webext-schema 5.5.2 → 5.5.4

package/schemas/mail/mailext.json

@@ -209,6 +209,13 @@
               "description": "Called to return the registered commands."
             }
           ]
+        },
+        {
+          "name": "openShortcutSettings",
+          "type": "function",
+          "async": true,
+          "description": "Open extension shortcuts configuration page.",
+          "parameters": []
         }
       ]
     }
@@ -3817,8 +3824,57 @@
       "events": [
         {
           "name": "onSearchRequest",
+          "max_manifest_version": 2,
+          "type": "function",
+          "description": "Registering this listener will create a read-only address book, similar to an LDAP address book. When selecting this address book, users will first see no contacts, but they can search for them, which will fire this event. Contacts returned by the listener callback will be displayed as contact cards in the address book. Several listeners can be registered, to create multiple address books.\n\nThe event also fires for each registered listener (for each created read-only address book), when users type something into the mail composer's <em>To:</em> field, or into similar fields like the calendar meeting attendees field. Contacts returned by the listener callback will be added to the autocomplete results in the dropdown of that field.\n\nExample: <literalinclude>includes/addressBooks/onSearchRequest_mv2.js<lang>JavaScript</lang></literalinclude>",
+          "parameters": [
+            {
+              "name": "node",
+              "$ref": "AddressBookNode"
+            },
+            {
+              "name": "searchString",
+              "description": "The search text that the user entered. Not available when invoked from the advanced address book search dialog.",
+              "type": "string",
+              "optional": true
+            },
+            {
+              "name": "query",
+              "type": "string",
+              "description": "The boolean query expression corresponding to the search. **Note:** This parameter may change in future releases of Thunderbird.",
+              "optional": true
+            }
+          ],
+          "extraParameters": [
+            {
+              "name": "parameters",
+              "description": "Descriptions for the address book created by registering this listener.",
+              "type": "object",
+              "properties": {
+                "addressBookName": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The name of the created address book. If not provided, the name of the extension is used."
+                },
+                "isSecure": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether the address book search queries are using encrypted protocols like HTTPS."
+                },
+                "id": {
+                  "type": "string",
+                  "optional": true,
+                  "description": "The unique identifier of the created address book. If not provided, a unique identifier will be generated for you."
+                }
+              }
+            }
+          ]
+        },
+        {
+          "name": "onSearchRequest",
+          "min_manifest_version": 3,
           "type": "function",
-          "description": "Registering this listener will create and list a read-only address book in Thunderbird's address book window, similar to LDAP address books. When selecting this address book, users will first see no contacts, but they can search for them, which will fire this event. Contacts returned by the listener callback will be displayed as contact cards in the address book. Several listeners can be registered, to create multiple address books.\n\nThe event also fires for each registered listener (for each created read-only address book), when users type something into the mail composer's <em>To:</em> field, or into similar fields like the calendar meeting attendees field. Contacts returned by the listener callback will be added to the autocomplete results in the dropdown of that field.\n\nExample: <literalinclude>includes/addressBooks/onSearchRequest.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Registering this listener will create a read-only address book, similar to an LDAP address book. When selecting this address book, users will first see no contacts, but they can search for them, which will fire this event. Contacts returned by the listener callback will be displayed as contact cards in the address book. Several listeners can be registered, to create multiple address books. **Ensure all listeners are at the top-level and use the synchronous pattern, otherwise the associated address books will be removed on background termination.**.\n\nThe event also fires for each registered listener (for each created read-only address book), when users type something into the mail composer's <em>To:</em> field, or into similar fields like the calendar meeting attendees field. Contacts returned by the listener callback will be added to the autocomplete results in the dropdown of that field.\n\nExample: <literalinclude>includes/addressBooks/onSearchRequest_mv3.js<lang>JavaScript</lang></literalinclude>",
           "parameters": [
             {
               "name": "node",
@@ -3846,7 +3902,7 @@
                 "addressBookName": {
                   "type": "string",
                   "optional": true,
-                  "description": "The name of the created address book."
+                  "description": "The name of the created address book. If not provided, the name of the extension is used."
                 },
                 "isSecure": {
                   "type": "boolean",
@@ -3856,7 +3912,7 @@
                 "id": {
                   "type": "string",
                   "optional": true,
-                  "description": "The unique ID of the created address book. If several listeners have been added, the <var>id</var> allows to identify which address book initiated the search request. If not provided, a unique ID will be generated for you."
+                  "description": "The unique identifier of the created address book. If not provided, a unique identifier will be generated for you."
                 }
               }
             }
@@ -8618,7 +8674,12 @@
             "lastUsed": {
               "$ref": "extensionTypes.Date",
               "optional": true,
-              "description": "Date the folder was last used (precision: seconds)."
+              "description": "Date the folder was last used. It is updated every time the folder was accessed, when the user moved or copied messages into the folder and when the folder received new messages. (precision: seconds)."
+            },
+            "lastUsedAsDestination": {
+              "$ref": "extensionTypes.Date",
+              "optional": true,
+              "description": "Date the folder was last used as a destination. It is updated every time the user moved or copied messages into the folder. (precision: seconds)."
             },
             "quota": {
               "type": "array",
@@ -8719,10 +8780,40 @@
             }
           }
         },
