pw-automation-framework 2.0.1

package/dist/queue/ExecutionQueue.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionQueue = exports.ExecutionQueue = void 0;
+const uuid_1 = require("uuid");
+const TestExecutor_1 = require("../core/TestExecutor");
+const sseManager_1 = require("../utils/sseManager");
+const logger_1 = require("../utils/logger");
+const log = logger_1.Logger.create("ExecutionQueue");
+class ExecutionQueue {
+    constructor(maxConcurrent = 3) {
+        this.jobs = new Map();
+        this.running = new Set();
+        this.maxConcurrent = maxConcurrent;
+    }
+    // ─── Enqueue ───────────────────────────────────────────────────────────────
+    enqueue(payload) {
+        const executionId = (0, uuid_1.v4)();
+        const job = {
+            executionId,
+            status: "queued",
+            payload,
+            queuedAt: new Date().toISOString(),
+            cancelRequested: false,
+            progress: {
+                total_scripts: payload.scripts.length,
+                completed_scripts: 0,
+                total_steps: payload.scripts.reduce((s, sc) => s + sc.steps.length, 0),
+                completed_steps: 0,
+                passed_steps: 0,
+                failed_steps: 0,
+                skipped_steps: 0,
+            },
+        };
+        this.jobs.set(executionId, job);
+        log.info(`Queued: ${executionId} | scripts=${payload.scripts.length}`);
+        this.broadcastQueueUpdate();
+        this.processNext();
+        return executionId;
+    }
+    // ─── Cancel ────────────────────────────────────────────────────────────────
+    cancel(executionId) {
+        const job = this.jobs.get(executionId);
+        if (!job)
+            return { success: false, message: "Execution not found" };
+        if (job.status === "done" || job.status === "failed" || job.status === "cancelled") {
+            return { success: false, message: `Cannot cancel — already ${job.status}` };
+        }
+        job.cancelRequested = true;
+        if (job.status === "queued") {
+            // Not started yet — cancel immediately
+            job.status = "cancelled";
+            job.cancelledAt = new Date().toISOString();
+            sseManager_1.sseManager.emit(executionId, "execution_cancelled", {
+                message: "Execution cancelled before it started",
+                executionId,
+            });
+            this.broadcastQueueUpdate();
+            log.info(`Cancelled (queued): ${executionId}`);
+            return { success: true, message: "Execution cancelled" };
+        }
+        // Running — signal the executor to stop after current step
+        log.info(`Cancel requested (running): ${executionId}`);
+        sseManager_1.sseManager.emit(executionId, "log", {
+            message: "⏹ Cancellation requested — stopping after current step...",
+        });
+        return { success: true, message: "Cancellation requested — will stop after current step" };
+    }
+    // ─── Cancel All ────────────────────────────────────────────────────────────
+    cancelAll() {
+        let count = 0;
+        this.jobs.forEach((job) => {
+            if (job.status === "queued" || job.status === "running") {
+                this.cancel(job.executionId);
+                count++;
+            }
+        });
+        return { cancelled: count };
+    }
+    // ─── Process ───────────────────────────────────────────────────────────────
+    processNext() {
+        if (this.running.size >= this.maxConcurrent)
+            return;
+        const next = Array.from(this.jobs.values()).find(j => j.status === "queued");
+        if (!next)
+            return;
+        this.running.add(next.executionId);
+        next.status = "running";
+        next.startedAt = new Date().toISOString();
+        this.broadcastQueueUpdate();
+        this.runJob(next).catch((err) => {
+            log.error(`Job crashed: ${next.executionId} — ${err.message}`);
+            next.status = "failed";
+            next.error = err.message;
+            this.finalize(next.executionId);
+        });
+    }
+    async runJob(job) {
+        log.info(`Starting: ${job.executionId}`);
+        try {
+            const result = await TestExecutor_1.TestExecutor.run(job.payload, job.executionId, 
+            // Progress callback
+            (update) => {
+                Object.assign(job.progress, update);
+                this.broadcastQueueUpdate();
+            }, 
+            // Cancel check — TestExecutor polls this
+            () => job.cancelRequested);
+            if (job.cancelRequested) {
+                job.status = "cancelled";
+                job.cancelledAt = new Date().toISOString();
+            }
+            else {
+                job.result = result;
+                job.status = result.overall_status === "PASS" ? "done" : "failed";
+            }
+            job.completedAt = new Date().toISOString();
+        }
+        catch (error) {
+            job.status = "failed";
+            job.error = error.message;
+            job.completedAt = new Date().toISOString();
+            sseManager_1.sseManager.emit(job.executionId, "error", { message: error.message });
+        }
+        this.finalize(job.executionId);
+    }
+    finalize(executionId) {
+        this.running.delete(executionId);
+        this.broadcastQueueUpdate();
+        log.info(`Finalized: ${executionId} | running=${this.running.size}/${this.maxConcurrent}`);
+        // Keep jobs in memory 1 hour for replay
+        setTimeout(() => this.jobs.delete(executionId), 60 * 60 * 1000);
+        this.processNext();
+    }
+    // ─── Query ─────────────────────────────────────────────────────────────────
+    getJob(executionId) {
+        return this.jobs.get(executionId);
+    }
+    isCancelRequested(executionId) {
+        return this.jobs.get(executionId)?.cancelRequested ?? false;
+    }
+    getAllJobs() {
+        return Array.from(this.jobs.values())
+            .sort((a, b) => new Date(b.queuedAt).getTime() - new Date(a.queuedAt).getTime());
+    }
+    getQueueStats() {
+        const jobs = this.getAllJobs();
+        return {
+            total: jobs.length,
+            queued: jobs.filter(j => j.status === "queued").length,
+            running: jobs.filter(j => j.status === "running").length,
+            done: jobs.filter(j => j.status === "done").length,
+            failed: jobs.filter(j => j.status === "failed").length,
+            cancelled: jobs.filter(j => j.status === "cancelled").length,
+            maxConcurrent: this.maxConcurrent,
+            jobs: jobs.map(j => ({
+                executionId: j.executionId,
+                status: j.status,
+                queuedAt: j.queuedAt,
+                startedAt: j.startedAt,
+                completedAt: j.completedAt,
+                cancelledAt: j.cancelledAt,
+                progress: j.progress,
+                error: j.error,
+                overall_status: j.result?.overall_status,
+                cancelRequested: j.cancelRequested,
+            })),
+        };
+    }
+    broadcastQueueUpdate() {
+        sseManager_1.sseManager.broadcast("queue_update", this.getQueueStats());
+    }
+}
+exports.ExecutionQueue = ExecutionQueue;
+exports.executionQueue = new ExecutionQueue(3);
+//# sourceMappingURL=ExecutionQueue.js.map

