axyseo 2.1.11 → 2.1.13

package/build/cjs/parsedPaper/research/TreeResearcher.js

@@ -0,0 +1,136 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _lodash = require("lodash");
+/**
+ * This contains all possible, default researches
+ * and logic to apply these researches to a formatted text,
+ * represented as a tree structure.
+ *
+ * @memberOf module:parsedPaper/research
+ */
+class TreeResearcher {
+  /**
+   * Makes a new TreeResearcher.
+   */
+  constructor() {
+    this._researches = {};
+    this._data = {};
+  }
+
+  /**
+   * Adds or overwrites a research to the list of available researches.
+   *
+   * **Note**: When a research is already known under the given name,
+   * the previous research with this name gets overwritten!
+   *
+   * @param {string} name       The ID to which to map the research to.
+   * @param {Research} research The research to add.
+   *
+   * @returns {void}
+   */
+  addResearch(name, research) {
+    this._researches[name] = research;
+  }
+
+  /**
+   * Returns all available researches.
+   *
+   * @returns {Object} An object containing all available researches.
+   */
+  getResearches() {
+    return this._researches;
+  }
+
+  /**
+   * Returns whether a research is known under this name.
+   *
+   * @param {string} name The name to get the research from.
+   *
+   * @returns {boolean} If a research is known under this name.
+   */
+  hasResearch(name) {
+    return (0, _lodash.has)(this._researches, name);
+  }
+
+  /**
+   * Gets the research with the given name.
+   * If a research is not known under this name, false is returned instead.
+   *
+   * @throws {Error} When a research is not known under the given name.
+   *
+   * @param {string} name The name of the research to get.
+   *
+   * @returns {Research} The research stored under the given name.
+   */
+  getResearch(name) {
+    if (this.hasResearch(name)) {
+      return this._researches[name];
+    }
+    throw new Error(`'${name}' research does not exist.`);
+  }
+
+  /**
+   * Applies the research with the given name to the node and its descendants.
+   *
+   * @param {string} name The name of the research to apply to the node.
+   * @param {module:parsedPaper/structure.Node} node The node to compute the research of.
+   * @param {module:parsedPaper/structure.StructuredNode} metadata The node that holds the paper metadata.
+   * @param {boolean} [bustCache=false] If we should force the results, as cached on each node, to be recomputed.
+   *
+   * @returns {Promise<*>} A promising research result.
+   */
+  async doResearch(name, node, metadata, bustCache = false) {
+    const research = this.getResearch(name);
+    let researchResult = Promise.resolve();
+    if (research.isLeafNode(node)) {
+      /*
+        Compute research results for this node, or use the cached results when available.
+        Always compute it when we need to bust the cache.
+       */
+      if (!node.hasResearchResult(name) || bustCache) {
+        node.setResearchResult(name, await research.calculateFor(node, metadata));
+      }
+      researchResult = node.getResearchResult(name);
+    } else {
+      const children = node.children;
+
+      // Heading and paragraph nodes do not have children.
+      if (children) {
+        const resultsForChildren = await Promise.all(children.map(child => {
+          return this.doResearch(name, child, metadata);
+        }));
+        researchResult = research.mergeChildrenResults(resultsForChildren);
+      }
+    }
+    return researchResult;
+  }
+
+  /**
+   * Add research data to the researcher by the research name.
+   *
+   * @param {string} researchName The identifier of the research.
+   * @param {Object} data         The data object.
+   *
+   * @returns {void}.
+   */
+  addResearchData(researchName, data) {
+    this._data[researchName] = data;
+  }
+
+  /**
+   * Return the research data from a research data provider by research name.
+   *
+   * @param {string} researchName The identifier of the research.
+   *
+   * @returns {Object|boolean} The data provided by the provider, false if the data do not exist
+   */
+  getData(researchName) {
+    return (0, _lodash.get)(this._data, researchName, false);
+  }
+}
+var _default = exports.default = TreeResearcher;
+//# sourceMappingURL=TreeResearcher.js.map

