@oat-sa/tao-core-ui 1.54.2 → 1.55.0

package/dist/highlighter.js

@@ -13,29 +13,29 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
     }, _typeof(obj);
   }
 
-  /**
-   * Data attribute used to logically group the wrapping nodes into a single selection
-   * @type {string}
+  /**
+   * Data attribute used to logically group the wrapping nodes into a single selection
+   * @type {string}
    */
 
   var GROUP_ATTR = 'data-hl-group';
-  /**
-   * Children of those nodes types cannot be highlighted
-   * @type {string[]}
+  /**
+   * Children of those nodes types cannot be highlighted
+   * @type {string[]}
    */
 
   var defaultBlackList = ['textarea', 'math', 'script', '.select2-container'];
-  /**
-   * @param {Object} options
-   * @param {String} options.className - name of the class that will be used by the wrappers tags to highlight text
-   * @param {String} options.containerSelector - allows to select the root Node in which highlighting is allowed
-   * @param {Array<String>} [options.containersBlackList] - additional blacklist selectors to be added to module instance's blacklist
-   * @param {Array<String>} [options.containersWhiteList] - whitelist selectors; supported only in `keepEmptyNodes` mode.
-   *   Priority of blacklist or whitelist is decided by which selector is closest to the node. If no match found, node is considered whitelisted.
-   * @param {Boolean} [options.clearOnClick] - clear single highlight node on click
-   * @param {Object} [options.colors] - keys is keeping as the "c" value of storing/restore the highlighters for indexing, values are wrappers class names
-   * @param {Boolean} [options.keepEmptyNodes] - retain original dom structure as far as possible and do not remove empty nodes if they were not created by highlighter
-   * @returns {Object} - the highlighter instance
+  /**
+   * @param {Object} options
+   * @param {String} options.className - name of the class that will be used by the wrappers tags to highlight text
+   * @param {String} options.containerSelector - allows to select the root Node in which highlighting is allowed
+   * @param {Array<String>} [options.containersBlackList] - additional blacklist selectors to be added to module instance's blacklist
+   * @param {Array<String>} [options.containersWhiteList] - whitelist selectors; supported only in `keepEmptyNodes` mode.
+   *   Priority of blacklist or whitelist is decided by which selector is closest to the node. If no match found, node is considered whitelisted.
+   * @param {Boolean} [options.clearOnClick] - clear single highlight node on click
+   * @param {Object} [options.colors] - keys is keeping as the "c" value of storing/restore the highlighters for indexing, values are wrappers class names
+   * @param {Boolean} [options.keepEmptyNodes] - retain original dom structure as far as possible and do not remove empty nodes if they were not created by highlighter
+   * @returns {Object} - the highlighter instance
    */
 
   function highlighter (options) {
@@ -47,10 +47,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
     if (options.colors) {
       highlightingClasses = Object.values(options.colors);
     }
-    /**
-     * list of node selectors which should NOT receive any highlighting from this instance
-     * an optional passed-in blacklist is merged with local defaults
-     * @type {Array}
+    /**
+     * list of node selectors which should NOT receive any highlighting from this instance
+     * an optional passed-in blacklist is merged with local defaults
+     * @type {Array}
      */
 
 
@@ -64,42 +64,42 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       containersWhiteListSelector = options.containersWhiteList.join(', ');
       containersBlackAndWhiteListSelector = _.union(containersBlackList, options.containersWhiteList).join(', ');
     }
-    /**
-     * used in recursive loops to decide if we should wrap or not the current node
-     * @type {boolean}
+    /**
+     * used in recursive loops to decide if we should wrap or not the current node
+     * @type {boolean}
      */
 
 
     var isWrapping = false;
-    /**
-     * performance improvement to break out of a potentially big recursive loop once the wrapping has ended
-     * @type {boolean}
+    /**
+     * performance improvement to break out of a potentially big recursive loop once the wrapping has ended
+     * @type {boolean}
      */
 
     var hasWrapped = false;
