@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/PixelDiff.swift

@@ -0,0 +1,72 @@
+// Local file (not in upstream agent-device). Computes the fraction of
+// differing pixels between two UIImages by drawing each into a raw RGBA
+// byte buffer via CGContext and comparing those buffers directly. Used
+// by the idleCheck command to power waitForAnimationToEnd without
+// shipping two full PNGs back to the host.
+
+import Foundation
+#if canImport(UIKit)
+import UIKit
+#endif
+
+extension RunnerTests {
+  func computePixelDiffFraction(_ a: RunnerImage, _ b: RunnerImage) -> Double {
+    guard let cgA = runnerCGImage(from: a), let cgB = runnerCGImage(from: b) else {
+      return 1.0
+    }
+    let width = cgA.width
+    let height = cgA.height
+    guard width > 0, height > 0,
+          width == cgB.width, height == cgB.height else {
+      return 1.0
+    }
+
+    let bytesPerRow = width * 4
+    let totalBytes = bytesPerRow * height
+    var bufA = [UInt8](repeating: 0, count: totalBytes)
+    var bufB = [UInt8](repeating: 0, count: totalBytes)
+
+    let colorSpace = CGColorSpaceCreateDeviceRGB()
+    let bitmapInfo: UInt32 =
+      CGImageAlphaInfo.premultipliedLast.rawValue |
+      CGBitmapInfo.byteOrder32Big.rawValue
+
+    guard let ctxA = CGContext(
+      data: &bufA,
+      width: width,
+      height: height,
+      bitsPerComponent: 8,
+      bytesPerRow: bytesPerRow,
+      space: colorSpace,
+      bitmapInfo: bitmapInfo
+    ) else {
+      return 1.0
+    }
+    guard let ctxB = CGContext(
+      data: &bufB,
+      width: width,
+      height: height,
+      bitsPerComponent: 8,
+      bytesPerRow: bytesPerRow,
+      space: colorSpace,
+      bitmapInfo: bitmapInfo
+    ) else {
+      return 1.0
+    }
+    let rect = CGRect(x: 0, y: 0, width: width, height: height)
+    ctxA.draw(cgA, in: rect)
+    ctxB.draw(cgB, in: rect)
+
+    var differing = 0
+    let pixelCount = width * height
+    var i = 0
+    while i < totalBytes {
+      // Compare R, G, B (skip alpha).
+      if bufA[i] != bufB[i] || bufA[i + 1] != bufB[i + 1] || bufA[i + 2] != bufB[i + 2] {
+        differing += 1
+      }
+      i += 4
+    }
+    return Double(differing) / Double(pixelCount)
+  }
+}

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/PrivateHeaders/XCTest/XCPointerEventPath.h

@@ -0,0 +1,43 @@
+//
+//     Generated by class-dump 3.5 (64 bit).
+//
+//     class-dump is Copyright (C) 1997-1998, 2000-2001, 2004-2013 by Steve Nygard.
+//
+
+@class NSArray, NSMutableArray;
+
+@interface XCPointerEventPath : NSObject <NSSecureCoding>
+{
+    NSMutableArray *_pointerEvents;
+    BOOL _immutable;
+    unsigned long long _pathType;
+    unsigned long long _index;
+}
+@property BOOL immutable; // @synthesize immutable=_immutable;
+@property unsigned long long index; // @synthesize index=_index;
+@property(readonly) unsigned long long pathType; // @synthesize pathType=_pathType;
+@property(readonly) NSArray *pointerEvents;
+
+- (id)firstEventAfterOffset:(double)arg1;
+- (id)lastEventBeforeOffset:(double)arg1;
+- (void)_addPointerEvent:(id)arg1;
+- (void)releaseButton:(unsigned long long)arg1 atOffset:(double)arg2;
+- (void)pressButton:(unsigned long long)arg1 atOffset:(double)arg2;
+- (void)liftUpAtOffset:(double)arg1;
+- (void)moveToPoint:(struct CGPoint)arg1 atOffset:(double)arg2;
+- (void)pressDownWithPressure:(double)arg1 atOffset:(double)arg2;
+- (void)pressDownAtOffset:(double)arg1;
+- (id)initForMouseAtPoint:(struct CGPoint)arg1 offset:(double)arg2;
+- (id)initForTouchAtPoint:(CGPoint)arg1 offset:(double)arg2;
+// Since Xcode 10.2
+- (void)typeKey:(id)arg1 modifiers:(unsigned long long)arg2 atOffset:(double)arg3;
+// Since Xcode 12.beta5
+- (void)typeText:(id)arg1 atOffset:(double)arg2 typingSpeed:(unsigned long long)arg3 shouldRedact:(_Bool)arg4;
+// Since Xcode 10.2
+- (id)initForTextInput;
+// Since Xcode 10.2
+- (void)setModifiers:(unsigned long long)arg1 mergeWithCurrentModifierFlags:(_Bool)arg2 atOffset:(double)arg3;
+
+- (id)init;
+
+@end

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/PrivateHeaders/XCTest/XCSynthesizedEventRecord.h