package/build/cjs/parsedPaper/research/TreeResearcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeResearcher.js","names":["_lodash","require","TreeResearcher","constructor","_researches","_data","addResearch","name","research","getResearches","hasResearch","has","getResearch","Error","doResearch","node","metadata","bustCache","researchResult","Promise","resolve","isLeafNode","hasResearchResult","setResearchResult","calculateFor","getResearchResult","children","resultsForChildren","all","map","child","mergeChildrenResults","addResearchData","researchName","data","getData","get","_default","exports","default"],"sources":["../../../../src/parsedPaper/research/TreeResearcher.js"],"sourcesContent":["import { get, has } from \"lodash\";\n\n/**\n * This contains all possible, default researches\n * and logic to apply these researches to a formatted text,\n * represented as a tree structure.\n *\n * @memberOf module:parsedPaper/research\n */\nclass TreeResearcher {\n\t/**\n\t * Makes a new TreeResearcher.\n\t */\n\tconstructor() {\n\t\tthis._researches = {};\n\t\tthis._data = {};\n\t}\n\n\t/**\n\t * Adds or overwrites a research to the list of available researches.\n\t *\n\t * **Note**: When a research is already known under the given name,\n\t * the previous research with this name gets overwritten!\n\t *\n\t * @param {string} name       The ID to which to map the research to.\n\t * @param {Research} research The research to add.\n\t *\n\t * @returns {void}\n\t */\n\taddResearch( name, research ) {\n\t\tthis._researches[ name ] = research;\n\t}\n\n\t/**\n\t * Returns all available researches.\n\t *\n\t * @returns {Object} An object containing all available researches.\n\t */\n\tgetResearches() {\n\t\treturn this._researches;\n\t}\n\n\t/**\n\t * Returns whether a research is known under this name.\n\t *\n\t * @param {string} name The name to get the research from.\n\t *\n\t * @returns {boolean} If a research is known under this name.\n\t */\n\thasResearch( name ) {\n\t\treturn has( this._researches, name );\n\t}\n\n\t/**\n\t * Gets the research with the given name.\n\t * If a research is not known under this name, false is returned instead.\n\t *\n\t * @throws {Error} When a research is not known under the given name.\n\t *\n\t * @param {string} name The name of the research to get.\n\t *\n\t * @returns {Research} The research stored under the given name.\n\t */\n\tgetResearch( name ) {\n\t\tif ( this.hasResearch( name ) ) {\n\t\t\treturn this._researches[ name ];\n\t\t}\n\t\tthrow new Error( `'${name}' research does not exist.` );\n\t}\n\n\t/**\n\t * Applies the research with the given name to the node and its descendants.\n\t *\n\t * @param {string} name The name of the research to apply to the node.\n\t * @param {module:parsedPaper/structure.Node} node The node to compute the research of.\n\t * @param {module:parsedPaper/structure.StructuredNode} metadata The node that holds the paper metadata.\n\t * @param {boolean} [bustCache=false] If we should force the results, as cached on each node, to be recomputed.\n\t *\n\t * @returns {Promise<*>} A promising research result.\n\t */\n\tasync doResearch( name, node, metadata, bustCache = false ) {\n\t\tconst research = this.getResearch( name );\n\t\tlet researchResult = Promise.resolve();\n\n\t\tif ( research.isLeafNode( node ) ) {\n\t\t\t/*\n\t\t\t  Compute research results for this node, or use the cached results when available.\n\t\t\t  Always compute it when we need to bust the cache.\n\t\t\t */\n\t\t\tif ( ! node.hasResearchResult( name ) || bustCache ) {\n\t\t\t\tnode.setResearchResult( name, await research.calculateFor( node, metadata ) );\n\t\t\t}\n\t\t\tresearchResult = node.getResearchResult( name );\n\t\t} else {\n\t\t\tconst children = node.children;\n\n\t\t\t// Heading and paragraph nodes do not have children.\n\t\t\tif ( children ) {\n\t\t\t\tconst resultsForChildren = await Promise.all( children.map( ( child ) => {\n\t\t\t\t\treturn this.doResearch( name, child, metadata );\n\t\t\t\t} ) );\n\n\t\t\t\tresearchResult = research.mergeChildrenResults( resultsForChildren );\n\t\t\t}\n\t\t}\n\n\t\treturn researchResult;\n\t}\n\n\t/**\n\t * Add research data to the researcher by the research name.\n\t *\n\t * @param {string} researchName The identifier of the research.\n\t * @param {Object} data         The data object.\n\t *\n\t * @returns {void}.\n\t */\n\taddResearchData( researchName, data ) {\n\t\tthis._data[ researchName ] = data;\n\t}\n\n\t/**\n\t * Return the research data from a research data provider by research name.\n\t *\n\t * @param {string} researchName The identifier of the research.\n\t *\n\t * @returns {Object|boolean} The data provided by the provider, false if the data do not exist\n\t */\n\tgetData( researchName ) {\n\t\treturn get( this._data, researchName, false );\n\t}\n}\n\nexport default TreeResearcher;\n"],"mappings":";;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,cAAc,CAAC;EACpB;AACD;AACA;EACCC,WAAWA,CAAA,EAAG;IACb,IAAI,CAACC,WAAW,GAAG,CAAC,CAAC;IACrB,IAAI,CAACC,KAAK,GAAG,CAAC,CAAC;EAChB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,IAAI,EAAEC,QAAQ,EAAG;IAC7B,IAAI,CAACJ,WAAW,CAAEG,IAAI,CAAE,GAAGC,QAAQ;EACpC;;EAEA;AACD;AACA;AACA;AACA;EACCC,aAAaA,CAAA,EAAG;IACf,OAAO,IAAI,CAACL,WAAW;EACxB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCM,WAAWA,CAAEH,IAAI,EAAG;IACnB,OAAO,IAAAI,WAAG,EAAE,IAAI,CAACP,WAAW,EAAEG,IAAK,CAAC;EACrC;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCK,WAAWA,CAAEL,IAAI,EAAG;IACnB,IAAK,IAAI,CAACG,WAAW,CAAEH,IAAK,CAAC,EAAG;MAC/B,OAAO,IAAI,CAACH,WAAW,CAAEG,IAAI,CAAE;IAChC;IACA,MAAM,IAAIM,KAAK,CAAE,IAAIN,IAAI,4BAA6B,CAAC;EACxD;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACC,MAAMO,UAAUA,CAAEP,IAAI,EAAEQ,IAAI,EAAEC,QAAQ,EAAEC,SAAS,GAAG,KAAK,EAAG;IAC3D,MAAMT,QAAQ,GAAG,IAAI,CAACI,WAAW,CAAEL,IAAK,CAAC;IACzC,IAAIW,cAAc,GAAGC,OAAO,CAACC,OAAO,CAAC,CAAC;IAEtC,IAAKZ,QAAQ,CAACa,UAAU,CAAEN,IAAK,CAAC,EAAG;MAClC;AACH;AACA;AACA;MACG,IAAK,CAAEA,IAAI,CAACO,iBAAiB,CAAEf,IAAK,CAAC,IAAIU,SAAS,EAAG;QACpDF,IAAI,CAACQ,iBAAiB,CAAEhB,IAAI,EAAE,MAAMC,QAAQ,CAACgB,YAAY,CAAET,IAAI,EAAEC,QAAS,CAAE,CAAC;MAC9E;MACAE,cAAc,GAAGH,IAAI,CAACU,iBAAiB,CAAElB,IAAK,CAAC;IAChD,CAAC,MAAM;MACN,MAAMmB,QAAQ,GAAGX,IAAI,CAACW,QAAQ;;MAE9B;MACA,IAAKA,QAAQ,EAAG;QACf,MAAMC,kBAAkB,GAAG,MAAMR,OAAO,CAACS,GAAG,CAAEF,QAAQ,CAACG,GAAG,CAAIC,KAAK,IAAM;UACxE,OAAO,IAAI,CAAChB,UAAU,CAAEP,IAAI,EAAEuB,KAAK,EAAEd,QAAS,CAAC;QAChD,CAAE,CAAE,CAAC;QAELE,cAAc,GAAGV,QAAQ,CAACuB,oBAAoB,CAAEJ,kBAAmB,CAAC;MACrE;IACD;IAEA,OAAOT,cAAc;EACtB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;EACCc,eAAeA,CAAEC,YAAY,EAAEC,IAAI,EAAG;IACrC,IAAI,CAAC7B,KAAK,CAAE4B,YAAY,CAAE,GAAGC,IAAI;EAClC;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,OAAOA,CAAEF,YAAY,EAAG;IACvB,OAAO,IAAAG,WAAG,EAAE,IAAI,CAAC/B,KAAK,EAAE4B,YAAY,EAAE,KAAM,CAAC;EAC9C;AACD;AAAC,IAAAI,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcrC,cAAc","ignoreList":[]}