+        {
+          "id": "QueryDateRange",
+          "description": "An object defining a range for a date value to be used in queries.",
+          "choices": [
+            {
+              "type": "object",
+              "properties": {
+                "recent": {
+                  "type": "boolean",
+                  "description": "Whether the date must be considered to be recent by Thunderbird (within the last month) or not, to match the query."
+                }
+              }
+            },
+            {
+              "type": "object",
+              "properties": {
+                "after": {
+                  "$ref": "extensionTypes.Date",
+                  "optional": true,
+                  "description": "The minimum date required to match the query."
+                },
+                "before": {
+                  "$ref": "extensionTypes.Date",
+                  "optional": true,
+                  "description": "The maximum date required to match the query."
+                }
+              }
+            }
+          ]
+        },
         {
           "id": "QueryRange",
           "type": "object",
-          "description": "An object defining a range.",
+          "description": "An object defining a range for an integer value to be used in queries.",
           "properties": {
             "min": {
               "type": "integer",
@@ -8756,7 +8847,7 @@
       "properties": {
         "DEFAULT_MOST_RECENT_LIMIT": {
           "value": -1,
-          "description": "The number of most recent folders used in Thunderbird's UI. Controled by the <var>mail.folder_widget.max_recent</var> preference."
+          "description": "The number of most recent folders used in Thunderbird's UI. Controlled by the <var>mail.folder_widget.max_recent</var> preference."
         }
       },
       "functions": [
@@ -8880,6 +8971,16 @@
                   "optional": true,
                   "description": "Whether the folder is a virtual search folder, or not."
                 },
+                "lastUsed": {
+                  "$ref": "QueryDateRange",
+                  "optional": true,
+                  "description": "Date the folder was last used (folder was accessed, user moved or copied messages into the folder or folder received new messages)."
+                },
+                "lastUsedAsDestination": {
+                  "$ref": "QueryDateRange",
+                  "optional": true,
+                  "description": "Date the folder was last used as a destination (user moved or copied messages into the folder)."
+                },
                 "limit": {
                   "type": "integer",
                   "optional": true,
@@ -8911,8 +9012,21 @@
                 },
                 "recent": {
                   "type": "boolean",
+                  "deprecated": "Deprecated. Use <var>queryInfo.lastUsed</var> and <var>queryInfo.sort</var>.",
+                  "optional": true,
+                  "description": "Whether the folder (excluding subfolders) has been used within the last month, or not. The returned folders will be sorted by <var>lastUsed</var>."
+                },
+                "sort": {
+                  "type": "string",
+                  "enum": [
+                    "lastUsed",
+                    "lastUsedAsDestination",
+                    "name",
+                    "path"
+                  ],
                   "optional": true,
-                  "description": "Whether the folder (excluding subfolders) has been used within the last month, or not. The returned folders will be sorted by their recentness."
+                  "default": "path",
+                  "description": "The sort order of the returned folders. If not specified, folders will be sorted by <var>path</var>. Sorting by <var>name</var> is case-insensitive."
                 },
                 "specialUse": {
                   "type": "array",
@@ -9675,7 +9789,7 @@
         {
           "name": "getUnifiedFolder",
           "type": "function",
-          "description": "Get one of the special unified mailbox folders, which are virtual search folders and return the content from all mail accounts.",
+          "description": "Get one of the special unified mailbox folders, which are virtual search folders and return the content from all mail accounts. Throws if the requested folder does not exist.",
           "async": "callback",
           "parameters": [
             {
@@ -9714,7 +9828,7 @@
         {
           "name": "getTagFolder",
           "type": "function",
-          "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.",
+          "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. Throws if the requested folder does not exist.",
           "async": "callback",
           "parameters": [
             {
@@ -10927,6 +11041,7 @@
                 "editable",
                 "folder_pane",
                 "frame",
+                "header_pane_link",
                 "image",
                 "link",
                 "message_attachments",
@@ -13141,6 +13256,10 @@
             {
               "name": "changedProperties",
               "$ref": "messages.MessageProperties"
+            },
+            {
+              "name": "oldProperties",
+              "$ref": "messages.MessageProperties"
             }
           ]
         },
@@ -13197,7 +13316,7 @@
         {
           "name": "onNewMailReceived",
           "type": "function",
-          "description": "Fired when a new message is received, and has been through junk classification and message filters.",
+          "description": "Fired when a new message is received, and has been handled by message filters and junk classification. Filters running after junk classification may move the message again.",
           "permissions": [
             "accountsRead"
           ],
@@ -13831,6 +13950,18 @@
                 }
               ],
               "description": "The folder to move the messages to."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "isUserAction": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this move operation should be treated as a user action, for example allowing undo."
+                }
+              }
             }
           ]
         },
@@ -13857,6 +13988,18 @@
               "name": "folderId",
               "$ref": "folders.MailFolderId",
               "description": "The folder to move the messages to."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "isUserAction": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this move operation should be treated as a user action, for example allowing undo."
+                }
+              }
             }
           ]
         },
