@koine/dom 1.0.80

package/$$.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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
+ */
+export declare function $$<T extends Element = HTMLElement>(selector: string, parent?: HTMLElement | Document, avoidEscape?: boolean): NodeListOf<T>;
+export default $$;

package/$$.js

@@ -0,0 +1,12 @@
+/**
+ * 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
+ */
+export function $$(selector, parent, avoidEscape) {
+    return (parent ? parent : document).querySelectorAll(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
+}
+export default $$;

package/$.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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);
+ */
+export declare function $<T extends Element = HTMLElement>(selector: string, parent?: HTMLElement | Document, avoidEscape?: boolean): T;
+export default $;

package/$.js

@@ -0,0 +1,15 @@
+/**
+ * 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);
+ */
+export function $(selector, parent, avoidEscape) {
+    return (parent ? parent : document).querySelector(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
+}
+export default $;

package/$each.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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
+ */
+export declare function $each<T extends Element = HTMLElement>(selector: string, callback: ($element: T, index: number) => any, parent?: HTMLElement, scope?: object): void;
+export default $each;

package/$each.js

@@ -0,0 +1,17 @@
+import $$ from "./$$";
+/**
+ * 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
+ */
+export function $each(selector, callback, parent, scope) {
+    var nodes = $$(selector, parent);
+    for (var i = 0; i < nodes.length; i++) {
+        callback.call(scope, nodes[i], i);
+    }
+}
+export default $each;

package/README.md

@@ -0,0 +1 @@
+# @koine/dom

package/_listen-delegation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @internal
+ */
+export declare type EventCallback = (event: Event, desiredTarget: Window | Document | Element) => any;
+/**
+ * @internal
+ */
+export declare type ListenEvent = {
+    selector: string;
+    callback: EventCallback;
+};
+/**
+ * Active events
+ *
+ * @internal
+ */
+export declare const activeEvents: Record<Event["type"], ListenEvent[]>;
+/**
+ * Get the index for the listener
+ *
+ * @internal
+ */
+export declare function getIndex(arr: ListenEvent[], selector: string, callback: EventCallback): number;
+/**
+ * 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 declare function getRunTarget(target: Element, selector: string | Window | Document | Element): false | Element | Document | Window | null;
+/**
+ * Handle listeners after event fires
+ *
+ * @internal
+ */
+export declare function eventHandler(event: Event): void;

package/_listen-delegation.js

@@ -0,0 +1,83 @@
+/**
+ * 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";
+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.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Add class shortcut
+ */
+export declare function addClass<T extends Element = HTMLElement>(el?: T, className?: string): void;
+export default addClass;

package/addClass.js

@@ -0,0 +1,15 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,2 @@
+export declare function calculateFixedOffset(selector?: string): number;
+export default calculateFixedOffset;

package/calculateFixedOffset.js

@@ -0,0 +1,10 @@
+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.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 declare function createElement(type: string, className?: string): HTMLElement;
+export default createElement;

package/createElement.js

@@ -0,0 +1,16 @@
+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.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Emit event (use only if the targeted browser supports `CustomEvent`s)
+ */
+export declare function emitEvent(type?: string, detail?: {}): void;
+export default emitEvent;

package/emitEvent.js

@@ -0,0 +1,14 @@
+/**
+ * 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/escapeSelector.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Escape colons to allow use class names as `.module:block__element`
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector#Escaping_special_characters
+ *
+ * @param selector
+ */
+export declare function escapeSelector(selector: string): string;
+export default escapeSelector;

package/escapeSelector.js

@@ -0,0 +1,10 @@
+/**
+ * Escape colons to allow use class names as `.module:block__element`
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector#Escaping_special_characters
+ *
+ * @param selector
+ */
+export function escapeSelector(selector) {
+    return selector.replace(/:/g, "\\:");
+}
+export default escapeSelector;

package/exists.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks if passed node exist and is a valid element.
+ *
+ * @borrows @glidejs/glide/src/utils/dom (source)
+ */
+export declare function exists(node?: Element): boolean;
+export default exists;

package/exists.js

@@ -0,0 +1,12 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,9 @@
+/**
+ * For each, iterate through a NodeList of HTMLElements
+ *
+ * @param nodes DOM nodes collection
+ * @param callback
+ * @param scope
+ */
+export declare function forEach<T extends Element = HTMLElement, TScope = object>(nodes: NodeList, callback: (this: TScope, $element: T, index: number) => any, scope?: TScope): void;
+export default forEach;

package/forEach.js

@@ -0,0 +1,13 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Get data attribute
+ *
+ * @param element
+ * @param attribute The name of the `data-{attr}`
+ */
+export declare function getDataAttr(element: HTMLElement, attribute: string): string | null;
+export default getDataAttr;

package/getDataAttr.js

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

package/getDocumentHeight.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Determine the document's height
+ *
+ * @see https://github.com/cferdinandi/smooth-scroll (credits)
+ */
+export declare function getDocumentHeight(): number;
+export default getDocumentHeight;

package/getDocumentHeight.js

@@ -0,0 +1,10 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get element height
+ */
+export declare function getHeight(element: HTMLElement): number;
+export default getHeight;

package/getHeight.js

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

package/getListeners.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get an immutable copy of all active event listeners
+ *
+ * @category listen-delegation
+ *
+ * @return Active event listeners
+ */
+export declare function getListeners(): Record<string, import("./_listen-delegation").ListenEvent[]>;
+export default getListeners;

package/getListeners.js

@@ -0,0 +1,18 @@
+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.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 declare function getOffset(elem: HTMLElement): {
+    top: number;
+    left: number;
+};
+export default getOffset;

package/getOffset.js

@@ -0,0 +1,18 @@
+/**
+ * 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.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 declare function getOffsetTop(elem: HTMLElement): number;
+export default getOffsetTop;

package/getOffsetTop.js

@@ -0,0 +1,20 @@
+/**
+ * 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) {
+    var 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.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Get scrollbar's current width
+ */
+export declare function getScrollbarWidth(element?: HTMLElement): number;
+export default getScrollbarWidth;

package/getScrollbarWidth.js

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

package/getStyleValue.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return the current style value for an element CSS property
+ *
+ * @param el The element to compute
+ * @param prop The style property
+ */
+export declare function getStyleValue(el: HTMLElement, prop: string): string;
+export default getStyleValue;

package/getStyleValue.js

@@ -0,0 +1,10 @@
+/**
+ * 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/index.d.ts

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

package/index.js

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

package/injectCss.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Inject css
+ */
+export declare function injectCss(id: string, cssString?: string, root?: Document): void;
+export default injectCss;