@devicelab/maestro-runner-darwin-x64 1.1.25

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.h

@@ -0,0 +1,33 @@
+/**
+ * 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 <WebDriverAgentLib/FBXCElementSnapshotWrapper.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface XCUIElement (FBMinMax)
+
+/*! Minimum value (minValue) – may be nil if the element does not have this attribute */
+@property (nonatomic, readonly, nullable) NSNumber *fb_minValue;
+
+/*! Maximum value (maxValue) - may be nil if the element does not have this attribute */
+@property (nonatomic, readonly, nullable) NSNumber *fb_maxValue;
+
+@end
+
+@interface FBXCElementSnapshotWrapper (FBMinMax)
+
+/*! Minimum value (minValue) – may be nil if the element does not have this attribute */
+@property (nonatomic, readonly, nullable) NSNumber *fb_minValue;
+
+/*! Maximum value (maxValue) - may be nil if the element does not have this attribute */
+@property (nonatomic, readonly, nullable) NSNumber *fb_maxValue;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBMinMax.m

@@ -0,0 +1,75 @@
+/**
+ * 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 "FBLogger.h"
+#import "XCUIElement+FBMinMax.h"
+#import "FBXCElementSnapshotWrapper+Helpers.h"
+#import "XCUIElement+FBUtilities.h"
+#import "XCTestPrivateSymbols.h"
+
+@interface FBXCElementSnapshotWrapper (FBMinMaxInternal)
+
+- (NSNumber *)fb_numericAttribute:(NSString *)attributeName symbol:(NSNumber *)symbol;
+
+@end
+
+@implementation XCUIElement (FBMinMax)
+
+- (NSNumber *)fb_minValue
+{
+  @autoreleasepool {
+    id<FBXCElementSnapshot> snapshot = [self fb_standardSnapshot];
+    return [[FBXCElementSnapshotWrapper ensureWrapped:snapshot] fb_minValue];
+  }
+}
+
+- (NSNumber *)fb_maxValue
+{
+  @autoreleasepool {
+    id<FBXCElementSnapshot> snapshot = [self fb_standardSnapshot];
+    return [[FBXCElementSnapshotWrapper ensureWrapped:snapshot] fb_maxValue];
+  }
+}
+
+@end
+
+@implementation FBXCElementSnapshotWrapper (FBMinMax)
+
+- (NSNumber *)fb_minValue
+{
+  return [self fb_numericAttribute:FB_XCAXACustomMinValueAttributeName
+                            symbol:FB_XCAXACustomMinValueAttribute];
+}
+
+- (NSNumber *)fb_maxValue
+{
+  return [self fb_numericAttribute:FB_XCAXACustomMaxValueAttributeName
+                            symbol:FB_XCAXACustomMaxValueAttribute];
+}
+
+- (NSNumber *)fb_numericAttribute:(NSString *)attributeName symbol:(NSNumber *)symbol
+{
+  NSNumber *cached = (self.snapshot.additionalAttributes ?: @{})[symbol];
+  if (cached) {
+    return cached;
+  }
+
+  NSError *error = nil;
+  NSNumber *raw = [self fb_attributeValue:attributeName error:&error];
+  if (nil != raw) {
+    NSMutableDictionary *updated = [NSMutableDictionary dictionaryWithDictionary:self.additionalAttributes ?: @{}];
+    updated[symbol] = raw;
+    self.snapshot.additionalAttributes = updated.copy;
+    return raw;
+  }
+
+  [FBLogger logFmt:@"[FBMinMax] Cannot determine %@ for %@: %@", attributeName, self.fb_description, error.localizedDescription];
+  return nil;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.h

@@ -0,0 +1,45 @@
+/**
+ * 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 <WebDriverAgentLib/XCUIElement.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface XCUIElement (FBPickerWheel)
+
+/**
+ Selects the next available option in Picker Wheel
+ 
+ @param offset the value in range [0.01, 0.5]. It defines how far from picker
+   wheel's center the click should happen. The actual distance is culculated by
+   multiplying this value to the actual picker wheel height. Too small offset value
+   may not change the picker wheel value and too high value may cause the wheel to switch
+   two or more values at once. Usually the optimal value is located in range [0.15, 0.3]
+ @param error returns error object if there was an error while selecting the
+   next picker value
+ @return YES if the current option has been successfully switched. Otherwise NO
+ */
+- (BOOL)fb_selectNextOptionWithOffset:(CGFloat)offset error:(NSError **)error;
+
+/**
+ Selects the previous available option in Picker Wheel
+ 
+ @param offset the value in range [0.01, 0.5]. It defines how far from picker
+   wheel's center the click should happen. The actual distance is culculated by
+   multiplying this value to the actual picker wheel height. Too small offset value
+   may not change the picker wheel value and too high value may cause the wheel to switch
+   two or more values at once. Usually the optimal value is located in range [0.15, 0.3]
+ @param error returns error object if there was an error while selecting the
+   previous picker value
+ @return YES if the current option has been successfully switched. Otherwise NO
+ */
+- (BOOL)fb_selectPreviousOptionWithOffset:(CGFloat)offset error:(NSError **)error;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBPickerWheel.m

