@koine/dom 2.0.0-beta.5 → 2.0.0-beta.50

package/listenResizeThrottled.d.ts

@@ -1,8 +1,2 @@
 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 declare const listenResizeThrottled: (el?: Parameters<typeof listenResize>[1], fn: Function, limit: number, context?: unknown) => () => void;
-export default listenResizeThrottled;
+export declare let listenResizeThrottled: (el?: Parameters<typeof listenResize>[1], fn: Function, limit: number, context?: unknown) => () => void;

package/listenScroll.d.ts

@@ -1,8 +1,2 @@
 import type { AnyDOMEventTargetLoose } from "./types";
-/**
- * Listen element's (`window` by default) _scroll_ event
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */
-export declare const listenScroll: (handler: () => void, el?: AnyDOMEventTargetLoose) => () => void;
-export default listenScroll;
+export declare let listenScroll: (handler: () => void, el?: AnyDOMEventTargetLoose) => () => void;

package/listenScrollDebounced.d.ts

@@ -1,8 +1,2 @@
 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 declare const listenScrollDebounced: (el?: Parameters<typeof listenScroll>[1], fn: (...args: any[]) => any, wait?: number | undefined, immediate?: boolean | undefined) => () => void;
-export default listenScrollDebounced;
+export declare let listenScrollDebounced: (el?: Parameters<typeof listenScroll>[1], fn: (...args: any[]) => any, wait?: number | undefined, immediate?: boolean | undefined) => () => void;

package/listenScrollThrottled.d.ts

@@ -1,8 +1,2 @@
 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 declare const listenScrollThrottled: (el?: Parameters<typeof listenScroll>[1], fn: Function, limit: number, context?: unknown) => () => void;
-export default listenScrollThrottled;
+export declare let listenScrollThrottled: (el?: Parameters<typeof listenScroll>[1], fn: Function, limit: number, context?: unknown) => () => void;

package/off.d.ts

@@ -1,6 +1,2 @@
 import type { AnyDOMEvent, AnyDOMEventTargetLoose, AnyDOMEventType } from "./types";
-/**
- * Shortcut for `removeEventListener`
- */
-export declare function off<TType extends AnyDOMEventType>(el: AnyDOMEventTargetLoose, type: TType, handler: (event: AnyDOMEvent<TType>) => void, options?: EventListenerOptions | boolean): void;
-export default off;
+export declare let off: <TType extends AnyDOMEventType>(el: AnyDOMEventTargetLoose, type: TType, handler: (event: AnyDOMEvent<TType>) => void, options?: EventListenerOptions | boolean) => void;

package/on.d.ts

@@ -1,8 +1,2 @@
 import type { AnyDOMEvent, AnyDOMEventTargetLoose, AnyDOMEventType } from "./types";
-/**
- * Shortcut for `addEventListener`
- *
- * @returns An automatic unbinding function to run to deregister the listener upon call
- */
-export declare function on<TType extends AnyDOMEventType>(el: AnyDOMEventTargetLoose, type: TType, handler: (event: AnyDOMEvent<TType>) => void, options?: AddEventListenerOptions | boolean): () => void;
-export default on;
+export declare let on: <TType extends AnyDOMEventType>(el: AnyDOMEventTargetLoose, type: TType, handler: (event: AnyDOMEvent<TType>) => void, options?: AddEventListenerOptions | boolean) => () => void;

package/onClickOutside.d.ts

@@ -1 +1 @@
-export declare function onClickOutside(element: HTMLElement, callback: (event: Event) => any, autoUnbind?: boolean): () => void;
+export declare let onClickOutside: <T extends HTMLElement>(element: T, callback: (event: Event) => any, autoUnbind?: boolean) => () => void;

package/once.d.ts

@@ -1,7 +1,2 @@
-import { AnyDOMEventTargetLoose } from "./types";
-/**
- * One shot listener, it `addEventListener` and removes it first time is called
- * with `removeEventListener`
- */
-export declare function once(el: AnyDOMEventTargetLoose, type: string, handler: EventListener, options?: EventListenerOptions | boolean): () => void;
-export default once;
+import type { AnyDOMEventTargetLoose } from "./types";
+export declare let once: (el: AnyDOMEventTargetLoose, type: string, handler: EventListener, options?: EventListenerOptions | boolean) => () => void;

package/package.json

@@ -2,19 +2,17 @@
   "name": "@koine/dom",
   "sideEffects": false,
   "dependencies": {
-    "clsx": "^1.2.1",
-    "ts-debounce": "^4.0.0",
-    "type-fest": "^3.12.0"
+    "@koine/utils": "2.0.0-beta.50"
   },
-  "peerDependencies": {},
-  "module": "./index.mjs",
-  "main": "./index.js",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
-      "import": "./index.js",
-      "require": "./index.js"
+      "module": "./index.esm.js",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
     }
   },
-  "types": "./index.d.ts",
-  "version": "2.0.0-beta.5"
-}
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "version": "2.0.0-beta.50"
+}

package/removeClass.d.ts

@@ -1,5 +1 @@
-/**
- * Remove class shortcut
- */
-export declare function removeClass<T extends Element = HTMLElement>(el?: T, className?: string): void;
-export default removeClass;
+export declare let removeClass: <T extends Element>(el?: T | undefined, className?: string) => void;

package/scrollTo.d.ts

