@rehearsal-labs/retest 0.1.0 → 0.3.0

package/dist/assertions/expect.d.ts

@@ -18,6 +18,14 @@ declare const misplaced: {
     readonly toHaveValue: "toHaveValue is for locators. Use toBe on a value.";
     readonly toHaveURL: "toHaveURL is for a page. Use toBe on a value.";
     readonly toHaveTitle: "toHaveTitle is for a page. Use toBe on a value.";
+    readonly toOverlap: "toOverlap is for locators. Use toBe on a value.";
+    readonly toOverflowViewport: "toOverflowViewport is for locators. Use toBe on a value.";
+    readonly toHaveClippedText: "toHaveClippedText is for locators. Use toBe on a value.";
+    readonly toScrollHorizontally: "toScrollHorizontally is for a page. Use toBe on a value.";
+    readonly layout: "Layout matchers measure a web page. A native app has no page layout to measure.";
+    readonly toHaveScreenshot: "toHaveScreenshot is for locators and pages. Use toEqual on a value.";
+    readonly screenshotNot: "toHaveScreenshot has no .not. Save a baseline of the picture you expect instead.";
+    readonly screenshotNative: "toHaveScreenshot compares web pages. Retest compares no picture of a native app yet.";
     readonly not: ".not is for locator and page matchers. Write the value matcher that says what you expect.";
     readonly twice: ".not is written once.";
 };
@@ -29,6 +37,18 @@ type Misplaced = typeof misplaced;
 export type AssertionOptions = {
     readonly timeout?: number | undefined;
 };
