vite-userscript-plugin 1.10.0 → 2.0.0

package/types/violentmonkey.d.ts

@@ -1,20 +1,49 @@
-declare const unsafeWindow: Window
+// synced from @violentmonkey/types@0.3.4
+// do not edit; run pnpm sync-types
+
+/// <reference path="./violentmonkey-ambient.d.ts" />
+declare const unsafeWindow: Window;
 
 declare type VMScriptRunAt =
   | 'document-start'
   | 'document-body'
   | 'document-end'
-  | 'document-idle'
+  | 'document-idle';
 
 /** Injection mode of a script. */
-declare type VMScriptInjectInto = 'auto' | 'page' | 'content'
+declare type VMScriptInjectInto = 'auto' | 'page' | 'content';
+
+declare type GenericObject = Record<string, unknown>;
 
 declare interface VMScriptGMInfoPlatform {
-  arch: 'arm' | 'arm64' | 'x86-32' | 'x86-64' | 'mips' | 'mips64'
-  /** `chrome`, `firefox` or whatever was returned by the API. */
-  browserName: string
-  browserVersion: string
-  os: 'mac' | 'win' | 'android' | 'cros' | 'linux' | 'openbsd' | 'fuchsia'
+  arch:
+    | 'aarch64'
+    | 'arm'
+    | 'arm64'
+    | 'mips'
+    | 'mips64'
+    | 'ppc64'
+    | 's390x'
+    | 'sparc64'
+    | 'x86-32'
+    | 'x86-64';
+  browserName: 'chrome' | 'firefox' | string;
+  browserVersion: string;
+  /**
+   * A copy of `navigator.userAgentData.getHighEntropyValues()` from the background script
+   * of the extension, so it's not affected by devtools of the web page tab.
+   * Only present in browsers that implement this API (Chromium >= 90).
+   * @since VM2.27.0
+   */
+  fullVersionList?: { brand: string; version: string }[] | undefined;
+  /**
+   * A copy of `navigator.userAgentData.mobile` from the background script of the extension,
+   * so it's not affected by devtools of the web page tab.
+   * Only present in browsers that implement this API (Chromium >= 90).
+   * @since VM2.27.0
+   */
+  mobile?: boolean | undefined;
+  os: 'mac' | 'win' | 'android' | 'cros' | 'linux' | 'openbsd' | 'fuchsia';
 }
 
 /**
@@ -22,74 +51,180 @@ declare interface VMScriptGMInfoPlatform {
  * Non-optional string property will be an empty string '' if omitted.
  */
 declare interface VMScriptGMInfoScriptMeta {
-  antifeature?: string[]
-  author?: string
-  compatible?: string[]
-  connect?: string[]
-  description: string
-  downloadURL?: string
-  excludeMatches: string[]
-  excludes: string[]
+  antifeature?: string[] | undefined;
+  author?: string | undefined;
+  compatible?: string[] | undefined;
+  connect?: string[] | undefined;
+  description: string;
+  downloadURL?: string | undefined;
+  excludeMatches: string[];
+  excludes: string[];
   /** Empty is the same as `@grant none` */
-  grant: string[]
+  grant: string[];
   /** Use homepageURL instead */
-  homepage?: string
-  homepageURL?: string
-  icon?: string
-  includes: string[]
-  matches: string[]
-  name: string
-  namespace: string
-  noframes?: boolean
-  require: string[]
-  resources: { name: string; url: string }[]
-  runAt: VMScriptRunAt | ''
-  supportURL?: string
-  unwrap?: boolean
-  updateURL?: string
-  version: string
+  homepage?: string | undefined;
+  homepageURL?: string | undefined;
+  icon?: string | undefined;
+  includes: string[];
+  matches: string[];
+  /** User options and overrides for the script
+   * @since VM2.31.1 */
+  options: {
+    check_for_updates: boolean,
+    inject_into: VMScriptInjectInto | null,
+    noframes: boolean | null,
+    override: {
+      /** Keep the script's `@exclude` */
+      merge_excludes: boolean,
+      /** Keep the script's `@include` */
+      merge_includes: boolean,
+      /** Keep the script's `@match` */
+      merge_matches: boolean,
+      /** Keep the script's `@exclude-match` */
+      merge_exclude_matches: boolean,
+      /** Keep the script's `@tag`
+       * @since VM2.35.2 */
+      merge_tags: boolean,
+      /** User overridden `@exclude` */
+      use_excludes: string[],
+      /** User overridden `@include` */
+      use_includes: string[],
+      /** User overridden `@match` */
+      use_matches: string[],
+      /** User overridden `@exclude-match` */
+      use_exclude_matches: string[],
+    },
+    run_at: VMScriptRunAt | null,
+    /** User overridden `@tag`
+     * @since VM2.35.2 */
+    tags: string[],
+    /** Last modification by the user; convertible as `new Date(user_modified)` */
+    user_modified: number,
+  },
+  name: string;
+  namespace: string;
+  noframes?: boolean | undefined;
+  require: string[];
+  resources: { name: string; url: string }[];
+  runAt: VMScriptRunAt | '';
+  supportURL?: string | undefined;
+  /** @since VM2.37.0 */
+  tags?: string[],
+  unwrap?: boolean | undefined;
+  updateURL?: string | undefined;
+  version: string;
 }
 
 declare interface VMScriptGMInfoObject {
-  /** Unique ID of the script. */
-  uuid: string
+  /** A unique ID of the script. */
+  uuid: string;
+  /** The injection mode of current script. See [`@inject-into`](https://violentmonkey.github.io/api/metadata-block/#inject-into) for more information. */
+  injectInto: VMScriptInjectInto;
+  /** Contains structured fields from the [Metadata Block](https://violentmonkey.github.io/api/metadata-block/). */
+  script: VMScriptGMInfoScriptMeta;
   /** The meta block of the script. */
-  scriptMetaStr: string
+  scriptMetaStr: string;
   /** Whether the script will be updated automatically. */
-  scriptWillUpdate: boolean
+  scriptWillUpdate: boolean;
   /** The name of userscript manager, which should be the string `Violentmonkey`. */
-  scriptHandler: string
+  scriptHandler: string;
   /** Version of Violentmonkey. */
-  version: string
+  version: string;
+  /**
+   * GM_download internal implementation:
+   * `native` - the classic `a` element's `download` attribute, used by default.
+   * `browser` - the browser API used if the user enabled it in the extension's options.
+   * @since VM2.45.2
+   */
+  downloadMode: 'native' | 'browser';
+  /**
+   * True when this is an incognito profile (Chrome) or private mode (Firefox).
+   * @since VM2.15.4
+   */
+  isIncognito: boolean;
   /**
    * Unlike `navigator.userAgent`, which can be overriden by other extensions/userscripts
    * or by devtools in device-emulation mode, `GM_info.platform` is more reliable as the
    * data is obtained in the background page of Violentmonkey using a specialized
    * extension API (`browser.runtime.getPlatformInfo` and `getBrowserInfo`).
    */
-  platform: VMScriptGMInfoPlatform
-  /** Contains structured fields from the *Metadata Block*. */
-  script: VMScriptGMInfoScriptMeta
-  /** The injection mode of current script. */
-  injectInto: VMScriptInjectInto
+  platform: VMScriptGMInfoPlatform;
+  /**
+   * A safe copy of `navigator.userAgent` from the content script of the extension,
+   * so it cannot be overridden by other extensions/userscripts, but unlike
+   * `GM_info.platform` it can be customized in devtools “device emulation” or
+   * “network conditions” for this tab.
+   * @since VM2.20.2
+   */
+  userAgent: string;
+  /**
+   * A safe copy of `navigator.userAgentData` from the content script of the extension,
+   * so it cannot be overridden by other extensions/userscripts, but unlike
+   * `GM_info.platform` it can be customized in devtools "device emulation" or
+   * "network conditions" for this tab.
+   *
+   * Only present if the browser actually implements it
+   * ([currently](https://caniuse.com/mdn-api_navigator_useragentdata) Chromium-based 90+),
+   * because there's no reliable/official polyfill.
+   *
+   * Violentmonkey implements the [official API](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData),
+   * including [getHighEntropyValues](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData/getHighEntropyValues)
+   * function to obtain the extra info asynchronously.
+   *
+   * @since VM2.20.2
+   */
+  userAgentData?:
+    | {
+        brands: { brand: string; version: string }[];
+        mobile: boolean;
+        platform: string;
+        getHighEntropyValues(hints: string[]): Promise<UADataValues>;
+      }
+    | undefined;
 }
 
 /**
  * An object that exposes information about the current userscript.
  */
