@empiricalrun/playwright-utils 0.63.0 → 0.63.1

package/dist/overlay-tests/cache.spec.js

@@ -13,11 +13,11 @@ const useCache = (data) => {
         version: "2025-03-06",
         data,
     };
-    const dir = path_1.default.dirname(cache_1.CACHE_FILE);
+    const dir = path_1.default.dirname((0, cache_1.cacheFile)());
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
-    fs_1.default.writeFileSync(cache_1.CACHE_FILE, JSON.stringify(cacheValue, null, 2), "utf8");
+    fs_1.default.writeFileSync((0, cache_1.cacheFile)(), JSON.stringify(cacheValue, null, 2), "utf8");
 };
 // Unsets env vars for the duration of a test and puts them back exactly as they
 // were — assigning `undefined` to process.env would store the string
@@ -41,11 +41,6 @@ function clearEnv(names) {
 fixtures_1.test.beforeEach(async ({ page }) => {
     (0, test_1.injectLocatorHighlightScripts)(page, fixtures_1.test);
 });
-fixtures_1.test.afterEach(() => {
-    if (fs_1.default.existsSync(cache_1.CACHE_FILE)) {
-        fs_1.default.unlinkSync(cache_1.CACHE_FILE);
-    }
-});
 (0, fixtures_1.test)("overlay dismiss should not trigger recursively when executing from cache", async ({ page, server, }) => {
     useCache([
         {
@@ -68,3 +63,32 @@ fixtures_1.test.afterEach(() => {
     (0, fixtures_1.expect)(error).toBeDefined();
     (0, fixtures_1.expect)(error.message).toContain('<div class="glass-pane"></div> intercepts pointer events');
 });
+for (const clickMode of ["mouse", "dispatch"]) {
+    (0, fixtures_1.test)(`cached dismissal in ${clickMode} mode keeps the test's listbox open`, async ({ page, server, }) => {
+        fixtures_1.test.fail(clickMode === "mouse", "A mouse click replayed on the toast is a pointerdown outside the listbox, which closes it");
+        await page.goto(`${server.baseURL}/dropdown-toast.html`);
+        await page.getByRole("combobox", { name: "Usage month" }).click();
+        const toast = page.getByRole("status", { name: "Notifications" });
+        await (0, fixtures_1.expect)(toast).toBeVisible();
+        const toastText = await toast.evaluate((el) => el.textContent?.trim().replace(/\s+/g, " ") ?? "");
+        useCache([
+            {
+                element: {
+                    dom: '<section id="toast" role="status" aria-label="Notifications">',
+                    textContent: toastText,
+                },
+                code: `await page.getByRole('button', { name: 'Later' }).click();\n`,
+            },
+        ]);
+        const restoreEnv = clearEnv(["EMPIRICALRUN_API_KEY", "OPENAI_BASE_URL"]);
+        process.env.EMPIRICALRUN_OVERLAY_CLICK_MODE = clickMode;
+        try {
+            await page.getByRole("option", { name: "September" }).click();
+        }
+        finally {
+            delete process.env.EMPIRICALRUN_OVERLAY_CLICK_MODE;
+            restoreEnv();
+        }
+        await (0, fixtures_1.expect)(page.locator("#status")).toHaveText("Showing usage for September (1280 credits)");
+    });
+}

package/dist/overlay-tests/click.spec.js

@@ -10,13 +10,8 @@ const fixtures_1 = require("./fixtures");
 fixtures_1.test.beforeEach(async ({ page }) => {
     (0, test_1.injectLocatorHighlightScripts)(page, fixtures_1.test);
 });
-fixtures_1.test.afterAll(async () => {
-    if (fs_1.default.existsSync(cache_1.CACHE_FILE)) {
-        fs_1.default.unlinkSync(cache_1.CACHE_FILE);
-    }
-});
 function getCacheDataWithDom({ dom }) {
-    const cacheData = JSON.parse(fs_1.default.readFileSync(cache_1.CACHE_FILE, "utf8"));
+    const cacheData = JSON.parse(fs_1.default.readFileSync((0, cache_1.cacheFile)(), "utf8"));
     return cacheData.data.find(({ element }) => {
         if (dom) {
             return element.dom.includes(dom);
@@ -25,7 +20,7 @@ function getCacheDataWithDom({ dom }) {
     });
 }
 function getCacheDataWithTextContent({ textContent }) {
-    const cacheData = JSON.parse(fs_1.default.readFileSync(cache_1.CACHE_FILE, "utf8"));
+    const cacheData = JSON.parse(fs_1.default.readFileSync((0, cache_1.cacheFile)(), "utf8"));
     return cacheData.data.find(({ element }) => {
         if (textContent) {
             return element.textContent.includes(textContent);

package/dist/overlay-tests/dismiss-mechanics.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dismiss-mechanics.spec.d.ts.map

package/dist/overlay-tests/dismiss-mechanics.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-mechanics.spec.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/dismiss-mechanics.spec.ts"],"names":[],"mappings":""}

package/dist/overlay-tests/dismiss-mechanics.spec.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fixtures_1 = require("./fixtures");
+const dismissals = {
+    "native click": (page) => page.getByRole("button", { name: "Later" }).click(),
+    "dispatched click": (page) => page.getByRole("button", { name: "Later" }).dispatchEvent("click"),
+    "Escape key": (page) => page.keyboard.press("Escape"),
+};
+const keepsListboxOpen = {
+    pointerdown: {
+        "native click": false,
+        "dispatched click": true,
+        "Escape key": false,
+    },
+    focusout: {
+        "native click": false,
+        "dispatched click": true,
+        "Escape key": false,
+    },
+};
+for (const [closeOn, expectations] of Object.entries(keepsListboxOpen)) {
+    for (const [name, keepsOpen] of Object.entries(expectations)) {
+        (0, fixtures_1.test)(`${name} on a toast ${keepsOpen ? "keeps" : "closes"} a listbox that closes on ${closeOn}`, async ({ page, server, }) => {
+            await page.goto(`${server.baseURL}/dropdown-toast.html?close=${closeOn}`);
+            await page.getByRole("combobox", { name: "Usage month" }).click();
+            const listbox = page.getByRole("listbox", { name: "Months" });
+            await (0, fixtures_1.expect)(listbox).toBeVisible();
+            await (0, fixtures_1.expect)(page.getByText("Install our CLI for your coding agents")).toBeVisible();
+            await dismissals[name](page);
+            await (0, fixtures_1.expect)(page.getByText("Install our CLI for your coding agents")).toBeVisible({ visible: name === "Escape key" });
+            await (0, fixtures_1.expect)(listbox).toBeVisible({ visible: keepsOpen });
+        });
+    }
+}
+(0, fixtures_1.test)("dispatched click lets the test finish selecting a month", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/dropdown-toast.html?close=pointerdown`);
+    await page.getByRole("combobox", { name: "Usage month" }).click();
+    await (0, fixtures_1.expect)(page.getByText("Install our CLI for your coding agents")).toBeVisible();
+    await page.getByRole("button", { name: "Later" }).dispatchEvent("click");
+    const response = page.waitForResponse(/usage\.json/);
+    await page.getByRole("option", { name: "September" }).click();
+    await response;
+    await (0, fixtures_1.expect)(page.locator("#status")).toHaveText("Showing usage for September (1280 credits)");
+});
+(0, fixtures_1.test)("Escape on an open date picker throws away the picked date", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/datepicker.html`);
+    await page.getByPlaceholder("Pick a date").click();
+    await page.getByRole("grid").getByRole("button", { name: "15" }).click();
+    await page.keyboard.press("Escape");
+    await page.getByRole("button", { name: "Save" }).click();
+    await (0, fixtures_1.expect)(page.locator("#status")).toHaveText("Saved without a date");
+});
+(0, fixtures_1.test)("Escape on open search results clears the query", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/search-results.html`);
+    await page.getByRole("searchbox", { name: "Search assets" }).fill("orders");
+    await (0, fixtures_1.expect)(page.getByText("Showing 74 results")).toBeVisible();
+    await page.keyboard.press("Escape");
+    await (0, fixtures_1.expect)(page.getByRole("searchbox", { name: "Search assets" })).toHaveValue("");
+});

package/dist/overlay-tests/dropdown.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dropdown.spec.d.ts.map

package/dist/overlay-tests/dropdown.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown.spec.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/dropdown.spec.ts"],"names":[],"mappings":""}

package/dist/overlay-tests/dropdown.spec.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("../test");
+const fixtures_1 = require("./fixtures");
+fixtures_1.test.beforeEach(async ({ page }) => {
+    (0, test_1.injectLocatorHighlightScripts)(page, fixtures_1.test);
+});
+async function openMonthsUnderToast(page) {
+    await page.getByRole("combobox", { name: "Usage month" }).click();
+    await (0, fixtures_1.expect)(page.getByText("Install our CLI for your coding agents")).toBeVisible();
+}
+for (const clickMode of ["mouse", "dispatch"]) {
+    fixtures_1.test.describe(`overlay click mode: ${clickMode}`, () => {
+        fixtures_1.test.beforeEach(() => {
+            process.env.EMPIRICALRUN_OVERLAY_CLICK_MODE = clickMode;
+        });
+        fixtures_1.test.afterEach(() => {
+            delete process.env.EMPIRICALRUN_OVERLAY_CLICK_MODE;
+        });
+        (0, fixtures_1.test)("selects a month through a toast covering the open listbox", async ({ page, server, }) => {
+            fixtures_1.test.fail(clickMode === "mouse", "A mouse click on the toast is a pointerdown outside the listbox, which closes it before the retried click");
+            await page.goto(`${server.baseURL}/dropdown-toast.html`);
+            await openMonthsUnderToast(page);
+            await page.getByRole("option", { name: "September" }).click();
+            await (0, fixtures_1.expect)(page.locator("#status")).toHaveText("Showing usage for September (1280 credits)");
+        });
+    });
+}
+(0, fixtures_1.test)("usage response wait survives a toast covering the listbox", async ({ page, server, }) => {
+    fixtures_1.test.fail(true, "waitForResponse times out while the click waits out its actionability timeout, before any dismissal runs");
+    await page.goto(`${server.baseURL}/dropdown-toast.html`);
+    await openMonthsUnderToast(page);
+    await Promise.all([
+        page.waitForResponse(/usage\.json/),
+        page.getByRole("option", { name: "September" }).click(),
+    ]);
+});
+(0, fixtures_1.test)("saves with the picked date when the open date picker covers Save", async ({ page, server, }) => {
+    fixtures_1.test.skip(true, "Not deterministic: the agent keeps the picked date in some runs and loses it in others");
+    await page.goto(`${server.baseURL}/datepicker.html`);
+    await page.getByPlaceholder("Pick a date").click();
+    await page.getByRole("grid").getByRole("button", { name: "15" }).click();
+    await page.getByRole("button", { name: "Save" }).click();
+    await (0, fixtures_1.expect)(page.locator("#status")).toHaveText("Saved for 2026-09-15");
+});
+(0, fixtures_1.test)("keeps the search query when open results cover a filter", async ({ page, server, }) => {
+    fixtures_1.test.skip(true, "Not deterministic: the agent keeps the query in some runs and clears it in others");
+    await page.goto(`${server.baseURL}/search-results.html`);
+    await page.getByRole("searchbox", { name: "Search assets" }).fill("orders");
+    await (0, fixtures_1.expect)(page.getByText("Showing 74 results")).toBeVisible();
+    await page.getByRole("button", { name: "Verified" }).click();
+    await (0, fixtures_1.expect)(page.locator("#status")).toHaveText('Query "orders", verified only: true');
+});

package/dist/overlay-tests/fixtures.d.ts

@@ -3,7 +3,9 @@ type ServerFixture = {
     baseURL: string;
 };
 export declare const expect: import("@playwright/test").Expect<{}>;
-export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & {
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
+    overlayCacheFile: string;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & {
     server: ServerFixture;
 }>;
 export {};

package/dist/overlay-tests/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/fixtures.ts"],"names":[],"mappings":"AAKA,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,MAAM,uCAAc,CAAC;AAClC,eAAO,MAAM,IAAI;YAA6B,aAAa;EAuBzD,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/fixtures.ts"],"names":[],"mappings":"AAKA,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,MAAM,uCAAc,CAAC;AAClC,eAAO,MAAM,IAAI;sBACK,MAAM;;YAChB,aAAa;EAsCvB,CAAC"}

package/dist/overlay-tests/fixtures.js

@@ -10,6 +10,21 @@ const path_1 = __importDefault(require("path"));
 const serve_handler_1 = __importDefault(require("serve-handler"));
 exports.expect = test_1.test.expect;
 exports.test = test_1.test.extend({
+    overlayCacheFile: [
+        async ({}, use, testInfo) => {
+            const previous = process.env.EMPIRICALRUN_OVERLAY_CACHE_FILE;
+            const file = testInfo.outputPath("overlay-cache.json");
+            process.env.EMPIRICALRUN_OVERLAY_CACHE_FILE = file;
+            await use(file);
+            if (previous === undefined) {
+                delete process.env.EMPIRICALRUN_OVERLAY_CACHE_FILE;
+            }
+            else {
+                process.env.EMPIRICALRUN_OVERLAY_CACHE_FILE = previous;
+            }
+        },
+        { auto: true },
+    ],
     server: [
         async ({}, use, workerInfo) => {
             const port = 1234 + workerInfo.workerIndex;

package/dist/overlay-tests/typesafe-hit-check.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typesafe-hit-check.spec.d.ts.map

package/dist/overlay-tests/typesafe-hit-check.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe-hit-check.spec.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/typesafe-hit-check.spec.ts"],"names":[],"mappings":""}

package/dist/overlay-tests/typesafe-hit-check.spec.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const typesafe_1 = require("../test/scripts/pw-locator-patch/dismiss-overlays/typesafe");
+const fixtures_1 = require("./fixtures");
+async function centerOf(locator) {
+    const box = await locator.boundingBox();
+    if (!box) {
+        throw new Error("Element has no bounding box");
+    }
+    return { x: box.x + box.width / 2, y: box.y + box.height / 2 };
+}
+(0, fixtures_1.test)("allows the toast close button", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/choose-an-overlay.html`);
+    const target = await page
+        .getByRole("button", { name: "Target" })
+        .elementHandle();
+    const point = await centerOf(page.locator("#toastCloseBtn"));
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, point)).toBe("ok");
+});
+(0, fixtures_1.test)("refuses the dialog behind a toast that blocks the target", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/choose-an-overlay.html`);
+    const target = await page
+        .getByRole("button", { name: "Target" })
+        .elementHandle();
+    const point = await centerOf(page.getByRole("button", { name: "Noted" }));
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, point)).toBe("outside_overlay");
+});
+(0, fixtures_1.test)("refuses a page control outside the blocking toast", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/toast-without-close.html`);
+    const target = await page
+        .getByRole("button", { name: "Target" })
+        .elementHandle();
+    const point = await centerOf(page.getByRole("button", { name: "Close project" }));
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, point)).toBe("outside_overlay");
+});
+(0, fixtures_1.test)("refuses text inside the blocking toast", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/toast-without-close.html`);
+    const target = await page
+        .getByRole("button", { name: "Target" })
+        .elementHandle();
+    const point = await centerOf(page.locator("#toast"));
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, point)).toBe("not_clickable");
+});
+(0, fixtures_1.test)("refuses the target under a glass pane", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/glass-pane.html`);
+    const target = await page
+        .getByRole("button", { name: "Target" })
+        .elementHandle();
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, await centerOf(page.getByRole("button", { name: "Target" })))).toBe("not_clickable");
+});
+(0, fixtures_1.test)("reports no blocker when the target is uncovered", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/toast-without-close.html`);
+    const target = await page
+        .getByRole("button", { name: "Close project" })
+        .elementHandle();
+    (0, fixtures_1.expect)(await (0, typesafe_1.checkHit)(target, await centerOf(page.getByRole("button", { name: "Close project" })))).toBe("no_blocker");
+});

package/dist/overlay-tests/typesafe.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typesafe.spec.d.ts.map

package/dist/overlay-tests/typesafe.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.spec.d.ts","sourceRoot":"","sources":["../../src/overlay-tests/typesafe.spec.ts"],"names":[],"mappings":""}

package/dist/overlay-tests/typesafe.spec.js

@@ -0,0 +1,86 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const dismiss_overlays_1 = require("../test/scripts/pw-locator-patch/dismiss-overlays");
+const typesafe_1 = require("../test/scripts/pw-locator-patch/dismiss-overlays/typesafe");
+const utils_1 = require("../test/scripts/pw-locator-patch/dismiss-overlays/utils");
+const fixtures_1 = require("./fixtures");
+fixtures_1.test.skip(!process.env.TYPESAFE_API_KEY, "TYPESAFE_API_KEY is not set");
+const RESULTS_FILE = node_path_1.default.join(process.cwd(), "test-results", "typesafe-overlay-results.jsonl");
+const DISMISS_ATTEMPTS = 3;
+async function actWithTypeSafeDismissal(page, target, action) {
+    const results = [];
+    for (let attempt = 0;; attempt++) {
+        try {
+            await target[action]({ timeout: 3_000 });
+            return results;
+        }
+        catch (error) {
+            if (attempt === DISMISS_ATTEMPTS || !(0, dismiss_overlays_1.isErrorSupported)(error.message)) {
+                throw error;
+            }
+            const element = (0, dismiss_overlays_1.extractInterceptingElement)(error.message);
+            const text = await (0, utils_1.textContent)(page, element);
+            const result = await (0, typesafe_1.dismissWithTypeSafe)(page, {
+                text,
+                target: await target.elementHandle(),
+            });
+            results.push(result);
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(RESULTS_FILE), { recursive: true });
+            node_fs_1.default.appendFileSync(RESULTS_FILE, JSON.stringify({
+                test: fixtures_1.test.info().title,
+                attempt,
+                overlayText: text,
+                ...result,
+            }) + "\n");
+            if (!result.dismissed) {
+                throw error;
+            }
+        }
+    }
+}
+(0, fixtures_1.test)("dismisses the toast but not the dialog", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/choose-an-overlay.html`);
+    await actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click");
+    await (0, fixtures_1.expect)(page.getByText("This is a toast message")).not.toBeVisible();
+    await (0, fixtures_1.expect)(page.getByRole("heading", { name: "Center Overlay" })).toBeVisible();
+});
+(0, fixtures_1.test)("ticks the checkbox and accepts terms", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/tos.html`);
+    page.on("dialog", (dialog) => dialog.dismiss());
+    await actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click");
+    await (0, fixtures_1.expect)(page.getByRole("heading", { name: "Terms of Service" })).not.toBeVisible();
+});
+(0, fixtures_1.test)("dismisses a product tour and terms in sequence", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/loop-to-dismiss.html`);
+    await actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click");
+    await (0, fixtures_1.expect)(page.getByText("Clicked!")).toBeVisible();
+});
+(0, fixtures_1.test)("dismisses a Survicate survey for hover", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/survey.html`);
+    await (0, fixtures_1.expect)(page.getByText("Start survey")).toBeVisible({ timeout: 15_000 });
+    await actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Click target" }), "hover");
+});
+(0, fixtures_1.test)("cannot fill a form overlay", async ({ page, server }) => {
+    await page.goto(`${server.baseURL}/overlay-form.html`);
+    await (0, fixtures_1.expect)(actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click")).rejects.toThrow();
+});
+(0, fixtures_1.test)("does not click a page control when the toast has no close button", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/toast-without-close.html`);
+    await (0, fixtures_1.expect)(actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click")).rejects.toThrow();
+    await (0, fixtures_1.expect)(page.getByText("Project closed")).not.toBeVisible();
+});
+(0, fixtures_1.test)("does not click anything for an invisible glass pane", async ({ page, server, }) => {
+    await page.goto(`${server.baseURL}/glass-pane.html`);
+    let dialogOpened = false;
+    page.on("dialog", (dialog) => {
+        dialogOpened = true;
+        return dialog.dismiss();
+    });
+    await (0, fixtures_1.expect)(actWithTypeSafeDismissal(page, page.getByRole("button", { name: "Target" }), "click")).rejects.toThrow();
+    (0, fixtures_1.expect)(dialogOpened).toBe(false);
+});