@@ -1,12 +1 @@
-/**
- * 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 declare function scrollTo(destination: number, callback?: () => void, fallbackTimeout?: number, behavior?: ScrollBehavior): void;
-export default scrollTo;
+export declare let scrollTo: (destination: number, callback?: () => void, fallbackTimeout?: number, behavior?: ScrollBehavior) => void;

package/setDataAttr.d.ts

@@ -1,9 +1 @@
-/**
- * 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 declare function setDataAttr(element: Element, attribute: string, value?: string | number | null | boolean): void;
-export default setDataAttr;
+export declare let setDataAttr: <T extends Element>(element: T, attribute: string, value?: string | number | null | boolean) => void;

package/setVendorCSS.d.ts

@@ -1,9 +1 @@
-/**
- * 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 declare function setVendorCSS(element: HTMLElement, prop: string, value: string | number | boolean): void;
-export default setVendorCSS;
+export declare let setVendorCSS: <T extends HTMLElement>(element: T, prop: string, value: string | number | boolean) => void;

package/siblings.d.ts

@@ -1,7 +1 @@
-/**
- * Finds siblings nodes of the passed node.
- *
- * @borrows @glidejs/glide/src/utils/dom (source)
- */
-export declare function siblings(node: Element): Element[];
-export default siblings;
+export declare let siblings: <T extends Element>(node: T) => Element[];

package/toArray.d.ts

@@ -1,7 +1 @@
-/**
- * Node list to array
- *
- * @param nodeList
- */
-export declare function toArray<T extends Element = HTMLElement>(nodeList: NodeListOf<T> | HTMLFormControlsCollection): T[] | HTMLFormElement[];
-export default toArray;
+export declare let toArray: <T extends Element>(nodeList: NodeListOf<T> | HTMLFormControlsCollection) => T[] | HTMLFormElement[];

package/types.d.ts

@@ -1,10 +1,5 @@
-import { LiteralUnion } from "type-fest";
-import type { AnythingFalsy } from "@koine/utils/types";
+import type { AnythingFalsy, LiteralUnion } from "@koine/utils";
 export type AnyDOMEventTarget = Window | Document | HTMLElement | Element;
-/**
- * We use it either throwing an error on unexisting element or falling back
- * to `window` in case of _scroll_ or _resize_ events
- */
 export type AnyDOMEventTargetLoose = AnyDOMEventTarget | AnythingFalsy;
 type StandardDOMEventTypes = keyof GlobalEventHandlersEventMap;
 export type AnyDOMEventType = LiteralUnion<StandardDOMEventTypes | "storage" | "popstate", string>;

package/unlisten.d.ts

@@ -1,13 +1,3 @@
 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 default unlisten;
+export declare let unlisten: <TTypes extends AnyDOMEventType, TTarget extends AnyDOMEventTarget = AnyDOMEventTarget>(types: TTypes, selector: string, callback: EventCallback<TTarget, TTypes>) => void;

package/$$.d.ts

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

package/$$.js

@@ -1,29 +0,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
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    $$: function() {
-        return $$;
-    },
-    default: function() {
-        return _default;
-    }
-});
-function $$(selector, parent, avoidEscape) {
-    return (parent ? parent : document).querySelectorAll(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
-}
-const _default = $$;

package/$$.mjs

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

package/$.js

@@ -1,32 +0,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);
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    $: function() {
-        return $;
-    },
-    default: function() {
-        return _default;
-    }
-});
-function $(selector, parent, avoidEscape) {
-    return (parent ? parent : document).querySelector(avoidEscape ? selector : selector.replace(/:/g, "\\:"));
-}
-const _default = $;

package/$.mjs

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

package/$each.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    $each: function() {
-        return $each;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _$$ = /*#__PURE__*/ _interop_require_default._(require("./$$"));
-function $each(selector, callback, parent, scope) {
-    const nodes = (0, _$$.default)(selector, parent);
-    for(let i = 0; i < nodes.length; i++){
-        callback.call(scope, nodes[i], i);
-    }
-}
-const _default = $each;

package/$each.mjs

@@ -1,16 +0,0 @@
-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) {
-    const nodes = $$(selector, parent);
-    for(let i = 0; i < nodes.length; i++){
-        callback.call(scope, nodes[i], i);
-    }
-}
-export default $each;

package/_listen-delegation.js

@@ -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
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    activeEvents: function() {
-        return activeEvents;
-    },
-    getIndex: function() {
-        return getIndex;
-    },
-    getRunTarget: function() {
-        return getRunTarget;
-    },
-    eventHandler: function() {
-        return eventHandler;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _isString = /*#__PURE__*/ _interop_require_default._(require("@koine/utils/isString"));
-const _escapeSelector = /*#__PURE__*/ _interop_require_default._(require("./escapeSelector"));
-const activeEvents = {};
-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;
-}
-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 ((0, _isString.default)(selector)) {
-        return target.closest((0, _escapeSelector.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;
-}
-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/_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.js

@@ -1,30 +0,0 @@
-/**
- * Add class shortcut
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    addClass: function() {
-        return addClass;
-    },
-    default: function() {
-        return _default;
-    }
-});
-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);
-}
-const _default = addClass;

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.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    calculateFixedOffset: function() {
-        return calculateFixedOffset;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _$each = require("./$each");
-function calculateFixedOffset(selector = "[data-fixed]") {
-    let fixedOffset = 0;
-    (0, _$each.$each)(selector, ($el)=>{
-        fixedOffset += $el.offsetHeight;
-    });
-    return fixedOffset;
-}
-const _default = calculateFixedOffset;

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.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: all[name]
-    });
-}
-_export(exports, {
-    createElement: function() {
-        return createElement;
-    },
-    default: function() {
-        return _default;
-    }
-});
-const _interop_require_default = require("@swc/helpers/_/_interop_require_default");
-const _addClass = /*#__PURE__*/ _interop_require_default._(require("./addClass"));
-function createElement(type, className) {
-    const el = document.createElement(type);
-    if (className) {
-        (0, _addClass.default)(el, className);
-    }
-    return el;
-}
-const _default = createElement;

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;