-    /**
-     * used in recursive loops to assign a group Id to the current wrapped node
-     * @type {number}
+    /**
+     * used in recursive loops to assign a group Id to the current wrapped node
+     * @type {number}
      */
 
     var currentGroupId;
-    /**
-     * used in recursive loops to build the index of text nodes
-     * @type {number}
+    /**
+     * used in recursive loops to build the index of text nodes
+     * @type {number}
      */
 
     var textNodesIndex;
-    /**
-     * Returns the node in which highlighting is allowed
-     * @returns {Element}
+    /**
+     * Returns the node in which highlighting is allowed
+     * @returns {Element}
      */
 
     function getContainer() {
       return $(containerSelector).get(0);
     }
-    /**
-     * Returns all highlighted nodes, excluding any inside blacklisted elements
-     * @returns {JQuery<HTMLElement>}
+    /**
+     * Returns all highlighted nodes, excluding any inside blacklisted elements
+     * @returns {JQuery<HTMLElement>}
      */
 
 
@@ -108,14 +108,14 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         return !isBlacklisted(node);
       });
     }
-    /**
-     * Attach data to wrapper node.
-     * Use it when deleting this highlight to know if highlight content should be merged with neighbour text nodes or not.
-     * Use it when building/restoring index to know if restored highlight content should be split off neighbour text node or not.
-     * Needed to keep markup the same as it was before highlighting.
-     * @param {HTMLElement} node
-     * @param {Boolean} beforeWasSplit
-     * @param {Boolean} afterWasSplit
+    /**
+     * Attach data to wrapper node.
+     * Use it when deleting this highlight to know if highlight content should be merged with neighbour text nodes or not.
+     * Use it when building/restoring index to know if restored highlight content should be split off neighbour text node or not.
+     * Needed to keep markup the same as it was before highlighting.
+     * @param {HTMLElement} node
+     * @param {Boolean} beforeWasSplit
+     * @param {Boolean} afterWasSplit
      */
 
 
@@ -123,9 +123,9 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       node.dataset.beforeWasSplit = beforeWasSplit;
       node.dataset.afterWasSplit = afterWasSplit;
     }
-    /**
-     * Highlight all text nodes within each given range
-     * @param {Range[]} ranges - array of ranges to highlight, may be given by the helper selector.getAllRanges()
+    /**
+     * Highlight all text nodes within each given range
+     * @param {Range[]} ranges - array of ranges to highlight, may be given by the helper selector.getAllRanges()
      */
 
 
@@ -180,10 +180,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         $(containerSelector + ' .' + className).off('click').on('click', clearSingleHighlight);
       }
     }
-    /**
-     * Check if a range is valid
-     * @param {Range} range
-     * @returns {boolean}
+    /**
+     * Check if a range is valid
+     * @param {Range} range
+     * @returns {boolean}
      */
 
 
@@ -197,18 +197,18 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         return false;
       }
     }
-    /**
-     * Core wrapping function. Traverse the DOM tree and highlight (= wraps) all text nodes within the given range.
-     * Recursive.
-     *
-     * @param {Node} rootNode - top of the node hierarchy in which text nodes will be searched
-     * @param {Object} rangeInfos
-     * @param {Node} rangeInfos.startNode - node on which the selection starts
-     * @param {Node} rangeInfos.startNodeContainer - container of the startNode, or the start node itself in case of text nodes
-     * @param {number} rangeInfos.startOffset - same as range.startOffset, but not read-only to allow override
-     * @param {Node} rangeInfos.endNode - node on which the selection ends
-     * @param {Node} rangeInfos.endNodeContainer - container of the endNode, or the end node itself in case of text nodes
-     * @param {number} rangeInfos.endOffset - same as range.endOffset, but not read-only to allow override
+    /**
+     * Core wrapping function. Traverse the DOM tree and highlight (= wraps) all text nodes within the given range.
+     * Recursive.
+     *
+     * @param {Node} rootNode - top of the node hierarchy in which text nodes will be searched
+     * @param {Object} rangeInfos
+     * @param {Node} rangeInfos.startNode - node on which the selection starts
+     * @param {Node} rangeInfos.startNodeContainer - container of the startNode, or the start node itself in case of text nodes
+     * @param {number} rangeInfos.startOffset - same as range.startOffset, but not read-only to allow override
+     * @param {Node} rangeInfos.endNode - node on which the selection ends
+     * @param {Node} rangeInfos.endNodeContainer - container of the endNode, or the end node itself in case of text nodes
+     * @param {number} rangeInfos.endOffset - same as range.endOffset, but not read-only to allow override
      */
 
 
