@koine/dom 2.0.0-beta.11 → 2.0.0-beta.110

package/getScrollbarWidth.mjs

@@ -1,6 +0,0 @@
-/**
- * Get scrollbar's current width
- */ export function getScrollbarWidth(element) {
-    return window.innerWidth - (element || document.documentElement).clientWidth;
-}
-export default getScrollbarWidth;

package/getStyleValue.mjs

@@ -1,9 +0,0 @@
-/**
- * Return the current style value for an element CSS property
- *
- * @param el The element to compute
- * @param prop The style property
- */ export function getStyleValue(el, prop) {
-    return getComputedStyle(el, null).getPropertyValue(prop);
-}
-export default getStyleValue;

package/getVisualBackgroundColor.mjs

@@ -1,19 +0,0 @@
-/**
- * Get the background color of an element eventually looking recursively into
- * its parents, if nothing is found it returns a `#fff` background
- */ export function getVisualBackgroundColor(elem) {
-    if (!elem) return "#fff";
-    const transparent = "rgba(0, 0, 0, 0)";
-    const transparentIE11 = "transparent";
-    // if (!elem) return transparent;
-    const bg = window.getComputedStyle(elem).backgroundColor;
-    if (bg === transparent || bg === transparentIE11) {
-        const parent = elem.parentElement;
-        if (parent) {
-            return getVisualBackgroundColor(parent);
-        }
-        return "#fff";
-    }
-    return bg;
-}
-export default getVisualBackgroundColor;

package/index.mjs

@@ -1,45 +0,0 @@
-export { $$ } from "./$$";
-export { $each } from "./$each";
-export { $ } from "./$";
-export { addClass } from "./addClass";
-export { calculateFixedOffset } from "./calculateFixedOffset";
-export { createElement } from "./createElement";
-export { emitEvent } from "./emitEvent";
-export { escapeSelector } from "./escapeSelector";
-export { exists } from "./exists";
-export { forEach } from "./forEach";
-export { getDataAttr } from "./getDataAttr";
-export { getDocumentHeight } from "./getDocumentHeight";
-export { getHeight } from "./getHeight";
-export { getListeners } from "./getListeners";
-export { getOffset } from "./getOffset";
-export { getOffsetTop } from "./getOffsetTop";
-export { getOffsetTopSlim } from "./getOffsetTopSlim";
-export { getScrollbarWidth } from "./getScrollbarWidth";
-export { getStyleValue } from "./getStyleValue";
-export { getVisualBackgroundColor } from "./getVisualBackgroundColor";
-export { injectCss } from "./injectCss";
-export { isHidden } from "./isHidden";
-export { isInViewport } from "./isInViewport";
-export { isNodeList } from "./isNodeList";
-export { isTotallyScrolled } from "./isTotallyScrolled";
-export { listenLoaded } from "./listenLoaded";
-export { listenOnce } from "./listenOnce";
-export { listenResize } from "./listenResize";
-export { listenResizeDebounced } from "./listenResizeDebounced";
-export { listenResizeThrottled } from "./listenResizeThrottled";
-export { listenScroll } from "./listenScroll";
-export { listenScrollDebounced } from "./listenScrollDebounced";
-export { listenScrollThrottled } from "./listenScrollThrottled";
-export { listen } from "./listen";
-export { off } from "./off";
-export { once } from "./once";
-export { onClickOutside } from "./onClickOutside";
-export { on } from "./on";
-export { removeClass } from "./removeClass";
-export { scrollTo } from "./scrollTo";
-export { setDataAttr } from "./setDataAttr";
-export { setVendorCSS } from "./setVendorCSS";
-export { siblings } from "./siblings";
-export { toArray } from "./toArray";
-export { unlisten } from "./unlisten";

package/injectCss.mjs

@@ -1,13 +0,0 @@
-/**
- * Inject css
- */ export function injectCss(id, cssString = "", root = document) {
-    let styleblock;
-    styleblock = root.getElementById(id);
-    if (!styleblock) {
-        styleblock = root.createElement("style");
-        styleblock.id = id;
-        root.body.appendChild(styleblock);
-    }
-    styleblock.innerHTML = cssString;
-}
-export default injectCss;

package/isHidden.mjs

@@ -1,6 +0,0 @@
-/**
- * Is element hidden?
- */ export function isHidden(el) {
-    return !el || el.offsetParent === null;
-}
-export default isHidden;

package/isInViewport.mjs

