@allwright.dev/core 0.1.17 → 0.1.19

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.17";
+const DEFAULT_RELEASE_VERSION = "0.1.19";
 const STARTUP_TIMEOUT_MS = 20_000;
 const PING_TIMEOUT_MS = 1_000;
 const PROTO_ROOT = fileURLToPath(new URL("../proto/", import.meta.url));

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`);
@@ -550,6 +563,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) {

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 {
@@ -195,11 +195,19 @@ export interface MobileAndroidLocator {
     innerText(options?: CommandOptions): Promise<TextResult>;
     waitFor(options?: WaitForSelectorOptions): Promise<WaitForSelectorResult>;
     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;
     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;
     click(selector: string, options?: CommandOptions): Promise<ClickResult>;
     count(selector: string, options?: CommandOptions): Promise<CountResult>;
     focus(selector: string, options?: CommandOptions): Promise<ElementResult>;

package/package.json

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