@riddledc/riddle-proof 0.7.20 → 0.7.22

package/dist/basic-gameplay.cjs

@@ -119,11 +119,13 @@ 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,
     path: result.path,
+    assessment_mode: result.assessment_mode,
     failures: result.failures,
     warnings: result.warnings,
     suite_failures: result.suite_failures
@@ -150,6 +152,8 @@ function assessBasicGameplayRoute(route, options = {}) {
   const failOnConsoleError = options.failOnConsoleError ?? false;
   const failures = [];
   const warnings = [];
+  const assessmentMode = routeAssessmentMode(route);
+  const auditAssessment = isAuditAssessmentRoute(route);
   const initial = route.initial || {};
   const timed = route.timed || {};
   const afterAction = route.after_action || route.afterAction || {};
@@ -161,7 +165,9 @@ function assessBasicGameplayRoute(route, options = {}) {
   const continuedActionChange = changed(afterAction, afterContinue);
   const cleanupBase = route.after_continue || route.afterContinue ? afterContinue : afterAction;
   const cleanupActionChange = changed(cleanupBase, afterCleanup);
-  const surfaceVisible = numberValue(initial.visible_canvas_count) > 0 || numberValue(initial.enabled_clickable_count) > 0 || numberValue(initial.visible_large_node_count) >= minSurfaceLargeNodes;
+  const interactiveSurfaceVisible = numberValue(initial.visible_canvas_count) > 0 || numberValue(initial.enabled_clickable_count) > 0 || numberValue(initial.visible_large_node_count) >= minSurfaceLargeNodes;
+  const auditSurfaceVisible = numberValue(initial.body_text_length) >= minBodyTextLength || numberValue(initial.visible_large_node_count) >= minVisibleLargeNodes || numberValue(initial.enabled_clickable_count) > 0 || numberValue(initial.visible_canvas_count) > 0;
+  const surfaceVisible = auditAssessment ? auditSurfaceVisible : interactiveSurfaceVisible;
   const actionResults = listValue(route.action_results || route.actionResults);
   const continuedActionResults = listValue(route.continued_action_results || route.continuedActionResults);
   const continuedCleanupActionResults = listValue(route.continued_cleanup_action_results || route.continuedCleanupActionResults);
@@ -175,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) {
@@ -183,20 +189,21 @@ function assessBasicGameplayRoute(route, options = {}) {
   }
   if (!surfaceVisible) failures.push("no_game_surface");
   if (mobileOverflowPx > maxMobileOverflowPx) failures.push("mobile_horizontal_overflow");
-  if (!actionAttempted && !timedChange.changed) failures.push("primary_control_missing");
-  if (actionAttempted && !stateChangeObserved) failures.push("primary_control_inert");
+  if (!auditAssessment && !actionAttempted && !timedChange.changed) failures.push("primary_control_missing");
+  if (!auditAssessment && actionAttempted && !stateChangeObserved) failures.push("primary_control_inert");
   if (failOnConsoleError && consoleErrorCount > 0) failures.push("fatal_page_error");
   if (numberValue(initial.visible_canvas_count) > 0 && actionAttempted && !timedChange.canvas_changed && !actionChange.canvas_changed && !actionChange.screenshot_changed) {
     warnings.push("canvas_inert");
   }
   if (actionFailed) warnings.push("some_actions_failed");
-  if (warnOnMissingResetPath && !resetPathPresent && route.requires_reset !== false && actionAttempted && stateChangeObserved) {
+  if (!auditAssessment && warnOnMissingResetPath && !resetPathPresent && route.requires_reset !== false && actionAttempted && stateChangeObserved) {
     warnings.push("missing_reset_path");
   }
   if (warnOnConsoleError && consoleErrorCount > 0) warnings.push("critical_console_error");
   return {
     name: route.name,
     path: route.path,
+    assessment_mode: assessmentMode,
     ok: failures.length === 0,
     failures,
     warnings,
@@ -317,15 +324,16 @@ 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,
     path: result.path,
+    assessment_mode: result.assessment_mode,
     failures: result.failures,
     warnings: result.warnings,
     suite_failures: result.suite_failures
@@ -382,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 = [];
@@ -456,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,
@@ -610,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,
@@ -632,7 +660,8 @@ function augmentRouteAssessmentWithProgressionChecks(result, route) {
         state_call: check.state_call || null,
         property_path: check.property_path || null
       })),
-      ...responsiveFailures
+      ...responsiveFailures,
+      ...responsiveBounds
     ]
   };
 }