@@ -1,12 +0,0 @@
-/**
- * Determine if an element is in the viewport
- *
- * @borrows (c) 2017 Chris Ferdinandi, MIT License, https://gomakethings.com
- *
- * @param elem The element
- * @return Returns true if element is in the viewport
- */ export function isInViewport(elem) {
-    const distance = elem.getBoundingClientRect();
-    return distance.top >= 0 && distance.left >= 0 && distance.bottom <= (window.innerHeight || document.documentElement.clientHeight) && distance.right <= (window.innerWidth || document.documentElement.clientWidth);
-}
-export default isInViewport;

package/isNodeList.mjs

@@ -1,9 +0,0 @@
-/**
- * Is node list
- *
- * @param nodes The object to check
- */ export function isNodeList(nodes) {
-    const stringRepr = Object.prototype.toString.call(nodes);
-    return typeof nodes === "object" && /^\[object (HTMLCollection|NodeList|Object)\]$/.test(stringRepr) && typeof nodes.length === "number" && (nodes.length === 0 || typeof nodes[0] === "object" && nodes[0].nodeType > 0);
-}
-export default isNodeList;

package/listen.mjs

@@ -1,36 +0,0 @@
-import { activeEvents, eventHandler } from "./_listen-delegation";
-import { on } from "./on";
-// import { off } from "./off";
-/**
- * Listen an event
- *
- * @category listen-delegation
- *
- * @param types The event type or types (comma separated)
- * @param selector The selector to run the event on
- * @param callback The function to run when the event fires
- */ export function listen(types, // | `${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes},${TTypes},${TTypes}`,
-selector, callback) {
-    // Make sure there's a selector and callback
-    if (!selector || !callback) return;
-    // Loop through each event type
-    types.split(",").forEach(function(type) {
-        // Remove whitespace
-        type = type.trim();
-        // If no event of this type yet, setup
-        if (!activeEvents[type]) {
-            activeEvents[type] = [];
-            on(window, type, eventHandler, true);
-        }
-        // Push to active events
-        activeEvents[type]?.push({
-            selector: selector,
-            // @ts-expect-error FIXME: type...
-            callback: callback
-        });
-    });
-}
-export default listen;

package/listenLoaded.mjs

@@ -1,10 +0,0 @@
-import { on } from "./on";
-/**
- * Fires a callback when the DOM content is loaded
- *
- * @see https://mathiasbynens.be/notes/settimeout-onload
- */ export function listenLoaded(handler) {
-    on(document, "DOMContentLoaded", handler);
-// document.addEventListener("DOMContentLoaded", setTimeout(handler, 4));
-}
-export default listenLoaded;

package/listenOnce.mjs

@@ -1,19 +0,0 @@
-import { getRunTarget } from "./_listen-delegation";
-import { listen } from "./listen";
-import { unlisten } from "./unlisten";
-/**
- * Listen an event, and automatically unlisten it after it's first run
- *
- * @category listen-delegation
- *
- * @param types The event type or types (comma separated)
- * @param selector The selector to run the event on
- * @param callback The function to run when the event fires
- */ export function listenOnce(types, selector, callback) {
-    listen(types, selector, function temp(event) {
-        const target = getRunTarget(event.target, selector);
-        callback(event, target || window);
-        unlisten(types, selector, temp);
-    });
-}
-export default listenOnce;

package/listenResize.mjs

@@ -1,7 +0,0 @@
-import { on } from "./on";
-/**
- * Listen element's (`window` by default) _scroll_ event
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenResize = (handler, el)=>on(el || window, "resize", handler);
-export default listenResize;

package/listenResizeDebounced.mjs

@@ -1,34 +0,0 @@
-import debounce from "@koine/utils/debounce";
-import listenResize from "./listenResize";
-/**
- * Listen element's (`window` by default) _resize_ event debouncing the callback
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenResizeDebounced = (el, ...args)=>listenResize(debounce(...args), el);
-export default listenResizeDebounced; // EXP: with too complex overload signature...
- // import debounce from "@koine/utils/debounce";
- // import isUndefined from "@koine/utils/isUndefined";
- // import listenResize from "./listenResize";
- // /**
- //  * Listen element's (`window` by default) _resize_ event debouncing the callback
- //  *
- //  * @returns An automatic unbinding function to run to deregister the listener upon call
- //  */
- // export function listenResizeDebounced(
- //   ...args: Parameters<typeof debounce>
- // ): ReturnType<typeof listenResize>;
- // export function listenResizeDebounced(
- //   el: Parameters<typeof listenResize>[1],
- //   ...args: Parameters<typeof debounce>
- // ): ReturnType<typeof listenResize>;
- // export function listenResizeDebounced(
- //   ...args:
- //     | [Parameters<typeof listenResize>[1], ...Parameters<typeof debounce>]
- //     | Parameters<typeof debounce>
- // ) {
- //   if (isUndefined(args[0])) {
- //     return listenResize(debounce(...args));
- //   }
- //   return listenResize(debounce(...args.slice(1)), args[0]);
- // }
- // export default listenResizeDebounced;

