@allwright.dev/core 0.1.18 → 0.1.20

package/README.md

@@ -104,7 +104,7 @@ const value = await page.locator('input, textarea').inputValue();
 const options = await page.locator('select').selectedOptions(); // [{ value, label, index }]
 const selectedText = await page.locator('textarea').selectedText();
 const checked = await page.locator('input[type=checkbox]').isChecked();
-const text = await page.locator('h1').innerText(); // { selector, text, note }
+const text = await page.locator('h1').innerText(); // string
 const attribute = await page.locator('a').getAttribute('href');
 const box = await page.locator('button').boundingBox(); // { x, y, width, height }
 ```

package/dist/bootstrap.js

@@ -12,7 +12,7 @@ const ALLWRIGHT_HOME_ENV_VAR = "ALLWRIGHT_HOME";
 const ALLWRIGHT_REPOSITORY_ENV_VAR = "ALLWRIGHT_REPOSITORY";
 const ALLWRIGHT_VERSION_ENV_VAR = "ALLWRIGHT_VERSION";
 const DEFAULT_RELEASE_REPOSITORY = "allwright-dev/allwright";
-const DEFAULT_RELEASE_VERSION = "0.1.18";
+const DEFAULT_RELEASE_VERSION = "0.1.20";
 const STARTUP_TIMEOUT_MS = 20_000;
 const PING_TIMEOUT_MS = 1_000;
 const PROTO_ROOT = fileURLToPath(new URL("../proto/", import.meta.url));

package/dist/locator.d.ts

@@ -1,27 +1,27 @@
 import { WebLocatorBuilders, type LocatorFilterOptions } from "./web-locators.js";
-import type { BoundingBox, CapturedOption, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, HighlightOptions, HighlightResult, Locator, LocatorInfo, Page, PressOptions, PressResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult } from "./types.js";
+import type { BoundingBox, CapturedOption, CommandOptions, HighlightOptions, Locator, LocatorInfo, Page, PressOptions, WaitForSelectorOptions } from "./types.js";
 export declare class LocatorImpl extends WebLocatorBuilders implements Locator {
     readonly page: Page;
     readonly selector: string;
     constructor(input: LocatorInfo);
     frame(options?: CommandOptions): Promise<Page>;
     Frame(options?: CommandOptions): Promise<Page>;
-    click(options?: CommandOptions): Promise<ClickResult>;
-    count(options?: CommandOptions): Promise<CountResult>;
-    highlight(options?: HighlightOptions): Promise<HighlightResult>;
-    focus(options?: CommandOptions): Promise<ElementResult>;
-    fill(value: string, options?: CommandOptions): Promise<FillResult>;
-    hover(options?: CommandOptions): Promise<ElementResult>;
-    press(key: string, options?: PressOptions): Promise<PressResult>;
+    click(options?: CommandOptions): Promise<void>;
+    count(options?: CommandOptions): Promise<number>;
+    highlight(options?: HighlightOptions): Promise<void>;
+    focus(options?: CommandOptions): Promise<void>;
+    fill(value: string, options?: CommandOptions): Promise<void>;
+    hover(options?: CommandOptions): Promise<void>;
+    press(key: string, options?: PressOptions): Promise<void>;
     inputValue(options?: CommandOptions): Promise<string>;
     selectedOptions(options?: CommandOptions): Promise<CapturedOption[]>;
     selectedText(options?: CommandOptions): Promise<string | null>;
     isChecked(options?: CommandOptions): Promise<boolean>;
     getAttribute(name: string, options?: CommandOptions): Promise<string | null>;
     boundingBox(options?: CommandOptions): Promise<BoundingBox | null>;
-    textContent(options?: CommandOptions): Promise<TextResult>;
-    innerText(options?: CommandOptions): Promise<TextResult>;
-    waitFor(options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
+    textContent(options?: CommandOptions): Promise<string | null>;
+    innerText(options?: CommandOptions): Promise<string>;
+    waitFor(options?: WaitForSelectorOptions): Promise<void>;
     not(other: Locator): Locator;
     filter(options?: LocatorFilterOptions): Locator;
     nth(index: number): Locator;

package/dist/mobile.js

@@ -3,6 +3,7 @@ import { open, rename, unlink, writeFile } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
 import { basename } from "node:path";
 import { chainMobileSelectorForTransport, normalizeMobileSelectorForTransport } from "./mobileSelectors.js";
+import { semanticSelector } from "./web-locators.js";
 function retryOptions(timeoutMs) {
     return timeoutMs ? { timeoutMs } : undefined;
 }
@@ -19,6 +20,18 @@ class MobileAndroidAppImpl {
     locator(selector) {
         return new MobileAndroidLocatorImpl(this, normalizeMobileSelectorForTransport(selector));
     }
+    getByRole(role, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "role", role }));
+    }
+    getByText(text, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "text", text }));
+    }
+    getByLabel(text, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "label", text }));
+    }
+    getByTestId(text) {
+        return this.locator(semanticSelector({ kind: "testId", text }));
+    }
     async registerHook(type) {
         if (type.name !== "fileChooser" && type.name !== "download") {
             throw new Error(`hook type ${type.name} is not supported by Android apps`);
@@ -191,11 +204,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementClicked) {
-                return {
-                    selector: event.elementClicked.cssSelector ?? "",
-                    note: event.elementClicked.note ?? "",
-                    bidiSessionId: event.elementClicked.bidiSessionId ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -206,6 +215,30 @@ class MobileAndroidAppImpl {
             }
         }
     }
+    async goto(url, options = {}) {
+        return this.navigate(url, options);
+    }
+    async navigate(url, options = {}) {
+        const handle = await this.#getHandle();
+        this.#ensureOpen(handle);
+        handle.stream.write({
+            surfaceSessionId: this.#surfaceSessionId,
+            contextSessionId: this.sessionId,
+            navigate: { url, retryOptions: retryOptions(options.timeoutMs) },
+        });
+        while (true) {
+            const event = await handle.queue.next();
+            if (event.navigated) {
+                return;
+            }
+            if (event.error?.message)
+                throw new Error(event.error.message);
+            if (event.closed) {
+                handle.closed = true;
+                throw new Error(`mobile app session ${this.sessionId} closed while opening deep link`);
+            }
+        }
+    }
     async count(selector, options = {}) {
         const handle = await this.#getHandle();
         this.#ensureOpen(handle);
@@ -220,11 +253,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementCounted) {
-                return {
-                    selector: event.elementCounted.cssSelector ?? "",
-                    count: event.elementCounted.count ?? 0,
-                    note: event.elementCounted.note ?? "",
-                };
+                return event.elementCounted.count ?? 0;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -249,10 +278,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementFocused) {
-                return {
-                    selector: event.elementFocused.cssSelector ?? "",
-                    note: event.elementFocused.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -278,11 +304,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementFilled) {
-                return {
-                    selector: event.elementFilled.cssSelector ?? "",
-                    value: event.elementFilled.value ?? "",
-                    note: event.elementFilled.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -309,11 +331,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.keyPressed) {
-                return {
-                    selector: event.keyPressed.cssSelector ?? "",
-                    key: event.keyPressed.key ?? "",
-                    note: event.keyPressed.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -325,10 +343,10 @@ class MobileAndroidAppImpl {
         }
     }
     async textContent(selector, options = {}) {
-        return this.#readText(selector, options, true);
+        return (await this.#readText(selector, options, true)).text;
     }
     async innerText(selector, options = {}) {
-        return this.#readText(selector, options, false);
+        return (await this.#readText(selector, options, false)).text;
     }
     async waitForSelector(selector, options = {}) {
         const handle = await this.#getHandle();
@@ -345,11 +363,7 @@ class MobileAndroidAppImpl {
         while (true) {
             const event = await handle.queue.next();
             if (event.selectorWaitSatisfied) {
-                return {
-                    selector: event.selectorWaitSatisfied.cssSelector ?? "",
-                    visible: event.selectorWaitSatisfied.visible ?? false,
-                    note: event.selectorWaitSatisfied.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -413,7 +427,7 @@ class MobileAndroidAppImpl {
                 if (options.path) {
                     await writeFile(options.path, screenshot.pngData);
                 }
-                return screenshot;
+                return screenshot.pngData;
             }
             if (event.error?.message) {
                 throw new Error(event.error.message);
@@ -550,6 +564,18 @@ class MobileAndroidLocatorImpl {
     locator(selector) {
         return new MobileAndroidLocatorImpl(this.page, chainMobileSelectorForTransport(this.selector, selector));
     }
+    getByRole(role, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "role", role }));
+    }
+    getByText(text, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "text", text }));
+    }
+    getByLabel(text, options = {}) {
+        return this.locator(semanticSelector({ ...options, kind: "label", text }));
+    }
+    getByTestId(text) {
+        return this.locator(semanticSelector({ kind: "testId", text }));
+    }
 }
 class MobileAndroidDeviceImpl {
     sessionId;

package/dist/mobileSelectors.js

@@ -30,7 +30,7 @@ const UIAUTOMATOR_SELECTOR_KEYS = new Set([
     "index",
     "instance",
 ]);
-const SELECTOR_PREFIXES = ["xpath=", "xpath:", "css=", "css:", "uia=", "uia:"];
+const SELECTOR_PREFIXES = ["xpath=", "xpath:", "css=", "css:", "uia=", "uia:", "aw=", "aw:"];
 function decodeSelectorBody(body) {
     const candidate = body.trim();
     if (candidate.startsWith("\"") && candidate.endsWith("\"")) {
@@ -54,6 +54,9 @@ function parseExplicitSelectorPrefix(selector) {
     if (lowered.startsWith("uia=") || lowered.startsWith("uia:")) {
         return { flavor: "uia", prefixLength: 4 };
     }
+    if (lowered.startsWith("aw=") || lowered.startsWith("aw:")) {
+        return { flavor: "aw", prefixLength: 3 };
+    }
     return null;
 }
 function findJsonStringEnd(value) {
@@ -149,6 +152,9 @@ export function normalizeMobileSelectorForTransport(selector) {
     if (!trimmed) {
         return "";
     }
+    if (/^ref[=:]/i.test(trimmed)) {
+        return `ref=${decodeSelectorBody(trimmed.slice(4))}`;
+    }
     if (isNormalizedTransportSelector(trimmed)) {
         return trimmed;
     }

package/dist/page.d.ts

@@ -1,5 +1,5 @@
 import { WebLocatorBuilders, type LocatorFilterOptions } from "./web-locators.js";
-import type { BoundingBox, CapturedOption, AccessibilitySnapshotOptions, ClickResult, CommandOptions, CountResult, ElementResult, FillResult, FileChooser, Download, HighlightOptions, HighlightResult, Hook, HookType, Locator, NavigateResult, Page, PageInfo, PressOptions, PressResult, RuntimeClient, ScreenshotOptions, ScreenshotResult, TextResult, WaitForSelectorOptions, WaitForSelectorResult } from "./types.js";
+import type { BoundingBox, CapturedOption, AccessibilitySnapshotOptions, CommandOptions, FileChooser, Download, HighlightOptions, Hook, HookType, Locator, Page, PageInfo, PressOptions, RuntimeClient, ScreenshotOptions, WaitForSelectorOptions } from "./types.js";
 export declare class PageImpl extends WebLocatorBuilders implements Page {
     #private;
     constructor(input: PageInfo & {
@@ -13,14 +13,14 @@ export declare class PageImpl extends WebLocatorBuilders implements Page {
     setFileChooserFiles(fileChooserId: string, files: string[], options?: CommandOptions): Promise<void>;
     saveDownload(downloadId: string, path: string, options?: CommandOptions): Promise<void>;
     locator(selector: string, options?: LocatorFilterOptions): Locator;
-    goto(url: string, options?: CommandOptions): Promise<NavigateResult>;
-    click(selector: string, options?: CommandOptions): Promise<ClickResult>;
-    count(selector: string, options?: CommandOptions): Promise<CountResult>;
-    highlight(selector: string, options?: HighlightOptions): Promise<HighlightResult>;
-    focus(selector: string, options?: CommandOptions): Promise<ElementResult>;
-    fill(selector: string, value: string, options?: CommandOptions): Promise<FillResult>;
-    hover(selector: string, options?: CommandOptions): Promise<ElementResult>;
-    press(selector: string, key: string, options?: PressOptions): Promise<PressResult>;
+    goto(url: string, options?: CommandOptions): Promise<void>;
+    click(selector: string, options?: CommandOptions): Promise<void>;
+    count(selector: string, options?: CommandOptions): Promise<number>;
+    highlight(selector: string, options?: HighlightOptions): Promise<void>;
+    focus(selector: string, options?: CommandOptions): Promise<void>;
+    fill(selector: string, value: string, options?: CommandOptions): Promise<void>;
+    hover(selector: string, options?: CommandOptions): Promise<void>;
+    press(selector: string, key: string, options?: PressOptions): Promise<void>;
     url(options?: CommandOptions): Promise<string>;
     inputValue(selector: string, options?: CommandOptions): Promise<string>;
     selectedOptions(selector: string, options?: CommandOptions): Promise<CapturedOption[]>;
@@ -28,15 +28,15 @@ export declare class PageImpl extends WebLocatorBuilders implements Page {
     isChecked(selector: string, options?: CommandOptions): Promise<boolean>;
     getAttribute(selector: string, name: string, options?: CommandOptions): Promise<string | null>;
     boundingBox(selector: string, options?: CommandOptions): Promise<BoundingBox | null>;
-    textContent(selector: string, options?: CommandOptions): Promise<TextResult>;
-    innerText(selector: string, options?: CommandOptions): Promise<TextResult>;
-    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
+    textContent(selector: string, options?: CommandOptions): Promise<string | null>;
+    innerText(selector: string, options?: CommandOptions): Promise<string>;
+    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<void>;
     accessibilitySnapshot(options?: AccessibilitySnapshotOptions): Promise<string>;
-    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
+    screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
     close(): Promise<void>;
     ping(message?: string): Promise<string>;
     pageInfo(): PageInfo;
-    navigate(url: string, options?: CommandOptions): Promise<NavigateResult>;
+    navigate(url: string, options?: CommandOptions): Promise<void>;
     dispose(): void;
 }
 export declare class FileChooserImpl implements FileChooser {

package/dist/page.js

@@ -278,14 +278,7 @@ export class PageImpl extends WebLocatorBuilders {
                 throw new Error(`page session ${this.sessionId} closed while navigating`);
             }
             if (navigated && injection) {
-                return {
-                    url: navigated.url ?? "",
-                    note: navigated.note ?? "",
-                    bidiSessionId: injection.bidiSessionId ?? "",
-                    mapperTargetId: injection.mapperTargetId ?? "",
-                    mapperSessionId: injection.mapperSessionId ?? "",
-                    packageVersion: injection.packageVersion ?? "",
-                };
+                return;
             }
         }
     }
@@ -304,11 +297,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementClicked) {
-                return {
-                    selector: event.elementClicked.cssSelector ?? "",
-                    note: event.elementClicked.note ?? "",
-                    bidiSessionId: event.elementClicked.bidiSessionId ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("click", event.error.message, selector);
@@ -334,11 +323,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementCounted) {
-                return {
-                    selector: event.elementCounted.cssSelector ?? "",
-                    count: event.elementCounted.count ?? 0,
-                    note: event.elementCounted.note ?? "",
-                };
+                return event.elementCounted.count ?? 0;
             }
             if (event.error?.message) {
                 throw formatActionError("count elements", event.error.message, selector);
@@ -365,11 +350,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementsHighlighted) {
-                return {
-                    selector: event.elementsHighlighted.cssSelector ?? "",
-                    count: event.elementsHighlighted.count ?? 0,
-                    note: event.elementsHighlighted.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("highlight elements", event.error.message, selector);
@@ -395,10 +376,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementFocused) {
-                return {
-                    selector: event.elementFocused.cssSelector ?? "",
-                    note: event.elementFocused.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("focus", event.error.message, selector);
@@ -425,11 +403,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementFilled) {
-                return {
-                    selector: event.elementFilled.cssSelector ?? "",
-                    value: event.elementFilled.value ?? "",
-                    note: event.elementFilled.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("fill", event.error.message, selector);
@@ -455,10 +429,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.elementHovered) {
-                return {
-                    selector: event.elementHovered.cssSelector ?? "",
-                    note: event.elementHovered.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("hover", event.error.message, selector);
@@ -486,11 +457,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.keyPressed) {
-                return {
-                    selector: event.keyPressed.cssSelector ?? "",
-                    key: event.keyPressed.key ?? "",
-                    note: event.keyPressed.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("press key", event.error.message, selector);
@@ -548,10 +515,10 @@ export class PageImpl extends WebLocatorBuilders {
         return r.boundingBox ?? null;
     }
     async textContent(selector, options = {}) {
-        return this.#readText(selector, options, true);
+        return (await this.#readText(selector, options, true)).text;
     }
     async innerText(selector, options = {}) {
-        return this.#readText(selector, options, false);
+        return (await this.#readText(selector, options, false)).text;
     }
     async waitForSelector(selector, options = {}) {
         const handle = await this.#getHandle();
@@ -569,11 +536,7 @@ export class PageImpl extends WebLocatorBuilders {
         while (true) {
             const event = await handle.queue.next();
             if (event.selectorWaitSatisfied) {
-                return {
-                    selector: event.selectorWaitSatisfied.cssSelector ?? "",
-                    visible: event.selectorWaitSatisfied.visible ?? false,
-                    note: event.selectorWaitSatisfied.note ?? "",
-                };
+                return;
             }
             if (event.error?.message) {
                 throw formatActionError("wait for selector", event.error.message, selector);
@@ -637,7 +600,7 @@ export class PageImpl extends WebLocatorBuilders {
                 if (options.path) {
                     await writeFile(options.path, screenshot.pngData);
                 }
-                return screenshot;
+                return screenshot.pngData;
             }
             if (event.error?.message) {
                 throw formatActionError("screenshot", event.error.message);

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { WebLocators, LocatorFilterOptions } from "./web-locators.js";
+import type { WebLocators, LocatorFilterOptions, RoleOptions, TextMatcher, TextOptions } from "./web-locators.js";
 import grpc from "@grpc/grpc-js";
 export { AllwrightError } from "./errors.js";
 export interface LaunchOptions {
@@ -153,19 +153,19 @@ export interface Page extends PageInfo, WebLocators {
     registerHook<T>(type: HookType<T>): Promise<Hook<T>>;
     accessibilitySnapshot(options?: AccessibilitySnapshotOptions): Promise<string>;
     locator(selector: string, options?: LocatorFilterOptions): Locator;
-    goto(url: string, options?: CommandOptions): Promise<NavigateResult>;
-    navigate(url: string, options?: CommandOptions): Promise<NavigateResult>;
-    click(selector: string, options?: CommandOptions): Promise<ClickResult>;
-    count(selector: string, options?: CommandOptions): Promise<CountResult>;
-    highlight(selector: string, options?: HighlightOptions): Promise<HighlightResult>;
-    focus(selector: string, options?: CommandOptions): Promise<ElementResult>;
-    fill(selector: string, value: string, options?: CommandOptions): Promise<FillResult>;
-    hover(selector: string, options?: CommandOptions): Promise<ElementResult>;
-    press(selector: string, key: string, options?: PressOptions): Promise<PressResult>;
-    textContent(selector: string, options?: CommandOptions): Promise<TextResult>;
-    innerText(selector: string, options?: CommandOptions): Promise<TextResult>;
-    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
-    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
+    goto(url: string, options?: CommandOptions): Promise<void>;
+    navigate(url: string, options?: CommandOptions): Promise<void>;
+    click(selector: string, options?: CommandOptions): Promise<void>;
+    count(selector: string, options?: CommandOptions): Promise<number>;
+    highlight(selector: string, options?: HighlightOptions): Promise<void>;
+    focus(selector: string, options?: CommandOptions): Promise<void>;
+    fill(selector: string, value: string, options?: CommandOptions): Promise<void>;
+    hover(selector: string, options?: CommandOptions): Promise<void>;
+    press(selector: string, key: string, options?: PressOptions): Promise<void>;
+    textContent(selector: string, options?: CommandOptions): Promise<string | null>;
+    innerText(selector: string, options?: CommandOptions): Promise<string>;
+    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<void>;
+    screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
     close(): Promise<void>;
     ping(message?: string): Promise<string>;
     pageInfo(): PageInfo;
@@ -186,29 +186,39 @@ export interface MobileAndroidLaunchOptions {
 export interface MobileAndroidLocator {
     readonly page: MobileAndroidApp;
     readonly selector: string;
-    click(options?: CommandOptions): Promise<ClickResult>;
-    count(options?: CommandOptions): Promise<CountResult>;
-    focus(options?: CommandOptions): Promise<ElementResult>;
-    fill(value: string, options?: CommandOptions): Promise<FillResult>;
-    press(key: string, options?: PressOptions): Promise<PressResult>;
-    textContent(options?: CommandOptions): Promise<TextResult>;
-    innerText(options?: CommandOptions): Promise<TextResult>;
-    waitFor(options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
+    click(options?: CommandOptions): Promise<void>;
+    count(options?: CommandOptions): Promise<number>;
+    focus(options?: CommandOptions): Promise<void>;
+    fill(value: string, options?: CommandOptions): Promise<void>;
+    press(key: string, options?: PressOptions): Promise<void>;
+    textContent(options?: CommandOptions): Promise<string | null>;
+    innerText(options?: CommandOptions): Promise<string>;
+    waitFor(options?: WaitForSelectorOptions): Promise<void>;
     locator(selector: string): MobileAndroidLocator;
+    getByRole(role: string, options?: RoleOptions): MobileAndroidLocator;
+    getByText(text: TextMatcher, options?: TextOptions): MobileAndroidLocator;
+    getByLabel(text: TextMatcher, options?: TextOptions): MobileAndroidLocator;
+    getByTestId(text: TextMatcher): MobileAndroidLocator;
 }
 export interface MobileAndroidApp {
     accessibilitySnapshot(options?: AccessibilitySnapshotOptions): Promise<string>;
     readonly sessionId: string;
+    goto(url: string, options?: CommandOptions): Promise<void>;
+    navigate(url: string, options?: CommandOptions): Promise<void>;
     locator(selector: string): MobileAndroidLocator;
-    click(selector: string, options?: CommandOptions): Promise<ClickResult>;
-    count(selector: string, options?: CommandOptions): Promise<CountResult>;
-    focus(selector: string, options?: CommandOptions): Promise<ElementResult>;
-    fill(selector: string, value: string, options?: CommandOptions): Promise<FillResult>;
-    press(selector: string, key: string, options?: PressOptions): Promise<PressResult>;
-    textContent(selector: string, options?: CommandOptions): Promise<TextResult>;
-    innerText(selector: string, options?: CommandOptions): Promise<TextResult>;
-    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
-    screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
+    getByRole(role: string, options?: RoleOptions): MobileAndroidLocator;
+    getByText(text: TextMatcher, options?: TextOptions): MobileAndroidLocator;
+    getByLabel(text: TextMatcher, options?: TextOptions): MobileAndroidLocator;
+    getByTestId(text: TextMatcher): MobileAndroidLocator;
+    click(selector: string, options?: CommandOptions): Promise<void>;
+    count(selector: string, options?: CommandOptions): Promise<number>;
+    focus(selector: string, options?: CommandOptions): Promise<void>;
+    fill(selector: string, value: string, options?: CommandOptions): Promise<void>;
+    press(selector: string, key: string, options?: PressOptions): Promise<void>;
+    textContent(selector: string, options?: CommandOptions): Promise<string | null>;
+    innerText(selector: string, options?: CommandOptions): Promise<string>;
+    waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<void>;
+    screenshot(options?: ScreenshotOptions): Promise<Uint8Array>;
     registerHook<T>(type: HookType<T>): Promise<Hook<T>>;
 }
 export interface MobileAndroidDevice {
@@ -261,16 +271,16 @@ export interface Locator extends WebLocators {
     last(): Locator;
     readonly page: Page;
     readonly selector: string;
-    click(options?: CommandOptions): Promise<ClickResult>;
-    count(options?: CommandOptions): Promise<CountResult>;
-    highlight(options?: HighlightOptions): Promise<HighlightResult>;
-    focus(options?: CommandOptions): Promise<ElementResult>;
-    fill(value: string, options?: CommandOptions): Promise<FillResult>;
-    hover(options?: CommandOptions): Promise<ElementResult>;
-    press(key: string, options?: PressOptions): Promise<PressResult>;
-    textContent(options?: CommandOptions): Promise<TextResult>;
-    innerText(options?: CommandOptions): Promise<TextResult>;
-    waitFor(options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
+    click(options?: CommandOptions): Promise<void>;
+    count(options?: CommandOptions): Promise<number>;
+    highlight(options?: HighlightOptions): Promise<void>;
+    focus(options?: CommandOptions): Promise<void>;
+    fill(value: string, options?: CommandOptions): Promise<void>;
+    hover(options?: CommandOptions): Promise<void>;
+    press(key: string, options?: PressOptions): Promise<void>;
+    textContent(options?: CommandOptions): Promise<string | null>;
+    innerText(options?: CommandOptions): Promise<string>;
+    waitFor(options?: WaitForSelectorOptions): Promise<void>;
     locator(selector: string, options?: LocatorFilterOptions): Locator;
 }
 export interface AllwrightConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allwright.dev/core",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "High-level TypeScript client for the allwright automation engine.",
   "license": "MIT",
   "type": "module",