@@ -13891,6 +14034,18 @@
                 }
               ],
               "description": "The folder to copy the messages to."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "isUserAction": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this copy operation should be treated as a user action, for example allowing undo."
+                }
+              }
             }
           ]
         },
@@ -13917,13 +14072,25 @@
               "name": "folderId",
               "$ref": "folders.MailFolderId",
               "description": "The folder to copy the messages to."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "isUserAction": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "Whether this copy operation should be treated as a user action, for example allowing undo."
+                }
+              }
             }
           ]
         },
         {
           "name": "delete",
           "type": "function",
-          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The <var>skipTrash</var> parameter allows immediate permanent deletion, bypassing the trash folder.",
+          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The <var>deletePermanently</var> parameter allows immediate permanent deletion, bypassing the trash folder.",
           "async": true,
           "permissions": [
             "messagesDelete"
@@ -13938,10 +14105,30 @@
               }
             },
             {
-              "name": "skipTrash",
-              "type": "boolean",
-              "description": "If true, the message will be deleted permanently, regardless of the account's deletion behavior settings.",
-              "optional": true
+              "name": "options",
+              "optional": true,
+              "choices": [
+                {
+                  "type": "boolean",
+                  "deprecated": "Specify the options object instead of a plain boolean to delete messages permanently.",
+                  "description": "Whether the message will be deleted permanently, regardless of the account's deletion behavior settings."
+                },
+                {
+                  "type": "object",
+                  "properties": {
+                    "deletePermanently": {
+                      "type": "boolean",
+                      "optional": true,
+                      "description": "Whether the message will be deleted permanently, regardless of the account's deletion behavior settings. Use this with care!"
+                    },
+                    "isUserAction": {
+                      "type": "boolean",
+                      "optional": true,
+                      "description": "Whether this copy operation should be treated as a user action, for example allowing undo. Note: Deleting messages permanently cannot be undone!"
+                    }
+                  }
+                }
+              ]
             }
           ]
         },
@@ -14098,7 +14285,7 @@
             {
               "type": "string",
               "name": "color",
-              "description": "Tag color in hex format (i.e.: <var>#000080</var> for navy blue). Value will be stored as upper case.",
+              "description": "Tag color in hex format (i.e.: <var>#000080</var> for navy blue).",
               "pattern": "^#[0-9a-fA-F]{6}"
             }
           ]
@@ -14132,7 +14319,7 @@
                 "color": {
                   "type": "string",
                   "pattern": "^#[0-9a-fA-F]{6}",
-                  "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
+                  "description": "Tag color in hex format (i.e.: <var>#000080</var> for navy blue).",
                   "optional": true
                 }
               }
@@ -14177,11 +14364,33 @@
             },
             "color": {
               "type": "string",
-              "description": "Tag color."
+              "description": "Tag color in upper case hex format (i.e.: <var>#000080</var> for navy blue)."
+            },
+            "ordinal": {
+              "type": "string",
+              "description": "A custom sort string."
+            }
+          }
+        },
+        {
+          "id": "MessageTagProperties",
+          "type": "object",
+          "properties": {
+            "tag": {
+              "type": "string",
+              "optional": true,
+              "description": "Human-readable tag name."
+            },
+            "color": {
+              "type": "string",
+              "pattern": "^#[0-9a-fA-F]{6}",
+              "optional": true,
+              "description": "Tag color in upper case hex format (i.e.: <var>#000080</var> for navy blue)."
             },
             "ordinal": {
               "type": "string",
-              "description": "Custom sort string (usually empty)."
+              "optional": true,
+              "description": "A custom sort string."
             }
           }
         },
@@ -14210,6 +14419,62 @@
           }
         }
       ],
+      "events": [
+        {
+          "name": "onCreated",
+          "permissions": [
+            "messagesTagsList"
+          ],
+          "type": "function",
+          "description": "Fired when a new message tag has been created.",
+          "parameters": [
+            {
+              "name": "tag",
+              "$ref": "messages.tags.MessageTag"
+            }
+          ]
+        },
+        {
+          "name": "onUpdated",
+          "permissions": [
+            "messagesTagsList"
+          ],
+          "type": "function",
+          "description": "Fired when one or more properties of a message tag have been updated.",
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "Unique tag identifier of the updated message tag."
+            },
+            {
+              "name": "changedProperties",
+              "$ref": "messages.tags.MessageTagProperties",
+              "description": "The changed message tag properties."
+            },
+            {
+              "name": "oldProperties",
+              "$ref": "messages.tags.MessageTagProperties",
+              "description": "The old values of the changed message tag properties."
+            }
+          ]
+        },
+        {
+          "name": "onDeleted",
+          "type": "function",
+          "description": "Fired when a message tag has been deleted.",
+          "permissions": [
+            "accountsRead"
+          ],
+          "parameters": [
+            {
+              "type": "string",
+              "name": "key",
+              "description": "Unique tag identifier of the deleted message tag."
+            }
+          ]
+        }
+      ],
       "functions": [
         {
           "name": "list",
@@ -14238,7 +14503,7 @@
         {
           "name": "create",
           "type": "function",
-          "description": "Creates a new message tag. Tagging a message will store the tag's key in the user's message. Throws if the specified tag key is used already.",
+          "description": "Creates a new message tag and returns the associated key. Tagging a message will store the tag's key in the user's message. Throws if the specified tag key is used already.",
           "async": true,
           "permissions": [
             "messagesTags"
@@ -14247,7 +14512,8 @@
             {
               "type": "string",
               "name": "key",
-              "description": "Unique tag identifier (will be converted to lower case). Must not include <var>()<>{/%*\"</var> or spaces.",
+              "optional": true,
+              "description": "Unique tag identifier (will be converted to lower case). Must not include <var>()<>{/%*\"</var> or spaces. Will be auto-generated if not provided.",
               "pattern": "^[^ ()/{%*<>\"]+$"
             },
             {
@@ -14258,8 +14524,19 @@
             {
               "type": "string",
               "name": "color",
-              "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
+              "description": "Tag color in hex format (i.e.: <var>#000080</var> for navy blue).",
               "pattern": "^#[0-9a-fA-F]{6}"
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string",
+                  "name": "key"
+                }
+              ]
             }
           ]
         },
@@ -14279,21 +14556,8 @@
               "pattern": "^[^ ()/{%*<>\"]+$"
             },
             {
-              "type": "object",
               "name": "updateProperties",
-              "properties": {
-                "tag": {
-                  "type": "string",
-                  "optional": true,
-                  "description": "Human-readable tag name."
-                },
-                "color": {
-                  "type": "string",
-                  "pattern": "^#[0-9a-fA-F]{6}",
-                  "description": "Tag color in hex format (i.e.: #000080 for navy blue). Value will be stored as upper case.",
-                  "optional": true
-                }
-              }
+              "$ref": "messages.tags.MessageTagProperties"
             }
           ]
         },
