webext-schema 2.0.5 → 2.0.9

package/schemas/mail/mailext.json

@@ -331,6 +331,22 @@
               "$ref": "extensionTypes.RunAt",
               "optional": true,
               "description": "The soonest that the JavaScript or CSS will be injected into the tab. Defaults to \"document_idle\"."
+            },
+            "cookieStoreId": {
+              "choices": [
+                {
+                  "type": "array",
+                  "minItems": 1,
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "optional": true,
+              "description": "limit the set of matched tabs to those that belong to the given cookie store id"
             }
           }
         },
@@ -2963,6 +2979,59 @@
             }
           ]
         }
+      ],
+      "events": [
+        {
+          "name": "onCreated",
+          "type": "function",
+          "description": "Fired when a new account has been created.",
+          "parameters": [
+            {
+              "name": "id",
+              "type": "string"
+            },
+            {
+              "name": "account",
+              "$ref": "MailAccount"
+            }
+          ]
+        },
+        {
+          "name": "onDeleted",
+          "type": "function",
+          "description": "Fired when an account has been removed.",
+          "parameters": [
+            {
+              "name": "id",
+              "type": "string"
+            }
+          ]
+        },
+        {
+          "name": "onUpdated",
+          "type": "function",
+          "description": "Fired when a property of an account has been modified. Folders and identities of accounts are not monitored by this event, use the dedicated folder and identity events instead. A changed ``defaultIdentity`` is reported only after a different identity has been assigned as default identity, but not after a property of the default identity has been changed.",
+          "parameters": [
+            {
+              "name": "id",
+              "type": "string"
+            },
+            {
+              "name": "changedValues",
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "The human-friendly name of this account."
+                },
+                "defaultIdentity": {
+                  "$ref": "identities.MailIdentity",
+                  "description": "The default identity of this account."
+                }
+              }
+            }
+          ]
+        }
       ]
     }
   ],
@@ -3243,7 +3312,7 @@
             {
               "name": "query",
               "type": "string",
-              "description": "The boolean query expression corresponding to the search. Note: This parameter may change in future releases of Thunderbird.",
+              "description": "The boolean query expression corresponding to the search. **Note:** This parameter may change in future releases of Thunderbird.",
               "optional": true
             }
           ],
@@ -3936,7 +4005,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "description": "Specifies icons to use for dark and light themes"
+                  "description": "Specifies dark and light icons to be used with themes. The ``light`` icon is used on dark backgrounds and vice versa. **Note:** The default theme uses the ``default_icon`` for light backgrounds (if specified)."
                 },
                 "default_popup": {
                   "type": "string",
@@ -4448,7 +4517,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a browserAction icon is clicked.  This event will not fire if the browserAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a browserAction icon is clicked. This event will not fire if the browserAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -4676,7 +4745,7 @@
               "properties": {
                 "browser_style": {
                   "type": "boolean",
-                  "description": "Enable browser styles. See the `MDN documentation <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
+                  "description": "Enable browser styles in the ``management_url`` page. See the `MDN documentation <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
                   "optional": true,
                   "default": false
                 },
@@ -4690,6 +4759,12 @@
                     "File"
                   ]
                 },
+                "reuse_uploads": {
+                  "description": "If a previously uploaded cloud file attachment is reused at a later time in a different message, Thunderbird may use the already known ``url`` and ``templateInfo`` values without triggering the registered :ref:`cloudFile.onFileUpload` listener again. Setting this option to false will always trigger the registered listener, providing the already known values through the ``relatedFileInfo`` parameter of the :ref:`cloudFile.onFileUpload` event, to let the provider decide how to handle these cases.",
+                  "type": "boolean",
+                  "optional": true,
+                  "default": true
+                },
                 "management_url": {
                   "type": "string",
                   "format": "relativeUrl",
@@ -4710,7 +4785,8 @@
                 "service_url": {
                   "type": "string",
                   "optional": true,
-                  "description": "URL to the web page of the cloud file service."
+                  "deprecated": true,
+                  "description": "This property is no longer used. The ``service_url`` property of the :ref:`cloudFile.CloudFileTemplateInfo` object returned by the :ref:`cloudFile.onFileUpload` event can be used to add a ``Learn more about`` link to the footer of the cloud file attachment element."
                 }
               },
               "optional": true
