@devicelab/maestro-runner-darwin-x64 1.1.25

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

@@ -0,0 +1,227 @@
+/**
+ * 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 "FBScreenshot.h"
+
+@import UniformTypeIdentifiers;
+
+#import "FBConfiguration.h"
+#import "FBErrorBuilder.h"
+#import "FBImageProcessor.h"
+#import "FBLogger.h"
+#import "FBMacros.h"
+#import "FBXCodeCompatibility.h"
+#import "FBXCTestDaemonsProxy.h"
+#import "XCTestManager_ManagerInterface-Protocol.h"
+#import "XCUIScreen.h"
+
+static const NSTimeInterval SCREENSHOT_TIMEOUT = 20.;
+static const CGFloat SCREENSHOT_SCALE = 1.0;  // Screenshot API should keep the original screen scale
+static const CGFloat HIGH_QUALITY = 0.8;
+static const CGFloat LOW_QUALITY = 0.25;
+
+NSString *formatTimeInterval(NSTimeInterval interval) {
+  NSUInteger milliseconds = (NSUInteger)(interval * 1000);
+  return [NSString stringWithFormat:@"%lu ms", milliseconds];
+}
+
+@implementation FBScreenshot
+
++ (CGFloat)compressionQualityWithQuality:(NSUInteger)quality
+{
+  switch (quality) {
+    case 1:
+      return HIGH_QUALITY;
+    case 2:
+      return LOW_QUALITY;
+    default:
+      return 1.0;
+  }
+}
+
++ (UTType *)imageUtiWithQuality:(NSUInteger)quality
+{
+  switch (quality) {
+    case 1:
+    case 2:
+      return UTTypeJPEG;
+    case 3:
+      return UTTypeHEIC;
+    default:
+      return UTTypePNG;
+  }
+}
+
++ (NSData *)takeInOriginalResolutionWithQuality:(NSUInteger)quality
+                                          error:(NSError **)error
+{
+  XCUIScreen *mainScreen = XCUIScreen.mainScreen;
+  return [self.class takeWithScreenID:mainScreen.displayID
+                                scale:SCREENSHOT_SCALE
+                   compressionQuality:[self.class compressionQualityWithQuality:quality]
+                            sourceUTI:[self.class imageUtiWithQuality:quality]
+                                error:error];
+}
+
++ (NSData *)takeWithScreenID:(long long)screenID
+                       scale:(CGFloat)scale
+          compressionQuality:(CGFloat)compressionQuality
+                   sourceUTI:(UTType *)uti
+                       error:(NSError **)error
+{
+  NSData *screenshotData = [self.class takeInOriginalResolutionWithScreenID:screenID
+                                                         compressionQuality:compressionQuality
+                                                                        uti:uti
+                                                                    timeout:SCREENSHOT_TIMEOUT
+                                                                      error:error];
+  if (nil == screenshotData) {
+    return nil;
+  }
+  return [[[FBImageProcessor alloc] init] scaledImageWithData:screenshotData
+                                                          uti:UTTypePNG
+                                                scalingFactor:1.0 / scale
+                                           compressionQuality:FBMaxCompressionQuality
+                                                        error:error];
+}
+
++ (NSData *)takeInOriginalResolutionWithScreenID:(long long)screenID
+                              compressionQuality:(CGFloat)compressionQuality
+                                             uti:(UTType *)uti
+                                         timeout:(NSTimeInterval)timeout
+                                           error:(NSError **)error
+{
+  id<XCTestManager_ManagerInterface> proxy = [FBXCTestDaemonsProxy testRunnerProxy];
+  __block NSData *screenshotData = nil;
+  __block NSError *innerError = nil;
+  dispatch_semaphore_t sem = dispatch_semaphore_create(0);
+  id screnshotRequest = [self.class screenshotRequestWithScreenID:screenID
+                                                             rect:CGRectNull
+                                                              uti:uti
+                                               compressionQuality:compressionQuality
+                                                            error:error];
+  if (nil == screnshotRequest) {
+    return nil;
+  }
+  [proxy _XCT_requestScreenshot:screnshotRequest
+                      withReply:^(id image, NSError *err) {
+    if (nil != err) {
+      innerError = err;
+    } else {
+      screenshotData = [image data];
+    }
+    dispatch_semaphore_signal(sem);
+  }];
+  int64_t timeoutNs = (int64_t)(timeout * NSEC_PER_SEC);
+  if (0 != dispatch_semaphore_wait(sem, dispatch_time(DISPATCH_TIME_NOW, timeoutNs))) {
+    NSString *timeoutMsg = [NSString stringWithFormat:@"Cannot take a screenshot within %@ timeout", formatTimeInterval(SCREENSHOT_TIMEOUT)];
+    if (nil == error) {
+      [FBLogger log:timeoutMsg];
+    } else if (nil == innerError) {
+      [[[FBErrorBuilder builder]
+        withDescription:timeoutMsg]
+       buildError:error];
+    }
+  };
+  if (nil != error && nil != innerError) {
+    *error = innerError;
+  }
+  return screenshotData;
+}
+
++ (nullable id)imageEncodingWithUniformTypeIdentifier:(UTType *)uti
+                                   compressionQuality:(CGFloat)compressionQuality
+                                                error:(NSError **)error
+{
+  Class imageEncodingClass = NSClassFromString(@"XCTImageEncoding");
+  if (nil == imageEncodingClass) {
+    [[[FBErrorBuilder builder]
+      withDescription:@"Cannot find XCTImageEncoding class"]
+     buildError:error];
+    return nil;
+  }
+
+  if ([uti conformsToType:UTTypeHEIC]) {
+    static BOOL isHeicSuppported = NO;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+      SEL selector = NSSelectorFromString(@"supportsHEICImageEncoding");
+      NSMethodSignature *signature = [imageEncodingClass methodSignatureForSelector:selector];
+      if (nil != signature) {
+        NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:signature];
+        [invocation setSelector:selector];
+        [invocation invokeWithTarget:imageEncodingClass];
+        [invocation getReturnValue:&isHeicSuppported];
+      }
+    });
+    if (!isHeicSuppported) {
+      [FBLogger logFmt:@"The device under test does not support HEIC image encoding. Falling back to PNG"];
+      uti = UTTypePNG;
+    }
+  }
+
+  id imageEncodingAllocated = [imageEncodingClass alloc];
+  SEL imageEncodingConstructorSelector = NSSelectorFromString(@"initWithUniformTypeIdentifier:compressionQuality:");
+  if (![imageEncodingAllocated respondsToSelector:imageEncodingConstructorSelector]) {
+    [[[FBErrorBuilder builder]
+      withDescription:@"'initWithUniformTypeIdentifier:compressionQuality:' contructor is not found on XCTImageEncoding class"]
+     buildError:error];
+    return nil;
+  }
+  NSMethodSignature *imageEncodingContructorSignature = [imageEncodingAllocated methodSignatureForSelector:imageEncodingConstructorSelector];
+  NSInvocation *imageEncodingInitInvocation = [NSInvocation invocationWithMethodSignature:imageEncodingContructorSignature];
+  [imageEncodingInitInvocation setSelector:imageEncodingConstructorSelector];
+  NSString *utiIdentifier = uti.identifier;
+  [imageEncodingInitInvocation setArgument:&utiIdentifier atIndex:2];
+  [imageEncodingInitInvocation setArgument:&compressionQuality atIndex:3];
+  [imageEncodingInitInvocation invokeWithTarget:imageEncodingAllocated];
+  id __unsafe_unretained imageEncoding;
+  [imageEncodingInitInvocation getReturnValue:&imageEncoding];
+  return imageEncoding;
+}
+
++ (nullable id)screenshotRequestWithScreenID:(long long)screenID
+                                        rect:(struct CGRect)rect
+                                         uti:(UTType *)uti
+                          compressionQuality:(CGFloat)compressionQuality
+                                       error:(NSError **)error
+{
+  id imageEncoding = [self.class imageEncodingWithUniformTypeIdentifier:uti
+                                                     compressionQuality:compressionQuality
+                                                                  error:error];
+  if (nil == imageEncoding) {
+    return nil;
+  }
+
+  Class screenshotRequestClass = NSClassFromString(@"XCTScreenshotRequest");
+  if (nil == screenshotRequestClass) {
+    [[[FBErrorBuilder builder]
+      withDescription:@"Cannot find XCTScreenshotRequest class"]
+     buildError:error];
+    return nil;
+  }
+  id screenshotRequestAllocated = [screenshotRequestClass alloc];
+  SEL screenshotRequestConstructorSelector = NSSelectorFromString(@"initWithScreenID:rect:encoding:");
+  if (![screenshotRequestAllocated respondsToSelector:screenshotRequestConstructorSelector]) {
+    [[[FBErrorBuilder builder]
+      withDescription:@"'initWithScreenID:rect:encoding:' contructor is not found on XCTScreenshotRequest class"]
+     buildError:error];
+    return nil;
+  }
+  NSMethodSignature *screenshotRequestContructorSignature = [screenshotRequestAllocated methodSignatureForSelector:screenshotRequestConstructorSelector];
+  NSInvocation *screenshotRequestInitInvocation = [NSInvocation invocationWithMethodSignature:screenshotRequestContructorSignature];
+  [screenshotRequestInitInvocation setSelector:screenshotRequestConstructorSelector];
+  [screenshotRequestInitInvocation setArgument:&screenID atIndex:2];
+  [screenshotRequestInitInvocation setArgument:&rect atIndex:3];
+  [screenshotRequestInitInvocation setArgument:&imageEncoding atIndex:4];
+  [screenshotRequestInitInvocation invokeWithTarget:screenshotRequestAllocated];
+  id __unsafe_unretained screenshotRequest;
+  [screenshotRequestInitInvocation getReturnValue:&screenshotRequest];
+  return screenshotRequest;
+}
+
+@end

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

@@ -0,0 +1,48 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+// See FBConfiguration.h for more details on the meaning of each setting
+
+extern NSString* const FB_SETTING_USE_COMPACT_RESPONSES;
+extern NSString* const FB_SETTING_ELEMENT_RESPONSE_ATTRIBUTES;
+extern NSString* const FB_SETTING_MJPEG_SERVER_SCREENSHOT_QUALITY;
+extern NSString* const FB_SETTING_MJPEG_SERVER_FRAMERATE;
+extern NSString* const FB_SETTING_MJPEG_FIX_ORIENTATION;
+extern NSString* const FB_SETTING_MJPEG_SCALING_FACTOR;
+extern NSString* const FB_SETTING_SCREENSHOT_QUALITY;
+extern NSString* const FB_SETTING_KEYBOARD_AUTOCORRECTION;
+extern NSString* const FB_SETTING_KEYBOARD_PREDICTION;
+extern NSString* const FB_SETTING_SNAPSHOT_MAX_DEPTH;
+extern NSString* const FB_SETTING_USE_FIRST_MATCH;
+extern NSString* const FB_SETTING_BOUND_ELEMENTS_BY_INDEX;
+extern NSString* const FB_SETTING_REDUCE_MOTION;
+extern NSString* const FB_SETTING_DEFAULT_ACTIVE_APPLICATION;
+extern NSString* const FB_SETTING_ACTIVE_APP_DETECTION_POINT;
+extern NSString* const FB_SETTING_INCLUDE_NON_MODAL_ELEMENTS;
+extern NSString* const FB_SETTING_DEFAULT_ALERT_ACTION;
+extern NSString* const FB_SETTING_ACCEPT_ALERT_BUTTON_SELECTOR;
+extern NSString* const FB_SETTING_DISMISS_ALERT_BUTTON_SELECTOR;
+extern NSString* const FB_SETTING_SCREENSHOT_ORIENTATION;
+extern NSString* const FB_SETTING_WAIT_FOR_IDLE_TIMEOUT;
+extern NSString* const FB_SETTING_ANIMATION_COOL_OFF_TIMEOUT;
+extern NSString* const FB_SETTING_MAX_TYPING_FREQUENCY;
+extern NSString* const FB_SETTING_RESPECT_SYSTEM_ALERTS;
+extern NSString* const FB_SETTING_USE_CLEAR_TEXT_SHORTCUT;
+extern NSString* const FB_SETTING_LIMIT_XPATH_CONTEXT_SCOPE;
+extern NSString* const FB_SETTING_AUTO_CLICK_ALERT_SELECTOR;
+extern NSString *const FB_SETTING_INCLUDE_HITTABLE_IN_PAGE_SOURCE;
+extern NSString *const FB_SETTING_INCLUDE_NATIVE_FRAME_IN_PAGE_SOURCE;
+extern NSString *const FB_SETTING_INCLUDE_MIN_MAX_VALUE_IN_PAGE_SOURCE;
+extern NSString *const FB_SETTING_INCLUDE_CUSTOM_ACTIONS_IN_PAGE_SOURCE;
+extern NSString *const FB_SETTING_ENFORCE_CUSTOM_SNAPSHOTS;
+
+NS_ASSUME_NONNULL_END

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

@@ -0,0 +1,42 @@
+/**
+ * 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 "FBSettings.h"
+
+NSString* const FB_SETTING_USE_COMPACT_RESPONSES = @"shouldUseCompactResponses";
+NSString* const FB_SETTING_ELEMENT_RESPONSE_ATTRIBUTES = @"elementResponseAttributes";
+NSString* const FB_SETTING_MJPEG_SERVER_SCREENSHOT_QUALITY = @"mjpegServerScreenshotQuality";
+NSString* const FB_SETTING_MJPEG_SERVER_FRAMERATE = @"mjpegServerFramerate";
+NSString* const FB_SETTING_MJPEG_SCALING_FACTOR = @"mjpegScalingFactor";
+NSString* const FB_SETTING_MJPEG_FIX_ORIENTATION = @"mjpegFixOrientation";
+NSString* const FB_SETTING_SCREENSHOT_QUALITY = @"screenshotQuality";
+NSString* const FB_SETTING_KEYBOARD_AUTOCORRECTION = @"keyboardAutocorrection";
+NSString* const FB_SETTING_KEYBOARD_PREDICTION = @"keyboardPrediction";
+NSString* const FB_SETTING_SNAPSHOT_MAX_DEPTH = @"snapshotMaxDepth";
+NSString* const FB_SETTING_USE_FIRST_MATCH = @"useFirstMatch";
+NSString* const FB_SETTING_BOUND_ELEMENTS_BY_INDEX = @"boundElementsByIndex";
+NSString* const FB_SETTING_REDUCE_MOTION = @"reduceMotion";
+NSString* const FB_SETTING_DEFAULT_ACTIVE_APPLICATION = @"defaultActiveApplication";
+NSString* const FB_SETTING_ACTIVE_APP_DETECTION_POINT = @"activeAppDetectionPoint";
+NSString* const FB_SETTING_INCLUDE_NON_MODAL_ELEMENTS = @"includeNonModalElements";
+NSString* const FB_SETTING_DEFAULT_ALERT_ACTION = @"defaultAlertAction";
+NSString* const FB_SETTING_ACCEPT_ALERT_BUTTON_SELECTOR = @"acceptAlertButtonSelector";
+NSString* const FB_SETTING_DISMISS_ALERT_BUTTON_SELECTOR = @"dismissAlertButtonSelector";
+NSString* const FB_SETTING_SCREENSHOT_ORIENTATION = @"screenshotOrientation";
+NSString* const FB_SETTING_WAIT_FOR_IDLE_TIMEOUT = @"waitForIdleTimeout";
+NSString* const FB_SETTING_ANIMATION_COOL_OFF_TIMEOUT = @"animationCoolOffTimeout";
+NSString* const FB_SETTING_MAX_TYPING_FREQUENCY = @"maxTypingFrequency";
+NSString* const FB_SETTING_RESPECT_SYSTEM_ALERTS = @"respectSystemAlerts";
+NSString* const FB_SETTING_USE_CLEAR_TEXT_SHORTCUT = @"useClearTextShortcut";
+NSString* const FB_SETTING_LIMIT_XPATH_CONTEXT_SCOPE = @"limitXPathContextScope";
+NSString* const FB_SETTING_AUTO_CLICK_ALERT_SELECTOR = @"autoClickAlertSelector";
+NSString* const FB_SETTING_INCLUDE_HITTABLE_IN_PAGE_SOURCE = @"includeHittableInPageSource";
+NSString* const FB_SETTING_INCLUDE_NATIVE_FRAME_IN_PAGE_SOURCE = @"includeNativeFrameInPageSource";
+NSString* const FB_SETTING_INCLUDE_MIN_MAX_VALUE_IN_PAGE_SOURCE = @"includeMinMaxValueInPageSource";
+NSString* const FB_SETTING_INCLUDE_CUSTOM_ACTIONS_IN_PAGE_SOURCE = @"includeCustomActionsInPageSource";
+NSString* const FB_SETTING_ENFORCE_CUSTOM_SNAPSHOTS = @"enforceCustomSnapshots";

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Utilities/FBTVNavigationTracker-Private.h

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2018-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 <Foundation/Foundation.h>
+
+#if TARGET_OS_TV
+
+@interface FBTVNavigationItem ()
+@property (nonatomic, readonly) NSString *uid;
+@property (nonatomic, readonly) NSMutableSet<NSNumber *>* directions;
+
++ (instancetype)itemWithUid:(NSString *) uid;
+@end
+
+
+@interface FBTVNavigationTracker ()
+
+- (FBTVDirection)horizontalDirectionWithItem:(FBTVNavigationItem *)item andDelta:(CGFloat)delta;
+- (FBTVDirection)verticalDirectionWithItem:(FBTVNavigationItem *)item andDelta:(CGFloat)delta;
+@end
+
+#endif

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

@@ -0,0 +1,52 @@
+/**
+ * Copyright (c) 2018-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 <Foundation/Foundation.h>
+#import <XCTest/XCUIElement.h>
+
+#if TARGET_OS_TV
+
+/**
+ Defines directions to move focuse to.
+ */
+typedef NS_ENUM(NSUInteger, FBTVDirection) {
+  FBTVDirectionUp     = 0,
+  FBTVDirectionDown   = 1,
+  FBTVDirectionLeft   = 2,
+  FBTVDirectionRight  = 3,
+  FBTVDirectionNone   = 4
+};
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface FBTVNavigationItem : NSObject
+@end
+
+@interface FBTVNavigationTracker : NSObject
+
+/**
+ Track the target element's point
+
+ @param targetElement A target element which will track
+ @return An instancce of FBTVNavigationTracker
+ */
++ (instancetype)trackerWithTargetElement: (XCUIElement *) targetElement;
+
+/**
+ Determine the correct direction to move the focus to the tracked target
+ element from the currently focused one
+
+ @return FBTVDirection to move the focus to
+ */
+- (FBTVDirection)directionToFocusedElement;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif

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

