Skip to content

AppKit macOS xcode27.2 b3

Jump to bottom
Alex Soto edited this page Oct 17, 2026 · 1 revision

#AppKit.framework

diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorSampler.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorSampler.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorSampler.h	2026-08-14 22:48:02
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorSampler.h	2026-10-08 04:36:53
@@ -22,7 +22,7 @@
 /*!
  * The primary method for NSColorSampler.
  *
- * Begins or attaches to an existing color sampling session which presents UI to the user for selecting a color from their screen. The handler will be called on the main thread when the user completes the session (either by selection, or cancelation). In the event of user-cancellation, `colorSelectionHandler` will be called with `nil`.
+ * Begins or attaches to an existing color sampling session which presents UI to the user for selecting a color from their screen. The handler will be called on the main thread when the user completes the session (either by selection, or cancelation). In the event of user-cancellation, `selectionHandler` will be called with `nil`.
  *
  * The calling NSColorSampler instance is retained until the sampling session is completed.
  */
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDragging.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDragging.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDragging.h	2026-08-14 22:47:54
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDragging.h	2026-10-08 04:36:44
@@ -55,7 +55,7 @@
     NSDraggingItemEnumerationClearNonenumeratedImages 	= (1UL << 16),
 } API_AVAILABLE(macos(10.7));
 
-/* The spring loading highlight styles roughly correlate to {None: NotSpringLoadable, Light: SpringLoadable, Dark: SpringLoadingEngaged}. However, this not not strictly true as Drag & Drop may switch between highlight styles as an animated signal to the user. */
+/* The spring loading highlight styles roughly correlate to {None: NotSpringLoadable, Light: SpringLoadable, Dark: SpringLoadingEngaged}. However, this is not strictly true as Drag & Drop may switch between highlight styles as an animated signal to the user. */
 typedef NS_ENUM(NSInteger, NSSpringLoadingHighlight) {
     NSSpringLoadingHighlightNone = 0,
     NSSpringLoadingHighlightStandard,
@@ -79,13 +79,14 @@
 @property (readonly) NSPasteboard *draggingPasteboard NS_SWIFT_UI_ACTOR;
 @property (nullable, readonly) id draggingSource NS_SWIFT_UI_ACTOR;
 @property (readonly) NSInteger draggingSequenceNumber NS_SWIFT_UI_ACTOR;
+
 - (void)slideDraggedImageTo:(NSPoint)screenPoint NS_SWIFT_UI_ACTOR;
 - (nullable NSArray<NSString *> *)namesOfPromisedFilesDroppedAtDestination:(NSURL *)dropDestination API_DEPRECATED("Use NSFilePromiseReceiver objects instead", macos(10.0,10.13));
 
 /* Controls the dragging formation while the drag is over this destination. The default value is the current drag formation. */
 @property NSDraggingFormation draggingFormation NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.7));
 
-/* During the conclusion of an accepted drag, if this property is set to YES, the drag manager will animate each dragging image to their NSDraggingFormationNone locations. Otherwise, the drag images are removed without any animation. Note: This property is inspected between -prepareForDragOperation: and -performDragOperation:. If the final destination frames do not match the current NSDraggingFormationNone frames, then enumerate through the draggingItems during -performDragOperation: to set thier NSDraggingFormationNone frames to the correct destinations.
+/* During the conclusion of an accepted drag, if this property is set to YES, the drag manager will animate each dragging image to their NSDraggingFormationNone locations. Otherwise, the drag images are removed without any animation. Note: This property is inspected between -prepareForDragOperation: and -performDragOperation:. If the final destination frames do not match the current NSDraggingFormationNone frames, then enumerate through the draggingItems during -performDragOperation: to set their NSDraggingFormationNone frames to the correct destinations.
  */
 @property BOOL animatesToDestination NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.7));
 
@@ -137,7 +138,7 @@
 */
 
 @required 
