@pxdiff/playwright 0.0.1

package/dist/fixture.d.ts

@@ -0,0 +1,12 @@
+import type { Page } from "@playwright/test";
+import type { PxdiffContext, PxdiffFixtureOptions } from "./types.js";
+/** Module-level WeakMap for passing context from fixture to matcher. */
+export declare const contextMap: WeakMap<Page, PxdiffContext>;
+export declare function createPxdiffFixture(options?: PxdiffFixtureOptions): {
+    _pxdiff: readonly [({ page }: {
+        page: Page;
+    }, use: (value: undefined) => Promise<void>) => Promise<void>, {
+        readonly auto: true;
+    }];
+};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAItE,wEAAwE;AACxE,eAAO,MAAM,UAAU,8BAAqC,CAAC;AAE7D,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB;kCAG9C;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,OAAO,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC;;;EAuC3E"}

package/dist/fixture.js

@@ -0,0 +1,41 @@
+import { PxdiffClient } from "@pxdiff/sdk";
+import { detectBaselineRef, detectBranch, detectCommit } from "./git.js";
+const DEFAULT_API_URL = "https://api.pxdiff.com";
+/** Module-level WeakMap for passing context from fixture to matcher. */
+export const contextMap = new WeakMap();
+export function createPxdiffFixture(options) {
+    return {
+        _pxdiff: [
+            async ({ page }, use) => {
+                const apiKey = process.env.PXDIFF_API_KEY;
+                if (!apiKey) {
+                    throw new Error("PXDIFF_API_KEY environment variable is required. " +
+                        "Get your API key from https://app.pxdiff.com.");
+                }
+                const apiUrl = options?.apiUrl ?? process.env.PXDIFF_API_URL ?? DEFAULT_API_URL;
+                const suite = options?.suite ?? "playwright";
+                const blocking = options?.blocking ?? true;
+                const autoBaseline = options?.autoBaseline ?? true;
+                const branch = await detectBranch(options?.git?.branch ?? process.env.PXDIFF_BRANCH);
+                const commit = await detectCommit(options?.git?.commit ?? process.env.PXDIFF_COMMIT);
+                const baselineRef = detectBaselineRef() ?? branch;
+                // Verify the client can be created (validates apiKey format etc.)
+                new PxdiffClient({ apiKey, apiUrl });
+                contextMap.set(page, {
+                    apiKey,
+                    apiUrl,
+                    suite,
+                    blocking,
+                    autoBaseline,
+                    branch,
+                    commit,
+                    baselineRef,
+                });
+                await use(undefined);
+                contextMap.delete(page);
+            },
+            { auto: true },
+        ],
+    };
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGzE,MAAM,eAAe,GAAG,wBAAwB,CAAC;AAEjD,wEAAwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,EAAuB,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IACjE,OAAO;QACN,OAAO,EAAE;YACR,KAAK,EAAE,EAAE,IAAI,EAAkB,EAAE,GAAwC,EAAE,EAAE;gBAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;gBAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CACd,mDAAmD;wBAClD,+CAA+C,CAChD,CAAC;gBACH,CAAC;gBAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,eAAe,CAAC;gBAChF,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC;gBAC7C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,IAAI,CAAC;gBAC3C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC;gBAEnD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACrF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBACrF,MAAM,WAAW,GAAG,iBAAiB,EAAE,IAAI,MAAM,CAAC;gBAElD,kEAAkE;gBAClE,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAErC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE;oBACpB,MAAM;oBACN,MAAM;oBACN,KAAK;oBACL,QAAQ;oBACR,YAAY;oBACZ,MAAM;oBACN,MAAM;oBACN,WAAW;iBACX,CAAC,CAAC;gBAEH,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;gBAErB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC;YACD,EAAE,IAAI,EAAE,IAAI,EAAE;SACL;KACV,CAAC;AACH,CAAC"}

package/dist/git.d.ts

@@ -0,0 +1,4 @@
+export declare function detectBranch(override?: string): Promise<string>;
+export declare function detectCommit(override?: string): Promise<string>;
+export declare function detectBaselineRef(): string | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBrE;AAED,wBAAsB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBrE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAUjD"}

package/dist/git.js

@@ -0,0 +1,61 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function detectBranch(override) {
+    if (override)
+        return override;
+    // GitHub Actions: PR head branch
+    const ghHead = process.env.GITHUB_HEAD_REF;
+    if (ghHead)
+        return ghHead;
+    // GitHub Actions: push branch (strip refs/heads/ prefix)
+    const ghRef = process.env.GITHUB_REF;
+    if (ghRef) {
+        const prefix = "refs/heads/";
+        return ghRef.startsWith(prefix) ? ghRef.slice(prefix.length) : ghRef;
+    }
+    // GitLab CI
+    const glRef = process.env.CI_COMMIT_REF_NAME;
+    if (glRef)
+        return glRef;
+    // Local git
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"]);
+        return stdout.trim();
+    }
+    catch {
+        throw new Error("Failed to detect git branch. Set PXDIFF_BRANCH or run in a git repository.");
+    }
+}
+export async function detectCommit(override) {
+    if (override)
+        return override;
+    // GitHub Actions
+    const ghSha = process.env.GITHUB_SHA;
+    if (ghSha)
+        return ghSha;
+    // GitLab CI
+    const glSha = process.env.CI_COMMIT_SHA;
+    if (glSha)
+        return glSha;
+    // Local git
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"]);
+        return stdout.trim();
+    }
+    catch {
+        throw new Error("Failed to detect git commit. Set PXDIFF_COMMIT or run in a git repository.");
+    }
+}
+export function detectBaselineRef() {
+    // GitHub Actions: PR base branch
+    const ghBase = process.env.GITHUB_BASE_REF;
+    if (ghBase)
+        return ghBase;
+    // Explicit override
+    const pxdiffRef = process.env.PXDIFF_BASELINE_REF;
+    if (pxdiffRef)
+        return pxdiffRef;
+    return null;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAiB;IACnD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,iCAAiC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,yDAAyD;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACrC,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,aAAa,CAAC;QAC7B,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtE,CAAC;IAED,YAAY;IACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC7C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,YAAY;IACZ,IAAI,CAAC;QACJ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAC/F,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAiB;IACnD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,iBAAiB;IACjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACrC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,YAAY;IACZ,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACxC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,YAAY;IACZ,IAAI,CAAC;QACJ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAC/F,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,iCAAiC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,oBAAoB;IACpB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAClD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/git.test.d.ts

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

package/dist/git.test.d.ts.map

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

package/dist/git.test.js

@@ -0,0 +1,119 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// Mock child_process before importing the module
+vi.mock("node:child_process", () => ({
+    execFile: vi.fn(),
+}));
+import { execFile } from "node:child_process";
+import { detectBaselineRef, detectBranch, detectCommit } from "./git.js";
+function mockExecFile(stdout) {
+    vi.mocked(execFile).mockImplementation((_cmd, _args, cb) => {
+        cb(null, { stdout });
+        return undefined;
+    });
+}
+function mockExecFileError() {
+    vi.mocked(execFile).mockImplementation((_cmd, _args, cb) => {
+        cb(new Error("git not found"));
+        return undefined;
+    });
+}
+describe("detectBranch", () => {
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns override when provided", async () => {
+        expect(await detectBranch("my-branch")).toBe("my-branch");
+    });
+    it("reads GITHUB_HEAD_REF for PR branches", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "feat/new-feature");
+        expect(await detectBranch()).toBe("feat/new-feature");
+    });
+    it("reads GITHUB_REF and strips refs/heads/ prefix", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "");
+        vi.stubEnv("GITHUB_REF", "refs/heads/main");
+        expect(await detectBranch()).toBe("main");
+    });
+    it("returns GITHUB_REF as-is when not a heads ref", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "");
+        vi.stubEnv("GITHUB_REF", "refs/tags/v1.0.0");
+        expect(await detectBranch()).toBe("refs/tags/v1.0.0");
+    });
+    it("reads CI_COMMIT_REF_NAME for GitLab CI", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "");
+        vi.stubEnv("GITHUB_REF", "");
+        vi.stubEnv("CI_COMMIT_REF_NAME", "develop");
+        expect(await detectBranch()).toBe("develop");
+    });
+    it("falls back to git rev-parse", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "");
+        vi.stubEnv("GITHUB_REF", "");
+        vi.stubEnv("CI_COMMIT_REF_NAME", "");
+        mockExecFile("feature-branch\n");
+        expect(await detectBranch()).toBe("feature-branch");
+    });
+    it("throws when git command fails and no env vars set", async () => {
+        vi.stubEnv("GITHUB_HEAD_REF", "");
+        vi.stubEnv("GITHUB_REF", "");
+        vi.stubEnv("CI_COMMIT_REF_NAME", "");
+        mockExecFileError();
+        await expect(detectBranch()).rejects.toThrow("Failed to detect git branch");
+    });
+});
+describe("detectCommit", () => {
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns override when provided", async () => {
+        expect(await detectCommit("abc123")).toBe("abc123");
+    });
+    it("reads GITHUB_SHA", async () => {
+        vi.stubEnv("GITHUB_SHA", "deadbeef1234567890abcdef");
+        expect(await detectCommit()).toBe("deadbeef1234567890abcdef");
+    });
+    it("reads CI_COMMIT_SHA for GitLab CI", async () => {
+        vi.stubEnv("GITHUB_SHA", "");
+        vi.stubEnv("CI_COMMIT_SHA", "gitlab-sha-123");
+        expect(await detectCommit()).toBe("gitlab-sha-123");
+    });
+    it("falls back to git rev-parse", async () => {
+        vi.stubEnv("GITHUB_SHA", "");
+        vi.stubEnv("CI_COMMIT_SHA", "");
+        mockExecFile("abcdef1234567890\n");
+        expect(await detectCommit()).toBe("abcdef1234567890");
+    });
+    it("throws when git command fails and no env vars set", async () => {
+        vi.stubEnv("GITHUB_SHA", "");
+        vi.stubEnv("CI_COMMIT_SHA", "");
+        mockExecFileError();
+        await expect(detectCommit()).rejects.toThrow("Failed to detect git commit");
+    });
+});
+describe("detectBaselineRef", () => {
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("reads GITHUB_BASE_REF for PR base branch", () => {
+        vi.stubEnv("GITHUB_BASE_REF", "main");
+        expect(detectBaselineRef()).toBe("main");
+    });
+    it("reads PXDIFF_BASELINE_REF when set", () => {
+        vi.stubEnv("GITHUB_BASE_REF", "");
+        vi.stubEnv("PXDIFF_BASELINE_REF", "develop");
+        expect(detectBaselineRef()).toBe("develop");
+    });
+    it("returns null when no env vars set", () => {
+        vi.stubEnv("GITHUB_BASE_REF", "");
+        vi.stubEnv("PXDIFF_BASELINE_REF", "");
+        expect(detectBaselineRef()).toBeNull();
+    });
+});
+//# sourceMappingURL=git.test.js.map