@@ -0,0 +1,32 @@
+//
+//     Generated by class-dump 3.5 (64 bit).
+//
+//     class-dump is Copyright (C) 1997-1998, 2000-2001, 2004-2013 by Steve Nygard.
+//
+
+@class NSArray, NSMutableArray, NSString, XCPointerEventPath;
+
+@interface XCSynthesizedEventRecord : NSObject <NSSecureCoding>
+{
+    NSMutableArray *_eventPaths;
+    NSString *_name;
+#if !TARGET_OS_TV
+    UIInterfaceOrientation _interfaceOrientation;
+#endif
+}
+#if !TARGET_OS_TV
+@property(readonly) UIInterfaceOrientation interfaceOrientation; // @synthesize interfaceOrientation=_interfaceOrientation;
+#endif
+@property(readonly, copy) NSString *name; // @synthesize name=_name;
+@property(readonly) double maximumOffset;
+@property(readonly) NSArray *eventPaths;
+
+- (void)addPointerEventPath:(XCPointerEventPath *)arg1;
+#if !TARGET_OS_TV
+- (id)initWithName:(NSString *)arg1 interfaceOrientation:(UIInterfaceOrientation)arg2;
+#endif
+- (id)initWithName:(id)arg1;
+- (id)init;
+- (BOOL)synthesizeWithError:(NSError **)arg1;
+
+@end

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/PrivateHeaders/XCTest/XCUIApplication+ActiveApp.h

@@ -0,0 +1,23 @@
+// Private XCTest surface for frontmost-app detection, class-dump style
+// like the neighboring headers. The accessibility interface reports the
+// active applications' accessibility elements (with PIDs), and
+// XCUIApplication can be constructed from a PID — together they let the
+// runner target whatever is on screen when the caller names no bundle,
+// instead of activating its own placeholder host app. Same mechanism
+// WebDriverAgent has used across Xcode releases.
+
+#import <XCTest/XCTest.h>
+
+@interface XCAccessibilityElement : NSObject
+@property (readonly) pid_t processIdentifier;
+@end
+
+// Implemented by -[XCUIDevice accessibilityInterface] (XCUIAccessibilityInterface).
+@protocol DLAccessibilityActiveApps <NSObject>
+- (NSArray<XCAccessibilityElement *> *)activeApplications;
+@end
+
+// libproc: resolves a (simulator) process id to its executable path —
+// simulator processes are host processes, so the path leads to the .app
+// bundle and its Info.plist names the bundle identifier.
+int proc_pidpath(int pid, void *buffer, uint32_t buffersize);

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/PrivateHeaders/XCTest/XCUIDevice.h

