// @ts-ignore
import { createApp } from "vue";

declare module "vue" {
    /**
     * Wrapper around {@link https://vuejs.org/api/application.html#createapp Vue.createApp} that
     * adds the {@link module:vue#$i18n i18n plugin} and the error handler. These were added
     * globally in Vue 2, but Vue 3 does not support global plugins.
     *
     * To ensure all Vue code has the i18n plugin and the error handler installed, use of
     * `vue.createMwApp()` is recommended anywhere one would normally use `Vue.createApp()`.
     *
     * @since 1.38
     * @returns Vue app instance
     * @see {@link https://doc.wikimedia.org/mediawiki-core/master/js/module-vue.html#.createMwApp}
     */
    export const createMwApp: typeof createApp;

    interface ComponentCustomProperties {
        /**
         * Adds an `$i18n()` instance method that can be used in all components. This method is a
         * proxy to {@link mw.message}.
         *
         * Usage:
         * ```
         * <p>{{ $i18n( 'my-message-key', param1, param2 ) }}</p>
         * ```
         * or
         * ```
         * <p>{{ $i18n( 'my-message-key' ).params( [ param1, param2 ] ) }}</p>
         * ```
         *
         * Note that this method only works for messages that return text. For messages that
         * need to be parsed to HTML, use the `v-i18n-html` directive.
         *
         * @param key Key of message to get
         * @param parameters Values for $N replacements
         * @see {@link https://doc.wikimedia.org/mediawiki-core/master/js/module-vue.html#$i18n}
         */
        $i18n: (key: string, ...parameters: any[]) => mw.Message;
    }
}