@devicelab/maestro-runner-darwin-arm64 1.1.27 → 1.1.28

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCUIAutomation.framework/Headers/XCUIElement.h

@@ -0,0 +1,366 @@
+//
+//  Copyright (c) 2014-2016 Apple Inc. All rights reserved.
+//
+
+#import <XCUIAutomation/XCUIAutomationDefines.h>
+
+#if TARGET_OS_IPHONE
+#import <UIKit/UIKit.h>
+#else
+#import <AppKit/AppKit.h>
+#endif
+
+#import <XCUIAutomation/XCUIElementAttributes.h>
+#import <XCUIAutomation/XCUIElementTypeQueryProvider.h>
+#import <XCUIAutomation/XCUIKeyboardKeys.h>
+#import <XCUIAutomation/XCUIScreenshotProviding.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+typedef NS_OPTIONS(NSUInteger, XCUIKeyModifierFlags) {
+    XCUIKeyModifierNone       = 0,
+    XCUIKeyModifierCapsLock   = (1UL << 0),
+    XCUIKeyModifierShift      = (1UL << 1),
+    XCUIKeyModifierControl    = (1UL << 2),
+    XCUIKeyModifierOption     = (1UL << 3),
+    XCUIKeyModifierCommand    = (1UL << 4),
+    XCUIKeyModifierFunction   = (1UL << 5),
+    
+    // These values align with UIKeyModifierFlags and CGEventFlags.
+    XCUIKeyModifierAlphaShift = XCUIKeyModifierCapsLock,
+    XCUIKeyModifierAlternate  = XCUIKeyModifierOption,
+};
+
+typedef CGFloat XCUIGestureVelocity NS_TYPED_EXTENSIBLE_ENUM;
+XCUI_EXPORT XCUIGestureVelocity const XCUIGestureVelocityDefault;
+XCUI_EXPORT XCUIGestureVelocity const XCUIGestureVelocitySlow;
+XCUI_EXPORT XCUIGestureVelocity const XCUIGestureVelocityFast;
+
+@class XCUIElementQuery;
+@class XCUICoordinate;
+
+/*!
+ * @class XCUIElement (/seealso XCUIElementAttributes)
+ * Elements are objects encapsulating the information needed to dynamically locate a user interface
+ * element in an application. Elements are described in terms of queries /seealso XCUIElementQuery.
+ */
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement : NSObject <XCUIElementAttributes, XCUIElementTypeQueryProvider>
+
++ (instancetype)new XCUI_UNAVAILABLE("Use XCUIElementQuery to create XCUIElement instances.");
+- (instancetype)init XCUI_UNAVAILABLE("Use XCUIElementQuery to create XCUIElement instances.");
+
+/*! Test to determine if the element exists. */
+@property (readonly) BOOL exists;
+
+/*! Waits the specified amount of time for the element's exist property to be true and returns false if the timeout expires without the element coming into existence. */
+- (BOOL)waitForExistenceWithTimeout:(NSTimeInterval)timeout XCUI_WARN_UNUSED;
+
+/*! Waits the specified amount of time for the element's exist property to be false and returns false if the timeout expires without the element disappearing. */
+- (BOOL)waitForNonExistenceWithTimeout:(NSTimeInterval)timeout;
+
+/*! Whether or not a hit point can be computed for the element for the purpose of synthesizing events. */
+@property (readonly, getter = isHittable) BOOL hittable;
+
+/*! Returns a query for all descendants of the element matching the specified type. */
+- (XCUIElementQuery *)descendantsMatchingType:(XCUIElementType)type;
+
+/*! Returns a query for direct children of the element matching the specified type. */
+- (XCUIElementQuery *)childrenMatchingType:(XCUIElementType)type;
+
+#if !TARGET_OS_TV
+/*! Creates and returns a new coordinate that will compute its screen point by adding the offset multiplied by the size of the element’s frame to the origin of the element’s frame. */
+- (XCUICoordinate *)coordinateWithNormalizedOffset:(CGVector)normalizedOffset;
+#endif
+
+/*!
+ @discussion
+ Provides debugging information about the element. The data in the string will vary based on the
+ time at which it is captured, but it may include any of the following as well as additional data:
+    • Values for the elements attributes.
+    • The entire tree of descendants rooted at the element.
+    • The element's query.
+ This data should be used for debugging only - depending on any of the data as part of a test is unsupported.
+ */
+@property (readonly, copy) NSString *debugDescription;
+
+@end
+
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIScreenshotProviding) <XCUIScreenshotProviding>
+@end
+
+#pragma mark - Event Synthesis
+
+/*!
+ * @category Events
+ * Events that can be synthesized relative to an XCUIElement object. When an event API is called, the element
+ * will be resolved. If zero or multiple matches are found, an error will be raised.
+ */
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementKeyboardEvents)
+
+/*!
+ * Types a string into the element. The element or a descendant must have keyboard focus; otherwise an
+ * error is raised.
+ *
+ * This API discards any modifiers set in the current context by +performWithKeyModifiers:block: so that
+ * it strictly interprets the provided text. To input keys with modifier flags, use  -typeKey:modifierFlags:.
+ */
+- (void)typeText:(NSString *)text;
+
+#if TARGET_OS_OSX || TARGET_OS_MACCATALYST || TARGET_OS_IOS
+
+/*!
+ * Hold modifier keys while the given block runs. This method pushes and pops the modifiers as global state
+ * without need for reference to a particular element. Inside the block, elements can be clicked on, dragged
+ * from, typed into, etc.
+ */
++ (void)performWithKeyModifiers:(XCUIKeyModifierFlags)flags block:(XCUI_NOESCAPE void (^)(void))block API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Types a single key with the specified modifier flags. Although `key` is a string, it must represent
+ * a single key on a physical keyboard; strings that resolve to multiple keys will raise an error at runtime.
+ * In addition to literal string key representations like "a", "6", and "[", keys such as the arrow keys,
+ * command, control, option, and function keys can be typed using constants defined for them in XCUIKeyboardKeys.h
+ */
+- (void)typeKey:(NSString *)key modifierFlags:(XCUIKeyModifierFlags)flags;
+
+#endif // TARGET_OS_OSX || TARGET_OS_MACCATALYST || TARGET_OS_IOS
+
+@end
+
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementTouchEvents)
+
+/*!
+ * Sends a tap event to a hittable point computed for the element.
+ */
+- (void)tap API_UNAVAILABLE(tvos);
+
+/*!
+ * Sends a double tap event to a hittable point computed for the element.
+ */
+- (void)doubleTap API_UNAVAILABLE(tvos);
+
+/*!
+ * Sends a long press gesture to a hittable point computed for the element, holding for the specified duration.
+ *
+ * @param duration
+ * Duration in seconds.
+ */
+- (void)pressForDuration:(NSTimeInterval)duration API_UNAVAILABLE(tvos);
+
+/*!
+ * Initiates a press-and-hold gesture that then drags to another element, suitable for table cell reordering and similar operations.
+ * @param duration
+ * Duration of the initial press-and-hold.
+ * @param otherElement
+ * The element to finish the drag gesture over. In the example of table cell reordering, this would be the reorder element of the destination row.
+ */
+- (void)pressForDuration:(NSTimeInterval)duration thenDragToElement:(XCUIElement *)otherElement API_UNAVAILABLE(tvos);
+
+/*!
+* Initiates a press-and-hold gesture that then drags to another element with a custom velocity and then holds, suitable for table cell reordering and similar operations.
+* @param duration
+* Duration of the initial press-and-hold.
+* @param otherElement
+* The element to finish the drag gesture over. In the example of table cell reordering, this would be the reorder element of the destination row.
+* @param velocity
+* The velocity pixels per second at which to drag the element.
+* @param holdDuration
+* The duration of the final hold.
+*/
+- (void)pressForDuration:(NSTimeInterval)duration thenDragToElement:(XCUIElement *)otherElement withVelocity:(XCUIGestureVelocity)velocity thenHoldForDuration:(NSTimeInterval)holdDuration API_UNAVAILABLE(tvos);
+
+#if !TARGET_OS_TV
+
+/*!
+ * Sends a swipe-up gesture.
+ */
+- (void)swipeUp;
+
+/*!
+ * Sends a swipe-down gesture.
+ */
+- (void)swipeDown;
+
+/*!
+ * Sends a swipe-left gesture.
+ */
+- (void)swipeLeft;
+
+/*!
+ * Sends a swipe-right gesture.
+ */
+- (void)swipeRight;
+
+/*!
+ * Sends a swipe in the specified direction with a specified velocity.
+ * @param velocity
+ * The velocity pixels per second at which to perform the swipe at.
+*/
+- (void)swipeUpWithVelocity:(XCUIGestureVelocity)velocity;
+- (void)swipeDownWithVelocity:(XCUIGestureVelocity)velocity;
+- (void)swipeLeftWithVelocity:(XCUIGestureVelocity)velocity;
+- (void)swipeRightWithVelocity:(XCUIGestureVelocity)velocity;
+
+#endif // !TARGET_OS_TV
+
+#if (TARGET_OS_IOS || TARGET_OS_WATCH) && !TARGET_OS_MACCATALYST
+
+/*!
+ * Sends a two finger tap event to a hittable point computed for the element.
+ */
+- (void)twoFingerTap;
+
+/*!
+ * Sends one or more taps with one or more touch points.
+ *
+ * @param numberOfTaps
+ * The number of taps.
+ *
+ * @param numberOfTouches
+ * The number of touch points.
+ */
+- (void)tapWithNumberOfTaps:(NSUInteger)numberOfTaps numberOfTouches:(NSUInteger)numberOfTouches;
+
+/*!
+ * Sends a pinching gesture with two touches.
+ *
+ * The system makes a best effort to synthesize the requested scale and velocity: absolute accuracy is not guaranteed.
+ * Some values may not be possible based on the size of the element's frame - these will result in test failures.
+ *
+ * @param scale
+ * The scale of the pinch gesture.  Use a scale between 0 and 1 to "pinch close" or zoom out and a scale greater than 1 to "pinch open" or zoom in.
+ *
+ * @param velocity
+ * The velocity of the pinch in scale factor per second.
+ */
+- (void)pinchWithScale:(CGFloat)scale velocity:(CGFloat)velocity;
+
+/*!
+ * Sends a rotation gesture with two touches.
+ *
+ * The system makes a best effort to synthesize the requested rotation and velocity: absolute accuracy is not guaranteed.
+ * Some values may not be possible based on the size of the element's frame - these will result in test failures.
+ *
+ * @param rotation
+ * The rotation of the gesture in radians.
+ *
+ * @param velocity
+ * The velocity of the rotation gesture in radians per second.
+ */
+- (void)rotate:(CGFloat)rotation withVelocity:(CGFloat)velocity;
+
+#endif // (TARGET_OS_IOS || TARGET_OS_WATCH) && !TARGET_OS_MACCATALYST
+
+@end
+
+#if TARGET_OS_OSX || TARGET_OS_MACCATALYST || TARGET_OS_IOS
+
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementMouseEvents)
+
+/*!
+ * Moves the cursor over the element.
+ */
+- (void)hover API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Sends a click event to a hittable point computed for the element.
+ */
+- (void)click API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Sends a double click event to a hittable point computed for the element.
+ */
+- (void)doubleClick API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Sends a right click event to a hittable point computed for the element.
+ */
+- (void)rightClick API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Clicks and holds for a specified duration (generally long enough to start a drag operation) then drags
+ * to the other element.
+ */
+- (void)clickForDuration:(NSTimeInterval)duration thenDragToElement:(XCUIElement *)otherElement API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Initiates a click-and-hold gesture that then drags to another element with a custom velocity and then holds, suitable for table cell reordering and similar operations.
+ * @param duration
+ * Duration of the initial click-and-hold.
+ * @param otherElement
+ * The element to finish the drag gesture over. In the example of table cell reordering, this would be the reorder element of the destination row.
+ * @param velocity
+ * The velocity pixels per second at which to drag the element.
+ * @param holdDuration
+ * The duration of the final hold.
+ */
+- (void)clickForDuration:(NSTimeInterval)duration thenDragToElement:(XCUIElement *)otherElement withVelocity:(XCUIGestureVelocity)velocity thenHoldForDuration:(NSTimeInterval)holdDuration API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+/*!
+ * Scroll the view the specified pixels, x and y.
+ */
+- (void)scrollByDeltaX:(CGFloat)deltaX deltaY:(CGFloat)deltaY API_AVAILABLE(ios(15.0), macCatalyst(13.0));
+
+@end
+
+#endif // TARGET_OS_OSX || TARGET_OS_MACCATALYST || TARGET_OS_IOS
+
+/*! This category on XCUIElement provides functionality for automating UISlider and NSSlider. */
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementTypeSlider)
+
+/*! Manipulates the UI to change the displayed value of the slider to one based on a normalized position. 0 corresponds to the minimum value of the slider, 1 corresponds to its maximum value. The adjustment is a "best effort" to move the indicator to the desired position; absolute fidelity is not guaranteed. */
+- (void)adjustToNormalizedSliderPosition:(CGFloat)normalizedSliderPosition;
+
+/*! Returns the position of the slider's indicator as a normalized value where 0 corresponds to the minimum value of the slider and 1 corresponds to its maximum value. */
+@property (readonly) CGFloat normalizedSliderPosition;
+
+@end
+
+#if TARGET_OS_IOS
+
+/*! This category on XCUIElement provides functionality for automating the picker wheels of UIPickerViews and UIDatePickers. */
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementTypePickerWheel)
+
+/*! Changes the displayed value for the picker wheel. Will generate a test failure if the specified value is not available. */
+- (void)adjustToPickerWheelValue:(NSString *)pickerWheelValue;
+
+@end
+
+#endif // TARGET_OS_IOS
+
+XCUI_SWIFT_MAIN_ACTOR
+@protocol XCUIElementSnapshot <XCUIElementAttributes>
+
+@property (readonly) NSArray<id<XCUIElementSnapshot>> *children;
+
+/*!
+ * Returns a hierarchical dictionary representation with standard attributes for the element and all
+ * of its descendants. The dictionary keys are of type XCUIElementAttributeName. If the value for a given
+ * attribute is null, the key will not be present, but empty strings may be found in the dictionary.
+ */
+@property (readonly, copy) NSDictionary<XCUIElementAttributeName, id> *dictionaryRepresentation;
+
+@end
+
+XCUI_SWIFT_MAIN_ACTOR
+@protocol XCUIElementSnapshotProviding <NSObject>
+
+/*!
+ * Returns a hierarchical data structure with standard attributes for the element and its children.
+ */
+- (nullable id<XCUIElementSnapshot>)snapshotWithError:(NSError **)outError;
+
+@end
+
+XCUI_SWIFT_MAIN_ACTOR
+@interface XCUIElement (XCUIElementSnapshotProviding) <XCUIElementSnapshotProviding>
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCUIAutomation.framework/Headers/XCUIElementAttributes.h

