appium-xcuitest-driver 12.21.0 → 12.22.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [12.22.1](https://github.com/appium/appium-xcuitest-driver/compare/v12.22.0...v12.22.1) (2026-10-28)
+
+### Miscellaneous Chores
+
+* release to bump the dependency for shell quote ([6d988f1](https://github.com/appium/appium-xcuitest-driver/commit/6d988f1df3a6388545458bc55da75efb5309fb30))
+
+## [12.22.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.21.0...v12.22.0) (2026-10-27)
+
+### Features
+
+* route Duo simulator HID controls through the host ([#3077](https://github.com/appium/appium-xcuitest-driver/issues/3077)) ([32dae67](https://github.com/appium/appium-xcuitest-driver/commit/32dae673c5b93bdee2fc5c3fe57a45c02a0295b2))
+
 ## [12.21.0](https://github.com/appium/appium-xcuitest-driver/compare/v12.20.0...v12.21.0) (2026-10-26)
 
 ### Features

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

@@ -36,13 +36,13 @@ export declare function getDevicePixelRatio(this: XCUITestDriver): Promise<numbe
  * Reads the current hinge angle in degrees, including changes made outside WDA.
  * Requires a WDA build with GET /wda/device/hingeAngle support.
  * WDA checks platform, hinge and CoreMotion availability and waits up to five seconds for a valid reading.
- * Physical Duo behavior is unverified. A reading may reflect an intermediate angle during folding.
+ * A reading may reflect an intermediate angle during folding.
  */
 export declare function mobileGetSimulatedHingeAngle(this: XCUITestDriver): Promise<number>;
 /**
- * Requests a simulated hinge angle on an iOS device with an available hinge.
- * Requires a WDA build with /wda/device/hingeAngle support; WDA validates the angle and checks availability at runtime.
- * Tested only on the Duo simulator. Physical Duo behavior is unverified.
+ * Requests a simulated hinge angle through the host CoreSimulator HID service.
+ * Requires an iPhone Duo Simulator on Xcode 27+; CoreSimulator identifies the device type.
+ * WDA supplies hinge angle readings.
  * The transition completes asynchronously. Select currentDisplayId separately.
  *
  * @param angle - Degrees from 0 (closed) to 180 (fully open), inclusive.

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

@@ -1 +1 @@
-{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../lib/commands/display.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAElF;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAe7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAcrF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG/E;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAExF;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAErG"}
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../../lib/commands/display.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAElF;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,CAe7E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAcrF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAG/E;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAExF;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrG"}

package/build/lib/commands/display.js

@@ -1,3 +1,5 @@
+import { errors } from 'appium/driver.js';
+import { getDuoSimulator, withDuoArgumentErrors } from './helpers/duo.js';
 /**
  * Retrieves the viewport dimensions.
  *
@@ -70,20 +72,24 @@ export async function getDevicePixelRatio() {
  * Reads the current hinge angle in degrees, including changes made outside WDA.
  * Requires a WDA build with GET /wda/device/hingeAngle support.
  * WDA checks platform, hinge and CoreMotion availability and waits up to five seconds for a valid reading.
- * Physical Duo behavior is unverified. A reading may reflect an intermediate angle during folding.
+ * A reading may reflect an intermediate angle during folding.
  */
 export async function mobileGetSimulatedHingeAngle() {
     return await this.proxyCommand('/wda/device/hingeAngle', 'GET');
 }
 /**
- * Requests a simulated hinge angle on an iOS device with an available hinge.
- * Requires a WDA build with /wda/device/hingeAngle support; WDA validates the angle and checks availability at runtime.
- * Tested only on the Duo simulator. Physical Duo behavior is unverified.
+ * Requests a simulated hinge angle through the host CoreSimulator HID service.
+ * Requires an iPhone Duo Simulator on Xcode 27+; CoreSimulator identifies the device type.
+ * WDA supplies hinge angle readings.
  * The transition completes asynchronously. Select currentDisplayId separately.
  *
  * @param angle - Degrees from 0 (closed) to 180 (fully open), inclusive.
  */
 export async function mobileSetSimulatedHingeAngle(angle) {
-    await this.proxyCommand('/wda/device/hingeAngle', 'POST', { angle });
+    const simulator = await getDuoSimulator(this);
+    if (!simulator) {
+        throw new errors.UnsupportedOperationError('Setting the hinge angle requires an iPhone Duo Simulator on Xcode 27+');
+    }
+    await withDuoArgumentErrors(() => simulator.setSimulatedHingeAngle(angle));
 }
 //# sourceMappingURL=display.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../lib/commands/display.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,2EAA2E;IAC3E,0CAA0C;IAC1C,MAAM,EAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACtE,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAExD,2EAA2E;IAC3E,qEAAqE;IACrE,OAAO;QACL,IAAI,EAAE,CAAC;QACP,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,eAAe;KAC1D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAe,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAqB,CAAC;IACzF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;QACtE,EAAE,EAAE,SAAS;QACb,OAAO,EAAE;YACP,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,CAAC;YAChB,OAAO,EAAE,KAAK;YACd,MAAM;SACP;QACD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACnD,OAAO,aAAa,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAuB,KAAa;IACpF,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../../lib/commands/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC;AAGxC,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AAGxE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,2EAA2E;IAC3E,0CAA0C;IAC1C,MAAM,EAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACtE,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAExD,2EAA2E;IAC3E,qEAAqE;IACrE,OAAO;QACL,IAAI,EAAE,CAAC;QACP,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,eAAe;KAC1D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,KAAK,CAAC,CAAe,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAqB,CAAC;IACzF,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAC,EAAE,EAAE,CAAC,CAAC;QACtE,EAAE,EAAE,SAAS;QACb,OAAO,EAAE;YACP,WAAW,EAAE,MAAM,CAAC,KAAK;YACzB,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,MAAM,EAAE,MAAM,CAAC,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC,CAAC;YAChB,OAAO,EAAE,KAAK;YACd,MAAM;SACP;QACD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAC,aAAa,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACnD,OAAO,aAAa,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAuB,KAAa;IACpF,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,MAAM,CAAC,yBAAyB,CAAC,uEAAuE,CAAC,CAAC;IACtH,CAAC;IACD,MAAM,qBAAqB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC"}

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

@@ -77,7 +77,8 @@ export declare function mobileGetPressableButtons(this: XCUITestDriver): Promise
  *
  * This executes different methods based on the platform:
  *
- * - iOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
+ * - Duo simulator Home and volume buttons: host CoreSimulator HID.
+ * - Other iOS buttons/devices: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
  * - tvOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627475-pressbutton) or [`pressButton:forDuration:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627476-pressbutton)
  *
  * Use {@linkcode mobilePerformIoHidEvent} to call a more universal API to perform a button press with duration on any supported device.

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

@@ -1 +1 @@
-{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../../lib/commands/general.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAC,UAAU,EAAE,oBAAoB,EAAC,MAAM,YAAY,CAAC;AAIjE;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,SAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B3G;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,SAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjH;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExF;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlE;AAED;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF"}
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../../lib/commands/general.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAC,UAAU,EAAE,oBAAoB,EAAC,MAAM,YAAY,CAAC;AASjE;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/F;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,SAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B3G;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,SAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAEjH;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAExF;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAKlE;AAED;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEnG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,EAChB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzF"}

package/build/lib/commands/general.js

@@ -1,9 +1,16 @@
 import { errors } from 'appium/driver.js';
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
+import { getDuoSimulator, withDuoArgumentErrors } from './helpers/duo.js';
+import { HIDPageEvent, HIDUsageConsumerEvent } from './hid-event.js';
 dayjs.extend(utc);
 import { LockdownClient } from '../device/lockdown-client.js';
 const DATETIME_FORMAT_ISO8601 = 'YYYY-MM-DDTHH:mm:ssZ';
+const DUO_BUTTON_USAGES = new Map([
+    ['home', HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu],
+    ['volumeup', HIDUsageConsumerEvent.kHIDUsage_Csmr_VolumeIncrement],
+    ['volumedown', HIDUsageConsumerEvent.kHIDUsage_Csmr_VolumeDecrement],
+]);
 /**
  * Trigger a touch/fingerprint match or match failure.
  *
@@ -141,7 +148,8 @@ export async function mobileGetPressableButtons() {
  *
  * This executes different methods based on the platform:
  *
- * - iOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
+ * - Duo simulator Home and volume buttons: host CoreSimulator HID.
+ * - Other iOS buttons/devices: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
  * - tvOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627475-pressbutton) or [`pressButton:forDuration:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627476-pressbutton)
  *
  * Use {@linkcode mobilePerformIoHidEvent} to call a more universal API to perform a button press with duration on any supported device.
@@ -156,6 +164,15 @@ export async function mobilePressButton(name, durationSeconds) {
     if (durationSeconds != null && typeof durationSeconds !== 'number') {
         throw new errors.InvalidArgumentError('durationSeconds should be a number');
     }
+    const simulator = await getDuoSimulator(this);
+    if (simulator) {
+        const usage = DUO_BUTTON_USAGES.get(name.toLowerCase());
+        if (usage === undefined) {
+            throw new errors.UnsupportedOperationError(`Button '${name}' has no supported Duo simulator HID mapping`);
+        }
+        // Preserve iOS pressButton semantics: durationSeconds is a tvOS-only option.
+        return await withDuoArgumentErrors(() => simulator.pressHidButton(HIDPageEvent.kHIDPage_Consumer, usage));
+    }
     return await this.proxyCommand('/wda/pressButton', 'POST', { name, duration: durationSeconds });
 }
 /**

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

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

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

@@ -0,0 +1,7 @@
+import type { Simulator, SupportsDuo } from 'appium-ios-simulator';
+import type { XCUITestDriver } from '../../driver.js';
+/** Select Duo controls by device type, not hinge or multiple-display capability. */
+export declare function getDuoSimulator(driver: XCUITestDriver): Promise<(Simulator & SupportsDuo) | undefined>;
+/** Translate native argument validation at the simulator command boundary. */
+export declare function withDuoArgumentErrors(command: () => Promise<void>): Promise<void>;
+//# sourceMappingURL=duo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duo.d.ts","sourceRoot":"","sources":["../../../../lib/commands/helpers/duo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAE,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAEpD,oFAAoF;AACpF,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,SAAS,CAAC,CAY5G;AAED,8EAA8E;AAC9E,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF"}

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

@@ -0,0 +1,28 @@
+import { errors } from 'appium/driver.js';
+/** Select Duo controls by device type, not hinge or multiple-display capability. */
+export async function getDuoSimulator(driver) {
+    if (!driver.isSimulator() || ['tvos', 'watchos'].includes(String(driver.opts.platformName).toLowerCase())) {
+        return undefined;
+    }
+    const simulator = driver.device;
+    if (typeof simulator.isDuo !== 'function' || !(await simulator.isDuo())) {
+        return undefined;
+    }
+    if (typeof simulator.setSimulatedHingeAngle !== 'function') {
+        return undefined;
+    }
+    return simulator;
+}
+/** Translate native argument validation at the simulator command boundary. */
+export async function withDuoArgumentErrors(command) {
+    try {
+        await command();
+    }
+    catch (err) {
+        if (err instanceof TypeError) {
+            throw new errors.InvalidArgumentError(err.message);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=duo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duo.js","sourceRoot":"","sources":["../../../../lib/commands/helpers/duo.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC;AAIxC,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAsB;IAC1D,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAC1G,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAmB,CAAC;IAC7C,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QACxE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,sBAAsB,KAAK,UAAU,EAAE,CAAC;QAC3D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAoC,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAA4B;IACtE,IAAI,CAAC;QACH,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -4,6 +4,9 @@ import { HIDPageEvent } from './hid-event.js';
 /**
  * Emulates triggering of the given low-level IO HID device event.
  *
+ * Duo simulators use host CoreSimulator HID with native argument validation.
+ * Other devices use WDA/XCTest. Completion does not guarantee that the event was applied.
+ *
  * Popular constants:
  * - `kHIDPage_Consumer` = `0x0C`
  * - `kHIDUsage_Csmr_VolumeIncrement` = `0xE9` (Volume Up)

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

@@ -1 +1 @@
-{"version":3,"file":"iohid.d.ts","sourceRoot":"","sources":["../../../lib/commands/iohid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAIxD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,OAAO,EAAgB,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GAAG,MAAM,GAC/B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,aAAa,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyCf"}
+{"version":3,"file":"iohid.d.ts","sourceRoot":"","sources":["../../../lib/commands/iohid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AAIxD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAgB,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GAAG,MAAM,GAC/B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,aAAa,EACpB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EACjC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/build/lib/commands/iohid.js

@@ -1,10 +1,14 @@
 import { errors } from 'appium/driver.js';
 import { HidIndigoClient } from '../device/hid-indigo-client.js';
+import { getDuoSimulator, withDuoArgumentErrors } from './helpers/duo.js';
 import { requireRealDevice } from './helpers/index.js';
 import { HIDUsageEvent, HIDPageEvent } from './hid-event.js';
 /**
  * Emulates triggering of the given low-level IO HID device event.
  *
+ * Duo simulators use host CoreSimulator HID with native argument validation.
+ * Other devices use WDA/XCTest. Completion does not guarantee that the event was applied.
+ *
  * Popular constants:
  * - `kHIDPage_Consumer` = `0x0C`
  * - `kHIDUsage_Csmr_VolumeIncrement` = `0xE9` (Volume Up)
@@ -18,6 +22,11 @@ import { HIDUsageEvent, HIDPageEvent } from './hid-event.js';
  * @param durationSeconds - The event duration in float seconds (XCTest uses `0.005` for a single press event)
  */
 export async function mobilePerformIoHidEvent(page, usage, durationSeconds) {
+    const simulator = await getDuoSimulator(this);
+    if (simulator) {
+        const duration = typeof durationSeconds === 'string' ? parseFloat(durationSeconds) : durationSeconds;
+        return await withDuoArgumentErrors(() => simulator.pressHidButton(page, usage, duration));
+    }
     if (!isHIDPageEvent(page)) {
         throw new errors.InvalidArgumentError(`'page' argument must be a valid HIDPageEvent identifier`);
     }

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../lib/commands/lock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE"}
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../lib/commands/lock.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAIjD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE"}

package/build/lib/commands/lock.js

@@ -1,4 +1,8 @@
 import { setTimeout as delay } from 'node:timers/promises';
+import { errors } from 'appium/driver.js';
+import { waitForCondition } from 'asyncbox';
+import { getDuoSimulator } from './helpers/duo.js';
+import { HIDPageEvent, HIDUsageConsumerEvent } from './hid-event.js';
 /**
  * Lock the device (and optionally unlock the device after a certain amount of time)
  *
@@ -6,7 +10,7 @@ import { setTimeout as delay } from 'node:timers/promises';
  * @defaultValue 0
  */
 export async function lock(seconds) {
-    await this.proxyCommand('/wda/lock', 'POST');
+    await setLocked(this, true);
     if (isNaN(Number(seconds))) {
         return;
     }
@@ -15,13 +19,13 @@ export async function lock(seconds) {
         return;
     }
     await delay(floatSeconds * 1000);
-    await this.proxyCommand('/wda/unlock', 'POST');
+    await this.unlock();
 }
 /**
  * Unlock the device
  */
 export async function unlock() {
-    await this.proxyCommand('/wda/unlock', 'POST');
+    await setLocked(this, false);
 }
 /**
  * Determine whether the device is locked
@@ -31,4 +35,35 @@ export async function unlock() {
 export async function isLocked() {
     return await this.proxyCommand('/wda/locked', 'GET');
 }
+async function setLocked(driver, locked) {
+    const simulator = await getDuoSimulator(driver);
+    if (!simulator) {
+        await driver.proxyCommand(locked ? '/wda/lock' : '/wda/unlock', 'POST');
+        return;
+    }
+    if ((await driver.isLocked()) === locked) {
+        return;
+    }
+    await simulator.pressHidButton(HIDPageEvent.kHIDPage_Consumer, locked ? HIDUsageConsumerEvent.kHIDUsage_Csmr_Power : HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu);
+    const timeoutError = new errors.UnknownError(`Timed out waiting for the simulator to ${locked ? 'lock' : 'unlock'}`);
+    const waitForState = async (waitMs) => await waitForCondition(async () => (await driver.isLocked()) === locked, {
+        waitMs,
+        intervalMs: 100,
+        error: timeoutError,
+    });
+    if (!locked) {
+        try {
+            await waitForState(1000);
+            return;
+        }
+        catch (err) {
+            if (err !== timeoutError) {
+                throw err;
+            }
+        }
+        // A sleeping device may need a second Home press after waking.
+        await simulator.pressHidButton(HIDPageEvent.kHIDPage_Consumer, HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu);
+    }
+    await waitForState(locked ? 5000 : 4000);
+}
 //# sourceMappingURL=lock.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../lib/commands/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,IAAI,KAAK,EAAC,MAAM,sBAAsB,CAAC;AAIzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAuB,OAAyB;IACxE,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAe,aAAa,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../lib/commands/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,IAAI,KAAK,EAAC,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAC,MAAM,EAAC,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAC,gBAAgB,EAAC,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAC,YAAY,EAAE,qBAAqB,EAAC,MAAM,gBAAgB,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAuB,OAAyB;IACxE,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,MAAM,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAe,aAAa,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,MAAsB,EAAE,MAAe;IAC9D,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACxE,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO;IACT,CAAC;IACD,MAAM,SAAS,CAAC,cAAc,CAC5B,YAAY,CAAC,iBAAiB,EAC9B,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC,qBAAqB,CAAC,mBAAmB,CAChG,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,0CAA0C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrH,MAAM,YAAY,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE,CAC5C,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,EAAE;QACvE,MAAM;QACN,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,YAAY;KACpB,CAAC,CAAC;IACL,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;gBACzB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACD,+DAA+D;QAC/D,MAAM,SAAS,CAAC,cAAc,CAAC,YAAY,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;IAC5G,CAAC;IACD,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/lib/commands/display.ts

@@ -1,4 +1,7 @@
+import {errors} from 'appium/driver.js';
+
 import type {XCUITestDriver} from '../driver.js';
+import {getDuoSimulator, withDuoArgumentErrors} from './helpers/duo.js';
 import type {Viewport, ScreenInfo, DisplayInfo, WDADisplayInfo} from './types.js';
 
 /**
@@ -79,20 +82,24 @@ export async function getDevicePixelRatio(this: XCUITestDriver): Promise<number>
  * Reads the current hinge angle in degrees, including changes made outside WDA.
  * Requires a WDA build with GET /wda/device/hingeAngle support.
  * WDA checks platform, hinge and CoreMotion availability and waits up to five seconds for a valid reading.
- * Physical Duo behavior is unverified. A reading may reflect an intermediate angle during folding.
+ * A reading may reflect an intermediate angle during folding.
  */
 export async function mobileGetSimulatedHingeAngle(this: XCUITestDriver): Promise<number> {
   return await this.proxyCommand('/wda/device/hingeAngle', 'GET');
 }
 
 /**
- * Requests a simulated hinge angle on an iOS device with an available hinge.
- * Requires a WDA build with /wda/device/hingeAngle support; WDA validates the angle and checks availability at runtime.
- * Tested only on the Duo simulator. Physical Duo behavior is unverified.
+ * Requests a simulated hinge angle through the host CoreSimulator HID service.
+ * Requires an iPhone Duo Simulator on Xcode 27+; CoreSimulator identifies the device type.
+ * WDA supplies hinge angle readings.
  * The transition completes asynchronously. Select currentDisplayId separately.
  *
  * @param angle - Degrees from 0 (closed) to 180 (fully open), inclusive.
  */
 export async function mobileSetSimulatedHingeAngle(this: XCUITestDriver, angle: number): Promise<void> {
-  await this.proxyCommand('/wda/device/hingeAngle', 'POST', {angle});
+  const simulator = await getDuoSimulator(this);
+  if (!simulator) {
+    throw new errors.UnsupportedOperationError('Setting the hinge angle requires an iPhone Duo Simulator on Xcode 27+');
+  }
+  await withDuoArgumentErrors(() => simulator.setSimulatedHingeAngle(angle));
 }

package/lib/commands/general.ts

@@ -3,6 +3,9 @@ import {errors} from 'appium/driver.js';
 import dayjs from 'dayjs';
 import utc from 'dayjs/plugin/utc.js';
 
+import {getDuoSimulator, withDuoArgumentErrors} from './helpers/duo.js';
+import {HIDPageEvent, HIDUsageConsumerEvent} from './hid-event.js';
+
 dayjs.extend(utc);
 
 import {LockdownClient} from '../device/lockdown-client.js';
@@ -10,6 +13,11 @@ import type {XCUITestDriver} from '../driver.js';
 import type {ButtonName, PressableButtonsInfo} from './types.js';
 
 const DATETIME_FORMAT_ISO8601 = 'YYYY-MM-DDTHH:mm:ssZ';
+const DUO_BUTTON_USAGES = new Map<string, HIDUsageConsumerEvent>([
+  ['home', HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu],
+  ['volumeup', HIDUsageConsumerEvent.kHIDUsage_Csmr_VolumeIncrement],
+  ['volumedown', HIDUsageConsumerEvent.kHIDUsage_Csmr_VolumeDecrement],
+]);
 
 /**
  * Trigger a touch/fingerprint match or match failure.
@@ -164,7 +172,8 @@ export async function mobileGetPressableButtons(this: XCUITestDriver): Promise<P
  *
  * This executes different methods based on the platform:
  *
- * - iOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
+ * - Duo simulator Home and volume buttons: host CoreSimulator HID.
+ * - Other iOS buttons/devices: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuidevice/1619052-pressbutton)
  * - tvOS: [`pressButton:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627475-pressbutton) or [`pressButton:forDuration:`](https://developer.apple.com/documentation/xctest/xcuiremote/1627476-pressbutton)
  *
  * Use {@linkcode mobilePerformIoHidEvent} to call a more universal API to perform a button press with duration on any supported device.
@@ -183,6 +192,15 @@ export async function mobilePressButton(
   if (durationSeconds != null && typeof durationSeconds !== 'number') {
     throw new errors.InvalidArgumentError('durationSeconds should be a number');
   }
+  const simulator = await getDuoSimulator(this);
+  if (simulator) {
+    const usage = DUO_BUTTON_USAGES.get(name.toLowerCase());
+    if (usage === undefined) {
+      throw new errors.UnsupportedOperationError(`Button '${name}' has no supported Duo simulator HID mapping`);
+    }
+    // Preserve iOS pressButton semantics: durationSeconds is a tvOS-only option.
+    return await withDuoArgumentErrors(() => simulator.pressHidButton(HIDPageEvent.kHIDPage_Consumer, usage));
+  }
   return await this.proxyCommand('/wda/pressButton', 'POST', {name, duration: durationSeconds});
 }
 

package/lib/commands/helpers/duo.ts

@@ -0,0 +1,31 @@
+import type {Simulator, SupportsDuo} from 'appium-ios-simulator';
+import {errors} from 'appium/driver.js';
+
+import type {XCUITestDriver} from '../../driver.js';
+
+/** Select Duo controls by device type, not hinge or multiple-display capability. */
+export async function getDuoSimulator(driver: XCUITestDriver): Promise<(Simulator & SupportsDuo) | undefined> {
+  if (!driver.isSimulator() || ['tvos', 'watchos'].includes(String(driver.opts.platformName).toLowerCase())) {
+    return undefined;
+  }
+  const simulator = driver.device as Simulator;
+  if (typeof simulator.isDuo !== 'function' || !(await simulator.isDuo())) {
+    return undefined;
+  }
+  if (typeof simulator.setSimulatedHingeAngle !== 'function') {
+    return undefined;
+  }
+  return simulator as Simulator & SupportsDuo;
+}
+
+/** Translate native argument validation at the simulator command boundary. */
+export async function withDuoArgumentErrors(command: () => Promise<void>): Promise<void> {
+  try {
+    await command();
+  } catch (err) {
+    if (err instanceof TypeError) {
+      throw new errors.InvalidArgumentError(err.message);
+    }
+    throw err;
+  }
+}

package/lib/commands/iohid.ts

@@ -3,12 +3,16 @@ import {errors} from 'appium/driver.js';
 
 import {HidIndigoClient} from '../device/hid-indigo-client.js';
 import type {XCUITestDriver} from '../driver.js';
+import {getDuoSimulator, withDuoArgumentErrors} from './helpers/duo.js';
 import {requireRealDevice} from './helpers/index.js';
 import {HIDUsageEvent, HIDPageEvent} from './hid-event.js';
 
 /**
  * Emulates triggering of the given low-level IO HID device event.
  *
+ * Duo simulators use host CoreSimulator HID with native argument validation.
+ * Other devices use WDA/XCTest. Completion does not guarantee that the event was applied.
+ *
  * Popular constants:
  * - `kHIDPage_Consumer` = `0x0C`
  * - `kHIDUsage_Csmr_VolumeIncrement` = `0xE9` (Volume Up)
@@ -27,6 +31,11 @@ export async function mobilePerformIoHidEvent(
   usage: number,
   durationSeconds: number | string,
 ): Promise<void> {
+  const simulator = await getDuoSimulator(this);
+  if (simulator) {
+    const duration = typeof durationSeconds === 'string' ? parseFloat(durationSeconds) : durationSeconds;
+    return await withDuoArgumentErrors(() => simulator.pressHidButton(page, usage, duration));
+  }
   if (!isHIDPageEvent(page)) {
     throw new errors.InvalidArgumentError(`'page' argument must be a valid HIDPageEvent identifier`);
   }

package/lib/commands/lock.ts

@@ -1,6 +1,11 @@
 import {setTimeout as delay} from 'node:timers/promises';
 
+import {errors} from 'appium/driver.js';
+import {waitForCondition} from 'asyncbox';
+
 import type {XCUITestDriver} from '../driver.js';
+import {getDuoSimulator} from './helpers/duo.js';
+import {HIDPageEvent, HIDUsageConsumerEvent} from './hid-event.js';
 
 /**
  * Lock the device (and optionally unlock the device after a certain amount of time)
@@ -9,7 +14,7 @@ import type {XCUITestDriver} from '../driver.js';
  * @defaultValue 0
  */
 export async function lock(this: XCUITestDriver, seconds?: number | string): Promise<void> {
-  await this.proxyCommand('/wda/lock', 'POST');
+  await setLocked(this, true);
   if (isNaN(Number(seconds))) {
     return;
   }
@@ -20,14 +25,14 @@ export async function lock(this: XCUITestDriver, seconds?: number | string): Pro
   }
 
   await delay(floatSeconds * 1000);
-  await this.proxyCommand('/wda/unlock', 'POST');
+  await this.unlock();
 }
 
 /**
  * Unlock the device
  */
 export async function unlock(this: XCUITestDriver): Promise<void> {
-  await this.proxyCommand('/wda/unlock', 'POST');
+  await setLocked(this, false);
 }
 
 /**
@@ -38,3 +43,38 @@ export async function unlock(this: XCUITestDriver): Promise<void> {
 export async function isLocked(this: XCUITestDriver): Promise<boolean> {
   return await this.proxyCommand<any, boolean>('/wda/locked', 'GET');
 }
+
+async function setLocked(driver: XCUITestDriver, locked: boolean): Promise<void> {
+  const simulator = await getDuoSimulator(driver);
+  if (!simulator) {
+    await driver.proxyCommand(locked ? '/wda/lock' : '/wda/unlock', 'POST');
+    return;
+  }
+  if ((await driver.isLocked()) === locked) {
+    return;
+  }
+  await simulator.pressHidButton(
+    HIDPageEvent.kHIDPage_Consumer,
+    locked ? HIDUsageConsumerEvent.kHIDUsage_Csmr_Power : HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu,
+  );
+  const timeoutError = new errors.UnknownError(`Timed out waiting for the simulator to ${locked ? 'lock' : 'unlock'}`);
+  const waitForState = async (waitMs: number) =>
+    await waitForCondition(async () => (await driver.isLocked()) === locked, {
+      waitMs,
+      intervalMs: 100,
+      error: timeoutError,
+    });
+  if (!locked) {
+    try {
+      await waitForState(1000);
+      return;
+    } catch (err) {
+      if (err !== timeoutError) {
+        throw err;
+      }
+    }
+    // A sleeping device may need a second Home press after waking.
+    await simulator.pressHidButton(HIDPageEvent.kHIDPage_Consumer, HIDUsageConsumerEvent.kHIDUsage_Csmr_Menu);
+  }
+  await waitForState(locked ? 5000 : 4000);
+}

package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.d.ts

@@ -0,0 +1,12 @@
+type BidiSubscriptionDriver = {
+    bidiEventSubs: Record<string, string[]>;
+};
+type Subscriptions = Map<string, Map<string, string[]>>;
+/** Get (or lazily create) the subscription registry of the given driver */
+export declare function getSubscriptions(driver: object): Subscriptions;
+/** Recompute `bidiEventSubs` as the union of all registered subscriptions */
+export declare function refreshEventSubscriptions(driver: BidiSubscriptionDriver): void;
+/** Forget all subscriptions, e.g. when the session ends */
+export declare function clearBidiSubscriptions(driver: BidiSubscriptionDriver): void;
+export {};
+//# sourceMappingURL=bidi-subscriptions.d.ts.map

package/node_modules/@appium/base-driver/build/lib/basedriver/commands/bidi-subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidi-subscriptions.d.ts","sourceRoot":"","sources":["../../../../lib/basedriver/commands/bidi-subscriptions.ts"],"names":[],"mappings":"AAEA,KAAK,sBAAsB,GAAG;IAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAC,CAAC;AAGxE,KAAK,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAIxD,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAO9D;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAS9E;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAG3E"}