@@ -329,12 +329,12 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Restructure content of the highlighted wrapper according to the selectedRange
-     * @param {Node} textNode
-     * @param {string} activeClass
-     * @param {Range} selectedRange
-     * @param {number} currentGroupId
+    /**
+     * Restructure content of the highlighted wrapper according to the selectedRange
+     * @param {Node} textNode
+     * @param {string} activeClass
+     * @param {Range} selectedRange
+     * @param {number} currentGroupId
      */
 
 
@@ -344,46 +344,46 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       range.selectNodeContents(textNode);
       var isSelectionCoversNodeStart = range.compareBoundaryPoints(Range.START_TO_START, selectedRange) === 0;
       var isSelectionCoversNodeEnd = range.compareBoundaryPoints(Range.END_TO_END, selectedRange) === 0;
-      /*
-      There are 4 possible cases selected area is intersected with already highlighted element.
-      In examples below the border is represents the selection, "yellow" is class name of already highlighted
-      container, "red" is class name of currently active highlighter
-      **********************************************************************************************************
-      1. The container content is completely selected, so that we only have to change the highlighter class name
-        Input:
-       __________________________________________________
-      |                                                  |
-      |<span class="yellow"> Lorem ipsum dolor sit</span>|
-      |__________________________________________________|
-        Output:
-       <span class="red"> Lorem ipsum dolor sit</span>
-        **********************************************************************************************************
-      2. The container content is partially selected from the begging.
-        Input:
-       ______________________________
-      |                              |
-      |<span class="yellow"> Lorem ip|sum dolor sit</span>
-      |______________________________|
-        Output:
-      <span class="red"> Lorem ip</span><span class="yellow">sum dolor sit</span>
-        **********************************************************************************************************
-      3. The container content is partially selected at the end.
-        Input:
-                                     ____________________
-                                    |                    |
-      <span class="yellow"> Lorem ip|sum dolor sit</span>|
-                                    |____________________|
-        Output:
-      <span class="yellow"> Lorem ip</span><span class="red">sum dolor sit</span>
-        **********************************************************************************************************
-      4. The container content is partially selected in the middle.
-        Input:
-                                   ___________
-                                  |           |
-      <span class="yellow"> Lorem |ipsum dolor| sit</span>
-                                  |___________|
-        Output:
-       <span class="yellow"> Lorem </span><span class="red">ipsum dolor</span><span class="yellow"> sit</span>
+      /*
+      There are 4 possible cases selected area is intersected with already highlighted element.
+      In examples below the border is represents the selection, "yellow" is class name of already highlighted
+      container, "red" is class name of currently active highlighter
+      **********************************************************************************************************
+      1. The container content is completely selected, so that we only have to change the highlighter class name
+       Input:
+       __________________________________________________
+      |                                                  |
+      |<span class="yellow"> Lorem ipsum dolor sit</span>|
+      |__________________________________________________|
+       Output:
+       <span class="red"> Lorem ipsum dolor sit</span>
+       **********************************************************************************************************
+      2. The container content is partially selected from the begging.
+       Input:
+       ______________________________
+      |                              |
+      |<span class="yellow"> Lorem ip|sum dolor sit</span>
+      |______________________________|
+       Output:
+      <span class="red"> Lorem ip</span><span class="yellow">sum dolor sit</span>
+       **********************************************************************************************************
+      3. The container content is partially selected at the end.
+       Input:
+                                     ____________________
+                                    |                    |
+      <span class="yellow"> Lorem ip|sum dolor sit</span>|
+                                    |____________________|
+       Output:
+      <span class="yellow"> Lorem ip</span><span class="red">sum dolor sit</span>
+       **********************************************************************************************************
+      4. The container content is partially selected in the middle.
+       Input:
+                                   ___________
+                                  |           |
+      <span class="yellow"> Lorem |ipsum dolor| sit</span>
+                                  |___________|
+       Output:
+       <span class="yellow"> Lorem </span><span class="red">ipsum dolor</span><span class="yellow"> sit</span>
        */
 
       if (isSelectionCoversNodeStart && isSelectionCoversNodeEnd) {
@@ -399,13 +399,13 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         wrapContainerChildNodes(container, 1, activeClass, currentGroupId);
       }
     }
