objcjs-types 0.4.0 → 0.5.0

package/dist/WebKit/WKWebExtensionTab.d.ts

@@ -1,11 +1,13 @@
-import type { NobjcObject } from "objc-js";
 import type { _WKSnapshotConfiguration } from "./WKSnapshotConfiguration.js";
 import type { _WKWebExtensionContext } from "./WKWebExtensionContext.js";
 import type { _WKWebExtensionTabConfiguration } from "./WKWebExtensionTabConfiguration.js";
 import type { _WKWebExtensionWindow } from "./WKWebExtensionWindow.js";
 import type { _WKWebView } from "./WKWebView.js";
+import type { _NSError } from "../Foundation/NSError.js";
+import type { _NSLocale } from "../Foundation/NSLocale.js";
 import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSURL } from "../Foundation/NSURL.js";
+import type { _NSImage } from "../AppKit/NSImage.js";
 import type { CGSize } from "../structs/CGSize.js";
 export interface _WKWebExtensionTab {
     /**
@@ -23,7 +25,7 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set or clear the parent tab for the tab. @param parentTab The tab that should be set as the parent of the tab. If \c nil is provided, the current parent tab should be cleared. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented. @seealso parentTabForWebExtensionContext:
      */
-    setParentTab$forWebExtensionContext$completionHandler$?(parentTab: _WKWebExtensionTab | null, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setParentTab$forWebExtensionContext$completionHandler$?(parentTab: _WKWebExtensionTab | null, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called when the web view for the tab is needed. @param context The context in which the web extension is running. @return The web view for the tab. @discussion The web view's ``WKWebViewConfiguration`` must have its ``webExtensionController`` property set to match the controller of the given context; otherwise `nil` will be used. Defaults to `nil` if not implemented. If `nil`, some critical features will not be available for this tab, such as content injection or modification.
      */
@@ -39,7 +41,7 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set the pinned state of the tab. @param pinned A boolean value indicating whether to pin the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion This is equivalent to the user selecting to pin or unpin the tab through a menu item. When a tab is pinned, it should be moved to the front of the tab bar and usually reduced in size. When a tab is unpinned, it should be restored to a normal size and position in the tab bar. No action is performed if not implemented. @seealso isPinnedForWebExtensionContext:
      */
-    setPinned$forWebExtensionContext$completionHandler$?(pinned: boolean, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setPinned$forWebExtensionContext$completionHandler$?(pinned: boolean, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to check if reader mode is available for the tab. @param context The context in which the web extension is running. @return `YES` if reader mode is available for the tab, `NO` otherwise. @discussion Defaults to `NO` if not implemented. @seealso isReaderModeActiveForWebExtensionContext:
      */
@@ -51,7 +53,7 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set the reader mode for the tab. @param active A boolean value indicating whether to activate reader mode. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented. @seealso isReaderModeAvailableForWebExtensionContext: @seealso isReaderModeActiveForWebExtensionContext:
      */
-    setReaderModeActive$forWebExtensionContext$completionHandler$?(active: boolean, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setReaderModeActive$forWebExtensionContext$completionHandler$?(active: boolean, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to check if the tab is currently playing audio. @param context The context in which the web extension is running. @return `YES` if the tab is playing audio, `NO` otherwise. @discussion Defaults to `NO` if not implemented.
      */
@@ -63,7 +65,7 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set the mute state of the tab. @param muted A boolean indicating whether the tab should be muted. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented. @seealso isMutedForWebExtensionContext:
      */
-    setMuted$forWebExtensionContext$completionHandler$?(muted: boolean, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setMuted$forWebExtensionContext$completionHandler$?(muted: boolean, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called when the size of the tab is needed. @param context The context in which the web extension is running. @return The size of the tab. @discussion Defaults to size of the tab's web view if not implemented.
      */
@@ -75,7 +77,7 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set the zoom factor of the tab. @param zoomFactor The desired zoom factor for the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion Sets ``pageZoom`` of the tab's web view if not implemented. @seealso zoomFactorForWebExtensionContext:
      */
-    setZoomFactor$forWebExtensionContext$completionHandler$?(zoomFactor: number, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setZoomFactor$forWebExtensionContext$completionHandler$?(zoomFactor: number, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called when the URL of the tab is needed. @param context The context in which the web extension is running. @return The URL of the tab. @discussion Defaults to `URL` of the tab's web view if not implemented.
      */
@@ -91,28 +93,28 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to detect the locale of the webpage currently loaded in the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. The block takes two arguments: the detected locale (or \c nil if the locale is unknown) and an error, which should be provided if any errors occurred. @discussion No action is performed if not implemented.
      */
-    detectWebpageLocaleForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
-    takeSnapshotUsingConfiguration$forWebExtensionContext$completionHandler$?(configuration: _WKSnapshotConfiguration, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    detectWebpageLocaleForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((_result: _NSLocale, error: _NSError) => void) | null): void;
+    takeSnapshotUsingConfiguration$forWebExtensionContext$completionHandler$?(configuration: _WKSnapshotConfiguration, context: _WKWebExtensionContext, completionHandler: ((_result: _NSImage, error: _NSError) => void) | null): void;
     /**
      * @abstract Called to load a URL in the tab. @param url The URL to be loaded in the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion If the tab is already loading a page, calling this method should stop the current page from loading and start loading the new URL. Loads the URL in the tab's web view via ``loadRequest:`` if not implemented.
      */
-    loadURL$forWebExtensionContext$completionHandler$?(url: _NSURL, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    loadURL$forWebExtensionContext$completionHandler$?(url: _NSURL, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to reload the current page in the tab. @param fromOrigin A boolean value indicating whether to reload the tab from the origin, bypassing the cache. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion Reloads the tab's web view via ``reload`` or ``reloadFromOrigin`` if not implemented.
      */
-    reloadFromOrigin$forWebExtensionContext$completionHandler$?(fromOrigin: boolean, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    reloadFromOrigin$forWebExtensionContext$completionHandler$?(fromOrigin: boolean, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to navigate the tab to the previous page in its history. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion Navigates to the previous page in the tab's web view via ``goBack`` if not implemented.
      */
-    goBackForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    goBackForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to navigate the tab to the next page in its history. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion Navigates to the next page in the tab's web view via ``goForward`` if not implemented.
      */
-    goForwardForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    goForwardForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to activate the tab, making it frontmost. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion Upon activation, the tab should become the frontmost and either be the sole selected tab or be included among the selected tabs. No action is performed if not implemented. @seealso setSelected:forWebExtensionContext:completionHandler:
      */
-    activateForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    activateForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called when the selected state of the tab is needed. @param context The context in which the web extension is running. @return `YES` if the tab is selected, `NO` otherwise. @discussion Defaults to `YES` for the active tab and `NO` for other tabs if not implemented.
      */
@@ -120,15 +122,15 @@ export interface _WKWebExtensionTab {
     /**
      * @abstract Called to set the selected state of the tab. @param selected A boolean value indicating whether to select the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion This is equivalent to the user command-clicking on the tab to add it to or remove it from a selection. The method should update the tab's selection state without changing the active tab. No action is performed if not implemented. @seealso isSelectedForWebExtensionContext:
      */
-    setSelected$forWebExtensionContext$completionHandler$?(selected: boolean, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setSelected$forWebExtensionContext$completionHandler$?(selected: boolean, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to duplicate the tab. @param configuration The tab configuration influencing the duplicated tab's properties. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes two arguments: the duplicated tab (or \c nil if no tab was created) and an error, which should be provided if any errors occurred. @discussion This is equivalent to the user selecting to duplicate the tab through a menu item, with the specified configuration. No action is performed if not implemented.
      */
-    duplicateUsingConfiguration$forWebExtensionContext$completionHandler$?(configuration: _WKWebExtensionTabConfiguration, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    duplicateUsingConfiguration$forWebExtensionContext$completionHandler$?(configuration: _WKWebExtensionTabConfiguration, context: _WKWebExtensionContext, completionHandler: ((duplicatedTab: _WKWebExtensionTab, error: _NSError) => void) | null): void;
     /**
      * @abstract Called to close the tab. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented.
      */
-    closeForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    closeForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to determine if permissions should be granted for the tab on user gesture. @param context The context in which the web extension is running. @return `YES` if permissions should be granted to the tab, `NO` otherwise. @discussion This method allows the app to control granting of permissions on a per-tab basis when triggered by a user gesture. Implementing this method enables the app to dynamically manage `activeTab` permissions based on the tab's current state, the content being accessed, or other custom criteria.
      */

package/dist/WebKit/WKWebExtensionWindow.d.ts

@@ -1,5 +1,5 @@
-import type { NobjcObject } from "objc-js";
 import type { _NSArray } from "../Foundation/NSArray.js";
+import type { _NSError } from "../Foundation/NSError.js";
 import type { _WKWebExtensionContext } from "./WKWebExtensionContext.js";
 import type { _WKWebExtensionTab } from "./WKWebExtensionTab.js";
 import type { CGRect } from "../structs/CGRect.js";
@@ -25,7 +25,7 @@ export interface _WKWebExtensionWindow {
     /**
      * @abstract Called to set the state of the window. @param context The context in which the web extension is running. @param state The new state of the window. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion The implementation of ``windowStateForWebExtensionContext:`` is a prerequisite. Without it, this method will not be called. @seealso windowStateForWebExtensionContext:
      */
-    setWindowState$forWebExtensionContext$completionHandler$?(state: WKWebExtensionWindowState, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setWindowState$forWebExtensionContext$completionHandler$?(state: WKWebExtensionWindowState, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called when the private state of the window is needed. @param context The context in which the web extension is running. @return `YES` if the window is private, `NO` otherwise. @discussion Defaults to `NO` if not implemented. This value is cached and will not change for the duration of the window or its contained tabs. @note To ensure proper isolation between private and non-private data, web views associated with private data must use a different ``WKUserContentController``. Likewise, to be identified as a private web view and to ensure that cookies and other website data is not shared, private web views must be configured to use a non-persistent ``WKWebsiteDataStore``.
      */
@@ -41,13 +41,13 @@ export interface _WKWebExtensionWindow {
     /**
      * @abstract Called to set the frame of the window. @param context The context in which the web extension is running. @param frame The new frame of the window, in screen coordinates. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion On macOS, the implementation of both ``frameForWebExtensionContext:`` and ``screenFrameForWebExtensionContext:`` are prerequisites. On iOS, iPadOS, and visionOS, only ``frameForWebExtensionContext:`` is a prerequisite. Without the respective method(s), this method will not be called. @seealso frameForWebExtensionContext: @seealso screenFrameForWebExtensionContext:
      */
-    setFrame$forWebExtensionContext$completionHandler$?(frame: CGRect, context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    setFrame$forWebExtensionContext$completionHandler$?(frame: CGRect, context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to focus the window. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented.
      */
-    focusForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    focusForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
     /**
      * @abstract Called to close the window. @param context The context in which the web extension is running. @param completionHandler A block that must be called upon completion. It takes a single error argument, which should be provided if any errors occurred. @discussion No action is performed if not implemented.
      */
-    closeForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: NobjcObject | null): void;
+    closeForWebExtensionContext$completionHandler$?(context: _WKWebExtensionContext, completionHandler: ((error: _NSError) => void) | null): void;
 }

package/dist/WebKit/WKWebView.d.ts

@@ -1,5 +1,6 @@
 import type { NobjcObject } from "objc-js";
 import type { _NSColor } from "../AppKit/NSColor.js";
+import type { _NSImage } from "../AppKit/NSImage.js";
 import type { _NSPrintInfo } from "../AppKit/NSPrintInfo.js";
 import type { _NSPrintOperation } from "../AppKit/NSPrintOperation.js";
 import type { _NSTextFinderClient } from "../AppKit/NSTextFinderClient.js";
@@ -8,7 +9,9 @@ import type { _NSView } from "../AppKit/NSView.js";
 import type { _WKBackForwardList } from "./WKBackForwardList.js";
 import type { _WKBackForwardListItem } from "./WKBackForwardListItem.js";
 import type { _WKContentWorld } from "./WKContentWorld.js";
+import type { _WKDownload } from "./WKDownload.js";
 import type { _WKFindConfiguration } from "./WKFindConfiguration.js";
+import type { _WKFindResult } from "./WKFindResult.js";
 import type { _WKFrameInfo } from "./WKFrameInfo.js";
 import type { _WKNavigation } from "./WKNavigation.js";
 import type { _WKNavigationDelegate } from "./WKNavigationDelegate.js";
@@ -20,6 +23,7 @@ import type { _NSArray } from "../Foundation/NSArray.js";
 import type { _NSCoder } from "../Foundation/NSCoder.js";
 import type { _NSData } from "../Foundation/NSData.js";
 import type { _NSDictionary } from "../Foundation/NSDictionary.js";
+import type { _NSError } from "../Foundation/NSError.js";
 import type { _NSString } from "../Foundation/NSString.js";
 import type { _NSURL } from "../Foundation/NSURL.js";
 import type { _NSURLRequest } from "../Foundation/NSURLRequest.js";
@@ -29,6 +33,7 @@ import type { CGRect } from "../structs/CGRect.js";
 import type { NSEdgeInsets } from "../structs/NSEdgeInsets.js";
 import type { WKFullscreenState } from "./WKFullscreenState.js";
 import type { WKMediaCaptureState } from "./WKMediaCaptureState.js";
+import type { WKMediaPlaybackState } from "./WKMediaPlaybackState.js";
 import type { WKWebViewDataType } from "./WKWebViewDataType.js";
 export declare class _WKWebView extends _NSView {
     static alloc(): _WKWebView;
@@ -82,62 +87,62 @@ export declare class _WKWebView extends _NSView {
     /**
      * Evaluates the given JavaScript string. The JavaScript string to evaluate. A block to invoke when script evaluation completes or fails. The completionHandler is passed the result of the script evaluation or an error. Calling this method is equivalent to calling `evaluateJavaScript:inFrame:inContentWorld:completionHandler:` with: - A `frame` value of `nil` to represent the main frame - A `contentWorld` value of `WKContentWorld.pageWorld`
      */
-    evaluateJavaScript$completionHandler$(javaScriptString: _NSString, completionHandler: NobjcObject | null): void;
+    evaluateJavaScript$completionHandler$(javaScriptString: _NSString, completionHandler: ((WK_NULLABLE_RESULT: NobjcObject, error: _NSError) => NobjcObject) | null): void;
     /**
      * Evaluates the given JavaScript string. The JavaScript string to evaluate. A WKFrameInfo identifying the frame in which to evaluate the JavaScript string. The WKContentWorld in which to evaluate the JavaScript string. A block to invoke when script evaluation completes or fails. The completionHandler is passed the result of the script evaluation or an error. Passing nil is equivalent to targeting the main frame. If the frame argument no longer represents a valid frame by the time WebKit attempts to call the JavaScript function your completion handler will be called with a WKErrorJavaScriptInvalidFrameTarget error. This might happen for a number of reasons, including but not limited to: - The target frame has been removed from the DOM via JavaScript - A parent frame has navigated, destroying all of its previous child frames No matter which WKContentWorld you use to evaluate your JavaScript string, you can make changes to the underlying web content. (e.g. the Document and its DOM structure) Such changes will be visible to script executing in all WKContentWorlds. Evaluating your JavaScript string can leave behind other changes to global state visible to JavaScript. (e.g. `window.myVariable = 1;`) Those changes will only be visible to scripts executed in the same WKContentWorld. evaluateJavaScript: is a great way to set up global state for future JavaScript execution in a given world. (e.g. Importing libraries/utilities that future JavaScript execution will rely on) Once your global state is set up, consider using callAsyncJavaScript: for more flexible interaction with the JavaScript programming model.
      */
-    evaluateJavaScript$inFrame$inContentWorld$completionHandler$(javaScriptString: _NSString, frame: _WKFrameInfo | null, contentWorld: _WKContentWorld, completionHandler: NobjcObject | null): void;
+    evaluateJavaScript$inFrame$inContentWorld$completionHandler$(javaScriptString: _NSString, frame: _WKFrameInfo | null, contentWorld: _WKContentWorld, completionHandler: ((WK_NULLABLE_RESULT: NobjcObject, error: _NSError) => NobjcObject) | null): void;
     /**
      * Calls the given JavaScript string as an async JavaScript function, passing the given named arguments to that function. The JavaScript string to use as the function body. A dictionary representing the arguments to be passed to the function call. A WKFrameInfo identifying the frame in which to call the JavaScript function. The WKContentWorld in which to call the JavaScript function. A block to invoke with the return value of the function call, or with the asynchronous resolution of the function's return value. The functionBody string is treated as an anonymous JavaScript function body that can be called with named arguments. Do not format your functionBody string as a function-like callable object as you would in pure JavaScript. Your functionBody string should contain only the function body you want executed. For example do not pass in the string: Instead pass in the string: The arguments dictionary supplies the values for those arguments which are serialized into JavaScript equivalents. For example: Combining the above arguments dictionary with the above functionBody string, a function with the arguments named "x", "y", and "z" is called with values true, 1, and "hello world" respectively. Allowed argument types are: NSNumber, NSString, NSDate, NSArray, NSDictionary, and NSNull. Any NSArray or NSDictionary containers can only contain objects of those types. Passing nil is equivalent to targeting the main frame. If the frame argument no longer represents a valid frame by the time WebKit attempts to call the JavaScript function your completion handler will be called with a WKErrorJavaScriptInvalidFrameTarget error. This might happen for a number of reasons, including but not limited to: - The target frame has been removed from the DOM via JavaScript - A parent frame has navigated, destroying all of its previous child frames No matter which WKContentWorld you use to call your JavaScript function, you can make changes to the underlying web content. (e.g. the Document and its DOM structure) Such changes will be visible to script executing in all WKContentWorlds. Calling your JavaScript function can leave behind other changes to global state visibile to JavaScript. (e.g. `window.myVariable = 1;`) Those changes will only be visibile to scripts executed in the same WKContentWorld. Your completion handler will be called with the explicit return value of your JavaScript function. If your JavaScript does not explicitly return any value, that undefined result manifests as nil being passed to your completion handler. If your JavaScript returns null, that result manifests as NSNull being passed to your completion handler. JavaScript has the concept of a "thenable" object, which is any JavaScript object that has a callable "then" property. The most well known example of a "thenable" object is a JavaScript promise. If your JavaScript returns a "thenable" object WebKit will call "then" on the resulting object and wait for it to be resolved. If the object resolves successfully (e.g. Calls the "fulfill" function) your completion handler will be called with the result. If the object rejects (e.g. Calls the "reject" function) your completion handler will be called with a WKErrorJavaScriptAsyncFunctionResultRejected error containing the reject reason in the userInfo dictionary. If the object is garbage collected before it is resolved, your completion handler will be called with a WKErrorJavaScriptAsyncFunctionResultUnreachable error indicating that it will never be resolved. Since the function is a JavaScript "async" function you can use JavaScript "await" on thenable objects inside your function body. For example: The above function text will create a promise that will fulfull with the value 42 after a one second delay, wait for it to resolve, then return the fulfillment value of 42.
      */
-    callAsyncJavaScript$arguments$inFrame$inContentWorld$completionHandler$(functionBody: _NSString, arguments_: _NSDictionary | null, frame: _WKFrameInfo | null, contentWorld: _WKContentWorld, completionHandler: NobjcObject | null): void;
+    callAsyncJavaScript$arguments$inFrame$inContentWorld$completionHandler$(functionBody: _NSString, arguments_: _NSDictionary | null, frame: _WKFrameInfo | null, contentWorld: _WKContentWorld, completionHandler: ((result: NobjcObject, error: _NSError) => NobjcObject) | null): void;
     /**
      * Closes all out-of-window media presentations in a WKWebView. Includes picture-in-picture and fullscreen.
      * @deprecated closeAllMediaPresentationsWithCompletionHandler:
      */
-    closeAllMediaPresentationsWithCompletionHandler$(completionHandler: NobjcObject | null): void;
+    closeAllMediaPresentationsWithCompletionHandler$(completionHandler: (() => NobjcObject) | null): void;
     /** @deprecated closeAllMediaPresentationsWithCompletionHandler: */
     closeAllMediaPresentations(): void;
     /**
      * Pauses media playback in WKWebView. Pauses media playback. Media in the page can be restarted by calling play() on a media element or resume() on an AudioContext in JavaScript. A user can also use media controls to play media content after it has been paused.
      * @deprecated pauseAllMediaPlaybackWithCompletionHandler:
      */
-    pauseAllMediaPlaybackWithCompletionHandler$(completionHandler: NobjcObject | null): void;
+    pauseAllMediaPlaybackWithCompletionHandler$(completionHandler: (() => NobjcObject) | null): void;
     /** @deprecated pauseAllMediaPlaybackWithCompletionHandler: */
-    pauseAllMediaPlayback$(completionHandler: NobjcObject | null): void;
+    pauseAllMediaPlayback$(completionHandler: (() => NobjcObject) | null): void;
     /**
      * Suspends or resumes all media playback in WKWebView. Whether media playback should be suspended or resumed. If suspended is true, this pauses media playback and blocks all attempts by the page or the user to resume until setAllMediaPlaybackSuspended is called again with suspended set to false. Media playback should always be suspended and resumed in pairs.
      * @deprecated setAllMediaPlaybackSuspended:completionHandler:
      */
-    setAllMediaPlaybackSuspended$completionHandler$(suspended: boolean, completionHandler: NobjcObject | null): void;
+    setAllMediaPlaybackSuspended$completionHandler$(suspended: boolean, completionHandler: (() => NobjcObject) | null): void;
     /** @deprecated setAllMediaPlaybackSuspended:completionHandler: */
-    resumeAllMediaPlayback$(completionHandler: NobjcObject | null): void;
+    resumeAllMediaPlayback$(completionHandler: (() => NobjcObject) | null): void;
     /** @deprecated setAllMediaPlaybackSuspended:completionHandler: */
-    suspendAllMediaPlayback$(completionHandler: NobjcObject | null): void;
+    suspendAllMediaPlayback$(completionHandler: (() => NobjcObject) | null): void;
     /**
      * Get the current media playback state of a WKWebView. A block to invoke with the return value of the function call. If media playback exists, WKMediaPlaybackState will be one of three values: WKMediaPlaybackPaused, WKMediaPlaybackSuspended, or WKMediaPlaybackPlaying. If no media playback exists in the current WKWebView, WKMediaPlaybackState will equal WKMediaPlaybackStateNone.
      * @deprecated requestMediaPlaybackStateWithCompletionHandler:
      */
-    requestMediaPlaybackStateWithCompletionHandler$(completionHandler: NobjcObject): void;
+    requestMediaPlaybackStateWithCompletionHandler$(completionHandler: (arg0: WKMediaPlaybackState) => NobjcObject): void;
     /** @deprecated requestMediaPlaybackStateWithCompletionHandler: */
-    requestMediaPlaybackState$(completionHandler: NobjcObject): void;
+    requestMediaPlaybackState$(completionHandler: (arg0: WKMediaPlaybackState) => NobjcObject): void;
     /**
      * Set camera capture state of a WKWebView. State to apply for capture. A block to invoke after the camera state has been changed. If value is WKMediaCaptureStateNone, this will stop any camera capture. If value is WKMediaCaptureStateMuted, any active camera capture will become muted. If value is WKMediaCaptureStateActive, any muted camera capture will become active.
      */
-    setCameraCaptureState$completionHandler$(state: WKMediaCaptureState, completionHandler: NobjcObject | null): void;
+    setCameraCaptureState$completionHandler$(state: WKMediaCaptureState, completionHandler: (() => NobjcObject) | null): void;
     /**
      * Set microphone capture state of a WKWebView. state to apply for capture. A block to invoke after the microphone state has been changed. If value is WKMediaCaptureStateNone, this will stop any microphone capture. If value is WKMediaCaptureStateMuted, any active microphone capture will become muted. If value is WKMediaCaptureStateActive, any muted microphone capture will become active.
      */
-    setMicrophoneCaptureState$completionHandler$(state: WKMediaCaptureState, completionHandler: NobjcObject | null): void;
-    takeSnapshotWithConfiguration$completionHandler$(snapshotConfiguration: _WKSnapshotConfiguration | null, completionHandler: NobjcObject | null): void;
+    setMicrophoneCaptureState$completionHandler$(state: WKMediaCaptureState, completionHandler: (() => NobjcObject) | null): void;
+    takeSnapshotWithConfiguration$completionHandler$(snapshotConfiguration: _WKSnapshotConfiguration | null, completionHandler: ((snapshotImage: _NSImage, error: _NSError) => NobjcObject) | null): void;
     /**
      * Create a PDF document representation from the web page currently displayed in the WKWebView An object that specifies how the PDF capture is configured. A block to invoke when the pdf document data is ready. If the WKPDFConfiguration is nil, the method will create a PDF document representing the bounds of the currently displayed web page. The completionHandler is passed the resulting PDF document data or an error. The data can be used to create a PDFDocument object. If the data is written to a file the resulting file is a valid PDF document.
      */
-    createPDFWithConfiguration$completionHandler$(pdfConfiguration: _WKPDFConfiguration | null, completionHandler: NobjcObject | null): void;
+    createPDFWithConfiguration$completionHandler$(pdfConfiguration: _WKPDFConfiguration | null, completionHandler: ((pdfDocumentData: _NSData, error: _NSError) => NobjcObject) | null): void;
     /**
      * Create WebKit web archive data representing the current web content of the WKWebView A block to invoke when the web archive data is ready. WebKit web archive data represents a snapshot of web content. It can be used to represent web content on a pasteboard, loaded into a WKWebView directly, and saved to a file for later use. The uniform type identifier kUTTypeWebArchive can be used get the related pasteboard type and MIME type.
      */
-    createWebArchiveDataWithCompletionHandler$(completionHandler: NobjcObject | null): void;
+    createWebArchiveDataWithCompletionHandler$(completionHandler: ((arg0: _NSData, arg1: _NSError) => NobjcObject) | null): void;
     /**
      * Scales the page content by a specified factor and centers the result on a specified point. The factor by which to scale the content. The point (in view space) on which to center magnification.
      */
@@ -145,15 +150,15 @@ export declare class _WKWebView extends _NSView {
     /**
      * Searches the page contents for the given string. The string to search for. A set of options configuring the search. A block to invoke when the search completes. If the WKFindConfiguration is nil, all of the default WKFindConfiguration values will be used. A match found by the search is selected and the page is scrolled to reveal the selection. The completion handler is called after the search completes.
      */
-    findString$withConfiguration$completionHandler$(string_: _NSString, configuration: _WKFindConfiguration | null, completionHandler: NobjcObject): void;
+    findString$withConfiguration$completionHandler$(string_: _NSString, configuration: _WKFindConfiguration | null, completionHandler: (result: _WKFindResult) => NobjcObject): void;
     /**
      * Begins a download in the context of the currently displayed webpage as if the WKNavigationDelegate turned a navigation into a download instead The request specifying the URL to download. A block called when the download has started. The download needs its delegate to be set in the completionHandler to receive updates about its progress.
      */
-    startDownloadUsingRequest$completionHandler$(request: _NSURLRequest, completionHandler: NobjcObject): void;
+    startDownloadUsingRequest$completionHandler$(request: _NSURLRequest, completionHandler: (arg0: _WKDownload) => NobjcObject): void;
     /**
      * Resumes a download that failed or was canceled. Data from a WKDownloadDelegate's didFailWithError or a WKDownload's cancel completionHandler. A block called when the download has resumed. The download needs its delegate to be set in the completionHandler to receive updates about its progress.
      */
-    resumeDownloadFromResumeData$completionHandler$(resumeData: _NSData, completionHandler: NobjcObject): void;
+    resumeDownloadFromResumeData$completionHandler$(resumeData: _NSData, completionHandler: (arg0: _WKDownload) => NobjcObject): void;
     /**
      * Sets the webpage contents from the passed data as if it was the response to the supplied request. The request is never actually sent to the supplied URL, though loads of resources defined in the NSData object would be performed. The request specifying the base URL and other loading details to be used while interpreting the supplied data object. A response that is used to interpret the supplied data object. The data to use as the contents of the webpage. A new navigation.
      * @deprecated loadSimulatedRequest:response:responseData:
@@ -180,11 +185,11 @@ export declare class _WKWebView extends _NSView {
     /**
      * Called when the client wants to fetch WKWebView data. The option set of WKWebView data types whose data the client wants to fetch. The completion handler that should be invoked with the retrieved data and possibly an error. The retrieved data will be a serialized blob. If an error occurred, the retrieved data will be nil. An error may occur if the data cannot be retrieved for some reason (such as a crash).
      */
-    fetchDataOfTypes$completionHandler$(dataTypes: WKWebViewDataType, completionHandler: NobjcObject | null): void;
+    fetchDataOfTypes$completionHandler$(dataTypes: WKWebViewDataType, completionHandler: ((data: _NSData, error: _NSError) => NobjcObject) | null): void;
     /**
      * Called when the client wants to restore WKWebView data. The serialized blob containing the data that the client wants to restore. The completion handler that may be invoked with an error if the data is in an invalid format or if the data cannot be restored for some other reason (such as a crash).
      */
-    restoreData$completionHandler$(data: _NSData, completionHandler: NobjcObject | null): void;
+    restoreData$completionHandler$(data: _NSData, completionHandler: ((error: _NSError) => NobjcObject) | null): void;
     /**
      * Action method that navigates to the back item in the back-forward list. The object that sent this message.
      */

package/dist/WebKit/WKWebsiteDataStore.d.ts

@@ -2,6 +2,7 @@ import type { NobjcObject } from "objc-js";
 import type { _NSArray } from "../Foundation/NSArray.js";
 import type { _NSData } from "../Foundation/NSData.js";
 import type { _NSDate } from "../Foundation/NSDate.js";
+import type { _NSError } from "../Foundation/NSError.js";
 import type { _NSObject } from "../Foundation/NSObject.js";
 import type { _NSSecureCoding } from "../Foundation/NSSecureCoding.js";
 import type { _NSSet } from "../Foundation/NSSet.js";
@@ -26,31 +27,31 @@ export declare class _WKWebsiteDataStore extends _NSObject {
     /**
      * Delete a persistent data store. An identifier that is used to uniquely identify the data store. A block to invoke with optional error when the operation completes. This should be called when the data store is not used any more. Returns error if removal fails to complete. WKWebView using the data store must be released before removal.
      */
-    static removeDataStoreForIdentifier$completionHandler$(identifier: _NSUUID, completionHandler: NobjcObject | null): void;
+    static removeDataStoreForIdentifier$completionHandler$(identifier: _NSUUID, completionHandler: ((arg0: _NSError) => NobjcObject) | null): void;
     /**
      * Fetch all data stores identifiers. A block to invoke with an array of identifiers when the operation completes. Default or non-persistent data store do not have an identifier.
      */
-    static fetchAllDataStoreIdentifiers$(completionHandler: NobjcObject): void;
+    static fetchAllDataStoreIdentifiers$(completionHandler: (arg0: _NSArray) => NobjcObject): void;
     /**
      * Fetches data records containing the given website data types. The website data types to fetch records for. A block to invoke when the data records have been fetched.
      */
-    fetchDataRecordsOfTypes$completionHandler$(dataTypes: _NSSet, completionHandler: NobjcObject): void;
+    fetchDataRecordsOfTypes$completionHandler$(dataTypes: _NSSet, completionHandler: (arg0: _NSArray) => NobjcObject): void;
     /**
      * Removes website data of the given types for the given data records. The website data types that should be removed. The website data records to delete website data for. A block to invoke when the website data for the records has been removed.
      */
-    removeDataOfTypes$forDataRecords$completionHandler$(dataTypes: _NSSet, dataRecords: _NSArray, completionHandler: NobjcObject): void;
+    removeDataOfTypes$forDataRecords$completionHandler$(dataTypes: _NSSet, dataRecords: _NSArray, completionHandler: () => NobjcObject): void;
     /**
      * Removes all website data of the given types that has been modified since the given date. The website data types that should be removed. A date. All website data modified after this date will be removed. A block to invoke when the website data has been removed.
      */
-    removeDataOfTypes$modifiedSince$completionHandler$(dataTypes: _NSSet, date: _NSDate, completionHandler: NobjcObject): void;
+    removeDataOfTypes$modifiedSince$completionHandler$(dataTypes: _NSSet, date: _NSDate, completionHandler: () => NobjcObject): void;
     /**
      * Called when the client wants to fetch WKWebsiteDataStore data. The set of WKWebsiteDataStore data types whose data the client wants to fetch. The completion handler that should be invoked with the retrieved data and possibly an error. The retrieved data will be a serialized blob. If an error occurred, the retrieved data will be nil. An error may occur if a requested data type is not supported or if the data cannot be retrieved for some other reason (such as a crash).
      */
-    fetchDataOfTypes$completionHandler$(dataTypes: _NSSet, completionHandler: NobjcObject | null): void;
+    fetchDataOfTypes$completionHandler$(dataTypes: _NSSet, completionHandler: ((data: _NSData, error: _NSError) => NobjcObject) | null): void;
     /**
      * Called when the client wants to restore WKWebsiteDataStore data. The serialized blob containing the data that the client wants to restore. The completion handler that may be invoked with an error if the data is in an invalid format or if the data cannot be restored for some other reason (such as a crash).
      */
-    restoreData$completionHandler$(data: _NSData, completionHandler: NobjcObject | null): void;
+    restoreData$completionHandler$(data: _NSData, completionHandler: ((error: _NSError) => NobjcObject) | null): void;
     /** Whether the data store is persistent or not. */
     persistent(): boolean;
     /** Returns the cookie store representing HTTP cookies in this website data store. */

package/dist/WebKit/index.d.ts

@@ -569,8 +569,13 @@ export { WKNavigationType } from "./WKNavigationType.js";
 export { WKPermissionDecision } from "./WKPermissionDecision.js";
 export { WKUserInterfaceDirectionPolicy } from "./WKUserInterfaceDirectionPolicy.js";
 export { WKUserScriptInjectionTime } from "./WKUserScriptInjectionTime.js";
+export { WKWebExtensionContextError } from "./WKWebExtensionContextError.js";
 export { WKWebExtensionContextPermissionStatus } from "./WKWebExtensionContextPermissionStatus.js";
+export { WKWebExtensionDataRecordError } from "./WKWebExtensionDataRecordError.js";
+export { WKWebExtensionError } from "./WKWebExtensionError.js";
+export { WKWebExtensionMatchPatternError } from "./WKWebExtensionMatchPatternError.js";
 export { WKWebExtensionMatchPatternOptions } from "./WKWebExtensionMatchPatternOptions.js";
+export { WKWebExtensionMessagePortError } from "./WKWebExtensionMessagePortError.js";
 export { WKWebExtensionTabChangedProperties } from "./WKWebExtensionTabChangedProperties.js";
 export { WKWebExtensionWindowState } from "./WKWebExtensionWindowState.js";
 export { WKWebExtensionWindowType } from "./WKWebExtensionWindowType.js";

package/dist/WebKit/index.js

@@ -185,8 +185,13 @@ export { WKNavigationType } from "./WKNavigationType.js";
 export { WKPermissionDecision } from "./WKPermissionDecision.js";
 export { WKUserInterfaceDirectionPolicy } from "./WKUserInterfaceDirectionPolicy.js";
 export { WKUserScriptInjectionTime } from "./WKUserScriptInjectionTime.js";
+export { WKWebExtensionContextError } from "./WKWebExtensionContextError.js";
 export { WKWebExtensionContextPermissionStatus } from "./WKWebExtensionContextPermissionStatus.js";
+export { WKWebExtensionDataRecordError } from "./WKWebExtensionDataRecordError.js";
+export { WKWebExtensionError } from "./WKWebExtensionError.js";
+export { WKWebExtensionMatchPatternError } from "./WKWebExtensionMatchPatternError.js";
 export { WKWebExtensionMatchPatternOptions } from "./WKWebExtensionMatchPatternOptions.js";
+export { WKWebExtensionMessagePortError } from "./WKWebExtensionMessagePortError.js";
 export { WKWebExtensionTabChangedProperties } from "./WKWebExtensionTabChangedProperties.js";
 export { WKWebExtensionWindowState } from "./WKWebExtensionWindowState.js";
 export { WKWebExtensionWindowType } from "./WKWebExtensionWindowType.js";

package/dist/iTunesLibrary/ITLibMediaEntity.d.ts

@@ -14,11 +14,11 @@ export declare class _ITLibMediaEntity extends _NSObject {
     /**
      * @abstract Executes a provided block with the fetched values for the given item properties. @discussion Use this method to get property values in a batch fashion. In some cases, enumerating over a set of property keys can be more efficient than fetching each individual property with valueForProperty:. The media property keys you can use with this property are listed in this document and in Media Item Property Keys and Playlist Property Keys. @param properties A set of keys for the properties that will be enumerated, or nil to enumerate all properties. @param block A block object that executes for each property in the properties set.
      */
-    enumerateValuesForProperties$usingBlock$(properties: _NSSet | null, block: NobjcObject): void;
+    enumerateValuesForProperties$usingBlock$(properties: _NSSet | null, block: (property: _NSString, value: NobjcObject, stop: NobjcObject) => void): void;
     /**
      * @abstract Executes a provided block with the fetched values for all properties in the entity except for the provided set. @discussion Use this method to get property values in a batch fashion. In some cases, enumerating over a set of property keys can be more efficient than fetching each individual property with valueForProperty:. The media property keys you can use with this property are listed in this document and in Media Item Property Keys and Playlist Property Keys. @param properties A set of property keys that should NOT be enumerated, or nil to enumerate all properties. @param block A block object that executes for each property except for the ones in the properties set.
      */
-    enumerateValuesExceptForProperties$usingBlock$(properties: _NSSet | null, block: NobjcObject): void;
+    enumerateValuesExceptForProperties$usingBlock$(properties: _NSSet | null, block: (property: _NSString, value: NobjcObject, stop: NobjcObject) => void): void;
     /** @abstract The unique identifier of this media entity. */
     persistentID(): _NSNumber;
 }