From b73665ddfb16de4020250140133a154edcf292bf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Wed, 24 Apr 2024 09:53:45 +0200
Subject: [PATCH 01/15] 1.42 & doc fixes - add `$.cookie`, `$.removeCookie`,
 `mw.loader.addSource`, `mw.templates`, `mw.user.getFirstRegistration`,
 `mw.util.isInfinity` - `new mw.Api().loadMessagesIfMissing` now accepts a
 single `string` message key as argument -
 `mw.loader.impl`/`implement`/`register`/`state` are now annotated private -
 `mw.Map` is no longer annotated private - `body` argument of `new
 mw.Rest().post` is now optional - various small jsdoc fixes, either from 1.42
 updates or oversights from previous PR

---
 jquery/confirmable.d.ts             |  45 ++--
 jquery/cookie.d.ts                  |  42 ++++
 jquery/footHovzer.d.ts              |   4 +-
 jquery/highlightText.d.ts           |   9 +
 jquery/lengthLimit.d.ts             |   9 +-
 jquery/makeCollapsible.d.ts         |   7 +
 jquery/spinner.d.ts                 |   7 +-
 jquery/suggestions.d.ts             |  10 +-
 jquery/tablesorter.d.ts             |   6 +-
 jquery/textSelection.d.ts           |  18 ++
 jquery/updateTooltipAccessKeys.d.ts |   9 +
 mw/Api.d.ts                         | 299 ++++++++++++++++-----------
 mw/ForeignApi.d.ts                  |  37 ++--
 mw/ForeignRest.d.ts                 |  46 ++---
 mw/Map.d.ts                         |  13 +-
 mw/Rest.d.ts                        |  31 +--
 mw/Title.d.ts                       | 175 ++++++++--------
 mw/Uri.d.ts                         |  74 +++----
 mw/cldr.d.ts                        |   1 +
 mw/confirmCloseWindow.d.ts          |  33 +--
 mw/cookie.d.ts                      |  81 +++++---
 mw/deflate.d.ts                     |   6 +-
 mw/errorLogger.d.ts                 |  22 ++
 mw/experiments.d.ts                 |   1 -
 mw/global.d.ts                      |   4 +
 mw/hook.d.ts                        |  82 ++++----
 mw/html.d.ts                        |  19 +-
 mw/index.d.ts                       |  48 +++--
 mw/inspect.d.ts                     |   7 +-
 mw/language.d.ts                    |  10 +-
 mw/loader.d.ts                      | 310 ++++++++++++++++------------
 mw/log.d.ts                         |  28 +--
 mw/message.d.ts                     |  43 ++--
 mw/notification.d.ts                | 124 +++++------
 mw/searchSuggest.d.ts               |  61 ++++--
 mw/storage.d.ts                     |  56 ++---
 mw/template.d.ts                    |   2 +-
 mw/user.d.ts                        |  74 ++++---
 mw/util.d.ts                        |  72 ++++---
 39 files changed, 1156 insertions(+), 769 deletions(-)
 create mode 100644 jquery/cookie.d.ts
 create mode 100644 mw/errorLogger.d.ts

diff --git a/jquery/confirmable.d.ts b/jquery/confirmable.d.ts
index bc44d43..eb003db 100644
--- a/jquery/confirmable.d.ts
+++ b/jquery/confirmable.d.ts
@@ -1,25 +1,34 @@
 declare global {
     interface JQuery {
+        /**
+         * Enable inline confirmation for given clickable element (like `<a />` or `<button />`).
+         * Provided by the `jquery.confirmable` ResourceLoader module.
+         *
+         * An additional inline confirmation step being shown before the default action is carried out on
+         * click.
+         *
+         * Calling `.confirmable( { handler: function () { … } } )` will fire the handler only after the
+         * confirmation step.
+         *
+         * The element will have the `jquery-confirmable-element` class added to it when it's clicked for
+         * the first time, which has `white-space: nowrap;` and `display: inline-block;` defined in CSS.
+         * If the computed values for the element are different when you make it confirmable, you might
+         * encounter unexpected behavior.
+         *
+         * @example
+         * ```js
+         * mw.loader.using( 'jquery.confirmable' ).then( () => {
+         *     $( 'button' ).confirmable();
+         * } );
+         * ```
+         */
         confirmable: Confirmable;
     }
 }
 
 interface Confirmable {
     /**
-     * Enable inline confirmation for given clickable element (like `<a />` or `<button />`).
-     *
-     * An additional inline confirmation step being shown before the default action is carried out on
-     * click.
-     *
-     * Calling `.confirmable( { handler: function () { … } } )` will fire the handler only after the
-     * confirmation step.
-     *
-     * The element will have the `jquery-confirmable-element` class added to it when it's clicked for
-     * the first time, which has `white-space: nowrap;` and `display: inline-block;` defined in CSS.
-     * If the computed values for the element are different when you make it confirmable, you might
-     * encounter unexpected behavior.
-     *
-     * @param {Options} [options]
+     * @param {Partial<Options>} [options]
      */
     (options?: Partial<Options>): this;
 
@@ -69,31 +78,35 @@ interface Options {
 interface I18N {
     /**
      * Text to use for the confirmation question.
+     * Defaults to `Are you sure?`.
      */
     confirm: string;
 
     /**
      * Text to use for the 'No' button.
+     * Defaults to `No`.
      */
     no: string;
 
     /**
-     * Title text to use for the 'No' button.
+     * Optional title text to use for the 'No' button.
      */
     noTitle: string | undefined;
 
     /**
      * Word separator to place between the three text messages.
+     * Defaults to ` `.
      */
     space: string;
 
     /**
      * Text to use for the 'Yes' button.
+     * Defaults to `Yes`.
      */
     yes: string;
 
     /**
-     * Title text to use for the 'Yes' button.
+     * Optional title text to use for the 'Yes' button.
      */
     yesTitle: string | undefined;
 }
diff --git a/jquery/cookie.d.ts b/jquery/cookie.d.ts
new file mode 100644
index 0000000..70df263
--- /dev/null
+++ b/jquery/cookie.d.ts
@@ -0,0 +1,42 @@
+declare global {
+    interface JQueryStatic {
+        /**
+         * Set a cookie.
+         *
+         * @example
+         * ```js
+         * mw.loader.using( 'mediawiki.cookie' ).then( () => {
+         *     $.cookie( 'name', 'value', {} );
+         * } );
+         * ```
+         * @param {string} [key] Cookie name or (when getting) omit to return an object with all
+         *  current cookie keys and values.
+         * @param {string|null} [value] Cookie value to set. If `null`, this method will remove the cookie.
+         *  If omited, this method will get and return the current value.
+         * @param {mw.cookie.CookieOptions} [options]
+         * @returns {string|Object} The current value (if getting a cookie), or an internal `document.cookie`
+         *  expression (if setting or removing).
+         */
+        cookie(key: string, value: string | null, options?: mw.cookie.CookieOptions): string;
+        cookie(key: string): unknown;
+        cookie(): Record<string, unknown>;
+
+        /**
+         * Remove a cookie by key.
+         *
+         * @example
+         * mw.loader.using( 'mediawiki.cookie' ).then( () => {
+         *     $.removeCookie( 'name', {} );
+         * } );
+         *
+         * @memberof jQueryPlugins
+         * @method removeCookie
+         * @param {string} key
+         * @param {mw.cookie.CookieOptions} options
+         * @returns {boolean} True if the cookie previously existed
+         */
+        removeCookie(key: string, options: mw.cookie.CookieOptions): boolean;
+    }
+}
+
+export {};
diff --git a/jquery/footHovzer.d.ts b/jquery/footHovzer.d.ts
index 12874e8..6aa6118 100644
--- a/jquery/footHovzer.d.ts
+++ b/jquery/footHovzer.d.ts
@@ -3,14 +3,12 @@ declare global {
         /**
          * Utility to stack stuff in an overlay fixed on the bottom of the page.
          *
-         * Usage:
-         *
+         * @example
          * ```js
          * var hovzer = $.getFootHovzer();
          * hovzer.$.append( $myCollection );
          * hovzer.update();
          * ```
-         *
          * @private
          * @returns {FootHovzer}
          */
diff --git a/jquery/highlightText.d.ts b/jquery/highlightText.d.ts
index f0146fa..2acddc6 100644
--- a/jquery/highlightText.d.ts
+++ b/jquery/highlightText.d.ts
@@ -6,7 +6,16 @@ declare global {
     interface JQuery {
         /**
          * Highlight certain text in current nodes (by wrapping it in `<span class="highlight">...</span>`).
+         * Provided by the `jquery.highlightText` ResourceLoader module.
          *
+         * @example
+         * ```js
+         * mw.loader.using( 'jquery.highlightText' ).then( () => {
+         *     // no styling is provided by default.
+         *     mw.util.addCSS( `.highlight { background: yellow; }` )
+         *     $( '#bodyContent' ).highlightText( 'bear' );
+         * } );
+         * ```
          * @param {string} matchString String to match
          * @param {Options} [options]
          * @returns {JQuery}
diff --git a/jquery/lengthLimit.d.ts b/jquery/lengthLimit.d.ts
index b91cb1d..e364d3d 100644
--- a/jquery/lengthLimit.d.ts
+++ b/jquery/lengthLimit.d.ts
@@ -2,10 +2,11 @@ declare global {
     interface JQueryStatic {
         /**
          * Utility function to trim down a string, based on byteLimit
-         * and given a safe start position. It supports insertion anywhere
-         * in the string, so "foo" to "fobaro" if limit is 4 will result in
-         * "fobo", not "foba". Basically emulating the native maxlength by
-         * reconstructing where the insertion occurred.
+         * and given a safe start position.
+         *
+         * It supports insertion anywhere in the string, so "foo" to "fobaro" if
+         * limit is 4 will result in "fobo", not "foba". Basically emulating the
+         * native maxlength by reconstructing where the insertion occurred.
          *
          * @deprecated Use `require( 'mediawiki.String' ).trimByteLength` instead.
          * @param {string} safeVal Known value that was previously returned by this
diff --git a/jquery/makeCollapsible.d.ts b/jquery/makeCollapsible.d.ts
index e13b597..be1a1bf 100644
--- a/jquery/makeCollapsible.d.ts
+++ b/jquery/makeCollapsible.d.ts
@@ -2,6 +2,7 @@ declare global {
     interface JQuery {
         /**
          * Enable collapsible-functionality on all elements in the collection.
+         * Provided by the `jquery.makeCollapsible` ResourceLoader module.
          *
          * - Will prevent binding twice to the same element.
          * - Initial state is expanded by default, this can be overridden by adding class
@@ -9,6 +10,12 @@ declare global {
          * - Elements made collapsible have jQuery data "mw-made-collapsible" set to true.
          * - The inner content is wrapped in a "div.mw-collapsible-content" (except for tables and lists).
          *
+         * @example
+         * ```js
+         * mw.loader.using( 'jquery.makeCollapsible' ).then( () => {
+         *     $( 'table' ).makeCollapsible();
+         * } );
+         * ```
          * @param {Options} [options]
          * @returns {JQuery}
          */
diff --git a/jquery/spinner.d.ts b/jquery/spinner.d.ts
index c79dbda..19e01c8 100644
--- a/jquery/spinner.d.ts
+++ b/jquery/spinner.d.ts
@@ -32,6 +32,7 @@ declare global {
          * $.createSpinner( { id: 'magic' } );
          * ```
          *
+         * @ignore
          * @param {string|Options} [opts] Options. If a string is given, it will be treated as the value
          *   of the `id` option.
          * @returns {JQuery}
@@ -41,6 +42,7 @@ declare global {
         /**
          * Remove a spinner element.
          *
+         * @ignore
          * @param {string} id Id of the spinner, as passed to {@link createSpinner}
          * @returns {JQuery} The (now detached) spinner element
          */
@@ -49,12 +51,13 @@ declare global {
 
     interface JQuery {
         /**
-         * Inject a spinner after each element in the collection
+         * Inject a spinner after each element in the collection.
+         * Provided by the `jquery.spinner` ResourceLoader module.
          *
          * Inserts spinner as siblings (not children) of the target elements.
          * Collection contents remain unchanged.
          *
-         * @param {string|Object} [opts] Options. If a string is given, it will be treated as the value
+         * @param {string|Options} [opts] Options. If a string is given, it will be treated as the value
          *   of the `id` option.
          * @returns {JQuery}
          */
diff --git a/jquery/suggestions.d.ts b/jquery/suggestions.d.ts
index 99cefe0..e04221e 100644
--- a/jquery/suggestions.d.ts
+++ b/jquery/suggestions.d.ts
@@ -2,6 +2,7 @@ declare global {
     interface JQuery {
         /**
          * This plugin provides a generic way to add suggestions to a text box.
+         * Provided by the `jquery.suggestions` ResourceLoader module.
          *
          * Set options:
          *
@@ -10,11 +11,14 @@ declare global {
          * $( '#textbox' ).suggestions( option, value );
          * ```
          *
-         * Initialize:
-         *
+         * @example
          * ```js
-         * $( '#textbox' ).suggestions();
+         * // Initialize:
+         * mw.loader.using( 'jquery.suggestions' ).then(()=> {
+         *     $( '#textbox' ).suggestions();
+         * });
          * ```
+         * Initialize:
          *
          * @param {string} property Name of property
          * @param {any} value Value to set property with
diff --git a/jquery/tablesorter.d.ts b/jquery/tablesorter.d.ts
index c80139d..ee08803 100644
--- a/jquery/tablesorter.d.ts
+++ b/jquery/tablesorter.d.ts
@@ -5,7 +5,8 @@ declare global {
 
     interface JQuery {
         /**
-         * Create a sortable table with multi-column sorting capabilities
+         * Create a sortable table with multi-column sorting capabilities.
+         * Provided by `jquery.tablesorter` ResourceLoader module.
          *
          * ```js
          * // Create a simple tablesorter interface
@@ -14,6 +15,9 @@ declare global {
          * // Create a tablesorter interface, initially sorting on the first and second column
          * $( 'table' ).tablesorter( { sortList: [ { 0: 'desc' }, { 1: 'asc' } ] } );
          * ```
+         *
+         * @param {Partial<Options>} settings
+         * @returns {JQuery}
          */
         tablesorter(this: JQuery<HTMLTableElement>, settings?: Partial<Options>): this;
     }
diff --git a/jquery/textSelection.d.ts b/jquery/textSelection.d.ts
index 8af079b..b6710ef 100644
--- a/jquery/textSelection.d.ts
+++ b/jquery/textSelection.d.ts
@@ -2,6 +2,7 @@ declare global {
     interface JQuery {
         /**
          * Get the contents of the textarea.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @returns {string}
@@ -11,6 +12,7 @@ declare global {
 
         /**
          * Set the contents of the textarea, replacing anything that was there before.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {string} content
@@ -21,6 +23,7 @@ declare global {
 
         /**
          * Get the currently selected text in this textarea.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @returns {string}
@@ -30,6 +33,7 @@ declare global {
 
         /**
          * Replace the selected text in the textarea with the given text, or insert it at the cursor.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {string} value
@@ -41,6 +45,7 @@ declare global {
         /**
          * Insert text at the beginning and end of a text selection, optionally
          * inserting text at the caret when selection is empty.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * Also focusses the textarea.
          *
@@ -56,6 +61,7 @@ declare global {
 
         /**
          * Get the current cursor position (in UTF-16 code units) in a textarea.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {Object} [options]
@@ -75,6 +81,7 @@ declare global {
 
         /**
          * Set the current cursor position (in UTF-16 code units) in a textarea.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {Object} options
@@ -88,6 +95,7 @@ declare global {
         /**
          * Scroll a textarea to the current cursor position. You can set the cursor
          * position with 'setSelection'.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {Object} [options]
@@ -100,6 +108,7 @@ declare global {
 
         /**
          * Register an alternative textSelection API for this element.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @param {Object.<string, Function>} functions Functions to replace. Keys are command names (as in {@link textSelection},
@@ -114,6 +123,7 @@ declare global {
 
         /**
          * Unregister the alternative textSelection API for this element (see 'register').
+         * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
@@ -122,6 +132,14 @@ declare global {
 
         /**
          * Do things to the selection in the textarea, using a command from the alternative textSelection API for this element.
+         * Provided by the `jquery.textSelection` ResourceLoader module.
+         *
+         * @example
+         * ```js
+         * mw.loader.using( 'jquery.textSelection' ).then( () => {
+         *     const contents = $( 'textarea' ).textSelection( 'getContents' );
+         * } );
+         * ```
          *
          * @param {string} command Command to execute
          * @param {any} [commandOptions] Options to pass to the command
diff --git a/jquery/updateTooltipAccessKeys.d.ts b/jquery/updateTooltipAccessKeys.d.ts
index 53e4517..fca2621 100644
--- a/jquery/updateTooltipAccessKeys.d.ts
+++ b/jquery/updateTooltipAccessKeys.d.ts
@@ -11,7 +11,16 @@ type KeyModifier = "alt" | "alt-shift" | "ctrl" | "ctrl-option";
 interface TooltipAccessKeys<This = JQuery> {
     /**
      * Update the titles for all elements in a jQuery selection.
+     * Installed by {@link mediawiki.util} module.
      *
+     * @example
+     * ```js
+     * // Converts tooltip "[z]" to associated browser shortcut key e.g. "[ctrl-option-z]"
+     * mw.loader.using( 'mediawiki.util' ).then( () => {
+     *     var $a = $('<a href="/wiki/Main_Page" title="Visit the main page [z]" accesskey="z"><span>Main page</span></a>');
+     *     $a.updateTooltipAccessKeys();
+     * } );
+     * ```
      * @returns {JQuery}
      */
     (): This;
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index 4f27c01..b8b7bb4 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -1,5 +1,4 @@
 import {
-    ApiParams,
     ApiEditPageParams,
     ApiLegacyTokenType,
     ApiParseParams,
@@ -11,7 +10,6 @@ import {
     ApiQueryTokensParams,
 } from "../api_params";
 import { TitleLike } from "./Title";
-import { UserInfo } from "./user";
 
 type TypeOrArray<T> = T extends any ? T | T[] : never; // T[] would be a mixed array
 type ReplaceValue<T extends U | U[], U, V> = T extends U[] ? V[] : V;
@@ -21,6 +19,9 @@ type UnknownApiParams = Record<string, string | string[] | boolean | number | nu
 export type ApiResponse = Record<string, any>; // it will always be a JSON object, the rest is uncertain ...
 
 interface Revision {
+    /**
+     * Revision content.
+     */
     content: string;
     timestamp: string;
 }
@@ -57,12 +58,6 @@ interface AssertUser {
     assertUser: string;
 }
 
-interface WatchStatus {
-    ns: number;
-    title: string;
-    watched: boolean;
-}
-
 interface RollbackInfo {
     /**
      * The revision being restored (the last revision before revision(s) by the reverted user).
@@ -88,67 +83,49 @@ interface FinishUpload {
     (data?: ApiUploadParams): JQuery.Promise<ApiResponse>;
 }
 
-/**
- * Default options for {@link jQuery.ajax} calls. Can be overridden by passing
- * `options` to {@link mw.Api} constructor.
- *
- * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-property-defaultOptions
- */
-export interface ApiOptions {
-    /**
-     * Default query parameters for API requests
-     */
-    parameters: UnknownApiParams;
-    /**
-     * Default options for {@link jQuery.ajax}
-     */
-    ajax: JQuery.AjaxSettings;
-    /**
-     * Whether to use U+001F when joining multi-valued parameters (since 1.28).
-     * Default is true if ajax.url is not set, false otherwise for compatibility.
-     */
-    useUS?: boolean;
-}
-
 declare global {
     namespace mw {
         /**
+         * Interact with the API of a particular MediaWiki site. mw.Api objects represent the API of
+         * one particular MediaWiki site.
+         *
+         * ```js
+         * var api = new mw.Api();
+         * api.get( {
+         *     action: 'query',
+         *     meta: 'userinfo'
+         * } ).done( function ( data ) {
+         *     console.log( data );
+         * } );
+         * ```
+         *
+         * Since MW 1.25, multiple values for a parameter can be specified using an array:
+         *
+         * ```js
+         * var api = new mw.Api();
+         * api.get( {
+         *     action: 'query',
+         *     meta: [ 'userinfo', 'siteinfo' ] // same effect as 'userinfo|siteinfo'
+         * } ).done( function ( data ) {
+         *     console.log( data );
+         * } );
+         * ```
+         *
+         * Since MW 1.26, boolean values for API parameters can be specified natively. Parameter
+         * values set to `false` or `undefined` will be omitted from the request, as required by
+         * the API.
+         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api
          */
         class Api {
             /**
-             * Constructor to create an object to interact with the API of a particular MediaWiki server. mw.Api objects represent the API of a particular MediaWiki server.
-             *
-             * ```js
-             * var api = new mw.Api();
-             * api.get( {
-             *     action: 'query',
-             *     meta: 'userinfo'
-             * } ).done( function ( data ) {
-             *     console.log( data );
-             * } );
-             * ```
-             *
-             * Since MW 1.25, multiple values for a parameter can be specified using an array:
-             *
-             * ```js
-             * var api = new mw.Api();
-             * api.get( {
-             *     action: 'query',
-             *     meta: [ 'userinfo', 'siteinfo' ] // same effect as 'userinfo|siteinfo'
-             * } ).done( function ( data ) {
-             *     console.log( data );
-             * } );
-             * ```
-             *
-             * Since MW 1.26, boolean values for a parameter can be specified directly. If the value is false or undefined, the parameter will be omitted from the request, as required by the API.
-             *
-             * @param {ApiOptions} [options]
+             * @param {Api.Options} [options] See {@link mw.Api.Options}. This can also be overridden for
+             *  each request by passing them to {@link get()} or {@link post()} (or directly to {@link ajax()}) later on.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-constructor
              */
-            constructor(options?: Partial<ApiOptions>);
+            constructor(options?: Api.Options);
 
-            private defaults: ApiOptions;
+            private defaults: Required<Api.Options>;
 
             /**
              * Abort all unfinished requests issued by this Api object.
@@ -195,8 +172,8 @@ declare global {
             /**
              * Perform the API call.
              *
-             * @param {UnknownApiParams} parameters Parameters to the API. See also {@link ApiOptions.parameters}
-             * @param {JQuery.AjaxSettings} [ajaxOptions] Parameters to pass to jQuery.ajax. See also {@link ApiOptions.ajax}
+             * @param {UnknownApiParams} parameters Parameters to the API. See also {@link mw.Api.Options.parameters}.
+             * @param {JQuery.AjaxSettings} [ajaxOptions] Parameters to pass to jQuery.ajax. See also {@link mw.Api.Options.ajax}.
              * @returns {JQuery.Promise<ApiResponse>} A promise that settles when the API response is processed.
              *   Has an 'abort' method which can be used to abort the request.
              *
@@ -218,7 +195,7 @@ declare global {
              *       first line of the server response). For HTTP/2, `exception` is always an empty string.
              *     - When the response is not valid JSON but the previous error conditions aren't met,
              *       textStatus is "parsererror" and exception is the exception object thrown by
-             *       `JSON.parse`.
+             *       {@link JSON.parse}.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-ajax
              */
             ajax(
@@ -229,8 +206,9 @@ declare global {
             /**
              * Post to API with the specified type of token. If we have no token, get one and try to post.
              * If we already have a cached token, try using that, and if the request fails using the cached token,
-             * blank it out and start over. For example, to change a user option, you could do:
+             * blank it out and start over.
              *
+             * @example <caption>For example, to change a user option, you could do:</caption>
              * ```js
              * new mw.Api().postWithToken( 'csrf', {
              *     action: 'options',
@@ -238,12 +216,11 @@ declare global {
              *     optionvalue: 'female'
              * } );
              * ```
-             *
              * @since 1.22
              * @param {string} tokenType The name of the token, like `options` or `edit`.
              * @param {UnknownApiParams} params API parameters
              * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<ApiResponse>} See {@link post}
+             * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-postWithToken
              */
             postWithToken(
@@ -268,8 +245,8 @@ declare global {
              *
              * @since 1.22
              * @param {string} type Token type
-             * @param {ApiQueryTokensParams|ApiAssert} [additionalParams] Additional parameters for the API (since 1.35). When given a string, it's treated as the `assert` parameter (since 1.25)
-             * @returns {JQuery.Promise<string>} Received token
+             * @param {ApiQueryTokensParams|ApiAssert} [additionalParams] Additional parameters for the API (since 1.35). When given a string, it's treated as the `assert` parameter (since 1.25).
+             * @returns {JQuery.Promise<string>} Received token.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-getToken
              */
             getToken(
@@ -289,8 +266,8 @@ declare global {
             /**
              * Indicate that the cached token for a certain action of the API is bad.
              *
-             * Call this if you get a `badtoken` error when using the token returned by `getToken()`.
-             * You may also want to use `postWithToken()` instead, which invalidates bad cached tokens
+             * Call this if you get a `badtoken` error when using the token returned by {@link getToken()}.
+             * You may also want to use {@link postWithToken()} instead, which invalidates bad cached tokens
              * automatically.
              *
              * @since 1.26
@@ -318,8 +295,7 @@ declare global {
              * Error messages, particularly for editing pages, may consist of multiple paragraphs of text.
              * Your user interface should have enough space for that.
              *
-             * Example usage:
-             *
+             * @example
              * ```js
              * var api = new mw.Api();
              * // var title = 'Test valid title';
@@ -333,7 +309,6 @@ declare global {
              *     mw.notify( api.getErrorMessage( data ), { type: 'error' } );
              * } );
              * ```
-             *
              * @param {ApiResponse} data API response indicating an error
              * @returns {JQuery} Error messages, each wrapped in a `<div>`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-getErrorMessage
@@ -344,8 +319,8 @@ declare global {
              * Post to API with csrf token. If we have no token, get one and try to post. If we have a cached token try using that, and if it fails, blank out the cached token and start over.
              *
              * @param {UnknownApiParams} params API parameters
-             * @param {JQuery.AjaxSettings} [ajaxOptions] See {@link post}
-             * @returns {JQuery.Promise<ApiResponse>}
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<ApiResponse>} See {@link post}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-postWithEditToken
              */
             postWithEditToken(
@@ -364,15 +339,13 @@ declare global {
             /**
              * Create a new page.
              *
-             * Example:
-             *
+             * @example
              * ```js
              * new mw.Api().create( 'Sandbox',
              *     { summary: 'Load sand particles.' },
              *     'Sand.'
              * );
              * ```
-             *
              * @since 1.28
              * @param {TitleLike} title Page title
              * @param {ApiEditPageParams} params Edit API parameters
@@ -389,7 +362,7 @@ declare global {
             /**
              * Edit an existing page.
              *
-             * To create a new page, use create() instead.
+             * To create a new page, use {@link create()} instead.
              *
              * Simple transformation:
              *
@@ -443,14 +416,11 @@ declare global {
              *
              * @since 1.28
              * @param {TitleLike} title Page title
-             * @param {function(Revision):string|ApiEditPageParams} transform Callback that prepares the edit
+             * @param {Api.EditTransform} transform Callback that prepares the edit
              * @returns {JQuery.Promise<EditResult>} Edit API response
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-edit
              */
-            edit(
-                title: TitleLike,
-                transform: (revision: Revision) => string | ApiEditPageParams
-            ): JQuery.Promise<EditResult>;
+            edit(title: TitleLike, transform: Api.EditTransform): JQuery.Promise<EditResult>;
 
             /**
              * Post a new section to the page.
@@ -459,7 +429,7 @@ declare global {
              * @param {string} header
              * @param {string} message Wikitext message
              * @param {ApiEditPageParams} additionalParams Additional API parameters
-             * @returns {JQuery.Promise<ApiResponse>}
+             * @returns {JQuery.Promise<ApiResponse>} See {@link postWithEditToken}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-newSection
              */
             newSection(
@@ -473,21 +443,33 @@ declare global {
              * Get the current user's groups and rights.
              *
              * @since 1.27
-             * @returns {JQuery.Promise<UserInfo>}
+             * @returns {JQuery.Promise<Api.UserInfo>}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.user-method-getUserInfo
              */
-            getUserInfo(): JQuery.Promise<UserInfo>;
+            getUserInfo(): JQuery.Promise<Api.UserInfo>;
 
             /**
              * Extend an API parameter object with an assertion that the user won't change.
              *
-             * This is useful for API calls which create new revisions or log entries. When the current page was loaded when the user was logged in, but at the time of the API call the user is not logged in anymore (e.g. due to session expiry), their IP is recorded in the page history or log, which can cause serious privacy issues. Extending the API parameters via this method ensures that that won't happen, by checking the user's identity that was embedded into the page when it was rendered against the active session on the server.
-             *
-             * Use it like this: `api.postWithToken( 'csrf', api.assertCurrentUser( { action: 'edit', ... } ) )`. When the assertion fails, the API request will fail, with one of the following error codes:
-             * * `apierror-assertanonfailed`: when the client-side logic thinks the user is anonymous but the server thinks it is logged in
-             * * `apierror-assertuserfailed`: when the client-side logic thinks the user is logged in but the server thinks it is anonymous
-             * * `apierror-assertnameduserfailed`: when both the client-side logic and the server thinks the user is logged in but they see it logged in under a different username.
-             *
+             * This is useful for API calls which create new revisions or log entries. When the current
+             * page was loaded when the user was logged in, but at the time of the API call the user
+             * is not logged in anymore (e.g. due to session expiry), their IP is recorded in the page
+             * history or log, which can cause serious privacy issues. Extending the API parameters via
+             * this method ensures that that won't happen, by checking the user's identity that was
+             * embedded into the page when it was rendered against the active session on the server.
+             *
+             * When the assertion fails, the API request will fail, with one of the following error codes:
+             * - `apierror-assertanonfailed`: when the client-side logic thinks the user is anonymous
+             *   but the server thinks it is logged in
+             * - `apierror-assertuserfailed`: when the client-side logic thinks the user is logged in but the
+             *   server thinks it is anonymous
+             * - `apierror-assertnameduserfailed`: when both the client-side logic and the server thinks the
+             *   user is logged in but they see it logged in under a different username.
+             *
+             * @example
+             * ```js
+             * api.postWithToken( 'csrf', api.assertCurrentUser( { action: 'edit', ... } ) )
+             * ```
              * @since 1.27
              * @param {UnknownApiParams} query Query parameters. The object will not be changed
              * @returns {AssertUser}
@@ -498,7 +480,8 @@ declare global {
             ): Omit<T, keyof AssertUser> & AssertUser;
 
             /**
-             * Asynchronously save the value of a single user option using the API. See `saveOptions()`.
+             * Asynchronously save the value of a single user option using the API.
+             * See {@link saveOptions()}.
              *
              * @param {string} name
              * @param {string|null} value
@@ -512,11 +495,15 @@ declare global {
              *
              * If a value of `null` is provided, the given option will be reset to the default value.
              *
-             * Any warnings returned by the API, including warnings about invalid option names or values, are ignored. However, do not rely on this behavior.
+             * Any warnings returned by the API, including warnings about invalid option names or values,
+             * are ignored. However, do not rely on this behavior.
              *
-             * If necessary, the options will be saved using several sequential API requests. Only one promise is always returned that will be resolved when all requests complete.
+             * If necessary, the options will be saved using several sequential API requests. Only one promise
+             * is always returned that will be resolved when all requests complete.
              *
-             * If a request from a previous `saveOptions()` call is still pending, this will wait for it to be completed, otherwise MediaWiki gets sad. No requests are sent for anonymous users, as they would fail anyway. See T214963.
+             * If a request from a previous {@link saveOptions()} call is still pending, this will wait for it to be
+             * completed, otherwise MediaWiki gets sad. No requests are sent for anonymous users, as they
+             * would fail anyway. See T214963.
              *
              * @param {Object.<string, string|null>} options Options as a `{ name: value, … }` object
              * @returns {JQuery.Promise<ApiResponse>}
@@ -528,34 +515,43 @@ declare global {
              * Convenience method for `action=watch`.
              *
              * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled
-             * @param {TypeOrArray<TitleLike>} pages
-             * @param {string} [expiry]
-             * @returns {JQuery.Promise<TypeOrArray<WatchStatus>>}
+             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
+             *  array thereof. If an array is passed, the return value passed to the promise will also be an
+             *  array of appropriate objects.
+             * @param {string} [expiry] When the page should expire from the watchlist. If omitted, the
+             *  page will not expire.
+             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
+             *  with an object (or array of objects) describing each page that was passed in and its
+             *  current watched/unwatched status.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.watch-method-watch
              */
             watch<P extends TypeOrArray<TitleLike>>(
                 pages: P,
                 expiry?: string
-            ): JQuery.Promise<ReplaceValue<P, TitleLike, WatchStatus>>;
+            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
 
             /**
              * Convenience method for `action=watch&unwatch=1`.
              *
-             * @param {TypeOrArray<TitleLike>} pages
-             * @returns {JQuery.Promise<TypeOrArray<WatchStatus>>}
+             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
+             *  array thereof. If an array is passed, the return value passed to the promise will also be an
+             *  array of appropriate objects.
+             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
+             *  with an object (or array of objects) describing each page that was passed in and its
+             *  current watched/unwatched status.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.watch-method-unwatch
              */
             unwatch<P extends TypeOrArray<TitleLike>>(
                 pages: P
-            ): JQuery.Promise<ReplaceValue<P, TitleLike, WatchStatus>>;
+            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
 
             /**
              * Convenience method for `action=parse`.
              *
-             * @param {TitleLike} content Content to parse, either as a wikitext string or a mw.Title
+             * @param {TitleLike} content Content to parse, either as a wikitext string or a {@link mw.Title}
              * @param {ApiParseParams} [additionalParams] Parameters object to set custom settings, e.g.
-             *   redirects, sectionpreview.  prop should not be overridden.
-             * @returns {JQuery.Promise<string>} Parsed HTML of `wikitext`.
+             *   `redirects`, `sectionpreview`. `prop` should not be overridden.
+             * @returns {JQuery.Promise<string>} Promise that resolves with the parsed HTML of `wikitext`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.parse-method-parse
              */
             parse(content: TitleLike, additionalParams?: ApiParseParams): JQuery.Promise<string>;
@@ -575,7 +571,7 @@ declare global {
             ): JQuery.Promise<Partial<Record<T, string>>>;
 
             /**
-             * Load a set of messages and add them to `mw.messages`.
+             * Load a set of messages and add them to {@link mw.messages}.
              *
              * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
@@ -588,16 +584,17 @@ declare global {
             ): JQuery.Promise<boolean>;
 
             /**
-             * Load a set of messages and add them to `mw.messages`. Only messages that are not already known are loaded. If all messages are known, the returned promise is resolved immediately.
+             * Load a set of messages and add them to {@link mw.messages}. Only messages that are not already known
+             * are loaded. If all messages are known, the returned promise is resolved immediately.
              *
              * @since 1.27
-             * @param {string[]} messages Messages to retrieve
+             * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
              * @returns {JQuery.Promise<boolean>}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.messages-method-loadMessagesIfMissing
              */
             loadMessagesIfMissing(
-                messages: string[],
+                messages: string | string[],
                 options?: ApiQueryAllMessagesParams
             ): JQuery.Promise<boolean>;
 
@@ -605,7 +602,7 @@ declare global {
              * Determine if a category exists.
              *
              * @param {TitleLike} title
-             * @returns {JQuery.Promise<boolean>}
+             * @returns {JQuery.Promise<boolean>} Promise that resolves with a boolean indicating whether the category exists.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-isCategory
              */
             isCategory(title: TitleLike): JQuery.Promise<boolean>;
@@ -616,7 +613,7 @@ declare global {
              * E.g. given "Foo", return "Food", "Foolish people", "Foosball tables"...
              *
              * @param {string} prefix Prefix to match.
-             * @returns {JQuery.Promise<string[]>} Matched categories
+             * @returns {JQuery.Promise<string[]>} Promise that resolves with an array of matched categories
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-getCategoriesByPrefix
              */
             getCategoriesByPrefix(prefix: string): JQuery.Promise<string[]>;
@@ -625,7 +622,7 @@ declare global {
              * Get the categories that a particular page on the wiki belongs to.
              *
              * @param {TitleLike} title
-             * @returns {JQuery.Promise<false|Title[]>} List of category titles or false if title was not found
+             * @returns {JQuery.Promise<false|Title[]>} Promise that resolves with an array of category titles, or with false if the title was not found.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-getCategories
              */
             getCategories(title: TitleLike): JQuery.Promise<false | Title[]>;
@@ -667,12 +664,14 @@ declare global {
              * Upload a file to the stash, in chunks.
              *
              * This function will return a promise that will resolve with a function to finish the stash upload.
+             * See {@link uploadToStash}.
              *
              * @param {File|HTMLInputElement} file
              * @param {ApiUploadParams} [data]
              * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
              * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
-             * @returns {JQuery.Promise<FinishUpload>}
+             * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
+             *  function that should be called to finish the upload.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-chunkedUploadToStash
              */
             chunkedUploadToStash(
@@ -710,8 +709,11 @@ declare global {
             /**
              * Upload a file to the stash.
              *
-             * This function will return a promise that will resolve with a function to finish the stash upload. You can call that function with an argument containing more, or conflicting, data to pass to the server. For example:
+             * This function will return a promise, which when resolved, will pass back a function
+             * to finish the stash upload. You can call that function with an argument containing
+             * more, or conflicting, data to pass to the server.
              *
+             * @example
              * ```js
              * // upload a file to the stash with a placeholder filename
              * api.uploadToStash( file, { filename: 'testing.png' } ).done( function ( finish ) {
@@ -725,7 +727,8 @@ declare global {
              *
              * @param {File|HTMLInputElement} file
              * @param {ApiUploadParams} [data]
-             * @returns {JQuery.Promise<FinishUpload>}
+             * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
+             *  function that should be called to finish the upload.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-uploadToStash
              */
             uploadToStash(
@@ -741,7 +744,69 @@ declare global {
              */
             login(username: string, password: string): JQuery.Promise<ApiResponse>;
         }
+
+        namespace Api {
+            interface EditTransform {
+                /**
+                 * @param {Object} revision Current revision
+                 * @returns {string|ApiEditPageParams|JQuery.Promise<string>|JQuery.Promise<ApiEditPageParams>} New content, object with edit API parameters, or promise providing one of those.
+                 */
+                (revision: Revision):
+                    | string
+                    | ApiEditPageParams
+                    | JQuery.Promise<string>
+                    | JQuery.Promise<ApiEditPageParams>;
+            }
+
+            /**
+             * Default options for {@link jQuery.ajax} calls. Can be overridden by passing
+             * `options` to {@link mw.Api} constructor.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-property-defaultOptions
+             */
+            interface Options {
+                /**
+                 * Default query parameters for API requests
+                 */
+                parameters?: UnknownApiParams;
+                /**
+                 * Default options for {@link jQuery.ajax}
+                 */
+                ajax?: JQuery.AjaxSettings;
+                /**
+                 * Whether to use U+001F when joining multi-valued parameters (since 1.28).
+                 * Default is true if ajax.url is not set, false otherwise for compatibility.
+                 */
+                useUS?: boolean;
+            }
+
+            interface UserInfo {
+                /**
+                 * User groups that the user belongs to.
+                 */
+                groups: string[];
+                /**
+                 * User's rights.
+                 */
+                rights: string[];
+            }
+
+            interface WatchedPage {
+                ns: number;
+                /**
+                 * Full page name.
+                 */
+                title: string;
+                /**
+                 * Whether the page is now watched (true) or unwatched (false).
+                 */
+                watched: boolean;
+            }
+        }
     }
 }
 
+/** @deprecated Use `mw.Api.Options` instead. Note that `ApiOptions` is strictly equivalent to `Required<mw.Api.Options>` as properties are now optional for consistency. */
+export type ApiOptions = Required<mw.Api.Options>;
+
 export {};
diff --git a/mw/ForeignApi.d.ts b/mw/ForeignApi.d.ts
index 0ac4fd3..03a8dd2 100644
--- a/mw/ForeignApi.d.ts
+++ b/mw/ForeignApi.d.ts
@@ -1,12 +1,3 @@
-import { ApiOptions } from "./Api";
-
-export interface ForeignApiOptions extends ApiOptions {
-    /**
-     * Whether to perform all requests anonymously. Use this option if the target wiki may otherwise not accept cross-origin requests, or if you don't need to perform write actions or read restricted information and want to avoid the overhead.
-     */
-    anonymous: boolean;
-}
-
 declare global {
     namespace mw {
         /**
@@ -19,9 +10,11 @@ declare global {
             static parent: typeof Api;
 
             /**
-             * Create an object like {@link mw.Api}, but automatically handling everything required to communicate with another MediaWiki wiki via cross-origin requests (CORS).
+             * Create an object like {@link mw.Api}, but automatically handling everything required to communicate
+             * with another MediaWiki wiki via cross-origin requests (CORS).
              *
-             * The foreign wiki must be configured to accept requests from the current wiki. See <https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains> for details.
+             * The foreign wiki must be configured to accept requests from the current wiki. See
+             * <https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains> for details.
              *
              * ```js
              * var api = new mw.ForeignApi( 'https://commons.wikimedia.org/w/api.php' );
@@ -33,7 +26,11 @@ declare global {
              * } );
              * ```
              *
-             * To ensure that the user at the foreign wiki is logged in, pass the `assert: 'user'` parameter to `get()`/`post()` (since MW 1.23): if they are not, the API request will fail. (Note that this doesn't guarantee that it's the same user.)
+             * To ensure that the user at the foreign wiki is logged in, pass the `assert: 'user'` parameter
+             * to {@link mw.ForeignApi.get}/{@link mw.ForeignApi.post} (since MW 1.23), otherwise the API
+             * request will fail. (Note that this doesn't guarantee that it's the same user. To assert that
+             * the user at the foreign wiki has a specific username, pass the `assertuser` parameter with
+             * the desired username.)
              *
              * Authentication-related MediaWiki extensions may extend this class to ensure that the user authenticated on the current wiki will be automatically authenticated on the foreign one. These extension modules should be registered using the ResourceLoaderForeignApiModules hook. See CentralAuth for a practical example. The general pattern to extend and override the name is:
              *
@@ -45,10 +42,10 @@ declare global {
              *
              * @since 1.26
              * @param {string|Uri} url URL pointing to another wiki's `api.php` endpoint.
-             * @param {Partial<ForeignApiOptions>} [options]
+             * @param {ForeignApi.Options} [options] Also accepts all the options from {@link mw.Api.Options}.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignApi-method-constructor
              */
-            constructor(url: string | Uri, options?: Partial<ForeignApiOptions>);
+            constructor(url: string | Uri, options?: ForeignApi.Options);
 
             /**
              * Return the origin to use for API requests, in the required format (protocol, host and port, if any).
@@ -58,7 +55,19 @@ declare global {
              */
             protected getOrigin(): "*" | `${string}//${string}` | undefined;
         }
+
+        namespace ForeignApi {
+            interface Options extends Api.Options {
+                /**
+                 * Whether to perform all requests anonymously. Use this option if the target wiki may otherwise not accept cross-origin requests, or if you don't need to perform write actions or read restricted information and want to avoid the overhead.
+                 */
+                anonymous?: boolean;
+            }
+        }
     }
 }
 
+/** @deprecated Use `mw.ForeignApi.Options` instead. Note that `ForeignApiOptions` is strictly equivalent to `Required<mw.ForeignApi.Options>` as properties are now optional for consistency. */
+export type ForeignApiOptions = Required<mw.ForeignApi.Options>;
+
 export {};
diff --git a/mw/ForeignRest.d.ts b/mw/ForeignRest.d.ts
index 1302232..218c06a 100644
--- a/mw/ForeignRest.d.ts
+++ b/mw/ForeignRest.d.ts
@@ -1,14 +1,3 @@
-import { RestOptions } from "./Rest";
-
-interface ForeignRestOptions extends RestOptions {
-    /**
-     * Perform all requests anonymously. Use this option if the target wiki may otherwise not
-     * accept cross-origin requests, or if you don't need to perform write actions or read
-     * restricted information and want to avoid the overhead.
-     */
-    anonymous: boolean;
-}
-
 declare global {
     namespace mw {
         /**
@@ -21,10 +10,11 @@ declare global {
             static parent: typeof Rest;
 
             /**
-             * Create an object like {@link mw.Rest}, but automatically handling everything required
-             * to communicate with another MediaWiki wiki via cross-origin requests (CORS).
+             * Create an object like {@link mw.Rest}, but automatically handling everything required to communicate
+             * with another MediaWiki wiki via cross-origin requests (CORS).
              *
-             * The foreign wiki must be configured to accept requests from the current wiki. See https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains for details.
+             * The foreign wiki must be configured to accept requests from the current wiki. See
+             * https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains for details.
              *
              * ```js
              * var api = new mw.ForeignRest( 'https://commons.wikimedia.org/w/rest.php' );
@@ -34,11 +24,10 @@ declare global {
              * } );
              * ```
              *
-             * Authentication-related MediaWiki extensions may extend this class to ensure that
-             * the user authenticated on the current wiki will be automatically authenticated on
-             * the foreign one. These extension modules should be registered using the
-             * ResourceLoaderForeignApiModules hook. See CentralAuth for a practical example.
-             * The general pattern to extend and override the name is:
+             * Authentication-related MediaWiki extensions may extend this class to ensure that the user
+             * authenticated on the current wiki will be automatically authenticated on the foreign one. These
+             * extension modules should be registered using the ResourceLoaderForeignApiModules hook. See
+             * CentralAuth for a practical example. The general pattern to extend and override the name is:
              *
              * ```js
              * function MyForeignRest() {};
@@ -49,14 +38,21 @@ declare global {
              * @since 1.36
              * @param {string} url URL pointing to another wiki's `rest.php` endpoint.
              * @param {ForeignApi} foreignActionApi
-             * @param {Partial<ForeignRestOptions>} [options]
+             * @param {ForeignRest.Options} [options] See {@link mw.Rest}.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignRest-method-constructor
              */
-            constructor(
-                url: string,
-                foreignActionApi: ForeignApi,
-                options?: Partial<ForeignRestOptions>
-            );
+            constructor(url: string, foreignActionApi: ForeignApi, options?: ForeignRest.Options);
+        }
+
+        namespace ForeignRest {
+            interface Options extends Rest.Options {
+                /**
+                 * Whether to perform all requests anonymously. Use this option if
+                 * the target wiki may otherwise not accept cross-origin requests, or if you don't need to
+                 * perform write actions or read restricted information and want to avoid the overhead.
+                 */
+                anonymous?: boolean;
+            }
         }
     }
 }
diff --git a/mw/Map.d.ts b/mw/Map.d.ts
index 0475f5a..46b0a68 100644
--- a/mw/Map.d.ts
+++ b/mw/Map.d.ts
@@ -67,12 +67,17 @@ export interface ExtensibleMap<V extends Record<string, any>, TX = unknown>
 declare global {
     namespace mw {
         /**
-         * Create an object that can be read from or written to via methods that allow interaction both
-         * with single and multiple properties at once.
+         * ES3 compatible class similar to [ES6 Map]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map}.
          *
-         * **NOTE**: This is a private utility class for internal use by the framework.
-         * Don't rely on its existence.
+         * Create an object that can be read from or written to via methods that allow
+         * interaction both with single and multiple properties at once.
          *
+         * @example
+         * ```js
+         * const map = new mw.Map();
+         * map.set( 'foo', 5 );
+         * alert( 5 === map.get( 'foo' ) );
+         * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map
          */
         class Map<V extends Record<string, any> = any> {
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index d412830..c1422cc 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -1,7 +1,3 @@
-export interface RestOptions {
-    ajax: JQuery.AjaxSettings;
-}
-
 export type RestResponse = Record<string, any>; // Unknown JSON object
 
 declare global {
@@ -15,6 +11,7 @@ declare global {
              * MediaWiki server. mw.Rest objects represent the REST API of a particular
              * MediaWiki server.
              *
+             * @example
              * ```js
              * var api = new mw.Rest();
              * api.get( '/v1/page/Main_Page/html' )
@@ -34,13 +31,12 @@ declare global {
              *     console.log( data );
              * } );
              * ```
-             *
-             * @param {Partial<RestOptions>} [options]
+             * @param {Rest.Options} [options] See {@link mw.Rest.Options}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-constructor
              */
-            constructor(options?: Partial<RestOptions>);
+            constructor(options?: Rest.Options);
 
-            private defaults: RestOptions;
+            private defaults: Required<Rest.Options>;
 
             /**
              * Abort all unfinished requests issued by this Api object.
@@ -67,24 +63,24 @@ declare global {
             /**
              * Perform REST API post request.
              *
-             * Note: only sending application/json is currently supported.
+             * Note: only sending `application/json` is currently supported.
              *
              * @param {string} path
-             * @param {Object.<string, any>} body
+             * @param {Object.<string, any>} [body]
              * @param {Object.<string, any>} [headers]
              * @returns {JQuery.Promise<RestResponse>}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-post
              */
             post(
                 path: string,
-                body: Record<string, any>,
+                body?: Record<string, any>,
                 headers?: Record<string, any>
             ): JQuery.Promise<RestResponse>;
 
             /**
              * Perform REST API PUT request.
              *
-             * Note: only sending application/json is currently supported.
+             * Note: only sending `application/json` is currently supported.
              *
              * @param {string} path
              * @param {Object.<string, any>} body
@@ -101,7 +97,7 @@ declare global {
             /**
              * Perform REST API DELETE request.
              *
-             * Note: only sending application/json is currently supported.
+             * Note: only sending `application/json` is currently supported.
              *
              * @param {string} path
              * @param {Object.<string, any>} body
@@ -125,7 +121,16 @@ declare global {
              */
             ajax(path: string, ajaxOptions?: JQuery.AjaxSettings): JQuery.Promise<RestResponse>;
         }
+
+        namespace Rest {
+            interface Options {
+                ajax?: JQuery.AjaxSettings;
+            }
+        }
     }
 }
 
+/** @deprecated Use `mw.Rest.Options` instead. Note that `RestOptions` is strictly equivalent to `Required<mw.Rest.Options>` as properties are now optional for consistency. */
+export type RestOptions = Required<mw.Rest.Options>;
+
 export {};
diff --git a/mw/Title.d.ts b/mw/Title.d.ts
index b03910d..398fcc2 100644
--- a/mw/Title.d.ts
+++ b/mw/Title.d.ts
@@ -2,31 +2,66 @@ import { QueryParams } from "./Uri";
 
 export type TitleLike = string | mw.Title;
 
+interface TitleExistenceStore {
+    /**
+     * Keyed by title. Boolean true value indicates page does exist.
+     */
+    pages: { [title: string]: boolean };
+
+    /**
+     * The setter function. Returns a boolean.
+     *
+     * Example to declare existing titles:
+     *
+     * ```js
+     * Title.exist.set( ['User:John_Doe', ...] );
+     * ```
+     *
+     * Example to declare titles nonexistent:
+     *
+     * ```js
+     * Title.exist.set( ['File:Foo_bar.jpg', ...], false );
+     * ```
+     *
+     * @param {string|string[]} titles Title(s) in strict prefixedDb title form
+     * @param {boolean} [state=true] State of the given titles
+     * @returns {boolean}
+     */
+    set(titles: string | string[], state?: boolean): boolean;
+}
+
 declare global {
     namespace mw {
         /**
-         * Parse titles into an object structure. Note that when using the constructor
-         * directly, passing invalid titles will result in an exception. Use {@link newFromText} to use the
-         * logic directly and get null for invalid titles which is easier to work with.
+         * Library for constructing MediaWiki titles.
          *
          * Note that in the constructor and {@link newFromText} method, `namespace` is the **default** namespace
          * only, and can be overridden by a namespace prefix in `title`. If you do not want this behavior,
-         * use {@link makeTitle}. Compare:
+         * use {@link makeTitle}.
          *
+         * @example
          * ```js
-         * new mw.Title( 'Foo', NS_TEMPLATE ).getPrefixedText();                  // => 'Template:Foo'
-         * mw.Title.newFromText( 'Foo', NS_TEMPLATE ).getPrefixedText();          // => 'Template:Foo'
-         * mw.Title.makeTitle( NS_TEMPLATE, 'Foo' ).getPrefixedText();            // => 'Template:Foo'
+         * new mw.Title( 'Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Template:Foo'
+         * mw.Title.newFromText( 'Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Template:Foo'
+         * mw.Title.makeTitle( NS_TEMPLATE, 'Foo' ).getPrefixedText();
+         * // => 'Template:Foo'
          *
-         * new mw.Title( 'Category:Foo', NS_TEMPLATE ).getPrefixedText();         // => 'Category:Foo'
-         * mw.Title.newFromText( 'Category:Foo', NS_TEMPLATE ).getPrefixedText(); // => 'Category:Foo'
-         * mw.Title.makeTitle( NS_TEMPLATE, 'Category:Foo' ).getPrefixedText();   // => 'Template:Category:Foo'
+         * new mw.Title( 'Category:Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Category:Foo'
+         * mw.Title.newFromText( 'Category:Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Category:Foo'
+         * mw.Title.makeTitle( NS_TEMPLATE, 'Category:Foo' ).getPrefixedText();
+         * // => 'Template:Category:Foo'
          *
-         * new mw.Title( 'Template:Foo', NS_TEMPLATE ).getPrefixedText();         // => 'Template:Foo'
-         * mw.Title.newFromText( 'Template:Foo', NS_TEMPLATE ).getPrefixedText(); // => 'Template:Foo'
-         * mw.Title.makeTitle( NS_TEMPLATE, 'Template:Foo' ).getPrefixedText();   // => 'Template:Template:Foo'
+         * new mw.Title( 'Template:Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Template:Foo'
+         * mw.Title.newFromText( 'Template:Foo', NS_TEMPLATE ).getPrefixedText();
+         * // => 'Template:Foo'
+         * mw.Title.makeTitle( NS_TEMPLATE, 'Template:Foo' ).getPrefixedText();
+         * // => 'Template:Template:Foo'
          * ```
-         *
          * @since 1.18
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title
          */
@@ -36,35 +71,13 @@ declare global {
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-property-exist
              */
-            static exist: {
-                /**
-                 * Keyed by title. Boolean true value indicates page does exist.
-                 */
-                pages: { [title: string]: boolean };
-
-                /**
-                 * The setter function.
-                 *
-                 * Example to declare existing titles:
-                 *
-                 * ```js
-                 * Title.exist.set( ['User:John_Doe', ...] );
-                 * ```
-                 *
-                 * Example to declare titles nonexistent:
-                 *
-                 * ```js
-                 * Title.exist.set( ['File:Foo_bar.jpg', ...], false );
-                 * ```
-                 *
-                 * @param {string|string[]} titles Title(s) in strict prefixedDb title form
-                 * @param {boolean} [state=true] State of the given titles
-                 * @returns {boolean}
-                 */
-                set(titles: string | string[], state?: boolean): boolean;
-            };
+            static exist: TitleExistenceStore;
 
             /**
+             * Parse titles into an object structure. Note that when using the constructor
+             * directly, passing invalid titles will result in an exception. See {@link newFromText} to use the
+             * logic directly and get null for invalid titles which is easier to work with.
+             *
              * @param {string} title Title of the page. If no second argument given,
              *  this will be searched for a namespace
              * @param {number} [namespace=NS_MAIN] If given, will used as default namespace for the given title
@@ -74,7 +87,7 @@ declare global {
             constructor(title: string, namespace?: number);
 
             /**
-             * Check the title can have an associated talk page
+             * Check the title can have an associated talk page.
              *
              * @returns {boolean} The title can have an associated talk page
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-canHaveTalkPage
@@ -82,7 +95,7 @@ declare global {
             canHaveTalkPage(): boolean;
 
             /**
-             * Whether this title exists on the wiki.
+             * Whether this title exists on the wiki. See {@link mw.Title.exists}.
              *
              * @returns {boolean|null} Boolean if the information is available, otherwise null
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-exists
@@ -90,7 +103,7 @@ declare global {
             exists(): boolean | null;
 
             /**
-             * Get the extension of the page name (if any)
+             * Get the extension of the page name (if any).
              *
              * @returns {string|null} Name extension or null if there is none
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getExtension
@@ -100,10 +113,10 @@ declare global {
             /**
              * Get the page name as if it is a file name, without extension or namespace prefix,
              * in the human-readable form with spaces instead of underscores. For example, the title
-             * "File:Example_image.svg" will be returned as "Example image".
+             * `File:Example_image.svg` will be returned as `Example image`.
              *
              * Note that this method will work for non-file titles but probably give nonsensical results.
-             * A title like "User:Dr._J._Fail" will be returned as "Dr. J"! Use {@link getMainText} instead.
+             * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMainText} instead.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getFileNameTextWithoutExtension
@@ -113,10 +126,10 @@ declare global {
             /**
              * Get the page name as if it is a file name, without extension or namespace prefix,
              * in the canonical form with underscores instead of spaces. For example, the title
-             * "File:Example_image.svg" will be returned as "Example_image".
+             * `File:Example_image.svg` will be returned as `Example image`.
              *
              * Note that this method will work for non-file titles but probably give nonsensical results.
-             * A title like "User:Dr._J._Fail" will be returned as "Dr._J"! Use {@link getMain} instead.
+             * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMain} instead.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getFileNameWithoutExtension
@@ -135,9 +148,9 @@ declare global {
             getFragment(): string | null;
 
             /**
-             * Get the main page name
+             * Get the main page name.
              *
-             * Example: "Example_image.svg" for "File:Example_image.svg".
+             * Example: `Example_image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getMain
@@ -145,9 +158,9 @@ declare global {
             getMain(): string;
 
             /**
-             * Get the main page name (transformed by #text)
+             * Get the main page name (transformed by {@link text()}).
              *
-             * Example: "Example image.svg" for "File:Example_image.svg".
+             * Example: `Example image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getMainText
@@ -156,21 +169,21 @@ declare global {
 
             /**
              * Get the page name as if it is a file name, without extension or namespace prefix. Warning,
-             * this is usually not what you want! A title like "User:Dr._J._Fail" will be returned as
-             * "Dr. J"! Use {@link getMain} or {@link getMainText} for the actual page name.
+             * this is usually not what you want! A title like `User:Dr._J._Fail` will be returned as
+             * `Dr. J`! Use {@link getMain} or {@link getMainText} for the actual page name.
              *
              * @deprecated since 1.40, use {@link getFileNameWithoutExtension} instead
              * @returns {string} File name without file extension, in the canonical form with underscores
-             *  instead of spaces. For example, the title "File:Example_image.svg" will be returned as
+             *  instead of spaces. For example, the title `File:Example_image.svg` will be returned as
              *  "Example_image".
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getName
              */
             getName(): string;
 
             /**
-             * Get the namespace number
+             * Get the namespace number.
              *
-             * Example: 6 for "File:Example_image.svg".
+             * Example: 6 for `File:Example_image.svg`.
              *
              * @returns {number}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getNamespaceId
@@ -178,9 +191,9 @@ declare global {
             getNamespaceId(): number;
 
             /**
-             * Get the namespace prefix (in the content language)
+             * Get the namespace prefix (in the content language).
              *
-             * Example: "File:" for "File:Example_image.svg".
+             * Example: `File:` for `File:Example_image.svg`.
              * In #NS_MAIN this is '', otherwise namespace name plus ':'
              *
              * @returns {string}
@@ -190,21 +203,21 @@ declare global {
 
             /**
              * Get the page name as if it is a file name, without extension or namespace prefix. Warning,
-             * this is usually not what you want! A title like "User:Dr._J._Fail" will be returned as
-             * "Dr. J"! Use {@link getMainText} for the actual page name.
+             * this is usually not what you want! A title like `User:Dr._J._Fail` will be returned as
+             * `Dr. J`! Use {@link getMainText} for the actual page name.
              *
              * @deprecated since 1.40, use {@link getFileNameTextWithoutExtension} instead
              * @returns {string} File name without file extension, formatted with spaces instead of
-             *  underscores. For example, the title "File:Example_image.svg" will be returned as
-             *  "Example image".
+             *  underscores. For example, the title `File:Example_image.svg` will be returned as
+             *  `Example image`.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getNameText
              */
             getNameText(): string;
 
             /**
-             * Get the full page name
+             * Get the full page name.
              *
-             * Example: "File:Example_image.svg".
+             * Example: `File:Example_image.svg`.
              * Most useful for API calls, anything that must identify the "title".
              *
              * @returns {string}
@@ -213,9 +226,9 @@ declare global {
             getPrefixedDb(): string;
 
             /**
-             * Get the full page name (transformed by #text)
+             * Get the full page name (transformed by {@link text()}).
              *
-             * Example: "File:Example image.svg" for "File:Example_image.svg".
+             * Example: `File:Example image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getPrefixedText
@@ -223,7 +236,7 @@ declare global {
             getPrefixedText(): string;
 
             /**
-             * Get the page name relative to a namespace
+             * Get the page name relative to a namespace.
              *
              * Example:
              *
@@ -238,7 +251,7 @@ declare global {
             getRelativeText(namespace: number): string;
 
             /**
-             * Get the title for the subject page of a talk page
+             * Get the title for the subject page of a talk page.
              *
              * @returns {Title|null} The title for the subject page of a talk page, null if not available
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getSubjectPage
@@ -246,7 +259,7 @@ declare global {
             getSubjectPage(): Title | null;
 
             /**
-             * Get the title for the associated talk page
+             * Get the title for the associated talk page.
              *
              * @returns {Title|null} The title for the associated talk page, null if not available
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getTalkPage
@@ -254,7 +267,7 @@ declare global {
             getTalkPage(): Title | null;
 
             /**
-             * Get the URL to this title
+             * Get the URL to this title. See {@link mw.util.getUrl()}.
              *
              * @param {QueryParams} [params] A mapping of query parameter names to values,
              *     e.g. `{ action: 'edit' }`.
@@ -264,7 +277,7 @@ declare global {
             getUrl(params?: QueryParams): string;
 
             /**
-             * Check if the title is in a talk namespace
+             * Check if the title is in a talk namespace.
              *
              * @returns {boolean} The title is in a talk namespace
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-isTalkPage
@@ -272,14 +285,14 @@ declare global {
             isTalkPage(): boolean;
 
             /**
-             * Alias of {@link getPrefixedDb}
+             * Alias of {@link getPrefixedDb}.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-toString
              */
             toString(): string;
 
             /**
-             * Alias of {@link getPrefixedText}
+             * Alias of {@link getPrefixedText}.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-toText
              */
@@ -296,7 +309,7 @@ declare global {
             static exists(title: TitleLike): boolean | null;
 
             /**
-             * Check if a given namespace is a talk namespace
+             * Check if a given namespace is a talk namespace.
              *
              * See NamespaceInfo::isTalk in PHP
              *
@@ -309,8 +322,8 @@ declare global {
             /**
              * Constructor for Title objects with predefined namespace.
              *
-             * Unlike {@link newFromText} or {@link constructor}, this function doesn't allow the given `namespace` to be
-             * overridden by a namespace prefix in `title`. See {@link constructor} for details about this behavior.
+             * Unlike {@link newFromText} or the constructor, this function doesn't allow the given `namespace` to be
+             * overridden by a namespace prefix in `title`. See the constructor documentation for details about this behavior.
              *
              * The single exception to this is when `namespace` is 0, indicating the main namespace. The
              * function behaves like {@link newFromText} in that case.
@@ -335,12 +348,12 @@ declare global {
             static newFromFileName(uncleanName: string): Title | null;
 
             /**
-             * Get the file title from an image element
+             * Get the file title from an image element.
              *
+             * @example
              * ```js
              * var title = mw.Title.newFromImg( imageNode );
              * ```
-             *
              * @param {HTMLElement|JQuery} img The image to use as a base
              * @returns {Title|null} The file title or null if unsuccessful
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-newFromImg
@@ -363,7 +376,7 @@ declare global {
 
             /**
              * Constructor for Title objects from user input altering that input to
-             * produce a title that MediaWiki will accept as legal
+             * produce a title that MediaWiki will accept as legal.
              *
              * @param {string} title
              * @param {number} [defaultNamespace=NS_MAIN]
@@ -403,7 +416,7 @@ declare global {
             static phpCharToUpper(chr: string): string;
 
             /**
-             * Check if signature buttons should be shown in a given namespace
+             * Check if signature buttons should be shown in a given namespace.
              *
              * See NamespaceInfo::wantSignatures in PHP
              *
diff --git a/mw/Uri.d.ts b/mw/Uri.d.ts
index f748e3b..98ca249 100644
--- a/mw/Uri.d.ts
+++ b/mw/Uri.d.ts
@@ -1,22 +1,5 @@
 export type QueryParams = Record<string, string | number | boolean | null | undefined>;
 
-interface UriOptions {
-    /**
-     * Trigger strict mode parsing of the url.
-     */
-    strictMode: boolean;
-    /**
-     * Whether to let duplicate query parameters override each other (`true`) or automagically convert them to an array (`false`).
-     */
-    overrideKeys: boolean;
-    /**
-     * Whether to parse array query parameters (e.g. `&foo[0]=a&foo[1]=b` or `&foo[]=a&foo[]=b`) or leave them alone.
-     * Currently this does not handle associative or multi-dimensional arrays, but that may be improved in the future.
-     * Implies `overrideKeys: true` (query parameters without `[...]` are not parsed as arrays).
-     */
-    arrayParams: boolean;
-}
-
 interface UriParser {
     strict: RegExp;
     loose: RegExp;
@@ -25,7 +8,7 @@ interface UriParser {
 declare global {
     namespace mw {
         /**
-         * A factory method to create an mw.Uri class with a default location to resolve relative URLs
+         * A factory method to create an {@link mw.Uri} class with a default location to resolve relative URLs
          * against (including protocol-relative URLs).
          *
          * @param {string|Function} documentLocation A full url, or function returning one.
@@ -92,49 +75,49 @@ declare global {
          */
         class Uri {
             /**
-             * For example `top`
+             * For example `top`.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-fragment
              */
             fragment: string | undefined;
             /**
-             * For example `www.example.com` (always present)
+             * For example `www.example.com` (always present).
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-host
              */
             host: string;
             /**
-             * For example `pwd`
+             * For example `pwd`.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-password
              */
             password: string | undefined;
             /**
-             * For example `/dir/dir.2/index.htm` (always present)
+             * For example `/dir/dir.2/index.htm` (always present).
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-path
              */
             path: string;
             /**
-             * For example `81`
+             * For example `81`.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-port
              */
             port: string | undefined;
             /**
-             * For example `http` (always present)
+             * For example `http` (always present).
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-protocol
              */
             protocol: string;
             /**
-             * For example `{ a: '0', b: '', c: 'value' }` (always present)
+             * For example `{ a: '0', b: '', c: 'value' }` (always present).
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-query
              */
             query: QueryParams;
             /**
-             * For example `usr`
+             * For example `usr`.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-user
              */
@@ -168,26 +151,25 @@ declare global {
             ];
 
             /**
-             * Construct a new URI object. Throws error if arguments are illegal/impossible, or
-             * otherwise don't parse.
+             * Create and manipulate MediaWiki URIs.
              *
              * @param {Object|string} [uri] URI string, or an Object with appropriate properties (especially
              *  another URI object to clone). Object must have non-blank `protocol`, `host`, and `path`
              *  properties. If omitted (or set to `undefined`, `null` or empty string), then an object
              *  will be created for the default `uri` of this constructor (`location.href` for mw.Uri,
-             *  other values for other instances -- see mw.UriRelative for details).
-             * @param {Partial<UriOptions>|boolean} [options] Object with options, or (backwards compatibility) a boolean
+             *  other values for other instances -- see {@link mw.UriRelative} for details).
+             * @param {Uri.UriOptions|boolean} [options] Object with options, or (backwards compatibility) a boolean
              *  for strictMode
              * @throws {Error} when the query string or fragment contains an unknown % sequence
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-constructor
              */
             constructor(
                 uri?: string | Uri | Partial<Record<typeof Uri.properties[number], string>>,
-                options?: Partial<UriOptions> | boolean
+                options?: Uri.UriOptions | boolean
             );
 
             /**
-             * Clone this URI
+             * Clone this URI.
              *
              * @returns {Uri} New URI object with same properties
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-clone
@@ -268,11 +250,11 @@ declare global {
              * Parse a string and set our properties accordingly.
              *
              * @param {string} str URI, see constructor.
-             * @param {Partial<UriOptions>} options See constructor.
+             * @param {Uri.UriOptions} options See constructor.
              * @throws {Error} when the query string or fragment contains an unknown % sequence
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-parse
              */
-            private parse(str: string, options: Partial<UriOptions>): void;
+            private parse(str: string, options: Uri.UriOptions): void;
 
             /**
              * Decode a url encoded value.
@@ -292,7 +274,7 @@ declare global {
              *
              * Standard encodeURIComponent, with extra stuff to make all browsers work similarly and more
              * compliant with RFC 3986. Similar to rawurlencode from PHP and our JS library
-             * mw.util.rawurlencode, except this also replaces spaces with `+`.
+             * {@link mw.util.rawurlencode}, except this also replaces spaces with `+`.
              *
              * @param {string} s String to encode
              * @returns {string} Encoded string for URI
@@ -300,6 +282,28 @@ declare global {
              */
             static encode(s: string): string;
         }
+
+        namespace Uri {
+            interface UriOptions {
+                /**
+                 * Whether to parse array query parameters (e.g. `&foo[0]=a&foo[1]=b` or `&foo[]=a&foo[]=b`) or leave them alone.
+                 * Currently this does not handle associative or multi-dimensional arrays, but that may be improved in the future.
+                 * Implies `overrideKeys: true` (query parameters without `[...]` are not parsed as arrays). Defaults to false.
+                 */
+                arrayParams: boolean;
+
+                /**
+                 * Whether to let duplicate query parameters override each other (`true`) or automagically convert them to an array (`false`).
+                 * Defaults to false.
+                 */
+                overrideKeys: boolean;
+
+                /**
+                 * Trigger strict mode parsing of the url. Defaults to false.
+                 */
+                strictMode: boolean;
+            }
+        }
     }
 }
 
diff --git a/mw/cldr.d.ts b/mw/cldr.d.ts
index ac27f04..b344e80 100644
--- a/mw/cldr.d.ts
+++ b/mw/cldr.d.ts
@@ -2,6 +2,7 @@ declare global {
     namespace mw {
         /**
          * Namespace for CLDR-related utility methods.
+         * Provided by the `mediawiki.cdlr` ResourceLoader module.
          */
         namespace cldr {
             /**
diff --git a/mw/confirmCloseWindow.d.ts b/mw/confirmCloseWindow.d.ts
index 0378fda..38d8a7a 100644
--- a/mw/confirmCloseWindow.d.ts
+++ b/mw/confirmCloseWindow.d.ts
@@ -35,28 +35,31 @@ declare global {
     namespace mw {
         /**
          * Prevent the closing of a window with a confirm message (the onbeforeunload event seems to
-         * work in most browsers.)
+         * work in most browsers).
+         *
+         * Provided by the `mediawiki.confirmCloseWindow` module.
          *
          * This supersedes any previous onbeforeunload handler. If there was a handler before, it is
          * restored when you execute the returned release() function.
          *
+         * @example
          * ```js
-         * var allowCloseWindow = mw.confirmCloseWindow();
-         * // ... do stuff that can't be interrupted ...
-         * allowCloseWindow.release();
-         * ```
+         * mw.loader.using( 'mediawiki.confirmCloseWindow' ).then(() => {
+         *     var allowCloseWindow = mw.confirmCloseWindow();
+         *     // ... do stuff that can't be interrupted ...
+         *     allowCloseWindow.release();
          *
-         * The second function returned is a trigger function to trigger the check and an alert
-         * window manually, e.g.:
+         *     // The second function returned is a trigger function to trigger the check and an alert
+         *     // window manually, e.g.:
          *
-         * ```js
-         * var allowCloseWindow = mw.confirmCloseWindow();
-         * // ... do stuff that can't be interrupted ...
-         * if ( allowCloseWindow.trigger() ) {
-         *     // don't do anything (e.g. destroy the input field)
-         * } else {
-         *     // do whatever you wanted to do
-         * }
+         *     var allowCloseWindow = mw.confirmCloseWindow();
+         *     // ... do stuff that can't be interrupted ...
+         *     if ( allowCloseWindow.trigger() ) {
+         *         // don't do anything (e.g. destroy the input field)
+         *     } else {
+         *         // do whatever you wanted to do
+         *     }
+         * })
          * ```
          *
          * @param {Options} [options]
diff --git a/mw/cookie.d.ts b/mw/cookie.d.ts
index e207505..83b5b79 100644
--- a/mw/cookie.d.ts
+++ b/mw/cookie.d.ts
@@ -3,8 +3,16 @@ type SameSite = "none" | "lax" | "strict";
 declare global {
     namespace mw {
         /**
-         * Manage cookies in a way that is syntactically and functionally similar to the `WebRequest#getCookie` and `WebResponse#setcookie` methods in PHP.
+         * Manage cookies in a way that is syntactically and functionally similar
+         * to the `WebRequest#getCookie` and `WebResponse#setcookie` methods in PHP.
+         * Provided by the `mediawiki.cookie` ResourceLoader module.
          *
+         * @example
+         * ```js
+         * mw.loader.using( 'mediawiki.cookie' ).then( () => {
+         *     mw.cookie.set('hello', 'world' );
+         * })
+         * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie
          */
         namespace cookie {
@@ -13,7 +21,7 @@ declare global {
              *
              * @param {string} key The key for the cookie
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
-             * @param {any} [defaultValue] A value to return if the cookie does not exist
+             * @param {null|string} [defaultValue] A value to return if the cookie does not exist
              * @returns {any} If the cookie exists, the value of the cookie, otherwise `defaultValue`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-get
              */
@@ -29,7 +37,7 @@ declare global {
              *
              * @param {string} key The key for the cookie
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
-             * @param {any} [defaultValue] A value to return if the cookie does not exist
+             * @param {null|string} [defaultValue] A value to return if the cookie does not exist
              * @returns {any} If the cookie exists, the value of the cookie, otherwise `defaultValue`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-getCrossSite
              */
@@ -50,34 +58,59 @@ declare global {
              * Without an expiry, this creates a session cookie. In a browser, session cookies persist for the lifetime of the browser *process*. Including across tabs, page views, and windows, until the browser itself is *fully* closed, or until the browser clears all storage for a given website. An exception to this is if the user evokes a "restore previous session" feature that some browsers have.
              *
              * @param {string} key
-             * @param {string | null} value Value of cookie. If `value` is `null` then this method will instead remove a cookie by name of `key`
-             * @param {Object | Date | number} [options] Options object, or expiry date
-             * @param {Date | number | null} [options.expires] The expiry date of the cookie or lifetime in seconds. If `options.expires` is null or 0, then a session cookie is set
-             * @param {string} [options.prefix] The prefix of the key
-             * @param {string} [options.domain] The domain attribute of the cookie
-             * @param {string} [options.path] The path attribute of the cookie
-             * @param {boolean} [options.secure] Whether or not to include the secure attribute (Does **not** use the wgCookieSecure configuration variable)
-             * @param {string} [options.sameSite] The `SameSite` flag of the cookie (case-insensitive; default is to omit the flag, which results in `Lax` on modern browsers). Set to `None` *and* set `secure` to `true` if the cookie needs to be visible on cross-domain requests
-             * @param {boolean} [options.sameSiteLegacy] If true, `SameSite` = `None` cookies will also be sent as non-`SameSite` cookies with an "ss0-" prefix, to work around old browsers interpreting the standard differently
+             * @param {string|null} value Value of cookie. If `value` is `null` then this method will instead remove a cookie by name of `key`
+             * @param {CookieOptions|Date|number} [options] Options object, or expiry date
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-set
              */
             // see https://stackoverflow.com/a/64932909 for <SS>
             function set<SS extends string = SameSite>(
                 key: string,
                 value: string | null,
-                options?:
-                    | Date
-                    | number
-                    | Partial<{
-                          domain: string;
-                          expires: Date | number | null;
-                          path: string;
-                          prefix: string;
-                          sameSite: Lowercase<SS> extends SameSite ? SS : SameSite;
-                          sameSiteLegacy: boolean;
-                          secure: boolean;
-                      }>
+                options?: CookieOptions<SS> | Date | number
             ): void;
+
+            /**
+             * Custom scope for cookie key, must match the way it was set.
+             */
+            interface CookieOptions<SS extends string = SameSite> {
+                /**
+                 * Custom scope for cookie key. The domain attribute of the cookie.
+                 * Defaults to wgCookieDomain.
+                 */
+                domain?: string;
+                /**
+                 * Number of days to store the value (when setting).
+                 * The expiry date of the cookie, or lifetime in seconds.
+                 * If null or 0, then a session cookie is set. Defaults to wgCookieExpiration.
+                 */
+                expires?: Date | number | null;
+                /**
+                 * The path attribute of the cookie. Defaults to wgCookiePath.
+                 */
+                path?: string;
+                /**
+                 * The prefix of the key. Defaults to wgCookiePrefix.
+                 */
+                prefix?: string;
+                /**
+                 * The SameSite flag of the cookie ('None' / 'Lax'
+                 * / 'Strict', case-insensitive; default is to omit the flag, which results in Lax on
+                 * modern browsers). Set to None AND set secure=true if the cookie needs to be visible on
+                 * cross-domain requests.
+                 */
+                sameSite?: Lowercase<SS> extends SameSite ? SS : SameSite;
+                /**
+                 * Deprecated, ignored.
+                 *
+                 * @deprecated
+                 */
+                sameSiteLegacy?: boolean;
+                /**
+                 * Whether or not to include the secure attribute. Defaults to false.
+                 * (Does **not** use the wgCookieSecure configuration variable)
+                 */
+                secure?: boolean;
+            }
         }
     }
 }
diff --git a/mw/deflate.d.ts b/mw/deflate.d.ts
index 5be4a4a..374f27f 100644
--- a/mw/deflate.d.ts
+++ b/mw/deflate.d.ts
@@ -1,15 +1,15 @@
 declare global {
     namespace mw {
         /**
-         * Compress the content and add the 'rawdeflate,' prefix.
+         * Convert a byte stream to base64 text.
+         * Before using load the `mediawiki.deflate` ResourceLoader module.
          *
          * @example
          * ```js
          * mw.loader.using( 'mediawiki.deflate' ).then( function () {
-         *     var deflated = mw.deflate( myContent );
+         *     return mw.deflate( html );
          * } );
          * ```
-         *
          * @param {string|ArrayBuffer} data Undeflated data
          * @returns {string} Deflated data
          * @see https://github.com/wikimedia/mediawiki/blob/master/resources/src/mediawiki.deflate/mw.deflate.js#L3
diff --git a/mw/errorLogger.d.ts b/mw/errorLogger.d.ts
new file mode 100644
index 0000000..032435d
--- /dev/null
+++ b/mw/errorLogger.d.ts
@@ -0,0 +1,22 @@
+declare global {
+    namespace mw {
+        /**
+         * Allows the logging of client errors for later inspections.
+         */
+        namespace errorLogger {
+            /**
+             * Logs an error by notifying subscribers to the given {@link mw.track()} topic
+             * (by default `error.caught`) that an event has occurred.
+             *
+             * @param {Error} error
+             * @param {string} [topic='error.caught'] Error topic. Conventionally in the form
+             *   'error.%component%' (where %component% identifies the code logging the error at a
+             *   high level; e.g. an extension name).
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log
+             */
+            function logError(error: Error, topic?: `error.${string}`): void;
+        }
+    }
+}
+
+export {};
diff --git a/mw/experiments.d.ts b/mw/experiments.d.ts
index 2d09da8..91278ce 100644
--- a/mw/experiments.d.ts
+++ b/mw/experiments.d.ts
@@ -41,7 +41,6 @@ declare global {
              *     }
              * }
              * ```
-             *
              * @param {Experiment} experiment
              * @param {string} experiment.name The name of the experiment
              * @param {boolean} experiment.enabled Whether or not the experiment is
diff --git a/mw/global.d.ts b/mw/global.d.ts
index f4d3f94..f50fe43 100644
--- a/mw/global.d.ts
+++ b/mw/global.d.ts
@@ -28,6 +28,8 @@ declare global {
     function importScript(title: string): HTMLScriptElement | null;
 
     /**
+     * Import a script using an absolute URI.
+     *
      * @since 1.12.2
      * @param {string} url
      * @returns {HTMLScriptElement|null} Script tag, or null if it was already imported before
@@ -46,6 +48,8 @@ declare global {
     function importStylesheet(title: string): HTMLLinkElement;
 
     /**
+     * Import a stylesheet using an absolute URI.
+     *
      * @since 1.12.2
      * @param {string} url
      * @param {string} media
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
index 5e1e15c..e61d90f 100644
--- a/mw/hook.d.ts
+++ b/mw/hook.d.ts
@@ -28,19 +28,16 @@ import { User } from "./user";
  * This means if an event is fired, and a handler added afterwards, the added
  * function will be fired right away with the last given event data.
  *
- * Like Deferreds and Promises, the mw.hook object is both detachable and chainable.
+ * Like Deferreds and Promises, the {@link mw.hook} object is both detachable and chainable.
  * Thus allowing flexible use and optimal maintainability and authority control.
  * You can pass around the `add` and/or `fire` method to another piece of code
- * without it having to know the event name (or `mw.hook` for that matter).
+ * without it having to know the event name (or {@link mw.hook} for that matter).
  *
  * ```js
  * var h = mw.hook( 'bar.ready' );
  * new mw.Foo( .. ).fetch( { callback: h.fire } );
  * ```
  *
- * Note: Events are documented with an underscore instead of a dot in the event
- * name due to jsduck not supporting dots in that position.
- *
  * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
  */
 interface Hook<T extends any[] = any[]> {
@@ -48,6 +45,7 @@ interface Hook<T extends any[] = any[]> {
      * Register a hook handler.
      *
      * @param {...Function} handler Function to bind.
+     * @returns {Hook}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-add
      */
     add(...handler: Array<(...data: T) => any>): this;
@@ -55,7 +53,8 @@ interface Hook<T extends any[] = any[]> {
     /**
      * Call hook handlers with data.
      *
-     * @param {any} data
+     * @param {...any} data
+     * @returns {Hook}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-fire
      */
     fire(...data: T): this;
@@ -64,6 +63,7 @@ interface Hook<T extends any[] = any[]> {
      * Unregister a hook handler.
      *
      * @param {...Function} handler Function to unbind.
+     * @returns {Hook}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-remove
      */
     remove(...handler: Array<(...data: T) => any>): this;
@@ -108,7 +108,7 @@ declare global {
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
         function hook(
-            event: "apisandbox.formatRequest"
+            name: "apisandbox.formatRequest"
         ): Hook<
             [
                 items: OO.ui.MenuOptionWidget[],
@@ -124,14 +124,14 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "editRecovery.loadEnd"): Hook<[editRecovery: EditRecovery]>;
+        function hook(name: "editRecovery.loadEnd"): Hook<[editRecovery: EditRecovery]>;
 
         /**
          * Create an instance of mw.hook.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "htmlform.enhance"): Hook<[$root: JQuery]>;
+        function hook(name: "htmlform.enhance"): Hook<[$root: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired after an edit was successfully saved.
@@ -151,7 +151,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "postEdit"): Hook<[data?: PostEditData]>;
+        function hook(name: "postEdit"): Hook<[data?: PostEditData]>;
 
         /**
          * Create an instance of mw.hook, fired after the listener for #postEdit removes the notification.
@@ -159,14 +159,14 @@ declare global {
          * @deprecated
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "postEdit.afterRemoval"): Hook<[]>;
+        function hook(name: "postEdit.afterRemoval"): Hook<[]>;
 
         /**
          * Create an instance of mw.hook.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "prefs.search.buildIndex"): Hook<[index: SearchIndex]>;
+        function hook(name: "prefs.search.buildIndex"): Hook<[index: SearchIndex]>;
 
         /**
          * Create an instance of mw.hook, fired when a trusted UI element to perform a logout has been activated.
@@ -175,47 +175,43 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "skin.logout"): Hook<[href: string]>;
+        function hook(name: "skin.logout"): Hook<[href: string]>;
 
         /**
          * Create an instance of mw.hook, fired when initialization of the filtering interface for changes list is complete.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "structuredChangeFilters.ui.initialized"): Hook<[]>;
+        function hook(name: "structuredChangeFilters.ui.initialized"): Hook<[]>;
 
         /**
          * Create an instance of mw.hook, fired when a portlet is successfully created.
          *
-         * Example usage:
-         *
+         * @example
          * ```
          * mw.hook( 'util.addPortlet' ).add( ( p ) => {
-         *  p.style.border = 'solid 1px black';
+         *     p.style.border = 'solid 1px black';
          * } );
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
         function hook(
-            event: "util.addPortlet"
+            name: "util.addPortlet"
         ): Hook<[portlet: HTMLElement, before: string | undefined]>;
 
         /**
          * Create an instance of mw.hook, fired when a portlet link is successfully created.
          *
-         * Example usage:
-         *
+         * @example
          * ```
          * mw.hook( 'util.addPortletLink' ).add( ( link ) => {
-         *  const span = $( '<span class="icon">' );
-         *  link.appendChild( span );
+         *     const span = $( '<span class="icon">' );
+         *     link.appendChild( span );
          * } );
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "util.addPortletLink"): Hook<[item: HTMLLIElement, data: object]>;
+        function hook(name: "util.addPortletLink"): Hook<[item: HTMLLIElement, data: object]>;
 
         /**
          * Create an instance of mw.hook, fired when categories are being added to the DOM.
@@ -226,7 +222,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.categories"): Hook<[$content: JQuery]>;
+        function hook(name: "wikipage.categories"): Hook<[$content: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired after collapsible content has been initialized.
@@ -235,7 +231,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.collapsibleContent"): Hook<[$collapsible: JQuery]>;
+        function hook(name: "wikipage.collapsibleContent"): Hook<[$collapsible: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when wiki content has been added to the DOM.
@@ -246,7 +242,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.content"): Hook<[$content: JQuery]>;
+        function hook(name: "wikipage.content"): Hook<[$content: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when a diff is added to a page or dynamically displayed to the user.
@@ -255,7 +251,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.diff"): Hook<[$table: JQuery<HTMLTableElement>]>;
+        function hook(name: "wikipage.diff"): Hook<[$table: JQuery<HTMLTableElement>]>;
 
         /**
          * Create an instance of mw.hook.
@@ -263,7 +259,7 @@ declare global {
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
         function hook(
-            event: "wikipage.diff.diffTypeSwitch"
+            name: "wikipage.diff.diffTypeSwitch"
         ): Hook<[inlineToggleSwitch: OO.ui.ToggleSwitchWidget]>;
 
         /**
@@ -271,7 +267,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.diff.wikitextBodyUpdate"): Hook<[$wikitextDiffBody: JQuery]>;
+        function hook(name: "wikipage.diff.wikitextBodyUpdate"): Hook<[$wikitextDiffBody: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when the editform is added to the edit page.
@@ -280,45 +276,51 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.editform"): Hook<[$editForm: JQuery]>;
+        function hook(name: "wikipage.editform"): Hook<[$editForm: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when a page's {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Page_status_indicators status indicators} are being added to the DOM or updated.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.indicators"): Hook<[$indicators: JQuery]>;
+        function hook(name: "wikipage.indicators"): Hook<[$indicators: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when dynamic changes have been made to the table of contents.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
-        function hook(event: "wikipage.tableOfContents"): Hook<[sections: any[]]>;
+        function hook(name: "wikipage.tableOfContents"): Hook<[sections: any[]]>;
 
         /**
          * Create an instance of mw.hook, fired when the page watch status has changed.
          *
-         * Example usage:
-         *
+         * @example
          * ```js
          * mw.hook( 'wikipage.watchlistChange' ).add( ( isWatched, expiry, expirySelected ) => {
          *     // Do things
          * } );
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
          */
         function hook(
-            event: "wikipage.watchlistChange"
+            name: "wikipage.watchlistChange"
         ): Hook<[isWatched: boolean, expiry: string, expirySelected: string]>;
 
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
+         * @example
+         * ```js
+         * const hook = mw.hook( 'name' );
+         * hook.add( () => alert( 'Hook was fired' ) );
+         * hook.fire();
+         * ```
+         * @param {string} name Name of hook.
+         * @returns {Hook}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-hook
          */
-        function hook<T extends any[] = any[]>(event: string): Hook<T>;
+        function hook<T extends any[] = any[]>(name: string): Hook<T>;
     }
 }
 
diff --git a/mw/html.d.ts b/mw/html.d.ts
index 2ec8b5c..4df0934 100644
--- a/mw/html.d.ts
+++ b/mw/html.d.ts
@@ -1,7 +1,7 @@
 declare global {
     namespace mw {
         /**
-         * HTML construction helper functions
+         * HTML construction helper functions.
          *
          * @example
          * ```js
@@ -13,7 +13,6 @@ declare global {
          * ) );
          * mw.log( output ); // <div><img src="&lt;"/></div>
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html
          */
         namespace html {
@@ -41,11 +40,11 @@ declare global {
              *
              * Converts special characters to HTML entities.
              *
+             * @example
              * ```js
              * mw.html.escape( '< > \' & "' );
              * // Returns &lt; &gt; &#039; &amp; &quot;
              * ```
-             *
              * @param {string} s The string to escape
              * @returns {string} HTML
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html-method-escape
@@ -53,14 +52,22 @@ declare global {
             function escape(s: string): string;
 
             /**
-             * Wrapper object for raw HTML passed to {@link mw.html.element()}.
+             * Wrapper object for raw HTML. Can be used with {@link mw.html.element}.
              *
-             * @param {string} value
+             * @example
+             * ```js
+             * const raw = new mw.html.Raw( 'Text' );
+             * mw.html.element( 'div', { class: 'html' }, raw );
+             * ```
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html.Raw-method-constructor
              */
             class Raw<V extends string = string> {
+                value: V;
+
+                /**
+                 * @param {string} value
+                 */
                 constructor(value: V);
-                private value: V;
             }
         }
     }
diff --git a/mw/index.d.ts b/mw/index.d.ts
index 210d46d..7a19543 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -5,6 +5,7 @@ import "./confirmCloseWindow";
 import "./cookie";
 import "./debug";
 import "./deflate";
+import "./errorLogger";
 import "./ForeignApi";
 import "./ForeignRest";
 import "./ForeignUpload";
@@ -33,8 +34,14 @@ type ObjectAnalyticEventData = Record<string, any>;
 type AnalyticEventData = ObjectAnalyticEventData | number | string | undefined;
 
 interface ErrorAnalyticEventData extends ObjectAnalyticEventData {
-    exception?: any;
+    exception?: Error;
+    /**
+     * Name of module which caused the error.
+     */
     module?: string;
+    /**
+     * Error source.
+     */
     source: string;
 }
 
@@ -51,8 +58,6 @@ declare global {
     /**
      * Base library for MediaWiki.
      *
-     * Exposed globally as `mw`, with `mediaWiki` as alias.
-     *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw
      */
     const mediaWiki: typeof mw;
@@ -60,8 +65,6 @@ declare global {
     /**
      * Base library for MediaWiki.
      *
-     * Exposed globally as `mw`, with `mediaWiki` as alias.
-     *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw
      */
     namespace mw {
@@ -75,10 +78,22 @@ declare global {
         const libs: Record<string, any>;
 
         /**
-         * OOUI widgets specific to MediaWiki
+         * Store for templates associated with a module.
+         */
+        const templates: Map<Record<string, any>>;
+
+        /**
+         * OOUI widgets specific to MediaWiki.
+         * Initially empty. To expand the amount of available widgets the `mediawiki.widget` module can be loaded.
          *
          * types for mw.widgets are out of scope!
          *
+         * @example
+         * ```
+         * mw.loader.using('mediawiki.widget').then(() => {
+         *     OO.ui.getWindowManager().addWindows( [ new mw.widget.AbandonEditDialog() ] );
+         * });
+         * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.base.html#mw-property-libs
          */
         const widgets: any;
@@ -86,7 +101,7 @@ declare global {
         /**
          * Format a string. Replace $1, $2 ... $N with positional arguments.
          *
-         * Used by {@link Message.parser()}.
+         * Used by {@link mw.Message.parse}.
          *
          * @since 1.25
          * @param {string} formatString Format string
@@ -163,10 +178,13 @@ declare global {
         function track(topic: string, data?: AnalyticEventData): void;
 
         /**
-         * Track an early error event via mw.track and send it to the window console.
+         * Track `'resourceloader.exception'` event and send it to the window console.
+         *
+         * This exists for internal use by mw.loader only, to remember and buffer
+         * very early events for `mw.trackSubscribe( 'resourceloader.exception' )`
+         * even while `mediawiki.base` and `mw.track` are still in-flight.
          *
          * @private
-         * @param {string} topic Topic name
          * @param {ErrorAnalyticEventData} data Data describing the event, encoded as an object; see {@link errorLogger.logError}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackError
          */
@@ -180,18 +198,16 @@ declare global {
          * `data` event object. The `this` value for the callback is a plain object with `topic` and
          * `data` properties set to those same values.
          *
-         * Example to monitor all topics for debugging:
-         *
+         * @example
          * ```js
+         * // To monitor all topics for debugging
          * mw.trackSubscribe( '', console.log );
          * ```
-         *
-         * Example to subscribe to any of `foo.*`, e.g. both `foo.bar` and `foo.quux`:
-         *
+         * @example
          * ```js
+         * // To subscribe to any of `foo.*`, e.g. both `foo.bar` and `foo.quux`
          * mw.trackSubscribe( 'foo.', console.log );
          * ```
-         *
          * @param {string} topic Handle events whose name starts with this string prefix
          * @param {function(string, AnalyticEventData): void} callback Handler to call for each matching tracked event
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackSubscribe
@@ -199,7 +215,7 @@ declare global {
         function trackSubscribe(topic: string, callback: AnalyticEventCallback): void;
 
         /**
-         * Stop handling events for a particular handler
+         * Stop handling events for a particular handler.
          *
          * @param {function(string, AnalyticEventData): void} callback
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackUnsubscribe
diff --git a/mw/inspect.d.ts b/mw/inspect.d.ts
index 69895f9..021712e 100644
--- a/mw/inspect.d.ts
+++ b/mw/inspect.d.ts
@@ -77,14 +77,17 @@ interface Dependency {
 declare global {
     namespace mw {
         /**
-         * Generate and print reports.
+         * Generates a ResourceLoader report using the {@link mw.inspect mediawiki.inspect module}.
          *
          * When invoked without arguments, prints all available reports.
          *
-         * @param {...string} [reports] One or more of "size", "css", "store", or "time".
+         * @param {...string} [reports]
          */
         function inspect(...reports: ResourceLoaderReport[]): void;
 
+        /**
+         * Tools for inspecting page composition and performance.
+         */
         namespace inspect {
             /**
              * @private
diff --git a/mw/language.d.ts b/mw/language.d.ts
index 26784c6..cf5acd5 100644
--- a/mw/language.d.ts
+++ b/mw/language.d.ts
@@ -212,15 +212,15 @@ declare global {
                 const abbrev: string[];
 
                 /**
-                 * Object containing zero-indexed arrays of message keys for appropriate messages
-                 * which can be passed to {@link mw.msg}.
+                 * Array of month names in genitive case, zero-indexed.
                  */
-                const keys: Record<"abbrev" | "genitive" | "names", string[]>;
+                const genitive: string[];
 
                 /**
-                 * Array of month names in genitive case, zero-indexed.
+                 * Object containing zero-indexed arrays of message keys for appropriate messages
+                 * which can be passed to {@link mw.msg}.
                  */
-                const genitive: string[];
+                const keys: Record<"abbrev" | "genitive" | "names", string[]>;
 
                 /**
                  * Array of month names (in nominative case in languages which have the distinction),
diff --git a/mw/loader.d.ts b/mw/loader.d.ts
index 6932513..a43978b 100644
--- a/mw/loader.d.ts
+++ b/mw/loader.d.ts
@@ -30,8 +30,8 @@ interface ModuleRequire {
     /**
      * Get the exported value of a module.
      *
-     * @param moduleName Module name
-     * @returns Exported value
+     * @param {string} moduleName Module name
+     * @returns {any} Exported value
      */
     (moduleName: string): any;
 }
@@ -103,8 +103,7 @@ declare global {
             /**
              * Load a script by URL.
              *
-             * Example:
-             *
+             * @example
              * ```js
              * mw.loader.getScript(
              *     'https://example.org/x-1.0.0.js'
@@ -117,7 +116,6 @@ declare global {
              *     } );
              * } );
              * ```
-             *
              * @param {string} url Script URL
              * @returns {JQuery.Promise} Resolved when the script is loaded
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-getScript
@@ -136,6 +134,31 @@ declare global {
              *    uncaught error from the module's script files.
              * - `missing`: The module was requested but is not defined according to the server.
              *
+             * Internal mw.loader state machine:
+             *
+             * - `registered`:
+             *    The module is known to the system but not yet required.
+             *    Meta data is stored by mw.loader#register.
+             *    Calls to that method are generated server-side by StartupModule.
+             * - `loading`:
+             *    The module was required through mw.loader (either directly or as dependency of
+             *    another module). The client will fetch module contents from mw.loader.store
+             *    or from the server. The contents should later be received by mw.loader#implement.
+             * - `loaded`:
+             *    The module has been received by mw.loader#implement.
+             *    Once the module has no more dependencies in-flight, the module will be executed,
+             *    controlled via #setAndPropagate and #doPropagation.
+             * - `executing`:
+             *    The module is being executed (apply messages and stylesheets, execute scripts)
+             *    by mw.loader#execute.
+             * - `ready`:
+             *    The module has been successfully executed.
+             * - `error`:
+             *    The module (or one of its dependencies) produced an uncaught error during execution.
+             * - `missing`:
+             *    The module was registered client-side and requested, but the server denied knowledge
+             *    of the module's existence.
+             *
              * @param {string} module Name of module
              * @returns {string|null} The state, or null if the module (or its state) is not
              *  in the registry.
@@ -143,87 +166,6 @@ declare global {
              */
             function getState(module: string): ModuleState | null;
 
-            /**
-             * Implement a module given a function which returns the components of the module
-             *
-             * @param {Function} declarator
-             *
-             * The declarator should return an array with the following keys:
-             *
-             * - 0. {string} module Name of module and current module version. Formatted
-             *   as '`[name]@[version]`". This version should match the requested version
-             *   (from #batchRequest and #registry). This avoids race conditions (T117587).
-             *
-             * - 1. {ModuleScript} [script] Module code. This can be a function,
-             *   a list of URLs to load via `<script src>`, a string for `globalEval()`, or an
-             *   object like {"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}.
-             *   If an object is provided, the main file will be executed immediately, and the other
-             *   files will only be executed if loaded via require(). If a function or string is
-             *   provided, it will be executed/evaluated immediately. If an array is provided, all
-             *   URLs in the array will be loaded immediately, and executed as soon as they arrive.
-             *
-             * - 2. {ModuleStyle} [style] Should follow one of the following patterns:
-             *
-             *   ```js
-             *   { "css": [css, ..] }
-             *   { "url": { (media): [url, ..] } }
-             *   ```
-             *
-             *   The reason css strings are not concatenated anymore is T33676. We now check
-             *   whether it's safe to extend the stylesheet.
-             *
-             * - 3. {ModuleMessages} [messages] List of key/value pairs to be added to {@link mw.messages}.
-             * - 4. {ModuleTemplates} [templates] List of key/value pairs to be added to {@link mw.templates}.
-             * - 5. {String|null} [deprecationWarning] Deprecation warning if any
-             *
-             * The declarator must not use any scope variables, since it will be serialized with
-             * {@link Function.prototype.toString()} and later restored and executed in the global scope.
-             *
-             * The elements are all optional except the name.
-             */
-            function impl(declarator: ModuleDeclarator): void;
-
-            /**
-             * Implement a module given the components of the module.
-             *
-             * See {@link impl} for a full description of the parameters.
-             *
-             * Prior to MW 1.41, this was used internally, but now it is only kept
-             * for backwards compatibility.
-             *
-             * Does not support mw.loader.store caching.
-             *
-             * @param {string} module
-             * @param {ModuleScript} [script] Module code. This can be a function,
-             *  a list of URLs to load via `<script src>`, a string for `domEval()`, or an
-             *  object like {"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}.
-             *  If an object is provided, the main file will be executed immediately, and the other
-             *  files will only be executed if loaded via require(). If a function or string is
-             *  provided, it will be executed/evaluated immediately. If an array is provided, all
-             *  URLs in the array will be loaded immediately, and executed as soon as they arrive.
-             * @param {ModuleStyle} [style] Should follow one of the following patterns:
-             *
-             * ```js
-             * { "css": [css, ..] }
-             * { "url": { <media>: [url, ..] } }
-             * ```
-             *
-             * The reason css strings are not concatenated anymore is T33676. We now check
-             * whether it's safe to extend the stylesheet.
-             * @param {ModuleMessages} [messages] List of key/value pairs to be added to {@link mw.messages}.
-             * @param {ModuleTemplates} [templates] List of key/value pairs to be added to {@link mw.templates}.
-             * @param {string|null} [deprecationWarning] Deprecation warning if any
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-implement
-             */
-            function implement(
-                module: string,
-                script?: ModuleScript,
-                style?: ModuleStyle,
-                messages?: ModuleMessages,
-                templates?: ModuleTemplates,
-                deprecationWarning?: string | null
-            ): void;
-
             /**
              * Load an external script or one or more modules.
              *
@@ -246,54 +188,6 @@ declare global {
              */
             function load(modules: string | string[], type?: "text/css" | "text/javascript"): void;
 
-            /**
-             * Register a module, letting the system know about it and its properties.
-             *
-             * The startup module calls this method.
-             *
-             * When using multiple module registration by passing an array, dependencies that
-             * are specified as references to modules within the array will be resolved before
-             * the modules are registered.
-             *
-             * @param {string|Array} modules Module name or array of arrays, each containing
-             *  a list of arguments compatible with this method
-             * @param {string|number} [version] Module version hash (falls backs to empty string)
-             *  Can also be a number (timestamp) for compatibility with MediaWiki 1.25 and earlier.
-             * @param {string[]} [dependencies] Array of module names on which this module depends.
-             * @param {string} [group=null] Group which the module is in
-             * @param {string} [source='local'] Name of the source
-             * @param {string} [skip=null] Script body of the skip function
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-register
-             */
-            function register(
-                modules: string,
-                version?: string | number,
-                dependencies?: string[],
-                group?: string | null,
-                source?: string,
-                skip?: string | null
-            ): void;
-            function register(
-                modules: Array<
-                    [
-                        module: string,
-                        version?: string | number,
-                        dependencies?: Array<string | number>,
-                        group?: string | null,
-                        source?: string,
-                        skip?: string | null
-                    ]
-                >
-            ): void;
-
-            /**
-             * Change the state of one or more modules.
-             *
-             * @param {Object.<string, ModuleState>} states Object of module name/state pairs
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-state
-             */
-            function state(states: Record<string, ModuleState>): void;
-
             /**
              * Execute a function after one or more modules are ready.
              *
@@ -391,6 +285,21 @@ declare global {
                 modules?: string[]
             ): HTMLScriptElement;
 
+            /**
+             * Register a source.
+             *
+             * The {@link work()} method will use this information to split up requests by source.
+             *
+             * @example
+             * ```
+             * mw.loader.addSource( { mediawikiwiki: 'https://www.mediawiki.org/w/load.php' } );
+             * ```
+             * @private
+             * @param {Object.<string, string>} ids An object mapping ids to load.php end point urls
+             * @throws {Error} If source id is already registered
+             */
+            function addSource(ids: Record<string, string>): void;
+
             /**
              * Add one or more modules to the module load queue.
              *
@@ -408,6 +317,128 @@ declare global {
                 error?: (error: Error, ...args: any[]) => void
             ): void;
 
+            /**
+             * Implement a module given a function which returns the components of the module
+             *
+             * @private
+             * @param {Function} declarator The declarator should return an array with the following keys:
+             *
+             * - 0. {string} module Name of module and current module version. Formatted
+             *   as '`[name]@[version]`". This version should match the requested version
+             *   (from #batchRequest and #registry). This avoids race conditions (T117587).
+             *
+             * - 1. {ModuleScript} [script] Module code. This can be a function,
+             *   a list of URLs to load via `<script src>`, a string for `globalEval()`, or an
+             *   object like {"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}.
+             *   If an object is provided, the main file will be executed immediately, and the other
+             *   files will only be executed if loaded via require(). If a function or string is
+             *   provided, it will be executed/evaluated immediately. If an array is provided, all
+             *   URLs in the array will be loaded immediately, and executed as soon as they arrive.
+             *
+             * - 2. {ModuleStyle} [style] Should follow one of the following patterns:
+             *
+             *   ```js
+             *   { "css": [css, ..] }
+             *   { "url": { (media): [url, ..] } }
+             *   ```
+             *
+             *   The reason css strings are not concatenated anymore is T33676. We now check
+             *   whether it's safe to extend the stylesheet.
+             *
+             * - 3. {ModuleMessages} [messages] List of key/value pairs to be added to {@link mw.messages}.
+             * - 4. {ModuleTemplates} [templates] List of key/value pairs to be added to {@link mw.templates}.
+             * - 5. {String|null} [deprecationWarning] Deprecation warning if any
+             *
+             * The declarator must not use any scope variables, since it will be serialized with
+             * {@link Function.prototype.toString()} and later restored and executed in the global scope.
+             *
+             * The elements are all optional except the name.
+             */
+            function impl(declarator: ModuleDeclarator): void;
+
+            /**
+             * Implement a module given the components of the module.
+             *
+             * See {@link impl} for a full description of the parameters.
+             *
+             * Prior to MW 1.41, this was used internally, but now it is only kept
+             * for backwards compatibility.
+             *
+             * Does not support mw.loader.store caching.
+             *
+             * @private
+             * @param {string} module
+             * @param {ModuleScript} [script] Module code. This can be a function,
+             *  a list of URLs to load via `<script src>`, a string for `domEval()`, or an
+             *  object like {"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}.
+             *  If an object is provided, the main file will be executed immediately, and the other
+             *  files will only be executed if loaded via require(). If a function or string is
+             *  provided, it will be executed/evaluated immediately. If an array is provided, all
+             *  URLs in the array will be loaded immediately, and executed as soon as they arrive.
+             * @param {ModuleStyle} [style] Should follow one of the following patterns:
+             *
+             * ```js
+             * { "css": [css, ..] }
+             * { "url": { <media>: [url, ..] } }
+             * ```
+             *
+             * The reason css strings are not concatenated anymore is T33676. We now check
+             * whether it's safe to extend the stylesheet.
+             * @param {ModuleMessages} [messages] List of key/value pairs to be added to {@link mw.messages}.
+             * @param {ModuleTemplates} [templates] List of key/value pairs to be added to {@link mw.templates}.
+             * @param {string|null} [deprecationWarning] Deprecation warning if any
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-implement
+             */
+            function implement(
+                module: string,
+                script?: ModuleScript,
+                style?: ModuleStyle,
+                messages?: ModuleMessages,
+                templates?: ModuleTemplates,
+                deprecationWarning?: string | null
+            ): void;
+
+            /**
+             * Register a module, letting the system know about it and its properties.
+             *
+             * The startup module calls this method.
+             *
+             * When using multiple module registration by passing an array, dependencies that
+             * are specified as references to modules within the array will be resolved before
+             * the modules are registered.
+             *
+             * @private
+             * @param {string|Array} modules Module name or array of arrays, each containing
+             *  a list of arguments compatible with this method
+             * @param {string|number} [version] Module version hash (falls backs to empty string)
+             *  Can also be a number (timestamp) for compatibility with MediaWiki 1.25 and earlier.
+             * @param {string[]} [dependencies] Array of module names on which this module depends.
+             * @param {string} [group=null] Group which the module is in
+             * @param {string} [source='local'] Name of the source
+             * @param {string} [skip=null] Script body of the skip function
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-register
+             */
+            function register(
+                modules: string,
+                version?: string | number,
+                dependencies?: string[],
+                group?: string | null,
+                source?: string,
+                skip?: string | null
+            ): void;
+            function register(
+                modules: Array<
+                    [
+                        module: string,
+                        version?: string | number,
+                        dependencies?: Array<string | number>,
+                        group?: string | null,
+                        source?: string,
+                        skip?: string | null
+                    ]
+                >
+            ): void;
+
             /**
              * Get the exported value of a module.
              *
@@ -436,6 +467,15 @@ declare global {
             // note: U is required so T is not inferred from the "modules" argument
             function resolve<T extends string, U extends T = T>(modules: U[]): T[];
 
+            /**
+             * Change the state of one or more modules.
+             *
+             * @private
+             * @param {Object.<string, ModuleState>} states Object of module name/state pairs
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-state
+             */
+            function state(states: Record<string, ModuleState>): void;
+
             /**
              * Start loading of all queued module dependencies.
              *
@@ -452,7 +492,6 @@ declare global {
                  * The localStorage key for the entire module store. The key references
                  * $wgDBname to prevent clashes between wikis which share a common host.
                  *
-                 * @property {string}
                  * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-property-key
                  */
                 const key: string;
@@ -462,7 +501,6 @@ declare global {
                  *
                  * Defined by ResourceLoader\StartupModule::getStoreVary() in PHP.
                  *
-                 * @property {string}
                  * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-property-vary
                  */
                 const vary: string;
diff --git a/mw/log.d.ts b/mw/log.d.ts
index 3fc05a0..5f6aaf8 100644
--- a/mw/log.d.ts
+++ b/mw/log.d.ts
@@ -1,19 +1,5 @@
 declare global {
     namespace mw {
-        namespace errorLogger {
-            /**
-             * Logs an error by notifying subscribers to the given {@link mw.track()} topic
-             * (by default `error.caught`) that an event has occurred.
-             *
-             * @param {Error} error
-             * @param {string} [topic='error.caught'] Error topic. Conventionally in the form
-             *   'error.?component?' (where ?component? identifies the code logging the error at a
-             *   high level; e.g. an extension name).
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log
-             */
-            function logError(error: Error, topic?: `error.${string}`): void;
-        }
-
         /**
          * Write a verbose message to the browser's console in debug mode.
          *
@@ -28,7 +14,7 @@ declare global {
         function log(...msg: any[]): void;
 
         /**
-         * Collection of methods to help log messages to the console.
+         * Library for logging developer warnings to the JavaScript console.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log
          */
@@ -37,14 +23,14 @@ declare global {
              * Create a property on a host object that, when accessed, will log
              * a deprecation warning to the console.
              *
-             * Usage:
-             *
+             * @example
              * ```js
              * mw.log.deprecate( window, 'myGlobalFn', myGlobalFn );
-             *
+             * ```
+             * @example
+             * ```js
              * mw.log.deprecate( Thing, 'old', old, 'Use Other.thing instead', 'Thing.old'  );
              * ```
-             *
              * @param {Object} obj Host object of deprecated property
              * @param {string} key Name of property to create in `obj`
              * @param {any} val The value this property should return when accessed
@@ -76,8 +62,7 @@ declare global {
             /**
              * Create a function that logs a deprecation warning when called.
              *
-             * Usage:
-             *
+             * @example
              * ```js
              * var deprecatedNoB = mw.log.makeDeprecated( 'hello_without_b', 'Use of hello without b is deprecated.' );
              *
@@ -91,7 +76,6 @@ declare global {
              *
              * hello( 1 );
              * ```
-             *
              * @since 1.38
              * @param {string|null} key Name of the feature for deprecation tracker,
              *  or null for a console-only deprecation.
diff --git a/mw/message.d.ts b/mw/message.d.ts
index 0ef9735..cf71da5 100644
--- a/mw/message.d.ts
+++ b/mw/message.d.ts
@@ -20,9 +20,7 @@ declare global {
         const messages: Map<{ [key: string]: string }>;
 
         /**
-         * Object constructor for messages.
-         *
-         * Similar to the Message class in MediaWiki PHP.
+         * Describes a translateable text or HTML string. Similar to the Message class in MediaWiki PHP.
          *
          * @example
          * ```js
@@ -60,14 +58,12 @@ declare global {
          * mw.log( obj.escaped() );
          * // You will find: Time &quot;after&quot; &lt;time&gt;
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message
          */
         class Message {
             /**
              * Object constructor for messages.
-             *
-             * Similar to the Message class in MediaWiki PHP.
+             * The constructor is not publicly accessible; use {@link mw.message} instead.
              *
              * @example
              * ```js
@@ -105,7 +101,6 @@ declare global {
              * mw.log( obj.escaped() );
              * // You will find: Time &quot;after&quot; &lt;time&gt;
              * ```
-             *
              * @param {Map} map Message store
              * @param {string} key
              * @param {Array} [parameters]
@@ -124,7 +119,7 @@ declare global {
             escaped(): string;
 
             /**
-             * Check if a message exists
+             * Check if a message exists. Equivalent to {@link mw.Map.exists}.
              *
              * @returns {boolean}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-exists
@@ -173,22 +168,6 @@ declare global {
              */
             parseDom(): JQuery;
 
-            /**
-             * Get parsed contents of the message.
-             *
-             * The default parser does simple $N replacements and nothing else.
-             * This may be overridden to provide a more complex message parser.
-             * The primary override is in the mediawiki.jqueryMsg module.
-             *
-             * This function will not be called for nonexistent messages.
-             *
-             * @private For internal use by mediawiki.jqueryMsg only
-             * @param {string} format
-             * @returns {string} Parsed message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-parser
-             */
-            private parser(format: string): string;
-
             /**
              * Return message plainly.
              *
@@ -212,6 +191,22 @@ declare global {
              */
             text(): string;
 
+            /**
+             * Get parsed contents of the message.
+             *
+             * The default parser does simple $N replacements and nothing else.
+             * This may be overridden to provide a more complex message parser.
+             * The primary override is in the mediawiki.jqueryMsg module.
+             *
+             * This function will not be called for nonexistent messages.
+             *
+             * @private For internal use by mediawiki.jqueryMsg only
+             * @param {string} format
+             * @returns {string} Parsed message
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-parser
+             */
+            private parser(format: string): string;
+
             /**
              * Convert message object to a string using the "text"-format .
              *
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 0d18a18..5e17ec5 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -1,60 +1,9 @@
-interface NotificationOptions {
-    /**
-     * A boolean indicating whether the notification should automatically
-     * be hidden after shown. Or if it should persist.
-     */
-    autoHide: boolean;
-
-    /**
-     * Key to {@link mw.notification.autoHideSeconds} for number of seconds for timeout of auto-hide
-     * notifications.
-     */
-    autoHideSeconds: "long" | "short";
-
-    /**
-     * An optional string. When a notification is tagged only one message
-     * with that tag will be displayed. Trying to display a new notification
-     * with the same tag as one already being displayed will cause the other
-     * notification to be closed and this new notification to open up inside
-     * the same place as the previous notification.
-     */
-    tag: string | null;
-
-    /**
-     * An optional title for the notification. Will be displayed above the
-     * content. Usually in bold.
-     */
-    title: string | null;
-
-    /**
-     * An optional string for the type of the message used for styling:
-     * Examples: 'info', 'warn', 'error', 'success'.
-     */
-    type: "error" | "info" | "success" | "warn" | null;
-
-    /**
-     * A boolean indicating if the autoHide timeout should be based on
-     * time the page was visible to user. Or if it should use wall clock time.
-     */
-    visibleTimeout: boolean;
-
-    /**
-     * HTML ID to set on the notification element.
-     */
-    id: string | false;
-
-    /**
-     * CSS class names in the form of a single string or
-     * array of strings, to be set on the notification element.
-     */
-    classes: string | string[] | false;
-}
-
 /**
- * A Notification object for 1 message.
+ * Describes a notification. See {@link mw.notification mw.notification module}. A Notification object for 1 message.
  *
  * The constructor is not publicly accessible; use {@link mw.notification.notify} instead.
- * This does not insert anything into the document (see {@link start}).
+ * This does not insert anything into the document. To add to document use
+ * {@link mw.notification.notify}.
  *
  * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_
  */
@@ -77,7 +26,7 @@ interface Notification {
     close(): void;
 
     /**
-     * Pause any running auto-hide timer for this notification
+     * Pause any running auto-hide timer for this notification.
      *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_-method-pause
      */
@@ -108,11 +57,11 @@ interface Notification {
 declare global {
     namespace mw {
         /**
-         * Display a notification message to the user.
+         * Convenience method for loading and accessing the {@link mw.notification.notify mw.notification module}.
          *
          * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
          * @param {Partial<NotificationOptions>} [options] The options to use for the notification.
-         *  See {@link NotificationOptions defaults} for details.
+         *  See {@link defaults} the defaults.
          * @returns {JQuery.Promise<Notification>} Notification object
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-notify
          */
@@ -122,6 +71,8 @@ declare global {
         ): JQuery.Promise<Notification>;
 
         /**
+         * Library for sending notifications to end users.
+         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification
          */
         namespace notification {
@@ -148,7 +99,7 @@ declare global {
             };
 
             /**
-             * The defaults for notify options parameter.
+             * The defaults for {@link notify} options parameter.
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-property-defaults
              */
@@ -174,15 +125,66 @@ declare global {
              * Display a notification message to the user.
              *
              * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
-             * @param {Partial<NotificationOptions>} [options] The options to use for the notification.
-             *  See {@link NotificationOptions defaults} for details.
+             * @param {NotificationOptions} [options] The options to use for the notification.
+             *  Options not specified default to the values in {@link defaults}.
              * @returns {Notification} Notification object
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-method-notify
              */
             function notify(
                 message: string | Message | JQuery | HTMLElement | HTMLElement[],
-                options?: Partial<NotificationOptions>
+                options?: NotificationOptions
             ): Notification;
+
+            interface NotificationOptions {
+                /**
+                 * Whether the notification should automatically
+                 * be hidden after shown. Or if it should persist.
+                 */
+                autoHide?: boolean;
+
+                /**
+                 * Key to {@link autoHideSeconds} for number of seconds for timeout of auto-hide
+                 * notifications.
+                 */
+                autoHideSeconds?: "long" | "short";
+
+                /**
+                 * CSS class names to be set on the notification element.
+                 */
+                classes?: string | string[] | false;
+
+                /**
+                 * HTML ID to set on the notification element.
+                 */
+                id?: string | false;
+
+                /**
+                 * An optional string. When a notification is tagged only one message
+                 * with that tag will be displayed. Trying to display a new notification
+                 * with the same tag as one already being displayed will cause the other
+                 * notification to be closed and this new notification to open up inside
+                 * the same place as the previous notification.
+                 */
+                tag?: string | null;
+
+                /**
+                 * An optional title for the notification. Will be displayed above the
+                 * content. Usually in bold.
+                 */
+                title?: string | null;
+
+                /**
+                 * An optional string for the type of the message used for styling.
+                 * Examples: `info`, `warn`, `error`, `success`.
+                 */
+                type?: "error" | "info" | "success" | "warn" | null;
+
+                /**
+                 * A boolean indicating if the autoHide timeout should be based on
+                 * time the page was visible to user. Or if it should use wall clock time.
+                 */
+                visibleTimeout?: boolean;
+            }
         }
     }
 }
diff --git a/mw/searchSuggest.d.ts b/mw/searchSuggest.d.ts
index 68c31c6..b5b3b49 100644
--- a/mw/searchSuggest.d.ts
+++ b/mw/searchSuggest.d.ts
@@ -1,23 +1,60 @@
 import { ApiResponse } from "./Api";
 
-interface ResultInfo {
-    type: string;
-    searchId: string;
+interface ResponseFunction {
+    /**
+     * @param {string[]} titles titles of pages that match search
+     * @param {ResponseMetaData} meta meta data relating to search
+     */
+    (titles: string[], meta: ResponseMetaData): void;
+}
+
+interface ResponseMetaData {
     query: string;
+    /**
+     * The contents of the X-Search-ID response header.
+     */
+    searchId: string;
+    /**
+     * The contents of the X-OpenSearch-Type response header.
+     */
+    type: string;
 }
 
 declare global {
-    namespace mw.searchSuggest {
+    namespace mw {
         /**
-         * Queries the wiki and calls response with the result.
+         * Convenience library for making searches for titles that match a string.
+         * Loaded via the `mediawiki.searchSuggest` ResourceLoader library.
+         *
+         * @example
+         * ```
+         * mw.loader.using('mediawiki.searchSuggest').then(() => {
+         *     var api = new mw.Api();
+         *     mw.searchSuggest.request(api, 'Dogs that', ( results ) => {
+         *         alert( `Results that match: ${results.join( '\n' );}` );
+         *     });
+         * });
+         * ```
          */
-        function request(
-            api: Api,
-            query: string,
-            response: (result: string[], info: ResultInfo) => void,
-            maxRows?: number | "max",
-            namespace?: number | number[]
-        ): JQuery.Promise<ApiResponse>;
+        namespace searchSuggest {
+            /**
+             * Queries the wiki and calls response with the result.
+             *
+             * @param {Api} api
+             * @param {string} query
+             * @param {ResponseFunction} response
+             * @param {string|number} [limit]
+             * @param {string|number|string[]|number[]} [namespace]
+             * @returns {JQuery.Promise<ApiResponse>}
+             */
+            function request(
+                api: Api,
+                query: string,
+                response: ResponseFunction,
+                limit?: number | "max",
+                namespace?: number | number[]
+            ): JQuery.Promise<ApiResponse>;
+        }
     }
 }
 
diff --git a/mw/storage.d.ts b/mw/storage.d.ts
index 7a68de7..b167e9c 100644
--- a/mw/storage.d.ts
+++ b/mw/storage.d.ts
@@ -2,7 +2,9 @@
  * A wrapper for the HTML5 Storage interface (`localStorage` or `sessionStorage`)
  * that is safe to call in all browsers.
  *
- * @private
+ * The constructor is not publicly accessible. An instance can be accessed from
+ * {@link mw.storage} or {@link module:mediawiki.storage}.
+ *
  * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage
  */
 interface SafeStorage {
@@ -47,7 +49,7 @@ interface SafeStorage {
     set(key: string, value: string, expiry?: number): boolean;
 
     /**
-     * Set the expiry time for an item in the store
+     * Set the expiry time for an item in the store.
      *
      * @param {string} key Key name
      * @param {number} [expiry] Number of seconds after which this item can be deleted,
@@ -59,7 +61,7 @@ interface SafeStorage {
     setExpires(key: string, expiry?: number): boolean;
 
     /**
-     * Set an object value in device storage by JSON encoding
+     * Set an object value in device storage by JSON encoding.
      *
      * @param {string} key Key name to store under
      * @param {Object} value Object value to be stored
@@ -70,7 +72,7 @@ interface SafeStorage {
     setObject(key: string, value: any, expiry?: number): boolean;
 
     /**
-     * Clear any expired items from the store
+     * Clear any expired items from the store.
      *
      * @private
      * @returns {JQuery.Promise} Resolves when items have been expired
@@ -79,7 +81,7 @@ interface SafeStorage {
     clearExpired(): JQuery.Promise<undefined>;
 
     /**
-     * Get all keys with expiry values
+     * Get all keys with expiry values.
      *
      * @private
      * @returns {JQuery.Promise<string[]>} Promise resolving with all the keys which have
@@ -89,7 +91,7 @@ interface SafeStorage {
     getExpiryKeys(): JQuery.Promise<string[]>;
 
     /**
-     * Check if a given key has expired
+     * Check if a given key has expired.
      *
      * @private
      * @param {string} key Key name
@@ -101,30 +103,40 @@ interface SafeStorage {
 
 interface MwStorage extends SafeStorage {
     /**
-     * A safe interface to HTML5 `sessionStorage`.
+     * A safe interface to HTML5 `localStorage` and `sessionStorage`.
      *
      * This normalises differences across browsers and silences any and all
      * exceptions that may occur.
      *
-     * **Note**: Data persisted via `sessionStorage` will persist for the lifetime
-     * of the browser *tab*, not the browser *window*.
-     * For longer-lasting persistence across tabs, refer to {@link mw.storage} or {@link mw.cookie} instead.
-     *
-     * Example:
-     *
+     * **Note**: Storage keys are not automatically prefixed in relation to
+     * MediaWiki and/or the current wiki. Always **prefix your keys** with "mw" to
+     * avoid conflicts with gadgets, JavaScript libraries, browser extensions,
+     * internal CDN or webserver cookies, and third-party applications that may
+     * be embedded on the page.
+     *
+     * **Warning**: This API has limited storage space and does not use an expiry
+     * by default. This means unused **keys are stored forever**, unless you
+     * opt-in to the `expiry` parameter or otherwise make sure that your code
+     * can rediscover and delete keys you created in the past.
+     *
+     * If you don't use the `expiry` parameter, avoid keys with variable
+     * components as this leads to untracked keys that your code has no way
+     * to know about and delete when the data is no longer needed. Instead,
+     * store dynamic values in an object under a single constant key that you
+     * manage or replace over time.
+     * See also <https://phabricator.wikimedia.org/T121646>.
+     *
+     * @example
      * ```js
      * mw.storage.session.set( key, value );
      * mw.storage.session.get( key );
      * ```
-     *
-     * Example:
-     *
+     * @example
      * ```js
      * var session = require( 'mediawiki.storage' ).session;
      * session.set( key, value );
      * session.get( key );
      * ```
-     *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.storage.session
      */
     session: SafeStorage;
@@ -133,7 +145,7 @@ interface MwStorage extends SafeStorage {
 declare global {
     namespace mw {
         /**
-         * A safe interface to HTML5 `localStorage`.
+         * A safe interface to HTML5 `localStorage` and `sessionStorage`.
          *
          * This normalises differences across browsers and silences any and all
          * exceptions that may occur.
@@ -156,22 +168,18 @@ declare global {
          * manage or replace over time.
          * See also <https://phabricator.wikimedia.org/T121646>.
          *
-         * Example:
-         *
+         * @example
          * ```js
          * mw.storage.set( key, value, expiry );
          * mw.storage.set( key, value ); // stored indefinitely
          * mw.storage.get( key );
          * ```
-         *
-         * Example:
-         *
+         * @example
          * ```js
          * var local = require( 'mediawiki.storage' ).local;
          * local.set( key, value, expiry );
          * local.get( key );
          * ```
-         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.storage
          */
         const storage: MwStorage;
diff --git a/mw/template.d.ts b/mw/template.d.ts
index 20a197f..b2981dd 100644
--- a/mw/template.d.ts
+++ b/mw/template.d.ts
@@ -7,7 +7,7 @@ interface Compiler {
 declare global {
     namespace mw {
         /**
-         * Requires mediawiki.template ResourceLoader module
+         * Requires `mediawiki.template` ResourceLoader module.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template
          */
diff --git a/mw/user.d.ts b/mw/user.d.ts
index 1fa6757..f946eae 100644
--- a/mw/user.d.ts
+++ b/mw/user.d.ts
@@ -1,14 +1,3 @@
-export interface UserInfo {
-    /**
-     * User groups that the user belongs to
-     */
-    groups: string[];
-    /**
-     * User's rights
-     */
-    rights: string[];
-}
-
 interface UserTokens extends Record<string, string> {
     csrfToken: string;
     patrolToken: string;
@@ -17,7 +6,7 @@ interface UserTokens extends Record<string, string> {
 
 export interface User {
     /**
-     * Manage client preferences
+     * Manage client preferences.
      *
      * For skins that enable the `clientPrefEnabled` option (see Skin class in PHP),
      * this feature allows you to store preferences in the browser session that will
@@ -28,31 +17,31 @@ export interface User {
      * and swap class names server-side through the Skin interface.
      *
      * This feature is limited to page views by unregistered users. For logged-in requests,
-     * store preferences in the database instead, via UserOptionsManager or mw.Api#saveOption
+     * store preferences in the database instead, via UserOptionsManager or {@link mw.Api.saveOption}
      * (may be hidden or API-only to exclude from Special:Preferences), and then include the
      * desired classes directly in Skin::getHtmlElementAttributes.
      *
      * Classes toggled by this feature must be named as `<feature>-clientpref-<value>`,
-     * where `value` contains only alphanumerical characters (a-zA-Z0-9), and `feature`
+     * where `value` contains only alphanumerical characters (a-z, A-Z, and 0-9), and `feature`
      * can also include hyphens.
      */
     clientPrefs: {
         /**
-         * Retrieve the current value of the feature from the HTML document element
+         * Retrieve the current value of the feature from the HTML document element.
          *
          * @param {string} feature
-         * @return {false|string} returns false if the feature is not recognized.
+         * @returns {false|string} returns false if the feature is not recognized.
          *   returns string if a feature was found.
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user.clientPrefs-method-get
          */
         get(feature: string): false | string;
 
         /**
-         * Change the class on the HTML document element, and save the value in a cookie
+         * Change the class on the HTML document element, and save the value in a cookie.
          *
          * @param {string} feature
          * @param {string} value
-         * @return {boolean} True if feature was stored successfully, false if the value
+         * @returns {boolean} True if feature was stored successfully, false if the value
          *   uses a forbidden character or the feature is not recognised
          *   e.g. a matching class was not defined on the HTML document element.
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user.clientPrefs-method-set
@@ -61,12 +50,16 @@ export interface User {
     };
 
     /**
+     * Map of user preferences and their values.
+     *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-property-options
      */
     // TODO: add types for items in the options map
     options: mw.Map;
 
     /**
+     * Map of retrieved user tokens.
+     *
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-property-tokens
      */
     tokens: mw.Map<UserTokens>;
@@ -93,8 +86,8 @@ export interface User {
      * session or series of sessions. Its uniqueness should not be depended on unless the
      * browser supports the crypto API.
      *
-     * Known problems with Math.random():
-     * Using the Math.random function we have seen sets
+     * Known problems with {@link Math.random()}:
+     * Using the `Math.random` function we have seen sets
      * with 1% of non uniques among 200,000 values with Safari providing most of these.
      * Given the prevalence of Safari in mobile the percentage of duplicates in
      * mobile usages of this code is probably higher.
@@ -103,8 +96,9 @@ export interface User {
      * We need about 80 bits to make sure that probability of collision
      * on 155 billion  is <= 1%
      *
-     * See https://en.wikipedia.org/wiki/Birthday_attack#Mathematics
-     * n(p;H) = n(0.01,2^80)= sqrt (2 * 2^80 * ln(1/(1-0.01)))
+     * See {@link https://en.wikipedia.org/wiki/Birthday_attack#Mathematics}
+     *
+     * `n(p;H) = n(0.01,2^80)= sqrt (2 * 2^80 * ln(1/(1-0.01)))`
      *
      * @returns {string} 80 bit integer (20 characters) in hex format, padded
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-generateRandomSessionId
@@ -112,7 +106,16 @@ export interface User {
     generateRandomSessionId(): string;
 
     /**
-     * Get the current user's groups
+     * Get date user first registered, if available.
+     *
+     * @return {false|null|Date} False for anonymous users, null if data is
+     *  unavailable, or Date for when the user registered. For temporary users
+     *  that is when their temporary account was created.
+     */
+    getFirstRegistration(): false | null | Date;
+
+    /**
+     * Get the current user's groups.
      *
      * @param {Function} [callback]
      * @returns {JQuery.Promise<string[]>}
@@ -122,7 +125,7 @@ export interface User {
     getGroups(): JQuery.Promise<string[]>;
 
     /**
-     * Get the current user's database id
+     * Get the current user's database id.
      *
      * Not to be confused with {@link id}.
      *
@@ -132,7 +135,7 @@ export interface User {
     getId(): number;
 
     /**
-     * Get the current user's name
+     * Get the current user's name.
      *
      * @returns {string|null} User name string or null if user is anonymous
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getName
@@ -150,7 +153,7 @@ export interface User {
     getPageviewToken(): string;
 
     /**
-     * Get date user registered, if available
+     * Get date user registered, if available.
      *
      * @returns {false|null|Date} False for anonymous users, null if data is
      *  unavailable, or Date for when the user registered.
@@ -159,7 +162,7 @@ export interface User {
     getRegistration(): false | null | Date;
 
     /**
-     * Get the current user's rights
+     * Get the current user's rights.
      *
      * @param {Function} [callback]
      * @returns {JQuery.Promise<string[]>}
@@ -169,7 +172,7 @@ export interface User {
     getRights(): JQuery.Promise<string[]>;
 
     /**
-     * Get the current user's name or the session ID
+     * Get the current user's name or the session ID.
      *
      * Not to be confused with {@link getId}.
      *
@@ -179,7 +182,7 @@ export interface User {
     id(): string;
 
     /**
-     * Whether the current user is anonymous
+     * Check whether the current user is anonymous.
      *
      * @returns {boolean}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isAnon
@@ -187,7 +190,7 @@ export interface User {
     isAnon(): boolean;
 
     /**
-     * Is the user a normal non-temporary registered user?
+     * Check whether the user is a normal non-temporary registered user.
      *
      * @returns {boolean}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isNamed
@@ -195,7 +198,7 @@ export interface User {
     isNamed(): boolean;
 
     /**
-     * Is the user an autocreated temporary user?
+     * Check whether the user is an autocreated temporary user.
      *
      * @returns {boolean}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isTemp
@@ -203,7 +206,7 @@ export interface User {
     isTemp(): boolean;
 
     /**
-     * Retrieve a random ID, generating it if needed
+     * Retrieve a random ID, generating it if needed.
      *
      * This ID is shared across windows, tabs, and page views. It is persisted
      * for the duration of one browser session (until the browser app is closed),
@@ -217,7 +220,7 @@ export interface User {
     sessionId(): string;
 
     /**
-     * Get the current user's groups or rights
+     * Get the current user's groups or rights.
      *
      * @private
      * @returns {JQuery.Promise<UserInfo>}
@@ -229,10 +232,15 @@ export interface User {
 declare global {
     namespace mw {
         /**
+         * User library provided by `mediawiki.user` ResourceLoader module.
+         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user
          */
         const user: User;
     }
 }
 
+/** @deprecated Use `mw.Api.UserInfo` instead. */
+export type UserInfo = mw.Api.UserInfo;
+
 export {};
diff --git a/mw/util.d.ts b/mw/util.d.ts
index 9507829..2084e61 100644
--- a/mw/util.d.ts
+++ b/mw/util.d.ts
@@ -9,7 +9,7 @@ type NoReturn<T extends (...args: any[]) => any> = T extends (
         : (this: U, ...args: V) => void
     : never;
 
-interface ImageUrlData {
+interface ResizeableThumbnailUrl {
     /**
      * File name (same format as {@link mw.Title.getMainText()}).
      */
@@ -34,13 +34,21 @@ interface ImageUrlData {
 declare global {
     namespace mw {
         /**
-         * Utility library provided by the `mediawiki.util` module.
+         * Utility library provided by the `mediawiki.util` ResourceLoader module. Accessible
+         * inside ResourceLoader modules or for gadgets as part of the {@link mw mw global object}.
          *
+         * @example
+         * ```js
+         * // Inside MediaWiki extensions
+         * const util = require( 'mediawiki.util' );
+         * // In gadgets
+         * const mwUtil = mw.util;
+         * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util
          */
         namespace util {
             /**
-             * The content wrapper of the skin (e.g. `.mw-body`).
+             * The content wrapper of the skin (`.mw-body`, for example).
              *
              * Populated on document ready. To use this property,
              * wait for `$.ready` and be sure to have a module dependency on
@@ -56,7 +64,6 @@ declare global {
              * allow your code to re-run when the page changes (e.g. live preview
              * or re-render after ajax save).
              *
-             * @property {JQuery}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-property-S-content
              */
             const $content: JQuery;
@@ -67,7 +74,7 @@ declare global {
              * To access the `<style>` element, reference `sheet.ownerNode`, or call
              * the {@link mw.loader.addStyleTag} method directly.
              *
-             * This function returns the CSSStyleSheet object for convience with features
+             * This function returns the CSSStyleSheet object for convenience with features
              * that are managed at that level, such as toggling of styles:
              *
              * ```js
@@ -101,12 +108,14 @@ declare global {
             function addPortlet(id: string, label?: string, before?: string): HTMLElement | null;
 
             /**
-             * Add a link to a portlet menu on the page, such as:
+             * Add a link to a portlet menu on the page.
              *
-             * - p-cactions (Content actions),
-             * - p-personal (Personal tools),
-             * - p-navigation (Navigation),
-             * - p-tb (Toolbox).
+             * The portlets that are supported include:
+             *
+             * - p-cactions (Content actions)
+             * - p-personal (Personal tools)
+             * - p-navigation (Navigation)
+             * - p-tb (Toolbox)
              * - p-associated-pages (For namespaces and special page tabs on supported skins)
              * - p-namespaces (For namespaces on legacy skins)
              *
@@ -244,7 +253,7 @@ declare global {
             function escapeIdForLink(str: string): string;
 
             /**
-             * Escape string for safe inclusion in regular expression
+             * Escape string for safe inclusion in regular expression.
              *
              * The following characters are escaped:
              *
@@ -264,12 +273,12 @@ declare global {
              * Currently this does not handle associative or multi-dimensional arrays, but that may be
              * improved in the future.
              *
+             * @example
              * ```js
              * mw.util.getArrayParam( 'foo', new URLSearchParams( '?foo[0]=a&foo[1]=b' ) ); // [ 'a', 'b' ]
              * mw.util.getArrayParam( 'foo', new URLSearchParams( '?foo[]=a&foo[]=b' ) ); // [ 'a', 'b' ]
              * mw.util.getArrayParam( 'foo', new URLSearchParams( '?foo=a' ) ); // null
              * ```
-             *
              * @param {string} param The parameter name.
              * @param {URLSearchParams} [params] Parsed URL parameters to search through, defaulting to the current browsing location.
              * @returns {string[]|null} Parameter value, or null if parameter was not found.
@@ -280,12 +289,12 @@ declare global {
             /**
              * Get the value for a given URL query parameter.
              *
+             * @example
              * ```js
              * mw.util.getParamValue( 'foo', '/?foo=x' ); // "x"
              * mw.util.getParamValue( 'foo', '/?foo=' ); // ""
              * mw.util.getParamValue( 'foo', '/' ); // null
              * ```
-             *
              * @param {string} param The parameter name.
              * @param {string} [url=location.href] URL to search through, defaulting to the current browsing location.
              * @returns {string|null} Parameter value, or null if parameter was not found.
@@ -294,7 +303,7 @@ declare global {
             function getParamValue(param: string, url?: string): string | null;
 
             /**
-             * Get the target element from a link hash
+             * Get the target element from a link hash.
              *
              * This is the same element as you would get from
              * `document.querySelectorAll(':target')`, but can be used on
@@ -316,7 +325,7 @@ declare global {
             function getTargetFromFragment(hash?: string): HTMLElement | null;
 
             /**
-             * Get the URL to a given local wiki page name,
+             * Get the URL to a given local wiki page name.
              *
              * @param {string|null} [pageName=wgPageName] Page name
              * @param {QueryParams} [params] A mapping of query parameter names to values,
@@ -337,7 +346,18 @@ declare global {
             function hidePortlet(portletId: string): void;
 
             /**
-             * Check whether a string is a valid IP address
+             * Determine if an input string represents a value of infinity.
+             * This is used when testing for infinity in the context of expiries,
+             * such as watchlisting, page protection, and block expiries.
+             *
+             * @param {string|null} str
+             * @return {boolean}
+             * @stable
+             */
+            function isInfinity(str: string | null): boolean;
+
+            /**
+             * Check whether a string is a valid IP address.
              *
              * @since 1.25
              * @param {string} address String to check
@@ -352,6 +372,7 @@ declare global {
              *
              * Based on \Wikimedia\IPUtils::isIPv4 in PHP.
              *
+             * @example
              * ```js
              * // Valid
              * mw.util.isIPv4Address( '80.100.20.101' );
@@ -361,7 +382,6 @@ declare global {
              * mw.util.isIPv4Address( '192.0.2.0/24' );
              * mw.util.isIPv4Address( 'hello' );
              * ```
-             *
              * @param {string} address
              * @param {boolean} [allowBlock=false]
              * @returns {boolean}
@@ -381,6 +401,7 @@ declare global {
              *
              * Based on \Wikimedia\IPUtils::isIPv6 in PHP.
              *
+             * @example
              * ```js
              * // Valid
              * mw.util.isIPv6Address( '2001:db8:a:0:0:0:0:0' );
@@ -390,7 +411,6 @@ declare global {
              * mw.util.isIPv6Address( '2001:db8:a::/32' );
              * mw.util.isIPv6Address( 'hello' );
              * ```
-             *
              * @param {string} address
              * @param {boolean} [allowBlock=false]
              * @returns {boolean}
@@ -399,7 +419,7 @@ declare global {
             function isIPv6Address(address: string, allowBlock?: boolean): boolean;
 
             /**
-             * Is a portlet visible?
+             * Whether a portlet is visible.
              *
              * @param {string} portletId ID of the target portlet (e.g. 'p-cactions' or 'p-personal')
              * @returns {boolean}
@@ -408,7 +428,7 @@ declare global {
             function isPortletVisible(portletId: string): boolean;
 
             /**
-             * Does given username match $wgAutoCreateTempUser?
+             * Checks if the given username matches $wgAutoCreateTempUser.
              *
              * This functionality has been adapted from `MediaWiki\User\TempUser\Pattern::isMatch()`
              *
@@ -424,14 +444,14 @@ declare global {
              * the image.
              *
              * @param {string} url URL to parse (URL-encoded)
-             * @returns {ImageUrlData|null} URL data, or null if the URL is not a valid MediaWiki
-             *   image/thumbnail URL.
+             * @returns {ResizeableThumbnailUrl|null} URL data, or null if the URL is not a valid MediaWiki
+             *  image/thumbnail URL.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-parseImageUrl
              */
-            function parseImageUrl(url: string): ImageUrlData | null;
+            function parseImageUrl(url: string): ResizeableThumbnailUrl | null;
 
             /**
-             * Percent-decode a string, as found in a URL hash fragment
+             * Percent-decode a string, as found in a URL hash fragment.
              *
              * Implements the percent-decode method as defined in
              * {@link https://url.spec.whatwg.org/#percent-decode}.
@@ -462,7 +482,7 @@ declare global {
             function prettifyIP(ip: string): string | null;
 
             /**
-             * Encode the string like PHP's rawurlencode
+             * Encode the string like PHP's rawurlencode.
              *
              * @param {string} str String to be encoded.
              * @returns {string} Encoded string
@@ -519,10 +539,10 @@ declare global {
              *
              * This validation is based on the HTML5 specification.
              *
+             * @example
              * ```js
              * mw.util.validateEmail( "me@example.org" ) === true;
              * ```
-             *
              * @param {string} email E-mail address
              * @returns {boolean|null} True if valid, false if invalid, null if `email` was empty.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-validateEmail

From 346d24cbc51802e540bc42e5bf170f363535621d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 15:29:15 +0200
Subject: [PATCH 02/15] Small fixes - synchronize `mw.cookie.get` TS type with
 JSdoc: only allow `string|null` as argument - fix `mw.notify` not targetting
 the mw implementation of `NotificationOptions` - add missing JSdoc to
 `mw.experiments` and `mw.Rest.Options.ajax` - add missing code block language
 annotations

---
 jquery/cookie.d.ts         |  5 ++---
 jquery/suggestions.d.ts    | 15 ++++++---------
 jquery/tablesorter.d.ts    |  1 +
 jquery/textSelection.d.ts  |  1 -
 mw/Api.d.ts                |  1 -
 mw/Rest.d.ts               |  4 ++++
 mw/confirmCloseWindow.d.ts |  1 -
 mw/cookie.d.ts             | 12 ++++++------
 mw/experiments.d.ts        |  2 ++
 mw/hook.d.ts               |  4 ++--
 mw/index.d.ts              |  2 +-
 mw/loader.d.ts             |  2 +-
 mw/notification.d.ts       |  6 +++---
 mw/searchSuggest.d.ts      |  2 +-
 14 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/jquery/cookie.d.ts b/jquery/cookie.d.ts
index 70df263..fa81c0f 100644
--- a/jquery/cookie.d.ts
+++ b/jquery/cookie.d.ts
@@ -25,12 +25,11 @@ declare global {
          * Remove a cookie by key.
          *
          * @example
+         * ```js
          * mw.loader.using( 'mediawiki.cookie' ).then( () => {
          *     $.removeCookie( 'name', {} );
          * } );
-         *
-         * @memberof jQueryPlugins
-         * @method removeCookie
+         * ```
          * @param {string} key
          * @param {mw.cookie.CookieOptions} options
          * @returns {boolean} True if the cookie previously existed
diff --git a/jquery/suggestions.d.ts b/jquery/suggestions.d.ts
index e04221e..1021f50 100644
--- a/jquery/suggestions.d.ts
+++ b/jquery/suggestions.d.ts
@@ -4,13 +4,6 @@ declare global {
          * This plugin provides a generic way to add suggestions to a text box.
          * Provided by the `jquery.suggestions` ResourceLoader module.
          *
-         * Set options:
-         *
-         * ```js
-         * $( '#textbox' ).suggestions( { option1: value1, option2: value2 } );
-         * $( '#textbox' ).suggestions( option, value );
-         * ```
-         *
          * @example
          * ```js
          * // Initialize:
@@ -18,8 +11,12 @@ declare global {
          *     $( '#textbox' ).suggestions();
          * });
          * ```
-         * Initialize:
-         *
+         * @example
+         * ```js
+         * // Set options:
+         * $( '#textbox' ).suggestions( { option1: value1, option2: value2 } );
+         * $( '#textbox' ).suggestions( option, value );
+         * ```
          * @param {string} property Name of property
          * @param {any} value Value to set property with
          * @returns {JQuery}
diff --git a/jquery/tablesorter.d.ts b/jquery/tablesorter.d.ts
index ee08803..ff28c5b 100644
--- a/jquery/tablesorter.d.ts
+++ b/jquery/tablesorter.d.ts
@@ -122,6 +122,7 @@ interface Options {
     /**
      * An array containing objects specifying sorting. By passing more
      * than one object, multi-sorting will be applied. Object structure:
+     *
      * ```
      * { <Integer column index>: <String 'asc' or 'desc'> }
      * ```
diff --git a/jquery/textSelection.d.ts b/jquery/textSelection.d.ts
index b6710ef..62f609f 100644
--- a/jquery/textSelection.d.ts
+++ b/jquery/textSelection.d.ts
@@ -140,7 +140,6 @@ declare global {
          *     const contents = $( 'textarea' ).textSelection( 'getContents' );
          * } );
          * ```
-         *
          * @param {string} command Command to execute
          * @param {any} [commandOptions] Options to pass to the command
          * @returns {any} Depending on the command
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index b8b7bb4..82e7bff 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -724,7 +724,6 @@ declare global {
              *     } );
              * } );
              * ```
-             *
              * @param {File|HTMLInputElement} file
              * @param {ApiUploadParams} [data]
              * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index c1422cc..e80bb6e 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -124,6 +124,10 @@ declare global {
 
         namespace Rest {
             interface Options {
+                /**
+                 * Default options for {@link Rest.ajax()} calls. Can be overridden by passing `options` to
+                 * the {@link Rest} constructor.
+                 */
                 ajax?: JQuery.AjaxSettings;
             }
         }
diff --git a/mw/confirmCloseWindow.d.ts b/mw/confirmCloseWindow.d.ts
index 38d8a7a..77919de 100644
--- a/mw/confirmCloseWindow.d.ts
+++ b/mw/confirmCloseWindow.d.ts
@@ -61,7 +61,6 @@ declare global {
          *     }
          * })
          * ```
-         *
          * @param {Options} [options]
          * @returns {ConfirmCloseWindow} An object of functions to work with this module
          */
diff --git a/mw/cookie.d.ts b/mw/cookie.d.ts
index 83b5b79..7bc0ea5 100644
--- a/mw/cookie.d.ts
+++ b/mw/cookie.d.ts
@@ -21,11 +21,11 @@ declare global {
              *
              * @param {string} key The key for the cookie
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
-             * @param {null|string} [defaultValue] A value to return if the cookie does not exist
-             * @returns {any} If the cookie exists, the value of the cookie, otherwise `defaultValue`
+             * @param {string|null} [defaultValue] A value to return if the cookie does not exist
+             * @returns {string|null} If the cookie exists, the value of the cookie, otherwise `defaultValue`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-get
              */
-            function get<D>(
+            function get<D extends string | null>(
                 key: string,
                 prefix: string | undefined | null,
                 defaultValue: D
@@ -37,11 +37,11 @@ declare global {
              *
              * @param {string} key The key for the cookie
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
-             * @param {null|string} [defaultValue] A value to return if the cookie does not exist
-             * @returns {any} If the cookie exists, the value of the cookie, otherwise `defaultValue`
+             * @param {string|null} [defaultValue] A value to return if the cookie does not exist
+             * @returns {string|null|undefined} If the cookie exists, the value of the cookie, otherwise `defaultValue`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-getCrossSite
              */
-            function getCrossSite<D>(
+            function getCrossSite<D extends string | null>(
                 key: string,
                 prefix: string | undefined | null,
                 defaultValue: D
diff --git a/mw/experiments.d.ts b/mw/experiments.d.ts
index 91278ce..55938bc 100644
--- a/mw/experiments.d.ts
+++ b/mw/experiments.d.ts
@@ -16,6 +16,8 @@ interface Experiment {
 declare global {
     namespace mw {
         /**
+         * Provides an API for bucketing users in experiments.
+         *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.experiments
          */
         namespace experiments {
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
index e61d90f..050d9da 100644
--- a/mw/hook.d.ts
+++ b/mw/hook.d.ts
@@ -188,7 +188,7 @@ declare global {
          * Create an instance of mw.hook, fired when a portlet is successfully created.
          *
          * @example
-         * ```
+         * ```js
          * mw.hook( 'util.addPortlet' ).add( ( p ) => {
          *     p.style.border = 'solid 1px black';
          * } );
@@ -203,7 +203,7 @@ declare global {
          * Create an instance of mw.hook, fired when a portlet link is successfully created.
          *
          * @example
-         * ```
+         * ```js
          * mw.hook( 'util.addPortletLink' ).add( ( link ) => {
          *     const span = $( '<span class="icon">' );
          *     link.appendChild( span );
diff --git a/mw/index.d.ts b/mw/index.d.ts
index 7a19543..33a8419 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -89,7 +89,7 @@ declare global {
          * types for mw.widgets are out of scope!
          *
          * @example
-         * ```
+         * ```js
          * mw.loader.using('mediawiki.widget').then(() => {
          *     OO.ui.getWindowManager().addWindows( [ new mw.widget.AbandonEditDialog() ] );
          * });
diff --git a/mw/loader.d.ts b/mw/loader.d.ts
index a43978b..4665d5c 100644
--- a/mw/loader.d.ts
+++ b/mw/loader.d.ts
@@ -291,7 +291,7 @@ declare global {
              * The {@link work()} method will use this information to split up requests by source.
              *
              * @example
-             * ```
+             * ```js
              * mw.loader.addSource( { mediawikiwiki: 'https://www.mediawiki.org/w/load.php' } );
              * ```
              * @private
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 5e17ec5..48a1261 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -60,14 +60,14 @@ declare global {
          * Convenience method for loading and accessing the {@link mw.notification.notify mw.notification module}.
          *
          * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
-         * @param {Partial<NotificationOptions>} [options] The options to use for the notification.
-         *  See {@link defaults} the defaults.
+         * @param {Partial<notification.NotificationOptions>} [options] The options to use for the notification.
+         *  See {@link notification.defaults the defaults}.
          * @returns {JQuery.Promise<Notification>} Notification object
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-notify
          */
         function notify(
             message: string | Message | JQuery | HTMLElement | HTMLElement[],
-            options?: Partial<NotificationOptions>
+            options?: Partial<notification.NotificationOptions>
         ): JQuery.Promise<Notification>;
 
         /**
diff --git a/mw/searchSuggest.d.ts b/mw/searchSuggest.d.ts
index b5b3b49..b696bfc 100644
--- a/mw/searchSuggest.d.ts
+++ b/mw/searchSuggest.d.ts
@@ -27,7 +27,7 @@ declare global {
          * Loaded via the `mediawiki.searchSuggest` ResourceLoader library.
          *
          * @example
-         * ```
+         * ```js
          * mw.loader.using('mediawiki.searchSuggest').then(() => {
          *     var api = new mw.Api();
          *     mw.searchSuggest.request(api, 'Dogs that', ( results ) => {

From df4cbcfe51591aa9e5f4be2ab91bbbec169fb1e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 15:46:17 +0200
Subject: [PATCH 03/15] Make `mw.libs` & `mw.widgets` namespaces so library and
 widget types can be specified in this package (or other ones)

---
 mw/index.d.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mw/index.d.ts b/mw/index.d.ts
index 33a8419..24b30af 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -75,7 +75,7 @@ declare global {
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-property-libs
          */
-        const libs: Record<string, any>;
+        namespace libs {}
 
         /**
          * Store for templates associated with a module.
@@ -96,7 +96,7 @@ declare global {
          * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.base.html#mw-property-libs
          */
-        const widgets: any;
+        namespace widgets {}
 
         /**
          * Format a string. Replace $1, $2 ... $N with positional arguments.

From 54a37645920a5f4c6edd41c8f339e2b7143e3e4e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 15:47:55 +0200
Subject: [PATCH 04/15] Add `pluralRuleParser` & `tempUserCreated` types

---
 mw/index.d.ts            |  2 ++
 mw/pluralRuleParser.d.ts | 14 ++++++++++++++
 mw/tempUserCreated.d.ts  | 15 +++++++++++++++
 3 files changed, 31 insertions(+)
 create mode 100644 mw/pluralRuleParser.d.ts
 create mode 100644 mw/tempUserCreated.d.ts

diff --git a/mw/index.d.ts b/mw/index.d.ts
index 24b30af..4f0a4d1 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -19,11 +19,13 @@ import "./log";
 import "./Map";
 import "./message";
 import "./notification";
+import "./pluralRuleParser";
 import "./RegExp";
 import "./Rest";
 import "./searchSuggest";
 import "./storage";
 import "./template";
+import "./tempUserCreated";
 import "./Title";
 import "./Upload";
 import "./Uri";
diff --git a/mw/pluralRuleParser.d.ts b/mw/pluralRuleParser.d.ts
new file mode 100644
index 0000000..67695a4
--- /dev/null
+++ b/mw/pluralRuleParser.d.ts
@@ -0,0 +1,14 @@
+declare global {
+    namespace mw.libs {
+        /**
+         * Evaluates a plural rule in CLDR syntax for a number.
+         *
+         * @param {string} rule
+         * @param {integer} number
+         * @returns {boolean} true if evaluation passed, false if evaluation failed.
+         */
+        function pluralRuleParser(rule: string, number: number): boolean;
+    }
+}
+
+export {};
diff --git a/mw/tempUserCreated.d.ts b/mw/tempUserCreated.d.ts
new file mode 100644
index 0000000..f8e4e94
--- /dev/null
+++ b/mw/tempUserCreated.d.ts
@@ -0,0 +1,15 @@
+declare global {
+    namespace mw {
+        /**
+         * Respond to the creation of a temporary user.
+         */
+        namespace tempUserCreated {
+            /**
+             * Show popup after creation of a temporary user.
+             */
+            function showPopup(): void;
+        }
+    }
+}
+
+export {};

From 62df4e6bc3ac4294b1a2e7062840cfeaa2567fdd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 16:23:59 +0200
Subject: [PATCH 05/15] Replace imports with globals missed some imports in the
 previous commits

---
 mw/ForeignUpload.d.ts | 9 +++------
 mw/Upload.d.ts        | 6 +++---
 mw/user.d.ts          | 4 ++--
 3 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/mw/ForeignUpload.d.ts b/mw/ForeignUpload.d.ts
index 441b43c..d0edfdc 100644
--- a/mw/ForeignUpload.d.ts
+++ b/mw/ForeignUpload.d.ts
@@ -1,6 +1,3 @@
-import { ApiOptions } from "./Api";
-import { ForeignApiOptions } from "./ForeignApi";
-
 declare global {
     namespace mw {
         /**
@@ -48,10 +45,10 @@ declare global {
              *     wiki. If not remote, this class behaves identically to mw.Upload (unless further subclassed)
              *     Use the same names as set in $wgForeignFileRepos for this. Also,
              *     make sure there is an entry in the $wgForeignUploadTargets array for this name.
-             * @param {Partial<ApiOptions>} [apiconfig] Passed to the constructor of mw.ForeignApi or mw.Api, as needed.
+             * @param {Api.Options} [apiconfig] Passed to the constructor of mw.ForeignApi or mw.Api, as needed.
              */
-            constructor(target: string, apiconfig?: Partial<ForeignApiOptions>);
-            constructor(apiconfig?: Partial<ApiOptions>);
+            constructor(target: string, apiconfig?: ForeignApi.Options);
+            constructor(apiconfig?: Api.Options);
         }
     }
 }
diff --git a/mw/Upload.d.ts b/mw/Upload.d.ts
index 222489a..c733960 100644
--- a/mw/Upload.d.ts
+++ b/mw/Upload.d.ts
@@ -1,4 +1,4 @@
-import { ApiOptions, ApiResponse } from "./Api";
+import { ApiResponse } from "./Api";
 
 declare global {
     namespace mw {
@@ -91,10 +91,10 @@ declare global {
              * } );
              * ```
              *
-             * @param {Api|Partial<ApiOptions>} [apiconfig] A mw.Api object (or subclass), or configuration
+             * @param {Api|Api.Options} [apiconfig] A mw.Api object (or subclass), or configuration
              *     to pass to the constructor of mw.Api.
              */
-            constructor(apiconfig?: Api | Partial<ApiOptions>);
+            constructor(apiconfig?: Api | Api.Options);
 
             /**
              * Finish a stash upload.
diff --git a/mw/user.d.ts b/mw/user.d.ts
index f946eae..f39e3ef 100644
--- a/mw/user.d.ts
+++ b/mw/user.d.ts
@@ -223,10 +223,10 @@ export interface User {
      * Get the current user's groups or rights.
      *
      * @private
-     * @returns {JQuery.Promise<UserInfo>}
+     * @returns {JQuery.Promise<mw.Api.UserInfo>}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getUserInfo
      */
-    getUserInfo(): JQuery.Promise<UserInfo>;
+    getUserInfo(): JQuery.Promise<mw.Api.UserInfo>;
 }
 
 declare global {

From 4d35db826a6c327907b89ba1b1b10eeca2b3efd1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 17:58:20 +0200
Subject: [PATCH 06/15] Update `mw.template` types Update JSdoc of
 `mw.template` based on MW 1.42. Some interface declarations for
 `TemplateCompiler` and `TemplateRenderer` were also added in JSdoc, so use
 these types.

---
 mw/template.d.ts | 67 ++++++++++++++++++++++++++++++++++++------------
 1 file changed, 51 insertions(+), 16 deletions(-)

diff --git a/mw/template.d.ts b/mw/template.d.ts
index b2981dd..c79f9da 100644
--- a/mw/template.d.ts
+++ b/mw/template.d.ts
@@ -1,30 +1,63 @@
-type CompiledTemplate = any; // Can this be made more specific?
+interface TemplateRenderer {
+    /**
+     * Compiles a template for rendering.
+     *
+     * @param {Object} [data] for the template
+     * @param {Object} [partials] additional partial templates
+     * @returns {JQuery}
+     */
+    render(data?: unknown, partials?: unknown): JQuery;
+}
 
-interface Compiler {
-    compile(src: string): CompiledTemplate;
+interface TemplateCompiler {
+    /**
+     * Compiles a template for rendering.
+     *
+     * @param {string} src source of the template
+     * @returns {TemplateRenderer} for rendering
+     */
+    compile(src: string): TemplateRenderer;
 }
 
 declare global {
     namespace mw {
         /**
+         * An extensible library for rendering templates in different template languages.
          * Requires `mediawiki.template` ResourceLoader module.
          *
+         * By default only the `html` template library is provided.
+         * The Mustache library is also provided in mediawiki core via the mediawiki.template.mustache library.
+         *
+         * @example
+         * ```js
+         * // returns $( '<div>hello world</div>' );
+         * const $node = mw.template.compile( '<div>hello world</div>', 'html' ).render();
+         *
+         * // also returns $( '<div>hello world</div>' );
+         * mw.loader.using( 'mediawiki.template.mustache' ).then( () => {
+         *   const $node = mw.template.compile( '<div>{{ >Foo }}</div>', 'mustache' ).render( {
+         *     text: 'Hello world'
+         *   }, {
+         *     Foo: mw.template.compile( '{{text}}', 'mustache' )
+         *   } );
+         * } );
+         * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template
          */
         namespace template {
             /**
              * Register a new compiler.
              *
-             * A compiler is any object that implements a compile() method. The compile() method must
-             * return a Template interface with a method render() that returns HTML.
+             * A compiler is any object that implements a {@link mw.template.compile} method. The compile() method must
+             * return a Template interface with a method {@link TemplateRenderer.render render()} that returns HTML.
              *
              * The compiler name must correspond with the name suffix of templates that use this compiler.
              *
              * @param {string} name Compiler name
-             * @param {Compiler} compiler
+             * @param {TemplateCompiler} compiler
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-registerCompiler
              */
-            function registerCompiler(name: string, compiler: Compiler): void;
+            function registerCompiler(name: string, compiler: TemplateCompiler): void;
 
             /**
              * Get the name of the associated compiler based on a template name.
@@ -39,10 +72,11 @@ declare global {
              * Get a compiler via its name.
              *
              * @param {string} name Name of a compiler
-             * @returns {Compiler} The compiler
+             * @returns {TemplateCompiler} The compiler
+             * @throws {Error} when unknown compiler provided
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-getCompiler
              */
-            function getCompiler(name: string): Compiler;
+            function getCompiler(name: string): TemplateCompiler;
 
             /**
              * Register a template associated with a module.
@@ -52,34 +86,35 @@ declare global {
              * @param {string} moduleName Name of the ResourceLoader module the template is associated with
              * @param {string} templateName Name of the template (including suffix)
              * @param {string} templateBody Contents of the template (e.g. html markup)
-             * @returns {CompiledTemplate} Compiled template
+             * @returns {TemplateRenderer} Compiled template
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-add
              */
             function add(
                 moduleName: string,
                 templateName: string,
                 templateBody: string
-            ): CompiledTemplate;
+            ): TemplateRenderer;
 
             /**
              * Get a compiled template by module and template name.
              *
              * @param {string} moduleName Name of the module to retrieve the template from
              * @param {string} templateName Name of template to be retrieved
-             * @returns {CompiledTemplate} Compiled template
+             * @returns {TemplateRenderer} Compiled template
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-get
              */
-            function get(moduleName: string, templateName: string): CompiledTemplate;
+            function get(moduleName: string, templateName: string): TemplateRenderer;
 
             /**
              * Compile a string of template markup with an engine of choice.
              *
              * @param {string} templateBody Template body
-             * @param {string} compilerName The name of a registered compiler
-             * @returns {CompiledTemplate} Compiled template
+             * @param {string} compilerName The name of a registered compiler.
+             * @returns {TemplateRenderer} Compiled template
+             * @throws {Error} when unknown compiler name provided.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-compile
              */
-            function compile(templateBody: string, compilerName: string): CompiledTemplate;
+            function compile(templateBody: string, compilerName: string): TemplateRenderer;
         }
     }
 }

From dbb4b8b22c31d4ee568b4676fb67f625625ffe1e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 18:47:06 +0200
Subject: [PATCH 07/15] =?UTF-8?q?Update=20links=20-=20update=20types=20of?=
 =?UTF-8?q?=20`mw.template`,=20based=20on=20interfaces=20in=20MW=201.42=20?=
 =?UTF-8?q?JSdoc=20-=20update=20`doc.wikimedia.org`=20urls=20to=20new=20fo?=
 =?UTF-8?q?rmat=20(with=20migration=20of=20source=20code=20from=20jsduck?=
 =?UTF-8?q?=20to=20jsdoc),=20almost=20all=20urls=20are=20currently=20broke?=
 =?UTF-8?q?n=20-=20remove=20`doc.wikimedia.org`=20urls=20to=20private=20me?=
 =?UTF-8?q?mbers=20(that=20linked=20to=20nothing,=20since=20jsdoc=20of=20p?=
 =?UTF-8?q?rivate=20members=20is=20not=20generated)=20-=20add=20missing=20?=
 =?UTF-8?q?`doc.wikimedia.org`=20urls=20-=20add=20`doc.wikimedia.org`=20ur?=
 =?UTF-8?q?ls=20for=20specific=20`mw.hook`=20events,=20since=20their=20jsd?=
 =?UTF-8?q?oc=20is=20now=20generated=20-=20use=20`Special:MyLanguage`=20wh?=
 =?UTF-8?q?en=20possible=20with=20wiki=20urls=20-=20use=20`{@link=20some-u?=
 =?UTF-8?q?rl=20=E2=80=A6}`=20consistently,=20instead=20of=20`[=E2=80=A6](?=
 =?UTF-8?q?some-url)`,=20`<some-url>`,=20or=20plain=20`some-url`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                           |   2 +-
 jquery/client.d.ts                  |  32 ++++----
 jquery/collapsibleTabs.d.ts         |  15 ++--
 jquery/colorUtil.d.ts               |  21 ++++--
 jquery/confirmable.d.ts             |   1 +
 jquery/cookie.d.ts                  |   2 +
 jquery/highlightText.d.ts           |   1 +
 jquery/htmlform.d.ts                |   2 +
 jquery/lengthLimit.d.ts             |  10 ++-
 jquery/makeCollapsible.d.ts         |   1 +
 jquery/spinner.d.ts                 |   1 +
 jquery/suggestions.d.ts             |   1 +
 jquery/tablesorter.d.ts             |   4 +
 jquery/textSelection.d.ts           |  22 +++---
 jquery/updateTooltipAccessKeys.d.ts |   1 +
 mw/Api.d.ts                         |  86 ++++++++++++----------
 mw/ForeignApi.d.ts                  |   7 +-
 mw/ForeignRest.d.ts                 |   6 +-
 mw/ForeignUpload.d.ts               |   5 ++
 mw/Map.d.ts                         |  21 ++++--
 mw/RegExp.d.ts                      |   4 +-
 mw/Rest.d.ts                        |  23 +++---
 mw/Title.d.ts                       |  71 +++++++++---------
 mw/Upload.d.ts                      |  39 ++++++++--
 mw/Uri.d.ts                         |  50 ++++++-------
 mw/cldr.d.ts                        |   3 +
 mw/config.d.ts                      | 110 ++++++++++++++--------------
 mw/confirmCloseWindow.d.ts          |   1 +
 mw/cookie.d.ts                      |  10 ++-
 mw/debug.d.ts                       |  14 ++++
 mw/deflate.d.ts                     |   3 +-
 mw/errorLogger.d.ts                 |   4 +-
 mw/experiments.d.ts                 |   4 +-
 mw/global.d.ts                      |  16 ++--
 mw/hook.d.ts                        |  75 ++++++++++++-------
 mw/html.d.ts                        |   9 ++-
 mw/index.d.ts                       |  35 +++++----
 mw/inspect.d.ts                     |  10 +++
 mw/language.d.ts                    |  29 ++++----
 mw/loader.d.ts                      |  55 +++-----------
 mw/log.d.ts                         |  11 ++-
 mw/message.d.ts                     |  28 ++++---
 mw/notification.d.ts                |  27 +++----
 mw/pluralRuleParser.d.ts            |   1 +
 mw/searchSuggest.d.ts               |   8 ++
 mw/storage.d.ts                     |  25 +++----
 mw/tempUserCreated.d.ts             |   3 +
 mw/template.d.ts                    |  22 ++++--
 mw/user.d.ts                        |  41 ++++++-----
 mw/util.d.ts                        |  73 +++++++++---------
 50 files changed, 573 insertions(+), 472 deletions(-)

diff --git a/README.md b/README.md
index f059ec8..1beea25 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ let namespaces = mw.config.get("pageTriageNamespaces") as number[];
 
 ### MediaWiki API parameters
 
-This package also provides typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/API:Main_page). API endpoints defined in MediaWiki core and by a number of common extensions (the ones enabled on English Wikipedia) are covered. These aren't exported to the global scope, however. For usage, you need to import them. For example:
+This package also provides typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page). API endpoints defined in MediaWiki core and by a number of common extensions (the ones enabled on English Wikipedia) are covered. These aren't exported to the global scope, however. For usage, you need to import them. For example:
 
 ```ts
 import type { ApiEditPageParams, ApiParseParams } from "types-mediawiki/api_params";
diff --git a/jquery/client.d.ts b/jquery/client.d.ts
index 152e6e6..b1da981 100644
--- a/jquery/client.d.ts
+++ b/jquery/client.d.ts
@@ -1,9 +1,9 @@
 declare global {
     interface JQueryStatic {
         /**
-         * User-agent detection
+         * User-agent detection.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.client
+         * @see https://doc.wikimedia.org/jquery-client/master/jQuery.client.html
          */
         client: Client;
     }
@@ -27,19 +27,6 @@ interface Client {
      * }
      * ```
      *
-     * Example:
-     *
-     * ```js
-     * if ( $.client.profile().layout == 'gecko' ) {
-     *     // This will only run in Gecko browsers, such as Mozilla Firefox.
-     * }
-     *
-     * var profile = $.client.profile();
-     * if ( profile.layout == 'gecko' && profile.platform == 'linux' ) {
-     *     // This will only run in Gecko browsers on Linux.
-     * }
-     * ```
-     *
      * Recognised browser names:
      *
      * - `android` (legacy Android browser, prior to Chrome Mobile)
@@ -76,10 +63,21 @@ interface Client {
      * - `solaris` (untested)
      * - `win`
      *
+     * @example
+     * ```js
+     * if ( $.client.profile().layout == 'gecko' ) {
+     *     // This will only run in Gecko browsers, such as Mozilla Firefox.
+     * }
+     *
+     * var profile = $.client.profile();
+     * if ( profile.layout == 'gecko' && profile.platform == 'linux' ) {
+     *     // This will only run in Gecko browsers on Linux.
+     * }
+     * ```
      * @param {ClientNavigator} [nav] An object with a 'userAgent' and 'platform' property.
      *  Defaults to the global `navigator` object.
      * @returns {ClientProfile} The client object
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.client-method-profile
+     * @see https://doc.wikimedia.org/jquery-client/master/jQuery.client.html#.profile
      */
     profile(nav?: ClientNavigator): ClientProfile;
 
@@ -124,7 +122,7 @@ interface Client {
      * @param {boolean} [exactMatchOnly=false] Only return true if the browser is matched,
      *  otherwise returns true if the browser is not found.
      * @returns {boolean} The current browser is in the support map
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.client-method-test
+     * @see https://doc.wikimedia.org/jquery-client/master/jQuery.client.html#.test
      */
     test(map: ClientSupportMap, profile?: ClientProfile, exactMatchOnly?: boolean): boolean;
 }
diff --git a/jquery/collapsibleTabs.d.ts b/jquery/collapsibleTabs.d.ts
index b218fdf..05165d2 100644
--- a/jquery/collapsibleTabs.d.ts
+++ b/jquery/collapsibleTabs.d.ts
@@ -1,20 +1,25 @@
-/**
- * CollapsibleTabsPlugin used in MediaWiki vector skin
- * Copied from https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/skins/Vector/+/master/resources/CollapsibleTabsPlugin.d.ts
- */
-
 declare global {
     interface JQueryStatic {
+        /**
+         * CollapsibleTabsPlugin used in MediaWiki vector skin
+         * Copied from {@link https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/skins/Vector/+/master/resources/CollapsibleTabsPlugin.d.ts}
+         */
         collapsibleTabs: CollapsibleTabsStatic;
     }
 
     interface JQuery {
+        /**
+         * CollapsibleTabsPlugin used in MediaWiki vector skin
+         * Copied from {@link https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/skins/Vector/+/master/resources/CollapsibleTabsPlugin.d.ts}
+         */
         collapsibleTabs(options: Partial<CollapsibleTabsOptions>): void;
     }
 }
 
 /**
  * A jQuery plugin that makes collapsible tabs for the Vector skin.
+ *
+ * @see https://doc.wikimedia.org/mediawiki-skins-Vector/master/js/js/CollapsibleTabsOptions.html
  */
 interface CollapsibleTabsOptions {
     /**
diff --git a/jquery/colorUtil.d.ts b/jquery/colorUtil.d.ts
index c71783a..24ccb19 100644
--- a/jquery/colorUtil.d.ts
+++ b/jquery/colorUtil.d.ts
@@ -1,5 +1,8 @@
 declare global {
     interface JQueryStatic {
+        /**
+         * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil
+         */
         colorUtil: ColorUtil;
     }
 }
@@ -11,10 +14,11 @@ interface ColorUtil {
      * Parse CSS color strings looking for color tuples
      *
      * Based on highlightFade by Blair Mitchelmore
-     * <http://jquery.offput.ca/highlightFade/>
+     * {@link http://jquery.offput.ca/highlightFade/}
      *
      * @param {Color|string} color
      * @returns {Color}
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getRGB
      */
     getRGB<T extends Color>(color: string | T): T;
 
@@ -22,7 +26,9 @@ interface ColorUtil {
      * Named color map
      *
      * Based on Interface by Stefan Petre
-     * <http://interface.eyecon.ro/>
+     * {@link http://interface.eyecon.ro/}
+     *
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-property-colors
      */
     colors: Record<string, Color>;
 
@@ -30,9 +36,9 @@ interface ColorUtil {
      * Convert an RGB color value to HSL.
      *
      * Conversion formula based on
-     * <http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript>
+     * {@link http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript}
      *
-     * Adapted from <https://en.wikipedia.org/wiki/HSL_color_space>.
+     * Adapted from {@link https://en.wikipedia.org/wiki/HSL_color_space}.
      *
      * Assumes `r`, `g`, and `b` are contained in the set `[0, 255]` and
      * returns `h`, `s`, and `l` in the set `[0, 1]`.
@@ -41,6 +47,7 @@ interface ColorUtil {
      * @param {number} g The green color value
      * @param {number} b The blue color value
      * @returns {Color} The HSL representation
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-rgbToHsl
      */
     rgbToHsl(r: number, g: number, b: number): Color;
 
@@ -48,9 +55,9 @@ interface ColorUtil {
      * Convert an HSL color value to RGB.
      *
      * Conversion formula based on
-     * <http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript>
+     * {@link http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript}
      *
-     * Adapted from <https://en.wikipedia.org/wiki/HSL_color_space>.
+     * Adapted from {@link https://en.wikipedia.org/wiki/HSL_color_space}.
      *
      * Assumes `h`, `s`, and `l` are contained in the set `[0, 1]` and
      * returns `r`, `g`, and `b` in the set `[0, 255]`.
@@ -59,6 +66,7 @@ interface ColorUtil {
      * @param {number} s The saturation
      * @param {number} l The lightness
      * @returns {Color} The RGB representation
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-hslToRgb
      */
     hslToRgb(h: number, s: number, l: number): Color;
 
@@ -77,6 +85,7 @@ interface ColorUtil {
      * @param {Color|string} currentColor Current value in css
      * @param {number} mod Wanted brightness modification between -1 and 1
      * @returns {string} Like `'rgb(r,g,b)'`
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getColorBrightness
      */
     getColorBrightness(
         currentColor: string | Color,
diff --git a/jquery/confirmable.d.ts b/jquery/confirmable.d.ts
index eb003db..3c35d19 100644
--- a/jquery/confirmable.d.ts
+++ b/jquery/confirmable.d.ts
@@ -21,6 +21,7 @@ declare global {
          *     $( 'button' ).confirmable();
          * } );
          * ```
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.confirmable
          */
         confirmable: Confirmable;
     }
diff --git a/jquery/cookie.d.ts b/jquery/cookie.d.ts
index fa81c0f..81b15d2 100644
--- a/jquery/cookie.d.ts
+++ b/jquery/cookie.d.ts
@@ -16,6 +16,7 @@ declare global {
          * @param {mw.cookie.CookieOptions} [options]
          * @returns {string|Object} The current value (if getting a cookie), or an internal `document.cookie`
          *  expression (if setting or removing).
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.cookie
          */
         cookie(key: string, value: string | null, options?: mw.cookie.CookieOptions): string;
         cookie(key: string): unknown;
@@ -33,6 +34,7 @@ declare global {
          * @param {string} key
          * @param {mw.cookie.CookieOptions} options
          * @returns {boolean} True if the cookie previously existed
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.removeCookie
          */
         removeCookie(key: string, options: mw.cookie.CookieOptions): boolean;
     }
diff --git a/jquery/highlightText.d.ts b/jquery/highlightText.d.ts
index 2acddc6..732a36a 100644
--- a/jquery/highlightText.d.ts
+++ b/jquery/highlightText.d.ts
@@ -19,6 +19,7 @@ declare global {
          * @param {string} matchString String to match
          * @param {Options} [options]
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.highlightText
          */
         highlightText(matchString: string, options?: Options): this;
     }
diff --git a/jquery/htmlform.d.ts b/jquery/htmlform.d.ts
index f591506..f7a088e 100644
--- a/jquery/htmlform.d.ts
+++ b/jquery/htmlform.d.ts
@@ -5,6 +5,7 @@ declare global {
          *
          * @param {boolean} [instantToggle=false]
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.goIn
          */
         goIn(instantToggle?: boolean): this;
 
@@ -13,6 +14,7 @@ declare global {
          *
          * @param {boolean} [instantToggle=false]
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.goOut
          */
         goOut(instantToggle?: boolean): this;
     }
diff --git a/jquery/lengthLimit.d.ts b/jquery/lengthLimit.d.ts
index e364d3d..5bebcf4 100644
--- a/jquery/lengthLimit.d.ts
+++ b/jquery/lengthLimit.d.ts
@@ -15,6 +15,7 @@ declare global {
          * @param {number} byteLimit Number of bytes the value may be in size.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {TrimResult}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.trimByteLength
          */
         trimByteLength(
             safeVal: string,
@@ -39,6 +40,7 @@ declare global {
          *  called with fetched value as argument.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.byteLimit
          */
         byteLimit(limit: number, filterFunction?: FilterFunction): this;
         byteLimit(filterFunction?: FilterFunction): this;
@@ -46,13 +48,12 @@ declare global {
         /**
          * Enforces a codepoint (character) limit on an input field.
          *
-         * For unfortunate historical reasons, browsers' native maxlength counts [the number of UTF-16
-         * code units rather than Unicode codepoints] [1], which means that codepoints outside the Basic
+         * For unfortunate historical reasons, browsers' native maxlength counts
+         * {@link https://www.w3.org/TR/html5/sec-forms.html#limiting-user-input-length-the-maxlength-attribute the number of UTF-16
+         * code units rather than Unicode codepoints}, which means that codepoints outside the Basic
          * Multilingual Plane (e.g. many emojis) count as 2 characters each. This plugin exists to
          * correct this.
          *
-         * [1]: https://www.w3.org/TR/html5/sec-forms.html#limiting-user-input-length-the-maxlength-attribute
-         *
          * Can be called with a custom limit (to use that limit instead of the maxlength attribute
          * value), a filter function (in case the limit should apply to something other than the
          * exact input value), or both. Order of parameters is important!
@@ -61,6 +62,7 @@ declare global {
          *  called with fetched value as argument.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.codePointLimit
          */
         codePointLimit(limit: number, filterFunction?: FilterFunction): this;
         codePointLimit(filterFunction?: FilterFunction): this;
diff --git a/jquery/makeCollapsible.d.ts b/jquery/makeCollapsible.d.ts
index be1a1bf..803436c 100644
--- a/jquery/makeCollapsible.d.ts
+++ b/jquery/makeCollapsible.d.ts
@@ -18,6 +18,7 @@ declare global {
          * ```
          * @param {Options} [options]
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.makeCollapsible
          */
         makeCollapsible(options?: Options): this;
     }
diff --git a/jquery/spinner.d.ts b/jquery/spinner.d.ts
index 19e01c8..d129909 100644
--- a/jquery/spinner.d.ts
+++ b/jquery/spinner.d.ts
@@ -60,6 +60,7 @@ declare global {
          * @param {string|Options} [opts] Options. If a string is given, it will be treated as the value
          *   of the `id` option.
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.injectSpinner
          */
         injectSpinner(opts?: string | Options): this;
     }
diff --git a/jquery/suggestions.d.ts b/jquery/suggestions.d.ts
index 1021f50..beabc73 100644
--- a/jquery/suggestions.d.ts
+++ b/jquery/suggestions.d.ts
@@ -20,6 +20,7 @@ declare global {
          * @param {string} property Name of property
          * @param {any} value Value to set property with
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.suggestions
          */
         suggestions<K extends keyof Options<T>, T = any>(property: K, value: Options<T>[K]): this;
         suggestions<T = any>(options?: Partial<Options<T>>): this;
diff --git a/jquery/tablesorter.d.ts b/jquery/tablesorter.d.ts
index ff28c5b..f35572b 100644
--- a/jquery/tablesorter.d.ts
+++ b/jquery/tablesorter.d.ts
@@ -18,6 +18,7 @@ declare global {
          *
          * @param {Partial<Options>} settings
          * @returns {JQuery}
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.tablesorter
          */
         tablesorter(this: JQuery<HTMLTableElement>, settings?: Partial<Options>): this;
     }
@@ -77,6 +78,9 @@ interface TableSorter {
     getParsers(): Parser[];
 }
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#~TableSorterOptions
+ */
 interface Options {
     /**
      * Boolean flag indicating iftablesorter should cancel
diff --git a/jquery/textSelection.d.ts b/jquery/textSelection.d.ts
index 62f609f..629a665 100644
--- a/jquery/textSelection.d.ts
+++ b/jquery/textSelection.d.ts
@@ -6,7 +6,7 @@ declare global {
          *
          * @param {string} command Command to execute
          * @returns {string}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "getContents"): string;
 
@@ -17,7 +17,7 @@ declare global {
          * @param {string} command Command to execute
          * @param {string} content
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "setContents", content: string): this;
 
@@ -27,7 +27,7 @@ declare global {
          *
          * @param {string} command Command to execute
          * @returns {string}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "getSelection"): string;
 
@@ -38,7 +38,7 @@ declare global {
          * @param {string} command Command to execute
          * @param {string} value
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "replaceSelection", value: string): this;
 
@@ -52,7 +52,7 @@ declare global {
          * @param {string} command Command to execute
          * @param {Partial<TextSelectionEncapsulateOptions>} [options]
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(
             command: "encapsulateSelection",
@@ -67,7 +67,7 @@ declare global {
          * @param {Object} [options]
          * @param {boolean} [options.startAndEnd=false] Return range of the selection rather than just start
          * @returns {number|number[]} Array with two numbers, for start and end of selection
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(
             command: "getCaretPosition",
@@ -88,7 +88,7 @@ declare global {
          * @param {number} options.start
          * @param {number} [options.end=options.start]
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "setSelection", options: { start: number; end?: number }): this;
 
@@ -102,7 +102,7 @@ declare global {
          * @param {boolean} [options.force=false] Whether to force a scroll even if the caret position
          *  is already visible.
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "scrollToCaretPosition", options: { force?: boolean }): this;
 
@@ -114,7 +114,7 @@ declare global {
          * @param {Object.<string, Function>} functions Functions to replace. Keys are command names (as in {@link textSelection},
          *  except 'register' and 'unregister'). Values are functions to execute when a given command is
          *  called.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(
             command: "register",
@@ -126,7 +126,7 @@ declare global {
          * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: "unregister"): void;
 
@@ -143,7 +143,7 @@ declare global {
          * @param {string} command Command to execute
          * @param {any} [commandOptions] Options to pass to the command
          * @returns {any} Depending on the command
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/jQuery.plugin.textSelection-method-textSelection
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(command: string, commandOptions?: unknown): any;
     }
diff --git a/jquery/updateTooltipAccessKeys.d.ts b/jquery/updateTooltipAccessKeys.d.ts
index fca2621..8b4c18b 100644
--- a/jquery/updateTooltipAccessKeys.d.ts
+++ b/jquery/updateTooltipAccessKeys.d.ts
@@ -22,6 +22,7 @@ interface TooltipAccessKeys<This = JQuery> {
      * } );
      * ```
      * @returns {JQuery}
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.updateTooltipAccessKeys
      */
     (): This;
 
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index 82e7bff..ab70cb8 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -115,13 +115,13 @@ declare global {
          * values set to `false` or `undefined` will be omitted from the request, as required by
          * the API.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html
          */
         class Api {
             /**
              * @param {Api.Options} [options] See {@link mw.Api.Options}. This can also be overridden for
              *  each request by passing them to {@link get()} or {@link post()} (or directly to {@link ajax()}) later on.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#Api
              */
             constructor(options?: Api.Options);
 
@@ -130,7 +130,7 @@ declare global {
             /**
              * Abort all unfinished requests issued by this Api object.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-abort
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#abort
              */
             abort(): void;
 
@@ -140,7 +140,7 @@ declare global {
              * @param {UnknownApiParams} parameters
              * @param {JQuery.AjaxSettings} [ajaxOptions]
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-get
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#get
              */
             get(
                 parameters: UnknownApiParams,
@@ -153,7 +153,7 @@ declare global {
              * @param {UnknownApiParams} parameters
              * @param {JQuery.AjaxSettings} [ajaxOptions]
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-post
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#post
              */
             post(
                 parameters: UnknownApiParams,
@@ -165,7 +165,6 @@ declare global {
              *
              * @param {UnknownApiParams} parameters (modified in-place)
              * @param {boolean} useUS Whether to use U+001F when joining multi-valued parameters.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-preprocessParameters
              */
             private preprocessParameters(parameters: UnknownApiParams, useUS: boolean): void;
 
@@ -179,7 +178,7 @@ declare global {
              *
              *   - On success, resolves to `( result, jqXHR )` where `result` is the parsed API response.
              *   - On an API error, rejects with `( code, result, result, jqXHR )` where `code` is the
-             *     [API error code](https://www.mediawiki.org/wiki/API:Errors_and_warnings), and `result`
+             *     {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Errors_and_warnings API error code}, and `result`
              *     is as above. When there are multiple errors, the code from the first one will be used.
              *     If there is no error code, "unknown" is used.
              *   - On other types of errors, rejects with `( 'http', details )` where `details` is an object
@@ -196,7 +195,7 @@ declare global {
              *     - When the response is not valid JSON but the previous error conditions aren't met,
              *       textStatus is "parsererror" and exception is the exception object thrown by
              *       {@link JSON.parse}.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-ajax
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#ajax
              */
             ajax(
                 parameters: UnknownApiParams,
@@ -221,7 +220,7 @@ declare global {
              * @param {UnknownApiParams} params API parameters
              * @param {JQuery.AjaxSettings} [ajaxOptions]
              * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-postWithToken
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithToken
              */
             postWithToken(
                 tokenType: ApiTokenType,
@@ -247,7 +246,7 @@ declare global {
              * @param {string} type Token type
              * @param {ApiQueryTokensParams|ApiAssert} [additionalParams] Additional parameters for the API (since 1.35). When given a string, it's treated as the `assert` parameter (since 1.25).
              * @returns {JQuery.Promise<string>} Received token.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-getToken
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getToken
              */
             getToken(
                 type: ApiTokenType,
@@ -272,7 +271,7 @@ declare global {
              *
              * @since 1.26
              * @param {string} type Token type
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-badToken
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#badToken
              */
             badToken(type: ApiTokenType): void;
             /** @deprecated Use "csrf" instead */
@@ -311,7 +310,7 @@ declare global {
              * ```
              * @param {ApiResponse} data API response indicating an error
              * @returns {JQuery} Error messages, each wrapped in a `<div>`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-getErrorMessage
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getErrorMessage
              */
             getErrorMessage(data: ApiResponse): JQuery;
 
@@ -321,7 +320,7 @@ declare global {
              * @param {UnknownApiParams} params API parameters
              * @param {JQuery.AjaxSettings} [ajaxOptions]
              * @returns {JQuery.Promise<ApiResponse>} See {@link post}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-postWithEditToken
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithEditToken
              */
             postWithEditToken(
                 params: UnknownApiParams,
@@ -332,7 +331,7 @@ declare global {
              * API helper to grab a csrf token.
              *
              * @returns {JQuery.Promise<string>} Received token.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-getEditToken
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getEditToken
              */
             getEditToken(): JQuery.Promise<string>;
 
@@ -351,7 +350,7 @@ declare global {
              * @param {ApiEditPageParams} params Edit API parameters
              * @param {string} content Page content
              * @returns {JQuery.Promise<EditResult>} API response
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-create
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#create
              */
             create(
                 title: TitleLike,
@@ -418,7 +417,7 @@ declare global {
              * @param {TitleLike} title Page title
              * @param {Api.EditTransform} transform Callback that prepares the edit
              * @returns {JQuery.Promise<EditResult>} Edit API response
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-edit
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#edit
              */
             edit(title: TitleLike, transform: Api.EditTransform): JQuery.Promise<EditResult>;
 
@@ -430,7 +429,7 @@ declare global {
              * @param {string} message Wikitext message
              * @param {ApiEditPageParams} additionalParams Additional API parameters
              * @returns {JQuery.Promise<ApiResponse>} See {@link postWithEditToken}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.edit-method-newSection
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#newSection
              */
             newSection(
                 title: TitleLike,
@@ -444,7 +443,7 @@ declare global {
              *
              * @since 1.27
              * @returns {JQuery.Promise<Api.UserInfo>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.user-method-getUserInfo
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getUserInfo
              */
             getUserInfo(): JQuery.Promise<Api.UserInfo>;
 
@@ -473,7 +472,7 @@ declare global {
              * @since 1.27
              * @param {UnknownApiParams} query Query parameters. The object will not be changed
              * @returns {AssertUser}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.user-method-assertCurrentUser
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#assertCurrentUser
              */
             assertCurrentUser<T extends UnknownApiParams>(
                 query: T
@@ -486,12 +485,12 @@ declare global {
              * @param {string} name
              * @param {string|null} value
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.options-method-saveOption
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOption
              */
             saveOption(name: string, value: string | null): JQuery.Promise<ApiResponse>;
 
             /**
-             * Asynchronously save the values of user options using the [Options API](https://www.mediawiki.org/wiki/API:Options).
+             * Asynchronously save the values of user options using the {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Options Options API}.
              *
              * If a value of `null` is provided, the given option will be reset to the default value.
              *
@@ -507,7 +506,7 @@ declare global {
              *
              * @param {Object.<string, string|null>} options Options as a `{ name: value, … }` object
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.options-method-saveOptions
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOptions
              */
             saveOptions(options: Record<string, string | null>): JQuery.Promise<ApiResponse>;
 
@@ -523,7 +522,7 @@ declare global {
              * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
              *  with an object (or array of objects) describing each page that was passed in and its
              *  current watched/unwatched status.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.watch-method-watch
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#watch
              */
             watch<P extends TypeOrArray<TitleLike>>(
                 pages: P,
@@ -539,7 +538,7 @@ declare global {
              * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
              *  with an object (or array of objects) describing each page that was passed in and its
              *  current watched/unwatched status.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.watch-method-unwatch
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#unwatch
              */
             unwatch<P extends TypeOrArray<TitleLike>>(
                 pages: P
@@ -552,7 +551,7 @@ declare global {
              * @param {ApiParseParams} [additionalParams] Parameters object to set custom settings, e.g.
              *   `redirects`, `sectionpreview`. `prop` should not be overridden.
              * @returns {JQuery.Promise<string>} Promise that resolves with the parsed HTML of `wikitext`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.parse-method-parse
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#parse
              */
             parse(content: TitleLike, additionalParams?: ApiParseParams): JQuery.Promise<string>;
 
@@ -563,7 +562,7 @@ declare global {
              * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
              * @returns {JQuery.Promise<Object.<string, string>>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.messages-method-getMessages
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getMessages
              */
             getMessages<T extends string>(
                 messages: T | T[],
@@ -576,7 +575,7 @@ declare global {
              * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
              * @returns {JQuery.Promise<boolean>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.messages-method-loadMessages
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#loadMessages
              */
             loadMessages(
                 messages: string | string[],
@@ -591,7 +590,7 @@ declare global {
              * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
              * @returns {JQuery.Promise<boolean>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.messages-method-loadMessagesIfMissing
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#loadMessagesIfMissing
              */
             loadMessagesIfMissing(
                 messages: string | string[],
@@ -603,7 +602,7 @@ declare global {
              *
              * @param {TitleLike} title
              * @returns {JQuery.Promise<boolean>} Promise that resolves with a boolean indicating whether the category exists.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-isCategory
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#isCategory
              */
             isCategory(title: TitleLike): JQuery.Promise<boolean>;
 
@@ -614,7 +613,7 @@ declare global {
              *
              * @param {string} prefix Prefix to match.
              * @returns {JQuery.Promise<string[]>} Promise that resolves with an array of matched categories
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-getCategoriesByPrefix
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategoriesByPrefix
              */
             getCategoriesByPrefix(prefix: string): JQuery.Promise<string[]>;
 
@@ -623,7 +622,7 @@ declare global {
              *
              * @param {TitleLike} title
              * @returns {JQuery.Promise<false|Title[]>} Promise that resolves with an array of category titles, or with false if the title was not found.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.category-method-getCategories
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategories
              */
             getCategories(title: TitleLike): JQuery.Promise<false | Title[]>;
 
@@ -635,7 +634,7 @@ declare global {
              * @param {string} user
              * @param {ApiRollbackParams} [params] Additional parameters
              * @returns {JQuery.Promise<RollbackInfo>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.rollback-method-rollback
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#rollback
              */
             rollback(
                 page: TitleLike,
@@ -651,7 +650,7 @@ declare global {
              * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
              * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-chunkedUpload
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUpload
              */
             chunkedUpload(
                 file: File,
@@ -672,7 +671,7 @@ declare global {
              * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
              * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
              *  function that should be called to finish the upload.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-chunkedUploadToStash
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUploadToStash
              */
             chunkedUploadToStash(
                 file: File | HTMLInputElement,
@@ -689,7 +688,7 @@ declare global {
              * @param {File|Blob|HTMLInputElement} file HTML `input type=file` element with a file already inside of it, or a File object.
              * @param {ApiUploadParams} data Other upload options, see `action=upload` API docs for more
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-upload
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#upload
              */
             upload(
                 file: File | Blob | HTMLInputElement,
@@ -702,7 +701,7 @@ declare global {
              * @param {string} filekey
              * @param {ApiUploadParams} data
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-uploadFromStash
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#uploadFromStash
              */
             uploadFromStash(filekey: string, data: ApiUploadParams): JQuery.Promise<ApiResponse>;
 
@@ -728,7 +727,7 @@ declare global {
              * @param {ApiUploadParams} [data]
              * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
              *  function that should be called to finish the upload.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.upload-method-uploadToStash
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#uploadToStash
              */
             uploadToStash(
                 file: File | HTMLInputElement,
@@ -739,12 +738,15 @@ declare global {
              * @param {string} username
              * @param {string} password
              * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api.plugin.login-method-login
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#login
              */
             login(username: string, password: string): JQuery.Promise<ApiResponse>;
         }
 
         namespace Api {
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#.EditTransform
+             */
             interface EditTransform {
                 /**
                  * @param {Object} revision Current revision
@@ -761,7 +763,7 @@ declare global {
              * Default options for {@link jQuery.ajax} calls. Can be overridden by passing
              * `options` to {@link mw.Api} constructor.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-property-defaultOptions
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#.Options
              */
             interface Options {
                 /**
@@ -779,6 +781,9 @@ declare global {
                 useUS?: boolean;
             }
 
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#.UserInfo
+             */
             interface UserInfo {
                 /**
                  * User groups that the user belongs to.
@@ -790,6 +795,9 @@ declare global {
                 rights: string[];
             }
 
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#.WatchedPage
+             */
             interface WatchedPage {
                 ns: number;
                 /**
diff --git a/mw/ForeignApi.d.ts b/mw/ForeignApi.d.ts
index 03a8dd2..aa274ee 100644
--- a/mw/ForeignApi.d.ts
+++ b/mw/ForeignApi.d.ts
@@ -1,7 +1,7 @@
 declare global {
     namespace mw {
         /**
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignApi
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignApi.html
          */
         class ForeignApi extends Api {
             static static: {};
@@ -14,7 +14,7 @@ declare global {
              * with another MediaWiki wiki via cross-origin requests (CORS).
              *
              * The foreign wiki must be configured to accept requests from the current wiki. See
-             * <https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains> for details.
+             * {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains} for details.
              *
              * ```js
              * var api = new mw.ForeignApi( 'https://commons.wikimedia.org/w/api.php' );
@@ -43,7 +43,7 @@ declare global {
              * @since 1.26
              * @param {string|Uri} url URL pointing to another wiki's `api.php` endpoint.
              * @param {ForeignApi.Options} [options] Also accepts all the options from {@link mw.Api.Options}.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignApi-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignApi.html#ForeignApi
              */
             constructor(url: string | Uri, options?: ForeignApi.Options);
 
@@ -51,7 +51,6 @@ declare global {
              * Return the origin to use for API requests, in the required format (protocol, host and port, if any).
              *
              * @returns {string|undefined}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignApi-method-getOrigin
              */
             protected getOrigin(): "*" | `${string}//${string}` | undefined;
         }
diff --git a/mw/ForeignRest.d.ts b/mw/ForeignRest.d.ts
index 218c06a..b4d813f 100644
--- a/mw/ForeignRest.d.ts
+++ b/mw/ForeignRest.d.ts
@@ -1,7 +1,7 @@
 declare global {
     namespace mw {
         /**
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignRest
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignRest.html
          */
         class ForeignRest extends Rest {
             static static: {};
@@ -14,7 +14,7 @@ declare global {
              * with another MediaWiki wiki via cross-origin requests (CORS).
              *
              * The foreign wiki must be configured to accept requests from the current wiki. See
-             * https://www.mediawiki.org/wiki/Manual:$wgCrossSiteAJAXdomains for details.
+             * {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains} for details.
              *
              * ```js
              * var api = new mw.ForeignRest( 'https://commons.wikimedia.org/w/rest.php' );
@@ -39,7 +39,7 @@ declare global {
              * @param {string} url URL pointing to another wiki's `rest.php` endpoint.
              * @param {ForeignApi} foreignActionApi
              * @param {ForeignRest.Options} [options] See {@link mw.Rest}.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.ForeignRest-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignRest.html#ForeignRest
              */
             constructor(url: string, foreignActionApi: ForeignApi, options?: ForeignRest.Options);
         }
diff --git a/mw/ForeignUpload.d.ts b/mw/ForeignUpload.d.ts
index d0edfdc..0cd81e4 100644
--- a/mw/ForeignUpload.d.ts
+++ b/mw/ForeignUpload.d.ts
@@ -9,6 +9,8 @@ declare global {
          * Note you can provide the {@link target} or not - if the first argument is
          * an object, we assume you want the default, and treat it as apiconfig
          * instead.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignUpload.html
          */
         class ForeignUpload extends Upload {
             static static: {};
@@ -28,6 +30,8 @@ declare global {
              *
              * Defaults to the first available foreign upload target,
              * or to local uploads if no foreign target is configured.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignUpload.html#.target
              */
             target: string;
 
@@ -46,6 +50,7 @@ declare global {
              *     Use the same names as set in $wgForeignFileRepos for this. Also,
              *     make sure there is an entry in the $wgForeignUploadTargets array for this name.
              * @param {Api.Options} [apiconfig] Passed to the constructor of mw.ForeignApi or mw.Api, as needed.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignUpload.html#ForeignUpload
              */
             constructor(target: string, apiconfig?: ForeignApi.Options);
             constructor(apiconfig?: Api.Options);
diff --git a/mw/Map.d.ts b/mw/Map.d.ts
index 46b0a68..f91b62b 100644
--- a/mw/Map.d.ts
+++ b/mw/Map.d.ts
@@ -26,7 +26,7 @@ export interface ExtensibleMap<V extends Record<string, any>, TX = unknown>
      *
      * @param selection Key to check
      * @returns True if the key exists
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-exists
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.exists
      */
     exists<S extends keyof V>(selection: S): selection is S;
     exists<S extends string>(selection: S): selection is S;
@@ -40,7 +40,7 @@ export interface ExtensibleMap<V extends Record<string, any>, TX = unknown>
      * @param fallback Value for keys that don't exist.
      * @returns If selection was a string, returns the value. If selection was an array, returns
      * an object of key/values. If no selection is passed, a new object with all key/values is returned.
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-get
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.get
      */
     get<S extends TypeOrArray<keyof V>, TD>(
         selection: S,
@@ -57,7 +57,7 @@ export interface ExtensibleMap<V extends Record<string, any>, TX = unknown>
      * @param selection Key to set value for, or object mapping keys to values
      * @param value Value to set (optional, only in use when key is a string)
      * @returns True on success, false on failure
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-set
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.set
      */
     set<S extends keyof V>(selection: S, value: V[S]): boolean;
     set<S extends string>(selection: S, value: TX): boolean;
@@ -67,7 +67,7 @@ export interface ExtensibleMap<V extends Record<string, any>, TX = unknown>
 declare global {
     namespace mw {
         /**
-         * ES3 compatible class similar to [ES6 Map]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map}.
+         * ES3 compatible class similar to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map ES6 Map}.
          *
          * Create an object that can be read from or written to via methods that allow
          * interaction both with single and multiple properties at once.
@@ -78,17 +78,22 @@ declare global {
          * map.set( 'foo', 5 );
          * alert( 5 === map.get( 'foo' ) );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html
          */
         class Map<V extends Record<string, any> = any> {
             private values: V;
 
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#Map
+             */
+            constructor();
+
             /**
              * Check if a given key exists in the map.
              *
              * @param selection Key to check
              * @returns True if the key exists
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-exists
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.exists
              */
             exists<S extends keyof V>(selection: S): selection is S;
 
@@ -101,7 +106,7 @@ declare global {
              * @param fallback Value for keys that don't exist.
              * @returns If selection was a string, returns the value. If selection was an array, returns
              * an object of key/values. If no selection is passed, a new object with all key/values is returned.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-get
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.get
              */
             get<S extends TypeOrArray<keyof V>, TD>(
                 selection: S,
@@ -116,7 +121,7 @@ declare global {
              * @param selection Key to set value for, or object mapping keys to values
              * @param value Value to set (optional, only in use when key is a string)
              * @returns True on success, false on failure
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Map-method-set
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Map.html#.set
              */
             set<S extends keyof V>(selection: S, value: V[S]): boolean;
             set<S extends Partial<V>>(selection: S): boolean;
diff --git a/mw/RegExp.d.ts b/mw/RegExp.d.ts
index b66cc1a..86a50fe 100644
--- a/mw/RegExp.d.ts
+++ b/mw/RegExp.d.ts
@@ -1,7 +1,7 @@
 declare global {
     namespace mw {
         /**
-         * @see https://doc.wikimedia.org/mediawiki-core/REL1_29/js/source/mediawiki.RegExp.html
+         * @see https://doc.wikimedia.org/mediawiki-core/REL1_33/js/#!/api/mw.RegExp
          */
         namespace RegExp {
             /**
@@ -15,7 +15,7 @@ declare global {
              * @since 1.26
              * @param {string} str String to escape
              * @returns {string} Escaped string
-             * @see https://doc.wikimedia.org/mediawiki-core/REL1_29/js/source/mediawiki.RegExp.html#mw-RegExp-static-method-escape
+             * @see https://doc.wikimedia.org/mediawiki-core/REL1_33/js/#!/api/mw.RegExp-static-method-escape
              */
             function escape(str: string): string;
         }
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index e80bb6e..99bd11b 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -3,7 +3,7 @@ export type RestResponse = Record<string, any>; // Unknown JSON object
 declare global {
     namespace mw {
         /**
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html
          */
         class Rest {
             /**
@@ -32,7 +32,7 @@ declare global {
              * } );
              * ```
              * @param {Rest.Options} [options] See {@link mw.Rest.Options}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#Rest
              */
             constructor(options?: Rest.Options);
 
@@ -41,7 +41,7 @@ declare global {
             /**
              * Abort all unfinished requests issued by this Api object.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-abort
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#abort
              */
             abort(): void;
 
@@ -52,7 +52,7 @@ declare global {
              * @param {Object.<string, any>} query
              * @param {Object.<string, any>} [headers]
              * @returns {JQuery.Promise<RestResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-get
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#get
              */
             get(
                 path: string,
@@ -69,7 +69,7 @@ declare global {
              * @param {Object.<string, any>} [body]
              * @param {Object.<string, any>} [headers]
              * @returns {JQuery.Promise<RestResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-post
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#post
              */
             post(
                 path: string,
@@ -86,7 +86,7 @@ declare global {
              * @param {Object.<string, any>} body
              * @param {Object.<string, any>} [headers]
              * @returns {JQuery.Promise<RestResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-put
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#put
              */
             put(
                 path: string,
@@ -103,7 +103,7 @@ declare global {
              * @param {Object.<string, any>} body
              * @param {Object.<string, any>} [headers]
              * @returns {JQuery.Promise<RestResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Rest-method-delete
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#delete
              */
             delete(
                 path: string,
@@ -117,16 +117,19 @@ declare global {
              * @param {string} path
              * @param {JQuery.AjaxSettings} [ajaxOptions]
              * @returns {JQuery.Promise<RestResponse>} Done: API response data and the jqXHR object.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Api-method-ajax
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#ajax
              */
             ajax(path: string, ajaxOptions?: JQuery.AjaxSettings): JQuery.Promise<RestResponse>;
         }
 
         namespace Rest {
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#.Options
+             */
             interface Options {
                 /**
-                 * Default options for {@link Rest.ajax()} calls. Can be overridden by passing `options` to
-                 * the {@link Rest} constructor.
+                 * Default options for {@link Rest.ajax ajax()} calls. Can be overridden by passing `options` to
+                 * the {@link mw.Rest} constructor.
                  */
                 ajax?: JQuery.AjaxSettings;
             }
diff --git a/mw/Title.d.ts b/mw/Title.d.ts
index 398fcc2..483101e 100644
--- a/mw/Title.d.ts
+++ b/mw/Title.d.ts
@@ -2,6 +2,9 @@ import { QueryParams } from "./Uri";
 
 export type TitleLike = string | mw.Title;
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#~TitleExistenceStore
+ */
 interface TitleExistenceStore {
     /**
      * Keyed by title. Boolean true value indicates page does exist.
@@ -63,13 +66,13 @@ declare global {
          * // => 'Template:Template:Foo'
          * ```
          * @since 1.18
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html
          */
         class Title {
             /**
              * Store page existence
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-property-exist
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.exist
              */
             static exist: TitleExistenceStore;
 
@@ -82,7 +85,7 @@ declare global {
              *  this will be searched for a namespace
              * @param {number} [namespace=NS_MAIN] If given, will used as default namespace for the given title
              * @throws {Error} When the title is invalid
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#Title
              */
             constructor(title: string, namespace?: number);
 
@@ -90,7 +93,7 @@ declare global {
              * Check the title can have an associated talk page.
              *
              * @returns {boolean} The title can have an associated talk page
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-canHaveTalkPage
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#canHaveTalkPage
              */
             canHaveTalkPage(): boolean;
 
@@ -98,7 +101,7 @@ declare global {
              * Whether this title exists on the wiki. See {@link mw.Title.exists}.
              *
              * @returns {boolean|null} Boolean if the information is available, otherwise null
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-exists
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#exists
              */
             exists(): boolean | null;
 
@@ -106,7 +109,7 @@ declare global {
              * Get the extension of the page name (if any).
              *
              * @returns {string|null} Name extension or null if there is none
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getExtension
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getExtension
              */
             getExtension(): string | null;
 
@@ -119,7 +122,7 @@ declare global {
              * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMainText} instead.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getFileNameTextWithoutExtension
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFileNameTextWithoutExtension
              */
             getFileNameTextWithoutExtension(): string;
 
@@ -132,7 +135,7 @@ declare global {
              * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMain} instead.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getFileNameWithoutExtension
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFileNameWithoutExtension
              */
             getFileNameWithoutExtension(): string;
 
@@ -143,7 +146,7 @@ declare global {
              * the value is not url encoded.
              *
              * @returns {string|null}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getFragment
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFragment
              */
             getFragment(): string | null;
 
@@ -153,7 +156,7 @@ declare global {
              * Example: `Example_image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getMain
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getMain
              */
             getMain(): string;
 
@@ -163,7 +166,7 @@ declare global {
              * Example: `Example image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getMainText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getMainText
              */
             getMainText(): string;
 
@@ -176,7 +179,7 @@ declare global {
              * @returns {string} File name without file extension, in the canonical form with underscores
              *  instead of spaces. For example, the title `File:Example_image.svg` will be returned as
              *  "Example_image".
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getName
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getName
              */
             getName(): string;
 
@@ -186,7 +189,7 @@ declare global {
              * Example: 6 for `File:Example_image.svg`.
              *
              * @returns {number}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getNamespaceId
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getNamespaceId
              */
             getNamespaceId(): number;
 
@@ -197,7 +200,7 @@ declare global {
              * In #NS_MAIN this is '', otherwise namespace name plus ':'
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getNamespacePrefix
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getNamespacePrefix
              */
             getNamespacePrefix(): string;
 
@@ -210,7 +213,7 @@ declare global {
              * @returns {string} File name without file extension, formatted with spaces instead of
              *  underscores. For example, the title `File:Example_image.svg` will be returned as
              *  `Example image`.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getNameText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getNameText
              */
             getNameText(): string;
 
@@ -221,7 +224,7 @@ declare global {
              * Most useful for API calls, anything that must identify the "title".
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getPrefixedDb
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getPrefixedDb
              */
             getPrefixedDb(): string;
 
@@ -231,7 +234,7 @@ declare global {
              * Example: `File:Example image.svg` for `File:Example_image.svg`.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getPrefixedText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getPrefixedText
              */
             getPrefixedText(): string;
 
@@ -246,7 +249,7 @@ declare global {
              *
              * @param {number} namespace The namespace to be relative to
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getRelativeText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getRelativeText
              */
             getRelativeText(namespace: number): string;
 
@@ -254,7 +257,7 @@ declare global {
              * Get the title for the subject page of a talk page.
              *
              * @returns {Title|null} The title for the subject page of a talk page, null if not available
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getSubjectPage
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getSubjectPage
              */
             getSubjectPage(): Title | null;
 
@@ -262,7 +265,7 @@ declare global {
              * Get the title for the associated talk page.
              *
              * @returns {Title|null} The title for the associated talk page, null if not available
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getTalkPage
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getTalkPage
              */
             getTalkPage(): Title | null;
 
@@ -272,7 +275,7 @@ declare global {
              * @param {QueryParams} [params] A mapping of query parameter names to values,
              *     e.g. `{ action: 'edit' }`.
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-getUrl
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getUrl
              */
             getUrl(params?: QueryParams): string;
 
@@ -280,21 +283,21 @@ declare global {
              * Check if the title is in a talk namespace.
              *
              * @returns {boolean} The title is in a talk namespace
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-isTalkPage
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#isTalkPage
              */
             isTalkPage(): boolean;
 
             /**
              * Alias of {@link getPrefixedDb}.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-toString
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#toString
              */
             toString(): string;
 
             /**
              * Alias of {@link getPrefixedText}.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-toText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#toText
              */
             toText(): string;
 
@@ -304,7 +307,7 @@ declare global {
              * @param {string|Title} title prefixed db-key name (string) or instance of Title
              * @returns {boolean|null} Boolean if the information is available, otherwise null
              * @throws {Error} If title is not a string or mw.Title
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-exists
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.exists
              */
             static exists(title: TitleLike): boolean | null;
 
@@ -315,7 +318,7 @@ declare global {
              *
              * @param {number} namespaceId Namespace ID
              * @returns {boolean} Namespace is a talk namespace
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-isTalkNamespace
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.isTalkNamespace
              */
             static isTalkNamespace(namespaceId: number): boolean;
 
@@ -331,7 +334,7 @@ declare global {
              * @param {number} namespace Namespace to use for the title
              * @param {string} title
              * @returns {Title|null} A valid Title object or null if the title is invalid
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-makeTitle
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.makeTitle
              */
             static makeTitle(namespace: number, title: string): Title | null;
 
@@ -343,7 +346,7 @@ declare global {
              * @param {string} uncleanName The unclean file name including file extension but
              *   without namespace
              * @returns {Title|null} A valid Title object or null if the title is invalid
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-newFromFileName
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromFileName
              */
             static newFromFileName(uncleanName: string): Title | null;
 
@@ -356,7 +359,7 @@ declare global {
              * ```
              * @param {HTMLElement|JQuery} img The image to use as a base
              * @returns {Title|null} The file title or null if unsuccessful
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-newFromImg
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromImg
              */
             static newFromImg(img: HTMLElement | JQuery): Title | null;
 
@@ -370,7 +373,7 @@ declare global {
              * @param {string} title
              * @param {number} [namespace=NS_MAIN] Default namespace
              * @returns {Title|null} A valid Title object or null if the title is invalid
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-newFromText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromText
              */
             static newFromText(title: string, namespace?: number): Title | null;
 
@@ -387,7 +390,7 @@ declare global {
              *  There are pages in the file namespace under which file upload is impossible.
              *  Automatically assumed if the title is created in the Media namespace.
              * @returns {Title|null} A valid Title object or null if the input cannot be turned into a valid title
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-static-method-newFromUserInput
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromUserInput
              */
             static newFromUserInput(
                 title: string,
@@ -402,7 +405,7 @@ declare global {
              *
              * @param {string} extension File extension (without the leading dot)
              * @returns {string} File extension in canonical form
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-normalizeExtension
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.normalizeExtension
              */
             static normalizeExtension(extension: string): string;
 
@@ -411,7 +414,7 @@ declare global {
              *
              * @param {string} chr Unicode character
              * @returns {string} Unicode character, in upper case, according to the same rules as in PHP
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-phpCharToUpper
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.phpCharToUpper
              */
             static phpCharToUpper(chr: string): string;
 
@@ -422,7 +425,7 @@ declare global {
              *
              * @param {number} namespaceId Namespace ID
              * @returns {boolean} Namespace is a signature namespace
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Title-method-wantSignaturesNamespace
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.wantSignaturesNamespace
              */
             static wantSignatureNamespace(namespaceId: number): boolean;
         }
diff --git a/mw/Upload.d.ts b/mw/Upload.d.ts
index c733960..6a33407 100644
--- a/mw/Upload.d.ts
+++ b/mw/Upload.d.ts
@@ -45,6 +45,8 @@ declare global {
          *     } );
          * } );
          * ```
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html
          */
         class Upload {
             /**
@@ -93,6 +95,7 @@ declare global {
              *
              * @param {Api|Api.Options} [apiconfig] A mw.Api object (or subclass), or configuration
              *     to pass to the constructor of mw.Api.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#Upload
              */
             constructor(apiconfig?: Api | Api.Options);
 
@@ -100,6 +103,7 @@ declare global {
              * Finish a stash upload.
              *
              * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#finishStashUpload
              */
             finishStashUpload(): JQuery.Promise<ApiResponse>;
 
@@ -107,6 +111,7 @@ declare global {
              * Get the mw.Api instance used by this Upload object.
              *
              * @returns {JQuery.Promise<Api>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getApi
              */
             getApi(): JQuery.Promise<Api>;
 
@@ -115,6 +120,7 @@ declare global {
              *
              * @param {string} path
              * @returns {string}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getBasename
              */
             getBasename(path: string): string;
 
@@ -122,6 +128,7 @@ declare global {
              * Get the current value of the edit comment for the upload.
              *
              * @returns {string}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getComment
              */
             getComment(): string;
 
@@ -129,6 +136,7 @@ declare global {
              * Get the file being uploaded.
              *
              * @returns {HTMLInputElement|File|Blob}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getFile
              */
             getFile(): HTMLInputElement | File | Blob;
 
@@ -136,6 +144,7 @@ declare global {
              * Get the filename, to be finalized on upload.
              *
              * @returns {string}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getFilename
              */
             getFilename(): string;
 
@@ -145,6 +154,7 @@ declare global {
              * beforehand.
              *
              * @returns {ApiResponse|undefined}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getImageInfo
              */
             getImageInfo(): ApiResponse | undefined;
 
@@ -152,6 +162,7 @@ declare global {
              * Gets the state of the upload.
              *
              * @returns {Upload.State}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getState
              */
             getState(): Upload.State;
 
@@ -159,6 +170,7 @@ declare global {
              * Gets details of the current state.
              *
              * @returns {any}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getStateDetails
              */
             getStateDetails(): any;
 
@@ -166,6 +178,7 @@ declare global {
              * Get the text of the file page, to be created on file upload.
              *
              * @returns {string}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getText
              */
             getText(): string;
 
@@ -173,6 +186,7 @@ declare global {
              * Get the boolean for whether the file will be watchlisted after upload.
              *
              * @returns {boolean}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#getWatchlist
              */
             getWatchlist(): boolean;
 
@@ -180,6 +194,7 @@ declare global {
              * Set the edit comment for the upload.
              *
              * @param {string} comment
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setComment
              */
             setComment(comment: string): void;
 
@@ -187,6 +202,7 @@ declare global {
              * Set the file to be uploaded.
              *
              * @param {HTMLInputElement|File|Blob} file
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setFile
              */
             setFile(file: HTMLInputElement | File | Blob): void;
 
@@ -194,6 +210,7 @@ declare global {
              * Set the stashed file to finish uploading.
              *
              * @param {string} filekey
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setFilekey
              */
             setFilekey(filekey: string): void;
 
@@ -201,11 +218,14 @@ declare global {
              * Set the filename, to be finalized on upload.
              *
              * @param {string} filename
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setFilename
              */
             setFilename(filename: string): void;
 
             /**
              * Sets the filename based on the filename as it was on the upload.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setFilenameFromFile
              */
             setFilenameFromFile(): void;
 
@@ -214,6 +234,7 @@ declare global {
              *
              * @param {Upload.State} state
              * @param {any} stateDetails
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setState
              */
             setState(state: Upload.State, stateDetails: any): void;
 
@@ -221,6 +242,7 @@ declare global {
              * Set the text of the file page, to be created on file upload.
              *
              * @param {string} text
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setText
              */
             setText(text: string): void;
 
@@ -228,6 +250,7 @@ declare global {
              * Set whether the file should be watchlisted after upload.
              *
              * @param {boolean} watchlist
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#setWatchlist
              */
             setWatchlist(watchlist: boolean): void;
 
@@ -235,6 +258,7 @@ declare global {
              * Upload the file directly.
              *
              * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#upload
              */
             upload(): JQuery.Promise<ApiResponse>;
 
@@ -242,6 +266,7 @@ declare global {
              * Upload the file to the stash to be completed later.
              *
              * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#uploadToStash
              */
             uploadToStash(): JQuery.Promise<ApiResponse>;
         }
@@ -249,35 +274,37 @@ declare global {
         namespace Upload {
             /**
              * State of uploads represented in simple terms.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Upload.html#.State
              */
             enum State {
                 /**
-                 * Upload not yet started
+                 * Upload not yet started.
                  */
                 NEW,
 
                 /**
-                 * Upload finished, but there was a warning
+                 * Upload finished, but there was a warning.
                  */
                 WARNING,
 
                 /**
-                 * Upload finished, but there was an error
+                 * Upload finished, but there was an error.
                  */
                 ERROR,
 
                 /**
-                 * Upload in progress
+                 * Upload in progress.
                  */
                 UPLOADING,
 
                 /**
-                 * Upload finished, but not published, call #finishStashUpload
+                 * Upload finished, but not published, call #finishStashUpload.
                  */
                 STASHED,
 
                 /**
-                 * Upload finished and published
+                 * Upload finished and published.
                  */
                 UPLOADED,
             }
diff --git a/mw/Uri.d.ts b/mw/Uri.d.ts
index 98ca249..9b9d720 100644
--- a/mw/Uri.d.ts
+++ b/mw/Uri.d.ts
@@ -14,7 +14,7 @@ declare global {
          * @param {string|Function} documentLocation A full url, or function returning one.
          *  If passed a function, the return value may change over time and this will be honoured. (T74334)
          * @returns {Function} An mw.Uri class constructor
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-UriRelative
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.UriRelative
          */
         function UriRelative(documentLocation: string | (() => string)): typeof Uri;
 
@@ -71,55 +71,55 @@ declare global {
          * Parsing based on parseUri 1.2.2 (c) Steven Levithan <http://stevenlevithan.com>, MIT License.
          * <http://stevenlevithan.com/demo/parseuri/js/>
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html
          */
         class Uri {
             /**
              * For example `top`.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-fragment
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#fragment
              */
             fragment: string | undefined;
             /**
              * For example `www.example.com` (always present).
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-host
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#host
              */
             host: string;
             /**
              * For example `pwd`.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-password
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#password
              */
             password: string | undefined;
             /**
              * For example `/dir/dir.2/index.htm` (always present).
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-path
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#path
              */
             path: string;
             /**
              * For example `81`.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-port
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#port
              */
             port: string | undefined;
             /**
              * For example `http` (always present).
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-protocol
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#protocol
              */
             protocol: string;
             /**
              * For example `{ a: '0', b: '', c: 'value' }` (always present).
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-query
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#query
              */
             query: QueryParams;
             /**
              * For example `usr`.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-property-user
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#user
              */
             user: string | undefined;
 
@@ -129,15 +129,11 @@ declare global {
              * These are gnarly expressions. For improved readability, they have been moved to a separate
              * file where they make use of named capture groups. That syntax isn't valid in JavaScript ES5,
              * so the server-side strips these before delivering to the client.
-             *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-static-property-parser
              */
             private static parser: UriParser;
 
             /**
              * The order here matches the order of captured matches in the `parser` property regexes.
-             *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-static-property-properties
              */
             private static properties: [
                 "protocol",
@@ -161,7 +157,7 @@ declare global {
              * @param {Uri.UriOptions|boolean} [options] Object with options, or (backwards compatibility) a boolean
              *  for strictMode
              * @throws {Error} when the query string or fragment contains an unknown % sequence
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#Uri
              */
             constructor(
                 uri?: string | Uri | Partial<Record<typeof Uri.properties[number], string>>,
@@ -172,7 +168,7 @@ declare global {
              * Clone this URI.
              *
              * @returns {Uri} New URI object with same properties
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-clone
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#clone
              */
             clone(): Uri;
 
@@ -182,7 +178,7 @@ declare global {
              * @param {QueryParams} parameters Query parameters to add to ours (or to override ours with) as an
              *  object
              * @returns {Uri} This URI object
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-extend
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#extend
              */
             extend(parameters: QueryParams): Uri;
 
@@ -192,7 +188,7 @@ declare global {
              * In most real-world URLs this is simply the hostname, but the definition of 'authority' section is more general.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-getAuthority
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#getAuthority
              */
             getAuthority(): string;
 
@@ -200,7 +196,7 @@ declare global {
              * Get host and port section of a URI.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-getHostPort
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#getHostPort
              */
             getHostPort(): string;
 
@@ -210,7 +206,7 @@ declare global {
              * Does not preserve the original order of arguments passed in the URI. Does handle escaping.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-getQueryString
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#getQueryString
              */
             getQueryString(): string;
 
@@ -218,7 +214,7 @@ declare global {
              * Get everything after the authority section of the URI.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-getRelativePath
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#getRelativePath
              */
             getRelativePath(): string;
 
@@ -226,7 +222,7 @@ declare global {
              * Get user and password section of a URI.
              *
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-getUserInfo
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#getUserInfo
              */
             getUserInfo(): string;
 
@@ -242,7 +238,7 @@ declare global {
              * is important.
              *
              * @returns {string} The URI string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-toString
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#toString
              */
             toString(): `${string}://${string}`;
 
@@ -252,7 +248,6 @@ declare global {
              * @param {string} str URI, see constructor.
              * @param {Uri.UriOptions} options See constructor.
              * @throws {Error} when the query string or fragment contains an unknown % sequence
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-method-parse
              */
             private parse(str: string, options: Uri.UriOptions): void;
 
@@ -265,7 +260,7 @@ declare global {
              * @param {string} s String to decode
              * @returns {string} Decoded string
              * @throws {Error} when the string contains an unknown % sequence
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-static-method-decode
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#.decode
              */
             static decode(s: string): string;
 
@@ -278,12 +273,15 @@ declare global {
              *
              * @param {string} s String to encode
              * @returns {string} Encoded string for URI
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Uri-static-method-encode
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#.encode
              */
             static encode(s: string): string;
         }
 
         namespace Uri {
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Uri.html#.UriOptions
+             */
             interface UriOptions {
                 /**
                  * Whether to parse array query parameters (e.g. `&foo[0]=a&foo[1]=b` or `&foo[]=a&foo[]=b`) or leave them alone.
diff --git a/mw/cldr.d.ts b/mw/cldr.d.ts
index b344e80..9cea46d 100644
--- a/mw/cldr.d.ts
+++ b/mw/cldr.d.ts
@@ -3,6 +3,8 @@ declare global {
         /**
          * Namespace for CLDR-related utility methods.
          * Provided by the `mediawiki.cdlr` ResourceLoader module.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cldr.html
          */
         namespace cldr {
             /**
@@ -14,6 +16,7 @@ declare global {
              * @param {number} number
              * @param {string[]} pluralRules
              * @returns {number} plural form index
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cldr.html#.getPluralForm
              */
             function getPluralForm(number: number, pluralRules: string[]): number;
         }
diff --git a/mw/config.d.ts b/mw/config.d.ts
index ba74e7f..3f2fd6a 100644
--- a/mw/config.d.ts
+++ b/mw/config.d.ts
@@ -5,13 +5,13 @@ declare global {
         /**
          * Map of configuration values.
          *
-         * Check out {@link https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#mw.config the complete list of configuration values}
+         * Check out {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#mw.config the complete list of configuration values}
          * on mediawiki.org.
          *
          * If `$wgLegacyJavaScriptGlobals` is true, this Map will add its values to the
          * global `window` object.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-property-config
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.config
          */
         const config: ExtensibleMap<{
             /**
@@ -19,64 +19,64 @@ declare global {
              *
              * In MediaWiki 1.35 and earlier, false and true were used (phab:T85805).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#debug
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#debug
              */
             debug: boolean | number;
             /**
              * The internal name of the currently used skin.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#skin
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#skin
              */
             skin: string;
             /**
              * Full URL to the root directory for skins, containing stylesheets and skin-specific scripts. The path does not contain the skin subdirectory, and is not terminated by a "/".
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#stylepath
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#stylepath
              */
             stylepath: string;
             wgActionPaths: Record<string, string>;
             /**
              * Local path, starting at the root, to reference articles, containing a "$1" placeholder that may be replaced by a page title to get a valid URL to that page. Given a valid page title title, a valid URL may be constructed using wgArticlePath.replace('$1', title). See also $wgArticlePath.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgArticlePath
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgArticlePath
              */
             wgArticlePath: string;
             /**
              * The IDs of the namespaces treated as case-sensitive by MediaWiki. Determined by the values of them $wgCapitalLinks and $wgCapitalLinksOverrides configuration variables.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgCaseSensitiveNamespaces
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgCaseSensitiveNamespaces
              */
             wgCaseSensitiveNamespaces: number[];
             wgCommentCodePointLimit: number;
             /**
              * The language code for the default content language of the wiki.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgContentLanguage
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgContentLanguage
              */
             wgContentLanguage: string;
             /**
              * The IDs of the namespaces considered "content namespaces" by MediaWiki. Equivalent to the value of the $wgContentNamespaces configuration variable, with 0 included if it is not already.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgContentNamespaces
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgContentNamespaces
              */
             wgContentNamespaces: number[];
             /**
              * The name of the wiki's database.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgDBname
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgDBname
              */
             wgDBname: string;
             /**
              * Root path used for extension static assets (e.g. images). Append '/' then the name of the extension to get the root path for a given extension.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgExtensionAssetsPath
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgExtensionAssetsPath
              */
             wgExtensionAssetsPath: string;
             wgExtraSignatureNamespaces: number[];
             /**
              * Gives a mapping from namespace IDs to localized namespace names. For each namespace, the object has one entry that has the stringified namespace number as the key and the namespace name as its value. Aliases or canonical names are not included.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgFormattedNamespaces
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgFormattedNamespaces
              */
             wgFormattedNamespaces: Record<number, string>;
             wgIllegalFileChars: string;
@@ -84,37 +84,37 @@ declare global {
             /**
              * Gives a mapping from namespace names to namespace IDs. For each namespace name, including localized and canonical names as well as aliases, the object has one entry that has namespace name as the key and the namespace ID as its integer value. The keys are all lowercase, with spaces replaced by underscores.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgNamespaceIds
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgNamespaceIds
              */
             wgNamespaceIds: Record<string, number>;
             /**
              * Full path to the main access point script, starting at the root, including the full script name with extension. On WMF wikis, normally "/w/index.php". See also $wgScript.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgScript
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgScript
              */
             wgScript: string;
             /**
              * The path part of wgScript, without trailing "/". This is the path to use for direct calls to the php access points such as index.php or api.php. See also $wgScriptPath.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgScriptPath
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgScriptPath
              */
             wgScriptPath: string;
             /**
              * The server URL, not terminated by "/". The combination wgServer + wgScriptPath + "/api.php", for instance, results in a valid URL to the API access point script.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgServer
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgServer
              */
             wgServer: string;
             /**
              * The name of the server, without the protocol or trailing slash (e.g. "en.wikipedia.org").
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgServerName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgServerName
              */
             wgServerName: string;
             /**
              * The name of the site, as defined by $wgSitename.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgSiteName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgSiteName
              */
             wgSiteName: string;
             wgTranslateNumerals: boolean;
@@ -122,55 +122,55 @@ declare global {
             /**
              * If a wiki has language variants (such as the Chinese and the Serbian Wikipedias), set to a path beginning at the root for language variants other than wgContentLanguage. The path contains two placeholders: "$1" is to be replaced by the page title, and "$2" is to be replaced by the language code of the language variant (e.g. "zh-tw"). If the wiki does not have language variants, set to false. See also $wgVariantArticlePath.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgVariantArticlePath
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgVariantArticlePath
              */
             wgVariantArticlePath: string | false;
             /**
              * Identifies the version of MediaWiki that served the page.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgVersion
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgVersion
              */
             wgVersion: string;
             /**
              * The wiki identifier. Should be preferred over wgDBname.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgWikiID
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgWikiID
              */
             wgWikiID: string;
             /**
              * The action performed, e.g. "edit" for edit pages, or "view" for page views. See Manual:Parameters to index.php#Actions.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgAction
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgAction
              */
             wgAction: string;
             /**
              * The internal ID (page ID) of the page. For non-existent pages and special pages, it is zero.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgArticleId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgArticleId
              */
             wgArticleId: number;
             /**
              * The canonical (i.e., not localized or aliased) namespace name of the page.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgCanonicalNamespace
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgCanonicalNamespace
              */
             wgCanonicalNamespace: string;
             /**
              * On special pages, the canonical (i.e., not localized or aliased) name of the special page; otherwise it is not defined at all (up to and including MW 1.15) or is set to false (since MW 1.16).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgCanonicalSpecialPageName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgCanonicalSpecialPageName
              */
             wgCanonicalSpecialPageName: string | false;
             /**
              * The list of all the categories a page belongs to. This is essentially a JavaScript version of the category box shown on the page (grey box at bottom of page, in Monobook/Vector). If the category box is not shown on the current page (as is the case when editing/viewing history), wgCategories will be an empty array.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgCategories
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgCategories
              */
             wgCategories: string[];
             /**
              * The top revision ID of the currently viewed page at the time the page was served. Also set on diff and history pages; zero for special pages.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgCurRevisionId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgCurRevisionId
              */
             wgCurRevisionId: number;
             /**
@@ -178,73 +178,73 @@ declare global {
              *
              * This variable is badly named – it is not related to a page being a main namespace "article".
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgIsArticle
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgIsArticle
              */
             wgIsArticle: boolean;
             /**
              * True if the page is probably editable (based on Title::quickUserCan) by the current user. The 'probably' is necessary for performance reasons. An exact editability check is too costly here, due to cascading protection and hook-based extensions like TitleBlacklist that may be enabled. If this is true, it is likely to be editable. If it is false, it is definitely not editable.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgIsProbablyEditable
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgIsProbablyEditable
              */
             wgIsProbablyEditable: boolean;
             /**
              * true if the page is a redirect to a wiki page using #REDIRECT [[Target page name]]. It is false for anything else (normal pages, special pages, most generated pages, etc.).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgIsRedirect
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgIsRedirect
              */
             wgIsRedirect: boolean;
             /**
              * The number of the namespace the page is in.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgNamespaceNumber
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgNamespaceNumber
              */
             wgNamespaceNumber: number;
             /**
              * Language code of the page content language (according to $context->getTitle()->getPageLanguage())
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgPageContentLanguage
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPageContentLanguage
              */
             wgPageContentLanguage: string;
             /**
              * 'wikitext' on typical wiki pages, 'javascript' on pages interpreted as JavaScript, 'css' on pages interpreted as CSS, 'Scribunto' on pages interpreted as Scribunto (Lua).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgPageContentModel
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPageContentModel
              */
             wgPageContentModel: string;
             /**
              * The full name of the page, including the localized namespace name, if the namespace has a name (the main namespace (number 0) doesn't), and with spaces replaced by underscores. To get only the title without the namespace, use wgTitle.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgPageName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPageName
              */
             wgPageName: string;
             /**
              * Parser limit report for the page when parser data is available. Includes data about parset limits, Lua statistics when Scribunto extension is enabled and parser cache information.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgPageParseReport
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPageParseReport
              */
             wgPageParseReport: PageParseReport;
             /**
              * When redirected contains the title of the page we were redirected from. If the page was not redirected, the value is omitted entirely (absent in mw.config). Uses the same format as wgPageName
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRedirectedFrom
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRedirectedFrom
              */
             wgRedirectedFrom?: string;
             /**
              * The full name of the page to which content actions and navigation links (e.g. a skin's tabs) apply. The AJAX watch function uses this to work correctly on special pages such as Special:MovePage and Special:WhatLinksHere.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRelevantPageName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRelevantPageName
              */
             wgRelevantPageName: string;
             /**
              * The relevant name of the user to which content actions and some extra navigation links (e.g. link to user rights or user contributions) apply.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRelevantUserName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRelevantUserName
              */
             wgRelevantUserName?: string;
             /**
              * Like wgIsProbablyEditable, but applied to the contextually relevant page name from wgRelevantPageName instead of strictly the current page being viewed. For example, when viewing a page "Special:MovePage/Example" this will indicate whether the subject page is editable.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRelevantPageIsProbablyEditable
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRelevantPageIsProbablyEditable
              */
             wgRelevantPageIsProbablyEditable: boolean;
             /**
@@ -254,7 +254,7 @@ declare global {
              *
              * If the page does not exist, the variable is not set.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRestrictionEdit
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRestrictionEdit
              */
             wgRestrictionEdit?: string[];
             /**
@@ -262,67 +262,67 @@ declare global {
              *
              * This array contains only explicit protections. Namespace-wide protections (e.g. MediaWiki namespace, $wgNamespaceProtection), cascading protections, or "protections" brought about by the TitleBlacklist extension's "moveonly" attribute, are ignored by this array. On such pages, the value is normally [], unless additional protections have been applied specifically to that page.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRestrictionMove
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRestrictionMove
              */
             wgRestrictionMove: string[];
             /**
              * The revision ID of the currently viewed revision, or the right revision for diff views (But 0 when diffonly=yes, task T231744). Also set on diff pages; zero for special pages, history pages, or anywhere else inapplicable.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgRevisionId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgRevisionId
              */
             wgRevisionId: number;
             /**
              * The name of the search backend used to execute search requests.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgSearchType
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgSearchType
              */
             wgSearchType: string | null;
             /**
              * The page title, without the namespace. May contain spaces – does not contain underscores. To get the title including the namespace, use wgPageName.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgTitle
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgTitle
              */
             wgTitle: string;
             /**
              * The number of edits the current user made (null if not logged in).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserEditCount
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserEditCount
              */
             wgUserEditCount?: number;
             /**
              * An array containing all the (local) user groups the current user is a member of, or null for non-logged-in users. User groups are identified by the internal user group names, e.g. "sysop", "autoconfirmed", "bureaucrat", and so on. The default user group is named "*".
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserGroups
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserGroups
              */
             wgUserGroups: string[] | null;
             /**
              * The numeric ID of the current user (null if not logged in).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserId
              */
             wgUserId?: number;
             /**
              * The language code for the user's interface language, as set in Special→Preferences (which may be overridden by a uselang= parameter in the URL).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserLanguage
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserLanguage
              */
             wgUserLanguage: string;
             /**
              * The user name of the user currently viewing the page, if it's a logged-in user. For non-logged-in users, it is null (not the user's IP address, unlike PHP $wgUser->getName() on the server).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserName
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserName
              */
             wgUserName: string | null;
             /**
              * The time and date on which the current user registered, represented as milliseconds since epoch. Null if not logged in.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserRegistration
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserRegistration
              */
             wgUserRegistration?: number;
             /**
              * true if the current page is the main page of the wiki. Omitted entirely otherwise (defaulting to null in mw.config).
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgIsMainPage
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgIsMainPage
              */
             wgIsMainPage?: true;
             /**
@@ -333,7 +333,7 @@ declare global {
              * mw.config.get( 'wgUserVariant' ); // null.
              * ```
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgUserVariant
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgUserVariant
              */
             wgUserVariant?: string;
             /**
@@ -345,19 +345,19 @@ declare global {
              *
              * On rollback, this is null
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgPostEdit
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPostEdit
              */
             wgPostEdit?: "created" | "restored" | "saved";
             /**
              * Revision ID of the "old" revision when viewing a diff. Only available when viewing a revision comparison.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgDiffOldId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgDiffOldId
              */
             wgDiffOldId?: number;
             /**
              * Revision ID of the "new" revision when viewing a diff. Only available when viewing a revision comparison.
              *
-             * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#wgDiffNewId
+             * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgDiffNewId
              */
             wgDiffNewId?: number;
         }>;
diff --git a/mw/confirmCloseWindow.d.ts b/mw/confirmCloseWindow.d.ts
index 77919de..887b8e0 100644
--- a/mw/confirmCloseWindow.d.ts
+++ b/mw/confirmCloseWindow.d.ts
@@ -63,6 +63,7 @@ declare global {
          * ```
          * @param {Options} [options]
          * @returns {ConfirmCloseWindow} An object of functions to work with this module
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.confirmCloseWindow
          */
         function confirmCloseWindow(options?: Options): ConfirmCloseWindow;
     }
diff --git a/mw/cookie.d.ts b/mw/cookie.d.ts
index 7bc0ea5..9ca7a2a 100644
--- a/mw/cookie.d.ts
+++ b/mw/cookie.d.ts
@@ -13,7 +13,7 @@ declare global {
          *     mw.cookie.set('hello', 'world' );
          * })
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cookie.html
          */
         namespace cookie {
             /**
@@ -23,7 +23,7 @@ declare global {
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
              * @param {string|null} [defaultValue] A value to return if the cookie does not exist
              * @returns {string|null} If the cookie exists, the value of the cookie, otherwise `defaultValue`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-get
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cookie.html#.get
              */
             function get<D extends string | null>(
                 key: string,
@@ -39,7 +39,7 @@ declare global {
              * @param {string} [prefix] The prefix of the key. If undefined or null, `$wgCookiePrefix` is used
              * @param {string|null} [defaultValue] A value to return if the cookie does not exist
              * @returns {string|null|undefined} If the cookie exists, the value of the cookie, otherwise `defaultValue`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-getCrossSite
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cookie.html#.getCrossSite
              */
             function getCrossSite<D extends string | null>(
                 key: string,
@@ -60,7 +60,7 @@ declare global {
              * @param {string} key
              * @param {string|null} value Value of cookie. If `value` is `null` then this method will instead remove a cookie by name of `key`
              * @param {CookieOptions|Date|number} [options] Options object, or expiry date
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.cookie-method-set
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cookie.html#.set
              */
             // see https://stackoverflow.com/a/64932909 for <SS>
             function set<SS extends string = SameSite>(
@@ -71,6 +71,8 @@ declare global {
 
             /**
              * Custom scope for cookie key, must match the way it was set.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.cookie.html#.CookieOptions
              */
             interface CookieOptions<SS extends string = SameSite> {
                 /**
diff --git a/mw/debug.d.ts b/mw/debug.d.ts
index 7349dbf..98de6a8 100644
--- a/mw/debug.d.ts
+++ b/mw/debug.d.ts
@@ -41,15 +41,20 @@ declare global {
          * Enabled server-side through `$wgDebugToolbar`.
          *
          * @since 1.19
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html
          */
         namespace Debug {
             /**
              * Toolbar container element.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.$container
              */
             const $container: JQuery;
 
             /**
              * Object containing data for the debug toolbar.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.data
              */
             const data: Data;
 
@@ -57,6 +62,7 @@ declare global {
              * Build the console panel.
              *
              * @returns {JQuery} Console panel
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildConsoleTable
              */
             function buildConsoleTable(): JQuery;
 
@@ -64,11 +70,14 @@ declare global {
              * Build legacy debug log pane.
              *
              * @returns {JQuery}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildDebugLogTable
              */
             function buildDebugLogTable(): JQuery;
 
             /**
              * Construct the HTML for the debugging toolbar.
+             *
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildHtml
              */
             function buildHtml(): void;
 
@@ -76,6 +85,7 @@ declare global {
              * Build included files pane.
              *
              * @returns {JQuery}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildIncludesPane
              */
             function buildIncludesPane(): JQuery;
 
@@ -83,6 +93,7 @@ declare global {
              * Build query list pane.
              *
              * @returns {JQuery}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildQueryTable
              */
             function buildQueryTable(): JQuery;
 
@@ -90,6 +101,7 @@ declare global {
              * Build request information pane.
              *
              * @returns {JQuery}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.buildRequestPane
              */
             function buildRequestPane(): JQuery;
 
@@ -100,6 +112,7 @@ declare global {
              * (since it binds to elements on the page).
              *
              * @param {Data} [data] Defaults to 'debugInfo' from {@link mw.config}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.init
              */
             function init(data?: Data): void;
 
@@ -110,6 +123,7 @@ declare global {
              * because it's meant to be an event handler.
              *
              * @param {JQuery.Event} e
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Debug.html#.switchPane
              */
             function switchPane(e: JQuery.Event): void;
         }
diff --git a/mw/deflate.d.ts b/mw/deflate.d.ts
index 374f27f..c8cb751 100644
--- a/mw/deflate.d.ts
+++ b/mw/deflate.d.ts
@@ -12,8 +12,7 @@ declare global {
          * ```
          * @param {string|ArrayBuffer} data Undeflated data
          * @returns {string} Deflated data
-         * @see https://github.com/wikimedia/mediawiki/blob/master/resources/src/mediawiki.deflate/mw.deflate.js#L3
-         * @see https://doc.wikimedia.org/mediawiki-core/master/php/classDeflate.html
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.deflate
          */
         function deflate(data: string | ArrayBuffer): `rawdeflate,${string}`;
     }
diff --git a/mw/errorLogger.d.ts b/mw/errorLogger.d.ts
index 032435d..677c046 100644
--- a/mw/errorLogger.d.ts
+++ b/mw/errorLogger.d.ts
@@ -2,6 +2,8 @@ declare global {
     namespace mw {
         /**
          * Allows the logging of client errors for later inspections.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.errorLogger.html
          */
         namespace errorLogger {
             /**
@@ -12,7 +14,7 @@ declare global {
              * @param {string} [topic='error.caught'] Error topic. Conventionally in the form
              *   'error.%component%' (where %component% identifies the code logging the error at a
              *   high level; e.g. an extension name).
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.errorLogger.html#.logError
              */
             function logError(error: Error, topic?: `error.${string}`): void;
         }
diff --git a/mw/experiments.d.ts b/mw/experiments.d.ts
index 55938bc..d52469e 100644
--- a/mw/experiments.d.ts
+++ b/mw/experiments.d.ts
@@ -18,7 +18,7 @@ declare global {
         /**
          * Provides an API for bucketing users in experiments.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.experiments
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.experiments.html
          */
         namespace experiments {
             /**
@@ -53,7 +53,7 @@ declare global {
              * @param {string} token A token that uniquely identifies the user for the
              *  duration of the experiment
              * @returns {string|undefined} The bucket
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.experiments-method-getBucket
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.experiments.html#.getBucket
              */
             function getBucket(experiment: Experiment, token: string): string | undefined;
         }
diff --git a/mw/global.d.ts b/mw/global.d.ts
index f50fe43..bd6873e 100644
--- a/mw/global.d.ts
+++ b/mw/global.d.ts
@@ -1,16 +1,10 @@
 declare global {
-    /**
-     * Global variables and functions.
-     *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global
-     */
-
     /**
      * Schedule a function to run once the page is ready (DOM loaded).
      *
      * @since 1.5.8
      * @param {Function} fn
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global-method-addOnloadHook
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/window.html#.addOnloadHook
      */
     function addOnloadHook(fn: () => void): void;
 
@@ -23,7 +17,7 @@ declare global {
      * @since 1.12.2
      * @param {string} title
      * @returns {HTMLScriptElement|null} Script tag, or null if it was already imported before
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global-method-importScript
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/window.html#.importScript
      */
     function importScript(title: string): HTMLScriptElement | null;
 
@@ -33,7 +27,7 @@ declare global {
      * @since 1.12.2
      * @param {string} url
      * @returns {HTMLScriptElement|null} Script tag, or null if it was already imported before
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global-method-importScriptURI
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/window.html#.importScriptURI
      */
     function importScriptURI(url: string): HTMLScriptElement | null;
 
@@ -43,7 +37,7 @@ declare global {
      * @since 1.12.2
      * @param {string} title
      * @returns {HTMLLinkElement} Link tag
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global-method-importStylesheet
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/window.html#.importStylesheet
      */
     function importStylesheet(title: string): HTMLLinkElement;
 
@@ -54,7 +48,7 @@ declare global {
      * @param {string} url
      * @param {string} media
      * @returns {HTMLLinkElement} Link tag
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/global-method-importStylesheetURI
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/window.html#.importStylesheetURI
      */
     function importStylesheetURI(url: string, media: string): HTMLLinkElement;
 }
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
index 050d9da..f15847a 100644
--- a/mw/hook.d.ts
+++ b/mw/hook.d.ts
@@ -38,7 +38,7 @@ import { User } from "./user";
  * new mw.Foo( .. ).fetch( { callback: h.fire } );
  * ```
  *
- * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hook.html
  */
 interface Hook<T extends any[] = any[]> {
     /**
@@ -46,7 +46,7 @@ interface Hook<T extends any[] = any[]> {
      *
      * @param {...Function} handler Function to bind.
      * @returns {Hook}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-add
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hook.html#.add
      */
     add(...handler: Array<(...data: T) => any>): this;
 
@@ -55,7 +55,7 @@ interface Hook<T extends any[] = any[]> {
      *
      * @param {...any} data
      * @returns {Hook}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-fire
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hook.html#.fire
      */
     fire(...data: T): this;
 
@@ -64,7 +64,7 @@ interface Hook<T extends any[] = any[]> {
      *
      * @param {...Function} handler Function to unbind.
      * @returns {Hook}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook-method-remove
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hook.html#.remove
      */
     remove(...handler: Array<(...data: T) => any>): this;
 }
@@ -105,7 +105,8 @@ declare global {
         /**
          * Create an instance of mw.hook.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(
             name: "apisandbox.formatRequest"
@@ -122,14 +123,16 @@ declare global {
         /**
          * Create an instance of mw.hook, fired after EditRecovery has loaded any recovery data, added event handlers, etc.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'editRecovery.loadEnd'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "editRecovery.loadEnd"): Hook<[editRecovery: EditRecovery]>;
 
         /**
          * Create an instance of mw.hook.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'htmlform.enhance'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "htmlform.enhance"): Hook<[$root: JQuery]>;
 
@@ -140,6 +143,7 @@ declare global {
          *
          * Code that fires the postEdit hook should first set `wgRevisionId` and `wgCurRevisionId` to the revision associated with the edit that triggered the postEdit hook, then fire the postEdit hook, e.g.:
          *
+         * @example
          * ```js
          * mw.config.set( {
          *    wgCurRevisionId: data.newrevid,
@@ -148,8 +152,8 @@ declare global {
          * // Now fire the hook.
          * mw.hook( 'postEdit' ).fire();
          * ```
-         *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'postEdit'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "postEdit"): Hook<[data?: PostEditData]>;
 
@@ -157,14 +161,15 @@ declare global {
          * Create an instance of mw.hook, fired after the listener for #postEdit removes the notification.
          *
          * @deprecated
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'postEdit.afterRemoval'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "postEdit.afterRemoval"): Hook<[]>;
 
         /**
          * Create an instance of mw.hook.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "prefs.search.buildIndex"): Hook<[index: SearchIndex]>;
 
@@ -173,14 +178,16 @@ declare global {
          *
          * This will end the user session, and either redirect to the given URL on success, or queue an error message via mw.notification.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'skin.logout'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "skin.logout"): Hook<[href: string]>;
 
         /**
          * Create an instance of mw.hook, fired when initialization of the filtering interface for changes list is complete.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'structuredChangeFilters.ui.initialized'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "structuredChangeFilters.ui.initialized"): Hook<[]>;
 
@@ -193,7 +200,8 @@ declare global {
          *     p.style.border = 'solid 1px black';
          * } );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'util.addPortlet'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(
             name: "util.addPortlet"
@@ -209,7 +217,8 @@ declare global {
          *     link.appendChild( span );
          * } );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'util.addPortletLink'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "util.addPortletLink"): Hook<[item: HTMLLIElement, data: object]>;
 
@@ -220,7 +229,8 @@ declare global {
          *
          * This includes the ready event on a page load (including post-edit loads) and when content has been previewed with LivePreview.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.categories'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.categories"): Hook<[$content: JQuery]>;
 
@@ -229,7 +239,8 @@ declare global {
          *
          * This gives an option to modify the collapsible behavior.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.collapsibleContent'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.collapsibleContent"): Hook<[$collapsible: JQuery]>;
 
@@ -240,7 +251,8 @@ declare global {
          *
          * This includes the ready event on a page load (including post-edit loads) and when content has been previewed with LivePreview.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.content'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.content"): Hook<[$content: JQuery]>;
 
@@ -249,14 +261,16 @@ declare global {
          *
          * Similar to the wikipage.content hook, `$diff` may still be detached when the hook is fired.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.diff'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.diff"): Hook<[$table: JQuery<HTMLTableElement>]>;
 
         /**
          * Create an instance of mw.hook.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.diff.diffTypeSwitch'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(
             name: "wikipage.diff.diffTypeSwitch"
@@ -265,7 +279,8 @@ declare global {
         /**
          * Create an instance of mw.hook.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.diff.wikitextDiffBody'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.diff.wikitextBodyUpdate"): Hook<[$wikitextDiffBody: JQuery]>;
 
@@ -274,21 +289,26 @@ declare global {
          *
          * Similar to the wikipage.content hoo $editForm can still be detached when this hook is fired.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.editform'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.editform"): Hook<[$editForm: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when a page's {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Page_status_indicators status indicators} are being added to the DOM or updated.
+         * Create an instance of mw.hook, fired when a page's
+         * {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Page_status_indicators status indicators}
+         * are being added to the DOM or updated.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.indicators'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.indicators"): Hook<[$indicators: JQuery]>;
 
         /**
          * Create an instance of mw.hook, fired when dynamic changes have been made to the table of contents.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.tableOfContents'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "wikipage.tableOfContents"): Hook<[sections: any[]]>;
 
@@ -301,7 +321,8 @@ declare global {
          *     // Do things
          * } );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.watchlistChange'
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(
             name: "wikipage.watchlistChange"
@@ -318,7 +339,7 @@ declare global {
          * ```
          * @param {string} name Name of hook.
          * @returns {Hook}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-hook
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook<T extends any[] = any[]>(name: string): Hook<T>;
     }
diff --git a/mw/html.d.ts b/mw/html.d.ts
index 4df0934..53f1050 100644
--- a/mw/html.d.ts
+++ b/mw/html.d.ts
@@ -13,7 +13,7 @@ declare global {
          * ) );
          * mw.log( output ); // <div><img src="&lt;"/></div>
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html.html
          */
         namespace html {
             /**
@@ -27,7 +27,7 @@ declare global {
              *  - null: The element is treated as void with short closing form, e.g. `<br/>`.
              *  - this.Raw: The raw value is directly included.
              * @returns {string} HTML
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html-method-element
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html.html#.element
              */
             function element(
                 name: string,
@@ -47,7 +47,7 @@ declare global {
              * ```
              * @param {string} s The string to escape
              * @returns {string} HTML
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html-method-escape
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html.html#.escape
              */
             function escape(s: string): string;
 
@@ -59,13 +59,14 @@ declare global {
              * const raw = new mw.html.Raw( 'Text' );
              * mw.html.element( 'div', { class: 'html' }, raw );
              * ```
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.html.Raw-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html.Raw.html
              */
             class Raw<V extends string = string> {
                 value: V;
 
                 /**
                  * @param {string} value
+                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html.Raw.html#Raw
                  */
                 constructor(value: V);
             }
diff --git a/mw/index.d.ts b/mw/index.d.ts
index 4f0a4d1..39346d2 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -60,14 +60,14 @@ declare global {
     /**
      * Base library for MediaWiki.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html
      */
     const mediaWiki: typeof mw;
 
     /**
      * Base library for MediaWiki.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html
      */
     namespace mw {
         /**
@@ -75,12 +75,14 @@ declare global {
          * want to add a new global, or the global is bad and needs containment
          * or wrapping.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-property-libs
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.libs
          */
         namespace libs {}
 
         /**
          * Store for templates associated with a module.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.templates
          */
         const templates: Map<Record<string, any>>;
 
@@ -96,7 +98,7 @@ declare global {
          *     OO.ui.getWindowManager().addWindows( [ new mw.widget.AbandonEditDialog() ] );
          * });
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.base.html#mw-property-libs
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.widgets.html
          */
         namespace widgets {}
 
@@ -109,7 +111,7 @@ declare global {
          * @param {string} formatString Format string
          * @param {...string} parameters Values for $N replacements
          * @returns {string} Formatted string
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-format
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.format
          */
         function format(formatString: string, ...parameters: string[]): string;
 
@@ -121,7 +123,7 @@ declare global {
          * On all other browsers, it will fall back to using `Date`.
          *
          * @returns {number} Current time
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-now
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.now
          */
         function now(): number;
 
@@ -133,7 +135,7 @@ declare global {
          *
          * Basic logic is as follows:
          *
-         * - User input event should be acknowledged within 100ms per [RAIL].
+         * - User input event should be acknowledged within 100ms per {@link https://developers.google.com/web/fundamentals/performance/rail RAIL}.
          * - Idle work should be grouped in blocks of upto 50ms so that enough time
          *   remains for the event handler to execute and any rendering to take place.
          * - Whenever a native event happens (e.g. user input), the deadline for any
@@ -143,17 +145,16 @@ declare global {
          *
          * See also:
          *
-         * - <https://developer.mozilla.org/en-US/docs/Web/API/Window/requestIdleCallback>
-         * - <https://w3c.github.io/requestidlecallback/>
-         * - <https://developers.google.com/web/updates/2015/08/using-requestidlecallback>
-         * [RAIL]: https://developers.google.com/web/fundamentals/performance/rail
+         * - {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/requestIdleCallback}
+         * - {@link https://w3c.github.io/requestidlecallback/}
+         * - {@link https://developers.google.com/web/updates/2015/08/using-requestidlecallback}
          *
          * @param {Function} callback
          * @param {Object} [options]
          * @param {number} [options.timeout] If set, the callback will be scheduled for
          *  immediate execution after this amount of time (in milliseconds) if it didn't run
          *  by that time.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-requestIdleCallback
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.requestIdleCallback
          */
         function requestIdleCallback(
             callback: (...args: any[]) => any,
@@ -175,7 +176,7 @@ declare global {
          *
          * @param {string} topic Topic name
          * @param {AnalyticEventData} [data] Data describing the event.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-track
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.track
          */
         function track(topic: string, data?: AnalyticEventData): void;
 
@@ -188,7 +189,6 @@ declare global {
          *
          * @private
          * @param {ErrorAnalyticEventData} data Data describing the event, encoded as an object; see {@link errorLogger.logError}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackError
          */
         function trackError(topic: string, data: ErrorAnalyticEventData): void;
 
@@ -212,7 +212,7 @@ declare global {
          * ```
          * @param {string} topic Handle events whose name starts with this string prefix
          * @param {function(string, AnalyticEventData): void} callback Handler to call for each matching tracked event
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackSubscribe
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.trackSubscribe
          */
         function trackSubscribe(topic: string, callback: AnalyticEventCallback): void;
 
@@ -220,17 +220,16 @@ declare global {
          * Stop handling events for a particular handler.
          *
          * @param {function(string, AnalyticEventData): void} callback
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-trackUnsubscribe
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.trackUnsubscribe
          */
         function trackUnsubscribe(callback: AnalyticEventCallback): void;
 
         /**
          * List of all analytic events emitted so far.
          *
-         * Exposed only for use by mediawiki.base.
+         * Exposed only for use by `mediawiki.base`.
          *
          * @private
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-property-trackQueue
          */
         const trackQueue: AnalyticEvent[];
     }
diff --git a/mw/inspect.d.ts b/mw/inspect.d.ts
index 021712e..c6edbe5 100644
--- a/mw/inspect.d.ts
+++ b/mw/inspect.d.ts
@@ -82,11 +82,14 @@ declare global {
          * When invoked without arguments, prints all available reports.
          *
          * @param {...string} [reports]
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.inspect
          */
         function inspect(...reports: ResourceLoaderReport[]): void;
 
         /**
          * Tools for inspecting page composition and performance.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html
          */
         namespace inspect {
             /**
@@ -101,6 +104,7 @@ declare global {
              *
              * @param {string} css CSS source
              * @returns {SelectorCounts} Selector counts
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.auditSelectors
              */
             function auditSelectors(css: string): SelectorCounts;
 
@@ -109,6 +113,7 @@ declare global {
              *
              * @param {any[]} data Tabular data represented as an array of objects
              *  with common properties.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.dumpTable
              */
             function dumpTable(data: any[]): void;
 
@@ -117,6 +122,7 @@ declare global {
              *
              * @returns {Object.<string, Dependency>} Maps module names to objects. Each sub-object has
              *  two properties, 'requires' and 'requiredBy'.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.getDependencyGraph
              */
             function getDependencyGraph(): Record<string, Dependency>;
 
@@ -124,6 +130,7 @@ declare global {
              * Get a list of all loaded ResourceLoader modules.
              *
              * @returns {string[]} List of module names
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.getLoadedModules
              */
             function getLoadedModules(): string[];
 
@@ -132,6 +139,7 @@ declare global {
              *
              * @param {string} moduleName The name of the module
              * @returns {number|null} Module size in bytes or null
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.getModuleSize
              */
             function getModuleSize(moduleName: string): number | null;
 
@@ -142,6 +150,7 @@ declare global {
              *
              * @param {string|RegExp} pattern String or regexp to match.
              * @returns {string[]} Array of the names of modules that matched.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.grep
              */
             function grep(pattern: string | RegExp): string[];
 
@@ -151,6 +160,7 @@ declare global {
              * When invoked without arguments, prints all available reports.
              *
              * @param {...ResourceLoaderReport} [reports] One or more of "size", "css", "store", or "time".
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mediawiki.inspect.html#.runReports
              */
             function runReports(...reports: ResourceLoaderReport[]): void;
         }
diff --git a/mw/language.d.ts b/mw/language.d.ts
index cf5acd5..2650130 100644
--- a/mw/language.d.ts
+++ b/mw/language.d.ts
@@ -8,7 +8,7 @@ declare global {
          * - transforming message syntax (`{{PLURAL:}}`, `{{GRAMMAR:}}`, `{{GENDER:}}`)
          * - formatting numbers
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html
          */
         namespace language {
             /**
@@ -44,7 +44,7 @@ declare global {
              * - `bcp47Map`
              * - `languageNames`
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-property-data
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.data
              */
             const data: Record<string, Map>;
 
@@ -54,7 +54,7 @@ declare global {
              *
              * @param {string} languageTag Well-formed language tag
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-bcp47
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.bcp47
              */
             function bcp47(languageTag: string): string;
 
@@ -68,7 +68,7 @@ declare global {
              * @param {string} word
              * @param {string} form
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-convertGrammar
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.convertGrammar
              */
             function convertGrammar(word: string, form: string): string;
 
@@ -78,7 +78,7 @@ declare global {
              * @param {number} num Value to be converted
              * @param {boolean} [integer=false] Whether to convert the return value to an integer
              * @returns {number|string} Formatted number
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-convertNumber
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.convertNumber
              */
             function convertNumber(num: number, integer: true): number;
             function convertNumber(num: number, integer?: false): string;
@@ -91,7 +91,7 @@ declare global {
              * @param {string[]} forms List of plural forms
              * @param {Object.<number, string>} [explicitPluralForms] List of explicit plural forms
              * @returns {string} Correct form for quantifier in this language
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-convertPlural
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.convertPlural
              */
             function convertPlural(
                 count: number,
@@ -110,7 +110,7 @@ declare global {
              * @param {string} gender 'male', 'female', or anything else for neutral.
              * @param {string[]} forms List of gender forms
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-gender
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.gender
              */
             function gender<T extends string>(gender: string, forms: [T, T?, T?]): T;
             function gender<T extends string = never>(gender: string, forms: [T?, T?, T?]): T | "";
@@ -125,7 +125,7 @@ declare global {
              * @param {string} dataKey
              * @returns {any} Value stored in the mw.Map (or `undefined` if there is no map for the
              *  specified langCode)
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-getData
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.getData
              */
             function getData(langCode: string, dataKey: string): any;
 
@@ -133,7 +133,6 @@ declare global {
              * Get the digit transform table for current UI language.
              *
              * @returns {Object.<number|string, string>|string[]}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-getDigitTransformTable
              */
             function getDigitTransformTable(): string[] | Record<number | string, string>;
 
@@ -141,7 +140,7 @@ declare global {
              * Get the language fallback chain for current UI language, including the language itself.
              *
              * @returns {string[]} List of language keys, e.g. `['pfl', de', 'en']`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-getFallbackLanguageChain
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.getFallbackLanguageChain
              */
             function getFallbackLanguageChain(): string[];
 
@@ -149,7 +148,7 @@ declare global {
              * Get the language fallback chain for current UI language (not including the language itself).
              *
              * @returns {string[]} List of language keys, e.g. `['de', 'en']`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-getFallbackLanguages
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.getFallbackLanguages
              */
             function getFallbackLanguages(): string[];
 
@@ -157,7 +156,6 @@ declare global {
              * Get the separator transform table for current UI language.
              *
              * @returns {Object.<number|string, string>|string[]}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-getSeparatorTransformTable
              */
             function getSeparatorTransformTable(): string[] | Record<number | string, string>;
 
@@ -168,7 +166,7 @@ declare global {
              *
              * @param {string[]} list
              * @returns {string}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-listToText
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.listToText
              */
             function listToText(list: string[]): string;
 
@@ -180,7 +178,7 @@ declare global {
              * @param {string} langCode
              * @param {string|Object.<string, any>} dataKey Key or object of key/values
              * @param {any} [value] Value for dataKey, omit if dataKey is an object
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-setData
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.setData
              */
             function setData(langCode: string, dataKey: string, value: any): void;
             function setData(langCode: string, dataKey: Record<string, any>): void;
@@ -192,7 +190,6 @@ declare global {
              * @param {string[]} forms Number of forms given to convertPlural
              * @param {number} count Number of forms required
              * @returns {string[]} Padded array of forms
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-method-preConvertPlural
              */
             function preConvertPlural<T extends string[]>(
                 forms: T,
@@ -202,7 +199,7 @@ declare global {
             /**
              * Information about month names in current UI language.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.language-property-months
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.language.html#.months
              */
             namespace months {
                 /**
diff --git a/mw/loader.d.ts b/mw/loader.d.ts
index 4665d5c..e9f0670 100644
--- a/mw/loader.d.ts
+++ b/mw/loader.d.ts
@@ -76,9 +76,9 @@ declare global {
          * well as dependency resolution and execution of source code.
          *
          * For more information, refer to
-         * <https://www.mediawiki.org/wiki/ResourceLoader/Features>
+         * {@link https://www.mediawiki.org/wiki/Special:MyLanguage/ResourceLoader/Features}
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html
          */
         namespace loader {
             /**
@@ -88,7 +88,7 @@ declare global {
              * @param {Node|null} [nextNode] The element where the style tag
              *  should be inserted before
              * @returns {HTMLStyleElement} Reference to the created style element
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-addStyleTag
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.addStyleTag
              */
             function addStyleTag(text: string, nextNode?: Node | null): HTMLStyleElement;
 
@@ -96,7 +96,7 @@ declare global {
              * Get the names of all registered ResourceLoader modules.
              *
              * @returns {string[]}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-getModuleNames
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.getModuleNames
              */
             function getModuleNames(): string[];
 
@@ -118,7 +118,7 @@ declare global {
              * ```
              * @param {string} url Script URL
              * @returns {JQuery.Promise} Resolved when the script is loaded
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-getScript
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.getScript
              */
             function getScript(url: string): JQuery.Promise<any>;
 
@@ -162,7 +162,7 @@ declare global {
              * @param {string} module Name of module
              * @returns {string|null} The state, or null if the module (or its state) is not
              *  in the registry.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-getState
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.getState
              */
             function getState(module: string): ModuleState | null;
 
@@ -184,7 +184,7 @@ declare global {
              *  external script or style; acceptable values are "text/css" and
              *  "text/javascript"; if no type is provided, text/javascript is assumed.
              * @throws {Error} If type is invalid
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-load
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.load
              */
             function load(modules: string | string[], type?: "text/css" | "text/javascript"): void;
 
@@ -227,7 +227,7 @@ declare global {
              * @param {Function} [ready] Callback to execute when all dependencies are ready
              * @param {Function} [error] Callback to execute if one or more dependencies failed
              * @returns {JQuery.Promise<ModuleRequire>} With a `require` function
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-using
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.loader.html#.using
              */
             function using(
                 dependencies: string | string[],
@@ -239,7 +239,6 @@ declare global {
              * Exposed for testing and debugging only.
              *
              * @private
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-property-maxQueryLength
              */
             const maxQueryLength: number;
 
@@ -248,7 +247,6 @@ declare global {
              * state; it is not a public interface for modifying the registry.
              *
              * @private
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-property-moduleRegistry
              */
             const moduleRegistry: Record<string, ModuleRegistryEntry>;
 
@@ -260,7 +258,6 @@ declare global {
              * @param {string} [media] Media attribute
              * @param {Node|null} [nextNode]
              * @returns {HTMLLinkElement}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html#global-method-addLinkTag
              */
             function addLinkTag(
                 url: string,
@@ -277,7 +274,6 @@ declare global {
              * @param {string[]} [modules] List of modules being requested, for state to be marked as error
              * in case the script fails to load
              * @returns {HTMLScriptElement}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html#mw-loader-method-addScriptTag
              */
             function addScriptTag(
                 src: string,
@@ -309,7 +305,6 @@ declare global {
              * @param {string[]} dependencies Array of module names in the registry
              * @param {Function} [ready] Callback to execute when all dependencies are ready
              * @param {Function} [error] Callback to execute when any dependency fails
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-enqueue
              */
             function enqueue(
                 dependencies: string[],
@@ -387,7 +382,6 @@ declare global {
              * @param {ModuleMessages} [messages] List of key/value pairs to be added to {@link mw.messages}.
              * @param {ModuleTemplates} [templates] List of key/value pairs to be added to {@link mw.templates}.
              * @param {string|null} [deprecationWarning] Deprecation warning if any
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-implement
              */
             function implement(
                 module: string,
@@ -416,7 +410,6 @@ declare global {
              * @param {string} [group=null] Group which the module is in
              * @param {string} [source='local'] Name of the source
              * @param {string} [skip=null] Script body of the skip function
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-register
              */
             function register(
                 modules: string,
@@ -451,7 +444,6 @@ declare global {
              *
              * @since 1.27
              * @private
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-require
              */
             const require: ModuleRequire;
 
@@ -462,7 +454,6 @@ declare global {
              * @param {string[]} modules Array of string module names
              * @returns {string[]} List of dependencies, including 'module'.
              * @throws {Error} If an unregistered module or a dependency loop is encountered
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-resolve
              */
             // note: U is required so T is not inferred from the "modules" argument
             function resolve<T extends string, U extends T = T>(modules: U[]): T[];
@@ -472,7 +463,6 @@ declare global {
              *
              * @private
              * @param {Object.<string, ModuleState>} states Object of module name/state pairs
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-state
              */
             function state(states: Record<string, ModuleState>): void;
 
@@ -480,13 +470,9 @@ declare global {
              * Start loading of all queued module dependencies.
              *
              * @private
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader-method-work
              */
             function work(): void;
 
-            /**
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store
-             */
             namespace store {
                 /**
                  * The localStorage key for the entire module store. The key references
@@ -500,8 +486,6 @@ declare global {
                  * A string containing various factors by which the module cache should vary.
                  *
                  * Defined by ResourceLoader\StartupModule::getStoreVary() in PHP.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-property-vary
                  */
                 const vary: string;
 
@@ -510,14 +494,11 @@ declare global {
                  *
                  * @since 1.32
                  * @param {string} module Module name
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-add
                  */
                 function add(module: string): void;
 
                 /**
                  * Clear the entire module store right now.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-clear
                  */
                 function clear(): void;
 
@@ -526,7 +507,6 @@ declare global {
                  *
                  * @param {string} module Module name
                  * @returns {string|boolean} Module implementation or false if unavailable
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-get
                  */
                 function get(module: string): string | false;
 
@@ -535,23 +515,17 @@ declare global {
                  *
                  * Retrieves store from localStorage and (if successfully retrieved) decoding
                  * the stored JSON value to a plain object.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-init
                  */
                 function init(): void;
 
                 /**
                  * Internal helper for {@link init()}. Separated for ease of testing.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-load
                  */
                 function load(): void;
 
                 /**
                  * Iterate through the module store, removing any item that does not correspond
                  * (in name and version) to an item in the module registry.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-prune
                  */
                 function prune(): void;
 
@@ -559,36 +533,27 @@ declare global {
                  * Construct a JSON-serializable object representing the content of the store.
                  *
                  * @returns {Object} Module store contents.
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-toJSON
                  */
                 function toJSON(): { items: string; vary: string; asOf: number };
 
                 /**
                  * Whether the store is in use on this page.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html
                  */
                 const enabled: boolean | null;
 
                 /**
                  * The contents of the store, mapping '[name]@[version]' keys
                  * to module implementations.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html
                  */
                 const items: Record<ModuleKey, any>;
 
                 /**
                  * Names of modules to be stored during the next update.
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html
                  */
                 const queue: string[];
 
                 /**
-                 * Cache hit stats
-                 *
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/source/mediawiki.loader.html
+                 * Cache hit stats.
                  */
                 const stats: ResourceLoaderStoreStats;
 
@@ -603,7 +568,6 @@ declare global {
                  *
                  * @private
                  * @param {string} module Module name
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-set
                  */
                 function set(module: string): void;
 
@@ -636,7 +600,6 @@ declare global {
                  * be called if the store is enabled.
                  *
                  * @private
-                 * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.loader.store-method-requestUpdate
                  */
                 function requestUpdate(): void;
             }
diff --git a/mw/log.d.ts b/mw/log.d.ts
index 5f6aaf8..ed17f5e 100644
--- a/mw/log.d.ts
+++ b/mw/log.d.ts
@@ -9,14 +9,13 @@ declare global {
          * See {@link mw.log} for other logging methods.
          *
          * @param {...any} msg Messages to output to console.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-log
          */
         function log(...msg: any[]): void;
 
         /**
          * Library for logging developer warnings to the JavaScript console.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.log.html
          */
         namespace log {
             /**
@@ -37,7 +36,7 @@ declare global {
              * @param {string} [msg] Optional extra text to add to the deprecation warning
              * @param {string} [logName] Name of the feature for deprecation tracker.
              *  Tracking is disabled by default, except for global variables on `window`.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-deprecate
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.log.html#.deprecate
              */
             function deprecate<T, K extends string & keyof T>(
                 obj: T,
@@ -55,7 +54,7 @@ declare global {
              *
              * @since 1.26
              * @param {...any} msg Messages to output to console
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-error
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.log.html#.error
              */
             function error(...msg: any[]): void;
 
@@ -81,7 +80,7 @@ declare global {
              *  or null for a console-only deprecation.
              * @param {string} msg Deprecation warning.
              * @returns {Function}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-makeDeprecated
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.log.html#.makeDeprecated
              */
             function makeDeprecated(key: string | null, msg: string): () => void;
 
@@ -89,7 +88,7 @@ declare global {
              * Write a message to the browser console's warning channel.
              *
              * @param {...any} msg Messages to output to console
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.log-method-warn
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.log.html#.warn
              */
             function warn(...msg: any[]): void;
         }
diff --git a/mw/message.d.ts b/mw/message.d.ts
index cf71da5..383e974 100644
--- a/mw/message.d.ts
+++ b/mw/message.d.ts
@@ -8,14 +8,14 @@ declare global {
          * @param {string} key Key of message to get
          * @param {...any} parameters Values for $N replacements
          * @returns {Message}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-message
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.message
          */
         function message(key: string, ...parameters: any[]): Message;
 
         /**
          * Store for messages.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-property-messages
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.messages
          */
         const messages: Map<{ [key: string]: string }>;
 
@@ -58,7 +58,7 @@ declare global {
          * mw.log( obj.escaped() );
          * // You will find: Time &quot;after&quot; &lt;time&gt;
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html
          */
         class Message {
             /**
@@ -104,7 +104,7 @@ declare global {
              * @param {Map} map Message store
              * @param {string} key
              * @param {Array} [parameters]
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-constructor
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#Message
              */
             constructor(map: Map<Record<string, string>>, key: string, parameters?: any[]);
 
@@ -114,7 +114,7 @@ declare global {
              * This is equivalent to the {@link text} format, which is then HTML-escaped.
              *
              * @returns {string} String form of html escaped message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-escaped
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#escaped
              */
             escaped(): string;
 
@@ -122,7 +122,7 @@ declare global {
              * Check if a message exists. Equivalent to {@link mw.Map.exists}.
              *
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-exists
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#exists
              */
             exists(): boolean;
 
@@ -133,7 +133,7 @@ declare global {
              *
              * @since 1.41
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-isParseable
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#isParseable
              */
             isParseable(): boolean;
 
@@ -142,7 +142,7 @@ declare global {
              *
              * @param {Array} parameters
              * @returns {Message}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-params
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#params
              */
             params(parameters: any[]): this;
 
@@ -153,7 +153,7 @@ declare global {
              * into HTML. Without jqueryMsg, it is equivalent to {@link escaped}.
              *
              * @returns {string} String form of parsed message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-parse
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#parse
              */
             parse(): string;
 
@@ -164,7 +164,7 @@ declare global {
              *
              * @since 1.27
              * @returns {JQuery}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-parseDom
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#parseDom
              */
             parseDom(): JQuery;
 
@@ -175,7 +175,7 @@ declare global {
              * message content.
              *
              * @returns {string} String form of plain message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-plain
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#plain
              */
             plain(): string;
 
@@ -187,7 +187,7 @@ declare global {
              * Without jqueryMsg, it is equivalent to {@link plain}.
              *
              * @returns {string} String form of text message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-text
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#text
              */
             text(): string;
 
@@ -203,7 +203,6 @@ declare global {
              * @private For internal use by mediawiki.jqueryMsg only
              * @param {string} format
              * @returns {string} Parsed message
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-parser
              */
             private parser(format: string): string;
 
@@ -218,7 +217,6 @@ declare global {
              *  implicitly through string casting.
              * @returns {string} Message in the given format, or `⧼key⧽` if the key
              *  does not exist.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Message-method-toString
              */
             private toString(format?: "escaped" | "parse" | "plain" | "text"): string;
         }
@@ -231,7 +229,7 @@ declare global {
          * @param {string} key Key of message to get
          * @param {...any} parameters Values for $N replacements
          * @returns {string}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-msg
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.msg
          */
         function msg(key: string, ...parameters: any[]): string;
     }
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 48a1261..032172a 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -5,7 +5,7 @@
  * This does not insert anything into the document. To add to document use
  * {@link mw.notification.notify}.
  *
- * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/Notification.html
  */
 interface Notification {
     $notification: JQuery;
@@ -21,14 +21,14 @@ interface Notification {
     /**
      * Close the notification.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_-method-close
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Notification.html#close
      */
     close(): void;
 
     /**
      * Pause any running auto-hide timer for this notification.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_-method-pause
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Notification.html#pause
      */
     pause(): void;
 
@@ -37,7 +37,7 @@ interface Notification {
      * Does nothing if autoHide is disabled.
      * Either to resume from pause or to make the first start.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_-method-resume
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/Notification.html#pause
      */
     resume(): void;
 
@@ -49,7 +49,6 @@ interface Notification {
      * handles the fadeIn animations and replacement transitions, and starts autoHide timers.
      *
      * @private
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.Notification_-method-start
      */
     start(): void;
 }
@@ -63,7 +62,7 @@ declare global {
          * @param {Partial<notification.NotificationOptions>} [options] The options to use for the notification.
          *  See {@link notification.defaults the defaults}.
          * @returns {JQuery.Promise<Notification>} Notification object
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw-method-notify
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.notify
          */
         function notify(
             message: string | Message | JQuery | HTMLElement | HTMLElement[],
@@ -73,7 +72,7 @@ declare global {
         /**
          * Library for sending notifications to end users.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html
          */
         namespace notification {
             /**
@@ -85,13 +84,12 @@ declare global {
              * This basically represents the minimal number of notifications the user should
              * be able to process during the {@link notification.defaults default} {@link autoHideSeconds} time.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-property-autoHideLimit
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.autoHideLimit
              */
             const autoHideLimit: number;
 
             /**
              * @private
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-property-autoHideSeconds
              */
             const autoHideSeconds: {
                 short: number;
@@ -101,7 +99,7 @@ declare global {
             /**
              * The defaults for {@link notify} options parameter.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-property-defaults
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.defaults
              */
             const defaults: NotificationOptions;
 
@@ -109,7 +107,7 @@ declare global {
              * Pause auto-hide timers for all notifications.
              * Notifications will not auto-hide until resume is called.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-method-pause
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.pause
              */
             function pause(): void;
 
@@ -117,7 +115,7 @@ declare global {
              * Resume any paused auto-hide timers from the beginning.
              * Only the first {@link autoHideLimit} timers will be resumed.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-method-resume
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.resume
              */
             function resume(): void;
 
@@ -128,13 +126,16 @@ declare global {
              * @param {NotificationOptions} [options] The options to use for the notification.
              *  Options not specified default to the values in {@link defaults}.
              * @returns {Notification} Notification object
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.notification-method-notify
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.notify
              */
             function notify(
                 message: string | Message | JQuery | HTMLElement | HTMLElement[],
                 options?: NotificationOptions
             ): Notification;
 
+            /**
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.NotificationOptions
+             */
             interface NotificationOptions {
                 /**
                  * Whether the notification should automatically
diff --git a/mw/pluralRuleParser.d.ts b/mw/pluralRuleParser.d.ts
index 67695a4..e0f9896 100644
--- a/mw/pluralRuleParser.d.ts
+++ b/mw/pluralRuleParser.d.ts
@@ -6,6 +6,7 @@ declare global {
          * @param {string} rule
          * @param {integer} number
          * @returns {boolean} true if evaluation passed, false if evaluation failed.
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.libs.pluralruleparser.html
          */
         function pluralRuleParser(rule: string, number: number): boolean;
     }
diff --git a/mw/searchSuggest.d.ts b/mw/searchSuggest.d.ts
index b696bfc..5ed8d6f 100644
--- a/mw/searchSuggest.d.ts
+++ b/mw/searchSuggest.d.ts
@@ -1,5 +1,8 @@
 import { ApiResponse } from "./Api";
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.searchSuggest.html#~ResponseFunction
+ */
 interface ResponseFunction {
     /**
      * @param {string[]} titles titles of pages that match search
@@ -8,6 +11,9 @@ interface ResponseFunction {
     (titles: string[], meta: ResponseMetaData): void;
 }
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.searchSuggest.html#~ResponseMetaData
+ */
 interface ResponseMetaData {
     query: string;
     /**
@@ -35,6 +41,7 @@ declare global {
          *     });
          * });
          * ```
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.searchSuggest.html
          */
         namespace searchSuggest {
             /**
@@ -46,6 +53,7 @@ declare global {
              * @param {string|number} [limit]
              * @param {string|number|string[]|number[]} [namespace]
              * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.searchSuggest.html#.request
              */
             function request(
                 api: Api,
diff --git a/mw/storage.d.ts b/mw/storage.d.ts
index b167e9c..f765520 100644
--- a/mw/storage.d.ts
+++ b/mw/storage.d.ts
@@ -5,7 +5,7 @@
  * The constructor is not publicly accessible. An instance can be accessed from
  * {@link mw.storage} or {@link module:mediawiki.storage}.
  *
- * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html
  */
 interface SafeStorage {
     /**
@@ -14,7 +14,7 @@ interface SafeStorage {
      * @param {string} key Key of item to retrieve
      * @returns {string|null|false} String value, null if no value exists, or false
      *  if storage is not available.
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-get
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#get
      */
     get(key: string): string | null | false;
 
@@ -24,7 +24,7 @@ interface SafeStorage {
      * @param {string} key Key of item to retrieve
      * @returns {Object|null|boolean} Object, null if no value exists or value
      *  is not JSON-parseable, or false if storage is not available.
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-getObject
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#getObject
      */
     getObject(key: string): any;
 
@@ -33,7 +33,7 @@ interface SafeStorage {
      *
      * @param {string} key Key of item to remove
      * @returns {boolean} Whether the key was removed
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-remove
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#remove
      */
     remove(key: string): boolean;
 
@@ -44,7 +44,7 @@ interface SafeStorage {
      * @param {string} value Value to be stored
      * @param {number} [expiry] Number of seconds after which this item can be deleted
      * @returns {boolean} The value was set
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-set
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#set
      */
     set(key: string, value: string, expiry?: number): boolean;
 
@@ -56,7 +56,7 @@ interface SafeStorage {
      *  omit to clear the expiry (either making the item never expire, or to clean up
      *  when deleting a key).
      * @returns {boolean} The expiry was set (or cleared) [since 1.41]
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-setExpires
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#setExpires
      */
     setExpires(key: string, expiry?: number): boolean;
 
@@ -67,7 +67,7 @@ interface SafeStorage {
      * @param {Object} value Object value to be stored
      * @param {number} [expiry] Number of seconds after which this item can be deleted
      * @returns {boolean} The value was set
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-setObject
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage-SafeStorage.html#setObject
      */
     setObject(key: string, value: any, expiry?: number): boolean;
 
@@ -76,7 +76,6 @@ interface SafeStorage {
      *
      * @private
      * @returns {JQuery.Promise} Resolves when items have been expired
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-clearExpired
      */
     clearExpired(): JQuery.Promise<undefined>;
 
@@ -86,7 +85,6 @@ interface SafeStorage {
      * @private
      * @returns {JQuery.Promise<string[]>} Promise resolving with all the keys which have
      *  expiry values (unprefixed), or as many could be retrieved in the allocated time.
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-getExpiryKeys
      */
     getExpiryKeys(): JQuery.Promise<string[]>;
 
@@ -96,7 +94,6 @@ interface SafeStorage {
      * @private
      * @param {string} key Key name
      * @returns {boolean} Whether key is expired
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.SafeStorage-method-isExpired
      */
     isExpired(key: string): boolean;
 }
@@ -124,7 +121,7 @@ interface MwStorage extends SafeStorage {
      * to know about and delete when the data is no longer needed. Instead,
      * store dynamic values in an object under a single constant key that you
      * manage or replace over time.
-     * See also <https://phabricator.wikimedia.org/T121646>.
+     * See also {@link https://phabricator.wikimedia.org/T121646}.
      *
      * @example
      * ```js
@@ -137,7 +134,7 @@ interface MwStorage extends SafeStorage {
      * session.set( key, value );
      * session.get( key );
      * ```
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.storage.session
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.storage.html#.session
      */
     session: SafeStorage;
 }
@@ -166,7 +163,7 @@ declare global {
          * to know about and delete when the data is no longer needed. Instead,
          * store dynamic values in an object under a single constant key that you
          * manage or replace over time.
-         * See also <https://phabricator.wikimedia.org/T121646>.
+         * See also {@link https://phabricator.wikimedia.org/T121646}.
          *
          * @example
          * ```js
@@ -180,7 +177,7 @@ declare global {
          * local.set( key, value, expiry );
          * local.get( key );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.storage
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.storage
          */
         const storage: MwStorage;
     }
diff --git a/mw/tempUserCreated.d.ts b/mw/tempUserCreated.d.ts
index f8e4e94..b18802c 100644
--- a/mw/tempUserCreated.d.ts
+++ b/mw/tempUserCreated.d.ts
@@ -2,10 +2,13 @@ declare global {
     namespace mw {
         /**
          * Respond to the creation of a temporary user.
+         *
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.tempUserCreated.html
          */
         namespace tempUserCreated {
             /**
              * Show popup after creation of a temporary user.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.tempUserCreated.html#.showPopup
              */
             function showPopup(): void;
         }
diff --git a/mw/template.d.ts b/mw/template.d.ts
index c79f9da..c889c14 100644
--- a/mw/template.d.ts
+++ b/mw/template.d.ts
@@ -1,3 +1,6 @@
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#~TemplateRenderer
+ */
 interface TemplateRenderer {
     /**
      * Compiles a template for rendering.
@@ -5,16 +8,21 @@ interface TemplateRenderer {
      * @param {Object} [data] for the template
      * @param {Object} [partials] additional partial templates
      * @returns {JQuery}
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#~TemplateCompileFunction
      */
     render(data?: unknown, partials?: unknown): JQuery;
 }
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#~TemplateCompiler
+ */
 interface TemplateCompiler {
     /**
      * Compiles a template for rendering.
      *
      * @param {string} src source of the template
      * @returns {TemplateRenderer} for rendering
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#~TemplateCompileFunction
      */
     compile(src: string): TemplateRenderer;
 }
@@ -42,7 +50,7 @@ declare global {
          *   } );
          * } );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html
          */
         namespace template {
             /**
@@ -55,7 +63,7 @@ declare global {
              *
              * @param {string} name Compiler name
              * @param {TemplateCompiler} compiler
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-registerCompiler
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.registerCompiler
              */
             function registerCompiler(name: string, compiler: TemplateCompiler): void;
 
@@ -64,7 +72,7 @@ declare global {
              *
              * @param {string} templateName Name of a template (including suffix)
              * @returns {string} Name of a compiler
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-getCompilerName
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompilerName
              */
             function getCompilerName(templateName: string): string;
 
@@ -74,7 +82,7 @@ declare global {
              * @param {string} name Name of a compiler
              * @returns {TemplateCompiler} The compiler
              * @throws {Error} when unknown compiler provided
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-getCompiler
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompiler
              */
             function getCompiler(name: string): TemplateCompiler;
 
@@ -87,7 +95,7 @@ declare global {
              * @param {string} templateName Name of the template (including suffix)
              * @param {string} templateBody Contents of the template (e.g. html markup)
              * @returns {TemplateRenderer} Compiled template
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-add
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.add
              */
             function add(
                 moduleName: string,
@@ -101,7 +109,7 @@ declare global {
              * @param {string} moduleName Name of the module to retrieve the template from
              * @param {string} templateName Name of template to be retrieved
              * @returns {TemplateRenderer} Compiled template
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-get
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.get
              */
             function get(moduleName: string, templateName: string): TemplateRenderer;
 
@@ -112,7 +120,7 @@ declare global {
              * @param {string} compilerName The name of a registered compiler.
              * @returns {TemplateRenderer} Compiled template
              * @throws {Error} when unknown compiler name provided.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.template-method-compile
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.compile
              */
             function compile(templateBody: string, compilerName: string): TemplateRenderer;
         }
diff --git a/mw/user.d.ts b/mw/user.d.ts
index f39e3ef..1a4fdf6 100644
--- a/mw/user.d.ts
+++ b/mw/user.d.ts
@@ -24,6 +24,8 @@ export interface User {
      * Classes toggled by this feature must be named as `<feature>-clientpref-<value>`,
      * where `value` contains only alphanumerical characters (a-z, A-Z, and 0-9), and `feature`
      * can also include hyphens.
+     *
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html
      */
     clientPrefs: {
         /**
@@ -32,7 +34,7 @@ export interface User {
          * @param {string} feature
          * @returns {false|string} returns false if the feature is not recognized.
          *   returns string if a feature was found.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user.clientPrefs-method-get
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html#.get
          */
         get(feature: string): false | string;
 
@@ -44,7 +46,7 @@ export interface User {
          * @returns {boolean} True if feature was stored successfully, false if the value
          *   uses a forbidden character or the feature is not recognised
          *   e.g. a matching class was not defined on the HTML document element.
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user.clientPrefs-method-set
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html#.set
          */
         set(feature: string, value: string): boolean;
     };
@@ -52,7 +54,7 @@ export interface User {
     /**
      * Map of user preferences and their values.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-property-options
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.options
      */
     // TODO: add types for items in the options map
     options: mw.Map;
@@ -60,7 +62,7 @@ export interface User {
     /**
      * Map of retrieved user tokens.
      *
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-property-tokens
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.tokens
      */
     tokens: mw.Map<UserTokens>;
 
@@ -75,7 +77,7 @@ export interface User {
      *
      * @returns {JQuery.Promise<string>} Promise resolved with the username if we succeeded,
      *   or resolved with `null` if we failed
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-acquireTempUserName
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.acquireTempUserName
      */
     acquireTempUserName(): JQuery.Promise<string>;
 
@@ -101,14 +103,14 @@ export interface User {
      * `n(p;H) = n(0.01,2^80)= sqrt (2 * 2^80 * ln(1/(1-0.01)))`
      *
      * @returns {string} 80 bit integer (20 characters) in hex format, padded
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-generateRandomSessionId
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.generateRandomSessionId
      */
     generateRandomSessionId(): string;
 
     /**
      * Get date user first registered, if available.
      *
-     * @return {false|null|Date} False for anonymous users, null if data is
+     * @returns {false|null|Date} False for anonymous users, null if data is
      *  unavailable, or Date for when the user registered. For temporary users
      *  that is when their temporary account was created.
      */
@@ -119,7 +121,7 @@ export interface User {
      *
      * @param {Function} [callback]
      * @returns {JQuery.Promise<string[]>}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getGroups
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getGroups
      */
     getGroups<T>(callback: (groups: string[]) => T): JQuery.Promise<T>;
     getGroups(): JQuery.Promise<string[]>;
@@ -130,7 +132,7 @@ export interface User {
      * Not to be confused with {@link id}.
      *
      * @returns {number} Current user's id, or 0 if user is anonymous
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getId
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getId
      */
     getId(): number;
 
@@ -138,7 +140,7 @@ export interface User {
      * Get the current user's name.
      *
      * @returns {string|null} User name string or null if user is anonymous
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getName
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getName
      */
     getName(): string | null;
 
@@ -148,7 +150,7 @@ export interface User {
      *
      * @since 1.32
      * @returns {string} 80 bit integer in hex format, padded
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getPageviewToken
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getPageviewToken
      */
     getPageviewToken(): string;
 
@@ -157,7 +159,7 @@ export interface User {
      *
      * @returns {false|null|Date} False for anonymous users, null if data is
      *  unavailable, or Date for when the user registered.
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getRegistration
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getRegistration
      */
     getRegistration(): false | null | Date;
 
@@ -166,7 +168,7 @@ export interface User {
      *
      * @param {Function} [callback]
      * @returns {JQuery.Promise<string[]>}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getRights
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getRights
      */
     getRights<T>(callback: (rights: string[]) => T): JQuery.Promise<T>;
     getRights(): JQuery.Promise<string[]>;
@@ -177,7 +179,7 @@ export interface User {
      * Not to be confused with {@link getId}.
      *
      * @returns {string} User name or random session ID
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-id
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.id
      */
     id(): string;
 
@@ -185,7 +187,7 @@ export interface User {
      * Check whether the current user is anonymous.
      *
      * @returns {boolean}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isAnon
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.isAnon
      */
     isAnon(): boolean;
 
@@ -193,7 +195,7 @@ export interface User {
      * Check whether the user is a normal non-temporary registered user.
      *
      * @returns {boolean}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isNamed
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.isNamed
      */
     isNamed(): boolean;
 
@@ -201,7 +203,7 @@ export interface User {
      * Check whether the user is an autocreated temporary user.
      *
      * @returns {boolean}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-isTemp
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.isTemp
      */
     isTemp(): boolean;
 
@@ -215,7 +217,7 @@ export interface User {
      * **Note:** Server-side code must never interpret or modify this value.
      *
      * @returns {string} Random session ID (20 hex characters)
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-sessionId
+     * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.sessionId
      */
     sessionId(): string;
 
@@ -224,7 +226,6 @@ export interface User {
      *
      * @private
      * @returns {JQuery.Promise<mw.Api.UserInfo>}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user-method-getUserInfo
      */
     getUserInfo(): JQuery.Promise<mw.Api.UserInfo>;
 }
@@ -234,7 +235,7 @@ declare global {
         /**
          * User library provided by `mediawiki.user` ResourceLoader module.
          *
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.user
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html
          */
         const user: User;
     }
diff --git a/mw/util.d.ts b/mw/util.d.ts
index 2084e61..41f5c80 100644
--- a/mw/util.d.ts
+++ b/mw/util.d.ts
@@ -9,6 +9,9 @@ type NoReturn<T extends (...args: any[]) => any> = T extends (
         : (this: U, ...args: V) => void
     : never;
 
+/**
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#~ResizeableThumbnailUrl
+ */
 interface ResizeableThumbnailUrl {
     /**
      * File name (same format as {@link mw.Title.getMainText()}).
@@ -44,7 +47,7 @@ declare global {
          * // In gadgets
          * const mwUtil = mw.util;
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html
          */
         namespace util {
             /**
@@ -64,7 +67,7 @@ declare global {
              * allow your code to re-run when the page changes (e.g. live preview
              * or re-render after ajax save).
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-property-S-content
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.$content
              */
             const $content: JQuery;
 
@@ -85,11 +88,11 @@ declare global {
              * } );
              * ```
              *
-             * See also [MDN: CSSStyleSheet](https://developer.mozilla.org/en-US/docs/Web/API/CSSStyleSheet).
+             * See also {@link https://developer.mozilla.org/en-US/docs/Web/API/CSSStyleSheet MDN: CSSStyleSheet}.
              *
              * @param {string} text CSS to be appended
              * @returns {CSSStyleSheet} The sheet object
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-addCSS
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addCSS
              */
             function addCSS(text: string): CSSStyleSheet;
 
@@ -103,7 +106,7 @@ declare global {
              * @returns {HTMLElement|null} will be null if it was not possible to create an portlet with
              *  the required information e.g. the selector given in before parameter could not be resolved
              *  to an existing element in the page.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-addPortlet
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addPortlet
              */
             function addPortlet(id: string, label?: string, before?: string): HTMLElement | null;
 
@@ -173,7 +176,7 @@ declare global {
              *  Must be another item in the same list, it will be ignored otherwise.
              *  Can be specified as DOM reference, as jQuery object, or as CSS selector string.
              * @returns {HTMLLIElement|null} The added list item, or null if no element was added.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-addPortletLink
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addPortletLink
              */
             function addPortletLink(
                 portletId: string,
@@ -189,7 +192,7 @@ declare global {
              * Add content to the subtitle of the skin.
              *
              * @param {HTMLElement|string} nodeOrHTMLString
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-addSubtitle
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addSubtitle
              */
             function addSubtitle(nodeOrHTMLString: HTMLElement | string): void;
 
@@ -197,7 +200,7 @@ declare global {
              * Clears the entire subtitle if present in the page. Used for refreshing subtitle
              * after edit with response from parse API.
              *
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-clearSubtitle
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.clearSubtitle
              */
             function clearSubtitle(): void;
 
@@ -209,14 +212,14 @@ declare global {
              *
              * Ported from Underscore.js 1.5.2, Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud
              * and Investigative Reporters & Editors, distributed under the MIT license, from
-             * <https://github.com/jashkenas/underscore/blob/1.5.2/underscore.js#L689>.
+             * {@link https://github.com/jashkenas/underscore/blob/1.5.2/underscore.js#L689}.
              *
              * @since 1.34
              * @param {Function} func Function to debounce
              * @param {number} [wait=0] Wait period in milliseconds
              * @param {boolean} [immediate] Trigger on leading edge
              * @returns {Function} Debounced function
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-debounce
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.debounce
              */
             function debounce<T extends (...args: any[]) => any>(
                 func: T,
@@ -236,7 +239,7 @@ declare global {
              * @since 1.30
              * @param {string} str String to encode
              * @returns {string} Encoded string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-escapeIdForAttribute
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.escapeIdForAttribute
              */
             function escapeIdForAttribute(str: string): string;
 
@@ -248,7 +251,7 @@ declare global {
              * @since 1.30
              * @param {string} str String to encode
              * @returns {string} Encoded string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-escapeIdForLink
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.escapeIdForLink
              */
             function escapeIdForLink(str: string): string;
 
@@ -264,7 +267,7 @@ declare global {
              * @since 1.26; moved to {@link mw.util} in 1.34
              * @param {string} str String to escape
              * @returns {string} Escaped string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-escapeRegExp
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.escapeRegExp
              */
             function escapeRegExp(str: string): string;
 
@@ -282,7 +285,7 @@ declare global {
              * @param {string} param The parameter name.
              * @param {URLSearchParams} [params] Parsed URL parameters to search through, defaulting to the current browsing location.
              * @returns {string[]|null} Parameter value, or null if parameter was not found.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-getArrayParam
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.getArrayParam
              */
             function getArrayParam(param: string, params?: URLSearchParams): string[] | null;
 
@@ -298,7 +301,7 @@ declare global {
              * @param {string} param The parameter name.
              * @param {string} [url=location.href] URL to search through, defaulting to the current browsing location.
              * @returns {string|null} Parameter value, or null if parameter was not found.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-getParamValue
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.getParamValue
              */
             function getParamValue(param: string, url?: string): string | null;
 
@@ -320,7 +323,7 @@ declare global {
              * @param {string} [hash] Hash fragment, without the leading '#'.
              *  Taken from location.hash if omitted.
              * @returns {HTMLElement|null} Element, if found
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-getTargetFromFragment
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.getTargetFromFragment
              */
             function getTargetFromFragment(hash?: string): HTMLElement | null;
 
@@ -331,7 +334,7 @@ declare global {
              * @param {QueryParams} [params] A mapping of query parameter names to values,
              *  e.g. `{ action: 'edit' }`
              * @returns {string} URL, relative to `wgServer`.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-getUrl
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.getUrl
              */
             // params are handled by $.param, which converts any value to a string. However, instead of using toString(),
             // object are serialized (deep ones recursively), so only simple values are allowed to prevent mistakes.
@@ -341,7 +344,7 @@ declare global {
              * Hide a portlet.
              *
              * @param {string} portletId ID of the target portlet (e.g. 'p-cactions' or 'p-personal')
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-hidePortlet
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.hidePortlet
              */
             function hidePortlet(portletId: string): void;
 
@@ -351,8 +354,8 @@ declare global {
              * such as watchlisting, page protection, and block expiries.
              *
              * @param {string|null} str
-             * @return {boolean}
-             * @stable
+             * @returns {boolean}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isInfinity
              */
             function isInfinity(str: string | null): boolean;
 
@@ -363,7 +366,7 @@ declare global {
              * @param {string} address String to check
              * @param {boolean} [allowBlock=false] If a block of IPs should be allowed
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-isIPAddress
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isIPAddress
              */
             function isIPAddress(address: string, allowBlock?: boolean): boolean;
 
@@ -385,7 +388,7 @@ declare global {
              * @param {string} address
              * @param {boolean} [allowBlock=false]
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-isIPv4Address
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isIPv4Address
              */
             function isIPv4Address(
                 address: string,
@@ -414,7 +417,7 @@ declare global {
              * @param {string} address
              * @param {boolean} [allowBlock=false]
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-isIPv6Address
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isIPv6Address
              */
             function isIPv6Address(address: string, allowBlock?: boolean): boolean;
 
@@ -423,7 +426,7 @@ declare global {
              *
              * @param {string} portletId ID of the target portlet (e.g. 'p-cactions' or 'p-personal')
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-isPortletVisible
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isPortletVisible
              */
             function isPortletVisible(portletId: string): boolean;
 
@@ -434,7 +437,7 @@ declare global {
              *
              * @param {string} username
              * @returns {boolean}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-isTemporaryUser
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isTemporaryUser
              */
             function isTemporaryUser(username: string): boolean;
 
@@ -446,7 +449,7 @@ declare global {
              * @param {string} url URL to parse (URL-encoded)
              * @returns {ResizeableThumbnailUrl|null} URL data, or null if the URL is not a valid MediaWiki
              *  image/thumbnail URL.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-parseImageUrl
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.parseImageUrl
              */
             function parseImageUrl(url: string): ResizeableThumbnailUrl | null;
 
@@ -464,7 +467,7 @@ declare global {
              *
              * @param {string} text Text to decode
              * @returns {string|null} Decoded text, null if decoding failed
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-percentDecodeFragment
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.percentDecodeFragment
              */
             function percentDecodeFragment(text: string): string | null;
 
@@ -477,7 +480,7 @@ declare global {
              *
              * @param {string} ip IP address in quad or octet form (CIDR or not).
              * @returns {string|null}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-prettifyIP
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.prettifyIP
              */
             function prettifyIP(ip: string): string | null;
 
@@ -486,7 +489,7 @@ declare global {
              *
              * @param {string} str String to be encoded.
              * @returns {string} Encoded string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-rawurlencode
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.rawurlencode
              */
             function rawurlencode(str: string): string;
 
@@ -501,7 +504,7 @@ declare global {
              *
              * @param {string} ip IP address in quad or octet form (CIDR or not).
              * @returns {string|null}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-sanitizeIP
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.sanitizeIP
              */
             function sanitizeIP(ip: string): string | null;
 
@@ -509,7 +512,7 @@ declare global {
              * Reveal a portlet if it is hidden.
              *
              * @param {string} portletId ID of the target portlet (e.g. 'p-cactions' or 'p-personal')
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-showPortlet
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.showPortlet
              */
             function showPortlet(portletId: string): void;
 
@@ -527,7 +530,7 @@ declare global {
              * @param {Function} func Function to throttle
              * @param {number} wait Throttle window length, in milliseconds
              * @returns {Function} Throttled function
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-throttle
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.throttle
              */
             function throttle<T extends (...args: any[]) => any>(
                 func: T,
@@ -545,7 +548,7 @@ declare global {
              * ```
              * @param {string} email E-mail address
              * @returns {boolean|null} True if valid, false if invalid, null if `email` was empty.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-validateEmail
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.validateEmail
              */
             function validateEmail(email: string): boolean | null;
 
@@ -557,7 +560,7 @@ declare global {
              * @since 1.18
              * @param {string} [str="index"] Name of entry point (e.g. 'index' or 'api')
              * @returns {string} URL to the script file (e.g. `/w/api.php`)
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-wikiScript
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.wikiScript
              */
             function wikiScript(str?: string): string;
 
@@ -572,7 +575,7 @@ declare global {
              *
              * @param {string} str String to be encoded.
              * @returns {string} Encoded string
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/#!/api/mw.util-method-wikiUrlencode
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.wikiUrlencode
              */
             function wikiUrlencode(str: string): string;
         }

From 0680f0185fb3a1464d15c34166835d61d04c9f6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Thu, 25 Apr 2024 19:07:02 +0200
Subject: [PATCH 08/15] Sort members consistency

---
 jquery/colorUtil.d.ts |  80 +++---
 mw/Api.d.ts           | 596 +++++++++++++++++++++---------------------
 mw/Rest.d.ts          |  54 ++--
 mw/notification.d.ts  |  28 +-
 mw/template.d.ts      |  80 +++---
 5 files changed, 419 insertions(+), 419 deletions(-)

diff --git a/jquery/colorUtil.d.ts b/jquery/colorUtil.d.ts
index 24ccb19..8585faf 100644
--- a/jquery/colorUtil.d.ts
+++ b/jquery/colorUtil.d.ts
@@ -10,18 +10,6 @@ declare global {
 type Color = [number, number, number];
 
 interface ColorUtil {
-    /**
-     * Parse CSS color strings looking for color tuples
-     *
-     * Based on highlightFade by Blair Mitchelmore
-     * {@link http://jquery.offput.ca/highlightFade/}
-     *
-     * @param {Color|string} color
-     * @returns {Color}
-     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getRGB
-     */
-    getRGB<T extends Color>(color: string | T): T;
-
     /**
      * Named color map
      *
@@ -33,23 +21,38 @@ interface ColorUtil {
     colors: Record<string, Color>;
 
     /**
-     * Convert an RGB color value to HSL.
+     * Get a brighter or darker rgb() value string.
      *
-     * Conversion formula based on
-     * {@link http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript}
+     * Usage:
      *
-     * Adapted from {@link https://en.wikipedia.org/wiki/HSL_color_space}.
+     * ```js
+     * $.colorUtil.getColorBrightness( 'red', +0.1 );
+     * // > "rgb(255,50,50)"
+     * $.colorUtil.getColorBrightness( 'rgb(200,50,50)', -0.2 );
+     * // > "rgb(118,29,29)"
+     * ```
      *
-     * Assumes `r`, `g`, and `b` are contained in the set `[0, 255]` and
-     * returns `h`, `s`, and `l` in the set `[0, 1]`.
+     * @param {Color|string} currentColor Current value in css
+     * @param {number} mod Wanted brightness modification between -1 and 1
+     * @returns {string} Like `'rgb(r,g,b)'`
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getColorBrightness
+     */
+    getColorBrightness(
+        currentColor: string | Color,
+        mod: number
+    ): `rgb(${number},${number},${number})`;
+
+    /**
+     * Parse CSS color strings looking for color tuples
      *
-     * @param {number} r The red color value
-     * @param {number} g The green color value
-     * @param {number} b The blue color value
-     * @returns {Color} The HSL representation
-     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-rgbToHsl
+     * Based on highlightFade by Blair Mitchelmore
+     * {@link http://jquery.offput.ca/highlightFade/}
+     *
+     * @param {Color|string} color
+     * @returns {Color}
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getRGB
      */
-    rgbToHsl(r: number, g: number, b: number): Color;
+    getRGB<T extends Color>(color: string | T): T;
 
     /**
      * Convert an HSL color value to RGB.
@@ -71,26 +74,23 @@ interface ColorUtil {
     hslToRgb(h: number, s: number, l: number): Color;
 
     /**
-     * Get a brighter or darker rgb() value string.
+     * Convert an RGB color value to HSL.
      *
-     * Usage:
+     * Conversion formula based on
+     * {@link http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript}
      *
-     * ```js
-     * $.colorUtil.getColorBrightness( 'red', +0.1 );
-     * // > "rgb(255,50,50)"
-     * $.colorUtil.getColorBrightness( 'rgb(200,50,50)', -0.2 );
-     * // > "rgb(118,29,29)"
-     * ```
+     * Adapted from {@link https://en.wikipedia.org/wiki/HSL_color_space}.
      *
-     * @param {Color|string} currentColor Current value in css
-     * @param {number} mod Wanted brightness modification between -1 and 1
-     * @returns {string} Like `'rgb(r,g,b)'`
-     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-getColorBrightness
+     * Assumes `r`, `g`, and `b` are contained in the set `[0, 255]` and
+     * returns `h`, `s`, and `l` in the set `[0, 1]`.
+     *
+     * @param {number} r The red color value
+     * @param {number} g The green color value
+     * @param {number} b The blue color value
+     * @returns {Color} The HSL representation
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil-method-rgbToHsl
      */
-    getColorBrightness(
-        currentColor: string | Color,
-        mod: number
-    ): `rgb(${number},${number},${number})`;
+    rgbToHsl(r: number, g: number, b: number): Color;
 }
 
 export {};
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index ab70cb8..e87887d 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -1,13 +1,13 @@
 import {
+    ApiAssert,
     ApiEditPageParams,
     ApiLegacyTokenType,
     ApiParseParams,
     ApiQueryAllMessagesParams,
+    ApiQueryTokensParams,
     ApiRollbackParams,
     ApiTokenType,
     ApiUploadParams,
-    ApiAssert,
-    ApiQueryTokensParams,
 } from "../api_params";
 import { TitleLike } from "./Title";
 
@@ -134,40 +134,6 @@ declare global {
              */
             abort(): void;
 
-            /**
-             * Perform API get request. See {@link ajax()} for details.
-             *
-             * @param {UnknownApiParams} parameters
-             * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#get
-             */
-            get(
-                parameters: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
-            ): JQuery.Promise<ApiResponse>;
-
-            /**
-             * Perform API post request. See {@link ajax()} for details.
-             *
-             * @param {UnknownApiParams} parameters
-             * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#post
-             */
-            post(
-                parameters: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
-            ): JQuery.Promise<ApiResponse>;
-
-            /**
-             * Massage parameters from the nice format we accept into a format suitable for the API.
-             *
-             * @param {UnknownApiParams} parameters (modified in-place)
-             * @param {boolean} useUS Whether to use U+001F when joining multi-valued parameters.
-             */
-            private preprocessParameters(parameters: UnknownApiParams, useUS: boolean): void;
-
             /**
              * Perform the API call.
              *
@@ -203,64 +169,35 @@ declare global {
             ): JQuery.Promise<ApiResponse>;
 
             /**
-             * Post to API with the specified type of token. If we have no token, get one and try to post.
-             * If we already have a cached token, try using that, and if the request fails using the cached token,
-             * blank it out and start over.
+             * Extend an API parameter object with an assertion that the user won't change.
              *
-             * @example <caption>For example, to change a user option, you could do:</caption>
+             * This is useful for API calls which create new revisions or log entries. When the current
+             * page was loaded when the user was logged in, but at the time of the API call the user
+             * is not logged in anymore (e.g. due to session expiry), their IP is recorded in the page
+             * history or log, which can cause serious privacy issues. Extending the API parameters via
+             * this method ensures that that won't happen, by checking the user's identity that was
+             * embedded into the page when it was rendered against the active session on the server.
+             *
+             * When the assertion fails, the API request will fail, with one of the following error codes:
+             * - `apierror-assertanonfailed`: when the client-side logic thinks the user is anonymous
+             *   but the server thinks it is logged in
+             * - `apierror-assertuserfailed`: when the client-side logic thinks the user is logged in but the
+             *   server thinks it is anonymous
+             * - `apierror-assertnameduserfailed`: when both the client-side logic and the server thinks the
+             *   user is logged in but they see it logged in under a different username.
+             *
+             * @example
              * ```js
-             * new mw.Api().postWithToken( 'csrf', {
-             *     action: 'options',
-             *     optionname: 'gender',
-             *     optionvalue: 'female'
-             * } );
+             * api.postWithToken( 'csrf', api.assertCurrentUser( { action: 'edit', ... } ) )
              * ```
-             * @since 1.22
-             * @param {string} tokenType The name of the token, like `options` or `edit`.
-             * @param {UnknownApiParams} params API parameters
-             * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithToken
-             */
-            postWithToken(
-                tokenType: ApiTokenType,
-                params: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
-            ): JQuery.Promise<ApiResponse>;
-            /** @deprecated Use "csrf" instead */
-            postWithToken(
-                tokenType: ApiLegacyTokenType,
-                params: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
-            ): JQuery.Promise<ApiResponse>;
-            postWithToken(
-                tokenType: string,
-                params: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
-            ): JQuery.Promise<ApiResponse>;
-
-            /**
-             * Get a token for a certain action from the API.
-             *
-             * @since 1.22
-             * @param {string} type Token type
-             * @param {ApiQueryTokensParams|ApiAssert} [additionalParams] Additional parameters for the API (since 1.35). When given a string, it's treated as the `assert` parameter (since 1.25).
-             * @returns {JQuery.Promise<string>} Received token.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getToken
+             * @since 1.27
+             * @param {UnknownApiParams} query Query parameters. The object will not be changed
+             * @returns {AssertUser}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#assertCurrentUser
              */
-            getToken(
-                type: ApiTokenType,
-                additionalParams?: ApiQueryTokensParams | ApiAssert
-            ): JQuery.Promise<string>;
-            /** @deprecated Use "csrf" instead */
-            getToken(
-                type: ApiLegacyTokenType,
-                additionalParams?: ApiQueryTokensParams | ApiAssert
-            ): JQuery.Promise<string>;
-            getToken(
-                type: string,
-                additionalParams?: ApiQueryTokensParams | ApiAssert
-            ): JQuery.Promise<string>;
+            assertCurrentUser<T extends UnknownApiParams>(
+                query: T
+            ): Omit<T, keyof AssertUser> & AssertUser;
 
             /**
              * Indicate that the cached token for a certain action of the API is bad.
@@ -279,61 +216,42 @@ declare global {
             badToken(type: string): void;
 
             /**
-             * Given an API response indicating an error, get a jQuery object containing a human-readable
-             * error message that you can display somewhere on the page.
-             *
-             * For better quality of error messages, it's recommended to use the following options in your
-             * API queries:
-             *
-             * ```js
-             * errorformat: 'html',
-             * errorlang: mw.config.get( 'wgUserLanguage' ),
-             * errorsuselocal: true,
-             * ```
-             *
-             * Error messages, particularly for editing pages, may consist of multiple paragraphs of text.
-             * Your user interface should have enough space for that.
-             *
-             * @example
-             * ```js
-             * var api = new mw.Api();
-             * // var title = 'Test valid title';
-             * var title = 'Test invalid title <>';
-             * api.postWithToken( 'watch', {
-             *     action: 'watch',
-             *     title: title
-             * } ).then( function ( data ) {
-             *     mw.notify( 'Success!' );
-             * }, function ( code, data ) {
-             *     mw.notify( api.getErrorMessage( data ), { type: 'error' } );
-             * } );
-             * ```
-             * @param {ApiResponse} data API response indicating an error
-             * @returns {JQuery} Error messages, each wrapped in a `<div>`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getErrorMessage
-             */
-            getErrorMessage(data: ApiResponse): JQuery;
-
-            /**
-             * Post to API with csrf token. If we have no token, get one and try to post. If we have a cached token try using that, and if it fails, blank out the cached token and start over.
+             * Upload a file in several chunks.
              *
-             * @param {UnknownApiParams} params API parameters
-             * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<ApiResponse>} See {@link post}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithEditToken
+             * @param {File} file
+             * @param {ApiUploadParams} data Other upload options, see `action=upload` API docs for more
+             * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
+             * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
+             * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUpload
              */
-            postWithEditToken(
-                params: UnknownApiParams,
-                ajaxOptions?: JQuery.AjaxSettings
+            chunkedUpload(
+                file: File,
+                data: ApiUploadParams,
+                chunkSize?: number,
+                chunkRetries?: number
             ): JQuery.Promise<ApiResponse>;
 
             /**
-             * API helper to grab a csrf token.
+             * Upload a file to the stash, in chunks.
              *
-             * @returns {JQuery.Promise<string>} Received token.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getEditToken
+             * This function will return a promise that will resolve with a function to finish the stash upload.
+             * See {@link uploadToStash}.
+             *
+             * @param {File|HTMLInputElement} file
+             * @param {ApiUploadParams} [data]
+             * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
+             * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
+             * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
+             *  function that should be called to finish the upload.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUploadToStash
              */
-            getEditToken(): JQuery.Promise<string>;
+            chunkedUploadToStash(
+                file: File | HTMLInputElement,
+                data?: ApiUploadParams,
+                chunkSize?: number,
+                chunkRetries?: number
+            ): JQuery.Promise<FinishUpload>;
 
             /**
              * Create a new page.
@@ -422,152 +340,136 @@ declare global {
             edit(title: TitleLike, transform: Api.EditTransform): JQuery.Promise<EditResult>;
 
             /**
-             * Post a new section to the page.
+             * Perform API get request. See {@link ajax()} for details.
              *
-             * @param {TitleLike} title Target page
-             * @param {string} header
-             * @param {string} message Wikitext message
-             * @param {ApiEditPageParams} additionalParams Additional API parameters
-             * @returns {JQuery.Promise<ApiResponse>} See {@link postWithEditToken}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#newSection
+             * @param {UnknownApiParams} parameters
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#get
              */
-            newSection(
-                title: TitleLike,
-                header: string,
-                message: string,
-                additionalParams?: ApiEditPageParams
+            get(
+                parameters: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
             ): JQuery.Promise<ApiResponse>;
 
             /**
-             * Get the current user's groups and rights.
+             * Get the categories that a particular page on the wiki belongs to.
              *
-             * @since 1.27
-             * @returns {JQuery.Promise<Api.UserInfo>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getUserInfo
+             * @param {TitleLike} title
+             * @returns {JQuery.Promise<false|Title[]>} Promise that resolves with an array of category titles, or with false if the title was not found.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategories
              */
-            getUserInfo(): JQuery.Promise<Api.UserInfo>;
+            getCategories(title: TitleLike): JQuery.Promise<false | Title[]>;
 
             /**
-             * Extend an API parameter object with an assertion that the user won't change.
-             *
-             * This is useful for API calls which create new revisions or log entries. When the current
-             * page was loaded when the user was logged in, but at the time of the API call the user
-             * is not logged in anymore (e.g. due to session expiry), their IP is recorded in the page
-             * history or log, which can cause serious privacy issues. Extending the API parameters via
-             * this method ensures that that won't happen, by checking the user's identity that was
-             * embedded into the page when it was rendered against the active session on the server.
+             * Get a list of categories that match a certain prefix.
              *
-             * When the assertion fails, the API request will fail, with one of the following error codes:
-             * - `apierror-assertanonfailed`: when the client-side logic thinks the user is anonymous
-             *   but the server thinks it is logged in
-             * - `apierror-assertuserfailed`: when the client-side logic thinks the user is logged in but the
-             *   server thinks it is anonymous
-             * - `apierror-assertnameduserfailed`: when both the client-side logic and the server thinks the
-             *   user is logged in but they see it logged in under a different username.
+             * E.g. given "Foo", return "Food", "Foolish people", "Foosball tables"...
              *
-             * @example
-             * ```js
-             * api.postWithToken( 'csrf', api.assertCurrentUser( { action: 'edit', ... } ) )
-             * ```
-             * @since 1.27
-             * @param {UnknownApiParams} query Query parameters. The object will not be changed
-             * @returns {AssertUser}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#assertCurrentUser
+             * @param {string} prefix Prefix to match.
+             * @returns {JQuery.Promise<string[]>} Promise that resolves with an array of matched categories
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategoriesByPrefix
              */
-            assertCurrentUser<T extends UnknownApiParams>(
-                query: T
-            ): Omit<T, keyof AssertUser> & AssertUser;
+            getCategoriesByPrefix(prefix: string): JQuery.Promise<string[]>;
 
             /**
-             * Asynchronously save the value of a single user option using the API.
-             * See {@link saveOptions()}.
+             * API helper to grab a csrf token.
              *
-             * @param {string} name
-             * @param {string|null} value
-             * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOption
+             * @returns {JQuery.Promise<string>} Received token.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getEditToken
              */
-            saveOption(name: string, value: string | null): JQuery.Promise<ApiResponse>;
+            getEditToken(): JQuery.Promise<string>;
 
             /**
-             * Asynchronously save the values of user options using the {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Options Options API}.
-             *
-             * If a value of `null` is provided, the given option will be reset to the default value.
+             * Given an API response indicating an error, get a jQuery object containing a human-readable
+             * error message that you can display somewhere on the page.
              *
-             * Any warnings returned by the API, including warnings about invalid option names or values,
-             * are ignored. However, do not rely on this behavior.
+             * For better quality of error messages, it's recommended to use the following options in your
+             * API queries:
              *
-             * If necessary, the options will be saved using several sequential API requests. Only one promise
-             * is always returned that will be resolved when all requests complete.
+             * ```js
+             * errorformat: 'html',
+             * errorlang: mw.config.get( 'wgUserLanguage' ),
+             * errorsuselocal: true,
+             * ```
              *
-             * If a request from a previous {@link saveOptions()} call is still pending, this will wait for it to be
-             * completed, otherwise MediaWiki gets sad. No requests are sent for anonymous users, as they
-             * would fail anyway. See T214963.
+             * Error messages, particularly for editing pages, may consist of multiple paragraphs of text.
+             * Your user interface should have enough space for that.
              *
-             * @param {Object.<string, string|null>} options Options as a `{ name: value, … }` object
-             * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOptions
+             * @example
+             * ```js
+             * var api = new mw.Api();
+             * // var title = 'Test valid title';
+             * var title = 'Test invalid title <>';
+             * api.postWithToken( 'watch', {
+             *     action: 'watch',
+             *     title: title
+             * } ).then( function ( data ) {
+             *     mw.notify( 'Success!' );
+             * }, function ( code, data ) {
+             *     mw.notify( api.getErrorMessage( data ), { type: 'error' } );
+             * } );
+             * ```
+             * @param {ApiResponse} data API response indicating an error
+             * @returns {JQuery} Error messages, each wrapped in a `<div>`
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getErrorMessage
              */
-            saveOptions(options: Record<string, string | null>): JQuery.Promise<ApiResponse>;
+            getErrorMessage(data: ApiResponse): JQuery;
 
             /**
-             * Convenience method for `action=watch`.
+             * Get a set of messages.
              *
-             * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled
-             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
-             *  array thereof. If an array is passed, the return value passed to the promise will also be an
-             *  array of appropriate objects.
-             * @param {string} [expiry] When the page should expire from the watchlist. If omitted, the
-             *  page will not expire.
-             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
-             *  with an object (or array of objects) describing each page that was passed in and its
-             *  current watched/unwatched status.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#watch
+             * @since 1.27
+             * @param {string|string[]} messages Messages to retrieve
+             * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
+             * @returns {JQuery.Promise<Object.<string, string>>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getMessages
              */
-            watch<P extends TypeOrArray<TitleLike>>(
-                pages: P,
-                expiry?: string
-            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
+            getMessages<T extends string>(
+                messages: T | T[],
+                options?: ApiQueryAllMessagesParams
+            ): JQuery.Promise<Partial<Record<T, string>>>;
 
             /**
-             * Convenience method for `action=watch&unwatch=1`.
+             * Get a token for a certain action from the API.
              *
-             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
-             *  array thereof. If an array is passed, the return value passed to the promise will also be an
-             *  array of appropriate objects.
-             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
-             *  with an object (or array of objects) describing each page that was passed in and its
-             *  current watched/unwatched status.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#unwatch
+             * @since 1.22
+             * @param {string} type Token type
+             * @param {ApiQueryTokensParams|ApiAssert} [additionalParams] Additional parameters for the API (since 1.35). When given a string, it's treated as the `assert` parameter (since 1.25).
+             * @returns {JQuery.Promise<string>} Received token.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getToken
              */
-            unwatch<P extends TypeOrArray<TitleLike>>(
-                pages: P
-            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
+            getToken(
+                type: ApiTokenType,
+                additionalParams?: ApiQueryTokensParams | ApiAssert
+            ): JQuery.Promise<string>;
+            /** @deprecated Use "csrf" instead */
+            getToken(
+                type: ApiLegacyTokenType,
+                additionalParams?: ApiQueryTokensParams | ApiAssert
+            ): JQuery.Promise<string>;
+            getToken(
+                type: string,
+                additionalParams?: ApiQueryTokensParams | ApiAssert
+            ): JQuery.Promise<string>;
 
             /**
-             * Convenience method for `action=parse`.
+             * Get the current user's groups and rights.
              *
-             * @param {TitleLike} content Content to parse, either as a wikitext string or a {@link mw.Title}
-             * @param {ApiParseParams} [additionalParams] Parameters object to set custom settings, e.g.
-             *   `redirects`, `sectionpreview`. `prop` should not be overridden.
-             * @returns {JQuery.Promise<string>} Promise that resolves with the parsed HTML of `wikitext`
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#parse
+             * @since 1.27
+             * @returns {JQuery.Promise<Api.UserInfo>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getUserInfo
              */
-            parse(content: TitleLike, additionalParams?: ApiParseParams): JQuery.Promise<string>;
+            getUserInfo(): JQuery.Promise<Api.UserInfo>;
 
             /**
-             * Get a set of messages.
+             * Determine if a category exists.
              *
-             * @since 1.27
-             * @param {string|string[]} messages Messages to retrieve
-             * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
-             * @returns {JQuery.Promise<Object.<string, string>>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getMessages
+             * @param {TitleLike} title
+             * @returns {JQuery.Promise<boolean>} Promise that resolves with a boolean indicating whether the category exists.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#isCategory
              */
-            getMessages<T extends string>(
-                messages: T | T[],
-                options?: ApiQueryAllMessagesParams
-            ): JQuery.Promise<Partial<Record<T, string>>>;
+            isCategory(title: TitleLike): JQuery.Promise<boolean>;
 
             /**
              * Load a set of messages and add them to {@link mw.messages}.
@@ -598,33 +500,103 @@ declare global {
             ): JQuery.Promise<boolean>;
 
             /**
-             * Determine if a category exists.
+             * @param {string} username
+             * @param {string} password
+             * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#login
+             */
+            login(username: string, password: string): JQuery.Promise<ApiResponse>;
+
+            /**
+             * Post a new section to the page.
              *
-             * @param {TitleLike} title
-             * @returns {JQuery.Promise<boolean>} Promise that resolves with a boolean indicating whether the category exists.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#isCategory
+             * @param {TitleLike} title Target page
+             * @param {string} header
+             * @param {string} message Wikitext message
+             * @param {ApiEditPageParams} additionalParams Additional API parameters
+             * @returns {JQuery.Promise<ApiResponse>} See {@link postWithEditToken}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#newSection
              */
-            isCategory(title: TitleLike): JQuery.Promise<boolean>;
+            newSection(
+                title: TitleLike,
+                header: string,
+                message: string,
+                additionalParams?: ApiEditPageParams
+            ): JQuery.Promise<ApiResponse>;
 
             /**
-             * Get a list of categories that match a certain prefix.
+             * Convenience method for `action=parse`.
              *
-             * E.g. given "Foo", return "Food", "Foolish people", "Foosball tables"...
+             * @param {TitleLike} content Content to parse, either as a wikitext string or a {@link mw.Title}
+             * @param {ApiParseParams} [additionalParams] Parameters object to set custom settings, e.g.
+             *   `redirects`, `sectionpreview`. `prop` should not be overridden.
+             * @returns {JQuery.Promise<string>} Promise that resolves with the parsed HTML of `wikitext`
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#parse
+             */
+            parse(content: TitleLike, additionalParams?: ApiParseParams): JQuery.Promise<string>;
+
+            /**
+             * Perform API post request. See {@link ajax()} for details.
              *
-             * @param {string} prefix Prefix to match.
-             * @returns {JQuery.Promise<string[]>} Promise that resolves with an array of matched categories
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategoriesByPrefix
+             * @param {UnknownApiParams} parameters
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#post
              */
-            getCategoriesByPrefix(prefix: string): JQuery.Promise<string[]>;
+            post(
+                parameters: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
+            ): JQuery.Promise<ApiResponse>;
 
             /**
-             * Get the categories that a particular page on the wiki belongs to.
+             * Post to API with csrf token. If we have no token, get one and try to post. If we have a cached token try using that, and if it fails, blank out the cached token and start over.
              *
-             * @param {TitleLike} title
-             * @returns {JQuery.Promise<false|Title[]>} Promise that resolves with an array of category titles, or with false if the title was not found.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#getCategories
+             * @param {UnknownApiParams} params API parameters
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<ApiResponse>} See {@link post}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithEditToken
              */
-            getCategories(title: TitleLike): JQuery.Promise<false | Title[]>;
+            postWithEditToken(
+                params: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
+            ): JQuery.Promise<ApiResponse>;
+
+            /**
+             * Post to API with the specified type of token. If we have no token, get one and try to post.
+             * If we already have a cached token, try using that, and if the request fails using the cached token,
+             * blank it out and start over.
+             *
+             * @example <caption>For example, to change a user option, you could do:</caption>
+             * ```js
+             * new mw.Api().postWithToken( 'csrf', {
+             *     action: 'options',
+             *     optionname: 'gender',
+             *     optionvalue: 'female'
+             * } );
+             * ```
+             * @since 1.22
+             * @param {string} tokenType The name of the token, like `options` or `edit`.
+             * @param {UnknownApiParams} params API parameters
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#postWithToken
+             */
+            postWithToken(
+                tokenType: ApiTokenType,
+                params: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
+            ): JQuery.Promise<ApiResponse>;
+            /** @deprecated Use "csrf" instead */
+            postWithToken(
+                tokenType: ApiLegacyTokenType,
+                params: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
+            ): JQuery.Promise<ApiResponse>;
+            postWithToken(
+                tokenType: string,
+                params: UnknownApiParams,
+                ajaxOptions?: JQuery.AjaxSettings
+            ): JQuery.Promise<ApiResponse>;
 
             /**
              * Convenience method for `action=rollback`.
@@ -643,42 +615,51 @@ declare global {
             ): JQuery.Promise<RollbackInfo>;
 
             /**
-             * Upload a file in several chunks.
+             * Asynchronously save the value of a single user option using the API.
+             * See {@link saveOptions()}.
              *
-             * @param {File} file
-             * @param {ApiUploadParams} data Other upload options, see `action=upload` API docs for more
-             * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
-             * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
+             * @param {string} name
+             * @param {string|null} value
              * @returns {JQuery.Promise<ApiResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUpload
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOption
              */
-            chunkedUpload(
-                file: File,
-                data: ApiUploadParams,
-                chunkSize?: number,
-                chunkRetries?: number
-            ): JQuery.Promise<ApiResponse>;
+            saveOption(name: string, value: string | null): JQuery.Promise<ApiResponse>;
 
             /**
-             * Upload a file to the stash, in chunks.
+             * Asynchronously save the values of user options using the {@link https://www.mediawiki.org/wiki/Special:MyLanguage/API:Options Options API}.
              *
-             * This function will return a promise that will resolve with a function to finish the stash upload.
-             * See {@link uploadToStash}.
+             * If a value of `null` is provided, the given option will be reset to the default value.
              *
-             * @param {File|HTMLInputElement} file
-             * @param {ApiUploadParams} [data]
-             * @param {number} [chunkSize] Size (in bytes) per chunk (default: 5MB)
-             * @param {number} [chunkRetries] Amount of times to retry a failed chunk (default: 1)
-             * @returns {JQuery.Promise<FinishUpload>} Promise that resolves with a
-             *  function that should be called to finish the upload.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#chunkedUploadToStash
+             * Any warnings returned by the API, including warnings about invalid option names or values,
+             * are ignored. However, do not rely on this behavior.
+             *
+             * If necessary, the options will be saved using several sequential API requests. Only one promise
+             * is always returned that will be resolved when all requests complete.
+             *
+             * If a request from a previous {@link saveOptions()} call is still pending, this will wait for it to be
+             * completed, otherwise MediaWiki gets sad. No requests are sent for anonymous users, as they
+             * would fail anyway. See T214963.
+             *
+             * @param {Object.<string, string|null>} options Options as a `{ name: value, … }` object
+             * @returns {JQuery.Promise<ApiResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#saveOptions
              */
-            chunkedUploadToStash(
-                file: File | HTMLInputElement,
-                data?: ApiUploadParams,
-                chunkSize?: number,
-                chunkRetries?: number
-            ): JQuery.Promise<FinishUpload>;
+            saveOptions(options: Record<string, string | null>): JQuery.Promise<ApiResponse>;
+
+            /**
+             * Convenience method for `action=watch&unwatch=1`.
+             *
+             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
+             *  array thereof. If an array is passed, the return value passed to the promise will also be an
+             *  array of appropriate objects.
+             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
+             *  with an object (or array of objects) describing each page that was passed in and its
+             *  current watched/unwatched status.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#unwatch
+             */
+            unwatch<P extends TypeOrArray<TitleLike>>(
+                pages: P
+            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
 
             /**
              * Upload a file to MediaWiki.
@@ -735,12 +716,31 @@ declare global {
             ): JQuery.Promise<FinishUpload>;
 
             /**
-             * @param {string} username
-             * @param {string} password
-             * @returns {JQuery.Promise<ApiResponse>} See {@link post()}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#login
+             * Convenience method for `action=watch`.
+             *
+             * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled
+             * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
+             *  array thereof. If an array is passed, the return value passed to the promise will also be an
+             *  array of appropriate objects.
+             * @param {string} [expiry] When the page should expire from the watchlist. If omitted, the
+             *  page will not expire.
+             * @returns {JQuery.Promise<TypeOrArray<Api.WatchedPage>>} A promise that resolves
+             *  with an object (or array of objects) describing each page that was passed in and its
+             *  current watched/unwatched status.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#watch
              */
-            login(username: string, password: string): JQuery.Promise<ApiResponse>;
+            watch<P extends TypeOrArray<TitleLike>>(
+                pages: P,
+                expiry?: string
+            ): JQuery.Promise<ReplaceValue<P, TitleLike, Api.WatchedPage>>;
+
+            /**
+             * Massage parameters from the nice format we accept into a format suitable for the API.
+             *
+             * @param {UnknownApiParams} parameters (modified in-place)
+             * @param {boolean} useUS Whether to use U+001F when joining multi-valued parameters.
+             */
+            private preprocessParameters(parameters: UnknownApiParams, useUS: boolean): void;
         }
 
         namespace Api {
@@ -766,14 +766,14 @@ declare global {
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#.Options
              */
             interface Options {
-                /**
-                 * Default query parameters for API requests
-                 */
-                parameters?: UnknownApiParams;
                 /**
                  * Default options for {@link jQuery.ajax}
                  */
                 ajax?: JQuery.AjaxSettings;
+                /**
+                 * Default query parameters for API requests
+                 */
+                parameters?: UnknownApiParams;
                 /**
                  * Whether to use U+001F when joining multi-valued parameters (since 1.28).
                  * Default is true if ajax.url is not set, false otherwise for compatibility.
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index 99bd11b..b76a7cf 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -45,6 +45,33 @@ declare global {
              */
             abort(): void;
 
+            /**
+             * Perform the API call.
+             *
+             * @param {string} path
+             * @param {JQuery.AjaxSettings} [ajaxOptions]
+             * @returns {JQuery.Promise<RestResponse>} Done: API response data and the jqXHR object.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#ajax
+             */
+            ajax(path: string, ajaxOptions?: JQuery.AjaxSettings): JQuery.Promise<RestResponse>;
+
+            /**
+             * Perform REST API DELETE request.
+             *
+             * Note: only sending `application/json` is currently supported.
+             *
+             * @param {string} path
+             * @param {Object.<string, any>} body
+             * @param {Object.<string, any>} [headers]
+             * @returns {JQuery.Promise<RestResponse>}
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#delete
+             */
+            delete(
+                path: string,
+                body: Record<string, any>,
+                headers?: Record<string, any>
+            ): JQuery.Promise<RestResponse>;
+
             /**
              * Perform REST API get request.
              *
@@ -93,33 +120,6 @@ declare global {
                 body: Record<string, any>,
                 headers?: Record<string, any>
             ): JQuery.Promise<RestResponse>;
-
-            /**
-             * Perform REST API DELETE request.
-             *
-             * Note: only sending `application/json` is currently supported.
-             *
-             * @param {string} path
-             * @param {Object.<string, any>} body
-             * @param {Object.<string, any>} [headers]
-             * @returns {JQuery.Promise<RestResponse>}
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Rest.html#delete
-             */
-            delete(
-                path: string,
-                body: Record<string, any>,
-                headers?: Record<string, any>
-            ): JQuery.Promise<RestResponse>;
-
-            /**
-             * Perform the API call.
-             *
-             * @param {string} path
-             * @param {JQuery.AjaxSettings} [ajaxOptions]
-             * @returns {JQuery.Promise<RestResponse>} Done: API response data and the jqXHR object.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#ajax
-             */
-            ajax(path: string, ajaxOptions?: JQuery.AjaxSettings): JQuery.Promise<RestResponse>;
         }
 
         namespace Rest {
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 032172a..3ff5d68 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -103,6 +103,20 @@ declare global {
              */
             const defaults: NotificationOptions;
 
+            /**
+             * Display a notification message to the user.
+             *
+             * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
+             * @param {NotificationOptions} [options] The options to use for the notification.
+             *  Options not specified default to the values in {@link defaults}.
+             * @returns {Notification} Notification object
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.notify
+             */
+            function notify(
+                message: string | Message | JQuery | HTMLElement | HTMLElement[],
+                options?: NotificationOptions
+            ): Notification;
+
             /**
              * Pause auto-hide timers for all notifications.
              * Notifications will not auto-hide until resume is called.
@@ -119,20 +133,6 @@ declare global {
              */
             function resume(): void;
 
-            /**
-             * Display a notification message to the user.
-             *
-             * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
-             * @param {NotificationOptions} [options] The options to use for the notification.
-             *  Options not specified default to the values in {@link defaults}.
-             * @returns {Notification} Notification object
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.notify
-             */
-            function notify(
-                message: string | Message | JQuery | HTMLElement | HTMLElement[],
-                options?: NotificationOptions
-            ): Notification;
-
             /**
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.NotificationOptions
              */
diff --git a/mw/template.d.ts b/mw/template.d.ts
index c889c14..8b2c3c3 100644
--- a/mw/template.d.ts
+++ b/mw/template.d.ts
@@ -53,39 +53,6 @@ declare global {
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html
          */
         namespace template {
-            /**
-             * Register a new compiler.
-             *
-             * A compiler is any object that implements a {@link mw.template.compile} method. The compile() method must
-             * return a Template interface with a method {@link TemplateRenderer.render render()} that returns HTML.
-             *
-             * The compiler name must correspond with the name suffix of templates that use this compiler.
-             *
-             * @param {string} name Compiler name
-             * @param {TemplateCompiler} compiler
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.registerCompiler
-             */
-            function registerCompiler(name: string, compiler: TemplateCompiler): void;
-
-            /**
-             * Get the name of the associated compiler based on a template name.
-             *
-             * @param {string} templateName Name of a template (including suffix)
-             * @returns {string} Name of a compiler
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompilerName
-             */
-            function getCompilerName(templateName: string): string;
-
-            /**
-             * Get a compiler via its name.
-             *
-             * @param {string} name Name of a compiler
-             * @returns {TemplateCompiler} The compiler
-             * @throws {Error} when unknown compiler provided
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompiler
-             */
-            function getCompiler(name: string): TemplateCompiler;
-
             /**
              * Register a template associated with a module.
              *
@@ -103,6 +70,17 @@ declare global {
                 templateBody: string
             ): TemplateRenderer;
 
+            /**
+             * Compile a string of template markup with an engine of choice.
+             *
+             * @param {string} templateBody Template body
+             * @param {string} compilerName The name of a registered compiler.
+             * @returns {TemplateRenderer} Compiled template
+             * @throws {Error} when unknown compiler name provided.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.compile
+             */
+            function compile(templateBody: string, compilerName: string): TemplateRenderer;
+
             /**
              * Get a compiled template by module and template name.
              *
@@ -114,15 +92,37 @@ declare global {
             function get(moduleName: string, templateName: string): TemplateRenderer;
 
             /**
-             * Compile a string of template markup with an engine of choice.
+             * Get a compiler via its name.
              *
-             * @param {string} templateBody Template body
-             * @param {string} compilerName The name of a registered compiler.
-             * @returns {TemplateRenderer} Compiled template
-             * @throws {Error} when unknown compiler name provided.
-             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.compile
+             * @param {string} name Name of a compiler
+             * @returns {TemplateCompiler} The compiler
+             * @throws {Error} when unknown compiler provided
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompiler
              */
-            function compile(templateBody: string, compilerName: string): TemplateRenderer;
+            function getCompiler(name: string): TemplateCompiler;
+
+            /**
+             * Get the name of the associated compiler based on a template name.
+             *
+             * @param {string} templateName Name of a template (including suffix)
+             * @returns {string} Name of a compiler
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.getCompilerName
+             */
+            function getCompilerName(templateName: string): string;
+
+            /**
+             * Register a new compiler.
+             *
+             * A compiler is any object that implements a {@link mw.template.compile} method. The compile() method must
+             * return a Template interface with a method {@link TemplateRenderer.render render()} that returns HTML.
+             *
+             * The compiler name must correspond with the name suffix of templates that use this compiler.
+             *
+             * @param {string} name Compiler name
+             * @param {TemplateCompiler} compiler
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html#.registerCompiler
+             */
+            function registerCompiler(name: string, compiler: TemplateCompiler): void;
         }
     }
 }

From 61ae74e18bb4cfd7225c1c4da380b380f922ca18 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Fri, 26 Apr 2024 12:25:07 +0200
Subject: [PATCH 09/15] Fixes mistakes from previous commits

---
 mw/Title.d.ts | 4 ++--
 mw/Uri.d.ts   | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/mw/Title.d.ts b/mw/Title.d.ts
index 483101e..b21cc04 100644
--- a/mw/Title.d.ts
+++ b/mw/Title.d.ts
@@ -129,10 +129,10 @@ declare global {
             /**
              * Get the page name as if it is a file name, without extension or namespace prefix,
              * in the canonical form with underscores instead of spaces. For example, the title
-             * `File:Example_image.svg` will be returned as `Example image`.
+             * `File:Example_image.svg` will be returned as `Example_image`.
              *
              * Note that this method will work for non-file titles but probably give nonsensical results.
-             * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMain} instead.
+             * A title like `User:Dr._J._Fail` will be returned as `Dr._J`! Use {@link getMain} instead.
              *
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFileNameWithoutExtension
diff --git a/mw/Uri.d.ts b/mw/Uri.d.ts
index 9b9d720..2ba8b67 100644
--- a/mw/Uri.d.ts
+++ b/mw/Uri.d.ts
@@ -288,18 +288,18 @@ declare global {
                  * Currently this does not handle associative or multi-dimensional arrays, but that may be improved in the future.
                  * Implies `overrideKeys: true` (query parameters without `[...]` are not parsed as arrays). Defaults to false.
                  */
-                arrayParams: boolean;
+                arrayParams?: boolean;
 
                 /**
                  * Whether to let duplicate query parameters override each other (`true`) or automagically convert them to an array (`false`).
                  * Defaults to false.
                  */
-                overrideKeys: boolean;
+                overrideKeys?: boolean;
 
                 /**
                  * Trigger strict mode parsing of the url. Defaults to false.
                  */
-                strictMode: boolean;
+                strictMode?: boolean;
             }
         }
     }

From 8e15551a78549ae1813eac930124f66ff41475f7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Tue, 30 Apr 2024 14:18:08 +0200
Subject: [PATCH 10/15] Cleanup - fix remaining `NotificationOptions` issues -
 move remaining Options objects to their own interfaces, so descriptions in
 some code editors (like VSC) only show relenvant information about the the
 object itself, not all of its methods and properties. This includes
 `JQuery.textSelection`, `mw.requestIdleCallback`, and
 `mw.Title.newFromUserInput` options. - synchronize `TableSorterOptions` with
 online doc: change its name and make all its properties optional - remove
 redundant jsdoc in `mw.experiments` and empty `@see` annotation in `mw.hook`
 - fix some jsdoc link, indent & type inconsistencies

---
 jquery/spinner.d.ts             |  6 +--
 jquery/tablesorter.d.ts         | 38 +++++++++---------
 jquery/textSelection.d.ts       | 71 ++++++++++++++++++++++-----------
 mw/Api.d.ts                     |  6 +--
 mw/Rest.d.ts                    |  8 ++--
 mw/Title.d.ts                   | 22 ++++++----
 mw/Upload.d.ts                  |  2 +-
 mw/Uri.d.ts                     |  2 +-
 mw/config.d.ts                  |  6 +--
 mw/errorLogger.d.ts             |  4 +-
 mw/experiments.d.ts             |  6 ---
 mw/hook.d.ts                    | 45 ++++++++++-----------
 mw/index.d.ts                   | 16 +++++---
 mw/loader.d.ts                  | 30 ++++++++------
 mw/notification.d.ts            |  8 ++--
 mw/pluralRuleParser.d.ts        |  2 +-
 mw/template.d.ts                | 10 ++---
 mw/user.d.ts                    | 12 +++---
 mw/util.d.ts                    | 12 +++---
 scripts/config-types-scraper.js |  2 +-
 20 files changed, 171 insertions(+), 137 deletions(-)

diff --git a/jquery/spinner.d.ts b/jquery/spinner.d.ts
index d129909..41cce1e 100644
--- a/jquery/spinner.d.ts
+++ b/jquery/spinner.d.ts
@@ -6,7 +6,7 @@ declare global {
          * The argument is an object with options used to construct the spinner (see below).
          *
          * It is a good practice to keep a reference to the created spinner to be able to remove it
-         * later. Alternatively, one can use the 'id' option and #removeSpinner (but make sure to choose
+         * later. Alternatively, one can use the 'id' option and {@link removeSpinner} (but make sure to choose
          * an id that's unlikely to cause conflicts, e.g. with extensions, gadgets or user scripts).
          *
          * CSS classes used:
@@ -34,7 +34,7 @@ declare global {
          *
          * @ignore
          * @param {string|Options} [opts] Options. If a string is given, it will be treated as the value
-         *   of the `id` option.
+         *  of the `id` option.
          * @returns {JQuery}
          */
         createSpinner(opts?: string | Options): JQuery;
@@ -58,7 +58,7 @@ declare global {
          * Collection contents remain unchanged.
          *
          * @param {string|Options} [opts] Options. If a string is given, it will be treated as the value
-         *   of the `id` option.
+         *  of the `id` option.
          * @returns {JQuery}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.injectSpinner
          */
diff --git a/jquery/tablesorter.d.ts b/jquery/tablesorter.d.ts
index f35572b..f8262dc 100644
--- a/jquery/tablesorter.d.ts
+++ b/jquery/tablesorter.d.ts
@@ -16,11 +16,11 @@ declare global {
          * $( 'table' ).tablesorter( { sortList: [ { 0: 'desc' }, { 1: 'asc' } ] } );
          * ```
          *
-         * @param {Partial<Options>} settings
+         * @param {TableSorterOptions} settings
          * @returns {JQuery}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.tablesorter
          */
-        tablesorter(this: JQuery<HTMLTableElement>, settings?: Partial<Options>): this;
+        tablesorter(this: JQuery<HTMLTableElement>, settings?: TableSorterOptions): this;
     }
 }
 
@@ -57,14 +57,14 @@ interface Parser<T = unknown, K extends string = string> {
 
 interface TableSorter {
     dateRegex: [];
-    defaultOptions: Options;
+    defaultOptions: Required<TableSorterOptions>;
     monthNames: {};
 
     addParser<T = unknown>(parser: Parser<T>): void;
 
     clearTableBody(table: HTMLTableElement): void;
 
-    construct<T extends JQuery<HTMLTableElement>>($tables: T, settings?: Partial<Options>): T;
+    construct<T extends JQuery<HTMLTableElement>>($tables: T, settings?: TableSorterOptions): T;
 
     formatDigit(s: string): number;
 
@@ -81,47 +81,47 @@ interface TableSorter {
 /**
  * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#~TableSorterOptions
  */
-interface Options {
+interface TableSorterOptions {
     /**
      * Boolean flag indicating iftablesorter should cancel
      * selection of the table headers text.
      * Defaults to true.
      */
-    cancelSelection: boolean;
+    cancelSelection?: boolean;
 
-    columns: number;
+    columns?: number;
 
-    columnToHeader: number[];
+    columnToHeader?: number[];
     /**
      * A string of the class name to be appended to
      * sortable tr elements in the thead on a ascending sort.
      * Defaults to 'headerSortUp'.
      */
-    cssAsc: string;
+    cssAsc?: string;
 
-    cssChildRow: string;
+    cssChildRow?: string;
 
     /**
      * A string of the class name to be appended to
      * sortable tr elements in the thead on a descending sort.
      * Defaults to 'headerSortDown'.
      */
-    cssDesc: string;
+    cssDesc?: string;
 
     /**
      * A string of the class name to be appended to sortable
      * tr elements in the thead of the table.
      * Defaults to 'headerSort'.
      */
-    cssHeader: string;
+    cssHeader?: string;
 
-    cssInitial: string;
+    cssInitial?: string;
 
-    headerList: HTMLTableCellElement[];
+    headerList?: HTMLTableCellElement[];
 
-    headerToColumns: number[][];
+    headerToColumns?: number[][];
 
-    parsers: Parser[];
+    parsers?: Parser[];
 
     /**
      * An array containing objects specifying sorting. By passing more
@@ -131,15 +131,15 @@ interface Options {
      * { <Integer column index>: <String 'asc' or 'desc'> }
      * ```
      */
-    sortList: Array<[number, number]>;
+    sortList?: Array<[number, number]>;
 
     /**
      * A string of the multi-column sort key.
      * Defaults to 'shiftKey'.
      */
-    sortMultiSortKey: MultiSortKey;
+    sortMultiSortKey?: MultiSortKey;
 
-    unsortableClass: string;
+    unsortableClass?: string;
 }
 
 export {};
diff --git a/jquery/textSelection.d.ts b/jquery/textSelection.d.ts
index 629a665..0859497 100644
--- a/jquery/textSelection.d.ts
+++ b/jquery/textSelection.d.ts
@@ -50,13 +50,13 @@ declare global {
          * Also focusses the textarea.
          *
          * @param {string} command Command to execute
-         * @param {Partial<TextSelectionEncapsulateOptions>} [options]
+         * @param {TextSelectionEncapsulateOptions} [options]
          * @returns {JQuery}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(
             command: "encapsulateSelection",
-            options?: Partial<TextSelectionEncapsulateOptions>
+            options?: TextSelectionEncapsulateOptions
         ): this;
 
         /**
@@ -64,19 +64,21 @@ declare global {
          * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
-         * @param {Object} [options]
-         * @param {boolean} [options.startAndEnd=false] Return range of the selection rather than just start
+         * @param {GetCaretPositionOptions} [options]
          * @returns {number|number[]} Array with two numbers, for start and end of selection
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
         textSelection(
             command: "getCaretPosition",
-            options: { startAndEnd: true }
+            options: GetCaretPositionOptions & { startAndEnd: true }
         ): [number, number];
-        textSelection(command: "getCaretPosition", options?: { startAndEnd?: false }): number;
         textSelection(
             command: "getCaretPosition",
-            options?: { startAndEnd: boolean }
+            options?: GetCaretPositionOptions & { startAndEnd?: false }
+        ): number;
+        textSelection(
+            command: "getCaretPosition",
+            options?: GetCaretPositionOptions
         ): number | [number, number];
 
         /**
@@ -84,13 +86,11 @@ declare global {
          * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
-         * @param {Object} options
-         * @param {number} options.start
-         * @param {number} [options.end=options.start]
+         * @param {SetSelectionOptions} options
          * @returns {JQuery}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
-        textSelection(command: "setSelection", options: { start: number; end?: number }): this;
+        textSelection(command: "setSelection", options: SetSelectionOptions): this;
 
         /**
          * Scroll a textarea to the current cursor position. You can set the cursor
@@ -98,13 +98,14 @@ declare global {
          * Provided by the `jquery.textSelection` ResourceLoader module.
          *
          * @param {string} command Command to execute
-         * @param {Object} [options]
-         * @param {boolean} [options.force=false] Whether to force a scroll even if the caret position
-         *  is already visible.
+         * @param {ScrollToCaretPositionOptions} [options]
          * @returns {JQuery}
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.textSelection
          */
-        textSelection(command: "scrollToCaretPosition", options: { force?: boolean }): this;
+        textSelection(
+            command: "scrollToCaretPosition",
+            options?: ScrollToCaretPositionOptions
+        ): this;
 
         /**
          * Register an alternative textSelection API for this element.
@@ -153,39 +154,61 @@ interface TextSelectionEncapsulateOptions {
     /**
      * Text to insert before the cursor/selection.
      */
-    pre: string;
+    pre?: string;
     /**
      * Text to insert between pre and post and select afterwards.
      */
-    peri: string;
+    peri?: string;
     /**
      * Text to insert after the cursor/selection.
      */
-    post: string;
+    post?: string;
     /**
      * Put the inserted text on a line of its own. Defaults to false.
      */
-    ownline: boolean;
+    ownline?: boolean;
     /**
      * If there is a selection, replace it with peri instead of leaving it alone. Defaults to false.
      */
-    replace: boolean;
+    replace?: boolean;
     /**
      * Select the peri text if it was inserted (but not if there was a selection and replace==false, or if splitlines==true). Defaults to true.
      */
-    selectPeri: boolean;
+    selectPeri?: boolean;
     /**
      * If multiple lines are selected, encapsulate each line individually. Defaults to false.
      */
-    splitlines: boolean;
+    splitlines?: boolean;
     /**
      * Position to start selection at.
      */
-    selectionStart: number;
+    selectionStart?: number;
     /**
      * Position to end selection at. Defaults to the position to start setection at.
      */
-    selectionEnd: number;
+    selectionEnd?: number;
+}
+
+interface GetCaretPositionOptions {
+    /**
+     * Return range of the selection rather than just start. Defaults to false.
+     */
+    startAndEnd?: boolean;
+}
+
+interface SetSelectionOptions {
+    /**
+     * Defaults to start.
+     */
+    end?: number;
+    start: number;
+}
+
+interface ScrollToCaretPositionOptions {
+    /**
+     * Whether to force a scroll even if the caret position is already visible. Defaults to false.
+     */
+    force?: boolean;
 }
 
 export {};
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index e87887d..134cd10 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -529,7 +529,7 @@ declare global {
              *
              * @param {TitleLike} content Content to parse, either as a wikitext string or a {@link mw.Title}
              * @param {ApiParseParams} [additionalParams] Parameters object to set custom settings, e.g.
-             *   `redirects`, `sectionpreview`. `prop` should not be overridden.
+             *  `redirects`, `sectionpreview`. `prop` should not be overridden.
              * @returns {JQuery.Promise<string>} Promise that resolves with the parsed HTML of `wikitext`
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Api.html#parse
              */
@@ -749,8 +749,8 @@ declare global {
              */
             interface EditTransform {
                 /**
-                 * @param {Object} revision Current revision
-                 * @returns {string|ApiEditPageParams|JQuery.Promise<string>|JQuery.Promise<ApiEditPageParams>} New content, object with edit API parameters, or promise providing one of those.
+                 * @param {Revision} revision Current revision
+                 * @returns {string|ApiEditPageParams|JQuery.Promise<string|ApiEditPageParams>} New content, object with edit API parameters, or promise providing one of those.
                  */
                 (revision: Revision):
                     | string
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index b76a7cf..e5b15be 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -20,10 +20,10 @@ declare global {
              * } );
              *
              * api.post( '/v1/page/Main_Page', {
-             *      token: 'anon_token',
-             *      source: 'Lörem Ipsüm',
-             *      comment: 'tästing',
-             *      title: 'My_Page'
+             *     token: 'anon_token',
+             *     source: 'Lörem Ipsüm',
+             *     comment: 'tästing',
+             *     title: 'My_Page'
              * }, {
              *     'authorization': 'token'
              * } )
diff --git a/mw/Title.d.ts b/mw/Title.d.ts
index b21cc04..6db48fc 100644
--- a/mw/Title.d.ts
+++ b/mw/Title.d.ts
@@ -33,6 +33,16 @@ interface TitleExistenceStore {
     set(titles: string | string[], state?: boolean): boolean;
 }
 
+interface UserInputOptions {
+    /**
+     * Makes sure that a file is uploadable under the title returned.
+     * There are pages in the file namespace under which file upload is impossible.
+     * Automatically assumed if the title is created in the Media namespace.
+     * Defaults to true.
+     */
+    forUploading?: boolean;
+}
+
 declare global {
     namespace mw {
         /**
@@ -178,7 +188,7 @@ declare global {
              * @deprecated since 1.40, use {@link getFileNameWithoutExtension} instead
              * @returns {string} File name without file extension, in the canonical form with underscores
              *  instead of spaces. For example, the title `File:Example_image.svg` will be returned as
-             *  "Example_image".
+             *  `Example_image`.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getName
              */
             getName(): string;
@@ -344,7 +354,7 @@ declare global {
              * Returns null on fatal errors.
              *
              * @param {string} uncleanName The unclean file name including file extension but
-             *   without namespace
+             *  without namespace
              * @returns {Title|null} A valid Title object or null if the title is invalid
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromFileName
              */
@@ -384,18 +394,14 @@ declare global {
              * @param {string} title
              * @param {number} [defaultNamespace=NS_MAIN]
              *  If given, will used as default namespace for the given title.
-             * @param {Object} [options] additional options
-             * @param {boolean} [options.forUploading=true]
-             *  Makes sure that a file is uploadable under the title returned.
-             *  There are pages in the file namespace under which file upload is impossible.
-             *  Automatically assumed if the title is created in the Media namespace.
+             * @param {UserInputOptions} [options] additional options
              * @returns {Title|null} A valid Title object or null if the input cannot be turned into a valid title
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#.newFromUserInput
              */
             static newFromUserInput(
                 title: string,
                 defaultNamespace?: number,
-                options?: { forUploading?: boolean }
+                options?: UserInputOptions
             ): Title | null;
 
             /**
diff --git a/mw/Upload.d.ts b/mw/Upload.d.ts
index 6a33407..589f97a 100644
--- a/mw/Upload.d.ts
+++ b/mw/Upload.d.ts
@@ -299,7 +299,7 @@ declare global {
                 UPLOADING,
 
                 /**
-                 * Upload finished, but not published, call #finishStashUpload.
+                 * Upload finished, but not published, call {@link Upload.finishStashUpload finishStashUpload}.
                  */
                 STASHED,
 
diff --git a/mw/Uri.d.ts b/mw/Uri.d.ts
index 2ba8b67..d9ab9d7 100644
--- a/mw/Uri.d.ts
+++ b/mw/Uri.d.ts
@@ -149,7 +149,7 @@ declare global {
             /**
              * Create and manipulate MediaWiki URIs.
              *
-             * @param {Object|string} [uri] URI string, or an Object with appropriate properties (especially
+             * @param {string|Uri|Object.<string,string>} [uri] URI string, or an Object with appropriate properties (especially
              *  another URI object to clone). Object must have non-blank `protocol`, `host`, and `path`
              *  properties. If omitted (or set to `undefined`, `null` or empty string), then an object
              *  will be created for the default `uri` of this constructor (`location.href` for mw.Uri,
diff --git a/mw/config.d.ts b/mw/config.d.ts
index 3f2fd6a..ffbcb27 100644
--- a/mw/config.d.ts
+++ b/mw/config.d.ts
@@ -138,7 +138,7 @@ declare global {
              */
             wgWikiID: string;
             /**
-             * The action performed, e.g. "edit" for edit pages, or "view" for page views. See Manual:Parameters to index.php#Actions.
+             * The action performed, e.g. "edit" for edit pages, or "view" for page views. See {@link https://www.mediawiki.org/wiki/Manual:Parameters_to_index.php#Actions Manual:Parameters to index.php}.
              *
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgAction
              */
@@ -188,7 +188,7 @@ declare global {
              */
             wgIsProbablyEditable: boolean;
             /**
-             * true if the page is a redirect to a wiki page using #REDIRECT [[Target page name]]. It is false for anything else (normal pages, special pages, most generated pages, etc.).
+             * true if the page is a redirect to a wiki page using `#REDIRECT [[Target page name]]`. It is false for anything else (normal pages, special pages, most generated pages, etc.).
              *
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgIsRedirect
              */
@@ -200,7 +200,7 @@ declare global {
              */
             wgNamespaceNumber: number;
             /**
-             * Language code of the page content language (according to $context->getTitle()->getPageLanguage())
+             * Language code of the page content language (according to `$context->getTitle()->getPageLanguage()`)
              *
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgPageContentLanguage
              */
diff --git a/mw/errorLogger.d.ts b/mw/errorLogger.d.ts
index 677c046..235c0b9 100644
--- a/mw/errorLogger.d.ts
+++ b/mw/errorLogger.d.ts
@@ -12,8 +12,8 @@ declare global {
              *
              * @param {Error} error
              * @param {string} [topic='error.caught'] Error topic. Conventionally in the form
-             *   'error.%component%' (where %component% identifies the code logging the error at a
-             *   high level; e.g. an extension name).
+             *  'error.%component%' (where %component% identifies the code logging the error at a
+             *  high level; e.g. an extension name).
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.errorLogger.html#.logError
              */
             function logError(error: Error, topic?: `error.${string}`): void;
diff --git a/mw/experiments.d.ts b/mw/experiments.d.ts
index d52469e..7e1e443 100644
--- a/mw/experiments.d.ts
+++ b/mw/experiments.d.ts
@@ -44,12 +44,6 @@ declare global {
              * }
              * ```
              * @param {Experiment} experiment
-             * @param {string} experiment.name The name of the experiment
-             * @param {boolean} experiment.enabled Whether or not the experiment is
-             *  enabled. If the experiment is disabled, then the user is always assigned
-             *  to the control bucket
-             * @param {Object.<string, number>} experiment.buckets A map of bucket name to probability
-             *  that the user will be assigned to that bucket
              * @param {string} token A token that uniquely identifies the user for the
              *  duration of the experiment
              * @returns {string|undefined} The bucket
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
index f15847a..b4e0d54 100644
--- a/mw/hook.d.ts
+++ b/mw/hook.d.ts
@@ -103,9 +103,8 @@ interface EditRecovery {
 declare global {
     namespace mw {
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
-         * @see
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(
@@ -121,7 +120,7 @@ declare global {
         >;
 
         /**
-         * Create an instance of mw.hook, fired after EditRecovery has loaded any recovery data, added event handlers, etc.
+         * Create an instance of {@link Hook}, fired after EditRecovery has loaded any recovery data, added event handlers, etc.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'editRecovery.loadEnd'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -129,7 +128,7 @@ declare global {
         function hook(name: "editRecovery.loadEnd"): Hook<[editRecovery: EditRecovery]>;
 
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'htmlform.enhance'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -137,7 +136,7 @@ declare global {
         function hook(name: "htmlform.enhance"): Hook<[$root: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired after an edit was successfully saved.
+         * Create an instance of {@link Hook}, fired after an edit was successfully saved.
          *
          * Does not fire for null edits.
          *
@@ -146,8 +145,8 @@ declare global {
          * @example
          * ```js
          * mw.config.set( {
-         *    wgCurRevisionId: data.newrevid,
-         *    wgRevisionId: data.newrevid
+         *     wgCurRevisionId: data.newrevid,
+         *     wgRevisionId: data.newrevid
          * } );
          * // Now fire the hook.
          * mw.hook( 'postEdit' ).fire();
@@ -158,7 +157,7 @@ declare global {
         function hook(name: "postEdit"): Hook<[data?: PostEditData]>;
 
         /**
-         * Create an instance of mw.hook, fired after the listener for #postEdit removes the notification.
+         * Create an instance of {@link Hook}, fired after the listener for #postEdit removes the notification.
          *
          * @deprecated
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'postEdit.afterRemoval'
@@ -167,14 +166,14 @@ declare global {
         function hook(name: "postEdit.afterRemoval"): Hook<[]>;
 
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
          */
         function hook(name: "prefs.search.buildIndex"): Hook<[index: SearchIndex]>;
 
         /**
-         * Create an instance of mw.hook, fired when a trusted UI element to perform a logout has been activated.
+         * Create an instance of {@link Hook}, fired when a trusted UI element to perform a logout has been activated.
          *
          * This will end the user session, and either redirect to the given URL on success, or queue an error message via mw.notification.
          *
@@ -184,7 +183,7 @@ declare global {
         function hook(name: "skin.logout"): Hook<[href: string]>;
 
         /**
-         * Create an instance of mw.hook, fired when initialization of the filtering interface for changes list is complete.
+         * Create an instance of {@link Hook}, fired when initialization of the filtering interface for changes list is complete.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'structuredChangeFilters.ui.initialized'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -192,7 +191,7 @@ declare global {
         function hook(name: "structuredChangeFilters.ui.initialized"): Hook<[]>;
 
         /**
-         * Create an instance of mw.hook, fired when a portlet is successfully created.
+         * Create an instance of {@link Hook}, fired when a portlet is successfully created.
          *
          * @example
          * ```js
@@ -208,7 +207,7 @@ declare global {
         ): Hook<[portlet: HTMLElement, before: string | undefined]>;
 
         /**
-         * Create an instance of mw.hook, fired when a portlet link is successfully created.
+         * Create an instance of {@link Hook}, fired when a portlet link is successfully created.
          *
          * @example
          * ```js
@@ -223,7 +222,7 @@ declare global {
         function hook(name: "util.addPortletLink"): Hook<[item: HTMLLIElement, data: object]>;
 
         /**
-         * Create an instance of mw.hook, fired when categories are being added to the DOM.
+         * Create an instance of {@link Hook}, fired when categories are being added to the DOM.
          *
          * It is encouraged to fire it before the main DOM is changed (when $content is still detached).  However, this order is not defined either way, so you should only rely on $content itself.
          *
@@ -235,7 +234,7 @@ declare global {
         function hook(name: "wikipage.categories"): Hook<[$content: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired after collapsible content has been initialized.
+         * Create an instance of {@link Hook}, fired after collapsible content has been initialized.
          *
          * This gives an option to modify the collapsible behavior.
          *
@@ -245,7 +244,7 @@ declare global {
         function hook(name: "wikipage.collapsibleContent"): Hook<[$collapsible: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when wiki content has been added to the DOM.
+         * Create an instance of {@link Hook}, fired when wiki content has been added to the DOM.
          *
          * This should only be fired after $content has been attached.
          *
@@ -257,7 +256,7 @@ declare global {
         function hook(name: "wikipage.content"): Hook<[$content: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when a diff is added to a page or dynamically displayed to the user.
+         * Create an instance of {@link Hook}, fired when a diff is added to a page or dynamically displayed to the user.
          *
          * Similar to the wikipage.content hook, `$diff` may still be detached when the hook is fired.
          *
@@ -267,7 +266,7 @@ declare global {
         function hook(name: "wikipage.diff"): Hook<[$table: JQuery<HTMLTableElement>]>;
 
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.diff.diffTypeSwitch'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -277,7 +276,7 @@ declare global {
         ): Hook<[inlineToggleSwitch: OO.ui.ToggleSwitchWidget]>;
 
         /**
-         * Create an instance of mw.hook.
+         * Create an instance of {@link Hook}.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.diff.wikitextDiffBody'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -285,7 +284,7 @@ declare global {
         function hook(name: "wikipage.diff.wikitextBodyUpdate"): Hook<[$wikitextDiffBody: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when the editform is added to the edit page.
+         * Create an instance of {@link Hook}, fired when the editform is added to the edit page.
          *
          * Similar to the wikipage.content hoo $editForm can still be detached when this hook is fired.
          *
@@ -295,7 +294,7 @@ declare global {
         function hook(name: "wikipage.editform"): Hook<[$editForm: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when a page's
+         * Create an instance of {@link Hook}, fired when a page's
          * {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Page_status_indicators status indicators}
          * are being added to the DOM or updated.
          *
@@ -305,7 +304,7 @@ declare global {
         function hook(name: "wikipage.indicators"): Hook<[$indicators: JQuery]>;
 
         /**
-         * Create an instance of mw.hook, fired when dynamic changes have been made to the table of contents.
+         * Create an instance of {@link Hook}, fired when dynamic changes have been made to the table of contents.
          *
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/Hooks.html#~event:'wikipage.tableOfContents'
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
@@ -313,7 +312,7 @@ declare global {
         function hook(name: "wikipage.tableOfContents"): Hook<[sections: any[]]>;
 
         /**
-         * Create an instance of mw.hook, fired when the page watch status has changed.
+         * Create an instance of {@link Hook}, fired when the page watch status has changed.
          *
          * @example
          * ```js
diff --git a/mw/index.d.ts b/mw/index.d.ts
index 39346d2..97c4ef2 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -32,6 +32,15 @@ import "./Uri";
 import "./user";
 import "./util";
 
+interface IdleCallbackOptions {
+    /**
+     * If set, the callback will be scheduled for
+     * immediate execution after this amount of time (in milliseconds) if it didn't run
+     * by that time.
+     */
+    timeout?: number;
+}
+
 type ObjectAnalyticEventData = Record<string, any>;
 type AnalyticEventData = ObjectAnalyticEventData | number | string | undefined;
 
@@ -150,15 +159,12 @@ declare global {
          * - {@link https://developers.google.com/web/updates/2015/08/using-requestidlecallback}
          *
          * @param {Function} callback
-         * @param {Object} [options]
-         * @param {number} [options.timeout] If set, the callback will be scheduled for
-         *  immediate execution after this amount of time (in milliseconds) if it didn't run
-         *  by that time.
+         * @param {IdleCallbackOptions} [options]
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.requestIdleCallback
          */
         function requestIdleCallback(
             callback: (...args: any[]) => any,
-            options?: { timeout?: number }
+            options?: IdleCallbackOptions
         ): void;
 
         /**
diff --git a/mw/loader.d.ts b/mw/loader.d.ts
index e9f0670..cf39a00 100644
--- a/mw/loader.d.ts
+++ b/mw/loader.d.ts
@@ -59,6 +59,12 @@ interface ModuleRegistryEntry {
     version: string;
 }
 
+interface JsonModuleStore {
+    asOf: number;
+    items: string;
+    vary: string;
+}
+
 export interface ResourceLoaderStoreStats {
     expired: number;
     failed: number;
@@ -138,12 +144,12 @@ declare global {
              *
              * - `registered`:
              *    The module is known to the system but not yet required.
-             *    Meta data is stored by mw.loader#register.
+             *    Meta data is stored by {@link mw.loader.register}.
              *    Calls to that method are generated server-side by StartupModule.
              * - `loading`:
              *    The module was required through mw.loader (either directly or as dependency of
              *    another module). The client will fetch module contents from mw.loader.store
-             *    or from the server. The contents should later be received by mw.loader#implement.
+             *    or from the server. The contents should later be received by {@link mw.loader.implement}.
              * - `loaded`:
              *    The module has been received by mw.loader#implement.
              *    Once the module has no more dependencies in-flight, the module will be executed,
@@ -180,7 +186,7 @@ declare global {
              *
              * @param {string|string[]} modules Either the name of a module, array of modules,
              *  or a URL of an external script or style
-             * @param {string} [type='text/javascript'] MIME type to use if calling with a URL of an
+             * @param {string} [type="text/javascript"] MIME type to use if calling with a URL of an
              *  external script or style; acceptable values are "text/css" and
              *  "text/javascript"; if no type is provided, text/javascript is assumed.
              * @throws {Error} If type is invalid
@@ -316,15 +322,15 @@ declare global {
              * Implement a module given a function which returns the components of the module
              *
              * @private
-             * @param {Function} declarator The declarator should return an array with the following keys:
+             * @param {ModuleDeclarator} declarator The declarator should return an array with the following keys:
              *
              * - 0. {string} module Name of module and current module version. Formatted
-             *   as '`[name]@[version]`". This version should match the requested version
+             *   as `[name]@[version]`. This version should match the requested version
              *   (from #batchRequest and #registry). This avoids race conditions (T117587).
              *
              * - 1. {ModuleScript} [script] Module code. This can be a function,
              *   a list of URLs to load via `<script src>`, a string for `globalEval()`, or an
-             *   object like {"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}.
+             *   object like `{"files": {"foo.js":function, "bar.js": function, ...}, "main": "foo.js"}`.
              *   If an object is provided, the main file will be executed immediately, and the other
              *   files will only be executed if loaded via require(). If a function or string is
              *   provided, it will be executed/evaluated immediately. If an array is provided, all
@@ -406,10 +412,10 @@ declare global {
              *  a list of arguments compatible with this method
              * @param {string|number} [version] Module version hash (falls backs to empty string)
              *  Can also be a number (timestamp) for compatibility with MediaWiki 1.25 and earlier.
-             * @param {string[]} [dependencies] Array of module names on which this module depends.
-             * @param {string} [group=null] Group which the module is in
-             * @param {string} [source='local'] Name of the source
-             * @param {string} [skip=null] Script body of the skip function
+             * @param {Array<string|number>} [dependencies] Array of module names on which this module depends.
+             * @param {string|null} [group=null] Group which the module is in
+             * @param {string} [source="local"] Name of the source
+             * @param {string|null} [skip=null] Script body of the skip function
              */
             function register(
                 modules: string,
@@ -532,9 +538,9 @@ declare global {
                 /**
                  * Construct a JSON-serializable object representing the content of the store.
                  *
-                 * @returns {Object} Module store contents.
+                 * @returns {JsonModuleStore} Module store contents.
                  */
-                function toJSON(): { items: string; vary: string; asOf: number };
+                function toJSON(): JsonModuleStore;
 
                 /**
                  * Whether the store is in use on this page.
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 3ff5d68..8eb53a0 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -12,7 +12,7 @@ interface Notification {
     autoHideSeconds: number;
     isOpen: boolean;
     isPaused: boolean;
-    options: Partial<NotificationOptions>;
+    options: mw.notification.NotificationOptions;
     timeout: {
         set: typeof setTimeout;
         clear: typeof clearTimeout;
@@ -59,14 +59,14 @@ declare global {
          * Convenience method for loading and accessing the {@link mw.notification.notify mw.notification module}.
          *
          * @param {HTMLElement|HTMLElement[]|JQuery|Message|string} message
-         * @param {Partial<notification.NotificationOptions>} [options] The options to use for the notification.
+         * @param {notification.NotificationOptions} [options] The options to use for the notification.
          *  See {@link notification.defaults the defaults}.
          * @returns {JQuery.Promise<Notification>} Notification object
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.notify
          */
         function notify(
             message: string | Message | JQuery | HTMLElement | HTMLElement[],
-            options?: Partial<notification.NotificationOptions>
+            options?: notification.NotificationOptions
         ): JQuery.Promise<Notification>;
 
         /**
@@ -101,7 +101,7 @@ declare global {
              *
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.defaults
              */
-            const defaults: NotificationOptions;
+            const defaults: Required<NotificationOptions>;
 
             /**
              * Display a notification message to the user.
diff --git a/mw/pluralRuleParser.d.ts b/mw/pluralRuleParser.d.ts
index e0f9896..24d68ec 100644
--- a/mw/pluralRuleParser.d.ts
+++ b/mw/pluralRuleParser.d.ts
@@ -4,7 +4,7 @@ declare global {
          * Evaluates a plural rule in CLDR syntax for a number.
          *
          * @param {string} rule
-         * @param {integer} number
+         * @param {number} number
          * @returns {boolean} true if evaluation passed, false if evaluation failed.
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.libs.pluralruleparser.html
          */
diff --git a/mw/template.d.ts b/mw/template.d.ts
index 8b2c3c3..c250393 100644
--- a/mw/template.d.ts
+++ b/mw/template.d.ts
@@ -43,11 +43,11 @@ declare global {
          *
          * // also returns $( '<div>hello world</div>' );
          * mw.loader.using( 'mediawiki.template.mustache' ).then( () => {
-         *   const $node = mw.template.compile( '<div>{{ >Foo }}</div>', 'mustache' ).render( {
-         *     text: 'Hello world'
-         *   }, {
-         *     Foo: mw.template.compile( '{{text}}', 'mustache' )
-         *   } );
+         *     const $node = mw.template.compile( '<div>{{ >Foo }}</div>', 'mustache' ).render( {
+         *         text: 'Hello world'
+         *     }, {
+         *         Foo: mw.template.compile( '{{text}}', 'mustache' )
+         *     } );
          * } );
          * ```
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.template.html
diff --git a/mw/user.d.ts b/mw/user.d.ts
index 1a4fdf6..574caea 100644
--- a/mw/user.d.ts
+++ b/mw/user.d.ts
@@ -33,7 +33,7 @@ export interface User {
          *
          * @param {string} feature
          * @returns {false|string} returns false if the feature is not recognized.
-         *   returns string if a feature was found.
+         *  returns string if a feature was found.
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html#.get
          */
         get(feature: string): false | string;
@@ -44,8 +44,8 @@ export interface User {
          * @param {string} feature
          * @param {string} value
          * @returns {boolean} True if feature was stored successfully, false if the value
-         *   uses a forbidden character or the feature is not recognised
-         *   e.g. a matching class was not defined on the HTML document element.
+         *  uses a forbidden character or the feature is not recognised
+         *  e.g. a matching class was not defined on the HTML document element.
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html#.set
          */
         set(feature: string, value: string): boolean;
@@ -76,7 +76,7 @@ export interface User {
      * created yet, and the name is not visible to other users.
      *
      * @returns {JQuery.Promise<string>} Promise resolved with the username if we succeeded,
-     *   or resolved with `null` if we failed
+     *  or resolved with `null` if we failed
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.acquireTempUserName
      */
     acquireTempUserName(): JQuery.Promise<string>;
@@ -119,7 +119,7 @@ export interface User {
     /**
      * Get the current user's groups.
      *
-     * @param {Function} [callback]
+     * @param {function(string[]):any} [callback]
      * @returns {JQuery.Promise<string[]>}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getGroups
      */
@@ -166,7 +166,7 @@ export interface User {
     /**
      * Get the current user's rights.
      *
-     * @param {Function} [callback]
+     * @param {function(string[]):any} [callback]
      * @returns {JQuery.Promise<string[]>}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.getRights
      */
diff --git a/mw/util.d.ts b/mw/util.d.ts
index 41f5c80..c672468 100644
--- a/mw/util.d.ts
+++ b/mw/util.d.ts
@@ -25,10 +25,10 @@ interface ResizeableThumbnailUrl {
 
     /**
      * @param w Width, which must be smaller than the width of the original image (or equal to it; that
-     *   only works if `MediaHandler::mustRender` returns true for the file). Null when the
-     *   file in the original URL is not a thumbnail.
-     *   On wikis with `$wgGenerateThumbnailOnParse` set to true, this will fall back to using
-     *   `Special:Redirect` which is less efficient. Otherwise, it is a direct thumbnail URL.
+     *  only works if `MediaHandler::mustRender` returns true for the file). Null when the
+     *  file in the original URL is not a thumbnail.
+     *  On wikis with `$wgGenerateThumbnailOnParse` set to true, this will fall back to using
+     *  `Special:Redirect` which is less efficient. Otherwise, it is a direct thumbnail URL.
      * @returns A thumbnail URL (URL-encoded) with that width.
      */
     resizeUrl: (w: number) => string | null;
@@ -159,7 +159,7 @@ declare global {
              *
              * ```js
              * $.when( mw.loader.using( [ 'mediawiki.util' ] ), $.ready ).then( function () {
-             *      mw.util.addPortletLink( 'p-tb', 'https://www.mediawiki.org/', 'mediawiki.org' );
+             *     mw.util.addPortletLink( 'p-tb', 'https://www.mediawiki.org/', 'mediawiki.org' );
              * } );
              * ```
              *
@@ -330,7 +330,7 @@ declare global {
             /**
              * Get the URL to a given local wiki page name.
              *
-             * @param {string|null} [pageName=wgPageName] Page name
+             * @param {string|null} [pageName="wgPageName"] Page name
              * @param {QueryParams} [params] A mapping of query parameter names to values,
              *  e.g. `{ action: 'edit' }`
              * @returns {string} URL, relative to `wgServer`.
diff --git a/scripts/config-types-scraper.js b/scripts/config-types-scraper.js
index 6d1390f..1d7d2f0 100644
--- a/scripts/config-types-scraper.js
+++ b/scripts/config-types-scraper.js
@@ -42,7 +42,7 @@ function formatEntry(name, data) {
         "/**",
         ...data.description.split("\n").map((e) => ` * ${e.trim()}`),
         " *",
-        ` * @see https://www.mediawiki.org/wiki/Manual:Interface/JavaScript#${name}`,
+        ` * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#${name}`,
         " */",
         `${name}${data.optional ? "?" : ""}: ${data.type};`,
     ];

From 83ced94c06a203b58aaf3fa3da558857852eb544 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Mon, 27 May 2024 12:53:49 +0200
Subject: [PATCH 11/15] Fix `confirmable` options & update some URLs - fix
 `$().confirmable` not allowing omitting some option properties - update some
 jQuery plugin URLs, changed since 1.42 release

---
 jquery/confirmable.d.ts             | 33 +++++++++++++++++------------
 jquery/cookie.d.ts                  |  4 ++--
 jquery/highlightText.d.ts           |  2 +-
 jquery/lengthLimit.d.ts             |  6 +++---
 jquery/makeCollapsible.d.ts         |  2 +-
 jquery/spinner.d.ts                 |  5 +++++
 jquery/updateTooltipAccessKeys.d.ts |  2 +-
 7 files changed, 33 insertions(+), 21 deletions(-)

diff --git a/jquery/confirmable.d.ts b/jquery/confirmable.d.ts
index 3c35d19..7a30e81 100644
--- a/jquery/confirmable.d.ts
+++ b/jquery/confirmable.d.ts
@@ -21,58 +21,65 @@ declare global {
          *     $( 'button' ).confirmable();
          * } );
          * ```
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.confirmable
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.confirmable.html#.$.fn.confirmable
          */
         confirmable: Confirmable;
     }
 }
 
+// make all properties required, replacing optional values with undefined
+type RequiredOrUndefined<T> = {
+    [P in keyof Required<T>]: undefined extends T[P] ? T[P] | undefined : T[P];
+};
+
 interface Confirmable {
     /**
-     * @param {Partial<Options>} [options]
+     * @param {Options} [options]
      */
-    (options?: Partial<Options>): this;
+    (options?: Options): this;
 
     /**
      * Default options. Overridable primarily for internationalisation handling.
      */
-    defaultOptions: Options;
+    defaultOptions: RequiredOptions;
 
-    handler(event: JQuery.Event, options: Options): void;
+    handler(event: JQuery.Event, options: RequiredOptions): void;
 }
 
+type RequiredOptions = Required<Options> & { i18n: RequiredOrUndefined<I18N> };
+
 interface Options {
     /**
      * Optional selector used for jQuery event delegation.
      */
-    delegate: string | null;
+    delegate?: string | null;
 
     /**
      * Events to hook to.
      */
-    events: string;
+    events?: string;
 
     /**
      * Text to use for interface elements.
      */
-    i18n: I18N;
+    i18n?: I18N;
 
     /**
      * Callback to fire when preparing confirmable buttons. It is fired separately for the 'Yes' and 'No' button.
      * Receives the button jQuery object as the first parameter and 'yes' or 'no' as the second.
      */
-    buttonCallback($button: JQuery): JQuery;
+    buttonCallback?($button: JQuery): JQuery;
 
     /**
      * Callback to fire when the action is confirmed (user clicks the 'Yes' button).
      */
-    handler: ((event: JQuery.Event) => void) | null;
+    handler?: ((event: JQuery.Event) => void) | null;
 
     /**
      * Callback to fire when preparing confirmable interface.
      * Receives the interface jQuery object as the only parameter.
      */
-    wrapperCallback($interface: JQuery): JQuery;
+    wrapperCallback?($interface: JQuery): JQuery;
 }
 
 // tslint:disable-next-line:interface-name
@@ -92,7 +99,7 @@ interface I18N {
     /**
      * Optional title text to use for the 'No' button.
      */
-    noTitle: string | undefined;
+    noTitle?: string;
 
     /**
      * Word separator to place between the three text messages.
@@ -109,7 +116,7 @@ interface I18N {
     /**
      * Optional title text to use for the 'Yes' button.
      */
-    yesTitle: string | undefined;
+    yesTitle?: string;
 }
 
 export {};
diff --git a/jquery/cookie.d.ts b/jquery/cookie.d.ts
index 81b15d2..6c0d3f9 100644
--- a/jquery/cookie.d.ts
+++ b/jquery/cookie.d.ts
@@ -16,7 +16,7 @@ declare global {
          * @param {mw.cookie.CookieOptions} [options]
          * @returns {string|Object} The current value (if getting a cookie), or an internal `document.cookie`
          *  expression (if setting or removing).
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.cookie
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.cookie.html#.$.cookie
          */
         cookie(key: string, value: string | null, options?: mw.cookie.CookieOptions): string;
         cookie(key: string): unknown;
@@ -34,7 +34,7 @@ declare global {
          * @param {string} key
          * @param {mw.cookie.CookieOptions} options
          * @returns {boolean} True if the cookie previously existed
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.removeCookie
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.cookie.html#.$.removeCookie
          */
         removeCookie(key: string, options: mw.cookie.CookieOptions): boolean;
     }
diff --git a/jquery/highlightText.d.ts b/jquery/highlightText.d.ts
index 732a36a..05df7cc 100644
--- a/jquery/highlightText.d.ts
+++ b/jquery/highlightText.d.ts
@@ -19,7 +19,7 @@ declare global {
          * @param {string} matchString String to match
          * @param {Options} [options]
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.highlightText
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.highlightText.html#.$.fn.highlightText
          */
         highlightText(matchString: string, options?: Options): this;
     }
diff --git a/jquery/lengthLimit.d.ts b/jquery/lengthLimit.d.ts
index 5bebcf4..6154d2a 100644
--- a/jquery/lengthLimit.d.ts
+++ b/jquery/lengthLimit.d.ts
@@ -15,7 +15,7 @@ declare global {
          * @param {number} byteLimit Number of bytes the value may be in size.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {TrimResult}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.trimByteLength
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.lengthLimit.html#.'$.fn.trimByteLength'
          */
         trimByteLength(
             safeVal: string,
@@ -40,7 +40,7 @@ declare global {
          *  called with fetched value as argument.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.byteLimit
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.lengthLimit.html#.$.fn.byteLimit
          */
         byteLimit(limit: number, filterFunction?: FilterFunction): this;
         byteLimit(filterFunction?: FilterFunction): this;
@@ -62,7 +62,7 @@ declare global {
          *  called with fetched value as argument.
          * @param {FilterFunction} [filterFunction] Function to call on the string before assessing the length.
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.codePointLimit
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.lengthLimit.html#.$.fn.codePointLimit
          */
         codePointLimit(limit: number, filterFunction?: FilterFunction): this;
         codePointLimit(filterFunction?: FilterFunction): this;
diff --git a/jquery/makeCollapsible.d.ts b/jquery/makeCollapsible.d.ts
index 803436c..64e48ac 100644
--- a/jquery/makeCollapsible.d.ts
+++ b/jquery/makeCollapsible.d.ts
@@ -18,7 +18,7 @@ declare global {
          * ```
          * @param {Options} [options]
          * @returns {JQuery}
-         * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.makeCollapsible
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-jquery.makeCollapsible.html#.$.fn.makeCollapsible
          */
         makeCollapsible(options?: Options): this;
     }
diff --git a/jquery/spinner.d.ts b/jquery/spinner.d.ts
index 41cce1e..29f48d7 100644
--- a/jquery/spinner.d.ts
+++ b/jquery/spinner.d.ts
@@ -69,6 +69,11 @@ declare global {
 type Size = "large" | "small";
 type Type = "block" | "inline";
 
+/**
+ * Options for {@link JQuery.injectSpinner}.
+ *
+ * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#~SpinnerOpts
+ */
 interface Options {
     /**
      * If given, spinner will be given an id of "mw-spinner-{id}".
diff --git a/jquery/updateTooltipAccessKeys.d.ts b/jquery/updateTooltipAccessKeys.d.ts
index 8b4c18b..0666398 100644
--- a/jquery/updateTooltipAccessKeys.d.ts
+++ b/jquery/updateTooltipAccessKeys.d.ts
@@ -22,7 +22,7 @@ interface TooltipAccessKeys<This = JQuery> {
      * } );
      * ```
      * @returns {JQuery}
-     * @see https://doc.wikimedia.org/mediawiki-core/master/js/jQueryPlugins.html#.updateTooltipAccessKeys
+     * @see https://doc.wikimedia.org/mediawiki-core/REL1_42/js/jQueryPlugins.html#.updateTooltipAccessKeys
      */
     (): This;
 

From 21e20cc1dc2db48d8c8e6394205960186832e8d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Tue, 28 May 2024 15:50:46 +0200
Subject: [PATCH 12/15] Fix `mw.util.parseImageUrl` return type The `resizeUrl`
 method may be missing, in which case the method is specified and `null`

---
 mw/util.d.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mw/util.d.ts b/mw/util.d.ts
index c672468..0da7208 100644
--- a/mw/util.d.ts
+++ b/mw/util.d.ts
@@ -31,7 +31,7 @@ interface ResizeableThumbnailUrl {
      *  `Special:Redirect` which is less efficient. Otherwise, it is a direct thumbnail URL.
      * @returns A thumbnail URL (URL-encoded) with that width.
      */
-    resizeUrl: (w: number) => string | null;
+    resizeUrl: ((w: number) => string) | null;
 }
 
 declare global {

From 49ad52dee0ca6d052f9e75ce318c6bd0e292c637 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Tue, 28 May 2024 16:07:22 +0200
Subject: [PATCH 13/15] Sort members for consistency, missed small interfaces
 from previous commits
 https://github.com/wikimedia-gadgets/types-mediawiki/pull/42/commits/0680f0185fb3a1464d15c34166835d61d04c9f6b
 Also simplify `RequiredOrUndefined` type

---
 jquery/client.d.ts          |  4 ++--
 jquery/collapsibleTabs.d.ts | 18 +++++++++---------
 jquery/confirmable.d.ts     |  5 +++--
 jquery/textSelection.d.ts   | 24 ++++++++++++------------
 mw/Api.d.ts                 |  2 +-
 mw/Uri.d.ts                 |  2 +-
 mw/config.d.ts              |  2 +-
 mw/experiments.d.ts         |  8 ++++----
 mw/hook.d.ts                | 12 ++++++------
 mw/index.d.ts               |  2 +-
 mw/inspect.d.ts             |  2 +-
 mw/notification.d.ts        |  4 ++--
 12 files changed, 43 insertions(+), 42 deletions(-)

diff --git a/jquery/client.d.ts b/jquery/client.d.ts
index b1da981..1f03fba 100644
--- a/jquery/client.d.ts
+++ b/jquery/client.d.ts
@@ -128,8 +128,8 @@ interface Client {
 }
 
 export interface ClientNavigator {
-    userAgent: string;
     platform: string;
+    userAgent: string;
 }
 
 type ClientProfileName =
@@ -157,9 +157,9 @@ type ClientSupportMap =
     | Record<"ltr" | "rtl", UndirectedClientSupportMap>;
 
 interface ClientProfile {
-    name: ClientProfileName;
     layout: "edge" | "gecko" | "khtml" | "presto" | "trident" | "webkit";
     layoutVersion: number;
+    name: ClientProfileName;
     platform: "ipad" | "iphone" | "linux" | "mac" | "solaris" | "win";
     version: string;
     versionBase: string;
diff --git a/jquery/collapsibleTabs.d.ts b/jquery/collapsibleTabs.d.ts
index 05165d2..4a2af39 100644
--- a/jquery/collapsibleTabs.d.ts
+++ b/jquery/collapsibleTabs.d.ts
@@ -22,10 +22,6 @@ declare global {
  * @see https://doc.wikimedia.org/mediawiki-skins-Vector/master/js/js/CollapsibleTabsOptions.html
  */
 interface CollapsibleTabsOptions {
-    /**
-     * Optional tab selector. Defaults to `#p-views ul`.
-     */
-    expandedContainer: string;
     /**
      * Optional menu item selector. Defaults to `#p-cactions ul`.
      */
@@ -34,12 +30,16 @@ interface CollapsibleTabsOptions {
      * Optional selector for tabs that are collapsible. Defaults to `li.collapsible`.
      */
     collapsible: string;
-    shifting: boolean;
+    /**
+     * Optional tab selector. Defaults to `#p-views ul`.
+     */
+    expandedContainer: string;
     expandedWidth: number;
-
-    expandCondition(eleWidth: number): boolean;
+    shifting: boolean;
 
     collapseCondition(): boolean;
+
+    expandCondition(eleWidth: number): boolean;
 }
 
 interface CollapsibleTabsStatic {
@@ -48,6 +48,8 @@ interface CollapsibleTabsStatic {
 
     addData($collapsible: JQuery): void;
 
+    calculateTabDistance(): number;
+
     getSettings($collapsible: JQuery): CollapsibleTabsOptions;
 
     handleResize(): void;
@@ -55,8 +57,6 @@ interface CollapsibleTabsStatic {
     moveToCollapsed($moving: JQuery): void;
 
     moveToExpanded($moving: JQuery): void;
-
-    calculateTabDistance(): number;
 }
 
 interface CollapsibleTabs extends CollapsibleTabsStatic, CollapsibleTabsOptions {}
diff --git a/jquery/confirmable.d.ts b/jquery/confirmable.d.ts
index 7a30e81..20843b9 100644
--- a/jquery/confirmable.d.ts
+++ b/jquery/confirmable.d.ts
@@ -27,9 +27,10 @@ declare global {
     }
 }
 
-// make all properties required, replacing optional values with undefined
+// make all properties required, replacing optional values with undefined,
+// whether "exactOptionalPropertyTypes" is enabled or not.
 type RequiredOrUndefined<T> = {
-    [P in keyof Required<T>]: undefined extends T[P] ? T[P] | undefined : T[P];
+    [P in keyof Required<T>]: T[P];
 };
 
 interface Confirmable {
diff --git a/jquery/textSelection.d.ts b/jquery/textSelection.d.ts
index 0859497..1614837 100644
--- a/jquery/textSelection.d.ts
+++ b/jquery/textSelection.d.ts
@@ -152,9 +152,9 @@ declare global {
 
 interface TextSelectionEncapsulateOptions {
     /**
-     * Text to insert before the cursor/selection.
+     * Put the inserted text on a line of its own. Defaults to false.
      */
-    pre?: string;
+    ownline?: boolean;
     /**
      * Text to insert between pre and post and select afterwards.
      */
@@ -164,29 +164,29 @@ interface TextSelectionEncapsulateOptions {
      */
     post?: string;
     /**
-     * Put the inserted text on a line of its own. Defaults to false.
+     * Text to insert before the cursor/selection.
      */
-    ownline?: boolean;
+    pre?: string;
     /**
      * If there is a selection, replace it with peri instead of leaving it alone. Defaults to false.
      */
     replace?: boolean;
     /**
-     * Select the peri text if it was inserted (but not if there was a selection and replace==false, or if splitlines==true). Defaults to true.
-     */
-    selectPeri?: boolean;
-    /**
-     * If multiple lines are selected, encapsulate each line individually. Defaults to false.
+     * Position to end selection at. Defaults to the position to start setection at.
      */
-    splitlines?: boolean;
+    selectionEnd?: number;
     /**
      * Position to start selection at.
      */
     selectionStart?: number;
     /**
-     * Position to end selection at. Defaults to the position to start setection at.
+     * Select the peri text if it was inserted (but not if there was a selection and replace==false, or if splitlines==true). Defaults to true.
      */
-    selectionEnd?: number;
+    selectPeri?: boolean;
+    /**
+     * If multiple lines are selected, encapsulate each line individually. Defaults to false.
+     */
+    splitlines?: boolean;
 }
 
 interface GetCaretPositionOptions {
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index b19ecc8..18d8679 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -48,9 +48,9 @@ interface EditNoChangeResult extends EditSuccessResult {
 }
 
 interface EditChangedResult extends EditSuccessResult {
-    oldrevid: number;
     newrevid: number;
     newtimestamp: string;
+    oldrevid: number;
 }
 
 // type alias to fix #45
diff --git a/mw/Uri.d.ts b/mw/Uri.d.ts
index d9ab9d7..4647dfc 100644
--- a/mw/Uri.d.ts
+++ b/mw/Uri.d.ts
@@ -1,8 +1,8 @@
 export type QueryParams = Record<string, string | number | boolean | null | undefined>;
 
 interface UriParser {
-    strict: RegExp;
     loose: RegExp;
+    strict: RegExp;
 }
 
 declare global {
diff --git a/mw/config.d.ts b/mw/config.d.ts
index ffbcb27..c28faf2 100644
--- a/mw/config.d.ts
+++ b/mw/config.d.ts
@@ -388,8 +388,8 @@ interface LimitReport {
 }
 
 interface LimitReportValue {
-    value: number;
     limit: number;
+    value: number;
 }
 
 export {};
diff --git a/mw/experiments.d.ts b/mw/experiments.d.ts
index 7e1e443..fe92203 100644
--- a/mw/experiments.d.ts
+++ b/mw/experiments.d.ts
@@ -1,16 +1,16 @@
 interface Experiment {
     /**
-     * The name of the experiment
+     * A map of bucket name to probability that the user will be assigned to that bucket
      */
-    name: string;
+    buckets: Record<string, number>;
     /**
      * Whether the experiment is enabled. If the experiment is disabled, then the user is always assigned to the control bucket
      */
     enabled: boolean;
     /**
-     * A map of bucket name to probability that the user will be assigned to that bucket
+     * The name of the experiment
      */
-    buckets: Record<string, number>;
+    name: string;
 }
 
 declare global {
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
index b4e0d54..3fc6f27 100644
--- a/mw/hook.d.ts
+++ b/mw/hook.d.ts
@@ -75,14 +75,14 @@ interface PostEditData {
      * String for plain text, use array or jQuery object to pass actual nodes.
      */
     message?: string | JQuery | HTMLElement[];
-    /**
-     * User that made the edit.
-     */
-    user?: string | User;
     /**
      * Whether a temporary user account was created.
      */
     tempUserCreated?: boolean;
+    /**
+     * User that made the edit.
+     */
+    user?: string | User;
 }
 
 interface SearchIndex {
@@ -90,10 +90,10 @@ interface SearchIndex {
 }
 
 interface SearchIndexEntry {
-    $highlight: JQuery;
     $field: JQuery;
-    $wrapper: JQuery;
+    $highlight: JQuery;
     $tabPanel: JQuery;
+    $wrapper: JQuery;
 }
 
 interface EditRecovery {
diff --git a/mw/index.d.ts b/mw/index.d.ts
index 97c4ef2..f86bc5f 100644
--- a/mw/index.d.ts
+++ b/mw/index.d.ts
@@ -57,8 +57,8 @@ interface ErrorAnalyticEventData extends ObjectAnalyticEventData {
 }
 
 interface AnalyticEvent {
-    topic: string;
     data: AnalyticEventData;
+    topic: string;
 }
 
 interface AnalyticEventCallback {
diff --git a/mw/inspect.d.ts b/mw/inspect.d.ts
index c6edbe5..3d7c2df 100644
--- a/mw/inspect.d.ts
+++ b/mw/inspect.d.ts
@@ -70,8 +70,8 @@ interface ResourceLoaderReportMap {
 }
 
 interface Dependency {
-    requires: string[];
     requiredBy: string[];
+    requires: string[];
 }
 
 declare global {
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
index 8eb53a0..de8be0c 100644
--- a/mw/notification.d.ts
+++ b/mw/notification.d.ts
@@ -14,8 +14,8 @@ interface Notification {
     isPaused: boolean;
     options: mw.notification.NotificationOptions;
     timeout: {
-        set: typeof setTimeout;
         clear: typeof clearTimeout;
+        set: typeof setTimeout;
     };
 
     /**
@@ -92,8 +92,8 @@ declare global {
              * @private
              */
             const autoHideSeconds: {
-                short: number;
                 long: number;
+                short: number;
             };
 
             /**

From 6712c9c3f696a938f0c0a8402dc634df6b4bb50f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Tue, 28 May 2024 19:47:17 +0200
Subject: [PATCH 14/15] Compatibility with 1.39 (LTS) - add various
 `@since`/`@deprecated` annotations for declarations
 added/modified/deprecated/removed with 1.40/1.41/1.42 - add `isoDate`/`url`
 tablesorter parsers, removed since 1.40 - add `jquery.tipsy` RL module,
 removed since 1.41 - add `mw.language.commafy`, removed since 1.40 - add
 missing `script` property of a RL module (not added recently, just an
 oversight)

---
 jquery/colorUtil.d.ts   |  1 +
 jquery/tablesorter.d.ts |  8 +++++
 jquery/tipsy.d.ts       | 78 +++++++++++++++++++++++++++++++++++++++++
 mw/Api.d.ts             |  3 +-
 mw/Rest.d.ts            |  1 +
 mw/Title.d.ts           |  2 ++
 mw/language.d.ts        | 22 ++++++++++++
 mw/loader.d.ts          | 13 ++++++-
 mw/storage.d.ts         |  1 +
 mw/tempUserCreated.d.ts |  1 +
 mw/user.d.ts            |  5 +++
 mw/util.d.ts            |  9 ++++-
 12 files changed, 141 insertions(+), 3 deletions(-)
 create mode 100644 jquery/tipsy.d.ts

diff --git a/jquery/colorUtil.d.ts b/jquery/colorUtil.d.ts
index 8585faf..84d1941 100644
--- a/jquery/colorUtil.d.ts
+++ b/jquery/colorUtil.d.ts
@@ -1,6 +1,7 @@
 declare global {
     interface JQueryStatic {
         /**
+         * @deprecated Removed since 1.41.
          * @see https://doc.wikimedia.org/mediawiki-core/REL1_40/js/#!/api/jQuery.colorUtil
          */
         colorUtil: ColorUtil;
diff --git a/jquery/tablesorter.d.ts b/jquery/tablesorter.d.ts
index f8262dc..b87bbe0 100644
--- a/jquery/tablesorter.d.ts
+++ b/jquery/tablesorter.d.ts
@@ -33,9 +33,17 @@ export interface ParserMap {
     currency: "numeric";
     date: "numeric";
     IPAddress: "numeric";
+    /**
+     * @deprecated Removed since 1.40.
+     */
+    isoDate: "numeric";
     number: "numeric";
     text: "text";
     time: "numeric";
+    /**
+     * @deprecated Removed since 1.40.
+     */
+    url: "text";
     usLongDate: "numeric";
 }
 
diff --git a/jquery/tipsy.d.ts b/jquery/tipsy.d.ts
new file mode 100644
index 0000000..c7e080d
--- /dev/null
+++ b/jquery/tipsy.d.ts
@@ -0,0 +1,78 @@
+declare global {
+    interface JQuery<TElement> {
+        /**
+         * @deprecated
+         * @deprecated Removed since 1.41.
+         */
+        tipsy: JQueryTipsy<TElement>;
+    }
+}
+
+type StringProvider<T = HTMLElement> = string | ((ctx: T) => string);
+type MethodsOf<T> = {
+    [P in keyof T]: T[P] extends (...args: unknown[]) => void ? P : never;
+}[keyof T];
+
+type NSDirection = "n" | "s" | "";
+type EWDirection = "e" | "w" | "";
+type Direction = `${NSDirection}${EWDirection}`;
+
+interface JQueryTipsy<T = HTMLElement> {
+    (options: true): Tipsy;
+    (options?: MethodsOf<Tipsy> | Options<T>): JQuery<T>;
+
+    defaults: Required<Options>;
+
+    /**
+     * Yields a closure of the supplied parameters, producing a function that takes
+     * no arguments and is suitable for use as an autogravity function like so:
+     *
+     * @param {number} margin (int) - distance from the viewable region edge that an
+     *  element should be before setting its tooltip's gravity to be away
+     *  from that edge.
+     * @param {Direction} prefer (string, e.g. `n`, `sw`, `w`) - the direction to prefer
+     *  if there are no viewable region edges effecting the tooltip's
+     *  gravity. It will try to vary from this minimally, for example,
+     *  if `sw` is preferred and an element is near the right viewable
+     *  region edge, but not the top edge, it will set the gravity for
+     *  that element's tooltip to be `se`, preserving the southern
+     *  component.
+     */
+    autoBounds(margin: number, prefer: Direction): Direction;
+    autoNS(): boolean;
+    autoWE(): boolean;
+    elementOptions<T extends Options>(ele: HTMLElement, options: T): T;
+}
+
+interface Options<T = HTMLElement> {
+    center?: boolean;
+    className?: StringProvider<T> | null;
+    delayIn?: number;
+    delayOut?: number;
+    fade?: boolean;
+    fallback?: string;
+    gravity?: StringProvider<T>;
+    html?: boolean;
+    live?: boolean;
+    offset?: number;
+    opacity?: number;
+    title?: StringProvider<T>;
+    trigger?: "hover" | "manual";
+}
+
+interface Tipsy<T = HTMLElement> {
+    $element: JQuery<T>;
+    enabled: boolean;
+    options: Required<Options>;
+
+    closeOnEsc(e: KeyboardEvent): void;
+    getTitle(): string;
+    fixTitle(): void;
+    hide(): void;
+    keyHandler(e: KeyboardEvent): void;
+    show(): void;
+    tip(): JQuery;
+    validate(): void;
+}
+
+export {};
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
index 18d8679..a945e65 100644
--- a/mw/Api.d.ts
+++ b/mw/Api.d.ts
@@ -490,6 +490,7 @@ declare global {
              * are loaded. If all messages are known, the returned promise is resolved immediately.
              *
              * @since 1.27
+             * @since 1.42 - accepts a single string message as parameter.
              * @param {string|string[]} messages Messages to retrieve
              * @param {ApiQueryAllMessagesParams} [options] Additional parameters for the API call
              * @returns {JQuery.Promise<boolean>}
@@ -719,7 +720,7 @@ declare global {
             /**
              * Convenience method for `action=watch`.
              *
-             * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled
+             * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled.
              * @param {TypeOrArray<TitleLike>} pages Full page name or instance of {@link mw.Title}, or an
              *  array thereof. If an array is passed, the return value passed to the promise will also be an
              *  array of appropriate objects.
diff --git a/mw/Rest.d.ts b/mw/Rest.d.ts
index e5b15be..a886aa3 100644
--- a/mw/Rest.d.ts
+++ b/mw/Rest.d.ts
@@ -92,6 +92,7 @@ declare global {
              *
              * Note: only sending `application/json` is currently supported.
              *
+             * @since 1.42 - body parameter is optional.
              * @param {string} path
              * @param {Object.<string, any>} [body]
              * @param {Object.<string, any>} [headers]
diff --git a/mw/Title.d.ts b/mw/Title.d.ts
index 6db48fc..2941e65 100644
--- a/mw/Title.d.ts
+++ b/mw/Title.d.ts
@@ -131,6 +131,7 @@ declare global {
              * Note that this method will work for non-file titles but probably give nonsensical results.
              * A title like `User:Dr._J._Fail` will be returned as `Dr. J`! Use {@link getMainText} instead.
              *
+             * @since 1.40
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFileNameTextWithoutExtension
              */
@@ -144,6 +145,7 @@ declare global {
              * Note that this method will work for non-file titles but probably give nonsensical results.
              * A title like `User:Dr._J._Fail` will be returned as `Dr._J`! Use {@link getMain} instead.
              *
+             * @since 1.40
              * @returns {string}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Title.html#getFileNameWithoutExtension
              */
diff --git a/mw/language.d.ts b/mw/language.d.ts
index 2650130..48c197c 100644
--- a/mw/language.d.ts
+++ b/mw/language.d.ts
@@ -58,6 +58,28 @@ declare global {
              */
             function bcp47(languageTag: string): string;
 
+            /**
+             * Apply pattern to format value as a string.
+             *
+             * Using patterns from {@link https://www.unicode.org/reports/tr35/#Number_Format_Patterns Unicode TR35}.
+             *
+             * @private
+             * @deprecated This function will be made private in a future release;
+             *  it is poorly named, corresponds to a deprecated function in core, and
+             *  its functionality should be rolled into convertNumber().
+             * @deprecated Removed since 1.40.
+             * @param {number} value
+             * @param {string} pattern Pattern string as described by Unicode TR35
+             * @param {number|null} [minimumGroupingDigits=null]
+             * @throws {Error} If unable to find a number expression in `pattern`.
+             * @return {string}
+             */
+            function commafy(
+                value: number,
+                pattern: string,
+                minimumGroupingDigits?: number | null
+            ): string;
+
             /**
              * Grammatical transformations, needed for inflected languages.
              * Invoked by putting `{{grammar:case|word}}` in a message.
diff --git a/mw/loader.d.ts b/mw/loader.d.ts
index cf39a00..6805529 100644
--- a/mw/loader.d.ts
+++ b/mw/loader.d.ts
@@ -46,13 +46,20 @@ type ModuleScript =
     | string;
 
 interface ModuleRegistryEntry {
+    /**
+     * @since 1.41
+     */
     declarator?: ModuleDeclarator | null;
     dependencies: string[];
+    /**
+     * @since 1.41
+     */
     deprecationWarning?: string | null;
     group: number | null;
     messages?: ModuleMessages | null;
     module: Module;
     packageExports: any;
+    script?: ModuleScript | null;
     skip: string | null;
     source: string;
     state: "error" | "loaded" | "missing" | "registered" | "ready";
@@ -322,6 +329,7 @@ declare global {
              * Implement a module given a function which returns the components of the module
              *
              * @private
+             * @since 1.41
              * @param {ModuleDeclarator} declarator The declarator should return an array with the following keys:
              *
              * - 0. {string} module Name of module and current module version. Formatted
@@ -368,6 +376,8 @@ declare global {
              * Does not support mw.loader.store caching.
              *
              * @private
+             * @since 1.41 - deprecationWarning parameter can be passed.
+             * @deprecated since 1.41
              * @param {string} module
              * @param {ModuleScript} [script] Module code. This can be a function,
              *  a list of URLs to load via `<script src>`, a string for `domEval()`, or an
@@ -408,10 +418,10 @@ declare global {
              * the modules are registered.
              *
              * @private
+             * @since 1.41 - version can no longer be a number (timestamp).
              * @param {string|Array} modules Module name or array of arrays, each containing
              *  a list of arguments compatible with this method
              * @param {string|number} [version] Module version hash (falls backs to empty string)
-             *  Can also be a number (timestamp) for compatibility with MediaWiki 1.25 and earlier.
              * @param {Array<string|number>} [dependencies] Array of module names on which this module depends.
              * @param {string|null} [group=null] Group which the module is in
              * @param {string} [source="local"] Name of the source
@@ -538,6 +548,7 @@ declare global {
                 /**
                  * Construct a JSON-serializable object representing the content of the store.
                  *
+                 * @deprecated Removed since 1.41.
                  * @returns {JsonModuleStore} Module store contents.
                  */
                 function toJSON(): JsonModuleStore;
diff --git a/mw/storage.d.ts b/mw/storage.d.ts
index f765520..f3f2b30 100644
--- a/mw/storage.d.ts
+++ b/mw/storage.d.ts
@@ -63,6 +63,7 @@ interface SafeStorage {
     /**
      * Set an object value in device storage by JSON encoding.
      *
+     * @since 1.41 - returns a boolean indicating whether the value was set.
      * @param {string} key Key name to store under
      * @param {Object} value Object value to be stored
      * @param {number} [expiry] Number of seconds after which this item can be deleted
diff --git a/mw/tempUserCreated.d.ts b/mw/tempUserCreated.d.ts
index b18802c..1816f55 100644
--- a/mw/tempUserCreated.d.ts
+++ b/mw/tempUserCreated.d.ts
@@ -3,6 +3,7 @@ declare global {
         /**
          * Respond to the creation of a temporary user.
          *
+         * @since 1.42
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.tempUserCreated.html
          */
         namespace tempUserCreated {
diff --git a/mw/user.d.ts b/mw/user.d.ts
index 574caea..9e25003 100644
--- a/mw/user.d.ts
+++ b/mw/user.d.ts
@@ -25,6 +25,7 @@ export interface User {
      * where `value` contains only alphanumerical characters (a-z, A-Z, and 0-9), and `feature`
      * can also include hyphens.
      *
+     * @since 1.41
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.clientPrefs.html
      */
     clientPrefs: {
@@ -75,6 +76,7 @@ export interface User {
      * will be used for their account. It may also be used in previews. However, the account is not
      * created yet, and the name is not visible to other users.
      *
+     * @since 1.41
      * @returns {JQuery.Promise<string>} Promise resolved with the username if we succeeded,
      *  or resolved with `null` if we failed
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.acquireTempUserName
@@ -110,6 +112,7 @@ export interface User {
     /**
      * Get date user first registered, if available.
      *
+     * @since 1.42
      * @returns {false|null|Date} False for anonymous users, null if data is
      *  unavailable, or Date for when the user registered. For temporary users
      *  that is when their temporary account was created.
@@ -194,6 +197,7 @@ export interface User {
     /**
      * Check whether the user is a normal non-temporary registered user.
      *
+     * @since 1.40
      * @returns {boolean}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.isNamed
      */
@@ -202,6 +206,7 @@ export interface User {
     /**
      * Check whether the user is an autocreated temporary user.
      *
+     * @since 1.40
      * @returns {boolean}
      * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.user.html#.isTemp
      */
diff --git a/mw/util.d.ts b/mw/util.d.ts
index 0da7208..c2a7c0f 100644
--- a/mw/util.d.ts
+++ b/mw/util.d.ts
@@ -99,6 +99,7 @@ declare global {
             /**
              * Creates a detached portlet Element in the skin with no elements.
              *
+             * @since 1.41
              * @param {string} id of the new portlet.
              * @param {string} [label] of the new portlet.
              * @param {string} [before] selector of the element preceding the new portlet. If not passed
@@ -191,6 +192,7 @@ declare global {
             /**
              * Add content to the subtitle of the skin.
              *
+             * @since 1.40
              * @param {HTMLElement|string} nodeOrHTMLString
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.addSubtitle
              */
@@ -200,6 +202,7 @@ declare global {
              * Clears the entire subtitle if present in the page. Used for refreshing subtitle
              * after edit with response from parse API.
              *
+             * @since 1.40
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.clearSubtitle
              */
             function clearSubtitle(): void;
@@ -264,7 +267,8 @@ declare global {
              * \ { } ( ) | . ? * + - ^ $ [ ]
              * ```
              *
-             * @since 1.26; moved to {@link mw.util} in 1.34
+             * @since 1.26
+             * @since 1.34 - moved to {@link mw.util}.
              * @param {string} str String to escape
              * @returns {string} Escaped string
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.escapeRegExp
@@ -282,6 +286,7 @@ declare global {
              * mw.util.getArrayParam( 'foo', new URLSearchParams( '?foo[]=a&foo[]=b' ) ); // [ 'a', 'b' ]
              * mw.util.getArrayParam( 'foo', new URLSearchParams( '?foo=a' ) ); // null
              * ```
+             * @since 1.41
              * @param {string} param The parameter name.
              * @param {URLSearchParams} [params] Parsed URL parameters to search through, defaulting to the current browsing location.
              * @returns {string[]|null} Parameter value, or null if parameter was not found.
@@ -353,6 +358,7 @@ declare global {
              * This is used when testing for infinity in the context of expiries,
              * such as watchlisting, page protection, and block expiries.
              *
+             * @since 1.42
              * @param {string|null} str
              * @returns {boolean}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isInfinity
@@ -435,6 +441,7 @@ declare global {
              *
              * This functionality has been adapted from `MediaWiki\User\TempUser\Pattern::isMatch()`
              *
+             * @since 1.40
              * @param {string} username
              * @returns {boolean}
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/module-mediawiki.util.html#.isTemporaryUser

From 4a6203c8b2c92ec00f3ad24bd9def707314a1c5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrien=20LES=C3=89N=C3=89CHAL?=
 <adrien.lesenechal@etu.univ-nantes.fr>
Date: Wed, 29 May 2024 10:13:27 +0200
Subject: [PATCH 15/15] Bump version to 1.8.0

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index d7a7bd4..612eb36 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
     "name": "types-mediawiki",
-    "version": "1.7.1",
+    "version": "1.8.0",
     "lockfileVersion": 2,
     "requires": true,
     "packages": {
         "": {
             "name": "types-mediawiki",
-            "version": "1.7.1",
+            "version": "1.8.0",
             "license": "GPL-3.0-or-later",
             "dependencies": {
                 "@types/jquery": "^3.5.5",
diff --git a/package.json b/package.json
index efd8b25..57b5852 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "types-mediawiki",
-    "version": "1.7.1",
+    "version": "1.8.0",
     "description": "TypeScript definitions for MediaWiki JS interface",
     "types": "index.d.ts",
     "scripts": {