-    /**
-     * Wraps all containers text nodes with highlighter element.
-     * The child node with index given by indexToWrapNode parameter will be wrap with class given by activeClass parameter
-     * @param {Element} container
-     * @param {number} indexToWrapNode
-     * @param {string} activeClass
-     * @param {number} currentGroupId
+    /**
+     * Wraps all containers text nodes with highlighter element.
+     * The child node with index given by indexToWrapNode parameter will be wrap with class given by activeClass parameter
+     * @param {Element} container
+     * @param {number} indexToWrapNode
+     * @param {string} activeClass
+     * @param {number} currentGroupId
      */
 
 
@@ -430,11 +430,11 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       });
       container.replaceWith(fragment);
     }
-    /**
-     * wraps a text node into the highlight span
-     * @param {Node} node - the node to wrap
-     * @param {number} groupId - the highlight group
-     * @returns {Node|null} wrapper node, if it was created
+    /**
+     * wraps a text node into the highlight span
+     * @param {Node} node - the node to wrap
+     * @param {number} groupId - the highlight group
+     * @returns {Node|null} wrapper node, if it was created
      */
 
 
@@ -446,11 +446,11 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
 
       return null;
     }
-    /**
-     * We need to re-index the groups after a user highlight: either to merge groups or to resolve inconsistencies
-     * Recursive.
-     *
-     * @param {Node} rootNode
+    /**
+     * We need to re-index the groups after a user highlight: either to merge groups or to resolve inconsistencies
+     * Recursive.
+     *
+     * @param {Node} rootNode
      */
 
 
@@ -483,10 +483,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Some highlights may result in having adjacent wrapping nodes. We remove them here to get a cleaner markup.
-     *
-     * @param {Node} rootNode
+    /**
+     * Some highlights may result in having adjacent wrapping nodes. We remove them here to get a cleaner markup.
+     *
+     * @param {Node} rootNode
      */
 
 
@@ -524,8 +524,8 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Unwraps highlighted nodes with a line break or with an empty content
+    /**
+     * Unwraps highlighted nodes with a line break or with an empty content
      */
 
 
@@ -542,13 +542,13 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       });
     }
-    /**
-     * Check condition to avoid the work of `unwrapEmptyHighlights` ahead of time, before `mergeAdjacentNodes` runs,
-     * because in `keepEmptyNodes` case we do not want to add nodes to dom unless necessary.
-     * Also be more strict and don't allow to select nodes with spaces only, because they may appear in unexpected places in markup
-     * (here it's not exactly same as `unwrapEmptyHighlights`).
-     * @param {Node} node - node which will be wrapped (highlighted)
-     * @returns {Boolean}
+    /**
+     * Check condition to avoid the work of `unwrapEmptyHighlights` ahead of time, before `mergeAdjacentNodes` runs,
+     * because in `keepEmptyNodes` case we do not want to add nodes to dom unless necessary.
+     * Also be more strict and don't allow to select nodes with spaces only, because they may appear in unexpected places in markup
+     * (here it's not exactly same as `unwrapEmptyHighlights`).
+     * @param {Node} node - node which will be wrapped (highlighted)
+     * @returns {Boolean}
      */
 
 
