objcjs-types 0.1.0 → 0.2.1

package/dist/FileProvider/NSFileProviderPartialContentFetching.d.ts

@@ -1,5 +1,6 @@
 import type { NobjcObject } from "objc-js";
 import type { _NSProgress } from "../Foundation/NSProgress.js";
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSFileProviderItemVersion } from "./NSFileProviderItemVersion.js";
 import type { _NSFileProviderRequest } from "./NSFileProviderRequest.js";
 import type { NSRange } from "../structs/NSRange.js";
@@ -8,5 +9,5 @@ export interface _NSFileProviderPartialContentFetching {
     /**
      * Download the requested extent of an item for the given identifier and return it via the completion handler. If this protocol is not implemented the system defaults to fetchContentsForItemWithIdentifier. The requestedVersion parameter specifies which version should be returned. This version will always be specified by the system so as to prevent extents from different versions from being written into the same file. The system tolerates a version mismatch for the first materialization of a fully dataless file (strictVersion=NO). The requested range is <location , length>. The implementation can provide any properly aligned range that covers the requested range (including the entire item). The system provides the minimal alignment value. The location (or start offset) of the fetched range should be a multiple of this value for it to be considered properly aligned. The length of the fetched range should be a multiple of this value, with an exception for the end of the file, checked against the documentSize attribute the implementation supplied for this item. The alignment value should not be expected to be stable across reboots. It is guaranteed by the system to be a power of two. In addition to the content the extension needs to fill in fetchedRange with either the requestest range, <location , length>, or indicate full materialization with, < 0, file size>. On-disk layout: --------------- The retrieved content at `fileContents` URL must be a regular file on the same volume as the user-visible URL. A suitable location can be retrieved using -[NSFileProviderManager temporaryDirectoryURLWithError:]. The file contents outside of the fetched range are ignored by the system. The system only requires the file to be at least as large as the end of the fetched range. For instance, if the fetchedRange is {offset:0x100000, length:0x1000}, the file size must be at least 0x101000 bytes. Any data (or lack thereof) beyond the fetched range is ignored. The fetched range must be stored in this file at the same offset as the range indicates. For instance if the retrievedRange is {offset:0x100000, length:0x1000} then it should actually be at offset 0x100000 in the `fileContents` file. The ranges {0, 0x100000}, and {0x101000, EOF} can be anything including sparse ranges. Concurrent Downloads: --------------- The system will call fetchContents concurrently if there are multiple outstanding file download requests. The provider can control the concurrency by setting the key NSExtensionFileProviderDownloadPipelineDepth in the Info.plist of the extension to the number of concurrent downloads that the system should create per domain. This number must be between 1 and 128, inclusive. File ownership: --------------- The system clones and unlinks the received fileContents. The extension should not mutate the corresponding file after calling the completion handler. If the extension wishes to keep a copy of the content, it must provide a clone of the that content as the URL passed to the completion handler. In case the extension or the system crashes between the moment the completion handler is called and the moment the system unlinks the file, the file may unexpectedly still be on disk the next time an instance of the extension is created. The extension is then responsible for deleting that file. Disallowing processes from fetching items: --------------- The system automatically downloads files on POSIX accesses. The extension may wish to disallow this class of downloads for specific applications. The extension can set an array of strings into the UserDefault key "NSFileProviderExtensionNonMaterializingProcessNames". A process whose executable's filename on disk is an exact match for an entry in this array will not be allowed to fetch items in the extension's domains. The comparison is case sensitive. In macOS 11.0 and later, this list will be checked when a download is initiated through a POSIX filesystem call. In macOS 11.4 and later, this list will also be checked for downloads initiated through file coordination. Error cases: ------------ If the download fails because the item is unknown, the call should fail with the NSFileProviderErrorNoSuchItem error. In that case, the system will consider the item has been removed from the domain and will attempt to delete it from disk. In case that deletion fails because there are local changes on this item, the system will re-create the item using createItemBasedOnTemplate. If the user does not have access to the content of the file, the provider can fail the call with NSCocoaErrorDomain and code NSFileReadNoPermissionError. That error will then be presented to the user. The extension can also report the NSFileProviderErrorNotAuthenticated, NSFileProviderErrorServerUnreachable in case the item cannot be fetched because of the current state of the system / domain. In those cases, the system will present an appropriate error message and back off until the next time it is signalled. If the requested version cannot be retrieved, the provider can choose to provide a different version of the file, unless NSFileProviderFetchContentsOptionsStrictVersioning is set. In this case, the provider should fail with NSFileProviderErrorVersionNoLongerAvailable. If some content is returned, the item must have the corresponding version. The system will detect any mismatch and handle it as a remote update. For the reading application, the materialization will fail with the same error as reading from a dataless file that got remotely updated (-1/errno=ESTALE). Upon retry the new version will be requested by the system. Any other error will be considered to be transient and will cause the download to be retried. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, nil, someRange, 0, NSUserCancelledError) in the NSProgress cancellation handler. The returned NSProgress is used to show progress to the user. If the user cancels the fetch, the extension should stop fetching the item, as it is no longer required. Execution time: --------------- The system will grant enough time to the extension to download the file. The system will interrupt the call if it stops making progress or if download takes an unexpectedly long time. In that case, the system will call `cancel` on the progress. The extension is then expected to quickly call the completion handler.
      */
-    fetchPartialContentsForItemWithIdentifier$version$request$minimalRange$aligningTo$options$completionHandler$?(itemIdentifier: number, requestedVersion: _NSFileProviderItemVersion, request: _NSFileProviderRequest, requestedRange: NSRange, alignment: number, options: NSFileProviderFetchContentsOptions, completionHandler: NobjcObject): _NSProgress;
+    fetchPartialContentsForItemWithIdentifier$version$request$minimalRange$aligningTo$options$completionHandler$?(itemIdentifier: _NSString, requestedVersion: _NSFileProviderItemVersion, request: _NSFileProviderRequest, requestedRange: NSRange, alignment: number, options: NSFileProviderFetchContentsOptions, completionHandler: NobjcObject | null): _NSProgress;
 }

package/dist/FileProvider/NSFileProviderReplicatedExtension.d.ts

@@ -1,9 +1,11 @@
 import type { NobjcObject } from "objc-js";
 import type { _NSFileProviderDomain } from "./NSFileProviderDomain.js";
 import type { _NSFileProviderEnumerating } from "./NSFileProviderEnumerating.js";
+import type { _NSFileProviderItem } from "./NSFileProviderItem.js";
 import type { _NSFileProviderItemVersion } from "./NSFileProviderItemVersion.js";
 import type { _NSFileProviderRequest } from "./NSFileProviderRequest.js";
 import type { _NSProgress } from "../Foundation/NSProgress.js";
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSURL } from "../Foundation/NSURL.js";
 import type { NSFileProviderCreateItemOptions } from "./NSFileProviderCreateItemOptions.js";
 import type { NSFileProviderDeleteItemOptions } from "./NSFileProviderDeleteItemOptions.js";