-declare const GM_info: VMScriptGMInfoObject
+declare const GM_info: VMScriptGMInfoObject;
+
+/** @since VM2.35.1 */
+declare const GM_cookie: {
+  delete: (
+    opts: browser.cookies._RemoveDetails | chrome.cookies.CookieDetails,
+    callback?: (error?: string) => any,
+  ) => void,
+  /** `httpOnly` cookies are listed only when the HTTP-only option is enabled for the script and globally in the extension */
+  list: (
+    opts: browser.cookies._GetAllDetails | Parameters<typeof chrome.cookies.getAll>[0],
+    callback?: (cookies?: browser.cookies.Cookie | chrome.cookies.Cookie, error?: string) => any,
+  ) => void,
+  /** `httpOnly` cookies are allowed only when the HTTP-only option is enabled for the script and globally in the extension */
+  set: (
+    opts: browser.cookies._SetDetails | Parameters<typeof chrome.cookies.set>[0],
+    callback?: (error?: string) => any,
+  ) => void,
+};
 
 /** The original console.log */
-declare function GM_log(...args: any): void
+declare function GM_log(...args: any): void;
 
 /** Retrieves a value for current script from storage. */
-declare function GM_getValue<T>(name: string, defaultValue?: T): T
+declare function GM_getValue<T>(name: string, defaultValue?: T | undefined): T;
+/** @since VM2.19.1 */
+declare function GM_getValues(names: string[]): GenericObject;
+/** @since VM2.19.1 */
+declare function GM_getValues(namesWithDefaults: GenericObject): GenericObject;
 /** Sets a key / value pair for current script to storage. */