-/* Declares what types of operations the source allows to be performed. Apple may provide more specific "within" values in the future. To account for this, for unrecongized localities, return the operation mask for the most specific context that you are concerned with. For example:
+/* Declares what types of operations the source allows to be performed. Apple may provide more specific "within" values in the future. To account for this, for unrecognized localities, return the operation mask for the most specific context that you are concerned with. For example:
     switch(context) {
         case NSDraggingContextOutsideApplication:
             return ...
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDraggingItem.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDraggingItem.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDraggingItem.h	2026-08-14 22:47:58
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSDraggingItem.h	2026-10-08 04:36:49
@@ -29,7 +29,7 @@
 - (instancetype)initWithKey:(NSDraggingImageComponentKey)key NS_DESIGNATED_INITIALIZER;
 - (instancetype)init NS_UNAVAILABLE;
 
-/* key must be unique for each component in an NSDraggingItem. You can create your own named components, but the following names have special meaning. NSDraggingImageComponentIconKey is an image of the item being dragged. NSDraggingImageComponentLabelKey represents a textual label associate with the item, for example, a file name.
+/* key must be unique for each component in an NSDraggingItem. You can create your own named components, but the following names have special meaning. NSDraggingImageComponentIconKey is an image of the item being dragged. NSDraggingImageComponentLabelKey represents a textual label associated with the item, for example, a file name.
 */
 @property (copy) NSDraggingImageComponentKey key;
 
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSGestureRecognizer.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSGestureRecognizer.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSGestureRecognizer.h	2026-08-14 22:47:57
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSGestureRecognizer.h	2026-10-08 04:36:48
@@ -82,6 +82,10 @@
 - (NSPoint)locationInView:(nullable NSView*)view;
 
 @property (nullable, copy) NSString *name API_AVAILABLE(macos(26.0));
+
+/// The keyboard modifier flags in effect while the receiver last processed an event.
+///
+/// Use this property from an action method or delegate callback to determine which modifier keys, such as Shift or Command, were held down as part of the gesture.
 @property (readonly) NSEventModifierFlags modifierFlags API_AVAILABLE(macos(26.0));
 
 @end
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h	2026-08-14 22:47:59
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h	2026-10-08 04:36:50
@@ -825,6 +825,7 @@
 - (CADisplayLink *)displayLinkWithTarget:(id)target selector:(SEL)selector NS_SWIFT_NAME(displayLink(target:selector:));
 @end
 
+
 @protocol NSWindowDelegate <NSObject>
 @optional
 - (BOOL)windowShouldClose:(NSWindow *)sender NS_SWIFT_UI_ACTOR;
diff -ruN /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h
--- /Applications/Xcode_27.1.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h	2026-08-14 22:47:55
+++ /Applications/Xcode_27.2.0-beta3.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h	2026-10-08 04:36:46
@@ -846,10 +846,16 @@
 /// into an image with a transparent background and use that image to create your
 /// ``NSTextPreview`` object directly. Set the ``NSTextPreview/presentationFrame``
 /// property to the rectangle in your view’s coordinate space that contains the
-/// text you captured. Set the ``NSTextPreview/candidateRects`` property to the
-/// selection rectangles for the text, which you get from your view’s layout manager.
-/// Writing Tools uses this information to place your image directly above the text in your view.
+/// text you captured. Set the ``NSTextPreview/candidateRects`` property to an
+/// array containing one rectangle per line of the selected text, which you get
+/// from your view’s layout manager.
 ///
+/// - Important: Provide one rectangle per line in `candidateRects`. Writing
+///   Tools uses each rectangle to animate its line independently, producing a
+///   bounce effect. If you provide a single rectangle that spans the entire
+///   range instead, Writing Tools can only animate the text as one unit, which
+///   produces a shimmer instead of a bounce.
+///
 /// For a single animation type, the system calls the
 /// ``writingToolsCoordinator(_:prepareFor:for:in:completion:)``
 /// method, followed sequentially by this method and then the
@@ -885,9 +891,14 @@
 /// of your view into an image with a transparent background and use that image
 /// to create your ``NSTextPreview`` object directly. Set the ``NSTextPreview/presentationFrame``
 /// property to the specified rectangle. Set the ``NSTextPreview/candidateRects``
-/// property to the selection rectangles for the associated text, which you get
-/// from your view’s layout manager. Writing Tools uses this information to
-/// place your image directly above the text in your view.
+/// property to an array containing one rectangle per line of the associated
+/// text, which you get from your view’s layout manager.
+///
+/// - Important: Provide one rectangle per line in `candidateRects`. Writing
+///   Tools uses each rectangle to animate its line independently, producing a
+///   bounce effect. If you provide a single rectangle that spans the entire
+///   range instead, Writing Tools can only animate the text as one unit, which
+///   produces a shimmer instead of a bounce.
 ///
 /// For a single animation type, the system calls the
 /// ``writingToolsCoordinator(_:prepareFor:for:in:completion:)``

Contributing

Bindings

Tips & tricks

Clone this wiki locally