add initial marp implementation with sample content and build configuration

node_modules/mathjax-full/ts/core/FindMath.ts

@@ -0,0 +1,90 @@
+/*************************************************************
+ *
+ *  Copyright (c) 2017-2022 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 FindMath objects
+ *
+ * @author dpvc@mathjax.org (Davide Cervone)
+ */
+
+import {userOptions, defaultOptions, OptionList} from '../util/Options.js';
+import {ProtoItem} from './MathItem.js';
+
+/*****************************************************************/
+/**
+ *  The FindMath interface
+ *
+ * @template N  The HTMLElement node class
+ * @template T  The Text node class
+ * @template _D  The Document class
+ */
+export interface FindMath<N, T, _D> {
+  /**
+   * One of two possibilities:  Look through a DOM element,
+   *   or look through an array of strings for delimited math.
+   *
+   * @param {N} node   The node to search for math
+   * @return {ProtoItem<N, T>[]}
+   */
+  findMath(node: N): ProtoItem<N, T>[];
+  /**
+   *
+   * @param {string[]} strings    The strings to search for math
+   * @return {ProtoItem<N, T>[]}
+   */
+  findMath(strings: string[]): ProtoItem<N, T>[];
+}
+
+/*****************************************************************/
+/**
+ *  The FindMath abstract class
+ */
+
+/**
+ * @template N  The HTMLElement node class
+ * @template T  The Text node class
+ * @template D  The Document class
+ */
+export abstract class AbstractFindMath<N, T, D> implements FindMath<N, T, D> {
+
+  /**
+   * The default options for FindMath
+   */
+  public static OPTIONS: OptionList = {};
+
+  /**
+   * The actual options for this instance
+   */
+  protected options: OptionList;
+
+  /**
+   * @param {OptionList} options  The user options for this instance
+   */
+  constructor(options: OptionList) {
+    let CLASS = this.constructor as typeof AbstractFindMath;
+    this.options = userOptions(defaultOptions({}, CLASS.OPTIONS), options);
+  }
+
+  /**
+   * Locate math in an Element or a string array;
+   *
+   * @param {Element | string[]} where  The node or string array to search for math
+   * @return {ProtoItem[]}              The array of proto math items found
+   */
+  public abstract findMath(where: N | string[]): ProtoItem<N, T>[];
+
+}