@bartificer/linkify 2.4.0 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/README.md +135 -35
  2. package/dist/index.js +1 -1
  3. package/docs/LinkData.class.mjs.html +28 -53
  4. package/docs/LinkTemplate.class.mjs.html +29 -33
  5. package/docs/Linkifier.class.mjs.html +46 -59
  6. package/docs/PageData.class.mjs.html +54 -69
  7. package/docs/defaults.mjs.html +22 -2
  8. package/docs/docdash-overrides.css +9 -3
  9. package/docs/externals.jsdoc.html +6 -2
  10. package/docs/global.html +1276 -0
  11. package/docs/index.html +114 -45
  12. package/docs/index.js.html +7 -3
  13. package/docs/mermaid-init.js +21 -0
  14. package/docs/module-cheerio.html +6 -2
  15. package/docs/module-defaults.html +100 -5
  16. package/docs/module-link-data.LinkData.html +81 -212
  17. package/docs/module-link-data.html +8 -4
  18. package/docs/module-link-template.LinkTemplate.html +71 -96
  19. package/docs/module-link-template.html +8 -4
  20. package/docs/module-linkifier.Linkifier.html +103 -376
  21. package/docs/module-linkifier.html +6 -2
  22. package/docs/module-linkify.html +7 -3
  23. package/docs/module-mustache.html +6 -2
  24. package/docs/module-node-fetch.html +6 -2
  25. package/docs/module-page-data.PageData.html +224 -202
  26. package/docs/module-page-data.html +8 -4
  27. package/docs/module-title-case.html +6 -2
  28. package/docs/module-urijs.html +6 -2
  29. package/docs/module-url-slug.html +6 -2
  30. package/docs/module-utilities.html +74 -24
  31. package/docs/typedefs.jsdoc.html +145 -0
  32. package/docs/utilities.mjs.html +36 -23
  33. package/package.json +3 -2
  34. package/src/LinkData.class.mjs +22 -51
  35. package/src/LinkTemplate.class.mjs +23 -31
  36. package/src/Linkifier.class.mjs +40 -57
  37. package/src/PageData.class.mjs +48 -67
  38. package/src/defaults.mjs +16 -0
  39. package/src/index.js +1 -1
  40. package/src/typedefs.jsdoc +52 -0
  41. package/src/utilities.mjs +30 -21
@@ -43,7 +43,7 @@
43
43
  <input type="text" id="nav-search" placeholder="Search" />
44
44
 
45
45
 
46
- <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>
46
+ <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>
47
47
 
48
48
  </nav>
49
49
 
@@ -69,7 +69,7 @@
69
69
 
70
70
  </h2>
71
71
 
72
- <div class="class-description usertext"><p>A class representing the a template that can be used to render links.</p></div>
72
+ <div class="class-description usertext"><p>A class representing the templates used to render link data objects as actual links.</p></div>
73
73
 
74
74
 
75
75
  </header>
@@ -97,7 +97,7 @@
97
97
 
98
98
  <dt class="tag-source">Source:</dt>
99
99
  <dd class="tag-source"><ul class="dummy"><li>
100
- <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line16">line 16</a>
100
+ <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line17">line 17</a>
101
101
  </li></ul></dd>
102
102
 
103
103
 
@@ -127,6 +127,13 @@
127
127
 
128
128
 
129
129
 
130
+
131
+ <dt class="tag-see">See:</dt>
132
+ <dd class="tag-see">
133
+ <ul>
134
+ <li><a href="module-link-data.LinkData.html">module:link-data.LinkData</a> for the data objects that are rendered with these templates.</li>
135
+ </ul>
136
+ </dd>
130
137
 
131
138
 
132
139
 
@@ -142,6 +149,19 @@
142
149
 
143
150
 
144
151
 
152
+ <h5 class="h5-examples">Example</h5>
153
+
154
+ <p class="code-caption">Example of defining a template with filters</p>
155
+
156
+ <pre class="prettyprint"><code>let template = new LinkTemplate(
157
+ '&lt;a href="{{{url}}}">{{{text}}}&lt;/a>',
158
+ [
159
+ ['url', linkify.util.stripUTMParameters],
160
+ ['text', linkify.util.regulariseWhitespace]
161
+ ]
162
+ );</code></pre>
163
+
164
+
145
165
 