+/**
+ * `toHaveScreenshot`'s options. `threshold` is the colour distance, from 0 to 1, above which a pixel counts as
+ * different: 0.2 when left out. `maxDiffPixels` is how many pixels may differ, and `maxDiffPixelRatio` what part of
+ * them, from 0 to 1; with both, each must hold, and with neither, no pixel may differ. `timeout` shortens the assertion
+ * budget for the call, in milliseconds, and never lengthens it.
+ */
+export type ScreenshotOptions = {
+    readonly threshold?: number | undefined;
+    readonly maxDiffPixels?: number | undefined;
+    readonly maxDiffPixelRatio?: number | undefined;
+    readonly timeout?: number | undefined;
+};
 /** A locator's matchers, as they are and after `.not`. Each looks at the page again until it passes or time runs out. */
 export interface LocatorMatchers {
     /**
@@ -97,8 +117,38 @@ export interface LocatorMatchers {
     readonly toContain: RetestTypeError<Misplaced['toContain']>;
     readonly toMatch: RetestTypeError<Misplaced['toMatch']>;
 }
+/**
+ * A locator's layout matchers, as they are and after `.not`. Each names a layout problem and passes while the page
+ * shows it, so `.not` passes once it is gone. Each measures the page again until it passes or time runs out, needs
+ * exactly one element for each locator, and passes neither way while an element is not shown.
+ */
+export interface LayoutMatchers {
+    /**
+     * Waits until exactly one element matches each locator and their visible boxes share more than 4 pixels both across
+     * and down. A control inside a field never overlaps it, and an element never overlaps one it holds. Negated, it
+     * passes once they share no more than that.
+     *
+     * @example await expect(page.getByRole('button', { name: 'Save' })).not.toOverlap(page.getByRole('link', { name: 'Help' }))
+     */
+    toOverlap(other: Locator, options?: AssertionOptions): Promise<void>;
+    /**
+     * Waits until exactly one element matches and the visible part of it ends more than 1 pixel past the right edge of
+     * the viewport, its width without the scrollbar. Negated, it passes once the element ends no further than that.
+     *
+     * @example await expect(page.getByTestId('price')).not.toOverflowViewport()
+     */
+    toOverflowViewport(options?: AssertionOptions): Promise<void>;
+    /**
+     * Waits until exactly one element matches and a container that hides its overflow cuts off more than 4 pixels of
+     * its words or the words of an element inside it. Text shortened on purpose, with an ellipsis or a line clamp, is
+     * not cut off. Negated, it passes once no more than that is cut off.
+     *
+     * @example await expect(page.getByRole('heading')).not.toHaveClippedText()
+     */
+    toHaveClippedText(options?: AssertionOptions): Promise<void>;
+}
 /** Matchers for a locator. They look at the page again until they pass or time runs out, so await them. */
-export interface LocatorAssertions extends LocatorMatchers {
+export interface LocatorAssertions extends LocatorMatchers, LayoutMatchers {
     /**
      * The same matchers, each passing only on a look that shows the opposite. A missing element passes only
      * `.not.toBeVisible()`, `.not.toHaveCount()` and `.not.toHaveText([...])`.
@@ -106,18 +156,36 @@ export interface LocatorAssertions extends LocatorMatchers {
      * @example await expect(page.getByRole('dialog')).not.toBeVisible()
      */
     readonly not: NegatedLocatorAssertions;
+    /**
+     * Takes pictures of the one element that matches, clipped to its box, at growing waits from 100 ms, until two in a
+     * row are the same and the last matches the baseline `name` beside the test file, pixel by pixel, or time runs out.
+     * The element must be shown and inside the viewport. No pixel may differ unless the options allow it. A missing
+     * baseline fails the check; run with `--update-screenshots` to write it.
+     *
+     * @example await expect(page.getByTestId('chart')).toHaveScreenshot('chart', { maxDiffPixels: 50 })
+     */
+    toHaveScreenshot(name: string, options?: ScreenshotOptions): Promise<void>;
 }
 /** A locator's matchers after `.not`. */
 export interface NativeLocatorAssertions extends LocatorMatchers {
     toBeSelected(options?: AssertionOptions): Promise<void>;
+    readonly toOverlap: RetestTypeError<Misplaced['layout']>;
+    readonly toOverflowViewport: RetestTypeError<Misplaced['layout']>;
+    readonly toHaveClippedText: RetestTypeError<Misplaced['layout']>;
     readonly not: NativeNegatedLocatorAssertions;
+    readonly toHaveScreenshot: RetestTypeError<Misplaced['screenshotNative']>;
 }
 export interface NativeNegatedLocatorAssertions extends LocatorMatchers {
     toBeSelected(options?: AssertionOptions): Promise<void>;
+    readonly toOverlap: RetestTypeError<Misplaced['layout']>;
+    readonly toOverflowViewport: RetestTypeError<Misplaced['layout']>;
+    readonly toHaveClippedText: RetestTypeError<Misplaced['layout']>;
     readonly not: RetestTypeError<Misplaced['twice']>;
+    readonly toHaveScreenshot: RetestTypeError<Misplaced['screenshotNative']>;
 }
-export interface NegatedLocatorAssertions extends LocatorMatchers {
+export interface NegatedLocatorAssertions extends LocatorMatchers, LayoutMatchers {
     readonly not: RetestTypeError<Misplaced['twice']>;
+    readonly toHaveScreenshot: RetestTypeError<Misplaced['screenshotNot']>;
 }
 /** A page's matchers, as they are and after `.not`. Each looks at the page again until it passes or time runs out. */
 export interface PageMatchers {
@@ -135,6 +203,13 @@ export interface PageMatchers {
      * @example await expect(page).toHaveTitle('Tasks')
      */
     toHaveTitle(title: string | RegExp, options?: AssertionOptions): Promise<void>;
+    /**
+     * Waits until the page scrolls sideways: the document is more than 1 pixel wider than the viewport without its
+     * scrollbar, and the page does not hide what runs past it. Negated, it passes once the page does not.
+     *
+     * @example await expect(page).not.toScrollHorizontally()
+     */
+    toScrollHorizontally(options?: AssertionOptions): Promise<void>;
     readonly toBe: RetestTypeError<Misplaced['toBe']>;
     readonly toEqual: RetestTypeError<Misplaced['toEqual']>;
 }
@@ -146,10 +221,19 @@ export interface PageAssertions extends PageMatchers {
      * @example await expect(page).not.toHaveURL('/login')
      */
     readonly not: NegatedPageAssertions;
+    /**
+     * Takes pictures of the page's viewport, at growing waits from 100 ms, until two in a row are the same and the last
+     * matches the baseline `name` beside the test file, pixel by pixel, or time runs out. No pixel may differ unless the
+     * options allow it. A missing baseline fails the check; run with `--update-screenshots` to write it.
+     *
+     * @example await expect(page).toHaveScreenshot('dashboard')
+     */
+    toHaveScreenshot(name: string, options?: ScreenshotOptions): Promise<void>;
 }
 /** A page's matchers after `.not`. */
 export interface NegatedPageAssertions extends PageMatchers {
     readonly not: RetestTypeError<Misplaced['twice']>;
+    readonly toHaveScreenshot: RetestTypeError<Misplaced['screenshotNot']>;
 }
 /** Matchers that compare a value. `Result` is `void` for `expect`, and a promise for `expect.poll`. */
 export interface ValueMatchers<Actual, Result> {
@@ -193,6 +277,11 @@ export interface ValueAssertions<Actual> extends ValueMatchers<Actual, void> {
     readonly toHaveValue: RetestTypeError<Misplaced['toHaveValue']>;
     readonly toHaveURL: RetestTypeError<Misplaced['toHaveURL']>;
     readonly toHaveTitle: RetestTypeError<Misplaced['toHaveTitle']>;
+    readonly toOverlap: RetestTypeError<Misplaced['toOverlap']>;
+    readonly toOverflowViewport: RetestTypeError<Misplaced['toOverflowViewport']>;
+    readonly toHaveClippedText: RetestTypeError<Misplaced['toHaveClippedText']>;
+    readonly toScrollHorizontally: RetestTypeError<Misplaced['toScrollHorizontally']>;
+    readonly toHaveScreenshot: RetestTypeError<Misplaced['toHaveScreenshot']>;
     readonly not: RetestTypeError<Misplaced['not']>;
 }
 /** Matchers for `expect.poll`. Each calls the function again until its value passes, so await them. */

package/dist/assertions/expect.d.ts.map

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

package/dist/assertions/expect.js

@@ -6,9 +6,11 @@ import { isThenable } from "../api/operation.js";
 import { Secret } from "../api/secret.js";
 import { describeLocator, textPatternOf } from "../protocol/locator.js";
 import { maxTimeout } from "../protocol/timeouts.js";
+import { pollLayout } from "./poll-layout.js";
 import { pollLocator } from "./poll-locator.js";
 import { pollPage } from "./poll-page.js";
 import { pollValue } from "./poll-value.js";
+import { pollScreenshot, readScreenshotCall } from "./screenshot.js";
 import { assertValue } from "./value.js";
 import { containCheck, equalCheck, matchCheck, sameCheck } from "./value-checks.js";
 // The type checker and JavaScript callers get the same sentence for a matcher used on the wrong kind of thing.
@@ -29,6 +31,14 @@ const misplaced = {
     toHaveValue: 'toHaveValue is for locators. Use toBe on a value.',
     toHaveURL: 'toHaveURL is for a page. Use toBe on a value.',
     toHaveTitle: 'toHaveTitle is for a page. Use toBe on a value.',
+    toOverlap: 'toOverlap is for locators. Use toBe on a value.',
+    toOverflowViewport: 'toOverflowViewport is for locators. Use toBe on a value.',
+    toHaveClippedText: 'toHaveClippedText is for locators. Use toBe on a value.',
+    toScrollHorizontally: 'toScrollHorizontally is for a page. Use toBe on a value.',
+    layout: 'Layout matchers measure a web page. A native app has no page layout to measure.',
+    toHaveScreenshot: 'toHaveScreenshot is for locators and pages. Use toEqual on a value.',
+    screenshotNot: 'toHaveScreenshot has no .not. Save a baseline of the picture you expect instead.',
+    screenshotNative: 'toHaveScreenshot compares web pages. Retest compares no picture of a native app yet.',
     not: '.not is for locator and page matchers. Write the value matcher that says what you expect.',
     twice: '.not is written once.',
 };
@@ -121,6 +131,40 @@ class LocatorExpectation {
             return this.#assert({ matcher: 'toHaveValue', pattern: textPatternOf(value) }, options);
         throw misuse(`toHaveValue() takes the expected value as a string or a RegExp, received ${formatValue(value)}.`, this.#scope.run);
     }
+    toOverlap(other, options) {
+        const { run } = this.#scope;
+        const found = locatorTarget(other);
+        if (found === undefined)
+            throw misuse(`toOverlap() takes the other element's locator, such as page.getByTestId('help'), received ${formatValue(other)}.`, run);
+        if (found.run !== run)
+            throw misuse('The other locator belongs to another test. Find it again with its page.', run);
+        if (found.app !== this.#target.app) {
+            const own = describeLocator(this.#target.recipe);
+            throw misuse(`toOverlap() compares two elements of one page: ${own} is on ${this.#target.app} and ${describeLocator(found.recipe)} on ${found.app}.`, run);
+        }
+        return this.#measure({ matcher: 'toOverlap', other: found.recipe }, options);
+    }
+    toOverflowViewport(options) {
+        return this.#measure({ matcher: 'toOverflowViewport' }, options);
+    }
+    toHaveClippedText(options) {
+        return this.#measure({ matcher: 'toHaveClippedText' }, options);
+    }
+    toHaveScreenshot(name, options) {
+        const { run, stepId } = this.#scope;
+        const { app, recipe } = this.#target;
+        const { soft, negated } = this.#sense;
+        const location = run.location();
+        if (negated)
+            throw misuse(misplaced.screenshotNot, run);
+        if (this.#target.run !== run)
+            throw misuse('This locator belongs to another test. Find it again with its page.', run);
+        const call = readScreenshotCall(name, options);
+        if (typeof call === 'string')
+            throw misuse(call, run);
+        const label = `${soft ? 'expect.soft' : 'expect'}(${describeLocator(recipe)}).toHaveScreenshot()`;
+        return run.assertion(label, location, () => pollScreenshot({ run, stepId, app, recipe, record: call.record, location, soft, timeoutMs: call.timeoutMs }), app);
+    }
     toBe() {
         throw misuse(misplaced.toBe, this.#scope.run);
     }
@@ -145,6 +189,18 @@ class LocatorExpectation {
         const label = `${soft ? 'expect.soft' : 'expect'}(${describeLocator(recipe)})${negated ? '.not' : ''}.${matched.matcher}()`;
         return run.assertion(label, location, () => pollLocator({ run, stepId, app, recipe, record, location, soft, timeoutMs }), app);
     }
+    #measure(matched, options) {
+        const { run, stepId } = this.#scope;
+        const { app, recipe } = this.#target;
+        const { soft, negated } = this.#sense;
+        const location = run.location();
+        if (this.#target.run !== run)
+            throw misuse('This locator belongs to another test. Find it again with its page.', run);
+        const timeoutMs = readAssertionOptions(matched.matcher, options, this.#scope);
+        const record = negated ? { ...matched, not: true } : matched;
+        const label = `${soft ? 'expect.soft' : 'expect'}(${describeLocator(recipe)})${negated ? '.not' : ''}.${matched.matcher}()`;
+        return run.assertion(label, location, () => pollLayout({ run, stepId, app, recipe, record, location, soft, timeoutMs }), app);
+    }
 }
 class PageExpectation {
     #scope;
@@ -175,6 +231,33 @@ class PageExpectation {
             return this.#assert({ matcher: 'toHaveTitle', pattern: textPatternOf(title) }, options);
         throw misuse(`toHaveTitle() takes the title as a string or a RegExp, received ${formatValue(title)}.`, this.#scope.run);
     }
+    toScrollHorizontally(options) {
+        const { run, stepId } = this.#scope;
+        const { app } = this.#target;
+        const { soft, negated } = this.#sense;
+        const location = run.location();
+        if (this.#target.run !== run)
+            throw misuse('This page belongs to another test. Use the page this test was given.', run);
+        const timeoutMs = readAssertionOptions('toScrollHorizontally', options, this.#scope);
+        const record = negated ? { matcher: 'toScrollHorizontally', not: true } : { matcher: 'toScrollHorizontally' };
+        const label = `${soft ? 'expect.soft' : 'expect'}(page)${negated ? '.not' : ''}.toScrollHorizontally()`;
+        return run.assertion(label, location, () => pollLayout({ run, stepId, app, recipe: undefined, record, location, soft, timeoutMs }), app);
+    }
+    toHaveScreenshot(name, options) {
+        const { run, stepId } = this.#scope;
+        const { app } = this.#target;
+        const { soft, negated } = this.#sense;
+        const location = run.location();
+        if (negated)
+            throw misuse(misplaced.screenshotNot, run);
+        if (this.#target.run !== run)
+            throw misuse('This page belongs to another test. Use the page this test was given.', run);
+        const call = readScreenshotCall(name, options);
+        if (typeof call === 'string')
+            throw misuse(call, run);
+        const label = `${soft ? 'expect.soft' : 'expect'}(page).toHaveScreenshot()`;
+        return run.assertion(label, location, () => pollScreenshot({ run, stepId, app, recipe: undefined, record: call.record, location, soft, timeoutMs: call.timeoutMs }), app);
+    }
     toBe() {
         throw misuse(misplaced.toBe, this.#scope.run);
     }
@@ -260,6 +343,21 @@ class ValueExpectation {
     toHaveTitle() {
         throw misuse(misplaced.toHaveTitle, this.#scope.run);
     }
+    toOverlap() {
+        throw misuse(misplaced.toOverlap, this.#scope.run);
+    }
+    toOverflowViewport() {
+        throw misuse(misplaced.toOverflowViewport, this.#scope.run);
+    }
+    toHaveClippedText() {
+        throw misuse(misplaced.toHaveClippedText, this.#scope.run);
+    }
+    toScrollHorizontally() {
+        throw misuse(misplaced.toScrollHorizontally, this.#scope.run);
+    }
+    toHaveScreenshot() {
+        throw misuse(misplaced.toHaveScreenshot, this.#scope.run);
+    }
     get not() {
         throw misuse(misplaced.not, this.#scope.run);
     }

package/dist/assertions/look-until.d.ts

@@ -19,6 +19,11 @@ export type LookOptions<Observed> = {
         ok: true;
     }>): Look<Observed> | undefined;
     passes(observation: Observed): boolean;
+    /**
+     * The waits before each look in milliseconds, counting from 0 for the first, the last repeating, for a check whose
+     * looks must be spaced, such as a screenshot's. Absent: `pollDelay`'s.
+     */
+    delays?: readonly number[];
 };
 /** How the looks went: the last, how many, when they began, and the failure that stopped them, if one did. */
 export type Looked<Observed> = {

package/dist/assertions/look-until.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"look-until.d.ts","sourceRoot":"","sources":["../../src/assertions/look-until.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAItE,mHAAmH;AACnH,MAAM,MAAM,IAAI,CAAC,QAAQ,IAAI;IAC3B,WAAW,EAAE,QAAQ,CAAA;IACrB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,QAAQ,IAAI;IAClC,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,+FAA+F;IAC/F,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAChF,4EAA4E;IAC5E,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAC9E,MAAM,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAA;CACvC,CAAA;AAED,8GAA8G;AAC9G,MAAM,MAAM,MAAM,CAAC,QAAQ,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAA;AAKtI,kHAAkH;AAClH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,+HAA+H;AAC/H,eAAO,MAAM,WAAW,EAAE,MAAW,CAAA;AAErC;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CA0CnG"}
+{"version":3,"file":"look-until.d.ts","sourceRoot":"","sources":["../../src/assertions/look-until.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAItE,mHAAmH;AACnH,MAAM,MAAM,IAAI,CAAC,QAAQ,IAAI;IAC3B,WAAW,EAAE,QAAQ,CAAA;IACrB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,QAAQ,IAAI;IAClC,GAAG,EAAE,OAAO,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,+FAA+F;IAC/F,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAChF,4EAA4E;IAC5E,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IAC9E,MAAM,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAA;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,8GAA8G;AAC9G,MAAM,MAAM,MAAM,CAAC,QAAQ,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,CAAA;AAKtI,kHAAkH;AAClH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,+HAA+H;AAC/H,eAAO,MAAM,WAAW,EAAE,MAAW,CAAA;AAErC;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CA0CnG"}

package/dist/assertions/look-until.js

@@ -28,7 +28,7 @@ export async function lookUntil(options) {
     for (;;) {
         // Rounded up, so a wait cut to the deadline ends at it; a timer that fires early leaves time, and the loop waits again.
         const waitToEndMs = deadline.waitToEndMs;
-        const delay = smallestBudget(pollDelay(attempts), waitToEndMs);
+        const delay = smallestBudget(options.delays === undefined ? pollDelay(attempts) : (options.delays[Math.min(attempts, options.delays.length - 1)] ?? 0), waitToEndMs);
         let after;
         const changes = last?.changes;
         if (changes === undefined) {

package/dist/assertions/poll-layout.d.ts

@@ -0,0 +1,24 @@
+import type { TestRun } from '../api/test-run.ts';
+import type { SourceLocation } from '../protocol/failures.ts';
+import type { LayoutCheckRecord } from '../protocol/layout-checks.ts';
+import type { LocatorRecipe } from '../protocol/locator.ts';
+export type LayoutPollOptions = {
+    run: TestRun;
+    stepId: string | undefined;
+    app: string;
+    /** The element the matcher was called on; absent for a page matcher. */
+    recipe: LocatorRecipe | undefined;
+    /** The matcher and its arguments, which the parent judges the look the event names with. */
+    record: LayoutCheckRecord;
+    location: SourceLocation | undefined;
+    soft: boolean;
+    /** The matcher's own `timeout`, which may shorten the assertion budget and never lengthens it. */
+    timeoutMs?: number | undefined;
+};
+/**
+ * Measures an app's page until the layout check passes or the assertion's time runs out, as a locator assertion looks:
+ * it only reads, and never repeats the action before it. The event names the look its verdict rested on, carries the
+ * check whole, and records what that look measured, so the parent can judge it again.
+ */
+export declare function pollLayout(options: LayoutPollOptions): Promise<void>;
+//# sourceMappingURL=poll-layout.d.ts.map

package/dist/assertions/poll-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-layout.d.ts","sourceRoot":"","sources":["../../src/assertions/poll-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAW,cAAc,EAAiB,MAAM,yBAAyB,CAAA;AAErF,OAAO,KAAK,EAAe,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAQ3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,wEAAwE;IACxE,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IACjC,4FAA4F;IAC5F,MAAM,EAAE,iBAAiB,CAAA;IACzB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,kGAAkG;IAClG,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsC1E"}

package/dist/assertions/poll-layout.js

@@ -0,0 +1,63 @@
+import { elapsedMs } from "../protocol/deadline.js";
+import { failure, truncateText } from "../protocol/failures.js";
+import { layoutCheck, layoutRequest } from "../protocol/layout-checks.js";
+import { lookUntil } from "./look-until.js";
+import { assertionTime, lookOf, lookReference } from "./poll-locator.js";
+import { reportAssertion } from "./report.js";
+/**
+ * Measures an app's page until the layout check passes or the assertion's time runs out, as a locator assertion looks:
+ * it only reads, and never repeats the action before it. The event names the look its verdict rested on, carries the
+ * check whole, and records what that look measured, so the parent can judge it again.
+ */
+export async function pollLayout(options) {
+    const { run, app, recipe, record, location } = options;
+    const check = layoutCheck(record);
+    const request = layoutRequest(record, recipe);
+    const timeoutMs = assertionTime(run, options.timeoutMs);
+    const looked = await lookUntil({
+        run,
+        timeoutMs,
+        location,
+        look: (lookMs, after) => run.observeLayout(app, request, lookMs, location, after),
+        read: (result) => (result.kind === 'observeLayout' ? lookOf(result.observation, result) : undefined),
+        passes: check.passes,
+    });
+    const { stopped, attempts } = looked;
+    const last = looked.last?.observation;
+    const passed = stopped === undefined && last !== undefined && check.passes(last);
+    const fields = {
+        testId: run.testId,
+        attemptId: run.attemptId,
+        ...(options.stepId === undefined ? {} : { stepId: options.stepId }),
+        session: app,
+        matcher: check.matcher,
+        ...(recipe === undefined ? {} : { locator: recipe }),
+        expected: truncateText(check.expected),
+        actual: last === undefined ? null : nullableText(check.actual(last)),
+        comparison: check.comparison,
+        attempts,
+        timeoutMs,
+        durationMs: elapsedMs(looked.startedAt, run.time.now),
+        ...(location === undefined ? {} : { location }),
+        ...lookReference(looked.last),
+        ...(last === undefined ? {} : { layout: check.measured(last) }),
+        check: record,
+    };
+    if (passed)
+        return reportAssertion(run, fields, undefined, false);
+    // Only the check's own verdict is softened; a page that could not be read stops the test as usual.
+    if (stopped !== undefined)
+        return reportAssertion(run, fields, stopped, false);
+    reportAssertion(run, fields, unmet({ check, recipe, last, attempts, timeoutMs, location }), options.soft);
+}
+function unmet({ check, recipe, last, attempts, timeoutMs, location }) {
+    if (last === undefined)
+        return failure('timeout', `The page answered no look within ${timeoutMs} ms.`, location);
+    const looked = `Looked ${attempts} ${attempts === 1 ? 'time' : 'times'} in ${timeoutMs} ms.`;
+    const details = { expected: truncateText(check.expected), received: nullableText(check.actual(last)), attempts, timeoutMs, comparison: check.comparison };
+    const reason = check.unmet(last, recipe);
+    return { ...failure(reason.class, `${reason.message} ${looked}`, location), details };
+}
+function nullableText(text) {
+    return text === null ? null : truncateText(text);
+}

package/dist/assertions/screenshot.d.ts

@@ -0,0 +1,36 @@
+import type { TestRun } from '../api/test-run.ts';
+import type { SourceLocation } from '../protocol/failures.ts';
+import type { LocatorRecipe } from '../protocol/locator.ts';
+import type { ScreenshotCheckRecord } from '../protocol/screenshot.ts';
+/** A screenshot check as the test called it: its record, and its own `timeout`, when it gave one. */
+export type ScreenshotCall = {
+    record: ScreenshotCheckRecord;
+    timeoutMs?: number;
+};
+/**
+ * Reads what a test passed `toHaveScreenshot`: the baseline's name, with a `.png` it ends in left off, and the options.
+ * Answers with a sentence for anything else, which the caller throws as misuse.
+ *
+ * @example readScreenshotCall('dashboard.png', { maxDiffPixels: 50 }) // { record: { matcher: 'toHaveScreenshot', name: 'dashboard', maxDiffPixels: 50 } }
+ */
+export declare function readScreenshotCall(name: unknown, options: unknown): ScreenshotCall | string;
+export type ScreenshotPollOptions = {
+    run: TestRun;
+    stepId: string | undefined;
+    app: string;
+    /** The element the matcher was called on; absent for the page. */
+    recipe: LocatorRecipe | undefined;
+    record: ScreenshotCheckRecord;
+    location: SourceLocation | undefined;
+    soft: boolean;
+    timeoutMs?: number | undefined;
+};
+/**
+ * Takes pictures of an app's page, or of one element, at the waits `pictureWaits` lists, until a picture has settled
+ * and passes against its baseline, the baseline is missing or cannot be read, or the assertion's time runs out, then
+ * judges the last. It only reads, and never repeats the action before it, so a page still loading passes once it
+ * shows its baseline, and a page that never stops moving fails as one that did not settle. The event names the look
+ * its verdict rested on and carries the check whole; the parent records what the picture showed.
+ */
+export declare function pollScreenshot(options: ScreenshotPollOptions): Promise<void>;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/assertions/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/assertions/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAW,cAAc,EAAiB,MAAM,yBAAyB,CAAA;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAmB,qBAAqB,EAAkB,MAAM,2BAA2B,CAAA;AAUvG,qGAAqG;AACrG,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAIlF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,MAAM,CA2B3F;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,OAAO,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,kEAAkE;IAClE,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;IACjC,MAAM,EAAE,qBAAqB,CAAA;IAC7B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2ClF"}

package/dist/assertions/screenshot.js

@@ -0,0 +1,125 @@
+import { formatValue } from "../api/format-value.js";
+import { elapsedMs } from "../protocol/deadline.js";
+import { failure, truncateText } from "../protocol/failures.js";
+import { pictureWaits, screenshotCheck, screenshotNameRefusal, screenshotRequest, thresholdRefusal } from "../protocol/screenshot.js";
+import { maxTimeout } from "../protocol/timeouts.js";
+import { lookUntil } from "./look-until.js";
+import { assertionTime, lookOf, lookReference } from "./poll-locator.js";
+import { reportAssertion } from "./report.js";
+const optionNames = ['threshold', 'maxDiffPixels', 'maxDiffPixelRatio', 'timeout'];
+/**
+ * Reads what a test passed `toHaveScreenshot`: the baseline's name, with a `.png` it ends in left off, and the options.
+ * Answers with a sentence for anything else, which the caller throws as misuse.
+ *
+ * @example readScreenshotCall('dashboard.png', { maxDiffPixels: 50 }) // { record: { matcher: 'toHaveScreenshot', name: 'dashboard', maxDiffPixels: 50 } }
+ */
+export function readScreenshotCall(name, options) {
+    if (typeof name !== 'string')
+        return `toHaveScreenshot() takes the name of its baseline, such as 'dashboard', received ${formatValue(name)}.`;
+    const named = name.endsWith('.png') ? name.slice(0, -'.png'.length) : name;
+    const refused = screenshotNameRefusal(named);
+    if (refused !== undefined)
+        return name === named ? refused : `${refused} A .png at the end of ${formatValue(name)} is left off.`;
+    if (options === undefined)
+        return { record: { matcher: 'toHaveScreenshot', name: named } };
+    const shape = `toHaveScreenshot() takes options such as { maxDiffPixels: 50 }, received ${formatValue(options)}.`;
+    if (typeof options !== 'object' || options === null || Array.isArray(options))
+        return shape;
+    const given = Object.entries(options).filter(([, value]) => value !== undefined);
+    if (given.some(([key]) => !optionNames.includes(key)))
+        return `${shape} Its options are threshold, maxDiffPixels, maxDiffPixelRatio and timeout.`;
+    const read = (key) => given.find(([option]) => option === key)?.[1];
+    const threshold = read('threshold');
+    const maxDiffPixels = read('maxDiffPixels');
+    const maxDiffPixelRatio = read('maxDiffPixelRatio');
+    const timeout = read('timeout');
+    if (threshold !== undefined && !isFraction(threshold))
+        return thresholdRefusal(formatValue(threshold));
+    if (maxDiffPixels !== undefined && !isCount(maxDiffPixels))
+        return `The maxDiffPixels option of toHaveScreenshot() is a whole number of pixels from 0, received ${formatValue(maxDiffPixels)}.`;
+    if (maxDiffPixelRatio !== undefined && !isFraction(maxDiffPixelRatio))
+        return `The maxDiffPixelRatio option of toHaveScreenshot() is a part of the pixels from 0 to 1, received ${formatValue(maxDiffPixelRatio)}.`;
+    if (timeout !== undefined && !(isCount(timeout) && timeout >= 1 && timeout <= maxTimeout))
+        return `The timeout option of toHaveScreenshot() must be a whole number of milliseconds from 1 to ${maxTimeout}, received ${formatValue(timeout)}.`;
+    const record = {
+        matcher: 'toHaveScreenshot',
+        name: named,
+        ...(threshold === undefined ? {} : { threshold }),
+        ...(maxDiffPixels === undefined ? {} : { maxDiffPixels }),
+        ...(maxDiffPixelRatio === undefined ? {} : { maxDiffPixelRatio }),
+    };
+    return timeout === undefined ? { record } : { record, timeoutMs: timeout };
+}
+/**
+ * Takes pictures of an app's page, or of one element, at the waits `pictureWaits` lists, until a picture has settled
+ * and passes against its baseline, the baseline is missing or cannot be read, or the assertion's time runs out, then
+ * judges the last. It only reads, and never repeats the action before it, so a page still loading passes once it
+ * shows its baseline, and a page that never stops moving fails as one that did not settle. The event names the look
+ * its verdict rested on and carries the check whole; the parent records what the picture showed.
+ */
+export async function pollScreenshot(options) {
+    const { run, app, recipe, record, location } = options;
+    const check = screenshotCheck(record);
+    const request = screenshotRequest(record, recipe);
+    const timeoutMs = assertionTime(run, options.timeoutMs);
+    let previous;
+    const looked = await lookUntil({
+        run,
+        timeoutMs,
+        location,
+        look: (lookMs) => run.observeScreenshot(app, request, previous, lookMs, location),
+        read: (result) => {
+            if (result.kind !== 'observeScreenshot')
+                return undefined;
+            previous = result.observationId;
+            return lookOf(result.observation, result);
+        },
+        passes: check.done,
+        delays: pictureWaits,
+    });
+    const { stopped, attempts } = looked;
+    const last = looked.last?.observation;
+    const passed = stopped === undefined && last !== undefined && check.passes(last);
+    const fields = {
+        testId: run.testId,
+        attemptId: run.attemptId,
+        ...(options.stepId === undefined ? {} : { stepId: options.stepId }),
+        session: app,
+        matcher: check.matcher,
+        ...(recipe === undefined ? {} : { locator: recipe }),
+        expected: truncateText(check.expected),
+        actual: last === undefined ? null : nullableText(check.actual(last)),
+        comparison: check.comparison,
+        attempts,
+        timeoutMs,
+        durationMs: elapsedMs(looked.startedAt, run.time.now),
+        ...(location === undefined ? {} : { location }),
+        ...lookReference(looked.last),
+        check: record,
+    };
+    if (passed)
+        return reportAssertion(run, fields, undefined, false);
+    // Only the check's own verdict is softened; a page that could not be pictured stops the test as usual.
+    if (stopped !== undefined)
+        return reportAssertion(run, fields, stopped, false);
+    reportAssertion(run, fields, unmet({ check, recipe, last, attempts, timeoutMs, location }), options.soft);
+}
+function unmet({ check, recipe, last, attempts, timeoutMs, location }) {
+    if (last === undefined)
+        return failure('timeout', `The page answered no look within ${timeoutMs} ms.`, location);
+    const looked = `Looked ${attempts} ${attempts === 1 ? 'time' : 'times'} in ${timeoutMs} ms.`;
+    const details = { expected: truncateText(check.expected), received: nullableText(check.actual(last)), attempts, timeoutMs, comparison: check.comparison };
+    const reason = check.unmet(last, recipe);
+    // A picture or a baseline that cannot be read says all there is, as the parent's own judgement says it.
+    const message = reason.class === 'setup_failed' ? reason.message : `${reason.message} ${looked}`;
+    return { ...failure(reason.class, message, location), details };
+}
+function nullableText(text) {
+    return text === null ? null : truncateText(text);
+}
+function isFraction(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1;
+}
+function isCount(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}

package/dist/browser/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/browser/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAMvD,6HAA6H;AAC7H,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEtF,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAU5C,CAAA;AAqBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAsBtH"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/browser/accessibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAMvD,6HAA6H;AAC7H,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEtF,oDAAoD;AACpD,eAAO,MAAM,aAAa,EAAE,SAAS,QAAQ,EAU5C,CAAA;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAiBtH"}