webext-schema 6.0.0 → 7.1.0

package/schemas/mail/mailext.json

@@ -821,7 +821,7 @@
           "properties": {
             "default_locale": {
               "type": "string",
-              "optional": "true"
+              "optional": true
             },
             "l10n_resources": {
               "type": "array",
@@ -1684,7 +1684,6 @@
             },
             "documentId": {
               "type": "string",
-              "unsupported": true,
               "optional": true,
               "description": "An UUID for the document associated with this context, or undefined if it is not hosted in a document"
             },
@@ -1769,6 +1768,11 @@
               "optional": true,
               "description": "The $(topic:frame_ids)[frame] that opened the connection. 0 for top-level frames, positive for child frames. This will only be set when <code>tab</code> is set."
             },
+            "documentId": {
+              "type": "string",
+              "optional": true,
+              "description": "A UUID of the document that opened the connection."
+            },
             "id": {
               "type": "string",
               "optional": true,
@@ -2070,6 +2074,27 @@
             "description": "The fully-qualified URL to the resource."
           }
         },
+        {
+          "name": "getDocumentId",
+          "type": "function",
+          "allowedContexts": [
+            "content",
+            "devtools"
+          ],
+          "description": "Get the documentId of any window global or frame element. Throws for invalid targets, such as unloaded frames.",
+          "parameters": [
+            {
+              "type": "any",
+              "name": "target",
+              "description": "A WindowProxy or a browsing context container Element (iframe, frame, embed, or object) for the target frame."
+            }
+          ],
+          "allowCrossOriginArguments": true,
+          "returns": {
+            "type": "string",
+            "description": "The documentId of the target document."
+          }
+        },
         {
           "name": "getFrameId",
           "type": "function",
@@ -2082,7 +2107,7 @@
             {
               "type": "any",
               "name": "target",
-              "description": "A WindowProxy or a Browsing Context container element (IFrame, Frame, Embed, Object) for the target frame."
+              "description": "A WindowProxy or a browsing context container Element (iframe, frame, embed, or object) for the target frame."
             }
           ],
           "allowCrossOriginArguments": true,
@@ -2653,7 +2678,7 @@
             },
             {
               "type": "array",
-              "description": "An RGBA array of 3 integers and a fractional (a float between 0 and 1). For example <var>[220, 20, 60, 0.5]<var> for the color *crimson* with 50% opacity.",
+              "description": "An RGBA array of 3 integers and a fractional (a float between 0 and 1). For example <var>[220, 20, 60, 0.5]</var> for the color *crimson* with 50% opacity.",
               "minItems": 4,
               "maxItems": 4,
               "items": {
@@ -2980,7 +3005,8 @@
                     ]
                   },
                   "maxItems": 15,
-                  "optional": true
+                  "optional": true,
+                  "description": "An array of alignment values, one for each image in <var>additional_backgrounds</var>."
                 },
                 "additional_backgrounds_tiling": {
                   "type": "array",
@@ -2994,16 +3020,18 @@
                     ]
                   },
                   "maxItems": 15,
-                  "optional": true
+                  "optional": true,
+                  "description": "An array of tiling values, one for each image in <var>additional_backgrounds</var>."
                 },
                 "color_scheme": {
                   "description": "If set, overrides the general theme (context menus, toolbars, content area).",
                   "optional": true,
                   "type": "string",
                   "enum": [
+                    "auto",
                     "light",
                     "dark",
-                    "auto"
+                    "system"
                   ]
                 },
                 "content_color_scheme": {
@@ -3011,9 +3039,10 @@
                   "optional": true,
                   "type": "string",
                   "enum": [
+                    "auto",
                     "light",
                     "dark",
-                    "auto"
+                    "system"
                   ]
                 }
               },
@@ -4018,45 +4047,85 @@
       "types": [
         {
           "id": "QueryInfo",
-          "description": "Object defining a query for $(ref:contacts.quickSearch).",
-          "type": "object",
-          "properties": {
-            "parentId": {
-              "type": "string",
-              "min_manifest_version": 3,
-              "optional": true,
-              "description": "The id of the address book to search. If not specified, all address books are searched."
-            },
-            "searchString": {
-              "type": "string",
-              "optional": true,
-              "description": "One or more space-separated terms to search for in predefined contact fields (defined by the preference <var>mail.addr_book.quicksearchquery.format</var>)."
-            },
-            "includeLocal": {
-              "type": "boolean",
-              "optional": true,
-              "default": true,
-              "description": "Whether to include results from local address books. Defaults to <var>true</var>."
-            },
-            "includeRemote": {
-              "type": "boolean",
-              "optional": true,
-              "default": true,
-              "description": "Whether to include results from remote address books. Defaults to <var>true</var>."
-            },
-            "includeReadOnly": {
-              "type": "boolean",
-              "optional": true,
-              "default": true,
-              "description": "Whether to include results from read-only address books. Defaults to <var>true</var>."
+          "choices": [
+            {
+              "max_manifest_version": 2,
+              "description": "Object defining a query for $(ref:contacts.quickSearch).",
+              "type": "object",
+              "properties": {
+                "searchString": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "One or more space-separated terms to search for in predefined contact fields (defined by the preference <var>mail.addr_book.quicksearchquery.format</var>)."
+                },
+                "includeLocal": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from local address books. Defaults to <var>true</var>."
+                },
+                "includeRemote": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from remote address books. Defaults to <var>true</var>."
+                },
+                "includeReadOnly": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from read-only address books. Defaults to <var>true</var>."
+                },
+                "includeReadWrite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from read-write address books. Defaults to <var>true</var>."
+                }
+              }
             },