package/build/cjs/parsedPaper/research/index.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "TreeResearcher", {
+  enumerable: true,
+  get: function () {
+    return _TreeResearcher.default;
+  }
+});
+var _TreeResearcher = _interopRequireDefault(require("./TreeResearcher"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/build/cjs/parsedPaper/research/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_TreeResearcher","_interopRequireDefault","require","e","__esModule","default"],"sources":["../../../../src/parsedPaper/research/index.js"],"sourcesContent":["import TreeResearcher from \"./TreeResearcher\";\n\n/**\n * Module for applying researches to text, represented as a tree structure.\n *\n * @see module:parsedPaper/structure\n *\n * @module parsedPaper/research\n */\n\nexport {\n\tTreeResearcher,\n};\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/build/cjs/parsedPaper/research/researches/Headings.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _tree = require("../../structure/tree");
+var _Research = _interopRequireDefault(require("./Research"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * A research giving back the headings located in a text.
+ */
+class Headings extends _Research.default {
+  /**
+   * Calculates the result of the research for the given Node.
+   *
+   * @param {module:parsedPaper/structure.Node} node The node to do the research on.
+   *
+   * @returns {Promise<module:parsedPaper/structure.Heading[]|[]>} The result of the research.
+   */
+  calculateFor(node) {
+    return node instanceof _tree.Heading ? Promise.resolve([node]) : Promise.resolve([]);
+  }
+}
+var _default = exports.default = Headings;
+//# sourceMappingURL=Headings.js.map

package/build/cjs/parsedPaper/research/researches/Headings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headings.js","names":["_tree","require","_Research","_interopRequireDefault","e","__esModule","default","Headings","Research","calculateFor","node","Heading","Promise","resolve","_default","exports"],"sources":["../../../../../src/parsedPaper/research/researches/Headings.js"],"sourcesContent":["import { Heading } from \"../../structure/tree\";\nimport Research from \"./Research\";\n\n/**\n * A research giving back the headings located in a text.\n */\nclass Headings extends Research {\n\t/**\n\t * Calculates the result of the research for the given Node.\n\t *\n\t * @param {module:parsedPaper/structure.Node} node The node to do the research on.\n\t *\n\t * @returns {Promise<module:parsedPaper/structure.Heading[]|[]>} The result of the research.\n\t */\n\tcalculateFor( node ) {\n\t\treturn node instanceof Heading ? Promise.resolve( [ node ] ) : Promise.resolve( [] );\n\t}\n}\n\nexport default Headings;\n"],"mappings":";;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AACA,IAAAC,SAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAkC,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAElC;AACA;AACA;AACA,MAAMG,QAAQ,SAASC,iBAAQ,CAAC;EAC/B;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,YAAYA,CAAEC,IAAI,EAAG;IACpB,OAAOA,IAAI,YAAYC,aAAO,GAAGC,OAAO,CAACC,OAAO,CAAE,CAAEH,IAAI,CAAG,CAAC,GAAGE,OAAO,CAACC,OAAO,CAAE,EAAG,CAAC;EACrF;AACD;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAT,OAAA,GAEcC,QAAQ","ignoreList":[]}

package/build/cjs/parsedPaper/research/researches/LinkStatistics.js

@@ -0,0 +1,129 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _url = _interopRequireDefault(require("url"));
+var _Research = _interopRequireDefault(require("./Research"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/* Internal dependencies */
+
+/**
+ * Calculates link statistics.
+ * E.g. which links a node or its children contains, and whether these links are:
+ *  * internal (points to a page in the same domain), external (a page in another domain) or other.
+ *  * marked as follow (search engines are allowed to follow this link) or no-follow (search engines are not allowed to follow the link).
+ *
+ *  @memberOf module:parsedPaper/research
+ */
+class LinkStatistics extends _Research.default {
+  /**
+   * Checks whether the given link is marked for search engines to not follow.
+   *
+   * @param {module:parsedPaper/structure.FormattingElement} linkElement The link to check.
+   *
+   * @returns {boolean} `true` if the link is marked as 'no-follow'.
+   *
+   * @private
+   */
+  _isNoFollow(linkElement) {
+    const rel = linkElement.getAttribute("rel");
+    if (!rel) {
+      return false;
+    }
+
+    // Check if the `rel` attribute includes "nofollow".
+    return rel.split(/\s+/).includes("nofollow");
+  }
+
+  /**
+   * Checks whether the given protocol string is either HTTP or HTTPS.
+   *
+   * @param {String} protocol The protocol string to check.
+   *
+   * @returns {boolean} Whether the protocol is either HTTP or HTTPS.
+   *
+   * @private
+   */
+  _isHttp(protocol) {
+    if (!protocol) {
+      return false;
+    }
+    return protocol === "http:" || protocol === "https:";
+  }
+
+  /**
+   * Checks whether the given link is:
+   *  * internal: points to a web page in the same domain as the current site.
+   *  * external: points to a web page in another domain as the current site.
+   *  * other: e.g. uses another protocol like `ftp`.
+   *
+   * @param {module:parsedPaper/structure.FormattingElement} linkElement The link to check.
+   * @param {string}                                         domain The domain to check against.
+   *
+   * @returns {"external"|"internal"|"other"} Whether the link points to an external, internal or other web page.
+   *
+   * @private
+   */
+  _whichTarget(linkElement, domain) {
+    const link = linkElement.getAttribute("href");
+    if (!link) {
+      return "other";
+    }
+    const url = _url.default.parse(link);
+    if (!this._isHttp(url.protocol) || url.hash) {
+      return "other";
+    }
+    if (url.hostname === domain) {
+      return "internal";
+    }
+    return "external";
+  }
+
+  /**
+   * Returns the permalink from the metadata.
+   *
+   * @param {module:parsedPaper/structure.Node} metadata The metadata to retrieve the permalink from.
+   *
+   * @returns {string} The permalink.
+   *
+   * @private
+   */
+  _getPermalink(metadata) {
+    const permalinkElement = metadata.children.find(child => child.tag === "permalink");
+    const paragraph = permalinkElement.children[0];
+    return paragraph.textContainer.text;
+  }
+
+  /**
+   * Calculates link statistics for the given node.
+   *
+   * @param {module:parsedPaper/structure.Node} node     The node to calculate the research for.
+   * @param {module:parsedPaper/structure.Node} metadata The document's metadata.
+   *
+   * @returns {Promise<Object[]>} The research results.
+   */
+  calculateFor(node, metadata) {
+    // Collect link elements.
+    const links = node.textContainer.formatting.filter(element => element.type === "a");
+
+    // URL of the current page.
+    const permalink = this._getPermalink(metadata);
+    const url = _url.default.parse(permalink);
+
+    // Collect statistics about the links.
+    const results = links.map(link => {
+      const noFollow = this._isNoFollow(link);
+      const target = this._whichTarget(link, url.hostname);
+      return {
+        link,
+        noFollow,
+        target
+      };
+    });
+    return Promise.resolve(results);
+  }
+}
+var _default = exports.default = LinkStatistics;
+//# sourceMappingURL=LinkStatistics.js.map

package/build/cjs/parsedPaper/research/researches/LinkStatistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkStatistics.js","names":["_url","_interopRequireDefault","require","_Research","e","__esModule","default","LinkStatistics","Research","_isNoFollow","linkElement","rel","getAttribute","split","includes","_isHttp","protocol","_whichTarget","domain","link","url","urlMethods","parse","hash","hostname","_getPermalink","metadata","permalinkElement","children","find","child","tag","paragraph","textContainer","text","calculateFor","node","links","formatting","filter","element","type","permalink","results","map","noFollow","target","Promise","resolve","_default","exports"],"sources":["../../../../../src/parsedPaper/research/researches/LinkStatistics.js"],"sourcesContent":["import urlMethods from \"url\";\n\n/* Internal dependencies */\nimport Research from \"./Research\";\n\n/**\n * Calculates link statistics.\n * E.g. which links a node or its children contains, and whether these links are:\n *  * internal (points to a page in the same domain), external (a page in another domain) or other.\n *  * marked as follow (search engines are allowed to follow this link) or no-follow (search engines are not allowed to follow the link).\n *\n *  @memberOf module:parsedPaper/research\n */\nclass LinkStatistics extends Research {\n\t/**\n\t * Checks whether the given link is marked for search engines to not follow.\n\t *\n\t * @param {module:parsedPaper/structure.FormattingElement} linkElement The link to check.\n\t *\n\t * @returns {boolean} `true` if the link is marked as 'no-follow'.\n\t *\n\t * @private\n\t */\n\t_isNoFollow( linkElement ) {\n\t\tconst rel = linkElement.getAttribute( \"rel\" );\n\n\t\tif ( ! rel ) {\n\t\t\treturn false;\n\t\t}\n\n\t\t// Check if the `rel` attribute includes \"nofollow\".\n\t\treturn rel.split( /\\s+/ ).includes( \"nofollow\" );\n\t}\n\n\t/**\n\t * Checks whether the given protocol string is either HTTP or HTTPS.\n\t *\n\t * @param {String} protocol The protocol string to check.\n\t *\n\t * @returns {boolean} Whether the protocol is either HTTP or HTTPS.\n\t *\n\t * @private\n\t */\n\t_isHttp( protocol ) {\n\t\tif ( ! protocol ) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn ( protocol === \"http:\" || protocol === \"https:\" );\n\t}\n\n\t/**\n\t * Checks whether the given link is:\n\t *  * internal: points to a web page in the same domain as the current site.\n\t *  * external: points to a web page in another domain as the current site.\n\t *  * other: e.g. uses another protocol like `ftp`.\n\t *\n\t * @param {module:parsedPaper/structure.FormattingElement} linkElement The link to check.\n\t * @param {string}                                         domain The domain to check against.\n\t *\n\t * @returns {\"external\"|\"internal\"|\"other\"} Whether the link points to an external, internal or other web page.\n\t *\n\t * @private\n\t */\n\t_whichTarget( linkElement, domain ) {\n\t\tconst link = linkElement.getAttribute( \"href\" );\n\n\t\tif ( ! link ) {\n\t\t\treturn \"other\";\n\t\t}\n\n\t\tconst url = urlMethods.parse( link );\n\n\t\tif ( ! this._isHttp( url.protocol ) || url.hash ) {\n\t\t\treturn \"other\";\n\t\t}\n\n\t\tif ( url.hostname === domain ) {\n\t\t\treturn \"internal\";\n\t\t}\n\n\t\treturn \"external\";\n\t}\n\n\t/**\n\t * Returns the permalink from the metadata.\n\t *\n\t * @param {module:parsedPaper/structure.Node} metadata The metadata to retrieve the permalink from.\n\t *\n\t * @returns {string} The permalink.\n\t *\n\t * @private\n\t */\n\t_getPermalink( metadata ) {\n\t\tconst permalinkElement = metadata.children.find( child => child.tag === \"permalink\" );\n\t\tconst paragraph = permalinkElement.children[ 0 ];\n\t\treturn paragraph.textContainer.text;\n\t}\n\n\t/**\n\t * Calculates link statistics for the given node.\n\t *\n\t * @param {module:parsedPaper/structure.Node} node     The node to calculate the research for.\n\t * @param {module:parsedPaper/structure.Node} metadata The document's metadata.\n\t *\n\t * @returns {Promise<Object[]>} The research results.\n\t */\n\tcalculateFor( node, metadata ) {\n\t\t// Collect link elements.\n\t\tconst links = node.textContainer.formatting.filter( element => element.type === \"a\" );\n\n\t\t// URL of the current page.\n\t\tconst permalink = this._getPermalink( metadata );\n\t\tconst url = urlMethods.parse( permalink );\n\n\t\t// Collect statistics about the links.\n\t\tconst results = links.map( link => {\n\t\t\tconst noFollow = this._isNoFollow( link );\n\t\t\tconst target = this._whichTarget( link, url.hostname );\n\n\t\t\treturn { link, noFollow, target };\n\t\t} );\n\n\t\treturn Promise.resolve( results );\n\t}\n}\n\nexport default LinkStatistics;\n"],"mappings":"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","ignoreList":[]}

package/build/cjs/parsedPaper/research/researches/Research.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _lodash = require("lodash");
+var _tree = require("../../structure/tree");
+/**
+ * A research that can be applied to the tree.
+ *
+ * @memberOf module:parsedPaper/research
+ *
+ * @abstract
+ */
+class Research {
+  /**
+   * Checks if the given node is a leaf node for this research.
+   *
+   * @param {module:parsedPaper/structure.Node} node The node to check.
+   *
+   * @returns {boolean} If the given node is considered a leaf node for this research.
+   *
+   */
+  isLeafNode(node) {
+    // eslint-disable-line no-unused-vars
+    return node instanceof _tree.LeafNode;
+  }
+
+  /**
+   * Calculates the result of the research for the given Node.
+   *
+   * @param {module:parsedPaper/structure.Node} node The node to calculate the research for.
+   * @param {module:parsedPaper/structure.Node} metadata The document's metadata.
+   *
+   * @returns {Promise<*>} The result of the research.
+   *
+   * @abstract
+   */
+  calculateFor(node, metadata) {
+    // eslint-disable-line no-unused-vars
+    console.warn("calculateFor should be implemented by a child class of Researcher.");
+  }
+
+  /**
+   * Merges results of this research according to a predefined strategy.
+   *
+   * @param {Array<*>} results The results of this research to merge.
+   *
+   * @returns {*} The merged results.
+   */
+  mergeChildrenResults(results) {
+    // eslint-disable-line no-unused-vars
+    return (0, _lodash.flatten)(results);
+  }
+}
+var _default = exports.default = Research;
+//# sourceMappingURL=Research.js.map

package/build/cjs/parsedPaper/research/researches/Research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Research.js","names":["_lodash","require","_tree","Research","isLeafNode","node","LeafNode","calculateFor","metadata","console","warn","mergeChildrenResults","results","flatten","_default","exports","default"],"sources":["../../../../../src/parsedPaper/research/researches/Research.js"],"sourcesContent":["import { flatten } from \"lodash\";\nimport { LeafNode } from \"../../structure/tree\";\n\n/**\n * A research that can be applied to the tree.\n *\n * @memberOf module:parsedPaper/research\n *\n * @abstract\n */\nclass Research {\n\t/**\n\t * Checks if the given node is a leaf node for this research.\n\t *\n\t * @param {module:parsedPaper/structure.Node} node The node to check.\n\t *\n\t * @returns {boolean} If the given node is considered a leaf node for this research.\n\t *\n\t */\n\tisLeafNode( node ) { // eslint-disable-line no-unused-vars\n\t\treturn node instanceof LeafNode;\n\t}\n\n\t/**\n\t * Calculates the result of the research for the given Node.\n\t *\n\t * @param {module:parsedPaper/structure.Node} node The node to calculate the research for.\n\t * @param {module:parsedPaper/structure.Node} metadata The document's metadata.\n\t *\n\t * @returns {Promise<*>} The result of the research.\n\t *\n\t * @abstract\n\t */\n\tcalculateFor( node, metadata ) { // eslint-disable-line no-unused-vars\n\t\tconsole.warn( \"calculateFor should be implemented by a child class of Researcher.\" );\n\t}\n\n\t/**\n\t * Merges results of this research according to a predefined strategy.\n\t *\n\t * @param {Array<*>} results The results of this research to merge.\n\t *\n\t * @returns {*} The merged results.\n\t */\n\tmergeChildrenResults( results ) { // eslint-disable-line no-unused-vars\n\t\treturn flatten( results );\n\t}\n}\n\nexport default Research;\n"],"mappings":";;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,KAAA,GAAAD,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,QAAQ,CAAC;EACd;AACD;AACA;AACA;AACA;AACA;AACA;AACA;EACCC,UAAUA,CAAEC,IAAI,EAAG;IAAE;IACpB,OAAOA,IAAI,YAAYC,cAAQ;EAChC;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCC,YAAYA,CAAEF,IAAI,EAAEG,QAAQ,EAAG;IAAE;IAChCC,OAAO,CAACC,IAAI,CAAE,oEAAqE,CAAC;EACrF;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,oBAAoBA,CAAEC,OAAO,EAAG;IAAE;IACjC,OAAO,IAAAC,eAAO,EAAED,OAAQ,CAAC;EAC1B;AACD;AAAC,IAAAE,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcb,QAAQ","ignoreList":[]}

