feat(accessibility): add modifiers, actions, and focus support (#1117)

Author: Kyle-Ye

Sources/COpenSwiftUI/Overlay/Accessibility/OpenSwiftUIAccessibilityPrivate.m

@@ -8,7 +8,7 @@
 #import "OpenSwiftUIAccessibilityPrivate.h"
 #import "../Foundation/OpenSwiftUI+NSObject.h"
 
-#if OPENSWIFTUI_TARGET_OS_IOS || OPENSWIFTUI_TARGET_OS_VISION || OPENSWIFTUI_TARGET_OS_OSX
+#if OPENSWIFTUI_TARGET_OS_DARWIN
 
 #import <objc/runtime.h>
 
@@ -55,4 +55,4 @@ - (void)set_accessibilityAllowsAutomationElements:(BOOL)value {
 #endif
 @end
 
-#endif /* OPENSWIFTUI_TARGET_OS_IOS || OPENSWIFTUI_TARGET_OS_VISION || OPENSWIFTUI_TARGET_OS_OSX */
+#endif /* OPENSWIFTUI_TARGET_OS_DARWIN */

Sources/COpenSwiftUI/Overlay/Foundation/OpenSwiftUI+NSKeyedUnarchiver.h

@@ -0,0 +1,31 @@
+//
+//  OpenSwiftUI+NSKeyedUnarchiver.h
+//  COpenSwiftUI
+//
+//  Audited for 6.5.4
+//  Status: Complete
+
+#ifndef OpenSwiftUI_NSKeyedUnarchiver_h
+#define OpenSwiftUI_NSKeyedUnarchiver_h
+
+#include "OpenSwiftUIBase.h"
+
+#if OPENSWIFTUI_TARGET_OS_DARWIN
+
+#import <Foundation/Foundation.h>
+
+OPENSWIFTUI_ASSUME_NONNULL_BEGIN
+
+@interface NSKeyedUnarchiver (OpenSwiftUI)
+// Preserve nil results when no NSError is reported.
++ (NSObject * _Nullable)openswiftui_unarchiveTopLevelLNActionWithData:(NSData *)data
+                                                             error:(NSError * _Nullable * _Nullable)error
+    __attribute__((swift_error(nonnull_error)))
+    NS_SWIFT_NAME(openswiftui_unarchiveTopLevelLNAction(with:));
+@end
+
+OPENSWIFTUI_ASSUME_NONNULL_END
+
+#endif /* OPENSWIFTUI_TARGET_OS_DARWIN */
+
+#endif /* OpenSwiftUI_NSKeyedUnarchiver_h */

Sources/COpenSwiftUI/Overlay/Foundation/OpenSwiftUI+NSKeyedUnarchiver.m

@@ -0,0 +1,22 @@
+//
+//  OpenSwiftUI+NSKeyedUnarchiver.m
+//  COpenSwiftUI
+//
+//  Audited for 6.5.4
+//  Status: Complete
+
+#import "OpenSwiftUI+NSKeyedUnarchiver.h"
+
+#if OPENSWIFTUI_TARGET_OS_DARWIN
+
+@implementation NSKeyedUnarchiver (OpenSwiftUI)
++ (NSObject * _Nullable)openswiftui_unarchiveTopLevelLNActionWithData:(NSData *)data
+                                                             error:(NSError * _Nullable * _Nullable)error {
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
+    return [self unarchiveTopLevelObjectWithData:data error:error];
+#pragma clang diagnostic pop
+}
+@end
+
+#endif /* OPENSWIFTUI_TARGET_OS_DARWIN */

Sources/COpenSwiftUI/Shims/AppKit/AppKit_Private.h

@@ -20,6 +20,9 @@ OPENSWIFTUI_EXTERN_C_BEGIN
 OPENSWIFTUI_EXPORT
 Class _Nullable AXNSTableViewCellMockElementClass(void);
 
+OPENSWIFTUI_EXPORT
+Class _Nullable AXNSTableRowClass(void);
+
 OPENSWIFTUI_EXPORT
 void NSAccessibilityBeginInternalAccessors(void);
 
@@ -29,8 +32,28 @@ void NSAccessibilityEndInternalAccessors(void);
 OPENSWIFTUI_EXPORT
 id _Nullable NSAccessibilityEntryPointValueForAttribute(id element, NSAccessibilityAttributeName attribute);
 
+OPENSWIFTUI_EXPORT
+NSArray * _Nullable NSAccessibilityEntryPointActionNames(id element);
+
+OPENSWIFTUI_EXPORT
+NSString * _Nullable NSAccessibilityEntryPointActionDescription(id element, NSAccessibilityActionName action);
+
+OPENSWIFTUI_EXPORT
+BOOL NSAccessibilityEntryPointPerformAction(id element, NSAccessibilityActionName action);
+
+OPENSWIFTUI_EXPORT
+NSAccessibilityAttributeName const NSAccessibilityIsAccessibilityElementAttribute;
+
+OPENSWIFTUI_EXPORT
+NSAccessibilityAttributeName const NSAccessibilityAttributedUserInputLabelsAttribute;
+
 OPENSWIFTUI_EXTERN_C_END
 
+@interface NSObject (OpenSwiftUI_SPI)
+- (BOOL)_accessibilitySetOverrideValue:(nullable id)value forAttribute:(NSAccessibilityAttributeName)attribute OPENSWIFTUI_SWIFT_NAME(_accessibilitySetOverrideValue(_:for:));
+- (BOOL)_accessibilitySetOverrideHandler:(id _Nullable (^ _Nullable)(void))handler forAttribute:(NSAccessibilityAttributeName)attribute OPENSWIFTUI_SWIFT_NAME(_accessibilitySetOverrideHandler(_:for:));
+@end
+
 @interface NSApplication (OpenSwiftUI_SPI)
 
 - (BOOL)_shouldLoadMainNibNamed:(nullable NSString *)name;
@@ -69,6 +92,23 @@ typedef OPENSWIFTUI_ENUM(NSInteger, NSViewVibrantBlendingStyle) {
 @property (nullable, copy) NSString *_defaultAccessibilityDescription;
 @end
 
+@interface NSWorkspace (OpenSwiftUI_SPI)
+@property (readonly, getter=isAccessibilityFullKeyboardAccessEnabled) BOOL accessibilityFullKeyboardAccessEnabled;
+@end
+
+@interface NSView (OpenSwiftUI_SPI)
+- (nullable id)accessibilityFocusedUIElement;
+@end
+
+@interface NSAccessibilityRemoteUIElement : NSObject
++ (BOOL)isRemoteUIApp;
+@end
+
+@protocol NSWindowSwiftUIDelegate <NSObject>
+@optional
+- (nullable id)_accessibilityWindow:(NSWindow *)window focusedUIElementOverrideWithCurrentValue:(nullable id)currentValue;
+@end
+
 OPENSWIFTUI_ASSUME_NONNULL_END
 
 #endif /* __has_include(<AppKit/AppKit.h>) */

Sources/COpenSwiftUI/Shims/AppKit/AppKit_Private.m

@@ -11,6 +11,15 @@
 
 #import <objc/runtime.h>
 
+Class _Nullable AXNSTableRowClass(void) {
+    static Class tableRowClass;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+        tableRowClass = NSClassFromString(@"NSTableRow");
+    });
+    return tableRowClass;
+}
+
 Class _Nullable AXNSTableViewCellMockElementClass(void) {
     static Class tableViewCellMockElementClass;
     static dispatch_once_t onceToken;

Sources/COpenSwiftUI/Shims/UIKit/UIKit_Private.h

@@ -19,6 +19,13 @@
 
 OPENSWIFTUI_ASSUME_NONNULL_BEGIN
 
+@interface NSObject (OpenSwiftUIAccessibility)
+- (nullable UITextRange *)_textRangeFromNSRange:(NSRange)range OPENSWIFTUI_SWIFT_NAME(_textRange(from:));
+- (NSRange)_nsrangeForTextRange:(UITextRange *)range OPENSWIFTUI_SWIFT_NAME(_nsrange(for:));
+- (nullable id)_textInputForReveal;
+- (NSComparisonResult)accessibilityCompareGeometry:(NSObject *)element;
+@end
+
 @interface UIApplication (OpenSwiftUI_SPI)
 - (nullable NSString *)_extendLaunchTest;
 - (BOOL)_supportsPrintCommand;
@@ -35,6 +42,7 @@ OPENSWIFTUI_ASSUME_NONNULL_BEGIN
 @end
 
 @interface UIView (OpenSwiftUI_SPI)
+- (nullable id<UILargeContentViewerItem>)_largeContentViewerItemAtPoint:(CGPoint)point OPENSWIFTUI_SWIFT_NAME(_largeContentViewerItem(at:));
 - (instancetype)_initWithLayer:(CALayer *)layer;
 - (void)_geometryChanged:(const void *)geometry forAncestor:(nullable UIView *)ancestor;
 - (void)_registerForGeometryChanges;