@@ -0,0 +1,58 @@
+/**
+ * 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 "XCUIElement+FBPickerWheel.h"
+
+#import "FBRunLoopSpinner.h"
+#import "FBXCElementSnapshot.h"
+#import "FBXCodeCompatibility.h"
+#import "XCUIElement+FBUID.h"
+#import "XCUICoordinate.h"
+#import "XCUIElement+FBCaching.h"
+#import "XCUIElement+FBResolve.h"
+
+#if !TARGET_OS_TV
+@implementation XCUIElement (FBPickerWheel)
+
+static const NSTimeInterval VALUE_CHANGE_TIMEOUT = 2;
+
+- (BOOL)fb_scrollWithOffset:(CGFloat)relativeHeightOffset error:(NSError **)error
+{
+  id<FBXCElementSnapshot> snapshot = [self fb_standardSnapshot];
+  NSString *previousValue = snapshot.value;
+  XCUICoordinate *startCoord = [self coordinateWithNormalizedOffset:CGVectorMake(0.5, 0.5)];
+  XCUICoordinate *endCoord = [startCoord coordinateWithOffset:CGVectorMake(0.0, relativeHeightOffset * snapshot.frame.size.height)];
+  // If picker value is reflected in its accessiblity id
+  // then fetching of the next snapshot may fail with StaleElementReferenceError
+  // because we bound elements by their accessbility ids by default.
+  // Fetching stable instance of an element allows it to be bounded to the
+  // unique element identifier (UID), so it could be found next time even if its
+  // id is different from the initial one. See https://github.com/appium/appium/issues/17569
+  XCUIElement *stableInstance = [self fb_stableInstanceWithUid:[FBXCElementSnapshotWrapper wdUIDWithSnapshot:snapshot]];
+  [endCoord tap];
+  return [[[[FBRunLoopSpinner new]
+     timeout:VALUE_CHANGE_TIMEOUT]
+    timeoutErrorMessage:[NSString stringWithFormat:@"Picker wheel value has not been changed after %@ seconds timeout", @(VALUE_CHANGE_TIMEOUT)]]
+   spinUntilTrue:^BOOL{
+     return ![stableInstance.value isEqualToString:previousValue];
+   }
+   error:error];
+}
+
+- (BOOL)fb_selectNextOptionWithOffset:(CGFloat)offset error:(NSError **)error
+{
+  return [self fb_scrollWithOffset:offset error:error];
+}
+
+- (BOOL)fb_selectPreviousOptionWithOffset:(CGFloat)offset error:(NSError **)error
+{
+  return [self fb_scrollWithOffset:-offset error:error];
+}
+
+@end
+#endif

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBResolve.h

@@ -0,0 +1,37 @@
+/**
+ * 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
+
+@interface XCUIElement (FBResolve)
+
+/*! This property is always true unless the element gets resolved by its internal UUID (e.g. results of an xpath query) */
+@property (nullable, nonatomic) NSNumber *fb_isResolvedNatively;
+
+/**
+ Returns element instance based on query by element's UUID rather than any other attributes, which
+ might be a subject of change during the application life cycle. The UUID is calculated based on the PID
+ of the application to which this particular element belongs and the identifier of the underlying AXElement
+ instance. That usually guarantees the same element is always going to be matched in scope of the parent
+ application independently of its current attribute values.
+ Example: We have an element X with value Y. Our locator looks like 'value == Y'. Normally, if the element's
+ value is changed to Z and we try to reuse this cached instance of it then a StaleElement error is thrown.
+ Although, if the cached element instance is the one returned by this API call then the same element
+ is going to be matched and no staleness exception will be thrown.
+
+ @param uid Element UUID
+ @return Either the same element instance if `fb_isResolvedNatively` was set to NO (usually the cache for elements
+ matched by xpath locators) or the stable instance of the self element based on the query by element's UUID.
+ */
+- (XCUIElement *)fb_stableInstanceWithUid:(NSString *__nullable)uid;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBResolve.m

