Add implementations for NSAccessibilityCustomRotor/Action and changes to related classes

Headers/Additions/GNUstepGUI/GSViewAccessibilityData.h

@@ -0,0 +1,101 @@
+/** <title>GSViewAccessibilityData</title>
+
+   <abstract>Encapsulates accessibility properties for NSView</abstract>
+
+   Author: Gregory Casamento <greg.casamento@gmail.com>
+   Copyright (C) 2026 Free Software Foundation, Inc.
+
+   This file is part of the GNUstep GUI Library.
+
+   This library is free software; you can redistribute it and/or
+   modify it under the terms of the GNU Lesser General Public
+   License as published by the Free Software Foundation; either
+   version 2 of the License, or (at your option) any later version.
+
+   This library is distributed in the hope that it will be useful,
+   but WITHOUT ANY WARRANTY; without even the implied warranty of
+   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU
+   Lesser General Public License for more details.
+
+   You should have received a copy of the GNU Lesser General Public
+   License along with this library; see the file COPYING.LIB.
+   If not, see <http://www.gnu.org/licenses/> or write to the 
+   Free Software Foundation, 51 Franklin Street, Fifth Floor, 
+   Boston, MA 02110-1301, USA.
+*/
+
+#ifndef _GNUstep_H_GSViewAccessibilityData
+#define _GNUstep_H_GSViewAccessibilityData
+
+#import <Foundation/NSObject.h>
+#import <AppKit/NSAccessibilityConstants.h>
+
+@class NSString;
+@class NSArray;
+
+/**
+ * GSViewAccessibilityData encapsulates all accessibility-related properties
+ * for NSView instances. This allows views to only allocate this object when
+ * accessibility functionality is actually needed, reducing memory overhead.
+ */
+@interface GSViewAccessibilityData : NSObject
+{
+@private
+  NSString *_accessibilityLabel;
+  NSString *_accessibilityValue;
+  NSString *_accessibilityHelp;
+  NSAccessibilityRole _accessibilityRole;
+  NSString *_accessibilityTitle;
+  NSString *_accessibilityRoleDescription;
+  NSString *_accessibilityIdentifier;
+  NSArray *_accessibilityUserInputLabels;
+  NSArray *_accessibilityChildren;
+  NSArray *_accessibilityCustomActions;
+  id _accessibilityParent;            // weak reference
+  BOOL _accessibilityFocused;
+  BOOL _accessibilityEnabled;
+}
+
+// Property accessors
+- (NSString *) accessibilityLabel;
+- (void) setAccessibilityLabel: (NSString *)label;
+
+- (NSString *) accessibilityValue;
+- (void) setAccessibilityValue: (NSString *)value;
+
+- (NSString *) accessibilityHelp;
+- (void) setAccessibilityHelp: (NSString *)help;
+
+- (NSAccessibilityRole) accessibilityRole;
+- (void) setAccessibilityRole: (NSAccessibilityRole)role;
+
+- (NSString *) accessibilityTitle;
+- (void) setAccessibilityTitle: (NSString *)title;
+
+- (NSString *) accessibilityRoleDescription;
+- (void) setAccessibilityRoleDescription: (NSString *)roleDescription;
+
+- (NSString *) accessibilityIdentifier;
+- (void) setAccessibilityIdentifier: (NSString *)identifier;
+
+- (NSArray *) accessibilityUserInputLabels;
+- (void) setAccessibilityUserInputLabels: (NSArray *)labels;
+
+- (NSArray *) accessibilityChildren;
+- (void) setAccessibilityChildren: (NSArray *)children;
+
+- (NSArray *) accessibilityCustomActions;
+- (void) setAccessibilityCustomActions: (NSArray *)actions;
+
+- (id) accessibilityParent;
+- (void) setAccessibilityParent: (id)parent;
+
+- (BOOL) isAccessibilityFocused;
+- (void) setAccessibilityFocused: (BOOL)focused;
+
+- (BOOL) isAccessibilityEnabled;
+- (void) setAccessibilityEnabled: (BOOL)enabled;
+
+@end
+
+#endif // _GNUstep_H_GSViewAccessibilityData

Headers/AppKit/NSAccessibilityConstants.h

@@ -32,6 +32,16 @@
 #import <AppKit/AppKitDefines.h>
 #import <Foundation/Foundation.h>
 
+// MARK: - Type Definitions
+
+typedef NSString * NSAccessibilityRole;
+typedef NSString * NSAccessibilitySubrole;
+typedef NSString * NSAccessibilityAttribute;
+typedef NSString * NSAccessibilityAction;
+typedef NSString * NSAccessibilityNotification;
+
+// MARK: - Error Information
+
 APPKIT_EXPORT NSString *const NSAccessibilityErrorCodeExceptionInfo;
 
 APPKIT_EXPORT NSString *const NSAccessibilityRoleAttribute;

Headers/AppKit/NSAccessibilityCustomAction.h

@@ -1,21 +1,21 @@
 /* Interface of class NSAccessibilityCustomAction
    Copyright (C) 2020 Free Software Foundation, Inc.
-   
+
    By: Gregory John Casamento
    Date: Mon 15 Jun 2020 03:18:47 AM EDT
 
    This file is part of the GNUstep Library.
-   
+
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.
-   
+
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.
-   
+
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
@@ -35,7 +35,13 @@ extern "C" {
 #endif
 
 DEFINE_BLOCK_TYPE(GSAccessibilityCustomActionHandler, void, BOOL);
-
+
+/**
+ * This class defines an accessibility action to be taken for a
+ * given accessibility object. An instance of this object should
+ * be added to accessibilityCustomActions so that it is
+ * accessible by the NSAccessibilityCustomRotor.
+ */
 APPKIT_EXPORT_CLASS
 @interface NSAccessibilityCustomAction : NSObject
 {
@@ -45,25 +51,81 @@ APPKIT_EXPORT_CLASS
   SEL _selector;
 }
 