@@ -19,23 +21,23 @@ export interface _NSFileProviderReplicatedExtension extends _NSFileProviderEnume
     /**
      * Fetch the metadata for the item with the provider identifier. Error cases: ------------ If the metadata lookup fails because the item is unknown, the call should fail with the NSFileProviderErrorNoSuchItem error. In that case, the system will consider the item has been removed from the domain and will attempt to delete it from disk. In case that deletion fails because there are local changes on this item, the system will re-create the item using createItemBasedOnTemplate. The extension can also report the NSFileProviderErrorNotAuthenticated, NSFileProviderErrorServerUnreachable in case the item cannot be fetched because of the current state of the system / domain. In that case, the system will present an appropriate error message and back off until the next time it is signalled. Any other error, including crashes of the extension process, will be considered to be transient and will cause the lookup to be retried. Errors must be in one of the following domains: NSCocoaErrorDomain, NSFileProviderErrorDomain. For errors which can not be represented using an existing error code in one of these domains, the extension should construct an NSError with domain NSCocoaErrorDomain and code NSXPCConnectionReplyInvalid. The extension should set the NSUnderlyingErrorKey in the NSError's userInfo to the error which could not be represented. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- This method is not expected to take more than a few seconds to complete the retrieval of the metadata of the item. If the operation may not complete in a reasonable amount of time because, for instance, of bad network conditions, it is recommended to report an error (for instance NSFileProviderErrorServerUnreachable). The system will call `cancel` on the progress if the operation takes too much time. The extension is then expected to quickly call the completion handler.
      */
-    itemForIdentifier$request$completionHandler$?(identifier: number, request: _NSFileProviderRequest, completionHandler: NobjcObject): _NSProgress;
+    itemForIdentifier$request$completionHandler$?(identifier: _NSString, request: _NSFileProviderRequest, completionHandler: NobjcObject | null): _NSProgress;
     /**
      * Download the item for the given identifier and return it via the completion handler. The system learns of items through enumerations. Initially, this means that the system is aware that an item (with a specific version) exists on the device. When the user accesses the item, the system makes a request for the contents of the item. The provider can then fulfill the request by providing the item. The system takes ownership of the item and will move it out of the sandbox of the provider. If the provider wishes to force materialization of a given item, the provider should use `-[NSFileProviderManager requestDownloadForItemWithIdentifier:requestedRange:completionHandler:]`, or configure the `-[NSFileProviderItem contentPolicy]`. The requestedVersion parameter specifies which version should be returned. A nil value means that the latest known version should be returned. Except for the error case, the version of the returned item is assumed to be identical to what was requested. requestedVersion is currently always set to nil. Concurrent Downloads: ---------- The system will call fetchContents concurrently if there are multiple outstanding file download requests. The provider can control the concurrency by setting the key NSExtensionFileProviderDownloadPipelineDepth in the Info.plist of the extension to the number of concurrent downloads that the system should create per domain. This number must be between 1 and 128, inclusive. File ownership: --------------- The retrieved content at `fileContents` URL must be a regular file on the same volume as the user-visible URL. A suitable location can be retrieved using -[NSFileProviderManager temporaryDirectoryURLWithError:]. The system clones and unlinks the received fileContents. The extension should not mutate the corresponding file after calling the completion handler. If the extension wishes to keep a copy of the content, it must provide a clone of the that content as the URL passed to the completion handler. In case the extension or the system crashes between the moment the completion handler is called and the moment the system unlinks the file, the file may unexpectedly still be on disk the next time an instance of the extension is created. The extension is then responsible for deleting that file. Disallowing processes from fetching items: --------------- The system automatically downloads files on POSIX accesses. The extension may wish to disallow this class of downloads for specific applications. The extension can set an array of strings into the UserDefault key "NSFileProviderExtensionNonMaterializingProcessNames". A process whose executable's filename on disk is an exact match for an entry in this array will not be allowed to fetch items in the extension's domains. The comparison is case sensitive. In macOS 11.0 and later, this list will be checked when a download is initiated through a POSIX filesystem call. In macOS 11.4 and later, this list will also be checked for downloads initiated through file coordination. Error cases: ------------ If the download fails because the item was deleted on the server, the call should fail with the NSFileProviderErrorNoSuchItem error. In that case, the system will consider the item has been removed from the domain and will attempt to delete it from disk. In case that deletion fails because there are local changes on this item, the system will re-create the item using createItemBasedOnTemplate, passing the NSFileProviderCreateItemDeletionConflicted flag. If the user does not have access to the content of the file, the provider can fail the call with NSCocoaErrorDomain and code NSFileReadNoPermissionError. That error will then be presented to the user. The extension can also report the NSFileProviderErrorNotAuthenticated, NSFileProviderErrorServerUnreachable in case the item cannot be fetched because of the current state of the system / domain. In those cases, the system will present an appropriate error message and back off until the next time it is signalled. Any other error, including crashes of the extension process, will be considered to be transient and will cause the download to be retried. Errors must be in one of the following domains: NSCocoaErrorDomain, NSFileProviderErrorDomain. For errors which can not be represented using an existing error code in one of these domains, the extension should construct an NSError with domain NSCocoaErrorDomain and code NSXPCConnectionReplyInvalid. The extension should set the NSUnderlyingErrorKey in the NSError's userInfo to the error which could not be represented. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, nil, NSUserCancelledError) in the NSProgress cancellation handler. The returned NSProgress is used to show progress to the user. If the user cancels the fetch, the extension should stop fetching the item, as it is no longer required. Execution time: --------------- The system will grant enough time to the extension to download the file. The system will interrupt the call if it stops making progress or if download takes an unexpectedly long time. In that case, the system will call `cancel` on the progress. The extension is then expected to quickly call the completion handler.
      */