package/dist/queue/ExecutionQueue.js.map

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

package/dist/routes/api.routes.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/dist/routes/api.routes.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const controller_1 = require("../controllers/controller");
+const router = (0, express_1.Router)();
+router.post("/run-test", controller_1.ApiController.runTest);
+router.get("/stream/:executionId", controller_1.ApiController.stream);
+router.get("/result/:executionId", controller_1.ApiController.getResult); // ← full formatted result
+router.get("/status/:executionId", controller_1.ApiController.getStatus); // ← lightweight status
+router.delete("/cancel/:executionId", controller_1.ApiController.cancelExecution);
+router.delete("/cancel-all", controller_1.ApiController.cancelAll);
+router.get("/queue", controller_1.ApiController.getQueue);
+router.get("/actions", controller_1.ApiController.listActions);
+router.get("/health", controller_1.ApiController.health);
+exports.default = router;
+//# sourceMappingURL=api.routes.js.map

package/dist/routes/api.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.routes.js","sourceRoot":"","sources":["../../src/routes/api.routes.ts"],"names":[],"mappings":";;AAAA,qCAAiC;AACjC,0DAA0D;AAE1D,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;AAExB,MAAM,CAAC,IAAI,CAAG,WAAW,EAAe,0BAAa,CAAC,OAAO,CAAC,CAAC;AAC/D,MAAM,CAAC,GAAG,CAAI,sBAAsB,EAAI,0BAAa,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,CAAC,GAAG,CAAI,sBAAsB,EAAI,0BAAa,CAAC,SAAS,CAAC,CAAC,CAAI,0BAA0B;AAC/F,MAAM,CAAC,GAAG,CAAI,sBAAsB,EAAI,0BAAa,CAAC,SAAS,CAAC,CAAC,CAAI,uBAAuB;AAC5F,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAI,0BAAa,CAAC,eAAe,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,CAAC,aAAa,EAAa,0BAAa,CAAC,SAAS,CAAC,CAAC;AACjE,MAAM,CAAC,GAAG,CAAI,QAAQ,EAAkB,0BAAa,CAAC,QAAQ,CAAC,CAAC;AAChE,MAAM,CAAC,GAAG,CAAI,UAAU,EAAgB,0BAAa,CAAC,WAAW,CAAC,CAAC;AACnE,MAAM,CAAC,GAAG,CAAI,SAAS,EAAiB,0BAAa,CAAC,MAAM,CAAC,CAAC;AAE9D,kBAAe,MAAM,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1 @@
+import "dotenv/config";

