@koine/dom 2.0.0-beta.1 → 2.0.0-beta.100

package/unlisten.d.ts

@@ -1,12 +1,4 @@
 import { type EventCallback } from "./_listen-delegation";
-/**
- * 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(types: string, selector: string, callback: EventCallback): void;
+import type { AnyDOMEventTarget, AnyDOMEventType } from "./types";
+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.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/$$.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$$ = void 0;
-/**
- * Sizzle/jQuery like DOM nodes shortcut for `document.querySelectorAll`
- * To avoid an extra function call we inline the above `escape`
- *
- * @param string selector DOM selector
- * @param parent It falls back to `window.document`
- * @param avoidEscape Whether to avoid escaping `:` in the selector string
- */
-function $$(selector, parent, avoidEscape) {
-    return (parent ? parent : document).querySelectorAll(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
-}
-exports.$$ = $$;
-exports.default = $$;

package/$.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$ = void 0;
-/**
- * Sizzle/jQuery like DOM nodes shortcut for `document.querySelector`
- * To avoid an extra function call we inline the above `escape`
- *
- * @param selector DOM selector
- * @param parent It falls back to `window.document`
- * @param avoidEscape Whether to avoid escaping `:` in the selector string
- * @example <caption>Basic DOM selection</caption>
- * const $container = $(".my-section:");
- * const $el = $("[data-some-attr]", $container);
- */
-function $(selector, parent, avoidEscape) {
-    return (parent ? parent : document).querySelector(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
-}
-exports.$ = $;
-exports.default = $;

package/$each.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.$each = void 0;
-var tslib_1 = require("tslib");
-var __1 = tslib_1.__importDefault(require("./$$"));
-/**
- * Each shortcut, iterate through a NodeList of HTMLElements retrieved with the
- * given selector (and optionally a parent container passed as thrid arguement)
- *
- * @param selector DOM selector
- * @param callback
- * @param parent It falls back to `window.document`
- * @param scope
- */
-function $each(selector, callback, parent, scope) {
-    var nodes = (0, __1.default)(selector, parent);
-    for (var i = 0; i < nodes.length; i++) {
-        callback.call(scope, nodes[i], i);
-    }
-}
-exports.$each = $each;
-exports.default = $each;

package/_listen-delegation.js

@@ -1,90 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.eventHandler = exports.getRunTarget = exports.getIndex = exports.activeEvents = void 0;
-var tslib_1 = require("tslib");
-/**
- * Listen: events delegation system
- *
- * From:
- * https://github.com/cferdinandi/events
- * https://github.com/cferdinandi/events/blob/master/src/js/events/events.js
- *
- * @fileoverview
- */
-var isString_1 = tslib_1.__importDefault(require("@koine/utils/isString"));
-var escapeSelector_1 = tslib_1.__importDefault(require("./escapeSelector"));
-/**
- * Active events
- *
- * @internal
- */
-exports.activeEvents = {};
-/**
- * Get the index for the listener
- *
- * @internal
- */
-function getIndex(arr, selector, callback) {
-    for (var i = 0; i < arr.length; i++) {
-        if (arr[i].selector === selector &&
-            arr[i].callback.toString() === callback.toString())
-            return i;
-    }
-    return -1;
-}
-exports.getIndex = getIndex;
-/**
- * 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
- */
-function getRunTarget(target, selector) {
-    // @ts-expect-error FIXME: type
-    if (["*", "window", window].includes(selector)) {
-        return window;
-    }
-    if ([
-        "document",
-        "document.documentElement",
-        document,
-        document.documentElement,
-        // @ts-expect-error FIXME: type
-    ].includes(selector))
-        return document;
-    if ((0, isString_1.default)(selector)) {
-        return target.closest((0, escapeSelector_1.default)(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;
-}
-exports.getRunTarget = getRunTarget;
-/**
- * Handle listeners after event fires
- *
- * @internal
- */
-function eventHandler(event) {
-    if (!exports.activeEvents[event.type])
-        return;
-    exports.activeEvents[event.type].forEach(function (listener) {
-        var target = getRunTarget(event.target, listener.selector);
-        if (!target) {
-            return;
-        }
-        listener.callback(event, target);
-    });
-}
-exports.eventHandler = eventHandler;

package/_listen-delegation.mjs

@@ -1,83 +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 var activeEvents = {};
-/**
- * Get the index for the listener
- *
- * @internal
- */
-export function getIndex(arr, selector, callback) {
-    for (var 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,
-        // @ts-expect-error FIXME: type
-    ].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) {
-        var target = getRunTarget(event.target, listener.selector);
-        if (!target) {
-            return;
-        }
-        listener.callback(event, target);
-    });
-}

package/addClass.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addClass = void 0;
-/**
- * Add class shortcut
- */
-function addClass(el, className) {
-    if (className === void 0) { className = ""; }
-    if (process.env["NODE_ENV"] !== "production") {
-        if (!el) {
-            console.warn("[@koine/dom:addClass] unexisting DOM element");
-            return;
-        }
-    }
-    if (el)
-        el.classList.add(className);
-}
-exports.addClass = addClass;
-exports.default = addClass;

package/addClass.mjs

@@ -1,15 +0,0 @@
-/**
- * Add class shortcut
- */
-export function addClass(el, className) {
-    if (className === void 0) { 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.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateFixedOffset = void 0;
-var _each_1 = require("./$each");
-function calculateFixedOffset(selector) {
-    if (selector === void 0) { selector = "[data-fixed]"; }
-    var fixedOffset = 0;
-    (0, _each_1.$each)(selector, function ($el) {
-        fixedOffset += $el.offsetHeight;
-    });
-    return fixedOffset;
-}
-exports.calculateFixedOffset = calculateFixedOffset;
-exports.default = calculateFixedOffset;

package/calculateFixedOffset.mjs

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

package/createElement.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createElement = void 0;
-var tslib_1 = require("tslib");
-var addClass_1 = tslib_1.__importDefault(require("./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
- */
-function createElement(type, className) {
-    var el = document.createElement(type);
-    if (className) {
-        (0, addClass_1.default)(el, className);
-    }
-    return el;
-}
-exports.createElement = createElement;
-exports.default = createElement;

package/createElement.mjs

@@ -1,16 +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) {
-    var el = document.createElement(type);
-    if (className) {
-        addClass(el, className);
-    }
-    return el;
-}
-export default createElement;

package/emitEvent.js

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

package/emitEvent.mjs

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

package/exists.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exists = void 0;
-/**
- * Checks if passed node exist and is a valid element.
- *
- * @borrows @glidejs/glide/src/utils/dom (source)
- */
-function exists(node) {
-    if (node && node instanceof window.HTMLElement) {
-        return true;
-    }
-    return false;
-}
-exports.exists = exists;
-exports.default = exists;

package/exists.mjs

@@ -1,12 +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.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.forEach = void 0;
-/**
- * For each, iterate through a NodeList of HTMLElements
- *
- * @param nodes DOM nodes collection
- * @param callback
- * @param scope
- */
-function forEach(nodes, callback, scope) {
-    for (var i = 0; i < nodes.length; i++) {
-        callback.call(scope, nodes[i], i);
-    }
-}
-exports.forEach = forEach;
-exports.default = forEach;

package/forEach.mjs

@@ -1,13 +0,0 @@
-/**
- * For each, iterate through a NodeList of HTMLElements
- *
- * @param nodes DOM nodes collection
- * @param callback
- * @param scope
- */
-export function forEach(nodes, callback, scope) {
-    for (var i = 0; i < nodes.length; i++) {
-        callback.call(scope, nodes[i], i);
-    }
-}
-export default forEach;

package/getDataAttr.js

@@ -1,17 +0,0 @@
-"use strict";
-// TODO: maybe move to `dataset` API but consider the comment about Safari here
-// https://stackoverflow.com/a/9201264/1938970
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDataAttr = void 0;
-/**
- * Get data attribute
- *
- * @param element
- * @param attribute The name of the `data-{attr}`
- */
-function getDataAttr(element, attribute) {
-    // return element.dataset[attribute];
-    return element.getAttribute("data-" + attribute);
-}
-exports.getDataAttr = getDataAttr;
-exports.default = getDataAttr;

package/getDocumentHeight.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDocumentHeight = void 0;
-/**
- * Determine the document's height
- *
- * @see https://github.com/cferdinandi/smooth-scroll (credits)
- */
-function getDocumentHeight() {
-    var body = document.body, documentElement = document.documentElement;
-    return Math.max(body.scrollHeight, documentElement.scrollHeight, body.offsetHeight, documentElement.offsetHeight, body.clientHeight, documentElement.clientHeight);
-}
-exports.getDocumentHeight = getDocumentHeight;
-exports.default = getDocumentHeight;

package/getDocumentHeight.mjs

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

package/getHeight.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getHeight = void 0;
-/**
- * Get element height
- */
-function getHeight(element) {
-    return parseInt(window.getComputedStyle(element).height, 10);
-}
-exports.getHeight = getHeight;
-exports.default = getHeight;

package/getHeight.mjs

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

package/getListeners.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getListeners = void 0;
-var _listen_delegation_1 = require("./_listen-delegation");
-/**
- * Get an immutable copy of all active event listeners
- *
- * @category listen-delegation
- *
- * @return Active event listeners
- */
-function getListeners() {
-    var obj = {};
-    for (var type in _listen_delegation_1.activeEvents) {
-        // if (activeEvents.hasOwnProperty(type)) {
-        obj[type] = _listen_delegation_1.activeEvents[type];
-        // }
-    }
-    return obj;
-}
-exports.getListeners = getListeners;
-exports.default = getListeners;

package/getListeners.mjs

@@ -1,18 +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() {
-    var obj = {};
-    for (var type in activeEvents) {
-        // if (activeEvents.hasOwnProperty(type)) {
-        obj[type] = activeEvents[type];
-        // }
-    }
-    return obj;
-}
-export default getListeners;

package/getOffset.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOffset = void 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
- */
-function getOffset(elem) {
-    var left = 0;
-    var 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: top, left: left };
-}
-exports.getOffset = getOffset;
-exports.default = getOffset;

package/getOffset.mjs

@@ -1,18 +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) {
-    var left = 0;
-    var 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: top, left: left };
-}
-export default getOffset;

package/getOffsetTop.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getOffsetTop = void 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
- */
-function getOffsetTop(elem) {
-    var location = 0;
-    if (elem.offsetParent) {
-        while (elem) {
-            location += elem.offsetTop;
-            // @ts-expect-error nevermind?
-            elem = elem.offsetParent;
-        }
-    }
-    return location >= 0 ? location : 0;
-}
-exports.getOffsetTop = getOffsetTop;
-exports.default = getOffsetTop;