-    fetchContentsForItemWithIdentifier$version$request$completionHandler$?(itemIdentifier: number, requestedVersion: _NSFileProviderItemVersion | null, request: _NSFileProviderRequest, completionHandler: NobjcObject): _NSProgress;
+    fetchContentsForItemWithIdentifier$version$request$completionHandler$?(itemIdentifier: _NSString, requestedVersion: _NSFileProviderItemVersion | null, request: _NSFileProviderRequest, completionHandler: NobjcObject | null): _NSProgress;
     /**
      * Create a new item. The itemTemplate object describes the expected state of the newly created item, including its location provided by parentItemIdentifier and filename. The list of fields to conside in that object is defined by the fields parameter. Fields not listed should be considered as not being defined. The url is used to transfer the content of the file from the system to the extension. It can be nil if the item has no content. This will be the case if the item is a folder or if the item is being reimported (flag NSFileProviderCreateItemMayAlreadyExist set) and the file is dataless on disk. If the item is a symbolic link, the target path is provided by the symlinkTargetPath of the itemTemplate. The system is setting the itemIdentifier of the itemTemplate to a unique value that is guaranteed to stay the same for a given item in case the creation is replayed after a crash. That itemIdentifier is not intended to be the identifier assigned to the item by the provider. In the completion block, the createdItem is expected to reflect the properties of the newly created item, which usually means matching the properties passed in by the template. An exception is the itemIdentifier which should be the identifier assigned to that item by the provider rather than the identifier passed in through the template. If the provider reuses an existing identifier, the item that used that identifier will be removed from disk, replaced by the createdItem. If the item is a directory, the two directories will be merged and the items from the existing one will be modified with the NSFileProviderModifyItemMayAlreadyExist option set. If the provider is not able to apply all the fields at once, it should return a set of stillPendingFields in its completion handler. In that case, the system will attempt to modify the item later by calling modifyItem with those fields. The filename and contents fields should be synced together. If synced independently, files may appear corrupted on other devices, due to a mismatch between the file extension and the actual file data. If a field in the returned createdItem does not match the itemTemplate, and is not in the list of stillPendingFields, the value from the createdItem will be propagated to the disk. If the content of the item as described by createdItem does not match the content from url, the provider should set shouldFetchContent in the completion handler. The content from the provider will then be fetched and propagated to disk. In case the deletion of an item from the working set could not be applied to the disk by the system because it conflicted with a local edit of the file, the system will attempt to create the edited item. In that case the creation call will receive the NSFileProviderCreateItemDeletionConflicted option and the itemIdentifier in the template will be set to the itemIdentifier of the item deleted from the working set. The itemVersion will also be set to the last itemVersion of the item that was made available on disk before the item was edited locally. If such a conflict happens on a dataless item on disk, the item will be immediately deleted from the disk instead of issuing a new creation. In case the NSFileProviderCreateItemMayAlreadyExist option is passed, the content may be nil if the item is found by the system without any associated content. In that case, you should return a nil item if you are not able to match the created item with an existing item from the provider. In case of path collision with an already existing item, the provider can either fail using -[NSError (NSFileProviderError) fileProviderErrorForCollisionWithItem:] or resolve the collision by itself (e.g. by returning an item with a different name). If the error is returned, the system will try to resolve the collision by itself by bouncing away one of the items (renaming the item). If the imported item is refused by the extension, it should return nil for the createdItem without any error. In that case, the source item will be deleted from disk. In case the item represents a directory, the content will be deleted recursively. If the extension does not wish to sync the item, while still keeping the item on disk, on macOS 13.0, iOS 16.0, and later, it should return `NSFileProviderErrorExcludedFromSync` on the completion handler. For more details, see the header comment for that error code. On earlier versions of macOS, where `NSFileProviderErrorExcludedFromSync` is unavailable, the extension could choose to respond to FileProvider API calls as if the item is synced to it's server, but the extension only tracks the item in it's own local database on the device. The extension must be careful to respond to all FileProvider API calls as if the file is really synced to it's server, including enumerations of the parent directory of that item, itemForIdentifier calls, etc. The progress returned by createItemBasedOnTemplate is expected to include the upload progress of the item and will be presented in the user interface until the completion handler is called. Creation is gated by the NSFileProviderItemCapabilitiesAllowsAddingSubItems capability on the parent folder on a UI level, but direct file system changes (e.g. from Terminal) can still result in changes that must be handled. Structural consistency: ----------------------- The system guarantees that the creation is called after the creation of the parent completed. File ownership: --------------- The file at `url` is owned by the system and is unlinked after the completion handler is called. If the extension wishes to keep access to the content of file after calling the completion handler, it should clone the file in its container. Atomicity: ---------- By default, the system assumes all the changes are applied non-atomically, which means that the change or an intermediary state from the change can be observed (for instance while enumerating the working set) while the call is in progress (before the completion handler is called). The provider can indicate to the system that it applies changes atomically (that is, the change cannot be observed before the completion handler is called) by setting the key NSExtensionFileProviderAppliesChangesAtomically in the Info.plist of the extension to YES. The atomicity declaration only describes the visibility of the changes, not the ability of the provider to apply all the fields at once: a provider that applies changes atomically might still apply a subset of the changedFields communicated by the system and defer the remaining fields by setting the stillPendingFields parameter in the completion handler. Error cases: ------------ If the creation fails because the target directory does not exist, the extension must fail the creation using the NSFileProviderErrorNoSuchItem error code. In that case, the system will attempt the re-create the parent directory. In case the location of the new item is already in use by another item, the extension can chose to either resolve the collision by moving one of the items away, or reject the creation with the NSFileProviderErrorFilenameCollision error code. In that error case, the system will be responsible for resolving the collision, by renaming one of the colliding items. When the collision is resolved, the system will call createItemBasedOnTemplate again. The extension can also report NSFileProviderErrorNotAuthenticated, NSFileProviderErrorCannotSynchronize, or NSFileProviderErrorExcludedFromSync, in case the modification cannot be applied because of the current state of the system / domain. In that case, the system will present an appropriate error message and back off until the next time it is signalled. The provider can signal the error resolution by calling signalErrorResolved:completionHandler:. Any other error, including crashes of the extension process, will be considered to be transient and will cause the creation to be retried. Errors must be in one of the following domains: NSCocoaErrorDomain, NSFileProviderErrorDomain. For errors which can not be represented using an existing error code in one of these domains, the extension should construct an NSError with domain NSCocoaErrorDomain and code NSXPCConnectionReplyInvalid. The extension should set the NSUnderlyingErrorKey in the NSError's userInfo to the error which could not be represented. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, [], NO, NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- The system will grant enough time to the extension to upload the file if content is passed to the call, otherwise the call is expected to completed within a few seconds. The system will interrupt the call if it stops making progress or if upload takes an unexpectedly long time. In that case, the system will call `cancel` on the progress. The extension is then expected to quickly call the completion handler.
      */
