@empiricalrun/playwright-utils 0.62.1 → 0.63.1

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

@@ -13,12 +13,11 @@ const useCache = (data) => {
         version: "2025-03-06",
         data,
     };
-    // Ensure the directory exists
-    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
@@ -42,14 +41,7 @@ function clearEnv(names) {
 fixtures_1.test.beforeEach(async ({ page }) => {
     (0, test_1.injectLocatorHighlightScripts)(page, fixtures_1.test);
 });
-fixtures_1.test.afterEach(() => {
-    // Delete overlay cache
-    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, }) => {
-    // Set up cache with a bad value: click on "Target" to dimiss the glass pane
     useCache([
         {
             element: { dom: '<div class="glass-pane">', textContent: "" },
@@ -58,15 +50,8 @@ fixtures_1.test.afterEach(() => {
     ]);
     await page.goto(`${server.baseURL}/glass-pane.html`);
     let error;
-    // The only two routes the browser agent has to a model: the project API key
-    // (api-worker's proxy) and a sandbox's OPENAI_BASE_URL. Clearing both makes
-    // llmProxyOpenAIConfig throw before any request — which matters here more
-    // than elsewhere, because this is the recursive case and every extra
-    // dismissal would spawn another agent and another set of screenshots.
     const restoreEnv = clearEnv(["EMPIRICALRUN_API_KEY", "OPENAI_BASE_URL"]);
     try {
-        // Target element click will trigger the cache - which will invoke another
-        // click to the same element (recursive overlay dismissal)
         await page.getByRole("button", { name: "Target" }).click();
     }
     catch (e) {
@@ -78,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,14 +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 () => {
-    // Delete overlay cache
-    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);
@@ -26,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);
@@ -36,28 +30,20 @@ function getCacheDataWithTextContent({ textContent }) {
 }
 (0, fixtures_1.test)("should dismiss survicate for hover", async ({ page, server }) => {
     await page.goto(`${server.baseURL}/survey.html`);
-    // Assert that Survicate and button loads
     await (0, fixtures_1.expect)(page.getByText("Start survey")).toBeVisible();
     const targetButton = page.getByRole("button", { name: "Target" });
     await (0, fixtures_1.expect)(targetButton).toBeVisible();
-    // Get initial z-index
     const initialZIndex = await targetButton.evaluate((el) => window.getComputedStyle(el).getPropertyValue("z-index"));
-    // Do the hover, which should pass after survey overlay is dismissed
     await targetButton.hover();
-    // Assert z-index hasn't changed
     const finalZIndex = await targetButton.evaluate((el) => window.getComputedStyle(el).getPropertyValue("z-index"));
     (0, fixtures_1.expect)(finalZIndex).toBe(initialZIndex);
 });
-// Skipped since it's flaky
 fixtures_1.test.skip("should dismiss two-step overlay for click", async ({ page, server, }) => {
     await page.goto(`${server.baseURL}/tos.html`);
-    // Assert that button and overlay load
     await (0, fixtures_1.expect)(page.getByRole("button", { name: "Target" })).toBeVisible();
     await (0, fixtures_1.expect)(page.getByRole("heading", { name: "Terms of Service" })).toBeVisible();
-    // Do the click, which should pass
     await page.getByRole("button", { name: "Target" }).click();
     await (0, fixtures_1.expect)(page.getByRole("heading", { name: "Terms of Service" })).not.toBeVisible();
-    // Assert cache is correct
     const withDom = getCacheDataWithDom({
         dom: '<div class="terms-text">',
     });
@@ -75,7 +61,6 @@ fixtures_1.test.skip("should dismiss two-step overlay for click", async ({ page,
     await page.goto(`${server.baseURL}/overlay-form.html`);
     await page.getByRole("button", { name: "Target" }).click();
     await (0, fixtures_1.expect)(page.getByText("Target was clicked")).toBeVisible();
-    // Assert cache is correct
     const withDom = getCacheDataWithDom({
         dom: 'id="hearAboutUs"',
     });
@@ -92,16 +77,12 @@ fixtures_1.test.skip("should dismiss two-step overlay for click", async ({ page,
 });
 (0, fixtures_1.test)("should choose and dismiss the correct overlay", async ({ page, server, }) => {
     await page.goto(`${server.baseURL}/choose-an-overlay.html`);
-    // Assert that button and overlays load
     await (0, fixtures_1.expect)(page.getByRole("button", { name: "Target" })).toBeVisible();
     await (0, fixtures_1.expect)(page.getByText("This is a toast message")).toBeVisible();
     await (0, fixtures_1.expect)(page.getByRole("button", { name: "Close" })).toBeVisible();
-    // Do the click, which should pass
     await page.getByRole("button", { name: "Target" }).click();
-    // Assert correct overlay was dismissed
     await (0, fixtures_1.expect)(page.getByText("This is a toast message")).not.toBeVisible();
     await (0, fixtures_1.expect)(page.getByRole("button", { name: "Close" })).toBeVisible();
-    // Assert cache is correct
     const withDom = getCacheDataWithDom({
         dom: '<div id="toast" class="z-[100]">',
     });
@@ -115,19 +96,15 @@ fixtures_1.test.skip("should dismiss two-step overlay for click", async ({ page,
     (0, fixtures_1.expect)(code).toBeDefined();
     (0, fixtures_1.expect)(code).toContain("await page.getByRole('button', { name: '×' }).click()");
 });
-// Test is flaky - skipping it
 fixtures_1.test.skip("should fallback when the overlay cannot be dismissed", async ({ page, server, }) => {
     await page.goto(`${server.baseURL}/no-overlay.html`);
     let error;
     try {
-        // Click on element that is hidden below another button, which is not
-        // dismissible
         await page.getByRole("button", { name: "Bottom Button" }).click();
     }
     catch (e) {
         error = e;
     }
-    // TODO: add better assertions with result from master agent
     console.log(fixtures_1.test.info().annotations);
     (0, fixtures_1.expect)(error).toBeDefined();
     (0, fixtures_1.expect)(error.message).toContain('<button type="button" class="top-button">Top Button</button> intercepts pointer events');

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/playwright-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-extensions.d.ts","sourceRoot":"","sources":["../src/playwright-extensions.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,OAAQ,SAAQ,eAAe;KAAG;CAC7C;AAED,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,OAAQ,SAAQ,eAAe;KAAG;CAC7C"}
+{"version":3,"file":"playwright-extensions.d.ts","sourceRoot":"","sources":["../src/playwright-extensions.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,OAAO,QAAQ,iBAAiB,CAAC;IAC/B,UAAU,OAAQ,SAAQ,eAAe;KAAG;CAC7C;AAED,OAAO,QAAQ,kBAAkB,CAAC;IAChC,UAAU,OAAQ,SAAQ,eAAe;KAAG;CAC7C"}

package/dist/playwright-extensions.js

@@ -1,3 +1,2 @@
 "use strict";
-// Extend Playwright core interfaces transparently to the end user.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/reporter/attachment-cleanup-test-reporter.d.ts

@@ -1,9 +1,3 @@
-/**
- * Test-only reporter used by attachment-cleanup integration tests.
- *
- * Records a timestamped event log of register/markUploaded/eviction events
- * so tests can make precise assertions about ordering and timing.
- */
 import type { FullResult, Reporter, TestCase, TestResult } from "@playwright/test/reporter";
 declare class AttachmentCleanupTestReporter implements Reporter {
     private _timeline;

package/dist/reporter/attachment-cleanup-test-reporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-cleanup-test-reporter.d.ts","sourceRoot":"","sources":["../../src/reporter/attachment-cleanup-test-reporter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACX,MAAM,2BAA2B,CAAC;AA0CnC,cAAM,6BAA8B,YAAW,QAAQ;IACrD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAkC;IAEhD,cAQC;IAED,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,QAyB5C;IAEK,KAAK,CAAC,OAAO,EAAE,UAAU,iBAyB9B;CACF;eAEc,6BAA6B"}
+{"version":3,"file":"attachment-cleanup-test-reporter.d.ts","sourceRoot":"","sources":["../../src/reporter/attachment-cleanup-test-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACX,MAAM,2BAA2B,CAAC;AA0CnC,cAAM,6BAA8B,YAAW,QAAQ;IACrD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAkC;IAEhD,cAQC;IAED,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,QAyB5C;IAEK,KAAK,CAAC,OAAO,EAAE,UAAU,iBAyB9B;CACF;eAEc,6BAA6B"}

package/dist/reporter/attachment-cleanup-test-reporter.js

@@ -1,10 +1,4 @@
 "use strict";
-/**
- * Test-only reporter used by attachment-cleanup integration tests.
- *
- * Records a timestamped event log of register/markUploaded/eviction events
- * so tests can make precise assertions about ordering and timing.
- */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/reporter/attachment-cleanup.d.ts

@@ -1,28 +1,3 @@
-/**
- * Tracks test attachments and evicts the oldest uploaded ones from disk
- * when total size exceeds the configured limit.
- *
- * Two-phase tracking:
- * 1. register() — called immediately when an attachment is created.
- *    Adds the file to the total size accounting so the LRU knows about
- *    all disk usage, even while uploads are still queued.
- * 2. markUploaded() — called after the file is uploaded to R2.
- *    Marks the file as safe to evict (delete from disk).
- *
- * Eviction only deletes files that have been uploaded. This ensures we
- * never delete a file before its upload completes.
- *
- * Why this exists:
- * Test attachments (videos, traces, screenshots) accumulate on disk during a
- * test run. On Fargate workers with 50 GB ephemeral storage, large test suites
- * can exhaust disk space. Since attachments are already uploaded to R2, we can
- * safely delete them from disk — but we can't delete them immediately because
- * Playwright's blob reporter reads them during onEnd to embed as resources/.
- *
- * The blob reporter's statSync guard (Playwright 1.57+) gracefully skips
- * missing files, and patchBlobZip replaces resources/ with
- * _empirical_urls.json pointing to R2 URLs anyway.
- */
 export declare class AttachmentCleanup {
     private _pending;
     private _uploaded;
@@ -36,17 +11,9 @@ export declare class AttachmentCleanup {
     private _diskLogTick;
     private _onEvict;
     constructor(limitBytes?: number);
-    /**
-     * Phase 1: Register an attachment immediately when it's created.
-     * Adds to total size accounting and attempts eviction of already-uploaded files.
-     */
     register(attachment: {
         path?: string | undefined;
     }): void;
-    /**
-     * Phase 2: Mark an attachment as uploaded (safe to evict).
-     * Moves from pending to the uploaded queue and attempts eviction.
-     */
     markUploaded(attachmentPath: string): void;
     private _evict;
     private _logDiskStatus;

package/dist/reporter/attachment-cleanup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-cleanup.d.ts","sourceRoot":"","sources":["../../src/reporter/attachment-cleanup.ts"],"names":[],"mappings":"AAgEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAyC;IAEzD,YAAY,UAAU,GAAE,MAAmC,EAU1D;IAED;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,QAiBjD;IAED;;;OAGG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,QASlC;IAED,OAAO,CAAC,MAAM;IA4Bd,OAAO,CAAC,cAAc;IAStB,UAAU,SAaT;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAE3C;IAED,IAAI,KAAK;QAEL,eAAe;QACf,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,SAAS;QACT,UAAU;MAEb;CACF"}
+{"version":3,"file":"attachment-cleanup.d.ts","sourceRoot":"","sources":["../../src/reporter/attachment-cleanup.ts"],"names":[],"mappings":"AA6DA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAyC;IAEzD,YAAY,UAAU,GAAE,MAAmC,EAM1D;IAED,QAAQ,CAAC,UAAU,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,QAejD;IAED,YAAY,CAAC,cAAc,EAAE,MAAM,QASlC;IAED,OAAO,CAAC,MAAM;IA4Bd,OAAO,CAAC,cAAc;IAItB,UAAU,SAWT;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAE3C;IAED,IAAI,KAAK;QAEL,eAAe;QACf,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,SAAS;QACT,UAAU;MAEb;CACF"}