@a11y-oracle/cypress-plugin 1.1.3 → 1.2.0

package/README.md

@@ -459,7 +459,9 @@ Cypress runs the app under test (AUT) inside an iframe within its runner page. T
 
 3. **Isolated execution context** — For `Runtime.evaluate` calls (focus indicator analysis, tab order, trap detection), the plugin creates an isolated world in the AUT frame via `Page.createIsolatedWorld`. This isolated world shares the same DOM (including `document.activeElement`, computed styles, etc.) but has its own JavaScript scope, ensuring evaluations target the AUT content.
 
-4. **Focus management** — Before each keyboard event, the plugin uses `DOM.focus()` on the AUT iframe element so that `Input.dispatchKeyEvent` reaches the correct frame.
+4. **Screenshot coordinate translation** — `getBoundingClientRect()` inside the AUT iframe returns iframe-relative coordinates, but `Page.captureScreenshot` clips from the top-level browser viewport. The plugin queries the AUT iframe's position in the viewport and offsets all screenshot clip coordinates accordingly. This ensures pixel-level analysis (color contrast, focus indicator diffing) captures the correct region.
+
+5. **Focus management** — Before each keyboard event, the plugin uses `DOM.focus()` on the AUT iframe element so that `Input.dispatchKeyEvent` reaches the correct frame.
 
 ### CDP Flow
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a11y-oracle/cypress-plugin",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Cypress custom commands for accessibility speech assertions with iframe-aware CDP routing",
   "license": "MIT",
   "author": "a11y-oracle",
@@ -45,9 +45,9 @@
     "cypress": ">=12.0.0"
   },
   "dependencies": {
-    "@a11y-oracle/core-engine": "1.1.3",
-    "@a11y-oracle/keyboard-engine": "1.1.3",
-    "@a11y-oracle/audit-formatter": "1.1.3",
+    "@a11y-oracle/core-engine": "1.2.0",
+    "@a11y-oracle/keyboard-engine": "1.2.0",
+    "@a11y-oracle/audit-formatter": "1.2.0",
     "tslib": "^2.3.0"
   }
 }