package/dist/git.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createPxdiffFixture } from "./fixture.js";
+export { pxdiffMatchers } from "./matchers.js";
+export type { MatchScreenshotOptions, PxdiffFixtureOptions, PxdiffResult, } from "./types.js";
+declare module "@playwright/test" {
+    interface Matchers<R, T> {
+        toMatchScreenshot(name: string, options?: import("./types.js").MatchScreenshotOptions): Promise<R>;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,QAAQ,kBAAkB,CAAC;IACjC,UAAU,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtB,iBAAiB,CAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,sBAAsB,GACnD,OAAO,CAAC,CAAC,CAAC,CAAC;KACd;CACD"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createPxdiffFixture } from "./fixture.js";
+export { pxdiffMatchers } from "./matchers.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/matchers.d.ts

@@ -0,0 +1,11 @@
+import type { Locator, Page } from "@playwright/test";
+import type { MatchScreenshotOptions } from "./types.js";
+export declare const pxdiffMatchers: {
+    toMatchScreenshot(this: {
+        isNot: boolean;
+    }, received: Page | Locator, name: string, options?: MatchScreenshotOptions): Promise<{
+        pass: boolean;
+        message: () => string;
+    }>;
+};
+//# sourceMappingURL=matchers.d.ts.map

package/dist/matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers.d.ts","sourceRoot":"","sources":["../src/matchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,YAAY,CAAC;AAyBvE,eAAO,MAAM,cAAc;4BAEnB;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,YACd,IAAI,GAAG,OAAO,QAClB,MAAM,YACF,sBAAsB;;;;CA2GjC,CAAC"}

package/dist/matchers.js

@@ -0,0 +1,110 @@
+import { PxdiffClient } from "@pxdiff/sdk";
+import { contextMap } from "./fixture.js";
+function isPage(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "screenshot" in value &&
+        "viewportSize" in value &&
+        !("page" in value));
+}
+function getPage(received) {
+    if (isPage(received))
+        return received;
+    if (typeof received === "object" &&
+        received !== null &&
+        "page" in received &&
+        typeof received.page === "function") {
+        return received.page();
+    }
+    throw new Error(`toMatchScreenshot() expects a Page or Locator. Got: ${typeof received}`);
+}
+export const pxdiffMatchers = {
+    async toMatchScreenshot(received, name, options) {
+        const page = getPage(received);
+        const ctx = contextMap.get(page);
+        if (!ctx) {
+            return {
+                pass: false,
+                message: () => "pxdiff context not found. Make sure you called createPxdiffFixture() " +
+                    "and extended your test with the fixtures.",
+            };
+        }
+        // Set viewport if requested
+        if (options?.viewport) {
+            await page.setViewportSize(options.viewport);
+        }
+        // Take screenshot
+        const screenshotTarget = isPage(received) ? page : received;
+        const png = await screenshotTarget.screenshot({
+            fullPage: options?.fullPage,
+            mask: options?.mask,
+            animations: options?.animations,
+            timeout: options?.timeout,
+        });
+        // Get viewport dimensions
+        const viewportSize = page.viewportSize();
+        const viewport = viewportSize
+            ? { width: viewportSize.width, height: viewportSize.height }
+            : undefined;
+        // Upload and diff
+        const client = new PxdiffClient({ apiKey: ctx.apiKey, apiUrl: ctx.apiUrl });
+        const result = await client.uploadSnapshotWithDiff({
+            name,
+            png,
+            suite: ctx.suite,
+            branch: ctx.branch,
+            commit: ctx.commit,
+            baselineRef: ctx.baselineRef ?? ctx.branch,
+            viewport,
+            autoBaseline: ctx.autoBaseline,
+        });
+        const pxdiffResult = {
+            status: result.status,
+            diffPercentage: result.diffPercentage,
+            diffUrl: result.diffS3Key,
+            snapshotName: name,
+            viewport: viewport ?? null,
+        };
+        // Attach result as test annotation
+        const testInfo = page?.context?.()
+            ?._testInfo;
+        if (testInfo &&
+            typeof testInfo === "object" &&
+            "annotations" in testInfo &&
+            Array.isArray(testInfo.annotations)) {
+            testInfo.annotations.push({
+                type: "pxdiff",
+                description: JSON.stringify(pxdiffResult),
+            });
+        }
+        // Determine pass/fail
+        const blocking = options?.blocking ?? ctx.blocking;
+        if (result.status === "unchanged" || result.status === "new") {
+            return {
+                pass: true,
+                message: () => `Screenshot "${name}" is ${result.status}.`,
+            };
+        }
+        // Status is "changed"
+        if (options?.maxDiffPixelRatio !== undefined &&
+            result.diffPercentage !== null &&
+            result.diffPercentage / 100 <= options.maxDiffPixelRatio) {
+            return {
+                pass: true,
+                message: () => `Screenshot "${name}" changed by ${result.diffPercentage}% ` +
+                    `(within maxDiffPixelRatio of ${options.maxDiffPixelRatio}).`,
+            };
+        }
+        if (!blocking) {
+            return {
+                pass: true,
+                message: () => `Screenshot "${name}" changed by ${result.diffPercentage ?? "unknown"}% (non-blocking).`,
+            };
+        }
+        return {
+            pass: false,
+            message: () => `Screenshot "${name}" has visual differences.\n  Diff: ${result.diffPercentage ?? "unknown"}%\n  Diff ID: ${result.diffId}\n${result.diffS3Key ? `  Diff image: ${result.diffS3Key}\n` : ""}  Review and approve the changes in the pxdiff dashboard.`,
+        };
+    },
+};
+//# sourceMappingURL=matchers.js.map

package/dist/matchers.js.map

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

package/dist/matchers.test.d.ts

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

package/dist/matchers.test.d.ts.map

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

package/dist/matchers.test.js

@@ -0,0 +1,185 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { contextMap } from "./fixture.js";
+import { pxdiffMatchers } from "./matchers.js";
+// Mock PxdiffClient
+vi.mock("@pxdiff/sdk", () => ({
+    PxdiffClient: vi.fn().mockImplementation(() => ({
+        uploadSnapshotWithDiff: vi.fn(),
+    })),
+}));
+import { PxdiffClient } from "@pxdiff/sdk";
+function createMockPage(viewportSize = { width: 1280, height: 720 }) {
+    const page = {
+        screenshot: vi.fn().mockResolvedValue(new Uint8Array([1, 2, 3])),
+        viewportSize: vi.fn().mockReturnValue(viewportSize),
+        setViewportSize: vi.fn().mockResolvedValue(undefined),
+        context: vi.fn().mockReturnValue({ _testInfo: null }),
+    };
+    return page;
+}
+function createMockLocator(page) {
+    const locator = {
+        screenshot: vi.fn().mockResolvedValue(new Uint8Array([4, 5, 6])),
+        page: vi.fn().mockReturnValue(page),
+    };
+    return locator;
+}
+const defaultContext = {
+    apiKey: "pxd_test123",
+    apiUrl: "https://api.test.pxdiff.com",
+    suite: "e2e",
+    blocking: true,
+    autoBaseline: true,
+    branch: "feat/test",
+    commit: "abc123",
+    baselineRef: "main",
+};
+function mockUploadResult(result) {
+    const fullResult = {
+        name: "test-screenshot",
+        suite: "e2e",
+        status: "unchanged",
+        diffPercentage: null,
+        diffId: "diff-1",
+        captureId: "cap-1",
+        currentS3Key: null,
+        baselineS3Key: null,
+        diffS3Key: null,
+        ...result,
+    };
+    vi.mocked(PxdiffClient).mockImplementation(() => ({
+        uploadSnapshotWithDiff: vi.fn().mockResolvedValue(fullResult),
+    }));
+}
+describe("pxdiffMatchers.toMatchScreenshot", () => {
+    let page;
+    const matcherContext = { isNot: false };
+    beforeEach(() => {
+        page = createMockPage();
+        contextMap.set(page, { ...defaultContext });
+    });
+    afterEach(() => {
+        contextMap.delete(page);
+        vi.restoreAllMocks();
+    });
+    it("passes for unchanged snapshots", async () => {
+        mockUploadResult({ status: "unchanged" });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "homepage");
+        expect(result.pass).toBe(true);
+        expect(result.message()).toContain("unchanged");
+    });
+    it("passes for new snapshots", async () => {
+        mockUploadResult({ status: "new" });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "new-page");
+        expect(result.pass).toBe(true);
+        expect(result.message()).toContain("new");
+    });
+    it("fails for changed snapshots in blocking mode", async () => {
+        mockUploadResult({
+            status: "changed",
+            diffPercentage: 5.2,
+            diffId: "diff-abc",
+            diffS3Key: "diffs/diff-abc/hash.png",
+        });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "login");
+        expect(result.pass).toBe(false);
+        expect(result.message()).toContain("visual differences");
+        expect(result.message()).toContain("5.2%");
+        expect(result.message()).toContain("diff-abc");
+    });
+    it("passes for changed snapshots in non-blocking mode (fixture-level)", async () => {
+        contextMap.set(page, { ...defaultContext, blocking: false });
+        mockUploadResult({ status: "changed", diffPercentage: 3.1 });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "dashboard");
+        expect(result.pass).toBe(true);
+        expect(result.message()).toContain("non-blocking");
+    });
+    it("passes for changed snapshots in non-blocking mode (option-level)", async () => {
+        mockUploadResult({ status: "changed", diffPercentage: 2.0 });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "dashboard", {
+            blocking: false,
+        });
+        expect(result.pass).toBe(true);
+        expect(result.message()).toContain("non-blocking");
+    });
+    it("passes when diffPercentage is within maxDiffPixelRatio", async () => {
+        mockUploadResult({ status: "changed", diffPercentage: 0.5 });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "subtle-change", { maxDiffPixelRatio: 0.01 });
+        expect(result.pass).toBe(true);
+        expect(result.message()).toContain("maxDiffPixelRatio");
+    });
+    it("fails when diffPercentage exceeds maxDiffPixelRatio", async () => {
+        mockUploadResult({ status: "changed", diffPercentage: 5.0 });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "big-change", {
+            maxDiffPixelRatio: 0.01,
+        });
+        expect(result.pass).toBe(false);
+        expect(result.message()).toContain("visual differences");
+    });
+    it("works with a Locator instead of Page", async () => {
+        const locator = createMockLocator(page);
+        mockUploadResult({ status: "unchanged" });
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, locator, "button");
+        expect(result.pass).toBe(true);
+        // Should call screenshot on the locator, not the page
+        expect(locator.screenshot.mock.calls).toHaveLength(1);
+    });
+    it("returns error when context is missing", async () => {
+        contextMap.delete(page);
+        const result = await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "no-context");
+        expect(result.pass).toBe(false);
+        expect(result.message()).toContain("pxdiff context not found");
+    });
+    it("sets viewport before taking screenshot", async () => {
+        mockUploadResult({ status: "unchanged" });
+        const viewport = { width: 375, height: 812 };
+        await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "mobile", {
+            viewport,
+        });
+        expect(page.setViewportSize.mock
+            .calls[0]).toEqual([viewport]);
+    });
+    it("passes screenshot options through", async () => {
+        mockUploadResult({ status: "unchanged" });
+        await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "full-page", {
+            fullPage: true,
+            animations: "disabled",
+            timeout: 5000,
+        });
+        const screenshotCall = page.screenshot.mock.calls[0]?.[0];
+        expect(screenshotCall?.fullPage).toBe(true);
+        expect(screenshotCall?.animations).toBe("disabled");
+        expect(screenshotCall?.timeout).toBe(5000);
+    });
+    it("sends correct metadata to uploadSnapshotWithDiff", async () => {
+        const uploadMock = vi.fn().mockResolvedValue({
+            name: "test",
+            suite: "e2e",
+            status: "unchanged",
+            diffPercentage: null,
+            diffId: "diff-1",
+            captureId: "cap-1",
+            currentS3Key: null,
+            baselineS3Key: null,
+            diffS3Key: null,
+        });
+        vi.mocked(PxdiffClient).mockImplementation(() => ({
+            uploadSnapshotWithDiff: uploadMock,
+        }));
+        await pxdiffMatchers.toMatchScreenshot.call(matcherContext, page, "test");
+        expect(uploadMock).toHaveBeenCalledWith({
+            name: "test",
+            png: expect.any(Uint8Array),
+            suite: "e2e",
+            branch: "feat/test",
+            commit: "abc123",
+            baselineRef: "main",
+            viewport: { width: 1280, height: 720 },
+            autoBaseline: true,
+        });
+    });
+    it("throws for non-page/non-locator values", async () => {
+        await expect(pxdiffMatchers.toMatchScreenshot.call(matcherContext, "not-a-page", "test")).rejects.toThrow("toMatchScreenshot() expects a Page or Locator");
+    });
+});
+//# sourceMappingURL=matchers.test.js.map

