webext-schema 5.5.1 → 5.5.2

package/package.json

@@ -14,30 +14,27 @@
   "types": "types/index.d.ts",
   "dependencies": {
     "camelize": "^1.0.1",
-    "commander": "^12.1.0",
+    "commander": "^13.0.0",
     "decamelize": "^6.0.0",
     "json5": "^2.2.3",
     "sinon": "^19.0.2"
   },
   "devDependencies": {
     "@types/firefox-webext-browser": "^120.0.4",
-    "@types/node": "^22.10.1",
+    "@types/node": "^22.10.5",
     "@types/sinon": "^17.0.3",
-    "c8": "^10.1.2",
-    "eslint": "^9.15.0",
-    "eslint-plugin-import-x": "^4.4.3",
-    "eslint-plugin-jsdoc": "^50.6.0",
+    "c8": "^10.1.3",
+    "eslint": "^9.17.0",
+    "eslint-plugin-import-x": "^4.6.1",
+    "eslint-plugin-jsdoc": "^50.6.1",
     "eslint-plugin-regexp": "^2.7.0",
     "eslint-plugin-unicorn": "^56.0.1",
-    "globals": "^15.12.0",
-    "mocha": "^10.8.2",
-    "neostandard": "^0.11.9",
-    "npm-run-all2": "^7.0.1",
-    "typescript": "^5.7.2",
-    "undici": "^7.0.0"
-  },
-  "overrides": {
-    "glob": "^10.4.5"
+    "globals": "^15.14.0",
+    "mocha": "^11.0.1",
+    "neostandard": "^0.12.0",
+    "npm-run-all2": "^7.0.2",
+    "typescript": "^5.7.3",
+    "undici": "^7.2.0"
   },
   "scripts": {
     "build": "npm run tsc && npm run lint && npm run test",
@@ -57,5 +54,5 @@
     "update-mail": "node index update --channel=mail -i",
     "update-release": "node index update --channel=release -i"
   },
-  "version": "5.5.1"
+  "version": "5.5.2"
 }

package/schemas/beta/webext.json

@@ -9590,6 +9590,7 @@
             "imageset",
             "web_manifest",
             "speculative",
+            "json",
             "other"
           ]
         },
@@ -12398,7 +12399,8 @@
             "bandwidth",
             "memory",
             "tracing",
-            "sandbox"
+            "sandbox",
+            "flows"
           ]
         },
         {
@@ -20423,6 +20425,7 @@
             "imageset",
             "web_manifest",
             "speculative",
+            "json",
             "other"
           ]
         },

package/schemas/central/webext.json

@@ -9590,6 +9590,7 @@
             "imageset",
             "web_manifest",
             "speculative",
+            "json",
             "other"
           ]
         },
@@ -12398,7 +12399,8 @@
             "bandwidth",
             "memory",
             "tracing",
-            "sandbox"
+            "sandbox",
+            "flows"
           ]
         },
         {
@@ -20423,6 +20425,7 @@
             "imageset",
             "web_manifest",
             "speculative",
+            "json",
             "other"
           ]
         },

package/schemas/mail/mailext.json