@@ -658,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)));
 }
@@ -667,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 {
@@ -760,6 +887,24 @@ function countCodes(codes) {
   for (const code of codes) counts[code] = (counts[code] || 0) + 1;
   return counts;
 }
+function routeAssessmentMode(route) {
+  const raw = route.assessment_mode ?? route.assessmentMode ?? route.proof_mode ?? route.proofMode ?? null;
+  if (raw === null || raw === void 0) return route.audit === true ? "audit" : null;
+  const mode = String(raw).trim().toLowerCase().replace(/_/g, "-");
+  return mode || (route.audit === true ? "audit" : null);
+}
+function isAuditAssessmentRoute(route) {
+  const mode = routeAssessmentMode(route);
+  return route.audit === true || [
+    "audit",
+    "audit-only",
+    "no-diff",
+    "not-required",
+    "profile",
+    "report-only",
+    "static"
+  ].includes(String(mode || ""));
+}
 function firstNumber(...values) {
   for (const value of values) {
     const number = numericValue(value);

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,22 +113,47 @@ 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 {
     name?: string;
     path?: string;
+    assessment_mode?: string | null;
+    assessmentMode?: string | null;
+    proof_mode?: string | null;
+    proofMode?: string | null;
+    audit?: boolean;
     http_status?: number | null;
     response_status?: number | null;
     status?: number | null;
@@ -180,6 +208,7 @@ interface BasicGameplayChangeSummary {
 interface RiddleProofBasicGameplayRouteAssessment {
     name?: string;
     path?: string;
+    assessment_mode?: string | null;
     ok: boolean;
     failures: BasicGameplayFailureCode[];
     warnings: BasicGameplayWarningCode[];
@@ -211,6 +240,7 @@ interface RiddleProofBasicGameplayAssessment {
     failing_routes: Array<{
         name?: string;
         path?: string;
+        assessment_mode?: string | null;
         failures: BasicGameplayFailureCode[];
         warnings: BasicGameplayWarningCode[];
         suite_failures?: BasicGameplaySuiteFailure[];
@@ -307,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,22 +113,47 @@ 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 {
     name?: string;
     path?: string;
+    assessment_mode?: string | null;
+    assessmentMode?: string | null;
+    proof_mode?: string | null;
+    proofMode?: string | null;
+    audit?: boolean;
     http_status?: number | null;
     response_status?: number | null;
     status?: number | null;
@@ -180,6 +208,7 @@ interface BasicGameplayChangeSummary {
 interface RiddleProofBasicGameplayRouteAssessment {
     name?: string;
     path?: string;
+    assessment_mode?: string | null;
     ok: boolean;
     failures: BasicGameplayFailureCode[];
     warnings: BasicGameplayWarningCode[];
@@ -211,6 +240,7 @@ interface RiddleProofBasicGameplayAssessment {
     failing_routes: Array<{
         name?: string;
         path?: string;
+        assessment_mode?: string | null;
         failures: BasicGameplayFailureCode[];
         warnings: BasicGameplayWarningCode[];
         suite_failures?: BasicGameplaySuiteFailure[];
@@ -307,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-6H742VFJ.js";
+} from "./chunk-ELZSPOWV.js";
 export {
   BASIC_GAMEPLAY_ACTION_TYPES,
   BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES,