webext-schema 5.4.0 → 5.4.2

package/modules/browser.js

@@ -905,6 +905,9 @@ export const highlightTab = async (index, windowId) => {
   if (!(Array.isArray(index) || Number.isInteger(index))) {
     throw new TypeError(`Expected Number or Array but got ${getType(index)}.`);
   }
+  if (Number.isInteger(index)) {
+    index = [index];
+  }
   if (!Number.isInteger(windowId)) {
     windowId = windows.WINDOW_ID_CURRENT;
   }

package/package.json

@@ -17,24 +17,24 @@
     "commander": "^12.1.0",
     "decamelize": "^6.0.0",
     "json5": "^2.2.3",
-    "sinon": "^18.0.0"
+    "sinon": "^19.0.2"
   },
   "devDependencies": {
     "@types/firefox-webext-browser": "^120.0.4",
-    "@types/node": "^20.14.10",
+    "@types/node": "^22.5.5",
     "@types/sinon": "^17.0.3",
     "c8": "^10.1.2",
     "chai": "^5.1.1",
     "eslint": "^8.57.0",
     "eslint-config-standard": "^17.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jsdoc": "^48.6.0",
+    "eslint-plugin-import": "^2.30.0",
+    "eslint-plugin-jsdoc": "^50.2.4",
     "eslint-plugin-regexp": "^2.6.0",
-    "eslint-plugin-unicorn": "^54.0.0",
-    "mocha": "^10.6.0",
+    "eslint-plugin-unicorn": "^55.0.0",
+    "mocha": "^10.7.3",
     "npm-run-all": "^4.1.5",
-    "typescript": "^5.5.3",
-    "undici": "^6.19.2"
+    "typescript": "^5.6.2",
+    "undici": "^6.19.8"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -54,5 +54,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.4.0"
+  "version": "5.4.2"
 }

package/schemas/beta/webext.json

@@ -4445,7 +4445,7 @@
             },
             "openerTabId": {
               "type": "integer",
-              "minimum": 0,
+              "minimum": -1,
               "optional": true,
               "description": "The ID of the tab that opened this tab, if any. This property is only present if the opener tab still exists."
             },
@@ -4989,7 +4989,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as the newly created tab."
                 },
@@ -5203,7 +5203,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -5353,7 +5353,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -17437,7 +17437,7 @@
           ]
         },
         {
-          "id": "StorageAreaSync",
+          "id": "StorageAreaWithUsage",
           "type": "object",
           "functions": [
             {
@@ -17634,7 +17634,7 @@
       ],
       "properties": {
         "sync": {
-          "$ref": "StorageAreaSync",
+          "$ref": "StorageAreaWithUsage",
           "description": "Items in the <code>sync</code> storage area are synced by the browser.",
           "properties": {
             "QUOTA_BYTES": {
@@ -17688,8 +17688,13 @@
           "allowedContexts": [
             "devtools"
           ],
-          "$ref": "StorageArea",
-          "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded."
+          "$ref": "StorageAreaWithUsage",
+          "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded.",
+          "properties": {
+            "QUOTA_BYTES": {
+              "description": "The maximum amount of data (in bytes, currently at 10MB) that can be stored in session storage, as measured by the StructuredCloneHolder of every value plus every key's length."
+            }
+          }
         }
       }
     }

package/schemas/central/webext.json

@@ -4445,7 +4445,7 @@
             },
             "openerTabId": {
               "type": "integer",
-              "minimum": 0,
+              "minimum": -1,
               "optional": true,
               "description": "The ID of the tab that opened this tab, if any. This property is only present if the opener tab still exists."
             },
@@ -4989,7 +4989,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as the newly created tab."
                 },
@@ -5203,7 +5203,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -5353,7 +5353,7 @@
                 },
                 "openerTabId": {
                   "type": "integer",
-                  "minimum": 0,
+                  "minimum": -1,
                   "optional": true,
                   "description": "The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab."
                 },
@@ -17437,7 +17437,7 @@
           ]
         },
         {
-          "id": "StorageAreaSync",
+          "id": "StorageAreaWithUsage",
           "type": "object",
           "functions": [
             {
@@ -17634,7 +17634,7 @@
       ],
       "properties": {
         "sync": {
-          "$ref": "StorageAreaSync",
+          "$ref": "StorageAreaWithUsage",
           "description": "Items in the <code>sync</code> storage area are synced by the browser.",
           "properties": {
             "QUOTA_BYTES": {
@@ -17688,8 +17688,13 @@
           "allowedContexts": [
             "devtools"
           ],
-          "$ref": "StorageArea",
-          "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded."
+          "$ref": "StorageAreaWithUsage",
+          "description": "Items in the <code>session</code> storage area are kept in memory, and only until the either browser or extension is closed or reloaded.",
+          "properties": {
+            "QUOTA_BYTES": {
+              "description": "The maximum amount of data (in bytes, currently at 10MB) that can be stored in session storage, as measured by the StructuredCloneHolder of every value plus every key's length."
+            }
+          }
         }
       }
     }
@@ -17698,64 +17703,6 @@
     {
       "namespace": "manifest",
       "types": [
-        {
-          "$extend": "WebExtensionManifest",
-          "properties": {
-            "telemetry": {
-              "type": "object",
-              "optional": true,
-              "additionalProperties": {
-                "$ref": "UnrecognizedProperty"
-              },
-              "properties": {
-                "ping_type": {
-                  "type": "string"
-                },
-                "schemaNamespace": {
-                  "type": "string"
-                },
-                "public_key": {
-                  "type": "object",
-                  "properties": {
-                    "id": {
-                      "type": "string"
-                    },
-                    "key": {
-                      "type": "object",
-                      "properties": {
-                        "crv": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "kty": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "x": {
-                          "type": "string",
-                          "optional": "false"
-                        },
-                        "y": {
-                          "type": "string",
-                          "optional": "false"
-                        }
-                      }
-                    }
-                  }
-                },
-                "study_name": {
-                  "type": "string",
-                  "optional": true
-                },
-                "pioneer_id": {
-                  "type": "boolean",
-                  "optional": true,
-                  "default": false
-                }
-              }
-            }
-          }
-        },
         {
           "$extend": "PermissionPrivileged",
           "choices": [
@@ -17912,39 +17859,6 @@
             }
           ]
         },
-        {
-          "name": "submitEncryptedPing",
-          "type": "function",
-          "description": "Submits a custom ping to the Telemetry back-end, with an encrypted payload. Requires a telemetry entry in the manifest to be used.",
-          "parameters": [
-            {
-              "name": "message",
-              "type": "object",
-              "additionalProperties": {
-                "type": "any"
-              },
-              "description": "The data payload for the ping, which will be encrypted."
-            },
-            {
-              "description": "Options object.",
-              "name": "options",
-              "type": "object",
-              "properties": {
-                "schemaName": {
-                  "type": "string",
-                  "optional": false,
-                  "description": "Schema name used for payload."
-                },
-                "schemaVersion": {
-                  "type": "integer",
-                  "optional": false,
-                  "description": "Schema version used for payload."
-                }
-              }
-            }
-          ],
-          "async": true
-        },
         {
           "name": "canUpload",
           "type": "function",
@@ -18113,6 +18027,7 @@
         },
         {
           "name": "recordEvent",
+          "deprecated": "`recordEvent` has been deprecated since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Record an event in Telemetry. Throws when trying to record an unknown event.",
           "async": true,
@@ -18172,6 +18087,7 @@
         },
         {
           "name": "registerEvents",
+          "deprecated": "`registerEvents` has been deprecated since Firefox 132 (see bug 1894533)",
           "type": "function",
           "description": "Register new events to record them from addons. See nsITelemetry.idl for more details.",
           "async": true,

package/schemas/mail/mailext.json

@@ -3098,8 +3098,15 @@
               "description": "The human-friendly name of this account."
             },
             "type": {
-              "type": "string",
-              "description": "What sort of account this is, e.g. <var>imap</var>, <var>nntp</var>, or <var>pop3</var>."
+              "choices": [
+                {
+                  "$ref": "accounts.NativeMailAccountType"
+                },
+                {
+                  "$ref": "accounts.ExtensionMailAccountType"
+                }
+              ],
+              "description": "What sort of account this is. Either one of the natively supported account types, or an account type added by an extension."
             },
             "folders": {
               "max_manifest_version": 2,
@@ -3135,17 +3142,18 @@
           "description": "A unique id representing a $(ref:accounts.MailAccount)."
         },
         {
-          "id": "MailAccountType",
-          "description": "The type of an account.",
+          "id": "NativeMailAccountType",
+          "description": "The type of an account natively supported by Thunderbird.",
           "choices": [
             {
               "max_manifest_version": 2,
               "type": "string",
               "enum": [
                 "imap",
-                "pop3",
                 "nntp",
-                "none"
+                "none",
+                "pop3",
+                "rss"
               ]
             },
             {
@@ -3153,12 +3161,19 @@
               "type": "string",
               "enum": [
                 "imap",
-                "pop3",
+                "local",
                 "nntp",
-                "local"
+                "pop3",
+                "rss"
               ]
             }
           ]
+        },
+        {
+          "id": "ExtensionMailAccountType",
+          "description": "The type of an account which was added by an extension. For the time being there is no guarantee for account types added by extensions to always work as expected.",
+          "type": "string",
+          "pattern": "^extension:.*$"
         }
       ],
       "functions": [
@@ -3244,8 +3259,14 @@
               "optional": true,
               "parameters": [
                 {
-                  "$ref": "accounts.MailAccount",
-                  "optional": true
+                  "choices": [
+                    {
+                      "$ref": "accounts.MailAccount"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
                 }
               ]
             }
@@ -6150,7 +6171,7 @@
         {
           "name": "getAccount",
           "type": "function",
-          "description": "Retrieve information about a single cloud file account, or <var>undefined</var> if it does not exists",
+          "description": "Retrieve information about a single cloud file account. Returns <var>undefined</var>, if the requested account does not exist.",
           "allowedContexts": [
             "content"
           ],
@@ -6168,8 +6189,7 @@
               "parameters": [
                 {
                   "optional": true,
-                  "$ref": "CloudFileAccount",
-                  "description": "This may return undefined"
+                  "$ref": "CloudFileAccount"
                 }
               ]
             }
@@ -6202,7 +6222,7 @@
         {
           "name": "updateAccount",
           "type": "function",
-          "description": "Update a cloud file account.",
+          "description": "Update a cloud file account. Returns <var>undefined</var>, if the requested account does not exist.",
           "allowedContexts": [
             "content"
           ],
@@ -6255,8 +6275,7 @@
               "parameters": [
                 {
                   "optional": true,
-                  "$ref": "CloudFileAccount",
-                  "description": "This may return undefined"
+                  "$ref": "CloudFileAccount"
                 }
               ]
             }
@@ -6356,7 +6375,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>.",
+              "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.",
               "optional": "omit-key-if-missing"
             },
             "additionalFccFolder": {
@@ -6375,7 +6394,7 @@
                   ]
                 }
               ],
-              "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used.",
+              "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.",
               "optional": true
             },
             "attachPublicPGPKey": {
@@ -6495,7 +6514,7 @@
               "max_manifest_version": 2,
               "type": "boolean",
               "optional": true,
-              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <var>false</var> will clear the override. Setting <var>true</var> will throw an <em>ExtensionError</em>, if <var>overrideDefaultFccFolder</var> is not set as well."
+              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <var>false</var> will clear the override. Setting <var>true</var> will throw an <em>ExtensionError</em>, if <var>overrideDefaultFccFolder</var> is not set as well. The permission <permission>accountsRead</permission> is required to use this property."
             },
             "overrideDefaultFccFolder": {
               "max_manifest_version": 2,
@@ -6514,12 +6533,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."
+              "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>.",
+              "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": {
@@ -6540,7 +6559,7 @@
               "optional": true
             },
             "relatedMessageId": {
-              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <var>null</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.",
               "$ref": "messages.MessageId",
               "optional": true
             },
@@ -8375,84 +8394,138 @@
       "types": [
         {
           "id": "MailFolder",
-          "type": "object",
           "description": "An object describing a folder.",
-          "properties": {
-            "accountId": {
-              "$ref": "accounts.MailAccountId",
-              "optional": true,
-              "description": "The id of the account this folder belongs to."
-            },
-            "id": {
-              "$ref": "folders.MailFolderId",
-              "optional": true,
-              "description": "An identifier for the folder."
-            },
-            "isFavorite": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether this folder is a favorite folder."
-            },
-            "isRoot": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether this folder is a root folder."
-            },
-            "isTag": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether this folder is a virtual tag folder."
-            },
-            "isUnified": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether this folder is a unified mailbox folder."
-            },
-            "isVirtual": {
-              "type": "boolean",
-              "optional": true,
-              "description": "Whether this folder is a virtual search folder."
-            },
-            "name": {
-              "type": "string",
-              "optional": true,
-              "description": "The human-friendly name of this folder."
-            },
-            "path": {
-              "type": "string",
-              "description": "Path to this folder in the account. Although paths look predictable, never guess a folder's path, as there are a number of reasons why it may not be what you think it is. Use $(ref:folders.getParentFolders) or $(ref:folders.getSubFolders) to obtain hierarchy information."
-            },
-            "specialUse": {
-              "type": "array",
-              "items": {
-                "$ref": "folders.MailFolderSpecialUse"
-              },
-              "optional": true,
-              "description": "The special use of this folder. A folder can have multiple special uses."
-            },
-            "subFolders": {
-              "description": "Subfolders of this folder. The property may be <var>null</var>, if inclusion of folders had not been requested. The folders will be returned in the same order as used in Thunderbird's folder pane.",
-              "choices": [
-                {
+          "choices": [
+            {
+              "max_manifest_version": 2,
+              "type": "object",
+              "properties": {
+                "accountId": {
+                  "$ref": "accounts.MailAccountId",
+                  "optional": true,
+                  "description": "The id of the account this folder belongs to."
+                },
+                "id": {
+                  "$ref": "folders.MailFolderId",
+                  "optional": true,
+                  "description": "An identifier for the folder."
+                },
+                "isFavorite": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a favorite folder."
+                },
+                "isRoot": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a root folder."
+                },
+                "isTag": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a virtual tag folder."
+                },
+                "isUnified": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a unified mailbox folder."
+                },
+                "isVirtual": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this folder is a virtual search folder."
+                },
+                "name": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The human-friendly name of this folder."
+                },
+                "path": {
+                  "type": "string",
+                  "description": "Path to this folder in the account. Although paths look predictable, never guess a folder's path, as there are a number of reasons why it may not be what you think it is. Use $(ref:folders.getParentFolders) or $(ref:folders.getSubFolders) to obtain hierarchy information."
+                },
+                "specialUse": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolderSpecialUse"
+                  },
+                  "optional": true,
+                  "description": "The special use of this folder. A folder can have multiple special uses."
+                },
+                "subFolders": {
+                  "description": "Subfolders of this folder. This property is optional and only present if the inclusion of subfolders had been requested. The folders will be returned in the same order as used in Thunderbird's folder pane.",
                   "type": "array",
                   "items": {
                     "$ref": "folders.MailFolder"
-                  }
+                  },
+                  "optional": true
                 },
-                {
-                  "max_manifest_version": 2,
-                  "type": "null"
+                "type": {
+                  "$ref": "folders.MailFolderSpecialUse",
+                  "optional": true,
+                  "description": "Deprecated. Was used to represent the type of this folder."
                 }
-              ],
-              "optional": true
+              }
             },
-            "type": {
-              "max_manifest_version": 2,
-              "$ref": "folders.MailFolderSpecialUse",
-              "optional": true,
-              "description": "Deprecated. Was used to represent the type of this folder."
+            {
+              "min_manifest_version": 3,
+              "type": "object",
+              "properties": {
+                "accountId": {
+                  "$ref": "accounts.MailAccountId",
+                  "description": "The id of the account this folder belongs to. This property is optional and not available for unified mailbox folders or virtual tag folders.",
+                  "optional": true
+                },
+                "id": {
+                  "$ref": "folders.MailFolderId",
+                  "description": "An identifier for the folder."
+                },
+                "isFavorite": {
+                  "type": "boolean",
+                  "description": "Whether this folder is a favorite folder."
+                },
+                "isRoot": {
+                  "type": "boolean",
+                  "description": "Whether this folder is a root folder."
+                },
+                "isTag": {
+                  "type": "boolean",
+                  "description": "Whether this folder is a virtual tag folder."
+                },
+                "isUnified": {
+                  "type": "boolean",
+                  "description": "Whether this folder is a unified mailbox folder."
+                },
+                "isVirtual": {
+                  "type": "boolean",
+                  "description": "Whether this folder is a virtual search folder."
+                },
+                "name": {
+                  "type": "string",
+                  "description": "The human-friendly name of this folder."
+                },
+                "path": {
+                  "type": "string",
+                  "description": "Path to this folder in the account. Although paths look predictable, never guess a folder's path, as there are a number of reasons why it may not be what you think it is. Use $(ref:folders.getParentFolders) or $(ref:folders.getSubFolders) to obtain hierarchy information."
+                },
+                "specialUse": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolderSpecialUse"
+                  },
+                  "description": "The special use of this folder. A folder can have multiple special uses."
+                },
+                "subFolders": {
+                  "description": "Subfolders of this folder. This property is optional and only present if the inclusion of subfolders had been requested. The folders will be returned in the same order as used in Thunderbird's folder pane.",
+                  "type": "array",
+                  "items": {
+                    "$ref": "folders.MailFolder"
+                  },
+                  "optional": true
+                }
+              }
             }
