handsontable 12.1.3 → 12.3.0-next-bb1a7c2-20221208

package/helpers/dom/element.mjs

@@ -1,15 +1,9 @@
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
-
 import "core-js/modules/es.object.get-prototype-of.js";
 import "core-js/modules/es.array.includes.js";
 import "core-js/modules/es.string.includes.js";
@@ -24,6 +18,7 @@ import "core-js/modules/es.array.join.js";
 import "core-js/modules/es.string.trim.js";
 import "core-js/modules/es.string.replace.js";
 import "core-js/modules/es.array.concat.js";
+import "core-js/modules/web.dom-collections.for-each.js";
 import "core-js/modules/es.symbol.js";
 import "core-js/modules/es.symbol.description.js";
 import "core-js/modules/es.symbol.iterator.js";
@@ -42,19 +37,16 @@ import { sanitize } from "../string.mjs";
  * @param {number} [level=0] Traversing deep level.
  * @returns {HTMLElement|null}
  */
-
 export function getParent(element) {
   var level = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
   var iteration = -1;
   var parent = null;
   var elementToCheck = element;
-
   while (elementToCheck !== null) {
     if (iteration === level) {
       parent = elementToCheck;
       break;
     }
-
     if (elementToCheck.host && elementToCheck.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
       elementToCheck = elementToCheck.host;
     } else {
@@ -62,39 +54,39 @@ export function getParent(element) {
       elementToCheck = elementToCheck.parentNode;
     }
   }
-
   return parent;
 }
+
 /**
  * Gets `frameElement` of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
  * @param {Window} frame Frame from which should be get frameElement in safe way.
  * @returns {HTMLIFrameElement|null}
  */
-
 export function getFrameElement(frame) {
   return Object.getPrototypeOf(frame.parent) && frame.frameElement;
 }
+
 /**
  * Gets parent frame of the specified frame. Returns null if it is a top frame or if script has no access to read property.
  *
  * @param {Window} frame Frame from which should be get frameElement in safe way.
  * @returns {Window|null}
  */
-
 export function getParentWindow(frame) {
   return getFrameElement(frame) && frame.parent;
 }
+
 /**
  * Checks if script has access to read from parent frame of specified frame.
  *
  * @param {Window} frame Frame from which should be get frameElement in safe way.
  * @returns {boolean}
  */
-
 export function hasAccessToParentWindow(frame) {
   return !!Object.getPrototypeOf(frame.parent);
 }
+
 /**
  * Goes up the DOM tree (including given element) until it finds an parent element that matches the nodes or nodes name.
  * This method goes up through web components.
@@ -104,36 +96,31 @@ export function hasAccessToParentWindow(frame) {
  * @param {Node} [until] The element until the traversing ends.
  * @returns {Node|null}
  */
-
 export function closest(element) {
   var nodes = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
   var until = arguments.length > 2 ? arguments[2] : undefined;
   var _Node = Node,
-      ELEMENT_NODE = _Node.ELEMENT_NODE,
-      DOCUMENT_FRAGMENT_NODE = _Node.DOCUMENT_FRAGMENT_NODE;
+    ELEMENT_NODE = _Node.ELEMENT_NODE,
+    DOCUMENT_FRAGMENT_NODE = _Node.DOCUMENT_FRAGMENT_NODE;
   var elementToCheck = element;
-
   while (elementToCheck !== null && elementToCheck !== void 0 && elementToCheck !== until) {
     var _elementToCheck = elementToCheck,
-        nodeType = _elementToCheck.nodeType,
-        nodeName = _elementToCheck.nodeName;
-
+      nodeType = _elementToCheck.nodeType,
+      nodeName = _elementToCheck.nodeName;
     if (nodeType === ELEMENT_NODE && (nodes.includes(nodeName) || nodes.includes(elementToCheck))) {
       return elementToCheck;
     }
-
     var _elementToCheck2 = elementToCheck,
-        host = _elementToCheck2.host;
-
+      host = _elementToCheck2.host;
     if (host && nodeType === DOCUMENT_FRAGMENT_NODE) {
       elementToCheck = host;
     } else {
       elementToCheck = elementToCheck.parentNode;
     }
   }
-
   return null;
 }
+
 /**
  * Goes "down" the DOM tree (including given element) until it finds an element that matches the nodes or nodes name.
  *
@@ -142,30 +129,25 @@ export function closest(element) {
  * @param {HTMLElement} [until] The list of elements until the traversing ends.
  * @returns {HTMLElement|null}
  */
-
 export function closestDown(element, nodes, until) {
   var matched = [];
   var elementToCheck = element;
-
   while (elementToCheck) {
     elementToCheck = closest(elementToCheck, nodes, until);
-
     if (!elementToCheck || until && !until.contains(elementToCheck)) {
       break;
     }
-
     matched.push(elementToCheck);
-
     if (elementToCheck.host && elementToCheck.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
       elementToCheck = elementToCheck.host;
     } else {
       elementToCheck = elementToCheck.parentNode;
     }
   }
-
   var length = matched.length;
   return length ? matched[length - 1] : null;
 }
+
 /**
  * Goes up the DOM tree and checks if element is child of another element.
  *
@@ -174,11 +156,9 @@ export function closestDown(element, nodes, until) {
  *                               If string provided, function returns `true` for the first occurrence of element with that class.
  * @returns {boolean}
  */
-
 export function isChildOf(child, parent) {
   var node = child.parentNode;
   var queriedParents = [];
-
   if (typeof parent === 'string') {
     if (child.defaultView) {
       queriedParents = Array.prototype.slice.call(child.querySelectorAll(parent), 0);
@@ -188,17 +168,15 @@ export function isChildOf(child, parent) {
   } else {
     queriedParents.push(parent);
   }
-
   while (node !== null) {
     if (queriedParents.indexOf(node) > -1) {
       return true;
     }
-
     node = node.parentNode;
   }
-
   return false;
 }
+
 /**
  * Counts index of element within its parent.
  * WARNING: for performance reasons, assumes there are only element nodes (no text nodes). This is true
@@ -208,20 +186,18 @@ export function isChildOf(child, parent) {
  * @param {Element} element The element to check.
  * @returns {number}
  */
-
 export function index(element) {
   var i = 0;
   var elementToCheck = element;
-
   if (elementToCheck.previousSibling) {
     /* eslint-disable no-cond-assign */
     while (elementToCheck = elementToCheck.previousSibling) {
       i += 1;
     }
   }
-
   return i;
 }
+
 /**
  * Check if the provided overlay contains the provided element.
  *
@@ -230,66 +206,51 @@ export function index(element) {
  * @param {HTMLElement} root The root element.
  * @returns {boolean}
  */
-
 export function overlayContainsElement(overlayType, element, root) {
   var overlayElement = root.parentElement.querySelector(".ht_clone_".concat(overlayType));
   return overlayElement ? overlayElement.contains(element) : null;
 }
-
 var _hasClass;
-
 var _addClass;
-
 var _removeClass;
+
 /**
  * @param {string} classNames The element "class" attribute string.
  * @returns {string[]}
  */
-
-
 function filterEmptyClassNames(classNames) {
   if (!classNames || !classNames.length) {
     return [];
   }
-
   return classNames.filter(function (x) {
     return !!x;
   });
 }
-
 if (isClassListSupported()) {
   var isSupportMultipleClassesArg = function isSupportMultipleClassesArg(rootDocument) {
     var element = rootDocument.createElement('div');
     element.classList.add('test', 'test2');
     return element.classList.contains('test2');
   };
-
   _hasClass = function _hasClass(element, className) {
     if (element.classList === void 0 || typeof className !== 'string' || className === '') {
       return false;
     }
-
     return element.classList.contains(className);
   };
-
   _addClass = function _addClass(element, classes) {
     var rootDocument = element.ownerDocument;
     var className = classes;
-
     if (typeof className === 'string') {
       className = className.split(' ');
     }
-
     className = filterEmptyClassNames(className);
-
     if (className.length > 0) {
       if (isSupportMultipleClassesArg(rootDocument)) {
         var _element$classList;
-
         (_element$classList = element.classList).add.apply(_element$classList, _toConsumableArray(className));
       } else {
         var len = 0;
-
         while (className[len]) {
           element.classList.add(className[len]);
           len += 1;
@@ -297,25 +258,19 @@ if (isClassListSupported()) {
       }
     }
   };
-
   _removeClass = function _removeClass(element, classes) {
     var rootDocument = element.ownerDocument;
     var className = classes;
-
     if (typeof className === 'string') {
       className = className.split(' ');
     }
-
     className = filterEmptyClassNames(className);
-
     if (className.length > 0) {
       if (isSupportMultipleClassesArg(rootDocument)) {
         var _element$classList2;
-
         (_element$classList2 = element.classList).remove.apply(_element$classList2, _toConsumableArray(className));
       } else {
         var len = 0;
-
         while (className[len]) {
           element.classList.remove(className[len]);
           len += 1;
@@ -327,22 +282,17 @@ if (isClassListSupported()) {
   var createClassNameRegExp = function createClassNameRegExp(className) {
     return new RegExp("(\\s|^)".concat(className, "(\\s|$)"));
   };
-
   _hasClass = function _hasClass(element, className) {
     // http://snipplr.com/view/3561/addclass-removeclass-hasclass/
     return element.className !== void 0 && createClassNameRegExp(className).test(element.className);
   };
-
   _addClass = function _addClass(element, classes) {
     var _className = element.className;
     var className = classes;
-
     if (typeof className === 'string') {
       className = className.split(' ');
     }
-
     className = filterEmptyClassNames(className);
-
     if (_className === '') {
       _className = className.join(' ');
     } else {
@@ -352,32 +302,27 @@ if (isClassListSupported()) {
         }
       }
     }
-
     element.className = _className;
   };
-
   _removeClass = function _removeClass(element, classes) {
     var len = 0;
     var _className = element.className;
     var className = classes;
-
     if (typeof className === 'string') {
       className = className.split(' ');
     }
-
     className = filterEmptyClassNames(className);
-
     while (className[len]) {
       // String.prototype.trim is defined in polyfill.js
       _className = _className.replace(createClassNameRegExp(className[len]), ' ').trim();
       len += 1;
     }
-
     if (element.className !== _className) {
       element.className = _className;
     }
   };
 }
+
 /**
  * Checks if element has class name.
  *
@@ -385,46 +330,44 @@ if (isClassListSupported()) {
  * @param {string} className Class name to check.
  * @returns {boolean}
  */
-
-
 export function hasClass(element, className) {
   return _hasClass(element, className);
 }
+
 /**
  * Add class name to an element.
  *
  * @param {HTMLElement} element An element to process.
  * @param {string|Array} className Class name as string or array of strings.
  */
-
 export function addClass(element, className) {
   _addClass(element, className);
 }
+
 /**
  * Remove class name from an element.
  *
  * @param {HTMLElement} element An element to process.
  * @param {string|Array} className Class name as string or array of strings.
  */
-
 export function removeClass(element, className) {
   _removeClass(element, className);
 }
+
 /**
  * @param {HTMLElement} element An element from the text is removed.
  */
-
 export function removeTextNodes(element) {
   if (element.nodeType === 3) {
     element.parentNode.removeChild(element); // bye text nodes!
   } else if (['TABLE', 'THEAD', 'TBODY', 'TFOOT', 'TR'].indexOf(element.nodeName) > -1) {
     var childs = element.childNodes;
-
     for (var i = childs.length - 1; i >= 0; i--) {
       removeTextNodes(childs[i]);
     }
   }
 }
+
 /**
  * Remove childs function
  * WARNING - this doesn't unload events and data attached by jQuery
@@ -433,16 +376,16 @@ export function removeTextNodes(element) {
  *
  * @param {HTMLElement} element An element to clear.
  */
-
 export function empty(element) {
   var child;
-  /* eslint-disable no-cond-assign */
 
+  /* eslint-disable no-cond-assign */
   while (child = element.lastChild) {
     element.removeChild(child);
   }
 }
 export var HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
+
 /**
  * Insert content into element trying avoid innerHTML method.
  *
@@ -450,28 +393,26 @@ export var HTML_CHARACTERS = /(<(.*)>|&(.*);)/;
  * @param {string} content The text to write.
  * @param {boolean} [sanitizeContent=true] If `true`, the content will be sanitized before writing to the element.
  */
-
 export function fastInnerHTML(element, content) {
   var sanitizeContent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
-
   if (HTML_CHARACTERS.test(content)) {
     element.innerHTML = sanitizeContent ? sanitize(content) : content;
   } else {
     fastInnerText(element, content);
   }
 }
+
 /**
  * Insert text content into element.
  *
  * @param {HTMLElement} element An element to write into.
  * @param {string} content The text to write.
  */
-
 export function fastInnerText(element, content) {
   var child = element.firstChild;
-
   if (child && child.nodeType === 3 && child.nextSibling === null) {
     // fast lane - replace existing text node
+
     if (isTextContentSupported) {
       // http://jsperf.com/replace-text-vs-reuse
       child.textContent = content;
@@ -485,17 +426,16 @@ export function fastInnerText(element, content) {
     element.appendChild(element.ownerDocument.createTextNode(content));
   }
 }
+
 /**
  * Returns true if element is attached to the DOM and visible, false otherwise.
  *
  * @param {HTMLElement} element An element to check.
  * @returns {boolean}
  */
-
 export function isVisible(element) {
   var documentElement = element.ownerDocument.documentElement;
   var next = element;
-
   while (next !== documentElement) {
     // until <html> reached
     if (next === null) {
@@ -513,7 +453,6 @@ export function isVisible(element) {
           // Chrome 33.0.1723.0 canary (2013-11-29) Web Platform features enabled
           return isVisible(next.host);
         }
-
         throw new Error('Lost in Web Components world');
       } else {
         return false; // this is a node detached from document in IE8
@@ -521,19 +460,17 @@ export function isVisible(element) {
     } else if (next.style && next.style.display === 'none') {
       return false;
     }
-
     next = next.parentNode;
   }
-
   return true;
 }
+
 /**
  * Returns elements top and left offset relative to the document. Function is not compatible with jQuery offset.
  *
  * @param {HTMLElement} element An element to get the offset position from.
  * @returns {object} Returns object with `top` and `left` props.
  */
-
 export function offset(element) {
   var rootDocument = element.ownerDocument;
   var rootWindow = rootDocument.defaultView;
@@ -543,7 +480,6 @@ export function offset(element) {
   var offsetTop;
   var lastElem;
   var box;
-
   if (hasCaptionProblem() && elementToCheck.firstChild && elementToCheck.firstChild.nodeName === 'CAPTION') {
     // fixes problem with Firefox ignoring <caption> in TABLE offset (see also export outerHeight)
     // http://jsperf.com/offset-vs-getboundingclientrect/8
@@ -553,35 +489,33 @@ export function offset(element) {
       left: box.left + (rootWindow.pageXOffset || documentElement.scrollLeft) - (documentElement.clientLeft || 0)
     };
   }
-
   offsetLeft = elementToCheck.offsetLeft;
   offsetTop = elementToCheck.offsetTop;
   lastElem = elementToCheck;
-  /* eslint-disable no-cond-assign */
 
+  /* eslint-disable no-cond-assign */
   while (elementToCheck = elementToCheck.offsetParent) {
     // from my observation, document.body always has scrollLeft/scrollTop == 0
     if (elementToCheck === rootDocument.body) {
       break;
     }
-
     offsetLeft += elementToCheck.offsetLeft;
     offsetTop += elementToCheck.offsetTop;
     lastElem = elementToCheck;
-  } // slow - http://jsperf.com/offset-vs-getboundingclientrect/6
-
+  }
 
+  // slow - http://jsperf.com/offset-vs-getboundingclientrect/6
   if (lastElem && lastElem.style.position === 'fixed') {
     // if(lastElem !== document.body) { //faster but does gives false positive in Firefox
     offsetLeft += rootWindow.pageXOffset || documentElement.scrollLeft;
     offsetTop += rootWindow.pageYOffset || documentElement.scrollTop;
   }
-
   return {
     left: offsetLeft,
     top: offsetTop
   };
 }
+
 /**
  * Returns the document's scrollTop property.
  *
@@ -589,18 +523,16 @@ export function offset(element) {
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getWindowScrollTop() {
   var rootWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
   var res = rootWindow.scrollY;
-
   if (res === void 0) {
     // IE8-11
     res = rootWindow.document.documentElement.scrollTop;
   }
-
   return res;
 }
+
 /**
  * Returns the document's scrollLeft property.
  *
@@ -608,18 +540,16 @@ export function getWindowScrollTop() {
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getWindowScrollLeft() {
   var rootWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
   var res = rootWindow.scrollX;
-
   if (res === void 0) {
     // IE8-11
     res = rootWindow.document.documentElement.scrollLeft;
   }
-
   return res;
 }
+
 /**
  * Returns the provided element's scrollTop property.
  *
@@ -628,16 +558,14 @@ export function getWindowScrollLeft() {
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getScrollTop(element) {
   var rootWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : window;
-
   if (element === rootWindow) {
     return getWindowScrollTop(rootWindow);
   }
-
   return element.scrollTop;
 }
+
 /**
  * Returns the provided element's scrollLeft property.
  *
@@ -646,102 +574,86 @@ export function getScrollTop(element) {
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getScrollLeft(element) {
   var rootWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : window;
-
   if (element === rootWindow) {
     return getWindowScrollLeft(rootWindow);
   }
-
   return element.scrollLeft;
 }
+
 /**
  * Returns a DOM element responsible for scrolling of the provided element.
  *
  * @param {HTMLElement} element An element to get the scrollable element from.
  * @returns {HTMLElement} Element's scrollable parent.
  */
-
 export function getScrollableElement(element) {
   var rootDocument = element.ownerDocument;
   var rootWindow = rootDocument ? rootDocument.defaultView : void 0;
-
   if (!rootDocument) {
     rootDocument = element.document ? element.document : element;
     rootWindow = rootDocument.defaultView;
   }
-
   var props = ['auto', 'scroll'];
   var supportedGetComputedStyle = isGetComputedStyleSupported();
   var el = element.parentNode;
-
   while (el && el.style && rootDocument.body !== el) {
     var _el$style = el.style,
-        overflow = _el$style.overflow,
-        overflowX = _el$style.overflowX,
-        overflowY = _el$style.overflowY;
-
+      overflow = _el$style.overflow,
+      overflowX = _el$style.overflowX,
+      overflowY = _el$style.overflowY;
     if ([overflow, overflowX, overflowY].includes('scroll')) {
       return el;
     } else if (supportedGetComputedStyle) {
       var _rootWindow$getComput = rootWindow.getComputedStyle(el);
-
       overflow = _rootWindow$getComput.overflow;
       overflowX = _rootWindow$getComput.overflowX;
       overflowY = _rootWindow$getComput.overflowY;
-
       if (props.includes(overflow) || props.includes(overflowX) || props.includes(overflowY)) {
         return el;
       }
-    } // The '+ 1' after the scrollHeight/scrollWidth is to prevent problems with zoomed out Chrome.
-
+    }
 
+    // The '+ 1' after the scrollHeight/scrollWidth is to prevent problems with zoomed out Chrome.
     if (el.clientHeight <= el.scrollHeight + 1 && (props.includes(overflowY) || props.includes(overflow))) {
       return el;
     }
-
     if (el.clientWidth <= el.scrollWidth + 1 && (props.includes(overflowX) || props.includes(overflow))) {
       return el;
     }
-
     el = el.parentNode;
   }
-
   return rootWindow;
 }
+
 /**
  * Returns a DOM element responsible for trimming the provided element.
  *
  * @param {HTMLElement} base Base element.
  * @returns {HTMLElement} Base element's trimming parent.
  */
-
 export function getTrimmingContainer(base) {
   var rootDocument = base.ownerDocument;
   var rootWindow = rootDocument.defaultView;
   var el = base.parentNode;
-
   while (el && el.style && rootDocument.body !== el) {
     if (el.style.overflow !== 'visible' && el.style.overflow !== '') {
       return el;
     }
-
     var computedStyle = getComputedStyle(el, rootWindow);
     var allowedProperties = ['scroll', 'hidden', 'auto'];
     var property = computedStyle.getPropertyValue('overflow');
     var propertyY = computedStyle.getPropertyValue('overflow-y');
     var propertyX = computedStyle.getPropertyValue('overflow-x');
-
     if (allowedProperties.includes(property) || allowedProperties.includes(propertyY) || allowedProperties.includes(propertyX)) {
       return el;
     }
-
     el = el.parentNode;
   }
-
   return rootWindow;
 }
+
 /**
  * Returns a style property for the provided element. (Be it an inline or external style).
  *
@@ -751,10 +663,8 @@ export function getTrimmingContainer(base) {
  * @returns {string|undefined} Element's style property.
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getStyle(element, prop) {
   var rootWindow = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : window;
-
   if (!element) {
     return;
   } else if (element === rootWindow) {
@@ -763,22 +673,18 @@ export function getStyle(element, prop) {
     } else if (prop === 'height') {
       return "".concat(rootWindow.innerHeight, "px");
     }
-
     return;
   }
-
   var styleProp = element.style[prop];
-
   if (styleProp !== '' && styleProp !== void 0) {
     return styleProp;
   }
-
   var computedStyle = getComputedStyle(element, rootWindow);
-
   if (computedStyle[prop] !== '' && computedStyle[prop] !== void 0) {
     return computedStyle[prop];
   }
 }
+
 /**
  * Verifies if element fit to provided CSSRule.
  *
@@ -786,11 +692,9 @@ export function getStyle(element, prop) {
  * @param {CSSRule} rule Selector text from CSSRule.
  * @returns {boolean}
  */
-
 export function matchesCSSRules(element, rule) {
   var selectorText = rule.selectorText;
   var result = false;
-
   if (rule.type === CSSRule.STYLE_RULE && selectorText) {
     if (element.msMatchesSelector) {
       result = element.msMatchesSelector(selectorText);
@@ -798,9 +702,9 @@ export function matchesCSSRules(element, rule) {
       result = element.matches(selectorText);
     }
   }
-
   return result;
 }
+
 /**
  * Returns a computed style object for the provided element. (Needed if style is declared in external stylesheet).
  *
@@ -809,28 +713,27 @@ export function matchesCSSRules(element, rule) {
  * @returns {IEElementStyle|CssStyle} Elements computed style object.
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getComputedStyle(element) {
   var rootWindow = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : window;
   return element.currentStyle || rootWindow.getComputedStyle(element);
 }
+
 /**
  * Returns the element's outer width.
  *
  * @param {HTMLElement} element An element to get the width from.
  * @returns {number} Element's outer width.
  */
-
 export function outerWidth(element) {
   return element.offsetWidth;
 }
+
 /**
  * Returns the element's outer height.
  *
  * @param {HTMLElement} element An element to get the height from.
  * @returns {number} Element's outer height.
  */
-
 export function outerHeight(element) {
   if (hasCaptionProblem() && element.firstChild && element.firstChild.nodeName === 'CAPTION') {
     // fixes problem with Firefox ignoring <caption> in TABLE.offsetHeight
@@ -842,47 +745,47 @@ export function outerHeight(element) {
     // http://lists.w3.org/Archives/Public/www-style/2009Oct/0140.html#start140
     return element.offsetHeight + element.firstChild.offsetHeight;
   }
-
   return element.offsetHeight;
 }
+
 /**
  * Returns the element's inner height.
  *
  * @param {HTMLElement} element An element to get the height from.
  * @returns {number} Element's inner height.
  */
-
 export function innerHeight(element) {
   return element.clientHeight || element.innerHeight;
 }
+
 /**
  * Returns the element's inner width.
  *
  * @param {HTMLElement} element An element to get the width from.
  * @returns {number} Element's inner width.
  */
-
 export function innerWidth(element) {
   return element.clientWidth || element.innerWidth;
 }
+
 /**
  * @param {HTMLElement} element An element to which the event is added.
  * @param {string} event The event name.
  * @param {Function} callback The callback to add.
  */
-
 export function addEvent(element, event, callback) {
   element.addEventListener(event, callback, false);
 }
+
 /**
  * @param {HTMLElement} element An element from which the event is removed.
  * @param {string} event The event name.
  * @param {Function} callback The function reference to remove.
  */
-
 export function removeEvent(element, event, callback) {
   element.removeEventListener(event, callback, false);
 }
+
 /**
  * Returns caret position in text input.
  *
@@ -890,56 +793,48 @@ export function removeEvent(element, event, callback) {
  * @param {HTMLElement} el An element to check.
  * @returns {number}
  */
-
 export function getCaretPosition(el) {
   var rootDocument = el.ownerDocument;
-
   if (el.selectionStart) {
     return el.selectionStart;
   } else if (rootDocument.selection) {
     // IE8
     el.focus();
     var r = rootDocument.selection.createRange();
-
     if (r === null) {
       return 0;
     }
-
     var re = el.createTextRange();
     var rc = re.duplicate();
     re.moveToBookmark(r.getBookmark());
     rc.setEndPoint('EndToStart', re);
     return rc.text.length;
   }
-
   return 0;
 }
+
 /**
  * Returns end of the selection in text input.
  *
  * @param {HTMLElement} el An element to check.
  * @returns {number}
  */
-
 export function getSelectionEndPosition(el) {
   var rootDocument = el.ownerDocument;
-
   if (el.selectionEnd) {
     return el.selectionEnd;
   } else if (rootDocument.selection) {
     // IE8
     var r = rootDocument.selection.createRange();
-
     if (r === null) {
       return 0;
     }
-
     var re = el.createTextRange();
     return re.text.indexOf(r.text) + r.text.length;
   }
-
   return 0;
 }
+
 /**
  * Returns text under selection.
  *
@@ -947,31 +842,29 @@ export function getSelectionEndPosition(el) {
  * @returns {string}
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function getSelectionText() {
   var rootWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
   var rootDocument = rootWindow.document;
   var text = '';
-
   if (rootWindow.getSelection) {
     text = rootWindow.getSelection().toString();
   } else if (rootDocument.selection && rootDocument.selection.type !== 'Control') {
     text = rootDocument.selection.createRange().text;
   }
-
   return text;
 }
+
 /**
  * Cross-platform helper to clear text selection.
  *
  * @param {Window} [rootWindow] The document window owner.
  */
 // eslint-disable-next-line no-restricted-globals
-
 export function clearTextSelection() {
   var rootWindow = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : window;
-  var rootDocument = rootWindow.document; // http://stackoverflow.com/questions/3169786/clear-text-selection-with-javascript
+  var rootDocument = rootWindow.document;
 
+  // http://stackoverflow.com/questions/3169786/clear-text-selection-with-javascript
   if (rootWindow.getSelection) {
     if (rootWindow.getSelection().empty) {
       // Chrome
@@ -985,6 +878,7 @@ export function clearTextSelection() {
     rootDocument.selection.empty();
   }
 }
+
 /**
  * Sets caret position in text input.
  *
@@ -993,15 +887,12 @@ export function clearTextSelection() {
  * @param {number} pos The selection start position.
  * @param {number} endPos The selection end position.
  */
-
 export function setCaretPosition(element, pos, endPos) {
   if (endPos === void 0) {
     endPos = pos;
   }
-
   if (element.setSelectionRange) {
     element.focus();
-
     try {
       element.setSelectionRange(pos, endPos);
     } catch (err) {
@@ -1014,6 +905,7 @@ export function setCaretPosition(element, pos, endPos) {
   }
 }
 var cachedScrollbarWidth;
+
 /**
  * Helper to calculate scrollbar width.
  * Source: https://stackoverflow.com/questions/986937/how-can-i-get-the-browsers-scrollbar-sizes.
@@ -1023,7 +915,6 @@ var cachedScrollbarWidth;
  * @returns {number}
  */
 // eslint-disable-next-line no-restricted-globals
-
 function walkontableCalculateScrollbarWidth() {
   var rootDocument = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : document;
   var inner = rootDocument.createElement('div');
@@ -1043,14 +934,13 @@ function walkontableCalculateScrollbarWidth() {
   var w1 = inner.offsetWidth;
   outer.style.overflow = 'scroll';
   var w2 = inner.offsetWidth;
-
   if (w1 === w2) {
     w2 = outer.clientWidth;
   }
-
   (rootDocument.body || rootDocument.documentElement).removeChild(outer);
   return w1 - w2;
 }
+
 /**
  * Returns the computed width of the native browser scroll bar.
  *
@@ -1058,37 +948,34 @@ function walkontableCalculateScrollbarWidth() {
  * @returns {number} Width.
  */
 // eslint-disable-next-line no-restricted-globals
-
-
 export function getScrollbarWidth() {
   var rootDocument = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : document;
-
   if (cachedScrollbarWidth === void 0) {
     cachedScrollbarWidth = walkontableCalculateScrollbarWidth(rootDocument);
   }
-
   return cachedScrollbarWidth;
 }
+
 /**
  * Checks if the provided element has a vertical scrollbar.
  *
  * @param {HTMLElement} element An element to check.
  * @returns {boolean}
  */
-
 export function hasVerticalScrollbar(element) {
   return element.offsetWidth !== element.clientWidth;
 }
+
 /**
  * Checks if the provided element has a vertical scrollbar.
  *
  * @param {HTMLElement} element An element to check.
  * @returns {boolean}
  */
-
 export function hasHorizontalScrollbar(element) {
   return element.offsetHeight !== element.clientHeight;
 }
+
 /**
  * Sets overlay position depending on it's type and used browser.
  *
@@ -1096,7 +983,6 @@ export function hasHorizontalScrollbar(element) {
  * @param {number|string} left The left position of the overlay.
  * @param {number|string} top The top position of the overlay.
  */
-
 export function setOverlayPosition(overlayElem, left, top) {
   if (isIE9()) {
     overlayElem.style.top = top;
@@ -1107,26 +993,24 @@ export function setOverlayPosition(overlayElem, left, top) {
     overlayElem.style.transform = "translate3d(".concat(left, ",").concat(top, ",0)");
   }
 }
+
 /**
  * @param {HTMLElement} element An element to process.
  * @returns {number|Array}
  */
-
 export function getCssTransform(element) {
   var transform;
-
   if (element.style.transform && (transform = element.style.transform) !== '') {
     return ['transform', transform];
   } else if (element.style['-webkit-transform'] && (transform = element.style['-webkit-transform']) !== '') {
     return ['-webkit-transform', transform];
   }
-
   return -1;
 }
+
 /**
  * @param {HTMLElement} element An element to process.
  */
-
 export function resetCssTransform(element) {
   if (element.style.transform && element.style.transform !== '') {
     element.style.transform = '';
@@ -1134,6 +1018,7 @@ export function resetCssTransform(element) {
     element.style['-webkit-transform'] = '';
   }
 }
+
 /**
  * Determines if the given DOM element is an input field.
  * Notice: By 'input' we mean input, textarea and select nodes.
@@ -1141,11 +1026,11 @@ export function resetCssTransform(element) {
  * @param {HTMLElement} element - DOM element.
  * @returns {boolean}
  */
-
 export function isInput(element) {
   var inputs = ['INPUT', 'SELECT', 'TEXTAREA'];
   return element && (inputs.indexOf(element.nodeName) > -1 || element.contentEditable === 'true');
 }
+
 /**
  * Determines if the given DOM element is an input field placed OUTSIDE of HOT.
  * Notice: By 'input' we mean input, textarea and select nodes which have defined 'data-hot-input' attribute.
@@ -1153,30 +1038,49 @@ export function isInput(element) {
  * @param {HTMLElement} element - DOM element.
  * @returns {boolean}
  */
-
 export function isOutsideInput(element) {
   return isInput(element) && element.hasAttribute('data-hot-input') === false;
 }
+
 /**
  * Check if the given DOM element can be focused (by using "select" method).
  *
  * @param {HTMLElement} element - DOM element.
  */
-
 export function selectElementIfAllowed(element) {
   var activeElement = element.ownerDocument.activeElement;
-
   if (!isOutsideInput(activeElement)) {
     element.select();
   }
 }
+
 /**
  * Check if the provided element is detached from DOM.
  *
  * @param {HTMLElement} element HTML element to be checked.
  * @returns {boolean} `true` if the element is detached, `false` otherwise.
  */
-
 export function isDetached(element) {
   return !element.parentNode;
+}
+
+/**
+ * Set up an observer to recognize when the provided element first becomes visible and trigger a callback when it
+ * happens.
+ *
+ * @param {HTMLElement} elementToBeObserved Element to be observed.
+ * @param {Function} callback The callback function.
+ */
+export function observeVisibilityChangeOnce(elementToBeObserved, callback) {
+  var visibilityObserver = new IntersectionObserver(function (entries, observer) {
+    entries.forEach(function (entry) {
+      if (entry.isIntersecting && elementToBeObserved.offsetParent !== null) {
+        callback();
+        observer.unobserve(elementToBeObserved);
+      }
+    });
+  }, {
+    root: elementToBeObserved.ownerDocument.body
+  });
+  visibilityObserver.observe(elementToBeObserved);
 }