@@ -13066,12 +13066,26 @@
         {
           "id": "MessageAttachment",
           "type": "object",
-          "description": "Represents an attachment in a message. This includes all MIME parts with a <em>content-disposition</em> header set to <var>attachment</var>, but also related parts like inline images.",
+          "description": "Represents an attachment in a message.",
           "properties": {
+            "contentDisposition": {
+              "type": "string",
+              "description": "The content disposition of the attachment, for example <var>attachment</var> for normal attachments, or <var>inline</var> for inline attachments."
+            },
             "contentType": {
               "type": "string",
               "description": "The content type of the attachment. A value of <var>text/x-moz-deleted</var> indicates that the original attachment was permanently deleted and replaced by a placeholder text attachment with some meta information about the original attachment."
             },
+            "headers": {
+              "type": "object",
+              "description": "A <em>dictionary object</em> of RFC 2047 decoded attachment headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>.",
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
             "name": {
               "type": "string",
               "description": "The name, as displayed to the user, of this attachment. This is usually but not always the filename of the attached file."
@@ -14383,8 +14397,26 @@
     {
       "namespace": "spaces",
       "types": [
+        {
+          "id": "SpaceTabProperties",
+          "description": "Properties for the new tab being opened by clicking on the associated button in the spaces toolbar.",
+          "type": "object",
+          "properties": {
+            "url": {
+              "type": "string",
+              "optional": true,
+              "description": "The default URL. May point to a WebExtension page or a web page."
+            },
+            "cookieStoreId": {
+              "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)."
+            }
+          }
+        },
         {
           "id": "SpaceButtonProperties",
+          "description": "Properties of a button in the spaces toolbar.",
           "choices": [
             {
               "max_manifest_version": 2,
@@ -14533,13 +14565,20 @@
               "description": "The name to assign to this space. May only contain alphanumeric characters and underscores. Must be unique for this extension."
             },
             {
-              "name": "defaultUrl",
-              "type": "string",
-              "description": "The default space url, loaded into a tab when the button in the spaces toolbar is clicked. Supported are <var>https://</var> and <var>http://</var> links, as well as links to WebExtension pages."
+              "name": "tabProperties",
+              "choices": [
+                {
+                  "$ref": "spaces.SpaceTabProperties"
+                },
+                {
+                  "type": "string"
+                }
+              ],
+              "description": "The properties for the new tab being opened, when the associated button in the spaces toolbar is clicked. Either a <em>string</em> specifiying the default URL, or a $(ref:spaces.SpaceTabProperties) object. The URL may point to a WebExtension page or a web page."
             },
             {
               "name": "buttonProperties",
-              "description": "Properties of the button for the new space.",
+              "description": "Properties of the button in the spaces toolbar for the new space.",
               "$ref": "spaces.SpaceButtonProperties",
               "optional": true,
               "default": {}
@@ -14674,14 +14713,23 @@
               "minimum": 1
             },
             {
-              "name": "defaultUrl",
-              "type": "string",
-              "description": "The default space url, loaded into a tab when the button in the spaces toolbar is clicked. Supported are <var>https://</var> and <var>http://</var> links, as well as links to WebExtension pages.",
-              "optional": true
+              "name": "tabProperties",
+              "choices": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "spaces.SpaceTabProperties"
+                },
+                {
+                  "$ref": "spaces.SpaceButtonProperties"
+                }
+              ],
+              "description": "The properties for the new tab being opened, when the associated button in the spaces toolbar is clicked. Either a <em>string</em> specifiying the default URL, or a $(ref:spaces.SpaceTabProperties) object. The URL may point to a WebExtension page or a web page."
             },
             {
               "name": "buttonProperties",
-              "description": "Only specified button properties will be updated.",
+              "description": "Properties of the button in the spaces toolbar for the specified space Only specified button properties will be updated.",
               "$ref": "spaces.SpaceButtonProperties",
               "optional": true
             }
@@ -15273,7 +15321,7 @@
                 "cookieStoreId": {
                   "type": "string",
                   "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."
+                  "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)."
                 },
                 "selected": {
                   "deprecated": "Please use <var>createProperties.active</var>.",
@@ -16486,7 +16534,7 @@
                 "cookieStoreId": {
                   "type": "string",
                   "optional": true,
-                  "description": "The CookieStoreId to use for all tabs that were created when the window is opened."
+                  "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)."
                 },
                 "titlePreface": {
                   "type": "string",

package/schemas/release/webext.json

@@ -748,54 +748,6 @@
                       "type": "boolean",
                       "optional": true,
                       "description": "Sets the default engine to a built-in engine only."
-                    },
-                    "params": {
-                      "optional": true,
-                      "max_manifest_version": 2,
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "name": {
-                            "type": "string",
-                            "description": "A url parameter name"
-                          },
-                          "condition": {
-                            "type": "string",
-                            "optional": true,
-                            "enum": [
-                              "purpose",
-                              "pref"
-                            ],
-                            "description": "The type of param can be either \"purpose\" or \"pref\"."
-                          },
-                          "pref": {
-                            "type": "string",
-                            "optional": true,
-                            "description": "The preference to retrieve the value from.",
-                            "preprocess": "localize"
-                          },
-                          "purpose": {
-                            "type": "string",
-                            "optional": true,
-                            "enum": [
-                              "contextmenu",
-                              "searchbar",
-                              "homepage",
-                              "keyword",
-                              "newtab"
-                            ],
-                            "description": "The context that initiates a search, required if condition is \"purpose\"."
-                          },
-                          "value": {
-                            "type": "string",
-                            "optional": true,
-                            "description": "A url parameter value.",
-                            "preprocess": "localize"
-                          }
-                        }
-                      },
-                      "description": "A list of optional search url parameters. This allows the additon of search url parameters based on how the search is performed in Firefox."
                     }
                   }
                 }
@@ -12445,7 +12397,8 @@
             "cpufreq",
             "bandwidth",
             "memory",
-            "tracing"
+            "tracing",
+            "sandbox"
           ]
         },
         {
@@ -13912,6 +13865,15 @@
             "$ref": "UnrecognizedProperty"
           }
         },
