import { App, LocaleConfig, PluginFunction } from 'vuepress/core';

interface LocaleRedirectConfig {
    /**
     * Whether enable locales redirection
     *
     * 是否启用语言重定向
     *
     * @default false
     */
    autoLocale: boolean;
    /**
     * Whether switch locales
     *
     * 是否启用重定向语言
     *
     * @default false
     */
    switchLocale: "direct" | "modal" | false;
    /**
     * Locale language config
     *
     * 多语言语言配置
     */
    localeConfig: Record<string, string[]>;
    /**
     * Whether fallback to other locales user defined
     *
     * 是否回退到用户定义的其他语言
     *
     * @default true
     */
    localeFallback: boolean;
    /**
     * Behavior when a locale version is not available for current link
     *
     * @description `"homepage"` and `"404"` is only available when a locale is assigned to current language
     *
     * 当前链接没有可用的语言版本时的行为
     *
     * @description 只有当语言分配给当前语言时，`"homepage"` 和 `"404"` 才可用
     *
     * @default "defaultLocale"
     */
    defaultBehavior: "defaultLocale" | "homepage" | "404";
    /**
     * Default locale path
     *
     * @description the first locale will be used if absent
     *
     * 默认语言路径
     *
     * @description 如果缺失，则使用第一个语言
     */
    defaultLocale: string;
}

interface RedirectLocaleData {
    /**
     * Language name
     */
    name: string;
    /**
     * Switch hint
     *
     * 切换提示
     */
    hint: string;
    /**
     * Switch button text
     */
    switch: string;
    /**
     * Cancel button text
     *
     * 取消按钮文字
     */
    cancel: string;
}

interface RedirectOptions extends Partial<Omit<LocaleRedirectConfig, "localeConfig">> {
    /**
     * Redirect mapping
     *
     * @description if the link starts with `/` then, hostname and base will be added in front of it.
     *
     * 重定向映射
     *
     * @description 如果链接以 `/` 开头，则会在前面添加 hostname 和 base
     */
    config?: Record<string, string> | ((app: App) => Record<string, string>);
    /**
     * domain which to be redirected to
     *
     * 重定向到的网站域名
     */
    hostname?: string;
    /**
     * Locale language config
     *
     * 多语言语言配置
     */
    localeConfig?: Record<string, string | string[]>;
    /**
     * Locales config
     *
     * @see [default config](https://github.com/vuepress-theme-hope/vuepress-theme-hope/blob/main/packages/redirect/src/node/locales.ts)
     *
     * 多语言选项
     *
     * @see [默认配置](https://github.com/vuepress-theme-hope/vuepress-theme-hope/blob/main/packages/redirect/src/node/locales.ts)
     */
    locales?: LocaleConfig<RedirectLocaleData>;
}

declare const redirectPlugin: (options?: RedirectOptions, legacy?: boolean) => PluginFunction;

interface RedirectPluginFrontmatterOption {
    redirectFrom?: string | string[];
    redirectTo?: string;
}

export { type RedirectOptions, type RedirectPluginFrontmatterOption, redirectPlugin };