@@ -0,0 +1,30 @@
+//
+//     Generated by class-dump 3.5 (64 bit).
+//
+//     class-dump is Copyright (C) 1997-1998, 2000-2001, 2004-2013 by Steve Nygard.
+//
+
+#import <XCTest/XCUIDevice.h>
+
+@interface XCUIDevice ()
+
+// Since Xcode 10.2
+@property (readonly) id accessibilityInterface; // implements XCUIAccessibilityInterface
+@property (readonly) id eventSynthesizer; // implements XCUIEventSynthesizing
+@property (readonly) id screenDataSource; // @synthesize screenDataSource=_screenDataSource;
+
+- (_Bool)performDeviceEvent:(id)arg1 error:(id *)arg2;
+
+// Since Xcode 13
+// 1 - Light
+// 2 - Dark
+- (void)setAppearanceMode:(long long)arg1;
+- (long long)appearanceMode;
+
+- (void)pressLockButton;
+- (void)holdHomeButtonForDuration:(double)arg1;
+- (void)_silentPressButton:(long long)arg1;
+// Since Xcode 11
+- (_Bool)supportsPressureInteraction;
+
+@end

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/RunnerObjCExceptionCatcher.h

@@ -0,0 +1,11 @@
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RunnerObjCExceptionCatcher : NSObject
+
++ (NSString * _Nullable)catchException:(NS_NOESCAPE dispatch_block_t)tryBlock;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/RunnerObjCExceptionCatcher.m

@@ -0,0 +1,16 @@
+#import "RunnerObjCExceptionCatcher.h"
+
+@implementation RunnerObjCExceptionCatcher
+
++ (NSString * _Nullable)catchException:(NS_NOESCAPE dispatch_block_t)tryBlock {
+  @try {
+    tryBlock();
+    return nil;
+  } @catch (NSException *exception) {
+    NSString *name = exception.name ?: @"NSException";
+    NSString *reason = exception.reason ?: @"Unhandled XCTest exception";
+    return [NSString stringWithFormat:@"%@: %@", name, reason];
+  }
+}
+
+@end

package/drivers/ios/DevicelabIOSRunner/DevicelabIOSRunnerUITests/RunnerTests+Alert.swift