-declare function GM_setValue<T>(name: string, value: T): void
+declare function GM_setValue<T>(name: string, value: T): void;
+/** @since VM2.19.1 */
+declare function GM_setValues(values: GenericObject): void;
 /** Deletes an existing key / value pair for current script from storage. */
-declare function GM_deleteValue(name: string): void
+declare function GM_deleteValue(name: string): void;
+/** @since VM2.19.1 */
+declare function GM_deleteValues(names: string[]): void;
 /** Returns an array of keys of all available values within this script. */
-declare function GM_listValues(): string[]
+declare function GM_listValues(): string[];
 
 declare type VMScriptGMValueChangeCallback<T> = (
   /** The name of the observed variable */
@@ -99,22 +234,22 @@ declare type VMScriptGMValueChangeCallback<T> = (
   /** The new value of the observed variable (`undefined` if it was deleted) */
   newValue: T,
   /** `true` if modified by the userscript instance of another tab or `false` for this script instance. Can be used by scripts of different browser tabs to communicate with each other. */
-  remote: boolean
-) => void
+  remote: boolean,
+) => void;
 
 /** Adds a change listener to the storage and returns the listener ID. */
 declare function GM_addValueChangeListener<T>(
   name: string,
-  callback: VMScriptGMValueChangeCallback<T>
-): string
+  callback: VMScriptGMValueChangeCallback<T>,
+): string;
 /** Removes a change listener by its ID. */
-declare function GM_removeValueChangeListener(listenerId: string): void
+declare function GM_removeValueChangeListener(listenerId: string): void;
 
 /** Retrieves a text resource from the *Metadata Block*. */
 declare function GM_getResourceText(
   /** Name of a resource defined in the *Metadata Block*. */
-  name: string
-): string
+  name: string,
+): string;
 /**
  * Retrieves a `blob:` or `data:` URL of a resource from the *Metadata Block*.
  *
@@ -127,8 +262,8 @@ declare function GM_getResourceURL(
    * - If `true`, returns a `blob:` URL. It's short and cacheable, so it's good for reusing in multiple DOM elements.
    * - If `false`, returns a `data:` URL. It's long so reusing it in DOM may be less performant due to the lack of caching, but it's particularly handy for direct synchronous decoding of the data on sites that forbid fetching `blob:` in their CSP.
    */
-  isBlobUrl?: boolean
-): string
+  isBlobUrl?: boolean | undefined,
+): string;
 
 /**
  * Appends and returns an element with the specified attributes.
@@ -151,8 +286,8 @@ declare function GM_addElement(
   /** A tag name like `script`. Any valid HTML tag can be used, but the only motivation for this API was to add `script`, `link`, `style` elements when they are disallowed by a strict `Content-Security-Policy` of the site e.g. github.com, twitter.com. */
   tagName: string,
   /** The keys are HTML attributes, not DOM properties, except `textContent` which sets DOM property `textContent`. The values are strings so if you want to assign a private function to `onload` you can do it after the element is created. */