@@ -0,0 +1,142 @@
+/**
+ * Copyright (c) 2018-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 "FBTVNavigationTracker.h"
+#import "FBTVNavigationTracker-Private.h"
+
+#import "FBMathUtils.h"
+#import "XCUIElement+FBCaching.h"
+#import "XCUIElement+FBUtilities.h"
+#import "XCUIElement+FBWebDriverAttributes.h"
+#import "XCUIApplication+FBHelpers.h"
+
+#if TARGET_OS_TV
+
+@implementation FBTVNavigationItem
+
++ (instancetype)itemWithUid:(NSString *) uid
+{
+  return [[FBTVNavigationItem alloc] initWithUid:uid];
+}
+
+- (instancetype)initWithUid:(NSString *) uid
+{
+  self = [super init];
+  if(self) {
+    _uid = uid;
+    _directions = [NSMutableSet set];
+  }
+  return self;
+}
+
+@end
+
+@interface FBTVNavigationTracker ()
+@property (nonatomic, strong) XCUIElement *targetElement;
+@property (nonatomic, assign) CGPoint targetCenter;
+@property (nonatomic, strong) NSMutableDictionary<NSString *, FBTVNavigationItem* >* navigationItems;
+@end
+
+@implementation FBTVNavigationTracker
+
++ (instancetype)trackerWithTargetElement:(XCUIElement *)targetElement
+{
+  FBTVNavigationTracker *tracker = [[FBTVNavigationTracker alloc] initWithTargetElement:targetElement];
+  tracker.targetElement = targetElement;
+  return tracker;
+}
+
+- (instancetype)initWithTargetElement:(XCUIElement *)targetElement
+{
+  self = [super init];
+  if (self) {
+    _targetElement = targetElement;
+    CGRect frame = targetElement.wdFrame;
+    _targetCenter = FBRectGetCenter(frame);
+    _navigationItems = [NSMutableDictionary dictionary];
+  }
+  return self;
+}
+
+- (FBTVDirection)directionToFocusedElement
+{
+  XCUIElement *focused = XCUIApplication.fb_activeApplication.fb_focusedElement;
+
+  CGPoint focusedCenter = FBRectGetCenter(focused.wdFrame);
+  FBTVNavigationItem *item = [self navigationItemWithElement:focused];
+  CGFloat yDelta = self.targetCenter.y - focusedCenter.y;
+  CGFloat xDelta = self.targetCenter.x - focusedCenter.x;
+  FBTVDirection direction;
+  if (fabs(yDelta) > fabs(xDelta)) {
+    direction = [self verticalDirectionWithItem:item andDelta:yDelta];
+    if (direction == FBTVDirectionNone) {
+      direction = [self horizontalDirectionWithItem:item andDelta:xDelta];
+    }
+  } else {
+    direction = [self horizontalDirectionWithItem:item andDelta:xDelta];
+    if (direction == FBTVDirectionNone) {
+      direction = [self verticalDirectionWithItem:item andDelta:yDelta];
+    }
+  }
+
+  return direction;
+}
+
+#pragma mark - Utilities
+- (FBTVNavigationItem*)navigationItemWithElement:(id<FBElement>)element
+{
+  NSString *uid = element.wdUID;
+  if (nil == uid) {
+    return nil;
+  }
+
+  FBTVNavigationItem* item = [self.navigationItems objectForKey:uid];
+  if (nil != item) {
+    return item;
+  }
+  
+  item = [FBTVNavigationItem itemWithUid:uid];
+  [self.navigationItems setObject:item forKey:uid];
+  return item;
+}
+
+- (FBTVDirection)horizontalDirectionWithItem:(FBTVNavigationItem *)item andDelta:(CGFloat)delta
+{
+  // GCFloat is double in 64bit. tvOS is only for arm64
+  if (delta > DBL_EPSILON &&
+      ![item.directions containsObject: [NSNumber numberWithInteger: FBTVDirectionRight]]) {
+    [item.directions addObject: [NSNumber numberWithInteger: FBTVDirectionRight]];
+    return FBTVDirectionRight;
+  }
+  if (delta < -DBL_EPSILON &&
+      ![item.directions containsObject: [NSNumber numberWithInteger: FBTVDirectionLeft]]) {
+    [item.directions addObject: [NSNumber numberWithInteger: FBTVDirectionLeft]];
+    return FBTVDirectionLeft;
+  }
+  return FBTVDirectionNone;
+}
+
+- (FBTVDirection)verticalDirectionWithItem:(FBTVNavigationItem *)item andDelta:(CGFloat)delta
+{
+  // GCFloat is double in 64bit. tvOS is only for arm64
+  if (delta > DBL_EPSILON &&
+      ![item.directions containsObject: [NSNumber numberWithInteger: FBTVDirectionDown]]) {
+    [item.directions addObject: [NSNumber numberWithInteger: FBTVDirectionDown]];
+    return FBTVDirectionDown;
+  }
+  if (delta < -DBL_EPSILON &&
+      ![item.directions containsObject: [NSNumber numberWithInteger: FBTVDirectionUp]]) {
+    [item.directions addObject: [NSNumber numberWithInteger: FBTVDirectionUp]];
+    return FBTVDirectionUp;
+  }
+  return FBTVDirectionNone;
+}
+
+@end
+
+#endif

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

@@ -0,0 +1,26 @@
+/**
+ * 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Launches apps without attaching them to an XCUITest or a WDA session, allowing them to remain open
+ when WDA closes.
+*/
+@interface FBUnattachedAppLauncher : NSObject
+
+/**
+ Launch the app with the specified bundle ID. Return YES if successful, NO otherwise.
+ */
++ (BOOL)launchAppWithBundleId:(NSString *)bundleId;
+
+@end
+
+NS_ASSUME_NONNULL_END

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