@@ -14317,21 +14581,295 @@
       ]
     }
   ],
-  "sessions.json": [
+  "messenger_settings.json": [
     {
-      "namespace": "sessions",
-      "functions": [
+      "namespace": "manifest",
+      "types": [
         {
-          "name": "setTabValue",
-          "type": "function",
-          "description": "Store a key/value pair associated with a given tab.",
-          "async": true,
-          "parameters": [
-            {
-              "name": "tabId",
-              "type": "integer",
-              "description": "ID of the tab with which you want to associate the data. Error is thrown if ID is invalid."
-            },
+          "$extend": "OptionalPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "messengerSettings"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "namespace": "messengerSettings",
+      "description": "The messengerSettings API allows to access global messenger settings.",
+      "permissions": [
+        "messengerSettings"
+      ],
+      "properties": {
+        "messagePlainTextFlowedOutputEnabled": {
+          "$ref": "types.Setting",
+          "description": "Whether long lines in outgoing plain text messages will get soft line breaks (<var> \n</var>) or hard line breaks (<var>\n</var>), to comply with requirements from RFC 2822. Soft line breaks will be ignored when displayed by the receiving client. When flowed output is enabled, add-ons should not create plain text messages with manually inserted hard or soft line breaks to achieve a certain text width, as that will most probably interfere with the default line break handling and generate ridged text. When flowed output is disabled, add-ons could add hard line breaks to have control over the final message, but any line longer than the maximum line length will still receive additional hard line breaks. See $(ref:messengerSettings.messageLineLengthLimit)."
+        },
+        "messageLineLengthLimit": {
+          "$ref": "types.Setting",
+          "description": "The line length limit for outgoing messages, to comply with requirements from RFC 2822. See description of $(ref:messengerSettings.messagePlainTextFlowedOutputEnabled)."
+        }
+      }
+    }
+  ],
+  "messenger_utilities.json": [
+    {
+      "namespace": "messengerUtilities",
+      "types": [
+        {
+          "id": "ParsedMailbox",
+          "type": "object",
+          "description": "Representation of a parsed mailbox string (see RFC 5322, section 3.4).",
+          "properties": {
+            "name": {
+              "type": "string",
+              "optional": true,
+              "description": "The <var>display-name</var> associated with the provided address or group, if available."
+            },
+            "email": {
+              "type": "string",
+              "optional": true,
+              "description": "The <var>addr-spec</var> associated with the provided address, if available."
+            },
+            "group": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "$ref": "messengerUtilities.ParsedMailbox"
+              },
+              "description": "The members of the group, if available."
+            }
+          }
+        },
+        {
+          "id": "MailboxHeaders",
+          "type": "string",
+          "description": "MIME headers, which by default are treated as containing one or more mailbox strings.",
+          "enum": [
+            "bcc",
+            "cc",
+            "from",
+            "reply-to",
+            "resent-bcc",
+            "resent-cc",
+            "resent-from",
+            "resent-reply-to",
+            "resent-sender",
+            "resent-to",
+            "sender",
+            "to",
+            "approved",
+            "disposition-notification-to",
+            "delivered-to",
+            "return-receipt-to",
+            "mail-reply-to",
+            "mail-followup-to"
+          ]
+        }
+      ],
+      "functions": [
+        {
+          "name": "convertToPlainText",
+          "type": "function",
+          "description": "Converts the provided body to readable plain text, without tags and leading/trailing whitespace.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "body",
+              "type": "string",
+              "description": "The to-be-converted body."
+            },
+            {
+              "name": "options",
+              "type": "object",
+              "optional": true,
+              "properties": {
+                "flowed": {
+                  "type": "boolean",
+                  "optional": true,
+                  "description": "The converted plain text will be wrapped to lines not longer than 72 characters and use format flowed, as defined by RFC 2646."
+                }
+              }
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "formatFileSize",
+          "type": "function",
+          "description": "Returns the provided file size in a human readable format (e.g. <var>12 bytes</var> or <var>11,4 GB</var>).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "integer",
+              "name": "sizeInBytes",
+              "description": "The size in bytes."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "parseMailboxString",
+          "type": "function",
+          "description": "Parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4).",
+          "async": "callback",
+          "parameters": [
+            {
+              "type": "string",
+              "name": "mailboxString",
+              "description": "The string to be parsed (e.g. <var>User <user@example.com>, other-user@example.com</var>)"
+            },
+            {
+              "type": "boolean",
+              "name": "preserveGroups",
+              "optional": true,
+              "description": "Keep grouped hierachies. Groups may be specified in a mailbox string as follows: <var>GroupName : user1 <user1@example.com>, user2@example,com ;</var>."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "$ref": "messengerUtilities.ParsedMailbox"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "decodeMimeHeader",
+          "type": "function",
+          "description": "Decode the provided header into a readable format according to RFC 2047.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "headerName",
+              "type": "string"
+            },
+            {
+              "name": "headerValue",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "name": "isMailBoxHeader",
+              "type": "boolean",
+              "optional": true,
+              "description": "Headers containing multiple mailbox strings need special handling. For example the header <var>=?UTF-8?Q?H=C3=B6rst=2C_Kenny?= <K.Hoerst@invalid>, new@thunderbird.bug</var> will be wrongly decoded to <var>Hörst, Kenny <K.Hoerst@invalid>, new@thunderbird.bug</var>, corrupting the structure of the first mailbox string. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "encodeMimeHeader",
+          "type": "function",
+          "description": "Encode the provided header according to RFC 2047.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "headerName",
+              "type": "string"
+            },
+            {
+              "name": "headerValue",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "name": "isMailBoxHeader",
+              "type": "boolean",
+              "optional": true,
+              "description": "Headers containing multiple mailbox strings need special handling. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
+            },
+            {
+              "type": "function",
+              "name": "callback",
+              "optional": true,
+              "parameters": [
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "sessions.json": [
+    {
+      "namespace": "sessions",
+      "functions": [
+        {
+          "name": "setTabValue",
+          "type": "function",
+          "description": "Store a key/value pair associated with a given tab.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "tabId",
+              "type": "integer",
+              "description": "ID of the tab with which you want to associate the data. Error is thrown if ID is invalid."
+            },
             {
               "name": "key",
               "type": "string",
@@ -14411,6 +14949,16 @@
               "type": "string",
               "optional": true,
               "description": "The <a href='url-cookieStore'>CookieStore</a> id used by the tab. Either a custom id created using the <a href='url-contextualIdentity'>contextualIdentities API</a>, or a built-in one: <var>firefox-default</var>, <var>firefox-container-1</var>, <var>firefox-container-2</var>, <var>firefox-container-3</var>, <var>firefox-container-4</var>, <var>firefox-container-5</var>. **Note:** The naming pattern was deliberately not changed for Thunderbird, but kept for compatibility reasons. The <permission>cookies</permission> permission is required to be able to specify this property. Furthermore, the <permission>contextualIdentities</permission> permission should be requested, to enable the contextual identities feature (enabled by default only on Thunderbird Daily)."
+            },
+            "linkHandler": {
+              "type": "string",
+              "enum": [
+                "strict",
+                "balanced",
+                "relaxed"
+              ],
+              "optional": true,
+              "description": "Thunderbird is a mail client, not a browser. It is possible to load a web page, but opening follow-up pages through hyperlinks should be handled by the user's default browser. This property specifies to what extent this behavior should be enforced. The default <var>balanced</var> link handler will open links to the same host directly in Thunderbird, everything else will be opened in the user's default browser. A <var>relaxed</var> link handler will open all links inside of Thunderbird, a <var>strict</var> link handler will open all links in the user's default browser, except links to the same page."
             }
           }
         },
@@ -15323,6 +15871,16 @@
                   "optional": true,
                   "description": "The <a href='url-cookieStore'>CookieStore</a> id the new tab should use. Either a custom id created using the <a href='url-contextualIdentity'>contextualIdentities API</a>, or a built-in one: <var>firefox-default</var>, <var>firefox-container-1</var>, <var>firefox-container-2</var>, <var>firefox-container-3</var>, <var>firefox-container-4</var>, <var>firefox-container-5</var>. **Note:** The naming pattern was deliberately not changed for Thunderbird, but kept for compatibility reasons. The <permission>cookies</permission> permission is required to be able to specify this property. Furthermore, the <permission>contextualIdentities</permission> permission should be requested, to enable the contextual identities feature (enabled by default only on Thunderbird Daily)."
                 },
+                "linkHandler": {
+                  "type": "string",
+                  "enum": [
+                    "strict",
+                    "balanced",
+                    "relaxed"
+                  ],
+                  "optional": true,
+                  "description": "Thunderbird is a mail client, not a browser. It is possible to load a web page, but opening follow-up pages through hyperlinks should be handled by the user's default browser. This property specifies to what extent this behavior should be enforced. The default <var>balanced</var> link handler will open links to the same host directly in Thunderbird, everything else will be opened in the user's default browser. A <var>relaxed</var> link handler will open all links inside of Thunderbird, a <var>strict</var> link handler will open all links in the user's default browser, except links to the same page."
+                },
                 "selected": {
                   "deprecated": "Please use <var>createProperties.active</var>.",
                   "unsupported": true,
@@ -15967,245 +16525,6 @@
       ]
     }
   ],
-  "utilities.json": [
-    {
-      "namespace": "messengerUtilities",
-      "types": [
-        {
-          "id": "ParsedMailbox",
-          "type": "object",
-          "description": "Representation of a parsed mailbox string (see RFC 5322, section 3.4).",
-          "properties": {
-            "name": {
-              "type": "string",
-              "optional": true,
-              "description": "The <var>display-name</var> associated with the provided address or group, if available."
-            },
-            "email": {
-              "type": "string",
-              "optional": true,
-              "description": "The <var>addr-spec</var> associated with the provided address, if available."
-            },
-            "group": {
-              "type": "array",
-              "optional": true,
-              "items": {
-                "$ref": "messengerUtilities.ParsedMailbox"
-              },
-              "description": "The members of the group, if available."
-            }
-          }
-        },
-        {
-          "id": "MailboxHeaders",
-          "type": "string",
-          "description": "MIME headers, which by default are treated as containing one or more mailbox strings.",
-          "enum": [
-            "bcc",
-            "cc",
-            "from",
-            "reply-to",
-            "resent-bcc",
-            "resent-cc",
-            "resent-from",
-            "resent-reply-to",
-            "resent-sender",
-            "resent-to",
-            "sender",
-            "to",
-            "approved",
-            "disposition-notification-to",
-            "delivered-to",
-            "return-receipt-to",
-            "mail-reply-to",
-            "mail-followup-to"
-          ]
-        }
-      ],
-      "functions": [
-        {
-          "name": "convertToPlainText",
-          "type": "function",
-          "description": "Converts the provided body to readable plain text, without tags and leading/trailing whitespace.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "body",
-              "type": "string",
-              "description": "The to-be-converted body."
-            },
-            {
-              "name": "options",
-              "type": "object",
-              "optional": true,
-              "properties": {
-                "flowed": {
-                  "type": "boolean",
-                  "optional": true,
-                  "description": "The converted plain text will be wrapped to lines not longer than 72 characters and use format flowed, as defined by RFC 2646."
-                }
-              }
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "formatFileSize",
-          "type": "function",
-          "description": "Returns the provided file size in a human readable format (e.g. <var>12 bytes</var> or <var>11,4 GB</var>).",
-          "async": "callback",
-          "parameters": [
-            {
-              "type": "integer",
-              "name": "sizeInBytes",
-              "description": "The size in bytes."
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "type": "string"
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "parseMailboxString",
-          "type": "function",
-          "description": "Parse a mailbox string containing one or more email addresses (see RFC 5322, section 3.4).",
-          "async": "callback",
-          "parameters": [
-            {
-              "type": "string",
-              "name": "mailboxString",
-              "description": "The string to be parsed (e.g. <var>User <user@example.com>, other-user@example.com</var>)"
-            },
-            {
-              "type": "boolean",
-              "name": "preserveGroups",
-              "optional": true,
-              "description": "Keep grouped hierachies. Groups may be specified in a mailbox string as follows: <var>GroupName : user1 <user1@example.com>, user2@example,com ;</var>."
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "type": "array",
-                  "items": {
-                    "$ref": "messengerUtilities.ParsedMailbox"
-                  }
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "decodeMimeHeader",
-          "type": "function",
-          "description": "Decode the provided header into a readable format according to RFC 2047.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "headerName",
-              "type": "string"
-            },
-            {
-              "name": "headerValue",
-              "choices": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "name": "isMailBoxHeader",
-              "type": "boolean",
-              "optional": true,
-              "description": "Headers containing multiple mailbox strings need special handling. For example the header <var>=?UTF-8?Q?H=C3=B6rst=2C_Kenny?= <K.Hoerst@invalid>, new@thunderbird.bug</var> will be wrongly decoded to <var>Hörst, Kenny <K.Hoerst@invalid>, new@thunderbird.bug</var>, corrupting the structure of the first mailbox string. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ]
-            }
-          ]
-        },
-        {
-          "name": "encodeMimeHeader",
-          "type": "function",
-          "description": "Encode the provided header according to RFC 2047.",
-          "async": "callback",
-          "parameters": [
-            {
-              "name": "headerName",
-              "type": "string"
-            },
-            {
-              "name": "headerValue",
-              "choices": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ]
-            },
-            {
-              "name": "isMailBoxHeader",
-              "type": "boolean",
-              "optional": true,
-              "description": "Headers containing multiple mailbox strings need special handling. This option overrides the default behavior of treating the headers defined in $(ref:messengerUtilities.MailboxHeaders) as mailbox headers."
-            },
-            {
-              "type": "function",
-              "name": "callback",
-              "optional": true,
-              "parameters": [
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  }
-                }
-              ]
-            }
-          ]
-        }
-      ]
-    }
-  ],
   "windows.json": [
     {
       "namespace": "windows",
@@ -16536,6 +16855,16 @@
                   "optional": true,
                   "description": "The <a href='url-cookieStore'>CookieStore</a> id which all initially opened tabs should use. Either a custom id created using the <a href='url-contextualIdentity'>contextualIdentities API</a>, or a built-in one: <var>firefox-default</var>, <var>firefox-container-1</var>, <var>firefox-container-2</var>, <var>firefox-container-3</var>, <var>firefox-container-4</var>, <var>firefox-container-5</var>. **Note:** The naming pattern was deliberately not changed for Thunderbird, but kept for compatibility reasons. The <permission>cookies</permission> permission is required to be able to specify this property. Furthermore, the <permission>contextualIdentities</permission> permission should be requested, to enable the contextual identities feature (enabled by default only on Thunderbird Daily)."
                 },
+                "linkHandler": {
+                  "type": "string",
+                  "enum": [
+                    "strict",
+                    "balanced",
+                    "relaxed"
+                  ],
+                  "optional": true,
+                  "description": "Thunderbird is a mail client, not a browser. It is possible to load a web page, but opening follow-up pages through hyperlinks should be handled by the user's default browser. This property specifies to what extent this behavior should be enforced. The default <var>balanced</var> link handler will open links to the same host directly in Thunderbird, everything else will be opened in the user's default browser. A <var>relaxed</var> link handler will open all links inside of Thunderbird, a <var>strict</var> link handler will open all links in the user's default browser, except links to the same page."
+                },
                 "titlePreface": {
                   "type": "string",
                   "optional": true,