-            "includeReadWrite": {
-              "type": "boolean",
-              "optional": true,
-              "default": true,
-              "description": "Whether to include results from read-write address books. Defaults to <var>true</var>."
+            {
+              "min_manifest_version": 3,
+              "description": "Object defining a query for $(ref:contacts.query).",
+              "type": "object",
+              "properties": {
+                "parentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The id of the address book to search. If not specified, all address books are searched."
+                },
+                "searchString": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "One or more space-separated terms to search for in predefined contact fields (defined by the preference <var>mail.addr_book.quicksearchquery.format</var>)."
+                },
+                "includeLocal": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from local address books. Defaults to <var>true</var>."
+                },
+                "includeRemote": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from remote address books. Defaults to <var>true</var>."
+                },
+                "includeReadOnly": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from read-only address books. Defaults to <var>true</var>."
+                },
+                "includeReadWrite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true,
+                  "description": "Whether to include results from read-write address books. Defaults to <var>true</var>."
+                }
+              }
             }
-          }
+          ]
         },
         {
           "id": "ContactNode",
@@ -4436,6 +4505,17 @@
             }
           ]
         },
+        {
+          "name": "onManyCreated",
+          "type": "function",
+          "description": "Fired when a large number of contacts are added. The contacts are not emitted for performance reasons. The event indicates significant changes, and consumers should rebuild any cached representation of the address book.",
+          "parameters": [
+            {
+              "name": "node",
+              "$ref": "AddressBookNode"
+            }
+          ]
+        },
         {
           "name": "onUpdated",
           "type": "function",
@@ -4803,6 +4883,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "action": {
+              "description": "Defines the appearance and behavior of an action button in the toolbar.",
               "min_manifest_version": 3,
               "type": "object",
               "additionalProperties": {
@@ -4908,6 +4989,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "browser_action": {
+              "description": "Defines the appearance and behavior of a browserAction button in the toolbar.",
               "max_manifest_version": 2,
               "type": "object",
               "additionalProperties": {
@@ -5988,6 +6070,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "cloud_file": {
+              "description": "Defines a cloud file provider for uploading large attachments to a remote server.",
               "type": "object",
               "additionalProperties": {
                 "$ref": "UnrecognizedProperty"
@@ -6522,7 +6605,7 @@
           "choices": [
             {
               "type": "string",
-              "description": "A name and email address in the format <var>Name <email@example.com></var>, or just an email address."
+              "description": "A name and email address in mailbox format (<var>Name <email@example.com></var>), or just an email address. Mailing lists are specified as <var>ListName <ListName></var>. Use $(ref:messengerUtilities.parseMailboxString) to extract the name and/or the email from the mailbox string, or to expand mailing list entries."
             },
             {
               "type": "object",
@@ -6535,7 +6618,7 @@
                 "nodeId": {
                   "type": "string",
                   "min_manifest_version": 3,
-                  "description": "The ID of a contact or mailing list node from the $(doc:addressBook.contacts) or $(doc:addressBook.mailingLists)."
+                  "description": "The ID of a contact or mailing list node from the $(doc:addressBooks.contacts) or $(doc:addressBooks.mailingLists)."
                 },
                 "type": {
                   "type": "string",
@@ -6586,7 +6669,7 @@
             "additionalFccFolderId": {
               "min_manifest_version": 3,
               "$ref": "folders.MailFolderId",
-              "description": "An additional fcc folder which can be selected while composing the message. Cleared when set to <var>null</var>. The permission <permission>accountsRead</permission> is required to use this property.",
+              "description": "An additional fcc folder which can be selected while composing the message. Cleared when set to <var>null</var>. Has no effect when the message is saved as a draft or template; the additional copy is only created when the message is actually sent or queued for sending. The permission <permission>accountsRead</permission> is required to use this property.",
               "optional": "omit-key-if-missing"
             },
             "additionalFccFolder": {
@@ -6605,7 +6688,7 @@
                   "$ref": "folders.MailFolderId"
                 }
               ],
-              "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used. The permission <permission>accountsRead</permission> is required to use this property.",
+              "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used. Has no effect when the message is saved as a draft or template; the additional copy is only created when the message is actually sent or queued for sending. The permission <permission>accountsRead</permission> is required to use this property.",
               "optional": true
             },
             "attachPublicPGPKey": {
@@ -6744,12 +6827,12 @@
                 }
               ],
               "optional": true,
-              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a $(ref:folders.MailFolder) specifying the folder for the copy of the sent message, or an empty string to not save a copy at all. The permission <permission>accountsRead</permission> is required to use this property."
+              "description": "This value overrides the default fcc setting (defined by the used identity) for this message only. Either a $(ref:folders.MailFolder) specifying the folder for the copy of the sent message, or an empty string to not save a copy at all. The permission <permission>accountsRead</permission> is required to use this property."
             },
             "overrideDefaultFccFolderId": {
               "min_manifest_version": 3,
               "$ref": "folders.MailFolderId",
-              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a $(ref:folders.MailFolderId) specifying the folder for the copy of the sent message, or an empty string to not save a copy at all. Reset when set to <var>null</var>. The permission <permission>accountsRead</permission> is required to use this property.",
+              "description": "This value overrides the default fcc setting (defined by the used identity) for this message only. Either a $(ref:folders.MailFolderId) specifying the folder for the copy of the sent message, or an empty string to not save a copy at all. Reset when set to <var>null</var>. The permission <permission>accountsRead</permission> is required to use this property.",
               "optional": "omit-key-if-missing"
             },
             "plainTextBody": {
@@ -6770,7 +6853,7 @@
               "optional": true
             },
             "relatedMessageId": {
-              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <var>undefined</var> in all other cases or if the original message was opened from file.",
+              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <var>undefined</var> in all other cases or if the original message was opened from file. The <permission>messagesRead</permission> permission is required to use this property.",
               "$ref": "messages.MessageId",
               "optional": true
             },
@@ -6953,7 +7036,8 @@
           "parameters": [
             {
               "name": "tab",
-              "$ref": "tabs.Tab"
+              "$ref": "tabs.Tab",
+              "description": "The tab of the associated compose window. By the time the event listener is called, this window may have already been destroyed."
             },
             {
               "name": "sendInfo",
@@ -6982,7 +7066,11 @@
                   "items": {
                     "$ref": "messages.MessageHeader"
                   },
-                  "description": "Copies of the sent message. The number of created copies depends on the applied file carbon copy configuration (fcc)."
+                  "description": "Copies of the sent message. The number of created copies depends on the applied file carbon copy configuration (fcc). The <permission>messagesRead</permission> permission is required for this property to be included."
+                },
+                "details": {
+                  "$ref": "ComposeDetails",
+                  "description": "The $(ref:compose.ComposeDetails) of the send message."
                 }
               }
             }
@@ -7023,7 +7111,11 @@
                   "items": {
                     "$ref": "messages.MessageHeader"
                   },
-                  "description": "An array with exactly one element, the saved message."
+                  "description": "An array with exactly one element, the saved message. The <permission>messagesRead</permission> permission is required for this property to be included."
+                },
+                "details": {
+                  "$ref": "ComposeDetails",
+                  "description": "The $(ref:compose.ComposeDetails) of the saved message."
                 }
               }
             }
@@ -7612,6 +7704,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "compose_action": {
+              "description": "Defines the appearance and behavior of a composeAction button in the message compose window.",
               "type": "object",
               "additionalProperties": {
                 "$ref": "UnrecognizedProperty"
@@ -8445,11 +8538,96 @@
               ]
             }
           ]
+        },
+        {
+          "id": "ComposeScript",
+          "type": "object",
+          "description": "A script and/or CSS to inject into compose windows via the manifest.",
+          "properties": {
+            "js": {
+              "type": "array",
+              "optional": true,
+              "description": "The list of JavaScript files to inject.",
+              "items": {
+                "$ref": "ExtensionURL"
+              }
+            },
+            "css": {
+              "type": "array",
+              "optional": true,
+              "description": "The list of CSS files to inject.",
+              "items": {
+                "$ref": "ExtensionURL"
+              }
+            }
+          },
+          "additionalProperties": {
+            "$ref": "UnrecognizedProperty"
+          }
+        },
+        {
+          "id": "MessageDisplayScript",
+          "type": "object",
+          "description": "A script and/or CSS to inject into message display pages via the manifest.",
+          "properties": {
+            "js": {
+              "type": "array",
+              "optional": true,
+              "description": "The list of JavaScript files to inject.",
+              "items": {
+                "$ref": "ExtensionURL"
+              }
+            },
+            "css": {
+              "type": "array",
+              "optional": true,
+              "description": "The list of CSS files to inject.",
+              "items": {
+                "$ref": "ExtensionURL"
+              }
+            },
+            "run_at": {
+              "type": "string",
+              "optional": true,
+              "default": "document_idle",
+              "enum": [
+                "document_start",
+                "document_end",
+                "document_idle"
+              ],
+              "description": "Determines when the files specified in css and js are injected. The states directly correspond to <code>Document.readyState</code>: <var>loading</var>, <var>interactive</var> and <var>complete</var>."
+            }
+          },
+          "additionalProperties": {
+            "$ref": "UnrecognizedProperty"
+          }
+        },
+        {
+          "$extend": "WebExtensionManifest",
+          "properties": {
+            "compose_scripts": {
+              "type": "array",
+              "optional": true,
+              "description": "Scripts and CSS to inject into compose windows.",
+              "items": {
+                "$ref": "ComposeScript"
+              }
+            },
+            "message_display_scripts": {
+              "type": "array",
+              "optional": true,
+              "description": "Scripts and CSS to inject into message display pages.",
+              "items": {
+                "$ref": "MessageDisplayScript"
+              }
+            }
+          }
         }
       ]
     },
     {
       "namespace": "composeScripts",
+      "description": "The composeScripts API allows to register and unregister scripts for the message compose window.",
       "permissions": [
         "compose"
       ],
@@ -8510,6 +8688,7 @@
     },
     {
       "namespace": "messageDisplayScripts",
+      "description": "The messageDisplayScripts API allows to register and unregister scripts for the message display window.",
       "permissions": [
         "messagesModify"
       ],
@@ -9918,7 +10097,7 @@
             {
               "name": "key",
               "type": "string",
-              "description": "The tag key of the requested folder. See $(ref:messages.tags.list()) for the available tags. Throws when specifying an invalid tag key."
+              "description": "The tag key of the requested folder. See $(ref:messages.tags.list) for the available tags. Throws when specifying an invalid tag key."
             },
             {
               "type": "function",
@@ -10855,7 +11034,7 @@
         {
           "name": "getListedMessages",
           "type": "function",
-          "description": "Lists the messages in the current view, honoring sort order and filters.",
+          "description": "Lists the messages in the current view, honoring sort order and filters as used in the UI. Sort order of the returned messages can be overridden via the <var>options</var> parameter",
           "permissions": [
             "messagesRead"
           ],
@@ -10868,6 +11047,40 @@
               "optional": true,
               "minimum": 1
             },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "sortType": {
+                  "type": "string",
+                  "description": "Specifies how the returned messages should be sorted. This does not change the actual sort of the displayed messages. Default sort order is <var>descending</var>, if not specified otherwise. Returning sorted messages is faster than manually sorting the messages afterwards, but slower than returning the messages in their original order.",
+                  "optional": true,
+                  "enum": [
+                    "author",
+                    "date",
+                    "flagged",
+                    "junk",
+                    "junkScore",
+                    "priority",
+                    "read",
+                    "recipients",
+                    "size",
+                    "subject",
+                    "tags"
+                  ]
+                },
+                "sortOrder": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The sort order for the returned messages. Ignored if <var>sortType</var> is not specified.",
+                  "enum": [
+                    "ascending",
+                    "descending"
+                  ]
+                }
+              }
+            },
             {
               "type": "function",
               "name": "callback",
@@ -12166,6 +12379,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "message_display_action": {
+              "description": "Defines the appearance and behavior of a messageDisplayAction button in the message display window.",
               "type": "object",
               "additionalProperties": {
                 "$ref": "UnrecognizedProperty"
@@ -12992,16 +13206,28 @@
               "enum": [
                 "messagesDelete",
                 "messagesImport",
+                "messagesModifyPermanent",
                 "messagesMove",
                 "messagesRead",
+                "messages.save",
                 "messagesTags",
                 "messagesTagsList",
                 "messagesUpdate",
-                "messagesModifyPermanent",
                 "sensitiveDataUpload"
               ]
             }
           ]
+        },
+        {
+          "$extend": "OptionalOnlyPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "messages.send"
+              ]
+            }
+          ]
         }
       ]
     },