package/dist/matchers.test.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface PxdiffFixtureOptions {
+    /** Suite name for grouping snapshots. Defaults to test file name. */
+    suite?: string;
+    /** If true, changed snapshots fail the test. Defaults to true. */
+    blocking?: boolean;
+    /** API URL override. Defaults to PXDIFF_API_URL env or https://api.pxdiff.com. */
+    apiUrl?: string;
+    /** Git metadata overrides. Auto-detected when not provided. */
+    git?: {
+        branch?: string;
+        commit?: string;
+    };
+    /** Auto-promote snapshots to baseline when no baseline exists. Defaults to true. */
+    autoBaseline?: boolean;
+}
+export interface MatchScreenshotOptions {
+    /** Override blocking mode for this snapshot. */
+    blocking?: boolean;
+    /** Custom diff threshold (0-1). */
+    threshold?: number;
+    /** Viewport size to set before taking the screenshot. */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Take full-page screenshot. Defaults to false. */
+    fullPage?: boolean;
+    /** Locators to mask before taking the screenshot. */
+    mask?: unknown[];
+    /** Maximum acceptable diff ratio (0-1). If diff is below this, the assertion passes. */
+    maxDiffPixelRatio?: number;
+    /** Animation handling: 'disabled' freezes animations. */
+    animations?: "disabled" | "allow";
+    /** Screenshot timeout in ms. */
+    timeout?: number;
+}
+export interface PxdiffResult {
+    status: "new" | "changed" | "unchanged";
+    diffPercentage: number | null;
+    diffUrl: string | null;
+    snapshotName: string;
+    viewport: {
+        width: number;
+        height: number;
+    } | null;
+}
+export interface PxdiffContext {
+    apiKey: string;
+    apiUrl: string;
+    suite: string;
+    blocking: boolean;
+    autoBaseline: boolean;
+    branch: string;
+    commit: string;
+    baselineRef: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACpC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,GAAG,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,oFAAoF;IACpF,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACtC,gDAAgD;IAChD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yDAAyD;IACzD,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;IAClC,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,WAAW,CAAC;IACxC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@pxdiff/playwright",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@pxdiff/sdk": "0.0.1"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.50.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "typecheck": "tsc --build --noEmit",
+    "test": "vitest run"
+  }
+}