Update to MediaWiki 1.46 (#71)

Derugon · web-flow · commit 564386397028 · 2026-06-30T07:55:47.000+02:00
- Added `labels` (3rd) optional parameter to `new mw.Api().watch()`.
- Added `enableWatchlistLabels`, `indefBlockReasonOptions`, `SpecialEditWatchlistUrl`, `SpecialWatchlistLabelsTitle`, `SpecialWatchlistLabelsUrl`, `watchlistLabels`, `wgAutoCreateTempUserEnabled`, `wgCreateAccountUsernamePolicyPopoverMsgs`, and `wgErrorPageMessageKey` configuration values (see `mw.config`).
- Added `mw.special.block.doBlockParamsReady` and `mw.special.block.formReset` hooks (see `mw.hook`).
- Added `ariaText` to `mw.notification()` options.
- Added `mw.util.adjustThumbWidthForSteps()` function.
- Deprecated `foreignActionApi` argument from `mw.ForeignRest` constructor.
- Moved `parseDom` method of `mw.Message` from `mediawiki.jqueryMsg` ResourceLoader module to `mediawiki.base`.
- `mw.util.addSubtitle()` returns a boolean indicating whether the subtitle was updated.
diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
@@ -15,7 +15,7 @@ jobs:
             - uses: actions/checkout@v4
             - uses: actions/setup-node@v4
               with:
-                  node-version: '24.x'
+                  node-version: "24.x"
                   registry-url: https://registry.npmjs.org/
             - run: npm ci
             - run: npm publish --provenance
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -13,6 +13,6 @@ jobs:
             - uses: actions/checkout@v4
             - uses: actions/setup-node@v4
               with:
-                  node-version: '24.x'
+                  node-version: "24.x"
             - run: npm ci
             - run: npm run test
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,30 +1,39 @@
 ## Unreleased
 
-- Updated to MediaWiki 1.45:
-  * Added `notice` as valid type for `mw.notify()` options.
-  * Added `blockCIDRLimit`, `wgParsoidHtmlVersion` configuration values.
-  * Added `revisionsize` property to the `wgPageParseReport.limitreport` configuration value.
-- Added missing configuration values defined in MediaWiki core.
-- Fixed configuration value types:
-  * `wgPageParseReport` and `wgRestrictionMove` can be undefined.
-  * `wgPostEdit` can have a `+tempuser` suffix.
-  * `wgUserRegistration` can be null.
+-   Updated to MediaWiki 1.45:
+    -   Added `notice` as valid type for `mw.notify()` options.
+    -   Added `blockCIDRLimit`, `wgParsoidHtmlVersion` configuration values.
+    -   Added `revisionsize` property to the `wgPageParseReport.limitreport` configuration value.
+-   Updated to MediaWiki 1.46:
+    -   Added `labels` (3rd) optional parameter to `new mw.Api().watch()`.
+    -   Added `enableWatchlistLabels`, `indefBlockReasonOptions`, `SpecialEditWatchlistUrl`, `SpecialWatchlistLabelsTitle`, `SpecialWatchlistLabelsUrl`, `watchlistLabels`, `wgAutoCreateTempUserEnabled`, `wgCreateAccountUsernamePolicyPopoverMsgs`, and `wgErrorPageMessageKey` configuration values (see `mw.config`).
+    -   Added `mw.special.block.doBlockParamsReady` and `mw.special.block.formReset` hooks (see `mw.hook`).
+    -   Added `ariaText` to `mw.notification()` options.
+    -   Added `mw.util.adjustThumbWidthForSteps()` function.
+    -   Deprecated `foreignActionApi` argument from `mw.ForeignRest` constructor.
+    -   Moved `parseDom` method of `mw.Message` from `mediawiki.jqueryMsg` ResourceLoader module to `mediawiki.base`.
+    -   `mw.util.addSubtitle()` returns a boolean indicating whether the subtitle was updated.
+-   Added missing configuration values defined in MediaWiki core.
+-   Fixed configuration value types:
+    -   `wgPageParseReport` and `wgRestrictionMove` can be undefined.
+    -   `wgPostEdit` can have a `+tempuser` suffix.
+    -   `wgUserRegistration` can be null.
 
 ## 2.0.0
 
-- Types for MediaWiki API parameters have been moved to [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).
-- Exports `ApiOptions`, `ForeignApiOptions`, `RestOptions`, and `UserInfo`, deprecated since 1.8.0, have been removed. Use the exposed `mw.Api.Options`, `mw.ForeignApi.Options`, `mw.Rest.Options`, and `mw.Api.UserInfo` instead.
-- `mw.Api.Promise.Upload`, deprecated since 1.10.0, has been removed. Use `mw.Upload.Promise` or `mw.Upload.AbortablePromise` instead.
-- Updated to MediaWiki 1.44:
-  * Added `mw.Api.AbortController`.
-  * Added `ajax.signal` and `userAgent` properties to `mw.Api` options.
-  * Added `new mw.Api().prepareExtensibleApiRequest`.
-  * Added an AJAX options argument to `new mw.Api().getToken`.
-  * Added `mw.deflateAsync`.
-  * Added `mw.hook(...).deprecate`.
-  * Added `mw.language.convertGrammarMapping`.
-  * Legacy token types are no longer deprecated.
-  * `mw.deflate` is deprecated, in favor of `mw.deflateAsync`.
-  * `mw.track` and `mw.trackSubscribe` accept multiple data arguments.
-  * Updated Vue to 3.5.13.
-- Parameter types of `apisandbox.formatRequest` hook callback have been narrowed.
+-   Types for MediaWiki API parameters have been moved to [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).
+-   Exports `ApiOptions`, `ForeignApiOptions`, `RestOptions`, and `UserInfo`, deprecated since 1.8.0, have been removed. Use the exposed `mw.Api.Options`, `mw.ForeignApi.Options`, `mw.Rest.Options`, and `mw.Api.UserInfo` instead.
+-   `mw.Api.Promise.Upload`, deprecated since 1.10.0, has been removed. Use `mw.Upload.Promise` or `mw.Upload.AbortablePromise` instead.
+-   Updated to MediaWiki 1.44:
+    -   Added `mw.Api.AbortController`.
+    -   Added `ajax.signal` and `userAgent` properties to `mw.Api` options.
+    -   Added `new mw.Api().prepareExtensibleApiRequest`.
+    -   Added an AJAX options argument to `new mw.Api().getToken`.
+    -   Added `mw.deflateAsync`.
+    -   Added `mw.hook(...).deprecate`.
+    -   Added `mw.language.convertGrammarMapping`.
+    -   Legacy token types are no longer deprecated.
+    -   `mw.deflate` is deprecated, in favor of `mw.deflateAsync`.
+    -   `mw.track` and `mw.trackSubscribe` accept multiple data arguments.
+    -   Updated Vue to 3.5.13.
+-   Parameter types of `apisandbox.formatRequest` hook callback have been narrowed.
diff --git a/README.md b/README.md
@@ -51,4 +51,4 @@ let namespaces = mw.config.get("pageTriageNamespaces") as number[];
 
 ### MediaWiki API parameters
 
-This package used to provide typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page) till v1.10.1. These have since been moved to a separate package, [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).
+This package used to provide typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page) till v1.10.1. These have since been moved to a separate package, [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).
diff --git a/mw/Api.d.ts b/mw/Api.d.ts
@@ -385,6 +385,13 @@ declare global {
              * 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.
              *
+             * This method handles the different error formats returned by the action API itself, and some
+             * error conditions that may occur at other layers, e.g. user losing their network connection,
+             * server being down, rate limits enforced by a proxy in front of MediaWiki, etc.
+             *
+             * Error messages, particularly for editing pages, may consist of multiple paragraphs of text.
+             * Your user interface should have enough space for that.
+             *
              * For better quality of error messages, it's recommended to use the following options in your
              * API queries:
              *
@@ -394,9 +401,6 @@ declare global {
              * 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();
@@ -789,18 +793,22 @@ declare global {
              * Convenience method for `action=watch`.
              *
              * @since 1.35 - expiry parameter can be passed when Watchlist Expiry is enabled.
+             * @since 1.46 - labels parameter can be passed.
              * @param 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 expiry When the page should expire from the watchlist. If omitted, the
              *  page will not expire.
+             * @param labels Array of integer watchlist label IDs for labels to apply to the watched
+             *  pages. If the page is already watched, this will replace any existing labels.
              * @returns 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
              */
             watch<P extends TypeOrArray<TitleLike>>(
                 pages: P,
-                expiry?: string
+                expiry?: string,
+                labels?: Array<number | string>
             ): Api.AbortablePromise<[ReplaceValue<P, TitleLike, Api.WatchedPage>]>;
 
             /**
diff --git a/mw/ForeignApi.d.ts b/mw/ForeignApi.d.ts
@@ -5,8 +5,7 @@ declare global {
          * an object like {@link mw.Api}, but automatically handle everything required to communicate
          *
          * The foreign wiki must be configured to accept requests from the current wiki.
-         * For details, see {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains $wgCrossSiteAJAXdomains}
-         * and {@link https://www.mediawiki.org/wiki/Manual:$wgRestAllowCrossOriginCookieAuth $wgRestAllowCrossOriginCookieAuth}.
+         * For details, see {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains $wgCrossSiteAJAXdomains}.
          *
          * ```js
          * const api = new mw.ForeignApi( 'https://commons.wikimedia.org/w/api.php' );
diff --git a/mw/ForeignRest.d.ts b/mw/ForeignRest.d.ts
@@ -6,8 +6,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.
-         * For details, see {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains $wgCrossSiteAJAXdomains}
-         * and {@link https://www.mediawiki.org/wiki/Manual:$wgRestAllowCrossOriginCookieAuth $wgRestAllowCrossOriginCookieAuth}.
+         * For details, see {@link https://www.mediawiki.org/wiki/Manual:$wgRestAllowCrossOriginCookieAuth $wgRestAllowCrossOriginCookieAuth}.
          *
          * ```js
          * const api = new mw.ForeignRest( 'https://commons.wikimedia.org/w/rest.php' );
@@ -43,6 +42,17 @@ declare global {
              * @param url URL pointing to another wiki's `rest.php` endpoint.
              * @param foreignActionApi
              * @param options See {@link mw.Rest}.
+             * @param optionsCompat No longer used, kept for compatibility.
+             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignRest.html#ForeignRest
+             */
+            constructor(url: string, options?: ForeignRest.Options);
+            /**
+             * Create an instance of {@link mw.ForeignRest}.
+             *
+             * @param url URL pointing to another wiki's `rest.php` endpoint.
+             * @param foreignActionApi
+             * @param options See {@link mw.Rest}.
+             * @deprecated since 1.46, do not pass `foreignActionApi`.
              * @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/Upload.d.ts b/mw/Upload.d.ts
@@ -10,7 +10,7 @@ declare global {
          * A simple example:
          *
          * ```js
-         * var file = new OO.ui.SelectFileWidget(),
+         * var file = new OO.ui.SelectFileInputWidget(),
          *     button = new OO.ui.ButtonWidget( { label: 'Save' } ),
          *     upload = new mw.Upload;
          *
diff --git a/mw/config.d.ts b/mw/config.d.ts
@@ -65,6 +65,14 @@ declare global {
              */
             debug: boolean | number;
             debugInfo?: DebugInfo;
+            /**
+             * @since 1.46
+             */
+            enableWatchlistLabels?: true;
+            /**
+             * @since 1.46
+             */
+            indefBlockReasonOptions?: BlockReasonOption[];
             partialBlockActionOptions?: Record<`ipb-action-${string}`, string>;
             searchTerm?: string;
             /**
@@ -73,6 +81,18 @@ declare global {
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#skin
              */
             skin: string;
+            /**
+             * @since 1.46
+             */
+            SpecialEditWatchlistUrl?: string;
+            /**
+             * @since 1.46
+             */
+            SpecialWatchlistLabelsTitle?: string;
+            /**
+             * @since 1.46
+             */
+            SpecialWatchlistLabelsUrl?: string;
             specUrl?: string | null;
             StructuredChangeFiltersDisplayConfig?: StructuredChangeFiltersDisplayConfig;
             /**
@@ -81,6 +101,10 @@ declare global {
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#stylepath
              */
             stylepath: string;
+            /**
+             * @since 1.46
+             */
+            watchlistLabels?: WatchlistLabel[];
             /**
              * 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}.
              *
@@ -101,6 +125,10 @@ declare global {
              * @see https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Interface/JavaScript#wgArticlePath
              */
             wgArticlePath: string;
+            /**
+             * @since 1.46
+             */
+            wgAutoCreateTempUserEnabled?: boolean;
             wgBackendResponseTime: number;
             wgBreakFrames: boolean;
             /**
@@ -145,6 +173,10 @@ declare global {
              */
             wgContentNamespaces: number[];
             wgCreateAccountDirty?: true;
+            /**
+             * @since 1.46
+             */
+            wgCreateAccountUsernamePolicyPopoverMsgs?: PopoverMessages;
             /**
              * 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.
              *
@@ -179,6 +211,10 @@ declare global {
                 | "editingsection";
             wgEditRecoveryWasPosted?: boolean;
             wgEditSubmitButtonLabelPublish?: boolean;
+            /**
+             * @since 1.46
+             */
+            wgErrorPageMessageKey?: 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.
              *
@@ -538,6 +574,16 @@ interface DebugInclude {
     size: string;
 }
 
+interface WatchlistLabel {
+    id: number;
+    name: string;
+}
+
+interface PopoverMessages {
+    title: string;
+    bulletsHtml: string;
+}
+
 interface FileWarning {
     module: string;
     messages: FileWarningMessages;
diff --git a/mw/hook.d.ts b/mw/hook.d.ts
@@ -1,3 +1,4 @@
+import { ApiBlockParams } from "types-mediawiki-api";
 import { User } from "./user";
 
 /**
@@ -155,6 +156,22 @@ declare global {
          */
         function hook(name: "htmlform.enhance"): Hook<[document: JQuery]>;
 
+        /**
+         * Create an instance of {@link Hook}.
+         *
+         * @since 1.46
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
+         */
+        function hook(name: "mw.special.block.doBlockParamsReady"): Hook<[params: ApiBlockParams]>;
+
+        /**
+         * Create an instance of {@link Hook}, fired when the `Special:Block` form has been reset to default values.
+         *
+         * @since 1.46
+         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.hook
+         */
+        function hook(name: "mw.special.block.formReset"): Hook<[]>;
+
         /**
          * Create an instance of {@link Hook}, fired after an edit was successfully saved.
          *
diff --git a/mw/message.d.ts b/mw/message.d.ts
@@ -154,14 +154,28 @@ declare global {
             parse(): string;
 
             /**
-             * Parse the message to DOM nodes, rather than HTML string like {@link parse}.
+             * Parse message as wikitext and return a jQuery object.
              *
-             * This method is only available when jqueryMsg is loaded.
+             * If jqueryMsg is loaded, this transforms text and parses a subset of supported wikitext
+             * into a jQuery object. Without jqueryMsg, it is equivalent to {@link text},
+             * wrapped in a text node inside a jQuery object.
              *
-             * @since 1.27
+             * @example
+             * ```js
+             * const msg = mw.message( 'key' );
+             * mw.loader.using(`mediawiki.jqueryMsg`).then(() => {
+             *     if ( msg.isParseable() ) {
+             *         const $node = msg.parseDom();
+             *         $node.appendTo('body');
+             *     }
+             * })
+             * ```
+             * @since 1.27 if `mediawiki.jqueryMsg` is loaded
+             * @since 1.46 in `mediawiki.base`
+             * @returns jQuery object of parsed message.
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.Message.html#parseDom
              */
-            parseDom(): JQuery;
+            parseDom(): JQuery<Text>;
 
             /**
              * Return message plainly.
diff --git a/mw/notification.d.ts b/mw/notification.d.ts
@@ -61,7 +61,6 @@ declare global {
          * @param message
          * @param options The options to use for the notification.
          *  See {@link notification.defaults the defaults}.
-         * @returns Notification object
          * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.html#.notify
          */
         function notify(
@@ -118,7 +117,6 @@ declare global {
              * @param message
              * @param options The options to use for the notification.
              *  Options not specified default to the values in {@link defaults}.
-             * @returns Notification object
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.notify
              */
             function notify(
@@ -146,6 +144,16 @@ declare global {
              * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.notification.html#.NotificationOptions
              */
             interface NotificationOptions {
+                /**
+                 * Optional text to announce to screen readers
+                 * via the aria-live region. Use this for notifications containing form controls
+                 * or widgets to provide a clean text alternative. If not provided, notifications
+                 * with form controls will not be announced automatically.
+                 *
+                 * @since 1.46
+                 */
+                ariaText?: string | null;
+
                 /**
                  * Whether the notification should automatically
                  * be hidden after shown. Or if it should persist.
diff --git a/mw/pluralRuleParser.d.ts b/mw/pluralRuleParser.d.ts
@@ -1,10 +1,17 @@
 declare global {
+    /**
+     * Evaluates a plural rule in CLDR syntax for a number.
+     *
+     * @since 1.46 – moved from mw.libs.
+     * @returns 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;
+
     namespace mw.libs {
         /**
          * Evaluates a plural rule in CLDR syntax for a number.
          *
-         * @param rule
-         * @param number
          * @returns 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/util.d.ts b/mw/util.d.ts

Original file line number	Diff line number	Diff line change
`@@ -51,4 +51,4 @@ let namespaces = mw.config.get("pageTriageNamespaces") as number[];`
`51`	`51`
`52`	`52`	`### MediaWiki API parameters`
`53`	`53`
`54`		`-This package used to provide typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page) till v1.10.1. These have since been moved to a separate package, [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).`
	`54`	`+This package used to provide typings for API request parameters for the [MediaWiki Action API](https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page) till v1.10.1. These have since been moved to a separate package, [types-mediawiki-api](https://github.com/wikimedia-gadgets/types-mediawiki-api).`
Original file line number	Diff line number	Diff line change
`@@ -5,8 +5,7 @@ declare global {`
`5`	`5`	`* an object like {@link mw.Api}, but automatically handle everything required to communicate`
`6`	`6`	`*`
`7`	`7`	`* The foreign wiki must be configured to accept requests from the current wiki.`
`8`		`- * For details, see {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains $wgCrossSiteAJAXdomains}`
`9`		`- * and {@link https://www.mediawiki.org/wiki/Manual:$wgRestAllowCrossOriginCookieAuth $wgRestAllowCrossOriginCookieAuth}.`
	`8`	`+ * For details, see {@link https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:$wgCrossSiteAJAXdomains $wgCrossSiteAJAXdomains}.`
`10`	`9`	`*`
`11`	`10`	* ```js
`12`	`11`	`* const api = new mw.ForeignApi( 'https://commons.wikimedia.org/w/api.php' );`
Original file line number	Diff line number	Diff line change
`@@ -10,7 +10,7 @@ declare global {`
`10`	`10`	`* A simple example:`
`11`	`11`	`*`
`12`	`12`	* ```js
`13`		`- * var file = new OO.ui.SelectFileWidget(),`
	`13`	`+ * var file = new OO.ui.SelectFileInputWidget(),`
`14`	`14`	`* button = new OO.ui.ButtonWidget( { label: 'Save' } ),`
`15`	`15`	`* upload = new mw.Upload;`
`16`	`16`	`*`