-          }
+          ]
         },
         {
           "id": "MailFolderId",
@@ -9569,7 +9642,7 @@
         {
           "name": "getTagFolder",
           "type": "function",
-          "description": "Get one of the special unified mailbox tag folders, which are virtual search folders and group messages from all mail accounts based on their tags.",
+          "description": "Get one of the special virtual tag folders, which are virtual search folders and group messages from all mail accounts based on their tags.",
           "async": "callback",
           "parameters": [
             {
@@ -10306,7 +10379,7 @@
             "displayedFolderId": {
               "$ref": "folders.MailFolderId",
               "min_manifest_version": 3,
-              "description": "Sets the folder displayed in the mail tab. Requires the <permission>accountsRead</permission> permission. The previous message selection in the given folder will be restored, if any. This property is ignored, if <var>selectedMessages</var> is specified.",
+              "description": "Sets the folder displayed in the mail tab. Requires the <permission>accountsRead</permission> permission. The previous message selection in the given folder will be restored, if any.",
               "optional": true
             },
             "displayedFolder": {
@@ -10320,7 +10393,7 @@
                 }
               ],
               "max_manifest_version": 2,
-              "description": "Sets the folder displayed in the mail tab. Requires the <permission>accountsRead</permission> permission. The previous message selection in the given folder will be restored, if any. This property is ignored, if <var>selectedMessages</var> is specified.",
+              "description": "Sets the folder displayed in the mail tab. Requires the <permission>accountsRead</permission> permission. The previous message selection in the given folder will be restored, if any.",
               "optional": true
             }
           }
@@ -10444,8 +10517,7 @@
               "parameters": [
                 {
                   "$ref": "mailTabs.MailTab",
-                  "optional": true,
-                  "description": "This may return undefined"
+                  "optional": true
                 }
               ]
             }