@@ -0,0 +1,155 @@
+import XCTest
+
+extension RunnerTests {
+  struct RunnerAlert {
+    let root: XCUIElement
+    let ownerApp: XCUIApplication
+    let buttons: [XCUIElement]
+  }
+
+  func resolveAlert(app activeApp: XCUIApplication) -> RunnerAlert? {
+    if let alert = firstExistingElement(in: activeApp.alerts.allElementsBoundByIndex) {
+      return runnerAlert(root: alert, ownerApp: activeApp)
+    }
+    if let popup = firstDismissPopupWindow(in: activeApp) {
+      return runnerAlert(root: popup, ownerApp: activeApp)
+    }
+#if os(macOS)
+    return nil
+#else
+    if let systemModal = firstBlockingSystemModal(in: springboard) {
+      return runnerAlert(root: systemModal, ownerApp: springboard)
+    }
+    return nil
+#endif
+  }
+
+  func handleAlert(_ alert: RunnerAlert, action: String) -> Response {
+    if action == "accept" || action == "dismiss" {
+      guard let button = chooseAlertButton(alert.buttons, action: action) else {
+        return Response(ok: false, error: ErrorPayload(message: "alert \(action) button not found"))
+      }
+      let outcome = activateElement(app: alert.ownerApp, element: button, action: "alert \(action)")
+      if let response = unsupportedResponse(for: outcome) {
+        return response
+      }
+      return Response(ok: true, data: DataPayload(message: action == "accept" ? "accepted" : "dismissed"))
+    }
+
+    return Response(
+      ok: true,
+      data: DataPayload(
+        message: preferredAlertTitle(alert.root, buttons: alert.buttons),
+        items: alert.buttons.map { $0.label.trimmingCharacters(in: .whitespacesAndNewlines) }
+      )
+    )
+  }
+
+  private func runnerAlert(root: XCUIElement, ownerApp: XCUIApplication) -> RunnerAlert? {
+    let buttons = actionableElements(in: root).filter { isEnabledElement($0) }
+    guard !buttons.isEmpty else {
+      return nil
+    }
+    return RunnerAlert(root: root, ownerApp: ownerApp, buttons: buttons)
+  }
+
+  private func firstExistingElement(in elements: [XCUIElement]) -> XCUIElement? {
+    elements.first { isVisibleElement($0) }
+  }
+
+  private func firstDismissPopupWindow(in app: XCUIApplication) -> XCUIElement? {
+    safeElementsQuery {
+      app.windows.allElementsBoundByIndex
+    }.first { window in
+      if !isVisibleElement(window) { return false }
+      if isDismissPopupMarker(window.label) || isDismissPopupMarker(window.identifier) {
+        return true
+      }
+      return safeElementsQuery {
+        window.descendants(matching: .any).allElementsBoundByIndex
+      }.contains { descendant in
+        isDismissPopupMarker(descendant.label) || isDismissPopupMarker(descendant.identifier)
+      }
+    }
+  }
+
+  private func chooseAlertButton(_ buttons: [XCUIElement], action: String) -> XCUIElement? {
+    if action == "accept" {
+      if let accept = buttons.first(where: { isAcceptButton($0.label) }) {
+        return accept
+      }
+      return buttons.count == 1 && !isDismissButton(buttons[0].label) ? buttons[0] : nil
+    }
+
+    return buttons.first(where: { isDismissButton($0.label) }) ?? buttons.last
+  }
+
+  private func isAcceptButton(_ label: String) -> Bool {
+    let normalized = label.trimmingCharacters(in: .whitespacesAndNewlines).lowercased()
+    return [
+      "ok",
+      "allow",
+      "yes",
+      "continue",
+      "done",
+      "open settings"
+    ].contains(normalized) || normalized.hasPrefix("confirm")
+  }
+
+  private func isDismissButton(_ label: String) -> Bool {
+    [
+      "cancel",
+      "close",
+      "dismiss",
+      "don't allow",
+      "don’t allow",
+      "not now",
+      "no",
+      "keep browsing",
+      "later"
+    ].contains(label.trimmingCharacters(in: .whitespacesAndNewlines).lowercased())
+  }
+
+  private func preferredAlertTitle(_ element: XCUIElement, buttons: [XCUIElement]) -> String {
+    let buttonLabels = Set(buttons.map { $0.label.trimmingCharacters(in: .whitespacesAndNewlines).lowercased() })
+    let descendants = element.descendants(matching: .any).allElementsBoundByIndex
+    for descendant in descendants {
+      let text = descendant.label.trimmingCharacters(in: .whitespacesAndNewlines)
+      if text.isEmpty ||
+        isGenericAlertLabel(text) ||
+        buttonLabels.contains(text.lowercased()) ||
+        descendant.elementType == .navigationBar ||
+        actionableTypes.contains(descendant.elementType)
+      {
+        continue
+      }
+      return text
+    }
+    let label = element.label.trimmingCharacters(in: .whitespacesAndNewlines)
+    return label.isEmpty || isGenericAlertLabel(label) ? "Alert" : label
+  }
+
+  private func isGenericAlertLabel(_ label: String) -> Bool {
+    let normalized = label.trimmingCharacters(in: .whitespacesAndNewlines).lowercased()
+    return isDismissPopupMarker(normalized) ||
+      normalized.hasPrefix("vertical scroll bar") ||
+      normalized.hasPrefix("horizontal scroll bar") ||
+      normalized == "tab bar"
+  }
+
+  private func isVisibleElement(_ element: XCUIElement) -> Bool {
+    element.exists && !element.frame.isNull && !element.frame.isEmpty
+  }
+
+  private func isEnabledElement(_ element: XCUIElement) -> Bool {
+    var enabled = false
+    _ = RunnerObjCExceptionCatcher.catchException({
+      enabled = element.exists && element.isEnabled
+    })
+    return enabled
+  }
+
+  private func isDismissPopupMarker(_ label: String) -> Bool {
+    label.trimmingCharacters(in: .whitespacesAndNewlines).caseInsensitiveCompare("dismiss popup") == .orderedSame
+  }
+}