146
166
 
147
167
  <h5 class="h5-parameters">Parameters:</h5>
@@ -215,7 +235,7 @@
215
235
  <td class="type">
216
236
 
217
237
 
218
- <span class="param-type">Array</span>
238
+ <span class="param-type">Array.&lt;<a href="global.html#templateFieldFilterTuple">templateFieldFilterTuple</a>></span>
219
239
 
220
240
 
221
241
 
@@ -242,13 +262,7 @@
242
262
  </td>
243
263
 
244
264
 
245
- <td class="description last"><p>An optional array of filter functions.
246
- Each element in the array should itself be an array where the first
247
- element is a string specifying which fields the filter should be applied
248
- to (one of <code>'all'</code>, <code>'url'</code>, <code>'text'</code>, or <code>'description'</code>), and the
249
- second the filter function itself which should be a function that takes
250
- a single string as an argument and returns a filtered version of that
251
- string.</p></td>
265
+ <td class="description last"><p>an optional set of filter functions to apply to some or all template fields.</p></td>
252
266
  </tr>
253
267
 
254
268
 
@@ -294,7 +308,7 @@ string.</p></td>
294
308
 
295
309
 
296
310
 
297
- <h4 class="name" id="templateString"><span class="type-signature"></span>templateString<span class="type-signature"></span></h4>
311
+ <h4 class="name" id="templateString"><span class="type-signature"></span>templateString<span class="type-signature"> :string</span></h4>
298
312
 
299
313
 
300
314
 
@@ -303,13 +317,13 @@ string.</p></td>
303
317
  <dl class="details">
304
318
 
305
319
  <dt class="tag-description">Description:</dt>
306
- <dd class="tag-description"><ul class="dummy"><li><p>Get the template string.</p></li></ul></dd>
320
+ <dd class="tag-description"><ul class="dummy"><li><p>The Mustache template string. Will be coerced to a string with <code>String(templateString)</code>.</p></li></ul></dd>
307
321
 
308
322
 
309
323
 
310
324
  <dt class="tag-source">Source:</dt>
311
325
  <dd class="tag-source"><ul class="dummy"><li>
312
- <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line70">line 70</a>
326
+ <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line72">line 72</a>
313
327
  </li></ul></dd>
314
328
 
315
329
 
@@ -349,79 +363,21 @@ string.</p></td>
349
363
 
350
364
 
351
365
  <div class="description usertext">
352
- <p>Get the template string.</p>
366
+ <p>The Mustache template string. Will be coerced to a string with <code>String(templateString)</code>.</p>
353
367
  </div>
354
368
 
355
369
 
356
370
 
357
-
358
-
359
-
360
-
361
-
362
-
371
+ <h5 class="h5-types">Type:</h5>
372
+ <ul>
373
+ <li>
363
374
 
364
- <h4 class="name" id="templateString"><span class="type-signature"></span>templateString<span class="type-signature"></span></h4>
365
-
366
-
367
-
368
-
369
-
370
- <dl class="details">
371
-
372
- <dt class="tag-description">Description:</dt>
373
- <dd class="tag-description"><ul class="dummy"><li><p>Set the template string. Should be in Mustache format. All values passed
374
- will be coerced to strings.</p></li></ul></dd>
375
-
376
-
377
-
378
- <dt class="tag-source">Source:</dt>
379
- <dd class="tag-source"><ul class="dummy"><li>
380
- <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line80">line 80</a>
381
- </li></ul></dd>
382
-
383
-
384
-
385
-
386
-
387
-
388
-
389
-
390
-
391
-
392
-
393
-
394
-
395
-
396
-
397
-
398
-
399
-
400
-
401
-
402
-
403
-
404
-
405
-
406
-
407
-
408
-
409
-
410
-
411
-
412
-
413
- </dl>
414
-
415
-
416
-
417
-
375
+ <span class="param-type">string</span>
418
376
 
419
- <div class="description usertext">
420
- <p>Set the template string. Should be in Mustache format. All values passed
421
- will be coerced to strings.</p>
422
- </div>
423
377
 
424
378
 
379
+ </li>
380
+ </ul>
425
381
 