@@ -577,12 +577,12 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
 
       return false;
     }
-    /**
-     * `range.surroundContents` can create empty text nodes,
-     * which will cause trouble in `mergeAdjacentNodes` later (in `keepEmptyNodes` case).
-     * This method surrounds range, then removes those nodes
-     * @param {Range} range
-     * @param {Node} wrapperNode
+    /**
+     * `range.surroundContents` can create empty text nodes,
+     * which will cause trouble in `mergeAdjacentNodes` later (in `keepEmptyNodes` case).
+     * This method surrounds range, then removes those nodes
+     * @param {Range} range
+     * @param {Node} wrapperNode
      */
 
 
@@ -593,10 +593,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       removeEmptyTextNodeIfDifferent(wrapperNode.previousSibling, containerPreviousSibling);
       removeEmptyTextNodeIfDifferent(wrapperNode.nextSibling, containerNextSibling);
     }
-    /**
-     * Remove `node`, if it's an empty text node and is *not* the same node as `nodeToCompare`
-     * @param {Node} node
-     * @param {Node} nodeToCompare
+    /**
+     * Remove `node`, if it's an empty text node and is *not* the same node as `nodeToCompare`
+     * @param {Node} node
+     * @param {Node} nodeToCompare
      */
 
 
@@ -605,8 +605,8 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         node.remove();
       }
     }
-    /**
-     * Remove all wrapping nodes from markup
+    /**
+     * Remove all wrapping nodes from markup
      */
 
 
@@ -622,8 +622,8 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       });
     }
-    /**
-     * Remove unwrap dom node
+    /**
+     * Remove unwrap dom node
      */
 
 
@@ -668,21 +668,21 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Index-related functions:
-     * ========================
-     * To allow saving and restoring highlights on an equivalent, but different, DOM tree (for example if the markup is deleted and re-created)
-     * we build an index containing the status of each text node:
-     * - not highlighted
-     * - fully highlighted
-     * - partially highlighted (= with inline ranges)
-     *
-     * This index will be used to restore a selection on the new DOM tree
+    /**
+     * Index-related functions:
+     * ========================
+     * To allow saving and restoring highlights on an equivalent, but different, DOM tree (for example if the markup is deleted and re-created)
+     * we build an index containing the status of each text node:
+     * - not highlighted
+     * - fully highlighted
+     * - partially highlighted (= with inline ranges)
+     *
+     * This index will be used to restore a selection on the new DOM tree
      */
 
-    /**
-     * Bootstrap the process of building the highlight index
-     * @returns {Object[]|BuildModelResultKeepEmpty|null}
+    /**
+     * Bootstrap the process of building the highlight index
+     * @returns {Object[]|BuildModelResultKeepEmpty|null}
      */
 
 
@@ -707,10 +707,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Traverse the DOM tree to create the text Nodes index. Recursive.
-     * @param {Node} rootNode
-     * @param {Object[]} highlightIndex
+    /**
+     * Traverse the DOM tree to create the text Nodes index. Recursive.
+     * @param {Node} rootNode
+     * @param {Object[]} highlightIndex
      */
 
 
@@ -779,28 +779,28 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * @typedef HighlightEntryKeepEmpty
-     * @property {String} groupId
-     * @property {String} c - color
-     * @property {Number} offsetBefore
-     * @property {Number} textLength
-     * @property {String} beforeWasSplit
-     * @property {String} afterWasSplit
-     * @property {Array<Number>} path - on each level from root container to highlight, index among siblings
+    /**
+     * @typedef HighlightEntryKeepEmpty
+     * @property {String} groupId
+     * @property {String} c - color
+     * @property {Number} offsetBefore
+     * @property {Number} textLength
+     * @property {String} beforeWasSplit
+     * @property {String} afterWasSplit
+     * @property {Array<Number>} path - on each level from root container to highlight, index among siblings
      */
 
