/*************************************************************
 *
 *  Copyright (c) 2017 The MathJax Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

/**
 * @fileoverview  Interfaces and abstract classes for Handler objects
 *
 * @author dpvc@mathjax.org (Davide Cervone)
 */

import {MathDocument, AbstractMathDocument, MathDocumentConstructor} from './MathDocument.js';
import {OptionList} from '../util/Options.js';
import {DOMAdaptor} from '../core/DOMAdaptor.js';

/*****************************************************************/
/**
 *  The Handler interface
 *
 * @template N  The HTMLElement node class
 * @template T  The Text node class
 * @template D  The Document class
 */
export interface Handler<N, T, D> {
    /**
     * The name of the handler class
     */
    name: string;

    /**
     * The DOM Adaptor to use for managing HTML elements
     */
    adaptor: DOMAdaptor<N, T, D>;

    /**
     * The priority for the handler when handlers are polled
     *   to see which one can process a given document.
     */
    priority: number;

    /**
     * The class implementing the MathDocument for this handler
     *   (so it can be subclassed by extensions as needed)
     */
    documentClass: MathDocumentConstructor<AbstractMathDocument<N, T, D>>;

    /**
     * Checks to see if the handler can process a given document
     *
     * @param {any} document  The document to be processed (string, window, etc.)
     * @return {boolean}      True if this handler can process the given document
     */
    handlesDocument(document: any): boolean;

    /**
     * Creates a MathDocument for the given handler
     *
     * @param {any} document        The document to be handled
     * @param {OptionList} options  The options for the handling of the document
     * @return {MathDocument}       The MathDocument object that manages the processing
     */
    create(document: any, options: OptionList): MathDocument<N, T, D>;
}

/*****************************************************************/
/**
 *  The default MathDocument class (subclasses use their own)
 *
 * @template N  The HTMLElement node class
 * @template T  The Text node class
 * @template D  The Document class
 */
class DefaultMathDocument<N, T, D> extends AbstractMathDocument<N, T, D> {}

/*****************************************************************/
/**
 *  The Handler interface
 *
 * @template N  The HTMLElement node class
 * @template T  The Text node class
 * @template D  The Document class
 */
export abstract class AbstractHandler<N, T, D> implements Handler<N, T, D> {

    /**
     * The name of this class
     */
    public static NAME: string = 'generic';

    /**
     * The DOM Adaptor to use for managing HTML elements
     */
    public adaptor: DOMAdaptor<N, T, D>;

    /**
     * The priority for this handler
     */
    public priority: number;

    /**
     * The class implementing the MathDocument for this handler
     *   (so it can be subclassed by extensions as needed)
     */
    public documentClass: MathDocumentConstructor<AbstractMathDocument<N, T, D>> = DefaultMathDocument;

    /**
     * @param {number} priority  The priority to use for this handler
     *
     * @constructor
     */
    constructor(adaptor: DOMAdaptor<N, T, D>, priority: number = 5) {
        this.adaptor = adaptor;
        this.priority = priority;
    }

    /**
     * @return {string}  The name of this handler class
     */
    public get name() {
        return (this.constructor as typeof AbstractHandler).NAME;
    }

    /**
     * @override
     */
    public handlesDocument(document: any) {
        return false;
    }

    /**
     * @override
     */
    public create(document: any, options: OptionList) {
        return new this.documentClass(document, this.adaptor, options) as MathDocument<N, T, D>;
    }

}