426
382
 
427
383
 
@@ -439,7 +395,7 @@ will be coerced to strings.</p>
439
395
 
440
396
 
441
397
 
442
- <h4 class="name" id="addFilter"><span class="type-signature"></span>addFilter<span class="signature">(fieldName, filterFn)</span><span class="type-signature"> &rarr; {LinkTemplate}</span></h4>
398
+ <h4 class="name" id="addFilter"><span class="type-signature"></span>addFilter<span class="signature">(fieldName, filterFn)</span><span class="type-signature"> &rarr; {<a href="module-link-template.LinkTemplate.html">module:link-template.LinkTemplate</a>}</span></h4>
443
399
 
444
400
 
445
401
 
@@ -457,7 +413,7 @@ throw an error, but it does log a warning.</p></li></ul></dd>
457
413
 
458
414
  <dt class="tag-source">Source:</dt>
459
415
  <dd class="tag-source"><ul class="dummy"><li>
460
- <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line95">line 95</a>
416
+ <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line89">line 89</a>
461
417
  </li></ul></dd>
462
418
 
463
419
 
@@ -535,7 +491,16 @@ throw an error, but it does log a warning.</p></li></ul></dd>
535
491
  <td class="type">
536
492
 
537
493
 
538
- <span class="param-type">string</span>
494
+ <span class="param-type">"all"</span>
495
+ |
496
+
497
+ <span class="param-type">"url"</span>
498
+ |
499
+
500
+ <span class="param-type">"text"</span>
501
+ |
502
+
503
+ <span class="param-type">"description"</span>
539
504
 
540
505
 
541
506
 
@@ -546,8 +511,7 @@ throw an error, but it does log a warning.</p></li></ul></dd>
546
511
 
547
512
 
548
513
 
549
- <td class="description last"><p>One of <code>'all'</code>, <code>'url'</code>, <code>'text'</code>, or
550
- <code>'description'</code>.</p></td>
514
+ <td class="description last"></td>
551
515
  </tr>
552
516
 
553
517
 
@@ -560,7 +524,7 @@ throw an error, but it does log a warning.</p></li></ul></dd>
560
524
  <td class="type">
561
525
 
562
526
 
563
- <span class="param-type">function</span>
527
+ <span class="param-type"><a href="global.html#templateFieldFilterFunction">templateFieldFilterFunction</a></span>
564
528
 
565
529
 
566
530
 
@@ -608,7 +572,7 @@ throw an error, but it does log a warning.</p></li></ul></dd>
608
572
  </dt>
609
573
  <dd>
610
574
 
611
- <span class="param-type">LinkTemplate</span>
575
+ <span class="param-type"><a href="module-link-template.LinkTemplate.html">module:link-template.LinkTemplate</a></span>
612
576
 
613
577
 
614
578
 
@@ -624,7 +588,7 @@ throw an error, but it does log a warning.</p></li></ul></dd>
624
588
 
625
589
 
626
590
 
627
- <h4 class="name" id="filtersFor"><span class="type-signature"></span>filtersFor<span class="signature">(fieldName)</span><span class="type-signature"> &rarr; {Array.&lt;function()>}</span></h4>
591
+ <h4 class="name" id="filtersFor"><span class="type-signature"></span>filtersFor<span class="signature">(fieldName)</span><span class="type-signature"> &rarr; {Array.&lt;<a href="global.html#templateFieldFilterFunction">templateFieldFilterFunction</a>>}</span></h4>
628
592
 
629
593
 
630
594
 
@@ -634,14 +598,13 @@ throw an error, but it does log a warning.</p></li></ul></dd>
634
598
  <dl class="details">
635
599
 
636
600
  <dt class="tag-description">Description:</dt>
637
- <dd class="tag-description"><ul class="dummy"><li><p>A function get the filter functions that should be applied to any given
638
- field.</p></li></ul></dd>
601
+ <dd class="tag-description"><ul class="dummy"><li><p>Get the filter functions that should be applied to any given field.</p></li></ul></dd>
639
602
 
640
603
 
641
604
 
642
605
  <dt class="tag-source">Source:</dt>
643
606
  <dd class="tag-source"><ul class="dummy"><li>