package/build/cjs/parsedPaper/research/researches/index.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Headings", {
+  enumerable: true,
+  get: function () {
+    return _Headings.default;
+  }
+});
+var _Headings = _interopRequireDefault(require("./Headings"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/build/cjs/parsedPaper/research/researches/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["_Headings","_interopRequireDefault","require","e","__esModule","default"],"sources":["../../../../../src/parsedPaper/research/researches/index.js"],"sourcesContent":["export { default as Headings } from \"./Headings\";\n"],"mappings":";;;;;;;;;;;AAAA,IAAAA,SAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAiD,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/build/cjs/parsedPaper/structure/tree/FormattingElement.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _SourceCodeLocation = _interopRequireDefault(require("./SourceCodeLocation"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Represents formatting elements (e.g. link, image, bold text) within a document.
+ *
+ * @memberOf module:parsedPaper/structure
+ */
+class FormattingElement {
+  /**
+   * Represents a formatting element (e.g. link, image, bold text) within a document.
+   *
+   * @param {string} type               The type of this element ("link", "image", "bold", etc.).
+   * @param {Object} sourceCodeLocation The parse5 formatted location of the element inside of the source code.
+   * @param {Object} [attributes=null]  The attributes (as key-value pairs, e.g. `{ href: '...' }` ).
+   */
+  constructor(type, sourceCodeLocation, attributes = null) {
+    /**
+     * Type of formatting element (e.g. "strong", "a").
+     * @type {string}
+     */
+    this.type = type;
+    /**
+     * Attributes of this element (e.g. "href", "id").
+     * @type {?Object}
+     */
+    this.attributes = attributes;
+    /**
+     * Location inside of the source code.
+     * @type {SourceCodeLocation}
+     */
+    this.sourceCodeLocation = new _SourceCodeLocation.default(sourceCodeLocation);
+    /**
+     * Start of this element's content within the parent textContainer's text.
+     * @type {?number}
+     */
+    this.textStartIndex = null;
+    /**
+     * End of this element's content within the parent textContainer's text.
+     * @type {?number}
+     */
+    this.textEndIndex = null;
+    /**
+     * This formatting element's parent.
+     * @type {LeafNode}
+     */
+    this.parent = null;
+  }
+
+  /**
+   * Returns the attribute with the given name if it exists.
+   *
+   * @param {string} name The name of the attribute.
+   *
+   * @returns {false|*} The attribute or `false` if the attribute does not exist.
+   */
+  getAttribute(name) {
+    if (!this.attributes) {
+      return false;
+    }
+    if (name in this.attributes) {
+      return this.attributes[name];
+    }
+    return false;
+  }
+}
+var _default = exports.default = FormattingElement;
+//# sourceMappingURL=FormattingElement.js.map

package/build/cjs/parsedPaper/structure/tree/FormattingElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormattingElement.js","names":["_SourceCodeLocation","_interopRequireDefault","require","e","__esModule","default","FormattingElement","constructor","type","sourceCodeLocation","attributes","SourceCodeLocation","textStartIndex","textEndIndex","parent","getAttribute","name","_default","exports"],"sources":["../../../../../src/parsedPaper/structure/tree/FormattingElement.js"],"sourcesContent":["import SourceCodeLocation from \"./SourceCodeLocation\";\n\n/**\n * Represents formatting elements (e.g. link, image, bold text) within a document.\n *\n * @memberOf module:parsedPaper/structure\n */\nclass FormattingElement {\n\t/**\n\t * Represents a formatting element (e.g. link, image, bold text) within a document.\n\t *\n\t * @param {string} type               The type of this element (\"link\", \"image\", \"bold\", etc.).\n\t * @param {Object} sourceCodeLocation The parse5 formatted location of the element inside of the source code.\n\t * @param {Object} [attributes=null]  The attributes (as key-value pairs, e.g. `{ href: '...' }` ).\n\t */\n\tconstructor( type, sourceCodeLocation, attributes = null ) {\n\t\t/**\n\t\t * Type of formatting element (e.g. \"strong\", \"a\").\n\t\t * @type {string}\n\t\t */\n\t\tthis.type = type;\n\t\t/**\n\t\t * Attributes of this element (e.g. \"href\", \"id\").\n\t\t * @type {?Object}\n\t\t */\n\t\tthis.attributes = attributes;\n\t\t/**\n\t\t * Location inside of the source code.\n\t\t * @type {SourceCodeLocation}\n\t\t */\n\t\tthis.sourceCodeLocation = new SourceCodeLocation( sourceCodeLocation );\n\t\t/**\n\t\t * Start of this element's content within the parent textContainer's text.\n\t\t * @type {?number}\n\t\t */\n\t\tthis.textStartIndex = null;\n\t\t/**\n\t\t * End of this element's content within the parent textContainer's text.\n\t\t * @type {?number}\n\t\t */\n\t\tthis.textEndIndex = null;\n\t\t/**\n\t\t * This formatting element's parent.\n\t\t * @type {LeafNode}\n\t\t */\n\t\tthis.parent = null;\n\t}\n\n\t/**\n\t * Returns the attribute with the given name if it exists.\n\t *\n\t * @param {string} name The name of the attribute.\n\t *\n\t * @returns {false|*} The attribute or `false` if the attribute does not exist.\n\t */\n\tgetAttribute( name ) {\n\t\tif ( ! this.attributes ) {\n\t\t\treturn false;\n\t\t}\n\t\tif ( name in this.attributes ) {\n\t\t\treturn this.attributes[ name ];\n\t\t}\n\t\treturn false;\n\t}\n}\n\nexport default FormattingElement;\n"],"mappings":";;;;;;AAAA,IAAAA,mBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAsD,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAEtD;AACA;AACA;AACA;AACA;AACA,MAAMG,iBAAiB,CAAC;EACvB;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,WAAWA,CAAEC,IAAI,EAAEC,kBAAkB,EAAEC,UAAU,GAAG,IAAI,EAAG;IAC1D;AACF;AACA;AACA;IACE,IAAI,CAACF,IAAI,GAAGA,IAAI;IAChB;AACF;AACA;AACA;IACE,IAAI,CAACE,UAAU,GAAGA,UAAU;IAC5B;AACF;AACA;AACA;IACE,IAAI,CAACD,kBAAkB,GAAG,IAAIE,2BAAkB,CAAEF,kBAAmB,CAAC;IACtE;AACF;AACA;AACA;IACE,IAAI,CAACG,cAAc,GAAG,IAAI;IAC1B;AACF;AACA;AACA;IACE,IAAI,CAACC,YAAY,GAAG,IAAI;IACxB;AACF;AACA;AACA;IACE,IAAI,CAACC,MAAM,GAAG,IAAI;EACnB;;EAEA;AACD;AACA;AACA;AACA;AACA;AACA;EACCC,YAAYA,CAAEC,IAAI,EAAG;IACpB,IAAK,CAAE,IAAI,CAACN,UAAU,EAAG;MACxB,OAAO,KAAK;IACb;IACA,IAAKM,IAAI,IAAI,IAAI,CAACN,UAAU,EAAG;MAC9B,OAAO,IAAI,CAACA,UAAU,CAAEM,IAAI,CAAE;IAC/B;IACA,OAAO,KAAK;EACb;AACD;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAb,OAAA,GAEcC,iBAAiB","ignoreList":[]}