package/dist/test/scripts/pw-locator-patch/actions/click.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/actions/click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,wBAAgB,UAAU,CACxB,YAAY,EAAE,QAAQ,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAC/C,MAAM,EAAE,MAAM,QAsDf"}
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/actions/click.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAWrC,wBAAgB,UAAU,CACxB,YAAY,EAAE,QAAQ,GAAG;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,EAC/C,MAAM,EAAE,MAAM,QA+Df"}

package/dist/test/scripts/pw-locator-patch/actions/click.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.patchClick = patchClick;
+const cua_1 = require("@empiricalrun/cua");
 const dismiss_overlays_1 = require("../dismiss-overlays");
 const utils_1 = require("../dismiss-overlays/utils");
 const utils_2 = require("../utils");
@@ -15,6 +16,13 @@ function patchClick(LocatorClass, testFn) {
     LocatorClass.prototype.click = async function (options) {
         const stepName = `locator.click(${(0, utils_2.description)(this)})`;
         return await testFn.step(stepName, async () => {
+            if (options?.isExecutingForOverlayDismiss &&
+                (0, dismiss_overlays_1.overlayClickMode)() === "dispatch" &&
+                !(await this.evaluate(cua_1.needsFocus, undefined, {
+                    timeout: options.timeout,
+                }))) {
+                return await this.dispatchEvent("click");
+            }
             let overlayAttemptsRemaining = 2;
             let originalError;
             const overlayDismiss = new dismiss_overlays_1.OverlayDismissAgent(this._frame._page);

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/cache.d.ts

@@ -1,5 +1,5 @@
 import type { Page } from "@playwright/test";
-export declare const CACHE_FILE: string;
+export declare function cacheFile(): string;
 export declare function setCodeToCache({ dom, text, code, }: {
     dom: string | undefined;
     text: string | undefined;

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/dismiss-overlays/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAM7C,eAAO,MAAM,UAAU,QAItB,CAAC;AAMF,wBAAsB,cAAc,CAAC,EACnC,GAAG,EACH,IAAI,EACJ,IAAI,GACL,EAAE;IACD,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,iBAgCA;AAED,wBAAsB,gBAAgB,CAAC,EACrC,IAAI,EACJ,GAAG,EACH,IAAI,GACL,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAiChC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,UAY5C"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/dismiss-overlays/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAM7C,wBAAgB,SAAS,WAKxB;AAMD,wBAAsB,cAAc,CAAC,EACnC,GAAG,EACH,IAAI,EACJ,IAAI,GACL,EAAE;IACD,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,iBAgCA;AAED,wBAAsB,gBAAgB,CAAC,EACrC,IAAI,EACJ,GAAG,EACH,IAAI,GACL,EAAE;IACD,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAiChC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,UAY5C"}

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/cache.js

@@ -3,13 +3,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CACHE_FILE = void 0;
+exports.cacheFile = cacheFile;
 exports.setCodeToCache = setCodeToCache;
 exports.executeFromCache = executeFromCache;
 exports.addOverlayOption = addOverlayOption;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-exports.CACHE_FILE = path_1.default.join(process.cwd(), ".empiricalrun", `overlay-cache.json`);
+function cacheFile() {
+    return (process.env.EMPIRICALRUN_OVERLAY_CACHE_FILE ??
+        path_1.default.join(process.cwd(), ".empiricalrun", "overlay-cache.json"));
+}
 function normalizeString(str) {
     return str.replace(/\s+/g, " ").trim();
 }
@@ -32,7 +35,7 @@ async function setCodeToCache({ dom, text, code, }) {
         data: [],
     };
     try {
-        cache = JSON.parse(fs_1.default.readFileSync(exports.CACHE_FILE, "utf8"));
+        cache = JSON.parse(fs_1.default.readFileSync(cacheFile(), "utf8"));
         cache.data.push(obj);
     }
     catch {
@@ -41,18 +44,18 @@ async function setCodeToCache({ dom, text, code, }) {
             data: [obj],
         };
     }
-    const dir = path_1.default.dirname(exports.CACHE_FILE);
+    const dir = path_1.default.dirname(cacheFile());
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
-    fs_1.default.writeFileSync(exports.CACHE_FILE, JSON.stringify(cache, null, 2));
+    fs_1.default.writeFileSync(cacheFile(), JSON.stringify(cache, null, 2));
 }
 async function executeFromCache({ page, dom, text, }) {
     if (!dom && !text) {
         return { success: false };
     }
     try {
-        const cache = JSON.parse(fs_1.default.readFileSync(exports.CACHE_FILE, "utf8"));
+        const cache = JSON.parse(fs_1.default.readFileSync(cacheFile(), "utf8"));
         const match = cache.data.find((c) => {
             return (c.element.dom === (dom || "") &&
                 c.element.textContent === normalizeString(text || ""));

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/index.d.ts

@@ -1,6 +1,8 @@
+import { type ClickMode } from "@empiricalrun/cua";
 import { Page } from "@playwright/test";
 import type { TestFn } from "../../types";
 import type { OverlayElement } from "./types";
+export declare function overlayClickMode(): ClickMode;
 export declare function isErrorSupported(errorMessage: string | undefined): boolean;
 export declare class OverlayDismissAgent {
     private readonly page;
@@ -8,6 +10,7 @@ export declare class OverlayDismissAgent {
     constructor(page: Page);
     saveToCache(): Promise<void>;
     run(originalError: any, reporter: (description: string) => void, testFn: TestFn): Promise<void>;
+    private dismiss;
     private runAgent;
 }
 export declare function extractInterceptingElement(errorMessage: string): OverlayElement | undefined;

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/dismiss-overlays/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,WAKhE;AAED,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,iBAAiB,CAIhB;IAET,YAA6B,IAAI,EAAE,IAAI,EAAI;IAErC,WAAW,kBAIhB;IAEK,GAAG,CACP,aAAa,EAAE,GAAG,EAClB,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqDf;YAEa,QAAQ;CA+BvB;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAiC5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/dismiss-overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAW9C,wBAAgB,gBAAgB,IAAI,SAAS,CAI5C;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,WAKhE;AAED,qBAAa,mBAAmB;IAOlB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,iBAAiB,CAIhB;IAET,YAA6B,IAAI,EAAE,IAAI,EAAI;IAErC,WAAW,kBAIhB;IAEK,GAAG,CACP,aAAa,EAAE,GAAG,EAClB,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,EACvC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf;YAEa,OAAO;YAwDP,QAAQ;CAkCvB;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,GACnB,cAAc,GAAG,SAAS,CAiC5B"}

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OverlayDismissAgent = void 0;
+exports.overlayClickMode = overlayClickMode;
 exports.isErrorSupported = isErrorSupported;
 exports.extractInterceptingElement = extractInterceptingElement;
 const cua_1 = require("@empiricalrun/cua");
@@ -10,6 +11,11 @@ const cache_1 = require("./cache");
 const prompt_1 = require("./prompt");
 const utils_1 = require("./utils");
 const ERROR_SUBSTRING_INTERCEPTION = "intercepts pointer events";
+function overlayClickMode() {
+    return process.env.EMPIRICALRUN_OVERLAY_CLICK_MODE === "dispatch"
+        ? "dispatch"
+        : "mouse";
+}
 function isErrorSupported(errorMessage) {
     if (!errorMessage) {
         return false;
@@ -28,12 +34,15 @@ class OverlayDismissAgent {
         }
     }
     async run(originalError, reporter, testFn) {
-        const startTime = Date.now();
         let element;
         try {
             element = extractInterceptingElement(originalError.message);
         }
         catch { }
+        await testFn.step((0, utils_1.dismissOverlayStepTitle)(element), () => this.dismiss(element, originalError, reporter, testFn), { box: true });
+    }
+    async dismiss(element, originalError, reporter, testFn) {
+        const startTime = Date.now();
         const description = (0, utils_1.overlayDescription)(element) ?? "unknown";
         const testName = testFn.info().title;
         reporter(`Attempting to auto-dismiss overlay: ${description}`);
@@ -83,7 +92,7 @@ class OverlayDismissAgent {
     async runAgent(element, text, testFn) {
         const task = await (0, prompt_1.getTask)(this.page, element, text);
         const trace = (0, utils_1.traceThis)(task, testFn);
-        const result = await (0, cua_1.createTestUsingComputerUseAgent)({
+        const result = await testFn.step(utils_1.DISMISSAL_AGENT_STEP, () => (0, cua_1.createTestUsingComputerUseAgent)({
             page: this.page,
             task,
             trace,
@@ -96,7 +105,8 @@ class OverlayDismissAgent {
             prefersElementFromPointCodegen: true,
             includePageGotoTool: false,
             openAIClientConfig: (0, api_worker_client_1.llmProxyOpenAIConfig)(),
-        });
+            clickMode: overlayClickMode(),
+        }));
         this.cachingCandidates.push({
             dom: element?.interceptor,
             text,

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/typesafe.d.ts

@@ -0,0 +1,38 @@
+import type { ElementHandle, Page } from "playwright-core";
+type Box = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export type TypeSafeDismissStep = {
+    popupProbability: number;
+    box: Box;
+    boxConfidence: number;
+    clicked: {
+        x: number;
+        y: number;
+    } | undefined;
+    hitCheck: HitCheck | undefined;
+    latencyMs: number;
+    inputTokens: number;
+    outputTokens: number;
+};
+type Point = {
+    x: number;
+    y: number;
+};
+type HitCheck = "ok" | "no_blocker" | "outside_overlay" | "not_clickable";
+export type TypeSafeStopReason = "popup_gone" | "low_box_confidence" | Exclude<HitCheck, "ok"> | "no_visual_change" | "max_steps";
+export type TypeSafeDismissResult = {
+    dismissed: boolean;
+    stopReason: TypeSafeStopReason;
+    steps: TypeSafeDismissStep[];
+};
+export declare function dismissWithTypeSafe(page: Page, overlay: {
+    text: string | undefined;
+    target: ElementHandle<Element>;
+}): Promise<TypeSafeDismissResult>;
+export declare function checkHit(target: ElementHandle<Element>, point: Point): Promise<"no_blocker" | "not_clickable" | "ok" | "outside_overlay">;
+export {};
+//# sourceMappingURL=typesafe.d.ts.map

package/dist/test/scripts/pw-locator-patch/dismiss-overlays/typesafe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe.d.ts","sourceRoot":"","sources":["../../../../../src/test/scripts/pw-locator-patch/dismiss-overlays/typesafe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAQ3D,KAAK,GAAG,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAWxE,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,GAAG,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC9C,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,KAAK,QAAQ,GAAG,IAAI,GAAG,YAAY,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,oBAAoB,GACpB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,GACvB,kBAAkB,GAClB,WAAW,CAAC;AAEhB,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAAE,GACpE,OAAO,CAAC,qBAAqB,CAAC,CAoDhC;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,sEAyDpE"}