axyseo 2.0.0-alpha.0.0.37 → 2.0.0-alpha.0.0.39

package/build/parse/structure/Node.js

@@ -0,0 +1,69 @@
+import { findAllInTree, innerText } from "../traverse";
+import SourceCodeLocation from "./SourceCodeLocation";
+import { isEmpty } from "lodash";
+
+/**
+ * A node in the tree.
+ */
+class Node {
+  /**
+   * Creates a new node.
+   *
+   * @param {string} 			name 					The node's name or tag.
+   * @param {Object} 			attributes 				This node's attributes.
+   * @param {(Node|Text)[]} 	childNodes 				This node's child nodes.
+   * @param {Object} 			sourceCodeLocationInfo 	This node's location in the source code, from parse5.
+   */
+  constructor(name, attributes = {}, childNodes = [], sourceCodeLocationInfo = {}) {
+    /**
+     * This node's name or tag.
+     * @type {string}
+     */
+    this.name = name;
+
+    /**
+     * This node's attributes.
+     * @type {Object}
+     */
+    this.attributes = attributes;
+
+    /**
+     * This node's child nodes.
+     * @type {(Node|Text)[]}
+     */
+    this.childNodes = childNodes;
+
+    // Don't add the source code location when unavailable.
+    if (!isEmpty(sourceCodeLocationInfo)) {
+      /**
+       * The location of this node inside the HTML.
+       * @type {SourceCodeLocation}
+       */
+      this.sourceCodeLocation = new SourceCodeLocation(sourceCodeLocationInfo);
+    }
+  }
+
+  /**
+   * Finds all nodes in the tree that satisfies the given condition.
+   *
+   * @param {function} 	condition 					The condition that a node should satisfy to end up in the list.
+   * @param {boolean} 	recurseFoundNodes=false 	Whether to recurse into found nodes to see if the condition
+   *  also applies to sub-nodes of the found node.
+   *
+   * @returns {(Node|Text|Paragraph|Heading)[]} The list of nodes that satisfy the condition.
+   */
+  findAll(condition, recurseFoundNodes = false) {
+    return findAllInTree(this, condition, recurseFoundNodes);
+  }
+
+  /**
+   * Returns the inner text (text without any markup) from this node.
+   *
+   * @returns {string} The inner text from this node.
+   */
+  innerText() {
+    return innerText(this);
+  }
+}
+export default Node;
+//# sourceMappingURL=Node.js.map

package/build/parse/structure/Node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.js","names":["findAllInTree","innerText","SourceCodeLocation","isEmpty","Node","constructor","name","attributes","childNodes","sourceCodeLocationInfo","sourceCodeLocation","findAll","condition","recurseFoundNodes"],"sources":["../../../src/parse/structure/Node.js"],"sourcesContent":["import { findAllInTree, innerText } from \"../traverse\";\nimport SourceCodeLocation from \"./SourceCodeLocation\";\nimport { isEmpty } from \"lodash\";\n\n/**\n * A node in the tree.\n */\nclass Node {\n\t/**\n\t * Creates a new node.\n\t *\n\t * @param {string} \t\t\tname \t\t\t\t\tThe node's name or tag.\n\t * @param {Object} \t\t\tattributes \t\t\t\tThis node's attributes.\n\t * @param {(Node|Text)[]} \tchildNodes \t\t\t\tThis node's child nodes.\n\t * @param {Object} \t\t\tsourceCodeLocationInfo \tThis node's location in the source code, from parse5.\n\t */\n\tconstructor( name, attributes = {}, childNodes = [], sourceCodeLocationInfo = {} ) {\n\t\t/**\n\t\t * This node's name or tag.\n\t\t * @type {string}\n\t\t */\n\t\tthis.name = name;\n\n\t\t/**\n\t\t * This node's attributes.\n\t\t * @type {Object}\n\t\t */\n\t\tthis.attributes = attributes;\n\n\t\t/**\n\t\t * This node's child nodes.\n\t\t * @type {(Node|Text)[]}\n\t\t */\n\t\tthis.childNodes = childNodes;\n\n\t\t// Don't add the source code location when unavailable.\n\t\tif ( ! isEmpty( sourceCodeLocationInfo ) ) {\n\t\t\t/**\n\t\t\t * The location of this node inside the HTML.\n\t\t\t * @type {SourceCodeLocation}\n\t\t\t */\n\t\t\tthis.sourceCodeLocation = new SourceCodeLocation( sourceCodeLocationInfo );\n\t\t}\n\t}\n\n\t/**\n\t * Finds all nodes in the tree that satisfies the given condition.\n\t *\n\t * @param {function} \tcondition \t\t\t\t\tThe condition that a node should satisfy to end up in the list.\n\t * @param {boolean} \trecurseFoundNodes=false \tWhether to recurse into found nodes to see if the condition\n\t *  also applies to sub-nodes of the found node.\n\t *\n\t * @returns {(Node|Text|Paragraph|Heading)[]} The list of nodes that satisfy the condition.\n\t */\n\tfindAll( condition, recurseFoundNodes = false ) {\n\t\treturn findAllInTree( this, condition, recurseFoundNodes );\n\t}\n\n\t/**\n\t * Returns the inner text (text without any markup) from this node.\n\t *\n\t * @returns {string} The inner text from this node.\n\t */\n\tinnerText() {\n\t\treturn innerText( this );\n\t}\n}\n\nexport default Node;\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,SAAS;AACjC,OAAOC,kBAAkB;AACzB,SAASC,OAAO,QAAQ,QAAQ;;AAEhC;AACA;AACA;AACA,MAAMC,IAAI,CAAC;EACV;AACD;AACA;AACA;AACA;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,IAAI,EAAEC,UAAU,GAAG,CAAC,CAAC,EAAEC,UAAU,GAAG,EAAE,EAAEC,sBAAsB,GAAG,CAAC,CAAC,EAAG;IAClF;AACF;AACA;AACA;IACE,IAAI,CAACH,IAAI,GAAGA,IAAI;;IAEhB;AACF;AACA;AACA;IACE,IAAI,CAACC,UAAU,GAAGA,UAAU;;IAE5B;AACF;AACA;AACA;IACE,IAAI,CAACC,UAAU,GAAGA,UAAU;;IAE5B;IACA,IAAK,CAAEL,OAAO,CAAEM,sBAAuB,CAAC,EAAG;MAC1C;AACH;AACA;AACA;MACG,IAAI,CAACC,kBAAkB,GAAG,IAAIR,kBAAkB,CAAEO,sBAAuB,CAAC;IAC3E;EACD;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCE,OAAOA,CAAEC,SAAS,EAAEC,iBAAiB,GAAG,KAAK,EAAG;IAC/C,OAAOb,aAAa,CAAE,IAAI,EAAEY,SAAS,EAAEC,iBAAkB,CAAC;EAC3D;;EAEA;AACD;AACA;AACA;AACA;EACCZ,SAASA,CAAA,EAAG;IACX,OAAOA,SAAS,CAAE,IAAK,CAAC;EACzB;AACD;AAEA,eAAeG,IAAI","ignoreList":[]}

