@bartificer/linkify 2.4.0 → 2.4.1

package/docs/Linkifier.class.mjs.html

@@ -43,7 +43,7 @@
     <input type="text" id="nav-search" placeholder="Search" />
     
     
-    <h2><a href="index.html">Home</a></h2><h2><a href="https://github.com/bartificer/linkify" target="_blank" >On GitHub</a></h2><h2><a href="https://bartificer.net/" target="_blank" >Bartificer Creations</a></h2><h3>Modules</h3><ul><li><a href="module-defaults.html">defaults</a><ul class='members'><li data-type='member'><a href="module-defaults.html#.linkTemplates">linkTemplates</a></li><li data-type='member'><a href="module-defaults.html#.smallWords">smallWords</a></li><li data-type='member'><a href="module-defaults.html#.speciallyCapitalisedWords">speciallyCapitalisedWords</a></li></ul></li><li><a href="module-link-data.html">link-data</a></li><li><a href="module-link-template.html">link-template</a></li><li><a href="module-linkifier.html">linkifier</a></li><li><a href="module-linkify.html">linkify</a><ul class='members'><li data-type='member'><a href="module-linkify.html#.LinkData">LinkData</a></li><li data-type='member'><a href="module-linkify.html#.LinkTemplate">LinkTemplate</a></li><li data-type='member'><a href="module-linkify.html#.Linkifier">Linkifier</a></li><li data-type='member'><a href="module-linkify.html#.PageData">PageData</a></li><li data-type='member'><a href="module-linkify.html#.VERSION">VERSION</a></li><li data-type='member'><a href="module-linkify.html#.default">default</a></li><li data-type='member'><a href="module-linkify.html#.linkify">linkify</a></li></ul></li><li><a href="module-page-data.html">page-data</a></li><li><a href="module-utilities.html">utilities</a><ul class='methods'><li data-type='method'><a href="module-utilities.html#.batchFixCustomWordCases">batchFixCustomWordCases</a></li><li data-type='method'><a href="module-utilities.html#.escapeRegex">escapeRegex</a></li><li data-type='method'><a href="module-utilities.html#.extractSlug">extractSlug</a></li><li data-type='method'><a href="module-utilities.html#.regulariseWhitespace">regulariseWhitespace</a></li><li data-type='method'><a href="module-utilities.html#.stripQueryString">stripQueryString</a></li><li data-type='method'><a href="module-utilities.html#.stripUTMParameters">stripUTMParameters</a></li><li data-type='method'><a href="module-utilities.html#.toTitleCase">toTitleCase</a></li></ul></li></ul><h3>Classes</h3><ul><li><a href="module-link-data.LinkData.html">LinkData</a><ul class='methods'><li data-type='method'><a href="module-link-data.LinkData.html#asPlainObject">asPlainObject</a></li></ul></li><li><a href="module-link-template.LinkTemplate.html">LinkTemplate</a><ul class='methods'><li data-type='method'><a href="module-link-template.LinkTemplate.html#addFilter">addFilter</a></li><li data-type='method'><a href="module-link-template.LinkTemplate.html#filtersFor">filtersFor</a></li></ul></li><li><a href="module-linkifier.Linkifier.html">Linkifier</a><ul class='methods'><li data-type='method'><a href="module-linkifier.Linkifier.html#fetchPageData">fetchPageData</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#generateLink">generateLink</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplate">getTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplateNameForDomain">getTemplateNameForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTransformerForDomain">getTransformerForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerDefaultTemplateMapping">registerDefaultTemplateMapping</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTemplate">registerTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTransformer">registerTransformer</a></li></ul></li><li><a href="module-page-data.PageData.html">PageData</a><ul class='methods'><li data-type='method'><a href="module-page-data.PageData.html#addSecondaryHeading">addSecondaryHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#addTopLevelHeading">addTopLevelHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#asPlainObject">asPlainObject</a></li><li data-type='method'><a href="module-page-data.PageData.html#h1">h1</a></li><li data-type='method'><a href="module-page-data.PageData.html#h2">h2</a></li></ul></li></ul><h3>Externals</h3><ul><li><a href="module-cheerio.html">cheerio</a></li><li><a href="module-mustache.html">mustache</a></li><li><a href="module-node-fetch.html">node-fetch</a></li><li><a href="module-title-case.html">title-case</a></li><li><a href="module-urijs.html">urijs</a></li><li><a href="module-url-slug.html">url-slug</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h2><a href="https://github.com/bartificer/linkify" target="_blank" >On GitHub</a></h2><h2><a href="https://bartificer.net/" target="_blank" >Bartificer Creations</a></h2><h3>Modules</h3><ul><li><a href="module-defaults.html">defaults</a><ul class='members'><li data-type='member'><a href="module-defaults.html#.linkTemplates">linkTemplates</a></li><li data-type='member'><a href="module-defaults.html#.smallWords">smallWords</a></li><li data-type='member'><a href="module-defaults.html#.speciallyCapitalisedWords">speciallyCapitalisedWords</a></li></ul><ul class='methods'><li data-type='method'><a href="module-defaults.html#.dataTransformer">dataTransformer</a></li></ul></li><li><a href="module-link-data.html">link-data</a></li><li><a href="module-link-template.html">link-template</a></li><li><a href="module-linkifier.html">linkifier</a></li><li><a href="module-linkify.html">linkify</a><ul class='members'><li data-type='member'><a href="module-linkify.html#.LinkData">LinkData</a></li><li data-type='member'><a href="module-linkify.html#.LinkTemplate">LinkTemplate</a></li><li data-type='member'><a href="module-linkify.html#.Linkifier">Linkifier</a></li><li data-type='member'><a href="module-linkify.html#.PageData">PageData</a></li><li data-type='member'><a href="module-linkify.html#.VERSION">VERSION</a></li><li data-type='member'><a href="module-linkify.html#.default">default</a></li><li data-type='member'><a href="module-linkify.html#.linkify">linkify</a></li></ul></li><li><a href="module-page-data.html">page-data</a></li><li><a href="module-utilities.html">utilities</a><ul class='methods'><li data-type='method'><a href="module-utilities.html#.batchFixCustomWordCases">batchFixCustomWordCases</a></li><li data-type='method'><a href="module-utilities.html#.escapeRegex">escapeRegex</a></li><li data-type='method'><a href="module-utilities.html#.extractSlug">extractSlug</a></li><li data-type='method'><a href="module-utilities.html#.regulariseWhitespace">regulariseWhitespace</a></li><li data-type='method'><a href="module-utilities.html#.stripQueryString">stripQueryString</a></li><li data-type='method'><a href="module-utilities.html#.stripUTMParameters">stripUTMParameters</a></li><li data-type='method'><a href="module-utilities.html#.toTitleCase">toTitleCase</a></li></ul></li></ul><h3>Classes</h3><ul><li><a href="module-link-data.LinkData.html">LinkData</a><ul class='methods'><li data-type='method'><a href="module-link-data.LinkData.html#asPlainObject">asPlainObject</a></li></ul></li><li><a href="module-link-template.LinkTemplate.html">LinkTemplate</a><ul class='methods'><li data-type='method'><a href="module-link-template.LinkTemplate.html#addFilter">addFilter</a></li><li data-type='method'><a href="module-link-template.LinkTemplate.html#filtersFor">filtersFor</a></li></ul></li><li><a href="module-linkifier.Linkifier.html">Linkifier</a><ul class='methods'><li data-type='method'><a href="module-linkifier.Linkifier.html#fetchPageData">fetchPageData</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#generateLink">generateLink</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplate">getTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplateNameForDomain">getTemplateNameForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTransformerForDomain">getTransformerForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerDefaultTemplateMapping">registerDefaultTemplateMapping</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTemplate">registerTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTransformer">registerTransformer</a></li></ul></li><li><a href="module-page-data.PageData.html">PageData</a><ul class='methods'><li data-type='method'><a href="module-page-data.PageData.html#addSecondaryHeading">addSecondaryHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#addTopLevelHeading">addTopLevelHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#asPlainObject">asPlainObject</a></li><li data-type='method'><a href="module-page-data.PageData.html#h1">h1</a></li><li data-type='method'><a href="module-page-data.PageData.html#h2">h2</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#dataTransformer">dataTransformer</a></li><li><a href="global.html#plainLinkInformationObject">plainLinkInformationObject</a></li><li><a href="global.html#plainPageInformationObject">plainPageInformationObject</a></li><li><a href="global.html#templateFieldFilterFunction">templateFieldFilterFunction</a></li><li><a href="global.html#templateFieldFilterTuple">templateFieldFilterTuple</a></li></ul><h3>Externals</h3><ul><li><a href="module-cheerio.html">cheerio</a></li><li><a href="module-mustache.html">mustache</a></li><li><a href="module-node-fetch.html">node-fetch</a></li><li><a href="module-title-case.html">title-case</a></li><li><a href="module-urijs.html">urijs</a></li><li><a href="module-url-slug.html">url-slug</a></li></ul>
     
 </nav>
 
