@webalternatif/js-core 1.5.4 → 1.6.0

package/dist/esm/array.js

@@ -1,4 +1,4 @@
-import { each } from "./traversal.js";
+import { each, map } from "./traversal.js";
 import { isArray, isInteger, isObject, isString, isUndefined } from "./is.js";
 import { round } from "./math.js";
 import { equals } from "./utils.js";
@@ -6,7 +6,7 @@ import { equals } from "./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
@@ -21,8 +21,7 @@ import { equals } from "./utils.js";
  * // → true
  *
  * @example
- * inArray(5, [1, 2, 3])
- * // → false
+ * inArray(5, [1, 2, 3]) // → false
  */
 export var inArray = function inArray(value, arr) {
   var index = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
@@ -51,11 +50,47 @@ export var 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
+ */
 export var 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 = isString(arr) ? 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
+ */
+export var lastIndexOf = function lastIndexOf(arr, elt) {
+  var from = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : -1;
+  var a = isString(arr) ? 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/esm/dom.js

@@ -1,129 +1,15 @@
-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; }
 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; } }
 function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
 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; }
-import { isArray, isArrayLike, isFunction, isObject, isPlainObject, isString, isTouchDevice } from "./is.js";
+import { isArray, isArrayLike, isObject, isPlainObject, isString } from "./is.js";
 import { camelCase } from "./string.js";
 import { each, foreach, map } from "./traversal.js";
 import { inArray } from "./array.js";
-import Mouse from "./Mouse.js";
+import { on, off, __resetCustomEventsForTests } from './onOff.js';
 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.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.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 (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.getViewportPosition(ev);
-    } else {
-      var pos = Mouse.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
@@ -372,9 +258,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) {
@@ -532,7 +416,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;
@@ -542,7 +426,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;
@@ -619,128 +503,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 (isFunction(selector)) {
-      options = handler;
-      handler = selector;
-      selector = null;
-    }
-    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 (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 (isFunction(selector)) {
-      options = handler;
-      handler = selector;
-      selector = null;
-    }
-    var store = LISTENERS.get(el);
-    if (!store) return el;
-    var evts = events ? events.split(' ') : [undefined];
-    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;
-      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
@@ -748,7 +510,7 @@ var dom = {
    * @returns {Element}
    */
   css: function css(el, style, value) {
-    var _this6 = this;
+    var _this5 = this;
     if (isString(style)) {
       var prop = style.startsWith('--') ? style : camelCase(style);
       if (undefined === value) {
@@ -762,7 +524,7 @@ var dom = {
       }
     } else {
       each(style, function (name, v) {
-        _this6.css(el, name, v);
+        _this5.css(el, name, v);
       });
     }
     return el;
@@ -817,7 +579,7 @@ var dom = {
    * @returns {Element|DocumentFragment|null}
    */
   create: function create(html) {
-    html += '';
+    if (!isString(html)) return null;
     var isTagName = function isTagName(s) {
       return /^[A-Za-z][A-Za-z0-9-]*$/.test(s);
     };
@@ -830,7 +592,6 @@ var dom = {
     if (frag.childElementCount === 1 && frag.children.length === 1) {
       return frag.firstElementChild;
     }
-    if (!frag.firstChild) return null;
     return frag.cloneNode(true);
   },
   /**
@@ -839,14 +600,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
@@ -873,13 +633,10 @@ var dom = {
     return el.parentElement.insertBefore(newEl, el);
   },
   /**
-   * @param {Element|string} el
+   * @param {Element} el
    * @returns {Element}
    */
   empty: function empty(el) {
-    if (isString(el)) {
-      el = this.findOne(el);
-    }
     while (el.firstChild) {
       el.removeChild(el.firstChild);
     }
@@ -894,7 +651,8 @@ var dom = {
     var elements = el instanceof Element ? [el] : Array.from(el);
     var selectorIsString = 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;
     });
   },
@@ -930,16 +688,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];
     }
     foreach(children, function (child) {
       if (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;
@@ -966,14 +724,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 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: on,
+  off: 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();
+    __resetCustomEventsForTests();
   };
 }
 export default dom;

package/dist/esm/index.js

@@ -13,16 +13,81 @@ import * as traversal from './traversal.js';
 import dom, { getStyle, isDomElement, isWindow, isDocument } from './dom.js';
 import * as math from './math.js';
 import * as utils from './utils.js';
-import * as i18n from './Translator.js';
 import eventDispatcher from './eventDispatcher.js';
 import Mouse from './Mouse.js';
 import Translator from './Translator.js';
-var webf = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, stringFunctions), arrayFunctions), traversal), is), random), {}, {
-  dom: dom,
+
+/**
+ * Main entry point of js-core.
+ *
+ * Provides pure JavaScript utility functions such as string, array,
+ * type checking, traversal, math and other helpers.
+ *
+ * @module webf
+ */
+var webf = _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, stringFunctions), arrayFunctions), traversal), is), random), {}, {
   isWindow: isWindow,
   isDocument: isDocument,
   isDomElement: isDomElement,
   getStyle: getStyle
-}, math), utils), i18n);
+}, math), utils);
+
+/**
+ * Default export containing pure utility functions.
+ *
+ * @example
+ * import webf from '@webalternatif/js-core'
+ * webf.unique([1,2,2])
+ */
 export default webf;
+
+/**
+ * String utility functions.
+ * @module stringFunctions
+ */
+
+/**
+ * Array utility functions.
+ * @module arrayFunctions
+ */
+
+/**
+ * DOM manipulation and event helpers.
+ * Must be imported explicitly.
+ *
+ * @example
+ * import { dom } from '@webalternatif/js-core'
+ * dom.on(el, 'click', (ev) => {
+ *     doSomething(ev.currentTarget)
+ * })
+ *
+ * @module dom
+ */
+
+/**
+ * Lightweight custom event dispatcher (pub/sub).
+ *
+ * @example
+ * import { eventDispatcher } from '@webalternatif/js-core'
+ * const dispatcher = eventDispatcher()
+ * dispatcher.addListener('save', (eventName, arg1, arg2) => {})
+ * dispatcher.dispatch('save', arg1, arg2)
+ *
+ * @module eventDispatcher
+ */
+
+/**
+ * Mouse utilities.
+ * @module Mouse
+ */
+
+/**
+ * Simple translation utility.
+ *
+ * @example
+ * import { Translator } from '@webalternatif/js-core'
+ * const t = new Translator({ en: { hi: 'Hello' } })
+ *
+ * @module Translator
+ */
 export { stringFunctions, arrayFunctions, traversal, is, random, getStyle, dom, math, utils, eventDispatcher, Mouse, Translator };