package/build/parse/structure/Paragraph.js

@@ -0,0 +1,47 @@
+import Node from "./Node";
+
+/**
+ * A paragraph in the tree.
+ *
+ * @see https://html.spec.whatwg.org/dev/dom.html#paragraphs
+ */
+class Paragraph extends Node {
+  /**
+   * Creates a new paragraph.
+   *
+   * @param {Object} attributes The paragraph's attributes.
+   * @param {(Node|Text)[]} childNodes This paragraph's child nodes.
+   * @param {Object} sourceCodeLocationInfo This paragraph's location in the source code, from parse5.
+   * @param {boolean} isImplicit Whether this paragraph is an implicit paragraph, or an explicit paragraph.
+   * @param {boolean} isOverarching Whether this paragraph is overarching text that is separated by double line breaks.
+   */
+  constructor(attributes = {}, childNodes = [], sourceCodeLocationInfo = {}, isImplicit = false, isOverarching = false) {
+    // We rename any overarching `<p>` element to not match it as a stand-alone paragraph downstream.
+    const name = isOverarching ? "p-overarching" : "p";
+    super(name, attributes, childNodes, sourceCodeLocationInfo);
+    /**
+     * Whether this paragraph is explicit (defined by an explicit `<p>` tag within the markup),
+     * or implicit (defined by a run of phrasing content).
+     *
+     * @see https://html.spec.whatwg.org/dev/dom.html#paragraphs
+     *
+     * @type {boolean}
+     */
+    this.isImplicit = isImplicit;
+  }
+
+  /**
+   * Creates and returns a new implicit paragraph.
+   *
+   * @param {Object} attributes The paragraph's attributes.
+   * @param {(Node|Text)[]} childNodes This paragraph's child nodes.
+   * @param {Object} sourceCodeLocationInfo This paragraph's location in the source code, from parse5.
+   *
+   * @returns {Paragraph} A new implicit paragraph.
+   */
+  static createImplicit(attributes = {}, childNodes = [], sourceCodeLocationInfo = {}) {
+    return new Paragraph(attributes, childNodes, sourceCodeLocationInfo, true);
+  }
+}
+export default Paragraph;
+//# sourceMappingURL=Paragraph.js.map

