types-mediawiki-response 1.1.0 → 1.1.1

package/dist/core/query/index.d.ts

@@ -448,6 +448,7 @@ export interface ApiQueryResponse extends ApiEnvelope {
     "query-noncontinue"?: Record<string, Record<string, string | number>>;
 }
 export * from "./shared";
+export * from "./logparams";
 export * from "./info";
 export * from "./categories";
 export * from "./revisions";

package/dist/core/query/logevents.d.ts

@@ -9,6 +9,7 @@
  */
 import type { Flag, NamespaceIndex, Timestamp } from "../../common";
 import type { ApiHiddenFlags } from "./shared";
+import type { ApiLogEventParams } from "./logparams";
 /** One log event. `leprop` controls which fields appear. */
 export interface ApiLogEvent extends ApiHiddenFlags {
     /** Log record id. `leprop=ids`. */
@@ -31,8 +32,11 @@ export interface ApiLogEvent extends ApiHiddenFlags {
     type?: string;
     /** Log action, e.g. `create`, `delete`. `leprop=type`. */
     action?: string;
-    /** Structured log details; shape varies by `type`/`action`. `leprop=details`. */
-    params?: Record<string, unknown>;
+    /**
+     * Structured log details; shape varies by `type`/`action` — see
+     * {@link ApiLogEventParams}. `leprop=details`.
+     */
+    params?: ApiLogEventParams;
     /** Performing user name (or IP). `leprop=user`. */
     user?: string;
     /** Performing user id. `leprop=userid`. */

package/dist/core/query/logparams.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Structured details of log events, shared by `logevents.params`,
+ * `recentchanges.logparams` and `watchlist.logparams`.
+ */
+import type { ContentModel, Expiry, Timestamp } from "../../common";
+/**
+ * Structured log details — the `params` object of a log event (`leprop=details`
+ * on `list=logevents`, `logparams` under the log-info fields of
+ * `list=recentchanges` / `list=watchlist`).
+ *
+ * Each log action writes its own key set, which the server normalizes for the
+ * API. The keys below are the ones MediaWiki core itself writes; which of
+ * them a row carries depends on its `type`/`action`.
+ *
+ * The key space is open: extensions and site configuration can register
+ * further log actions, and rows written by older MediaWiki versions keep
+ * their historical key forms. Unknown keys therefore fall back to `unknown`
+ * instead of erroring. Consumers targeting one specific log action — or a
+ * site-custom one — can add its keys through interface merging:
+ *
+ * @example
+ * declare module "types-mediawiki-response" {
+ *   interface ApiLogEventParams {
+ *     // a site-custom log action, or a legacy key form still in the data
+ *     "4::target"?: string;
+ *   }
+ * }
+ */
+export interface ApiLogEventParams {
+    /**
+     * Block duration as configured: `'infinity'` or the raw specifier
+     * (`'2 weeks'`, …), on `block/block`, `block/reblock`, `suppress/block` and
+     * `suppress/reblock` rows. Older rows without one are normalized to
+     * `'infinity'`.
+     */
+    duration?: string;
+    /**
+     * Options in force on the block. Rows written by very old MediaWiki
+     * versions may carry the legacy values `autoblock` or `angry-autoblock`
+     * instead of the current flag set. An array (`[]` when none).
+     */
+    flags?: Array<"anononly" | "nocreate" | "noautoblock" | "noemail" | "nousertalk" | "hiddenname" | "autoblock" | "angry-autoblock">;
+    /**
+     * Absolute expiry of the block (ISO 8601), on rows with a finite duration.
+     */
+    expiry?: Timestamp;
+    /** Whether the block covers the whole site (`false` for a partial block). */
+    sitewide?: boolean;
+    /** Scope of a partial block; absent for sitewide blocks. */
+    restrictions?: ApiLogBlockRestrictions;
+    /**
+     * Id of the block the row created or changed.
+     *
+     * @since MediaWiki 1.44
+     */
+    blockId?: number;
+    /**
+     * Localized duration text (e.g. `'14 days'`, `'infinite'`), in the
+     * requesting user's language.
+     *
+     * @since MediaWiki 1.44
+     */
+    "duration-l10n"?: string;
+    /** Namespace of the move destination (on `move/move` and `move/move_redir` rows). */
+    target_ns?: number;
+    /** Title of the move destination. */
+    target_title?: string;
+    /** Whether the move left no redirect behind. */
+    suppressredirect?: boolean;
+    /**
+     * Content-language protection summary (e.g. `'[edit=autoconfirmed]
+     * (indefinite)'`), aimed at machine feeds; the structured data lives in
+     * {@link details}.
+     */
+    description?: string;
+    /** Whether cascading protection was requested. */
+    cascade?: boolean;
+    /** Protection restrictions in force. */
+    details?: ApiLogProtectDetail[];
+    /** Namespace of the title the protection moved away from. */
+    oldtitle_ns?: number;
+    /** Title the protection moved away from. */
+    oldtitle_title?: string;
+    /**
+     * How many revisions and archived file versions the undeletion restored
+     * (`delete/restore`), how many revisions an import created
+     * (`import/upload`, `import/interwiki`), or how many uses a managed tag
+     * had (`managetags/activate|deactivate|delete`).
+     */
+    count?: {
+        revisions: number;
+        files: number;
+    } | number;
+    /**
+     * What the visibility change targeted: `'revision'`, `'archive'`,
+     * `'oldimage'` or `'filearchive'` on `…/revision` rows; `'logging'` on
+     * `…/event` rows.
+     */
+    type?: "revision" | "archive" | "oldimage" | "filearchive" | "logging";
+    /**
+     * Ids of the targeted revisions, file versions or log entries — numbers on
+     * current rows, strings on legacy ones.
+     */
+    ids?: Array<number | string>;
+    /** Visibility state before the change. */
+    old?: ApiLogRevDelVisibility;
+    /** Visibility state after the change. */
+    new?: ApiLogRevDelVisibility;
+    /**
+     * Id of the account the row reports (on `newusers/create`, `newusers/create2`
+     * and `newusers/autocreate` rows).
+     */
+    userid?: number;
+    /**
+     * Groups the target user belonged to before the change (on `rights/rights`
+     * and `rights/autopromote` rows).
+     */
+    oldgroups?: string[];
+    /** Groups after the change. */
+    newgroups?: string[];
+    /**
+     * Per-group membership expiry, parallel to {@link oldgroups}; `[]` when the
+     * memberships were all permanent. Absent on `rights/autopromote` rows.
+     */
+    oldmetadata?: ApiLogGroupMetadata[];
+    /**
+     * Per-group membership expiry, parallel to {@link newgroups}; `[]` when
+     * permanent. Absent on `rights/autopromote` rows.
+     */
+    newmetadata?: ApiLogGroupMetadata[];
+    /**
+     * Content model before the change (on `contentmodel/change` and
+     * `contentmodel/new` rows).
+     */
+    oldmodel?: ContentModel;
+    /** Content model after the change. */
+    newmodel?: ContentModel;
+    /** Namespace of the page the history was merged into. */
+    dest_ns?: number;
+    /** Title of the page the history was merged into. */
+    dest_title?: string;
+    /**
+     * Namespace of the page whose history was merged in (`merge/merge-into` row
+     * filed on the destination page).
+     *
+     * @since MediaWiki 1.45
+     */
+    src_ns?: number;
+    /**
+     * Title of the page whose history was merged in (`merge/merge-into`).
+     *
+     * @since MediaWiki 1.45
+     */
+    src_title?: string;
+    /**
+     * Revision the histories were interleaved at (ISO 8601), on `merge/merge`
+     * and `merge/merge-into` rows.
+     */
+    mergepoint?: Timestamp;
+    /**
+     * Boundary revision id the merge stopped at; stored raw, so it appears as
+     * a number or its decimal string.
+     *
+     * @since MediaWiki 1.42
+     */
+    mergerevid?: number | string;
+    /**
+     * Timestamp of the first revision kept out of the merge, when a start
+     * boundary was used (ISO 8601); the id of that revision is
+     * {@link mergestartid}. Only `merge/merge` rows carry it — `merge/merge-into`
+     * rows do not report the start boundary at all.
+     *
+     * @since MediaWiki 1.45
+     */
+    mergestart?: Timestamp;
+    /**
+     * First revision id kept out of the merge; stored raw like
+     * {@link mergerevid}.
+     *
+     * @since MediaWiki 1.45
+     */
+    mergestartid?: number | string;
+    /** Namespace of the source page on the foreign wiki (`import/interwiki`). */
+    interwiki_ns?: number;
+    /** Source page on the foreign wiki, with its interwiki prefix (`import/interwiki`). */
+    interwiki_title?: string;
+    /**
+     * SHA-1 of the uploaded file (base36), on `upload/upload`, `upload/overwrite`
+     * and `upload/revert` rows.
+     */
+    img_sha1?: string;
+    /** File timestamp (ISO 8601), which can differ from the row's timestamp. */
+    img_timestamp?: Timestamp;
+    /** Revision id that was marked patrolled, on `patrol/patrol` rows. */
+    curid?: number;
+    /** Revision id the patrolled one followed. */
+    previd?: number;
+    /** Always `false`: automatic patrols are not logged. */
+    auto?: boolean;
+    /**
+     * Revision the tags were applied to (`tag/update` rows); a raw value from
+     * the tagging caller, so forms vary (a number, its decimal string, or
+     * `false` when the update targeted a log entry).
+     */
+    revid?: number | string | false;
+    /**
+     * Log entry the tags were applied to, on rows that targeted one; a raw
+     * value like {@link revid} — `false` when the update targeted a revision.
+     */
+    logid?: number | string | false;
+    /** Tags the update added. */
+    tagsAdded?: string[];
+    /** How many tags {@link tagsAdded} holds. */
+    tagsAddedCount?: number;
+    /** Tags the update removed. */
+    tagsRemoved?: string[];
+    /** How many tags {@link tagsRemoved} holds. */
+    tagsRemovedCount?: number;
+    /** Tags the target carried before the update. */
+    initialTags?: string[];
+    /** Name of the managed tag (`managetags/create|activate|deactivate|delete`). */
+    tag?: string;
+    /**
+     * Page language before the change, on `pagelang/pagelang` rows; the wiki's
+     * default language carries a `[def]` suffix (e.g. `'en[def]'`).
+     */
+    oldlanguage?: string;
+    /** Page language after the change; also `[def]`-suffixed when set to default. */
+    newlanguage?: string;
+    /**
+     * Any other parameter a log action attaches — a log action registered by an
+     * extension or site configuration, or a legacy key form on rows written by
+     * an older MediaWiki version.
+     */
+    [key: string]: unknown;
+}
+/** One page a partial block is restricted to (`restrictions.pages` entry). */
+export interface ApiLogPageRef {
+    /** Namespace index. */
+    page_ns: number;
+    /** Full page title. */
+    page_title: string;
+}
+/** Scope of a partial block (`restrictions`). */
+export interface ApiLogBlockRestrictions {
+    /** Pages the block is restricted to. */
+    pages?: ApiLogPageRef[];
+    /** Namespace indexes the block is restricted to. */
+    namespaces?: number[];
+    /** Action names the block is restricted to (e.g. `'edit'`). */
+    actions?: string[];
+}
+/** One protection restriction (`details` entry on `protect/protect`, `protect/modify`). */
+export interface ApiLogProtectDetail {
+    /** Action being restricted (e.g. `'edit'`); `'create'` for title protection. */
+    type: string;
+    /** Protection level (e.g. `'autoconfirmed'`, `'sysop'`). */
+    level: string;
+    /** When the protection lapses (ISO 8601), or `'infinite'`. */
+    expiry: Timestamp | "infinite";
+    /** Whether this restriction cascades; absent on `'create'` entries. */
+    cascade?: boolean;
+}
+/** One visibility state (`old`/`new` on a RevisionDelete row). */
+export interface ApiLogRevDelVisibility {
+    /** Raw visibility bitfield. */
+    bitmask: number;
+    /** Whether the content is hidden. */
+    content: boolean;
+    /** Whether the edit summary is hidden. */
+    comment: boolean;
+    /** Whether the performer is hidden. */
+    user: boolean;
+    /** Whether only suppressors can unhide. */
+    restricted: boolean;
+}
+/** One group-membership change with its expiry (`oldmetadata`/`newmetadata` entry). */
+export interface ApiLogGroupMetadata {
+    /** Group name. */
+    group: string;
+    /** When the membership lapses. */
+    expiry: Expiry;
+}

package/dist/core/query/recentchanges.d.ts

@@ -9,6 +9,7 @@
  */
 import type { Flag, NamespaceIndex, Timestamp } from "../../common";
 import type { ApiHiddenFlags } from "./shared";
+import type { ApiLogEventParams } from "./logparams";
 /** Change type (`rctype`). Open union for forward compatibility. */
 export type RecentChangeType = "edit" | "new" | "log" | "categorize" | "external" | (string & {});
 /** One recent-changes entry. `rcprop` controls which fields appear. */
@@ -83,8 +84,11 @@ export interface ApiRecentChange extends ApiHiddenFlags {
     logtype?: string;
     /** Log action, e.g. `create`. `rcprop=loginfo`. */
     logaction?: string;
-    /** Structured log parameters. `rcprop=loginfo`. */
-    logparams?: Record<string, unknown>;
+    /**
+     * Structured log details — see {@link ApiLogEventParams}. `rcprop=loginfo`
+     * (only for `type=log`).
+     */
+    logparams?: ApiLogEventParams;
 }
 declare module "./index" {
     interface ApiQueryResult {

package/dist/core/query/watchlist.d.ts

@@ -13,6 +13,7 @@
 import type { ApiWatchlistLabel, Flag, NamespaceIndex, Timestamp } from "../../common";
 import type { ApiHiddenFlags } from "./shared";
 import type { RecentChangeType } from "./recentchanges";
+import type { ApiLogEventParams } from "./logparams";
 /** One watchlist entry. `wlprop` controls which fields appear. */
 export interface ApiWatchlistEntry extends ApiHiddenFlags {
     /** Change type. */
@@ -33,8 +34,11 @@ export interface ApiWatchlistEntry extends ApiHiddenFlags {
     logtype?: string;
     /** Log action. `wlprop=loginfo` (only for `type=log`). */
     logaction?: string;
-    /** Structured log parameters. `wlprop=loginfo` (only for `type=log`). */
-    logparams?: Record<string, unknown>;
+    /**
+     * Structured log details — see {@link ApiLogEventParams}. `wlprop=loginfo`
+     * (only for `type=log`).
+     */
+    logparams?: ApiLogEventParams;
     /**
      * Localized log action text, e.g. `changed protection settings`.
      * `wlprop=loginfo` (only for `type=log`).

package/dist/extensions/betafeatures.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Opt-in extension pack: **BetaFeatures** (`list=betafeatures`).
+ *
+ * Not in the default export: importing anything from this file — even just the
+ * field-group type you are about to use — activates the augmentation shipped at
+ * the bottom, which merges the field groups into the root package automatically
+ * (no manual `declare module`):
+ *
+ * ```ts
+ * import type {} from 'types-mediawiki-response/ext/betafeatures';
+ * ```
+ *
+ * The result is a flat map keyed by feature id — one entry per feature
+ * registered through `$wgBetaFeatures` or the
+ * `GetBetaFeaturePreferences` hook, so the key set is site-configured and open.
+ * A wiki with no beta features omits the whole `betafeatures` bucket.
+ *
+ * @see https://www.mediawiki.org/wiki/Extension:BetaFeatures
+ */
+/**
+ * One `list=betafeatures` entry: a feature id with its user count.
+ */
+export interface ApiBetaFeature {
+    /** The feature id, e.g. `mw-vector-2022-default-title`. */
+    name: string;
+    /**
+     * Number of users who enabled the feature; `0` unless `bfcounts` was
+     * requested.
+     */
+    count: number;
+}
+declare module "types-mediawiki-response" {
+    interface ApiQueryResult {
+        /**
+         * Beta features registered on this wiki, keyed by feature id
+         * (`list=betafeatures`). Absent when no features are registered.
+         */
+        betafeatures?: Record<string, ApiBetaFeature>;
+    }
+}

package/dist/extensions/centralauth.d.ts

@@ -0,0 +1,328 @@
+/**
+ * Opt-in extension pack: **CentralAuth** (`list=globalallusers`,
+ * `list=globalgroups`, `list=globalusers`, `list=wikisets`,
+ * `action=centralauthtoken`, `action=globaluserrights`,
+ * `action=setglobalaccountstatus`, `action=deleteglobalaccount`,
+ * `action=createlocalaccount`).
+ *
+ * Not in the default export: importing anything from this file — even just the
+ * field-group type you are about to use — activates the augmentation shipped at
+ * the bottom, which merges the field groups into the root package automatically
+ * (no manual `declare module`):
+ *
+ * ```ts
+ * import type {} from 'types-mediawiki-response/ext/centralauth';
+ * ```
+ *
+ * fv2 notes: `list=globalallusers` ids are real numbers, while `list=wikisets`
+ * carries the database id **as a string up to MediaWiki 1.45 and as a number
+ * from 1.46** (its `WikiSet::newFromRow` picked up an `intval()` cast). When a
+ * write action's operation fails — `createlocalaccount`, or the unmerge /
+ * lock-hide step of `deleteglobalaccount` / `setglobalaccountstatus` — the
+ * messages are reported **in band** under the root `error` key as a nested list
+ * of {@link ApiSpecMessage} rows rather than as a standard `ApiErrorResponse`;
+ * `setglobalaccountstatus` still returns its (unchanged) result object alongside
+ * that `error` key. Input validation failures (e.g. an unknown global account)
+ * are ordinary top-level errors.
+ *
+ * @see https://www.mediawiki.org/wiki/Extension:CentralAuth
+ */
+import type { ApiSpecMessage } from "../common";
+import type { Expiry, Timestamp } from "../common";
+import type { ApiEnvelope } from "../envelope";
+/**
+ * One `list=globalallusers` entry. `aguprop` controls which fields beyond
+ * {@link ApiGlobalCentralUser.id} / {@link ApiGlobalCentralUser.name} appear.
+ * Hidden accounts (suppressed from public lists) never appear here at all.
+ */
+export interface ApiGlobalCentralUser {
+    /** Global account id. */
+    id: number;
+    /** Global account name. */
+    name: string;
+    /**
+     * Global groups of the account, `[]` when it is in none. `aguprop=groups`.
+     * Expired group memberships are not included.
+     */
+    groups?: string[];
+    /**
+     * The account is attached to (has a local account on) the requesting wiki;
+     * an empty-string marker (stays `""` under fv2 rather than becoming `true`).
+     * `aguprop=existslocally`.
+     */
+    existslocally?: "";
+    /**
+     * The account is locked globally; an empty-string marker (see
+     * {@link ApiGlobalCentralUser.existslocally}). `aguprop=lockinfo`.
+     */
+    locked?: "";
+}
+/**
+ * One `list=globalgroups` entry: a global group defined on the wiki farm. The
+ * rows derive from the `global_group_permissions` table, so groups are only
+ * listed once they have at least one permission granted.
+ */
+export interface ApiGlobalGroup {
+    /** Global group name, e.g. `global-sysop` (site-configured, not fixed). */
+    name: string;
+    /** Permissions granted to the group. `ggpprop=rights`. */
+    rights?: string[];
+}
+/**
+ * One `list=wikisets` entry: a named wiki set (a list of wikis used for global
+ * group restrictions). The key set is farm-configured.
+ */
+export interface ApiWikiSet {
+    /**
+     * Wiki set id. A string up to MediaWiki 1.45 (fv2 passes the raw `ws_id`
+     * column through), a number from 1.46 once the value is cast to int.
+     */
+    id: string | number;
+    /** Wiki set name. */
+    name: string;
+    /** Whether the set lists included (`optin`) or excluded (`optout`) wikis. */
+    type?: "optin" | "optout";
+    /**
+     * Wikis the set covers (for `optin`) or does not cover (for `optout`), `[]`
+     * when none. Present whenever `wsprop` includes it.
+     */
+    wikisincluded?: string[];
+    /**
+     * The complement of {@link ApiWikiSet.wikisincluded} against all known wikis,
+     * `[]` when none. Present whenever `wsprop` includes it.
+     */
+    wikisnotincluded?: string[];
+}
+/**
+ * Result of `action=globaluserrights` (userrights-token POST): global group
+ * memberships changed for one global account. Mirrors the core
+ * `action=userrights` result shape.
+ */
+export interface ApiGlobalUserRightsResult {
+    /** The affected global account name. */
+    user: string;
+    /** Global account id. */
+    userid: number;
+    /** Groups added by this call (empty when only removing). */
+    added: string[];
+    /** Groups removed by this call (empty when only adding). */
+    removed: string[];
+}
+/** Response of `action=globaluserrights`. Failures are standard top-level errors. */
+export interface ApiGlobalUserRightsResponse extends ApiEnvelope {
+    /** Result of `action=globaluserrights`. */
+    globaluserrights: ApiGlobalUserRightsResult;
+}
+/**
+ * The lock / hide state of a global account, written by
+ * `action=setglobalaccountstatus` on every outcome. The success response
+ * extends it with {@link ApiSetGlobalAccountStatusResult.reason}; a failed call
+ * reports only this state, alongside the in-band root `error` list.
+ */
+export interface ApiSetGlobalAccountStatusState {
+    /** The affected global account name. */
+    user: string;
+    /** Whether the account is locked after the call. */
+    locked: boolean;
+    /**
+     * Suppression level after the call: visible (`""`), hidden from lists, or
+     * fully suppressed.
+     */
+    hidden: "" | "lists" | "suppressed";
+}
+/**
+ * Result object of `action=setglobalaccountstatus` (its own token type POST):
+ * the new lock / hide state of a global account plus the reason echoed back.
+ */
+export interface ApiSetGlobalAccountStatusResult extends ApiSetGlobalAccountStatusState {
+    /** The reason passed to the call; `null` when none was given. */
+    reason: string | null;
+}
+/**
+ * Successful response of `action=setglobalaccountstatus`. A failed lock/hide
+ * returns the unchanged state (without `reason`) plus an in-band root `error`
+ * — see {@link ApiSetGlobalAccountStatusFailedResponse}.
+ */
+export interface ApiSetGlobalAccountStatusResponse extends ApiEnvelope {
+    /** Result of `action=setglobalaccountstatus`. */
+    setglobalaccountstatus: ApiSetGlobalAccountStatusResult;
+}
+/**
+ * In-band failure of `action=setglobalaccountstatus`: the unchanged state object
+ * is returned without `reason`, alongside the root `error` list as a nested
+ * {@link ApiSpecMessage} list rather than a standard `ApiErrorResponse`. Use
+ * `ApiResponseWith` to model either outcome.
+ */
+export interface ApiSetGlobalAccountStatusFailedResponse extends ApiEnvelope {
+    /** The unchanged lock / hide state after the failed call. */
+    setglobalaccountstatus: ApiSetGlobalAccountStatusState;
+    /** In-band failure messages. */
+    error: ApiSpecMessage[][];
+}
+/**
+ * Result of `action=deleteglobalaccount` (its own token type POST): the global
+ * account was unmerged (deleted).
+ */
+export interface ApiDeleteGlobalAccountResult {
+    /** The deleted global account name. */
+    user: string;
+    /** The reason passed to the call; `null` when none was given. */
+    reason: string | null;
+}
+/** Response of `action=deleteglobalaccount`. */
+export interface ApiDeleteGlobalAccountResponse extends ApiEnvelope {
+    /** Result of `action=deleteglobalaccount`. */
+    deleteglobalaccount: ApiDeleteGlobalAccountResult;
+}
+/**
+ * Result of `action=createlocalaccount` (CSRF-token POST, `centralauth-createlocal`
+ * right): a local account was force-created on this wiki for the global account.
+ *
+ * @since MediaWiki 1.36
+ */
+export interface ApiCreateLocalAccountResult {
+    /** The user name a local account was created for. */
+    username: string;
+    /** The reason passed to the call; `null` when none was given. */
+    reason: string | null;
+}
+/**
+ * Response of `action=createlocalaccount`. Unlike `setglobalaccountstatus`, a
+ * failure returns only the root `error` list and no result object.
+ *
+ * @since MediaWiki 1.36
+ */
+export interface ApiCreateLocalAccountResponse extends ApiEnvelope {
+    /** Result of `action=createlocalaccount`. */
+    createlocalaccount: ApiCreateLocalAccountResult;
+}
+/**
+ * Response of `action=centralauthtoken`: a token that authenticates the
+ * current CentralAuth session on another wiki of the farm (sent as the
+ * `centralauthtoken` parameter there). Requires a logged-in user attached to
+ * a global account whose session comes from the CentralAuth session provider;
+ * every other case is a standard top-level error (`notloggedin`, `badsession`,
+ * `notattached`).
+ */
+export interface ApiCentralAuthTokenResponse extends ApiEnvelope {
+    centralauthtoken: {
+        /** The cross-wiki authentication token. */
+        centralauthtoken: string;
+    };
+}
+/**
+ * In-band failure of `action=deleteglobalaccount` / `action=createlocalaccount`:
+ * the messages appear under the root `error` key as a list of per-status
+ * lists — not as a standard {@link ApiErrorResponse} — so `error` carries no
+ * `code`/`info` of its own.
+ */
+export interface ApiCentralAuthInBandErrorResponse extends ApiEnvelope {
+    error: ApiSpecMessage[][];
+}
+/**
+ * One `list=globalusers` entry for an existing global account. `gusprop`
+ * controls which fields beyond {@link ApiGlobalUserFound.centralid} /
+ * {@link ApiGlobalUserFound.name} appear. Results come back in request order;
+ * unknown names/ids get marker rows (see {@link ApiGlobalUserRow}).
+ */
+export interface ApiGlobalUserFound {
+    /** Global account id. */
+    centralid: number;
+    /** Global account name. */
+    name: string;
+    /**
+     * The account is hidden from public lists; a real `true`. Only observable to
+     * requesters with the `centralauth-suppress` right — for everyone else the
+     * row is replaced by a `missing` marker.
+     */
+    hidden?: true;
+    /**
+     * The account is fully suppressed; a real `true`. Same visibility rule as
+     * {@link ApiGlobalUserFound.hidden}.
+     */
+    suppressed?: true;
+    /** Whether the account is locked globally. `gusprop=locked`. */
+    locked?: boolean;
+    /**
+     * Log id of the most recent lock on the account (for a follow-up
+     * `list=logevents` on the central wiki); present only when locked.
+     */
+    locklogid?: number;
+    /** Global edit count. `gusprop=editcount`. */
+    editcount?: number;
+    /** When the global account was created. `gusprop=registration`. */
+    registration?: Timestamp;
+    /**
+     * Attachment status on the requesting wiki. `gusprop=localinfo`;
+     * {@link ApiGlobalUserLocalInfo.localid} /
+     * {@link ApiGlobalUserLocalInfo.timestamp} are only present when attached.
+     */
+    localinfo?: ApiGlobalUserLocalInfo;
+    /** Global groups of the account (active ones only). `gusprop=groups`. */
+    groups?: string[];
+    /**
+     * Global group memberships with expiry. `gusprop=groupmemberships`.
+     */
+    groupmemberships?: ApiGlobalGroupMembership[];
+    /** Permissions derived from the account's global groups. `gusprop=rights`. */
+    rights?: string[];
+}
+/** The `localinfo` object of a `list=globalusers` row. */
+export interface ApiGlobalUserLocalInfo {
+    /** The account has a local account on the requesting wiki. */
+    attached: boolean;
+    /** Local user id; `null` when recorded without one. Only when attached. */
+    localid?: number | null;
+    /** When the local account was attached. Only when attached. */
+    timestamp?: Timestamp | null;
+}
+/** One global group membership of a `list=globalusers` row. */
+export interface ApiGlobalGroupMembership {
+    /** Global group name. */
+    group: string;
+    /** Membership expiry, or `infinity`. */
+    expiry: Expiry;
+}
+/** A `list=globalusers` row for a requested name with no global account. */
+export interface ApiGlobalUserMissingName {
+    /** The requested name, echoed back. */
+    name: string;
+    /** Marker: no global account under this name. */
+    missing: true;
+}
+/** A `list=globalusers` row for a requested name that is not a valid username. */
+export interface ApiGlobalUserInvalidName {
+    /** The requested name, echoed back as given. */
+    name: string;
+    /** Marker: not a valid username. */
+    invalid: true;
+}
+/** A `list=globalusers` row for a requested global id with no global account. */
+export interface ApiGlobalUserMissingId {
+    /** The requested global id, echoed back. */
+    centralid: number;
+    /** Marker: no global account with this id. */
+    missing: true;
+}
+/**
+ * One `list=globalusers` row: either a found account
+ * ({@link ApiGlobalUserFound}) or a marker for a name/id that is unknown
+ * (`missing`), syntactically invalid (`invalid`), or hidden from the requester
+ * (`missing` again — hidden accounts are reported as absent).
+ */
+export type ApiGlobalUserRow = ApiGlobalUserFound | ApiGlobalUserMissingName | ApiGlobalUserInvalidName | ApiGlobalUserMissingId;
+declare module "types-mediawiki-response" {
+    interface ApiQueryResult {
+        /** All global accounts of the farm, name-ordered (`list=globalallusers`). */
+        globalallusers?: ApiGlobalCentralUser[];
+        /** Global groups defined on the farm (`list=globalgroups`). */
+        globalgroups?: ApiGlobalGroup[];
+        /** Per-name/per-id global account lookup (`list=globalusers`).
+         *
+         * @since MediaWiki 1.47
+         */
+        globalusers?: ApiGlobalUserRow[];
+        /** Wiki sets defined on the farm (`list=wikisets`). */
+        wikisets?: ApiWikiSet[];
+    }
+}

package/dist/extensions/checkuser.d.ts

@@ -1,5 +1,6 @@
 /**
- * Opt-in extension pack: **CheckUser** (`list=checkuser`, `list=checkuserlog`).
+ * Opt-in extension pack: **CheckUser** (`list=checkuser`, `list=checkuserlog`,
+ * `meta=checkuserformattedblockinfo`).
  *
  * Not in the default export: importing anything from this file — even just the
  * field-group type you are about to use — activates the augmentation shipped at
@@ -139,11 +140,28 @@ export interface ApiQueryCheckUserLogResult {
     /** Log entries, ordered per `culdir` (default newest first). */
     entries?: ApiCheckUserLogEntry[];
 }
+/**
+ * The `checkuserformattedblockinfo` object: the sitewide-block status of the
+ * requesting user, for clients that need to explain API failures caused by
+ * their own block.
+ *
+ * @since MediaWiki 1.44
+ */
+export interface ApiQueryCheckUserFormattedBlockInfoResult {
+    /**
+     * Rendered (HTML) block message explaining the sitewide block; `null` when
+     * the requesting user is not sitewide-blocked. Partial blocks and blocks on
+     * other users do not appear here.
+     */
+    details: string | null;
+}
 declare module "types-mediawiki-response" {
     interface ApiQueryResult {
         /** Result of the requested `curequest` mode (`list=checkuser`). */
         checkuser?: ApiQueryCheckUserResult;
         /** Entries from the CheckUser log (`list=checkuserlog`). */
         checkuserlog?: ApiQueryCheckUserLogResult;
+        /** Block status of the requesting user (`meta=checkuserformattedblockinfo`). */
+        checkuserformattedblockinfo?: ApiQueryCheckUserFormattedBlockInfoResult;
     }
 }

package/dist/extensions/translate.d.ts

@@ -0,0 +1,524 @@
+/**
+ * Opt-in extension pack: **Translate** (`meta=messagegroups`,
+ * `meta=messagegroupstats`, `meta=languagestats`, `meta=messagetranslations`,
+ * `list=messagecollection`, `action=translationstats`,
+ * `action=translationaids`, `action=ttmserver`, `action=markfortranslation`,
+ * `action=translationreview`, `action=groupreview`, `action=aggregategroups`,
+ * `action=translationentitysearch`, `action=translatesandbox`,
+ * `action=translationstash`, `action=messagegroupsubscription`,
+ * `action=searchtranslations`).
+ *
+ * Not in the default export: importing anything from this file — even just the
+ * field-group type you are about to use — activates the augmentation shipped at
+ * the bottom, which merges the field groups into the root package automatically
+ * (no manual `declare module`):
+ *
+ * ```ts
+ * import type {} from 'types-mediawiki-response/ext/translate';
+ * ```
+ *
+ * fv2 notes: `messagegroupstats` / `languagestats` continue with an
+ * `mgsoffset` / `lsoffset` cursor (a group/language id, not a number), and
+ * `messagetranslations` / `messagecollection` paginate with a numeric `mtoffset`
+ * / string `mcoffset`; all are covered by the core `ApiQueryContinue` index
+ * signature. The `workflowstates` / `prioritylangs` payloads use `false` (not
+ * `null`) as their "not configured" marker.
+ * Out of scope here: `action=managemessagegroups` and
+ * `action=managegroupsynchronizationcache`, whose success shapes only occur
+ * within the group-synchronization (changeset) workflow of file-based groups.
+ *
+ * @see https://www.mediawiki.org/wiki/Extension:Translate
+ */
+import type { ApiEnvelope } from "../envelope";
+/**
+ * One `meta=messagegroups` entry. `mgprop` controls which fields appear. The
+ * groups themselves are site-defined (wiki pages, YAML files, aggregate
+ * definitions), so ids beyond the dynamic `!recent` / `!additions` ones are
+ * open-ended.
+ */ export interface ApiTranslateMessageGroup {
+    /** Group id, e.g. `page-Example`, `!recent`. `mgprop=id`. */
+    id?: string;
+    /** Localized group label. `mgprop=label`. */
+    label?: string;
+    /** Localized group description. `mgprop=description`. */
+    description?: string;
+    /** PHP class backing the group, e.g. `WikiPageMessageGroup`. `mgprop=class`. */
+    class?: string;
+    /**
+     * Namespace the group's messages live in, e.g. `1198` (the Translations
+     * namespace) for page groups; `false` for groups without a namespace (the
+     * dynamic `!recent` / `!additions` ones). `mgprop=namespace`.
+     */
+    namespace?: number | false;
+    /** Whether the group currently exists (real `boolean`). `mgprop=exists`. */
+    exists?: boolean;
+    /**
+     * Icon URLs keyed by size. `mgprop=icon`; absent for groups without an icon.
+     */
+    icon?: Record<string, unknown>;
+    /**
+     * Translation priority. Beyond the core `default`, values are site-defined
+     * (set through the group's priority metadata).
+     */
+    priority?: "default" | (string & {});
+    /**
+     * Priority languages of the group, or `false` when unset.
+     * `mgprop=prioritylangs`.
+     */
+    prioritylangs?: string[] | false;
+    /**
+     * Whether translation to non-priority languages is prevented.
+     * `mgprop=priorityforce`.
+     */
+    priorityforce?: boolean;
+    /**
+     * Workflow states of the group keyed by state id, or `false` when the group
+     * has none. `mgprop=workflowstates`.
+     */
+    workflowstates?: Record<string, ApiTranslateWorkflowState> | false;
+    /** Source language of the group's messages. `mgprop=sourcelanguage`. */
+    sourcelanguage?: string;
+    /**
+     * Whether the current user is subscribed to group updates. `mgprop=subscription`;
+     * absent when group subscription is disabled or unavailable to the user.
+     */
+    subscription?: boolean;
+    /**
+     * Number of nested groups folded into this entry (`mgformat=tree` with
+     * `mgdepth` reached).
+     */
+    groupcount?: number;
+    /** Child groups (`mgformat=tree` above the depth cutoff). */
+    groups?: ApiTranslateMessageGroup[];
+}
+/** One workflow state of a message group (`meta=messagegroups` + `mgprop=workflowstates`). */
+export interface ApiTranslateWorkflowState {
+    /** Localized state name. */
+    name: string;
+    /** The requesting user may set this state. */
+    canchange?: 1;
+    /** Site-defined state configuration, passed through. */
+    [key: string]: unknown;
+}
+/**
+ * The four completeness counters shared by `meta=languagestats` and
+ * `meta=messagegroupstats` rows. A row appears only once its statistics are
+ * available; while they are still being computed the result is a continue
+ * instead.
+ */
+export interface ApiTranslateStatsRow {
+    /** Total number of messages. */
+    total: number;
+    /** Number of translated (non-fuzzy) messages. */
+    translated: number;
+    /** Number of out-of-date (fuzzy) translations. */
+    fuzzy: number;
+    /** Number of proofread translations. */
+    proofread: number;
+}
+/**
+ * One `meta=languagestats` row: completeness of one message group in the
+ * requested language.
+ */
+export interface ApiLanguageStatsRow extends ApiTranslateStatsRow {
+    /** Message group id the row counts. */
+    group: string;
+}
+/**
+ * One `meta=messagegroupstats` row: completeness of one language in the
+ * requested group.
+ */
+export interface ApiMessageGroupStatsRow extends ApiTranslateStatsRow {
+    /**
+     * Language code of the row. Kept for backwards compatibility; newer clients
+     * should read {@link ApiMessageGroupStatsRow.language}.
+     *
+     * @deprecated Superseded by `language`.
+     */
+    code: string;
+    /** Language code of the row. */
+    language: string;
+}
+/**
+ * One `meta=messagetranslations` row: one existing translation of a message
+ * (the title named in `mttitle`).
+ */
+export interface ApiMessageTranslation {
+    /** Title of the translation subpage, e.g. `Translations:Example/1/de`. */
+    title: string;
+    /** Language code of the translation. */
+    language: string;
+    /** Name of the last translator. */
+    lasttranslator: string;
+    /** The translation text (fuzzy marker stripped). */
+    translation: string;
+    /** The translation is marked out-of-date (fuzzy); a literal marker. */
+    fuzzy?: "fuzzy";
+}
+/**
+ * One `list=messagecollection` row: a message of the group named in `mcgroup`
+ * for the language named in `mclanguage`. `mcprop` controls which fields
+ * beyond the mandatory ones appear.
+ */
+export interface ApiMessageCollectionRow {
+    /** Message key, e.g. `Example/1`. */
+    key: string;
+    /** Title of the translation subpage for this message and language. */
+    title: string;
+    /** Language the collection was requested for (`mclanguage`). */
+    targetLanguage: string;
+    /** Id of the group the message belongs to. */
+    primaryGroup?: string;
+    /** Source-language definition. `mcprop=definition`. */
+    definition?: string;
+    /**
+     * Translation in the requested language; `null` when the message is
+     * untranslated. `mcprop=translation`.
+     */
+    translation?: string | null;
+    /** Change tags of the translation, `[]` when untagged. `mcprop=tags`. */
+    tags?: string[];
+    /**
+     * Per-message metadata (e.g. `status`, `last-translator-text`,
+     * `last-translator-id`, `revision`) keyed by property name; values may be
+     * `null` for untranslated messages. `mcprop=properties`.
+     */
+    properties?: Record<string, string | null>;
+    /** Revision of the translated unit. `mcprop=revision`.
+     *
+     * @deprecated Superseded by `properties.revision`; removed in MediaWiki 1.44.
+     */
+    revision?: number | string;
+}
+/**
+ * The `query.metadata` block `list=messagecollection` writes alongside its
+ * rows, describing the requested slice of the collection.
+ */
+export interface ApiMessageCollectionMetadata {
+    /**
+     * Review workflow state of the group for the requested language; `null` when
+     * the group has no workflow states configured.
+     */
+    state: string | null;
+    /** Number of messages matching the requested filters. */
+    resultsize: number;
+    /** Rows after this slice, i.e. `resultsize` minus the rows returned. */
+    remaining: number;
+}
+/**
+ * Payload of one translation aid of `action=translationaids`, keyed by aid
+ * type (the registry is hook-extensible, so the set is open). An aid that
+ * cannot run reports {@link ApiTranslationAid.error} instead of its data.
+ */
+export interface ApiTranslationAid {
+    /** Language of {@link ApiTranslationAid.value}, when language-bound. */
+    language?: string;
+    /** The aid's payload, when it is a text value. */
+    value?: string | null;
+    /** Whether the translation is marked out-of-date (fuzzy). */
+    fuzzy?: boolean;
+    /** Rendered reason why this aid is unavailable. */
+    error?: string;
+    [key: string]: unknown;
+}
+/**
+ * The `helpers` map of `action=translationaids`. Members are the aid types of
+ * the {@link https://www.mediawiki.org/wiki/Manual:Hooks/TranslationAids |
+ * TranslationAids registry} — the built-in ones are declared here for
+ * autocomplete, the index signature keeps hook-registered aids usable.
+ */
+export interface ApiTranslationAidsPayload {
+    /** Source-language definition of the message. */
+    definition?: ApiTranslationAid;
+    /** The current translation in the target language. */
+    translation?: ApiTranslationAid;
+    /** `{{Documentation}}` subpage content; `error` when docs are disabled. */
+    documentation?: ApiTranslationAid;
+    /** Existing translations in other languages; a list. */
+    inotherlanguages?: unknown[];
+    /** Diff of the definition since the translation was made. */
+    definitiondiff?: ApiTranslationAid;
+    /** Edit summaries of the definition page. */
+    editsummaries?: ApiTranslationAid;
+    /** Gettext metadata for gettext-defined messages. */
+    gettext?: ApiTranslationAid;
+    /** Insertable wikitext snippets (customizable via hooks). */
+    insertables?: ApiTranslationAid;
+    /** Machine-translation suggestions, when a service is configured. */
+    mt?: ApiTranslationAid;
+    /** Human translation support (e.g. TTMServer suggestions). */
+    support?: ApiTranslationAid;
+    [key: string]: ApiTranslationAid | unknown[] | undefined;
+}
+/** Response of `action=translationaids` (root-level `helpers` and `times`). */
+export interface ApiTranslationAidsResponse extends ApiEnvelope {
+    /** Requested aids keyed by aid type. */
+    helpers?: ApiTranslationAidsPayload;
+    /** Wall-clock seconds spent per aid (plus `query_aggregator`). */
+    times?: Record<string, number>;
+}
+/** Response of `action=translationstats`: graph data for the requested series. */
+export interface ApiTranslationStatsResponse extends ApiEnvelope {
+    translationstats: {
+        /** One label per series, e.g. `Example @ Deutsch (de)`. */
+        labels: string[];
+        /** Per-day (per scale unit) values, one entry per series. */
+        data: Record<string, number[]>;
+    };
+}
+/**
+ * One suggestion of `action=ttmserver`: a translation-memory hit for the
+ * requested text. The fields are supplied by the configured translation-memory
+ * service; a unit from the local memory carries the fields below.
+ */
+export interface ApiTtmServerSuggestion {
+    /** Source text of the stored translation unit. */
+    source: string;
+    /** Translation text of the stored unit. */
+    target: string;
+    /** Message key of the stored unit, e.g. `Translations:Example/1`. */
+    context: string;
+    /** Canonical URL of the translation page the unit came from. */
+    location: string;
+    /** Match quality as a ratio between 0 and 1 (1 is a perfect match). */
+    quality: number;
+}
+/** Response of `action=ttmserver`. */
+export interface ApiTtmServerResponse extends ApiEnvelope {
+    /** Suggestions, best match first; `[]` when the memory has no hit. */
+    ttmserver: ApiTtmServerSuggestion[];
+}
+/**
+ * Result of `action=markfortranslation` (pagetranslation-token POST,
+ * `pagetranslation` right): a wiki page was marked for translation, creating
+ * its translation units and the `page-<title>` message group.
+ */
+export interface ApiMarkForTranslationResult {
+    /** Fixed `Success` marker; failures are standard top-level errors. */
+    result: "Success";
+    /** Whether this was the first time the page was marked. */
+    firstmark: boolean;
+    /** Number of translation units created (including the page title). */
+    unitcount: number;
+}
+/** Response of `action=markfortranslation`. */
+export interface ApiMarkForTranslationResponse extends ApiEnvelope {
+    /** Result of `action=markfortranslation`. */
+    markfortranslation: ApiMarkForTranslationResult;
+}
+/**
+ * Result of `action=translationreview` (CSRF-token POST,
+ * `translate-messagereview` right): one translation revision was marked as
+ * reviewed. Reviewing one's own translation, fuzzy translations and already
+ * reviewed revisions are errors / warnings.
+ */
+export interface ApiTranslationReviewResponse extends ApiEnvelope {
+    translationreview: {
+        /** Result of `action=translationreview`. */
+        review: {
+            /** Title of the reviewed translation, e.g. `Translations:Page/1/de`. */
+            title: string;
+            /** Page id of the translation subpage. */
+            pageid: number;
+            /** Reviewed revision id. */
+            revision: number;
+        };
+    };
+}
+/**
+ * Response of `action=groupreview` (CSRF-token POST, `translate-groupreview`
+ * right): the workflow state of one message group for one language was set.
+ * Requires `$wgTranslateWorkflowStates` on the wiki; the state names are
+ * site-configured.
+ */
+export interface ApiGroupReviewResponse extends ApiEnvelope {
+    groupreview: {
+        /** Result of `action=groupreview`. */
+        review: {
+            /** Message group id the state was set for. */
+            group: string;
+            /** Language code the state was set for. */
+            language: string;
+            /** The new workflow state, as configured on the wiki. */
+            state: string;
+        };
+    };
+}
+/**
+ * Result of `action=aggregategroups` (CSRF-token POST, `translate-manage`
+ * right). The fields depend on the requested `do`: creating returns the new
+ * group id and the aggregate-able groups, associating returns the target page
+ * URL, dissociating and removing return only the marker.
+ */
+export interface ApiAggregateGroupsResult {
+    /** Fixed `ok` marker; failures are standard top-level errors. */
+    result: "ok";
+    /**
+     * Groups that can be added to the new aggregate group, keyed by group id
+     * with their labels as values. Returned by `do=add`.
+     */
+    groups?: Record<string, string>;
+    /** Id of the created aggregate group. Returned by `do=add`. */
+    aggregategroupId?: string;
+    /** Full URL of the associated group's translation page. `do=associate`. */
+    groupUrl?: string;
+}
+/** Response of `action=aggregategroups`. */
+export interface ApiAggregateGroupsResponse extends ApiEnvelope {
+    /** Result of `action=aggregategroups`. */
+    aggregategroups: ApiAggregateGroupsResult;
+}
+/**
+ * Result of `action=translationentitysearch`: message group and message key
+ * prefixes matching the query. Keys are absent when the entity type was not
+ * requested or nothing matched.
+ */
+export interface ApiTranslationEntitySearchResult {
+    /** Matching message groups, best match first. */
+    groups?: ApiTranslationEntitySearchGroup[];
+    /**
+     * Matching message key prefixes; several messages under one prefix are
+     * collapsed into a `*` wildcard pattern with a match count.
+     */
+    messages?: ApiTranslationEntitySearchMessage[];
+}
+/** One message group match of `action=translationentitysearch`. */
+export interface ApiTranslationEntitySearchGroup {
+    /** Localized group label. */
+    label: string;
+    /** Message group id. */
+    group: string;
+}
+/** One message prefix match of `action=translationentitysearch`. */
+export interface ApiTranslationEntitySearchMessage {
+    /** Message key prefix; `*` marks a wildcard. */
+    pattern: string;
+    /** Number of messages matching the pattern. */
+    count: number;
+}
+/** Response of `action=translationentitysearch`. */
+export interface ApiTranslationEntitySearchResponse extends ApiEnvelope {
+    /** Result of `action=translationentitysearch`. */
+    translationentitysearch: ApiTranslationEntitySearchResult;
+}
+/**
+ * Response of `action=translatesandbox` with `do=create` (registers a sandboxed
+ * translator; requires `$wgTranslateUseSandbox`). The `delete` / `promote` /
+ * `remind` variants return no payload — an empty {@link ApiEnvelope}.
+ */
+export interface ApiTranslateSandboxCreateResponse extends ApiEnvelope {
+    translatesandbox: {
+        /** The registered sandbox user. */
+        user: {
+            /** User name of the sandbox user. */
+            name: string;
+            /** User id of the sandbox user. */
+            id: number;
+        };
+    };
+}
+/**
+ * Response of `action=translatesandbox` with `do=delete` / `do=promote` /
+ * `do=remind`: the users were processed, no payload keys are returned.
+ */
+export interface ApiTranslateSandboxActionResponse extends ApiEnvelope {
+}
+/** One stashed translation of `action=translationstash` `subaction=query`. */
+export interface ApiStashedTranslation {
+    /** Title the stashed translation belongs to, e.g. `Translations:Page/2/nl`. */
+    title: string;
+    /** Source-language definition; `""` when the message handle is unknown. */
+    definition: string;
+    /** The stashed translation text. */
+    translation: string;
+    /** Current translation in the target language, `null` when untranslated. */
+    comparison: string | null;
+    /** Arbitrary metadata passed when stashing (an empty map decodes to `[]`). */
+    metadata: unknown;
+}
+/**
+ * Response of `action=translationstash` (CSRF-token POST): `subaction=add`
+ * returns only the marker, `subaction=query` additionally lists the stashed
+ * translations of the requesting (sandbox) user.
+ */
+export interface ApiTranslationStashResponse extends ApiEnvelope {
+    translationstash: {
+        /** Stashed translations, oldest first. Only with `subaction=query`. */
+        translations?: ApiStashedTranslation[];
+        /** Fixed `ok` marker; failures are standard top-level errors. */
+        result: "ok";
+    };
+}
+/**
+ * Response of `action=messagegroupsubscription` (CSRF-token POST): the
+ * requesting user's subscription to the group was changed. Requires
+ * `$wgTranslateEnableMessageGroupSubscription`.
+ */
+export interface ApiMessageGroupSubscriptionResponse extends ApiEnvelope {
+    messagegroupsubscription: {
+        /** Fixed `1` success marker; failures are standard top-level errors. */
+        success: 1;
+        /** The group whose subscription changed. */
+        group: {
+            /** Message group id. */
+            id: string;
+            /** Localized group label. */
+            label: string;
+        };
+    };
+}
+/**
+ * One `action=searchtranslations` match: a document of the translation memory.
+ * The fields are fixed by the search index; the result may replace `content`
+ * with a highlighted snippet.
+ */
+export interface ApiSearchTranslationsDocument {
+    /** Wiki id the indexed translation belongs to. */
+    wiki: string;
+    /** Canonical URL of the translation page. */
+    uri: string;
+    /** Base title of the translation unit, e.g. `Example`. */
+    localid: string;
+    /** Language code of the indexed translation. */
+    language: string;
+    /** Message group ids the unit belongs to. */
+    group: string[];
+    /** The indexed text (translation or definition), possibly highlighted. */
+    content: string;
+}
+/**
+ * Response of `action=searchtranslations`: full-text search over the
+ * translation memories. Only wikis backed by a searchable translation-memory
+ * service return hits; the response carries them with a metadata block under
+ * the root `search` key.
+ */
+export interface ApiSearchTranslationsResponse extends ApiEnvelope {
+    search: {
+        /** Hit metadata. */
+        metadata: {
+            /** Total number of hits. */
+            total: number;
+        };
+        /** Hits, best match first; `[]` when nothing matched. */
+        translations: ApiSearchTranslationsDocument[];
+    };
+}
+declare module "types-mediawiki-response" {
+    interface ApiQueryResult {
+        /** Message groups of this wiki (`meta=messagegroups`). */
+        messagegroups?: ApiTranslateMessageGroup[];
+        /** Per-language completeness of one group (`meta=messagegroupstats`). */
+        messagegroupstats?: ApiMessageGroupStatsRow[];
+        /** Per-group completeness of one language (`meta=languagestats`). */
+        languagestats?: ApiLanguageStatsRow[];
+        /** Existing translations of one message (`meta=messagetranslations`). */
+        messagetranslations?: ApiMessageTranslation[];
+        /**
+         * Workflow/report metadata of the message collection slice
+         * (`list=messagecollection`).
+         */
+        metadata?: ApiMessageCollectionMetadata;
+        /** Messages of one group and language (`list=messagecollection`). */
+        messagecollection?: ApiMessageCollectionRow[];
+    }
+}

package/dist/extensions/uls.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Opt-in extension pack: **Universal Language Selector** (`ulssetlang`,
+ * `ulslocalization`).
+ *
+ * Not in the default export: importing anything from this file — even just a
+ * response type — is all that is needed; both modules return standalone action
+ * payloads, so no declaration merging is involved:
+ *
+ * ```ts
+ * import type {
+ *   ApiUlsLocalizationResponse,
+ *   ApiUlsSetLanguageResponse,
+ * } from 'types-mediawiki-response/ext/uls';
+ * ```
+ *
+ * `action=languagesearch` used to be the third ULS module; it now ships with
+ * core as `ApiLanguageSearchResponse` in the core package.
+ *
+ * @see https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector
+ */
+import type { ApiEnvelope } from "../envelope";
+/**
+ * Response of `action=ulssetlang` (CSRF-token POST): stores the interface
+ * language in the named user's preferences. A success response carries no
+ * payload keys. Anonymous callers only succeed when `$wgULSAnonCanChangeLanguage`
+ * is enabled (then only a cookie is set, likewise with no payload).
+ */
+export interface ApiUlsSetLanguageResponse extends ApiEnvelope {
+}
+/**
+ * Metadata block of a ULS localization bundle, carried over from the source
+ * i18n files. Only the keys the wiki's ULS files actually use appear.
+ */
+export interface ApiUlsLocalizationMetadata {
+    /** translators: credited in the source file. */
+    authors?: string[];
+    /** Message documentation language code, typically `qqq`. */
+    "message-documentation"?: string;
+}
+/**
+ * Response of `action=ulslocalization`: the ULS message bundle for one language
+ * (its fallback chain merged in), returned raw as JSON — there is no envelope and
+ * no `ulslocalization` wrapper. Keys are ULS message ids (e.g.
+ * `uls-region-WW`) mapped to their translation; `@metadata` holds the source
+ * file credits. The module is internal to ULS; responses are cached publicly
+ * for 28 days.
+ */
+export interface ApiUlsLocalizationResponse {
+    /** Credits and provenance of the merged source files. */
+    "@metadata"?: ApiUlsLocalizationMetadata;
+    [key: string]: string | ApiUlsLocalizationMetadata | undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "types-mediawiki-response",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "TypeScript type definitions for MediaWiki Action API responses",
   "keywords": [
     "action-api",