donobu 2.13.1 → 2.14.0

package/dist/esm/managers/InteractionVisualizer.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionVisualizer = void 0;
+const Logger_1 = require("../utils/Logger");
+const main_1 = require("../main");
+/**
+ * Class for visualizing interactions in a webpage with a virtual mouse and messages.
+ */
+class InteractionVisualizer {
+    constructor(defaultDurationMillis) {
+        this.defaultDurationMillis = defaultDurationMillis;
+        this.currentMousePosition = { x: 0, y: 0 };
+        this.isMouseVisible = false;
+    }
+    /**
+     * Show the given message text visually adjacent to the given element for the given duration.
+     * Moves the virtual mouse to the element with a smooth animation.
+     * Blocks execution for the duration.
+     */
+    async pointAt(page, element, message, durationMillis = this.defaultDurationMillis) {
+        if (!message.trim() || !durationMillis || durationMillis <= 0) {
+            return;
+        }
+        try {
+            // Get element position for mouse movement
+            const boundingBox = await element.boundingBox();
+            if (!boundingBox) {
+                Logger_1.appLogger.error('Failed to get element bounding box');
+                return;
+            }
+            // Calculate target position (center of the element)
+            const targetX = boundingBox.x + boundingBox.width / 2;
+            const targetY = boundingBox.y + boundingBox.height / 2;
+            // Start mouse movement and message display in parallel
+            const mouseMovementPromise = this.moveVirtualMouse(page, targetX, targetY, durationMillis / 2);
+            // Display the message for the element
+            await this.displayMessageNearElement(element, message);
+            // Create a promise for the message duration
+            const messageDurationPromise = page.waitForTimeout(durationMillis);
+            // Wait for both mouse movement and message duration to complete
+            await Promise.all([mouseMovementPromise, messageDurationPromise]);
+            // 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 (main_1.PlaywrightUtils.isPageClosedError(e)) {
+                throw e;
+            }
+            else {
+                Logger_1.appLogger.error(`Failed to display message at element`, e);
+            }
+        }
+    }
+    /**
+     * Moves the virtual mouse to the target position with a smooth animation.
+     */
+    async moveVirtualMouse(page, targetX, targetY, durationMillis) {
+        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('style');
+                    styleEl.textContent = `
+              :host { all: initial; }
+              .donobu-message {
+                z-index: 2147483647;
+                background-color: black;
+                color: white;
+                padding: 8px;
+                border-radius: 5px;
+                font-size: 12px;
+                font-family: 'Source Sans Pro', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+                display: block;
+                max-width: 300px;
+                white-space: pre-wrap;
+                box-shadow: 2px 2px 10px rgba(0,0,0,0.2);
+                position: absolute;
+              }
+              .virtual-mouse {
+                width: 20px;
+                height: 20px;
+                background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='20' height='20' viewBox='0 0 20 20'%3E%3Cpath d='M0,0 L12,10 L7,11 L10,18 L8,19 L5,12 L0,16 Z' fill='%23ffffff' stroke='%23000000' stroke-width='1'/%3E%3C/svg%3E");
+                background-repeat: no-repeat;
+                background-size: contain;
+                position: absolute;
+                z-index: 2147483646;
+                transition-property: left, top;
+                transition-timing-function: ease-in-out;
+                filter: drop-shadow(1px 1px 1px rgba(0,0,0,0.5));
+              }
+            `;
+                    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 = '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 - 10}px`; // Offset by half the cursor size
+                mouse.style.top = `${endY - 5}px`; // Offset to position pointer tip at target
+                // Resolve when transition completes or timeout as fallback
+                const transitionEndHandler = () => {
+                    mouse?.removeEventListener('transitionend', transitionEndHandler);
+                    resolve();
+                };
+                mouse.addEventListener('transitionend', transitionEndHandler);
+                // Fallback in case transitionend doesn't fire
+                setTimeout(resolve, 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 };
+        this.isMouseVisible = true;
+    }
+    /**
+     * 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`;
+            }
+        }, [InteractionVisualizer.MESSAGE_CONTAINER_ID, message]);
+    }
+    /**
+     * Hide the virtual mouse.
+     */
+    async hideVirtualMouse(page) {
+        if (!this.isMouseVisible) {
+            return;
+        }
+        await page.evaluate(([containerId, mouseId]) => {
+            const container = document.getElementById(containerId);
+            if (container && container.shadowRoot) {
+                const mouse = container.shadowRoot.getElementById(mouseId);
+                if (mouse) {
+                    mouse.remove();
+                }
+            }
+        }, [
+            InteractionVisualizer.MESSAGE_CONTAINER_ID,
+            InteractionVisualizer.VIRTUAL_MOUSE_ID,
+        ]);
+        this.isMouseVisible = false;
+    }
+    /**
+     * Clean up all messages and the virtual mouse.
+     */
+    async cleanUp(page) {
+        await page.evaluate(([containerId]) => {
+            const container = document.getElementById(containerId);
+            if (container) {
+                container.remove();
+            }
+        }, [InteractionVisualizer.MESSAGE_CONTAINER_ID]);
+        this.isMouseVisible = false;
+    }
+}
+exports.InteractionVisualizer = InteractionVisualizer;
+InteractionVisualizer.MESSAGE_CONTAINER_ID = 'donobu-message-shadow-container';
+InteractionVisualizer.VIRTUAL_MOUSE_ID = 'virtual-mouse';
+//# sourceMappingURL=InteractionVisualizer.js.map

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

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

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