@@ -11161,6 +11233,30 @@
             }
           },
           "description": "A <em>dictionary object</em> to specify paths for multiple icons in different sizes, so the best matching icon can be used, instead of scaling a standard icon to fit the pixel density of the user's display. Each entry is a <em>name-value</em> pair, with <em>name</em> being a size and <em>value</em> being a $(ref:menus.MenuIconPath). Example: <literalinclude>includes/IconPath.json<lang>JSON</lang></literalinclude>See the <a href='url-choosing-icon-size'>MDN documentation about choosing icon sizes</a> for more information on this. "
+        },
+        {
+          "id": "MenuActionCommand",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "_execute_browser_action",
+                "_execute_compose_action",
+                "_execute_message_display_action"
+              ],
+              "max_manifest_version": 2
+            },
+            {
+              "type": "string",
+              "enum": [
+                "_execute_action",
+                "_execute_compose_action",
+                "_execute_message_display_action"
+              ],
+              "min_manifest_version": 3
+            }
+          ],
+          "description": "A predefined command to open an action popup."
         }
       ],
       "functions": [
@@ -11293,16 +11389,13 @@
                   "optional": true,
                   "choices": [
                     {
-                      "type": "string",
-                      "max_manifest_version": 2,
-                      "description": "Specifies a command to issue for the context click. Currently supports internal commands <var>_execute_browser_action</var>, <var>_execute_compose_action</var> and <var>_execute_message_display_action</var>."
+                      "type": "string"
                     },
                     {
-                      "type": "string",
-                      "min_manifest_version": 3,
-                      "description": "Specifies a command to issue for the context click. Currently supports internal commands <var>_execute_action</var>, <var>_execute_compose_action</var> and <var>_execute_message_display_action</var>."
+                      "$ref": "menus.MenuActionCommand"
                     }
-                  ]
+                  ],
+                  "description": "Specifies a command to issue for the context click. Can either be a user defined command, or one of the predefined action commands."
                 }
               }
             },
@@ -12665,26 +12758,31 @@
             }
           }
         },