package/build/parse/structure/Paragraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paragraph.js","names":["Node","Paragraph","constructor","attributes","childNodes","sourceCodeLocationInfo","isImplicit","isOverarching","name","createImplicit"],"sources":["../../../src/parse/structure/Paragraph.js"],"sourcesContent":["import Node from \"./Node\";\n\n/**\n * A paragraph in the tree.\n *\n * @see https://html.spec.whatwg.org/dev/dom.html#paragraphs\n */\nclass Paragraph extends Node {\n\t/**\n\t * Creates a new paragraph.\n\t *\n\t * @param {Object} attributes The paragraph's attributes.\n\t * @param {(Node|Text)[]} childNodes This paragraph's child nodes.\n\t * @param {Object} sourceCodeLocationInfo This paragraph's location in the source code, from parse5.\n\t * @param {boolean} isImplicit Whether this paragraph is an implicit paragraph, or an explicit paragraph.\n\t * @param {boolean} isOverarching Whether this paragraph is overarching text that is separated by double line breaks.\n\t */\n\tconstructor( attributes = {}, childNodes = [], sourceCodeLocationInfo = {},\n\t\tisImplicit = false, isOverarching = false ) {\n\t\t// We rename any overarching `<p>` element to not match it as a stand-alone paragraph downstream.\n\t\tconst name = isOverarching ? \"p-overarching\" : \"p\";\n\t\tsuper( name, attributes, childNodes, sourceCodeLocationInfo );\n\t\t/**\n\t\t * Whether this paragraph is explicit (defined by an explicit `<p>` tag within the markup),\n\t\t * or implicit (defined by a run of phrasing content).\n\t\t *\n\t\t * @see https://html.spec.whatwg.org/dev/dom.html#paragraphs\n\t\t *\n\t\t * @type {boolean}\n\t\t */\n\t\tthis.isImplicit = isImplicit;\n\t}\n\n\t/**\n\t * Creates and returns a new implicit paragraph.\n\t *\n\t * @param {Object} attributes The paragraph's attributes.\n\t * @param {(Node|Text)[]} childNodes This paragraph's child nodes.\n\t * @param {Object} sourceCodeLocationInfo This paragraph's location in the source code, from parse5.\n\t *\n\t * @returns {Paragraph} A new implicit paragraph.\n\t */\n\tstatic createImplicit( attributes = {}, childNodes = [], sourceCodeLocationInfo = {} ) {\n\t\treturn new Paragraph( attributes, childNodes, sourceCodeLocationInfo, true );\n\t}\n}\n\nexport default Paragraph;\n"],"mappings":"AAAA,OAAOA,IAAI;;AAEX;AACA;AACA;AACA;AACA;AACA,MAAMC,SAAS,SAASD,IAAI,CAAC;EAC5B;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCE,WAAWA,CAAEC,UAAU,GAAG,CAAC,CAAC,EAAEC,UAAU,GAAG,EAAE,EAAEC,sBAAsB,GAAG,CAAC,CAAC,EACzEC,UAAU,GAAG,KAAK,EAAEC,aAAa,GAAG,KAAK,EAAG;IAC5C;IACA,MAAMC,IAAI,GAAGD,aAAa,GAAG,eAAe,GAAG,GAAG;IAClD,KAAK,CAAEC,IAAI,EAAEL,UAAU,EAAEC,UAAU,EAAEC,sBAAuB,CAAC;IAC7D;AACF;AACA;AACA;AACA;AACA;AACA;AACA;IACE,IAAI,CAACC,UAAU,GAAGA,UAAU;EAC7B;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACC,OAAOG,cAAcA,CAAEN,UAAU,GAAG,CAAC,CAAC,EAAEC,UAAU,GAAG,EAAE,EAAEC,sBAAsB,GAAG,CAAC,CAAC,EAAG;IACtF,OAAO,IAAIJ,SAAS,CAAEE,UAAU,EAAEC,UAAU,EAAEC,sBAAsB,EAAE,IAAK,CAAC;EAC7E;AACD;AAEA,eAAeJ,SAAS","ignoreList":[]}

package/build/parse/structure/Sentence.js

@@ -0,0 +1,30 @@
+/**
+ * A sentence within a text.
+ */
+class Sentence {
+  /**
+   * Creates a sentence.
+   *
+   * @param {string} text The sentence's text.
+   */
+  constructor(text) {
+    /**
+     * The text in this sentence.
+     *
+     * @type {string}
+     */
+    this.text = text;
+    /**
+     * The tokens in this sentence.
+     * @type {Token[]}
+     */
+    this.tokens = [];
+    /**
+     * The start and end positions of the sentence in the source code.
+     * @type {SourceCodeRange}
+     */
+    this.sourceCodeRange = {};
+  }
+}
+export default Sentence;
+//# sourceMappingURL=Sentence.js.map

package/build/parse/structure/Sentence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sentence.js","names":["Sentence","constructor","text","tokens","sourceCodeRange"],"sources":["../../../src/parse/structure/Sentence.js"],"sourcesContent":["/**\n * A sentence within a text.\n */\nclass Sentence {\n\t/**\n\t * Creates a sentence.\n\t *\n\t * @param {string} text The sentence's text.\n\t */\n\tconstructor( text ) {\n\t\t/**\n\t\t * The text in this sentence.\n\t\t *\n\t\t * @type {string}\n\t\t */\n\t\tthis.text = text;\n\t\t/**\n\t\t * The tokens in this sentence.\n\t\t * @type {Token[]}\n\t\t */\n\t\tthis.tokens = [];\n\t\t/**\n\t\t * The start and end positions of the sentence in the source code.\n\t\t * @type {SourceCodeRange}\n\t\t */\n\t\tthis.sourceCodeRange = {};\n\t}\n}\n\nexport default Sentence;\n"],"mappings":"AAAA;AACA;AACA;AACA,MAAMA,QAAQ,CAAC;EACd;AACD;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,IAAI,EAAG;IACnB;AACF;AACA;AACA;AACA;IACE,IAAI,CAACA,IAAI,GAAGA,IAAI;IAChB;AACF;AACA;AACA;IACE,IAAI,CAACC,MAAM,GAAG,EAAE;IAChB;AACF;AACA;AACA;IACE,IAAI,CAACC,eAAe,GAAG,CAAC,CAAC;EAC1B;AACD;AAEA,eAAeJ,QAAQ","ignoreList":[]}

package/build/parse/structure/SourceCodeLocation.js

@@ -0,0 +1,40 @@
+/**
+ * Represents a range in the source code.
+ *
+ * @typedef {Object} SourceCodeRange
+ * @property {number} startOffset The start position of the range.
+ * @property {number} endOffset The end position of the range.
+ */
+
+/**
+ * Represents a location of a node in the HTML tree.
+ *
+ * @extends SourceCodeRange
+ * @property {SourceCodeRange?} startTag The location of the start tag of the element, if it has one.
+ * @property {SourceCodeRange?} endTag The location of the end tag of the element, if it has one.
+ */
+class SourceCodeLocation {
+  /**
+   * Creates a new SourceCodeLocation.
+   *
+   * @param {Object} sourceCodeLocationInfo This node's location in the source code, from parse5.
+   */
+  constructor(sourceCodeLocationInfo) {
+    if (sourceCodeLocationInfo.startTag) {
+      this.startTag = {
+        startOffset: sourceCodeLocationInfo.startTag.startOffset,
+        endOffset: sourceCodeLocationInfo.startTag.endOffset
+      };
+    }
+    if (sourceCodeLocationInfo.endTag) {
+      this.endTag = {
+        startOffset: sourceCodeLocationInfo.endTag.startOffset,
+        endOffset: sourceCodeLocationInfo.endTag.endOffset
+      };
+    }
+    this.startOffset = sourceCodeLocationInfo.startOffset;
+    this.endOffset = sourceCodeLocationInfo.endOffset;
+  }
+}
+export default SourceCodeLocation;
+//# sourceMappingURL=SourceCodeLocation.js.map