+/**
+ * Create an action with a name and handler
+ */
 - (instancetype) initWithName: (NSString *)name
-                      handler: (GSAccessibilityCustomActionHandler)handler;
+		      handler: (GSAccessibilityCustomActionHandler)handler;
 
+/**
+ * Create an action with a name, handler, and selector.
+ */
 - (instancetype) initWithName: (NSString *)name
-                       target: (id)target
-                     selector: (SEL)selector;
+		       target: (id)target
+		     selector: (SEL)selector;
 
+/**
+ * Return name
+ */
 - (NSString *) name;
+
+/**
+ * Set name
+ */
 - (void) setName: (NSString *)name;
-
+
+/**
+ * Return handler
+ */
 - (GSAccessibilityCustomActionHandler) handler;
+
+/**
+ * Set handler
+ */
 - (void) setHandler: (GSAccessibilityCustomActionHandler)handler;
 
+/**
+ * Return target
+ */
 - (id) target;
+
+/**
+ * Set target
+ */
 - (void) setTarget: (id)target;
 
+/**
+ * Return selector
+ */
 - (SEL) selector;
+
+/**
+ * Set selector
+ */
 - (void) setSelector: (SEL)selector;
-
+
+@end
+
+@interface NSAccessibilityCustomAction (GNUstep)
+
+/**
+ * Convenience factory returning an autoreleased custom action that invokes a block.
+ */
++ (instancetype) actionWithName: (NSString *)name
+			 handler: (GSAccessibilityCustomActionHandler)handler;
+
+/**
+ * Convenience factory returning an autoreleased custom action that sends selector to target.
+ */
++ (instancetype) actionWithName: (NSString *)name
+			  target: (id)target
+			selector: (SEL)selector;
+
+/**
+ * Perform the custom action. Returns YES on success (block executed or target responded)
+ */
+- (BOOL) perform;
+
 @end
 
 #if	defined(__cplusplus)
@@ -73,4 +135,3 @@ APPKIT_EXPORT_CLASS
 #endif	/* GS_API_MACOSX */
 
 #endif	/* _NSAccessibilityCustomAction_h_GNUSTEP_GUI_INCLUDE */
-

Headers/AppKit/NSAccessibilityCustomRotor.h

@@ -1,21 +1,21 @@
 /* Interface of class NSAccessibilityCustomRotor
    Copyright (C) 2020 Free Software Foundation, Inc.
-   
+
    By: Gregory John Casamento
    Date: Mon 15 Jun 2020 03:18:59 AM EDT
 
    This file is part of the GNUstep Library.
-   
+
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.
-   
+
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.
-   
+
    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
@@ -46,14 +46,14 @@ extern "C" {
 @class NSAccessibilityCustomRotorSearchParameters;
 @class NSString;
 @class NSAccessibilityElement;
-  
+
 enum
   {
    NSAccessibilityCustomRotorSearchDirectionPrevious,
    NSAccessibilityCustomRotorSearchDirectionNext,
 };
 typedef NSInteger NSAccessibilityCustomRotorSearchDirection;
-  
+
 enum
   {
    NSAccessibilityCustomRotorTypeCustom = 0,
@@ -77,13 +77,19 @@ enum
    NSAccessibilityCustomRotorTypeTextField,
    NSAccessibilityCustomRotorTypeUnderlinedText,
    NSAccessibilityCustomRotorTypeVisitedLink,
-}; 
+};
 typedef NSInteger NSAccessibilityCustomRotorType;
 
 // Rotor...
 APPKIT_EXPORT_CLASS
 @interface NSAccessibilityCustomRotor : NSObject
-
+{
+  NSString *_label;
+  id<NSAccessibilityCustomRotorItemSearchDelegate> _itemSearchDelegate;
+  id<NSAccessibilityElementLoading> _itemLoadingDelegate;
+  NSAccessibilityCustomRotorType _type;
+}
+
 - (instancetype) initWithLabel: (NSString *)label
                    itemSearchDelegate: (id<NSAccessibilityCustomRotorItemSearchDelegate>)delegate;
 
@@ -101,20 +107,26 @@ APPKIT_EXPORT_CLASS
 
 - (id<NSAccessibilityElementLoading>) itemLoadingDelegate;
 - (void) setItemLoadingDelegate: (id<NSAccessibilityElementLoading>) delegate;
-  
+
 @end
 
 // Results...
 APPKIT_EXPORT_CLASS
 @interface NSAccessibilityCustomRotorItemResult : NSObject
+{
+  id<NSAccessibilityElement> _targetElement;
+  id<NSAccessibilityLoadingToken> _itemLoadingToken;
+  NSString *_customLabel;
+  NSRange _targetRange;
+}
 
 - (instancetype)initWithTargetElement:(id<NSAccessibilityElement>)targetElement;
 
 - (instancetype)initWithItemLoadingToken: (id<NSAccessibilityLoadingToken>)token
                              customLabel: (NSString *)customLabel;
 
 - (id<NSAccessibilityElement>) targetElement;
-  
+
 - (id<NSAccessibilityLoadingToken>) itemLoadingToken;
 
 - (NSRange) targetRange;