@@ -13061,6 +13287,7 @@
               }
             },
             "date": {
+              "description": "The date and time when the message was sent, according to the Date header in the message.",
               "$ref": "extensionTypes.Date"
             },
             "external": {
@@ -13097,6 +13324,18 @@
               "minimum": 0,
               "maximum": 100
             },
+            "priority": {
+              "type": "string",
+              "description": "The priority of the message.",
+              "enum": [
+                "none",
+                "lowest",
+                "low",
+                "normal",
+                "high",
+                "highest"
+              ]
+            },
             "read": {
               "type": "boolean",
               "optional": true,
@@ -13180,15 +13419,9 @@
               ]
             },
             "headers": {
-              "type": "object",
+              "$ref": "messages.HeadersDictionary",
               "description": "A <em>dictionary object</em> of RFC 2047 decoded part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>. Only present if requested, see the <var>decodeHeaders</var> option of $(ref:messages.getFull).",
-              "optional": true,
-              "additionalProperties": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
+              "optional": true
             },
             "name": {
               "type": "string",
@@ -13214,15 +13447,9 @@
               "optional": true
             },
             "rawHeaders": {
-              "type": "object",
+              "$ref": "messages.HeadersDictionary",
               "description": "A <em>dictionary object</em> of raw part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>. Only present if requested, see the <var>decodeHeaders</var> option of $(ref:messages.getFull).",
-              "optional": true,
-              "additionalProperties": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
+              "optional": true
             },
             "size": {
               "type": "integer",
@@ -13266,6 +13493,18 @@
             }
           }
         },
