/*************************************************************
 *
 *  Copyright (c) 2017-2025 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.
 */

/**
 * @file  The main MathJax global object
 *
 * @author dpvc@mathjax.org (Davide Cervone)
 */

import { VERSION } from './components/version.js';
import { HandlerList } from './core/HandlerList.js';
import { handleRetriesFor, retryAfter } from './util/Retries.js';
import { OptionList } from './util/Options.js';
import { MathDocument } from './core/MathDocument.js';
import { context } from './util/context.js';

/*****************************************************************/
/**
 * The main MathJax global object
 */
export const mathjax = {
  /**
   *  The MathJax version number
   */
  version: VERSION,

  /**
   * The browser context (window and document values)
   */
  context: context,

  /**
   *  The list of registers document handlers
   */
  handlers: new HandlerList<any, any, any>(),

  /**
   * Creates a MathDocument using a registered handler that knows how to handl it
   *
   * @param {any} document        The document to handle
   * @param {OptionList} options   The options to use for the document (e.g., input and output jax)
   * @returns {MathDocument}       The MathDocument to handle the document
   */
  document: function (
    document: any,
    options: OptionList
  ): MathDocument<any, any, any> {
    return mathjax.handlers.document(document, options);
  },

  /**
   * The functions for handling retries if a file must be loaded dynamically
   */
  handleRetriesFor: handleRetriesFor,
  retryAfter: retryAfter,

  /**
   * A function for loading external files (can be changed for node/browser use)
   */
  asyncLoad: null as (file: string) => any,

  /**
   * When asyncLoad uses require(), it actually operates synchronously and this is true
   */
  asyncIsSynchronous: false,
};