-
Notifications
You must be signed in to change notification settings - Fork 558
AppKit macOS xcode26.4 b2
Rolf Bjarne Kvinge edited this page Feb 27, 2026
·
1 revision
#AppKit.framework
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSButtonTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSButtonTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSButtonTouchBarItem.h 2025-11-20 06:44:09
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSButtonTouchBarItem.h 2026-02-16 07:22:50
@@ -46,7 +46,7 @@
@property (getter=isEnabled) BOOL enabled;
-/// The localized string labelling this item during user customization. The default value is empty string.
+/// The localized string labeling this item during user customization. The default value is empty string.
@property (readwrite, copy, null_resettable) NSString *customizationLabel;
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColor.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColor.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColor.h 2025-11-20 06:44:02
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColor.h 2026-02-16 07:22:42
@@ -261,18 +261,18 @@
@property (class, strong, readonly) NSColor *systemMintColor API_AVAILABLE(macos(10.12));
@property (class, strong, readonly) NSColor *systemCyanColor API_AVAILABLE(macos(12.0));
-/*! Fill colors for UI elements.
- These are meant to be used over the background colors, since their alpha component is less than 1.
- */
-/// systemFillColor is appropriate for filling thin shapes, such as the track of a slider.
+// Fill colors for UI elements.
+// These are meant to be used over the background colors, since their alpha component is less than 1.
+
+/// A color appropriate for filling thin shapes, such as the track of a slider.
@property (class, strong, readonly) NSColor *systemFillColor API_AVAILABLE(macos(14.0));
-/// secondarySystemFillColor is appropriate for filling small-size shapes, such as the backing of a progress indicator.
+/// A color appropriate for filling small-size shapes, such as the backing of a progress indicator.
@property (class, strong, readonly) NSColor *secondarySystemFillColor API_AVAILABLE(macos(14.0));
-/// tertiarySystemFillColor is appropriate for filling medium-size shapes, such as the backing of a switch.
+/// A color appropriate for filling medium-size shapes, such as the backing of a switch.
@property (class, strong, readonly) NSColor *tertiarySystemFillColor API_AVAILABLE(macos(14.0));
-/// quaternarySystemFillColor is appropriate for filling large areas, such as a group box or tab pane.
+/// A color appropriate for filling large areas, such as a group box or tab pane.
@property (class, strong, readonly) NSColor *quaternarySystemFillColor API_AVAILABLE(macos(14.0));
-/// quinarySystemFillColor is appropriate for filling large areas that require subtle emphasis, such as content of a form..
+/// A color appropriate for filling large areas that require subtle emphasis, such as content of a form.
@property (class, strong, readonly) NSColor *quinarySystemFillColor API_AVAILABLE(macos(14.0));
/*! A dynamic color that reflects the user's current preferred accent color. This color automatically updates when the accent color preference changes. Do not make assumptions about the color space of this color, which may change across releases. */
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorPickerTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorPickerTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorPickerTouchBarItem.h 2025-11-20 06:44:01
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSColorPickerTouchBarItem.h 2026-02-16 07:22:41
@@ -48,7 +48,7 @@
/// The color list displayed in the list color picker. Defaults to the standard system color list. Setting a custom color list will disable the additional tints/shades that appear on long-press.
@property (strong, null_resettable) NSColorList *colorList API_UNAVAILABLE(ios);
-/// The localized string labelling this item during user customization. The default value is the localized string of "Color Picker".
+/// The localized string labeling this item during user customization. The default value is the localized string of "Color Picker".
@property (readwrite, copy, null_resettable) NSString *customizationLabel;
@property (weak, nullable) id target;
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImage.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImage.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImage.h 2025-11-20 06:44:07
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImage.h 2026-02-16 07:22:47
@@ -81,20 +81,20 @@
/// @param description The image’s accessibility description. This description is used automatically by interface elements that display images. Like all accessibility descriptions, use a short localized string that does not include the name of the interface element. For instance, “delete” rather than “delete button”.
+ (nullable instancetype)imageWithSystemSymbolName:(NSString *)name accessibilityDescription:(nullable NSString *)description API_AVAILABLE(macos(11.0));
-/// Creates a system symbol image with the specified name and value. The @c value argument is only accommodated if the symbol supports variable rendering.
+/// Creates a system symbol image with the specified name and value. The `value` argument is only accommodated if the symbol supports variable rendering.
/// @param name A name from the system’s SF Symbols catalog
/// @param value The value represented by the symbol. The value should be between 0 and 1 inclusive ([0,1]).
/// @param description The image’s accessibility description. This description is used automatically by interface elements that display images. Like all accessibility descriptions, use a short localized string that does not include the name of the interface element. For instance, “delete” rather than “delete button”.
/// @note Values less than 0 or greater than 1 will be clamped to 0 and 1, respectively.
+ (nullable instancetype)imageWithSystemSymbolName:(NSString *)name variableValue:(double)value accessibilityDescription:(nullable NSString *)description API_AVAILABLE(macos(13.0));
-/// Creates a symbol image with the specified name and value. The @c value argument is only accommodated if the symbol supports variable rendering.
+/// Creates a symbol image with the specified name and value. The `value` argument is only accommodated if the symbol supports variable rendering.
/// @param name A name of a symbol image file in the main bundle’s catalog
/// @param value The value represented by the symbol. The value should be between 0 and 1 inclusive ([0,1]).
/// @note Values less than 0 or greater than 1 will be clamped to 0 and 1, respectively.
+ (nullable instancetype)imageWithSymbolName:(NSString *)name variableValue:(double)value API_AVAILABLE(macos(13.0));
-/// Creates a symbol image with the specified name and value. The @c value argument is only accommodated if the symbol supports variable rendering.
+/// Creates a symbol image with the specified name and value. The `value` argument is only accommodated if the symbol supports variable rendering.
/// @param name A name of a symbol image file in the main bundle’s catalog
/// @param bundle The bundle containing the image file or asset catalog. Specify `nil` to search the app’s main bundle.
/// @param value The value represented by the symbol. The value should be between 0 and 1 inclusive ([0,1]).
@@ -235,7 +235,9 @@
@property (readonly, copy) NSImageSymbolConfiguration *symbolConfiguration API_AVAILABLE(macos(12.0));
-/// Creates and returns a new image with the specified locale. If the receiver contains locale-sensitive representations, the returned image will prefer to draw using representations appropriate for the specified locale. If locale is `nil`, the returned image uses the default behavior of choosing representations appropriate for the system’s currently-configured locale.
+/// Creates and returns a new image with the specified locale.
+///
+/// If the receiver contains locale-sensitive representations, the returned image will prefer to draw using representations appropriate for the specified locale. If locale is `nil`, the returned image uses the default behavior of choosing representations appropriate for the system’s currently-configured locale.
- (NSImage *)imageWithLocale:(nullable NSLocale *)locale NS_SWIFT_NAME(withLocale(_:)) API_AVAILABLE(macos(14.0));
/// The image’s preferred locale for resolving representations, if one has been specified using `-imageWithLocale:`. Otherwise, `nil`.
@@ -571,12 +573,12 @@
#pragma mark - Creating a Color Configuration
/**
- Create a configuration that specifies that the symbol should prefer its monochrome variant.
+ Creates a configuration that specifies that the symbol should prefer its monochrome variant.
*/
+ (instancetype)configurationPreferringMonochrome NS_SWIFT_NAME(preferringMonochrome()) API_AVAILABLE(macos(13.0));
/**
- Create a configuration that specifies that the symbol should prefer its hierarchical variant, if one exists.
+ Creates a configuration that specifies that the symbol should prefer its hierarchical variant, if one exists.
If the symbol doesn’t support hierarchical, the result will be a monochrome (templated) symbol.
*/
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImageView.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImageView.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImageView.h 2025-11-20 06:44:04
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSImageView.h 2026-02-16 07:22:44
@@ -32,7 +32,7 @@
@interface NSImageView : NSControl <NSAccessibilityImage, NSMenuItemValidation>
-/*!
+/**
Creates a non-editable image view containing the provided image. The image is scaled proportionally down to fit the view, and is centered within the view.
@param image The image to display within the view.
@return An initialized image view.
@@ -47,13 +47,19 @@
@property NSImageScaling imageScaling;
@property NSImageFrameStyle imageFrameStyle;
-/*!
- Specifies a combination of point size, weight, and scale to use when sizing and displaying symbol images. If a symbol configuration isn't provided, the image view uses a default size, weight, and scale provided by the system. The default value is `nil`.
+/**
+ Specifies a combination of point size, weight, and scale to use when sizing and displaying symbol images.
+
+ If a symbol configuration isn't provided, the image view uses a default size, weight, and scale provided by the system.
+ The default value is `nil`.
*/
@property (nullable, copy) NSImageSymbolConfiguration *symbolConfiguration API_AVAILABLE(macos(11.0));
-/*!
- A tint color to be used when rendering template image content. This color may be combined with other effects to produce a theme-appropriate rendition of the template image. A nil value indicates the standard set of effects without color modification. The default value is nil.
+/**
+ A tint color to be used when rendering template image content.
+
+ This color may be combined with other effects to produce a theme-appropriate rendition of the template image. A `nil` value indicates the standard set of effects without color modification.
+ The default value is `nil`.
*/
@property (nullable, copy) NSColor *contentTintColor API_AVAILABLE(macos(10.14));
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSLevelIndicator.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSLevelIndicator.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSLevelIndicator.h 2025-11-20 06:44:07
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSLevelIndicator.h 2026-02-16 07:22:47
@@ -52,13 +52,25 @@
#pragma mark Custom Colors
-/*! Sets the fill color used by Continuous and Discrete Capacity indicators when drawing the "normal" state, and by the Rating indicator when drawing stars. The default value is a system-defined color which may vary between level indicator styles and OS releases. */
+/**
+Sets the fill color used by Continuous and Discrete Capacity indicators when drawing the "normal" state, and by the rating indicator when drawing stars.
+
+The default value is a system-defined color which may vary between level indicator styles and OS releases.
+*/
@property (copy, null_resettable) NSColor *fillColor API_AVAILABLE(macos(10.13));
-/*! Sets the fill color used by Continuous and Discrete Capacity indicators when drawing values above the "warning" threshold. The default value is a system-defined color which may vary between level indicator styles and OS releases. */
+/**
+Sets the fill color used by Continuous and Discrete Capacity indicators when drawing values above the "warning" threshold.
+
+The default value is a system-defined color which may vary between level indicator styles and OS releases.
+*/
@property (copy, null_resettable) NSColor *warningFillColor API_AVAILABLE(macos(10.13));
-/*! Sets the fill color used by Continuous and Discrete Capacity indicators when drawing values above the "critical" threshold. The default value is a system-defined color which may vary between level indicator styles and OS releases. */
+/**
+Sets the fill color used by Continuous and Discrete Capacity indicators when drawing values above the "critical" threshold.
+
+The default value is a system-defined color which may vary between level indicator styles and OS releases.
+*/
@property (copy, null_resettable) NSColor *criticalFillColor API_AVAILABLE(macos(10.13));
#pragma mark Capacity Indicator Options
@@ -67,17 +79,29 @@
#pragma mark Rating Indicator Options
-/*! For a Rating-style indicator, sets the conditions under which Rating placeholders are displayed. This property currently has no effect for other indicator styles. The default value is \c NSLevelIndicatorPlaceholderVisibilityAutomatic. */
+/**
+For a rating-style indicator, sets the conditions under which rating placeholders are displayed.
+
+This property currently has no effect for other indicator styles.
+The default value is `NSLevelIndicatorPlaceholderVisibilityAutomatic`.
+*/
@property NSLevelIndicatorPlaceholderVisibility placeholderVisibility API_AVAILABLE(macos(10.13));
-/*! If non-nil, sets the image used by the Rating indicator style in place of the default star image. The default value is nil. */
+/**
+Sets the image used by the rating indicator style in place of the default star image.
+
+The default value is `nil`.
+*/
@property (strong, nullable) NSImage *ratingImage API_AVAILABLE(macos(10.13));
-/*! If non-nil, sets the image used by the Rating indicator style in place of the default faded placeholder image. The default value is nil.
+/**
+Sets the image used by the rating indicator style in place of the default faded placeholder image.
+
+If the custom placeholder is a template image, its fill opacity can be adjusted by modifying the opacity of the template image.
+If both a ``ratingImage`` and ``ratingPlaceholderImage`` are set, each rating position is sized such that either image will fit without scaling (i.e. sized to the maximum width and height of both images).
+The default value is `nil`.
+*/
- If the custom placeholder is a template image, its fill opacity can be adjusted by modifying the opacity of the template image.
-
- If both a ratingImage and ratingPlaceholderImage are set, each rating position is sized such that either image will fit without scaling (i.e. sized to the maximum width and height of both images). */
@property (strong, nullable) NSImage *ratingPlaceholderImage API_AVAILABLE(macos(10.13));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenu.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenu.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenu.h 2025-11-20 06:44:04
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenu.h 2026-02-16 07:22:44
@@ -280,7 +280,14 @@
- (void)menuWillOpen:(NSMenu *)menu API_AVAILABLE(macos(10.5)) NS_SWIFT_UI_ACTOR;
- (void)menuDidClose:(NSMenu *)menu API_AVAILABLE(macos(10.5)) NS_SWIFT_UI_ACTOR;
-/* Indicates that menu is about to highlight item. Only one item per menu can be highlighted at a time. If item is nil, it means all items in the menu are about to be unhighlighted. */
+/*!
+ Indicates that a menu is about to highlight an item. Only one item per menu can be highlighted at a time. If item is nil, it means all items in the menu are about to be unhighlighted.
+
+ The behavior of this method varies when closing a menu with a highlighted item.
+ In macOS 26.4 and later, this method is sent with a nil item for both the topmost open menu and its submenus, to any menu that has a highlighted item.
+ In macOS 14.0 and later, this method is sent with a nil item when closing a submenu with a highlighted item. This method is not sent for the topmost open menu, even if it has a highlighted item.
+ Prior to macOS 14.0, this method is not sent when a menu is closed, even if it has a highlighted item.
+ */
- (void)menu:(NSMenu *)menu willHighlightItem:(nullable NSMenuItem *)item API_AVAILABLE(macos(10.5)) NS_SWIFT_UI_ACTOR;
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenuItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenuItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenuItem.h 2025-11-20 06:44:05
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSMenuItem.h 2026-02-16 07:22:45
@@ -27,6 +27,7 @@
+ (NSMenuItem *)separatorItem;
/// Creates a menu item representing a section header with the provided title.
+///
/// Section header items are used to provide context to a grouping of menu items.
/// Items created using this method are non-interactive and do not perform an action.
+ (instancetype)sectionHeaderWithTitle:(NSString *)title API_AVAILABLE(macos(14.0)) NS_REFINED_FOR_SWIFT;
@@ -115,10 +116,9 @@
@property (nullable, copy) NSString *toolTip;
-/// A badge used to provide additional quantitative information specific to
-/// the menu item, such as the number of available updates.
+/// A badge used to provide additional quantitative information specific to the menu item, such as the number of available updates.
///
-/// @note The default value of this property is @c nil.
+/// The default value of this property is `nil`.
@property (nullable, copy) NSMenuItemBadge *badge API_AVAILABLE(macos(14.0));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSPickerTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSPickerTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSPickerTouchBarItem.h 2025-11-20 06:44:08
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSPickerTouchBarItem.h 2026-02-16 07:22:49
@@ -103,7 +103,9 @@
- (void)setEnabled:(BOOL)enabled atIndex:(NSInteger)index;
- (BOOL)isEnabledAtIndex:(NSInteger)index;
-/// The localized string labelling this item during user customization. The default value is empty string.
+/// The localized string labeling this item during user customization.
+///
+/// The default value is empty string.
@property (readwrite, copy, null_resettable) NSString *customizationLabel;
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSScreen.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSScreen.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSScreen.h 2025-11-20 06:44:02
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSScreen.h 2026-02-16 07:22:42
@@ -126,8 +126,10 @@
API_AVAILABLE(macos(14.0))
@interface NSScreen (NSDisplayLink)
-/*
- Returns a new display link whose callback will be invoked in-sync with the display the screen is on. Note that views and windows can move between screens and you may want to get a display link directly from NSView or NSWindow which will track those changes automatically.
+/**
+ Returns a new display link whose callback will be invoked in-sync with the display the screen is on.
+
+ Note that views and windows can move between screens and you may want to get a display link directly from `NSView` or `NSWindow` which will track those changes automatically.
*/
- (CADisplayLink *)displayLinkWithTarget:(id)target selector:(SEL)selector NS_SWIFT_NAME(displayLink(target:selector:));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSegmentedControl.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSegmentedControl.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSegmentedControl.h 2025-11-20 06:44:04
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSegmentedControl.h 2026-02-16 07:22:43
@@ -119,8 +119,9 @@
@interface NSSegmentedControl (NSSegmentedControlConvenience)
-/*!
+/**
Creates a standard segmented control containing one segment for each of the provided labels.
+
@param labels An array of localized label strings to use for the control's segments.
@param trackingMode The selection mode for the control. The NSSegmentSwitchTracking enum describes the possible values and their effects.
@param target The target object that receives action messages from the control.
@@ -129,8 +130,10 @@
*/
+ (instancetype)segmentedControlWithLabels:(NSArray<NSString *> *)labels trackingMode:(NSSegmentSwitchTracking)trackingMode target:(nullable id)target action:(nullable SEL)action API_AVAILABLE(macos(10.12));
-/*!
- Creates a standard segmented control containing one segment for each of the provided images. To ensure accessibility for this control, set the accessibilityDescription property on each of the provided images.
+/**
+ Creates a standard segmented control containing one segment for each of the provided images.
+
+ To ensure accessibility for this control, set the `accessibilityDescription` property on each of the provided images.
@param images An array of image objects to use for the control's segments.
@param trackingMode The selection mode for the control. The NSSegmentSwitchTracking enum describes the possible values and their effects.
@param target The target object that receives action messages from the control.
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingCollaborationModeRestriction.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingCollaborationModeRestriction.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingCollaborationModeRestriction.h 2025-11-20 06:44:06
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingCollaborationModeRestriction.h 2026-02-16 07:22:46
@@ -22,10 +22,11 @@
NSSharingCollaborationModeCollaborate,
};
-/// Specifies whether a specific type of sharing should be disabled in the share picker, and if so, whether a reason should be provided for the disablement
-/// If a reason is provided, the corresponding mode will show up as an option, but an alert explaining why it is disabled will show if it is chosen, and the mode will switch back to the supported one
-/// Optionally, an extra alert button can be provided for a "recovery suggestion". This can give a user a way to fix whatever is causing this type of sharing to be disabled
-/// If no reason is provided, the corresponding mode will not show up as an option
+/// Specifies whether a specific type of sharing should be disabled in the share picker, and if so, whether a reason should be provided for the disablement.
+///
+/// If a reason is provided, the corresponding mode will show up as an option, but an alert explaining why it is disabled will show if it is chosen, and the mode will switch back to the supported one.
+/// Optionally, an extra alert button can be provided for a "recovery suggestion". This can give a user a way to fix whatever is causing this type of sharing to be disabled.
+/// If no reason is provided, the corresponding mode will not show up as an option.
API_AVAILABLE(macos(15.0)) API_UNAVAILABLE(ios, watchos, tvos)
NS_SWIFT_NAME(NSSharingServicePicker.CollaborationModeRestriction)
@interface NSSharingCollaborationModeRestriction : NSObject<NSSecureCoding, NSCopying>
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingService.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingService.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingService.h 2025-11-20 06:44:04
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSharingService.h 2026-02-16 07:22:44
@@ -175,9 +175,11 @@
- (nullable NSWindow *)sharingService:(NSSharingService *)sharingService sourceWindowForShareItems:(NSArray *)items sharingContentScope:(NSSharingContentScope *)sharingContentScope NS_SWIFT_UI_ACTOR;
/**
- The following method is invoked when the service is performed and wants to display its contents in a popover. The delegate should return the view that will act as the anchor of the popover, along with the target rectangle within the bounds of that view and preferred edge of that rectangle for the popover to appear. The delegate may also return nil, indicating that there is no anchoring view currently available, in which case the service may attempt to display the service via some other means.
+ The method invoked when the service is performed and wants to display its contents in a popover.
- The service named NSSharingServiceNameCloudSharing prefers to display itself using a popover anchored to an "Add People" or "Share" button. If no such button is available or visible, return nil.
+ The delegate should return the view that will act as the anchor of the popover, along with the target rectangle within the bounds of that view and preferred edge of that rectangle for the popover to appear. The delegate may also return `nil`, indicating that there is no anchoring view currently available, in which case the service may attempt to display the service via some other means.
+
+ The service named `NSSharingServiceNameCloudSharing` prefers to display itself using a popover anchored to an "Add People" or "Share" button. If no such button is available or visible, return `nil`.
*/
- (nullable NSView *)anchoringViewForSharingService:(NSSharingService *)sharingService showRelativeToRect:(NSRect *)positioningRect preferredEdge:(NSRectEdge *)preferredEdge NS_SWIFT_UI_ACTOR;
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderAccessory.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderAccessory.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderAccessory.h 2025-11-20 06:44:08
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderAccessory.h 2026-02-16 07:22:48
@@ -26,10 +26,12 @@
+ (NSSliderAccessory *)accessoryWithImage:(UIImage *)image API_AVAILABLE(ios(13.0));
#endif
-/// The effect on interaction with the accessory. Defaults to `automaticBehavior`
+/// The effect on interaction with the accessory.
+///
+/// The default value is `automaticBehavior`.
@property (copy) NSSliderAccessoryBehavior *behavior;
-/// Whether or not the accessory is interactive and draws with an enabled appearance. Defaults to YES.
+/// Determines whether or not the accessory is interactive and draws with an enabled appearance. Defaults to `true`.
@property (getter=isEnabled) BOOL enabled;
@end
@@ -42,7 +44,9 @@
API_AVAILABLE(macos(10.12), ios(13.0)) NS_SWIFT_UI_ACTOR
@interface NSSliderAccessoryBehavior : NSObject <NSCoding, NSCopying>
-/// The behavior is automatically picked to be the system standard for the slider's current context, e.g. NSTouchBarItems have `.valueStep` behavior.
+/// The behavior is automatically picked to be the system standard, given the slider's current context.
+///
+/// For example, NSTouchBarItems have `.valueStep` behavior.
@property (class, readonly, copy) NSSliderAccessoryBehavior *automaticBehavior;
/// The value of the slider moves towards the associated value for the accessory with by a delta of the slider's `altIncrementValue`.
@@ -51,10 +55,13 @@
/// The value of the slider is reset to the associated value for the accessory.
@property (class, readonly, copy) NSSliderAccessoryBehavior *valueResetBehavior;
-/// The action is sent to the target on interaction. The optional first parameter is an NSSliderAccessory.
+/// The action is sent to the target on interaction.
+/// @param target An optional `NSSliderAccessory`.
+ (NSSliderAccessoryBehavior *)behaviorWithTarget:(nullable id)target action:(SEL)action;
-/// The handler block is invoked on interaction. This variant is not codable and will assert in `-encodeWithCoder:`.
+/// The handler block is invoked on interaction.
+///
+/// This variant is not codable and will assert in `-encodeWithCoder:`.
+ (NSSliderAccessoryBehavior *)behaviorWithHandler:(void(^)(NSSliderAccessory *))handler;
/// Override point for custom subclasses to handle interaction.
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderTouchBarItem.h 2025-11-20 06:44:05
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSliderTouchBarItem.h 2026-02-16 07:22:45
@@ -49,7 +49,9 @@
/// The action of the item, called when the slider or accessories receive user interaction.
@property (nullable) SEL action;
-/// The localized string labelling this item during user customization. The default value is empty string.
+/// The localized string labeling this item during user customization.
+///
+/// The default value is empty string.
@property (readwrite, copy, null_resettable) NSString *customizationLabel;
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSplitViewController.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSplitViewController.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSplitViewController.h 2025-11-20 06:44:09
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSSplitViewController.h 2026-02-16 07:22:50
@@ -83,10 +83,14 @@
@interface NSSplitViewController (NSSplitViewControllerToggleSidebarAction)
-/// Animatedly collapses or uncollapses the first sidebar split view item in the receiver. Does nothing if the receiver does not contain any sidebars.
+/// Collapses or expands the first sidebar in the split view controller using an animation.
+///
+/// If the split view controller doesn't contain a sidebar, calling this method does nothing.
- (IBAction)toggleSidebar:(nullable id)sender API_AVAILABLE(macos(10.11));
-/// Animatedly collapses or uncollapses the first inspector split view item in the receiver. Does nothing if the receiver does not contain any inspectors.
+/// Collapses or expands the first inspector in the split view controller using an animation.
+///
+/// If the split view controller doesn't contain an inspector, calling this method does nothing.
- (IBAction)toggleInspector:(nullable id)sender API_AVAILABLE(macos(14.0));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStackView.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStackView.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStackView.h 2025-11-20 06:44:02
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStackView.h 2026-02-16 07:22:42
@@ -49,16 +49,18 @@
All NSStackViewDistribution enum values fit first and last stacked views tightly to the container, except for NSStackViewDistributionGravityAreas.
*/
typedef NS_ENUM(NSInteger, NSStackViewDistribution) {
- /// Default value. NSStackView will not have any special distribution behavior, relying on behavior described by gravity areas and set hugging priorities along the stacking axis.
+ /// Stacked views will not have any special distribution behavior, relying on behavior described by gravity areas and set hugging priorities along the stacking axis.
+ ///
+ /// This is the default value.
NSStackViewDistributionGravityAreas = -1,
- /// The effective hugging priority in the stacking axis is NSLayoutPriorityRequired, causing the stacked views to tightly fill the container along the stacking axis.
+ /// The effective hugging priority in the stacking axis is `NSLayoutPriorityRequired`, causing the stacked views to tightly fill the container along the stacking axis.
NSStackViewDistributionFill = 0,
- /// Stacked views will have sizes maintained to be equal as much as possible along the stacking axis. The effective hugging priority in the stacking axis is NSLayoutPriorityRequired.
+ /// Stacked views will have sizes maintained to be equal as much as possible along the stacking axis. The effective hugging priority in the stacking axis is `NSLayoutPriorityRequired`.
NSStackViewDistributionFillEqually,
- /// Stacked views will have sizes maintained to be equal, proportionally to their intrinsicContentSizes, as much as possible. The effective hugging priority in the stacking axis is NSLayoutPriorityRequired.
+ /// Stacked views will have sizes maintained to be equal, proportionally to their `intrinsicContentSize`s, as much as possible. The effective hugging priority in the stacking axis is `NSLayoutPriorityRequired`.
NSStackViewDistributionFillProportionally,
/// The space separating stacked views along the stacking axis are maintained to be equal as much as possible while still maintaining the minimum spacing.
@@ -121,7 +123,9 @@
/// Default padding inside the StackView, around all of the subviews.
@property NSEdgeInsets edgeInsets;
-/// The spacing and sizing distribution of stacked views along the primary axis. Defaults to GravityAreas.
+/// The spacing and sizing distribution of stacked views along the primary axis.
+///
+/// The default value is `gravityAreas`.
@property NSStackViewDistribution distribution API_AVAILABLE(macos(10.11));
/// Default (minimum) spacing between each view
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStatusBarButton.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStatusBarButton.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStatusBarButton.h 2025-11-20 06:44:08
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStatusBarButton.h 2026-02-16 07:22:49
@@ -16,7 +16,9 @@
API_AVAILABLE(macos(10.10))
@interface NSStatusBarButton : NSButton
-/// If `YES`, the status bar icon has a disabled/off appearance while still being functional, such as allowing selection and actions. Defaults to `NO`.
+/// Determines whether the status bar icon has a disabled/off appearance while still being functional, such as allowing selection and actions.
+///
+/// The default value is `false`.
@property BOOL appearsDisabled;
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStepperTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStepperTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStepperTouchBarItem.h 2025-11-20 06:44:04
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSStepperTouchBarItem.h 2026-02-16 07:22:45
@@ -12,23 +12,29 @@
API_AVAILABLE(macos(10.15), ios(13.0))
@interface NSStepperTouchBarItem : NSTouchBarItem
-/// Creates an `NSStepperTouchBarItem` with a `formatter` to display the stepper's value as text
+/// Creates a `NSStepperTouchBarItem` with a `formatter` to display the stepper's value as text.
///
/// @param formatter A formatter used to display a textual representation of the stepper's value
+ (instancetype)stepperTouchBarItemWithIdentifier:(NSTouchBarItemIdentifier)identifier formatter:(NSFormatter *)formatter;
-/// Creates an `NSStepperTouchBarItem` using the result of `drawingHandler` to display the stepper's value as an image
+/// Creates a `NSStepperTouchBarItem` using the result of `drawingHandler` to display the stepper's value as an image.
///
/// @param drawingHandler A block that draws a graphical representation of the stepper's value in the specified rectangle. The coordinates of this rectangle are specified in points.
+ (instancetype)stepperTouchBarItemWithIdentifier:(NSTouchBarItemIdentifier)identifier drawingHandler:(void (^)(NSRect rect, double value))drawingHandler;
-/// The stepper's maximum value. The default is 59.0.
+/// The stepper's maximum value.
+///
+/// The default is `59.0`.
@property double maxValue;
-/// The stepper's minimum value. The default is 0.0.
+/// The stepper's minimum value.
+///
+/// The default is `0.0`.
@property double minValue;
-/// The stepper's increment value. The default is 1.0.
+/// The stepper's increment value.
+///
+/// The default value is `1.0`.
@property double increment;
/// The current value of the stepper.
@@ -40,7 +46,9 @@
/// The action-message selector associated with the stepper.
@property (nullable) SEL action;
-/// The localized string labelling this item during user customization. The default value is empty string.
+/// The localized string labeling this item during user customization.
+///
+/// The default value is empty string.
@property (copy, null_resettable) NSString *customizationLabel;
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTabViewItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTabViewItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTabViewItem.h 2025-11-20 06:44:03
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTabViewItem.h 2026-02-16 07:22:43
@@ -24,8 +24,10 @@
@interface NSTabViewItem : NSObject <NSCoding>
/*!
- * Creates an autoreleased TabViewItem that wraps the provided ViewController. The viewController is set as the tab view item’s \c -viewController property, which sets several of the tab view item’s other properties.
- * \param viewController The view controller to wrap, used to set the viewController property
+ * Creates an autoreleased `TabViewItem` that wraps the provided view controller.
+ *
+ * The view controller is set as the tab view item’s `viewController` property, which sets several of the tab view item’s other properties.
+ * \param viewController The view controller to wrap, used to set the `viewController` property
*/
+ (instancetype)tabViewItemWithViewController:(NSViewController *)viewController API_AVAILABLE(macos(10.10));
@@ -36,7 +38,9 @@
@property (strong, nullable) id identifier;
@property (copy) NSColor *color;
@property (copy) NSString *label;
-/// Get and set the image for this tab view item. The image may only be used in certain tab view styles and options. The default value is nil.
+/// Gets and set the image for this tab view item. The image may only be used in certain tab view styles and options.
+///
+/// The default value is `nil`.
@property (nullable, strong) NSImage *image API_AVAILABLE(macos(10.10));
@property (nullable, strong) NSView *view;
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTextField.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTextField.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTextField.h 2025-11-20 06:44:02
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTextField.h 2026-02-16 07:22:42
@@ -68,10 +68,10 @@
*/
@property (copy) NSArray<NSAttributedString *> *placeholderAttributedStrings API_AVAILABLE(macos(26.0));
-/// Specifies the behavior for resolving ``NSTextAlignment.natural`` to the visual alignment.
+/// Specifies the behavior for resolving ``NSTextAlignment/natural`` to the visual alignment.
///
-/// When set to ``true``, the resolved visual alignment is determined by the resolved base writing direction; otherwise, it is using the user’s preferred language.
-/// The default value is ``false``.
+/// When set to `true`, the resolved visual alignment is determined by the resolved base writing direction; otherwise, it is using the user’s preferred language.
+/// The default value is `false`.
@property BOOL resolvesNaturalAlignmentWithBaseWritingDirection API_AVAILABLE(macos(26.0));
@end
@@ -125,12 +125,12 @@
@optional
-/// Provides a customized list of candidates to the text view’s `candidateListTouchBarItem`. Invoked from `-updateCandidates`. `NSTextView` uses the candidates returned from this method and suppress its built-in candidate generation. Returning `nil` from this delegate method allows `NSTextView` to query candidates from `NSSpellChecker`.
-/// - Returns: An array of objects that represent the elements of a selection.
+/// Provides a customized list of candidates to the text view’s `candidateListTouchBarItem`. This method returns an array of objects that represent the elements of a selection.
+///
+/// Invoked from `updateCandidates`. `NSTextView` uses the candidates returned from this method and suppress its built-in candidate generation. Returning `nil` from this delegate method allows `NSTextView` to query candidates from `NSSpellChecker`.
- (nullable NSArray *)textField:(NSTextField *)textField textView:(NSTextView *)textView candidatesForSelectedRange:(NSRange)selectedRange NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.12.2));
-/// Allows customizing the candidate list queried from `NSSpellChecker`.
-/// - Returns: An array of text objects to include in a text selection.
+/// Allows customizing the candidate list queried from `NSSpellChecker`. This method returns array of text objects to include in a text selection.
- (NSArray<NSTextCheckingResult *> *)textField:(NSTextField *)textField textView:(NSTextView *)textView candidates:(NSArray<NSTextCheckingResult *> *)candidates forSelectedRange:(NSRange)selectedRange NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.12.2));
/// Notifies the delegate that the user selected the candidate at index in `-[NSCandidateListTouchBarItem candidates]` for the text view’s `candidateListTouchBarItem`. Returns a Boolean value that indicates whether to select the text object at the index.
@@ -138,7 +138,6 @@
/// - textField: The text field that sent the message.
/// - textView: The text view that sent the message.
/// - index: The index that represents the start of the candidate text to evaluate, or `NSNotFound` if no candidate is to be selected.
-/// - Returns: `YES` if the framework selects the text. `YES` allows `textView` to insert the candidate into the text storage if it’s `NSString`, `NSAttributedString`, or `NSTextCheckingResult`.
- (BOOL)textField:(NSTextField *)textField textView:(NSTextView *)textView shouldSelectCandidateAtIndex:(NSUInteger)index NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.12.2));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSToolbarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSToolbarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSToolbarItem.h 2025-11-20 06:44:03
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSToolbarItem.h 2026-02-16 07:22:43
@@ -172,7 +172,9 @@
@property (readonly, getter=isVisible) BOOL visible API_AVAILABLE(macos(12.0), ios(16.0));
/**
- When an item is hidden it will not be visible in the toolbar. The item will still be visible in the customization panel. Because hidden items may be visible during user customization, use the `visible` property to determine if an item is currently displayed. Note that even hidden toolbar items are sync'd to other toolbars with a shared identifier, but its `hidden` state can be unique to each instance. Use this property to show a toolbar item in one toolbar instance but not another.
+ Determines whether an item is visible in the toolbar.
+
+ The item will still be visible in the customization panel. Because hidden items may be visible during user customization, use the `visible` property to determine if an item is currently displayed. Note that even hidden toolbar items are sync'd to other toolbars with a shared identifier, but its `hidden` state can be unique to each instance. Use this property to show a toolbar item in one toolbar instance but not another.
*/
@property (getter=isHidden) BOOL hidden API_AVAILABLE(macos(15.0), ios(18.0));
@@ -295,13 +297,15 @@
APPKIT_EXTERN NSToolbarItemIdentifier NSToolbarWritingToolsItemIdentifier API_AVAILABLE(macos(15.2));
/**
- Creates a new NSTrackingSeparatorToolbarItem and automatically configures it to track the divider of the sidebar if one is discovered.
+ Creates a new `NSTrackingSeparatorToolbarItem` and automatically configures it to track the divider of the sidebar if one is discovered.
+
Only applies to windows with `NSWindowStyleMaskFullSizeContentView` applied.
*/
APPKIT_EXTERN NSToolbarItemIdentifier NSToolbarSidebarTrackingSeparatorItemIdentifier API_AVAILABLE(macos(11.0)) API_UNAVAILABLE(ios);
/**
- Creates a new NSTrackingSeparatorToolbarItem and automatically configures it to track the divider of the inspector if one is discovered.
+ Creates a new `NSTrackingSeparatorToolbarItem` and automatically configures it to track the divider of the inspector if one is discovered.
+
Only applies to windows with `NSWindowStyleMaskFullSizeContentView` applied.
*/
APPKIT_EXTERN NSToolbarItemIdentifier NSToolbarInspectorTrackingSeparatorItemIdentifier API_AVAILABLE(macos(14.0)) API_UNAVAILABLE(ios);
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTouchBarItem.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTouchBarItem.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTouchBarItem.h 2025-11-20 06:44:00
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSTouchBarItem.h 2026-02-16 07:22:40
@@ -60,7 +60,7 @@
*/
@property (readonly, nullable) NSViewController *viewController;
-/*
+/**
The user visible string identifying this item during customization. By default this method returns the empty string.
*/
@property (readonly, copy) NSString *customizationLabel API_AVAILABLE(ios(13.0));
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSView.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSView.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSView.h 2025-11-20 06:44:07
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSView.h 2026-02-16 07:22:47
@@ -286,6 +286,9 @@
@property BOOL postsBoundsChangedNotifications;
+/*! The nearest ancestor scroll view that contains the current view as part of its document view.
+ * - Note: If the current view is not embedded inside a scroll view, the value of this property is `nil`. This property does not contain the current view if the current view is itself a scroll view. It always contains an ancestor scroll view.
+ */
@property (nullable, readonly, strong) NSScrollView *enclosingScrollView;
- (nullable NSMenu *)menuForEvent:(NSEvent *)event;
@@ -605,8 +608,10 @@
API_AVAILABLE(macos(14.0))
@interface NSView (NSDisplayLink)
-/*
- Returns a new display link whose callback will be invoked in-sync with the display the view is on. If the view is hidden, or not on any display, the callback will not be invoked.
+/**
+ Returns a new display link whose callback will be invoked in-sync with the display the view is on.
+
+ If the view is hidden, or not on any display, the callback will not be invoked.
*/
- (CADisplayLink *)displayLinkWithTarget:(id)target selector:(SEL)selector NS_SWIFT_NAME(displayLink(target:selector:));
@end
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h 2025-11-20 06:44:06
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWindow.h 2026-02-16 07:22:46
@@ -729,19 +729,20 @@
#pragma mark - Window Sharing
-/*!
- @abstract Attempt to move window sharing (i.e. within a SharePlay session) from the receiver to another window. In response to this request, the user may choose to transfer sharing to the new window, or simply stop sharing the content.
+/**
+ Attempts to move window sharing (i.e. within a SharePlay session) from the receiver to another window. In response to this request, the user may choose to transfer sharing to the new window, or simply stop sharing the content.
+
+ In the event of a failed transfer request, a non-`nil` error contains details about the failure.
+
@param window
A window that is replacing the reciever in representing the user's current activity.
@param completionHandler
A completion block that is called after the request finishes.
- @c error
- In the event of a failed transfer request, a non-nil error contains details about the failure.
*/
- (void)transferWindowSharingToWindow:(NSWindow *)window completionHandler:(void(^)(NSError * _Nullable error))completionHandler API_AVAILABLE(macos(13.3));
-/*!
- @abstract Indicates whether the receiver is the subject of an active SharePlay sharing session.
+/**
+ Indicates whether the receiver is the subject of an active SharePlay sharing session.
*/
@property (readonly) BOOL hasActiveWindowSharingSession API_AVAILABLE(macos(13.3));
@@ -816,8 +817,10 @@
API_AVAILABLE(macos(14.0))
@interface NSWindow (NSDisplayLink)
-/*
- Returns a new display link whose callback will be invoked in-sync with the display the window is on. If the window is not on any display the callback will not be invoked.
+/**
+ Returns a new display link whose callback will be invoked in-sync with the display the window is on.
+
+ If the window is not on any display the callback will not be invoked.
*/
- (CADisplayLink *)displayLinkWithTarget:(id)target selector:(SEL)selector NS_SWIFT_NAME(displayLink(target:selector:));
@end
@@ -891,8 +894,7 @@
*/
- (void)window:(NSWindow *)window didDecodeRestorableState:(NSCoder *)state NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(10.7));
-/*! Preview representable activity items, used for sharing and collaboration.
-*/
+/// A collection of Preview-representable activity items, used for sharing and collaboration.
- (NSArray<id<NSPreviewRepresentableActivityItem>> *_Nullable)previewRepresentableActivityItemsForWindow:(NSWindow *)window NS_SWIFT_UI_ACTOR API_AVAILABLE(macos(13.2)) API_UNAVAILABLE(ios);
/*! Method called to get the window to share once sharing is confirmed, after a request is initiated by requestSharingOfWindowUsingPreview:title:completionHandler:. Implement this on the delegate of the requesting window
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h 2025-11-20 06:44:02
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinator.h 2026-02-16 07:22:42
@@ -127,7 +127,7 @@
/// An option to animate the replacement of text in your view.
///
/// When Writing Tools requests an interactive change in your delegate’s
- /// ``NSWritingToolsCoordinator/writingToolsCoordinator(_:replaceRange:inContext:proposedText:reason:animationParameters:completion:)``
+ /// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:replace:in:proposedText:reason:animationParameters:completion:)``
/// method, it passes a valid set of animation parameters to that method.
/// Update your view’s text storage and use the provided ``NSWritingToolsCoordinator/AnimationParameters``
/// type to create any view-specific animations you need to support the
@@ -137,7 +137,7 @@
/// An option to replace the text in your view without animating the change.
///
/// When Writing Tools requests a noninteractive change in your delegate’s
- /// ``NSWritingToolsCoordinator/writingToolsCoordinator(_:replaceRange:inContext:proposedText:reason:animationParameters:completion:)``
+ /// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:replace:in:proposedText:reason:animationParameters:completion:)``
/// method, update your view’s text storage without animating the change.
NSWritingToolsCoordinatorTextReplacementReasonNoninteractive, // an unanimated replacement prompted from writing tools, perhaps copied from the overlay-panel experience, perhaps a reverted rewrite or individual proofreading suggestion, and so forth
} API_AVAILABLE(macos(15.2)) NS_SWIFT_NAME(NSWritingToolsCoordinator.TextReplacementReason);
@@ -145,7 +145,7 @@
/// Options that indicate how much of your content Writing Tools requested.
///
/// At the start of any Writing Tools interaction, you provide the text for
-/// the system to evaluate from your ``NS/UIWritingToolsCoordinator/Delegate``
+/// the system to evaluate from your ``NSWritingToolsCoordinator/Delegate``
/// object. The request for your content comes with a scope constant that
/// indicates how much of your view’s text to provide.
typedef NS_ENUM(NSInteger, NSWritingToolsCoordinatorContextScope) {
@@ -318,7 +318,7 @@
/// The default value of this property is `nil`.
///
/// If you display your view’s text using multiple text containers, implement the
-/// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:singleContainerSubrangesOf:in:)``
+/// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:requestsSingleContainerSubrangesOf:in:completion:)``
/// method to request multiple previews.
@property (weak, nullable) NSView *effectContainerView; // When nil, uses the view property. The WTC will have a "real" effect container which will be kept in front of all the public container's subviews. Ignored if the delegate implements -requestsEffectContainerView
@@ -335,8 +335,8 @@
/// in your custom view. The default value of this property is `nil`.
///
/// If you display your view’s text using multiple text containers, implement the
-/// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:singleContainerSubrangesOf:in:)``
-/// and ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:decorationContainerViewFor:in:)``
+/// ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:requestsSingleContainerSubrangesOf:in:completion:)``
+/// and ``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:requestsDecorationContainerViewFor:in:completion:)``
/// methods to provide separate decoration views for each container.
@property (weak, nullable) NSView *decorationContainerView; // When nil, uses the view property. The WTC will have a "real" decorations container which will be kept behind all the public container's subviews. Ignored if the delegate implements -requestsDecorationContainerView
@@ -380,7 +380,7 @@
/// Writing Tools can create plain text or rich text, and it can format text
/// using lists or tables as needed. If your view doesn’t support specific
/// types of content, specify the types you do support in this property.
-/// The default value of this property is ``NSWritingToolsResult/default``,
+/// The default value of this property is ``NSWritingToolsResultOptions/default``,
/// which lets the system determine the type of content to generate.
@property NSWritingToolsResultOptions preferredResultOptions; // Defaults to "Default"
@@ -578,7 +578,7 @@
/// you need to modify other parts of your interface to reflect the changes,
/// use the provided ``NSWritingToolsCoordinator/AnimationParameters`` object
/// to create additional animations to run at the same time as the system-provided animations.
-- (void)writingToolsCoordinator:(NSWritingToolsCoordinator *)writingToolsCoordinator replaceRange:(NSRange)range inContext:(NSWritingToolsCoordinatorContext *)context proposedText:(NSAttributedString *)replacementText reason:(NSWritingToolsCoordinatorTextReplacementReason)reason animationParameters:(NSWritingToolsCoordinatorAnimationParameters *__nullable)animationParameters completion:(void(^)(NSAttributedString *__nullable attributedString))completion;
+- (void)writingToolsCoordinator:(NSWritingToolsCoordinator *)writingToolsCoordinator replaceRange:(NSRange)range inContext:(NSWritingToolsCoordinatorContext *)context proposedText:(NSAttributedString *)replacementText reason:(NSWritingToolsCoordinatorTextReplacementReason)reason animationParameters:(NSWritingToolsCoordinatorAnimationParameters *__nullable)animationParameters completion:(void(^)(NSAttributedString *__nullable attributedString))completion;
/// Asks the delegate to update your view’s current text selection.
///
@@ -719,7 +719,7 @@
/// method to undo any changes you make to your content.
///
/// For a single animation type, the system calls this method, followed sequentially
-/// by the ``writingToolsCoordinator(_:previewFor:range:context:completion:)``
+/// by the ``writingToolsCoordinator(_:requestsPreviewFor:of:in:completion:)``
/// and ``writingToolsCoordinator(_:finish:for:in:completion:)``
/// methods. Each method executes asynchronously, but the system calls the next
/// method in the sequence only after you call the completion handler of the previous
@@ -766,7 +766,7 @@
/// Writing Tools uses this information to place your image directly above the text in your view.
///
/// For a single animation type, the system calls the
-/// ``writingToolsCoordinator(_:prepareFor:range:context:completion:)``
+/// ``writingToolsCoordinator(_:prepareFor:for:in:completion:)``
/// method, followed sequentially by this method and then the
/// ``writingToolsCoordinator(_:finish:for:in:completion:)``
/// method. Each method executes asynchronously, but the system calls the next
@@ -805,7 +805,7 @@
/// place your image directly above the text in your view.
///
/// For a single animation type, the system calls the
-/// ``writingToolsCoordinator(_:prepareFor:range:context:completion:)``
+/// ``writingToolsCoordinator(_:prepareFor:for:in:completion:)``
/// method, followed sequentially by this method and then the
/// ``writingToolsCoordinator(_:finish:for:in:completion:)``
/// method. Each method executes asynchronously, but the system calls the next
@@ -841,8 +841,8 @@
/// you finish your cleanup work, call the completion handler to notify Writing Tools.
///
/// Writing Tools calls this method only after previous calls to the
-/// ``writingToolsCoordinator(_:prepareFor:range:context:completion:)``
-/// and ``writingToolsCoordinator(_:previewFor:range:context:completion:)``
+/// ``writingToolsCoordinator(_:prepareFor:for:in:completion:)``
+/// and ``writingToolsCoordinator(_:requestsPreviewFor:of:in:completion:)``
/// methods for the same animation type. However, Writing Tools can interleave
/// calls to this method with calls to prepare an animation of a different
/// type. In your implementation of this method, make sure the actions you
@@ -893,7 +893,7 @@
///
/// When configuring animations for your view, Writing Tools asks your delegate to
/// provide separate previews for each of your view’s container object. Specifically,
-/// it calls your delegate’s ``writingToolsCoordinator(_:previewFor:range:context:completion:)``
+/// it calls your delegate’s ``writingToolsCoordinator(_:requestsPreviewFor:of:in:completion:)``
/// method separately for each range of text you return in the completion handler.
/// Your implementation of that method must create a preview suitable for animating
/// the content from the underlying text container.
@@ -921,7 +921,7 @@
///
/// If your view uses multiple ``NSTextContainer`` objects to draw text in different
/// regions, use this method to provide Writing Tools with the view to use for the
-/// specified range of text. After calling your delegate’s ``writingToolsCoordinator(_:singleContainerSubrangesOf:in:)``
+/// specified range of text. After calling your delegate’s ``writingToolsCoordinator(_:requestsSingleContainerSubrangesOf:in:completion:)``
/// method, Writing Tools calls this method for each subrange of text you provided.
/// Find or provide a view situated visibly below the specified text in your text
/// view. It's also satisfactory to provide a view that’s visually in front of the
@@ -963,7 +963,7 @@
/// When Writing Tools is active, it updates its state to indicate what task
/// it’s currently performing. Writing Tools starts in the ``NSWritingToolsCoordinator/State/inactive``
/// state and moves to other states as it presents UI and starts interacting with
-/// your view’s content. For example, it moves to the ``NSWritingToolsCoordinator/State/interactiveUpdating``
+/// your view’s content. For example, it moves to the ``NSWritingToolsCoordinator/State/interactiveResting``
/// state when it’s making changes to your view’s text storage.
- (void)writingToolsCoordinator:(NSWritingToolsCoordinator *)writingToolsCoordinator willChangeToState:(NSWritingToolsCoordinatorState)newState completion:(void(^)(void))completion;
diff -ruN /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinatorAnimationParameters.h /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinatorAnimationParameters.h
--- /Applications/Xcode_26.3.0.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinatorAnimationParameters.h 2025-11-20 06:44:03
+++ /Applications/Xcode_26.4.0-beta2.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks/AppKit.framework/Headers/NSWritingToolsCoordinatorAnimationParameters.h 2026-02-16 07:22:43
@@ -31,7 +31,7 @@
///
/// You don’t create an `NSWritingToolsCoordinator.AnimationParameters`
/// object directly. Instead, the system creates one and passes it to the
-///``NSWritingToolsCoordinator/writingToolsCoordinator(_:replaceRange:inContext:proposedText:reason:animationParameters:completion:)``
+///``NSWritingToolsCoordinator/Delegate/writingToolsCoordinator(_:replace:in:proposedText:reason:animationParameters:completion:)``
///method of your ``NSWritingToolsCoordinator/Delegate`` object. Use that
///object to specify the blocks to run during and after the system animations.
API_AVAILABLE(macos(15.2)) NS_SWIFT_SENDABLE NS_SWIFT_NAME(NSWritingToolsCoordinator.AnimationParameters)