package/build/parse/structure/SourceCodeLocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceCodeLocation.js","names":["SourceCodeLocation","constructor","sourceCodeLocationInfo","startTag","startOffset","endOffset","endTag"],"sources":["../../../src/parse/structure/SourceCodeLocation.js"],"sourcesContent":["/**\n * Represents a range in the source code.\n *\n * @typedef {Object} SourceCodeRange\n * @property {number} startOffset The start position of the range.\n * @property {number} endOffset The end position of the range.\n */\n\n/**\n * Represents a location of a node in the HTML tree.\n *\n * @extends SourceCodeRange\n * @property {SourceCodeRange?} startTag The location of the start tag of the element, if it has one.\n * @property {SourceCodeRange?} endTag The location of the end tag of the element, if it has one.\n */\nclass SourceCodeLocation {\n\t/**\n\t * Creates a new SourceCodeLocation.\n\t *\n\t * @param {Object} sourceCodeLocationInfo This node's location in the source code, from parse5.\n\t */\n\tconstructor( sourceCodeLocationInfo ) {\n\t\tif ( sourceCodeLocationInfo.startTag ) {\n\t\t\tthis.startTag = {\n\t\t\t\tstartOffset: sourceCodeLocationInfo.startTag.startOffset,\n\t\t\t\tendOffset: sourceCodeLocationInfo.startTag.endOffset,\n\t\t\t};\n\t\t}\n\t\tif ( sourceCodeLocationInfo.endTag ) {\n\t\t\tthis.endTag = {\n\t\t\t\tstartOffset: sourceCodeLocationInfo.endTag.startOffset,\n\t\t\t\tendOffset: sourceCodeLocationInfo.endTag.endOffset,\n\t\t\t};\n\t\t}\n\n\t\tthis.startOffset = sourceCodeLocationInfo.startOffset;\n\t\tthis.endOffset = sourceCodeLocationInfo.endOffset;\n\t}\n}\n\nexport default SourceCodeLocation;\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMA,kBAAkB,CAAC;EACxB;AACD;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,sBAAsB,EAAG;IACrC,IAAKA,sBAAsB,CAACC,QAAQ,EAAG;MACtC,IAAI,CAACA,QAAQ,GAAG;QACfC,WAAW,EAAEF,sBAAsB,CAACC,QAAQ,CAACC,WAAW;QACxDC,SAAS,EAAEH,sBAAsB,CAACC,QAAQ,CAACE;MAC5C,CAAC;IACF;IACA,IAAKH,sBAAsB,CAACI,MAAM,EAAG;MACpC,IAAI,CAACA,MAAM,GAAG;QACbF,WAAW,EAAEF,sBAAsB,CAACI,MAAM,CAACF,WAAW;QACtDC,SAAS,EAAEH,sBAAsB,CAACI,MAAM,CAACD;MAC1C,CAAC;IACF;IAEA,IAAI,CAACD,WAAW,GAAGF,sBAAsB,CAACE,WAAW;IACrD,IAAI,CAACC,SAAS,GAAGH,sBAAsB,CAACG,SAAS;EAClD;AACD;AAEA,eAAeL,kBAAkB","ignoreList":[]}

package/build/parse/structure/Text.js

@@ -0,0 +1,26 @@
+import SourceCodeLocation from "./SourceCodeLocation";
+/**
+ * A text.
+ */
+class Text {
+  /**
+   * Creates a new Text object, that consist of some text and a source code range.
+   *
+   * @param {object} textNode The current #text node in the parse5 tree.
+   */
+  constructor(textNode) {
+    this.name = "#text";
+    /**
+     * This text's content.
+     *
+     * @type {string}
+     */
+    this.value = textNode.value;
+    this.sourceCodeRange = new SourceCodeLocation({
+      startOffset: textNode.sourceCodeLocation.startOffset,
+      endOffset: textNode.sourceCodeLocation.endOffset
+    });
+  }
+}
+export default Text;
+//# sourceMappingURL=Text.js.map

