@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.h

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBXCElementSnapshot.h"
+#import "FBElement.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBXCElementSnapshotWrapper : NSObject<FBXCElementSnapshot>
+
+/*!Wrapped snapshot instance */
+@property (nonatomic, readonly) id<FBXCElementSnapshot> snapshot;
+
+/**
+ Wraps the given snapshot.. If the given snapshot is already wrapped then the result remains unchanged.
+ 
+ @param snapshot snapshot instance to wrap
+ @returns wrapper instance
+ */
++ (nullable instancetype)ensureWrapped:(nullable id<FBXCElementSnapshot>)snapshot;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Routing/FBXCElementSnapshotWrapper.m

@@ -0,0 +1,114 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBXCElementSnapshotWrapper.h"
+
+#import "FBElementUtils.h"
+
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wobjc-protocol-property-synthesis"
+#pragma clang diagnostic ignored "-Wprotocol"
+
+@implementation FBXCElementSnapshotWrapper
+
+- (instancetype)initWithSnapshot:(id<FBXCElementSnapshot>)snapshot;
+{
+  self->_snapshot = snapshot;
+  return self;
+}
+
++ (instancetype)ensureWrapped:(id<FBXCElementSnapshot>)snapshot
+{
+  if (nil == snapshot) {
+    return nil;
+  }
+  return [(NSObject *)snapshot isKindOfClass:self.class]
+    ? (FBXCElementSnapshotWrapper *)snapshot
+    : [[FBXCElementSnapshotWrapper alloc] initWithSnapshot:snapshot];
+}
+
+// Attributes are queried most often,
+// so we prefer them to have direct accessors defined here
+// rather than to use message forwarding via forwardingTargetForSelector,
+// which is slow
+
+- (NSString *)identifier
+{
+  return self.snapshot.identifier;
+}
+
+- (CGRect)frame
+{
+  return self.snapshot.frame;
+}
+
+- (id)value
+{
+  return self.snapshot.value;
+}
+
+- (NSString *)title
+{
+  return self.snapshot.title;
+}
+
+- (NSString *)label
+{
+  return self.snapshot.label;
+}
+
+- (XCUIElementType)elementType
+{
+  return self.snapshot.elementType;
+}
+
+- (BOOL)isEnabled
+{
+  return self.snapshot.enabled;
+}
+
+- (XCUIUserInterfaceSizeClass)horizontalSizeClass
+{
+  return self.snapshot.horizontalSizeClass;
+}
+
+- (XCUIUserInterfaceSizeClass)verticalSizeClass
+{
+  return self.snapshot.verticalSizeClass;
+}
+
+- (NSString *)placeholderValue
+{
+  return self.snapshot.placeholderValue;
+}
+
+- (BOOL)isSelected
+{
+  return self.snapshot.selected;
+}
+
+#if !TARGET_OS_OSX
+- (BOOL)hasFocus
+{
+  return self.snapshot.hasFocus;
+}
+#endif
+
+- (id)forwardingTargetForSelector:(SEL)aSelector
+{
+  static dispatch_once_t onceToken;
+  static NSSet<NSString *> *names;
+  dispatch_once(&onceToken, ^{
+    names = [FBElementUtils selectorNamesWithProtocol:@protocol(FBXCElementSnapshot)];
+  });
+  return [names containsObject:NSStringFromSelector(aSelector)] ? self.snapshot : nil;
+}
+
+@end
+
+#pragma clang diagnostic pop

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBAccessibilityTraits.h

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Converts accessibility traits bitmask to an array of string representations
+ @param traits The accessibility traits bitmask
+ @return Array of strings representing the accessibility traits
+ */
+NSArray<NSString *> *FBAccessibilityTraitsToStringsArray(unsigned long long traits);
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBAccessibilityTraits.m

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBAccessibilityTraits.h"
+
+NSArray<NSString *> *FBAccessibilityTraitsToStringsArray(unsigned long long traits) {
+    NSMutableArray<NSString *> *traitStringsArray;
+    NSNumber *key;
+    
+    static NSDictionary<NSNumber *, NSString *> *traitsMapping;
+    static dispatch_once_t onceToken;
+
+    dispatch_once(&onceToken, ^{
+        NSMutableDictionary<NSNumber *, NSString *> *mapping = [@{
+            @(UIAccessibilityTraitNone): @"None",
+            @(UIAccessibilityTraitButton): @"Button",
+            @(UIAccessibilityTraitLink): @"Link",
+            @(UIAccessibilityTraitHeader): @"Header",
+            @(UIAccessibilityTraitSearchField): @"SearchField",
+            @(UIAccessibilityTraitImage): @"Image",
+            @(UIAccessibilityTraitSelected): @"Selected",
+            @(UIAccessibilityTraitPlaysSound): @"PlaysSound",
+            @(UIAccessibilityTraitKeyboardKey): @"KeyboardKey",
+            @(UIAccessibilityTraitStaticText): @"StaticText",
+            @(UIAccessibilityTraitSummaryElement): @"SummaryElement",
+            @(UIAccessibilityTraitNotEnabled): @"NotEnabled",
+            @(UIAccessibilityTraitUpdatesFrequently): @"UpdatesFrequently",
+            @(UIAccessibilityTraitStartsMediaSession): @"StartsMediaSession",
+            @(UIAccessibilityTraitAdjustable): @"Adjustable",
+            @(UIAccessibilityTraitAllowsDirectInteraction): @"AllowsDirectInteraction",
+            @(UIAccessibilityTraitCausesPageTurn): @"CausesPageTurn",
+            @(UIAccessibilityTraitTabBar): @"TabBar"
+        } mutableCopy];
+        
+        #if __clang_major__ >= 16
+        // Add iOS 17.0 specific traits if available
+        if (@available(iOS 17.0, *)) {
+            [mapping addEntriesFromDictionary:@{
+                @(UIAccessibilityTraitToggleButton): @"ToggleButton",
+                @(UIAccessibilityTraitSupportsZoom): @"SupportsZoom"
+            }];
+        }
+        #endif
+        
+        traitsMapping = [mapping copy];
+    });
+
+    traitStringsArray = [NSMutableArray array];
+    for (key in traitsMapping) {
+      if (traits & [key unsignedLongLongValue] && nil != traitsMapping[key]) {
+        [traitStringsArray addObject:(id)traitsMapping[key]];
+      }
+    }
+
+    return [traitStringsArray copy];
+}

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.h