package/listenResizeThrottled.mjs

@@ -1,8 +0,0 @@
-import throttle from "@koine/utils/throttle";
-import { listenResize } from "./listenResize";
-/**
- * Listen element's (`window` by default) _resize_ event throttling the callback
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenResizeThrottled = (el, ...args)=>listenResize(throttle(...args), el);
-export default listenResizeThrottled;

package/listenScroll.mjs

@@ -1,10 +0,0 @@
-import { on } from "./on";
-/**
- * Listen element's (`window` by default) _scroll_ event
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenScroll = (handler, el)=>on(el || window, "scroll", handler, {
-        capture: true,
-        passive: true
-    });
-export default listenScroll;

package/listenScrollDebounced.mjs

@@ -1,8 +0,0 @@
-import debounce from "@koine/utils/debounce";
-import { listenScroll } from "./listenScroll";
-/**
- * Listen element's (`window` by default) _scroll_ event debouncing the callback
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenScrollDebounced = (el, ...args)=>listenScroll(debounce(...args), el);
-export default listenScrollDebounced;

package/listenScrollThrottled.mjs

@@ -1,8 +0,0 @@
-import throttle from "@koine/utils/throttle";
-import { listenScroll } from "./listenScroll";
-/**
- * Listen element's (`window` by default) _scroll_ event throttling the callback
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export const listenScrollThrottled = (el, ...args)=>listenScroll(throttle(...args), el);
-export default listenScrollThrottled;

package/off.mjs

@@ -1,11 +0,0 @@
-/**
- * Shortcut for `removeEventListener`
- */ export function off(el, type, handler, options = false) {
-    if (process.env["NODE_ENV"] !== "production") {
-        if (!el) {
-            console.warn("[@koine/dom:off] unexisting DOM element");
-        }
-    }
-    if (el) el.removeEventListener(type, handler, options);
-}
-export default off;

package/on.mjs

@@ -1,21 +0,0 @@
-// import noop from "@koine/utils/noop"; FIXME: build breaks with this import
-import off from "./off";
-/**
- * Shortcut for `addEventListener`
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */ export function on(el, type, handler, // handler: THandler /* EventListener |  */ /* ((event: Event) => void) */,
-options = false) {
-    if (process.env["NODE_ENV"] !== "production") {
-        if (!el) {
-            console.warn("[@koine/dom:on] unexisting DOM element");
-        }
-    }
-    if (el) {
-        el.addEventListener(type, handler, options);
-        return ()=>off(el, type, handler);
-    }
-    // return noop;
-    return ()=>void 0;
-}
-export default on;

package/onClickOutside.mjs

@@ -1,15 +0,0 @@
-import { off, on } from "./index";
-export function onClickOutside(element, callback, autoUnbind = false) {
-    const bind = (event)=>{
-        // if (event.target.closest(element) === null) {
-        if (!element.contains(event.target)) {
-            callback(event);
-            if (autoUnbind) unbind();
-        }
-    };
-    const unbind = ()=>{
-        off(document, "click", bind);
-    };
-    on(document, "click", bind);
-    return unbind;
-}

package/once.mjs

@@ -1,13 +0,0 @@
-import off from "./off";
-import on from "./on";
-/**
- * One shot listener, it `addEventListener` and removes it first time is called
- * with `removeEventListener`
- */ export function once(el, type, handler, options = false) {
-    const handlerWrapper = (event)=>{
-        handler(event);
-        off(el, type, handlerWrapper);
-    };
-    return on(el, type, handlerWrapper, options);
-}
-export default once;

package/removeClass.mjs

@@ -1,12 +0,0 @@
-/**
- * Remove class shortcut
- */ export function removeClass(el, className = "") {
-    if (process.env["NODE_ENV"] !== "production") {
-        if (!el) {
-            "[@koine/dom:removeClass] unexisting DOM element";
-            return;
-        }
-    }
-    if (el) el.classList.remove(className);
-}
-export default removeClass;

package/scrollTo.mjs