+        {
+          "id": "OptionalOnlyPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": []
+            }
+          ]
+        },
         {
           "id": "OptionalPermissionNoPrompt",
           "choices": [
@@ -13946,6 +13908,9 @@
             {
               "$ref": "OptionalPermission"
             },
+            {
+              "$ref": "OptionalOnlyPermission"
+            },
             {
               "$ref": "MatchPattern"
             }
@@ -14419,7 +14384,7 @@
         {
           "name": "getLinkInfo",
           "type": "function",
-          "description": "Returns the $(ref:NetworkLinkInfo} of the current network connection.",
+          "description": "Returns the $(ref:NetworkLinkInfo) of the current network connection.",
           "async": true,
           "parameters": []
         }
@@ -15249,7 +15214,14 @@
             "permissions": {
               "type": "array",
               "items": {
-                "$ref": "manifest.OptionalPermission"
+                "choices": [
+                  {
+                    "$ref": "manifest.OptionalPermission"
+                  },
+                  {
+                    "$ref": "manifest.OptionalOnlyPermission"
+                  }
+                ]
               },
               "optional": true,
               "default": []
@@ -15271,7 +15243,14 @@
             "permissions": {
               "type": "array",
               "items": {
-                "$ref": "manifest.Permission"
+                "choices": [
+                  {
+                    "$ref": "manifest.Permission"
+                  },
+                  {
+                    "$ref": "manifest.OptionalOnlyPermission"
+                  }
+                ]
               },
               "optional": true,
               "default": []
@@ -16048,6 +16027,11 @@
               "type": "string",
               "optional": true,
               "description": "The TLS channel ID of the page or frame that opened the connection, if requested by the extension or app, and if available."
+            },
+            "userScriptWorldId": {
+              "type": "string",
+              "optional": true,
+              "description": "The worldId of the USER_SCRIPT world that sent the message. Only present on onUserScriptMessage and onUserScriptConnect (in port.sender) events."
             }
           }
         },
@@ -16716,6 +16700,20 @@
             }
           ]
         },
+        {
+          "name": "onUserScriptConnect",
+          "type": "function",
+          "description": "Fired when a connection is made from a USER_SCRIPT world registered through the userScripts API.",
+          "permissions": [
+            "userScripts"
+          ],
+          "parameters": [
+            {
+              "$ref": "Port",
+              "name": "port"
+            }
+          ]
+        },
         {
           "name": "onConnectExternal",
           "type": "function",
@@ -16785,6 +16783,36 @@
             "description": "Return true from the event listener if you wish to call <code>sendResponse</code> after the event listener returns."
           }
         },