-  attributes?: Record<string, string>
-): HTMLElement
+  attributes?: Record<string, string> | undefined,
+): HTMLElement;
 declare function GM_addElement(
   /**
    * The parent node to which the new node will be appended.
@@ -167,24 +302,24 @@ declare function GM_addElement(
   /** A tag name like `script`. Any valid HTML tag can be used, but the only motivation for this API was to add `script`, `link`, `style` elements when they are disallowed by a strict `Content-Security-Policy` of the site e.g. github.com, twitter.com. */
   tagName: string,
   /** The keys are HTML attributes, not DOM properties, except `textContent` which sets DOM property `textContent`. The values are strings so if you want to assign a private function to `onload` you can do it after the element is created. */
-  attributes?: Record<string, string>
-): HTMLElement
+  attributes?: Record<string, string> | undefined,
+): HTMLElement;
 
 /** Appends and returns a `<style>` element with the specified CSS. */
-declare function GM_addStyle(css: string): HTMLStyleElement
+declare function GM_addStyle(css: string): HTMLStyleElement;
 
 declare interface VMScriptGMTabControl {
   /** Сan be assigned to a function. If provided, it will be called when the opened tab is closed. */
-  onclose?: () => void
+  onclose?: (() => void) | undefined;
   /** Whether the opened tab is closed. */
-  closed: boolean
+  closed: boolean;
   /** A function to explicitly close the opened tab. */
-  close: () => void
+  close: () => void;
 }
 
 declare interface VMScriptGMTabOptions {
   /** Make the new tab active (i.e. open in foreground). Default as `true`. */
-  active?: boolean
+  active?: boolean | undefined;
   /**
    * Firefox only.
    *
@@ -192,41 +327,57 @@ declare interface VMScriptGMTabOptions {
    * - `0` = default (main) container
    * - `1`, `2`, etc. = internal container index
    */
-  container?: number
+  container?: number | undefined;
   /** Insert the new tab next to the current tab and set its `openerTab` so when it's closed the original tab will be focused automatically. When `false` or not specified, the usual browser behavior is to open the tab at the end of the tab list. Default as `true`. */
-  insert?: boolean
+  insert?: boolean | undefined;
   /** Pin the tab (i.e. show without a title at the beginning of the tab list). Default as `false`. */
-  pinned?: boolean
+  pinned?: boolean | undefined;
 }
 
 /** Opens URL in a new tab. */
 declare function GM_openInTab(
   /** The URL to open in a new tab. URL relative to current page is also allowed. Note: Firefox does not support data URLs. */
   url: string,
-  options?: VMScriptGMTabOptions
-): VMScriptGMTabControl
+  options?: VMScriptGMTabOptions | undefined,
+): VMScriptGMTabControl;
 declare function GM_openInTab(
   /** The URL to open in a new tab. URL relative to current page is also allowed. Note: Firefox does not support data URLs. */
   url: string,
   /** Open the tab in background. Note, this is a reverse of the first usage method so for example `true` is the same as `{ active: false }`. */
-  openInBackground?: boolean
-): VMScriptGMTabControl
+  openInBackground?: boolean | undefined,
+): VMScriptGMTabControl;
 
 /**
  * Registers a command in Violentmonkey popup menu.
+ * Returns the command's id since VM2.12.5, see description of the `id` parameter.
  * If you want to add a shortcut, please see `@violentmonkey/shortcut`.
  */
 declare function GM_registerMenuCommand(
   /** The name to show in the popup menu. */
   caption: string,
   /** Callback function when the command is clicked in the menu. */
-  onClick: (event: MouseEvent | KeyboardEvent) => void
-): string
+  onClick: (event: MouseEvent | KeyboardEvent) => void,
+  /** @since VM2.15.9 */
+  options?:
+    | {
+        /** Default: the `caption` parameter.
+         * In 2.15.9-2.16.1 the default was a randomly generated string. */
+        id?: string | undefined;
+        /** @since VM2.31.1 */
+        icon?: string | undefined;
+        /** A hint shown in the status bar when hovering the command. */
+        title?: string | undefined;
+        /** Default: `true`.
+         * Whether to auto-close the popup after the user invoked the command. */
+        autoClose?: boolean | undefined;
+      }
+    | undefined,
+): string;
 /** Unregisters a command which has been registered to Violentmonkey popup menu. */
 declare function GM_unregisterMenuCommand(
   /** The name of command to unregister. */
-  caption: string
-): void
+  caption: string,
+): void;
 
 /**
  * A control object returned by `GM_notification`.
@@ -234,51 +385,75 @@ declare function GM_unregisterMenuCommand(
  */
 declare interface VMScriptGMNotificationControl {
   /** Remove the notification immediately. */
-  remove: () => Promise<void>
+  remove: () => Promise<void>;
 }
 
 declare interface VMScriptGMNotificationOptions {
   /** Main text of the notification. */
-  text: string
+  text: string;
   /** Title of the notification. */
-  title?: string
+  title?: string | undefined;
   /** URL of an image to show in the notification. */
-  image?: string
+  image?: string | undefined;
+  /** No sounds/vibrations when showing the notification.
+   * @since VM2.15.2, Chrome 70. */
+  silent?: boolean | undefined;
+  /**
+   * Unique name of the notification, e.g. 'abc', same as the web Notification API.
+   * Names are scoped to each userscript i.e. your tag won't clash with another script's tag.
+   * The purpose of a tagged notification is to replace an older notification with the same tag,
+   * even if it was shown in another tab (or before this tab was navigated elsewhere
+   * and your notification had `zombieTimeout`).
+   * @since VM2.15.4
+   */
+  tag?: string | undefined;
+  /**
+   * Number of milliseconds to keep the notification after the userscript "dies",
+   * i.e. when its tab or frame is reloaded/closed/navigated. If not specified or invalid,
+   * the default behavior is to immediately remove the notifications.
+   * @since VM2.15.4
+   */
+  zombieTimeout?: number | undefined;
+  /**
+   * URL to open when a zombie notification is clicked, see `zombieTimeout` for more info.
+   * @since VM2.16.1
+   */
+  zombieUrl?: string | undefined;
   /** Callback when the notification is clicked by user. */
-  onclick?: () => void
+  onclick?: (() => void) | undefined;
   /** Callback when the notification is closed, either by user or by system. */
-  ondone?: () => void
+  ondone?: (() => void) | undefined;
 }
 
 /** Shows an HTML5 desktop notification. */
 declare function GM_notification(
-  options: VMScriptGMNotificationOptions
-): VMScriptGMNotificationControl
+  options: VMScriptGMNotificationOptions,
+): VMScriptGMNotificationControl;
 declare function GM_notification(
   /** Main text of the notification. */
   text: string,
   /** Title of the notification. */
-  title?: string,
+  title?: string | undefined,
   /** URL of an image to show in the notification. */
-  image?: string,
+  image?: string | undefined,
   /** Callback when the notification is clicked by user. */
-  onclick?: () => void
-): VMScriptGMNotificationControl
+  onclick?: (() => void) | undefined,
+): VMScriptGMNotificationControl;
 
 /** Sets data to system clipboard. */
 declare function GM_setClipboard(
   /** The data to be copied to system clipboard. */
   data: string,
   /** The MIME type of data to copy. Default as `text/plain`. */
-  type?: string
-): void
+  type?: string | undefined,
+): void;
 
 /**
  * A control object returned by `GM_xmlhttpRequest`.
  * `control.abort()` can be used to abort the request.
  */
 declare interface VMScriptXHRControl {
-  abort: () => void
+  abort: () => void;
 }
 
 declare type VMScriptResponseType =
