@webalternatif/js-core 1.5.4 → 1.6.0

package/README.md

@@ -1,7 +1,59 @@
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+![Tests](https://img.shields.io/github/actions/workflow/status/webalternatif/js-core/ci.yml?label=Tests)
+[![codecov](https://codecov.io/github/webalternatif/js-core/branch/main/graph/badge.svg?token=MLPFU51XJH)](https://codecov.io/github/webalternatif/js-core)
+![npm](https://img.shields.io/npm/v/@webalternatif/js-core)
+
 # js-core
-A set of Javascript utility functions.
 
-## Functions
+Modular JavaScript utilities for modern applications.
+
+Lightweight, framework-agnostic helpers for data manipulation, DOM handling, events and internationalization.
+
+---
+
+## Installation
+
+```bash
+npm install @webalternatif/js-core
+```
+
+```bash
+yarn add @webalternatif/js-core
+```
+
+## Basic Usage
+
+The default export provides pure JavaScript utilities only.
+
+```js
+import webf from '@webalternatif/js-core'
+
+webf.unique([1, 2, 2]) // [1, 2]
+webf.numberFormat(12345.6789, 2, true, '.', ',') // 12.345,68
+webf.isTouchDevice() // true or false
+```
+
+## Documentation
+
+### Core modules
+- [String utilities](docs/string.md)
+- [Array utilities](docs/array.md)
+- [Type checking](docs/is.md)
+- [Random utilities](docs/random.md)
+- [Traversal utilities](docs/traversal.md)
+- [Math utilities](docs/math.md)
+- [General utilities](docs/utils.md)
+
+### Additional modules
+- [DOM utilities](docs/dom.md)
+- [Event Dispatcher](docs/eventDispatcher.md)
+- [Translator (i18n)](docs/translator.md)
+- [Mouse utilities](docs/mouse.md)
 
 ## Tests
 
+This project uses Jest for unit testing.
+
+```bash
+yarn test
+```

package/dist/cjs/Mouse.js

@@ -18,7 +18,13 @@ var Mouse = /*#__PURE__*/function () {
   }
   return _createClass(Mouse, null, [{
     key: "getPosition",
-    value: function getPosition(ev, element) {
+    value:
+    /**
+     * @param {Event} ev
+     * @param {Element} element
+     * @returns {{x: number, y: number}}
+     */
+    function getPosition(ev, element) {
       ev = _assertClassBrand(Mouse, this, _getEvent).call(this, ev);
       var rect = {
         left: 0,
@@ -32,10 +38,15 @@ var Mouse = /*#__PURE__*/function () {
         };
       }
       return {
-        x: ev.pageX !== undefined ? ev.pageX - rect.left : rect.left,
-        y: ev.pageY !== undefined ? ev.pageY - rect.top : rect.top
+        x: ev.pageX - rect.left,
+        y: ev.pageY - rect.top
       };
     }
+
+    /**
+     * @param {Event} ev
+     * @returns {{x: number, y: number}}
+     */
   }, {
     key: "getViewportPosition",
     value: function getViewportPosition(ev) {
@@ -51,18 +62,24 @@ var Mouse = /*#__PURE__*/function () {
       ev = _assertClassBrand(Mouse, this, _getEvent).call(this, ev);
       return window.document.elementFromPoint(ev.clientX, ev.clientY);
     }
+
+    /**
+     * @param {Event|{originalEvent?: Event}} ev
+     * @returns {Event}
+     */
   }]);
 }();
 function _getEvent(ev) {
   var _ev$originalEvent;
+  ev = (_ev$originalEvent = ev.originalEvent) !== null && _ev$originalEvent !== void 0 ? _ev$originalEvent : ev;
   if ((0, _is.isTouchDevice)()) {
-    var orgEvent = ev.originalEvent ? ev.originalEvent : ev;
-    if (orgEvent.changedTouches && orgEvent.changedTouches.length) {
-      ev = orgEvent.changedTouches[0];
-    } else if (orgEvent.touches) {
-      ev = orgEvent.touches[0];
-    }
+    var _ev$changedTouches, _ev$touches;
+    var touch = ((_ev$changedTouches = ev.changedTouches) === null || _ev$changedTouches === void 0 ? void 0 : _ev$changedTouches[0]) || ((_ev$touches = ev.touches) === null || _ev$touches === void 0 ? void 0 : _ev$touches[0]);
+    ev.clientX = touch.clientX;
+    ev.clientY = touch.clientY;
+    ev.pageX = touch.pageX;
+    ev.pageY = touch.pageY;
   }
-  return (_ev$originalEvent = ev.originalEvent) !== null && _ev$originalEvent !== void 0 ? _ev$originalEvent : ev;
+  return ev;
 }
 var _default = exports["default"] = Mouse;

package/dist/cjs/Translator.js

@@ -19,13 +19,13 @@ function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
 function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 /**
- * @typedef {string | (() => string)} TranslatorValue
+ * @typedef {string|(()=>string)} TranslatorValue
  */
 /**
- * @typedef {Record<string, Record<string, Record<string, TranslatorValue>>>} TranslatorNsMapping
+ * @typedef {Record<string,Record<string,Record<string,TranslatorValue>>>} TranslatorNsMapping
  */
 /**
- * @typedef {Record<string, Record<string, TranslatorValue>>} TranslatorCoreMapping
+ * @typedef {Record<string,Record<string,TranslatorValue>>} TranslatorCoreMapping
  */
 /**
  * @typedef {TranslatorNsMapping | TranslatorCoreMapping} TranslatorMapping
@@ -65,7 +65,7 @@ var Translator = exports["default"] = /*#__PURE__*/function () {
         var entry = _classPrivateFieldGet(_mapping, this)[namespace][lang][label];
         return _assertClassBrand(_Translator_brand, this, _resolve).call(this, entry);
       }
-      return 'en' !== lang ? this.translate(label, namespace, 'en') : label;
+      return 'en' !== lang ? this.translate(label, 'en', namespace) : label;
     }
 
     /**
@@ -142,11 +142,7 @@ function _findKeyByValue(entries, label) {
 }
 function _resolve(entry) {
   if ((0, _is.isFunction)(entry)) {
-    try {
-      return entry();
-    } catch (e) {
-      return null;
-    }
+    return entry();
   }
   return entry;
 }

package/dist/cjs/array.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.range = exports.indexOf = exports.inArray = exports.compareArray = exports.array_unique = exports.array_diff = exports.arrayUnique = exports.arrayDiff = void 0;
+exports.range = exports.lastIndexOf = exports.indexOf = exports.inArray = exports.compareArray = exports.array_unique = exports.array_diff = exports.arrayUnique = exports.arrayDiff = void 0;
 var _traversal = require("./traversal.js");
 var _is = require("./is.js");
 var _math = require("./math.js");
@@ -11,7 +11,7 @@ var _utils = require("./utils.js");
 /**
  * Checks if a value exists in an array or an object
  *
- * @param {*} value the searched value
+ * @param {any} value the searched value
  * @param {Object|Array} arr the array
  * @param {number} [index=0] if provided, search from this index
  * @param {boolean} [strict=false] if true, search is done with strict equality
@@ -26,8 +26,7 @@ var _utils = require("./utils.js");
  * // → true
  *
  * @example
- * inArray(5, [1, 2, 3])
- * // → false
+ * inArray(5, [1, 2, 3]) // → false
  */
 var inArray = exports.inArray = function inArray(value, arr) {
   var index = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
@@ -56,11 +55,47 @@ var inArray = exports.inArray = function inArray(value, arr) {
   });
   return ret;
 };
+
+/**
+ * Returns the first index at which a given element can be found in an array or a string.
+ * or -1 if it is not present.
+ *
+ * @param {Array<any>|string} arr - The array to search in
+ * @param {any} elt - The element to search for
+ * @param {number} [from] - The index to start the search from. Can be negative.
+ * @returns {number} - The index of the element, or -1 if not found
+ */
 var indexOf = exports.indexOf = function indexOf(arr, elt) {
   var from = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
-  from = from < 0 ? Math.ceil(from) + arr.length : Math.floor(from);
-  for (; from < arr.length; from++) {
-    if (from in arr && arr[from] === elt) {
+  var a = (0, _is.isString)(arr) ? (0, _traversal.map)(arr, function (_, a) {
+    return a;
+  }) : arr;
+  from = from < 0 ? Math.ceil(from) + a.length : Math.floor(from);
+  for (; from < a.length; from++) {
+    if (from in a && a[from] === elt) {
+      return from;
+    }
+  }
+  return -1;
+};
+
+/**
+ * Returns the last index at which a given element can be found in an array or a string.
+ * or -1 if it is not present.
+ *
+ * @param {Array<any>|string} arr - The array to search in
+ * @param {any} elt - The element to search for
+ * @param {number} [from] - The index to start the search from. Can be negative.
+ * @returns {number} - The index of the element, or -1 if not found
+ */
+var lastIndexOf = exports.lastIndexOf = function lastIndexOf(arr, elt) {
+  var from = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : -1;
+  var a = (0, _is.isString)(arr) ? (0, _traversal.map)(arr, function (_, a) {
+    return a;
+  }) : arr;
+  from = from < 0 ? a.length + Math.ceil(from) : Math.floor(from);
+  for (; from >= 0; from--) {
+    if (from in a && a[from] === elt) {
       return from;
     }
   }

package/dist/cjs/dom.js

@@ -8,12 +8,7 @@ var _is = require("./is.js");
 var _string = require("./string.js");
 var _traversal = require("./traversal.js");
 var _array = require("./array.js");
-var _Mouse = _interopRequireDefault(require("./Mouse.js"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
-function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
-function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
-function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+var _onOff = require("./onOff.js");
 function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _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(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
@@ -21,116 +16,6 @@ function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Sym
 function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 var cssNumber = ['animationIterationCount', 'aspectRatio', 'borderImageSlice', 'columnCount', 'flexGrow', 'flexShrink', 'fontWeight', 'gridArea', 'gridColumn', 'gridColumnEnd', 'gridColumnStart', 'gridRow', 'gridRowEnd', 'gridRowStart', 'lineHeight', 'opacity', 'order', 'orphans', 'scale', 'widows', 'zIndex', 'zoom', 'fillOpacity', 'floodOpacity', 'stopOpacity', 'strokeMiterlimit', 'strokeOpacity'];
-var LISTENERS = new Map();
-var CUSTOM_EVENTS = ['longtap', 'dbltap'];
-var ENABLED_EVENTS = new Set();
-var _teardownLongTap = null;
-var _teardownDblTap = null;
-var supplyEvent = function supplyEvent(event) {
-  if (ENABLED_EVENTS !== null && ENABLED_EVENTS !== void 0 && ENABLED_EVENTS.has(event)) return;
-  if (event === 'longtap') enableLongTap();
-  if (event === 'dbltap') enableDblTap();
-  ENABLED_EVENTS.add(event);
-};
-var enableLongTap = function enableLongTap() {
-  var LONGPRESS_DELAY = 800;
-  var MOVE_TOLERANCE = 8;
-  var timer = null;
-  var startX = 0;
-  var startY = 0;
-  var target = null;
-  var start = function start(ev) {
-    target = ev.target;
-    var pos = _Mouse["default"].getViewportPosition(ev);
-    startX = pos.x;
-    startY = pos.y;
-    timer = setTimeout(function () {
-      target.dispatchEvent(new CustomEvent('longtap', {
-        bubbles: true,
-        cancelable: true,
-        detail: {
-          originalEvent: ev
-        }
-      }));
-      timer = null;
-    }, LONGPRESS_DELAY);
-  };
-  var move = function move(ev) {
-    if (!timer) return;
-    var pos = _Mouse["default"].getViewportPosition(ev);
-    if (Math.hypot(pos.x - startX, pos.y - startY) > MOVE_TOLERANCE) {
-      clearTimeout(timer);
-      timer = null;
-    }
-  };
-  var end = function end() {
-    if (timer) clearTimeout(timer);
-    timer = null;
-  };
-  document.addEventListener('touchstart', start, {
-    passive: true
-  });
-  document.addEventListener('touchmove', move, {
-    passive: true
-  });
-  document.addEventListener('touchend', end);
-  document.addEventListener('touchcancel', end);
-  _teardownLongTap = function teardownLongTap() {
-    document.removeEventListener('touchstart', start, {
-      passive: true
-    });
-    document.removeEventListener('touchmove', move, {
-      passive: true
-    });
-    document.removeEventListener('touchend', end);
-    document.removeEventListener('touchcancel', end);
-    _teardownLongTap = null;
-  };
-};
-var enableDblTap = function enableDblTap() {
-  var DBLTAP_DELAY = 300;
-  var MOVE_TOLERANCE = 40;
-  var lastTapTime = 0;
-  var lastPos = null;
-  if ((0, _is.isTouchDevice)()) {
-    document.addEventListener('dblclick', function (ev) {
-      ev.preventDefault();
-      ev.stopPropagation();
-      ev.stopImmediatePropagation();
-    }, {
-      capture: true
-    });
-  }
-  var start = function start(ev) {
-    var target = ev.target;
-    if (Date.now() - lastTapTime > DBLTAP_DELAY) {
-      lastTapTime = Date.now();
-      lastPos = _Mouse["default"].getViewportPosition(ev);
-    } else {
-      var pos = _Mouse["default"].getViewportPosition(ev);
-      if (Math.hypot(pos.x - lastPos.x, pos.y - lastPos.y) <= MOVE_TOLERANCE) {
-        target.dispatchEvent(new CustomEvent('dbltap', {
-          bubbles: true,
-          cancelable: true,
-          detail: {
-            originalEvent: ev
-          }
-        }));
-      }
-      lastTapTime = Date.now();
-      lastPos = pos;
-    }
-  };
-  document.addEventListener('touchstart', start, {
-    passive: true
-  });
-  _teardownDblTap = function teardownDblTap() {
-    document.removeEventListener('touchstart', start, {
-      passive: true
-    });
-    _teardownDblTap = null;
-  };
-};
 
 /**
  * @param {any} o
@@ -379,9 +264,7 @@ var dom = {
    */
   closest: function closest(el, selector) {
     if (selector instanceof Element) {
-      if (el === selector) {
-        return el;
-      }
+      if (el === selector) return el;
       var parentEl = el.parentElement;
       while (parentEl) {
         if (parentEl === selector) {
@@ -539,7 +422,7 @@ var dom = {
   /**
    * @param {Element} el
    * @param {string} [html]
-   * @returns {Element|*}
+   * @returns {Element|string}
    */
   html: function html(el, _html) {
     if (undefined === _html) return el.innerHTML;
@@ -549,7 +432,7 @@ var dom = {
   /**
    * @param {Element} el
    * @param {string} [text]
-   * @returns {Element|*}
+   * @returns {Element|string}
    */
   text: function text(el, _text) {
     if (undefined === _text) return el.innerText;
@@ -626,128 +509,6 @@ var dom = {
     delete el.dataset[key];
     return el;
   },
-  /**
-   * @param {Element|Document|Window} el
-   * @param {string} events
-   * @param {string|Element|function} selector
-   * @param {function|AddEventListenerOptions|boolean} [handler]
-   * @param {AddEventListenerOptions|boolean} [options]
-   * @returns {Element}
-   */
-  on: function on(el, events, selector, handler, options) {
-    var _this5 = this;
-    if ((0, _is.isFunction)(selector)) {
-      options = handler;
-      handler = selector;
-      selector = null;
-    }
-    (0, _traversal.foreach)(events.split(' '), function (rawEvent) {
-      var _rawEvent$split = rawEvent.split('.'),
-        _rawEvent$split2 = _slicedToArray(_rawEvent$split, 2),
-        event = _rawEvent$split2[0],
-        namespace = _rawEvent$split2[1];
-      var listener = function listener(ev) {
-        if (!selector) {
-          handler.call(el, ev);
-          return;
-        }
-        var currentTarget = ev.target;
-        var _loop = function _loop() {
-            if (_this5.matches(currentTarget, selector)) {
-              var wrappedEv = {
-                _immediateStopped: false,
-                originalEvent: ev,
-                type: ev.type,
-                target: ev.target,
-                currentTarget: currentTarget,
-                relatedTarget: ev.relatedTarget,
-                button: ev.button,
-                pageX: ev.pageX,
-                pageY: ev.pageY,
-                preventDefault: function preventDefault() {
-                  return ev.preventDefault.apply(ev, arguments);
-                },
-                stopPropagation: function stopPropagation() {
-                  return ev.stopPropagation.apply(ev, arguments);
-                },
-                stopImmediatePropagation: function stopImmediatePropagation() {
-                  wrappedEv._immediateStopped = true;
-                  ev.stopImmediatePropagation.apply(ev, arguments);
-                }
-              };
-              handler.call(currentTarget, wrappedEv);
-              if (wrappedEv._immediateStopped) {
-                return {
-                  v: void 0
-                };
-              }
-              return 0; // break
-            }
-            currentTarget = currentTarget.parentElement;
-          },
-          _ret;
-        while (currentTarget && currentTarget !== el) {
-          _ret = _loop();
-          if (_ret === 0) break;
-          if (_ret) return _ret.v;
-        }
-      };
-      var store = LISTENERS.get(el);
-      if (!store) {
-        store = [];
-        LISTENERS.set(el, store);
-      }
-      store.push({
-        event: event,
-        handler: handler,
-        selector: selector,
-        listener: listener,
-        namespace: namespace,
-        options: options
-      });
-      if ((0, _array.inArray)(event, CUSTOM_EVENTS)) {
-        supplyEvent(event);
-      }
-      el.addEventListener(event, listener, options);
-    });
-    return el;
-  },
-  /**
-   * @param {Element|Document|Window} el
-   * @param {string} [events]
-   * @param {string|Element|function} [selector]
-   * @param {function|AddEventListenerOptions|boolean} [handler]
-   * @param {AddEventListenerOptions|boolean} [options]
-   * @returns {Element}
-   */
-  off: function off(el, events, selector, handler, options) {
-    if ((0, _is.isFunction)(selector)) {
-      options = handler;
-      handler = selector;
-      selector = null;
-    }
-    var store = LISTENERS.get(el);
-    if (!store) return el;
-    var evts = events ? events.split(' ') : [undefined];
-    (0, _traversal.foreach)(evts, function (rawEvent) {
-      var _ref = undefined === rawEvent ? [undefined, undefined] : rawEvent.split('.'),
-        _ref2 = _slicedToArray(_ref, 2),
-        event = _ref2[0],
-        namespace = _ref2[1];
-      event = !event ? undefined : event;
-      var hasEvent = undefined !== event;
-      var hasNs = undefined !== namespace;
-      (0, _traversal.foreach)(_toConsumableArray(store).reverse(), function (l) {
-        var match = !hasEvent && !hasNs || hasEvent && !hasNs && l.event === event || !hasEvent && hasNs && l.namespace === namespace || hasEvent && hasNs && l.event === event && l.namespace === namespace;
-        if (match && (undefined === event || l.event === event) && (undefined === handler || l.handler === handler) && (undefined === selector || l.selector === selector) && (undefined === namespace || l.namespace === namespace) && (undefined === options || l.options === options)) {
-          el.removeEventListener(l.event, l.listener, l.options);
-          var index = store.indexOf(l);
-          index !== -1 && store.splice(index, 1);
-        }
-      });
-    });
-    return el;
-  },
   /**
    * @param {HTMLElement} el
    * @param {Object<string, string>|string} style
@@ -755,7 +516,7 @@ var dom = {
    * @returns {Element}
    */
   css: function css(el, style, value) {
-    var _this6 = this;
+    var _this5 = this;
     if ((0, _is.isString)(style)) {
       var prop = style.startsWith('--') ? style : (0, _string.camelCase)(style);
       if (undefined === value) {
@@ -769,7 +530,7 @@ var dom = {
       }
     } else {
       (0, _traversal.each)(style, function (name, v) {
-        _this6.css(el, name, v);
+        _this5.css(el, name, v);
       });
     }
     return el;
@@ -824,7 +585,7 @@ var dom = {
    * @returns {Element|DocumentFragment|null}
    */
   create: function create(html) {
-    html += '';
+    if (!(0, _is.isString)(html)) return null;
     var isTagName = function isTagName(s) {
       return /^[A-Za-z][A-Za-z0-9-]*$/.test(s);
     };
@@ -837,7 +598,6 @@ var dom = {
     if (frag.childElementCount === 1 && frag.children.length === 1) {
       return frag.firstElementChild;
     }
-    if (!frag.firstChild) return null;
     return frag.cloneNode(true);
   },
   /**
@@ -846,14 +606,13 @@ var dom = {
    * @returns {Element|null}
    */
   eq: function eq(nodeList) {
-    var _nodeList$index;
     var index = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
     nodeList = Array.from(nodeList);
     if (Math.abs(index) >= nodeList.length) return null;
     if (index < 0) {
       index = nodeList.length + index;
     }
-    return (_nodeList$index = nodeList[index]) !== null && _nodeList$index !== void 0 ? _nodeList$index : null;
+    return nodeList[index];
   },
   /**
    * @param {Element} el
@@ -880,13 +639,10 @@ var dom = {
     return el.parentElement.insertBefore(newEl, el);
   },
   /**
-   * @param {Element|string} el
+   * @param {Element} el
    * @returns {Element}
    */
   empty: function empty(el) {
-    if ((0, _is.isString)(el)) {
-      el = this.findOne(el);
-    }
     while (el.firstChild) {
       el.removeChild(el.firstChild);
     }
@@ -901,7 +657,8 @@ var dom = {
     var elements = el instanceof Element ? [el] : Array.from(el);
     var selectorIsString = (0, _is.isString)(selector);
     return elements.filter(function (e) {
-      if (!(e instanceof Element)) return false;
+      // if (!(e instanceof Element)) return false
+
       return selectorIsString ? !e.matches(selector) : e !== selector;
     });
   },
@@ -937,16 +694,16 @@ var dom = {
    * @returns {Element}
    */
   replaceChildren: function replaceChildren(el) {
-    var _this7 = this;
+    var _this6 = this;
     var nodes = [];
     for (var _len4 = arguments.length, children = new Array(_len4 > 1 ? _len4 - 1 : 0), _key4 = 1; _key4 < _len4; _key4++) {
       children[_key4 - 1] = arguments[_key4];
     }
     (0, _traversal.foreach)(children, function (child) {
       if ((0, _is.isString)(child)) {
-        child = _this7.create(child);
+        child = _this6.create(child);
       }
-      if (child) nodes.push(child);
+      nodes.push(child);
     });
     el.replaceChildren.apply(el, nodes);
     return el;
@@ -973,14 +730,36 @@ var dom = {
       top: rect.top + wOffset.top,
       left: rect.left + wOffset.left
     };
-  }
+  },
+  /**
+   * @param {Node} el
+   * @returns {boolean}
+   */
+  isEditable: function isEditable(el) {
+    var _el;
+    if (((_el = el) === null || _el === void 0 ? void 0 : _el.nodeType) === 3) el = el.parentElement;
+    if (!(el instanceof HTMLElement)) return false;
+    return (0, _array.inArray)(el.tagName, ['INPUT', 'TEXTAREA', 'SELECT']) || el.isContentEditable || !!this.closest(el, '[contenteditable="true"]');
+  },
+  /**
+   * @param {Node} node
+   * @returns {boolean}
+   */
+  isInDOM: function isInDOM(node) {
+    if (!(node instanceof Node)) return false;
+    var root = node.getRootNode({
+      composed: true
+    });
+    return root === document;
+  },
+  on: _onOff.on,
+  off: _onOff.off
 };
+
+/* istanbul ignore next */
 if ('test' === process.env.NODE_ENV) {
   dom.__resetCustomEventsForTests = function () {
-    var _teardownLongTap2, _teardownDblTap2;
-    ENABLED_EVENTS.clear();
-    (_teardownLongTap2 = _teardownLongTap) === null || _teardownLongTap2 === void 0 || _teardownLongTap2();
-    (_teardownDblTap2 = _teardownDblTap) === null || _teardownDblTap2 === void 0 || _teardownDblTap2();
+    (0, _onOff.__resetCustomEventsForTests)();
   };
 }
 var _default = exports["default"] = dom;