package/build/cjs/parsedPaper/structure/tree/SourceCodeLocation.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+/**
+ * A location of an element in the source code.
+ */
+class SourceCodeLocation {
+  /**
+   * A location of an element in the source code.
+   *
+   * @param {Object?} startTag The location of the start tag of the element, if it has one.
+   * @param {number} startTag.startOffset The start position of the start tag.
+   * @param {number} startTag.endOffset The end position of the start tag.
+   *
+   * @param {Object?} endTag The location of the end tag of the element, if it has one.
+   * @param {number} endTag.startOffset The start position of the end tag.
+   * @param {number} endTag.endOffset The end position of the end tag.
+   *
+   * @param {Object} startOffset The start position of the element.
+   * @param {Object} endOffset The end position of the element.
+   */
+  constructor({
+    startTag,
+    endTag,
+    startOffset,
+    endOffset
+  }) {
+    if (startTag) {
+      this.startTag = {
+        startOffset: startTag.startOffset,
+        endOffset: startTag.endOffset
+      };
+    }
+    if (endTag) {
+      this.endTag = {
+        startOffset: endTag.startOffset,
+        endOffset: endTag.endOffset
+      };
+    }
+    this.startOffset = startOffset;
+    this.endOffset = endOffset;
+  }
+}
+var _default = exports.default = SourceCodeLocation;
+//# sourceMappingURL=SourceCodeLocation.js.map