-    /**
-     * @typedef BuildModelResultKeepEmpty
-     * @property {HighlightEntryKeepEmpty[]} highlightModel
-     * @property {NodeList} wrapperNodes
+    /**
+     * @typedef BuildModelResultKeepEmpty
+     * @property {HighlightEntryKeepEmpty[]} highlightModel
+     * @property {NodeList} wrapperNodes
      */
 
-    /**
-     * For `keepEmptyNodes` option, creates data model of highlights.
-     * Additionally returns array of highlight nodes. Traverses DOM tree.
-     * @param {Node} rootNode
-     * @returns {BuildModelResultKeepEmpty|null} result
+    /**
+     * For `keepEmptyNodes` option, creates data model of highlights.
+     * Additionally returns array of highlight nodes. Traverses DOM tree.
+     * @param {Node} rootNode
+     * @returns {BuildModelResultKeepEmpty|null} result
      */
 
 
@@ -872,9 +872,9 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         wrapperNodes: wrapperNodes
       };
     }
-    /**
-     * Bootstrap the process of restoring the highlights from an index
-     * @param {Object[]|HighlightEntryKeepEmpty[]|null} highlightIndex
+    /**
+     * Bootstrap the process of restoring the highlights from an index
+     * @param {Object[]|HighlightEntryKeepEmpty[]|null} highlightIndex
      */
 
 
@@ -891,10 +891,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * Traverse the DOM tree to wraps the text nodes according to the highlight index. Recursive.
-     * @param {Node} rootNode
-     * @param {Object[]} highlightIndex
+    /**
+     * Traverse the DOM tree to wraps the text nodes according to the highlight index. Recursive.
+     * @param {Node} rootNode
+     * @param {Object[]} highlightIndex
      */
 
 
@@ -939,11 +939,11 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         }
       }
     }
-    /**
-     * For `keepEmptyNodes` option, wraps the text nodes according to highlights data model.
-     * Traverses and updates DOM tree. Shouldn't throw errors in case of mismatches.
-     * @param {Node} rootNode
-     * @param {HighlightEntryKeepEmpty[]|null} highlightModel
+    /**
+     * For `keepEmptyNodes` option, wraps the text nodes according to highlights data model.
+     * Traverses and updates DOM tree. Shouldn't throw errors in case of mismatches.
+     * @param {Node} rootNode
+     * @param {HighlightEntryKeepEmpty[]|null} highlightModel
      */
 
 
@@ -1020,9 +1020,9 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         rangeSurroundContentsNoEmptyNodes(range, wrapperNode);
       }
     }
-    /**
-     * Set highlighter color
-     * @param {string} color Active highlighter color
+    /**
+     * Set highlighter color
+     * @param {string} color Active highlighter color
      */
 
 
@@ -1031,15 +1031,15 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         className = options.colors[color];
       }
     };
-    /**
-     * Helpers
+    /**
+     * Helpers
      */
 
-    /**
-     * Return the object key contains the given value
-     * @param {Object} object
-     * @param {any} value
-     * @return {string|undefined}
+    /**
+     * Return the object key contains the given value
+     * @param {Object} object
+     * @param {any} value
+     * @return {string|undefined}
      */
 
 
@@ -1048,10 +1048,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         return object[key] === value;
       });
     };
-    /**
-     * Returns color identifier for the given class name
-     * @param {string} highlighterClassName Class name of highlighter classes
-     * @returns {string|number} Color identifier
+    /**
+     * Returns color identifier for the given class name
+     * @param {string} highlighterClassName Class name of highlighter classes
+     * @returns {string|number} Color identifier
      */
 
 
@@ -1062,10 +1062,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
 
       return className;
     };
-    /**
-     * Returns class name for the given color identifier
-     * @param {string|number} color Color identifier
-     * @returns {string} Class name
+    /**
+     * Returns class name for the given color identifier
+     * @param {string|number} color Color identifier
+     * @returns {string} Class name
      */
 
 
@@ -1076,33 +1076,33 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
 
       return className;
     };
