Skip to content

AnYiEE/types-mediawiki-renovate

 
 

Repository files navigation

NPM version PRs Welcome

types-mediawiki-renovate

TypeScript definitions for MediaWiki JS interface.

This package covers the functions and classes in the mw global object, as well some jQuery plugins used in MediaWiki core. All commonly used parts of the interface are covered.

Download stats

Usage

To use types from this package, run

pnpm add -D @types/jquery @types/oojs-ui types-mediawiki-renovate

Edit your project's tsconfig.json file so that it includes

"include": [
  "node_modules/types-mediawiki-renovate"
]

You should be all set! mw will be available in the global scope. There is no need to put any import statements in the TypeScript source files.

If you find any errors or have suggestions for more specific typings, please open a PR or file an issue.

mw.config

Types for mw.config are included:

let NS = mw.config.get('wgNamespaceNumber'); // NS gets type number
let pageName = mw.config.get('wgPageName'); // pageName gets type string

mw.config entries added by MediaWiki extensions can also be used but their type is not known, so they need to be declare:

interface MediaWikiConfigMap {
	pageTriageNamespaces: number[];
}
let namespaces = mw.config.get('pageTriageNamespaces');

or explicitly cast:

let namespaces = mw.config.get('pageTriageNamespaces') as number[];

(mw.config.get("pageTriageNamespaces") gets the type unknown without using the interface merging or a cast.)

The optional values ​​of the return value of mw.config.get("wgAction") can also be extended through MediaWikiConfigMapWgAction like MediaWikiConfigMap.

MediaWiki API parameters

This package also provides typings for API request parameters for the MediaWiki Action API. 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:

import type {ApiEditPageParams, ApiParseParams} from 'types-mediawiki/api_params';

Since it is just a type import, it doesn't generate any JavaScript. Hence, such imports can also be used in non-modular applications.

TODO

  • Add doc comments for mw.ForeignStructuredUpload, mw.GallerySlideshow, mw.special.ApiSandbox and mw.jqueryMsg private methods.

About

TypeScript definitions for MediaWiki JS interface

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • JavaScript 99.0%
  • TypeScript 1.0%