+        {
+          "id": "MailBoxHeaderString",
+          "type": "string",
+          "description": "Content may either be a single email address, or a mailbox string (see RFC 5322, section 3.4). Use $(ref:messengerUtilities.parseMailboxString) to extract the name and/or the email from the mailbox string."
+        },
         {
           "id": "MessageHeader",
           "type": "object",
           "description": "Basic information about a message.",
           "properties": {
             "author": {
-              "type": "string"
+              "$ref": "messages.MailBoxHeaderString"
             },
             "bccList": {
               "description": "The Bcc recipients. Not populated for news/nntp messages.",
               "type": "array",
               "items": {
-                "type": "string"
+                "$ref": "messages.MailBoxHeaderString"
               }
             },
             "ccList": {
               "description": "The Cc recipients. Not populated for news/nntp messages.",
               "type": "array",
               "items": {
-                "type": "string"
+                "$ref": "messages.MailBoxHeaderString"
               }
             },
             "date": {
@@ -12737,7 +12835,7 @@
               "description": "The To recipients. Not populated for news/nntp messages.",
               "type": "array",
               "items": {
-                "type": "string"
+                "$ref": "messages.MailBoxHeaderString"
               }
             },
             "size": {
@@ -14128,7 +14226,7 @@
         {
           "name": "getTabValue",
           "type": "function",
-          "description": "Retrieve a previously stored value for a given tab, given its key. Returns <var>undefined</var> if the key does not exist.",
+          "description": "Retrieve a previously stored value for a given tab, given its key. Returns <var>undefined</var> if the requested <var>key</var> does not exist for the given <var>tabId</var>.",
           "async": "callback",
           "parameters": [
             {
@@ -14148,8 +14246,7 @@
               "parameters": [
                 {
                   "type": "string",
-                  "optional": true,
-                  "description": "This may return undefined"
+                  "optional": true
                 }
               ]
             }
@@ -14181,93 +14278,98 @@
       "namespace": "spaces",
       "types": [
         {
-          "id": "SpaceButtonProperties_MV2",
-          "type": "object",
-          "properties": {
-            "badgeBackgroundColor": {
-              "choices": [
-                {
-                  "type": "string"
+          "id": "SpaceButtonProperties",
+          "choices": [
+            {
+              "max_manifest_version": 2,
+              "type": "object",
+              "properties": {
+                "badgeBackgroundColor": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "$ref": "spaces.ColorArray"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <var>[255, 0, 0, 255]</var>. Can also be a string with an HTML color name (<var>red</var>) or a HEX color value (<var>#FF0000</var> or <var>#F00</var>). Reset when set to an empty string."
                 },
-                {
-                  "$ref": "spaces.ColorArray"
-                }
-              ],
-              "optional": true,
-              "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <var>[255, 0, 0, 255]</var>. Can also be a string with an HTML color name (<var>red</var>) or a HEX color value (<var>#FF0000</var> or <var>#F00</var>). Reset when set to an empty string."
-            },
-            "badgeText": {
-              "type": "string",
-              "optional": true,
-              "description": "Sets the badge text for the button in the spaces toolbar. The badge is displayed on top of the icon. Any number of characters can be set, but only about four can fit in the space. Removed when set to an empty string."
-            },
-            "defaultIcons": {
-              "choices": [
-                {
-                  "type": "string"
+                "badgeText": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "Sets the badge text for the button in the spaces toolbar. The badge is displayed on top of the icon. Any number of characters can be set, but only about four can fit in the space. Removed when set to an empty string."
                 },
-                {
-                  "$ref": "manifest.IconPath"
+                "defaultIcons": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "$ref": "manifest.IconPath"
+                    }
+                  ],
+                  "optional": true,
+                  "description": "The paths to one or more icons for the button in the spaces toolbar. Reset to the extension icon, when set to an empty string."
+                },
+                "themeIcons": {
+                  "type": "array",
+                  "optional": true,
+                  "items": {
+                    "$ref": "manifest.ThemeIcons"
+                  },
+                  "description": "Specifies dark and light icons for the button in the spaces toolbar to be used with themes: The <var>light</var> icons will be used on dark backgrounds and vice versa. At least the set for <em>16px</em> icons should be specified. The set for <em>32px</em> icons will be used on screens with a very high pixel density, if specified. Reset when set to an empty array."
+                },
+                "title": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The title for the button in the spaces toolbar, used in the tooltip of the button and as the displayed name in the overflow menu. Reset to the name of the extension, when set to an empty string."
                 }
-              ],
-              "optional": true,
-              "description": "The paths to one or more icons for the button in the spaces toolbar. Reset to the extension icon, when set to an empty string."
-            },
-            "themeIcons": {
-              "type": "array",
-              "optional": true,
-              "items": {
-                "$ref": "manifest.ThemeIcons"
-              },
-              "description": "Specifies dark and light icons for the button in the spaces toolbar to be used with themes: The <var>light</var> icons will be used on dark backgrounds and vice versa. At least the set for <em>16px</em> icons should be specified. The set for <em>32px</em> icons will be used on screens with a very high pixel density, if specified. Reset when set to an empty array."
+              }
             },
-            "title": {
-              "type": "string",
-              "optional": true,
-              "description": "The title for the button in the spaces toolbar, used in the tooltip of the button and as the displayed name in the overflow menu. Reset to the name of the extension, when set to an empty string."
-            }
-          }
-        },
-        {
-          "id": "SpaceButtonProperties_MV3",
-          "type": "object",
-          "properties": {
-            "badgeBackgroundColor": {
-              "choices": [
-                {
-                  "type": "string"
+            {
+              "min_manifest_version": 3,
+              "type": "object",
+              "properties": {
+                "badgeBackgroundColor": {
+                  "choices": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "$ref": "spaces.ColorArray"
+                    }
+                  ],
+                  "optional": "omit-key-if-missing",
+                  "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <var>[255, 0, 0, 255]</var>. Can also be a string with an HTML color name (<var>red</var>) or a HEX color value (<var>#FF0000</var> or <var>#F00</var>). Reset when set to <var>null</var>."
                 },
-                {
-                  "$ref": "spaces.ColorArray"
+                "badgeText": {
+                  "type": "string",
+                  "optional": "omit-key-if-missing",
+                  "description": "Sets the badge text for the button in the spaces toolbar. The badge is displayed on top of the icon. Any number of characters can be set, but only about four can fit in the space. Removed when set to <var>null</var>."
+                },
+                "defaultIcons": {
+                  "$ref": "manifest.IconPath",
+                  "optional": "omit-key-if-missing",
+                  "description": "The paths to one or more icons for the button in the spaces toolbar. Reset to the extension icon, when set to <var>null</var>."
+                },
+                "themeIcons": {
+                  "type": "array",
+                  "optional": "omit-key-if-missing",
+                  "items": {
+                    "$ref": "manifest.ThemeIcons"
+                  },
+                  "description": "Specifies dark and light icons for the button in the spaces toolbar to be used with themes: The <var>light</var> icons will be used on dark backgrounds and vice versa. At least the set for <em>16px</em> icons should be specified. The set for <em>32px</em> icons will be used on screens with a very high pixel density, if specified. Reset when set to <var>null</var>."
+                },
+                "title": {
+                  "type": "string",
+                  "optional": "omit-key-if-missing",
+                  "description": "The title for the button in the spaces toolbar, used in the tooltip of the button and as the displayed name in the overflow menu. Reset to the name of the extension, when set to <var>null</var>."
                 }
-              ],
-              "optional": "omit-key-if-missing",
-              "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <var>[255, 0, 0, 255]</var>. Can also be a string with an HTML color name (<var>red</var>) or a HEX color value (<var>#FF0000</var> or <var>#F00</var>). Reset when set to <var>null</var>."
-            },
-            "badgeText": {
-              "type": "string",
-              "optional": "omit-key-if-missing",
-              "description": "Sets the badge text for the button in the spaces toolbar. The badge is displayed on top of the icon. Any number of characters can be set, but only about four can fit in the space. Removed when set to <var>null</var>."
-            },
-            "defaultIcons": {
-              "$ref": "manifest.IconPath",
-              "optional": "omit-key-if-missing",
-              "description": "The paths to one or more icons for the button in the spaces toolbar. Reset to the extension icon, when set to <var>null</var>."
-            },
-            "themeIcons": {
-              "type": "array",
-              "optional": "omit-key-if-missing",
-              "items": {
-                "$ref": "manifest.ThemeIcons"
-              },
-              "description": "Specifies dark and light icons for the button in the spaces toolbar to be used with themes: The <var>light</var> icons will be used on dark backgrounds and vice versa. At least the set for <em>16px</em> icons should be specified. The set for <em>32px</em> icons will be used on screens with a very high pixel density, if specified. Reset when set to <var>null</var>."
-            },
-            "title": {
-              "type": "string",
-              "optional": "omit-key-if-missing",
-              "description": "The title for the button in the spaces toolbar, used in the tooltip of the button and as the displayed name in the overflow menu. Reset to the name of the extension, when set to <var>null</var>."
+              }
             }
-          }
+          ]
         },
         {
           "id": "ColorArray",
@@ -14332,16 +14434,7 @@
             {
               "name": "buttonProperties",
               "description": "Properties of the button for the new space.",
-              "choices": [
-                {
-                  "$ref": "spaces.SpaceButtonProperties_MV3",
-                  "min_manifest_version": 3
-                },
-                {
-                  "$ref": "spaces.SpaceButtonProperties_MV2",
-                  "max_manifest_version": 2
-                }
-              ],
+              "$ref": "spaces.SpaceButtonProperties",
               "optional": true,
               "default": {}
             },
@@ -14483,16 +14576,7 @@
             {
               "name": "buttonProperties",
               "description": "Only specified button properties will be updated.",
-              "choices": [
-                {
-                  "$ref": "spaces.SpaceButtonProperties_MV3",
-                  "min_manifest_version": 3
-                },
-                {
-                  "$ref": "spaces.SpaceButtonProperties_MV2",
-                  "max_manifest_version": 2
-                }
-              ],
+              "$ref": "spaces.SpaceButtonProperties",
               "optional": true
             }
           ]
@@ -14954,7 +15038,7 @@
         {
           "name": "getCurrent",
           "type": "function",
-          "description": "Gets the tab that this script call is being made from. May be <var>undefined</var> if called from a non-tab context (for example: a background page or popup view).",
+          "description": "Gets the tab that this script call is being made from. Returns <var>undefined</var> if called from a non-tab context (for example a background page or a popup view).",
           "async": "callback",
           "parameters": [
             {
@@ -14965,8 +15049,7 @@
                 {
                   "name": "tab",
                   "$ref": "Tab",
-                  "optional": true,
-                  "description": "This may return undefined"
+                  "optional": true
                 }
               ]
             }
@@ -15051,7 +15134,7 @@
         {
           "name": "create",
           "type": "function",
-          "description": "Creates a new content tab. Use the $(doc:messageDisplay) to open messages. Only supported in <var>normal</var> windows. Same-site links in the loaded page are opened within Thunderbird, all other links are opened in the user's default browser. To override this behavior, add-ons have to register a <a href='url-content-script-click-capture'>content script</a> , capture click events and handle them manually.",
+          "description": "Creates a new content tab. To create message tabs, use the $(ref:messageDisplay.open). Only supported in <var>normal</var> windows. Same-site links in the loaded page are opened within Thunderbird, all other links are opened in the user's default browser. To override this behavior, add-ons have to register a <a href='url-content-script-click-capture'>content script</a> , capture click events and handle them manually.",
           "async": "callback",
           "parameters": [
             {
@@ -15103,7 +15186,7 @@
                 {
                   "name": "tab",
                   "$ref": "Tab",
-                  "description": "Details about the created tab. Will contain the ID of the new tab."
+                  "description": "A Promise that will be fulfilled with a $(ref:tabs.Tab) object containing details about the created tab. If the tab could not be created (for example, because it was added to a non-normal window) the promise will be rejected with an error message. The returned promise resolves as soon as the tab has been created. The tab may still be loading, with its title being <var>loading...</var> and its URL being <var>about:blank</var>. To detect when the tab has finished loading, listen to the $(ref:tabs.onUpdated) event before creating the tab."
                 }
               ]
             }
@@ -15533,7 +15616,7 @@
         {
           "name": "onCreated",
           "type": "function",
-          "description": "Fired when a tab is created. Note that the tab's URL may not be set at the time this event fired, but you can listen to onUpdated events to be notified when a URL is set.",
+          "description": "Fired when a tab is created. The tab may still be loading, with its title being <var>loading...</var> and its URL being <var>about:blank</var>. To detect when the tab has finished loading, listen to the $(ref:tabs.onUpdated) event.",
           "parameters": [
             {
               "$ref": "Tab",

package/schemas/release/webext.json

@@ -721,7 +721,8 @@
                       "optional": true,
                       "format": "url",
                       "pattern": "^(https://|http://(localhost|127\\.0\\.0\\.1|\\[::1\\])(:\\d*)?(/|$)).*$",
-                      "preprocess": "localize"
+                      "preprocess": "localize",
+                      "deprecated": "Unsupported on Firefox at this time."
                     },
                     "alternate_urls": {
                       "type": "array",
@@ -13884,30 +13885,6 @@
             }
           }
         },
-        {
-          "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",
@@ -14020,18 +13997,6 @@
             }
           ]
         },
-        {
-          "id": "SitePermission",
-          "choices": [
-            {
-              "type": "string",
-              "enum": [
-                "midi",
-                "midi-sysex"
-              ]
-            }
-          ]
-        },
         {
           "id": "HttpURL",
           "type": "string",