package/build/parse/structure/Text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.js","names":["SourceCodeLocation","Text","constructor","textNode","name","value","sourceCodeRange","startOffset","sourceCodeLocation","endOffset"],"sources":["../../../src/parse/structure/Text.js"],"sourcesContent":["import SourceCodeLocation from \"./SourceCodeLocation\";\n/**\n * A text.\n */\nclass Text {\n\t/**\n\t * Creates a new Text object, that consist of some text and a source code range.\n\t *\n\t * @param {object} textNode The current #text node in the parse5 tree.\n\t */\n\tconstructor( textNode ) {\n\t\tthis.name = \"#text\";\n\t\t/**\n\t\t * This text's content.\n\t\t *\n\t\t * @type {string}\n\t\t */\n\t\tthis.value = textNode.value;\n\n\t\tthis.sourceCodeRange = new SourceCodeLocation( {\n\t\t\tstartOffset: textNode.sourceCodeLocation.startOffset,\n\t\t\tendOffset: textNode.sourceCodeLocation.endOffset,\n\t\t} );\n\t}\n}\n\nexport default Text;\n"],"mappings":"AAAA,OAAOA,kBAAkB;AACzB;AACA;AACA;AACA,MAAMC,IAAI,CAAC;EACV;AACD;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,QAAQ,EAAG;IACvB,IAAI,CAACC,IAAI,GAAG,OAAO;IACnB;AACF;AACA;AACA;AACA;IACE,IAAI,CAACC,KAAK,GAAGF,QAAQ,CAACE,KAAK;IAE3B,IAAI,CAACC,eAAe,GAAG,IAAIN,kBAAkB,CAAE;MAC9CO,WAAW,EAAEJ,QAAQ,CAACK,kBAAkB,CAACD,WAAW;MACpDE,SAAS,EAAEN,QAAQ,CAACK,kBAAkB,CAACC;IACxC,CAAE,CAAC;EACJ;AACD;AAEA,eAAeR,IAAI","ignoreList":[]}

package/build/parse/structure/Token.js

@@ -0,0 +1,24 @@
+import { normalizeSingle } from "../../languageProcessing";
+
+/**
+ * A token representing a word, whitespace or punctuation in the sentence.
+ */
+class Token {
+  /**
+   * Creates a new token.
+   *
+   * @param {string} text The token's text.
+   * @param {SourceCodeRange} sourceCodeRange The start and end positions of the token in the source code.
+   */
+  constructor(text, sourceCodeRange = {}) {
+    // Normalize single quotes so that tokens can be matched with strings regardless of single quote type.
+    this.text = normalizeSingle(text);
+    /**
+     * The start and end positions of the token in the source code.
+     * @type {SourceCodeRange}
+     */
+    this.sourceCodeRange = sourceCodeRange;
+  }
+}
+export default Token;
+//# sourceMappingURL=Token.js.map

package/build/parse/structure/Token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Token.js","names":["normalizeSingle","Token","constructor","text","sourceCodeRange"],"sources":["../../../src/parse/structure/Token.js"],"sourcesContent":["import { normalizeSingle } from \"../../languageProcessing\";\n\n/**\n * A token representing a word, whitespace or punctuation in the sentence.\n */\nclass Token {\n\t/**\n\t * Creates a new token.\n\t *\n\t * @param {string} text The token's text.\n\t * @param {SourceCodeRange} sourceCodeRange The start and end positions of the token in the source code.\n\t */\n\tconstructor( text, sourceCodeRange = {} ) {\n\t\t// Normalize single quotes so that tokens can be matched with strings regardless of single quote type.\n\t\tthis.text = normalizeSingle( text );\n\t\t/**\n\t\t * The start and end positions of the token in the source code.\n\t\t * @type {SourceCodeRange}\n\t\t */\n\t\tthis.sourceCodeRange = sourceCodeRange;\n\t}\n}\n\nexport default Token;\n"],"mappings":"AAAA,SAASA,eAAe;;AAExB;AACA;AACA;AACA,MAAMC,KAAK,CAAC;EACX;AACD;AACA;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,IAAI,EAAEC,eAAe,GAAG,CAAC,CAAC,EAAG;IACzC;IACA,IAAI,CAACD,IAAI,GAAGH,eAAe,CAAEG,IAAK,CAAC;IACnC;AACF;AACA;AACA;IACE,IAAI,CAACC,eAAe,GAAGA,eAAe;EACvC;AACD;AAEA,eAAeH,KAAK","ignoreList":[]}

package/build/parse/structure/index.js

@@ -0,0 +1,12 @@
+import Node from "./Node";
+import Heading from "./Heading";
+import Paragraph from "./Paragraph";
+import Text from "./Text";
+
+/**
+ * @module parse/structure
+ *
+ * Contains elements out of which a tree structure can be built.
+ */
+export { Node, Heading, Paragraph, Text };
+//# sourceMappingURL=index.js.map

package/build/parse/structure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Node","Heading","Paragraph","Text"],"sources":["../../../src/parse/structure/index.js"],"sourcesContent":["import Node from \"./Node\";\nimport Heading from \"./Heading\";\nimport Paragraph from \"./Paragraph\";\nimport Text from \"./Text\";\n\n/**\n * @module parse/structure\n *\n * Contains elements out of which a tree structure can be built.\n */\nexport {\n\tNode,\n\tHeading,\n\tParagraph,\n\tText,\n};\n"],"mappings":"AAAA,OAAOA,IAAI;AACX,OAAOC,OAAO;AACd,OAAOC,SAAS;AAChB,OAAOC,IAAI;;AAEX;AACA;AACA;AACA;AACA;AACA,SACCH,IAAI,EACJC,OAAO,EACPC,SAAS,EACTC,IAAI","ignoreList":[]}

package/build/parse/traverse/findAllInTree.js