@@ -0,0 +1,56 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+@protocol FBXCAccessibilityElement;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBActiveAppDetectionPoint : NSObject
+
+@property (nonatomic) CGPoint coordinates;
+
+/**
+ * Retrieves singleton representation of the current class
+ */
++ (instancetype)sharedInstance;
+
+/**
+ * Calculates the accessbility element which is located at the given screen coordinates
+ *
+ * @param point The screen coordinates
+ * @returns The retrieved accessbility element or nil if it cannot be detected
+ */
++ (nullable id<FBXCAccessibilityElement>)axElementWithPoint:(CGPoint)point;
+
+/**
+ * Retrieves the accessbility element for the current screen point
+ *
+ * @returns The retrieved accessbility element or nil if it cannot be detected
+ */
+- (nullable id<FBXCAccessibilityElement>)axElement;
+
+/**
+ * Sets the coordinates for the current screen point
+ *
+ * @param coordinatesStr The coordinates string in `x,y` format. x and y can be any float numbers
+ * @param error Is assigned to the actual error object if coordinates cannot be set
+ * @returns YES if the coordinates were successfully set
+ */
+- (BOOL)setCoordinatesWithString:(NSString *)coordinatesStr error:(NSError **)error;
+
+/**
+ * Retrieves the coordinates of the current screen point in string representation
+ *
+ * @returns Point coordinates as `x,y` string
+ */
+- (NSString *)stringCoordinates;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBActiveAppDetectionPoint.m

@@ -0,0 +1,87 @@
+/**
+* Copyright (c) 2015-present, Facebook, Inc.
+* All rights reserved.
+*
+* This source code is licensed under the BSD-style license found in the
+* LICENSE file in the root directory of this source tree.
+*/
+
+#import "FBActiveAppDetectionPoint.h"
+
+#import "FBErrorBuilder.h"
+#import "FBLogger.h"
+#import "FBXCTestDaemonsProxy.h"
+#import "XCTestManager_ManagerInterface-Protocol.h"
+
+@implementation FBActiveAppDetectionPoint
+
+- (instancetype)init {
+  if ((self = [super init])) {
+    CGSize screenSize = [UIScreen mainScreen].bounds.size;
+    // Consider the element, which is located close to the top left corner of the screen the on-screen one.
+    CGFloat pointDistance = MIN(screenSize.width, screenSize.height) * (CGFloat) 0.2;
+    _coordinates = CGPointMake(pointDistance, pointDistance);
+  }
+  return self;
+}
+
++ (instancetype)sharedInstance
+{
+  static FBActiveAppDetectionPoint *instance;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    instance = [[self alloc] init];
+  });
+  return instance;
+}
+
++ (id<FBXCAccessibilityElement>)axElementWithPoint:(CGPoint)point
+{
+  __block id<FBXCAccessibilityElement> onScreenElement = nil;
+  id<XCTestManager_ManagerInterface> proxy = [FBXCTestDaemonsProxy testRunnerProxy];
+  dispatch_semaphore_t sem = dispatch_semaphore_create(0);
+  [proxy _XCT_requestElementAtPoint:point
+                              reply:^(id element, NSError *error) {
+                                if (nil == error) {
+                                  onScreenElement = element;
+                                } else {
+                                  [FBLogger logFmt:@"Cannot request the screen point at %@", NSStringFromCGPoint(point)];
+                                }
+                                dispatch_semaphore_signal(sem);
+                              }];
+  dispatch_semaphore_wait(sem, dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.3 * NSEC_PER_SEC)));
+  return onScreenElement;
+}
+
+- (id<FBXCAccessibilityElement>)axElement
+{
+  return [self.class axElementWithPoint:self.coordinates];
+}
+
+- (BOOL)setCoordinatesWithString:(NSString *)coordinatesStr error:(NSError **)error
+{
+  NSArray<NSString *> *screenPointCoords = [coordinatesStr componentsSeparatedByString:@","];
+  if (screenPointCoords.count != 2) {
+    return [[[FBErrorBuilder builder]
+             withDescriptionFormat:@"The screen point coordinates should be separated by a single comma character. Got '%@' instead", coordinatesStr]
+            buildError:error];
+  }
+  NSString *strX = [screenPointCoords.firstObject stringByTrimmingCharactersInSet:
+                    NSCharacterSet.whitespaceAndNewlineCharacterSet];
+  NSString *strY = [screenPointCoords.lastObject stringByTrimmingCharactersInSet:
+                    NSCharacterSet.whitespaceAndNewlineCharacterSet];
+  if (0 == strX.length || 0 == strY.length) {
+    return [[[FBErrorBuilder builder]
+             withDescriptionFormat:@"Both screen point coordinates should be valid numbers. Got '%@' instead", coordinatesStr]
+            buildError:error];
+  }
+  self.coordinates = CGPointMake((CGFloat) strX.doubleValue, (CGFloat) strY.doubleValue);
+  return YES;
+}
+
+- (NSString *)stringCoordinates
+{
+  return [NSString stringWithFormat:@"%.2f,%.2f", self.coordinates.x, self.coordinates.y];
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBAlertsMonitor.h

@@ -0,0 +1,51 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import <XCTest/XCTest.h>
+
+@class FBAlert, XCUIApplication;
+
+NS_ASSUME_NONNULL_BEGIN
+
+@protocol FBAlertsMonitorDelegate
+
+/**
+ The callback which is invoked when an unexpected on-screen alert is shown
+
+ @param alert The instance of the current alert
+ */
+- (void)didDetectAlert:(FBAlert *)alert;
+
+@end
+
+@interface FBAlertsMonitor : NSObject
+
+/*! The delegate which decides on what to do when an alert is detected  */
+@property (nonatomic, nullable, weak) id<FBAlertsMonitorDelegate> delegate;
+
+/**
+ Creates an instance of alerts monitor.
+ The monitoring is done on the main thread and is disabled unless `enable` is called.
+
+ @return Alerts monitor instance
+ */
+- (instancetype)init;
+
+/**
+ Enables alerts monitoring
+ */
+- (void)enable;
+
+/**
+ Disables alerts monitoring
+ */
+- (void)disable;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBAlertsMonitor.m

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBAlertsMonitor.h"
+
+#import "FBAlert.h"
+#import "FBLogger.h"
+#import "XCUIApplication+FBAlert.h"
+#import "XCUIApplication+FBHelpers.h"
+
+static const NSTimeInterval FB_MONTORING_INTERVAL = 2.0;
+
+@interface FBAlertsMonitor()
+
+@property (atomic) BOOL isMonitoring;
+
+@end
+
+@implementation FBAlertsMonitor
+
+- (instancetype)init
+{
+  if ((self = [super init])) {
+    _isMonitoring = NO;
+    _delegate = nil;
+  }
+  return self;
+}
+
+- (void)scheduleNextTick
+{
+  if (!self.isMonitoring) {
+    return;
+  }
+
+  dispatch_time_t delta = (int64_t)(FB_MONTORING_INTERVAL * NSEC_PER_SEC);
+
+  if (nil == self.delegate) {
+    dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delta), dispatch_get_main_queue(), ^{
+      [self scheduleNextTick];
+    });
+    return;
+  }
+
+  dispatch_async(dispatch_get_main_queue(), ^{
+    NSArray<XCUIApplication *> *activeApps = XCUIApplication.fb_activeApplications;
+    for (XCUIApplication *activeApp in activeApps) {
+      XCUIElement *alertElement = nil;
+      @try {
+        alertElement = activeApp.fb_alertElement;
+        if (nil != alertElement) {
+          [self.delegate didDetectAlert:[FBAlert alertWithElement:alertElement]];
+        }
+      } @catch (NSException *e) {
+        [FBLogger logFmt:@"Got an unexpected exception while monitoring alerts: %@\n%@", e.reason, e.callStackSymbols];
+      }
+      if (nil != alertElement) {
+        break;
+      }
+    }
+
+    if (self.isMonitoring) {
+      dispatch_after(dispatch_time(DISPATCH_TIME_NOW, delta), dispatch_get_main_queue(), ^{
+        [self scheduleNextTick];
+      });
+    }
+  });
+}
+
+- (void)enable
+{
+  if (self.isMonitoring) {
+    return;
+  }
+
+  self.isMonitoring = YES;
+  [self scheduleNextTick];
+}
+
+- (void)disable
+{
+  if (!self.isMonitoring) {
+    return;
+  }
+
+  self.isMonitoring = NO;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBBaseActionsSynthesizer.h

@@ -0,0 +1,131 @@
+/**
+ * Copyright (c) 2015-present, Facebook, Inc.
+ * All rights reserved.
+ *
+ * This source code is licensed under the BSD-style license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "FBElementCache.h"
+#import "FBXCElementSnapshot.h"
+#import "XCUIApplication.h"
+#import "XCSynthesizedEventRecord.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+#if !TARGET_OS_TV
+@interface FBBaseActionItem : NSObject
+
+/*! Raw JSON representation of the corresponding action item */
+@property (nonatomic) NSDictionary<NSString *, id> *actionItem;
+/*! Current application instance */
+@property (nonatomic) XCUIApplication *application;
+/*! Action offset in the chain in milliseconds */
+@property (nonatomic) double offset;
+
+/**
+ Get the name of the corresponding raw action item. This method is expected to be overriden in subclasses.
+ 
+ @return The corresponding action item key in object's raw JSON reprsentation
+ */
++ (NSString *)actionName;
+
+/**
+ Add the current gesture to XCPointerEventPath instance. This method is expected to be overriden in subclasses.
+ 
+ @param eventPath The destination XCPointerEventPath instance. If nil value is passed then a new XCPointerEventPath instance is going to be created
+ @param allItems The existing actions chain to be transformed into event path
+ @param currentItemIndex The index of the current item in allItems array
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return the constructed XCPointerEventPath instance or nil in case of failure
+ */
+- (nullable NSArray<XCPointerEventPath *> *)addToEventPath:(nullable XCPointerEventPath *)eventPath
+                                                  allItems:(NSArray *)allItems
+                                          currentItemIndex:(NSUInteger)currentItemIndex
+                                                     error:(NSError **)error;
+
+@end
+
+
+@interface FBBaseGestureItem : FBBaseActionItem
+
+/*! Absolute position on the screen where the gesure should be performed */
+@property (nonatomic) XCUICoordinate *atPosition;
+/*! Gesture duration in milliseconds */
+@property (nonatomic) double duration;
+
+/**
+ Calculate absolute gesture position on the screen based on provided element and positionOffset values.
+
+ @param element The element instance to perform the gesture on. If element equals to nil then positionOffset is considered as absolute coordinates
+ @param positionOffset The actual coordinate offset. If this calue equals to nil then element's hitpoint is taken as gesture position. If element is not nil then this offset is calculated relatively to the top-left cordner of the element's position
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return Adbsolute gesture position on the screen or nil if the calculation fails (for example, the element is invisible)
+ */
+- (nullable XCUICoordinate *)hitpointWithElement:(nullable XCUIElement *)element
+                                  positionOffset:(nullable NSValue *)positionOffset
+                                           error:(NSError **)error;
+
+@end
+
+
+@interface FBBaseActionItemsChain : NSObject
+
+/*! All gesture items collected in the chain */
+@property (readonly, nonatomic) NSMutableArray *items;
+/*! Total length of all the gestures in the chain in milliseconds */
+@property (nonatomic) double durationOffset;
+
+/**
+ Add a new gesture item to the current chain. The method is expected to be overriden in subclasses.
+ 
+ @param item The actual gesture instance to be added
+ */
+- (void)addItem:(FBBaseActionItem *)item;
+
+/**
+ Represents the chain as XCPointerEventPath instance.
+ 
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return The constructed array of XCPointerEventPath instances or nil if there was a failure
+ */
+- (nullable NSArray<XCPointerEventPath *> *)asEventPathsWithError:(NSError **)error;
+
+@end
+
+
+@interface FBBaseActionsSynthesizer : NSObject
+
+/*! Raw actions chain received from request's JSON */
+@property (readonly, nonatomic) NSArray *actions;
+/*! Current application instance */
+@property (readonly, nonatomic) XCUIApplication *application;
+/*! Current elements cache */
+@property (readonly, nonatomic, nullable) FBElementCache *elementCache;
+
+/**
+ Initializes actions synthesizer. This initializer should be used only by subclasses.
+ 
+ @param actions The raw actions chain received from request's JSON. The format of this chain is defined by the standard, implemented in the correspoding subclass.
+ @param application Current application instance
+ @param elementCache Elements cache, which is used to replace elements references in the chain with their instances. We assume the chain already contains element instances if this parameter is set to nil
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return The corresponding synthesizer instance or nil in case of failure (for example if `actions` is nil or empty)
+ */
+- (nullable instancetype)initWithActions:(NSArray *)actions
+                          forApplication:(XCUIApplication *)application
+                            elementCache:(nullable FBElementCache *)elementCache
+                                   error:(NSError **)error;
+
+/**
+ Synthesizes XCTest-compatible event record to be performed in the UI. This method is supposed to be overriden by subclasses.
+ 
+ @param error If there is an error, upon return contains an NSError object that describes the problem
+ @return The generated event record or nil in case of failure
+ */
+- (nullable XCSynthesizedEventRecord *)synthesizeWithError:(NSError **)error;
+
+@end
+#endif
+
+NS_ASSUME_NONNULL_END