@@ -4747,6 +4823,12 @@
               "name": "tab",
               "$ref": "tabs.Tab",
               "description": "The tab where the upload was initiated. Currently only available for the message composer."
+            },
+            {
+              "$ref": "RelatedCloudFile",
+              "name": "relatedFileInfo",
+              "optional": true,
+              "description": "Information about an already uploaded file, which is related to this upload."
             }
           ],
           "returns": {
@@ -4757,6 +4839,18 @@
                 "description": "Set this to true if the file upload was aborted.",
                 "optional": true
               },
+              "error": {
+                "choices": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ],
+                "description": "Report an error to the user. Set this to true for showing a generic error message, or set a specific error message.",
+                "optional": true
+              },
               "url": {
                 "type": "string",
                 "description": "The URL where the uploaded file can be accessed.",
@@ -4764,7 +4858,7 @@
               },
               "templateInfo": {
                 "$ref": "CloudFileTemplateInfo",
-                "description": "Information to override the default values used in the cloud file message template.",
+                "description": "Additional file information used in the cloud file entry added to the message.",
                 "optional": true
               }
             }
@@ -4792,10 +4886,60 @@
             }
           ]
         },
+        {
+          "name": "onFileRename",
+          "type": "function",
+          "description": "Fired when a previously uploaded file should be renamed.",
+          "parameters": [
+            {
+              "name": "account",
+              "$ref": "CloudFileAccount",
+              "description": "The account used for the file upload."
+            },
+            {
+              "type": "integer",
+              "name": "fileId",
+              "minimum": 1,
+              "description": "An identifier for the file which should be renamed."
+            },
+            {
+              "type": "string",
+              "name": "newName",
+              "description": "The new name of the file."
+            },
+            {
+              "name": "tab",
+              "$ref": "tabs.Tab",
+              "description": "The tab where the rename was initiated. Currently only available for the message composer."
+            }
+          ],
+          "returns": {
+            "type": "object",
+            "properties": {
+              "error": {
+                "choices": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "string"
+                  }
+                ],
+                "description": "Report an error to the user. Set this to true for showing a generic error message, or set a specific error message.",
+                "optional": true
+              },
+              "url": {
+                "type": "string",
+                "description": "The URL where the renamed file can be accessed.",
+                "optional": true
+              }
+            }
+          }
+        },
         {
           "name": "onFileDeleted",
           "type": "function",
-          "description": "Fired when a file previously uploaded should be deleted.",
+          "description": "Fired when a previously uploaded file should be deleted.",
           "parameters": [
             {
               "name": "account",
@@ -4886,7 +5030,7 @@
         {
           "id": "CloudFileTemplateInfo",
           "type": "object",
-          "description": "Information to be used in the cloud file message template.",
+          "description": "Defines information to be used in the cloud file entry added to the message.",
           "properties": {
             "service_icon": {
               "type": "string",
@@ -4901,7 +5045,34 @@
             "service_url": {
               "type": "string",
               "optional": true,
-              "description": "An URL to the web page of the used cloud file service, attached the <code>service_name</code>. Defaults to the <code>service_url</code> manifest entry. Set to an empty string in order to not create a link."
+              "description": "A URL pointing to a web page of the used cloud file service. Will be used in a ``Learn more about`` link in the footer of the cloud file attachment element."
+            },
+            "download_password_protected": {
+              "type": "boolean",
+              "optional": true,
+              "description": "If set to true, the cloud file entry for this upload will include a hint, that the download link is password protected."
+            },
+            "download_limit": {
+              "type": "integer",
+              "optional": true,
+              "description": "If set, the cloud file entry for this upload will include a hint, that the file has a download limit."
+            },
+            "download_expiry_date": {
+              "type": "object",
+              "optional": true,
+              "description": "If set, the cloud file entry for this upload will include a hint, that the link will only be available for a limited time.",
+              "properties": {
+                "timestamp": {
+                  "type": "integer",
+                  "description": "The expiry date of the link as the number of milliseconds since the UNIX epoch."
+                },
+                "format": {
+                  "optional": true,
+                  "description": "A format options object as used by `Intl.DateTimeFormat <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat>`__. Defaults to: <literalinclude>includes/cloudFile/defaultDateFormat.js<lang>JavaScript</lang></literalinclude>",
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              }
             }
           }
         },
@@ -4936,6 +5107,37 @@
               ]
             }
           }
+        },
+        {
+          "id": "RelatedCloudFile",
+          "type": "object",
+          "description": "Information about an already uploaded cloud file, which is related to a new upload. For example if the content of a cloud attachment is updated, if a repeatedly used cloud attachment is renamed (and therefore should be re-uploaded to not invalidate existing links) or if the provider has its manifest property ``reuse_uploads`` set to ``false``.",
+          "properties": {
+            "id": {
+              "type": "integer",
+              "minimum": 1,
+              "optional": true,
+              "description": "The identifier for the related file. In some circumstances, the id is unavailable."
+            },
+            "url": {
+              "type": "string",
+              "description": "The URL where the upload of the related file can be accessed.",
+              "optional": true
+            },
+            "templateInfo": {
+              "$ref": "CloudFileTemplateInfo",
+              "description": "Additional information of the related file, used in the cloud file entry added to the message.",
+              "optional": true
+            },
+            "name": {
+              "type": "string",
+              "description": "Filename of the related file."
+            },
+            "dataChanged": {
+              "type": "boolean",
+              "description": "The content of the new upload differs from the related file."
+            }
+          }
         }
       ],
       "functions": [
@@ -5141,7 +5343,7 @@
             },
             "from": {
               "$ref": "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.",
+              "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": {
@@ -5203,34 +5405,51 @@
             },
             "body": {
               "type": "string",
+              "description": "The HTML content of the message.",
               "optional": true
             },
             "plainTextBody": {
               "type": "string",
+              "description": "The plain text content of the message.",
               "optional": true
             },
             "isPlainText": {
               "type": "boolean",
+              "description": "Whether the message is an HTML message or a plain text message.",
               "optional": true
             },
             "attachments": {
               "type": "array",
               "items": {
-                "type": "object",
-                "properties": {
-                  "name": {
-                    "type": "string",
-                    "description": "The name, as displayed to the user, of this attachment. If not specified, the name of the ``file`` object is used.",
-                    "optional": true
+                "choices": [
+                  {
+                    "$ref": "FileAttachment"
                   },
-                  "file": {
-                    "type": "object",
-                    "isInstanceOf": "File",
-                    "additionalProperties": true
+                  {
+                    "$ref": "ComposeAttachment"
                   }
-                }
+                ]
               },
-              "description": "Attachments to add to the message. Only used in the begin* functions.",
+              "description": "Only used in the begin* functions. Attachments to add to the message.",
+              "optional": true
+            }
+          }
+        },
+        {
+          "id": "FileAttachment",
+          "type": "object",
+          "description": "Object used to add, update or rename an attachment in a message being composed.",
+          "properties": {
+            "file": {
+              "type": "object",
+              "isInstanceOf": "File",
+              "additionalProperties": true,
+              "description": "The new content for the attachment.",
+              "optional": true
+            },
+            "name": {
+              "type": "string",
+              "description": "The new name for the attachment, as displayed to the user. If not specified, the name of the provided ``file`` object is used.",
               "optional": true
             }
           }
@@ -5246,22 +5465,15 @@
             },
             "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."
+              "optional": true,
+              "description": "The name of this attachment, as displayed to the user."
             },
             "size": {
               "type": "integer",
-              "description": "The size in bytes of this attachment."
-            }
-          },
-          "functions": [
-            {
-              "name": "getFile",
-              "type": "function",
-              "description": "Retrieves the contents of the attachment as a DOM ``File`` object.",
-              "async": true,
-              "parameters": []
+              "optional": true,
+              "description": "The size in bytes of this attachment. Read-only."
             }
-          ]
+          }
         }
       ],
       "events": [
@@ -5280,7 +5492,7 @@
             {
               "name": "details",
               "$ref": "ComposeDetails",
-              "description": "The current state of the compose window. This is functionally the same as the :ref:`compose.getComposeDetails` function."
+              "description": "The current state of the compose window. This is functionally the same as calling the :ref:`compose.getComposeDetails` function."
             }
           ],
           "returns": {
@@ -5294,7 +5506,7 @@
               "details": {
                 "$ref": "ComposeDetails",
                 "optional": true,
-                "description": "Updates the compose window. See the :ref:`compose.setComposeDetails` function for more information."
+                "description": "Updates the compose window. This is functionally the same as calling the :ref:`compose.setComposeDetails` function."
               }
             }
           }