@@ -0,0 +1,106 @@
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <XCUIAutomation/XCUIAutomationDefines.h>
+#import <XCUIAutomation/XCUIElementTypes.h>
+
+#if TARGET_OS_IPHONE
+
+#import <CoreGraphics/CoreGraphics.h>
+
+typedef NS_ENUM(NSInteger, XCUIUserInterfaceSizeClass) {
+    XCUIUserInterfaceSizeClassUnspecified = 0,
+    XCUIUserInterfaceSizeClassCompact     = 1,
+    XCUIUserInterfaceSizeClassRegular     = 2,
+};
+
+#else
+
+#import <AppKit/AppKit.h>
+
+typedef NS_ENUM(NSInteger, XCUIUserInterfaceSizeClass) {
+    XCUIUserInterfaceSizeClassUnspecified = 0,
+};
+
+#endif
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*! Protocol describing the attributes exposed on user interface elements and available during query matching. These attributes represent data exposed to the Accessibility system. */
+XCUI_SWIFT_MAIN_ACTOR
+@protocol XCUIElementAttributes
+
+/*! The accessibility identifier. */
+@property (readonly) NSString *identifier;
+
+/*! The frame of the element in the screen coordinate space. */
+@property (readonly) CGRect frame;
+
+/*! The raw value attribute of the element. Depending on the element, the actual type can vary. */
+@property (readonly, nullable) id value;
+
+/*! The title attribute of the element. */
+@property (readonly, copy) NSString *title;
+
+/*! The label attribute of the element. */
+@property (readonly, copy) NSString *label;
+
+/*! The type of the element. /seealso XCUIElementType. */
+@property (readonly) XCUIElementType elementType;
+
+/*! Whether or not the element is enabled for user interaction. */
+@property (readonly, getter = isEnabled) BOOL enabled;
+
+/*! The horizontal size class of the element. */
+@property (readonly) XCUIUserInterfaceSizeClass horizontalSizeClass;
+
+/*! The vertical size class of the element. */
+@property (readonly) XCUIUserInterfaceSizeClass verticalSizeClass;
+
+/*! The value that is displayed when the element has no value. */
+@property (readonly, nullable) NSString *placeholderValue;
+
+/*! Whether or not the element is selected. */
+@property (readonly, getter = isSelected) BOOL selected;
+
+#if !TARGET_OS_OSX
+/*! Whether or not the element has UI focus. */
+@property (readonly) BOOL hasFocus;
+#endif
+
+@end
+
+/*!
+ * @enum Constants for use with APIs that accept or return objects with element attributes specified,
+ * such as the dictionaries returned by XCUIElement.dictionaryRepresentation.
+ */
+typedef NSString * XCUIElementAttributeName NS_TYPED_ENUM;
+/// An array of the element's children.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameChildren;
+/// The element's type, an NSNumber-wrapped XCUIElementType.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameElementType;
+/// The element's accessibility identifier.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameIdentifier;
+/// The element's accessibility value, an NSString or NSNumber.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameValue;
+/// The element's placeholder value.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNamePlaceholderValue;
+/// The element's title.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameTitle;
+/// The element's label.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameLabel;
+/// A dictionary representation of the element's frame, as returned by CGRectCreateDictionaryRepresentation.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameFrame;
+/// True if the element is enabled, false otherwise, an NSNumber-wrapped BOOL.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameEnabled;
+/// True if the element is selected, false otherwise, an NSNumber-wrapped BOOL.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameSelected;
+/// True if the element is focused, false otherwise, an NSNumber-wrapped BOOL.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameHasFocus;
+/// The element's horizontal size class, an NSNumber-wrapped XCUIUserInterfaceSizeClass.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameHorizontalSizeClass;
+/// The element's vertical size class, an NSNumber-wrapped XCUIUserInterfaceSizeClass.
+XCUI_EXPORT XCUIElementAttributeName const XCUIElementAttributeNameVerticalSizeClass;
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCUIAutomation.framework/Headers/XCUIElementQuery.h