package/dist/server.js

@@ -0,0 +1,30 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("dotenv/config");
+const app_1 = __importDefault(require("./app"));
+const PORT = parseInt(process.env.PORT || "3000", 10);
+const server = app_1.default.listen(PORT, () => {
+    console.log("\n" + "═".repeat(60));
+    console.log("  🎭  Playwright Automation Framework v2.0");
+    console.log("═".repeat(60));
+    console.log(`  API          : http://localhost:${PORT}/api`);
+    console.log(`  Queue Monitor: http://localhost:${PORT}/queue-monitor`);
+    console.log(`  Health       : http://localhost:${PORT}/api/health`);
+    console.log(`  Actions      : http://localhost:${PORT}/api/actions`);
+    console.log("═".repeat(60) + "\n");
+});
+server.keepAliveTimeout = 65000;
+server.headersTimeout = 66000;
+const shutdown = (signal) => {
+    console.log(`\n[SHUTDOWN] ${signal} received`);
+    server.close(() => process.exit(0));
+    setTimeout(() => process.exit(1), 10000);
+};
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+process.on("uncaughtException", (e) => { console.error("[FATAL]", e); shutdown("uncaughtException"); });
+process.on("unhandledRejection", (r) => console.error("[UNHANDLED]", r));
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";;;;;AAAA,yBAAuB;AACvB,gDAAwB;AAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAEtD,MAAM,MAAM,GAAG,aAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACnC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,MAAM,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,gBAAgB,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,aAAa,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,cAAc,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC;AAChC,MAAM,CAAC,cAAc,GAAK,KAAK,CAAC;AAEhC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE;IAClC,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,WAAW,CAAC,CAAC;IAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAa,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAc,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3D,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAG,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzG,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/types.d.ts

@@ -0,0 +1,135 @@
+export type ScreenshotMode = "always" | "on_failure" | "never";
+export type StepStatus = "PASS" | "FAIL" | "SKIP" | "RUNNING" | "PENDING";
+export type ScriptStatus = "PASS" | "FAIL" | "RUNNING" | "PENDING";
+export type QueueStatus = "queued" | "running" | "done" | "failed" | "cancelled";
+export type SSEEventType = "execution_start" | "script_start" | "step_start" | "step_complete" | "script_complete" | "execution_complete" | "execution_cancelled" | "queue_update" | "log" | "error" | "health";
+export interface ITestData {
+    set(key: string, value: unknown): void;
+    get(key: string): unknown;
+    has(key: string): boolean;
+    resolve(value: unknown): unknown;
+    getAll(): Record<string, unknown>;
+}
+export interface TestCaseConfig {
+    testData: ITestData;
+    screenshot_mode: ScreenshotMode;
+    record_video: boolean;
+    headless: boolean;
+    executionId: string;
+    timeout: number;
+    slowMo?: number;
+}
+export interface RequestPayload {
+    scripts: Script[];
+    stop_on_failure?: boolean;
+    parallel?: boolean;
+    max_parallel?: number;
+}
+export interface Script {
+    test_script_uid: string;
+    test_case_name?: string;
+    app_id?: string;
+    headless?: boolean;
+    screenshot_mode?: ScreenshotMode;
+    record_video?: boolean;
+    stop_on_failure?: boolean;
+    steps: Step[];
+    browser?: string;
+}
+export interface Step {
+    uid?: string;
+    step_name: string;
+    step_script: string;
+    label?: string;
+    obj_uid?: string;
+    page_uid?: string | null;
+    value?: string;
+    continue_on_failure?: boolean;
+}
+export interface StepResult {
+    uid?: string;
+    obj_uid?: string;
+    step_name: string;
+    step_script?: string;
+    status: StepStatus;
+    page_uid?: string | null;
+    comments: string;
+    screenshot?: string;
+    duration_ms: number;
+    start_time: string;
+    expected_result?: string;
+    skip_reason?: string;
+    label?: string;
+    value?: string;
+    comparison_code?: any;
+}
+export interface ScriptResult {
+    test_script_uid: string;
+    test_case_name: string;
+    step_results: StepResult[];
+    overall_status: ScriptStatus;
+    app_id?: string;
+    duration_ms: number;
+    start_time: string;
+    browser?: string;
+    passed_steps: number;
+    failed_steps: number;
+    skipped_steps: number;
+    total_steps: number;
+}
+export interface ExecutionResult {
+    executionId: string;
+    overall_status: "PASS" | "FAIL" | "CANCELLED";
+    total_scripts: number;
+    passed: number;
+    failed: number;
+    duration_ms: number;
+    results: ScriptResult[];
+}
+export interface QueueJob {
+    executionId: string;
+    status: QueueStatus;
+    payload: RequestPayload;
+    queuedAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    cancelledAt?: string;
+    result?: ExecutionResult;
+    error?: string;
+    cancelRequested: boolean;
+    progress: {
+        total_scripts: number;
+        completed_scripts: number;
+        total_steps: number;
+        completed_steps: number;
+        passed_steps: number;
+        failed_steps: number;
+        skipped_steps: number;
+    };
+}
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp?: string;
+}
+export interface ActionResponse {
+    status: "Pass" | "Fail";
+    comments: string;
+    screenshot?: string;
+    data?: any;
+}
+export interface ParsedStep {
+    action: string;
+    args: string[];
+}
+export type ActionHandler = (args: string[]) => Promise<ActionResponse | undefined>;
+export interface IActionHandler {
+    getActions(): Record<string, ActionHandler>;
+}
+export interface SSEEvent {
+    type: SSEEventType;
+    executionId: string;
+    timestamp: string;
+    data: any;
+}
+export type LogLevel = "DEBUG" | "INFO" | "WARN" | "ERROR";