@@ -0,0 +1,56 @@
+/**
+ * Finds all nodes in the tree that satisfies the given condition.
+ *
+ * @param {Object} 		tree 						The tree.
+ * @param {function} 	condition 					The condition that a node should satisfy to end up in the list.
+ * @param {boolean} 	recurseFoundNodes=false 	Whether to recurse into found nodes to see if the condition also applies to
+ * sub-nodes of the found node.
+ * If false, as soon as a node is found that satisfies the condition, it is added to the list and no further recursion is done through its children.
+ * If true, the node is added to the list and its children are also checked for the condition.
+ * If they satisfy the condition, they are also added to the list.
+ * This comes with the risk of adding the same node multiple times to the list.
+ *
+ * Example:
+ * HTML: <div><div><div>foo</div></div></div>
+ * Condition: node => node.nodeName === 'div'
+ * If recurseFoundNodes is false, this will return: [ <div><div><div>foo</div></div></div> ]
+ *
+ * If recurseFoundNodes is true, this will return: [ <div><div><div>foo</div></div></div>, <div><div>foo</div></div>, <div>foo</div> ]
+ *
+ * In assessments where you want to count the number of occurrences of a certain type of node, you should set recurseFoundNodes to false.
+ * For example in the list assessment with a nested list: you only want to count the outer list.
+ *
+ * <ul>
+ *   <li>Coffee</li>
+ *   <li>Tea
+ *     <ul>
+ *       <li>Black tea</li>
+ *       <li>Green tea</li>
+ *     </ul>
+ *   </li>
+ *   <li>Milk</li>
+ * </ul>
+ *
+ * In getTextElementPositions, you want to find all descendant nodes that have position information.
+ * In this case you want to recurse into found nodes.
+ *
+ * @returns {Object[]} The list of nodes that satisfy the condition.
+ */
+export default function findAllInTree(tree, condition, recurseFoundNodes = false) {
+  const nodes = [];
+  if (!tree.childNodes) {
+    return nodes;
+  }
+  tree.childNodes.forEach(child => {
+    if (condition(child)) {
+      nodes.push(child);
+      if (recurseFoundNodes) {
+        nodes.push(...findAllInTree(child, condition, recurseFoundNodes));
+      }
+    } else {
+      nodes.push(...findAllInTree(child, condition, recurseFoundNodes));
+    }
+  });
+  return nodes;
+}
+//# sourceMappingURL=findAllInTree.js.map

package/build/parse/traverse/findAllInTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findAllInTree.js","names":["findAllInTree","tree","condition","recurseFoundNodes","nodes","childNodes","forEach","child","push"],"sources":["../../../src/parse/traverse/findAllInTree.js"],"sourcesContent":["/**\n * Finds all nodes in the tree that satisfies the given condition.\n *\n * @param {Object} \t\ttree \t\t\t\t\t\tThe tree.\n * @param {function} \tcondition \t\t\t\t\tThe condition that a node should satisfy to end up in the list.\n * @param {boolean} \trecurseFoundNodes=false \tWhether to recurse into found nodes to see if the condition also applies to\n * sub-nodes of the found node.\n * If false, as soon as a node is found that satisfies the condition, it is added to the list and no further recursion is done through its children.\n * If true, the node is added to the list and its children are also checked for the condition.\n * If they satisfy the condition, they are also added to the list.\n * This comes with the risk of adding the same node multiple times to the list.\n *\n * Example:\n * HTML: <div><div><div>foo</div></div></div>\n * Condition: node => node.nodeName === 'div'\n * If recurseFoundNodes is false, this will return: [ <div><div><div>foo</div></div></div> ]\n *\n * If recurseFoundNodes is true, this will return: [ <div><div><div>foo</div></div></div>, <div><div>foo</div></div>, <div>foo</div> ]\n *\n * In assessments where you want to count the number of occurrences of a certain type of node, you should set recurseFoundNodes to false.\n * For example in the list assessment with a nested list: you only want to count the outer list.\n *\n * <ul>\n *   <li>Coffee</li>\n *   <li>Tea\n *     <ul>\n *       <li>Black tea</li>\n *       <li>Green tea</li>\n *     </ul>\n *   </li>\n *   <li>Milk</li>\n * </ul>\n *\n * In getTextElementPositions, you want to find all descendant nodes that have position information.\n * In this case you want to recurse into found nodes.\n *\n * @returns {Object[]} The list of nodes that satisfy the condition.\n */\nexport default function findAllInTree( tree, condition, recurseFoundNodes = false ) {\n\tconst nodes = [];\n\n\tif ( ! tree.childNodes ) {\n\t\treturn nodes;\n\t}\n\n\ttree.childNodes.forEach( child => {\n\t\tif ( condition( child ) ) {\n\t\t\tnodes.push( child );\n\t\t\tif ( recurseFoundNodes ) {\n\t\t\t\tnodes.push( ...findAllInTree( child, condition, recurseFoundNodes ) );\n\t\t\t}\n\t\t} else {\n\t\t\tnodes.push( ...findAllInTree( child, condition, recurseFoundNodes ) );\n\t\t}\n\t} );\n\n\treturn nodes;\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASA,aAAaA,CAAEC,IAAI,EAAEC,SAAS,EAAEC,iBAAiB,GAAG,KAAK,EAAG;EACnF,MAAMC,KAAK,GAAG,EAAE;EAEhB,IAAK,CAAEH,IAAI,CAACI,UAAU,EAAG;IACxB,OAAOD,KAAK;EACb;EAEAH,IAAI,CAACI,UAAU,CAACC,OAAO,CAAEC,KAAK,IAAI;IACjC,IAAKL,SAAS,CAAEK,KAAM,CAAC,EAAG;MACzBH,KAAK,CAACI,IAAI,CAAED,KAAM,CAAC;MACnB,IAAKJ,iBAAiB,EAAG;QACxBC,KAAK,CAACI,IAAI,CAAE,GAAGR,aAAa,CAAEO,KAAK,EAAEL,SAAS,EAAEC,iBAAkB,CAAE,CAAC;MACtE;IACD,CAAC,MAAM;MACNC,KAAK,CAACI,IAAI,CAAE,GAAGR,aAAa,CAAEO,KAAK,EAAEL,SAAS,EAAEC,iBAAkB,CAAE,CAAC;IACtE;EACD,CAAE,CAAC;EAEH,OAAOC,KAAK;AACb","ignoreList":[]}

package/build/parse/traverse/index.js

@@ -0,0 +1,10 @@
+import findAllInTree from "./findAllInTree";
+import innerText from "./innerText";
+
+/**
+ * @module parse/traverse
+ *
+ * Module containing functions to traverse and gather information from the tree.
+ */
+export { findAllInTree, innerText };
+//# sourceMappingURL=index.js.map

package/build/parse/traverse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["findAllInTree","innerText"],"sources":["../../../src/parse/traverse/index.js"],"sourcesContent":["import findAllInTree from \"./findAllInTree\";\nimport innerText from \"./innerText\";\n\n/**\n * @module parse/traverse\n *\n * Module containing functions to traverse and gather information from the tree.\n */\nexport {\n\tfindAllInTree,\n\tinnerText,\n};\n"],"mappings":"AAAA,OAAOA,aAAa;AACpB,OAAOC,SAAS;;AAEhB;AACA;AACA;AACA;AACA;AACA,SACCD,aAAa,EACbC,SAAS","ignoreList":[]}

