@a11y-oracle/cypress-plugin 1.1.2 → 1.1.3

package/dist/lib/commands.js

@@ -37,6 +37,7 @@ let engine = null;
 let orchestrator = null;
 let autFrameId = null;
 let autContextId = null;
+let autIframeBounds = null;
 /**
  * Send a raw CDP command through Cypress's automation channel.
  */
@@ -69,6 +70,21 @@ function createFrameAwareCDPAdapter() {
             if (method === 'Runtime.evaluate' && autContextId !== null) {
                 p['contextId'] = autContextId;
             }
+            // Translate iframe-relative clip coordinates to viewport coordinates.
+            // Runtime.evaluate runs inside the AUT iframe (via contextId), so
+            // getBoundingClientRect() returns iframe-relative coords. But
+            // Page.captureScreenshot clips relative to the top-level viewport.
+            if (method === 'Page.captureScreenshot' &&
+                p['clip'] &&
+                autIframeBounds &&
+                (autIframeBounds.x !== 0 || autIframeBounds.y !== 0)) {
+                const clip = p['clip'];
+                p['clip'] = {
+                    ...clip,
+                    x: clip.x + autIframeBounds.x,
+                    y: clip.y + autIframeBounds.y,
+                };
+            }
             return sendCDP(method, p);
         },
     };
@@ -122,6 +138,34 @@ async function findAUTContextId(frameId) {
         return null;
     }
 }
+/**
+ * Get the AUT iframe's position in the top-level viewport.
+ *
+ * Runs `Runtime.evaluate` in the top-level context (without `contextId`)
+ * to find the AUT iframe and return its bounding rect origin. Adds
+ * `clientLeft`/`clientTop` to account for any iframe border.
+ *
+ * Used to translate iframe-relative coordinates from
+ * `getBoundingClientRect()` to viewport-absolute coordinates for
+ * `Page.captureScreenshot` clips.
+ */
+async function getAUTIframeBounds() {
+    const result = (await sendCDP('Runtime.evaluate', {
+        expression: `(() => {
+      const iframes = document.querySelectorAll('iframe');
+      for (const f of iframes) {
+        const src = f.getAttribute('src') || f.src || '';
+        if (src && !src.includes('/__/') && !src.includes('__cypress') && src !== 'about:blank') {
+          const rect = f.getBoundingClientRect();
+          return { x: rect.x + f.clientLeft, y: rect.y + f.clientTop };
+        }
+      }
+      return { x: 0, y: 0 };
+    })()`,
+        returnByValue: true,
+    }));
+    return result.result.value;
+}
 /**
  * Focus the AUT iframe element so that CDP keyboard events
  * reach the AUT's content instead of the Cypress runner UI.
@@ -214,6 +258,8 @@ Cypress.Commands.add('initA11yOracle', (options) => {
         }
         // Get the AUT frame's execution context for Runtime.evaluate
         autContextId = await findAUTContextId(autFrameId);
+        // Cache iframe bounds for screenshot coordinate translation
+        autIframeBounds = await getAUTIframeBounds();
         // Focus the AUT iframe so key events reach it
         await focusAUTFrame();
         // Create the CDP adapter that routes to the AUT frame
@@ -358,6 +404,7 @@ Cypress.Commands.add('disposeA11yOracle', () => {
         }
         autFrameId = null;
         autContextId = null;
+        autIframeBounds = null;
         return null;
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a11y-oracle/cypress-plugin",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "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.2",
-    "@a11y-oracle/keyboard-engine": "1.1.2",
-    "@a11y-oracle/audit-formatter": "1.1.2",
+    "@a11y-oracle/core-engine": "1.1.3",
+    "@a11y-oracle/keyboard-engine": "1.1.3",
+    "@a11y-oracle/audit-formatter": "1.1.3",
     "tslib": "^2.3.0"
   }
 }