package/build/cjs/parsedPaper/structure/tree/SourceCodeLocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceCodeLocation.js","names":["SourceCodeLocation","constructor","startTag","endTag","startOffset","endOffset","_default","exports","default"],"sources":["../../../../../src/parsedPaper/structure/tree/SourceCodeLocation.js"],"sourcesContent":["/**\n * A location of an element in the source code.\n */\nclass SourceCodeLocation {\n\t/**\n\t * A location of an element in the source code.\n\t *\n\t * @param {Object?} startTag The location of the start tag of the element, if it has one.\n\t * @param {number} startTag.startOffset The start position of the start tag.\n\t * @param {number} startTag.endOffset The end position of the start tag.\n\t *\n\t * @param {Object?} endTag The location of the end tag of the element, if it has one.\n\t * @param {number} endTag.startOffset The start position of the end tag.\n\t * @param {number} endTag.endOffset The end position of the end tag.\n\t *\n\t * @param {Object} startOffset The start position of the element.\n\t * @param {Object} endOffset The end position of the element.\n\t */\n\tconstructor( { startTag, endTag, startOffset, endOffset } ) {\n\t\tif ( startTag ) {\n\t\t\tthis.startTag = { startOffset: startTag.startOffset, endOffset: startTag.endOffset };\n\t\t}\n\t\tif ( endTag ) {\n\t\t\tthis.endTag = { startOffset: endTag.startOffset, endOffset: endTag.endOffset };\n\t\t}\n\t\tthis.startOffset = startOffset;\n\t\tthis.endOffset = endOffset;\n\t}\n}\n\nexport default SourceCodeLocation;\n"],"mappings":";;;;;;AAAA;AACA;AACA;AACA,MAAMA,kBAAkB,CAAC;EACxB;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACCC,WAAWA,CAAE;IAAEC,QAAQ;IAAEC,MAAM;IAAEC,WAAW;IAAEC;EAAU,CAAC,EAAG;IAC3D,IAAKH,QAAQ,EAAG;MACf,IAAI,CAACA,QAAQ,GAAG;QAAEE,WAAW,EAAEF,QAAQ,CAACE,WAAW;QAAEC,SAAS,EAAEH,QAAQ,CAACG;MAAU,CAAC;IACrF;IACA,IAAKF,MAAM,EAAG;MACb,IAAI,CAACA,MAAM,GAAG;QAAEC,WAAW,EAAED,MAAM,CAACC,WAAW;QAAEC,SAAS,EAAEF,MAAM,CAACE;MAAU,CAAC;IAC/E;IACA,IAAI,CAACD,WAAW,GAAGA,WAAW;IAC9B,IAAI,CAACC,SAAS,GAAGA,SAAS;EAC3B;AACD;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcR,kBAAkB","ignoreList":[]}