package/dist/types/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Enums / Literals ────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types/types.ts"],"names":[],"mappings":";AAAA,gFAAgF"}

package/dist/utils/elementHighlight.d.ts

@@ -0,0 +1,35 @@
+import { Page } from "playwright";
+/**
+ * elementHighlight.ts
+ * ===================
+ * Injects a visual highlight into the browser window BEFORE the framework
+ * interacts with an element. This lets the user watching the automation
+ * clearly see which field is being targeted.
+ *
+ * Visual effects:
+ *   • Glowing border (blue for input/click, orange for verify/assertion)
+ *   • Ripple pulse animation
+ *   • Small floating label showing the step action + value
+ *   • Auto-removes after the interaction completes (or on timeout)
+ *
+ * Usage (in handlers):
+ *   await highlightElement(this.page, locatorString, 'input', 'Ravi');
+ *   // ... do the actual interaction ...
+ *   await removeHighlight(this.page);
+ */
+type HighlightType = "input" | "click" | "verify" | "select" | "checkbox";
+/**
+ * Highlights an element in the browser before interacting with it.
+ *
+ * @param page         Playwright Page
+ * @param locator      CSS/XPath locator string (already built)
+ * @param type         Visual type: input | click | verify | select | checkbox
+ * @param labelText    Short text shown in the floating label (e.g. the value being entered)
+ */
+export declare function highlightElement(page: Page, locator: string, type?: HighlightType, labelText?: string): Promise<void>;
+/**
+ * Removes the visual highlight from the page.
+ * Called after the interaction completes (or on failure).
+ */
+export declare function removeHighlight(page: Page): Promise<void>;
+export {};

