@mobilewright/core 0.0.41 → 0.0.43

package/dist/device.d.ts

@@ -1,8 +1,12 @@
-import type { AppInfo, ConnectionConfig, LaunchOptions, MobilewrightDriver, Orientation, RecordingOptions, RecordingResult, Session } from '@mobilewright/protocol';
+import type { AppInfo, ConnectionConfig, LaunchOptions, MobilewrightDriver, Orientation, RecordingOptions, RecordingResult, ScreenSize, Session } from '@mobilewright/protocol';
 import { Screen } from './screen.js';
 import type { LocatorOptions } from './locator.js';
 export interface DeviceOptions {
     locatorDefaults?: LocatorOptions;
+    /** Timeout waiting for app to reach foreground after launch, in ms. Default: 20000. */
+    appLaunchTimeout?: number;
+    /** Timeout for app installation in ms. Default: none (no limit). */
+    installTimeout?: number;
 }
 export declare class Device {
     readonly driver: MobilewrightDriver;
@@ -19,6 +23,8 @@ export declare class Device {
     get screen(): Screen;
     getOrientation(): Promise<Orientation>;
     setOrientation(orientation: Orientation): Promise<void>;
+    /** Screen dimensions and pixel density: { width, height, scale }. */
+    screenSize(): Promise<ScreenSize>;
     openUrl(url: string): Promise<void>;
     /** Alias for openUrl — matches Playwright's page.goto(). */
     goto(url: string): Promise<void>;

package/dist/device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,OAAO,EACR,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,MAAM,EAAE,kBAAkB,EAAE,IAAI,GAAE,aAAkB;IAKhE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMtC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,IAAI,MAAM,IAAI,MAAM,CAGnB;IAIK,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAItC,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,4DAA4D;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAI9B,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;CAGhD"}
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,OAAO,EACR,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAOnD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD,qBAAa,MAAM;IACjB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,MAAM,EAAE,kBAAkB,EAAE,IAAI,GAAE,aAAkB;IAKhE,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMtC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,IAAI,MAAM,IAAI,MAAM,CAGnB;IAIK,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAItC,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7D,qEAAqE;IAC/D,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,4DAA4D;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BhE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAI9B,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC;CAGhD"}

package/dist/device.js

@@ -3,6 +3,12 @@ import { Screen } from './screen.js';
 import { retryUntil } from './poll.js';
 const debug = createDebug('mw:device');
 const LAUNCH_APP_TIMEOUT = 20_000;
+function raceWithTimeout(promise, ms, message) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(message)), ms);
+        promise.then((value) => { clearTimeout(timer); resolve(value); }, (err) => { clearTimeout(timer); reject(err); });
+    });
+}
 export class Device {
     constructor(driver, opts = {}) {
         this.cleanupCallbacks = [];
@@ -40,6 +46,10 @@ export class Device {
     async setOrientation(orientation) {
         return this.driver.setOrientation(orientation);
     }
+    /** Screen dimensions and pixel density: { width, height, scale }. */
+    async screenSize() {
+        return this.driver.getScreenSize();
+    }
     async openUrl(url) {
         return this.driver.openUrl(url);
     }
@@ -53,9 +63,10 @@ export class Device {
         if (opts?.noWaitAfter) {
             return;
         }
+        const timeout = this.opts.appLaunchTimeout ?? LAUNCH_APP_TIMEOUT;
         debug('waiting for %s to reach foreground', bundleId);
         try {
-            await retryUntil(() => this.getForegroundApp(), (app) => app.bundleId === bundleId, LAUNCH_APP_TIMEOUT, `launchApp: timed out waiting for "${bundleId}" to be in foreground`);
+            await retryUntil(() => this.getForegroundApp(), (app) => app.bundleId === bundleId, timeout, `launchApp: timed out waiting for "${bundleId}" to be in foreground`);
             debug('%s is in foreground', bundleId);
         }
         catch (err) {
@@ -80,7 +91,11 @@ export class Device {
         return this.driver.getForegroundApp();
     }
     async installApp(path) {
-        return this.driver.installApp(path);
+        const { installTimeout } = this.opts;
+        if (installTimeout === undefined) {
+            return this.driver.installApp(path);
+        }
+        return raceWithTimeout(this.driver.installApp(path), installTimeout, `installApp timed out after ${installTimeout}ms`);
     }
     async uninstallApp(bundleId) {
         return this.driver.uninstallApp(bundleId);

package/dist/device.js.map

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

package/dist/device.test.d.ts

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

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

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

package/dist/device.test.js

@@ -0,0 +1,39 @@
+import { test, expect } from '@playwright/test';
+import { Device } from './device.js';
+function createMockDriver(screenSize) {
+    return {
+        connect: async () => ({ deviceId: 'device1', platform: 'ios' }),
+        disconnect: async () => { },
+        getViewHierarchy: async () => [],
+        tap: async () => { },
+        doubleTap: async () => { },
+        longPress: async () => { },
+        typeText: async () => { },
+        swipe: async () => { },
+        gesture: async () => { },
+        pressButton: async () => { },
+        screenshot: async () => Buffer.from(''),
+        getScreenSize: async () => screenSize,
+        getOrientation: async () => 'portrait',
+        setOrientation: async () => { },
+        launchApp: async () => { },
+        terminateApp: async () => { },
+        listApps: async () => [],
+        getForegroundApp: async () => ({ bundleId: 'com.test' }),
+        installApp: async () => { },
+        uninstallApp: async () => { },
+        listDevices: async () => [],
+        openUrl: async () => { },
+        startRecording: async () => { },
+        stopRecording: async () => ({}),
+    };
+}
+test.describe('Device.screenSize', () => {
+    test('returns the width, height, and scale from the driver', async () => {
+        const driver = createMockDriver({ width: 390, height: 844, scale: 3 });
+        const device = new Device(driver);
+        const size = await device.screenSize();
+        expect(size).toEqual({ width: 390, height: 844, scale: 3 });
+    });
+});
+//# sourceMappingURL=device.test.js.map

package/dist/device.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.test.js","sourceRoot":"","sources":["../src/device.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,SAAS,gBAAgB,CAAC,UAAsB;IAC9C,OAAO;QACL,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAc,EAAE,CAAC;QACxE,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC1B,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAChC,GAAG,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACnB,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACzB,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACzB,QAAQ,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACxB,KAAK,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACrB,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACvB,WAAW,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC3B,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU;QACrC,cAAc,EAAE,KAAK,IAAI,EAAE,CAAC,UAAyB;QACrD,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACzB,YAAY,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC5B,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,EAAe;QACrC,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QACxD,UAAU,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC1B,YAAY,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC5B,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,EAAkB;QAC3C,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QACvB,cAAc,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;QAC9B,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACtC,IAAI,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACtE,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAEvC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/expect.d.ts

@@ -1,24 +1,55 @@
-import type { Locator } from './locator.js';
+import type { Locator, StepFn } from './locator.js';
+import { Page } from './page.js';
+import { WebLocator } from './web-locator.js';
 export interface ExpectOptions {
     timeout?: number;
 }
 /**
- * Playwright-style expect for mobile locators and plain values.
+ * Playwright-style expect for mobile locators, web locators, pages, and plain values.
  *
  * Usage:
  *   expect(locator).toBeVisible()
- *   expect(locator).not.toBeVisible()
- *   expect(locator).toHaveText('Hello')
+ *   expect(page).toHaveURL(/dashboard/)
+ *   expect(webLocator).toHaveText('Hello')
  *   expect(42).toBe(42)
  */
+export declare function expect(actual: Page): PageAssertions;
+export declare function expect(actual: WebLocator): WebLocatorAssertions;
 export declare function expect(actual: Locator): LocatorAssertions;
 export declare function expect<T>(actual: T): ValueAssertions<T>;
+interface LocatorLike {
+    isVisible(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    isEnabled(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    isChecked(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    isSelected?(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    isFocused?(opts?: {
+        timeout?: number;
+    }): Promise<boolean>;
+    getText(opts?: {
+        timeout?: number;
+    }): Promise<string>;
+    getValue(opts?: {
+        timeout?: number;
+    }): Promise<string>;
+    count(): Promise<number>;
+    expectTimeout?: number;
+    _stepFn?: StepFn | null;
+}
 declare class LocatorAssertions {
-    private readonly locator;
-    private readonly negated;
-    constructor(locator: Locator, negated: boolean);
+    protected readonly locator: LocatorLike;
+    protected readonly negated: boolean;
+    constructor(locator: LocatorLike, negated: boolean);
     get not(): LocatorAssertions;
-    private _wrapAssertion;
+    private assertionTimeout;
+    protected _wrapAssertion<T>(method: string, fn: () => Promise<T>): Promise<T>;
     toBeVisible(opts?: ExpectOptions): Promise<void>;
     toBeHidden(opts?: ExpectOptions): Promise<void>;
     toBeEnabled(opts?: ExpectOptions): Promise<void>;
@@ -31,9 +62,9 @@ declare class LocatorAssertions {
     toHaveCount(expected: number, opts?: ExpectOptions): Promise<void>;
     toBeEmpty(opts?: ExpectOptions): Promise<void>;
     toHaveValue(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
-    private assertBoolean;
-    private assertText;
-    private retryAssertion;
+    protected assertBoolean(name: string, poll: () => Promise<boolean>, opts?: ExpectOptions): Promise<void>;
+    protected assertText(predicate: (text: string) => boolean, expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    protected retryAssertion<T>(poll: () => Promise<T>, predicate: (value: T) => boolean, timeout: number, failMessage: string | (() => string)): Promise<void>;
 }
 declare class ValueAssertions<T> {
     private readonly actual;
@@ -64,6 +95,46 @@ declare class ValueAssertions<T> {
     toThrow(expected?: string | RegExp): void;
     private assert;
 }
+declare class PageAssertions {
+    private readonly page;
+    private readonly negated;
+    constructor(page: Page, negated: boolean);
+    get not(): PageAssertions;
+    private _wrapAssertion;
+    private matches;
+    toHaveURL(url: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveTitle(title: string | RegExp, opts?: ExpectOptions): Promise<void>;
+}
+declare class WebLocatorAssertions {
+    private readonly webLocator;
+    private readonly negated;
+    constructor(webLocator: WebLocator, negated: boolean);
+    get not(): WebLocatorAssertions;
+    private assertionTimeout;
+    private runMatcher;
+    toBeVisible(opts?: ExpectOptions): Promise<void>;
+    toBeHidden(opts?: ExpectOptions): Promise<void>;
+    toBeEnabled(opts?: ExpectOptions): Promise<void>;
+    toBeDisabled(opts?: ExpectOptions): Promise<void>;
+    toBeEditable(opts?: ExpectOptions): Promise<void>;
+    toBeFocused(opts?: ExpectOptions): Promise<void>;
+    toBeAttached(opts?: ExpectOptions): Promise<void>;
+    toBeInViewport(opts?: ExpectOptions & {
+        ratio?: number;
+    }): Promise<void>;
+    toBeChecked(opts?: ExpectOptions): Promise<void>;
+    toBeEmpty(opts?: ExpectOptions): Promise<void>;
+    toHaveText(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toContainText(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveValue(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveCount(expected: number, opts?: ExpectOptions): Promise<void>;
+    toHaveAttribute(name: string, expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveClass(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toContainClass(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveCSS(name: string, expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveId(expected: string | RegExp, opts?: ExpectOptions): Promise<void>;
+    toHaveJSProperty(name: string, expected: unknown, opts?: ExpectOptions): Promise<void>;
+}
 export declare class ExpectError extends Error {
     constructor(message: string);
 }

package/dist/expect.d.ts.map

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

package/dist/expect.js

@@ -1,13 +1,38 @@
 import { LocatorError } from './locator.js';
+import { Page } from './page.js';
+import { WebLocator } from './web-locator.js';
 import { retryUntil } from './poll.js';
-import { filterStack, captureLocation } from './stackTrace.js';
+import { filterStack, runStep } from './stackTrace.js';
+import { textValue } from './web-expect-matcher.js';
 const DEFAULT_TIMEOUT = 5_000;
 export function expect(actual) {
+    if (actual instanceof Page) {
+        return new PageAssertions(actual, false);
+    }
+    if (actual instanceof WebLocator) {
+        return new WebLocatorAssertions(actual, false);
+    }
     if (actual && typeof actual === 'object' && 'tap' in actual && 'getText' in actual) {
         return new LocatorAssertions(actual, false);
     }
     return new ValueAssertions(actual, false);
 }
+// Wrap an assertion body as a reporter step titled after the matcher, shared by
+// all assertion classes so the title/negation convention lives in one place.
+function wrapAssertion(stepFn, negated, method, fn) {
+    const title = negated ? `expect.not.${method}()` : `expect.${method}()`;
+    return runStep(stepFn, title, fn);
+}
+// Poll until `predicate` holds (or the timeout elapses), re-raising any failure
+// as an ExpectError. The predicate must already account for negation.
+async function retryAssertion(poll, predicate, timeout, failMessage) {
+    try {
+        await retryUntil(poll, predicate, timeout, failMessage);
+    }
+    catch (e) {
+        throw new ExpectError(e instanceof Error ? e.message : String(e));
+    }
+}
 class LocatorAssertions {
     constructor(locator, negated) {
         this.locator = locator;
@@ -16,14 +41,11 @@ class LocatorAssertions {
     get not() {
         return new LocatorAssertions(this.locator, !this.negated);
     }
+    assertionTimeout(opts) {
+        return opts?.timeout ?? this.locator.expectTimeout ?? DEFAULT_TIMEOUT;
+    }
     _wrapAssertion(method, fn) {
-        const stepFn = this.locator._stepFn;
-        const title = this.negated ? `expect.not.${method}()` : `expect.${method}()`;
-        if (stepFn) {
-            const location = captureLocation();
-            return stepFn(title, fn, location);
-        }
-        return fn();
+        return wrapAssertion(this.locator._stepFn, this.negated, method, fn);
     }
     async toBeVisible(opts) {
         return this._wrapAssertion('toBeVisible', async () => {
@@ -53,12 +75,20 @@ class LocatorAssertions {
     }
     async toBeSelected(opts) {
         return this._wrapAssertion('toBeSelected', async () => {
-            await this.assertBoolean('selected', () => this.locator.isSelected({ timeout: 0 }), opts);
+            const isSelected = this.locator.isSelected?.bind(this.locator);
+            if (!isSelected) {
+                throw new ExpectError('toBeSelected() is not supported for this locator');
+            }
+            await this.assertBoolean('selected', () => isSelected({ timeout: 0 }), opts);
         });
     }
     async toBeFocused(opts) {
         return this._wrapAssertion('toBeFocused', async () => {
-            await this.assertBoolean('focused', () => this.locator.isFocused({ timeout: 0 }), opts);
+            const isFocused = this.locator.isFocused?.bind(this.locator);
+            if (!isFocused) {
+                throw new ExpectError('toBeFocused() is not supported for this locator');
+            }
+            await this.assertBoolean('focused', () => isFocused({ timeout: 0 }), opts);
         });
     }
     async toBeChecked(opts) {
@@ -82,7 +112,7 @@ class LocatorAssertions {
             await this.retryAssertion(async () => { lastCount = await this.locator.count(); return lastCount; }, (count) => {
                 const matches = count === expected;
                 return this.negated ? !matches : matches;
-            }, opts?.timeout ?? DEFAULT_TIMEOUT, () => this.negated
+            }, this.assertionTimeout(opts), () => this.negated
                 ? `Expected element count NOT to be ${expected}, but got ${lastCount}`
                 : `Expected element count to be ${expected}, but got ${lastCount}`);
         });
@@ -107,7 +137,7 @@ class LocatorAssertions {
                 }
                 const isEmpty = value === '';
                 return this.negated ? !isEmpty : isEmpty;
-            }, opts?.timeout ?? DEFAULT_TIMEOUT, () => this.negated
+            }, this.assertionTimeout(opts), () => this.negated
                 ? 'Expected element NOT to be empty, but it was'
                 : `Expected element to be empty, but got "${lastValue}"`);
         });
@@ -132,13 +162,13 @@ class LocatorAssertions {
                 }
                 const matches = expected instanceof RegExp ? expected.test(value) : value === expected;
                 return this.negated ? !matches : matches;
-            }, opts?.timeout ?? DEFAULT_TIMEOUT, () => this.negated
+            }, this.assertionTimeout(opts), () => this.negated
                 ? `Expected element NOT to have value "${expected}", but got "${lastValue}"`
                 : `Expected element to have value "${expected}", but got "${lastValue}"`);
         });
     }
     async assertBoolean(name, poll, opts) {
-        await this.retryAssertion(poll, (result) => (this.negated ? !result : result), opts?.timeout ?? DEFAULT_TIMEOUT, this.negated
+        await this.retryAssertion(poll, (result) => (this.negated ? !result : result), this.assertionTimeout(opts), this.negated
             ? `Expected element to NOT be ${name}, but it was`
             : `Expected element to be ${name}, but it was not`);
     }
@@ -161,17 +191,12 @@ class LocatorAssertions {
             }
             const matches = predicate(text);
             return this.negated ? !matches : matches;
-        }, opts?.timeout ?? DEFAULT_TIMEOUT, () => this.negated
+        }, this.assertionTimeout(opts), () => this.negated
             ? `Expected element NOT to have text "${expected}", but got "${lastText}"`
             : `Expected element to have text "${expected}", but got "${lastText}"`);
     }
-    async retryAssertion(poll, predicate, timeout, failMessage) {
-        try {
-            await retryUntil(poll, predicate, timeout, failMessage);
-        }
-        catch (e) {
-            throw new ExpectError(e instanceof Error ? e.message : String(e));
-        }
+    retryAssertion(poll, predicate, timeout, failMessage) {
+        return retryAssertion(poll, predicate, timeout, failMessage);
     }
 }
 class ValueAssertions {
@@ -297,6 +322,140 @@ class ValueAssertions {
         }
     }
 }
+// ─── PageAssertions ───────────────────────────────────────────
+class PageAssertions {
+    constructor(page, negated) {
+        this.page = page;
+        this.negated = negated;
+    }
+    get not() {
+        return new PageAssertions(this.page, !this.negated);
+    }
+    _wrapAssertion(method, fn) {
+        return wrapAssertion(this.page._stepFn, this.negated, method, fn);
+    }
+    // Applies negation so callers pass the plain "does it match?" predicate.
+    matches(pass) {
+        return this.negated ? !pass : pass;
+    }
+    async toHaveURL(url, opts) {
+        return this._wrapAssertion('toHaveURL', async () => {
+            let last = '';
+            await retryAssertion(async () => { try {
+                last = await this.page.url();
+            }
+            catch {
+                last = '';
+            } return last; }, (current) => this.matches(url instanceof RegExp ? url.test(current) : current === url), opts?.timeout ?? DEFAULT_TIMEOUT, () => `Expected page URL to ${this.negated ? 'not ' : ''}match "${url}", but got "${last}"`);
+        });
+    }
+    async toHaveTitle(title, opts) {
+        return this._wrapAssertion('toHaveTitle', async () => {
+            let last = '';
+            await retryAssertion(async () => { try {
+                last = await this.page.title();
+            }
+            catch {
+                last = '';
+            } return last; }, (current) => this.matches(title instanceof RegExp ? title.test(current) : current === title), opts?.timeout ?? DEFAULT_TIMEOUT, () => `Expected page title to ${this.negated ? 'not ' : ''}match "${title}", but got "${last}"`);
+        });
+    }
+}
+// ─── WebLocatorAssertions ─────────────────────────────────────
+// Standalone: every web matcher routes through Playwright's injected expect()
+// (window.__mwInjected.expect) for byte-exact matcher semantics. Native
+// LocatorAssertions and PageAssertions are unaffected.
+class WebLocatorAssertions {
+    constructor(webLocator, negated) {
+        this.webLocator = webLocator;
+        this.negated = negated;
+    }
+    get not() {
+        return new WebLocatorAssertions(this.webLocator, !this.negated);
+    }
+    assertionTimeout(opts) {
+        return opts?.timeout ?? this.webLocator.expectTimeout ?? DEFAULT_TIMEOUT;
+    }
+    // Poll the injected matcher until matches !== isNot, or throw ExpectError.
+    runMatcher(method, params, opts) {
+        return wrapAssertion(this.webLocator._stepFn, this.negated, method, async () => {
+            const isNot = this.negated;
+            let received;
+            let missingReceived = false;
+            await retryAssertion(async () => {
+                const result = await this.webLocator._runInjectedExpect({ ...params, isNot, timeout: 0 });
+                received = result.received;
+                missingReceived = result.missingReceived ?? false;
+                return result.matches;
+            }, (matches) => matches !== isNot, this.assertionTimeout(opts), () => {
+                const got = missingReceived ? 'no element' : fmt(received);
+                return isNot
+                    ? `Expected ${method} NOT to match, but it did (received ${got})`
+                    : `Expected ${method} to match, but it did not (received ${got})`;
+            });
+        });
+    }
+    toBeVisible(opts) {
+        return this.runMatcher('toBeVisible', { expression: 'to.be.visible' }, opts);
+    }
+    toBeHidden(opts) {
+        return this.runMatcher('toBeHidden', { expression: 'to.be.hidden' }, opts);
+    }
+    toBeEnabled(opts) {
+        return this.runMatcher('toBeEnabled', { expression: 'to.be.enabled' }, opts);
+    }
+    toBeDisabled(opts) {
+        return this.runMatcher('toBeDisabled', { expression: 'to.be.disabled' }, opts);
+    }
+    toBeEditable(opts) {
+        return this.runMatcher('toBeEditable', { expression: 'to.be.editable' }, opts);
+    }
+    toBeFocused(opts) {
+        return this.runMatcher('toBeFocused', { expression: 'to.be.focused' }, opts);
+    }
+    toBeAttached(opts) {
+        return this.runMatcher('toBeAttached', { expression: 'to.be.attached' }, opts);
+    }
+    toBeInViewport(opts) {
+        return this.runMatcher('toBeInViewport', { expression: 'to.be.in.viewport', expectedNumber: opts?.ratio }, opts);
+    }
+    toBeChecked(opts) {
+        return this.runMatcher('toBeChecked', { expression: 'to.be.checked', expectedValue: { checked: true, indeterminate: false } }, opts);
+    }
+    toBeEmpty(opts) {
+        return this.runMatcher('toBeEmpty', { expression: 'to.be.empty' }, opts);
+    }
+    toHaveText(expected, opts) {
+        return this.runMatcher('toHaveText', { expression: 'to.have.text', expectedText: [textValue(expected, { normalizeWhiteSpace: true })] }, opts);
+    }
+    toContainText(expected, opts) {
+        return this.runMatcher('toContainText', { expression: 'to.have.text', expectedText: [textValue(expected, { normalizeWhiteSpace: true, matchSubstring: true })] }, opts);
+    }
+    toHaveValue(expected, opts) {
+        return this.runMatcher('toHaveValue', { expression: 'to.have.value', expectedText: [textValue(expected)] }, opts);
+    }
+    toHaveCount(expected, opts) {
+        return this.runMatcher('toHaveCount', { expression: 'to.have.count', expectedNumber: expected }, opts);
+    }
+    toHaveAttribute(name, expected, opts) {
+        return this.runMatcher('toHaveAttribute', { expression: 'to.have.attribute.value', expressionArg: name, expectedText: [textValue(expected)] }, opts);
+    }
+    toHaveClass(expected, opts) {
+        return this.runMatcher('toHaveClass', { expression: 'to.have.class', expectedText: [textValue(expected)] }, opts);
+    }
+    toContainClass(expected, opts) {
+        return this.runMatcher('toContainClass', { expression: 'to.contain.class', expectedText: [textValue(expected)] }, opts);
+    }
+    toHaveCSS(name, expected, opts) {
+        return this.runMatcher('toHaveCSS', { expression: 'to.have.css', expressionArg: name, expectedText: [textValue(expected)] }, opts);
+    }
+    toHaveId(expected, opts) {
+        return this.runMatcher('toHaveId', { expression: 'to.have.id', expectedText: [textValue(expected)] }, opts);
+    }
+    toHaveJSProperty(name, expected, opts) {
+        return this.runMatcher('toHaveJSProperty', { expression: 'to.have.property', expressionArg: name, expectedValue: expected }, opts);
+    }
+}
 function fmt(value) {
     return typeof value === 'string' ? `"${value}"` : String(value);
 }