644
- <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line124">line 124</a>
607
+ <a href="LinkTemplate.class.mjs.html">LinkTemplate.class.mjs</a>, <a href="LinkTemplate.class.mjs.html#line116">line 116</a>
645
608
  </li></ul></dd>
646
609
 
647
610
 
@@ -719,7 +682,16 @@ field.</p></li></ul></dd>
719
682
  <td class="type">
720
683
 
721
684
 
722
- <span class="param-type">string</span>
685
+ <span class="param-type">"all"</span>
686
+ |
687
+
688
+ <span class="param-type">"url"</span>
689
+ |
690
+
691
+ <span class="param-type">"text"</span>
692
+ |
693
+
694
+ <span class="param-type">"description"</span>
723
695
 
724
696
 
725
697
 
@@ -730,8 +702,7 @@ field.</p></li></ul></dd>
730
702
 
731
703
 
732
704
 
733
- <td class="description last"><p>one of <code>'url'</code>, <code>'text'</code>, or
734
- <code>'description'</code>.</p></td>
705
+ <td class="description last"></td>
735
706
  </tr>
736
707
 
737
708
 
@@ -758,7 +729,7 @@ field.</p></li></ul></dd>
758
729
 
759
730
  <div class="param-desc">
760
731
  <p>returns an array of callbacks, which may be
761
- empty. An empty array is returned if an invalid field name is passed.</p>
732
+ empty. An empty array is also returned if an invalid field name is passed.</p>
762
733
  </div>
763
734
 
764
735
 
@@ -769,7 +740,7 @@ empty. An empty array is returned if an invalid field name is passed.</p>
769
740
  </dt>
770
741
  <dd>
771
742
 
772
- <span class="param-type">Array.&lt;function()></span>
743
+ <span class="param-type">Array.&lt;<a href="global.html#templateFieldFilterFunction">templateFieldFilterFunction</a>></span>
773
744
 
774
745
 
775
746
 
@@ -800,7 +771,7 @@ empty. An empty array is returned if an invalid field name is passed.</p>
800
771
  <br class="clear">
801
772
 
802
773
  <footer>
803
- 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.
774
+ 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.
804
775
  </footer>
805
776
 
806
777
  <script>prettyPrint();</script>
@@ -813,5 +784,9 @@ empty. An empty array is returned if an invalid field name is passed.</p>
813
784
 
814
785
  <link type="text/css" rel="stylesheet" href="./docdash-overrides.css">
815
786
 
787
+ <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
788
+
789
+ <script src="./mermaid-init.js"></script>
790
+
816
791
  </body>
817
792
  </html>
@@ -43,7 +43,7 @@
43
43
  <input type="text" id="nav-search" placeholder="Search" />
44
44
 
45
45
 
46
- <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>
46
+ <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>
47
47
 
48
48
  </nav>
49
49
 
@@ -72,7 +72,7 @@
72
72
  <div class="container-overview">
73
73
 
74
74
 
75
- <div class="description usertext"><p>This module provides as class for representing a template used for generating links.</p></div>
75
+ <div class="description usertext"><p>This module provides as class for representing the templates used to generate links from link data objects.</p></div>
76
76
 
77
77
 
78
78
 
@@ -84,7 +84,7 @@
84
84
  <dl class="details">
85
85
 
86
86
  <dt class="tag-description">Description:</dt>
87
- <dd class="tag-description"><ul class="dummy"><li><p>This module provides as class for representing a template used for generating links.</p></li></ul></dd>
87
+ <dd class="tag-description"><ul class="dummy"><li><p>This module provides as class for representing the templates used to generate links from link data objects.</p></li></ul></dd>
88
88
 
89
89
 
90
90
 
@@ -205,7 +205,7 @@
205
205
  <br class="clear">
206
206
 
207
207
  <footer>
208
- 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.
208
+ 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.
209
209
  </footer>
210
210
 
211
211
  <script>prettyPrint();</script>
@@ -218,5 +218,9 @@
218
218
 
219
219
  <link type="text/css" rel="stylesheet" href="./docdash-overrides.css">
220
220
 
221
+ <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
222
+
223
+ <script src="./mermaid-init.js"></script>
224
+
221
225
  </body>
222
226
  </html>