declare global {
    namespace mw {
        /**
         * Interact with the API of another MediaWiki site. mw.Foreign API creates
         * 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}.
         *
         * ```js
         * const api = new mw.ForeignApi( 'https://commons.wikimedia.org/w/api.php' );
         * api.get( {
         *     action: 'query',
         *     meta: 'userinfo'
         * } ).done( function ( data ) {
         *     console.log( data );
         * } );
         * ```
         *
         * To ensure that the user at the foreign wiki is logged in, pass the `assert: 'user'` parameter
         * to {@link ForeignApi.get get()}/{@link ForeignApi.post 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:
         *
         * ```js
         * function MyForeignApi() {};
         * OO.inheritClass( MyForeignApi, mw.ForeignApi );
         * mw.ForeignApi = MyForeignApi;
         * ```
         *
         * @since 1.26
         * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignApi.html
         */
        class ForeignApi extends Api {
            static static: {};
            static super: typeof Api;
            /** @deprecated Use `super` instead */
            static parent: typeof Api;

            /**
             * Create an instance of {@link mw.ForeignApi}.
             *
             * @param url URL pointing to another wiki's `api.php` endpoint.
             * @param options Also accepts all the options from {@link mw.Api.Options}.
             * @see https://doc.wikimedia.org/mediawiki-core/master/js/mw.ForeignApi.html#ForeignApi
             */
            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).
             */
            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;
            }
        }
    }
}

export {};