@@ -1,35 +1,32 @@
 import { Page, Locator } from 'playwright';
 export declare class ToolTipper {
-    readonly defaultDuration: number;
-    constructor(defaultDuration: number);
-    /**
-     * Show the given tooltip text in the top-left corner of the page for the given duration.
-     * If duration <= 0 or toolTip is empty, does nothing. Blocks execution for the duration.
-     */
-    blipToolTip(page: Page, toolTip: string, duration?: number): Promise<void>;
+    readonly defaultDurationMillis: number;
+    private static readonly TOOL_TIP_CONTAINER_ID;
+    private static readonly VIRTUAL_MOUSE_ID;
+    private currentMousePosition;
+    private isMouseVisible;
+    constructor(defaultDurationMillis: number);
     /**
      * Show the given tooltip text visually adjacent to the given element for the given duration.
+     * Moves the virtual mouse to the element with a smooth animation.
      * Blocks execution for the duration.
      */
-    blipToolTipAtElement(page: Page, element: Locator, toolTip: string, duration?: number): Promise<void>;
+    blipToolTip(page: Page, element: Locator, toolTip: string, durationMillis?: number): Promise<void>;
     /**
-     * Creates a tooltip in the top-left corner, inside a shadow root to avoid CSS collisions.
-     * Returns the tooltip's unique ID.
+     * Moves the virtual mouse to the target position with a smooth animation.
      */
-    private displayToolTip;
+    private moveVirtualMouse;
     /**
      * Creates a tooltip adjacent to the element, inside a shadow root to avoid CSS collisions.
-     * Returns the tooltip's unique ID.
      */
     private displayToolTipForElement;
     /**
-     * Removes the tooltip with the given ID from the shadow root (top-level).
+     * Hide the virtual mouse.
      */
-    private static removeElementById;
+    hideVirtualMouse(page: Page): Promise<void>;
     /**
-     * Same as removeElementById but uses the element's frame context
-     * in case the tooltip was created via that element's evaluate call.
+     * Clean up all tooltips and the virtual mouse.
      */
-    private static useElementToRemoveElementById;
+    cleanUp(page: Page): Promise<void>;
 }
 //# sourceMappingURL=ToolTipper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ToolTipper.d.ts","sourceRoot":"","sources":["../../../src/managers/ToolTipper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI3C,qBAAa,UAAU;aAEH,eAAe,EAAE,MAAM;gBAAvB,eAAe,EAAE,MAAM;IAGzC;;;OAGG;IACU,WAAW,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,IAAI,CAAC;IAahB;;;OAGG;IACU,oBAAoB,CAC/B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAA6B,GACtC,OAAO,CAAC,IAAI,CAAC;IAahB;;;OAGG;YACW,cAAc;IA8D5B;;;OAGG;YACW,wBAAwB;IAiFtC;;OAEG;mBACkB,iBAAiB;IAYtC;;;OAGG;mBACkB,6BAA6B;CAWnD"}
+{"version":3,"file":"ToolTipper.d.ts","sourceRoot":"","sources":["../../../src/managers/ToolTipper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI3C,qBAAa,UAAU;aAMc,qBAAqB,EAAE,MAAM;IALhE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAA+B;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAC3D,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,cAAc,CAAS;gBAEI,qBAAqB,EAAE,MAAM;IAEhE;;;;OAIG;IACU,WAAW,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAmC,GAClD,OAAO,CAAC,IAAI,CAAC;IA0DhB;;OAEG;YACW,gBAAgB;IAiH9B;;OAEG;YACW,wBAAwB;IAgDtC;;OAEG;IACU,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBxD;;OAEG;IACU,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAahD"}