package/dist/utils/elementHighlight.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.highlightElement = highlightElement;
+exports.removeHighlight = removeHighlight;
+const COLORS = {
+    input: { border: "#3b82f6", bg: "rgba(59,130,246,0.08)", label: "#3b82f6" },
+    click: { border: "#22c55e", bg: "rgba(34,197,94,0.08)", label: "#22c55e" },
+    verify: { border: "#a855f7", bg: "rgba(168,85,247,0.08)", label: "#a855f7" },
+    select: { border: "#f59e0b", bg: "rgba(245,158,11,0.08)", label: "#f59e0b" },
+    checkbox: { border: "#ec4899", bg: "rgba(236,72,153,0.08)", label: "#ec4899" },
+};
+/**
+ * Highlights an element in the browser before interacting with it.
+ *
+ * @param page         Playwright Page
+ * @param locator      CSS/XPath locator string (already built)
+ * @param type         Visual type: input | click | verify | select | checkbox
+ * @param labelText    Short text shown in the floating label (e.g. the value being entered)
+ */
+async function highlightElement(page, locator, type = "input", labelText = "") {
+    const c = COLORS[type];
+    try {
+        await page.evaluate(({ locator, border, bg, labelColor, labelText }) => {
+            // ── Find element ──────────────────────────────────────────────────────
+            let el = null;
+            if (locator.startsWith("//") || locator.startsWith("(//") || locator.startsWith("./")) {
+                // XPath
+                const result = document.evaluate(locator, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null);
+                el = result.singleNodeValue;
+            }
+            else {
+                // CSS
+                try {
+                    el = document.querySelector(locator);
+                }
+                catch { /* bad selector */ }
+            }
+            if (!el || !(el instanceof HTMLElement))
+                return;
+            // ── Remove any previous highlight ─────────────────────────────────────
+            document.querySelectorAll("[data-pw-highlight]").forEach(n => {
+                const orig = n.dataset.pwOrigStyle ?? "";
+                n.style.cssText = orig;
+                delete n.dataset.pwHighlight;
+                delete n.dataset.pwOrigStyle;
+            });
+            document.querySelectorAll("#pw-overlay,#pw-label,#pw-ripple-style").forEach(n => n.remove());
+            // ── Store original style ───────────────────────────────────────────────
+            el.dataset.pwHighlight = "1";
+            el.dataset.pwOrigStyle = el.style.cssText;
+            // ── Apply highlight styles ─────────────────────────────────────────────
+            el.style.outline = `2px solid ${border}`;
+            el.style.outlineOffset = "2px";
+            el.style.boxShadow = `0 0 0 4px ${bg}, 0 0 16px ${border}55`;
+            el.style.transition = "outline .15s, box-shadow .15s";
+            el.style.zIndex = "9999";
+            // ── Scroll element into view (smooth) ─────────────────────────────────
+            el.scrollIntoView({ behavior: "smooth", block: "center", inline: "nearest" });
+            // ── Ripple pulse animation ─────────────────────────────────────────────
+            const style = document.createElement("style");
+            style.id = "pw-ripple-style";
+            style.textContent = `
+          @keyframes pwRipple {
+            0%   { box-shadow: 0 0 0 0 ${border}66, 0 0 0 0 ${border}33; }
+            50%  { box-shadow: 0 0 0 6px ${border}33, 0 0 0 12px ${border}11; }
+            100% { box-shadow: 0 0 0 0 ${border}00, 0 0 0 0 ${border}00; }
+          }
+        `;
+            document.head.appendChild(style);
+            el.style.animation = "pwRipple .7s ease-out";
+            // ── Floating label ─────────────────────────────────────────────────────
+            if (labelText) {
+                const rect = el.getBoundingClientRect();
+                const label = document.createElement("div");
+                label.id = "pw-label";
+                const scrollX = window.scrollX || document.documentElement.scrollLeft;
+                const scrollY = window.scrollY || document.documentElement.scrollTop;
+                // Position above the element; clamp to viewport
+                const top = Math.max(scrollY + rect.top - 36, scrollY + 4);
+                const left = Math.min(Math.max(scrollX + rect.left, scrollX + 4), scrollX + document.documentElement.clientWidth - 240);
+                Object.assign(label.style, {
+                    position: "absolute",
+                    top: `${top}px`,
+                    left: `${left}px`,
+                    zIndex: "2147483647",
+                    background: "#0a0d14",
+                    color: labelColor,
+                    border: `1px solid ${border}`,
+                    borderRadius: "6px",
+                    padding: "3px 10px",
+                    fontSize: "12px",
+                    fontFamily: "-apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif",
+                    fontWeight: "600",
+                    pointerEvents: "none",
+                    whiteSpace: "nowrap",
+                    maxWidth: "260px",
+                    overflow: "hidden",
+                    textOverflow: "ellipsis",
+                    boxShadow: "0 4px 14px rgba(0,0,0,.5)",
+                    animation: "pwFadeIn .15s ease",
+                });
+                const styleTag = document.createElement("style");
+                styleTag.textContent = "@keyframes pwFadeIn{from{opacity:0;transform:translateY(4px)}to{opacity:1;transform:none}}";
+                document.head.appendChild(styleTag);
+                label.textContent = `⚡ ${labelText.length > 40 ? labelText.slice(0, 37) + "…" : labelText}`;
+                document.body.appendChild(label);
+            }
+        }, { locator, border: c.border, bg: c.bg, labelColor: c.label, labelText });
+    }
+    catch {
+        // Highlight is purely cosmetic — never throw
+    }
+}
+/**
+ * Removes the visual highlight from the page.
+ * Called after the interaction completes (or on failure).
+ */
+async function removeHighlight(page) {
+    try {
+        await page.evaluate(() => {
+            document.querySelectorAll("[data-pw-highlight]").forEach(n => {
+                const el = n;
+                el.style.cssText = el.dataset.pwOrigStyle ?? "";
+                el.style.animation = "";
+                delete el.dataset.pwHighlight;
+                delete el.dataset.pwOrigStyle;
+            });
+            document.querySelectorAll("#pw-overlay,#pw-label,#pw-ripple-style").forEach(n => n.remove());
+            document.querySelectorAll("style[textContent*='pwFadeIn'],style[textContent*='pwRipple']").forEach(n => n.remove());
+        });
+    }
+    catch {
+        // Cosmetic — never throw
+    }
+}
+//# sourceMappingURL=elementHighlight.js.map