-    createItemBasedOnTemplate$fields$contents$options$request$completionHandler$?(itemTemplate: number, fields: NSFileProviderItemFields, url: _NSURL | null, options: NSFileProviderCreateItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject): _NSProgress;
+    createItemBasedOnTemplate$fields$contents$options$request$completionHandler$?(itemTemplate: _NSFileProviderItem, fields: NSFileProviderItemFields, url: _NSURL | null, options: NSFileProviderCreateItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject | null): _NSProgress;
     /**
      * Informs the provider that an item or its metadata have changed. More than one property may have changed, e.g. an item may have been renamed, moved and also changed contents, in which case changedFields might contain [.contents, .filename, .parentItemIdentifier, .contentModificationDate]. If the provider is not able to apply all the fields at once, it should return a set of stillPendingFields in its completion handler. In that case, the system will attempt to modify the item later by calling modifyItem with those fields. The filename and contents fields should be synced together. If synced independently, files may appear corrupted on other devices, due to a mismatch between the file extension and the actual file data. Starting in macOS 12.0, if the set of stillPendingFields returned by the provider is identical to the set of fields passed to modifyItem, then the system will consider that these fields are not supported by the provider. The system will not send these fields to the provider again, until the item is modified. If a field in the returned item does not match the itemTemplate, and is not in the list of stillPendingFields, the value from the item will be propagated to the disk. In case there is a content change and the content of the returned item as described by item does not match the content from url, the provider should set shouldFetchContent in the completion handler. The content from the provider will then be fetched and propagated to disk. If the item modification results from the parent directory being merged into another directory, the NSFileProviderModifyItemMayAlreadyExist flag will be passed to the call. The provider can chose to merge two existing items when receiving modifyItem. In that case, the item returned should carry the itemIdentifier of the item with which the item will be merged and well as the resulting state of that item. The system will then keep one of the items (the one whose itemIdentifier was returned) and remove the other one from disk. In case of directories, the content of the two directories is merged and sub-items will be modified with the NSFileProviderModifyItemMayAlreadyExist flag set. If the extension wishes the modify item to cause the deletion of the item on disk, it can call the completion handler with nil in place of the resulting item. If the item is directory, the item will be kept on disk until all its children has been deleted from the working set. The system will only apply the deletion on the disk if this does not conflict with local edits. Otherwise, the system will attempt to re-create the item with the NSFileProviderCreateItemDeletionConflicted option set. The progress returned by modifyItem is expected to include the upload progress if any, even if the provider chose to call the completion handler before the upload finishes. For example, the provider might decide to call the completion handler as soon as the metadata have been stored in a local database. Modifications are gated by the corresponding capabilities of the item on a UI level, but direct file system changes (e.g. from Terminal) can still result in changes that must be handled. Conflict resolution: ------------------- The system passes a `baseVersion` parameter to the modifyItem call. This baseVersion describes the latest version of the file which was reflected on disk. This parameter can be used to detect conflicts with remote edits. For instance, if content version A of the file was downloaded to the local system, and the content was modified locally, the modifyItem call will receive baseVersion of A. If the server has in the meantime received another content edit of the same file, the server may have content version C. In this case, the extension can detect the mismatching baseVersion, and decide how to resolve the conflict. The extension informs the system of how it wishes to resolve the conflict by returning the resolved metadata on the completion handler. As an example resolution, if the extension informs that it wishes for the remote version of the item to be on disk (and to ignore the local edits), it should return the new contentVersion in the completion handler's item. The system will subsequently call fetchContents to retrieve the new contents and replace them on disk. The `baseVersion` might contain one or both component set to `+[NSFileProviderItemVersion beforeFirstSyncComponent]`, in case there has never been a version for which the item on disk and the item in the provider were known to be in sync. Structural consistency and Cycle handling: ------------------------------------------ In case the parentItemIdentifier is modified, the system guarantees that the new parent has been created and the creation completed before the call to modifyItem is issued. The system guarantees that modifyItem called after local changes from the user will never create a cycle: that is all items will always be a descendent of either the root item or the trash item. However, cycles that are caused by concurrent local changes by the user and changes on the remote server can also create cycles. This is handled by the system as a conflict. This means the provider must validate that the call of modifyItem is not creating a cycle with a change it observed from the server. If such a cycle is detected, the provider must fix the conflict by breaking the cycle, and return the state of the item after resolving that conflict. If the resolution affects other items as well, updates for those other items must be published on the working set. File ownership: --------------- The file at `url` is owned by the system and is unlinked after the completion handler is called. If the extension wishes to keep access to the content of file after calling the completion handler, it should clone the file in its container. Atomicity: ---------- By default, the system assumes all the changes are applied non-atomically, which means that the change or an intermediary state from the change can be observed (for instance while enumerating the working set) while the call is in progress (before the completion handler is called). The provider can indicate to the system that it applies changes atomically (that is, the change cannot be observed before the completion handler is called) by setting the key NSExtensionFileProviderAppliesChangesAtomically in the Info.plist of the extension to YES. The atomicity declaration only describes the visibility of the changes, not the ability of the provider to apply all the fields at once: a provider that applies changes atomically might still apply a subset of the changedFields communicated by the system and defer the remaining fields by setting the stillPendingFields parameter in the completion handler. Error cases: ------------ The extension may fail the modification if the modified item does not exist anymore. In that case, the extension should fail the call the NSFileProviderErrorNoSuchItem error code. The system will attempt to delete the item on disk. If the item on disk actually has changes since this call to modifyItem, then it will be re-created by a call to createItemBasedOnTemplate. Likewise, if the item is reparented to a parent that no longer exists, the extension may return a NSFileProviderErrorNoSuchItem error with the parent item. In case the modification updates the location of the item and another item is already known at this location, the extension can chose to either resolve the collision by moving one of the items away, or reject the modification with the NSFileProviderErrorFilenameCollision error code. In that error case, the system will be responsible for resolving the collision, by renaming one of the colliding items. When the collision is resolved, the system will call modifyItem again. In case the NSFileProviderModifyItemFailOnConflict option is passed, the provider should fail the modification if the baseVersion does not match the version on the server. It will be up to the system to merge the conflict and call modifyItem again with an updated baseVersion. The extension can also report NSFileProviderErrorNotAuthenticated, NSFileProviderErrorCannotSynchronize, or NSFileProviderErrorExcludedFromSync, in case the modification cannot be applied because of the current state of the system / domain. In that case, the system will present an appropriate error message and back off until the next time it is signalled. The provider can signal the error resolution by calling signalErrorResolved:completionHandler:. Any other error, including crashes of the extension process, will be considered to be transient and will cause the modification to be retried. Errors must be in one of the following domains: NSCocoaErrorDomain, NSFileProviderErrorDomain. For errors which can not be represented using an existing error code in one of these domains, the extension should construct an NSError with domain NSCocoaErrorDomain and code NSXPCConnectionReplyInvalid. The extension should set the NSUnderlyingErrorKey in the NSError's userInfo to the error which could not be represented. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, [], NO, NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- The system will grant enough time to the extension to upload the file if content is passed to the call, otherwise the call is expected to completed within a few seconds. The system will interrupt the call if it stops making progress or if upload takes an unexpectedly long time. In that case, the system will call `cancel` on the progress. The extension is then expected to quickly call the completion handler.
      */
-    modifyItem$baseVersion$changedFields$contents$options$request$completionHandler$?(item: number, version: _NSFileProviderItemVersion, changedFields: NSFileProviderItemFields, newContents: _NSURL | null, options: NSFileProviderModifyItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject): _NSProgress;
+    modifyItem$baseVersion$changedFields$contents$options$request$completionHandler$?(item: _NSFileProviderItem, version: _NSFileProviderItemVersion, changedFields: NSFileProviderItemFields, newContents: _NSURL | null, options: NSFileProviderModifyItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject | null): _NSProgress;
     /**
      * Delete an item forever. This is called when the user deletes an item that was already in the Trash and the item should no longer appear there after this call. This call should remove the item from the working set. This call receives an optional baseVersion which represent the version of the item we are trying to delete. Unless the NSFileProviderDeleteItemRecursive options is passed, the deletion of a directory should be non-recursive. If the deletion is recursive the provider should take care of reporting the deletion of all the deleted items through the working set. Delete is gated by the capabilities of the removed item with NSFileProviderItemCapabilitiesAllowsDeleting. Modifications are gated by NSFileProviderItemCapabilitiesAllowsDeleting of the item on a UI level, but direct file system changes (e.g. from Terminal) can still result in changes that must be handled. Atomicity: ---------- By default, the system assumes all the changes are applied non-atomically, which means that the change or an intermediary state from the change can be observed (for instance while enumerating the working set) while the call is in progress (before the completion handler is called). The provider can indicate to the system that it applies changes atomically (that is, the change cannot be observed before the completion handler is called) by setting the key NSExtensionFileProviderAppliesChangesAtomically in the Info.plist of the extension to YES. Error cases: ------------ The extension may fail the deletion in different scenarios, for instance because the baseVersion is out of date or because the user does not have permissions to delete the item. In that case the extension should fail the call with the NSFileProviderErrorDeletionRejected error code which will cause the system to re-create the deleted item on disk based on the latest metadata available from the extension. If the options don't include NSFileProviderDeleteItemRecursive and the deletion targets a non-empty directory, the extension must reject the deletion with the NSFileProviderErrorDirectoryNotEmpty error code. This error can also be reported in case some children of the directory cannot be deleted when receiving the NSFileProviderDeleteItemRecursive option. In both cases, the system will re-create the deleted item on disk based on the latest metadata available from the extension. If the deletion targets an item that is unknown from the extension because that item may have already been deleted remotely, then the extension should report a success. The extension can also report the NSFileProviderErrorNotAuthenticated, NSFileProviderErrorServerUnreachable, or NSFileProviderErrorCannotSynchronize in case the deletion cannot be applied because of the current state of the system / domain. In that case, the system will present an appropriate error message and back off until the next time it is signalled. Any other error, including crashes of the extension process, will be considered to be transient and will cause the deletion to be retried. Errors must be in one of the following domains: NSCocoaErrorDomain, NSFileProviderErrorDomain. For errors which can not be represented using an existing error code in one of these domains, the extension should construct an NSError with domain NSCocoaErrorDomain and code NSXPCConnectionReplyInvalid. The extension should set the NSUnderlyingErrorKey in the NSError's userInfo to the error which could not be represented. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- This call is not expected to take more than a few seconds to complete. The system will interrupt the call if it stops making progress or if the deletion takes an unexpectedly long time. In that case,the system will call `cancel` on the progress. The extension is then expected to quickly call the completion handler.
      */
