appium-xcuitest-driver 12.3.4 → 12.5.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [12.5.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.4.0...v12.5.0) (2026-08-17)
+
+### Features
+
+* support native web tap inside same-origin iframes, bump remote-debugger ([#2950](https://github.com/appium/appium-xcuitest-driver/issues/2950)) ([6f91d47](https://github.com/appium/appium-xcuitest-driver/commit/6f91d47349484742e05d9da56148a8c4d264f9a2))
+
+## [12.4.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.3.4...v12.4.0) (2026-08-17)
+
+### Features
+
+* replace native web tap heuristics with automatic coordinate calibration ([#2948](https://github.com/appium/appium-xcuitest-driver/issues/2948)) ([9fd2107](https://github.com/appium/appium-xcuitest-driver/commit/9fd21077a6fda9a162713438edc635b9a7677361))
+
+### Code Refactoring
+
+* tighten typing in web commands and dedupe web-context guards ([#2947](https://github.com/appium/appium-xcuitest-driver/issues/2947)) ([96299f3](https://github.com/appium/appium-xcuitest-driver/commit/96299f38145d2fe7ba9624212933e71044c44039))
+
 ## [12.3.4](https://github.com/appium/appium-xcuitest-driver/compare/v12.3.3...v12.3.4) (2026-08-14)
 
 ### Bug Fixes

package/build/lib/commands/execute.js.map

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

package/build/lib/commands/helpers/guards.d.ts

@@ -5,6 +5,9 @@ export interface DeviceGuardDriver {
     isRealDevice(): boolean;
     readonly device: unknown;
 }
+export interface WebContextGuardDriver {
+    isWebContext(): boolean;
+}
 /**
  * Requires that the given driver is running on a Simulator and return
  * the simulator instance.
@@ -15,4 +18,8 @@ export declare function requireSimulator(driver: DeviceGuardDriver, action: stri
  * the real device instance.
  */
 export declare function requireRealDevice(driver: DeviceGuardDriver, action: string): RealDevice;
+/**
+ * Throws if the given driver is not currently in a web context.
+ */
+export declare function requireWebContext(driver: WebContextGuardDriver, message?: string): void;
 //# sourceMappingURL=guards.d.ts.map

package/build/lib/commands/helpers/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../lib/commands/helpers/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,wCAAwC,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAKrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAKvF"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../../lib/commands/helpers/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,sBAAsB,CAAC;AAGpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,wCAAwC,CAAC;AAGvE,MAAM,WAAW,iBAAiB;IAChC,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,IAAI,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,IAAI,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAKrF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAKvF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAIvF"}

package/build/lib/commands/helpers/guards.js

@@ -1,3 +1,4 @@
+import { errors } from 'appium/driver.js';
 import { upperFirst } from '../../utils/index.js';
 /**
  * Requires that the given driver is running on a Simulator and return
@@ -19,4 +20,12 @@ export function requireRealDevice(driver, action) {
     }
     return driver.device;
 }
+/**
+ * Throws if the given driver is not currently in a web context.
+ */
+export function requireWebContext(driver, message) {
+    if (!driver.isWebContext()) {
+        throw new errors.NotImplementedError(message);
+    }
+}
 //# sourceMappingURL=guards.js.map

package/build/lib/commands/helpers/guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../lib/commands/helpers/guards.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAQhD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,MAAc;IACxE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,MAAmB,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,MAAc;IACzE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,MAAoB,CAAC;AACrC,CAAC"}
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../../lib/commands/helpers/guards.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC;AAGxC,OAAO,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAYhD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAyB,EAAE,MAAc;IACxE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,MAAM,CAAC,MAAmB,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAyB,EAAE,MAAc;IACzE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,MAAM,CAAC,MAAoB,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA6B,EAAE,OAAgB;IAC/E,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/build/lib/commands/helpers/index.d.ts

@@ -1,7 +1,7 @@
 export { SAFARI_BUNDLE_ID, buildSafariPreferences, checkAutInstallationState, findApps, installAUT, onDownloadApp, onPostConfigureApp, } from './app.js';
 export { TimeoutError, withTimeout } from './async.js';
-export { requireRealDevice, requireSimulator } from './guards.js';
-export type { DeviceGuardDriver } from './guards.js';
+export { requireRealDevice, requireSimulator, requireWebContext } from './guards.js';
+export type { DeviceGuardDriver, WebContextGuardDriver } from './guards.js';
 export { encodeBase64OrUpload, getPIDsListeningOnPort, isLocalHost } from './network.js';
 export type { UploadOptions } from './network.js';
 export { handleMjpegOptions } from './mjpeg.js';

package/build/lib/commands/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/commands/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,YAAY,CAAC;AAErD,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAChE,YAAY,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAC,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AACvF,YAAY,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,cAAc,CAAC;AACtD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAC,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAC,iCAAiC,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAC,oBAAoB,EAAE,2BAA2B,EAAC,MAAM,cAAc,CAAC;AAEpF,OAAO,EAAC,mBAAmB,EAAE,eAAe,EAAE,wBAAwB,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/commands/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,YAAY,CAAC;AAErD,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAC;AACnF,YAAY,EAAC,iBAAiB,EAAE,qBAAqB,EAAC,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAC,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AACvF,YAAY,EAAC,aAAa,EAAC,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,cAAc,CAAC;AACtD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAC,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAC,iCAAiC,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAC1F,YAAY,EAAC,oBAAoB,EAAE,2BAA2B,EAAC,MAAM,cAAc,CAAC;AAEpF,OAAO,EAAC,mBAAmB,EAAE,eAAe,EAAE,wBAAwB,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC"}

package/build/lib/commands/helpers/index.js

@@ -1,7 +1,7 @@
 // Submodules must import siblings directly, never this barrel — avoids cycles.
 export { SAFARI_BUNDLE_ID, buildSafariPreferences, checkAutInstallationState, findApps, installAUT, onDownloadApp, onPostConfigureApp, } from './app.js';
 export { TimeoutError, withTimeout } from './async.js';
-export { requireRealDevice, requireSimulator } from './guards.js';
+export { requireRealDevice, requireSimulator, requireWebContext } from './guards.js';
 export { encodeBase64OrUpload, getPIDsListeningOnPort, isLocalHost } from './network.js';
 export { handleMjpegOptions } from './mjpeg.js';
 export { getDriverInfo, printUser } from './runtime.js';

package/build/lib/commands/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/commands/helpers/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,YAAY,CAAC;AAErD,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAC,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAC,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAC,iCAAiC,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAC,mBAAmB,EAAE,eAAe,EAAE,wBAAwB,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/commands/helpers/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAC,YAAY,EAAE,WAAW,EAAC,MAAM,YAAY,CAAC;AAErD,OAAO,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAGnF,OAAO,EAAC,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,cAAc,CAAC;AAGtD,OAAO,EAAC,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAC,iCAAiC,EAAE,yBAAyB,EAAC,MAAM,cAAc,CAAC;AAG1F,OAAO,EAAC,mBAAmB,EAAE,eAAe,EAAE,wBAAwB,EAAE,WAAW,EAAC,MAAM,iBAAiB,CAAC"}

package/build/lib/commands/wda/utils.d.ts

@@ -1,6 +1,13 @@
 import type { WebDriverAgent } from 'appium-webdriveragent';
+import type { XCUITestDriver } from '../../driver.js';
 /**
  * Returns the WebDriverAgent derived data root from Xcode build settings.
  */
 export declare function getDerivedDataPath(wda: WebDriverAgent): Promise<string | undefined>;
+/**
+ * Gets the base URL for accessing WDA HTTP endpoints.
+ *
+ * @returns The base URL (e.g., 'http://127.0.0.1:8100')
+ */
+export declare function getWdaLocalhostRoot(this: XCUITestDriver): string;
 //# sourceMappingURL=utils.d.ts.map

package/build/lib/commands/wda/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../lib/commands/wda/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAE1D;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMzF"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../lib/commands/wda/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAEpD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAahE"}

package/build/lib/commands/wda/utils.js

@@ -9,4 +9,23 @@ export async function getDerivedDataPath(wda) {
     const buildDir = buildSettings?.BUILD_DIR;
     return buildDir ? path.dirname(path.dirname(path.normalize(buildDir))) : undefined;
 }
+/**
+ * Gets the base URL for accessing WDA HTTP endpoints.
+ *
+ * @returns The base URL (e.g., 'http://127.0.0.1:8100')
+ */
+export function getWdaLocalhostRoot() {
+    const wdaPort = () => {
+        try {
+            return this.wda.url?.port;
+        }
+        catch {
+            // this.wda could raise an error when that was not initialized yet.
+            return null;
+        }
+    };
+    const remotePort = ((this.isRealDevice() ? this.opts.wdaRemotePort : null) ?? wdaPort() ?? this.opts.wdaLocalPort) || 8100;
+    const remoteIp = this.opts.wdaBindingIP ?? '127.0.0.1';
+    return `http://${remoteIp}:${remotePort}`;
+}
 //# sourceMappingURL=utils.js.map

package/build/lib/commands/wda/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/commands/wda/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAmB;IAC1D,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC;QACpD,MAAM,EAAE,sBAAsB;KAC/B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,aAAa,EAAE,SAAS,CAAC;IAC1C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/commands/wda/utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAmB;IAC1D,MAAM,aAAa,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC;QACpD,MAAM,EAAE,sBAAsB;KAC/B,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,aAAa,EAAE,SAAS,CAAC;IAC1C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IACF,MAAM,UAAU,GACd,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC;IAC1G,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC;IACvD,OAAO,UAAU,QAAQ,IAAI,UAAU,EAAE,CAAC;AAC5C,CAAC"}

package/build/lib/commands/web-native-bridge.d.ts

@@ -0,0 +1,116 @@
+import type { Element, Position, Size } from '@appium/types';
+import type { XCUITestDriver } from '../driver.js';
+import type { CalibrationData, CalibrationSample, ViewportState } from '../types.js';
+/**
+ * Computes the affine transform (`native = offset + ratio * web`) that best
+ * fits a set of native/web coordinate sample pairs, independently per axis.
+ * With exactly 2 samples this reduces to the same 2-point calculation the
+ * driver has always used; with more it's an ordinary least-squares fit,
+ * which lets calibration become more robust in the future without changing
+ * the shape of the result.
+ *
+ * Pure and driver-independent so it can be unit tested directly.
+ *
+ * @param samples - At least 2 native/web coordinate pairs
+ * @throws {Error} If fewer than 2 samples are given, or the samples don't
+ *   vary enough along an axis to fit a transform (e.g. all web x values equal)
+ */
+export declare function fitAffineTransform(samples: readonly CalibrationSample[]): CalibrationData;
+/**
+ * Builds the cache key `translateWebCoords` uses to decide whether a
+ * previously fitted calibration transform is still valid. Rotating the
+ * device, resizing the viewport (e.g. the on-screen keyboard appearing), or
+ * scrolling away from the top of the page can all change how web
+ * coordinates map to native ones, so any change to this signature should
+ * invalidate the cache.
+ *
+ * Pure and driver-independent so it can be unit tested directly.
+ */
+export declare function viewportSignature(state: ViewportState): string;
+/**
+ * Clicks at the specified web coordinates.
+ *
+ * Coordinates are automatically translated from web to native coordinates.
+ *
+ * @param x - X coordinate in web space
+ * @param y - Y coordinate in web space
+ */
+export declare function clickWebCoords(this: XCUITestDriver, x: number, y: number): Promise<void>;
+/**
+ * @deprecated No longer used: coordinate translation is calibrated
+ * automatically and no longer needs a device-type hint. Kept as a no-op only
+ * for backward compatibility with existing callers.
+ */
+export declare function getSafariIsIphone(this: XCUITestDriver): Promise<boolean>;
+/**
+ * @deprecated No longer used: coordinate translation is calibrated
+ * automatically and no longer needs the device's screen size. Kept as a
+ * no-op only for backward compatibility with existing callers.
+ */
+export declare function getSafariDeviceSize(this: XCUITestDriver): Promise<Size>;
+/**
+ * @deprecated No longer used: coordinate translation is calibrated
+ * automatically and no longer needs a notch hint. Kept as a no-op only for
+ * backward compatibility with existing callers.
+ */
+export declare function getSafariIsNotched(this: XCUITestDriver): Promise<boolean>;
+/**
+ * @deprecated No longer used: coordinate translation is calibrated
+ * automatically instead of computing Safari-chrome offsets. Kept as a no-op
+ * only for backward compatibility with existing callers.
+ */
+export declare function getExtraTranslateWebCoordsOffset(this: XCUITestDriver, wvPos: {
+    x: number;
+    y: number;
+}, realDims: {
+    w: number;
+    h: number;
+}): Promise<void>;
+/**
+ * @deprecated No longer used: coordinate translation is calibrated
+ * automatically instead of computing a smart-app-banner offset. Kept as a
+ * no-op only for backward compatibility with existing callers.
+ */
+export declare function getExtraNativeWebTapOffset(this: XCUITestDriver, isIphone: boolean, bannerVisibility: string): Promise<number>;
+/**
+ * Performs a native tap on a web element.
+ *
+ * Attempts to use a simple native tap first, falling back to coordinate-based tapping if needed.
+ *
+ * @param el - Element to tap
+ */
+export declare function nativeWebTap(this: XCUITestDriver, el: Element | string): Promise<void>;
+/**
+ * Translates web coordinates to native screen coordinates.
+ *
+ * Always uses a calibration transform, automatically (re)fitting one via
+ * {@linkcode getOrCreateWebviewCalibration} whenever the cached one no
+ * longer matches the current orientation/size/scroll state. That transform
+ * is fitted against the top-level page, so `x`/`y` are first shifted by the
+ * current sub-frame's offset (see {@linkcode getFrameChainOffset}), if any.
+ *
+ * @param x - X coordinate in web space
+ * @param y - Y coordinate in web space
+ * @returns Translated position in native coordinates
+ * @throws {Error} If no WebView is found, if calibration fails, or if the
+ *   current frame (or one of its ancestors) has a different origin than the
+ *   top-level page
+ */
+export declare function translateWebCoords(this: XCUITestDriver, x: number, y: number): Promise<Position>;
+/**
+ * Primes (or refreshes) the calibration transform that `translateWebCoords`
+ * fits and applies automatically for every native web tap. Calibration
+ * happens transparently as soon as it's needed, so calling this explicitly
+ * is optional; it's useful mainly to warm the cache ahead of a
+ * timing-sensitive interaction, or to force a fresh fit without waiting for
+ * the viewport signature to change.
+ *
+ * Measures against the current page in place, without navigating away from
+ * it, so it is safe to call without losing web app state, and works
+ * identically for Safari and hybrid-app webviews.
+ *
+ * @returns Calibration data with offset and pixel ratio information
+ * @throws {errors.NotImplementedError} If not in a web context
+ */
+export declare function mobileCalibrateWebToRealCoordinatesTranslation(this: XCUITestDriver): Promise<CalibrationData>;
+//# sourceMappingURL=web-native-bridge.d.ts.map

package/build/lib/commands/web-native-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-native-bridge.d.ts","sourceRoot":"","sources":["../../../lib/commands/web-native-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAE,QAAQ,EAAQ,IAAI,EAAC,MAAM,eAAe,CAAC;AAIjE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAwB,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AA6J1G;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GAAG,eAAe,CAwCzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAK9D;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9F;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/E;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,EAC7B,QAAQ,EAAE;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,OAAO,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoCtG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,8CAA8C,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CASnH"}