package/build/cjs/parsedPaper/structure/tree/TextContainer.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _lodash = require("lodash");
+var _parseText = require("../../build/linguisticParsing/parseText");
+/**
+ * Represents a text (with optional formatting element(s)) within a document that can be read by a reader.
+ *
+ * Example (in the case of HTML):
+ * ```html
+ * This text is <strong id="elem-id">very strong</strong>.
+ * ```
+ * is transformed to:
+ * ```js
+ * TextContainer {
+ *     text: "This text is very strong".
+ *     formatting: [
+ *         FormattingElement {
+ *             type: "strong",
+ *             sourceStartIndex: 13, // "This text is ".length
+ *             sourceEndIndex: 54,   // "This text is <strong id="elem-id">very strong</strong>".length
+ *             textStartIndex: 13,  // "This text is ".length
+ *             textEndIndex: 24,    // "This text is very strong".length
+ *             attributes: {
+ *                 id: "elem-id"
+ *             }
+ *         }
+ *     ]
+ * }
+ * ```
+ *
+ * @memberOf module:parsedPaper/structure
+ */
+class TextContainer {
+  /**
+   * Represents a text (with optional formatting element(s)) within a document that can be read by a reader.
+   */
+  constructor() {
+    /**
+     * Clean, analyzable text, without formatting.
+     * @type {string}
+     */
+    this.text = "";
+    /**
+     * This text's formatting (e.g. bold text, links, etc.).
+     * @type {Array<module:parsedPaper/structure.FormattingElement>}
+     */
+    this.formatting = [];
+
+    /**
+     * A cache for the tree representations of this container's text.
+     */
+    this._tree = {};
+  }
+
+  /**
+   * Adds a text string to this container's text.
+   *
+   * @param {string} text The text to be added to the TextContainer.
+   *
+   * @returns {void}
+   */
+  appendText(text) {
+    // If the text changes, the 'linguistic' tree should be rebuilt. This means the cache should be cleared.
+    this.text += text;
+    this._tree = {};
+  }
+
+  /**
+   * Returns the tree representation of this container's text.
+   *
+   * If the cache is filled, it will return the cached tree.
+   * If the cache is empty, it will additionally construct the tree and fill the cache.
+   *
+   * @returns {Object} The tree representation of the text.
+   */
+  getTree() {
+    if (!(0, _lodash.isEmpty)(this._tree)) {
+      return this._tree;
+    }
+    this._tree = (0, _parseText.parseTextIntoSentences)(this.text);
+    return this._tree;
+  }
+}
+var _default = exports.default = TextContainer;
+//# sourceMappingURL=TextContainer.js.map