appium-xcuitest-driver 10.14.1 → 10.14.3

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [10.14.3](https://github.com/appium/appium-xcuitest-driver/compare/v10.14.2...v10.14.3) (2026-01-04)
+
+### Miscellaneous Chores
+
+* Migrate various command modules to typescript (part 7) ([#2693](https://github.com/appium/appium-xcuitest-driver/issues/2693)) ([1286364](https://github.com/appium/appium-xcuitest-driver/commit/128636475c1eac6ea5c73da3dcebb2eb9d539c4d))
+
+## [10.14.2](https://github.com/appium/appium-xcuitest-driver/compare/v10.14.1...v10.14.2) (2026-01-01)
+
+### Miscellaneous Chores
+
+* Migrate various command modules to typescript (part 6) ([#2692](https://github.com/appium/appium-xcuitest-driver/issues/2692)) ([3736824](https://github.com/appium/appium-xcuitest-driver/commit/37368246181f2e4096ce80ae76e3d458ea39c711))
+
 ## [10.14.1](https://github.com/appium/appium-xcuitest-driver/compare/v10.14.0...v10.14.1) (2025-12-31)
 
 ### Miscellaneous Chores

package/build/lib/commands/alert.d.ts

@@ -1,45 +1,40 @@
+import type { XCUITestDriver } from '../driver';
+export type AlertAction = 'accept' | 'dismiss' | 'getButtons';
 /**
- * @this {XCUITestDriver}
- */
-export function getAlertText(this: import("../driver").XCUITestDriver): Promise<string | null>;
-/**
- * @param {string} value
- * @this {XCUITestDriver}
- * @returns {Promise<void>}
+ * Gets the text of the currently displayed alert.
+ *
+ * @returns The alert text, or null if no alert is displayed
  */
-export function setAlertText(this: import("../driver").XCUITestDriver, value: string): Promise<void>;
+export declare function getAlertText(this: XCUITestDriver): Promise<string | null>;
 /**
- * @param { {buttonLabel?: string} } opts
- * @returns {Promise<void>}
- * @this {XCUITestDriver}
+ * Sets the text in an alert input field.
+ *
+ * @param value - The text to set
  */
-export function postAcceptAlert(this: import("../driver").XCUITestDriver, opts?: {
-    buttonLabel?: string;
-}): Promise<void>;
+export declare function setAlertText(this: XCUITestDriver, value: string): Promise<void>;
 /**
- * @param { {buttonLabel?: string} } opts
- * @returns {Promise<void>}
- * @this {XCUITestDriver}
+ * Accepts the currently displayed alert.
+ *
+ * @param opts - Options including optional button label
  */
-export function postDismissAlert(this: import("../driver").XCUITestDriver, opts?: {
-    buttonLabel?: string;
-}): Promise<void>;
+export declare function postAcceptAlert(this: XCUITestDriver, opts?: AlertOptions): Promise<void>;
 /**
- * @internal
- * @this {XCUITestDriver}
- * @returns {Promise<string[]>} The list of button labels
+ * Dismisses the currently displayed alert.
+ *
+ * @param opts - Options including optional button label
  */
-export function getAlertButtons(this: import("../driver").XCUITestDriver): Promise<string[]>;
+export declare function postDismissAlert(this: XCUITestDriver, opts?: AlertOptions): Promise<void>;
 /**
  * Tries to apply the given action to the currently visible alert.
  *
- * @param {AlertAction} action - The actual action to apply.
- * @param {string} [buttonLabel] - The name of the button used to perform the chosen alert action. Only makes sense if the action is `accept` or `dismiss`.
- * @returns {Promise<string[]|void>} If `action` is `getButtons`, a list of alert button labelsp; otherwise nothing.
+ * @param action - The actual action to apply
+ * @param buttonLabel - The name of the button used to perform the chosen alert action. Only makes sense if the action is `accept` or `dismiss`
+ * @returns If `action` is `getButtons`, a list of alert button labels; otherwise nothing
  * @remarks This should really be separate commands.
- * @this {XCUITestDriver}
  */
-export function mobileHandleAlert(this: import("../driver").XCUITestDriver, action: AlertAction, buttonLabel?: string): Promise<string[] | void>;
-export type AlertAction = "accept" | "dismiss" | "getButtons";
-export type XCUITestDriver = import("../driver").XCUITestDriver;
+export declare function mobileHandleAlert(this: XCUITestDriver, action: AlertAction, buttonLabel?: string): Promise<string[] | void>;
+interface AlertOptions {
+    buttonLabel?: string;
+}
+export {};
 //# sourceMappingURL=alert.d.ts.map

package/build/lib/commands/alert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../lib/commands/alert.js"],"names":[],"mappings":"AAAA;;GAEG;AACH,+FAEC;AAED;;;;GAIG;AACH,8EAJW,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;GAIG;AACH,iFAJY;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAKzB;AAED;;;;GAIG;AACH,kFAJY;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAC,GACrB,OAAO,CAAC,IAAI,CAAC,CAKzB;AAED;;;;GAIG;AACH,2EAFa,OAAO,CAAC,MAAM,EAAE,CAAC,CAI7B;AAED;;;;;;;;GAQG;AACH,oFANW,WAAW,gBACX,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,GAAC,IAAI,CAAC,CAkBlC;0BAgBY,QAAQ,GAAC,SAAS,GAAC,YAAY;6BAI/B,OAAO,WAAW,EAAE,cAAc"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../lib/commands/alert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC;AAE9D;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/E;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf;AAYD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,WAAW,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAc1B;AAUD,UAAU,YAAY;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/build/lib/commands/alert.js

@@ -7,51 +7,53 @@ exports.postDismissAlert = postDismissAlert;
 exports.getAlertButtons = getAlertButtons;
 exports.mobileHandleAlert = mobileHandleAlert;
 /**
- * @this {XCUITestDriver}
+ * Gets the text of the currently displayed alert.
+ *
+ * @returns The alert text, or null if no alert is displayed
  */
 async function getAlertText() {
-    return /** @type {string|null} */ (await this.proxyCommand('/alert/text', 'GET'));
+    return await this.proxyCommand('/alert/text', 'GET');
 }
 /**
- * @param {string} value
- * @this {XCUITestDriver}
- * @returns {Promise<void>}
+ * Sets the text in an alert input field.
+ *
+ * @param value - The text to set
  */
 async function setAlertText(value) {
     await this.proxyCommand('/alert/text', 'POST', { value });
 }
 /**
- * @param { {buttonLabel?: string} } opts
- * @returns {Promise<void>}
- * @this {XCUITestDriver}
+ * Accepts the currently displayed alert.
+ *
+ * @param opts - Options including optional button label
  */
 async function postAcceptAlert(opts = {}) {
     await this.proxyCommand('/alert/accept', 'POST', toAlertParams(opts));
 }
 /**
- * @param { {buttonLabel?: string} } opts
- * @returns {Promise<void>}
- * @this {XCUITestDriver}
+ * Dismisses the currently displayed alert.
+ *
+ * @param opts - Options including optional button label
  */
 async function postDismissAlert(opts = {}) {
     await this.proxyCommand('/alert/dismiss', 'POST', toAlertParams(opts));
 }
 /**
+ * Gets the list of button labels from the currently displayed alert.
+ *
+ * @returns The list of button labels
  * @internal
- * @this {XCUITestDriver}
- * @returns {Promise<string[]>} The list of button labels
  */
 async function getAlertButtons() {
-    return /** @type {string[]} */ (await this.proxyCommand('/wda/alert/buttons', 'GET'));
+    return await this.proxyCommand('/wda/alert/buttons', 'GET');
 }
 /**
  * Tries to apply the given action to the currently visible alert.
  *
- * @param {AlertAction} action - The actual action to apply.
- * @param {string} [buttonLabel] - The name of the button used to perform the chosen alert action. Only makes sense if the action is `accept` or `dismiss`.
- * @returns {Promise<string[]|void>} If `action` is `getButtons`, a list of alert button labelsp; otherwise nothing.
+ * @param action - The actual action to apply
+ * @param buttonLabel - The name of the button used to perform the chosen alert action. Only makes sense if the action is `accept` or `dismiss`
+ * @returns If `action` is `getButtons`, a list of alert button labels; otherwise nothing
  * @remarks This should really be separate commands.
- * @this {XCUITestDriver}
  */
 async function mobileHandleAlert(action, buttonLabel) {
     switch (action) {
@@ -66,11 +68,6 @@ async function mobileHandleAlert(action, buttonLabel) {
                 `'${action}' is provided instead.`);
     }
 }
-/**
- *
- * @param { {buttonLabel?: string} } opts
- * @returns { {name?: string} }
- */
 function toAlertParams(opts = {}) {
     const params = {};
     if (opts.buttonLabel) {
@@ -78,10 +75,4 @@ function toAlertParams(opts = {}) {
     }
     return params;
 }
-/**
- * @typedef {'accept'|'dismiss'|'getButtons'} AlertAction
- */
-/**
- * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
- */
 //# sourceMappingURL=alert.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../lib/commands/alert.js"],"names":[],"mappings":";;AAGA,oCAEC;AAOD,oCAEC;AAOD,0CAEC;AAOD,4CAEC;AAOD,0CAEC;AAWD,8CAcC;AAlED;;GAEG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,0BAA0B,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAAC,KAAK;IACtC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,IAAI,GAAG,EAAE;IAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAAC,IAAI,GAAG,EAAE;IAC9C,MAAM,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe;IACnC,OAAO,uBAAuB,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,iBAAiB,CAAC,MAAM,EAAE,WAAW;IACzD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,EAAC,WAAW,EAAC,CAAC,CAAC;QACnD,KAAK,SAAS;YACZ,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAC,WAAW,EAAC,CAAC,CAAC;QACpD,KAAK,YAAY;YACf,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CACb,2EAA2E;gBACzE,IAAI,MAAM,wBAAwB,CACrC,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAI,GAAG,EAAE;IAC9B,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AAEH;;GAEG"}
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../lib/commands/alert.ts"],"names":[],"mappings":";;AASA,oCAEC;AAOD,oCAKC;AAOD,0CAKC;AAOD,4CAKC;AAQD,0CAEC;AAUD,8CAkBC;AAjFD;;;;GAIG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAqB,aAAa,EAAE,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,YAAY,CAEhC,KAAa;IAEb,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAEnC,OAAqB,EAAE;IAEvB,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,gBAAgB,CAEpC,OAAqB,EAAE;IAEvB,MAAM,IAAI,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,eAAe;IACnC,OAAO,MAAM,IAAI,CAAC,YAAY,CAAgB,oBAAoB,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,iBAAiB,CAErC,MAAmB,EACnB,WAAoB;IAEpB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,EAAC,WAAW,EAAC,CAAC,CAAC;QACnD,KAAK,SAAS;YACZ,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAC,WAAW,EAAC,CAAC,CAAC;QACpD,KAAK,YAAY;YACf,OAAO,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CACb,2EAA2E;gBACzE,IAAI,MAAM,wBAAwB,CACrC,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAqB,EAAE;IAC5C,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/lib/commands/appearance.d.ts

@@ -1,22 +1,20 @@
+import type { XCUITestDriver } from '../driver';
+import type { Style } from './types';
 /**
  * Set the device's UI appearance style
  *
  * @since iOS 12.0
- * @param {'dark'|'light'} style - The appearance style to set
- * @throws {Error} if the current platform does not support UI appearance changes
- * @this {XCUITestDriver}
+ * @param style - The appearance style to set
+ * @throws If the current platform does not support UI appearance changes
  */
-export function mobileSetAppearance(this: import("../driver").XCUITestDriver, style: "dark" | "light"): Promise<undefined>;
+export declare function mobileSetAppearance(this: XCUITestDriver, style: 'dark' | 'light'): Promise<void>;
 /**
  * Get the device's UI appearance style.
  *
  * @since Xcode SDK 11
- * @returns {Promise<{style: Style}>}
- * @this {XCUITestDriver}
+ * @returns The current appearance style
  */
-export function mobileGetAppearance(this: import("../driver").XCUITestDriver): Promise<{
+export declare function mobileGetAppearance(this: XCUITestDriver): Promise<{
     style: Style;
 }>;
-export type XCUITestDriver = import("../driver").XCUITestDriver;
-export type Style = import("./types").Style;
 //# sourceMappingURL=appearance.d.ts.map

package/build/lib/commands/appearance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../../lib/commands/appearance.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qFAJW,MAAM,GAAC,OAAO,sBA0BxB;AAED;;;;;;GAMG;AACH,+EAHa,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,CAAC,CA0BnC;6BAGY,OAAO,WAAW,EAAE,cAAc;oBAClC,OAAO,SAAS,EAAE,KAAK"}
+{"version":3,"file":"appearance.d.ts","sourceRoot":"","sources":["../../../lib/commands/appearance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,SAAS,CAAC;AAGnC;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,GAAG,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,CAAC,CAkBzB"}

package/build/lib/commands/appearance.js

@@ -11,27 +11,28 @@ const support_1 = require("appium/support");
  * Set the device's UI appearance style
  *
  * @since iOS 12.0
- * @param {'dark'|'light'} style - The appearance style to set
- * @throws {Error} if the current platform does not support UI appearance changes
- * @this {XCUITestDriver}
+ * @param style - The appearance style to set
+ * @throws If the current platform does not support UI appearance changes
  */
 async function mobileSetAppearance(style) {
     if (!['light', 'dark'].includes(lodash_1.default.toLower(style))) {
         throw new Error(`The 'style' value is expected to equal either 'light' or 'dark'`);
     }
-    if (support_1.util.compareVersions(/** @type {string} */ (this.opts.platformVersion), '<', '12.0')) {
+    if (support_1.util.compareVersions(this.opts.platformVersion, '<', '12.0')) {
         throw new Error('Changing appearance is only supported since iOS 12');
     }
     if (this.isSimulator()) {
         try {
-            return void (await /** @type {import('appium-ios-simulator').Simulator} */ (this.device).setAppearance(style));
+            await this.device.setAppearance(style);
+            return;
         }
         catch (e) {
             this.log.debug(e.stack);
         }
     }
     try {
-        return void (await this.proxyCommand('/wda/device/appearance', 'POST', { name: style }, false));
+        await this.proxyCommand('/wda/device/appearance', 'POST', { name: style }, false);
+        return;
     }
     catch (e) {
         this.log.debug(e.stack);
@@ -43,32 +44,25 @@ async function mobileSetAppearance(style) {
  * Get the device's UI appearance style.
  *
  * @since Xcode SDK 11
- * @returns {Promise<{style: Style}>}
- * @this {XCUITestDriver}
+ * @returns The current appearance style
  */
 async function mobileGetAppearance() {
-    if (support_1.util.compareVersions(/** @type {string} */ (this.opts.platformVersion), '<', '12.0')) {
+    if (support_1.util.compareVersions(this.opts.platformVersion, '<', '12.0')) {
         return { style: 'unsupported' };
     }
-    /** @type {Style|undefined} */
     let style;
     if (this.isSimulator()) {
         try {
-            style = /** @type {Style} */ (await /** @type {import('appium-ios-simulator').Simulator} */ (this.device).getAppearance());
+            style = await this.device.getAppearance();
         }
         catch { }
     }
     if (!style) {
-        style = /** @type {Style} */ (
-        /** @type {any} */ (await this.proxyCommand('/wda/device/info', 'GET'))
-            ?.userInterfaceStyle ?? 'unknown');
+        const deviceInfo = await this.proxyCommand('/wda/device/info', 'GET');
+        style = (deviceInfo?.userInterfaceStyle ?? 'unknown');
     }
     return {
-        style,
+        style: style,
     };
 }
-/**
- * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
- * @typedef {import('./types').Style} Style
- */
 //# sourceMappingURL=appearance.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../../lib/commands/appearance.js"],"names":[],"mappings":";;;;;AAWA,kDAsBC;AASD,kDAuBC;AAjED,oDAAuB;AACvB,4CAAoC;AAEpC;;;;;;;GAOG;AACI,KAAK,UAAU,mBAAmB,CAAC,KAAK;IAC7C,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,cAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,MAAM,uDAAuD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QACjH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAE,KAAK,EAAC,EAAE,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,sEAAsE;IACtE,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB;IACvC,IAAI,cAAI,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;QACzF,OAAO,EAAC,KAAK,EAAE,aAAa,EAAC,CAAC;IAChC,CAAC;IAED,8BAA8B;IAC9B,IAAI,KAAK,CAAC;IACV,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,oBAAoB,CAAC,CAC3B,MAAM,uDAAuD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAC5F,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,oBAAoB,CAAC;QAC3B,kBAAkB,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;YACrE,EAAE,kBAAkB,IAAI,SAAS,CACpC,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;GAGG"}
+{"version":3,"file":"appearance.js","sourceRoot":"","sources":["../../../lib/commands/appearance.ts"],"names":[],"mappings":";;;;;AAaA,kDA2BC;AAQD,kDAoBC;AApED,oDAAuB;AACvB,4CAAoC;AAKpC;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CAEvC,KAAuB;IAEvB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,cAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,eAAyB,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAO,IAAI,CAAC,MAAoB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAE,KAAK,EAAC,EAAE,KAAK,CAAC,CAAC;QAChF,OAAO;IACT,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,sEAAsE;IACtE,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,gBAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,mBAAmB;IAGvC,IAAI,cAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,eAAyB,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAC,KAAK,EAAE,aAAa,EAAC,CAAC;IAChC,CAAC;IAED,IAAI,KAAwB,CAAC;IAC7B,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,GAAG,MAAO,IAAI,CAAC,MAAoB,CAAC,aAAa,EAAW,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAqC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QAC1G,KAAK,GAAG,CAAC,UAAU,EAAE,kBAAkB,IAAI,SAAS,CAAU,CAAC;IACjE,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAc;KACtB,CAAC;AACJ,CAAC"}

package/build/lib/commands/execute.d.ts

@@ -1,33 +1,21 @@
+import { XCUITestDriver } from '../driver';
+import type { StringRecord } from '@appium/types';
 /**
  * Collect the response of an async script execution
- * @this {XCUITestDriver}
  * @deprecated
  * @privateRemarks It's unclear what this is for. Don't use it.
  */
-export function receiveAsyncResponse(this: XCUITestDriver, status: any, value: any): Promise<void>;
+export declare function receiveAsyncResponse(this: XCUITestDriver, status: number | null | undefined, value: any): Promise<void>;
 /**
- * @template {ExecuteMethodArgs} [TArgs = unknown[]]
- * @template [TReturn = unknown]
- * @param {string} script - Either a script to run, or in the case of an Execute Method, the name of the script to execute.
- * @param {TArgs} [args]
- * @this {XCUITestDriver}
- * @returns {Promise<TReturn>}
+ * @template TReturn
+ * @param script - Either a script to run, or in the case of an Execute Method, the name of the script to execute.
+ * @param args
  */
-export function execute<TArgs extends ExecuteMethodArgs = unknown[], TReturn = unknown>(this: XCUITestDriver, script: string, args?: TArgs): Promise<TReturn>;
+export declare function execute<TReturn = unknown>(this: XCUITestDriver, script: string, args?: ExecuteMethodArgs): Promise<TReturn>;
 /**
- * @this {XCUITestDriver}
  * @group Mobile Web Only
  */
-export function executeAsync(this: XCUITestDriver, script: any, args: any): Promise<any>;
-export class executeAsync {
-    /**
-     * @this {XCUITestDriver}
-     * @group Mobile Web Only
-     */
-    constructor(this: XCUITestDriver, script: any, args: any);
-    asyncWaitMs: number;
-}
-export type StringRecord<T = any> = import("@appium/types").StringRecord<T>;
-export type ExecuteMethodArgs = readonly any[] | readonly [StringRecord] | Readonly<StringRecord>;
-import { XCUITestDriver } from '../driver';
+export declare function executeAsync(this: XCUITestDriver, script: string, args?: readonly any[]): Promise<any>;
+type ExecuteMethodArgs = readonly any[] | readonly [StringRecord<unknown>] | Readonly<StringRecord<unknown>>;
+export {};
 //# sourceMappingURL=execute.d.ts.map

package/build/lib/commands/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.js"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,mGAqBC;AAED;;;;;;;GAOG;AACH,wBAPkC,KAAK,SAAzB,iBAAkB,cAClB,OAAO,0CACV,MAAM,SACN,KAAK,GAEH,OAAO,CAAC,OAAO,CAAC,CAe5B;AAED;;;GAGG;AACH,yFAaC;;IAjBD;;;OAGG;IACH,0DAaC;IAPC,oBAAwC;;yBA+E5B,CAAC,UACF,OAAO,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;gCAIvC,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC;+BAtJjD,WAAW"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../lib/commands/execute.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAGzC,OAAO,KAAK,EAAU,YAAY,EAAC,MAAM,eAAe,CAAC;AAEzD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,KAAK,EAAE,GAAG,GACT,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,OAAO,GAAG,OAAO,EAC7C,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,SAAS,GAAG,EAAE,GACpB,OAAO,CAAC,GAAG,CAAC,CAad;AA0ED,KAAK,iBAAiB,GAAG,SAAS,GAAG,EAAE,GAAG,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC"}

package/build/lib/commands/execute.js

@@ -12,7 +12,6 @@ const driver_2 = require("appium/driver");
 const support_1 = require("appium/support");
 /**
  * Collect the response of an async script execution
- * @this {XCUITestDriver}
  * @deprecated
  * @privateRemarks It's unclear what this is for. Don't use it.
  */
@@ -34,12 +33,9 @@ async function receiveAsyncResponse(status, value) {
     return this.asyncPromise.resolve(value);
 }
 /**
- * @template {ExecuteMethodArgs} [TArgs = unknown[]]
- * @template [TReturn = unknown]
- * @param {string} script - Either a script to run, or in the case of an Execute Method, the name of the script to execute.
- * @param {TArgs} [args]
- * @this {XCUITestDriver}
- * @returns {Promise<TReturn>}
+ * @template TReturn
+ * @param script - Either a script to run, or in the case of an Execute Method, the name of the script to execute.
+ * @param args
  */
 async function execute(script, args) {
     // TODO: create a type that converts args to the parameters of the associated method using the `command` prop of `executeMethodMap`
@@ -49,7 +45,7 @@ async function execute(script, args) {
         return await this.executeMethod(script, [executeMethodArgs]);
     }
     else if (this.isWebContext()) {
-        const atomsArgs = this.convertElementsForAtoms(/** @type {readonly any[]} */ (args));
+        const atomsArgs = this.convertElementsForAtoms(args);
         const result = await this.executeAtom('execute_script', [script, atomsArgs]);
         return this.cacheWebElements(result);
     }
@@ -58,7 +54,6 @@ async function execute(script, args) {
     }
 }
 /**
- * @this {XCUITestDriver}
  * @group Mobile Web Only
  */
 async function executeAsync(script, args) {
@@ -72,15 +67,13 @@ async function executeAsync(script, args) {
 }
 /**
  * Checks if script expects a particular parameter (either optional or required).
- * @template {keyof XCUITestDriver.executeMethodMap} Script
- * @param {Script} script - Script name
- * @param {string} param - Parameter name
+ * @template Script
+ * @param script - Script name
+ * @param param - Parameter name
  * @returns {boolean}
  */
 function executeMethodExpectsParam(script, param) {
-    /** @type {ReadonlyArray<string>|undefined} */
     let required;
-    /** @type {ReadonlyArray<string>|undefined} */
     let optional;
     const execMethodDef = driver_1.XCUITestDriver.executeMethodMap[script];
     if ('params' in execMethodDef) {
@@ -95,7 +88,7 @@ function executeMethodExpectsParam(script, param) {
     return allParams.has(param);
 }
 /**
- * @param {any} script
+ * @param script
  * @returns {script is keyof XCUITestDriver.executeMethodMap}
  */
 function isExecuteMethod(script) {
@@ -103,15 +96,14 @@ function isExecuteMethod(script) {
 }
 /**
  * Massages the arguments going into an execute method.
- * @param {keyof XCUITestDriver.executeMethodMap} script
- * @param {ExecuteMethodArgs} [args]
- * @returns {StringRecord<unknown>}
+ * @param script
+ * @param args
  */
 function preprocessExecuteMethodArgs(script, args) {
     if (lodash_1.default.isArray(args)) {
         args = lodash_1.default.first(args);
     }
-    const executeMethodArgs = /** @type {StringRecord<unknown>} */ (args ?? {});
+    const executeMethodArgs = (args ?? {});
     /**
      * Renames the deprecated `element` key to `elementId`.  Historically,
      * all of the pre-Execute-Method-Map execute methods accepted an `element` _or_ and `elementId` param.
@@ -127,16 +119,8 @@ function preprocessExecuteMethodArgs(script, args) {
      * Most of these Execute Methods (typically beginning with `mobile*`) will accept an `Element|string` for `elementId`, in practice they will only ever get a `string`. `Element|string` in the method's docstring is simply for documentation purposes.
      */
     if ('elementId' in executeMethodArgs && executeMethodExpectsParam(script, 'elementId')) {
-        executeMethodArgs.elementId = support_1.util.unwrapElement(
-        /** @type {import('@appium/types').Element|string} */ (executeMethodArgs.elementId));
+        executeMethodArgs.elementId = support_1.util.unwrapElement(executeMethodArgs.elementId);
     }
     return executeMethodArgs;
 }
-/**
- * @template [T=any]
- * @typedef {import('@appium/types').StringRecord<T>} StringRecord
- */
-/**
- * @typedef {readonly any[] | readonly [StringRecord] | Readonly<StringRecord>} ExecuteMethodArgs
- */
 //# sourceMappingURL=execute.js.map

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

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

@@ -1,3 +1,6 @@
+import type { XCUITestDriver } from '../driver';
+import type { Location } from '@appium/types';
+import type { LocationWithAltitude } from './types';
 /**
  * Returns location of the device under test.
  * The device under test must allow the location services for WDA
@@ -11,31 +14,25 @@
  * "mobile:getSimulatedLocation" if the simulated location has been previously set
  * "mobile:setSimulatedLocation" already.
  *
- * @returns {Promise<import('./types').LocationWithAltitude>}
+ * @returns Location with altitude
  * @throws {Error} If the device under test returns an error message.
  *                 i.e.: tvOS returns unsupported error
- * @this {XCUITestDriver}
  */
-export function getGeoLocation(this: import("../driver").XCUITestDriver): Promise<import("./types").LocationWithAltitude>;
+export declare function getGeoLocation(this: XCUITestDriver): Promise<LocationWithAltitude>;
 /**
  * Set location of the device under test.
  *
  * iOS 17+ real device environment will be via "mobile:setSimulatedLocation" as
  * setting simulated location for XCTest session.
  *
- * @param {Partial<Location>} location
- * @this {XCUITestDriver}
+ * @param location - Location with latitude and longitude
  */
-export function setGeoLocation(this: import("../driver").XCUITestDriver, location: Partial<Location>): Promise<import("@appium/types").Location>;
+export declare function setGeoLocation(this: XCUITestDriver, location: Partial<Location>): Promise<Location>;
 /**
  * Reset the location service on real device.
  *
  * @throws {Error} If the device is simulator and iOS version is below 17,
  * or 'resetLocation' raises an error.
- * @this {XCUITestDriver}
  */
-export function mobileResetLocationService(this: import("../driver").XCUITestDriver): Promise<void>;
-export type XCUITestDriver = import("../driver").XCUITestDriver;
-export type WDALocationInfo = import("./types").WDALocationInfo;
-export type Location = import("@appium/types").Location;
+export declare function mobileResetLocationService(this: XCUITestDriver): Promise<void>;
 //# sourceMappingURL=location.d.ts.map

package/build/lib/commands/location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../lib/commands/location.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH,0EALa,OAAO,CAAC,OAAO,SAAS,EAAE,oBAAoB,CAAC,CAyC3D;AAED;;;;;;;;GAQG;AACH,mFAHW,OAAO,CAAC,QAAQ,CAAC,6CAgC3B;AAED;;;;;;GAMG;AACH,oGAsBC;6BAGY,OAAO,WAAW,EAAE,cAAc;8BAClC,OAAO,SAAS,EAAE,eAAe;uBACjC,OAAO,eAAe,EAAE,QAAQ"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../lib/commands/location.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAC,oBAAoB,EAAkB,MAAM,SAAS,CAAC;AAGnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkCxF;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAC1B,OAAO,CAAC,QAAQ,CAAC,CA6BnB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBpF"}

package/build/lib/commands/location.js

@@ -21,10 +21,9 @@ const utils_1 = require("../utils");
  * "mobile:getSimulatedLocation" if the simulated location has been previously set
  * "mobile:setSimulatedLocation" already.
  *
- * @returns {Promise<import('./types').LocationWithAltitude>}
+ * @returns Location with altitude
  * @throws {Error} If the device under test returns an error message.
  *                 i.e.: tvOS returns unsupported error
- * @this {XCUITestDriver}
  */
 async function getGeoLocation() {
     // Currently we proxy the setGeoLocation to mobile:setSimulatedLocation for iOS 17+.
@@ -43,7 +42,7 @@ async function getGeoLocation() {
     // '/wda/device/location' returns current device location information,
     // but '/wda/simulatedLocation' returns `null` values until the WDA process
     // sets a simulated location. After setting the value, both returns the same values.
-    const { authorizationStatus, latitude, longitude, altitude } = /** @type {WDALocationInfo} */ (await this.proxyCommand('/wda/device/location', 'GET'));
+    const { authorizationStatus, latitude, longitude, altitude } = await this.proxyCommand('/wda/device/location', 'GET');
     // '3' is 'Always' in the privacy
     // https://developer.apple.com/documentation/corelocation/clauthorizationstatus
     if (authorizationStatus !== enum_1.AuthorizationStatus.authorizedAlways) {
@@ -61,17 +60,16 @@ async function getGeoLocation() {
  * iOS 17+ real device environment will be via "mobile:setSimulatedLocation" as
  * setting simulated location for XCTest session.
  *
- * @param {Partial<Location>} location
- * @this {XCUITestDriver}
+ * @param location - Location with latitude and longitude
  */
 async function setGeoLocation(location) {
-    let { latitude, longitude } = location;
+    const { latitude, longitude } = location;
     if (!support_1.util.hasValue(latitude) || !support_1.util.hasValue(longitude)) {
         throw new driver_1.errors.InvalidArgumentError(`Both latitude and longitude should be set`);
     }
     if (this.isSimulator()) {
-        await /** @type {import('appium-ios-simulator').Simulator} */ (this.device).setGeolocation(`${latitude}`, `${longitude}`);
-        return /** @type {Location} */ ({ latitude, longitude, altitude: 0 });
+        await this.device.setGeolocation(`${latitude}`, `${longitude}`);
+        return { latitude, longitude, altitude: 0 };
     }
     if ((0, utils_1.isIos17OrNewer)(this.opts)) {
         this.log.info(`Proxying to mobile:setSimulatedLocation method for iOS 17+`);
@@ -89,14 +87,13 @@ async function setGeoLocation(location) {
             service.close();
         }
     }
-    return /** @type {Location} */ ({ latitude, longitude, altitude: 0 });
+    return { latitude, longitude, altitude: 0 };
 }
 /**
  * Reset the location service on real device.
  *
  * @throws {Error} If the device is simulator and iOS version is below 17,
  * or 'resetLocation' raises an error.
- * @this {XCUITestDriver}
  */
 async function mobileResetLocationService() {
     if ((0, utils_1.isIos17OrNewer)(this.opts)) {
@@ -119,9 +116,4 @@ async function mobileResetLocationService() {
         service.close();
     }
 }
-/**
- * @typedef {import('../driver').XCUITestDriver} XCUITestDriver
- * @typedef {import('./types').WDALocationInfo} WDALocationInfo
- * @typedef {import('@appium/types').Location} Location
- */
 //# sourceMappingURL=location.js.map