donobu 2.16.0 → 2.17.1

package/dist/esm/managers/InteractionVisualizer.js

@@ -1,223 +1,151 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InteractionVisualizer = void 0;
-const Logger_1 = require("../utils/Logger");
-const PlaywrightUtils_1 = require("../utils/PlaywrightUtils");
-const MiscUtils_1 = require("../utils/MiscUtils");
-/**
- * Class for visualizing interactions in a webpage with a virtual mouse and messages.
- */
 class InteractionVisualizer {
-    /**
-     * Creates an instance of InteractionVisualizer.
-     * @param defaultMessageDurationMillis - Default duration for displaying messages in milliseconds.
-     */
     constructor(defaultMessageDurationMillis) {
         this.defaultMessageDurationMillis = defaultMessageDurationMillis;
-        this.currentMousePosition = { x: 0, y: 0 };
+        this.cursorPos = { x: 0, y: 0 };
     }
-    /**
-     * Moves the virtual mouse to the element with a smooth animation and
-     * optionally displays a message at element.
-     */
-    async pointAt(page, element, message, durationMillis = this.defaultMessageDurationMillis) {
-        if (!durationMillis || durationMillis <= 0) {
+    /* ------------------------------------------------------------------ */
+    /*  Public API                                                        */
+    /* ------------------------------------------------------------------ */
+    /** Move the virtual cursor to the centre of the locator and optionally show a message. */
+    async pointAt(page, locator, message, duration = this.defaultMessageDurationMillis) {
+        if (!duration || duration <= 0)
             return;
-        }
-        await InteractionVisualizer.ensureRoutesRegistered(page.context());
-        try {
-            // Get element position for mouse movement
-            const boundingBox = await element.boundingBox();
-            if (!boundingBox) {
-                Logger_1.appLogger.error('Failed to get element bounding box');
+        await locator.scrollIntoViewIfNeeded();
+        const box = await locator.boundingBox();
+        if (!box)
+            throw new Error('Element bounding box unavailable');
+        const target = { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+        await this.ensureContainer(page);
+        await Promise.all([
+            this.moveCursor(page, target, duration / 2),
+            message && message.trim()
+                ? this.showMessage(page, target, message.trim(), duration)
+                : Promise.resolve(),
+        ]);
+    }
+    /* ------------------------------------------------------------------ */
+    /*  Private helpers                                                   */
+    /* ------------------------------------------------------------------ */
+    async ensureContainer(page) {
+        const id = InteractionVisualizer.CONTAINER_ID;
+        await page.evaluate(([containerId, css]) => {
+            if (document.getElementById(containerId))
                 return;
-            }
-            // Calculate target position (center of the element)
-            const targetX = boundingBox.x + boundingBox.width / 2;
-            const targetY = boundingBox.y + boundingBox.height / 2;
-            const promises = [];
-            // Start mouse movement and message display in parallel
-            promises.push(this.moveVirtualMouse(page, targetX, targetY, durationMillis / 2));
-            if (message && !message.trim()) {
-                // Display the message for the element
-                await this.displayMessageNearElement(element, message);
-                // Create a promise for the message duration
-                promises.push(page.waitForTimeout(durationMillis));
-            }
-            // Wait for both mouse movement and message duration to complete
-            await Promise.all(promises);
-            // Remove only the message after the duration (keep the mouse)
-            await element.evaluate((_, [messageContainerId]) => {
-                const container = document.getElementById(messageContainerId);
-                if (container) {
-                    const shadow = container.shadowRoot;
-                    if (shadow) {
-                        // Remove only message elements but keep the mouse
-                        const messages = Array.from(shadow.querySelectorAll('.donobu-message'));
-                        messages.forEach((msg) => msg.remove());
-                    }
-                }
-            }, [InteractionVisualizer.MESSAGE_CONTAINER_ID]);
-        }
-        catch (e) {
-            if (PlaywrightUtils_1.PlaywrightUtils.isPageClosedError(e)) {
-                throw e;
-            }
-            else {
-                Logger_1.appLogger.error(`Failed to display message at element`, e);
-            }
-        }
+            const el = document.createElement('div');
+            el.id = containerId;
+            Object.assign(el.style, {
+                position: 'fixed',
+                top: '0',
+                left: '0',
+                width: '100vw',
+                height: '100vh',
+                pointerEvents: 'none',
+                zIndex: '2147483646', // just below the message itself
+            });
+            const shadow = el.attachShadow({ mode: 'open' });
+            const style = document.createElement('style');
+            style.textContent = css;
+            shadow.appendChild(style);
+            // Append to <html> so it is not clipped by overflow/transform on <body>
+            (document.documentElement || document.body).appendChild(el);
+        }, [id, InteractionVisualizer.CSS]);
     }
-    /**
-     * Moves the virtual mouse to the target position with a smooth animation.
-     */
-    async moveVirtualMouse(page, targetX, targetY, durationMillis) {
-        await InteractionVisualizer.ensureRoutesRegistered(page.context());
-        await page.evaluate(([containerId, mouseId, startX, startY, endX, endY, duration]) => {
-            return new Promise((resolve) => {
-                // 1) Find or create the container
-                let container = document.getElementById(containerId);
-                if (!container) {
-                    container = document.createElement('div');
-                    container.id = containerId;
-                    container.style.position = 'absolute';
-                    container.style.top = '0';
-                    container.style.left = '0';
-                    container.style.width = '100%';
-                    container.style.height = '100%';
-                    container.style.pointerEvents = 'none';
-                    document.body.appendChild(container);
-                    const shadowRoot = container.attachShadow({ mode: 'open' });
-                    // Insert style
-                    const styleEl = document.createElement('link');
-                    styleEl.rel = 'stylesheet';
-                    styleEl.href = '/donobu.css';
-                    shadowRoot.appendChild(styleEl);
-                }
-                const shadow = container.shadowRoot;
-                if (!shadow) {
-                    resolve();
-                    return;
-                }
-                // Find or create mouse
-                let mouse = shadow.getElementById(mouseId);
-                if (!mouse) {
-                    mouse = document.createElement('div');
-                    mouse.id = mouseId;
-                    mouse.className = 'donobu-virtual-mouse';
-                    // Initial position if first time
-                    mouse.style.left = `${startX}px`;
-                    mouse.style.top = `${startY}px`;
-                    mouse.style.transitionDuration = '0s'; // No animation initially
-                    shadow.appendChild(mouse);
-                    // Force reflow to ensure initial position is applied before animation
-                    void mouse.offsetWidth;
-                }
-                // Animate the mouse
-                mouse.style.transitionDuration = `${duration}ms`;
-                mouse.style.left = `${endX - 16}px`; // Half of 40px
-                mouse.style.top = `${endY - 8}px`; // Tip adjustment
-                // Resolve when transition completes or timeout as fallback
-                const transitionEndHandler = () => {
-                    mouse?.removeEventListener('transitionend', transitionEndHandler);
-                    if (mouse) {
-                        mouse.classList.remove('rippling'); // Reset ripple
-                        void mouse.offsetWidth; // Force reflow
-                        setTimeout(() => {
-                            mouse?.classList.add('rippling'); // Trigger new ripple
-                        }, 10);
-                    }
+    async moveCursor(page, target, duration) {
+        const id = InteractionVisualizer.CONTAINER_ID;
+        await page.evaluate(([containerId, start, end, duration, svg]) => {
+            containerId = containerId;
+            start = start;
+            end = end;
+            duration = duration;
+            svg = svg;
+            const root = document.getElementById(containerId)
+                .shadowRoot;
+            let cursor = root.querySelector('.donobu-virtual-mouse');
+            if (!cursor) {
+                cursor = document.createElement('div');
+                cursor.className = 'donobu-virtual-mouse';
+                cursor.innerHTML = svg;
+                cursor.style.left = `${start.x}px`;
+                cursor.style.top = `${start.y}px`;
+                cursor.style.transitionDuration = '0s';
+                root.appendChild(cursor);
+                cursor.getBoundingClientRect(); // force reflow
+            }
+            cursor.style.transitionDuration = `${duration}ms`;
+            cursor.style.left = `${end.x - 12}px`; // half width offset
+            cursor.style.top = `${end.y - 12}px`; // half height offset
+            cursor.classList.add('rippling');
+            const done = new Promise((resolve) => {
+                const finish = () => {
+                    cursor.removeEventListener('transitionend', finish);
+                    cursor.classList.remove('rippling');
                     resolve();
                 };
-                mouse.addEventListener('transitionend', transitionEndHandler);
-                // Fallback in case transitionend doesn't fire
-                setTimeout(resolve, duration + 50);
+                cursor.addEventListener('transitionend', finish);
+                setTimeout(finish, duration + 50);
             });
-        }, [
-            InteractionVisualizer.MESSAGE_CONTAINER_ID,
-            InteractionVisualizer.VIRTUAL_MOUSE_ID,
-            this.currentMousePosition.x,
-            this.currentMousePosition.y,
-            targetX,
-            targetY,
-            durationMillis,
-        ]);
-        // Update current mouse position
-        this.currentMousePosition = { x: targetX, y: targetY };
+            return done;
+        }, [id, this.cursorPos, target, duration, InteractionVisualizer.SVG_MOUSE]);
+        this.cursorPos = target;
     }
-    /**
-     * Creates a message adjacent to the element, inside a shadow root to avoid CSS collisions.
-     */
-    async displayMessageNearElement(element, message) {
-        await element.evaluate((targetElement, [messageContainerId, message]) => {
-            // 1) Find container (should already exist from moveVirtualMouse)
-            const container = document.getElementById(messageContainerId);
-            if (!container || !container.shadowRoot) {
-                return;
-            }
-            const shadow = container.shadowRoot;
-            // 2) Insert message
-            const messageElement = document.createElement('div');
-            messageElement.className = 'donobu-message';
-            messageElement.textContent = message;
-            // Temporarily place off-screen to measure size
-            messageElement.style.left = '-9999px';
-            messageElement.style.top = '-9999px';
-            shadow.appendChild(messageElement);
-            // 3) Compute final position
-            const rect = targetElement.getBoundingClientRect();
-            let x = rect.left + window.scrollX;
-            let y = rect.bottom + window.scrollY + 10;
-            messageElement.style.left = `${x}px`;
-            messageElement.style.top = `${y}px`;
-            // Adjust if it goes off-screen to the right
-            const msgRect = messageElement.getBoundingClientRect();
-            const overflowRight = msgRect.right - window.innerWidth;
-            if (overflowRight > 0) {
-                messageElement.style.left = `${x - overflowRight - 10}px`;
-            }
-            // Adjust if it goes off-screen to the left
-            if (msgRect.left < 0) {
-                messageElement.style.left = `${window.scrollX + 10}px`;
+    async showMessage(page, target, text, duration) {
+        const id = InteractionVisualizer.CONTAINER_ID;
+        await page.evaluate(([containerId, target, text, duration]) => {
+            containerId = containerId;
+            target = target;
+            text = text;
+            duration = duration;
+            const root = document.getElementById(containerId)
+                .shadowRoot;
+            const msg = document.createElement('div');
+            msg.className = 'donobu-message';
+            msg.textContent = text;
+            root.appendChild(msg);
+            /* ── compute final coordinates ────────────────────────────────── */
+            const { width, height } = msg.getBoundingClientRect();
+            let x = target.x - width / 2;
+            let y = target.y + 24; // default - below cursor
+            /* clamp horizontally inside viewport */
+            x = Math.max(8, Math.min(window.innerWidth - width - 8, x));
+            /* if it overflows bottom, flip above the element */
+            if (y + height + 8 > window.innerHeight) {
+                y = target.y - height - 24;
             }
-        }, [InteractionVisualizer.MESSAGE_CONTAINER_ID, message]);
-    }
-    /**
-     * Ensures routes are registered for the given browser context.
-     * @param browserContext - The browser context to register routes on.
-     */
-    static async ensureRoutesRegistered(browserContext) {
-        if (this.registeredContexts.has(browserContext)) {
-            return;
-        }
-        try {
-            await browserContext.route('**/donobu-virtual-mouse.svg', async (route) => {
-                await route.fulfill({
-                    status: 200,
-                    contentType: 'image/svg+xml',
-                    body: InteractionVisualizer.VIRTUAL_MOUSE_SVG,
-                });
-            });
-            await browserContext.route('**/donobu.css', async (route) => {
-                await route.fulfill({
-                    status: 200,
-                    contentType: 'text/css',
-                    body: InteractionVisualizer.CSS,
-                });
-            });
-            this.registeredContexts.add(browserContext);
-            Logger_1.appLogger.debug('Routes registered for InteractionVisualizer');
-        }
-        catch (e) {
-            Logger_1.appLogger.error('Failed to register routes for InteractionVisualizer', e);
-            throw e;
-        }
+            /* if still off-screen at the top, clamp to 8 px margin */
+            if (y < 8)
+                y = 8;
+            msg.style.left = `${x}px`;
+            msg.style.top = `${y}px`;
+            /* auto-remove after the requested duration */
+            setTimeout(() => msg.remove(), duration);
+        }, [id, target, text, duration]);
     }
 }
 exports.InteractionVisualizer = InteractionVisualizer;
-InteractionVisualizer.VIRTUAL_MOUSE_SVG = MiscUtils_1.MiscUtils.getResourceFileAsString('donobu-virtual-mouse.svg');
-InteractionVisualizer.CSS = MiscUtils_1.MiscUtils.getResourceFileAsString('donobu.css');
-InteractionVisualizer.MESSAGE_CONTAINER_ID = 'donobu-message-shadow-container';
-InteractionVisualizer.VIRTUAL_MOUSE_ID = 'virtual-mouse';
-InteractionVisualizer.registeredContexts = new WeakSet();
+/* ------------------------------------------------------------------ */
+/*  Constants                                                         */
+/* ------------------------------------------------------------------ */
+InteractionVisualizer.SVG_MOUSE = `
+<svg xmlns="http://www.w3.org/2000/svg"
+     width="32"
+     height="32"
+     viewBox="0 0 24 24"
+     fill="oklch(13.09% 0.005 165.18)"
+     stroke="oklch(83.04% 0.1698 83.99)"
+     stroke-width="2"
+     stroke-linecap="round"
+     stroke-linejoin="round">
+  <path d="M4.037 4.688a.495.495 0 0 1 .651-.651l16 6.5a.5.5 0 0 1-.063.947l-6.124 1.58a2 2 0 0 0-1.438 1.435l-1.579 6.126a.5.5 0 0 1-.947.063z" />
+</svg>`;
+InteractionVisualizer.CSS = `
+  .donobu-message{position:absolute;z-index:2147483647;background:#000;color:#fff;padding:8px 10px;border-radius:5px;font:12px/1 'Source Sans Pro','Helvetica Neue',Helvetica,Arial,sans-serif;max-width:300px;white-space:pre-wrap;box-shadow:2px 2px 10px rgba(0,0,0,.2);pointer-events:none}
+  .donobu-virtual-mouse{width:24px;height:24px;position:absolute;z-index:2147483646;filter:drop-shadow(1px 1px 1px rgba(0,0,0,.5));transition:left .15s ease-in-out,top .15s ease-in-out,transform .15s ease-in-out}
+  .donobu-virtual-mouse svg{width:100%;height:100%;display:block}
+  .donobu-virtual-mouse.rippling::after{content:"";position:absolute;left:50%;top:50%;width:24px;height:24px;border-radius:50%;background:oklch(83.04% 0.1698 83.99);transform:translate(-50%,-50%) scale(.5);opacity:.4;animation:ripple-pop .6s ease-out forwards}
+  @keyframes ripple-pop{40%{transform:translate(-50%,-50%) scale(1);opacity:.5}100%{transform:translate(-50%,-50%) scale(2);opacity:0}}
+`;
+InteractionVisualizer.CONTAINER_ID = 'donobu-iv-overlay';
 //# sourceMappingURL=InteractionVisualizer.js.map

package/dist/esm/managers/InteractionVisualizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"InteractionVisualizer.js","sourceRoot":"","sources":["../../../src/managers/InteractionVisualizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"InteractionVisualizer.js","sourceRoot":"","sources":["../../../src/managers/InteractionVisualizer.ts"],"names":[],"mappings":"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"}

package/dist/esm/managers/PageInspector.d.ts

@@ -141,7 +141,6 @@ export declare class PageInspector {
      * const inspector = new PageInspector();
      * await inspector.attributeInteractableElements(page);
      * await inspector.annotateInteractableElements(page);
-     * // Visible numbered annotations now appear over all interactable elements
      */
     annotateInteractableElements(page: Page): Promise<void>;
     /**

package/dist/esm/managers/PageInspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageInspector.d.ts","sourceRoot":"","sources":["../../../src/managers/PageInspector.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,aAAa;aAYN,4BAA4B,EAAE,MAAM;aACpC,+BAA+B,EAAE,MAAM;IAZzD;;;;;OAKG;IACH,gBAAuB,WAAW,SAEhC;gBAGgB,4BAA4B,GAAE,MAAmC,EACjE,+BAA+B,GAAE,MAAiC;IAGpF;;;;;;;;;;;;;;;;;;;OAmBG;IACU,6BAA6B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoErE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,iCAAiC,CAC5C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,4BAA4B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAmJpE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAkBjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgVzC,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ3B"}
+{"version":3,"file":"PageInspector.d.ts","sourceRoot":"","sources":["../../../src/managers/PageInspector.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,aAAa;aAYN,4BAA4B,EAAE,MAAM;aACpC,+BAA+B,EAAE,MAAM;IAZzD;;;;;OAKG;IACH,gBAAuB,WAAW,SAEhC;gBAGgB,4BAA4B,GAAE,MAAmC,EACjE,+BAA+B,GAAE,MAAiC;IAGpF;;;;;;;;;;;;;;;;;;;OAmBG;IACU,6BAA6B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAoErE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,iCAAiC,CAC5C,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA4DjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACU,4BAA4B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuJpE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACU,+BAA+B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCvE;;;;OAIG;WACW,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAkBjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAkUzC,OAAO,CAAC,MAAM,CAAC,WAAW;CAQ3B"}

package/dist/esm/managers/PageInspector.js

@@ -235,7 +235,6 @@ class PageInspector {
      * const inspector = new PageInspector();
      * await inspector.attributeInteractableElements(page);
      * await inspector.annotateInteractableElements(page);
-     * // Visible numbered annotations now appear over all interactable elements
      */
     async annotateInteractableElements(page) {
         try {
@@ -252,8 +251,11 @@ class PageInspector {
                         container.id = 'annotation-shadow-container';
                         // Position container so child elements can be absolutely placed
                         Object.assign(container.style, {
-                            position: 'fixed', // anchor to viewport
-                            inset: '0', // stretch across it
+                            position: 'absolute',
+                            top: '0',
+                            left: '0',
+                            width: '100%',
+                            height: '100%',
                             pointerEvents: 'none', // Let clicks pass through
                             zIndex: '2147483647', // win every z-index fight
                         });
@@ -275,29 +277,29 @@ class PageInspector {
                         // Add a <style> element inside the shadow root to reset and define annotation styles
                         const style = document.createElement('style');
                         style.textContent = `
-                    :host {
-                      all: initial; /* Reset styles in shadow root */
-                    }
-                    .annotation {
-                      position: absolute;
-                      z-index: 2147483647;
-                      background-color: black;
-                      color: white;
-                      width: 40px;
-                      height: 40px;
-                      border-radius: 50%;
-                      display: flex;
-                      align-items: center;
-                      justify-content: center;
-                      font-size: 14px;
-                      font-weight: bold;
-                      line-height: 20px;
-                      text-align: center;
-                      box-shadow: 0px 2px 4px rgba(0,0,0,0.2);
-                      border: 4px solid #FF4136;
-                      pointer-events: none;
-                    }
-                  `;
+                :host {
+                  all: initial; /* Reset styles in shadow root */
+                }
+                .annotation {
+                  position: absolute;
+                  z-index: 2147483647;
+                  background-color: black;
+                  color: white;
+                  width: 40px;
+                  height: 40px;
+                  border-radius: 50%;
+                  display: flex;
+                  align-items: center;
+                  justify-content: center;
+                  font-size: 14px;
+                  font-weight: bold;
+                  line-height: 20px;
+                  text-align: center;
+                  box-shadow: 0px 2px 4px rgba(0,0,0,0.2);
+                  border: 4px solid #FF4136;
+                  pointer-events: none;
+                }
+              `;
                         shadowRoot.appendChild(style);
                     }
                     // Retrieve the shadow root to place annotation elements
@@ -318,6 +320,7 @@ class PageInspector {
                     const positionAnnotation = (annotation, element) => {
                         const rect = element.getBoundingClientRect();
                         // Center the annotation on the element, adjusting for its size
+                        // Since container is absolute, we need to account for scroll position
                         const x = rect.left + rect.width / 2 - 20 + window.scrollX;
                         const y = rect.top + rect.height / 2 - 20 + window.scrollY;
                         annotation.style.left = `${x}px`;
@@ -437,15 +440,23 @@ class PageInspector {
      */
     async deattributeInteractableElements(page) {
         try {
-            const frames = page
-                .frames()
-                .filter((frame) => PageInspector.frameFilter(frame));
+            const frames = page.frames().filter(PageInspector.frameFilter);
+            const attr = this.interactableElementAttribute;
             for (const frame of frames) {
-                await frame.evaluate((attr) => {
-                    document.querySelectorAll(`[${attr}]`).forEach((element) => {
-                        element.removeAttribute(attr);
-                    });
-                }, this.interactableElementAttribute);
+                await frame.evaluate(([a]) => {
+                    /** Depth-first removal inside document & every shadow root */
+                    const removeDeep = (root) => {
+                        root
+                            .querySelectorAll(`[${a}]`)
+                            .forEach((el) => el.removeAttribute(a));
+                        root.querySelectorAll('*').forEach((el) => {
+                            const sr = el.shadowRoot;
+                            if (sr)
+                                removeDeep(sr);
+                        });
+                    };
+                    removeDeep(document);
+                }, [attr]);
             }
         }
         catch (error) {
@@ -715,52 +726,42 @@ class PageInspector {
         const interactableElements = getAllInteractableElements(document)
             .concat(window.__donobu.getInteractiveElements())
             .filter((el) => !el.id || (typeof el.id === 'string' && !el.id.startsWith('donobu-')));
-        // Use a Set to avoid duplicates
         const uniqueElements = new Set(interactableElements);
-        // 2) Check each element for visibility + actual "interactability"
+        // 2) Iterate and assign numbers
         uniqueElements.forEach((element) => {
-            if (typeof element.getBoundingClientRect !== 'function') {
-                // Should be rare, but just in case
+            // Skip if this element already carries a value (e.g. assigned via <label>)
+            if (element.hasAttribute(interactableAttribute))
                 return;
-            }
             const rect = element.getBoundingClientRect();
             const style = window.getComputedStyle(element);
             const visible = isElementVisible(rect, style) && isElementMoreThanHalfInViewport(rect);
-            // Check if the element is actually enabled/interactive
             const enabled = isElementEnabled(element, style);
-            if (!visible || !enabled) {
+            if (!visible || !enabled)
                 return;
-            }
-            let annotated = false;
-            // 3) Test small set of points on the element to confirm it's truly topmost
+            // Check a few probe points to make sure the element is top-most
             for (const pt of getPointsToCheck(rect)) {
                 let elToCheck = getDeepElementFromPoint(pt.x, pt.y);
-                // Walk up the DOM tree from that point
                 while (elToCheck) {
                     if (elToCheck === element) {
-                        // Found the actual element
                         element.setAttribute(interactableAttribute, offset.toString());
                         offset++;
-                        annotated = true;
-                        break;
+                        return; // this element done
                     }
-                    else if (elToCheck.tagName?.toLowerCase() === 'label' &&
+                    // Handle <label> → control mapping
+                    if (elToCheck.tagName.toLowerCase() === 'label' &&
                         elToCheck.htmlFor) {
-                        // If we found a label referencing an element, also mark that
                         const forId = elToCheck.htmlFor;
-                        const associatedInput = document.getElementById(forId);
-                        if (associatedInput) {
-                            associatedInput.setAttribute(interactableAttribute, offset.toString());
+                        const control = document.getElementById(forId);
+                        if (control &&
+                            !control.hasAttribute(interactableAttribute) // prevent double number
+                        ) {
+                            control.setAttribute(interactableAttribute, offset.toString());
                             offset++;
                         }
-                        annotated = true;
-                        break;
+                        return;
                     }
                     elToCheck = elToCheck.parentElement;
                 }
-                if (annotated) {
-                    break;
-                }
             }
         });
         return offset;