package/dist/utils/elementHighlight.js.map

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

package/dist/utils/locatorHelper.d.ts

@@ -0,0 +1,7 @@
+/**
+ * buildLocatorString
+ * ==================
+ * Converts strategy + value → Playwright selector string.
+ * Supports all standard and Playwright-native strategies.
+ */
+export declare function buildLocatorString(strategy: string, value: string): string;

package/dist/utils/locatorHelper.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLocatorString = buildLocatorString;
+/**
+ * buildLocatorString
+ * ==================
+ * Converts strategy + value → Playwright selector string.
+ * Supports all standard and Playwright-native strategies.
+ */
+function buildLocatorString(strategy, value) {
+    switch (strategy.toLowerCase().replace(/[_\s-]/g, "")) {
+        case "xpath":
+            return `xpath=${value}`;
+        case "css":
+        case "cssselector":
+            return value;
+        case "id":
+            return `#${value}`;
+        case "name":
+            return `[name="${value}"]`;
+        case "placeholder":
+            return `[placeholder="${value}"]`;
+        case "text":
+        case "linktext":
+            return `text=${value}`;
+        case "partiallinktext":
+        case "partialtext":
+            return `text=${value}`;
+        case "classname":
+        case "class":
+            return `.${value}`;
+        case "tagname":
+        case "tag":
+            return value;
+        case "testid":
+        case "datatestid":
+            return `[data-testid="${value}"]`;
+        case "label":
+            return `label=${value}`;
+        case "arialabel":
+            return `[aria-label="${value}"]`;
+        case "role":
+            return `[role="${value}"]`;
+        case "title":
+            return `[title="${value}"]`;
+        case "value":
+            return `[value="${value}"]`;
+        default:
+            console.warn(`[WARN] Unknown strategy "${strategy}", treating as CSS`);
+            return value;
+    }
+}
+//# sourceMappingURL=locatorHelper.js.map

package/dist/utils/locatorHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locatorHelper.js","sourceRoot":"","sources":["../../src/utils/locatorHelper.ts"],"names":[],"mappings":";;AAMA,gDA0CC;AAhDD;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,KAAa;IAChE,QAAQ,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;QACtD,KAAK,OAAO;YACV,OAAO,SAAS,KAAK,EAAE,CAAC;QAC1B,KAAK,KAAK,CAAC;QACX,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC;QACf,KAAK,IAAI;YACP,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,UAAU,KAAK,IAAI,CAAC;QAC7B,KAAK,aAAa;YAChB,OAAO,iBAAiB,KAAK,IAAI,CAAC;QACpC,KAAK,MAAM,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,QAAQ,KAAK,EAAE,CAAC;QACzB,KAAK,iBAAiB,CAAC;QACvB,KAAK,aAAa;YAChB,OAAO,QAAQ,KAAK,EAAE,CAAC;QACzB,KAAK,WAAW,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,IAAI,KAAK,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC;QACf,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY;YACf,OAAO,iBAAiB,KAAK,IAAI,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,SAAS,KAAK,EAAE,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,gBAAgB,KAAK,IAAI,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,UAAU,KAAK,IAAI,CAAC;QAC7B,KAAK,OAAO;YACV,OAAO,WAAW,KAAK,IAAI,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,WAAW,KAAK,IAAI,CAAC;QAC9B;YACE,OAAO,CAAC,IAAI,CAAC,4BAA4B,QAAQ,oBAAoB,CAAC,CAAC;YACvE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}