+        {
+          "name": "onUserScriptMessage",
+          "type": "function",
+          "description": "Fired when a message is sent from a USER_SCRIPT world registered through the userScripts API.",
+          "permissions": [
+            "userScripts"
+          ],
+          "parameters": [
+            {
+              "name": "message",
+              "type": "any",
+              "optional": true,
+              "description": "The message sent by the calling script."
+            },
+            {
+              "name": "sender",
+              "$ref": "MessageSender"
+            },
+            {
+              "name": "sendResponse",
+              "type": "function",
+              "description": "Function to call (at most once) when you have a response. The argument should be any JSON-ifiable object. If you have more than one <code>onMessage</code> listener in the same document, then only one may send a response. This function becomes invalid when the event listener returns, unless you return true from the event listener to indicate you wish to send a response asynchronously (this will keep the message channel open to the other end until <code>sendResponse</code> is called)."
+            }
+          ],
+          "returns": {
+            "type": "boolean",
+            "optional": true,
+            "description": "Return true from the event listener if you wish to call <code>sendResponse</code> after the event listener returns."
+          }
+        },
         {
           "name": "onRestartRequired",
           "unsupported": true,
@@ -17874,6 +17902,7 @@
         },
         {
           "name": "scalarAdd",
+          "deprecated": "`scalarAdd` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Adds the value to the given scalar.",
           "async": true,
@@ -17893,6 +17922,7 @@
         },
         {
           "name": "scalarSet",
+          "deprecated": "`scalarSet` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Sets the named scalar to the given value. Throws if the value type doesn't match the scalar type.",
           "async": true,
@@ -17927,6 +17957,7 @@
         },
         {
           "name": "scalarSetMaximum",
+          "deprecated": "`scalarSetMaximum` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Sets the scalar to the maximum of the current and the passed value",
           "async": true,
@@ -17946,6 +17977,7 @@
         },
         {
           "name": "keyedScalarAdd",
+          "deprecated": "`keyedScalarAdd` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Adds the value to the given keyed scalar.",
           "async": true,
@@ -17970,6 +18002,7 @@
         },
         {
           "name": "keyedScalarSet",
+          "deprecated": "`keyedScalarSet` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Sets the keyed scalar to the given value. Throws if the value type doesn't match the scalar type.",
           "async": true,
@@ -18009,6 +18042,7 @@
         },
         {
           "name": "keyedScalarSetMaximum",
+          "deprecated": "`keyedScalarSetMaximum` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Sets the keyed scalar to the maximum of the current and the passed value",
           "async": true,
@@ -18072,6 +18106,7 @@
         },
         {
           "name": "registerScalars",
+          "deprecated": "`registerScalars` is a no-op since Firefox 134 (see bug 1930196)",
           "type": "function",
           "description": "Register new scalars to record them from addons. See nsITelemetry.idl for more details.",
           "async": true,
@@ -18939,6 +18974,110 @@
       ]
     }
   ],