@@ -286,27 +461,27 @@ declare type VMScriptResponseType =
   | 'json'
   | 'blob'
   | 'arraybuffer'
-  | 'document'
+  | 'document';
 
 /**
  * https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#properties
  * https://developer.mozilla.org/en-US/docs/Web/API/ProgressEvent#properties
  */
 declare interface VMScriptResponseObject<T> {
-  status: number
-  statusText: string
-  readyState: number
-  responseHeaders: string
-  response: T | null
-  responseText: string | undefined
-  responseXML: Document | null
+  status: number;
+  statusText: string;
+  readyState: number;
+  responseHeaders: string;
+  response: T | null;
+  responseText: string | undefined;
+  responseXML: Document | null;
   /** The final URL after redirection. */
-  finalUrl: string
-  lengthComputable?: boolean
-  loaded?: number
-  total?: number
+  finalUrl: string;
+  lengthComputable?: boolean | undefined;
+  loaded?: number | undefined;
+  total?: number | undefined;
   /** The same `context` object you specified in `details`. */
-  context?: unknown
+  context?: unknown | undefined;
 }
 
 type TypedArray =
@@ -320,15 +495,15 @@ type TypedArray =
   | BigUint64Array
   | BigInt64Array
   | Float32Array
-  | Float64Array
+  | Float64Array;
 