-    deleteItemWithIdentifier$baseVersion$options$request$completionHandler$?(identifier: number, version: _NSFileProviderItemVersion, options: NSFileProviderDeleteItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject): _NSProgress;
+    deleteItemWithIdentifier$baseVersion$options$request$completionHandler$?(identifier: _NSString, version: _NSFileProviderItemVersion, options: NSFileProviderDeleteItemOptions, request: _NSFileProviderRequest, completionHandler: NobjcObject | null): _NSProgress;
     /**
      * Signal the end of import of on-disk items. This is called after a reimport of on-disk items has been triggered by either `-[NSFileProviderManager reimportItemsBelowItemWithIdentifier:completionHandler:]` or after a new domain is created using `+[NSFileProviderManager importDomain:fromDirectoryAtURL:completionHandler:]` or `+[NSFileProviderManager addDomain:completionHandler:]`. `reimport` can also be started by the system independently from any request by the provider. The provider can detect those events by monitoring `-[NSFileProviderDomain backingStoreIdentity]`. During import, found items will be created via the -[NSFileProviderExtension createItemBasedOnTemplate:fields:contents:options:completionHandler:] call with the NSFileProviderCreateItemMayAlreadyExist flag set. At the end of an import the -[NSFileProviderExtension importDidFinishWithCompletionHandler:] is called. The system will attempt to import items as they are accessed by the user or applications. Import of the other items is scheduled by the system as a background task. That task may be delayed, for instance in low-power situations, or when the system is under heavy load. The provider can force the system to process a folder and its direct children by issuing a coordination request on that folder. Execution time: --------------- This call is not expected to take more than a few seconds to complete.
      */

package/dist/FileProvider/NSFileProviderSearchEnumerationObserver.d.ts

@@ -1,11 +1,12 @@
-import type { NobjcObject } from "objc-js";
+import type { _NSArray } from "../Foundation/NSArray.js";
+import type { _NSData } from "../Foundation/NSData.js";
 import type { _NSError } from "../Foundation/NSError.js";
 export interface _NSFileProviderSearchEnumerationObserver {
-    didEnumerateSearchResults$?(searchResults: NobjcObject): void;
+    didEnumerateSearchResults$?(searchResults: _NSArray): void;
     /**
      * Call this method after enumerating a full page of results. If you set a non-nil nextPage, -[NSFileProviderSearchEnumerator enumerateSearchResultsToObserver:startingAtPage:] might be called with nextPage to enumerate more items. Page data is limited to 500 bytes. Setting a larger nextPage interrupts the enumeration.
      */
-    finishEnumeratingUpToPage$?(nextPage: number | null): void;
+    finishEnumeratingUpToPage$?(nextPage: _NSData | null): void;
     /**
      * Finishing a search enumeration with an error will cause the system to stop requesting additional pages of results. The system will not retry in case of an error. It is up to the extension to decide whether to retry errors internally, in their implementation of `enumerateSearchResultsForObserver`, or to return the error to the system and end the search query.
      */

package/dist/FileProvider/NSFileProviderSearchEnumerator.d.ts

@@ -1,4 +1,5 @@
 import type { _NSFileProviderSearchEnumerationObserver } from "./NSFileProviderSearchEnumerationObserver.js";
+import type { _NSData } from "../Foundation/NSData.js";
 export interface _NSFileProviderSearchEnumerator {
     /**
      * Called when the system wants to cancel a currently running enumeration, or when the system is finished using this enumerator object. For instance, the user has changed their query, and the result of the currently running query will no longer be used by the system. Or, the system is finished using this enumerator object. The extension should cancel any outstanding requests and cleanup resources.
@@ -7,5 +8,5 @@ export interface _NSFileProviderSearchEnumerator {
     /**
      * Enumerate search results starting from the specified page. - Parameters: - observer: The observer object, which the extension will use to provide results. - page: If a previous enumeration returned a `nextPage` on ``-[NSFileProviderSearchEnumerationObserver finishEnumeratingUpToPage:]``, the system may pass that page into the next enumeration. The page should contain whatever information is needed to resume the enumeration.
      */
-    enumerateSearchResultsForObserver$startingAtPage$?(observer: _NSFileProviderSearchEnumerationObserver, page: number | null): void;
+    enumerateSearchResultsForObserver$startingAtPage$?(observer: _NSFileProviderSearchEnumerationObserver, page: _NSData | null): void;
 }

package/dist/FileProvider/NSFileProviderSearchResult.d.ts

@@ -6,7 +6,7 @@ export interface _NSFileProviderSearchResult {
     /**
      * The identifier for this search result. This identifier should be usable on API calls from the ``NSFileProviderReplicatedExtension`` protocol.
      */
-    itemIdentifier?(): number;
+    itemIdentifier?(): _NSString;
     filename?(): _NSString;
     creationDate?(): _NSDate | null;
     contentModificationDate?(): _NSDate | null;

package/dist/FileProvider/NSFileProviderServiceSource.d.ts

@@ -5,7 +5,7 @@ export interface _NSFileProviderServiceSource {
     /**
      * Return an endpoint object to allow the client application to connect to the file provider. The endpoint is retrieved from an anonymous @c NSXPCListener that the file provider creates. The file provider is in charge of accepting incoming @c NSXPCConnection's via @c -[NSXPCListenerDelegate listener:shouldAcceptNewConnection:], and setting up properties on the new connection, like its exported object and interfaces (that both the file provider and the client application have agreed on).
      */
-    makeListenerEndpointAndReturnError$?(error: NobjcObject): _NSXPCListenerEndpoint | null;
+    makeListenerEndpointAndReturnError$?(error: NobjcObject | null): _NSXPCListenerEndpoint | null;
     /**
      * The service name that uniquely identifies the service (using reverse domain name notation for you service name is recommended).
      */

package/dist/FileProvider/NSFileProviderServicing.d.ts

@@ -1,8 +1,9 @@
 import type { NobjcObject } from "objc-js";
 import type { _NSProgress } from "../Foundation/NSProgress.js";
+import type { _NSString } from "../Foundation/NSString.js";
 export interface _NSFileProviderServicing {
     /**
      * A file provider can implemement this method to return service sources that provide custom communication channels to client applications. The service sources must be tied to the item identified by Client applications can retrieve the list of supported services by calling getFileProviderServicesForItemAtURL:] for a specific item URL. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (nil, NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- This method is not expected to take more than a few seconds to complete the retrieval of the thumbnails. The system will call `cancel` on the progress if the operation takes too much time. The extension is then expected to quickly call the completion handler.
      */
-    supportedServiceSourcesForItemIdentifier$completionHandler$?(itemIdentifier: number, completionHandler: NobjcObject): _NSProgress;
+    supportedServiceSourcesForItemIdentifier$completionHandler$?(itemIdentifier: _NSString, completionHandler: NobjcObject | null): _NSProgress;
 }

package/dist/FileProvider/NSFileProviderTestingChildrenEnumeration.d.ts

@@ -1,8 +1,9 @@
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingChildrenEnumeration extends _NSFileProviderTestingOperation {
     /** The side of the operation. */
     side?(): NSFileProviderTestingOperationSide;
     /** The identifier of the item. */
-    itemIdentifier?(): number;
+    itemIdentifier?(): _NSString;
 }

package/dist/FileProvider/NSFileProviderTestingCollisionResolution.d.ts

@@ -1,8 +1,9 @@
+import type { _NSFileProviderItem } from "./NSFileProviderItem.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingCollisionResolution extends _NSFileProviderTestingOperation {
     /** The side of the operation. */
     side?(): NSFileProviderTestingOperationSide;
     /** The state of the item. */
-    renamedItem?(): number;
+    renamedItem?(): _NSFileProviderItem;
 }

package/dist/FileProvider/NSFileProviderTestingContentFetch.d.ts

@@ -1,8 +1,9 @@
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingContentFetch extends _NSFileProviderTestingOperation {
     /** The side of the operation. */
     side?(): NSFileProviderTestingOperationSide;
     /** The identifier of the item. */
-    itemIdentifier?(): number;
+    itemIdentifier?(): _NSString;
 }

package/dist/FileProvider/NSFileProviderTestingCreation.d.ts

@@ -1,11 +1,12 @@
 import type { _NSFileProviderDomainVersion } from "./NSFileProviderDomainVersion.js";
+import type { _NSFileProviderItem } from "./NSFileProviderItem.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingCreation extends _NSFileProviderTestingOperation {
     /** The target side of the operation. */
     targetSide?(): NSFileProviderTestingOperationSide;
     /** The description of the item. */
-    sourceItem?(): number;
+    sourceItem?(): _NSFileProviderItem;
     /** The domain version at the time the creation was discovered on the source side. */
     domainVersion?(): _NSFileProviderDomainVersion | null;
 }

package/dist/FileProvider/NSFileProviderTestingDeletion.d.ts

@@ -1,3 +1,4 @@
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSFileProviderDomainVersion } from "./NSFileProviderDomainVersion.js";
 import type { _NSFileProviderItemVersion } from "./NSFileProviderItemVersion.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