+  "trial_ml.json": [
+    {
+      "namespace": "manifest",
+      "types": [
+        {
+          "$extend": "OptionalOnlyPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "trialML"
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "namespace": "trial",
+      "allowedContexts": [
+        "content"
+      ],
+      "permissions": [
+        "trialML"
+      ]
+    },
+    {
+      "namespace": "trial.ml",
+      "description": "Use the trial ML API to run Machine Learning models requests from extensions pages or content scripts.",
+      "allowedContexts": [
+        "content"
+      ],
+      "permissions": [
+        "trialML"
+      ],
+      "events": [
+        {
+          "name": "onProgress",
+          "type": "function",
+          "allowedContexts": [
+            "content"
+          ],
+          "description": "Events from the inference engine.",
+          "parameters": [
+            {
+              "name": "progressData",
+              "description": "Object containing the data, see https://firefox-source-docs.mozilla.org/toolkit/components/ml/notifications.html",
+              "type": "object"
+            }
+          ]
+        }
+      ],
+      "types": [
+        {
+          "id": "CreateEngineRequest",
+          "type": "object",
+          "additionalProperties": true
+        },
+        {
+          "id": "RunEngineRequest",
+          "type": "object",
+          "additionalProperties": true
+        }
+      ],
+      "functions": [
+        {
+          "name": "createEngine",
+          "type": "function",
+          "description": "Prepare the inference engine",
+          "async": true,
+          "parameters": [
+            {
+              "name": "CreateEngineRequest",
+              "$ref": "CreateEngineRequest"
+            }
+          ]
+        },
+        {
+          "name": "runEngine",
+          "type": "function",
+          "allowedContexts": [
+            "content"
+          ],
+          "description": "Call the inference engine",
+          "async": true,
+          "parameters": [
+            {
+              "name": "RunEngineRequest",
+              "$ref": "RunEngineRequest"
+            }
+          ]
+        },
+        {
+          "name": "deleteCachedModels",
+          "type": "function",
+          "allowedContexts": [
+            "content"
+          ],
+          "description": "Delete the models the extension downloaded.",
+          "async": true
+        }
+      ]
+    }
+  ],
   "types.json": [
     {
       "namespace": "types",
@@ -19111,6 +19250,17 @@
     {
       "namespace": "manifest",
       "types": [
+        {
+          "$extend": "OptionalOnlyPermission",
+          "choices": [
+            {
+              "type": "string",
+              "enum": [
+                "userScripts"
+              ]
+            }
+          ]
+        },
         {
           "$extend": "WebExtensionManifest",
           "properties": {
@@ -19134,13 +19284,14 @@
     },
     {
       "namespace": "userScripts",
-      "max_manifest_version": 2,
       "permissions": [
-        "manifest:user_scripts"
+        "manifest:user_scripts",
+        "userScripts"
       ],
       "types": [
         {
           "id": "UserScriptOptions",
+          "max_manifest_version": 2,
           "type": "object",
           "description": "Details of a user script",
           "properties": {
@@ -19226,29 +19377,322 @@
         },
         {
           "id": "RegisteredUserScript",
+          "min_manifest_version": 3,
           "type": "object",
           "description": "An object that represents a user script registered programmatically",
-          "functions": [
+          "properties": {
+            "id": {
+              "type": "string",
+              "optional": false,
+              "description": "The ID of the user script specified in the API call. This property must not start with a '_' as it's reserved as a prefix for generated script IDs."
+            },
+            "allFrames": {
+              "type": "boolean",
+              "optional": true,
+              "description": "If allFrames is <code>true</code>, implies that the JavaScript should be injected into all frames of current page. By default, it's <code>false</code> and is only injected into the top frame."
+            },
+            "js": {
+              "type": "array",
+              "optional": false,
+              "description": "The list of ScriptSource objects defining sources of scripts to be injected into matching pages.",
+              "items": {
+                "$ref": "ScriptSource"
+              }
+            },
+            "matches": {
+              "type": "array",
+              "optional": true,
+              "description": "At least one of matches or includeGlobs should be non-empty. The script runs in documents whose URL match either pattern.",
+              "items": {
+                "$ref": "manifest.MatchPattern"
+              }
+            },
+            "excludeMatches": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "$ref": "manifest.MatchPattern"
+              }
+            },
+            "includeGlobs": {
+              "type": "array",
+              "optional": true,
+              "description": "At least one of matches or includeGlobs should be non-empty. The script runs in documents whose URL match either pattern.",
+              "items": {
+                "type": "string"
+              }
+            },
+            "excludeGlobs": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "type": "string"
+              }
+            },
+            "runAt": {
+              "$ref": "extensionTypes.RunAt",
+              "optional": true,
+              "description": "The soonest that the JavaScript will be injected into the tab. Defaults to \"document_idle\"."
+            },
+            "world": {
+              "$ref": "ExecutionWorld",
+              "optional": true,
+              "description": "The JavaScript script for a script to execute within. Defaults to \"USER_SCRIPT\"."
+            },
+            "worldId": {
+              "type": "string",
+              "optional": true,
+              "description": "If specified, specifies a specific user script world ID to execute in. Only valid if `world` is omitted or is `USER_SCRIPT`. If `worldId` is omitted, the script will execute in the default user script world (\"\"). Values with leading underscores (`_`) are reserved. The maximum length is 256."
+            }
+          }
+        },
+        {
+          "id": "ExecutionWorld",
+          "min_manifest_version": 3,
+          "type": "string",
+          "enum": [
+            "MAIN",
+            "USER_SCRIPT"
+          ],
+          "description": "The JavaScript world for a script to execute within. <code>USER_SCRIPT</code> is the default execution environment of user scripts, <code>MAIN</code> is the web page's execution environment."
+        },
+        {
+          "id": "UserScriptFilter",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "Optional filter to use with getScripts() and unregister().",
+          "properties": {
+            "ids": {
+              "type": "array",
+              "optional": true,
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        {
+          "id": "ScriptSource",
+          "min_manifest_version": 3,
+          "description": "Object with file xor code property. Equivalent to the ExtensionFileOrCode, except the file remains a relative URL.",
+          "choices": [
             {
-              "name": "unregister",
-              "type": "function",
-              "description": "Unregister a user script registered programmatically",
-              "async": true,
-              "parameters": []
+              "type": "object",
+              "properties": {
+                "file": {
+                  "type": "string",
+                  "description": "The path of the JavaScript file to inject relative to the extension's root directory.",
+                  "format": "unresolvedRelativeUrl"
+                }
+              }
+            },
+            {
+              "type": "object",
+              "properties": {
+                "code": {
+                  "type": "string"
+                }
+              }
             }
           ]
+        },
+        {
+          "id": "WorldProperties",
+          "min_manifest_version": 3,
+          "type": "object",
+          "description": "The configuration of a USER_SCRIPT world.",
+          "properties": {
+            "worldId": {
+              "type": "string",
+              "optional": true,
+              "default": "",
+              "description": "The identifier of the world. Values with leading underscores (`_`) are reserved. The maximum length is 256. Defaults to the default USER_SCRIPT world (\"\")."
+            },
+            "csp": {
+              "type": "string",
+              "optional": true,
+              "description": "The world's Content Security Policy. Defaults to the CSP of regular content scripts, which prohibits dynamic code execution such as eval."
+            },
+            "messaging": {
+              "type": "boolean",
+              "optional": true,
+              "default": false,
+              "description": "Whether the runtime.sendMessage and runtime.connect methods are exposed. Defaults to not exposing these messaging APIs."
+            }
+          }
         }
       ],
       "functions": [
         {
           "name": "register",
+          "max_manifest_version": 2,
           "type": "function",
-          "description": "Register a user script programmatically given its $(ref:userScripts.UserScriptOptions), and resolves to a $(ref:userScripts.RegisteredUserScript) instance",
-          "async": true,
+          "description": "Register a user script programmatically given its $(ref:userScripts.UserScriptOptions), and resolves to an object with the unregister() function",
+          "async": "callback",
           "parameters": [
             {
               "name": "userScriptOptions",
               "$ref": "UserScriptOptions"
+            },
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "legacyRegisteredUserScript",
+                  "type": "object",
+                  "description": "An object that represents a user script registered programmatically",
+                  "properties": {
+                    "unregister": {
+                      "type": "function",
+                      "description": "Unregister a user script registered programmatically",
+                      "async": true,
+                      "parameters": []
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "register",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Registers one or more user scripts for this extension.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "scripts",
+              "type": "array",
+              "items": {
+                "$ref": "RegisteredUserScript"
+              },
+              "description": "List of user scripts to be registered."
+            }
+          ]
+        },
+        {
+          "name": "update",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Updates one or more user scripts for this extension.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "scripts",
+              "type": "array",
+              "items": {
+                "type": "object",
+                "$import": "RegisteredUserScript",
+                "properties": {
+                  "js": {
+                    "type": "array",
+                    "optional": true,
+                    "items": {
+                      "$ref": "ScriptSource"
+                    }
+                  }
+                }
+              },
+              "description": "List of user scripts to be updated."
+            }
+          ]
+        },
+        {
+          "name": "unregister",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Unregisters all dynamically-registered user scripts for this extension.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "filter",
+              "$ref": "UserScriptFilter",
+              "optional": true,
+              "description": "If specified, this method unregisters only the user scripts that match it."
+            }
+          ]
+        },
+        {
+          "name": "getScripts",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Returns all dynamically-registered user scripts for this extension.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "filter",
+              "$ref": "UserScriptFilter",
+              "optional": true,
+              "description": "If specified, this method returns only the user scripts that match it."
+            },
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "scripts",
+                  "type": "array",
+                  "items": {
+                    "$ref": "RegisteredUserScript"
+                  },
+                  "description": "List of registered user scripts."
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "name": "configureWorld",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Configures the environment for scripts running in a USER_SCRIPT world.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "properties",
+              "$ref": "WorldProperties",
+              "description": "The desired configuration for a USER_SCRIPT world."
+            }
+          ]
+        },
+        {
+          "name": "resetWorldConfiguration",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Resets the configuration for a given world. That world will fall back to the default world's configuration.",
+          "async": true,
+          "parameters": [
+            {
+              "name": "worldId",
+              "type": "string",
+              "optional": true,
+              "default": "",
+              "description": "The ID of the USER_SCRIPT world to reset. If omitted or empty, resets the default world's configuration."
+            }
+          ]
+        },
+        {
+          "name": "getWorldConfigurations",
+          "min_manifest_version": 3,
+          "type": "function",
+          "description": "Returns all registered USER_SCRIPT world configurations.",
+          "async": "callback",
+          "parameters": [
+            {
+              "name": "callback",
+              "type": "function",
+              "parameters": [
+                {
+                  "name": "configurations",
+                  "type": "array",
+                  "items": {
+                    "$ref": "WorldProperties"
+                  },
+                  "description": "All configurations registered with configureWorld()."
+                }
+              ]
             }
           ]
         }
@@ -19258,9 +19702,9 @@
   "user_scripts_content.json": [
     {
       "namespace": "userScripts",
-      "max_manifest_version": 2,
       "permissions": [
-        "manifest:user_scripts"
+        "manifest:user_scripts",
+        "userScripts"
       ],
       "allowedContexts": [
         "content"
@@ -19268,6 +19712,7 @@
       "events": [
         {
           "name": "onBeforeScript",
+          "max_manifest_version": 2,
           "permissions": [
             "manifest:user_scripts.api_script"
           ],