-interface GMRequestBase<T> {
+interface GMRequestBase<T> extends GMRequestBaseEvents<T> {
   /** URL relative to current page is also allowed. */
-  url: string
+  url: string;
   /** User for authentication. */
-  user?: string
+  user?: string | undefined;
   /** Password for authentication. */
-  password?: string
+  password?: string | undefined;
   /**
    * Some special headers are also allowed:
    *
@@ -338,28 +513,31 @@ interface GMRequestBase<T> {
    * - `Referer`
    * - `User-Agent`
    */
-  headers?: Record<string, string>
+  headers?: Record<string, string> | undefined;
   /** Time to wait for the request, none by default. */
-  timeout?: number
+  timeout?: number | undefined;
   /** Can be an object and will be assigned to context of the response object. */
-  context?: unknown
+  context?: unknown | undefined;
   /** When set to `true`, no cookie will be sent with the request and the response cookies will be ignored. The default value is `false`. */
-  anonymous?: boolean
-  onabort?: (resp: VMScriptResponseObject<T>) => void
-  onerror?: (resp: VMScriptResponseObject<T>) => void
-  onload?: (resp: VMScriptResponseObject<T>) => void
-  onloadend?: (resp: VMScriptResponseObject<T>) => void
-  onloadstart?: (resp: VMScriptResponseObject<T>) => void
-  onprogress?: (resp: VMScriptResponseObject<T>) => void
-  onreadystatechange?: (resp: VMScriptResponseObject<T>) => void
-  ontimeout?: (resp: VMScriptResponseObject<T>) => void
+  anonymous?: boolean | undefined;
+}
+
+interface GMRequestBaseEvents<T> {
+  onabort?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onerror?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onload?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onloadend?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onloadstart?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onprogress?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  onreadystatechange?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
+  ontimeout?: ((resp: VMScriptResponseObject<T>) => void) | undefined;
 }
 
 declare interface VMScriptGMXHRDetails<T> extends GMRequestBase<T> {
   /** HTTP method, default as `GET`. */
-  method?: string
+  method?: string | undefined;
   /** A MIME type to specify with the request. */
-  overrideMimeType?: string
+  overrideMimeType?: string | undefined;
   /**
    * One of the following:
    *
@@ -369,7 +547,7 @@ declare interface VMScriptGMXHRDetails<T> extends GMRequestBase<T> {
    * - `arraybuffer`
    * - `document`
    */
-  responseType?: VMScriptResponseType
+  responseType?: VMScriptResponseType | undefined;
   /** Data to send with the request, usually for `POST` and `PUT` requests. */
   data?:
     | string
@@ -380,55 +558,85 @@ declare interface VMScriptGMXHRDetails<T> extends GMRequestBase<T> {
     | ReadableStream
     | TypedArray
     | URLSearchParams
+    | undefined;
   /** Send the `data` string as a `blob`. This is for compatibility with Tampermonkey/Greasemonkey, where only `string` type is allowed in `data`. */
-  binary?: boolean
+  binary?: boolean | undefined;
+  /** @since VM2.32.0 */
+  upload?: GMRequestBaseEvents<T>;
 }
 
 /** Makes a request like XMLHttpRequest, with some special capabilities, not restricted by same-origin policy. */
 declare function GM_xmlhttpRequest<
-  T = string | Blob | ArrayBuffer | Document | object
->(details: VMScriptGMXHRDetails<T>): VMScriptXHRControl
+  T = string | Blob | ArrayBuffer | Document | object,
+>(details: VMScriptGMXHRDetails<T>): VMScriptXHRControl;
 
 declare interface VMScriptGMDownloadOptions extends GMRequestBase<Blob> {
   /** The filename to save as. */
-  name: string
+  name: string;
+  /** Used only when GM_info.downloadMode === 'browser' */
+  conflictAction?: browser.downloads.FilenameConflictAction;
+  /** Shows the dialog. Used only when GM_info.downloadMode === 'browser' */
+  saveAs?: boolean;
 }
 
 /** Downloads a URL to a local file. */
-declare function GM_download(options: VMScriptGMDownloadOptions): void
+declare function GM_download(options: VMScriptGMDownloadOptions): void;
 declare function GM_download(
   /** The URL to download. */
   url: string,
   /** The filename to save as. */
-  name: string
-): void
+  name: string,
+): void;
 
 /** Aliases for GM_ methods that are not included in Greasemonkey4 API */
 declare interface VMScriptGMObjectVMExtensions {
-  addElement: typeof GM_addElement
-  addStyle: typeof GM_addStyle
-  addValueChangeListener: typeof GM_addValueChangeListener
-  download: typeof GM_download
-  getResourceText: typeof GM_getResourceText
-  log: typeof GM_log
-  removeValueChangeListener: typeof GM_removeValueChangeListener
-  unregisterMenuCommand: typeof GM_unregisterMenuCommand
+  addElement: typeof GM_addElement;
+  addStyle: typeof GM_addStyle;
+  addValueChangeListener: typeof GM_addValueChangeListener;
+  /** @since VM2.35.1 */
+  cookie: {
+    delete: (opts: browser.cookies._RemoveDetails | chrome.cookies.CookieDetails) => Promise<void>,
+    /** `httpOnly` cookies are listed only when the HTTP-only option is enabled for the script and globally in the extension */
+    list: (opts: browser.cookies._GetAllDetails | Parameters<typeof chrome.cookies.getAll>[0]) =>
+      Promise<browser.cookies.Cookie | chrome.cookies.Cookie>,
+    /** `httpOnly` cookies are allowed only when the HTTP-only option is enabled for the script and globally in the extension */
+    set: (opts: browser.cookies._SetDetails | Parameters<typeof chrome.cookies.set>[0]) => Promise<void>,
+  };
+  /** @since VM2.19.1 */
+  deleteValues: (names: string[]) => Promise<void>;
+  download(options: VMScriptGMDownloadOptions): Promise<Blob> | void;
+  download(url: string, name: string): Promise<Blob> | void;
+  getResourceText: typeof GM_getResourceText;
+  /** @since VM2.19.1 */
+  getValues(names: string[]): Promise<GenericObject>;
+  /** @since VM2.19.1 */
+  getValues(namesWithDefaults: GenericObject): Promise<GenericObject>;
+  log: typeof GM_log;
+  removeValueChangeListener: typeof GM_removeValueChangeListener;
+  /** @since VM2.19.1 */
+  setValues: (values: GenericObject) => Promise<void>;
+  unregisterMenuCommand: typeof GM_unregisterMenuCommand;
 }
 
 /** The Greasemonkey4 API, https://wiki.greasespot.net/Greasemonkey_Manual:API */
 declare interface VMScriptGMObject extends VMScriptGMObjectVMExtensions {
-  unsafeWindow: Window
-  info: typeof GM_info
-  getValue: <T>(name: string, defaultValue?: T) => Promise<T>
-  setValue: <T>(name: string, value: T) => Promise<void>
-  deleteValue: (name: string) => Promise<void>
-  listValues: () => Promise<string[]>
-  registerMenuCommand: typeof GM_registerMenuCommand
-  getResourceUrl: (name: string, isBlobUrl?: boolean) => Promise<string>
-  notification: typeof GM_notification
-  openInTab: typeof GM_openInTab
-  setClipboard: typeof GM_setClipboard
-  xmlHttpRequest: typeof GM_xmlhttpRequest
+  unsafeWindow: Window;
+  info: typeof GM_info;
+  getValue: <T>(name: string, defaultValue?: T | undefined) => Promise<T>;
+  setValue: <T>(name: string, value: T) => Promise<void>;
+  deleteValue: (name: string) => Promise<void>;
+  listValues: () => Promise<string[]>;
+  registerMenuCommand: typeof GM_registerMenuCommand;
+  getResourceUrl: (
+    name: string,
+    isBlobUrl?: boolean | undefined,
+  ) => Promise<string>;
+  notification: typeof GM_notification;
+  openInTab: typeof GM_openInTab;
+  setClipboard: typeof GM_setClipboard;
+  xmlHttpRequest: <T = string | Blob | ArrayBuffer | Document | object>(
+    details: VMScriptGMXHRDetails<T>,
+  ) => Promise<T> & VMScriptXHRControl;
 }
 
-declare const GM: VMScriptGMObject
+declare const GM: VMScriptGMObject;