@@ -6,9 +7,9 @@ export interface _NSFileProviderTestingDeletion extends _NSFileProviderTestingOp
     /** The target side of the operation. */
     targetSide?(): NSFileProviderTestingOperationSide;
     /** The identifier of the source item. */
-    sourceItemIdentifier?(): number;
+    sourceItemIdentifier?(): _NSString;
     /** The identifier of the target item. */
-    targetItemIdentifier?(): number;
+    targetItemIdentifier?(): _NSString;
     /** The version of the target item on top of which the deletion is applied */
     targetItemBaseVersion?(): _NSFileProviderItemVersion;
     /** The domain version at the time the change was discovered on the source side. */

package/dist/FileProvider/NSFileProviderTestingIngestion.d.ts

@@ -1,10 +1,12 @@
+import type { _NSString } from "../Foundation/NSString.js";
+import type { _NSFileProviderItem } from "./NSFileProviderItem.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingIngestion extends _NSFileProviderTestingOperation {
     /** Side of the event. */
     side?(): NSFileProviderTestingOperationSide;
     /** Identifier of the affected item. */
-    itemIdentifier?(): number;
+    itemIdentifier?(): _NSString;
     /** The metadata of the item. This will be nil if the item is being deleted. */
-    item?(): number | null;
+    item?(): _NSFileProviderItem | null;
 }

package/dist/FileProvider/NSFileProviderTestingLookup.d.ts

@@ -1,8 +1,9 @@
+import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingLookup extends _NSFileProviderTestingOperation {
     /** Side of the event. */
     side?(): NSFileProviderTestingOperationSide;
     /** Identifier of the affected item. */
-    itemIdentifier?(): number;
+    itemIdentifier?(): _NSString;
 }

package/dist/FileProvider/NSFileProviderTestingModification.d.ts

@@ -1,15 +1,17 @@
 import type { _NSFileProviderDomainVersion } from "./NSFileProviderDomainVersion.js";
+import type { _NSFileProviderItem } from "./NSFileProviderItem.js";
 import type { _NSFileProviderItemVersion } from "./NSFileProviderItemVersion.js";
 import type { _NSFileProviderTestingOperation } from "./NSFileProviderTestingOperation.js";
+import type { _NSString } from "../Foundation/NSString.js";
 import type { NSFileProviderItemFields } from "./NSFileProviderItemFields.js";
 import type { NSFileProviderTestingOperationSide } from "./NSFileProviderTestingOperationSide.js";
 export interface _NSFileProviderTestingModification extends _NSFileProviderTestingOperation {
     /** The target side of the operation. */
     targetSide?(): NSFileProviderTestingOperationSide;
     /** The description of the item. */
-    sourceItem?(): number;
+    sourceItem?(): _NSFileProviderItem;
     /** The identifier of the target item. */
-    targetItemIdentifier?(): number;
+    targetItemIdentifier?(): _NSString;
     /** The version of the target item on top of which the modification is applied */
     targetItemBaseVersion?(): _NSFileProviderItemVersion;
     /** The list of updated fields. */

package/dist/FileProvider/NSFileProviderThumbnailing.d.ts

@@ -6,5 +6,5 @@ export interface _NSFileProviderThumbnailing {
     /**
      * The system calls this method to fetch thumbnails. The should be called for each thumbnail, and only after all the per thumbnail completion blocks. In the event of a global error, the implementation is allowed to skip calling the for individual thumbnails. In that case, the error parameter would apply to all item identifiers for which had not been called. If there is no thumbnail for a given item, the should be called with its and parameters both set to nil. If the system decides that an in-flight thumbnail request is not needed anymore, it will call the returned object's method, at which time the implementation should clean up any held resources. The system will cache the thumbnail for the item, and the cache will be invalidated when itemVersion.contentVersion changes. Thread safety: ------------ The may be called from multiple threads concurrently. Cancellations: ------------ If the NSProgress returned by this method is cancelled, the extension should call the completion handler with (NSUserCancelledError) in the NSProgress cancellation handler. Execution time: --------------- This method is not expected to take more than a few tens seconds to complete the retrieval of the services exposed on the item. The system will call `cancel` on the progress if the operation takes too much time. The extension is then expected to quickly call the completion handler.
      */
-    fetchThumbnailsForItemIdentifiers$requestedSize$perThumbnailCompletionHandler$completionHandler$?(itemIdentifiers: _NSArray, size: CGSize, perThumbnailCompletionHandler: NobjcObject, completionHandler: NobjcObject): _NSProgress;
+    fetchThumbnailsForItemIdentifiers$requestedSize$perThumbnailCompletionHandler$completionHandler$?(itemIdentifiers: _NSArray, size: CGSize, perThumbnailCompletionHandler: NobjcObject | null, completionHandler: NobjcObject | null): _NSProgress;
 }

package/dist/FileProvider/index.js

@@ -1,15 +1,16 @@
 // AUTO-GENERATED by objcjs-types generator — DO NOT EDIT
 import { NobjcLibrary } from "objc-js";
+import { _bindClass } from "../bind.js";
 export const FileProvider = new NobjcLibrary("/System/Library/Frameworks/FileProvider.framework/FileProvider");
-export const NSFileProviderDomain = FileProvider["NSFileProviderDomain"];
-export const NSFileProviderDomainVersion = FileProvider["NSFileProviderDomainVersion"];
-export const NSFileProviderExtension = FileProvider["NSFileProviderExtension"];
-export const NSFileProviderItemVersion = FileProvider["NSFileProviderItemVersion"];
-export const NSFileProviderKnownFolderLocation = FileProvider["NSFileProviderKnownFolderLocation"];
-export const NSFileProviderKnownFolderLocations = FileProvider["NSFileProviderKnownFolderLocations"];
-export const NSFileProviderManager = FileProvider["NSFileProviderManager"];
-export const NSFileProviderRequest = FileProvider["NSFileProviderRequest"];
-export const NSFileProviderStringSearchRequest = FileProvider["NSFileProviderStringSearchRequest"];
+export const NSFileProviderDomain = _bindClass(FileProvider, "NSFileProviderDomain");
+export const NSFileProviderDomainVersion = _bindClass(FileProvider, "NSFileProviderDomainVersion");
+export const NSFileProviderExtension = _bindClass(FileProvider, "NSFileProviderExtension");
+export const NSFileProviderItemVersion = _bindClass(FileProvider, "NSFileProviderItemVersion");
+export const NSFileProviderKnownFolderLocation = _bindClass(FileProvider, "NSFileProviderKnownFolderLocation");
+export const NSFileProviderKnownFolderLocations = _bindClass(FileProvider, "NSFileProviderKnownFolderLocations");
+export const NSFileProviderManager = _bindClass(FileProvider, "NSFileProviderManager");
+export const NSFileProviderRequest = _bindClass(FileProvider, "NSFileProviderRequest");
+export const NSFileProviderStringSearchRequest = _bindClass(FileProvider, "NSFileProviderStringSearchRequest");
 export { NSFileProviderContentPolicy } from "./NSFileProviderContentPolicy.js";
 export { NSFileProviderCreateItemOptions } from "./NSFileProviderCreateItemOptions.js";
 export { NSFileProviderDeleteItemOptions } from "./NSFileProviderDeleteItemOptions.js";

package/dist/FileProviderUI/index.js

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by objcjs-types generator — DO NOT EDIT
 import { NobjcLibrary } from "objc-js";
+import { _bindClass } from "../bind.js";
 export const FileProviderUI = new NobjcLibrary("/System/Library/Frameworks/FileProviderUI.framework/FileProviderUI");
-export const FPUIActionExtensionContext = FileProviderUI["FPUIActionExtensionContext"];
-export const FPUIActionExtensionViewController = FileProviderUI["FPUIActionExtensionViewController"];
+export const FPUIActionExtensionContext = _bindClass(FileProviderUI, "FPUIActionExtensionContext");
+export const FPUIActionExtensionViewController = _bindClass(FileProviderUI, "FPUIActionExtensionViewController");
 export { FPUIExtensionErrorCode } from "./FPUIExtensionErrorCode.js";

package/dist/FinderSync/FIFinderSync.d.ts

@@ -1,5 +1,6 @@
 import type { NobjcObject } from "objc-js";
 import type { _NSArray } from "../Foundation/NSArray.js";
+import type { _NSExtensionRequestHandling } from "../Foundation/NSExtensionRequestHandling.js";
 import type { _NSObject } from "../Foundation/NSObject.js";
 import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSURL } from "../Foundation/NSURL.js";