@@ -5373,7 +5585,7 @@
         {
           "name": "beginNew",
           "type": "function",
-          "description": "Open a new message compose window. If the provided ComposeDetails object does not provide ``body``, ``plainTextBody`` or ``isPlainText``, the default compose format of the used/default identity is used. The :ref:`accounts_api` API can be used to get the used/default identity and its default compose format.",
+          "description": "Open a new message compose window.\n\n**Note:** The compose format can be set by ``details.isPlainText`` or by specifying only one of ``details.body`` or ``details.plainTextBody``. Otherwise the default compose format of the selected identity is used.\n\n**Note:** Specifying ``details.body`` and ``details.plainTextBody`` without also specifying ``details.isPlainText`` threw an exception in Thunderbird up to version 97. Since Thunderbird 98, this combination creates a compose window with the compose format of the selected identity, using the matching ``details.body`` or ``details.plainTextBody`` value.\n\n**Note:** If no identity is specified, this function is using the default identity and not the identity of the referenced message.",
           "async": "callback",
           "parameters": [
             {
@@ -5404,7 +5616,7 @@
         {
           "name": "beginReply",
           "type": "function",
-          "description": "Open a new message compose window replying to a given message. If the provided ComposeDetails object does not provide ``body``, ``plainTextBody`` or ``isPlainText``, the default compose format of the used/default identity is used. The :ref:`accounts_api` API can be used to get the used/default identity and its default compose format.",
+          "description": "Open a new message compose window replying to a given message.\n\n**Note:** The compose format can be set by ``details.isPlainText`` or by specifying only one of ``details.body`` or ``details.plainTextBody``. Otherwise the default compose format of the selected identity is used.\n\n**Note:** Specifying ``details.body`` and ``details.plainTextBody`` without also specifying ``details.isPlainText`` threw an exception in Thunderbird up to version 97. Since Thunderbird 98, this combination creates a compose window with the compose format of the selected identity, using the matching ``details.body`` or ``details.plainTextBody`` value.\n\n**Note:** If no identity is specified, this function is using the default identity and not the identity of the referenced message.",
           "async": "callback",
           "parameters": [
             {
@@ -5444,7 +5656,7 @@
         {
           "name": "beginForward",
           "type": "function",
-          "description": "Open a new message compose window forwarding a given message. If the provided ComposeDetails object does not provide ``body``, ``plainTextBody`` or ``isPlainText``, the default compose format of the used/default identity is used. The :ref:`accounts_api` API can be used to get the used/default identity and its default compose format.",
+          "description": "Open a new message compose window forwarding a given message.\n\n**Note:** The compose format can be set by ``details.isPlainText`` or by specifying only one of ``details.body`` or ``details.plainTextBody``. Otherwise the default compose format of the selected identity is used.\n\n**Note:** Specifying ``details.body`` and ``details.plainTextBody`` without also specifying ``details.isPlainText`` threw an exception in Thunderbird up to version 97. Since Thunderbird 98, this combination creates a compose window with the compose format of the selected identity, using the matching ``details.body`` or ``details.plainTextBody`` value.\n\n**Note:** If no identity is specified, this function is using the default identity and not the identity of the referenced message.",
           "async": "callback",
           "parameters": [
             {
@@ -5510,7 +5722,7 @@
           "name": "setComposeDetails",
           "type": "function",
           "async": true,
-          "description": "Updates the compose window. Specify only fields that you want to change. Currently only the to/cc/bcc/replyTo/followupTo/newsgroups fields and the subject are implemented. It is not possible to change the compose format.",
+          "description": "Updates the compose window. Only fields that are to be changed should be specified. Currently only a limited amount of information can be set, more will be added in later versions.\n\n**Note:** The compose format of an existing compose window cannot be changed. Since Thunderbird 98, setting conflicting values for ``details.body``, ``details.plainTextBody`` or ``details.isPlaintext`` no longer throw an exception, instead the compose window chooses the matching ``details.body`` or ``details.plainTextBody`` value and ignores the other.",
           "permissions": [
             "compose"
           ],
@@ -5522,8 +5734,7 @@
             },
             {
               "name": "details",
-              "$ref": "ComposeDetails",
-              "description": "The compose format of an already opened compose window cannot be changed. Setting ``details.body``, ``details.plainTextBody`` or ``details.isPlaintext`` will fail if the compose format of the compose window does not match. Use :ref:`compose.getComposeDetails` to get the current compose format."
+              "$ref": "ComposeDetails"
             }
           ]
         },
@@ -5546,17 +5757,35 @@
               "optional": true,
               "parameters": [
                 {
-                  "choices": [
-                    {
-                      "type": "array",
-                      "items": {
-                        "$ref": "ComposeAttachment"
-                      }
-                    },
-                    {
-                      "type": "any"
-                    }
-                  ]
+                  "type": "array",
+                  "items": {
+                    "$ref": "ComposeAttachment"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "getAttachmentFile",
+          "type": "function",
+          "description": "Gets the content of a :ref:`compose.ComposeAttachment` as a DOM <code>File</code> object.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "id",
+              "type": "integer",
+              "description": "The unique identifier for the attachment."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "object",
+                  "isInstanceOf": "File",
+                  "additionalProperties": true
                 }
               ]
             }
@@ -5576,20 +5805,15 @@
               "type": "integer"
             },
             {
-              "name": "data",
-              "type": "object",
-              "properties": {
-                "name": {
-                  "type": "string",
-                  "description": "The name, as displayed to the user, of this attachment. If not specified, the name of the ``file`` object is used.",
-                  "optional": true
+              "name": "attachment",
+              "choices": [
+                {
+                  "$ref": "FileAttachment"
                 },
-                "file": {
-                  "type": "object",
-                  "isInstanceOf": "File",
-                  "additionalProperties": true
+                {
+                  "$ref": "ComposeAttachment"
                 }
-              }
+              ]
             },
             {
               "type": "function",
@@ -5597,14 +5821,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "choices": [
-                    {
-                      "$ref": "ComposeAttachment"
-                    },
-                    {
-                      "type": "any"
-                    }
-                  ]
+                  "$ref": "ComposeAttachment"
                 }
               ]
             }
@@ -5613,7 +5830,7 @@
         {
           "name": "updateAttachment",
           "type": "function",
-          "description": "Renames and/or replaces the contents of an attachment to the message being composed in the specified tab.",
+          "description": "Updates the name and/or the content of an attachment in the message being composed in the specified tab. If the specified attachment is a cloud file attachment and the associated provider failed to update the attachment, the function will throw an ``ExtensionError``.",
           "permissions": [
             "compose"
           ],
@@ -5628,21 +5845,8 @@
               "type": "integer"
             },
             {
-              "name": "data",
-              "type": "object",
-              "properties": {
-                "name": {
-                  "type": "string",
-                  "description": "The name, as displayed to the user, of this attachment. If not specified, the name of the ``file`` object is used.",
-                  "optional": true
-                },
-                "file": {
-                  "type": "object",
-                  "isInstanceOf": "File",
-                  "additionalProperties": true,
-                  "optional": true
-                }
-              }
+              "name": "attachment",
+              "$ref": "FileAttachment"
             },
             {
               "type": "function",
@@ -5650,14 +5854,7 @@
               "optional": true,
               "parameters": [
                 {
-                  "choices": [
-                    {
-                      "$ref": "ComposeAttachment"
-                    },
-                    {
-                      "type": "any"
-                    }
-                  ]
+                  "$ref": "ComposeAttachment"
                 }
               ]
             }
@@ -5787,7 +5984,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "description": "Specifies icons to use for dark and light themes"
+                  "description": "Specifies dark and light icons to be used with themes. The ``light`` icon is used on dark backgrounds and vice versa. **Note:** The default theme uses the ``default_icon`` for light backgrounds (if specified)."
                 },
                 "default_popup": {
                   "type": "string",
@@ -6299,7 +6496,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a composeAction icon is clicked.  This event will not fire if the composeAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a composeAction icon is clicked. This event will not fire if the composeAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -7180,7 +7377,7 @@
             },
             "sortType": {
               "type": "string",
-              "description": "Note: ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
               "optional": true,
               "enum": [
                 "none",
@@ -7207,7 +7404,7 @@
             },
             "sortOrder": {
               "type": "string",
-              "description": "Note: ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
+              "description": "**Note:** ``sortType`` and ``sortOrder`` depend on each other, so both should be present, or neither.",
               "optional": true,
               "enum": [
                 "none",
@@ -7655,6 +7852,8 @@
             "message_list",
             "folder_pane",
             "compose_attachments",
+            "message_attachments",
+            "all_message_attachments",
             "tools_menu"
           ],
           "description": "The different contexts a menu can appear in. Specifying <code>all</code> is equivalent to the combination of all other contexts excluding <code>tab</code> and <code>tools_menu</code>. More information about each context can be found in the `Supported UI Elements <https://developer.thunderbird.net/add-ons/mailextensions/supported-ui-elements#menu-items>`__ article on developer.thunderbird.net."
@@ -7673,7 +7872,7 @@
         {
           "id": "OnShowData",
           "type": "object",
-          "description": "Information sent when a context menu is being shown. For more information about each property, see :ref:`menus.OnClickData`. \nSome properties are only included if the extension has host permission for the given context, for example :permission:`activeTab` for content tabs, :permission:`compose` for compose tabs and :permission:`messagesRead` for message display tabs.",
+          "description": "Information sent when a context menu is being shown. Some properties are only included if the extension has host permission for the given context, for example :permission:`activeTab` for content tabs, :permission:`compose` for compose tabs and :permission:`messagesRead` for message display tabs.",
           "properties": {
             "menuIds": {
               "description": "A list of IDs of the menu items that were shown.",
@@ -7696,76 +7895,101 @@
                 "$ref": "ContextType"
               }
             },
-            "viewType": {
-              "$ref": "extension.ViewType",
-              "optional": true
-            },
             "editable": {
-              "type": "boolean"
+              "type": "boolean",
+              "description": "A flag indicating whether the element is editable (text input, textarea, etc.)."
             },
             "mediaType": {
               "type": "string",
-              "optional": true
+              "optional": true,
+              "description": "One of 'image', 'video', or 'audio' if the context menu was activated on one of these types of elements."
             },
-            "linkUrl": {
-              "type": "string",
-              "description": "Host permission is required.",
-              "optional": true
+            "viewType": {
+              "$ref": "extension.ViewType",
+              "optional": true,
+              "description": "The type of view where the menu is shown. May be unset if the menu is not associated with a view."
             },
             "linkText": {
               "type": "string",
-              "description": "Host permission is required.",
-              "optional": true
+              "optional": true,
+              "description": "If the element is a link, the text of that link. **Note:** Host permission is required."
+            },
+            "linkUrl": {
+              "type": "string",
+              "optional": true,
+              "description": "If the element is a link, the URL it points to. **Note:** Host permission is required."
             },
             "srcUrl": {
               "type": "string",
-              "description": "Host permission is required.",
+              "description": "Will be present for elements with a 'src' URL. **Note:** Host permission is required.",
               "optional": true
             },
             "pageUrl": {
               "type": "string",
-              "description": "Host permission is required.",
+              "description": "The URL of the page where the menu item was clicked. This property is not set if the click occurred in a context where there is no current page, such as in a launcher context menu. **Note:** Host permission is required.",
               "optional": true
             },
             "frameUrl": {
               "type": "string",
-              "description": "Host permission is required.",
+              "description": "The URL of the frame of the element where the context menu was clicked, if it was in a frame. **Note:** Host permission is required.",
               "optional": true
             },
             "selectionText": {
               "type": "string",
-              "description": "Host permission is required.",
+              "description": "The text for the context selection, if any. **Note:** Host permission is required.",
               "optional": true
             },
             "targetElementId": {
               "type": "integer",
-              "optional": true
+              "optional": true,
+              "description": "An identifier of the clicked content element, if any. Use menus.getTargetElement in the page to find the corresponding element."
             },
             "fieldId": {
               "type": "string",
-              "optional": true
+              "optional": true,
+              "description": "An identifier of the clicked Thunderbird UI element, if any.",
+              "enum": [
+                "composeSubject",
+                "composeTo",
+                "composeCc",
+                "composeBcc",
+                "composeReplyTo",
+                "composeNewsgroupTo"
+              ]
             },
             "selectedMessages": {
               "$ref": "messages.MessageList",
-              "optional": true
+              "optional": true,
+              "description": "The selected messages, if the context menu was opened in the message list. The <permission>messagesRead</permission> permission is required."
             },
             "displayedFolder": {
               "$ref": "folders.MailFolder",
-              "optional": true
+              "optional": true,
+              "description": "The displayed folder, if the context menu was opened in the message list. The <permission>accountsRead</permission> permission is required."
             },
             "selectedFolder": {
               "$ref": "folders.MailFolder",
-              "optional": true
+              "optional": true,
+              "description": "The selected folder, if the context menu was opened in the folder pane. The <permission>accountsRead</permission> permission is required."
             },
             "selectedAccount": {
               "$ref": "accounts.MailAccount",
-              "optional": true
+              "optional": true,
+              "description": "The selected account, if the context menu was opened on an account entry in the folder pane. The <permission>accountsRead</permission> permission is required."
             },
             "attachments": {
               "type": "array",
               "optional": true,
+              "description": "The selected attachments. The <permission>compose</permission> permission is required to return attachments of a message being composed. The <permission>messagesRead</permission> permission is required to return attachments of displayed messages.",
               "items": {
-                "$ref": "compose.ComposeAttachment"
+                "choices": [
+                  {
+                    "$ref": "compose.ComposeAttachment"
+                  },
+                  {
+                    "$ref": "messages.MessageAttachment"
+                  }
+                ]
               }
             }
           }
@@ -7798,16 +8022,20 @@
               "optional": true,
               "description": "The parent ID, if any, for the item clicked."
             },
-            "viewType": {
-              "$ref": "extension.ViewType",
-              "optional": true,
-              "description": "The type of view where the menu is clicked. May be unset if the menu is not associated with a view."
+            "editable": {
+              "type": "boolean",
+              "description": "A flag indicating whether the element is editable (text input, textarea, etc.)."
             },
             "mediaType": {
               "type": "string",
               "optional": true,
               "description": "One of 'image', 'video', or 'audio' if the context menu was activated on one of these types of elements."
             },
+            "viewType": {
+              "$ref": "extension.ViewType",
+              "optional": true,
+              "description": "The type of view where the menu is clicked. May be unset if the menu is not associated with a view."
+            },
             "linkText": {
               "type": "string",
               "optional": true,
@@ -7844,10 +8072,6 @@
               "optional": true,
               "description": "The text for the context selection, if any."
             },
-            "editable": {
-              "type": "boolean",
-              "description": "A flag indicating whether the element is editable (text input, textarea, etc.)."
-            },
             "wasChecked": {
               "type": "boolean",
               "optional": true,
@@ -7918,9 +8142,16 @@
             "attachments": {
               "type": "array",
               "optional": true,
-              "description": "The selected attachments of a message being composed. The <permission>compose</permission> permission is required.",
+              "description": "The selected attachments. The <permission>compose</permission> permission is required to return attachments of a message being composed. The <permission>messagesRead</permission> permission is required to return attachments of displayed messages.",
               "items": {
-                "$ref": "compose.ComposeAttachment"
+                "choices": [
+                  {
+                    "$ref": "compose.ComposeAttachment"
+                  },
+                  {
+                    "$ref": "messages.MessageAttachment"
+                  }
+                ]
               }
             }
           }
@@ -8012,7 +8243,7 @@
                     {
                       "name": "tab",
                       "$ref": "tabs.Tab",
-                      "description": "The details of the tab where the click took place. Note: this parameter only present for extensions."
+                      "description": "The details of the tab where the click took place. **Note:** this parameter only present for extensions."
                     }
                   ]
                 },
@@ -8052,7 +8283,7 @@
                 "command": {
                   "type": "string",
                   "optional": true,
-                  "description": "Specifies a command to issue for the context click.  Currently supports internal command _execute_browser_action."
+                  "description": "Specifies a command to issue for the context click.  Currently supports internal commands ``_execute_browser_action``, ``_execute_compose_action`` and ``_execute_message_display_action``."
                 }
               }
             },
@@ -8141,7 +8372,7 @@
                     {
                       "name": "tab",
                       "$ref": "tabs.Tab",
-                      "description": "The details of the tab where the click took place. Note: this parameter only present for extensions."
+                      "description": "The details of the tab where the click took place. **Note:** this parameter only present for extensions."
                     }
                   ]
                 },
@@ -8155,7 +8386,7 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Note: You cannot change an item to be a child of one of its own descendants."
+                  "description": "**Note:** You cannot change an item to be a child of one of its own descendants."
                 },
                 "documentUrlPatterns": {
                   "type": "array",
@@ -8494,7 +8725,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "description": "Specifies icons to use for dark and light themes"
+                  "description": "Specifies dark and light icons to be used with themes. The ``light`` icon is used on dark backgrounds and vice versa. **Note:** The default theme uses the ``default_icon`` for light backgrounds (if specified)."
                 },
                 "default_popup": {
                   "type": "string",
@@ -9002,7 +9233,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a messageDisplayAction icon is clicked.  This event will not fire if the messageDisplayAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a messageDisplayAction icon is clicked. This event will not fire if the messageDisplayAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -9259,7 +9490,7 @@
           }
         },
         {
-          "id": "Attachment",
+          "id": "MessageAttachment",
           "type": "object",
           "description": "Represents an attachment in a message.",
           "properties": {
@@ -9499,7 +9730,7 @@
                 {
                   "type": "array",
                   "items": {
-                    "$ref": "Attachment"
+                    "$ref": "MessageAttachment"
                   }
                 }
               ]
@@ -9509,7 +9740,7 @@
         {
           "name": "getAttachmentFile",
           "type": "function",
-          "description": "Gets the content of an attachment as a DOM <code>File</code> object.",
+          "description": "Gets the content of a :ref:`messages.MessageAttachment` as a DOM <code>File</code> object.",
           "async": "callback",
           "parameters": [
             {
@@ -11243,7 +11474,7 @@
         {
           "name": "onFocusChanged",
           "type": "function",
-          "description": "Fired when the currently focused window changes. Will be :ref:`windows.WINDOW_ID_NONE`) if all browser windows have lost focus. Note: On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one browser window to another.",
+          "description": "Fired when the currently focused window changes. Will be :ref:`windows.WINDOW_ID_NONE`) if all browser windows have lost focus. **Note:** On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one browser window to another.",
           "filters": [
             {
               "name": "windowTypes",