// Type definitions for cotalk 1.5
// Project: https://codeberg.org/cotalk/cotalk
// Definitions by: Chen Junda<https://github.com/viccrubs>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
import { FlipMoveProps } from "react-flip-move";

/*~ If this module is a UMD module that exposes a global variable 'myLib' when
 *~ loaded outside a module loader environment, declare that global here.
 *~ Otherwise, delete this declaration.
 */

export as namespace Cotalk;

export default Cotalk;

/*~ You can declare types that are available via importing the module */
declare class Cotalk {
    /**
     * Construct a Cotalk instance.
     * @param options Cotalk options
     */
    constructor(options: Cotalk.CotalkOptions);

    /**
     * Init render and mount plugin.
     * @param element the element or the selector to the element.
     */
    render(element: string | HTMLElement): void;
}

declare namespace Cotalk {
    interface CotalkOptions {
        /**
         * Codeberg Application Client ID.
         */
        clientID: string;

        /**
         * Codeberg Application Client Secret.
         */
        clientSecret: string;

        /**
         * Name of Codeberg repository.
         */
        repo: string;

        /**
         * Codeberg repository owner.
         * Can be personal user or organization.
         */
        owner: string;

        /**
         * Codeberg repository owner and collaborators.
         * (Users who having write access to this repository)
         */
        admin: string[];

        /**
         * The unique id of the page.
         * Length must less than 50.
         *
         * @default location.href
         */
        id?: string;

        /**
         * The issue ID of the page.
         * If the number attribute is not defined, issue will be located using id.
         *
         * @default -1
         */
        number?: number;

        /**
         * Codeberg issue labels.
         *
         * @default ['Cotalk']
         */
        labels?: string[];

        /**
         * Codeberg issue title.
         *
         * @default document.title
         */
        title?: string;

        /**
         * Codeberg issue body.
         *
         * @default location.href + header.meta[description]
         */
        body?: string;

        /**
         * Localization language key.
         * en, zh-CN and zh-TW are currently available.
         *
         * @default navigator.language || navigator.userLanguage
         */
        language?: string;

        /**
         * Pagination size, with maximum 100.
         *
         * @default 10
         */
        perPage?: number;

        /**
         * Facebook-like distraction free mode.
         *
         * @default false
         */
        distractionFreeMode?: boolean;

        /**
         * Comment sorting direction.
         * Available values are last and first.
         *
         * @default "last"
         */
        pagerDirection?: "last" | "first";

        /**
         * By default, Cotalk will create a corresponding codeberg issue for your every single page automatically when the logined user is belong to the admin users.
         * You can create it manually by setting this option to true.
         *
         * @default false
         */
        createIssueManually?: boolean;

        /**
         * Codeberg oauth request reverse proxy for CORS.
         *
         * @default "https://cors-anywhere.azm.workers.dev/https://codeberg.org/login/oauth/access_token"
         */
        proxy?: string;

        /**
         * Comment list animation.
         *
         * [Reference](https://github.com/joshwcomeau/react-flip-move/blob/master/documentation/enter_leave_animations.md)
         *
         * Default value:
         * ```js
         * {
         *  staggerDelayBy: 150,
         *  appearAnimation: 'accordionVertical',
         *  enterAnimation: 'accordionVertical',
         *  leaveAnimation: 'accordionVertical',
         * }
         * ```
         */
        flipMoveOptions?: FlipMoveProps;

        /**
         * Enable hot key (cmd|ctrl + enter) submit comment.
         *
         * @default true
         */
        enableHotKey?: boolean;
    }

}