appium-uiautomator2-driver 6.7.6 → 6.7.8

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [6.7.8](https://github.com/appium/appium-uiautomator2-driver/compare/v6.7.7...v6.7.8) (2025-12-25)
+
+### Miscellaneous Chores
+
+* Migrate index to typescript ([#972](https://github.com/appium/appium-uiautomator2-driver/issues/972)) ([381fadd](https://github.com/appium/appium-uiautomator2-driver/commit/381fadd7b3e53ad7fa9bd16e8e60d563ebfc8c24))
+
+## [6.7.7](https://github.com/appium/appium-uiautomator2-driver/compare/v6.7.6...v6.7.7) (2025-12-24)
+
+### Miscellaneous Chores
+
+* Migrate the rest of command modules to typescript ([#971](https://github.com/appium/appium-uiautomator2-driver/issues/971)) ([1e7606c](https://github.com/appium/appium-uiautomator2-driver/commit/1e7606ccc41b19ace7b7ced898329f84a4774280))
+
 ## [6.7.6](https://github.com/appium/appium-uiautomator2-driver/compare/v6.7.5...v6.7.6) (2025-12-23)
 
 ### Miscellaneous Chores

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

@@ -1,40 +1,37 @@
+import type { StringRecord } from '@appium/types';
+import type { AndroidUiautomator2Driver } from '../driver';
+import type { ActionResult } from './types';
 /**
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-scheduleaction
- * @this {AndroidUiautomator2Driver}
- * @param {string} name
- * @param {import('@appium/types').StringRecord[]} steps
- * @param {number} [maxPass]
- * @param {number} [maxFail]
- * @param {number} [times]
- * @param {number} [intervalMs]
- * @param {number} [maxHistoryItems]
- * @returns {Promise<any>}
+ * Schedules a recurring action to be performed at specified intervals.
+ * @param name - Unique name for the scheduled action.
+ * @param steps - Array of action steps to be executed.
+ * @param maxPass - Maximum number of successful executions before stopping.
+ * @param maxFail - Maximum number of failed executions before stopping.
+ * @param times - Total number of times to execute the action.
+ * @param intervalMs - Interval in milliseconds between action executions.
+ * @param maxHistoryItems - Maximum number of history items to keep.
+ * @returns The result of scheduling the action.
  */
-export function mobileScheduleAction(this: import("../driver").AndroidUiautomator2Driver, name: string, steps: import("@appium/types").StringRecord[], maxPass?: number, maxFail?: number, times?: number, intervalMs?: number, maxHistoryItems?: number): Promise<any>;
+export declare function mobileScheduleAction(this: AndroidUiautomator2Driver, name: string, steps: StringRecord[], maxPass?: number, maxFail?: number, times?: number, intervalMs?: number, maxHistoryItems?: number): Promise<any>;
 /**
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-getactionhistory
- * @this {AndroidUiautomator2Driver}
- * @param {string} name
- * @returns {Promise<import('./types').ActionResult>}
+ * Gets the execution history for a scheduled action.
+ * @param name - Name of the scheduled action.
+ * @returns The action execution history containing repeats and step results.
  */
-export function mobileGetActionHistory(this: import("../driver").AndroidUiautomator2Driver, name: string): Promise<import("./types").ActionResult>;
+export declare function mobileGetActionHistory(this: AndroidUiautomator2Driver, name: string): Promise<ActionResult>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-unscheduleaction
- * @param {string} name
- * @returns {Promise<any>}
+ * Unschedules a previously scheduled action.
+ * @param name - Name of the scheduled action to unschedule.
+ * @returns The result of unscheduling the action.
  */
-export function mobileUnscheduleAction(this: import("../driver").AndroidUiautomator2Driver, name: string): Promise<any>;
+export declare function mobileUnscheduleAction(this: AndroidUiautomator2Driver, name: string): Promise<any>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {import('@appium/types').StringRecord[]} actions
- * @returns {Promise<void>}
+ * Performs a sequence of actions.
+ * @param actions - Array of action objects to perform. Pointer actions are automatically converted to touch type.
  */
-export function performActions(this: import("../driver").AndroidUiautomator2Driver, actions: import("@appium/types").StringRecord[]): Promise<void>;
+export declare function performActions(this: AndroidUiautomator2Driver, actions: StringRecord[]): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Releases all currently pressed keys and buttons.
  */
-export function releaseActions(this: import("../driver").AndroidUiautomator2Driver): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function releaseActions(this: AndroidUiautomator2Driver): Promise<void>;
 //# sourceMappingURL=actions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../lib/commands/actions.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,gGATW,MAAM,SACN,OAAO,eAAe,EAAE,YAAY,EAAE,YACtC,MAAM,YACN,MAAM,UACN,MAAM,eACN,MAAM,oBACN,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAwBxB;AAED;;;;;GAKG;AACH,kGAHW,MAAM,GACJ,OAAO,CAAC,OAAO,SAAS,EAAE,YAAY,CAAC,CAUnD;AAED;;;;;GAKG;AACH,kGAHW,MAAM,GACJ,OAAO,CAAC,GAAG,CAAC,CAQxB;AAED;;;;GAIG;AACH,6FAHW,OAAO,eAAe,EAAE,YAAY,EAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAyBzB;AAED;;;GAGG;AACH,qFAFa,OAAO,CAAC,IAAI,CAAC,CAIzB;wCAGY,OAAO,WAAW,EAAE,yBAAyB"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../lib/commands/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,GAAG,CAAC,CAUd;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,GAAG,CAAC,CAEd;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF"}

package/build/lib/commands/actions.js

@@ -6,16 +6,15 @@ exports.mobileUnscheduleAction = mobileUnscheduleAction;
 exports.performActions = performActions;
 exports.releaseActions = releaseActions;
 /**
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-scheduleaction
- * @this {AndroidUiautomator2Driver}
- * @param {string} name
- * @param {import('@appium/types').StringRecord[]} steps
- * @param {number} [maxPass]
- * @param {number} [maxFail]
- * @param {number} [times]
- * @param {number} [intervalMs]
- * @param {number} [maxHistoryItems]
- * @returns {Promise<any>}
+ * Schedules a recurring action to be performed at specified intervals.
+ * @param name - Unique name for the scheduled action.
+ * @param steps - Array of action steps to be executed.
+ * @param maxPass - Maximum number of successful executions before stopping.
+ * @param maxFail - Maximum number of failed executions before stopping.
+ * @param times - Total number of times to execute the action.
+ * @param intervalMs - Interval in milliseconds between action executions.
+ * @param maxHistoryItems - Maximum number of history items to keep.
+ * @returns The result of scheduling the action.
  */
 async function mobileScheduleAction(name, steps, maxPass, maxFail, times, intervalMs, maxHistoryItems) {
     return await this.uiautomator2.jwproxy.command('/appium/schedule_action', 'POST', {
@@ -29,27 +28,24 @@ async function mobileScheduleAction(name, steps, maxPass, maxFail, times, interv
     });
 }
 /**
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-getactionhistory
- * @this {AndroidUiautomator2Driver}
- * @param {string} name
- * @returns {Promise<import('./types').ActionResult>}
+ * Gets the execution history for a scheduled action.
+ * @param name - Name of the scheduled action.
+ * @returns The action execution history containing repeats and step results.
  */
 async function mobileGetActionHistory(name) {
-    return /** @type {import('./types').ActionResult} */ (await this.uiautomator2.jwproxy.command('/appium/action_history', 'POST', { name }));
+    return (await this.uiautomator2.jwproxy.command('/appium/action_history', 'POST', { name }));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @see https://github.com/appium/appium-uiautomator2-driver/blob/master/docs/scheduled-actions.md#mobile-unscheduleaction
- * @param {string} name
- * @returns {Promise<any>}
+ * Unschedules a previously scheduled action.
+ * @param name - Name of the scheduled action to unschedule.
+ * @returns The result of unscheduling the action.
  */
 async function mobileUnscheduleAction(name) {
     return await this.uiautomator2.jwproxy.command('/appium/unschedule_action', 'POST', { name });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {import('@appium/types').StringRecord[]} actions
- * @returns {Promise<void>}
+ * Performs a sequence of actions.
+ * @param actions - Array of action objects to perform. Pointer actions are automatically converted to touch type.
  */
 async function performActions(actions) {
     // This is mandatory, since Selenium API uses MOUSE as the default pointer type
@@ -66,13 +62,9 @@ async function performActions(actions) {
     });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Releases all currently pressed keys and buttons.
  */
 async function releaseActions() {
     this.log.info('On this platform, releaseActions is a no-op');
 }
-/**
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
 //# sourceMappingURL=actions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../lib/commands/actions.js"],"names":[],"mappings":";;AAYA,oDAsBC;AAQD,wDAQC;AAQD,wDAMC;AAOD,wCAuBC;AAMD,wCAEC;AAtGD;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,oBAAoB,CACxC,IAAI,EACJ,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,UAAU,EACV,eAAe;IAEf,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAC5C,yBAAyB,EACzB,MAAM,EACN;QACE,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK;QACL,UAAU;QACV,eAAe;KAChB,CACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,sBAAsB,CAAC,IAAI;IAC/C,OAAO,6CAA6C,CAAC,CACnD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,wBAAwB,EACxB,MAAM,EACN,EAAC,IAAI,EAAC,CACP,CACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,sBAAsB,CAAC,IAAI;IAC/C,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAC5C,2BAA2B,EAC3B,MAAM,EACN,EAAC,IAAI,EAAC,CACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAAC,OAAO;IAC1C,+EAA+E;IAC/E,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACjD,MAAM,CAAC,MAAM,CACX,EAAE,EACF,MAAM,EACN,MAAM,CAAC,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC;YACE,UAAU,EAAE;gBACV,WAAW,EAAE,OAAO;aACrB;SACF;QACH,CAAC,CAAC,EAAE,CACP,CACF,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,UAAU,EACV,MAAM,EACN;QACE,OAAO,EAAE,mBAAmB;KAC7B,CACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../lib/commands/actions.ts"],"names":[],"mappings":";;AAeA,oDAmBC;AAOD,wDAKC;AAOD,wDAKC;AAMD,wCAsBC;AAKD,wCAEC;AAzFD;;;;;;;;;;GAUG;AACI,KAAK,UAAU,oBAAoB,CAExC,IAAY,EACZ,KAAqB,EACrB,OAAgB,EAChB,OAAgB,EAChB,KAAc,EACd,UAAmB,EACnB,eAAwB;IAExB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,yBAAyB,EAAE,MAAM,EAAE;QAChF,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK;QACL,UAAU;QACV,eAAe;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAE1C,IAAY;IAEZ,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,CAAC,CAAiB,CAAC;AAC7G,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,sBAAsB,CAE1C,IAAY;IAEZ,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,EAAE,MAAM,EAAE,EAAC,IAAI,EAAC,CAAC,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,cAAc,CAElC,OAAuB;IAEvB,+EAA+E;IAC/E,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACjD,MAAM,CAAC,MAAM,CACX,EAAE,EACF,MAAM,EACN,MAAM,CAAC,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC;YACE,UAAU,EAAE;gBACV,WAAW,EAAE,OAAO;aACrB;SACF;QACH,CAAC,CAAC,EAAE,CACP,CACF,CAAC;IACF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE;QAC1D,OAAO,EAAE,mBAAmB;KAC7B,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;AAC/D,CAAC"}

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

@@ -1,33 +1,25 @@
+import type { AndroidUiautomator2Driver } from '../driver';
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<string>}
+ * Gets the text of the currently displayed alert.
+ * @returns The alert text as a string.
  */
-export function getAlertText(this: import("../driver").AndroidUiautomator2Driver): Promise<string>;
+export declare function getAlertText(this: AndroidUiautomator2Driver): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} [buttonLabel] The name of the button to click in order to accept the alert.
- * If the name is not provided
- * then the script will try to detect the button automatically.
- * @returns {Promise<void>}
+ * Accepts the currently displayed alert.
+ * @param buttonLabel - Optional label of the button to click. If not provided, the button will be detected automatically.
  */
-export function mobileAcceptAlert(this: import("../driver").AndroidUiautomator2Driver, buttonLabel?: string): Promise<void>;
+export declare function mobileAcceptAlert(this: AndroidUiautomator2Driver, buttonLabel?: string): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Accepts the currently displayed alert (W3C endpoint).
  */
-export function postAcceptAlert(this: import("../driver").AndroidUiautomator2Driver): Promise<void>;
+export declare function postAcceptAlert(this: AndroidUiautomator2Driver): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} [buttonLabel] The name of the button to click in order to dismiss the alert.
- * If the name is not provided
- * then the script will try to detect the button automatically.
- * @returns {Promise<void>}
+ * Dismisses the currently displayed alert.
+ * @param buttonLabel - Optional label of the button to click. If not provided, the button will be detected automatically.
  */
-export function mobileDismissAlert(this: import("../driver").AndroidUiautomator2Driver, buttonLabel?: string): Promise<void>;
+export declare function mobileDismissAlert(this: AndroidUiautomator2Driver, buttonLabel?: string): Promise<void>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Dismisses the currently displayed alert (W3C endpoint).
  */
-export function postDismissAlert(this: import("../driver").AndroidUiautomator2Driver): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function postDismissAlert(this: AndroidUiautomator2Driver): Promise<void>;
 //# 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;;;GAGG;AACH,mFAFa,OAAO,CAAC,MAAM,CAAC,CAU3B;AAED;;;;;;GAMG;AACH,qGALW,MAAM,GAGJ,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;GAGG;AACH,sFAFa,OAAO,CAAC,IAAI,CAAC,CAIzB;AAED;;;;;;GAMG;AACH,sGALW,MAAM,GAGJ,OAAO,CAAC,IAAI,CAAC,CAQzB;AAED;;;GAGG;AACH,uFAFa,OAAO,CAAC,IAAI,CAAC,CAIzB;wCAGY,OAAO,WAAW,EAAE,yBAAyB"}
+{"version":3,"file":"alert.d.ts","sourceRoot":"","sources":["../../../lib/commands/alert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAErF"}

package/build/lib/commands/alert.js

@@ -6,47 +6,36 @@ exports.postAcceptAlert = postAcceptAlert;
 exports.mobileDismissAlert = mobileDismissAlert;
 exports.postDismissAlert = postDismissAlert;
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<string>}
+ * Gets the text of the currently displayed alert.
+ * @returns The alert text as a string.
  */
 async function getAlertText() {
     return String(await this.uiautomator2.jwproxy.command('/alert/text', 'GET', {}));
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} [buttonLabel] The name of the button to click in order to accept the alert.
- * If the name is not provided
- * then the script will try to detect the button automatically.
- * @returns {Promise<void>}
+ * Accepts the currently displayed alert.
+ * @param buttonLabel - Optional label of the button to click. If not provided, the button will be detected automatically.
  */
 async function mobileAcceptAlert(buttonLabel) {
     await this.uiautomator2.jwproxy.command('/alert/accept', 'POST', { buttonLabel });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Accepts the currently displayed alert (W3C endpoint).
  */
 async function postAcceptAlert() {
     await this.mobileAcceptAlert();
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} [buttonLabel] The name of the button to click in order to dismiss the alert.
- * If the name is not provided
- * then the script will try to detect the button automatically.
- * @returns {Promise<void>}
+ * Dismisses the currently displayed alert.
+ * @param buttonLabel - Optional label of the button to click. If not provided, the button will be detected automatically.
  */
 async function mobileDismissAlert(buttonLabel) {
     await this.uiautomator2.jwproxy.command('/alert/dismiss', 'POST', { buttonLabel });
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<void>}
+ * Dismisses the currently displayed alert (W3C endpoint).
  */
 async function postDismissAlert() {
     await this.mobileDismissAlert();
 }
-/**
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
 //# 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":";;AAIA,oCAQC;AASD,8CAMC;AAMD,0CAEC;AASD,gDAMC;AAMD,4CAEC;AA1DD;;;GAGG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CACX,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,aAAa,EACb,KAAK,EACL,EAAE,CACH,CACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,iBAAiB,CAAC,WAAW;IACjD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,eAAe,EACf,MAAM,EACN,EAAC,WAAW,EAAC,CACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,eAAe;IACnC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,kBAAkB,CAAC,WAAW;IAClD,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,gBAAgB,EAChB,MAAM,EACN,EAAC,WAAW,EAAC,CACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,gBAAgB;IACpC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG"}
+{"version":3,"file":"alert.js","sourceRoot":"","sources":["../../../lib/commands/alert.ts"],"names":[],"mappings":";;AAMA,oCAEC;AAMD,8CAKC;AAKD,0CAEC;AAMD,gDAKC;AAKD,4CAEC;AA1CD;;;GAGG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;AACnF,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,iBAAiB,CAErC,WAAoB;IAEpB,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,EAAC,WAAW,EAAC,CAAC,CAAC;AAClF,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe;IACnC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;AACjC,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CAEtC,WAAoB;IAEpB,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAC,WAAW,EAAC,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB;IACpC,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;AAClC,CAAC"}

package/build/lib/commands/app-management.d.ts

@@ -1,13 +1,10 @@
+import type { AndroidUiautomator2Driver } from '../driver';
+import type { InstallOptions } from './types';
 /**
- * Install multiple APKs with `install-multiple` option.
- * @this {AndroidUiautomator2Driver}
- * @param {string[]} apks The list of APKs to install. Each APK should be a path to a apk
- * or downloadable URL as HTTP/HTTPS.
- * @param {import('./types').InstallOptions} [options] Installation options.
- * @throws {Error} if an error occured while installing the given APKs.
- * @returns {Promise<void>}
+ * Installs multiple APKs with `install-multiple` option.
+ * @param apks - Array of APK file paths or URLs to install.
+ * @param options - Optional installation options (allowTestPackages, useSdcard, grantPermissions, etc.).
+ * @throws {errors.InvalidArgumentError} If the apks array is empty or invalid.
  */
-export function mobileInstallMultipleApks(this: import("../driver").AndroidUiautomator2Driver, apks: string[], options?: import("./types").InstallOptions): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
-export type StringRecord<T = any> = import("@appium/types").StringRecord<T>;
+export declare function mobileInstallMultipleApks(this: AndroidUiautomator2Driver, apks: string[], options?: InstallOptions): Promise<void>;
 //# sourceMappingURL=app-management.d.ts.map

package/build/lib/commands/app-management.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,qGANW,MAAM,EAAE,YAER,OAAO,SAAS,EAAE,cAAc,GAE9B,OAAO,CAAC,IAAI,CAAC,CAUzB;wCAGY,OAAO,WAAW,EAAE,yBAAyB;yBAI5C,CAAC,UACF,OAAO,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"app-management.d.ts","sourceRoot":"","sources":["../../../lib/commands/app-management.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,SAAS,CAAC;AAE5C;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,yBAAyB,EAC/B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/build/lib/commands/app-management.js

@@ -9,13 +9,10 @@ const bluebird_1 = __importDefault(require("bluebird"));
 const driver_1 = require("appium/driver");
 const extensions_1 = require("../extensions");
 /**
- * Install multiple APKs with `install-multiple` option.
- * @this {AndroidUiautomator2Driver}
- * @param {string[]} apks The list of APKs to install. Each APK should be a path to a apk
- * or downloadable URL as HTTP/HTTPS.
- * @param {import('./types').InstallOptions} [options] Installation options.
- * @throws {Error} if an error occured while installing the given APKs.
- * @returns {Promise<void>}
+ * Installs multiple APKs with `install-multiple` option.
+ * @param apks - Array of APK file paths or URLs to install.
+ * @param options - Optional installation options (allowTestPackages, useSdcard, grantPermissions, etc.).
+ * @throws {errors.InvalidArgumentError} If the apks array is empty or invalid.
  */
 async function mobileInstallMultipleApks(apks, options) {
     if (!lodash_1.default.isArray(apks) || lodash_1.default.isEmpty(apks)) {
@@ -24,11 +21,4 @@ async function mobileInstallMultipleApks(apks, options) {
     const configuredApks = await bluebird_1.default.all(apks.map((app) => this.helpers.configureApp(app, [extensions_1.APK_EXTENSION])));
     await this.adb.installMultipleApks(configuredApks, options);
 }
-/**
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
-/**
- * @template [T=any]
- * @typedef {import('@appium/types').StringRecord<T>} StringRecord
- */
 //# sourceMappingURL=app-management.js.map

package/build/lib/commands/app-management.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../lib/commands/app-management.js"],"names":[],"mappings":";;;;;AAcA,8DAQC;AAtBD,oDAAuB;AACvB,wDAAyB;AACzB,0CAAqC;AACrC,8CAA4C;AAE5C;;;;;;;;GAQG;AACI,KAAK,UAAU,yBAAyB,CAAC,IAAI,EAAE,OAAO;IAC3D,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,eAAM,CAAC,oBAAoB,CAAC,8BAA8B,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,kBAAC,CAAC,GAAG,CAChC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,0BAAa,CAAC,CAAC,CAAC,CACnE,CAAC;IACF,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AAEH;;;GAGG"}
+{"version":3,"file":"app-management.js","sourceRoot":"","sources":["../../../lib/commands/app-management.ts"],"names":[],"mappings":";;;;;AAaA,8DAUC;AAvBD,oDAAuB;AACvB,wDAAyB;AACzB,0CAAqC;AACrC,8CAA4C;AAI5C;;;;;GAKG;AACI,KAAK,UAAU,yBAAyB,CAE7C,IAAc,EACd,OAAwB;IAExB,IAAI,CAAC,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,gBAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,eAAM,CAAC,oBAAoB,CAAC,8BAA8B,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,cAAc,GAAG,MAAM,kBAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,0BAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACvG,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC"}

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

@@ -1,9 +1,8 @@
+import type { AndroidUiautomator2Driver } from '../driver';
+import type { BatteryInfo } from './types';
 /**
  * Reads the battery information from the device under test.
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<import('./types').BatteryInfo>} The actual battery info
+ * @returns Battery information including level (0.0-1.0) and state (charging, discharging, etc.).
  */
-export function mobileGetBatteryInfo(this: import("../driver").AndroidUiautomator2Driver): Promise<import("./types").BatteryInfo>;
-export type BatteryInfo = import("./types").BatteryInfo;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function mobileGetBatteryInfo(this: AndroidUiautomator2Driver): Promise<BatteryInfo>;
 //# sourceMappingURL=battery.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"battery.d.ts","sourceRoot":"","sources":["../../../lib/commands/battery.js"],"names":[],"mappings":"AACA;;;;GAIG;AACH,2FAFa,OAAO,CAAC,OAAO,SAAS,EAAE,WAAW,CAAC,CAalD;0BAGY,OAAO,SAAS,EAAE,WAAW;wCAC7B,OAAO,WAAW,EAAE,yBAAyB"}
+{"version":3,"file":"battery.d.ts","sourceRoot":"","sources":["../../../lib/commands/battery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,WAAW,CAAC,CAUhG"}

package/build/lib/commands/battery.js

@@ -3,19 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mobileGetBatteryInfo = mobileGetBatteryInfo;
 /**
  * Reads the battery information from the device under test.
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<import('./types').BatteryInfo>} The actual battery info
+ * @returns Battery information including level (0.0-1.0) and state (charging, discharging, etc.).
  */
 async function mobileGetBatteryInfo() {
-    const result = /** @type {import('./types').MapKey<BatteryInfo, 'state', 'status'>} */ (await /** @type {import('../uiautomator2').UiAutomator2Server} */ (this.uiautomator2).jwproxy.command('/appium/device/battery_info', 'GET', {}));
-    const batteryInfo = /** @type {any} */ (result);
+    const result = (await this.uiautomator2.jwproxy.command('/appium/device/battery_info', 'GET', {}));
+    const batteryInfo = result;
     // Give it the same name as in iOS
     batteryInfo.state = result.status;
     delete batteryInfo.status;
-    return /** @type {BatteryInfo} */ (batteryInfo);
+    return batteryInfo;
 }
-/**
- * @typedef {import('./types').BatteryInfo} BatteryInfo
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
 //# sourceMappingURL=battery.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"battery.js","sourceRoot":"","sources":["../../../lib/commands/battery.js"],"names":[],"mappings":";;AAMA,oDAWC;AAhBD;;;;GAIG;AACI,KAAK,UAAU,oBAAoB;IACxC,MAAM,MAAM,GAAG,uEAAuE,CAAC,CACrF,MAAM,2DAA2D,CAAC,CAChE,IAAI,CAAC,YAAY,CAClB,CAAC,OAAO,CAAC,OAAO,CAAC,6BAA6B,EAAE,KAAK,EAAE,EAAE,CAAC,CAC5D,CAAC;IACF,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,kCAAkC;IAClC,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,WAAW,CAAC,MAAM,CAAC;IAC1B,OAAO,0BAA0B,CAAC,CAAC,WAAW,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG"}
+{"version":3,"file":"battery.js","sourceRoot":"","sources":["../../../lib/commands/battery.ts"],"names":[],"mappings":";;AAOA,oDAUC;AAdD;;;GAGG;AACI,KAAK,UAAU,oBAAoB;IACxC,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,6BAA6B,EAAE,KAAK,EAAE,EAAE,CAAC,CAGhG,CAAC;IACF,MAAM,WAAW,GAAG,MAAa,CAAC;IAClC,kCAAkC;IAClC,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,WAAW,CAAC,MAAM,CAAC;IAC1B,OAAO,WAA0B,CAAC;AACpC,CAAC"}

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

@@ -1,18 +1,14 @@
+import type { AndroidUiautomator2Driver } from '../driver';
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<string>} Base64-encoded content of the clipboard
- * or an empty string if the clipboard is empty.
+ * Gets the clipboard content as a base64-encoded string.
+ * @returns Base64-encoded clipboard content, or an empty string if the clipboard is empty.
  */
-export function getClipboard(this: import("../driver").AndroidUiautomator2Driver): Promise<string>;
+export declare function getClipboard(this: AndroidUiautomator2Driver): Promise<string>;
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} content Base64-encoded clipboard payload
- * @param {'plaintext'} [contentType='plaintext'] Only a single
- * content type is supported, which is 'plaintext'
- * @param {string} [label] Optinal label to identify the current
- * clipboard payload
- * @returns {Promise<void>}
+ * Sets the clipboard content.
+ * @param content - Base64-encoded clipboard payload.
+ * @param contentType - Content type. Only 'plaintext' is supported. Defaults to 'plaintext'.
+ * @param label - Optional label to identify the current clipboard payload.
  */
-export function setClipboard(this: import("../driver").AndroidUiautomator2Driver, content: string, contentType?: "plaintext", label?: string): Promise<void>;
-export type AndroidUiautomator2Driver = import("../driver").AndroidUiautomator2Driver;
+export declare function setClipboard(this: AndroidUiautomator2Driver, content: string, contentType?: 'plaintext', label?: string): Promise<void>;
 //# sourceMappingURL=clipboard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../lib/commands/clipboard.js"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,mFAHa,OAAO,CAAC,MAAM,CAAC,CAa3B;AAED;;;;;;;;GAQG;AACH,2FAPW,MAAM,gBACN,WAAW,UAEX,MAAM,GAEJ,OAAO,CAAC,IAAI,CAAC,CAQzB;wCAGY,OAAO,WAAW,EAAE,yBAAyB"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../lib/commands/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,WAAW,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnF;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,yBAAyB,EAC/B,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,WAAyB,EACtC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/build/lib/commands/clipboard.js

@@ -3,9 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getClipboard = getClipboard;
 exports.setClipboard = setClipboard;
 /**
- * @this {AndroidUiautomator2Driver}
- * @returns {Promise<string>} Base64-encoded content of the clipboard
- * or an empty string if the clipboard is empty.
+ * Gets the clipboard content as a base64-encoded string.
+ * @returns Base64-encoded clipboard content, or an empty string if the clipboard is empty.
  */
 async function getClipboard() {
     return String((await this.adb.getApiLevel()) < 29
@@ -13,18 +12,12 @@ async function getClipboard() {
         : await this.settingsApp.getClipboard());
 }
 /**
- * @this {AndroidUiautomator2Driver}
- * @param {string} content Base64-encoded clipboard payload
- * @param {'plaintext'} [contentType='plaintext'] Only a single
- * content type is supported, which is 'plaintext'
- * @param {string} [label] Optinal label to identify the current
- * clipboard payload
- * @returns {Promise<void>}
+ * Sets the clipboard content.
+ * @param content - Base64-encoded clipboard payload.
+ * @param contentType - Content type. Only 'plaintext' is supported. Defaults to 'plaintext'.
+ * @param label - Optional label to identify the current clipboard payload.
  */
-async function setClipboard(content, contentType, label) {
+async function setClipboard(content, contentType = 'plaintext', label) {
     await this.uiautomator2.jwproxy.command('/appium/device/set_clipboard', 'POST', { content, contentType, label });
 }
-/**
- * @typedef {import('../driver').AndroidUiautomator2Driver} AndroidUiautomator2Driver
- */
 //# sourceMappingURL=clipboard.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../lib/commands/clipboard.js"],"names":[],"mappings":";;AAKA,oCAUC;AAWD,oCAMC;AAhCD;;;;GAIG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CACX,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE;QACjC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,8BAA8B,EAC9B,MAAM,EACN,EAAE,CACH;QACH,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACI,KAAK,UAAU,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK;IAC5D,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CACrC,8BAA8B,EAC9B,MAAM,EACN,EAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAC,CAC9B,CAAC;AACJ,CAAC;AAED;;GAEG"}
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../lib/commands/clipboard.ts"],"names":[],"mappings":";;AAMA,oCAMC;AAQD,oCAOC;AAzBD;;;GAGG;AACI,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CACX,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE;QACjC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,EAAE,MAAM,EAAE,EAAE,CAAC;QACrF,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAEhC,OAAe,EACf,cAA2B,WAAW,EACtC,KAAc;IAEd,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,EAAE,MAAM,EAAE,EAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAC,CAAC,CAAC;AACjH,CAAC"}

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

@@ -3,66 +3,95 @@ import type { Element as AppiumElement, Position, Rect, Size } from '@appium/typ
 import type { AndroidUiautomator2Driver } from '../driver';
 /**
  * Gets the currently active element.
+ * @returns The currently active element.
  */
 export declare function active(this: AndroidUiautomator2Driver): Promise<AppiumElement>;
 /**
  * Gets an element attribute value.
+ * @param attribute - Name of the attribute to retrieve.
+ * @param elementId - ID of the element.
+ * @returns The attribute value as a string.
  */
 export declare function getAttribute(this: AndroidUiautomator2Driver, attribute: string, elementId: string): Promise<string>;
 /**
  * Returns whether the element is displayed.
+ * @param elementId - ID of the element.
+ * @returns True if the element is displayed, false otherwise.
  */
 export declare function elementDisplayed(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
  * Returns whether the element is enabled.
+ * @param elementId - ID of the element.
+ * @returns True if the element is enabled, false otherwise.
  */
 export declare function elementEnabled(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
  * Returns whether the element is selected.
+ * @param elementId - ID of the element.
+ * @returns True if the element is selected, false otherwise.
  */
 export declare function elementSelected(this: AndroidUiautomator2Driver, elementId: string): Promise<boolean>;
 /**
  * Gets the element tag name.
+ * @param elementId - ID of the element.
+ * @returns The element tag name.
  */
 export declare function getName(this: AndroidUiautomator2Driver, elementId: string): Promise<string>;
 /**
  * Gets the element location.
+ * @param elementId - ID of the element.
+ * @returns The element position coordinates (x, y).
  */
 export declare function getLocation(this: AndroidUiautomator2Driver, elementId: string): Promise<Position>;
 /**
  * Gets the element size.
+ * @param elementId - ID of the element.
+ * @returns The element size (width, height).
  */
 export declare function getSize(this: AndroidUiautomator2Driver, elementId: string): Promise<Size>;
 /**
  * Sets the value of an element using the upstream driver API.
+ * @param params - Options containing the element ID and value to set.
  */
 export declare function doSetElementValue(this: AndroidUiautomator2Driver, params: DoSetElementValueOpts): Promise<void>;
 /**
  * Sends text to an element without replacement.
+ * @param keys - Text to send, either as a string or array of strings (which will be joined).
+ * @param elementId - ID of the element.
  */
 export declare function setValueImmediate(this: AndroidUiautomator2Driver, keys: string | string[], elementId: string): Promise<void>;
 /**
  * Gets the element text.
+ * @param elementId - ID of the element.
+ * @returns The element text content.
  */
 export declare function getText(this: AndroidUiautomator2Driver, elementId: string): Promise<string>;
 /**
  * Clicks the given element.
+ * @param element - ID of the element to click.
  */
 export declare function click(this: AndroidUiautomator2Driver, element: string): Promise<void>;
 /**
  * Takes a screenshot of the element.
+ * @param element - ID of the element.
+ * @returns Base64-encoded PNG screenshot of the element.
  */
 export declare function getElementScreenshot(this: AndroidUiautomator2Driver, element: string): Promise<string>;
 /**
  * Clears the element text.
+ * @param elementId - ID of the element to clear.
  */
 export declare function clear(this: AndroidUiautomator2Driver, elementId: string): Promise<void>;
 /**
  * Gets the element rectangle.
+ * @param elementId - ID of the element.
+ * @returns The element rectangle (x, y, width, height).
  */
 export declare function getElementRect(this: AndroidUiautomator2Driver, elementId: string): Promise<Rect>;
 /**
  * Replaces the element text.
+ * @param elementId - ID of the element.
+ * @param text - Text to replace the current element value with.
  */
 export declare function mobileReplaceElementValue(this: AndroidUiautomator2Driver, elementId: string, text: string): Promise<void>;
 //# sourceMappingURL=element.d.ts.map