objcjs-types 0.1.0 → 0.2.0

package/dist/AppKit/NSWorkspace.d.ts

@@ -29,15 +29,15 @@ export declare class _NSWorkspace extends _NSObject {
     /**
      * Open a URL asynchronously with the given configuration. The completion handler is called on a concurrent queue with either the NSRunningApplication on success, or an NSError on failure.
      */
-    openURL$configuration$completionHandler$(url: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject): void;
+    openURL$configuration$completionHandler$(url: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject | null): void;
     /**
      * Open URLs in a specified application with the given configuration. The completion handler is called on a concurrent queue with either the NSRunningApplication on success, or an NSError on failure.
      */
-    openURLs$withApplicationAtURL$configuration$completionHandler$(urls: _NSArray, applicationURL: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject): void;
+    openURLs$withApplicationAtURL$configuration$completionHandler$(urls: _NSArray, applicationURL: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject | null): void;
     /**
      * Launch the application at the specified URL with the given configuration. The completion handler is called on a concurrent queue with either the NSRunningApplication on success, or an NSError on failure.
      */
-    openApplicationAtURL$configuration$completionHandler$(applicationURL: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject): void;
+    openApplicationAtURL$configuration$completionHandler$(applicationURL: _NSURL, configuration: _NSWorkspaceOpenConfiguration, completionHandler: NobjcObject | null): void;
     /**
      * Activate the Finder and open a window selecting the file at the given path. If fullPath is nil, this will instead open the directory specified by rootFullPath, and not select any file. If rootFullPath is the empty string (@""), the file is selected in the main viewer. Otherwise, a new file viewer is opened.
      */
@@ -75,12 +75,12 @@ export declare class _NSWorkspace extends _NSObject {
     /**
      * Asynchronous file operations. recycleURLs moves the given files to the trash, and duplicateURLs duplicates them in the same manner as the Finder. If completionHandler is not nil, it will be called when the operation is complete, on the same dispatch queue that was used for the recycleURLs: call. Within the completion handler, the newURLs dictionary parameter maps the given URLs to their new URLs in the Trash. Files that could not be moved to the Trash will not be present in the dictionary. If the operation succeeded for every file, the error parameter will be nil. If it failed for one or more files, the error parameter will describe the overall result of the operation in a manner suitable for presentation to the user. The completionHandler may be nil if you are not interested in the results. These methods may show a progress indicator, or other user interface elements, at AppKit's discretion. In Mac OS X 10.6, these methods require that the main run loop be run in a common mode.
      */
-    recycleURLs$completionHandler$(URLs: _NSArray, handler: NobjcObject): void;
-    duplicateURLs$completionHandler$(URLs: _NSArray, handler: NobjcObject): void;
+    recycleURLs$completionHandler$(URLs: _NSArray, handler: NobjcObject | null): void;
+    duplicateURLs$completionHandler$(URLs: _NSArray, handler: NobjcObject | null): void;
     /**
      * Gets information about the filesystem. fullPath is the path to any file or directory on the filesystem, including the filesystem's mount point. The returned values have the following significance: - isRemovable: whether the filesystem is backed by removable media, such as a CD or floppy disk. - isWritable: whether the filesystem can be written to - isUnmountable: whether the filesystem can be unmounted. - description: typically the type of the volume or the name of the filesystem - the file system type, for example, 'hfs'
      */
-    getFileSystemInfoForPath$isRemovable$isWritable$isUnmountable$description$type$(fullPath: _NSString, removableFlag: NobjcObject, writableFlag: NobjcObject, unmountableFlag: NobjcObject, description: NobjcObject, fileSystemType: NobjcObject): boolean;
+    getFileSystemInfoForPath$isRemovable$isWritable$isUnmountable$description$type$(fullPath: _NSString, removableFlag: NobjcObject | null, writableFlag: NobjcObject | null, unmountableFlag: NobjcObject | null, description: NobjcObject | null, fileSystemType: NobjcObject | null): boolean;
     /**
      * Attempt to eject the volume mounted at the given path. Returns YES if successful, NO if not, for example, if the volume is not ejectable.
      */
@@ -88,7 +88,7 @@ export declare class _NSWorkspace extends _NSObject {
     /**
      * Same as unmountAndEjectDeviceAtPath, except it takes an NSURL and returns an NSError.
      */
-    unmountAndEjectDeviceAtURL$error$(url: _NSURL, error: NobjcObject): boolean;
+    unmountAndEjectDeviceAtURL$error$(url: _NSURL, error: NobjcObject | null): boolean;
     /** extendPowerOffBy: is currently not implemented. Do not use it. */
     extendPowerOffBy$(requested: number): number;
     /** Attempt to hide all other applications. */
@@ -112,15 +112,15 @@ export declare class _NSWorkspace extends _NSObject {
     /**
      * Sets the default handler for files with the same UTType as the one specified. Does not apply to non-file URLs. Some UTTypes require user consent before you can change their handlers. If a change requires user consent, the system will ask the user asynchronously before invoking the completion handler.
      */
-    setDefaultApplicationAtURL$toOpenContentTypeOfFileAtURL$completionHandler$(applicationURL: _NSURL, url: _NSURL, completionHandler: NobjcObject): void;
+    setDefaultApplicationAtURL$toOpenContentTypeOfFileAtURL$completionHandler$(applicationURL: _NSURL, url: _NSURL, completionHandler: NobjcObject | null): void;
     /**
      * Sets the default handler for URLs with the same scheme as the one specified. Some URL schemes require user consent before you can change their handlers. If a change requires user consent, the system will ask the user asynchronously before invoking the completion handler.
      */
-    setDefaultApplicationAtURL$toOpenURLsWithScheme$completionHandler$(applicationURL: _NSURL, urlScheme: _NSString, completionHandler: NobjcObject): void;
+    setDefaultApplicationAtURL$toOpenURLsWithScheme$completionHandler$(applicationURL: _NSURL, urlScheme: _NSString, completionHandler: NobjcObject | null): void;
     /**
      * Sets the default handler for the specified file (rather than all files like it.) Does not apply to non-file URLs. Some files require user consent before you can change their handlers. Write access to the specified URL is required. If a change requires user consent, the system will ask the user asynchronously before invoking the completion handler.
      */
-    setDefaultApplicationAtURL$toOpenFileAtURL$completionHandler$(applicationURL: _NSURL, url: _NSURL, completionHandler: NobjcObject): void;
+    setDefaultApplicationAtURL$toOpenFileAtURL$completionHandler$(applicationURL: _NSURL, url: _NSURL, completionHandler: NobjcObject | null): void;
     /**
      * Returns the URL to the default application that would be used to open the given URL, as if the file were double clicked in the Finder. This returns nil if no app can open it.
      */
@@ -132,16 +132,16 @@ export declare class _NSWorkspace extends _NSObject {
     /**
      * Sets the default handler for the specified UTType. Some types require user consent before you can change their handlers. If a change requires user consent, the system will ask the user asynchronously before invoking the completion handler.
      */
-    setDefaultApplicationAtURL$toOpenContentType$completionHandler$(applicationURL: _NSURL, contentType: _UTType, completionHandler: NobjcObject): void;
+    setDefaultApplicationAtURL$toOpenContentType$completionHandler$(applicationURL: _NSURL, contentType: _UTType, completionHandler: NobjcObject | null): void;
     /**
      * Sets the desktop image for the given screen to the image at the given URL. The URL must be a file URL and may not be nil. The options dictionary may contain any of the NSWorkspaceDesktopImage keys, which control how the image is scaled on the screen. This returns YES if the image was successfully set; otherwise, NO is returned and an error is returned by reference. You should normally NOT present a user interface for picking the options. Instead, just choose appropriate defaults and allow the user to adjust them in the System Preference Pane.
      */
-    setDesktopImageURL$forScreen$options$error$(url: _NSURL, screen: _NSScreen, options: _NSDictionary, error: NobjcObject): boolean;
+    setDesktopImageURL$forScreen$options$error$(url: _NSURL, screen: _NSScreen, options: _NSDictionary, error: NobjcObject | null): boolean;
     /** Returns the URL for the desktop image for the given screen. */
     desktopImageURLForScreen$(screen: _NSScreen): _NSURL | null;
     /** Returns the options dictionary for the desktop image for the given screen. */
     desktopImageOptionsForScreen$(screen: _NSScreen): _NSDictionary | null;
-    requestAuthorizationOfType$completionHandler$(type: NSWorkspaceAuthorizationType, completionHandler: NobjcObject): void;
+    requestAuthorizationOfType$completionHandler$(type: NSWorkspaceAuthorizationType, completionHandler: NobjcObject | null): void;
     /**
      * Open a file at some path. If you use the variant without the withApplication: parameter, or if you pass nil for this parameter, the default application is used. The appName parameter may be a full path to an application, or just the application's name, with or without the .app extension. If you pass YES for andDeactivate:, or call a variant without this parameter, the calling app is deactivated before the new app is launched, so that the new app may come to the foreground unless the user switches to another application in the interim. Passing YES for andDeactivate: is generally recommended.
      * @deprecated Use -[NSWorkspace openURL:] instead.
@@ -164,17 +164,17 @@ export declare class _NSWorkspace extends _NSObject {
      * Launches the app at the given URL. If the app is successfully launched, a reference to the new running app is returned. If the app is already running, and NSWorkspaceLaunchNewInstance is not specified, then a reference to the existing app is returned. If the app could not be launched, nil is returned and an NSError is returned by reference. The configuration dictionary can be used to pass additional options to the app. The configuration dictionary may be empty, in which case default behavior applies.
      * @deprecated Use -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.
      */
-    launchApplicationAtURL$options$configuration$error$(url: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject): _NSRunningApplication | null;
+    launchApplicationAtURL$options$configuration$error$(url: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject | null): _NSRunningApplication | null;
     /**
      * Opens the given URL in an the application that claims it. An NSRunningApplication instance representing the app that the URL was opened in is returned. If the app could not be launched or no app claims the URL, nil is returned and an NSError is returned by reference. The options and configuration parameters are the same as those in launchApplicationAtURL:options:configuration:error:.
      * @deprecated Use -[NSWorkspace openURL:configuration:completionHandler:] instead.
      */
-    openURL$options$configuration$error$(url: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject): _NSRunningApplication | null;
+    openURL$options$configuration$error$(url: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject | null): _NSRunningApplication | null;
     /**
      * Opens the given URLs in the application at applicationURL. Returns the NSRunningApplication for the app the URLs were opened in. If the app could not be launched, nil is returned and an NSError is returned by reference. The options and configuration parameters are the same as those in launchApplicationAtURL:options:configuration:error:.
      * @deprecated Use -[NSWorkspace openURLs:withApplicationAtURL:configuration:completionHandler:] instead.
      */
-    openURLs$withApplicationAtURL$options$configuration$error$(urls: _NSArray, applicationURL: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject): _NSRunningApplication | null;
+    openURLs$withApplicationAtURL$options$configuration$error$(urls: _NSArray, applicationURL: _NSURL, options: NSWorkspaceLaunchOptions, configuration: _NSDictionary, error: NobjcObject | null): _NSRunningApplication | null;
     /**
      * This currently does the same thing as launchApplication:. Its use is discouraged.
      * @deprecated Use -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.
@@ -194,11 +194,11 @@ export declare class _NSWorkspace extends _NSObject {
      * The following methods launch an app with the given bundle identifier. The descriptor describes the first AppleEvent to be sent to the process. The launchIdentifier is currently of no significance. If the application is already running, and NSWorkspaceLaunchNewInstance is not specified in the options, then the descriptor is delivered to the currently running app, and YES is returned.
      * @deprecated Use -[NSWorkspace openApplicationAtURL:configuration:completionHandler:] instead.
      */
-    launchAppWithBundleIdentifier$options$additionalEventParamDescriptor$launchIdentifier$(bundleIdentifier: _NSString, options: NSWorkspaceLaunchOptions, descriptor: _NSAppleEventDescriptor | null, identifier: NobjcObject): boolean;
+    launchAppWithBundleIdentifier$options$additionalEventParamDescriptor$launchIdentifier$(bundleIdentifier: _NSString, options: NSWorkspaceLaunchOptions, descriptor: _NSAppleEventDescriptor | null, identifier: NobjcObject | null): boolean;
     /**
      * @deprecated Use -[NSWorkspace openURLs:withApplicationAtURL:configuration:completionHandler:] instead.
      */
-    openURLs$withAppBundleIdentifier$options$additionalEventParamDescriptor$launchIdentifiers$(urls: _NSArray, bundleIdentifier: _NSString | null, options: NSWorkspaceLaunchOptions, descriptor: _NSAppleEventDescriptor | null, identifiers: NobjcObject): boolean;
+    openURLs$withAppBundleIdentifier$options$additionalEventParamDescriptor$launchIdentifiers$(urls: _NSArray, bundleIdentifier: _NSString | null, options: NSWorkspaceLaunchOptions, descriptor: _NSAppleEventDescriptor | null, identifiers: NobjcObject | null): boolean;
     /** @deprecated */
     openTempFile$(fullPath: _NSString): boolean;
     /** @deprecated */
@@ -246,12 +246,12 @@ export declare class _NSWorkspace extends _NSObject {
      * Performs the given file operation, blocking until complete. source should be the directory containing the file(s). For operations that require a destination, such as Move and Copy, destination should be the destination directory; otherwise it should be nil. files is an array of file names that are in the source directory. A value is returned by reference in the tag parameter, either 0 for success, or -1 for failure. tag may be NULL.
      * @deprecated
      */
-    performFileOperation$source$destination$files$tag$(operation: number, source: _NSString, destination: _NSString, files: _NSArray, tag: NobjcObject): boolean;
+    performFileOperation$source$destination$files$tag$(operation: _NSString, source: _NSString, destination: _NSString, files: _NSArray, tag: NobjcObject | null): boolean;
     /**
      * Get, by reference, the name of the app used to open a file at the given path, and the type of the file. The type of the file will either be a filename extension or an HFS type encoded with NSFileTypeForHFSTypeCode(). Both strings are returned autoreleased. The method returns YES if successful, NO if not.
      * @deprecated Use -[NSWorkspace URLForApplicationToOpenURL:] to get the URL of an application that will open a given item, or -[NSURL getResourceValue:forKey:error:] with NSURLContentTypeKey to get the type of the given item.
      */
-    getInfoForFile$application$type$(fullPath: _NSString, appName: NobjcObject, type: NobjcObject): boolean;
+    getInfoForFile$application$type$(fullPath: _NSString, appName: NobjcObject | null, type: NobjcObject | null): boolean;
     /**
      * Get the icon for a given file type. The file type may be a filename extension, or a HFS code encoded via NSFileTypeForHFSTypeCode, or a Universal Type Identifier (UTI). Returns a default icon if the operation fails.
      * @deprecated Use -[NSWorkspace iconForContentType:] instead.
@@ -261,7 +261,7 @@ export declare class _NSWorkspace extends _NSObject {
      * Given an absolute file path, return the uniform type identifier (UTI) of the file, if one can be determined. Otherwise, return nil after setting *outError to an NSError that encapsulates the reason why the file's type could not be determined. If the file at the end of the path is a symbolic link the type of the symbolic link will be returned. You can invoke this method to get the UTI of an existing file. To get the UTI of a URL, use the NSURLTypeIdentifierKey file system resource key from NSURL.h.
      * @deprecated Use -[NSURL getResourceValue:forKey:error:] with NSURLContentTypeKey instead.
      */
-    typeOfFile$error$(absoluteFilePath: _NSString, outError: NobjcObject): _NSString | null;
+    typeOfFile$error$(absoluteFilePath: _NSString, outError: NobjcObject | null): _NSString | null;
     /**
      * Given a UTI, return a string that describes the document type and is fit to present to the user, or nil for failure. You can invoke this method to get the name of a type that must be shown to the user, in an alert about your application's inability to handle the type, for instance.
      * @deprecated Use UTType.localizedDescription instead.

package/dist/AppKit/NSWorkspaceOpenConfiguration.d.ts

@@ -1,4 +1,3 @@
-import type { NobjcObject } from "objc-js";
 import type { _NSAppleEventDescriptor } from "../Foundation/NSAppleEventDescriptor.js";
 import type { _NSArray } from "../Foundation/NSArray.js";
 import type { _NSDictionary } from "../Foundation/NSDictionary.js";
@@ -61,8 +60,8 @@ export declare class _NSWorkspaceOpenConfiguration extends _NSObject {
     /**
      * A cpu_type_t (from <mach/machine.h>) that specifies the architecture to launch. Ignored if a new instance is not launched. Defaults to CPU_TYPE_ANY. When CPU_TYPE_ANY, the system will decide the preferred architecture based on those present in the executable.
      */
-    architecture(): NobjcObject;
-    setArchitecture$(value: NobjcObject): void;
+    architecture(): number;
+    setArchitecture$(value: number): void;
     /**
      * Only open the provided URL if it is a valid universal link with an application configured to open it. If there is no application configured, or the user disabled using it to open the link, then the open will fail with an error. Defaults to NO.
      */

package/dist/AppKit/NSWritingToolsCoordinatorAnimationParameters.d.ts

@@ -11,11 +11,11 @@ export declare class _NSWritingToolsCoordinatorAnimationParameters extends _NSOb
     /**
      * A custom block that runs at the same time as the system animations. If you have animations you want to run at the same time as the system animations, assign a block to this property and use it to run your animations. The block you provide must have no return value and take a floating-point value as a parameter. The parameter indicates the current progress of the animations as a percentage value between `0.0` to `1.0`. The system executes your block multiple times during the course of the animations, providing an updated completion value each time.
      */
-    progressHandler(): NobjcObject;
-    setProgressHandler$(value: NobjcObject): void;
+    progressHandler(): NobjcObject | null;
+    setProgressHandler$(value: NobjcObject | null): void;
     /**
      * A custom block to run when the system animations finish. Set this property to a block that you want the system to run when any animations finish. The block you provide must have no return value and no parameters. The system executes this block once when the current animation finish.
      */
-    completionHandler(): NobjcObject;
-    setCompletionHandler$(value: NobjcObject): void;
+    completionHandler(): NobjcObject | null;
+    setCompletionHandler$(value: NobjcObject | null): void;
 }

package/dist/AppKit/NSWritingToolsCoordinatorDelegate.d.ts

@@ -19,7 +19,7 @@ export interface _NSWritingToolsCoordinatorDelegate {
     /**
      * Tells the delegate that there are text changes to incorporate into the view. - Parameters: - writingToolsCoordinator: The coordinator object providing the changes to your custom view. - range: A range of text to update. This range is relative to the text in your context object, and it’s your responsibility to match that location to the correct location in your text storage. If you initialized the context object with the entire contents of your view’s text storage, you can use `range` as-is to access that text storage. However, if you initialized the context object with only a portion of your view’s text, add the starting location of your context object’s text to this value to get the correct range for that text storage. - context: The context object that contains the original text to modify. Use this object to locate the correct text storage object for your view. - replacementText: The text to insert in place of the current text at `range`. You can insert this text as-is, insert a modified version of this string, or reject the replacement text altogether. - reason: The type of replacement Writing Tools performs. This parameter indicates whether Writing Tools is replacing the text with or without animations. - animationParameters: The animation parameters for any interactive changes, or `nil` if the changes aren’t interactive. Use this object to create any additional animations for the system to run alongside the changes Writing Tools makes. For example, use it to update other views that contain related information. - completion: A completion handler to execute with the results of the operation. The handler has no return value and takes an optional attributed string as a parameter. If you incorporate the replacement text, either as-is or with modifications, pass the actual string you incorporated to the completion block. If you reject the suggested change and leave the original text unchanged, specify `nil` for this parameter. Use this method to update your view’s text storage with the proposed changes. Writing Tools can call this method multiple times during the course of a session to notify you of changes to different ranges of text. Incorporate the changes into your view’s text storage and notify your layout manager so it can refresh the view. > Important: When integrating changes, remember to update `range.location` as needed to get the correct location in your view’s text storage. Remove the text in the appropriate range of your text storage, and replace it with the contents of `replacementText`. When you finish, call the completion handler and pass in the replacement text you inserted. If you change the string in `replacementText` before incorporating it into your text storage, return your modified string instead. Returning the string lets Writing Tools track any alterations you made to it. You can also pass `nil` to the completion handler if you don’t incorporate the replacement text. For interactive changes, Writing Tools works with your delegate to animate the removal of the old text and the insertion of any replacement text. If 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.
      */
-    writingToolsCoordinator$replaceRange$inContext$proposedText$reason$animationParameters$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, range: NSRange, context: _NSWritingToolsCoordinatorContext, replacementText: _NSAttributedString, reason: NSWritingToolsCoordinatorTextReplacementReason, animationParameters: _NSWritingToolsCoordinatorAnimationParameters | null, completion: NobjcObject): void;
+    writingToolsCoordinator$replaceRange$inContext$proposedText$reason$animationParameters$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, range: NSRange, context: _NSWritingToolsCoordinatorContext, replacementText: _NSAttributedString, reason: NSWritingToolsCoordinatorTextReplacementReason, animationParameters: _NSWritingToolsCoordinatorAnimationParameters | null, completion: NobjcObject | null): void;
     /**
      * Asks the delegate to update your view’s current text selection. - Parameters: - writingToolsCoordinator: The coordinator object making the change to your view. - ranges: One or more ranges of text to select. Each range is relative to the text in your context object, and it’s your responsibility to match each location to the correct location in your text storage. If you initialized the context object with the entire contents of your view’s text storage, you can use the ranges as-is to access that text storage. However, if you initialized the context object with only a portion of your view’s text, add the starting location of your context object’s text to each value to get the correct range for that text storage. - context: The context object you use to identify the associated text storage. - completion: The completion handler to execute when your delegate finishes updating the selection. The handler has no parameters or return value. You must call this handler at some point during the implementation of your method. As Writing Tools suggests changes to your view’s text, it calls this method to update the text selection accordingly. Use this method to update the current selection in your view’s text storage. When you finish making the changes, call the provided completion block to let Writing Tools know you’re finished.
      */
@@ -39,11 +39,11 @@ export interface _NSWritingToolsCoordinatorDelegate {
     /**
      * Asks the delegate for a preview image and layout information for the specified text. - Parameters: - writingToolsCoordinator: The coordinator object notifying you that animations are about to begin. - textAnimation: The type of animation Writing Tools is preparing. - range: The range of text that requires a preview image. This range is relative to the text in your context object, and it’s your responsibility to match that location to the correct location in your text storage. If you initialized the context object with the entire contents of your view’s text storage, you can use `range` as-is to access that text storage. However, if you initialized the context object with only a portion of your view’s text, add the starting location of your context object’s text to this value to get the correct range for that text storage. - context: The context object that contains the original text. Use this object to fetch the current text, and to match that text to your underlying text storage. - completion: A completion handler to execute when you are done. The handler has no return value and takes an ``NSTextPreview`` object as a parameter. You must call this handler at some point during your implementation. During an interactive evaluation of your view’s text, Writing Tools creates different animations to provide feedback on what’s happening. As part of the preparation for those animations, Writing Tools asks you to provide a preview of the affected content in your view. Writing Tools uses this preview to build and execute the animations in the view stored in the ``NSWritingToolsCoordinator/effectContainerView`` property of the coordinator object. To build a preview of your content in macOS, render the specified range of text 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. For a single animation type, the system calls the ``writingToolsCoordinator(_:prepareFor:range:context: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 method in the sequence only after you call the completion handler of the previous method. However, multiple animations can run simultaneously, so check the `textAnimation` parameter to differentiate sequences.
      */
-    writingToolsCoordinator$requestsPreviewForTextAnimation$ofRange$inContext$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, textAnimation: NSWritingToolsCoordinatorTextAnimation, range: NSRange, context: _NSWritingToolsCoordinatorContext, completion: NobjcObject): void;
+    writingToolsCoordinator$requestsPreviewForTextAnimation$ofRange$inContext$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, textAnimation: NSWritingToolsCoordinatorTextAnimation, range: NSRange, context: _NSWritingToolsCoordinatorContext, completion: NobjcObject | null): void;
     /**
      * Asks the delegate for a preview image and layout information for the specified text. - Parameters: - writingToolsCoordinator: The coordinator object notifying you that animations are about to begin. - rect: The portion of your view that contains the requested text. This rectangle is in the view’s coordinate system. - context: The context object that contains the original text. Use this object to fetch the current text, and to match that text to your underlying text storage. - completion: A completion handler to execute when you are done. The handler has no return value and takes an ``NSTextPreview`` object as a parameter. You must call this handler at some point during your implementation. During an interactive evaluation of your view’s text, Writing Tools creates different animations to provide feedback on what’s happening. As part of the preparation for those animations, Writing Tools asks you to provide a preview of the affected content in your view. Writing Tools uses this preview to build and execute the animations in the view stored in the ``NSWritingToolsCoordinator/effectContainerView`` property of the coordinator object. To build a preview of your content in macOS, render the requested portion 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. For a single animation type, the system calls the ``writingToolsCoordinator(_:prepareFor:range:context: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 method in the sequence only after you call the completion handler of the previous method. However, multiple animations can run simultaneously, so check the `textAnimation` parameter to differentiate sequences.
      */
-    writingToolsCoordinator$requestsPreviewForRect$inContext$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, rect: CGRect, context: _NSWritingToolsCoordinatorContext, completion: NobjcObject): void;
+    writingToolsCoordinator$requestsPreviewForRect$inContext$completion$?(writingToolsCoordinator: _NSWritingToolsCoordinator, rect: CGRect, context: _NSWritingToolsCoordinatorContext, completion: NobjcObject | null): void;
     /**
      * Asks the delegate to clean up any state related to the specified Writing Tools animation. - Parameters: - writingToolsCoordinator: The coordinator object notifying you that animations are about to begin. - textAnimation: The type of animation Writing Tools finished. - range: The range of text that finished animating. This range is relative to the text in your context object, and it’s your responsibility to match that location to the correct location in your text storage. If you initialized the context object with the entire contents of your view’s text storage, you can use `range` as-is to access that text storage. However, if you initialized the context object with only a portion of your view’s text, add the starting location of your context object’s text to this value to get the correct range for that text storage. - context: The context object that contains the original text. - completion: A completion handler to execute when you are done. The handler has no return value and takes no parameters. You must call this handler at some point during your implementation. Use this method to clean up any data structures you created to support the specified type of Writing Tools animation. You can also use this method to restore the visibility of any text you hid previously. When 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:)`` 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 take don’t interfere with other in-flight animations.
      */