@girs/sdk-gnome-49 5.2.0 → 5.3.0

package/webkit-6.0/webkit-6.0.d.ts

@@ -186,7 +186,7 @@ export namespace WebKit {
 
     /**
      * Enum values used to denote the stock actions for
-     * {@link WebKit.ContextMenuItem}<!-- -->s
+     * {@link WebKit.ContextMenuItem} objects
      * @gir-type Enum
      */
     enum ContextMenuAction {
@@ -247,7 +247,7 @@ export namespace WebKit {
          */
         RELOAD = 13,
         /**
-         * Copy current selection the clipboard.
+         * Copy current selection to the clipboard.
          */
         COPY = 14,
         /**
@@ -327,11 +327,11 @@ export namespace WebKit {
          */
         OPEN_AUDIO_IN_NEW_WINDOW = 33,
         /**
-         * Copy video link location in to the clipboard.
+         * Copy video link location to the clipboard.
          */
         COPY_VIDEO_LINK_TO_CLIPBOARD = 34,
         /**
-         * Copy audio link location in to the clipboard.
+         * Copy audio link location to the clipboard.
          */
         COPY_AUDIO_LINK_TO_CLIPBOARD = 35,
         /**
@@ -537,7 +537,7 @@ export namespace WebKit {
     }
 
     /**
-     * Describes the status of a {@link WebKitFeature}.
+     * Describes the status of a {@link Feature}.
      * 
      * The status for a given feature can be obtained with
      * `webkit_feature_get_status`.
@@ -546,9 +546,9 @@ export namespace WebKit {
      */
     enum FeatureStatus {
         /**
-         * Feature that adjust behaviour for
+         * Feature that adjusts behavior for
          *   specific application needs. The feature is not part of a Web platform
-         *   feature, not a mature feature intended to be always on.
+         *   feature, nor a mature feature intended to be always on.
          */
         EMBEDDER = 0,
         /**
@@ -559,7 +559,7 @@ export namespace WebKit {
         UNSTABLE = 1,
         /**
          * Feature for debugging the WebKit engine.
-         *   The feature is not generally useful for user or web developers, and
+         *   The feature is not generally useful for users or web developers, and
          *   always disabled by default.
          */
         INTERNAL = 2,
@@ -660,6 +660,11 @@ export namespace WebKit {
          * Editable element expects a password
          */
         PASSWORD = 6,
+        /**
+         * Edited field contents will be used for searching data.
+         * @since 2.54
+         */
+        SEARCH = 7,
     }
 
 
@@ -707,7 +712,7 @@ export namespace WebKit {
         static SCRIPT_FAILED: number;
 
         /**
-         * An unsupported parameter has been used to call and async function from API. Since 2.40
+         * An unsupported parameter has been used to call an async function from API. Since 2.40
          */
         static INVALID_PARAMETER: number;
 
@@ -1275,7 +1280,7 @@ export namespace WebKit {
     }
 
     /**
-     * Specifies in which frames user style sheets are to be inserted in.
+     * Specifies in which frames user style sheets are to be inserted.
      * @gir-type Enum
      * @since 2.6
      */
@@ -1327,7 +1332,7 @@ export namespace WebKit {
     }
 
     /**
-     * Specifies at which place of documents an user script will be inserted.
+     * Specifies at which place of documents a user script will be inserted.
      * @gir-type Enum
      * @since 2.6
      */
@@ -1353,13 +1358,13 @@ export namespace WebKit {
     }
 
     /**
-     * Specifies how to treat an user style sheet.
+     * Specifies how to treat a user style sheet.
      * @gir-type Enum
      * @since 2.6
      */
     enum UserStyleLevel {
         /**
-         * The style sheet is an user style sheet,
+         * The style sheet is a user style sheet,
          *   its contents always override other style sheets. This is the default.
          */
         USER = 0,
@@ -1381,7 +1386,7 @@ export namespace WebKit {
 
         // Static fields
         /**
-         * An unknown error occured.
+         * An unknown error occurred.
          */
         static UNKNOWN: number;
 
@@ -1446,7 +1451,7 @@ export namespace WebKit {
 
         // Static fields
         /**
-         * An unknown error occured.
+         * An unknown error occurred.
          */
         static UNKNOWN: number;
 
@@ -1580,7 +1585,7 @@ export namespace WebKit {
      * the current cursor position. If there's a selection, the selected text
      * will be used as the link text, otherwise the URL itself will be used.
      * It receives the link URL as argument. This command should be executed
-     * with `webkit_web_view_execute_editing_command_with_argument()`
+     * with `webkit_web_view_execute_editing_command_with_argument()`.
      * @since 2.10
      * @default CreateLink
      */
@@ -1599,7 +1604,7 @@ export namespace WebKit {
 
     /**
      * The insert image command. Creates an image element that is inserted at
-     * the current cursor position. It receives an URI as argument,
+     * the current cursor position. It receives a URI as argument,
      * that is used as the image source. This command should be executed with
      * `webkit_web_view_execute_editing_command_with_argument()`.
      * @since 2.10
@@ -1671,7 +1676,7 @@ export namespace WebKit {
      * Like `webkit_get_micro_version()`, but from the headers used at
      * application compile time, rather than from the library linked
      * against at application run time.
-     * @default 5
+     * @default 0
      */
     const MICRO_VERSION: number;
 
@@ -1679,7 +1684,7 @@ export namespace WebKit {
      * Like `webkit_get_minor_version()`, but from the headers used at
      * application compile time, rather than from the library linked
      * against at application run time.
-     * @default 52
+     * @default 54
      */
     const MINOR_VERSION: number;
 
@@ -1742,7 +1747,7 @@ export namespace WebKit {
 
     /**
      * Gets the quark for the domain of media errors.
-     * @returns media error domin.
+     * @returns media error domain.
      * @since 2.40
      */
     function media_error_quark(): GLib.Quark;
@@ -1930,7 +1935,7 @@ export namespace WebKit {
         CASE_INSENSITIVE = 1,
         /**
          * search text only at the
-         *   begining of the words.
+         *   beginning of the words.
          */
         AT_WORD_STARTS = 2,
         /**
@@ -2015,7 +2020,7 @@ export namespace WebKit {
          */
         SPELLCHECK = 1,
         /**
-         * Suggest to not autocapitlize
+         * Suggest to not autocapitalize
          */
         LOWERCASE = 2,
         /**
@@ -2089,7 +2094,7 @@ export namespace WebKit {
          */
         IGNORE_SCHEMES = 2,
         /**
-         * The host components should be ignored while matching.
+         * The path components should be ignored while matching.
          */
         IGNORE_PATHS = 4,
         /**
@@ -2386,7 +2391,7 @@ export namespace WebKit {
         is_for_proxy(): boolean;
 
         /**
-         * Determine whether this this is a first attempt or a retry for this authentication challenge.
+         * Determine whether this is a first attempt or a retry for this authentication challenge.
          * @returns `true` if authentication attempt is a retry or `false` otherwise.
          * @since 2.2
          */
@@ -2533,10 +2538,10 @@ export namespace WebKit {
 
         // Methods
         /**
-         * Get the the previously set {@link WebKit.AutomationSession}.
+         * Get the previously set {@link WebKit.ApplicationInfo}.
          * 
-         * Get the {@link WebKit.AutomationSession} previously set with `webkit_automation_session_set_application_info()`.
-         * @returns the {@link WebKit.AutomationSession} of `session`, or `null` if no one has been set.
+         * Get the {@link WebKit.ApplicationInfo} previously set with `webkit_automation_session_set_application_info()`.
+         * @returns the {@link WebKit.ApplicationInfo} of `session`, or `null` if no one has been set.
          * @since 2.18
          */
         get_application_info(): ApplicationInfo;
@@ -2571,7 +2576,7 @@ export namespace WebKit {
              * This signal is emitted when `back_forward_list` changes. This happens
              * when the current item is updated, a new item is added or one or more
              * items are removed. Note that both `item_added` and `items_removed` can
-             * `null` when only the current item is updated. Items are only removed
+             * be `null` when only the current item is updated. Items are only removed
              * when the list is cleared or the maximum items limit is reached.
              * @signal
              * @run-last
@@ -2596,7 +2601,7 @@ export namespace WebKit {
      * Methods `webkit_web_view_go_back()` and `webkit_web_view_go_forward()` move
      * the current item backward or forward by one. Method
      * `webkit_web_view_go_to_back_forward_list_item()` sets the current item to the
-     * specified item. All other methods returning {@link WebKit.BackForwardListItem}<!-- -->s
+     * specified item. All other methods returning {@link WebKit.BackForwardListItem} objects
      * do not change the value of the current item, they just return the requested
      * item or items.
      * @gir-type Class
@@ -2700,7 +2705,7 @@ export namespace WebKit {
      * One item of the {@link WebKit.BackForwardList}.
      * 
      * A history item is part of the {@link WebKit.BackForwardList} and consists
-     * out of a title and a URI.
+     * of a title and a URI.
      * @gir-type Class
      */
     class BackForwardListItem extends GObject.InitiallyUnowned {
@@ -2856,7 +2861,7 @@ export namespace WebKit {
      * Whenever the user interacts with an <input type='color' />
      * HTML element, WebKit will need to show a dialog to choose a color. For that
      * to happen in a general way, instead of just opening a {@link Gtk.ColorChooser}
-     * (which might be not desirable in some cases, which could prefer to use their
+     * (which might not be desirable for applications that prefer to use their
      * own color chooser dialog), WebKit will fire the
      * {@link WebKit.WebView.SignalSignatures.run_color_chooser | WebKit.WebView::run-color-chooser} signal with a {@link WebKit.ColorChooserRequest}
      * object, which will allow the client application to specify the color to be
@@ -3271,7 +3276,7 @@ export namespace WebKit {
      * You can get it from a {@link WebKit.WebsiteDataManager} with
      * `webkit_website_data_manager_get_cookie_manager()`, and use it to set where to
      * store cookies with `webkit_cookie_manager_set_persistent_storage()`,
-     * or to set the acceptance policy, with `webkit_cookie_manager_get_accept_policy()`.
+     * or to set the acceptance policy, with `webkit_cookie_manager_set_accept_policy()`.
      * @gir-type Class
      */
     class CookieManager extends GObject.Object {
@@ -3491,7 +3496,7 @@ export namespace WebKit {
          * 
          * When the operation is finished, `callback` will be called. You can then call
          * `webkit_cookie_manager_get_cookies_finish()` to get the result of the operation.
-         * @param uri the URI associated to the cookies to be retrieved
+         * @param uri the URI associated with the cookies to be retrieved
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
          * @since 2.20
          */
@@ -3505,7 +3510,7 @@ export namespace WebKit {
          * 
          * When the operation is finished, `callback` will be called. You can then call
          * `webkit_cookie_manager_get_cookies_finish()` to get the result of the operation.
-         * @param uri the URI associated to the cookies to be retrieved
+         * @param uri the URI associated with the cookies to be retrieved
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
          * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied
          * @since 2.20
@@ -3520,7 +3525,7 @@ export namespace WebKit {
          * 
          * When the operation is finished, `callback` will be called. You can then call
          * `webkit_cookie_manager_get_cookies_finish()` to get the result of the operation.
-         * @param uri the URI associated to the cookies to be retrieved
+         * @param uri the URI associated with the cookies to be retrieved
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
          * @param callback a {@link Gio.AsyncReadyCallback} to call when the request is satisfied
          * @since 2.20
@@ -3605,8 +3610,8 @@ export namespace WebKit {
          * By default, `cookie_manager` doesn't store the cookies persistently, so you need to call this
          * method to keep cookies saved across sessions.
          * 
-         * This method should never be called on a {@link WebKit.CookieManager} associated to an ephemeral {@link WebKit.WebsiteDataManager}.
-         * @param filename the filename to read to/write from
+         * This method should never be called on a {@link WebKit.CookieManager} associated with an ephemeral {@link WebKit.WebsiteDataManager}.
+         * @param filename the filename to read from/write to
          * @param storage a {@link WebKit.CookiePersistentStorage}
          */
         set_persistent_storage(filename: string, storage: CookiePersistentStorage): void;
@@ -3625,8 +3630,8 @@ export namespace WebKit {
      * A permission request for enumerating the user's media devices
      * 
      * WebKitDeviceInfoPermissionRequest represents a request for
-     * permission to whether WebKit should be allowed to access the user's
-     * devices information when requested through the MediaDevices.enumerateDevices
+     * permission to decide whether WebKit should be allowed to access the user's
+     * device information when requested through the MediaDevices.enumerateDevices
      * API.
      * 
      * When a WebKitDeviceInfoPermissionRequest is not handled by the user,
@@ -3801,7 +3806,7 @@ export namespace WebKit {
          * This value will range from 0.0 to 1.0. The value is an estimate
          * based on the total number of bytes expected to be received for
          * a download.
-         * If you need a more accurate progress information you can connect to
+         * If you need more accurate progress information you can connect to
          * {@link WebKit.Download.SignalSignatures.received_data | WebKit.Download::received-data} signal to track the progress.
          * @read-only
          * @default 1
@@ -3813,7 +3818,7 @@ export namespace WebKit {
          * This value will range from 0.0 to 1.0. The value is an estimate
          * based on the total number of bytes expected to be received for
          * a download.
-         * If you need a more accurate progress information you can connect to
+         * If you need more accurate progress information you can connect to
          * {@link WebKit.Download.SignalSignatures.received_data | WebKit.Download::received-data} signal to track the progress.
          * @read-only
          * @default 1
@@ -3891,11 +3896,10 @@ export namespace WebKit {
         get_elapsed_time(): number;
 
         /**
-         * Gets the value of the {@link WebKit.Download.estimated_progress} property.
          * Gets the value of the {@link WebKit.Download.estimated_progress} property.
          * You can monitor the estimated progress of the download operation by
          * connecting to the notify::estimated-progress signal of `download`.
-         * @returns an estimate of the of the percent complete for a download     as a range from 0.0 to 1.0.
+         * @returns an estimate of the percent complete for a download     as a range from 0.0 to 1.0.
          */
         get_estimated_progress(): number;
 
@@ -3969,7 +3973,7 @@ export namespace WebKit {
         // Signal signatures
         interface SignalSignatures extends GObject.Object.SignalSignatures {
             /**
-             * Emitted when the `WebKitEdtorState` is changed.
+             * Emitted when the {@link WebKit.EditorState} is changed.
              * @signal
              * @since 2.44
              * @run-last
@@ -4101,6 +4105,7 @@ export namespace WebKit {
              * {@link WebKit.WebView} it's easier to use the {@link WebKit.WebView.favicon}
              * property. See `webkit_web_view_get_favicon()` for more details.
              * @signal
+             * @deprecated since 2.54
              * @run-last
              */
             "favicon-changed": (page_uri: string, favicon_uri: string) => void;
@@ -4113,12 +4118,12 @@ export namespace WebKit {
     /**
      * Provides access to the icons associated with web sites.
      * 
-     * WebKit will automatically look for available icons in <link>
+     * WebKit will automatically look for available icons in `<link>`
      * elements on opened pages as well as an existing favicon.ico and
      * load the images found into a memory cache if possible. That cache
      * is frozen to an on-disk database for persistence.
      * 
-     * If {@link WebKit.Settings.enable_private_browsing} is `true`, new icons
+     * If {@link WebsiteDataManager.is_ephemeral} is `true`, new icons
      * won't be added to the on-disk database and no existing icons will
      * be deleted from it. Nevertheless, WebKit will still store them in
      * the in-memory cache during the current execution.
@@ -4161,14 +4166,19 @@ export namespace WebKit {
          * Asynchronously obtains a favicon image.
          * 
          * Asynchronously obtains an image of the favicon for the
-         * given page URI. It returns the cached icon if it's in the database
-         * asynchronously waiting for the icon to be read from the database.
+         * given page URI. If the icon is already in the memory cache, its image data
+         * is not read from the database again. The result is always delivered
+         * asynchronously.
          * 
          * This is an asynchronous method. When the operation is finished, callback will
          * be invoked. You can then call `webkit_favicon_database_get_favicon_finish()`
          * to get the result of the operation.
+         * 
+         * New applications should use {@link FaviconDatabase.get_page_icons} and
+         * {@link FaviconDatabase.get_page_icons_finish} instead.
          * @param page_uri URI of the page for which we want to retrieve the favicon
          * @param cancellable A {@link Gio.Cancellable} or `null`.
+         * @deprecated since 2.54
          */
         get_favicon(page_uri: string, cancellable: Gio.Cancellable | null): globalThis.Promise<Gdk.Texture>;
 
@@ -4176,15 +4186,20 @@ export namespace WebKit {
          * Asynchronously obtains a favicon image.
          * 
          * Asynchronously obtains an image of the favicon for the
-         * given page URI. It returns the cached icon if it's in the database
-         * asynchronously waiting for the icon to be read from the database.
+         * given page URI. If the icon is already in the memory cache, its image data
+         * is not read from the database again. The result is always delivered
+         * asynchronously.
          * 
          * This is an asynchronous method. When the operation is finished, callback will
          * be invoked. You can then call `webkit_favicon_database_get_favicon_finish()`
          * to get the result of the operation.
+         * 
+         * New applications should use {@link FaviconDatabase.get_page_icons} and
+         * {@link FaviconDatabase.get_page_icons_finish} instead.
          * @param page_uri URI of the page for which we want to retrieve the favicon
          * @param cancellable A {@link Gio.Cancellable} or `null`.
          * @param callback A {@link Gio.AsyncReadyCallback} to call when the request is            satisfied or `null` if you don't care about the result.
+         * @deprecated since 2.54
          */
         get_favicon(page_uri: string, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
 
@@ -4192,22 +4207,31 @@ export namespace WebKit {
          * Asynchronously obtains a favicon image.
          * 
          * Asynchronously obtains an image of the favicon for the
-         * given page URI. It returns the cached icon if it's in the database
-         * asynchronously waiting for the icon to be read from the database.
+         * given page URI. If the icon is already in the memory cache, its image data
+         * is not read from the database again. The result is always delivered
+         * asynchronously.
          * 
          * This is an asynchronous method. When the operation is finished, callback will
          * be invoked. You can then call `webkit_favicon_database_get_favicon_finish()`
          * to get the result of the operation.
+         * 
+         * New applications should use {@link FaviconDatabase.get_page_icons} and
+         * {@link FaviconDatabase.get_page_icons_finish} instead.
          * @param page_uri URI of the page for which we want to retrieve the favicon
          * @param cancellable A {@link Gio.Cancellable} or `null`.
          * @param callback A {@link Gio.AsyncReadyCallback} to call when the request is            satisfied or `null` if you don't care about the result.
+         * @deprecated since 2.54
          */
         get_favicon(page_uri: string, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<Gdk.Texture> | void;
 
         /**
          * Finishes an operation started with `webkit_favicon_database_get_favicon()`.
+         * 
+         * New applications should use {@link FaviconDatabase.get_page_icons} and
+         * {@link FaviconDatabase.get_page_icons_finish} instead.
          * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to `webkit_favicon_database_get_favicon()`
          * @returns a new favicon image, or `null` in case of error.
+         * @deprecated since 2.54
          * @throws GLib.Error
          */
         get_favicon_finish(result: Gio.AsyncResult): Gdk.Texture;
@@ -4216,8 +4240,59 @@ export namespace WebKit {
          * Obtains the URI of the favicon for the given `page_uri`.
          * @param page_uri URI of the page containing the icon
          * @returns a newly allocated URI for the favicon, or `null` if the database doesn't have a favicon for `page_uri`.
+         * @deprecated since 2.54
          */
         get_favicon_uri(page_uri: string): string;
+
+        /**
+         * Obtains the set of icons for a page.
+         * 
+         * Starts an asynchronous operation to obtain the set of icons cached in the database for a given
+         * page URI. Available icons will be read from the database and provided as a {@link ImageList}
+         * that can be retrieved using `webkit_favicon_database_get_page_icons_finish` in the completion
+         * `callback`.
+         * @param page_uri URI of the page to get icons for
+         * @param cancellable A {@link Gio.Cancellable} or `null`
+         * @since 2.54
+         */
+        get_page_icons(page_uri: string, cancellable: Gio.Cancellable | null): globalThis.Promise<ImageList>;
+
+        /**
+         * Obtains the set of icons for a page.
+         * 
+         * Starts an asynchronous operation to obtain the set of icons cached in the database for a given
+         * page URI. Available icons will be read from the database and provided as a {@link ImageList}
+         * that can be retrieved using `webkit_favicon_database_get_page_icons_finish` in the completion
+         * `callback`.
+         * @param page_uri URI of the page to get icons for
+         * @param cancellable A {@link Gio.Cancellable} or `null`
+         * @param callback A {@link Gio.AsyncReadyCallback} to invoke when the request    is satisfied or `null` to discard the result.
+         * @since 2.54
+         */
+        get_page_icons(page_uri: string, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
+
+        /**
+         * Obtains the set of icons for a page.
+         * 
+         * Starts an asynchronous operation to obtain the set of icons cached in the database for a given
+         * page URI. Available icons will be read from the database and provided as a {@link ImageList}
+         * that can be retrieved using `webkit_favicon_database_get_page_icons_finish` in the completion
+         * `callback`.
+         * @param page_uri URI of the page to get icons for
+         * @param cancellable A {@link Gio.Cancellable} or `null`
+         * @param callback A {@link Gio.AsyncReadyCallback} to invoke when the request    is satisfied or `null` to discard the result.
+         * @since 2.54
+         */
+        get_page_icons(page_uri: string, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<ImageList> | void;
+
+        /**
+         * Finishes an operation started with `webkit_favicon_database_get_page_icons`.
+         * @param result A {@link Gio.AsyncResult} obtained from the {@link Gio.AsyncReadyCallback} passed to `webkit_favicon_database_get_page_icons`.
+         * @returns the set of icons for the page, or `null` in case of error.
+         * @since 2.54
+         * @throws GLib.Error
+         */
+        get_page_icons_finish(result: Gio.AsyncResult): ImageList;
     }
 
 
@@ -4249,8 +4324,8 @@ export namespace WebKit {
      * file type, WebKit will need to show a dialog to choose one or
      * more files to be uploaded to the server along with the rest of the
      * form data. For that to happen in a general way, instead of just
-     * opening a {@link Gtk.FileChooserDialog} (which might be not desirable in
-     * some cases, which could prefer to use their own file chooser
+     * opening a {@link Gtk.FileChooserDialog} (which might not be desirable for
+     * applications that prefer to use their own file chooser
      * dialog), WebKit will fire the {@link WebKit.WebView.SignalSignatures.run_file_chooser | WebKit.WebView::run-file-chooser}
      * signal with a {@link WebKit.FileChooserRequest} object, which will allow
      * the client application to specify the files to be selected, to
@@ -4313,7 +4388,7 @@ export namespace WebKit {
 
         /**
          * A `null`-terminated array of strings containing the list of
-         * selected files associated to the current request. See
+         * selected files associated with the current request. See
          * `webkit_file_chooser_request_get_selected_files()` for more details.
          * @read-only
          */
@@ -4321,7 +4396,7 @@ export namespace WebKit {
 
         /**
          * A `null`-terminated array of strings containing the list of
-         * selected files associated to the current request. See
+         * selected files associated with the current request. See
          * `webkit_file_chooser_request_get_selected_files()` for more details.
          * @read-only
          */
@@ -4386,14 +4461,14 @@ export namespace WebKit {
          * 
          * See `webkit_file_chooser_request_get_mime_types()` if you are
          * interested in getting the list of accepted MIME types.
-         * @returns a {@link Gtk.FileFilter} if a list of accepted MIME types is defined or `null` otherwise. The returned object is owned by WebKit should not be modified or freed.
+         * @returns a {@link Gtk.FileFilter} if a list of accepted MIME types is defined or `null` otherwise. The returned object is owned by WebKit and should not be modified or freed.
          */
         get_mime_types_filter(): Gtk.FileFilter;
 
         /**
          * Whether the file chooser should allow selecting multiple files.
          * 
-         * Determine whether the file chooser associated to this
+         * Determine whether the file chooser associated with this
          * {@link WebKit.FileChooserRequest} should allow selecting multiple files,
          * which depends on the HTML input element having a 'multiple'
          * attribute defined.
@@ -4402,12 +4477,12 @@ export namespace WebKit {
         get_select_multiple(): boolean;
 
         /**
-         * Get the list of selected files associated to the request.
+         * Get the list of selected files associated with the request.
          * 
-         * Get the list of selected files currently associated to the
+         * Get the list of selected files currently associated with the
          * request. Initially, the return value of this method contains any
          * files selected in previous file chooser requests for this HTML
-         * input element. Once webkit_file_chooser_request_select_files, the
+         * input element. Once `webkit_file_chooser_request_select_files()` has been called, the
          * value will reflect whatever files are given.
          * 
          * This function should normally be called only before presenting the
@@ -4478,14 +4553,14 @@ export namespace WebKit {
      * Controls text search in a {@link WebKit.WebView}.
      * 
      * A {@link WebKit.FindController} is used to search text in a {@link WebKit.WebView}. You
-     * can get a {@link WebKit.WebView}<!-- -->'s {@link WebKit.FindController} with
+     * can get a {@link WebKit.WebView}'s {@link WebKit.FindController} with
      * `webkit_web_view_get_find_controller()`, and later use it to search
      * for text using `webkit_find_controller_search()`, or get the
      * number of matches using `webkit_find_controller_count_matches()`. The
      * operations are asynchronous and trigger signals when ready, such as
      * {@link WebKit.FindController.SignalSignatures.found_text | WebKit.FindController::found-text},
      * {@link WebKit.FindController.SignalSignatures.failed_to_find_text | WebKit.FindController::failed-to-find-text} or
-     * {@link WebKit.FindController.SignalSignatures.counted_matches | WebKit.FindController::counted-matches}<!-- -->.
+     * {@link WebKit.FindController.SignalSignatures.counted_matches | WebKit.FindController::counted-matches}.
      * @gir-type Class
      */
     class FindController extends GObject.Object {
@@ -4521,13 +4596,13 @@ export namespace WebKit {
         get text(): string;
 
         /**
-         * The {@link WebKit.WebView} this controller is associated to.
+         * The {@link WebKit.WebView} this controller is associated with.
          * @construct-only
          */
         get web_view(): WebView;
 
         /**
-         * The {@link WebKit.WebView} this controller is associated to.
+         * The {@link WebKit.WebView} this controller is associated with.
          * @construct-only
          */
         get webView(): WebView;
@@ -4602,7 +4677,7 @@ export namespace WebKit {
         get_search_text(): string;
 
         /**
-         * Gets the {@link WebKit.WebView} this find controller is associated to.
+         * Gets the {@link WebKit.WebView} this find controller is associated with.
          * 
          * Do
          * not dereference the returned instance as it belongs to the
@@ -4717,10 +4792,10 @@ export namespace WebKit {
 
         // Methods
         /**
-         * Get lists of the text fields contained in the form associated to `request`.
+         * Get lists of the text fields contained in the form associated with `request`.
          * 
          * Get lists with the names and values of the text fields contained in
-         * the form associated to `request`. Note that names and values may be
+         * the form associated with `request`. Note that names and values may be
          * `null`.
          * 
          * If this function returns `false`, then both `field_names` and
@@ -5190,6 +5265,267 @@ export namespace WebKit {
     }
 
 
+    namespace Image {
+        // Signal signatures
+        interface SignalSignatures extends GObject.Object.SignalSignatures {
+            "notify::height": (pspec: GObject.ParamSpec) => void;
+            "notify::stride": (pspec: GObject.ParamSpec) => void;
+            "notify::width": (pspec: GObject.ParamSpec) => void;
+        }
+
+        // Constructor properties interface
+        interface ConstructorProps extends GObject.Object.ConstructorProps, Gio.Icon.ConstructorProps, Gio.LoadableIcon.ConstructorProps {
+            height: number;
+            stride: number;
+            width: number;
+        }
+    }
+
+    /**
+     * @gir-type Class
+     */
+    class Image extends GObject.Object implements Gio.Icon, Gio.LoadableIcon {
+        static $gtype: GObject.GType<Image>;
+
+        // Properties
+        /**
+         * The image height in pixels.
+         * @since 2.52
+         * @construct-only
+         * @default 1
+         */
+        get height(): number;
+
+        /**
+         * The image stride, in bytes. This value indicates the amount of
+         * memory occupied by each row of pixels in the image. Note that
+         * the stride may be larger than the image width multiplied by the
+         * amount of bytes used to represent each pixel.
+         * @since 2.52
+         * @construct-only
+         * @default 4
+         */
+        get stride(): number;
+
+        /**
+         * The image width in pixels.
+         * @since 2.52
+         * @construct-only
+         * @default 1
+         */
+        get width(): number;
+
+        /**
+         * Compile-time signal type information.
+         *
+         * This instance property is generated only for TypeScript type checking.
+         * It is not defined at runtime and should not be accessed in JS code.
+         * @internal
+         */
+        $signals: Image.SignalSignatures;
+
+        // Constructors
+        constructor(properties?: Partial<Image.ConstructorProps>, ...args: any[]);
+
+        _init(...args: any[]): void;
+
+        // Signals
+        /** @signal */
+        connect<K extends keyof Image.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, Image.SignalSignatures[K]>): number;
+
+        /** @signal */
+        connect_after<K extends keyof Image.SignalSignatures>(signal: K, callback: GObject.SignalCallback<this, Image.SignalSignatures[K]>): number;
+
+        /** @signal */
+        emit<K extends keyof Image.SignalSignatures>(signal: K, ...args: GObject.GjsParameters<Image.SignalSignatures[K]>): void;
+
+        // Methods
+        /**
+         * Get the `image` pixel data as an array of bytes.
+         * 
+         * The pixel format for the returned byte buffer is 32-bit per pixel
+         * with 8-bit premultiplied alpha, in the preferred byte order for
+         * the architecture.
+         * @returns a {@link GLib.Bytes}
+         * @since 2.52
+         */
+        as_bytes(): GLib.Bytes;
+
+        /**
+         * Get the `image` height in pixels.
+         * @returns the image height
+         * @since 2.52
+         */
+        get_height(): number;
+
+        /**
+         * Get the `image` stride.
+         * @returns the image stride
+         * @since 2.52
+         */
+        get_stride(): number;
+
+        /**
+         * Get the `image` width in pixels.
+         * @returns the image width
+         * @since 2.52
+         */
+        get_width(): number;
+
+        /**
+         * Checks if two icons are equal.
+         * @param icon2 pointer to the second {@link Gio.Icon}.
+         * @returns `true` if `icon1` is equal to `icon2`. `false` otherwise.
+         */
+        equal(icon2: Gio.Icon | null): boolean;
+
+        /**
+         * Gets a hash for an icon.
+         * @returns a `guint` containing a hash for the `icon`, suitable for   use in a {@link GLib.HashTable} or similar data structure.
+         */
+        hash(): number;
+
+        /**
+         * Serializes a {@link Gio.Icon} into a {@link GLib.Variant}. An equivalent {@link Gio.Icon} can be retrieved
+         * back by calling `g_icon_deserialize()` on the returned value.
+         * As serialization will avoid using raw icon data when possible, it only
+         * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
+         * (as opposed to over the network), and within the same file system namespace.
+         * @returns a {@link GLib.Variant}, or `null` when serialization fails. The {@link GLib.Variant} will not be floating.
+         * @since 2.38
+         */
+        serialize(): GLib.Variant | null;
+
+        /**
+         * Generates a textual representation of `icon` that can be used for
+         * serialization such as when passing `icon` to a different process or
+         * saving it to persistent storage. Use `g_icon_new_for_string()` to
+         * get `icon` back from the returned string.
+         * 
+         * The encoding of the returned string is proprietary to {@link Gio.Icon} except
+         * in the following two cases
+         * 
+         * - If `icon` is a {@link Gio.FileIcon}, the returned string is a native path
+         *   (such as `/path/to/my icon.png`) without escaping
+         *   if the {@link Gio.File} for `icon` is a native file.  If the file is not
+         *   native, the returned string is the result of `g_file_get_uri()`
+         *   (such as `sftp://path/to/my%20icon.png`).
+         * 
+         * - If `icon` is a {@link Gio.ThemedIcon} with exactly one name and no fallbacks,
+         *   the encoding is simply the name (such as `network-server`).
+         * @returns An allocated NUL-terminated UTF8 string or `null` if `icon` can't be serialized. Use `g_free()` to free.
+         * @since 2.20
+         */
+        to_string(): string | null;
+
+        /**
+         * Checks if two icons are equal.
+         * @param icon2 pointer to the second {@link Gio.Icon}.
+         * @virtual
+         */
+        vfunc_equal(icon2: Gio.Icon | null): boolean;
+
+        /**
+         * Gets a hash for an icon.
+         * @virtual
+         */
+        vfunc_hash(): number;
+
+        /**
+         * Serializes a {@link Gio.Icon} into a {@link GLib.Variant}. An equivalent {@link Gio.Icon} can be retrieved
+         * back by calling `g_icon_deserialize()` on the returned value.
+         * As serialization will avoid using raw icon data when possible, it only
+         * makes sense to transfer the {@link GLib.Variant} between processes on the same machine,
+         * (as opposed to over the network), and within the same file system namespace.
+         * @since 2.38
+         * @virtual
+         */
+        vfunc_serialize(): GLib.Variant | null;
+
+        /**
+         * Serializes the `icon` into string tokens.
+         * This is can be invoked when `g_icon_new_for_string()` is called.
+         * @since 2.20
+         * @virtual
+         */
+        vfunc_to_tokens(): [boolean, string[], number];
+
+        /**
+         * Loads a loadable icon. For the asynchronous version of this function,
+         * see `g_loadable_icon_load_async()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @returns a {@link Gio.InputStream} to read the icon from.
+         * @throws GLib.Error
+         */
+        load(size: number, cancellable: Gio.Cancellable | null): [Gio.InputStream, string];
+
+        /**
+         * Loads an icon asynchronously. To finish this function, see
+         * `g_loadable_icon_load_finish()`. For the synchronous, blocking
+         * version of this function, see `g_loadable_icon_load()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         */
+        load_async(size: number, cancellable: Gio.Cancellable | null): globalThis.Promise<[Gio.InputStream, string]>;
+
+        /**
+         * Loads an icon asynchronously. To finish this function, see
+         * `g_loadable_icon_load_finish()`. For the synchronous, blocking
+         * version of this function, see `g_loadable_icon_load()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @param callback a {@link Gio.AsyncReadyCallback}   to call when the request is satisfied
+         */
+        load_async(size: number, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
+
+        /**
+         * Loads an icon asynchronously. To finish this function, see
+         * `g_loadable_icon_load_finish()`. For the synchronous, blocking
+         * version of this function, see `g_loadable_icon_load()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @param callback a {@link Gio.AsyncReadyCallback}   to call when the request is satisfied
+         */
+        load_async(size: number, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<[Gio.InputStream, string]> | void;
+
+        /**
+         * Finishes an asynchronous icon load started in `g_loadable_icon_load_async()`.
+         * @param res a {@link Gio.AsyncResult}.
+         * @returns a {@link Gio.InputStream} to read the icon from.
+         * @throws GLib.Error
+         */
+        load_finish(res: Gio.AsyncResult): [Gio.InputStream, string];
+
+        /**
+         * Loads a loadable icon. For the asynchronous version of this function,
+         * see `g_loadable_icon_load_async()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @virtual
+         */
+        vfunc_load(size: number, cancellable: Gio.Cancellable | null): [Gio.InputStream, string];
+
+        /**
+         * Loads an icon asynchronously. To finish this function, see
+         * `g_loadable_icon_load_finish()`. For the synchronous, blocking
+         * version of this function, see `g_loadable_icon_load()`.
+         * @param size an integer.
+         * @param cancellable optional {@link Gio.Cancellable} object, `null` to ignore.
+         * @param callback a {@link Gio.AsyncReadyCallback}   to call when the request is satisfied
+         * @virtual
+         */
+        vfunc_load_async(size: number, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
+
+        /**
+         * Finishes an asynchronous icon load started in `g_loadable_icon_load_async()`.
+         * @param res a {@link Gio.AsyncResult}.
+         * @virtual
+         */
+        vfunc_load_finish(res: Gio.AsyncResult): [Gio.InputStream, string];
+    }
+
+
     namespace InputMethodContext {
         // Signal signatures
         interface SignalSignatures extends GObject.Object.SignalSignatures {
@@ -5739,7 +6075,7 @@ export namespace WebKit {
         set dataDirectory(val: string);
 
         /**
-         * Whether to create an ephermeral {@link WebKit.WebsiteDataManager} for the session.
+         * Whether to create an ephemeral {@link WebKit.WebsiteDataManager} for the session.
          * @since 2.40
          * @construct-only
          * @default false
@@ -5747,7 +6083,7 @@ export namespace WebKit {
         get is_ephemeral(): boolean;
 
         /**
-         * Whether to create an ephermeral {@link WebKit.WebsiteDataManager} for the session.
+         * Whether to create an ephemeral {@link WebKit.WebsiteDataManager} for the session.
          * @since 2.40
          * @construct-only
          * @default false
@@ -5811,7 +6147,7 @@ export namespace WebKit {
 
         // Methods
         /**
-         * Ignore further TLS errors on the `host` for the certificate present in `info`.
+         * Ignore further TLS errors on the `host` for `certificate`.
          * 
          * If `host` is an IPv6 address, it should not be surrounded by brackets. This
          * expectation matches `g_uri_get_host()`.
@@ -5824,7 +6160,7 @@ export namespace WebKit {
         /**
          * Requests downloading of the specified URI string.
          * 
-         * The download operation will not be associated to any {@link WebKit.WebView},
+         * The download operation will not be associated with any {@link WebKit.WebView},
          * if you are interested in starting a download from a particular {@link WebKit.WebView} use
          * `webkit_web_view_download_uri()` instead.
          * @param uri the URI to download
@@ -5891,7 +6227,7 @@ export namespace WebKit {
         /**
          * Finish an asynchronous operation started with `webkit_network_session_get_itp_summary()`.
          * @param result a {@link Gio.AsyncResult}
-         * @returns a {@link GLib.List} of {@link WebKit.ITPThirdParty}.    You must free the {@link GLib.List} with `g_list_free()` and unref the {@link WebKit.ITPThirdParty}<!-- -->s with    `webkit_itp_third_party_unref()` when you're done with them.
+         * @returns a {@link GLib.List} of {@link WebKit.ITPThirdParty}.    You must free the {@link GLib.List} with `g_list_free()` and unref the {@link WebKit.ITPThirdParty} objects with    `webkit_itp_third_party_unref()` when you're done with them.
          * @since 2.40
          * @throws GLib.Error
          */
@@ -5934,7 +6270,7 @@ export namespace WebKit {
          * When ITP is enabled resource load statistics
          * are collected and used to decide whether to allow or block third-party cookies and prevent user tracking.
          * Note that while ITP is enabled the accept policy {@link WebKit.CookieAcceptPolicy.NO_THIRD_PARTY} is ignored and
-         * {@link WebKit.CookieAcceptPolicy.ALWAYS} is used instead. See also `webkit_cookie_session_set_accept_policy()`.
+         * {@link WebKit.CookieAcceptPolicy.ALWAYS} is used instead. See also `webkit_cookie_manager_set_accept_policy()`.
          * @param enabled value to set
          * @since 2.40
          */
@@ -5944,7 +6280,7 @@ export namespace WebKit {
          * Enable or disable persistent credential storage.
          * 
          * When enabled, which is the default for
-         * non-ephemeral sessions, the network process will try to read and write HTTP authentiacation
+         * non-ephemeral sessions, the network process will try to read and write HTTP authentication
          * credentials from persistent storage.
          * @param enabled value to set
          * @since 2.40
@@ -5952,7 +6288,7 @@ export namespace WebKit {
         set_persistent_credential_storage_enabled(enabled: boolean): void;
 
         /**
-         * Set the network proxy settings to be used by connections started in `session` session.
+         * Set the network proxy settings to be used by connections started in `session`.
          * 
          * By default {@link WebKit.NetworkProxyMode.DEFAULT} is used, which means that the
          * system settings will be used (g_proxy_resolver_get_default()).
@@ -6216,7 +6552,7 @@ export namespace WebKit {
      * 
      * When a select element in a {@link WebKit.WebView} needs to display a dropdown menu, the signal
      * {@link WebKit.WebView.SignalSignatures.show_option_menu | WebKit.WebView::show-option-menu} is emitted, providing a WebKitOptionMenu with the
-     * {@link WebKit.OptionMenuItem}<!-- -->s that should be displayed.
+     * {@link WebKit.OptionMenuItem} objects that should be displayed.
      * @gir-type Class
      * @since 2.18
      */
@@ -6291,7 +6627,7 @@ export namespace WebKit {
 
         /**
          * Gets the length of the `menu`.
-         * @returns the number of {@link WebKit.OptionMenuItem}<!-- -->s in `menu`
+         * @returns the number of {@link WebKit.OptionMenuItem} objects in `menu`
          * @since 2.18
          */
         get_n_items(): number;
@@ -6301,7 +6637,7 @@ export namespace WebKit {
          * 
          * Selecting an item changes the
          * text shown by the combo button, but it doesn't change the value of the element. You need to
-         * explicitly activate the item with `webkit_option_menu_select_item()` or close the menu with
+         * explicitly activate the item with `webkit_option_menu_activate_item()` or close the menu with
          * `webkit_option_menu_close()` in which case the currently selected item will be activated.
          * @param index the index of the item
          * @since 2.18
@@ -6437,7 +6773,7 @@ export namespace WebKit {
         download(): void;
 
         /**
-         * {@link WebKit.ResponsePolicyDecision}, this would cancel the request.
+         * Ignore the action which triggered this decision.
          * 
          * Ignore the action which triggered this decision. For instance, for a
          * {@link WebKit.ResponsePolicyDecision}, this would cancel the request.
@@ -6457,7 +6793,7 @@ export namespace WebKit {
          * in the origin associated with the accepted navigation action.
          * 
          * For example, a navigation decision to a video sharing website may
-         * be accepted under the priviso no movies are allowed to autoplay. The
+         * be accepted under the proviso no movies are allowed to autoplay. The
          * autoplay policy in this case would be set in the `policies`.
          * @param policies a {@link WebKit.WebsitePolicies}
          * @since 2.30
@@ -6625,8 +6961,8 @@ export namespace WebKit {
          * is returned and the print operation starts. In this case, the {@link WebKit.PrintOperation.SignalSignatures.finished | WebKit.PrintOperation::finished}
          * signal is emitted when the operation finishes. If an error occurs while printing, the signal
          * {@link WebKit.PrintOperation.SignalSignatures.failed | WebKit.PrintOperation::failed} is emitted before {@link WebKit.PrintOperation.SignalSignatures.finished | WebKit.PrintOperation::finished}.
-         * If the print dialog is not cancelled current print settings and page setup of `print_operation`
-         * are updated with options selected by the user when Print button is pressed in print dialog.
+         * If the print dialog is not cancelled, the current print settings and page setup of `print_operation`
+         * are updated with the options selected by the user when the Print button is pressed in the print dialog.
          * You can get the updated print settings and page setup by calling
          * `webkit_print_operation_get_print_settings()` and `webkit_print_operation_get_page_setup()`
          * after this method.
@@ -6725,7 +7061,7 @@ export namespace WebKit {
         /**
          * Return the {@link WebKit.URIRequest} associated with the response decision.
          * 
-         * Modifications to the returned object are <emphasis>not</emphasis> taken
+         * Modifications to the returned object are *not* taken
          * into account when the request is sent over the network, and is intended
          * only to aid in evaluating whether a response decision should be taken or
          * not. To modify requests before they are sent over the network the
@@ -6742,7 +7078,7 @@ export namespace WebKit {
 
         /**
          * Gets whether the request is the main frame main resource
-         * @returns `true` if the request is the main frame main resouce or `false` otherwise
+         * @returns `true` if the request is the main frame main resource or `false` otherwise
          * @since 2.40
          */
         is_main_frame_main_resource(): boolean;
@@ -7102,7 +7438,7 @@ export namespace WebKit {
     }
 
     /**
-     * Control the behaviour of a {@link WebKit.WebView}.
+     * Control the behavior of a {@link WebKit.WebView}.
      * 
      * {@link WebKit.Settings} can be applied to a {@link WebKit.WebView} to control text charset,
      * color, font sizes, printing mode, script support, loading of images and various
@@ -7124,7 +7460,7 @@ export namespace WebKit {
          * Whether file access is allowed from file URLs. By default, when
          * something is loaded in a {@link WebKit.WebView} using a file URI, cross
          * origin requests to other file resources are not allowed. This
-         * setting allows you to change that behaviour, so that it would be
+         * setting allows you to change that behavior, so that it would be
          * possible to do a XMLHttpRequest of a local file, for example.
          * @since 2.10
          * @default false
@@ -7136,7 +7472,7 @@ export namespace WebKit {
          * Whether file access is allowed from file URLs. By default, when
          * something is loaded in a {@link WebKit.WebView} using a file URI, cross
          * origin requests to other file resources are not allowed. This
-         * setting allows you to change that behaviour, so that it would be
+         * setting allows you to change that behavior, so that it would be
          * possible to do a XMLHttpRequest of a local file, for example.
          * @since 2.10
          * @default false
@@ -7147,7 +7483,7 @@ export namespace WebKit {
         /**
          * Determine whether it's allowed to create and run modal dialogs
          * from a {@link WebKit.WebView} through JavaScript with
-         * <function>window.showModalDialog</function>. If it's set to
+         * `window.showModalDialog`. If it's set to
          * `false`, the associated {@link WebKit.WebView} won't be able to create
          * new modal dialogs, so not even the {@link WebKit.WebView.SignalSignatures.create | WebKit.WebView::create}
          * signal will be emitted.
@@ -7159,7 +7495,7 @@ export namespace WebKit {
         /**
          * Determine whether it's allowed to create and run modal dialogs
          * from a {@link WebKit.WebView} through JavaScript with
-         * <function>window.showModalDialog</function>. If it's set to
+         * `window.showModalDialog`. If it's set to
          * `false`, the associated {@link WebKit.WebView} won't be able to create
          * new modal dialogs, so not even the {@link WebKit.WebView.SignalSignatures.create | WebKit.WebView::create}
          * signal will be emitted.
@@ -7172,7 +7508,7 @@ export namespace WebKit {
          * Whether or not the top frame is allowed to navigate to data URLs. It is disabled by default
          * due to the risk it poses when loading untrusted URLs, with data URLs being used in scamming
          * and phishing attacks. In contrast, a scenario where it could be enabled could be an app that
-         * embeds a WebView and you have control of the pages being show instead of a generic browser.
+         * embeds a WebView and you have control of the pages being shown instead of a generic browser.
          * @since 2.28
          * @default false
          */
@@ -7183,7 +7519,7 @@ export namespace WebKit {
          * Whether or not the top frame is allowed to navigate to data URLs. It is disabled by default
          * due to the risk it poses when loading untrusted URLs, with data URLs being used in scamming
          * and phishing attacks. In contrast, a scenario where it could be enabled could be an app that
-         * embeds a WebView and you have control of the pages being show instead of a generic browser.
+         * embeds a WebView and you have control of the pages being shown instead of a generic browser.
          * @since 2.28
          * @default false
          */
@@ -7195,7 +7531,7 @@ export namespace WebKit {
          * should be allowed to access content from any origin.  By default, when
          * something is loaded in a {@link WebKit.WebView} using a file scheme URL,
          * access to the local file system and arbitrary local storage is not
-         * allowed. This setting allows you to change that behaviour, so that
+         * allowed. This setting allows you to change that behavior, so that
          * it would be possible to use local storage, for example.
          * @since 2.14
          * @default false
@@ -7208,7 +7544,7 @@ export namespace WebKit {
          * should be allowed to access content from any origin.  By default, when
          * something is loaded in a {@link WebKit.WebView} using a file scheme URL,
          * access to the local file system and arbitrary local storage is not
-         * allowed. This setting allows you to change that behaviour, so that
+         * allowed. This setting allows you to change that behavior, so that
          * it would be possible to use local storage, for example.
          * @since 2.14
          * @default false
@@ -7794,9 +8130,9 @@ export namespace WebKit {
          * Whether to enable Spatial Navigation. This feature consists in the ability
          * to navigate between focusable elements in a Web page, such as hyperlinks
          * and form controls, by using Left, Right, Up and Down arrow keys.
-         * For example, if an user presses the Right key, heuristics determine whether
+         * For example, if a user presses the Right key, heuristics determine whether
          * there is an element they might be trying to reach towards the right, and if
-         * there are multiple elements, which element they probably wants.
+         * there are multiple elements, which element they probably want.
          * @since 2.4
          * @default false
          */
@@ -7807,9 +8143,9 @@ export namespace WebKit {
          * Whether to enable Spatial Navigation. This feature consists in the ability
          * to navigate between focusable elements in a Web page, such as hyperlinks
          * and form controls, by using Left, Right, Up and Down arrow keys.
-         * For example, if an user presses the Right key, heuristics determine whether
+         * For example, if a user presses the Right key, heuristics determine whether
          * there is an element they might be trying to reach towards the right, and if
-         * there are multiple elements, which element they probably wants.
+         * there are multiple elements, which element they probably want.
          * @since 2.4
          * @default false
          */
@@ -8023,7 +8359,7 @@ export namespace WebKit {
         set mathFontFamily(val: string | null);
 
         /**
-         * List of media content types requiring hardware support, split by semicolons (:).
+         * List of media content types requiring hardware support, split by colons (:).
          * For example: 'video/webm; codecs="vp*":video/mp4; codecs="avc*":video/&ast; codecs="av1*"'.
          * @since 2.30
          * @default null
@@ -8032,7 +8368,7 @@ export namespace WebKit {
         set media_content_types_requiring_hardware_support(val: string);
 
         /**
-         * List of media content types requiring hardware support, split by semicolons (:).
+         * List of media content types requiring hardware support, split by colons (:).
          * For example: 'video/webm; codecs="vp*":video/mp4; codecs="avc*":video/&ast; codecs="av1*"'.
          * @since 2.30
          * @default null
@@ -8199,8 +8535,8 @@ export namespace WebKit {
         /**
          * Allow customization of the WebRTC UDP ports range.
          * 
-         * In some constrained environments where a firewall blocks UDP network traffic excepted on a
-         * specific port range, this settings can be used to give hints to the WebRTC backend regarding
+         * In some constrained environments where a firewall blocks UDP network traffic except on a
+         * specific port range, this setting can be used to give hints to the WebRTC backend regarding
          * which ports to allocate. The format is min-port:max-port, so for instance 20000:30000. The
          * default empty string value means the OS will use no hints from the WebRTC backend. Using 0
          * for one of the values is allowed and means the value is unspecified.
@@ -8213,8 +8549,8 @@ export namespace WebKit {
         /**
          * Allow customization of the WebRTC UDP ports range.
          * 
-         * In some constrained environments where a firewall blocks UDP network traffic excepted on a
-         * specific port range, this settings can be used to give hints to the WebRTC backend regarding
+         * In some constrained environments where a firewall blocks UDP network traffic except on a
+         * specific port range, this setting can be used to give hints to the WebRTC backend regarding
          * which ports to allocate. The format is min-port:max-port, so for instance 20000:30000. The
          * default empty string value means the OS will use no hints from the WebRTC backend. Using 0
          * for one of the values is allowed and means the value is unspecified.
@@ -8311,7 +8647,7 @@ export namespace WebKit {
          * Gets the list of available development WebKit features.
          * 
          * The returned features are a subset of those returned by
-         * {@link Settings.get_all_features}, and includes those which
+         * {@link Settings.get_all_features}, and include those which
          * web and WebKit developers might find useful, but in general should
          * *not* be exposed to end users; see {@link FeatureStatus} for
          * more details.
@@ -8323,7 +8659,7 @@ export namespace WebKit {
          * Gets the list of available experimental WebKit features.
          * 
          * The returned features are a subset of those returned by
-         * {@link Settings.get_all_features}, and includes those which
+         * {@link Settings.get_all_features}, and include those which
          * certain applications may want to expose to end users; see
          * {@link FeatureStatus} for more details.
          * @since 2.42
@@ -8332,7 +8668,7 @@ export namespace WebKit {
 
         // Methods
         /**
-         * Reads the contents of the given `group_name` from the given `key_file` and apply the value of
+         * Reads the contents of the given `group_name` from the given `key_file` and applies the value of
          * each key/value to the corresponding property on the `settings`.
          * 
          * Value types have to match with the corresponding setting property type and the group keys have to
@@ -8363,7 +8699,7 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.Settings.allow_top_navigation_to_data_urls} property.
-         * @returns `true` If navigation to data URLs from the top frame is allowed or `false`\ otherwise.
+         * @returns `true` If navigation to data URLs from the top frame is allowed or `false` otherwise.
          * @since 2.28
          */
         get_allow_top_navigation_to_data_urls(): boolean;
@@ -8433,7 +8769,7 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.Settings.enable_back_forward_navigation_gestures} property.
-         * @returns `true` if horizontal swipe gesture will trigger back-forward navigaiton or `false` otherwise.
+         * @returns `true` if horizontal swipe gesture will trigger back-forward navigation or `false` otherwise.
          * @since 2.24
          */
         get_enable_back_forward_navigation_gestures(): boolean;
@@ -8546,7 +8882,7 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.Settings.enable_page_cache} property.
-         * @returns `true` if page cache enabled or `false` otherwise.
+         * @returns `true` if page cache is enabled or `false` otherwise.
          */
         get_enable_page_cache(): boolean;
 
@@ -8615,7 +8951,7 @@ export namespace WebKit {
 
         /**
          * Gets whether a feature is enabled.
-         * @param feature the feature to toggle.
+         * @param feature the feature to query.
          * @returns Whether the feature is enabled.
          * @since 2.42
          */
@@ -8636,7 +8972,7 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.Settings.javascript_can_open_windows_automatically} property.
-         * @returns `true` If JavaScript can open window automatically or `false` otherwise.
+         * @returns `true` If JavaScript can open windows automatically or `false` otherwise.
          */
         get_javascript_can_open_windows_automatically(): boolean;
 
@@ -8649,7 +8985,8 @@ export namespace WebKit {
 
         /**
          * Gets the {@link WebKit.Settings.math_font_family} property.
-         * @returns The default font family used to display content marked with math font. Since 2.52
+         * @returns The default font family used to display content marked with math font.
+         * @since 2.52
          */
         get_math_font_family(): string | null;
 
@@ -8668,7 +9005,7 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.Settings.media_playback_requires_user_gesture} property.
-         * @returns `true` If an user gesture is needed to play or load media    or `false` if no user gesture is needed.
+         * @returns `true` If a user gesture is needed to play or load media    or `false` if no user gesture is needed.
          */
         get_media_playback_requires_user_gesture(): boolean;
 
@@ -8912,7 +9249,7 @@ export namespace WebKit {
         /**
          * Set the {@link WebKit.Settings.enable_mock_capture_devices} property.
          * @param enabled Value to be set
-         * @since 2.4
+         * @since 2.24
          */
         set_enable_mock_capture_devices(enabled: boolean): void;
 
@@ -9035,15 +9372,14 @@ export namespace WebKit {
 
         /**
          * Set the {@link WebKit.Settings.math_font_family} property.
-         * 
-         * Since 2.52
          * @param math_font_family the new default math font family
+         * @since 2.52
          */
         set_math_font_family(math_font_family: string | null): void;
 
         /**
          * Set the {@link WebKit.Settings.media_content_types_requiring_hardware_support} property.
-         * @param content_types list of media content types requiring hardware support split by semicolons (:) or `null` to use the default value.
+         * @param content_types list of media content types requiring hardware support split by colons (:) or `null` to use the default value.
          * @since 2.30
          */
         set_media_content_types_requiring_hardware_support(content_types: string | null): void;
@@ -9106,10 +9442,10 @@ export namespace WebKit {
          * Set the {@link WebKit.Settings.user_agent} property by appending the application details.
          * 
          * Set the {@link WebKit.Settings.user_agent} property by appending the application details to the default user
-         * agent. If no application name or version is given, the default user agent used will be used. If only
-         * the version is given, the default engine version is used with the given application name.
+         * agent. If no application name is given, the default user agent will be used and `application_version`
+         * is ignored. If only the name is given, the default engine version is used with the given application name.
          * @param application_name The application name used for the user agent or `null` to use the default user agent.
-         * @param application_version The application version for the user agent or `null` to user the default version.
+         * @param application_version The application version for the user agent or `null` to use the default version.
          */
         set_user_agent_with_application_details(application_name: string | null, application_version: string | null): void;
 
@@ -9477,10 +9813,10 @@ export namespace WebKit {
 
         /**
          * Get the request body.
-         * @returns (nullable): the body of the `request`.
+         * @returns the body of the `request`.
          * @since 2.40
          */
-        get_http_body(): Gio.InputStream;
+        get_http_body(): Gio.InputStream | null;
 
         /**
          * Get the {@link Soup.MessageHeaders} of the request.
@@ -9545,11 +9881,11 @@ export namespace WebKit {
      * a {@link WebKit.URISchemeRequestCallback}. After that, when a URI response
      * is made with that particular scheme, your callback will be
      * called. There you will be able to provide more response parameters
-     * when the methods and properties of a {@link WebKit.URISchemeRequest} is not
+     * when the methods and properties of a {@link WebKit.URISchemeRequest} are not
      * enough.
      * 
      * When you finished setting up your {@link WebKit.URISchemeResponse}, call
-     * `webkit_uri_request_finish_with_response()` with it to return the response.
+     * `webkit_uri_scheme_request_finish_with_response()` with it to return the response.
      * @gir-type Class
      */
     class URISchemeResponse extends GObject.Object {
@@ -9723,7 +10059,7 @@ export namespace WebKit {
          * `webkit_user_content_filter_store_fetch_identifiers_finish()` to obtain the list of
          * filter identifiers.
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
-         * @param callback a {@link Gio.AsyncReadyCallback} to call when the removal is completed
+         * @param callback a {@link Gio.AsyncReadyCallback} to call when the identifiers have been fetched
          * @since 2.24
          */
         fetch_identifiers(cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
@@ -9735,7 +10071,7 @@ export namespace WebKit {
          * `webkit_user_content_filter_store_fetch_identifiers_finish()` to obtain the list of
          * filter identifiers.
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
-         * @param callback a {@link Gio.AsyncReadyCallback} to call when the removal is completed
+         * @param callback a {@link Gio.AsyncReadyCallback} to call when the identifiers have been fetched
          * @since 2.24
          */
         fetch_identifiers(cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<string[]> | void;
@@ -9861,10 +10197,10 @@ export namespace WebKit {
         remove_finish(result: Gio.AsyncResult): boolean;
 
         /**
-         * Asynchronously save a content filter from a set source rule.
+         * Asynchronously save a content filter from a source rule set.
          * 
          * Asynchronously save a content filter from a source rule set in the
-         * [WebKit content extesions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
+         * [WebKit content extensions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
          * 
          * The `identifier` can be used afterwards to refer to the filter when using
          * `webkit_user_content_filter_store_remove()` and `webkit_user_content_filter_store_load()`.
@@ -9881,10 +10217,10 @@ export namespace WebKit {
         save(identifier: string, source: GLib.Bytes | Uint8Array, cancellable: Gio.Cancellable | null): globalThis.Promise<UserContentFilter>;
 
         /**
-         * Asynchronously save a content filter from a set source rule.
+         * Asynchronously save a content filter from a source rule set.
          * 
          * Asynchronously save a content filter from a source rule set in the
-         * [WebKit content extesions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
+         * [WebKit content extensions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
          * 
          * The `identifier` can be used afterwards to refer to the filter when using
          * `webkit_user_content_filter_store_remove()` and `webkit_user_content_filter_store_load()`.
@@ -9902,10 +10238,10 @@ export namespace WebKit {
         save(identifier: string, source: GLib.Bytes | Uint8Array, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
 
         /**
-         * Asynchronously save a content filter from a set source rule.
+         * Asynchronously save a content filter from a source rule set.
          * 
          * Asynchronously save a content filter from a source rule set in the
-         * [WebKit content extesions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
+         * [WebKit content extensions JSON format](https://webkit.org/blog/3476/content-blockers-first-look/).
          * 
          * The `identifier` can be used afterwards to refer to the filter when using
          * `webkit_user_content_filter_store_remove()` and `webkit_user_content_filter_store_load()`.
@@ -9983,7 +10319,7 @@ export namespace WebKit {
         save_from_file(identifier: string, file: Gio.File, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<UserContentFilter> | void;
 
         /**
-         * Finishes and asynchronous filter save previously started with
+         * Finishes an asynchronous filter save previously started with
          * `webkit_user_content_filter_store_save_from_file()`.
          * @param result a {@link Gio.AsyncResult}
          * @returns a {@link WebKit.UserContentFilter}, or `null` if saving failed.
@@ -9999,8 +10335,8 @@ export namespace WebKit {
         interface SignalSignatures extends GObject.Object.SignalSignatures {
             /**
              * This signal is emitted when JavaScript in a web view calls
-             * <code>window.webkit.messageHandlers.<name>.postMessage()</code>, after registering
-             * <code><name></code> using
+             * `window.webkit.messageHandlers.<name>.postMessage()`, after registering
+             * `<name>` using
              * `webkit_user_content_manager_register_script_message_handler()`
              * @signal
              * @since 2.8
@@ -10010,8 +10346,8 @@ export namespace WebKit {
             "script-message-received": (value: JavaScriptCore.Value) => void;
             /**
              * This signal is emitted when JavaScript in a web view calls
-             * <code>window.webkit.messageHandlers.<name>.postMessage()</code>, after registering
-             * <code><name></code> using
+             * `window.webkit.messageHandlers.<name>.postMessage()`, after registering
+             * `<name>` using
              * `webkit_user_content_manager_register_script_message_handler_with_reply()`
              * 
              * The given `reply` can be used to send a return value with
@@ -10128,7 +10464,7 @@ export namespace WebKit {
          * 
          * ```c
          * WebKitWebView *view = webkit_web_view_new ();
-         * WebKitUserContentManager *manager = webkit_web_view_get_user_content_manager ();
+         * WebKitUserContentManager *manager = webkit_web_view_get_user_content_manager (view);
          * g_signal_connect (manager, "script-message-received::foobar",
          *                   G_CALLBACK (handle_script_message), NULL);
          * webkit_user_content_manager_register_script_message_handler (manager, "foobar", "world");
@@ -10193,9 +10529,8 @@ export namespace WebKit {
 
         /**
          * Removes a filter from the given {@link WebKit.UserContentManager}.
-         * 
-         * Since 2.24
          * @param filter A {@link WebKit.UserContentFilter}
+         * @since 2.24
          */
         remove_filter(filter: UserContentFilter): void;
 
@@ -10541,21 +10876,21 @@ export namespace WebKit {
         interface ConstructorProps extends GObject.Object.ConstructorProps {
             memory_pressure_settings: MemoryPressureSettings;
             memoryPressureSettings: MemoryPressureSettings;
-            time_zone_override: string;
-            timeZoneOverride: string;
+            time_zone_override: string | null;
+            timeZoneOverride: string | null;
         }
     }
 
     /**
-     * Manages aspects common to all {@link WebKit.WebView}<!-- -->s
+     * Manages aspects common to all {@link WebKit.WebView} objects
      * 
      * The {@link WebKit.WebContext} manages all aspects common to all
-     * {@link WebKit.WebView}<!-- -->s.
+     * {@link WebKit.WebView} objects.
      * 
      * You can define the {@link WebKit.CacheModel} with
      * `webkit_web_context_set_cache_model()`, depending on the needs of
      * your application. You can access the {@link WebKit.SecurityManager} to specify
-     * the behaviour of your application regarding security using
+     * the behavior of your application regarding security using
      * `webkit_web_context_get_security_manager()`.
      * 
      * It is also possible to change your preferred language or enable
@@ -10605,7 +10940,7 @@ export namespace WebKit {
          * @construct-only
          * @default null
          */
-        get time_zone_override(): string;
+        get time_zone_override(): string | null;
 
         /**
          * The timezone override for this web context. Setting this property provides a better
@@ -10620,7 +10955,7 @@ export namespace WebKit {
          * @construct-only
          * @default null
          */
-        get timeZoneOverride(): string;
+        get timeZoneOverride(): string | null;
 
         /**
          * Compile-time signal type information.
@@ -10709,9 +11044,9 @@ export namespace WebKit {
         get_spell_checking_enabled(): boolean;
 
         /**
-         * Get the the list of spell checking languages.
+         * Get the list of spell checking languages.
          * 
-         * Get the the list of spell checking languages associated with
+         * Get the list of spell checking languages associated with
          * `context`, or `null` if no languages have been previously set.
          * 
          * See `webkit_web_context_set_spell_checking_languages()` for more
@@ -10722,9 +11057,10 @@ export namespace WebKit {
 
         /**
          * Get the {@link WebKit.WebContext.time_zone_override} property.
+         * @returns the time zone override, or `null` if none was set.
          * @since 2.38
          */
-        get_time_zone_override(): string;
+        get_time_zone_override(): string | null;
 
         /**
          * Sets initial desktop notification permissions for the `context`.
@@ -10761,7 +11097,7 @@ export namespace WebKit {
         /**
          * Register `scheme` in `context`.
          * 
-         * Register `scheme` in `context`, so that when an URI request with `scheme` is made in the
+         * Register `scheme` in `context`, so that when a URI request with `scheme` is made in the
          * {@link WebKit.WebContext}, the {@link WebKit.URISchemeRequestCallback} registered will be called with a
          * {@link WebKit.URISchemeRequest}.
          * It is possible to handle URI scheme requests asynchronously, by calling `g_object_ref()` on the
@@ -10802,7 +11138,7 @@ export namespace WebKit {
         register_uri_scheme(scheme: string, callback: URISchemeRequestCallback): void;
 
         /**
-         * Send `message` to all web process extensions associated to `context`.
+         * Send `message` to all web process extensions associated with `context`.
          * 
          * If `message` is floating, it's consumed.
          * @param message a {@link WebKit.UserMessage}
@@ -10832,7 +11168,7 @@ export namespace WebKit {
          * Specifies a usage model for WebViews, which WebKit will use to
          * determine its caching behavior. All web views follow the cache
          * model. This cache model determines the RAM and disk space to use
-         * for caching previously viewed content .
+         * for caching previously viewed content.
          * 
          * Research indicates that users tend to browse within clusters of
          * documents that hold resources in common, and to revisit previously
@@ -11141,7 +11477,7 @@ export namespace WebKit {
 
         /**
          * Whether the {@link WebKit.WebExtension} includes rules used for content modification or blocking.
-         * See `webkit_web_extension_get_content_modification_rules()` for more details.
+         * See `webkit_web_extension_get_has_content_modification_rules()` for more details.
          * @since 2.52
          * @read-only
          * @default false
@@ -11150,7 +11486,7 @@ export namespace WebKit {
 
         /**
          * Whether the {@link WebKit.WebExtension} includes rules used for content modification or blocking.
-         * See `webkit_web_extension_get_content_modification_rules()` for more details.
+         * See `webkit_web_extension_get_has_content_modification_rules()` for more details.
          * @since 2.52
          * @read-only
          * @default false
@@ -11327,8 +11663,8 @@ export namespace WebKit {
         /**
          * Returns the extension's default action icon image for the specified size.
          * This icon serves as a default and should be used to represent the extension in contexts like action sheets or toolbars prior to
-         * the extension being loaded into an extension context. Once the extension is loaded, use the
-         * ``actionForTab:`` API to get the tab-specific icon.
+         * the extension being loaded into an extension context. Once the extension is loaded, a tab-specific
+         * icon may be used instead.
          * The returned image will be the best match for the specified size that is available in the extension's action icon set. If no matching icon is available,
          * the method will fall back to the extension's icon.
          * @param width The width to use when looking up the icon.
@@ -11358,7 +11694,7 @@ export namespace WebKit {
          * 
          * This label serves as a default and should be used to represent the extension in contexts like action sheets or toolbars prior to
          * the extension being loaded into an extension context.
-         * Once the extension is loaded, use the ``actionForTab:`` API to get the tab-specific label.
+         * Once the extension is loaded, a tab-specific label may be used instead.
          * @returns the localized display action label, or `null` if there was no display action label specified.
          * @since 2.52
          */
@@ -11404,9 +11740,7 @@ export namespace WebKit {
          * 
          * These commands should be accessible via keyboard shortcuts,
          * menu items, or other user interface elements provided
-         * by the app. The list of commands can be accessed
-         * via ``commands`` on an extension context, and
-         * invoked via ``performCommand:``.
+         * by the app.
          * @returns `TRUE` if the extension contains one or more commands that can be performed by the user.
          * @since 2.52
          */
@@ -11424,8 +11758,8 @@ export namespace WebKit {
          * Get whether the extension has script or stylesheet content
          * that can be injected into webpages.
          * 
-         * Once the extension is loaded, use the ``hasInjectedContent``
-         * property on an extension context, as the injectable content
+         * Once the extension is loaded, use
+         * `webkit_web_extension_context_get_has_injected_content()`, as the injectable content
          * can change after the extension is loaded.
          * @returns `TRUE` if the extension has content that can be injected by matching against the extension's requested match patterns.
          * @since 2.52
@@ -11437,7 +11771,7 @@ export namespace WebKit {
          * 
          * The app should provide access to this page through a
          * user interface element, which can be accessed via
-         * ``optionsPageURL`` on an extension context.
+         * `webkit_web_extension_context_get_options_page_uri()`.
          * @returns `TRUE` if the extension includes a dedicated options page where users can customize settings.
          * @since 2.52
          */
@@ -11449,8 +11783,8 @@ export namespace WebKit {
          * 
          * The app should prompt the user for permission to use
          * the extension's new tab page as the default, which can
-         * be accessed via ``overrideNewTabPageURL``
-         * on an extension context.
+         * be accessed via
+         * `webkit_web_extension_context_get_override_new_tab_page_uri()`.
          * @returns `TRUE` if the extension can specify a custom page that can be displayed when a new tab is opened in the app, instead of the default new tab page.
          * @since 2.52
          */
@@ -11842,7 +12176,7 @@ export namespace WebKit {
         detach(): void;
 
         /**
-         * Get the height that the inspector view when attached.
+         * Get the height that the inspector view should have when attached.
          * 
          * Get the height that the inspector view should have when
          * it's attached. If the inspector view is not attached this
@@ -11864,7 +12198,7 @@ export namespace WebKit {
          * 
          * This can be `null` if
          * nothing has been loaded yet in the inspected view, if the inspector
-         * has been closed or when inspected view was loaded from a HTML string
+         * has been closed or when the inspected view was loaded from an HTML string
          * instead of a URI.
          * @returns the URI that is currently being inspected or `null`
          */
@@ -12035,7 +12369,7 @@ export namespace WebKit {
         /**
          * Finish an asynchronous operation started with `webkit_web_resource_get_data()`.
          * @param result a {@link Gio.AsyncResult}
-         * @returns a    string with the data of `resource`, or `null` in case of error. if `length`    is not `null`, the size of the data will be assigned to it.
+         * @returns a    string with the data of `resource`, or `null` in case of error. If `length`    is not `null`, the size of the data will be assigned to it.
          * @throws GLib.Error
          */
         get_data_finish(result: Gio.AsyncResult): Uint8Array;
@@ -12056,25 +12390,15 @@ export namespace WebKit {
          * The active URI might change during
          * a load operation:
          * 
-         * <orderedlist>
-         * <listitem><para>
-         *   When the resource load starts, the active URI is the requested URI
-         * </para></listitem>
-         * <listitem><para>
-         *   When the initial request is sent to the server, {@link WebKit.WebResource.SignalSignatures.sent_request | WebKit.WebResource::sent-request}
-         *   signal is emitted without a redirected response, the active URI is the URI of
-         *   the request sent to the server.
-         * </para></listitem>
-         * <listitem><para>
-         *   In case of a server redirection, {@link WebKit.WebResource.SignalSignatures.sent_request | WebKit.WebResource::sent-request} signal
-         *   is emitted again with a redirected response, the active URI is the URI the request
-         *   was redirected to.
-         * </para></listitem>
-         * <listitem><para>
-         *   When the response is received from the server, the active URI is the final
-         *   one and it will not change again.
-         * </para></listitem>
-         * </orderedlist>
+         * 1. When the resource load starts, the active URI is the requested URI
+         * 2. When the initial request is sent to the server, {@link WebKit.WebResource.SignalSignatures.sent_request | WebKit.WebResource::sent-request}
+         *    signal is emitted without a redirected response, the active URI is the URI of
+         *    the request sent to the server.
+         * 3. In case of a server redirection, {@link WebKit.WebResource.SignalSignatures.sent_request | WebKit.WebResource::sent-request} signal
+         *    is emitted again with a redirected response, the active URI is the URI the request
+         *    was redirected to.
+         * 4. When the response is received from the server, the active URI is the final
+         *    one and it will not change again.
          * 
          * You can monitor the active URI by connecting to the notify::uri
          * signal of `resource`.
@@ -12107,7 +12431,7 @@ export namespace WebKit {
             authenticate: (request: AuthenticationRequest) => boolean | void;
             /**
              * Emitted when closing a {@link WebKit.WebView} is requested. This occurs when a
-             * call is made from JavaScript's <function>window.close</function> function or
+             * call is made from JavaScript's `window.close` function or
              * after trying to close the `web_view` with `webkit_web_view_try_close()`.
              * It is the owner's responsibility to handle this signal to hide or
              * destroy the {@link WebKit.WebView}, if necessary.
@@ -12119,33 +12443,24 @@ export namespace WebKit {
              * Emitted when a context menu is about to be displayed to give the application
              * a chance to customize the proposed menu, prevent the menu from being displayed,
              * or build its own context menu.
-             * <itemizedlist>
-             * <listitem><para>
-             *  To customize the proposed menu you can use `webkit_context_menu_prepend()`,
+             * 
+             * - To customize the proposed menu you can use `webkit_context_menu_prepend()`,
              *  `webkit_context_menu_append()` or `webkit_context_menu_insert()` to add new
-             *  {@link WebKit.ContextMenuItem}<!-- -->s to `context_menu`, `webkit_context_menu_move_item()`
+             *  {@link WebKit.ContextMenuItem} objects to `context_menu`, `webkit_context_menu_move_item()`
              *  to reorder existing items, or `webkit_context_menu_remove()` to remove an
              *  existing item. The signal handler should return `false`, and the menu represented
              *  by `context_menu` will be shown.
-             * </para></listitem>
-             * <listitem><para>
-             *  To prevent the menu from being displayed you can just connect to this signal
+             * - To prevent the menu from being displayed you can just connect to this signal
              *  and return `true` so that the proposed menu will not be shown.
-             * </para></listitem>
-             * <listitem><para>
-             *  To build your own menu, you can remove all items from the proposed menu with
+             * - To build your own menu, you can remove all items from the proposed menu with
              *  `webkit_context_menu_remove_all()`, add your own items and return `false` so
              *  that the menu will be shown. You can also ignore the proposed {@link WebKit.ContextMenu},
-             *  build your own `GtkMenu` and return `true` to prevent the proposed menu from being shown.
-             * </para></listitem>
-             * <listitem><para>
-             *  If you just want the default menu to be shown always, simply don't connect to this
-             *  signal because showing the proposed context menu is the default behaviour.
-             * </para></listitem>
-             * </itemizedlist>
+             *  build your own {@link Gtk.PopoverMenu} and return `true` to prevent the proposed menu from being shown.
+             * - If you just want the default menu to be shown always, simply don't connect to this
+             *  signal because showing the proposed context menu is the default behavior.
              * 
              * If the signal handler returns `false` the context menu represented by `context_menu`
-             * will be shown, if it return `true` the context menu will not be shown.
+             * will be shown, if it returns `true` the context menu will not be shown.
              * 
              * The proposed {@link WebKit.ContextMenu} passed in `context_menu` argument is only valid
              * during the signal emission.
@@ -12183,8 +12498,8 @@ export namespace WebKit {
             /**
              * This signal is emitted when WebKit is requesting the client to decide a policy
              * decision, such as whether to navigate to a page, open a new window or whether or
-             * not to download a resource. The {@link WebKit.NavigationPolicyDecision} passed in the
-             * `decision` argument is a generic type, but should be casted to a more
+             * not to download a resource. The {@link WebKit.PolicyDecision} passed in the
+             * `decision` argument is a generic type, but should be cast to a more
              * specific type when making the decision. For example:
              * 
              * ```c
@@ -12221,17 +12536,17 @@ export namespace WebKit {
              * If the last reference is removed on a {@link WebKit.PolicyDecision} and no decision has been
              * made explicitly, `webkit_policy_decision_use()` will be the default policy decision. The
              * default signal handler will simply call `webkit_policy_decision_use()`. Only the first
-             * policy decision chosen for a given {@link WebKit.PolicyDecision} will have any affect.
+             * policy decision chosen for a given {@link WebKit.PolicyDecision} will have any effect.
              * @signal
              * @run-last
              */
             "decide-policy": (decision: PolicyDecision, decision_type: PolicyDecisionType) => boolean | void;
             /**
              * Emitted when JavaScript code calls
-             * <function>element.webkitRequestFullScreen</function>. If the
+             * `element.webkitRequestFullScreen`. If the
              * signal is not handled the {@link WebKit.WebView} will proceed to full screen
              * its top level window. This signal can be used by client code to
-             * request permission to the user prior doing the full screen
+             * request permission to the user prior to doing the full screen
              * transition and eventually prepare the top-level window
              * (e.g. hide some widgets that would otherwise be part of the
              * full screen window).
@@ -12356,7 +12671,7 @@ export namespace WebKit {
              * operations.
              * 
              * A possible way to use this signal could be through a dialog
-             * allowing the user decide what to do with the request:
+             * allowing the user to decide what to do with the request:
              * 
              * ```c
              * static gboolean permission_request_cb (WebKitWebView *web_view,
@@ -12421,7 +12736,7 @@ export namespace WebKit {
              * 
              * You can handle the query asynchronously by calling `webkit_permission_state_query_ref()` on
              * `query` and returning `true`. If the last reference of `query` is removed and the query has not
-             * been handled, the query result will be set to `WEBKIT_QUERY_PERMISSION_PROMPT`.
+             * been handled, the query result will be set to {@link WebKit.PermissionState.PROMPT}.
              * @signal
              * @since 2.40
              * @run-last
@@ -12450,7 +12765,7 @@ export namespace WebKit {
             /**
              * Emitted after {@link WebKit.WebView.SignalSignatures.ready_to_show | WebKit.WebView::ready-to-show} on the newly
              * created {@link WebKit.WebView} when JavaScript code calls
-             * <function>window.showModalDialog</function>. The purpose of
+             * `window.showModalDialog`. The purpose of
              * this signal is to allow the client application to prepare the
              * new view to behave as modal. Once the signal is emitted a new
              * main loop will be run to block user interaction in the parent
@@ -12495,30 +12810,21 @@ export namespace WebKit {
              */
             "run-file-chooser": (request: FileChooserRequest) => boolean | void;
             /**
-             * Emitted when JavaScript code calls <function>window.alert</function>,
-             * <function>window.confirm</function> or <function>window.prompt</function>,
-             * or when <function>onbeforeunload</function> event is fired.
+             * Emitted when JavaScript code calls `window.alert`,
+             * `window.confirm` or `window.prompt`,
+             * or when `onbeforeunload` event is fired.
              * The `dialog` parameter should be used to build the dialog.
              * If the signal is not handled a different dialog will be built and shown depending
              * on the dialog type:
-             * <itemizedlist>
-             * <listitem><para>
-             *  {@link WebKit.ScriptDialogType.ALERT}: message dialog with a single Close button.
-             * </para></listitem>
-             * <listitem><para>
-             *  {@link WebKit.ScriptDialogType.CONFIRM}: message dialog with OK and Cancel buttons.
-             * </para></listitem>
-             * <listitem><para>
-             *  {@link WebKit.ScriptDialogType.PROMPT}: message dialog with OK and Cancel buttons and
-             *  a text entry with the default text.
-             * </para></listitem>
-             * <listitem><para>
-             *  {@link WebKit.ScriptDialogType.BEFORE_UNLOAD_CONFIRM}: message dialog with Stay and Leave buttons.
-             * </para></listitem>
-             * </itemizedlist>
+             * 
+             * - {@link WebKit.ScriptDialogType.ALERT}: message dialog with a single Close button.
+             * - {@link WebKit.ScriptDialogType.CONFIRM}: message dialog with OK and Cancel buttons.
+             * - {@link WebKit.ScriptDialogType.PROMPT}: message dialog with OK and Cancel buttons and
+             *   a text entry with the default text.
+             * - {@link WebKit.ScriptDialogType.BEFORE_UNLOAD_CONFIRM}: message dialog with Stay and Leave buttons.
              * 
              * It is possible to handle the script dialog request asynchronously, by simply
-             * caling `webkit_script_dialog_ref()` on the `dialog` argument and calling
+             * calling `webkit_script_dialog_ref()` on the `dialog` argument and calling
              * `webkit_script_dialog_close()` when done.
              * If the last reference is removed on a {@link WebKit.ScriptDialog} and the dialog has not been
              * closed, `webkit_script_dialog_close()` will be called.
@@ -12546,7 +12852,7 @@ export namespace WebKit {
              * menu.
              * To handle this signal asynchronously you should keep a ref of the `menu`.
              * 
-             * The default signal handler will pop up a `GtkMenu`.
+             * The default signal handler will pop up a {@link Gtk.Popover}.
              * @signal
              * @since 2.18
              * @run-last
@@ -12603,8 +12909,10 @@ export namespace WebKit {
             "notify::is-muted": (pspec: GObject.ParamSpec) => void;
             "notify::is-playing-audio": (pspec: GObject.ParamSpec) => void;
             "notify::is-web-process-responsive": (pspec: GObject.ParamSpec) => void;
+            "notify::magnification": (pspec: GObject.ParamSpec) => void;
             "notify::microphone-capture-state": (pspec: GObject.ParamSpec) => void;
             "notify::network-session": (pspec: GObject.ParamSpec) => void;
+            "notify::page-icons": (pspec: GObject.ParamSpec) => void;
             "notify::page-id": (pspec: GObject.ParamSpec) => void;
             "notify::related-view": (pspec: GObject.ParamSpec) => void;
             "notify::settings": (pspec: GObject.ParamSpec) => void;
@@ -12679,10 +12987,13 @@ export namespace WebKit {
             isPlayingAudio: boolean;
             is_web_process_responsive: boolean;
             isWebProcessResponsive: boolean;
+            magnification: number;
             microphone_capture_state: MediaCaptureState;
             microphoneCaptureState: MediaCaptureState;
             network_session: NetworkSession;
             networkSession: NetworkSession;
+            page_icons: ImageList | null;
+            pageIcons: ImageList | null;
             page_id: bigint | number;
             pageId: bigint | number;
             related_view: WebView;
@@ -12754,7 +13065,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -12772,7 +13083,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -12816,7 +13127,7 @@ export namespace WebKit {
 
         /**
          * Capture state of the display device. Whenever the user grants a media-request sent by the web
-         * page, requesting screencasting capabilities (`navigator.mediaDevices.getDisplayMedia() this
+         * page, requesting screencasting capabilities (`navigator.mediaDevices.getDisplayMedia()`) this
          * property will be set to {@link WebKit.MediaCaptureState.ACTIVE}.
          * 
          * The application can monitor this property and provide a visual indicator allowing to
@@ -12824,7 +13135,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -12834,7 +13145,7 @@ export namespace WebKit {
 
         /**
          * Capture state of the display device. Whenever the user grants a media-request sent by the web
-         * page, requesting screencasting capabilities (`navigator.mediaDevices.getDisplayMedia() this
+         * page, requesting screencasting capabilities (`navigator.mediaDevices.getDisplayMedia()`) this
          * property will be set to {@link WebKit.MediaCaptureState.ACTIVE}.
          * 
          * The application can monitor this property and provide a visual indicator allowing to
@@ -12842,7 +13153,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -12886,8 +13197,11 @@ export namespace WebKit {
         get estimatedLoadProgress(): number;
 
         /**
-         * The favicon currently associated to the {@link WebKit.WebView}.
+         * The favicon currently associated with the {@link WebKit.WebView}.
          * See `webkit_web_view_get_favicon()` for more details.
+         * 
+         * New applications should use {@link WebView.page_icons} instead.
+         * @deprecated since 2.54
          * @read-only
          */
         get favicon(): Gdk.Texture;
@@ -13007,7 +13321,7 @@ export namespace WebKit {
         get isPlayingAudio(): boolean;
 
         /**
-         * Whether the web process currently associated to the {@link WebKit.WebView} is responsive.
+         * Whether the web process currently associated with the {@link WebKit.WebView} is responsive.
          * @since 2.34
          * @read-only
          * @default true
@@ -13015,13 +13329,26 @@ export namespace WebKit {
         get is_web_process_responsive(): boolean;
 
         /**
-         * Whether the web process currently associated to the {@link WebKit.WebView} is responsive.
+         * Whether the web process currently associated with the {@link WebKit.WebView} is responsive.
          * @since 2.34
          * @read-only
          * @default true
          */
         get isWebProcessResponsive(): boolean;
 
+        /**
+         * The magnification factor of the {@link WebKit.WebView} content.
+         * 
+         * The magnification factor represents the visual scaling of the page (similar
+         * to pinch-to-zoom). This is independent of the layout zoom level. Setting
+         * the magnification factor scales the rendered page visually without affecting
+         * page layout or text wrapping.
+         * @since 2.54
+         * @default 1
+         */
+        get magnification(): number;
+        set magnification(val: number);
+
         /**
          * Capture state of the microphone device. Whenever the user grants a media-request sent by the web
          * page, requesting audio capture capabilities (`navigator.mediaDevices.getUserMedia({audio:
@@ -13032,7 +13359,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -13050,7 +13377,7 @@ export namespace WebKit {
          * {@link WebKit.MediaCaptureState.NONE} or {@link WebKit.MediaCaptureState.MUTED}.
          * 
          * If the capture state of the device is set to {@link WebKit.MediaCaptureState.NONE} the web-page
-         * can still re-request the permission to the user. Permission desision caching is left to the
+         * can still re-request the permission to the user. Permission decision caching is left to the
          * application.
          * @since 2.34
          * @default WebKit.MediaCaptureState.NONE
@@ -13072,6 +13399,20 @@ export namespace WebKit {
          */
         get networkSession(): NetworkSession;
 
+        /**
+         * The page icons (favicons) associated with the currently loaded content, if any.
+         * @since 2.54
+         * @read-only
+         */
+        get page_icons(): ImageList | null;
+
+        /**
+         * The page icons (favicons) associated with the currently loaded content, if any.
+         * @since 2.54
+         * @read-only
+         */
+        get pageIcons(): ImageList | null;
+
         /**
          * The identifier of the `WebKitWebPage` corresponding to the {@link WebKit.WebView}.
          * @since 2.28
@@ -13423,7 +13764,7 @@ export namespace WebKit {
          * Asynchronously call `body` with `arguments` in the script world with name `world_name` of the main frame current context in `web_view`.
          * The `arguments` values must be one of the following types, or contain only the following GVariant types: number, string and dictionary.
          * The result of the operation can be a Promise that will be properly passed to the callback.
-         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distin ct world.
+         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distinct world.
          * The `source_uri` will be shown in exceptions and doesn't affect the behavior of the script.
          * When not provided, the document URL is used.
          * 
@@ -13454,13 +13795,12 @@ export namespace WebKit {
          *     }
          * 
          *     if (jsc_value_is_number (value)) {
-         *         gint32        int_value = jsc_value_to_string (value);
+         *         gint32        int_value = jsc_value_to_int32 (value);
          *         JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value));
          *         if (exception)
          *             g_warning ("Error running javascript: %s", jsc_exception_get_message (exception));
          *         else
          *             g_print ("Script result: %d\n", int_value);
-         *         g_free (str_value);
          *     } else {
          *         g_warning ("Error running javascript: unexpected return value");
          *     }
@@ -13475,7 +13815,7 @@ export namespace WebKit {
          *     g_variant_dict_insert (&dict, "count", "u", 42);
          *     GVariant *args = g_variant_dict_end (&dict);
          *     const gchar *body = "return new Promise((resolve) => { resolve(count); });";
-         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, arguments, NULL, NULL, NULL, web_view_javascript_finished, NULL);
+         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, args, NULL, NULL, NULL, web_view_javascript_finished, NULL);
          * }
          * ```
          * @param body the function body
@@ -13492,7 +13832,7 @@ export namespace WebKit {
          * Asynchronously call `body` with `arguments` in the script world with name `world_name` of the main frame current context in `web_view`.
          * The `arguments` values must be one of the following types, or contain only the following GVariant types: number, string and dictionary.
          * The result of the operation can be a Promise that will be properly passed to the callback.
-         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distin ct world.
+         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distinct world.
          * The `source_uri` will be shown in exceptions and doesn't affect the behavior of the script.
          * When not provided, the document URL is used.
          * 
@@ -13523,13 +13863,12 @@ export namespace WebKit {
          *     }
          * 
          *     if (jsc_value_is_number (value)) {
-         *         gint32        int_value = jsc_value_to_string (value);
+         *         gint32        int_value = jsc_value_to_int32 (value);
          *         JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value));
          *         if (exception)
          *             g_warning ("Error running javascript: %s", jsc_exception_get_message (exception));
          *         else
          *             g_print ("Script result: %d\n", int_value);
-         *         g_free (str_value);
          *     } else {
          *         g_warning ("Error running javascript: unexpected return value");
          *     }
@@ -13544,7 +13883,7 @@ export namespace WebKit {
          *     g_variant_dict_insert (&dict, "count", "u", 42);
          *     GVariant *args = g_variant_dict_end (&dict);
          *     const gchar *body = "return new Promise((resolve) => { resolve(count); });";
-         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, arguments, NULL, NULL, NULL, web_view_javascript_finished, NULL);
+         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, args, NULL, NULL, NULL, web_view_javascript_finished, NULL);
          * }
          * ```
          * @param body the function body
@@ -13562,7 +13901,7 @@ export namespace WebKit {
          * Asynchronously call `body` with `arguments` in the script world with name `world_name` of the main frame current context in `web_view`.
          * The `arguments` values must be one of the following types, or contain only the following GVariant types: number, string and dictionary.
          * The result of the operation can be a Promise that will be properly passed to the callback.
-         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distin ct world.
+         * If `world_name` is `null`, the default world is used. Any value that is not `null` is a distinct world.
          * The `source_uri` will be shown in exceptions and doesn't affect the behavior of the script.
          * When not provided, the document URL is used.
          * 
@@ -13593,13 +13932,12 @@ export namespace WebKit {
          *     }
          * 
          *     if (jsc_value_is_number (value)) {
-         *         gint32        int_value = jsc_value_to_string (value);
+         *         gint32        int_value = jsc_value_to_int32 (value);
          *         JSCException *exception = jsc_context_get_exception (jsc_value_get_context (value));
          *         if (exception)
          *             g_warning ("Error running javascript: %s", jsc_exception_get_message (exception));
          *         else
          *             g_print ("Script result: %d\n", int_value);
-         *         g_free (str_value);
          *     } else {
          *         g_warning ("Error running javascript: unexpected return value");
          *     }
@@ -13614,7 +13952,7 @@ export namespace WebKit {
          *     g_variant_dict_insert (&dict, "count", "u", 42);
          *     GVariant *args = g_variant_dict_end (&dict);
          *     const gchar *body = "return new Promise((resolve) => { resolve(count); });";
-         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, arguments, NULL, NULL, NULL, web_view_javascript_finished, NULL);
+         *     webkit_web_view_call_async_javascript_function (web_view, body, -1, args, NULL, NULL, NULL, web_view_javascript_finished, NULL);
          * }
          * ```
          * @param body the function body
@@ -13954,7 +14292,7 @@ export namespace WebKit {
 
         /**
          * Get the camera capture state of a {@link WebKit.WebView}.
-         * @returns The {@link WebKit.MediaCaptureState} of the camera device. If {@link WebKit.Settings.enable_mediastream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
+         * @returns The {@link WebKit.MediaCaptureState} of the camera device. If {@link WebKit.Settings.enable_media_stream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
          * @since 2.34
          */
         get_camera_capture_state(): MediaCaptureState;
@@ -13980,7 +14318,7 @@ export namespace WebKit {
 
         /**
          * Get the display capture state of a {@link WebKit.WebView}.
-         * @returns The {@link WebKit.MediaCaptureState} of the display device. If {@link WebKit.Settings.enable_mediastream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
+         * @returns The {@link WebKit.MediaCaptureState} of the display device. If {@link WebKit.Settings.enable_media_stream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
          * @since 2.34
          */
         get_display_capture_state(): MediaCaptureState;
@@ -13997,17 +14335,20 @@ export namespace WebKit {
          * 
          * You can monitor the estimated progress of a load operation by
          * connecting to the notify::estimated-load-progress signal of `web_view`.
-         * @returns an estimate of the of the percent complete for a document     load as a range from 0.0 to 1.0.
+         * @returns an estimate of the percent complete for a document     load as a range from 0.0 to 1.0.
          */
         get_estimated_load_progress(): number;
 
         /**
-         * Returns favicon currently associated to `web_view`.
+         * Returns favicon currently associated with `web_view`.
          * 
-         * Returns favicon currently associated to `web_view`, if any. You can
+         * Returns favicon currently associated with `web_view`, if any. You can
          * connect to notify::favicon signal of `web_view` to be notified when
          * the favicon is available.
+         * 
+         * New applications should use {@link WebView.get_page_icons} instead.
          * @returns the favicon image or `null` if there's no    icon associated with `web_view`.
+         * @deprecated since 2.54
          */
         get_favicon(): Gdk.Texture;
 
@@ -14016,7 +14357,7 @@ export namespace WebKit {
          * 
          * Gets the {@link WebKit.FindController} that will allow the caller to query
          * the {@link WebKit.WebView} for the text to look for.
-         * @returns the {@link WebKit.FindController} associated to this particular {@link WebKit.WebView}.
+         * @returns the {@link WebKit.FindController} associated with this particular {@link WebKit.WebView}.
          */
         get_find_controller(): FindController;
 
@@ -14030,14 +14371,14 @@ export namespace WebKit {
         get_input_method_context(): InputMethodContext | null;
 
         /**
-         * Get the {@link WebKit.WebInspector} associated to `web_view`
+         * Get the {@link WebKit.WebInspector} associated with `web_view`
          * @returns the {@link WebKit.WebInspector} of `web_view`
          */
         get_inspector(): WebInspector;
 
         /**
          * Gets the mute state of `web_view`.
-         * @returns `true` if `web_view` audio is muted or `false` is audio is not muted.
+         * @returns `true` if `web_view` audio is muted or `false` if audio is not muted.
          * @since 2.30
          */
         get_is_muted(): boolean;
@@ -14049,6 +14390,17 @@ export namespace WebKit {
          */
         get_is_web_process_responsive(): boolean;
 
+        /**
+         * Get the magnification factor of `web_view`.
+         * 
+         * The magnification factor represents the visual scaling of the page (similar
+         * to pinch-to-zoom). This is independent of the layout zoom level (which is
+         * obtained with `webkit_web_view_get_zoom_level()`).
+         * @returns the current magnification factor of `web_view`
+         * @since 2.54
+         */
+        get_magnification(): number;
+
         /**
          * Return the main resource of `web_view`.
          * @returns the main {@link WebKit.WebResource} of the view    or `null` if nothing has been loaded.
@@ -14057,18 +14409,29 @@ export namespace WebKit {
 
         /**
          * Get the microphone capture state of a {@link WebKit.WebView}.
-         * @returns The {@link WebKit.MediaCaptureState} of the microphone device. If {@link WebKit.Settings.enable_mediastream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
+         * @returns The {@link WebKit.MediaCaptureState} of the microphone device. If {@link WebKit.Settings.enable_media_stream} is `false`, this method will return {@link WebKit.MediaCaptureState.NONE}.
          * @since 2.34
          */
         get_microphone_capture_state(): MediaCaptureState;
 
         /**
-         * Get the {@link WebKit.NetworkSession} associated to `web_view`.
+         * Get the {@link WebKit.NetworkSession} associated with `web_view`.
          * @returns a {@link WebKit.NetworkSession}
          * @since 2.40
          */
         get_network_session(): NetworkSession;
 
+        /**
+         * Returns the page icons for the content loaded in the web view.
+         * 
+         * Gets the page icons associated with the content currently loaded in the
+         * `web_view`, if any, as a {@link ImageList}. Changes to the page icons
+         * can be observed by connecting to the `notify::page-icons` signal.
+         * @returns a list of icons, or `null` if there    are no icons for the content loaded in `web_view`.
+         * @since 2.54
+         */
+        get_page_icons(): ImageList | null;
+
         /**
          * Get the identifier of the `WebKitWebPage` corresponding to
          * the {@link WebKit.WebView}
@@ -14095,9 +14458,9 @@ export namespace WebKit {
          * the desired preferences, and then replace the existing `web_view`
          * settings with `webkit_web_view_set_settings()` or get the existing
          * `web_view` settings and update it directly. {@link WebKit.Settings} objects
-         * can be shared by multiple {@link WebKit.WebView}<!-- -->s, so modifying
+         * can be shared by multiple {@link WebKit.WebView} objects, so modifying
          * the settings of a {@link WebKit.WebView} would affect other
-         * {@link WebKit.WebView}<!-- -->s using the same {@link WebKit.Settings}.
+         * {@link WebKit.WebView} objects using the same {@link WebKit.Settings}.
          * @returns the {@link WebKit.Settings} attached to `web_view`
          */
         get_settings(): Settings;
@@ -14206,50 +14569,30 @@ export namespace WebKit {
          * The active URI might change during
          * a load operation:
          * 
-         * <orderedlist>
-         * <listitem><para>
-         *   When nothing has been loaded yet on `web_view` the active URI is `null`.
-         * </para></listitem>
-         * <listitem><para>
-         *   When a new load operation starts the active URI is the requested URI:
-         *   <itemizedlist>
-         *   <listitem><para>
-         *     If the load operation was started by `webkit_web_view_load_uri()`,
-         *     the requested URI is the given one.
-         *   </para></listitem>
-         *   <listitem><para>
-         *     If the load operation was started by `webkit_web_view_load_html()`,
-         *     the requested URI is "about:blank".
-         *   </para></listitem>
-         *   <listitem><para>
-         *     If the load operation was started by `webkit_web_view_load_alternate_html()`,
-         *     the requested URI is content URI provided.
-         *   </para></listitem>
-         *   <listitem><para>
-         *     If the load operation was started by `webkit_web_view_go_back()` or
-         *     `webkit_web_view_go_forward()`, the requested URI is the original URI
-         *     of the previous/next item in the {@link WebKit.BackForwardList} of `web_view`.
-         *   </para></listitem>
-         *   <listitem><para>
-         *     If the load operation was started by
-         *     `webkit_web_view_go_to_back_forward_list_item()`, the requested URI
-         *     is the opriginal URI of the given {@link WebKit.BackForwardListItem}.
-         *   </para></listitem>
-         *   </itemizedlist>
-         * </para></listitem>
-         * <listitem><para>
-         *   If there is a server redirection during the load operation,
-         *   the active URI is the redirected URI. When the signal
-         *   {@link WebKit.WebView.SignalSignatures.load_changed | WebKit.WebView::load-changed} is emitted with {@link WebKit.LoadEvent.REDIRECTED}
-         *   event, the active URI is already updated to the redirected URI.
-         * </para></listitem>
-         * <listitem><para>
-         *   When the signal {@link WebKit.WebView.SignalSignatures.load_changed | WebKit.WebView::load-changed} is emitted
-         *   with {@link WebKit.LoadEvent.COMMITTED} event, the active URI is the final
-         *   one and it will not change unless a new load operation is started
-         *   or a navigation action within the same page is performed.
-         * </para></listitem>
-         * </orderedlist>
+         * 1. When nothing has been loaded yet on `web_view` the active URI is `null`.
+         * 2. When a new load operation starts the active URI is the requested URI:
+         * 
+         *    - If the load operation was started by `webkit_web_view_load_uri()`,
+         *      the requested URI is the given one.
+         *    - If the load operation was started by `webkit_web_view_load_html()`,
+         *      the requested URI is "about:blank".
+         *    - If the load operation was started by `webkit_web_view_load_alternate_html()`,
+         *      the requested URI is content URI provided.
+         *    - If the load operation was started by `webkit_web_view_go_back()` or
+         *      `webkit_web_view_go_forward()`, the requested URI is the original URI
+         *      of the previous/next item in the {@link WebKit.BackForwardList} of `web_view`.
+         *    - If the load operation was started by
+         *      `webkit_web_view_go_to_back_forward_list_item()`, the requested URI
+         *      is the original URI of the given {@link WebKit.BackForwardListItem}.
+         * 
+         * 3. If there is a server redirection during the load operation,
+         *    the active URI is the redirected URI. When the signal
+         *    {@link WebKit.WebView.SignalSignatures.load_changed | WebKit.WebView::load-changed} is emitted with {@link WebKit.LoadEvent.REDIRECTED}
+         *    event, the active URI is already updated to the redirected URI.
+         * 4. When the signal {@link WebKit.WebView.SignalSignatures.load_changed | WebKit.WebView::load-changed} is emitted
+         *    with {@link WebKit.LoadEvent.COMMITTED} event, the active URI is the final
+         *    one and it will not change unless a new load operation is started
+         *    or a navigation action within the same page is performed.
          * 
          * You can monitor the active URI by connecting to the notify::uri
          * signal of `web_view`.
@@ -14258,7 +14601,7 @@ export namespace WebKit {
         get_uri(): string;
 
         /**
-         * Gets the user content manager associated to `web_view`.
+         * Gets the user content manager associated with `web_view`.
          * @returns the {@link WebKit.UserContentManager} associated with the view
          * @since 2.6
          */
@@ -14294,7 +14637,7 @@ export namespace WebKit {
         get_window_properties(): WindowProperties;
 
         /**
-         * Set the zoom level of `web_view`.
+         * Get the zoom level of `web_view`.
          * 
          * Get the zoom level of `web_view`, i.e. the factor by which the
          * view contents are scaled with respect to their original size.
@@ -14418,7 +14761,7 @@ export namespace WebKit {
          * 
          * You can monitor the load operation by connecting to
          * {@link WebKit.WebView.SignalSignatures.load_changed | WebKit.WebView::load-changed} signal.
-         * @param uri an URI string
+         * @param uri a URI string
          */
         load_uri(uri: string): void;
 
@@ -14445,7 +14788,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode`.
          * 
@@ -14460,7 +14803,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode`.
          * 
@@ -14476,7 +14819,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode`.
          * 
@@ -14500,7 +14843,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode` and writing it to `file`.
          * 
@@ -14516,7 +14859,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode` and writing it to `file`.
          * 
@@ -14533,7 +14876,7 @@ export namespace WebKit {
         /**
          * Asynchronously save the current web page.
          * 
-         * Asynchronously save the current web page associated to the
+         * Asynchronously save the current web page associated with the
          * {@link WebKit.WebView} into a self-contained format using the mode
          * specified in `save_mode` and writing it to `file`.
          * 
@@ -14577,7 +14920,7 @@ export namespace WebKit {
          * `webkit_web_view_send_message_to_page_finish()` to get the message reply.
          * @param message a {@link WebKit.UserMessage}
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
-         * @param callback (nullable): A {@link Gio.AsyncReadyCallback} to call when the request is satisfied or `null`
+         * @param callback A {@link Gio.AsyncReadyCallback} to call when the request is satisfied or `null`
          * @since 2.28
          */
         send_message_to_page(message: UserMessage, cancellable: Gio.Cancellable | null, callback: Gio.AsyncReadyCallback<this> | null): void;
@@ -14591,7 +14934,7 @@ export namespace WebKit {
          * `webkit_web_view_send_message_to_page_finish()` to get the message reply.
          * @param message a {@link WebKit.UserMessage}
          * @param cancellable a {@link Gio.Cancellable} or `null` to ignore
-         * @param callback (nullable): A {@link Gio.AsyncReadyCallback} to call when the request is satisfied or `null`
+         * @param callback A {@link Gio.AsyncReadyCallback} to call when the request is satisfied or `null`
          * @since 2.28
          */
         send_message_to_page(message: UserMessage, cancellable: Gio.Cancellable | null, callback?: Gio.AsyncReadyCallback<this> | null): globalThis.Promise<UserMessage> | void;
@@ -14620,7 +14963,7 @@ export namespace WebKit {
         /**
          * Set the camera capture state of a {@link WebKit.WebView}.
          * 
-         * If {@link WebKit.Settings.enable_mediastream} is `false`, this method will have no visible effect. Once the
+         * If {@link WebKit.Settings.enable_media_stream} is `false`, this method will have no visible effect. Once the
          * state of the device has been set to {@link WebKit.MediaCaptureState.NONE} it cannot be changed
          * anymore. The page can however request capture again using the mediaDevices API.
          * @param state a {@link WebKit.MediaCaptureState}
@@ -14664,7 +15007,7 @@ export namespace WebKit {
         /**
          * Set the display capture state of a {@link WebKit.WebView}.
          * 
-         * If {@link WebKit.Settings.enable_mediastream} is `false`, this method will have no visible effect. Once the
+         * If {@link WebKit.Settings.enable_media_stream} is `false`, this method will have no visible effect. Once the
          * state of the device has been set to {@link WebKit.MediaCaptureState.NONE} it cannot be changed
          * anymore. The page can however request capture again using the mediaDevices API.
          * @param state a {@link WebKit.MediaCaptureState}
@@ -14680,7 +15023,7 @@ export namespace WebKit {
          * CONTENTEDITABLE attribute has been set on the element or one of its parent
          * elements. By default a {@link WebKit.WebView} is not editable.
          * 
-         * Normally, a HTML document is not editable unless the elements within the
+         * Normally, an HTML document is not editable unless the elements within the
          * document are editable. This function provides a way to make the contents
          * of a {@link WebKit.WebView} editable without altering the document or DOM structure.
          * @param editable a `gboolean` indicating the editable state
@@ -14705,10 +15048,23 @@ export namespace WebKit {
          */
         set_is_muted(muted: boolean): void;
 
+        /**
+         * Set the magnification factor of `web_view`.
+         * 
+         * The magnification factor represents the visual scaling of the page (similar
+         * to pinch-to-zoom). This is independent of the layout zoom level (which is
+         * set with `webkit_web_view_set_zoom_level()`). Setting the magnification factor
+         * scales the rendered page visually around the center of the view without
+         * affecting page layout or text wrapping.
+         * @param magnification the magnification factor
+         * @since 2.54
+         */
+        set_magnification(magnification: number): void;
+
         /**
          * Set the microphone capture state of a {@link WebKit.WebView}.
          * 
-         * If {@link WebKit.Settings.enable_mediastream} is `false`, this method will have no visible effect. Once the
+         * If {@link WebKit.Settings.enable_media_stream} is `false`, this method will have no visible effect. Once the
          * state of the device has been set to {@link WebKit.MediaCaptureState.NONE} it cannot be changed
          * anymore. The page can however request capture again using the mediaDevices API.
          * @param state a {@link WebKit.MediaCaptureState}
@@ -14723,7 +15079,7 @@ export namespace WebKit {
          * existing {@link WebKit.Settings} of `web_view` will be replaced by
          * `settings`. New settings are applied immediately on `web_view`.
          * The same {@link WebKit.Settings} object can be shared
-         * by multiple {@link WebKit.WebView}<!-- -->s.
+         * by multiple {@link WebKit.WebView} objects.
          * @param settings a {@link WebKit.Settings}
          */
         set_settings(settings: Settings): void;
@@ -14748,7 +15104,7 @@ export namespace WebKit {
         stop_loading(): void;
 
         /**
-         * Terminates the web process associated to `web_view`.
+         * Terminates the web process associated with `web_view`.
          * 
          * When the web process gets terminated
          * using this method, the {@link WebKit.WebView.SignalSignatures.web_process_terminated | WebKit.WebView::web-process-terminated} signal is emitted with
@@ -15196,7 +15552,7 @@ export namespace WebKit {
      * A permission request for accessing website data from third-party domains.
      * 
      * WebKitWebsiteDataAccessPermissionRequest represents a request for
-     * permission to allow a third-party domain access its cookies.
+     * permission to allow a third-party domain to access its cookies.
      * 
      * When a WebKitWebsiteDataAccessPermissionRequest is not handled by the user,
      * it is denied by default.
@@ -15299,7 +15655,7 @@ export namespace WebKit {
      * 
      * You can use WebKitWebsiteDataManager to configure the local directories
      * where website data will be stored. Use {@link WebKit.WebsiteDataManager.base_data_directory}
-     * and {@link WebKit.WebsiteDataManager.base_cache_directory} set a common base directory for all
+     * and {@link WebKit.WebsiteDataManager.base_cache_directory} to set a common base directory for all
      * website data and caches.
      * 
      * A WebKitWebsiteDataManager can be ephemeral, in which case all the directory configuration
@@ -15542,7 +15898,7 @@ export namespace WebKit {
         /**
          * Finish an asynchronous operation started with `webkit_website_data_manager_fetch()`.
          * @param result a {@link Gio.AsyncResult}
-         * @returns a {@link GLib.List} of {@link WebKit.WebsiteData}. You must free the {@link GLib.List} with    `g_list_free()` and unref the {@link WebKit.WebsiteData}<!-- -->s with `webkit_website_data_unref()` when you're done with them.
+         * @returns a {@link GLib.List} of {@link WebKit.WebsiteData}. You must free the {@link GLib.List} with    `g_list_free()` and unref the {@link WebKit.WebsiteData} objects with `webkit_website_data_unref()` when you're done with them.
          * @since 2.16
          * @throws GLib.Error
          */
@@ -15620,7 +15976,7 @@ export namespace WebKit {
         /**
          * Finish an asynchronous operation started with `webkit_website_data_manager_get_itp_summary()`.
          * @param result a {@link Gio.AsyncResult}
-         * @returns a {@link GLib.List} of {@link WebKit.ITPThirdParty}.    You must free the {@link GLib.List} with `g_list_free()` and unref the {@link WebKit.ITPThirdParty}<!-- -->s with    `webkit_itp_third_party_unref()` when you're done with them.
+         * @returns a {@link GLib.List} of {@link WebKit.ITPThirdParty}.    You must free the {@link GLib.List} with `g_list_free()` and unref the {@link WebKit.ITPThirdParty} objects with    `webkit_itp_third_party_unref()` when you're done with them.
          * @since 2.30
          * @throws GLib.Error
          */
@@ -15699,11 +16055,14 @@ export namespace WebKit {
         // Signal signatures
         interface SignalSignatures extends GObject.Object.SignalSignatures {
             "notify::autoplay": (pspec: GObject.ParamSpec) => void;
+            "notify::custom-user-agent": (pspec: GObject.ParamSpec) => void;
         }
 
         // Constructor properties interface
         interface ConstructorProps extends GObject.Object.ConstructorProps {
             autoplay: AutoplayPolicy;
+            custom_user_agent: string | null;
+            customUserAgent: string | null;
         }
     }
 
@@ -15711,7 +16070,7 @@ export namespace WebKit {
      * View specific website policies.
      * 
      * WebKitWebsitePolicies allows you to configure per-page policies,
-     * currently only autoplay policies are supported.
+     * currently only autoplay and custom user agent policies are supported.
      * @gir-type Class
      * @since 2.30
      */
@@ -15727,6 +16086,24 @@ export namespace WebKit {
          */
         get autoplay(): AutoplayPolicy;
 
+        /**
+         * The custom user agent string to send for navigations governed by these
+         * {@link WebKit.WebsitePolicies}, or `null` to use the default user agent.
+         * @since 2.54
+         * @construct-only
+         * @default null
+         */
+        get custom_user_agent(): string | null;
+
+        /**
+         * The custom user agent string to send for navigations governed by these
+         * {@link WebKit.WebsitePolicies}, or `null` to use the default user agent.
+         * @since 2.54
+         * @construct-only
+         * @default null
+         */
+        get customUserAgent(): string | null;
+
         /**
          * Compile-time signal type information.
          *
@@ -15760,6 +16137,13 @@ export namespace WebKit {
          * @since 2.30
          */
         get_autoplay_policy(): AutoplayPolicy;
+
+        /**
+         * Get the {@link WebKit.WebsitePolicies.custom_user_agent} property.
+         * @returns the custom user agent string, or `null` if the default    user agent is used
+         * @since 2.54
+         */
+        get_custom_user_agent(): string | null;
     }
 
 
@@ -16391,14 +16775,14 @@ export namespace WebKit {
      *   for details): {@link Feature.get_status}.
      * - A category, which may be used to group features together:
      *   {@link Feature.get_category}.
-     * - An optional short “name” which can be presented to an user:
+     * - An optional short “name” which can be presented to a user:
      *   {@link Feature.get_name}.
      * - An optional longer “detailed” description:
      *   {@link Feature.get_details}.
      * 
      * The lists of available features can be obtained with
      * {@link Settings.get_all_features}, {@link Settings.get_experimental_features},
-     * and {@link Settings.get_development_features}). As a rule of thumb,
+     * and {@link Settings.get_development_features}. As a rule of thumb,
      * applications which may want to allow users (i.e. web developers) to test
      * WebKit features should use the list of experimental features. Additionally,
      * applications might want to expose development features *when targeting
@@ -16448,7 +16832,7 @@ export namespace WebKit {
          * The returned string is suitable to be displayed to end users, but it
          * should not be relied upon being localized.
          * 
-         * Note that some *features may not* have a detailed description, and `NULL`
+         * Note that some *features may not* have a detailed description, and `null`
          * is returned in this case.
          * @returns Feature description.
          * @since 2.42
@@ -16468,7 +16852,7 @@ export namespace WebKit {
          * The returned string is suitable to be displayed to end users, but it
          * should not be relied upon being localized.
          * 
-         * Note that some *features may not* have a short name, and `NULL`
+         * Note that some *features may not* have a short name, and `null`
          * is returned in this case.
          * @returns Short feature name.
          * @since 2.42
@@ -16494,7 +16878,7 @@ export namespace WebKit {
         /**
          * Atomically releases a reference on the given `feature`.
          * 
-         * If the reference was the last, the resources associated to the
+         * If the reference was the last, the resources associated with the
          * `feature` are freed. This function is MT-safe and may be called from
          * any thread.
          * @since 2.42
@@ -16511,7 +16895,7 @@ export namespace WebKit {
      * 
      * ```c
      * g_autoptr(WebKitFeatureList) list = `webkit_settings_get_experimental_features()`;
-     * for (gsize i = 0; i < webkit_feature_list_get_length(list): i++) {
+     * for (gsize i = 0; i < webkit_feature_list_get_length(list); i++) {
      *     WebKitFeature *feature = webkit_feature_list_get(list, i);
      *     // Do something with "feature".
      * }
@@ -16528,6 +16912,14 @@ export namespace WebKit {
         static $gtype: GObject.GType<FeatureList>;
 
         // Methods
+        /**
+         * Finds a feature given its identifier.
+         * @param identifier a {@link WebKit.Feature} identifier
+         * @returns The feature with the given     `identifier`, or `null` if it cannot be found.
+         * @since 2.54
+         */
+        find(identifier: string): Feature | null;
+
         /**
          * Gets a feature given its index.
          * @param index index of the feature
@@ -16538,7 +16930,8 @@ export namespace WebKit {
 
         /**
          * Gets the number of elements in the feature list.
-         * @returns number of elements. Since 2.42
+         * @returns number of elements.
+         * @since 2.42
          */
         get_length(): number;
 
@@ -16554,7 +16947,7 @@ export namespace WebKit {
         /**
          * Atomically releases a reference on the given `feature_list`.
          * 
-         * If the reference was the last, the resources associated to the
+         * If the reference was the last, the resources associated with the
          * `feature_list` are freed. This function is MT-safe and may be called
          * from any thread.
          * @since 2.42
@@ -16684,7 +17077,7 @@ export namespace WebKit {
         /**
          * Get the last time a {@link WebKit.ITPThirdParty} has been seen under `itp_first_party`.
          * 
-         * Each `WebKitITPFirstParty` is created by `webkit_itp_third_party_get_first_parties()` and
+         * Each {@link WebKit.ITPFirstParty} is created by `webkit_itp_third_party_get_first_parties()` and
          * therefore corresponds to exactly one {@link WebKit.ITPThirdParty}.
          * @returns the last update time as a {@link GLib.DateTime}
          * @since 2.30
@@ -16694,7 +17087,7 @@ export namespace WebKit {
         /**
          * Get whether `itp_first_party` has granted website data access to its {@link WebKit.ITPThirdParty}.
          * 
-         * Each `WebKitITPFirstParty` is created by `webkit_itp_third_party_get_first_parties()` and
+         * Each {@link WebKit.ITPFirstParty} is created by `webkit_itp_third_party_get_first_parties()` and
          * therefore corresponds to exactly one {@link WebKit.ITPThirdParty}.
          * @returns `true` if website data access has been granted, or `false` otherwise
          * @since 2.30
@@ -16766,6 +17159,69 @@ export namespace WebKit {
     }
 
 
+    /**
+     * @gir-type Alias
+     */
+    type ImageClass = typeof Image;
+
+    /**
+     * Represents a set of related images.
+     * 
+     * The list supports iterating over each {@link Image}:
+     * 
+     * ```c
+     * g_autoptr(WebKitImageList) list = webkit_favicon_database_get_page_icons_finish(database, result, NULL);
+     * for (gsize i = 0; i < webkit_image_list_get_length(list); i++) {
+     *     WebKitImage *image = webkit_image_list_get(list, i);
+     *     // Do something with "image".
+     * }
+     * ```
+     * 
+     * Image lists can be obtained as the result of `webkit_favicon_database_get_page_icons`.
+     * @gir-type Struct
+     * @since 2.54
+     */
+    abstract class ImageList {
+        static $gtype: GObject.GType<ImageList>;
+
+        // Methods
+        /**
+         * Gets an image given its index.
+         * @param index index of the image
+         * @returns The image at `index`.
+         * @since 2.54
+         */
+        get(index: bigint | number): Image;
+
+        /**
+         * Gets the number of elements in the image list.
+         * @returns number of elements.
+         * @since 2.54
+         */
+        get_length(): number;
+
+        /**
+         * Atomically acquires a reference on the given `image_list`.
+         * 
+         * This function is MT-safe and may be called from any thread.
+         * @returns The same `image_list` with an additional reference.
+         * @since 2.54
+         */
+        ref(): ImageList;
+
+        /**
+         * Atomically releases a reference on the given `image_list`.
+         * 
+         * If the reference was the last, the resources associated with
+         * the `image_list` are freed.
+         * 
+         * This function is MT-safe and may be called from any thread.
+         * @since 2.54
+         */
+        unref(): void;
+    }
+
+
     /**
      * @gir-type Alias
      */
@@ -16780,7 +17236,7 @@ export namespace WebKit {
 
 
     /**
-     * Range of text in an preedit string to be shown underlined.
+     * Range of text in a preedit string to be shown underlined.
      * @gir-type Struct
      * @since 2.28
      */
@@ -16829,10 +17285,10 @@ export namespace WebKit {
      * {@link WebKit.MemoryPressureSettings} is a boxed type that can be used to provide some custom settings
      * to control how the memory pressure situations are handled by the different processes.
      * 
-     * The memory pressure system implemented inside the different process will try to keep the memory usage
+     * The memory pressure system implemented inside the different processes will try to keep the memory usage
      * under the defined memory limit. In order to do that, it will check the used memory with a user defined
      * frequency and decide whether it should try to release memory. The thresholds passed will define how urgent
-     * is to release that memory.
+     * it is to release that memory.
      * 
      * Take into account that badly defined parameters can greatly reduce the performance of the engine. For
      * example, setting memory limit too low with a fast poll interval can cause the process to constantly
@@ -16858,7 +17314,7 @@ export namespace WebKit {
         // Methods
         /**
          * Make a copy of `settings`.
-         * @returns A copy of of the passed {@link WebKit.MemoryPressureSettings}.
+         * @returns A copy of the passed {@link WebKit.MemoryPressureSettings}.
          * @since 2.34
          */
         copy(): MemoryPressureSettings;
@@ -16922,7 +17378,7 @@ export namespace WebKit {
          * Sets `value` as the fraction of the defined memory limit where the process will be
          * killed.
          * 
-         * The threshold must be a value bigger or equal to 0. A value of 0 means that the process
+         * The threshold must be a value bigger than or equal to 0. A value of 0 means that the process
          * is never killed. If the threshold is not 0, then it must be bigger than the strict threshold
          * defined in `settings`. The threshold can also have values bigger than 1. The default value is 0.
          * @param value fraction of the memory limit where the process will be killed because   of excessive memory usage.
@@ -16931,7 +17387,7 @@ export namespace WebKit {
         set_kill_threshold(value: number): void;
 
         /**
-         * Sets `memory_limit` the memory limit value to `settings`.
+         * Sets `memory_limit` as the memory limit value of `settings`.
          * 
          * The default value is the system's RAM size with a maximum of 3GB.
          * @param memory_limit amount of memory (in MB) that the process is allowed to use.
@@ -17025,8 +17481,8 @@ export namespace WebKit {
         /**
          * Return the {@link WebKit.URIRequest} associated with the navigation action.
          * 
-         * Modifications to the returned object are <emphasis>not</emphasis> taken
-         * into account when the request is sent over the network, and is intended
+         * Modifications to the returned object are *not* taken
+         * into account when the request is sent over the network, and the object is intended
          * only to aid in evaluating whether a navigation action should be taken or
          * not. To modify requests before they are sent over the network the
          * `WebKitPage::send-request` signal can be used instead.
@@ -17060,7 +17516,7 @@ export namespace WebKit {
      * Configures network proxies.
      * 
      * WebKitNetworkProxySettings can be used to provide a custom proxy configuration
-     * to a {@link WebKit.NetworkSession}. You need to call `webkit_network_session_set_network_proxy_settings()`
+     * to a {@link WebKit.NetworkSession}. You need to call `webkit_network_session_set_proxy_settings()`
      * with {@link WebKit.NetworkProxyMode.CUSTOM} and a WebKitNetworkProxySettings.
      * @gir-type Struct
      * @since 2.16
@@ -17077,11 +17533,11 @@ export namespace WebKit {
         /**
          * Adds a URI-scheme-specific proxy.
          * 
-         * URIs whose scheme matches `uri_scheme` will be proxied via `proxy_uri`.
+         * URIs whose scheme matches `scheme` will be proxied via `proxy_uri`.
          * As with the default proxy URI, if `proxy_uri` starts with "socks://", it will be treated as referring to
          * all three of the socks5, socks4a, and socks4 proxy types.
          * @param scheme the URI scheme to add a proxy for
-         * @param proxy_uri the proxy URI to use for `uri_scheme`
+         * @param proxy_uri the proxy URI to use for `scheme`
          * @since 2.16
          */
         add_proxy_for_scheme(scheme: string, proxy_uri: string): void;
@@ -17124,7 +17580,7 @@ export namespace WebKit {
     /**
      * One item of a {@link WebKit.OptionMenu}.
      * 
-     * The {@link WebKit.OptionMenu} is composed of WebKitOptionMenuItem<!-- -->s.
+     * The {@link WebKit.OptionMenu} is composed of WebKitOptionMenuItem objects.
      * A WebKitOptionMenuItem always has a label and can contain a tooltip text.
      * You can use the WebKitOptionMenuItem of a {@link WebKit.OptionMenu} to build your
      * own menus.
@@ -17364,7 +17820,7 @@ export namespace WebKit {
          * Atomically decrements the reference count of `dialog` by one.
          * 
          * If the
-         * reference count drops to 0, all memory allocated by the `WebKitScriptdialog` is
+         * reference count drops to 0, all memory allocated by the {@link WebKit.ScriptDialog} is
          * released. This function is MT-safe and may be called from any
          * thread.
          * @since 2.24
@@ -17376,7 +17832,7 @@ export namespace WebKit {
     /**
      * A reply for a script message received.
      * If no reply has been sent by the user, an automatically generated reply with
-     * undefined value with be sent.
+     * undefined value will be sent.
      * @gir-type Struct
      * @since 2.40
      */
@@ -17401,7 +17857,8 @@ export namespace WebKit {
         /**
          * Reply to a script message with a value.
          * 
-         * This function can be called twice for passing the reply value in.
+         * This function can only be called once. Further calls to it or to
+         * `webkit_script_message_reply_return_error_message()` emit a critical warning and are ignored.
          * @param reply_value Reply value of the provided script message
          * @since 2.40
          */
@@ -17537,7 +17994,7 @@ export namespace WebKit {
     type URISchemeResponseClass = typeof URISchemeResponse;
 
     /**
-     * A compiled set of rules which applied to resource loads.
+     * A compiled set of rules which are applied to resource loads.
      * @gir-type Struct
      * @since 2.24
      */
@@ -17735,7 +18192,7 @@ export namespace WebKit {
         get_host(): string;
 
         /**
-         * Gets whether the match pattern matches all host. This happens when
+         * Gets whether the match pattern matches all hosts. This happens when
          * the pattern is `<all_urls>`, or if `*` is set as the host string.
          * @returns Whether this match pattern matches all hosts.
          * @since 2.48
@@ -17774,7 +18231,7 @@ export namespace WebKit {
         /**
          * Matches the `matchPattern` against the specified `pattern` with options.
          * @param pattern The {@link WebKit.WebExtensionMatchPattern} to match with `matchPattern`.
-         * @param options The {@link WebKit.WebExtensionMatchPatternOptions} use while matching.
+         * @param options The {@link WebKit.WebExtensionMatchPatternOptions} to use while matching.
          * @returns Whether the pattern matches the specified `pattern`.
          * @since 2.48
          */
@@ -17783,7 +18240,7 @@ export namespace WebKit {
         /**
          * Matches the `matchPattern` against the specified URL with options.
          * @param url The URL to match against the pattern.
-         * @param options The {@link WebKit.WebExtensionMatchPatternOptions} use while matching.
+         * @param options The {@link WebKit.WebExtensionMatchPatternOptions} to use while matching.
          * @returns Whether the pattern matches the specified URL.
          * @since 2.48
          */
@@ -17801,7 +18258,7 @@ export namespace WebKit {
         /**
          * Atomically releases a reference on the given `matchPattern`.
          * 
-         * If the reference was the last, the resources associated to the
+         * If the reference was the last, the resources associated with the
          * `matchPattern` are freed. This function is MT-safe and may be called from
          * any thread.
          * @since 2.48
@@ -17926,8 +18383,9 @@ export namespace WebKit {
         /**
          * Gets the size of the data of types `types` in a {@link WebKit.WebsiteData}.
          * 
-         * Note that currently the data size is only known for {@link WebKit.WebsiteDataTypes.DISK_CACHE} data type
-         * so for all other types 0 will be returned.
+         * Note that currently the data size is only known for the {@link WebKit.WebsiteDataTypes.DISK_CACHE},
+         * {@link WebKit.WebsiteDataTypes.LOCAL_STORAGE}, {@link WebKit.WebsiteDataTypes.INDEXEDDB_DATABASES} and
+         * {@link WebKit.WebsiteDataTypes.DOM_CACHE} data types, so for all other types 0 will be returned.
          * @param types a bitmask  of {@link WebKit.WebsiteDataTypes}
          * @returns the size of `website_data` for the given `types`.
          * @since 2.16