@a11y-pulse/tab-orchestrator 0.3.0 → 0.5.0

package/dist/index.js

@@ -226,14 +226,8 @@ function isCenterObscuredScript(el) {
     return false;
   }
   const rect = el.getBoundingClientRect();
-  const x = Math.min(
-    Math.max(rect.left + rect.width / 2, 0),
-    window.innerWidth - 1
-  );
-  const y = Math.min(
-    Math.max(rect.top + rect.height / 2, 0),
-    window.innerHeight - 1
-  );
+  const x = Math.min(Math.max(rect.left + rect.width / 2, 0), window.innerWidth - 1);
+  const y = Math.min(Math.max(rect.top + rect.height / 2, 0), window.innerHeight - 1);
   let hit = document.elementFromPoint(x, y);
   while (hit?.shadowRoot) {
     const inner = hit.shadowRoot.elementFromPoint(x, y);
@@ -319,9 +313,7 @@ function measureObscuringScript(el, obscurerAttr) {
   if (!el) {
     return empty;
   }
-  for (const marked of Array.from(
-    document.querySelectorAll(`[${obscurerAttr}]`)
-  )) {
+  for (const marked of Array.from(document.querySelectorAll(`[${obscurerAttr}]`))) {
     marked.removeAttribute(obscurerAttr);
   }
   const rect = el.getBoundingClientRect();
@@ -463,9 +455,7 @@ function obscurerHandleScript() {
   return document.querySelector("[data-a11y-obscurer]");
 }
 function clearObscurerScript(obscurerAttr) {
-  for (const marked of Array.from(
-    document.querySelectorAll(`[${obscurerAttr}]`)
-  )) {
+  for (const marked of Array.from(document.querySelectorAll(`[${obscurerAttr}]`))) {
     marked.removeAttribute(obscurerAttr);
   }
 }
@@ -551,9 +541,7 @@ function drainContextObserverScript(markerAttr) {
   if (!state) {
     return empty;
   }
-  for (const marked of Array.from(
-    document.querySelectorAll(`[${attributedAttr}]`)
-  )) {
+  for (const marked of Array.from(document.querySelectorAll(`[${attributedAttr}]`))) {
     marked.removeAttribute(attributedAttr);
   }
   const openedWindow = state.openedWindow;
@@ -568,9 +556,7 @@ function drainContextObserverScript(markerAttr) {
   while (active?.shadowRoot?.activeElement) {
     active = active.shadowRoot.activeElement;
   }
-  const intended = focusIns.find(
-    (el) => el !== document.body && el !== document.documentElement
-  ) ?? null;
+  const intended = focusIns.find((el) => el !== document.body && el !== document.documentElement) ?? null;
   const openingHtml = (node) => {
     const clone = node.cloneNode(false);
     clone.removeAttribute(markerAttr);
@@ -628,9 +614,7 @@ function attributedHandleScript() {
   return document.querySelector("[data-a11y-ctx-attr]");
 }
 function clearAttributedScript() {
-  for (const marked of Array.from(
-    document.querySelectorAll("[data-a11y-ctx-attr]")
-  )) {
+  for (const marked of Array.from(document.querySelectorAll("[data-a11y-ctx-attr]"))) {
     marked.removeAttribute("data-a11y-ctx-attr");
   }
 }
@@ -646,16 +630,16 @@ function clearContextFocusInsScript() {
 function locationHrefScript() {
   return location.href;
 }
+function hasFocusScript() {
+  return document.hasFocus();
+}
 
 // src/clip.ts
 function bufferedClip(rect, pageWidth, pageHeight, buffer) {
   const left = Math.max(0, Math.min(buffer, rect.x));
   const top = Math.max(0, Math.min(buffer, rect.y));
   const right = Math.max(0, Math.min(buffer, pageWidth - rect.x - rect.width));
-  const bottom = Math.max(
-    0,
-    Math.min(buffer, pageHeight - rect.y - rect.height)
-  );
+  const bottom = Math.max(0, Math.min(buffer, pageHeight - rect.y - rect.height));
   return {
     x: Math.max(0, rect.x - left),
     y: Math.max(0, rect.y - top),
@@ -832,12 +816,7 @@ function getSelector(root) {
 async function captureScreenshot(adaptor, options, handle) {
   const { width: pageWidth, height: pageHeight } = await adaptor.evaluate(pageDimensionsScript);
   const rect = await adaptor.evaluate(elementRectScript, handle);
-  const clip = bufferedClip(
-    rect,
-    pageWidth,
-    pageHeight,
-    options.screenshotClipBuffer
-  );
+  const clip = bufferedClip(rect, pageWidth, pageHeight, options.screenshotClipBuffer);
   const scale = adaptor.screenshotClipScale ?? 1;
   return adaptor.screenshotClip(clip, scale);
 }
@@ -873,9 +852,7 @@ function truncateHtml(html, options = {}) {
 async function captureUnfocusedPair(adaptor, options, handle) {
   if (await adaptor.evaluate(isCenterObscuredScript, handle)) {
     await adaptor.evaluate(scrollToCenterScript, handle);
-    await new Promise(
-      (resolve) => setTimeout(resolve, options.screenshotSettleDelay)
-    );
+    await new Promise((resolve) => setTimeout(resolve, options.screenshotSettleDelay));
   }
   const { width: pageWidth, height: pageHeight } = await adaptor.evaluate(pageDimensionsScript);
   const focusedRect = await adaptor.evaluate(elementRectScript, handle);
@@ -895,10 +872,7 @@ async function captureUnfocusedPair(adaptor, options, handle) {
     pageHeight,
     options.screenshotClipBuffer
   );
-  const unfocusedScreenshot = await adaptor.screenshotClip(
-    unfocusedClip,
-    scale
-  );
+  const unfocusedScreenshot = await adaptor.screenshotClip(unfocusedClip, scale);
   const unfocusedStyles = await adaptor.evaluate(elementStylesScript, handle, [
     ...options.styleProps
   ]);
@@ -918,9 +892,7 @@ async function captureUnfocusedPair(adaptor, options, handle) {
 // src/orchestrator.ts
 function isContextDestroyedError(error) {
   const message = error instanceof Error ? error.message : String(error);
-  return /Execution context was destroyed|Target closed|frame was detached|navigat/i.test(
-    message
-  );
+  return /Execution context was destroyed|Target closed|frame was detached|navigat/i.test(message);
 }
 var DEFAULT_SCREENSHOT_SETTLE_DELAY2 = 33;
 var DEFAULT_SCREENSHOT_CLIP_BUFFER = 10;
@@ -990,11 +962,7 @@ function createTabOrchestrator(adaptor, options = {}) {
           if (activeHandle === void 0) {
             throw new Error("unfocusedPair capture not implemented");
           }
-          pairByStop.current ??= captureUnfocusedPair(
-            adaptor,
-            resolved,
-            activeHandle
-          );
+          pairByStop.current ??= captureUnfocusedPair(adaptor, resolved, activeHandle);
           return pairByStop.current;
         },
         screenshotClip: () => {
@@ -1007,11 +975,7 @@ function createTabOrchestrator(adaptor, options = {}) {
           if (activeHandle === void 0) {
             throw new Error("screenshot capture not implemented");
           }
-          screenshotByStop.current ??= captureScreenshot(
-            adaptor,
-            resolved,
-            activeHandle
-          );
+          screenshotByStop.current ??= captureScreenshot(adaptor, resolved, activeHandle);
           return screenshotByStop.current;
         }
       });
@@ -1046,6 +1010,13 @@ function createTabOrchestrator(adaptor, options = {}) {
         baselineHref = href;
         return { navigation: false, raw };
       }
+      async function documentHasFocus() {
+        if (await adaptor.evaluate(hasFocusScript)) {
+          return true;
+        }
+        await adaptor.ensureFocusReporting();
+        return adaptor.evaluate(hasFocusScript);
+      }
       let failure;
       try {
         await adaptor.ensureFocusReporting();
@@ -1075,8 +1046,7 @@ function createTabOrchestrator(adaptor, options = {}) {
           pairByStop.current = null;
           screenshotByStop.current = null;
           lastHasAttributed = false;
-          const hasFocus = await adaptor.evaluate(() => document.hasFocus());
-          if (!hasFocus) {
+          if (!await documentHasFocus()) {
             end("lostFocus");
             break;
           }
@@ -1092,13 +1062,10 @@ function createTabOrchestrator(adaptor, options = {}) {
           if (attached.size === 0) {
             break;
           }
+          const focusedAtMeasurement = await documentHasFocus();
           let base;
           try {
-            base = await adaptor.evaluate(
-              probeActiveElementScript,
-              styleProps,
-              MARKER_ATTR
-            );
+            base = await adaptor.evaluate(probeActiveElementScript, styleProps, MARKER_ATTR);
           } catch (error) {
             if (remainingHas("contextSignals") && isContextDestroyedError(error)) {
               end("navigation");
@@ -1106,6 +1073,10 @@ function createTabOrchestrator(adaptor, options = {}) {
             }
             throw error;
           }
+          if (!focusedAtMeasurement && base !== null && !base.isBody) {
+            end("lostFocus");
+            break;
+          }
           let contextNav = null;
           if (remainingHas("contextSignals")) {
             const outcome = await checkContextNavigation();
@@ -1119,10 +1090,7 @@ function createTabOrchestrator(adaptor, options = {}) {
             if (remainingHas("contextSignals")) {
               let raw;
               try {
-                raw = contextNav?.raw ?? await adaptor.evaluate(
-                  drainContextObserverScript,
-                  MARKER_ATTR
-                );
+                raw = contextNav?.raw ?? await adaptor.evaluate(drainContextObserverScript, MARKER_ATTR);
               } catch (error) {
                 if (!isContextDestroyedError(error)) {
                   throw error;
@@ -1131,9 +1099,7 @@ function createTabOrchestrator(adaptor, options = {}) {
                 break;
               }
               if (raw.hasAttributed) {
-                const attributedRef = await adaptor.evaluateHandle(
-                  attributedHandleScript
-                );
+                const attributedRef = await adaptor.evaluateHandle(attributedHandleScript);
                 let selector;
                 try {
                   selector = await adaptor.evaluate(getSelector, attributedRef);
@@ -1210,10 +1176,7 @@ function createTabOrchestrator(adaptor, options = {}) {
             if (remainingHas("contextSignals")) {
               let signals;
               try {
-                const raw = contextNav?.raw ?? await adaptor.evaluate(
-                  drainContextObserverScript,
-                  MARKER_ATTR
-                );
+                const raw = contextNav?.raw ?? await adaptor.evaluate(drainContextObserverScript, MARKER_ATTR);
                 signals = {
                   openedWindow: raw.openedWindow,
                   submittedForm: raw.submittedForm,
@@ -1240,29 +1203,16 @@ function createTabOrchestrator(adaptor, options = {}) {
               snapshot.contextSignals = { signals };
             }
             if (remainingHas("obscuring")) {
-              let raw = await adaptor.evaluate(
-                measureObscuringScript,
-                ref,
-                OBSCURER_ATTR
-              );
+              let raw = await adaptor.evaluate(measureObscuringScript, ref, OBSCURER_ATTR);
               if (raw.fullyObscured) {
-                await new Promise(
-                  (resolve) => setTimeout(resolve, OBSCURING_RECHECK_DELAY_MS)
-                );
-                raw = await adaptor.evaluate(
-                  measureObscuringScript,
-                  ref,
-                  OBSCURER_ATTR
-                );
+                await new Promise((resolve) => setTimeout(resolve, OBSCURING_RECHECK_DELAY_MS));
+                raw = await adaptor.evaluate(measureObscuringScript, ref, OBSCURER_ATTR);
               }
               let obscuredBy = null;
               if (raw.hasObscurer) {
                 const obscurer = await adaptor.evaluateHandle(obscurerHandleScript);
                 try {
-                  const obscurerSelector = await adaptor.evaluate(
-                    getSelector,
-                    obscurer
-                  );
+                  const obscurerSelector = await adaptor.evaluate(getSelector, obscurer);
                   obscuredBy = {
                     selector: obscurerSelector,
                     html: truncateHtml(raw.obscuredByHtml ?? "")
@@ -1337,6 +1287,7 @@ export {
   elementStylesScript,
   focusScript,
   getSelector,
+  hasFocusScript,
   isCenterObscuredScript,
   pageDimensionsScript,
   probeActiveElementScript,