webext-schema 2.0.7 → 2.0.8

package/modules/update.js

@@ -8,7 +8,7 @@ import { URL } from 'url';
 import JSON5 from 'json5';
 import { createFile } from './file-util.js';
 import { getType, isString } from './common.js';
-import commander from 'commander';
+import { program as commander } from 'commander';
 import fetch from 'node-fetch';
 import path from 'path';
 import process from 'process';

package/package.json

@@ -24,23 +24,23 @@
   },
   "dependencies": {
     "camelize": "^1.0.0",
-    "commander": "^8.3.0",
+    "commander": "^9.0.0",
     "decamelize": "^6.0.0",
     "json5": "^2.2.0",
     "node-fetch": "^3.2.0",
-    "sinon": "^12.0.1"
+    "sinon": "^13.0.1"
   },
   "devDependencies": {
     "c8": "^7.11.0",
-    "chai": "^4.3.4",
+    "chai": "^4.3.6",
     "eslint": "^7.32.0",
     "eslint-config-standard": "^16.0.3",
     "eslint-plugin-import": "^2.25.4",
-    "eslint-plugin-jsdoc": "^37.6.3",
+    "eslint-plugin-jsdoc": "^37.7.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-promise": "^5.2.0",
     "mocha": "^9.2.0",
     "nock": "^13.2.2"
   },
-  "version": "2.0.7"
+  "version": "2.0.8"
 }

package/schemas/central/webext.json

@@ -12896,7 +12896,9 @@
                     },
                     "persistent": {
                       "optional": true,
-                      "$ref": "PersistentBackgroundProperty"
+                      "type": "boolean",
+                      "max_manifest_version": 2,
+                      "default": true
                     }
                   },
                   "additionalProperties": {
@@ -12914,7 +12916,9 @@
                     },
                     "persistent": {
                       "optional": true,
-                      "$ref": "PersistentBackgroundProperty"
+                      "type": "boolean",
+                      "max_manifest_version": 2,
+                      "default": true
                     }
                   },
                   "additionalProperties": {
@@ -13537,24 +13541,6 @@
           "id": "UnrecognizedProperty",
           "type": "any",
           "deprecated": "An unexpected property was found in the WebExtension manifest."
-        },
-        {
-          "id": "PersistentBackgroundProperty",
-          "choices": [
-            {
-              "type": "boolean",
-              "enum": [
-                true
-              ]
-            },
-            {
-              "type": "boolean",
-              "enum": [
-                false
-              ],
-              "deprecated": "Event pages are not currently supported. This will run as a persistent background page."
-            }
-          ]
         }
       ]
     }

package/schemas/mail/mailext.json

@@ -2979,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."
+                }
+              }
+            }
+          ]
+        }
       ]
     }
   ],
@@ -3259,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
             }
           ],
@@ -3952,7 +4005,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "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)."
+                  "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",
@@ -4464,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",
@@ -4706,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",
@@ -4764,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": {
@@ -4793,7 +4858,7 @@
               },
               "templateInfo": {
                 "$ref": "CloudFileTemplateInfo",
-                "description": "Defines information to be used in the cloud file entry added to the message.",
+                "description": "Additional file information used in the cloud file entry added to the message.",
                 "optional": true
               }
             }
@@ -5042,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": [
@@ -5309,17 +5405,17 @@
             },
             "body": {
               "type": "string",
-              "description": "The HTML content of the message. Ignored by ``setComposeDetails``, if used on a plain text composer. If only ``body`` is specified when used with ``beginNew``, ``beginReply`` and similar functions, an HTML message will be created. The recommended usage is to always specify both (``body`` and ``plainTextBody``) and use ``isPlainText`` to select the compose format, or use the users default compose format.",
+              "description": "The HTML content of the message.",
               "optional": true
             },
             "plainTextBody": {
               "type": "string",
-              "description": "The plain text content of the message. Ignored by ``setComposeDetails``, if used on an HTML composer. If only ``plainTextBody`` is specified when used with ``beginNew``, ``beginReply`` and similar functions, a plain text message will be created. The recommended usage is to always specify both (``body`` and ``plainTextBody``) and use ``isPlainText`` to select the compose format, or use the users default compose format.",
+              "description": "The plain text content of the message.",
               "optional": true
             },
             "isPlainText": {
               "type": "boolean",
-              "description": "Wether the message is an HTML message or a plain text message. Can be used to specify the message format in ``beginNew``, ``beginReply`` and similar functions. It is however not possible to change the compose format with ``setComposeDetails``. Note: Using ``isPlainText`` together with a single but conflicting body type (e.g.: ``isPlainText`` = ``true`` and ``body`` is set but not ``plainTextBody``) will cause an exception. ",
+              "description": "Whether the message is an HTML message or a plain text message.",
               "optional": true
             },
             "attachments": {
@@ -5334,7 +5430,7 @@
                   }
                 ]
               },
-              "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
             }
           }
@@ -5396,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": {
@@ -5410,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."
               }
             }
           }
@@ -5489,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": [
             {
@@ -5520,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": [
             {
@@ -5560,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": [
             {
@@ -5626,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"
           ],
@@ -5638,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"
             }
           ]
         },
@@ -5889,7 +5984,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "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)."
+                  "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",
@@ -6401,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",
@@ -7282,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",
@@ -7309,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",
@@ -7757,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."
@@ -7775,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.",
@@ -7798,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"
+                  }
+                ]
               }
             }
           }
@@ -7900,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,
@@ -7946,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,
@@ -8020,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"
+                  }
+                ]
               }
             }
           }
@@ -8114,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."
                     }
                   ]
                 },
@@ -8243,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."
                     }
                   ]
                 },
@@ -8257,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",
@@ -8596,7 +8725,7 @@
                   "items": {
                     "$ref": "ThemeIcons"
                   },
-                  "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)."
+                  "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",
@@ -9104,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",
@@ -11345,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",

package/schemas/release/webext.json

@@ -5165,7 +5165,17 @@
                   "description": "The position of the tabs within their windows."
                 },
                 "cookieStoreId": {
-                  "type": "string",
+                  "choices": [
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    {
+                      "type": "string"
+                    }
+                  ],
                   "optional": true,
                   "description": "The CookieStoreId used for the tab."
                 },
@@ -9033,6 +9043,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"
             }
           }
         },
@@ -11737,7 +11763,6 @@
             "screenshots",
             "seqstyle",
             "stackwalk",
-            "threads",
             "jstracer",
             "jsallocations",
             "nostacksampling",
@@ -13147,6 +13172,30 @@
             }
           }
         },
+        {
+          "id": "WebExtensionSitePermissionsManifest",
+          "type": "object",
+          "description": "Represents a WebExtension site permissions manifest.json file",
+          "$import": "ManifestBase",
+          "properties": {
+            "site_permissions": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "$ref": "SitePermission"
+              }
+            },
+            "install_origins": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 1,
+              "items": {
+                "type": "string",
+                "format": "origin"
+              }
+            }
+          }
+        },
         {
           "id": "ThemeIcons",
           "type": "object",
@@ -13246,6 +13295,18 @@
             }
           ]
         },
+        {
+          "id": "SitePermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "midi",
+                "midi-sysex"
+              ]
+            }
+          ]
+        },
         {
           "id": "HttpURL",
           "type": "string",