+        {
+          "id": "AttachmentType",
+          "type": "string",
+          "enum": [
+            "normal",
+            "detached",
+            "deleted",
+            "linked",
+            "cloudFile"
+          ],
+          "description": "The type of an attachment in a message."
+        },
         {
           "id": "MessageAttachment",
           "type": "object",
@@ -13279,19 +13518,17 @@
               "type": "string",
               "description": "The content type of the attachment. A value of <var>text/x-moz-deleted</var> indicates that the original attachment was permanently deleted and replaced by a placeholder text attachment with some meta information about the original attachment."
             },
+            "type": {
+              "$ref": "messages.AttachmentType",
+              "description": "The type of this attachment."
+            },
             "headers": {
-              "type": "object",
-              "description": "A <em>dictionary object</em> of RFC 2047 decoded attachment headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
-              "additionalProperties": {
-                "type": "array",
-                "items": {
-                  "type": "string"
-                }
-              }
+              "$ref": "messages.HeadersDictionary",
+              "description": "A <em>dictionary object</em> of RFC 2047 decoded attachment headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>."
             },
             "name": {
               "type": "string",
-              "description": "The name, as displayed to the user, of this attachment. This is usually but not always the filename of the attached file."
+              "description": "The name, as displayed to the user, of this attachment. This is usually but not always the filename of the attached file. For a <var>cloudFile</var> attachment, this is the real name of the linked file, when the message provides one."
             },
             "partName": {
               "type": "string",
@@ -13301,10 +13538,20 @@
               "type": "integer",
               "description": "The size in bytes of this attachment."
             },
-            "contentId": {
+            "linkUrl": {
               "type": "string",
               "optional": true,
-              "description": "The content-id of this part. Available for related parts, which are referenced from other places inside the same message (e.g. inline images)."
+              "description": "The remote location the attachment's content is linked to. Present for <var>linked</var> attachments (see $(ref:messages.AttachmentType)), whose content is not part of the message and can be fetched from this url."
+            },
+            "cloudFileUrl": {
+              "type": "string",
+              "optional": true,
+              "description": "The remote location a <var>cloudFile</var> attachment's content is stored at. Present for <var>cloudFile</var> attachments (see $(ref:messages.AttachmentType)), whose content is not part of the message."
+            },
+            "contentId": {
+              "type": "string",
+              "optional": true,
+              "description": "The content-id of this part. Available for related parts, which are referenced from other places inside the same message (e.g. inline images)."
             },
             "message": {
               "$ref": "messages.MessageHeader",
@@ -13313,6 +13560,17 @@
             }
           }
         },