@@ -89,28 +89,26 @@ import Mustache from 'mustache';
  * The class providing the link rendering functionality. Instances of this class capture the settings for generating links, and, generate links using these settings.
  */
 export class Linkifier {
+    /**
+     * Builds a Linkifier instance ready for use rendering links using the default configration.
+     * @see {@link module:defaults} for the default configuration settings.
+     */
     constructor(){
         /**
-         * A mapping of domain names to data transformation functions.
+         * A mapping of fully qualified domain names to data transformation functions.
          *
          * @private
-         * @type {Object.&lt;FQDN, dataTransformer>}
+         * @type {Object.&lt;string, dataTransformer>}
          */
         this._pageDataToLinkDataTransmformers = {
-            '.' : function(pData){
-                let text = pData.title;
-                if(pData.h1s.length === 1){
-                    text = pData.mainHeading;
-                }
-                return new LinkData(pData.url, text);
-            }
+            '.' : defaults.dataTransformer
         };
 
         /**
-         * A mapping of domains names to default template names.
+         * A mapping of fully qualified domain names to default template names.
          * 
          * @private
-         * @type {Object.&lt;FQDN, templateName>}
+         * @type {Object.&lt;string, string>}
          */
         this._pageDataToLinkTemplateName = {
             '.' : 'html' // default to the 'html' template for all domains unless otherwise specified
@@ -120,7 +118,7 @@ export class Linkifier {
          * The registered link templates.
          *
          * @private
-         * @type {Object.&lt;templateName, module:@bartificer/linkify.LinkTemplate>}
+         * @type {Object.&lt;string, module:link-template.LinkTemplate>}
          */
         this._linkTemplates = {};
 
@@ -151,30 +149,30 @@ export class Linkifier {
 
     /**
      * @type {Object.&lt;string, Function>}
+     * @readonly
+     * @see {@link module:utilities} for the utility functions available in this collection.
      */
     get utilities() {
         return this._utilities;
     }
 
     /**
-     * @see Linfifier.utilities
+     * Shorthand property for `.utilities`.
+     * @see {@link module:linkifier.Linkifier#utilities}
      */
     get util(){
         return this._utilities;
     }
 
     /**
-     * @returns {string[]} The current list of known words with special capitalisations.
+     * The list of known words with special capitalisations. The words should be capitalised in the descired manner.
+     * @type {string[]}
      */
     get speciallyCapitalisedWords(){
         const ans = [];
         this._speciallyCapitalisedWords.map(word => ans.push(word));
         return ans;
     }
-
-    /**
-     * @param {string[]} words - a list of words with special capitalisations
-     */
     set speciallyCapitalisedWords(words){
         // TO DO - add validation
 
@@ -182,13 +180,11 @@ export class Linkifier {
     }
 
     /**
-     * Register a data transformer function for a given domain.
+     * Register a data transformer function to a domain name.
      *
-     * @param {domainName} domain - The domain for which this transformer should be
+     * @param {string} domain - The fully qualified domain for which this transformer should be
      * used.
      * @param {dataTransformer} transformerFn - The data transformer callback.
-     * @throws {ValidationError} A validation error is thrown if either parameter
-     * is missing or invalid.
      */
     registerTransformer(domain, transformerFn){
         // TO DO - add validation
@@ -204,16 +200,14 @@ export class Linkifier {
      * Get the data transformer function for a given domain.
      *
      * Note that domains are searched from the subdomain up. For example, if passed
-     * the domain `www.bartificer.net` the function will first look for a
-     * transformer for the domain `www.bartificer.net`, if there's no transformer
+     * the domain `www.bartificer.ie` the function will first look for a
+     * transformer for the domain `www.bartificer.ie`, if there's no transformer
      * registered for that domain it will look for a transformer for the domain
-     * `bartificer.net`, if there's no transformer for that domain either it will
+     * `bartificer.ie`, if there's no transformer for that domain either it will
      * return the default transformer.
      *
-     * @param {domainName} domain - The domain to get the data transformer for.
+     * @param {string} domain - The fully qualified domain for which to get the data transformer.
      * @returns {dataTransformer}
-     * @throws {ValidationError} A validation error is thrown unless a valid domain
-     * name is passed.
      */
     getTransformerForDomain(domain){
         // TO DO - add validation
@@ -239,22 +233,20 @@ export class Linkifier {
     /**
      * A list of the names of the registered link templates.
      * @type {string[]}
+     * @readonly
      */
     get templateNames() {
         return Object.keys(this._linkTemplates);
     }
 
     /**
-     * @returns {string} The name of the default template.
+     * The name of the default template used when rendering links.
+     * @type {string}
+     * @throws {ValidationError} A validation error is thrown if the template name is missing, invalid, or doesn't correspond to a registered template.
      */
     get defaultTemplateName(){
         return this._pageDataToLinkTemplateName['.'];
     }
-
-    /**
-     * @param {string} templateName - The name of the default template to use.
-     * @throws {ValidationError} A validation error is thrown if the template name is missing, invalid, or doesn't correspond to a registered template.
-     */
     set defaultTemplateName(templateName){
         const tplName = String(templateName);
         if(!this._linkTemplates[tplName]){
@@ -265,7 +257,8 @@ export class Linkifier {
     
     /**
      * The default link template.
-     * @type {module:LinkTemplate.class.LinkTemplate}
+     * @type {module:link-template.LinkTemplate}
+     * @readonly
      */
     get defaultTemplate(){
         return this._linkTemplates[this._pageDataToLinkTemplateName['.']];
@@ -275,9 +268,7 @@ export class Linkifier {
      * Register a link template.
      *
      * @param {string} name
-     * @param {LinkTemplate} template
-     * @throws {ValidationError} A validation error is thrown unless both a valid
-     * name and template object are passed.
+     * @param {module:link-template.LinkTemplate} template
      */
     registerTemplate(name, template){
         // TO DO - add validation
@@ -290,7 +281,7 @@ export class Linkifier {
      * Get a registered link template by name.
      *
      * @param {string} templateName
-     * @returns {LinkTemplate}
+     * @returns {module:link-template.LinkTemplate}
      * @throws {ValidationError} A validation error is thrown unless a valid name is passed and corresponds to a registered template.
      */
     getTemplate(templateName){
@@ -306,10 +297,8 @@ export class Linkifier {
      * Register a default template for use with a given domain. This template will
      * override the overall default for this domain and all its subdomains.
      *
-     * @param {domainName} domain - The domain for which this template should be used by default.
-     * @param {templateName} templateName - The name of the template to use.
-     * @throws {ValidationError} A validation error is thrown if either parameter
-     * is missing or invalid.
+     * @param {string} domain - The fully qualified domain name for which this template should be used by default.
+     * @param {string} templateName - The name of the template to use.
      */
     registerDefaultTemplateMapping(domain, templateName){
         // TO DO - add validation
@@ -325,16 +314,14 @@ export class Linkifier {
      * Get the data transformer function for a given domain.
      *
      * Note that domains are searched from the subdomain up. For example, if passed
-     * the domain `www.bartificer.net` the function will first look for a
-     * transformer for the domain `www.bartificer.net`, if there's no transformer
+     * the domain `www.bartificer.ie` the function will first look for a
+     * transformer for the domain `www.bartificer.ie`, if there's no transformer
      * registered for that domain it will look for a transformer for the domain
-     * `bartificer.net`, if there's no transformer for that domain either it will
+     * `bartificer.ie`, if there's no transformer for that domain either it will
      * return the default transformer.
      *
-     * @param {domainName} domain - The domain to get the data transformer for.
+     * @param {string} domain - The fully qualified domain name to get the data transformer for.
      * @returns {dataTransformer}
-     * @throws {ValidationError} A validation error is thrown unless a valid domain
-     * name is passed.
      */
     getTemplateNameForDomain(domain){
         // TO DO - add validation
@@ -369,10 +356,8 @@ export class Linkifier {
      * Fetch the page data for a given URL.
      *
      * @async
-     * @param {URL} url
-     * @returns {PageData}
-     * @throws {ValidationError} A validation error is thrown unless a valid URL is
-     * passed.
+     * @param {string} url
+     * @returns {module:page-data.PageData}
      */
     async fetchPageData(url){
         // TO DO - add validation
@@ -412,11 +397,9 @@ export class Linkifier {
      * default will be used (`html`).
      *
      * @async
-     * @param {URL} url
-     * @param {templateName} [templateName='html']
+     * @param {string} url
+     * @param {string} [templateName='html']
      * @returns {string}
-     * @throws {ValidationError} A validation error is thrown unless a valid URL is
-     * passed.
      */
     async generateLink(url, templateName){
         // TO DO - add validation
@@ -482,7 +465,7 @@ export class Linkifier {
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Apr 13 2026 16:45:07 GMT+0100 (Irish Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Apr 15 2026 17:49:51 GMT+0100 (Irish Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
@@ -495,5 +478,9 @@ export class Linkifier {
 
     <link type="text/css" rel="stylesheet" href="./docdash-overrides.css">
     
+    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+    
+    <script src="./mermaid-init.js"></script>
+    
 </body>
 </html>

package/docs/PageData.class.mjs.html

@@ -43,7 +43,7 @@
     <input type="text" id="nav-search" placeholder="Search" />
     
     
-    <h2><a href="index.html">Home</a></h2><h2><a href="https://github.com/bartificer/linkify" target="_blank" >On GitHub</a></h2><h2><a href="https://bartificer.net/" target="_blank" >Bartificer Creations</a></h2><h3>Modules</h3><ul><li><a href="module-defaults.html">defaults</a><ul class='members'><li data-type='member'><a href="module-defaults.html#.linkTemplates">linkTemplates</a></li><li data-type='member'><a href="module-defaults.html#.smallWords">smallWords</a></li><li data-type='member'><a href="module-defaults.html#.speciallyCapitalisedWords">speciallyCapitalisedWords</a></li></ul></li><li><a href="module-link-data.html">link-data</a></li><li><a href="module-link-template.html">link-template</a></li><li><a href="module-linkifier.html">linkifier</a></li><li><a href="module-linkify.html">linkify</a><ul class='members'><li data-type='member'><a href="module-linkify.html#.LinkData">LinkData</a></li><li data-type='member'><a href="module-linkify.html#.LinkTemplate">LinkTemplate</a></li><li data-type='member'><a href="module-linkify.html#.Linkifier">Linkifier</a></li><li data-type='member'><a href="module-linkify.html#.PageData">PageData</a></li><li data-type='member'><a href="module-linkify.html#.VERSION">VERSION</a></li><li data-type='member'><a href="module-linkify.html#.default">default</a></li><li data-type='member'><a href="module-linkify.html#.linkify">linkify</a></li></ul></li><li><a href="module-page-data.html">page-data</a></li><li><a href="module-utilities.html">utilities</a><ul class='methods'><li data-type='method'><a href="module-utilities.html#.batchFixCustomWordCases">batchFixCustomWordCases</a></li><li data-type='method'><a href="module-utilities.html#.escapeRegex">escapeRegex</a></li><li data-type='method'><a href="module-utilities.html#.extractSlug">extractSlug</a></li><li data-type='method'><a href="module-utilities.html#.regulariseWhitespace">regulariseWhitespace</a></li><li data-type='method'><a href="module-utilities.html#.stripQueryString">stripQueryString</a></li><li data-type='method'><a href="module-utilities.html#.stripUTMParameters">stripUTMParameters</a></li><li data-type='method'><a href="module-utilities.html#.toTitleCase">toTitleCase</a></li></ul></li></ul><h3>Classes</h3><ul><li><a href="module-link-data.LinkData.html">LinkData</a><ul class='methods'><li data-type='method'><a href="module-link-data.LinkData.html#asPlainObject">asPlainObject</a></li></ul></li><li><a href="module-link-template.LinkTemplate.html">LinkTemplate</a><ul class='methods'><li data-type='method'><a href="module-link-template.LinkTemplate.html#addFilter">addFilter</a></li><li data-type='method'><a href="module-link-template.LinkTemplate.html#filtersFor">filtersFor</a></li></ul></li><li><a href="module-linkifier.Linkifier.html">Linkifier</a><ul class='methods'><li data-type='method'><a href="module-linkifier.Linkifier.html#fetchPageData">fetchPageData</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#generateLink">generateLink</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplate">getTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplateNameForDomain">getTemplateNameForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTransformerForDomain">getTransformerForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerDefaultTemplateMapping">registerDefaultTemplateMapping</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTemplate">registerTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTransformer">registerTransformer</a></li></ul></li><li><a href="module-page-data.PageData.html">PageData</a><ul class='methods'><li data-type='method'><a href="module-page-data.PageData.html#addSecondaryHeading">addSecondaryHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#addTopLevelHeading">addTopLevelHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#asPlainObject">asPlainObject</a></li><li data-type='method'><a href="module-page-data.PageData.html#h1">h1</a></li><li data-type='method'><a href="module-page-data.PageData.html#h2">h2</a></li></ul></li></ul><h3>Externals</h3><ul><li><a href="module-cheerio.html">cheerio</a></li><li><a href="module-mustache.html">mustache</a></li><li><a href="module-node-fetch.html">node-fetch</a></li><li><a href="module-title-case.html">title-case</a></li><li><a href="module-urijs.html">urijs</a></li><li><a href="module-url-slug.html">url-slug</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h2><a href="https://github.com/bartificer/linkify" target="_blank" >On GitHub</a></h2><h2><a href="https://bartificer.net/" target="_blank" >Bartificer Creations</a></h2><h3>Modules</h3><ul><li><a href="module-defaults.html">defaults</a><ul class='members'><li data-type='member'><a href="module-defaults.html#.linkTemplates">linkTemplates</a></li><li data-type='member'><a href="module-defaults.html#.smallWords">smallWords</a></li><li data-type='member'><a href="module-defaults.html#.speciallyCapitalisedWords">speciallyCapitalisedWords</a></li></ul><ul class='methods'><li data-type='method'><a href="module-defaults.html#.dataTransformer">dataTransformer</a></li></ul></li><li><a href="module-link-data.html">link-data</a></li><li><a href="module-link-template.html">link-template</a></li><li><a href="module-linkifier.html">linkifier</a></li><li><a href="module-linkify.html">linkify</a><ul class='members'><li data-type='member'><a href="module-linkify.html#.LinkData">LinkData</a></li><li data-type='member'><a href="module-linkify.html#.LinkTemplate">LinkTemplate</a></li><li data-type='member'><a href="module-linkify.html#.Linkifier">Linkifier</a></li><li data-type='member'><a href="module-linkify.html#.PageData">PageData</a></li><li data-type='member'><a href="module-linkify.html#.VERSION">VERSION</a></li><li data-type='member'><a href="module-linkify.html#.default">default</a></li><li data-type='member'><a href="module-linkify.html#.linkify">linkify</a></li></ul></li><li><a href="module-page-data.html">page-data</a></li><li><a href="module-utilities.html">utilities</a><ul class='methods'><li data-type='method'><a href="module-utilities.html#.batchFixCustomWordCases">batchFixCustomWordCases</a></li><li data-type='method'><a href="module-utilities.html#.escapeRegex">escapeRegex</a></li><li data-type='method'><a href="module-utilities.html#.extractSlug">extractSlug</a></li><li data-type='method'><a href="module-utilities.html#.regulariseWhitespace">regulariseWhitespace</a></li><li data-type='method'><a href="module-utilities.html#.stripQueryString">stripQueryString</a></li><li data-type='method'><a href="module-utilities.html#.stripUTMParameters">stripUTMParameters</a></li><li data-type='method'><a href="module-utilities.html#.toTitleCase">toTitleCase</a></li></ul></li></ul><h3>Classes</h3><ul><li><a href="module-link-data.LinkData.html">LinkData</a><ul class='methods'><li data-type='method'><a href="module-link-data.LinkData.html#asPlainObject">asPlainObject</a></li></ul></li><li><a href="module-link-template.LinkTemplate.html">LinkTemplate</a><ul class='methods'><li data-type='method'><a href="module-link-template.LinkTemplate.html#addFilter">addFilter</a></li><li data-type='method'><a href="module-link-template.LinkTemplate.html#filtersFor">filtersFor</a></li></ul></li><li><a href="module-linkifier.Linkifier.html">Linkifier</a><ul class='methods'><li data-type='method'><a href="module-linkifier.Linkifier.html#fetchPageData">fetchPageData</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#generateLink">generateLink</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplate">getTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTemplateNameForDomain">getTemplateNameForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#getTransformerForDomain">getTransformerForDomain</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerDefaultTemplateMapping">registerDefaultTemplateMapping</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTemplate">registerTemplate</a></li><li data-type='method'><a href="module-linkifier.Linkifier.html#registerTransformer">registerTransformer</a></li></ul></li><li><a href="module-page-data.PageData.html">PageData</a><ul class='methods'><li data-type='method'><a href="module-page-data.PageData.html#addSecondaryHeading">addSecondaryHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#addTopLevelHeading">addTopLevelHeading</a></li><li data-type='method'><a href="module-page-data.PageData.html#asPlainObject">asPlainObject</a></li><li data-type='method'><a href="module-page-data.PageData.html#h1">h1</a></li><li data-type='method'><a href="module-page-data.PageData.html#h2">h2</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#dataTransformer">dataTransformer</a></li><li><a href="global.html#plainLinkInformationObject">plainLinkInformationObject</a></li><li><a href="global.html#plainPageInformationObject">plainPageInformationObject</a></li><li><a href="global.html#templateFieldFilterFunction">templateFieldFilterFunction</a></li><li><a href="global.html#templateFieldFilterTuple">templateFieldFilterTuple</a></li></ul><h3>Externals</h3><ul><li><a href="module-cheerio.html">cheerio</a></li><li><a href="module-mustache.html">mustache</a></li><li><a href="module-node-fetch.html">node-fetch</a></li><li><a href="module-title-case.html">title-case</a></li><li><a href="module-urijs.html">urijs</a></li><li><a href="module-url-slug.html">url-slug</a></li></ul>
     
 </nav>
 
@@ -60,28 +60,27 @@
     <section>
         <article>
             <pre class="prettyprint source linenums"><code>/**
- * @file The definition of the class representing a web page.
+ * @file Data model for web page information.
  * @author Bart Busschots &lt;opensource@bartificer.ie>
  * @license MIT
  */
 
 /**
- * This module provides as class for representing the information extracted from web pages which can be used to generate the link data avaiable for rendering links.
+ * This module provides the class for representing the information that is extracted from web pages.
  * @module page-data
  * @requires module:urijs
  */
 import {default as URI} from 'urijs';
 
 /**
- * A class representing the data extracted from web pages that can be transformed into link data for use when rendering links.
+ * The information extracted from web pages that can be used to render a link.
+ * 
+ * Instances of this class are created from the information extracted from web pages and converted to link information by data transformers before being rendered to links via templates.
+ * @see {@link dataTransformer} for details of how instances of this class are used in the link generation process.
  */
 export class PageData {
     /**
-     * This constructor throws a {@link ValidationError} unless a valid URL is passed.
-     *
-     * @param {URL} url - The page's full URL.
-     * @throws {ValidationError} A validation error is thrown if an invalid URL
-     * is passed.
+     * @param {string} url - The page's full URL.
      */
     constructor(url){
         // TO DO - add validation
@@ -90,7 +89,7 @@ export class PageData {
          * The page's URL as a URI object.
          *
          * @private
-         * @type {URIObject}
+         * @type {module:urijs}
          */
         this._uri = URI();
         
@@ -107,74 +106,73 @@ export class PageData {
          * `h1` and `h2`.
          * 
          * @private
-         * @type {plainObject}
+         * @type {Object}
+         * @property {string[]} h1 - The page's top-level headings (`h1` tags).
+         * @property {string[]} h2 - The page's secondary headings (`h2` tags).
          */
         this._headings = {
             h1: [],
             h2: []
         };
         
-        // store the URL
+        // store the URL using the public setter to ensure it's stored as a URI object
         this.url = url;
     }
     
     /**
-     * @returns {string}
+     * @type {string}
+     * @throws {TypeError} on invalid URLs.
      */
     get url(){
         return this._uri.toString();
     }
-
-    /**
-     * @param {string} url - A URL as a string.
-     * @throws {ValidationError} A validation error is thrown if an argument
-     * is passed that's not a valid URL string.
-     */
     set url(url){
         this._uri = URI(url).normalize();
     }
     
     /**
-     * @returns {Object} A URI.js object.
+     * @type {module:urijs}
+     * @readonly
      */
     get uri(){
         return this._uri.clone();
     }
     
     /**
-     * Get the domain-part of the URL as a string.
-     * 
-     * @returns {string} The domain-part of the URL.
+     * The domain-part of the URL.
+     * @type {string}
+     * @readonly
      */
     get domain(){
         return this._uri.hostname();
     }
     
     /**
-     * @returns {string} The path-part of the URL.
+     * The path-part of the URL.
+     * @type {string}
+     * @readonly
      */
     get path(){
         return this._uri.path();
     }
     
     /**
-     * @returns {string}
+     * The page's title. Values are coerced to strings with `String(title)`.
+     * @type {string}
      */
     get title(){
         return this._title;
     }
-
-    /**
-     * @param {string} title - the page's title as a string. Values passed will be coerced to strings.
-     */
     set title(title){
         this._title = String(title);
     }
     
     /**
-     * Get the page's section headings.
-     * 
-     * @returns {Object} A plain object containing arrays of strings indexed by `h1` and `h2`.
+     * The page's primary and secondary headings.
+     * @type {Object}
+     * @property {string[]} h1 - The page's top-level headings (`h1` tags).
+     * @property {string[]} h2 - The page's secondary headings (`h2` tags).
+     * @readonly
      */
     get headings(){
         let ans = {
@@ -192,8 +190,8 @@ export class PageData {
     
     /**
      * The page's top-level headings (`h1` tags).
-     *
-     * @returns {string[]}
+     * @type {string[]}
+     * @readonly
      */
     get topLevelHeadings(){
         var ans = [];
@@ -205,7 +203,8 @@ export class PageData {
 
     /**
      * An alias for `.topLevelHeadings`.
-     * @see PageData#topLevelHeadings
+     * @readonly
+     * @see {@link module:page-data.PageData#topLevelHeadings}
      */
     get h1s(){
         return this.topLevelHeadings;
@@ -213,8 +212,8 @@ export class PageData {
 
     /**
      * The page's secondary headings (`h2` tags).
-     *
-     * @returns {string[]}
+     * @type {string[]}
+     * @readonly
      */
     get secondaryHeadings(){
         var ans = [];
@@ -226,8 +225,9 @@ export class PageData {
 
     /**
      * An alias for `.secondaryHeadings`.
-     * @see PageData#secondaryHeadings
-    */
+     * @readonly
+     * @see {@link module:page-data.PageData#secondaryHeadings}
+     */
     get h2s(){
         return this.secondaryHeadings;
     }
@@ -237,8 +237,8 @@ export class PageData {
      * has `h1` tags, the first one will be used, if not, the first `h2` tag
      * will be used, and if there's none of those either, an empty string will
      * be returned.
-     * 
-     * @returns {string} Heading text as a string, or an empty string.
+     * @type {string}
+     * @readonly
      */
     get mainHeading(){
         if(this._headings.h1.length > 0){
@@ -254,7 +254,7 @@ export class PageData {
      * Add a top-level heading.
      *
      * @param {string} h1Text
-     * @returns {PageData} A reference to self to 
+     * @returns {module:page-data.PageData} A reference to self to 
      * facilitate function chaning.
      */
     addTopLevelHeading(h1Text){
@@ -267,7 +267,7 @@ export class PageData {
      * Add a seconary heading.
      *
      * @param {string} h2Text
-     * @returns {PageData} A reference to self to 
+     * @returns {module:page-data.PageData} A reference to self to 
      * facilitate function chaning.
      */
     addSecondaryHeading(h2Text){
@@ -277,27 +277,8 @@ export class PageData {
     }
 
     /**
-     * Get the page data as a plain object of the form:
-     * ```
-     * {
-     *     url: 'http://www.bartificer.net/',
-     *     title: 'the page title',
-     *     topLevelHeadings: [ 'first h1', 'second h1' ],
-     *     secondaryHeadings: [ 'first h2', 'second h2' ],
-     *     mainHeading: 'first h1',
-     *     uri: {
-     *         hostname: 'www.bartificer.net',
-     *         path: '/',
-     *         hasPath: false
-     *     }
-     * }
-     * ```
-     *
-     * Note that the `uri` could contain more fields - it's initialised with
-     * output from the `URI.parse()` function from the `URI` module.
-     * 
-     * @returns {Object} A plain object containing the page data.
-     * @see {@link https://medialize.github.io/URI.js/docs.html#static-parse}
+     * Get the page data as a plain object.
+     * @returns {plainPageInformationObject}
      */
     asPlainObject(){
         let ans = {
@@ -315,18 +296,18 @@ export class PageData {
 
 /**
  * A shortcut for `.addTopLevelHeading()`.
- *
+ * @name module:page-data.PageData#h1
  * @function
- * @see PageData#addTopLevelHeading
+ * @see {@link module:page-data.PageData#addTopLevelHeading}
  * 
  */
 PageData.prototype.h1 = PageData.prototype.addTopLevelHeading;
 
 /**
  * A shortcut for `.addSecondaryHeading()`.
- *
+ * @name module:page-data.PageData#h2
  * @function
- * @see PageData#addSecondaryHeading
+ * @see {@link module:page-data.PageData#addSecondaryHeading}
  * 
  */
 PageData.prototype.h2 = PageData.prototype.addSecondaryHeading;</code></pre>
@@ -343,7 +324,7 @@ PageData.prototype.h2 = PageData.prototype.addSecondaryHeading;</code></pre>
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Mon Apr 13 2026 16:45:07 GMT+0100 (Irish Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Apr 15 2026 17:49:51 GMT+0100 (Irish Standard Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
@@ -356,5 +337,9 @@ PageData.prototype.h2 = PageData.prototype.addSecondaryHeading;</code></pre>
 
     <link type="text/css" rel="stylesheet" href="./docdash-overrides.css">
     
+    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+    
+    <script src="./mermaid-init.js"></script>
+    
 </body>
 </html>