package/build/parse/traverse/innerText.js

@@ -0,0 +1,25 @@
+import { isEmpty } from "lodash";
+
+/**
+ * Gathers the text content of the given node.
+ *
+ * @param {Object} node The node to gather the text content from.
+ *
+ * @returns {string} The text content.
+ */
+export default function innerText(node) {
+  let text = "";
+  if (!isEmpty(node.childNodes)) {
+    node.childNodes.forEach(child => {
+      if (child.name === "#text") {
+        text += child.value;
+      } else if (child.name === "br") {
+        text += "\n";
+      } else {
+        text += innerText(child);
+      }
+    });
+  }
+  return text;
+}
+//# sourceMappingURL=innerText.js.map

package/build/parse/traverse/innerText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"innerText.js","names":["isEmpty","innerText","node","text","childNodes","forEach","child","name","value"],"sources":["../../../src/parse/traverse/innerText.js"],"sourcesContent":["import { isEmpty } from \"lodash\";\n\n/**\n * Gathers the text content of the given node.\n *\n * @param {Object} node The node to gather the text content from.\n *\n * @returns {string} The text content.\n */\nexport default function innerText( node ) {\n\tlet text = \"\";\n\n\tif ( ! isEmpty( node.childNodes ) ) {\n\t\tnode.childNodes.forEach( child => {\n\t\t\tif ( child.name === \"#text\" ) {\n\t\t\t\ttext += child.value;\n\t\t\t} else if ( child.name === \"br\" ) {\n\t\t\t\ttext += \"\\n\";\n\t\t\t} else {\n\t\t\t\ttext += innerText( child );\n\t\t\t}\n\t\t} );\n\t}\n\n\treturn text;\n}\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,QAAQ;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,SAASC,SAASA,CAAEC,IAAI,EAAG;EACzC,IAAIC,IAAI,GAAG,EAAE;EAEb,IAAK,CAAEH,OAAO,CAAEE,IAAI,CAACE,UAAW,CAAC,EAAG;IACnCF,IAAI,CAACE,UAAU,CAACC,OAAO,CAAEC,KAAK,IAAI;MACjC,IAAKA,KAAK,CAACC,IAAI,KAAK,OAAO,EAAG;QAC7BJ,IAAI,IAAIG,KAAK,CAACE,KAAK;MACpB,CAAC,MAAM,IAAKF,KAAK,CAACC,IAAI,KAAK,IAAI,EAAG;QACjCJ,IAAI,IAAI,IAAI;MACb,CAAC,MAAM;QACNA,IAAI,IAAIF,SAAS,CAAEK,KAAM,CAAC;MAC3B;IACD,CAAE,CAAC;EACJ;EAEA,OAAOH,IAAI;AACZ","ignoreList":[]}

package/build/parsedPaper/ParsedPaper.js

@@ -0,0 +1,93 @@
+/**
+ * A parsed version of the paper, containing a tree representation of the text,
+ * and parsed metaData pertaining to the tree's context.
+ *
+ * @class ParsedPaper
+ *
+ * @memberOf module:parsedPaper
+ * */
+export default class ParsedPaper {
+  /**
+   * Creates a new ParsedPaper.
+   */
+  constructor() {
+    /**
+     * Stores the metadata (e.g. the keywords, metadescription, title of the document).
+     *
+     * @type{Object}
+     * @private
+     */
+    this._metaData = {};
+
+    /**
+     * Stores the tree representation of a Paper's text.
+     *
+     * @type{module:parsedPaper/structure.Node|Object}
+     * @private
+     */
+    this._tree = {};
+  }
+
+  /**
+   * Sets a tree structure on the ParsedPaper.
+   *
+   * @param {module:parsedPaper/structure.Node} tree A tree representation of the paper's text.
+   *
+   * @returns {void}
+   */
+  setTree(tree) {
+    this._tree = tree;
+  }
+
+  /**
+   * Returns the tree from the ParsedPaper.
+   *
+   * @returns {module:parsedPaper/structure.Node|Object} The tree.
+   */
+  getTree() {
+    return this._tree;
+  }
+
+  /**
+   * Sets a metadata value on the ParsedPaper under the passed key.
+   *
+   * @param {string} key   The key for the metaData key-value pair.
+   * @param {*}      value The value for the metaData key-value pair.
+   *
+   * @returns {void}
+   */
+  setMetaProperty(key, value) {
+    this._metaData[key] = value;
+  }
+
+  /**
+   * Returns the metadata value for a specific key from the ParsedPaper.
+   *
+   * @param   {string} key The key to return the value for.
+   * @returns {*}          The value belonging to this key.
+   */
+  getMetaProperty(key) {
+    return this._metaData[key];
+  }
+
+  /**
+   * Sets the metaData on the ParsedPaper.
+   *
+   * @param {Object} metaData The metaData pertaining to tree.
+   *
+   * @returns {void}
+   */
+  setMetaData(metaData) {
+    this._metaData = metaData;
+  }
+
+  /**
+   * Returns the current metaData of the ParsedPaper.
+   *
+   * @returns {Object} The metaData.
+   */
+  getMetaData() {
+    return this._metaData;
+  }
+}
+//# sourceMappingURL=ParsedPaper.js.map