@@ -30,8 +31,8 @@ export declare class _FIFinderSync extends _NSObject {
     requestBadgeIdentifierForURL$(url: _NSURL): void;
     /** Collaboration, starting in macOS 10.13. */
     supportedServiceNamesForItemWithURL$(itemURL: _NSURL): _NSArray;
-    makeListenerEndpointForServiceName$itemURL$andReturnError$(serviceName: NSFileProviderServiceName, itemURL: _NSURL, error: NobjcObject): _NSXPCListenerEndpoint | null;
-    valuesForAttributes$forItemWithURL$completion$(attributes: _NSArray, itemURL: _NSURL, completion: NobjcObject): void;
+    makeListenerEndpointForServiceName$itemURL$andReturnError$(serviceName: NSFileProviderServiceName, itemURL: _NSURL, error: NobjcObject | null): _NSXPCListenerEndpoint | null;
+    valuesForAttributes$forItemWithURL$completion$(attributes: _NSArray, itemURL: _NSURL, completion: NobjcObject | null): void;
     /**
      * The name of the extension’s toolbar button. To add a toolbar item to the Finder, override the getter method for the toolbar image, name, and tooltip properties.
      */
@@ -45,3 +46,5 @@ export declare class _FIFinderSync extends _NSObject {
      */
     toolbarItemToolTip(): _NSString;
 }
+export interface _FIFinderSync extends _NSExtensionRequestHandling {
+}

package/dist/FinderSync/index.js

@@ -1,6 +1,7 @@
 // AUTO-GENERATED by objcjs-types generator — DO NOT EDIT
 import { NobjcLibrary } from "objc-js";
+import { _bindClass } from "../bind.js";
 export const FinderSync = new NobjcLibrary("/System/Library/Frameworks/FinderSync.framework/FinderSync");
-export const FIFinderSync = FinderSync["FIFinderSync"];
-export const FIFinderSyncController = FinderSync["FIFinderSyncController"];
+export const FIFinderSync = _bindClass(FinderSync, "FIFinderSync");
+export const FIFinderSyncController = _bindClass(FinderSync, "FIFinderSyncController");
 export { FIMenuKind } from "./FIMenuKind.js";

package/dist/Foundation/NSAffineTransform.d.ts

@@ -1,4 +1,6 @@
+import type { _NSCopying } from "./NSCopying.js";
 import type { _NSObject } from "./NSObject.js";
+import type { _NSSecureCoding } from "./NSSecureCoding.js";
 import type { CGPoint } from "../structs/CGPoint.js";
 import type { CGSize } from "../structs/CGSize.js";
 import type { NSAffineTransformStruct } from "../structs/NSAffineTransformStruct.js";
@@ -30,3 +32,5 @@ export declare class _NSAffineTransform extends _NSObject {
     transformStruct(): NSAffineTransformStruct;
     setTransformStruct$(value: NSAffineTransformStruct): void;
 }
+export interface _NSAffineTransform extends _NSCopying, _NSSecureCoding {
+}

package/dist/Foundation/NSAppleEventDescriptor.d.ts

@@ -1,7 +1,9 @@
 import type { NobjcObject } from "objc-js";
+import type { _NSCopying } from "./NSCopying.js";
 import type { _NSData } from "./NSData.js";
 import type { _NSDate } from "./NSDate.js";
 import type { _NSObject } from "./NSObject.js";
+import type { _NSSecureCoding } from "./NSSecureCoding.js";
 import type { _NSString } from "./NSString.js";
 import type { _NSURL } from "./NSURL.js";
 import type { NSAppleEventSendOptions } from "./NSAppleEventSendOptions.js";
@@ -14,16 +16,16 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
     /**
      * Given some data, and a four-character type code, create and return an autoreleased NSAppleEventDescriptor that contains that data, with that type.
      */
-    static descriptorWithDescriptorType$bytes$length$(descriptorType: NobjcObject, bytes: Uint8Array | null, byteCount: number): _NSAppleEventDescriptor | null;
-    static descriptorWithDescriptorType$data$(descriptorType: NobjcObject, data: _NSData | null): _NSAppleEventDescriptor | null;
+    static descriptorWithDescriptorType$bytes$length$(descriptorType: number, bytes: Uint8Array | null, byteCount: number): _NSAppleEventDescriptor | null;
+    static descriptorWithDescriptorType$data$(descriptorType: number, data: _NSData | null): _NSAppleEventDescriptor | null;
     /**
      * Given a value, create and return an autoreleased NSAppleEventDescriptor that contains that value, with an appropriate type (typeBoolean, typeEnumerated, typeSInt32, typeIEEE64BitFloatingPoint, or typeType, respectively).
      */
     static descriptorWithBoolean$(boolean_: NobjcObject): _NSAppleEventDescriptor;
-    static descriptorWithEnumCode$(enumerator: NobjcObject): _NSAppleEventDescriptor;
-    static descriptorWithInt32$(signedInt: NobjcObject): _NSAppleEventDescriptor;
+    static descriptorWithEnumCode$(enumerator: number): _NSAppleEventDescriptor;
+    static descriptorWithInt32$(signedInt: number): _NSAppleEventDescriptor;
     static descriptorWithDouble$(doubleValue: number): _NSAppleEventDescriptor;
-    static descriptorWithTypeCode$(typeCode: NobjcObject): _NSAppleEventDescriptor;
+    static descriptorWithTypeCode$(typeCode: number): _NSAppleEventDescriptor;
     /**
      * Given a string, date, or file URL object, respectively, create and return an autoreleased NSAppleEventDescriptor that contains that value.
      */
@@ -33,7 +35,7 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
     /**
      * Create and return an autoreleased event, list, or record NSAppleEventDescriptor, respectively.
      */
-    static appleEventWithEventClass$eventID$targetDescriptor$returnID$transactionID$(eventClass: NobjcObject, eventID: NobjcObject, targetDescriptor: _NSAppleEventDescriptor | null, returnID: NobjcObject, transactionID: NobjcObject): _NSAppleEventDescriptor;
+    static appleEventWithEventClass$eventID$targetDescriptor$returnID$transactionID$(eventClass: number, eventID: number, targetDescriptor: _NSAppleEventDescriptor | null, returnID: number, transactionID: number): _NSAppleEventDescriptor;
     static listDescriptor(): _NSAppleEventDescriptor;
     static recordDescriptor(): _NSAppleEventDescriptor;
     /**
@@ -48,20 +50,20 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
      */
     initWithAEDescNoCopy$(aeDesc: NobjcObject): _NSAppleEventDescriptor;
     /** Other initializers. */
-    initWithDescriptorType$bytes$length$(descriptorType: NobjcObject, bytes: Uint8Array | null, byteCount: number): _NSAppleEventDescriptor | null;
-    initWithDescriptorType$data$(descriptorType: NobjcObject, data: _NSData | null): _NSAppleEventDescriptor | null;
-    initWithEventClass$eventID$targetDescriptor$returnID$transactionID$(eventClass: NobjcObject, eventID: NobjcObject, targetDescriptor: _NSAppleEventDescriptor | null, returnID: NobjcObject, transactionID: NobjcObject): _NSAppleEventDescriptor;
+    initWithDescriptorType$bytes$length$(descriptorType: number, bytes: Uint8Array | null, byteCount: number): _NSAppleEventDescriptor | null;
+    initWithDescriptorType$data$(descriptorType: number, data: _NSData | null): _NSAppleEventDescriptor | null;
+    initWithEventClass$eventID$targetDescriptor$returnID$transactionID$(eventClass: number, eventID: number, targetDescriptor: _NSAppleEventDescriptor | null, returnID: number, transactionID: number): _NSAppleEventDescriptor;
     initListDescriptor(): _NSAppleEventDescriptor;
     initRecordDescriptor(): _NSAppleEventDescriptor;
     /** Set, retrieve, or remove parameter descriptors inside an event descriptor. */
-    setParamDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: NobjcObject): void;
-    paramDescriptorForKeyword$(keyword: NobjcObject): _NSAppleEventDescriptor | null;
-    removeParamDescriptorWithKeyword$(keyword: NobjcObject): void;
+    setParamDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: number): void;
+    paramDescriptorForKeyword$(keyword: number): _NSAppleEventDescriptor | null;
+    removeParamDescriptorWithKeyword$(keyword: number): void;
     /** Set or retrieve attribute descriptors inside an event descriptor. */