@@ -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 "XCUIElement+FBResolve.h"
+
+#import <objc/runtime.h>
+
+#import "XCUIElement.h"
+#import "FBXCodeCompatibility.h"
+#import "XCUIElement+FBUID.h"
+
+@implementation XCUIElement (FBResolve)
+
+static char XCUIELEMENT_IS_RESOLVED_NATIVELY_KEY;
+
+@dynamic fb_isResolvedNatively;
+
+- (void)setFb_isResolvedNatively:(NSNumber *)isResolvedNatively
+{
+  objc_setAssociatedObject(self, &XCUIELEMENT_IS_RESOLVED_NATIVELY_KEY, isResolvedNatively, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
+}
+
+- (NSNumber *)fb_isResolvedNatively
+{
+  NSNumber *result = objc_getAssociatedObject(self, &XCUIELEMENT_IS_RESOLVED_NATIVELY_KEY);
+  return nil == result ? @YES : result;
+}
+
+- (XCUIElement *)fb_stableInstanceWithUid:(NSString *)uid
+{
+  if (nil == uid || ![self.fb_isResolvedNatively boolValue] || [self isKindOfClass:XCUIApplication.class]) {
+    return self;
+  }
+  NSPredicate *predicate = [NSPredicate predicateWithFormat:@"%K = %@", FBStringify(FBXCElementSnapshotWrapper, fb_uid), uid];
+  @autoreleasepool {
+    XCUIElementQuery *query = [self.application.fb_query descendantsMatchingType:XCUIElementTypeAny];
+    XCUIElement *result = [query matchingPredicate:predicate].allElementsBoundByIndex.firstObject;
+    if (nil != result) {
+      result.fb_isResolvedNatively = @NO;
+      return result;
+    }
+  }
+  return self;
+}
+
+@end

package/drivers/ios/WebDriverAgent/WebDriverAgentLib/Categories/XCUIElement+FBScrolling.h

@@ -0,0 +1,98 @@
+/**
+ * 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 <WebDriverAgentLib/XCUIElement.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ Defines directions in which scrolling is possible.
+ */
+typedef NS_ENUM(NSUInteger, FBXCUIElementScrollDirection) {
+  FBXCUIElementScrollDirectionUnknown,
+  FBXCUIElementScrollDirectionVertical,
+  FBXCUIElementScrollDirectionHorizontal,
+};
+
+#if !TARGET_OS_TV
+
+@interface XCUIElement (FBScrolling)
+
+/**
+ Scrolls receiver up by one screen height
+
+ @param distance Normalized <0.0 - 1.0> scroll distance distance
+ */
+- (void)fb_scrollUpByNormalizedDistance:(CGFloat)distance;
+
+/**
+ Scrolls receiver down by one screen height
+
+ @param distance Normalized <0.0 - 1.0> scroll distance distance
+ */
+- (void)fb_scrollDownByNormalizedDistance:(CGFloat)distance;
+
+/**
+ Scrolls receiver left by one screen width
+
+ @param distance Normalized <0.0 - 1.0> scroll distance distance
+ */
+- (void)fb_scrollLeftByNormalizedDistance:(CGFloat)distance;
+
+/**
+ Scrolls receiver right by one screen width
+
+ @param distance Normalized <0.0 - 1.0> scroll distance distance
+ */
+- (void)fb_scrollRightByNormalizedDistance:(CGFloat)distance;
+
+/**
+ Scrolls parent scroll view till receiver is visible.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)fb_scrollToVisibleWithError:(NSError **)error;
+
+/**
+ Scrolls parent scroll view till the current element is visible.
+ This call is fast as it uses a native XCTest implementation.
+ The element must be hittable.
+
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)fb_nativeScrollToVisibleWithError:(NSError **)error;
+
+/**
+ Scrolls parent scroll view till receiver is visible. Whenever element is invisible it scrolls by normalizedScrollDistance
+ in its direction. E.g. if normalizedScrollDistance is equal to 0.5, each step will scroll by half of scroll view's size.
+
+ @param normalizedScrollDistance single scroll step normalized (0.0 - 1.0) distance
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)fb_scrollToVisibleWithNormalizedScrollDistance:(CGFloat)normalizedScrollDistance error:(NSError **)error;
+
+/**
+ Scrolls parent scroll view till receiver is visible. Whenever element is invisible it scrolls by normalizedScrollDistance
+ in its direction. E.g. if normalizedScrollDistance is equal to 0.5, each step will scroll by half of scroll view's size.
+
+ @param normalizedScrollDistance single scroll step normalized (0.0 - 1.0) distance
+ @param scrollDirection the direction in which the scroll view should be scrolled, or FBXCUIElementScrollDirectionUnknown 
+ to attempt to determine it automatically
+ @param error If there is an error, upon return contains an NSError object that describes the problem.
+ @return YES if the operation succeeds, otherwise NO.
+ */
+- (BOOL)fb_scrollToVisibleWithNormalizedScrollDistance:(CGFloat)normalizedScrollDistance scrollDirection:(FBXCUIElementScrollDirection)scrollDirection error:(NSError **)error;
+
+@end
+
+#endif
+
+NS_ASSUME_NONNULL_END