@@ -0,0 +1,81 @@
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <XCUIAutomation/XCUIAutomationDefines.h>
+
+#import <XCUIAutomation/XCUIElementTypes.h>
+#import <XCUIAutomation/XCUIElementTypeQueryProvider.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+XCUI_EXPORT NSString *XCUIIdentifierCloseWindow;
+XCUI_EXPORT NSString *XCUIIdentifierMinimizeWindow;
+XCUI_EXPORT NSString *XCUIIdentifierZoomWindow;
+XCUI_EXPORT NSString *XCUIIdentifierFullScreenWindow;
+
+@class XCUIElement;
+
+/*! Object for locating elements that can be chained with other queries. */
+@interface XCUIElementQuery : NSObject <XCUIElementTypeQueryProvider>
+
++ (instancetype)new XCUI_UNAVAILABLE("Use XCUIElementTypeQueryProvider methods on XCUIApplication or an existing XCUIElementQuery to create XCUIElementQuery instances.");
+- (instancetype)init XCUI_UNAVAILABLE("Use XCUIElementTypeQueryProvider methods on XCUIApplication or an existing XCUIElementQuery to create XCUIElementQuery instances.");
+
+/*! Returns an element that will use the query for resolution. */
+@property (readonly) XCUIElement *element;
+
+/*! Evaluates the query at the time it is called and returns the number of matches found. */
+@property (readonly) NSUInteger count;
+
+/*! Returns an element that will resolve to the index into the query's result set. */
+- (XCUIElement *)elementAtIndex:(NSUInteger)index
+    XCUI_DEPRECATED_WITH_DIRECT_REPLACEMENT("elementBoundByIndex:")
+    XCUI_DEPRECATED_WITH_SWIFT_REPLACEMENT("element(boundBy:)");
+
+/*! Returns an element that will use the index into the query's results to determine which underlying accessibility element it is matched with. */
+- (XCUIElement *)elementBoundByIndex:(NSUInteger)index;
+
+/*! Returns an element that matches the predicate. The predicate will be evaluated against objects of type id<XCUIElementAttributes>. */
+- (XCUIElement *)elementMatchingPredicate:(NSPredicate *)predicate;
+
+/*! Returns an element that matches the type and identifier. */
+- (XCUIElement *)elementMatchingType:(XCUIElementType)elementType identifier:(nullable NSString *)identifier;
+
+/*! Keyed subscripting is implemented as a shortcut for matching an identifier only. For example, app.descendants["Foo"] -> XCUIElement. */
+- (XCUIElement *)objectForKeyedSubscript:(NSString *)key;
+
+/*! Immediately evaluates the query and returns an array of elements bound to the resulting accessibility elements. */
+@property (readonly, copy) NSArray<XCUIElement *> *allElementsBoundByAccessibilityElement;
+
+/*! Immediately evaluates the query and returns an array of elements bound by the index of each result. */
+@property (readonly, copy) NSArray<XCUIElement *> *allElementsBoundByIndex;
+
+/*! Returns a new query that finds the descendants of all the elements found by the receiver. */
+- (XCUIElementQuery *)descendantsMatchingType:(XCUIElementType)type;
+
+/*! Returns a new query that finds the direct children of all the elements found by the receiver. */
+- (XCUIElementQuery *)childrenMatchingType:(XCUIElementType)type;
+
+/*! Returns a new query that applies the specified attributes or predicate to the receiver. The predicate will be evaluated against objects of type id<XCUIElementAttributes>. */
+- (XCUIElementQuery *)matchingPredicate:(NSPredicate *)predicate;
+- (XCUIElementQuery *)matchingType:(XCUIElementType)elementType identifier:(nullable NSString *)identifier;
+- (XCUIElementQuery *)matchingIdentifier:(NSString *)identifier;
+
+/*! Returns a new query for finding elements that contain a descendant matching the specification. The predicate will be evaluated against objects of type id<XCUIElementAttributes>. */
+- (XCUIElementQuery *)containingPredicate:(NSPredicate *)predicate;
+- (XCUIElementQuery *)containingType:(XCUIElementType)elementType identifier:(nullable NSString *)identifier;
+
+/*!
+ @discussion
+ Provides debugging information about the query. The data in the string will vary based on the time
+ at which it is captured, but it may include any of the following as well as additional data:
+    • A description of each step of the query.
+    • Information about the inputs and matched outputs of each step of the query.
+ This data should be used for debugging only - depending on any of the data as part of a test is unsupported.
+ */
+@property (readonly, copy) NSString *debugDescription;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/drivers/ios/devicelab-ios-agent/simulator/DevicelabIOSAgentUITests-Runner.app/Frameworks/XCUIAutomation.framework/Headers/XCUIElementTypeQueryProvider.h