@@ -1,39 +0,0 @@
-import { off } from "./off";
-import { on } from "./on";
-/**
- * Native `scrollTo`, `"smooth"` and with callback
- *
- * @borrows https://stackoverflow.com/a/55686711/1938970
- *
- * @param offset - offset to scroll to
- * @param callback - callback function
- * @param [fallbackTimeout] - this appears to be needed in some hard to reproduce scenario on safari, where the callback seem to be never called
- * @param [behavior="smooth"]
- */ export function scrollTo(destination, callback, fallbackTimeout, behavior) {
-    const fixedDestination = destination.toFixed();
-    if (callback) {
-        let callbackFired = false;
-        const onScroll = function() {
-            if (window.pageYOffset.toFixed() === fixedDestination) {
-                off(window, "scroll", onScroll);
-                callbackFired = true;
-                callback();
-            }
-        };
-        on(window, "scroll", onScroll);
-        onScroll();
-        if (fallbackTimeout) {
-            setTimeout(()=>{
-                if (!callbackFired) {
-                    off(window, "scroll", onScroll);
-                    callback();
-                }
-            }, fallbackTimeout);
-        }
-    }
-    window.scrollTo({
-        top: destination,
-        behavior: behavior || "smooth"
-    });
-}
-export default scrollTo;

package/setDataAttr.mjs

@@ -1,17 +0,0 @@
-/**
- * Set data attribute
- *
- * @param element
- * @param attribute The name of the `data-{attr}`
- * @param value The value to set, `null` or `undefined` will remove the attribute
- */ export function setDataAttr(element, attribute, value) {
-    if (value === null || typeof value === "undefined") {
-        // delete element.dataset[attribute];
-        // return;
-        element.removeAttribute("data-" + attribute);
-        return;
-    }
-    // element.dataset[attribute] = value.toString();
-    element.setAttribute("data-" + attribute, value.toString());
-}
-export default setDataAttr;

package/setVendorCSS.mjs

@@ -1,20 +0,0 @@
-/**
- * Set vendor CSS rule
- *
- * @param element A single HTMLElement
- * @param prop CSS rule proerty
- * @param value The CSS value to set, it will be automatically vendor prefixed
- */ export function setVendorCSS(element, prop, value) {
-    const propUpper = prop.charAt(0).toUpperCase() + prop.slice(1);
-    // @ts-expect-error nevermind now...
-    element.style["webkit" + propUpper] = value;
-    // @ts-expect-error nevermind now...
-    element.style["moz" + propUpper] = value;
-    // @ts-expect-error nevermind now...
-    element.style["ms" + propUpper] = value;
-    // @ts-expect-error nevermind now...
-    element.style["o" + propUpper] = value;
-    // @ts-expect-error nevermind now...
-    element.style[prop] = value;
-}
-export default setVendorCSS;

package/siblings.mjs

@@ -1,18 +0,0 @@
-/**
- * Finds siblings nodes of the passed node.
- *
- * @borrows @glidejs/glide/src/utils/dom (source)
- */ export function siblings(node) {
-    if (node && node.parentNode) {
-        let n = node.parentNode.firstChild;
-        const matched = [];
-        for(; n; n = n.nextSibling){
-            if (n.nodeType === 1 && n !== node) {
-                matched.push(n);
-            }
-        }
-        return matched;
-    }
-    return [];
-}
-export default siblings;

package/toArray.mjs

@@ -1,8 +0,0 @@
-/**
- * Node list to array
- *
- * @param nodeList
- */ export function toArray(nodeList) {
-    return Array.prototype.slice.call(nodeList);
-}
-export default toArray;

package/types.mjs

@@ -1 +0,0 @@
-export { };

package/typings.d.ts

@@ -1,4 +0,0 @@
-/**
- * List here the global variables used by third party scripts supported within
- * the `koine` ecosystem.
- */

package/unlisten.mjs

@@ -1,35 +0,0 @@
-import { activeEvents, eventHandler, getIndex } from "./_listen-delegation";
-import { off } from "./off";
-/**
- * Stop listening for an event
- *
- * @category listen-delegation
- *
- * @param types The event type or types (comma separated)
- * @param selector The selector to remove the event from
- * @param callback The function to remove
- */ export function unlisten(types, // | `${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes},${TTypes}`
-// | `${TTypes},${TTypes},${TTypes},${TTypes},${TTypes}`,
-selector, callback) {
-    // Loop through each event type
-    types.split(",").forEach(function(type) {
-        // Remove whitespace
-        type = type.trim();
-        // if event type doesn't exist, bail
-        if (!activeEvents[type]) return;
-        // If it's the last event of it's type, remove entirely
-        if (activeEvents[type].length < 2 || !selector) {
-            delete activeEvents[type];
-            off(window, type, eventHandler, true);
-            return;
-        }
-        // Otherwise, remove event
-        // @ts-expect-error FIXME: type...
-        const index = getIndex(activeEvents[type], selector, callback);
-        if (index < 0) return;
-        activeEvents[type].splice(index, 1);
-    });
-}
-export default unlisten;