package/build/parsedPaper/ParsedPaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParsedPaper.js","names":["ParsedPaper","constructor","_metaData","_tree","setTree","tree","getTree","setMetaProperty","key","value","getMetaProperty","setMetaData","metaData","getMetaData"],"sources":["../../src/parsedPaper/ParsedPaper.js"],"sourcesContent":["/**\n * A parsed version of the paper, containing a tree representation of the text,\n * and parsed metaData pertaining to the tree's context.\n *\n * @class ParsedPaper\n *\n * @memberOf module:parsedPaper\n * */\nexport default class ParsedPaper {\n\t/**\n\t * Creates a new ParsedPaper.\n\t */\n\tconstructor() {\n\t\t/**\n\t\t * Stores the metadata (e.g. the keywords, metadescription, title of the document).\n\t\t *\n\t\t * @type{Object}\n\t\t * @private\n\t\t */\n\t\tthis._metaData = {};\n\n\t\t/**\n\t\t * Stores the tree representation of a Paper's text.\n\t\t *\n\t\t * @type{module:parsedPaper/structure.Node|Object}\n\t\t * @private\n\t\t */\n\t\tthis._tree = {};\n\t}\n\n\t/**\n\t * Sets a tree structure on the ParsedPaper.\n\t *\n\t * @param {module:parsedPaper/structure.Node} tree A tree representation of the paper's text.\n\t *\n\t * @returns {void}\n\t */\n\tsetTree( tree ) {\n\t\tthis._tree = tree;\n\t}\n\n\t/**\n\t * Returns the tree from the ParsedPaper.\n\t *\n\t * @returns {module:parsedPaper/structure.Node|Object} The tree.\n\t */\n\tgetTree() {\n\t\treturn this._tree;\n\t}\n\n\t/**\n\t * Sets a metadata value on the ParsedPaper under the passed key.\n\t *\n\t * @param {string} key   The key for the metaData key-value pair.\n\t * @param {*}      value The value for the metaData key-value pair.\n\t *\n\t * @returns {void}\n\t */\n\tsetMetaProperty( key, value ) {\n\t\tthis._metaData[ key ] = value;\n\t}\n\n\t/**\n\t * Returns the metadata value for a specific key from the ParsedPaper.\n\t *\n\t * @param   {string} key The key to return the value for.\n\t * @returns {*}          The value belonging to this key.\n\t */\n\tgetMetaProperty( key ) {\n\t\treturn this._metaData[ key ];\n\t}\n\n\t/**\n\t * Sets the metaData on the ParsedPaper.\n\t *\n\t * @param {Object} metaData The metaData pertaining to tree.\n\t *\n\t * @returns {void}\n\t */\n\tsetMetaData( metaData ) {\n\t\tthis._metaData = metaData;\n\t}\n\n\t/**\n\t * Returns the current metaData of the ParsedPaper.\n\t *\n\t * @returns {Object} The metaData.\n\t */\n\tgetMetaData() {\n\t\treturn this._metaData;\n\t}\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,MAAMA,WAAW,CAAC;EAChC;AACD;AACA;EACCC,WAAWA,CAAA,EAAG;IACb;AACF;AACA;AACA;AACA;AACA;IACE,IAAI,CAACC,SAAS,GAAG,CAAC,CAAC;;IAEnB;AACF;AACA;AACA;AACA;AACA;IACE,IAAI,CAACC,KAAK,GAAG,CAAC,CAAC;EAChB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,OAAOA,CAAEC,IAAI,EAAG;IACf,IAAI,CAACF,KAAK,GAAGE,IAAI;EAClB;;EAEA;AACD;AACA;AACA;AACA;EACCC,OAAOA,CAAA,EAAG;IACT,OAAO,IAAI,CAACH,KAAK;EAClB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;EACCI,eAAeA,CAAEC,GAAG,EAAEC,KAAK,EAAG;IAC7B,IAAI,CAACP,SAAS,CAAEM,GAAG,CAAE,GAAGC,KAAK;EAC9B;;EAEA;AACD;AACA;AACA;AACA;AACA;EACCC,eAAeA,CAAEF,GAAG,EAAG;IACtB,OAAO,IAAI,CAACN,SAAS,CAAEM,GAAG,CAAE;EAC7B;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCG,WAAWA,CAAEC,QAAQ,EAAG;IACvB,IAAI,CAACV,SAAS,GAAGU,QAAQ;EAC1B;;EAEA;AACD;AACA;AACA;AACA;EACCC,WAAWA,CAAA,EAAG;IACb,OAAO,IAAI,CAACX,SAAS;EACtB;AACD","ignoreList":[]}