+        {
+          "id": "HeadersDictionary",
+          "type": "object",
+          "description": "A <em>dictionary object</em> of headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
         {
           "id": "QueryRange",
           "type": "object",
@@ -13329,6 +13587,176 @@
               "description": "The maximum value required to match the query."
             }
           }
+        },
+        {
+          "id": "NewMessageDetails",
+          "type": "object",
+          "description": "Details of a message to be sent.",
+          "additionalProperties": true,
+          "properties": {
+            "identityId": {
+              "type": "string",
+              "description": "The ID of an identity from the :doc:`accounts` API. Defaults to the default identity. The permission <permission>accountsRead</permission> is required to include the ``identityId``.",
+              "optional": true
+            },
+            "from": {
+              "$ref": "compose.ComposeRecipient",
+              "description": "*Caution*: Setting a value for ``from`` does not change the used identity, it overrides the FROM header. Many email servers do not accept emails where the FROM header does not match the sender identity. Must be set to exactly one valid email address.",
+              "optional": true
+            },
+            "to": {
+              "$ref": "compose.ComposeRecipientList",
+              "optional": true
+            },
+            "cc": {
+              "$ref": "compose.ComposeRecipientList",
+              "optional": true
+            },
+            "bcc": {
+              "$ref": "compose.ComposeRecipientList",
+              "optional": true
+            },
+            "overrideDefaultFccFolder": {
+              "choices": [
+                {
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    ""
+                  ]
+                }
+              ],
+              "optional": true,
+              "description": " This value overrides the default fcc setting (defined by the used identity) for this message. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
+            },
+            "additionalFccFolder": {
+              "choices": [
+                {
+                  "$ref": "folders.MailFolder"
+                },
+                {
+                  "type": "string",
+                  "enum": [
+                    ""
+                  ]
+                }
+              ],
+              "description": "An additional fcc folder. Only effective for send operations ($(ref:messages.sendMessage)), has no effect for save operations ($(ref:messages.saveMessage)), which only ever store the message in the primary draft or template folder. For compatibility with :ref:`compose.ComposeDetails`, setting an empty string is supported as well, but has no effect.",
+              "optional": true
+            },
+            "replyTo": {
+              "$ref": "compose.ComposeRecipientList",
+              "optional": true
+            },
+            "followupTo": {
+              "$ref": "compose.ComposeRecipientList",
+              "optional": true
+            },
+            "newsgroups": {
+              "description": "A single newsgroup name or an array of newsgroup names.",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "optional": true
+            },
+            "subject": {
+              "type": "string"
+            },
+            "body": {
+              "type": "string",
+              "description": "The HTML content for the message.",
+              "optional": true
+            },
+            "plainTextBody": {
+              "type": "string",
+              "description": "The content for a plain text message. A specified <value>body</value> will be preferred, except when <value>isPlainText</value> is specified as well.",
+              "optional": true
+            },
+            "isPlainText": {
+              "type": "boolean",
+              "description": "Whether the message should be sent as plain text or as HTML. Prefers a specified <value>plainTextBody</value> over a specified <value>body</value>.",
+              "optional": true
+            },
+            "deliveryFormat": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "plaintext",
+                "html",
+                "both"
+              ],
+              "description": "Defines the mime format of the sent message. Defaults to <value>auto</value>, which prefers to send plain text messages, if the specified body does not include any formatting.\n**Note**: If a plain text body and an HTML body is included in the message, the plain text body is always derived from the included HTML body. It is not possible to specify two independent values via <value>body</value> and <value>plainTextBody</value>.",
+              "optional": true
+            },
+            "contentLanguage": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "The languages of the message content, used for the <em>Content-Language</em> header. Each entry is a free-form language tag (for example <var>en-US</var>). If omitted, no <em>Content-Language</em> header is added. The i18n API's <var>detectLanguage()</var> can be used to derive a value from the message body, which should be converted to plain text first (for example via $(ref:messengerUtilities.convertToPlainText)), so that markup does not influence the detection.",
+              "optional": true
+            },
+            "customHeaders": {
+              "type": "array",
+              "items": {
+                "$ref": "compose.CustomHeader"
+              },
+              "description": "Array of custom headers.",
+              "optional": true
+            },
+            "priority": {
+              "type": "string",
+              "enum": [
+                "lowest",
+                "low",
+                "normal",
+                "high",
+                "highest"
+              ],
+              "description": "The priority of the message.",
+              "optional": true
+            },
+            "returnReceipt": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Add the <em>Disposition-Notification-To</em> header to the message to requests the recipients email client to send a reply once the message has been received. Recipient server may strip the header and the recipient might ignore the request."
+            },
+            "deliveryStatusNotification": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Let the sender know when the recipient's server received the message. Not supported by all servers."
+            },
+            "attachVCard": {
+              "type": "boolean",
+              "optional": true,
+              "description": "Wether or not the vCard of the used identity will be attached to the message during send."
+            },
+            "attachments": {
+              "type": "array",
+              "items": {
+                "choices": [
+                  {
+                    "$ref": "compose.FileAttachment"
+                  },
+                  {
+                    "$ref": "compose.ComposeAttachment"
+                  }
+                ]
+              },
+              "description": "Attachments to add to the message. **Note:** :ref:`compose.ComposeAttachments` are included as real file attachments, not as cloudFile links.",
+              "optional": true
+            }
+          }
         }
       ],
       "events": [
@@ -13443,6 +13871,40 @@
               "name": "folderId",
               "$ref": "folders.MailFolderId"
             },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "sortType": {
+                  "type": "string",
+                  "description": "Specifies how the returned messages should be sorted. Default sort order is <var>descending</var>, if not specified otherwise. Returning sorted messages is faster than manually sorting the messages afterwards, but slower than returning the messages in their original order.",
+                  "optional": true,
+                  "enum": [
+                    "author",
+                    "date",
+                    "flagged",
+                    "junk",
+                    "junkScore",
+                    "priority",
+                    "read",
+                    "recipients",
+                    "size",
+                    "subject",
+                    "tags"
+                  ]
+                },
+                "sortOrder": {
+                  "type": "string",
+                  "description": "The sort order for the returned messages. Ignored if <var>sortType</var> is not specified.",
+                  "optional": true,
+                  "enum": [
+                    "ascending",
+                    "descending"
+                  ]
+                }
+              }
+            },
             {
               "type": "function",
               "name": "callback",
@@ -13477,6 +13939,40 @@
                 }
               ]
             },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "sortType": {
+                  "type": "string",
+                  "description": "Specifies how the returned messages should be sorted. Default sort order is <var>descending</var>, if not specified otherwise. Returning sorted messages is faster than manually sorting the messages afterwards, but slower than returning the messages in their original order.",
+                  "optional": true,
+                  "enum": [
+                    "author",
+                    "date",
+                    "flagged",
+                    "junk",
+                    "junkScore",
+                    "priority",
+                    "read",
+                    "recipients",
+                    "size",
+                    "subject",
+                    "tags"
+                  ]
+                },
+                "sortOrder": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The sort order for the returned messages. Ignored if <var>sortType</var> is not specified.",
+                  "enum": [
+                    "ascending",
+                    "descending"
+                  ]
+                }
+              }
+            },
             {
               "type": "function",
               "name": "callback",
@@ -13589,6 +14085,40 @@
             }
           ]
         },