-    /**
-     * Check if the given node is a wrapper
-     * @param {Node|Element} node
-     * @returns {boolean}
+    /**
+     * Check if the given node is a wrapper
+     * @param {Node|Element} node
+     * @returns {boolean}
      */
 
 
     function isWrappingNode(node) {
       return isElement(node) && node.tagName.toLowerCase() === 'span' && highlightingClasses.includes(node.className);
     }
-    /**
-     * Check if the given node can be wrapped
-     * @param {Node} node
-     * @returns {boolean}
+    /**
+     * Check if the given node can be wrapped
+     * @param {Node} node
+     * @returns {boolean}
      */
 
 
     function isWrappable(node) {
       return isText(node) && !isBlacklisted(node);
     }
-    /**
-     * Check if the given node is, or is within, a blacklisted container.
-     * With `keepEmptyNodes` option, node inside blacklisted container can be whitelisted too.
-     * Priority of blacklist or whitelist is decided by which selector is closest to the node.
-     * If no match found, node is considered whitelisted.
-     * @param {Node} node
-     * @returns {boolean}
+    /**
+     * Check if the given node is, or is within, a blacklisted container.
+     * With `keepEmptyNodes` option, node inside blacklisted container can be whitelisted too.
+     * Priority of blacklist or whitelist is decided by which selector is closest to the node.
+     * If no match found, node is considered whitelisted.
+     * @param {Node} node
+     * @returns {boolean}
      */
 
 
@@ -1117,11 +1117,11 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
         return !closest.get(0).matches(containersWhiteListSelector);
       }
     }
-    /**
-     * Wraps text node to the highlighter wrapper element
-     * @param {Node} textNode Text node to wrap
-     * @param {string} className Wrapper class name
-     * @param {number} groupId Group id
+    /**
+     * Wraps text node to the highlighter wrapper element
+     * @param {Node} textNode Text node to wrap
+     * @param {string} className Wrapper class name
+     * @param {number} groupId Group id
      */
 
 
@@ -1130,10 +1130,10 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       element.appendChild(textNode);
       return element;
     }
-    /**
-     * Create a wrapping node
-     * @param {number} groupId
-     * @returns {Element}
+    /**
+     * Create a wrapping node
+     * @param {number} groupId
+     * @returns {Element}
      */
 
 
@@ -1143,9 +1143,9 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
       wrapper.setAttribute(GROUP_ATTR, "".concat(groupId));
       return wrapper;
     }
-    /**
-     * Returns the first unused group Id
-     * @returns {number}
+    /**
+     * Returns the first unused group Id
+     * @returns {number}
      */
 
 
@@ -1158,38 +1158,38 @@ define(['lodash', 'jquery'], function (_, $) { 'use strict';
 
       return id;
     }
-    /**
-     * Check if the given node is an element
-     * @param {Node} node
-     * @returns {boolean}
+    /**
+     * Check if the given node is an element
+     * @param {Node} node
+     * @returns {boolean}
      */
 
 
     function isElement(node) {
       return node && _typeof(node) === 'object' && node.nodeType === window.Node.ELEMENT_NODE;
     }
-    /**
-     * Check if the given node is of type text
-     * @param {Node} node
-     * @returns {boolean}
+    /**
+     * Check if the given node is of type text
+     * @param {Node} node
+     * @returns {boolean}
      */
 
 
     function isText(node) {
       return node && _typeof(node) === 'object' && node.nodeType === window.Node.TEXT_NODE;
     }
-    /**
-     * a "Hot Node" is either wrappable text node or a wrapper
-     * @param {Node} node
-     * @returns {boolean}
+    /**
+     * a "Hot Node" is either wrappable text node or a wrapper
+     * @param {Node} node
+     * @returns {boolean}
      */
 
 
     function isHotNode(node) {
       return isWrappingNode(node) || isWrappable(node);
     }
-    /**
-     * Public API of the highlighter helper
+    /**
+     * Public API of the highlighter helper
      */