@koine/dom 2.0.0-beta.12 → 2.0.0-beta.121

package/unlisten.cjs.js

@@ -0,0 +1,32 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _listenDelegation = require('./_listen-delegation.cjs.js');
+var off = require('./off.cjs.js');
+require('@koine/utils');
+require('./escapeSelector.cjs.js');
+
+/**
+ * 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
+ */let unlisten=(r,// | `${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes},${TTypes},${TTypes}`,
+n,o)=>{// Loop through each event type
+r.split(",").forEach(r=>{let f=_listenDelegation.activeEvents[// Remove whitespace
+r=r.trim()];// if event type doesn't exist, bail
+if(!f)return;// If it's the last event of it's type, remove entirely
+if(f.length<2||!n){delete _listenDelegation.activeEvents[r],off.off(window,r,_listenDelegation.eventHandler,!0);return}// Otherwise, remove event
+// @ts-expect-error FIXME: type...
+let p=_listenDelegation.getIndex(f,n,o);p<0||// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+_listenDelegation.activeEvents[r].splice(p,1);});};
+
+exports.default = unlisten;
+exports.unlisten = unlisten;

package/unlisten.cjs.mjs

@@ -0,0 +1,2 @@
+export * from './unlisten.cjs.js';
+export { _default as default } from './unlisten.cjs.default.js';

package/unlisten.d.ts

@@ -1,13 +1,4 @@
 import { type EventCallback } from "./_listen-delegation";
 import type { AnyDOMEventTarget, AnyDOMEventType } from "./types";
-/**
- * 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 declare function unlisten<TTypes extends AnyDOMEventType, TTarget extends AnyDOMEventTarget = AnyDOMEventTarget>(types: TTypes, selector: string, callback: EventCallback<TTarget, TTypes>): void;
+export declare let unlisten: <TTypes extends AnyDOMEventType, TTarget extends AnyDOMEventTarget = AnyDOMEventTarget>(types: TTypes, selector: string, callback: EventCallback<TTarget, TTypes>) => void;
 export default unlisten;

package/unlisten.esm.d.ts

@@ -0,0 +1,2 @@
+export * from "./unlisten";
+export { default } from "./unlisten";

package/unlisten.esm.js

@@ -0,0 +1,27 @@
+import { a as activeEvents, e as eventHandler, b as getIndex } from './_listen-delegation.esm.js';
+import { off } from './off.esm.js';
+import '@koine/utils';
+import './escapeSelector.esm.js';
+
+/**
+ * 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
+ */let unlisten=(r,// | `${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes},${TTypes}`
+// | `${TTypes},${TTypes},${TTypes},${TTypes},${TTypes}`,
+n,o)=>{// Loop through each event type
+r.split(",").forEach(r=>{let f=activeEvents[// Remove whitespace
+r=r.trim()];// if event type doesn't exist, bail
+if(!f)return;// If it's the last event of it's type, remove entirely
+if(f.length<2||!n){delete activeEvents[r],off(window,r,eventHandler,!0);return}// Otherwise, remove event
+// @ts-expect-error FIXME: type...
+let p=getIndex(f,n,o);p<0||// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+activeEvents[r].splice(p,1);});};
+
+export { unlisten as default, unlisten };

package/_listen-delegation.mjs

@@ -1,77 +0,0 @@
-/**
- * Listen: events delegation system
- *
- * From:
- * https://github.com/cferdinandi/events
- * https://github.com/cferdinandi/events/blob/master/src/js/events/events.js
- *
- * @fileoverview
- */ import isString from "@koine/utils/isString";
-import escapeSelector from "./escapeSelector";
-/**
- * Active events
- *
- * @internal
- */ export const activeEvents = {};
-/**
- * Get the index for the listener
- *
- * @internal
- */ export function getIndex(arr, selector, callback) {
-    for(let i = 0; i < arr.length; i++){
-        if (arr[i].selector === selector && arr[i].callback.toString() === callback.toString()) return i;
-    }
-    return -1;
-}
-/**
- * Check if the listener callback should run or not
- *
- * @internal
- * @param target The event.target
- * @param selector The selector/element to check the target against
- * @return If not false, run listener and pass the targeted element to use in the callback
- */ export function getRunTarget(target, selector) {
-    // @ts-expect-error FIXME: type
-    if ([
-        "*",
-        "window",
-        window
-    ].includes(selector)) {
-        return window;
-    }
-    if ([
-        "document",
-        "document.documentElement",
-        document,
-        document.documentElement
-    ].includes(selector)) return document;
-    if (isString(selector)) {
-        return target.closest(escapeSelector(selector));
-    }
-    // @ts-expect-error FIXME: type
-    if (typeof selector !== "string" && selector.contains) {
-        if (selector === target) {
-            return target;
-        }
-        // @ts-expect-error FIXME: type
-        if (selector.contains(target)) {
-            return selector;
-        }
-        return false;
-    }
-    return false;
-}
-/**
- * Handle listeners after event fires
- *
- * @internal
- */ export function eventHandler(event) {
-    // if (!activeEvents[event.type]) return;
-    activeEvents[event.type]?.forEach(function(listener) {
-        const target = getRunTarget(event.target, listener.selector);
-        if (!target) {
-            return;
-        }
-        listener.callback(event, target);
-    });
-}

package/addClass.mjs

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

package/calculateFixedOffset.mjs

@@ -1,9 +0,0 @@
-import { $each } from "./$each";
-export function calculateFixedOffset(selector = "[data-fixed]") {
-    let fixedOffset = 0;
-    $each(selector, ($el)=>{
-        fixedOffset += $el.offsetHeight;
-    });
-    return fixedOffset;
-}
-export default calculateFixedOffset;

package/createElement.mjs

@@ -1,15 +0,0 @@
-import addClass from "./addClass";
-/**
- * Shortcut for `document.createElement`, allowing to to create an HTML element
- * with a given className directly (a very common use case)
- *
- * @param type
- * @param className
- */ export function createElement(type, className) {
-    const el = document.createElement(type);
-    if (className) {
-        addClass(el, className);
-    }
-    return el;
-}
-export default createElement;

package/emitEvent.mjs

@@ -1,10 +0,0 @@
-/**
- * Emit event (use only if the targeted browser supports `CustomEvent`s)
- */ export function emitEvent(type = "customEvent", detail = {}) {
-    if (typeof window.CustomEvent !== "function") return;
-    document.dispatchEvent(new CustomEvent(type, {
-        bubbles: true,
-        detail
-    }));
-}
-export default emitEvent;

package/exists.mjs

@@ -1,11 +0,0 @@
-/**
- * Checks if passed node exist and is a valid element.
- *
- * @borrows @glidejs/glide/src/utils/dom (source)
- */ export function exists(node) {
-    if (node && node instanceof window.HTMLElement) {
-        return true;
-    }
-    return false;
-}
-export default exists;

package/forEach.mjs

@@ -1,34 +0,0 @@
-/**
- * For each, iterate through a `NodeList` or an `array` of `HTMLElement`s
- *
- * @param scope The optional `this` of the callback function
- */ export function forEach(nodes, callback, scope) {
-    for(let i = 0; i < nodes.length; i++){
-        callback.call(scope, nodes[i], i);
-    }
-}
-export default forEach; // /**
- //  * For each, iterate through a `NodeList` or an `array` of `HTMLElement`s
- //  *
- //  * @param scope The optional `this` of the callback function
- //  */
- // export function forEach<TScope = object>(
- //   nodes: HTMLElement[],
- //   callback: (this: TScope, $element: HTMLElement, index: number) => any,
- //   scope?: TScope
- // ): void;
- // export function forEach<TScope = object>(
- //   nodes: NodeListOf<HTMLElement> | HTMLElement[],
- //   callback: (this: TScope, $element: HTMLElement, index: number) => any,
- //   scope?: TScope
- // ): void;
- // export function forEach<T extends Element, TScope = object>(
- //   nodes: NodeListOf<T> | HTMLElement[],
- //   callback: (this: TScope, $element: T, index: number) => any,
- //   scope?: TScope
- // ) {
- //   for (let i = 0; i < nodes.length; i++) {
- //     callback.call(scope as TScope, nodes[i] as T, i);
- //   }
- // }
- // export default forEach;

package/getDocumentHeight.mjs

@@ -1,9 +0,0 @@
-/**
- * Determine the document's height
- *
- * @see https://github.com/cferdinandi/smooth-scroll (credits)
- */ export function getDocumentHeight() {
-    const { body, documentElement } = document;
-    return Math.max(body.scrollHeight, documentElement.scrollHeight, body.offsetHeight, documentElement.offsetHeight, body.clientHeight, documentElement.clientHeight);
-}
-export default getDocumentHeight;

package/getHeight.mjs

@@ -1,6 +0,0 @@
-/**
- * Get element height
- */ export function getHeight(element) {
-    return parseInt(window.getComputedStyle(element).height, 10);
-}
-export default getHeight;

package/getListeners.mjs

@@ -1,17 +0,0 @@
-import { activeEvents } from "./_listen-delegation";
-/**
- * Get an immutable copy of all active event listeners
- *
- * @category listen-delegation
- *
- * @return Active event listeners
- */ export function getListeners() {
-    const obj = {};
-    for(const type in activeEvents){
-        // if (activeEvents.hasOwnProperty(type)) {
-        obj[type] = activeEvents[type];
-    // }
-    }
-    return obj;
-}
-export default getListeners;

package/getOffset.mjs

@@ -1,20 +0,0 @@
-/**
- * Get an element's distance from the top and left of the Document.
- *
- * @param elem The HTML node element
- * @return Distance from the top and left in pixels
- */ export function getOffset(elem) {
-    let left = 0;
-    let top = 0;
-    while(elem && !isNaN(elem.offsetLeft) && !isNaN(elem.offsetTop)){
-        left += elem.offsetLeft - elem.scrollLeft;
-        top += elem.offsetTop - elem.scrollTop;
-        // @ts-expect-error nevermind?
-        elem = elem.offsetParent;
-    }
-    return {
-        top,
-        left
-    };
-}
-export default getOffset;

package/getOffsetTop.mjs

@@ -1,19 +0,0 @@
-/**
- * Get an element's distance from the top of the Document.
- *
- * @see https://vanillajstoolkit.com/helpers/getoffsettop/
- *
- * @param elem The HTML node element
- * @return Distance from the top in pixels
- */ export function getOffsetTop(elem) {
-    let location = 0;
-    if (elem.offsetParent) {
-        while(elem){
-            location += elem.offsetTop;
-            // @ts-expect-error nevermind?
-            elem = elem.offsetParent;
-        }
-    }
-    return location >= 0 ? location : 0;
-}
-export default getOffsetTop;

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;