+        {
+          "name": "getHeaders",
+          "type": "function",
+          "description": "Returns all message headers of the specified message, without MIME structure parsing. Throws an error if the message cannot be read, for example due to network issues. This function is significantly faster than $(ref:messages.getFull) when only the header information is required.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "messageId",
+              "$ref": "messages.MessageId"
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "properties": {
+                "decodeHeaders": {
+                  "type": "boolean",
+                  "description": "Whether to decode RFC 2047 encoded headers. Defaults to <var>true</var>.",
+                  "optional": true
+                }
+              },
+              "optional": true
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "messages.HeadersDictionary"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "getRaw",
           "type": "function",
@@ -13666,7 +14196,7 @@
         {
           "name": "listAttachments",
           "type": "function",
-          "description": "Lists the attachments of a message.",
+          "description": "Lists the attachments of a message. If the message is encrypted, the attachments of the decrypted message are listed.",
           "async": "callback",
           "parameters": [
             {
@@ -13691,7 +14221,7 @@
         {
           "name": "listInlineTextParts",
           "type": "function",
-          "description": "Lists all inline text parts of a message. These parts are not returned by $(ref:messages.listAttachments) and usually make up the readable content of the message, mostly with content type <var>text/plain</var> or <var>text/html</var>. If a message only includes a part with content type <var>text/html</var>, the method $(ref:messengerUtilities.convertToPlainText) can be used to retreive a plain text version.",
+          "description": "Lists all inline text parts of a message. These parts are not returned by $(ref:messages.listAttachments) and usually make up the readable content of the message, mostly with content type <var>text/plain</var> or <var>text/html</var>. If a message only includes a part with content type <var>text/html</var>, the method $(ref:messengerUtilities.convertToPlainText) can be used to retreive a plain text version. If the message is encrypted, the inline text parts of the decrypted message are listed.",
           "async": "callback",
           "parameters": [
             {
@@ -13716,7 +14246,7 @@
         {
           "name": "getAttachmentFile",
           "type": "function",
-          "description": "Gets the content of a $(ref:messages.MessageAttachment) as a $(url:dom-file)[File] object.",
+          "description": "Gets the content of a $(ref:messages.MessageAttachment) as a $(url:dom-file)[File] object. If the message is encrypted, the function retrieves the attachment from the decrypted message.",
           "async": "callback",
           "parameters": [
             {
@@ -13725,6 +14255,7 @@
             },
             {
               "name": "partName",
+              "description": "The <var>partName</var> of an attachment to be retrieved from the decrypted message.",
               "type": "string",
               "pattern": "^\\d+(\\.\\d+\\$?)*$"
             },
@@ -13745,7 +14276,7 @@
         {
           "name": "deleteAttachments",
           "type": "function",
-          "description": "Deletes the specified attachments and replaces them by placeholder text attachments with meta information about the original attachments and a <var>text/x-moz-deleted</var> content type. This permanently modifies the message.",
+          "description": "Deletes the specified attachments and replaces them by placeholder text attachments with meta information about the original attachments and a <var>text/x-moz-deleted</var> content type. This permanently modifies the message. Deleting attachments of encrypted messages is not supported and will throw an <em>ExtensionError</em>.",
           "permissions": [
             "messagesModifyPermanent"
           ],
@@ -14306,6 +14837,126 @@
             }
           ]
         },
+        {
+          "name": "sendMessage",
+          "permissions": [
+            "messages.send"
+          ],
+          "type": "function",
+          "description": "Sends a message programmatically in the background without user interaction. If the send mode is not specified or set to <value>default</value>, the message will be sent directly if the user is online and placed in the user's outbox otherwise. The returned Promise fulfills once the message has been successfully sent or placed in the user's outbox. Throws when there has been an error while sending the message to the outgoing mail server.\n**Note:** If no <value>deliveryFormat</value> is specified, the message is sent as plain text when the body contains no HTML formatting.\n**Note:** It is possible to pass in a :ref:`compose.ComposeDetails` object as the <value>details</value> parameter, and it will be interpreted as a :ref:`messages.NewMessageDetails` object.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "details",
+              "$ref": "messages.NewMessageDetails"
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "sendNow",
+                    "sendLater"
+                  ]
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "return",
+                  "type": "object",
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "description": "The used send mode.",
+                      "enum": [
+                        "sendNow",
+                        "sendLater"
+                      ]
+                    },
+                    "headerMessageId": {
+                      "type": "string",
+                      "description": "The header messageId of the outgoing message. Only included for actually sent messages.",
+                      "optional": true
+                    },
+                    "messages": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "messages.MessageHeader"
+                      },
+                      "description": "Copies of the sent message. The number of created copies depends on the applied file carbon copy configuration (fcc)."
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "saveMessage",
+          "permissions": [
+            "messages.save"
+          ],
+          "type": "function",
+          "description": "Saves a message programmatically as a draft or as a template in the background without user interaction. The save mode defaults to <value>draft</value>. The returned Promise fulfills once the message has been successfully saved. Throws when there has been an error while saving the message.\n**Note:** If no <value>deliveryFormat</value> is specified, the message is saved as plain text when the body contains no HTML formatting.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "details",
+              "$ref": "NewMessageDetails"
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "mode": {
+                  "type": "string",
+                  "enum": [
+                    "draft",
+                    "template"
+                  ]
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "name": "return",
+                  "type": "object",
+                  "properties": {
+                    "mode": {
+                      "type": "string",
+                      "description": "The used save mode.",
+                      "enum": [
+                        "draft",
+                        "template"
+                      ]
+                    },
+                    "messages": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "messages.MessageHeader"
+                      },
+                      "description": "The saved message(s). The number of saved messages depends on the applied file carbon copy configuration (fcc)."
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "archive",
           "type": "function",
@@ -14499,10 +15150,11 @@
             },
             "mode": {
               "type": "string",
-              "description": "Whether all of the tag filters must apply, or any of them.",
+              "description": "Whether <var>all</var> of the tag filters must apply, <var>any</var> of them, or <var>none</var>. The <var>none</var> mode ignores the provided filters and selects only messages without any tags.",
               "enum": [
                 "all",
-                "any"
+                "any",
+                "none"
               ]
             }
           }
@@ -14553,7 +15205,7 @@
           "type": "function",
           "description": "Fired when a message tag has been deleted.",
           "permissions": [
-            "accountsRead"
+            "messagesTagsList"
           ],
           "parameters": [
             {
@@ -14589,6 +15241,32 @@
             }
           ]
         },
+        {
+          "name": "get",
+          "type": "function",
+          "description": "Returns a message tag identified by its key.",
+          "async": "callback",
+          "permissions": [
+            "messagesTagsList"
+          ],
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "The key of the message tag to retrieve."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "$ref": "messages.tags.MessageTag"
+                }
+              ]
+            }
+          ]
+        },
         {
           "name": "create",
           "type": "function",
@@ -14694,13 +15372,21 @@
         "messengerSettings"
       ],
       "properties": {
-        "messagePlainTextFlowedOutputEnabled": {
+        "composeInlineSpellCheckEnabled": {
           "$ref": "types.Setting",
-          "description": "Whether long lines in outgoing plain text messages will get soft line breaks (<var> \n</var>) or hard line breaks (<var>\n</var>), to comply with requirements from RFC 2822. Soft line breaks will be ignored when displayed by the receiving client. When flowed output is enabled, add-ons should not create plain text messages with manually inserted hard or soft line breaks to achieve a certain text width, as that will most probably interfere with the default line break handling and generate ridged text. When flowed output is disabled, add-ons could add hard line breaks to have control over the final message, but any line longer than the maximum line length will still receive additional hard line breaks. See $(ref:messengerSettings.messageLineLengthLimit)."
+          "description": "Whether the inline (real-time) spell checker is enabled in the message compose window."
         },
         "messageLineLengthLimit": {
           "$ref": "types.Setting",
-          "description": "The line length limit for outgoing messages, to comply with requirements from RFC 2822. See description of $(ref:messengerSettings.messagePlainTextFlowedOutputEnabled)."
+          "description": "The line length limit for outgoing messages, to comply with requirements from RFC 2822. See description of $(ref:messengerSettings.messagePlainTextFlowedOutputEnabled). This property is read-only."
+        },
+        "messagePlainTextFlowedOutputEnabled": {
+          "$ref": "types.Setting",
+          "description": "Whether long lines in outgoing plain text messages will get soft line breaks (<var> \n</var>) or hard line breaks (<var>\n</var>), to comply with requirements from RFC 2822. Soft line breaks will be ignored when displayed by the receiving client. When flowed output is enabled, add-ons should not create plain text messages with manually inserted hard or soft line breaks to achieve a certain text width, as that will most probably interfere with the default line break handling and generate ridged text. When flowed output is disabled, add-ons could add hard line breaks to have control over the final message, but any line longer than the maximum line length will still receive additional hard line breaks. See $(ref:messengerSettings.messageLineLengthLimit). This property is read-only."
+        },
+        "readerDisplayAttachmentsInline": {
+          "$ref": "types.Setting",
+          "description": "Whether supported attachments (for example, media files) are shown inline within the body of displayed messages. This property is read-only."
         }
       }
     }