-    setAttributeDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: NobjcObject): void;
-    attributeDescriptorForKeyword$(keyword: NobjcObject): _NSAppleEventDescriptor | null;
+    setAttributeDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: number): void;
+    attributeDescriptorForKeyword$(keyword: number): _NSAppleEventDescriptor | null;
     /** Send an Apple event. */
-    sendEventWithOptions$timeout$error$(sendOptions: NSAppleEventSendOptions, timeoutInSeconds: number, error: NobjcObject): _NSAppleEventDescriptor | null;
+    sendEventWithOptions$timeout$error$(sendOptions: NSAppleEventSendOptions, timeoutInSeconds: number, error: NobjcObject | null): _NSAppleEventDescriptor | null;
     /**
      * Set, retrieve, or remove indexed descriptors inside a list or record descriptor.
      */
@@ -69,32 +71,32 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
     descriptorAtIndex$(index: number): _NSAppleEventDescriptor | null;
     removeDescriptorAtIndex$(index: number): void;
     /** Set, retrieve, or remove keyed descriptors inside a record descriptor. */
-    setDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: NobjcObject): void;
-    descriptorForKeyword$(keyword: NobjcObject): _NSAppleEventDescriptor | null;
-    removeDescriptorWithKeyword$(keyword: NobjcObject): void;
+    setDescriptor$forKeyword$(descriptor: _NSAppleEventDescriptor, keyword: number): void;
+    descriptorForKeyword$(keyword: number): _NSAppleEventDescriptor | null;
+    removeDescriptorWithKeyword$(keyword: number): void;
     /**
      * Return the keyword associated with an indexed descriptor inside a record descriptor.
      */
-    keywordForDescriptorAtIndex$(index: number): NobjcObject;
+    keywordForDescriptorAtIndex$(index: number): number;
     /**
      * Create and return a descriptor of the requested type, doing a coercion if that's appropriate and possible.
      */
-    coerceToDescriptorType$(descriptorType: NobjcObject): _NSAppleEventDescriptor | null;
+    coerceToDescriptorType$(descriptorType: number): _NSAppleEventDescriptor | null;
     /** Return a pointer to the AEDesc that is encapsulated by the object. */
     aeDesc(): NobjcObject;
     /**
      * Get the four-character type code or the data from a fully-initialized descriptor.
      */
-    descriptorType(): NobjcObject;
+    descriptorType(): number;
     data(): _NSData;
     /**
      * Return the contents of a descriptor, after coercing the descriptor's contents to typeBoolean, typeEnumerated, typeSInt32, typeIEEE64BitFloatingPoint, or typeType, respectively.
      */
     booleanValue(): NobjcObject;
-    enumCodeValue(): NobjcObject;
-    int32Value(): NobjcObject;
+    enumCodeValue(): number;
+    int32Value(): number;
     doubleValue(): number;
-    typeCodeValue(): NobjcObject;
+    typeCodeValue(): number;
     /**
      * Return the contents of a descriptor, after coercing the descriptor's contents to a string, date, or file URL, respectively.
      */
@@ -102,10 +104,10 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
     dateValue(): _NSDate;
     fileURLValue(): _NSURL;
     /** Accessors for an event descriptor. */
-    eventClass(): NobjcObject;
-    eventID(): NobjcObject;
-    returnID(): NobjcObject;
-    transactionID(): NobjcObject;
+    eventClass(): number;
+    eventID(): number;
+    returnID(): number;
+    transactionID(): number;
     /**
      * Return whether or not a descriptor is a record-like descriptor. Record-like descriptors function as records, but may have a descriptorType other than typeAERecord, such as typeObjectSpecifier.
      */
@@ -113,3 +115,5 @@ export declare class _NSAppleEventDescriptor extends _NSObject {
     /** Return the number of items inside a list or record descriptor. */
     numberOfItems(): number;
 }
+export interface _NSAppleEventDescriptor extends _NSCopying, _NSSecureCoding {
+}