@@ -0,0 +1,109 @@
+//
+//  Copyright (c) 2015 Apple Inc. All rights reserved.
+//
+
+#import <XCUIAutomation/XCUIAutomationDefines.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class XCUIElement;
+@class XCUIElementQuery;
+
+XCUI_SWIFT_MAIN_ACTOR
+@protocol XCUIElementTypeQueryProvider
+
+@property (readonly, copy) XCUIElementQuery *touchBars;
+@property (readonly, copy) XCUIElementQuery *groups;
+@property (readonly, copy) XCUIElementQuery *windows;
+@property (readonly, copy) XCUIElementQuery *sheets;
+@property (readonly, copy) XCUIElementQuery *drawers;
+@property (readonly, copy) XCUIElementQuery *alerts;
+@property (readonly, copy) XCUIElementQuery *dialogs;
+@property (readonly, copy) XCUIElementQuery *buttons;
+@property (readonly, copy) XCUIElementQuery *radioButtons;
+@property (readonly, copy) XCUIElementQuery *radioGroups;
+@property (readonly, copy) XCUIElementQuery *checkBoxes;
+@property (readonly, copy) XCUIElementQuery *disclosureTriangles;
+@property (readonly, copy) XCUIElementQuery *popUpButtons;
+@property (readonly, copy) XCUIElementQuery *comboBoxes;
+@property (readonly, copy) XCUIElementQuery *menuButtons;
+@property (readonly, copy) XCUIElementQuery *toolbarButtons;
+@property (readonly, copy) XCUIElementQuery *popovers;
+@property (readonly, copy) XCUIElementQuery *keyboards;
+@property (readonly, copy) XCUIElementQuery *keys;
+@property (readonly, copy) XCUIElementQuery *navigationBars;
+@property (readonly, copy) XCUIElementQuery *tabBars;
+@property (readonly, copy) XCUIElementQuery *tabGroups;
+@property (readonly, copy) XCUIElementQuery *toolbars;
+@property (readonly, copy) XCUIElementQuery *statusBars;
+@property (readonly, copy) XCUIElementQuery *tables;
+@property (readonly, copy) XCUIElementQuery *tableRows;
+@property (readonly, copy) XCUIElementQuery *tableColumns;
+@property (readonly, copy) XCUIElementQuery *outlines;
+@property (readonly, copy) XCUIElementQuery *outlineRows;
+@property (readonly, copy) XCUIElementQuery *disclosedChildRows;
+@property (readonly, copy) XCUIElementQuery *browsers;
+@property (readonly, copy) XCUIElementQuery *collectionViews;
+@property (readonly, copy) XCUIElementQuery *sliders;
+@property (readonly, copy) XCUIElementQuery *pageIndicators;
+@property (readonly, copy) XCUIElementQuery *progressIndicators;
+@property (readonly, copy) XCUIElementQuery *activityIndicators;
+@property (readonly, copy) XCUIElementQuery *segmentedControls;
+@property (readonly, copy) XCUIElementQuery *pickers;
+@property (readonly, copy) XCUIElementQuery *pickerWheels;
+@property (readonly, copy) XCUIElementQuery *switches;
+@property (readonly, copy) XCUIElementQuery *toggles;
+@property (readonly, copy) XCUIElementQuery *links;
+@property (readonly, copy) XCUIElementQuery *images;
+@property (readonly, copy) XCUIElementQuery *icons;
+@property (readonly, copy) XCUIElementQuery *searchFields;
+@property (readonly, copy) XCUIElementQuery *scrollViews;
+@property (readonly, copy) XCUIElementQuery *scrollBars;
+@property (readonly, copy) XCUIElementQuery *staticTexts;
+@property (readonly, copy) XCUIElementQuery *textFields;
+@property (readonly, copy) XCUIElementQuery *secureTextFields;
+@property (readonly, copy) XCUIElementQuery *datePickers;
+@property (readonly, copy) XCUIElementQuery *textViews;
+@property (readonly, copy) XCUIElementQuery *menus;
+@property (readonly, copy) XCUIElementQuery *menuItems;
+@property (readonly, copy) XCUIElementQuery *menuBars;
+@property (readonly, copy) XCUIElementQuery *menuBarItems;
+@property (readonly, copy) XCUIElementQuery *maps;
+@property (readonly, copy) XCUIElementQuery *webViews;
+@property (readonly, copy) XCUIElementQuery *steppers;
+@property (readonly, copy) XCUIElementQuery *incrementArrows;
+@property (readonly, copy) XCUIElementQuery *decrementArrows;
+@property (readonly, copy) XCUIElementQuery *tabs;
+@property (readonly, copy) XCUIElementQuery *timelines;
+@property (readonly, copy) XCUIElementQuery *ratingIndicators;
+@property (readonly, copy) XCUIElementQuery *valueIndicators;
+@property (readonly, copy) XCUIElementQuery *splitGroups;
+@property (readonly, copy) XCUIElementQuery *splitters;
+@property (readonly, copy) XCUIElementQuery *relevanceIndicators;
+@property (readonly, copy) XCUIElementQuery *colorWells;
+@property (readonly, copy) XCUIElementQuery *helpTags;
+@property (readonly, copy) XCUIElementQuery *mattes;
+@property (readonly, copy) XCUIElementQuery *dockItems;
+@property (readonly, copy) XCUIElementQuery *rulers;
+@property (readonly, copy) XCUIElementQuery *rulerMarkers;
+@property (readonly, copy) XCUIElementQuery *grids;
+@property (readonly, copy) XCUIElementQuery *levelIndicators;
+@property (readonly, copy) XCUIElementQuery *cells;
+@property (readonly, copy) XCUIElementQuery *layoutAreas;
+@property (readonly, copy) XCUIElementQuery *layoutItems;
+@property (readonly, copy) XCUIElementQuery *handles;
+@property (readonly, copy) XCUIElementQuery *otherElements;
+@property (readonly, copy) XCUIElementQuery *statusItems;
+
+/*!
+ * Returns an element that will use the query for resolution. This changes how the query is resolved
+ * at runtime; instead of evaluating against every element in the user interface, `firstMatch` stops
+ * the search as soon as a single matching element is found. This can result in significantly faster
+ * evaluation if the element is located early in a large view hierarchy but also means that multiple
+ * matches will not be detected.
+ */
+@property (readonly) XCUIElement *firstMatch;
+
+@end
+
+NS_ASSUME_NONNULL_END