@@ -14832,10 +15518,33 @@
               "description": "The string to be parsed (e.g. <var>User <user@example.com>, other-user@example.com</var>)"
             },
             {
-              "type": "boolean",
-              "name": "preserveGroups",
+              "name": "options",
               "optional": true,
-              "description": "Keep grouped hierarchies. Groups may be specified in a mailbox string as follows: <var>GroupName : user1 <user1@example.com>, user2@example,com ;</var>."
+              "choices": [
+                {
+                  "type": "boolean",
+                  "deprecated": "Specify the options object instead of a plain boolean to preserve groups.",
+                  "description": "Keep grouped hierarchies. Groups may be specified in a mailbox string as follows: <var>GroupName : user1 <user1@example.com>, user2@example,com ;</var>."
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "preserveGroups": {
+                      "type": "boolean",
+                      "optional": true,
+                      "description": "Keep grouped hierarchies. Groups may be specified in a mailbox string as follows: <var>GroupName : user1 <user1@example.com>, user2@example,com ;</var>."
+                    },
+                    "expandMailingLists": {
+                      "type": "boolean",
+                      "optional": true,
+                      "permissions": [
+                        "addressBooks"
+                      ],
+                      "description": "Expand Thunderbird mailing lists (specified as <var>ListName <ListName></var>) and include the parsed primary email addresses of all members. When used together with <var>preserveGroups</var>, the mailing list's name and hierarchy are preserved. If the mailing list does not exist, or the <permission>addressBook</permission> permission is not granted, the entries are not expanded and returned unchanged."
+                    }
+                  }
+                }
+              ]
             },
             {
               "type": "function",
@@ -14953,7 +15662,7 @@
           "$extend": "WebExtensionManifest",
           "properties": {
             "oauth_provider": {
-              "description": "Describes an OAuth authentication provider for Thunderbird to use when connecting to mail/address book/calendar services. You will need to have a client ID registered with the provider to use this API.",
+              "description": "Describes an OAuth authentication provider for Thunderbird. You will need to have a client ID registered with the provider to use this API.",
               "type": "object",
               "properties": {
                 "issuer": {
@@ -14969,6 +15678,11 @@
                   "type": "string",
                   "optional": true
                 },
+                "issuerIdentifier": {
+                  "description": "The OAuth authorization server issuer identifier, as defined by RFC 9207. If provided, it <em>must</em> be an exact string match to what the provider gives in the iss field.",
+                  "type": "string",
+                  "optional": true
+                },
                 "authorizationEndpoint": {
                   "description": "OAuth authorization endpoint address.",
                   "type": "string",
@@ -14981,14 +15695,18 @@
                 },
                 "redirectionEndpoint": {
                   "description": "OAuth redirection endpoint.",
-                  "type": "string",
-                  "format": "url"
+                  "type": "string"
                 },
                 "usePKCE": {
                   "description": "If the authorization uses PKCE.",
                   "type": "boolean",
                   "optional": true
                 },
+                "useExternalBrowser": {
+                  "description": "If the login flow should use the system web browser. If true, the redirectionEndpoint <em>must</em> be a loopback address, so an origin of http://127.0.0.1 or http://localhost.",
+                  "type": "boolean",
+                  "optional": true
+                },
                 "hostnames": {
                   "description": "One or more hostnames which use this OAuth provider.",
                   "type": "array",
@@ -15797,6 +16515,12 @@
               "optional": true,
               "minimum": -1,
               "description": "The ID of the group that the tab belongs to. -1 if the tab does not belong to a tab group."
+            },
+            "splitViewId": {
+              "type": "integer",
+              "optional": true,
+              "minimum": -1,
+              "description": "The ID of the Split View that the tab belongs to. -1 if the tab does not belong to a split view."
             }
           }
         },
@@ -15960,6 +16684,11 @@
                   "optional": true,
                   "minimum": 0,
                   "description": "Open a port to a specific frame identified by <var>frameId</var> instead of all frames in the tab."
+                },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Open a port to a specific document identified by <var>documentId</var> instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -15994,6 +16723,11 @@
                   "optional": true,
                   "minimum": 0,
                   "description": "Send a message to a specific frame identified by <var>frameId</var> instead of all frames in the tab."
+                },
+                "documentId": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Send a message to a specific document identified by <var>documentId</var> instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -16176,7 +16910,7 @@
                 "title": {
                   "type": "string",
                   "optional": true,
-                  "description": "Match page titles against a pattern."
+                  "description": "Match page titles against a pattern. The <permission>tabs</permission> permission is required to use this property."
                 },
                 "url": {
                   "choices": [
@@ -16191,7 +16925,7 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Match tabs against one or more $(url:match-patterns)[URL Patterns]. Fragment identifiers are not matched."
+                  "description": "Match tabs against one or more $(url:match-patterns)[URL Patterns]. Fragment identifiers are not matched. The <permission>tabs</permission> permission is required to use this property."
                 },
                 "windowId": {
                   "type": "integer",
@@ -16290,7 +17024,7 @@
         {
           "name": "move",
           "type": "function",
-          "description": "Moves one or more tabs to a new position within its current window, or to a different window. Tabs can only be moved to and from windows of type <var>normal</var>.",
+          "description": "Moves one or more tabs to a new position within its current window, or to a different window. Tabs can only be moved to and from windows of type <var>normal</var>. The primary mail tab cannot be moved, attempting to actively reposition it will throw an <em>ExtensionError</em>. Other tabs also cannot be placed before the primary mail tab, they will automatically be positioned after it, ensuring that the primary mail tab always remains first.",
           "async": "callback",
           "parameters": [
             {