@@ -0,0 +1,21 @@
+/**
+ * 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 "FBUnattachedAppLauncher.h"
+
+#import <MobileCoreServices/MobileCoreServices.h>
+
+#import "LSApplicationWorkspace.h"
+
+@implementation FBUnattachedAppLauncher
+
++ (BOOL)launchAppWithBundleId:(NSString *)bundleId {
+  return [[LSApplicationWorkspace defaultWorkspace] openApplicationWithBundleID:bundleId];
+}
+
+@end

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

@@ -0,0 +1,42 @@
+/**
+* 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 <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * Extracts value property for a key action
+ *
+ * @param actionItem Action item dictionary
+ * @param error Contains the acttual error in case of failure
+ * @returns Either the extracted value or nil in case of failure
+ */
+NSString *_Nullable FBRequireValue(NSDictionary<NSString *, id> *actionItem, NSError **error);
+
+/**
+ * Extracts duration property for an action
+ *
+ * @param actionItem Action item dictionary
+ * @param defaultValue The default duration value if it is not present. If nil then the error will be set
+ * @param error Contains the acttual error in case of failure
+ * @returns Either the extracted value or nil in case of failure
+ */
+NSNumber *_Nullable FBOptDuration(NSDictionary<NSString *, id> *actionItem, NSNumber *_Nullable defaultValue, NSError **error);
+
+/**
+ * Maps W3C meta modifier to XCUITest compatible-one
+ * See https://w3c.github.io/webdriver/#keyboard-actions
+ *
+ * @param value key action value
+ * @returns the mapped modifier value or the same input character
+ * if no mapped value could be found for it.
+ */
+NSString * FBMapIfSpecialCharacter(NSString *value);
+
+NS_ASSUME_NONNULL_END