tool-shack 0.0.42 → 1.1.0

package/dist/cjs/dateTime/parseDuration.d.ts

@@ -1,4 +1,4 @@
-import { IDuration } from './interfaces/parseDuration.js';
+import type { IDuration } from './interfaces/parseDuration.js';
 /**
  * Parse duration in milliseconds into days, hours, minutes, seconds, milliseconds
  *

package/dist/cjs/dateTime/parseDuration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseDuration.d.ts","sourceRoot":"","sources":["../../../src/dateTime/parseDuration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,cAAc,MAAM,KAAG,SAUpD,CAAC"}
+{"version":3,"file":"parseDuration.d.ts","sourceRoot":"","sources":["../../../src/dateTime/parseDuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,cAAc,MAAM,KAAG,SAUpD,CAAC"}

package/dist/cjs/dateTime/timeAgo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Convert a date into human-readable relative time string (e.g. "5 minutes ago", "in 2 days")
+ *
+ * @param date Target Date, timestamp number, or date string
+ * @param locale Optional BCP 47 locale tag (defaults to 'en')
+ * @returns Human-readable relative time string
+ */
+export declare const timeAgo: (date: Date | number | string, locale?: string) => string;
+//# sourceMappingURL=timeAgo.d.ts.map

package/dist/cjs/dateTime/timeAgo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.d.ts","sourceRoot":"","sources":["../../../src/dateTime/timeAgo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,eAAa,KAAG,MAiCrE,CAAC"}

package/dist/cjs/dateTime/timeAgo.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeAgo = void 0;
+/**
+ * Convert a date into human-readable relative time string (e.g. "5 minutes ago", "in 2 days")
+ *
+ * @param date Target Date, timestamp number, or date string
+ * @param locale Optional BCP 47 locale tag (defaults to 'en')
+ * @returns Human-readable relative time string
+ */
+const timeAgo = (date, locale = 'en') => {
+    const targetDate = date instanceof Date ? date : new Date(date);
+    const diffInSeconds = Math.round((targetDate.getTime() - Date.now()) / 1000);
+    const absDiff = Math.abs(diffInSeconds);
+    const formatter = new Intl.RelativeTimeFormat(locale, { numeric: 'auto' });
+    if (absDiff < 60) {
+        return formatter.format(diffInSeconds, 'second');
+    }
+    const diffInMinutes = Math.round(diffInSeconds / 60);
+    if (Math.abs(diffInMinutes) < 60) {
+        return formatter.format(diffInMinutes, 'minute');
+    }
+    const diffInHours = Math.round(diffInMinutes / 60);
+    if (Math.abs(diffInHours) < 24) {
+        return formatter.format(diffInHours, 'hour');
+    }
+    const diffInDays = Math.round(diffInHours / 24);
+    if (Math.abs(diffInDays) < 30) {
+        return formatter.format(diffInDays, 'day');
+    }
+    const diffInMonths = Math.round(diffInDays / 30);
+    if (Math.abs(diffInMonths) < 12) {
+        return formatter.format(diffInMonths, 'month');
+    }
+    const diffInYears = Math.round(diffInDays / 365);
+    return formatter.format(diffInYears, 'year');
+};
+exports.timeAgo = timeAgo;
+//# sourceMappingURL=timeAgo.js.map

package/dist/cjs/dateTime/timeAgo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.js","sourceRoot":"","sources":["../../../src/dateTime/timeAgo.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,IAA4B,EAAE,MAAM,GAAG,IAAI,EAAU,EAAE;IAC7E,MAAM,UAAU,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAE3E,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,CAAC;QACjC,OAAO,SAAS,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC/C,CAAC,CAAC;AAjCW,QAAA,OAAO,WAiClB"}

package/dist/cjs/dom/addAsyncEventListener.d.ts

@@ -4,7 +4,7 @@
  * @param elementSelector Selector for element(s) to match event target
  * @param listeners List of event types and related callback(s)
  * @param acceptBubbling Boolean switch to allow bubbling or accept only direct element match
- * @returns void
+ * @returns Cleanup function to remove the delegated listeners
  */
-export declare const addAsyncEventListener: (elementSelector: string, listeners: Record<string, EventListener | EventListener[]>, acceptBubbling?: boolean) => void;
+export declare const addAsyncEventListener: (elementSelector: string, listeners: Record<string, EventListener | EventListener[]>, acceptBubbling?: boolean) => (() => void);
 //# sourceMappingURL=addAsyncEventListener.d.ts.map

package/dist/cjs/dom/addAsyncEventListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addAsyncEventListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,MAAM,EACvB,WAAW,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC,EAC1D,wBAAqB,KACpB,IAqBF,CAAC"}
+{"version":3,"file":"addAsyncEventListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,iBAAiB,MAAM,EACvB,WAAW,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC,EAC1D,wBAAqB,KACpB,CAAC,MAAM,IAAI,CAkCb,CAAC"}

package/dist/cjs/dom/addAsyncEventListener.js

@@ -7,24 +7,36 @@ exports.addAsyncEventListener = void 0;
  * @param elementSelector Selector for element(s) to match event target
  * @param listeners List of event types and related callback(s)
  * @param acceptBubbling Boolean switch to allow bubbling or accept only direct element match
- * @returns void
+ * @returns Cleanup function to remove the delegated listeners
  */
 const addAsyncEventListener = (elementSelector, listeners, acceptBubbling = true) => {
-    for (let eventName in listeners) {
+    const removals = [];
+    for (const eventName in listeners) {
         const functionList = (listeners[eventName] instanceof Array ? listeners[eventName] : [listeners[eventName]]);
-        functionList.forEach((fn) => document.addEventListener(eventName, (event) => {
-            const target = event.target;
-            if (!target) {
-                return;
-            }
-            if (!acceptBubbling && target.matches(elementSelector)) {
-                fn.call(this, event);
-            }
-            else if (acceptBubbling && target.closest(elementSelector)) {
-                fn.call(this, event);
-            }
-        }));
+        functionList.forEach((listener) => {
+            const handleEvent = (event) => {
+                const target = event.target;
+                if (!target) {
+                    return;
+                }
+                if (!acceptBubbling && target.matches(elementSelector)) {
+                    listener(event);
+                }
+                else if (acceptBubbling && target.closest(elementSelector)) {
+                    listener(event);
+                }
+            };
+            document.addEventListener(eventName, handleEvent);
+            removals.push(() => {
+                document.removeEventListener(eventName, handleEvent);
+            });
+        });
     }
+    return () => {
+        removals.forEach((remove) => {
+            remove();
+        });
+    };
 };
 exports.addAsyncEventListener = addAsyncEventListener;
 //# sourceMappingURL=addAsyncEventListener.js.map

package/dist/cjs/dom/addAsyncEventListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"addAsyncEventListener.js","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,qBAAqB,GAAG,CACnC,eAAuB,EACvB,SAA0D,EAC1D,cAAc,GAAG,IAAI,EACf,EAAE;IACR,KAAK,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,CACnB,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CACnE,CAAC;QAErB,YAAY,CAAC,OAAO,CAAC,CAAC,EAAiB,EAAE,EAAE,CACzC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAY,EAAE,EAAE;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;YAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YAED,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBACvD,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7D,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAzBW,QAAA,qBAAqB,yBAyBhC"}
+{"version":3,"file":"addAsyncEventListener.js","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACI,MAAM,qBAAqB,GAAG,CACnC,eAAuB,EACvB,SAA0D,EAC1D,cAAc,GAAG,IAAI,EACP,EAAE;IAChB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,CACnB,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CACnE,CAAC;QAErB,YAAY,CAAC,OAAO,CAAC,CAAC,QAAuB,EAAE,EAAE;YAC/C,MAAM,WAAW,GAAG,CAAC,KAAY,EAAQ,EAAE;gBACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;gBAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;oBACvD,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;qBAAM,IAAI,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;oBAC7D,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC;YAEF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjB,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACvD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,MAAM,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC,CAAC;AAtCW,QAAA,qBAAqB,yBAsChC"}

package/dist/cjs/dom/addClickOutsideListener.d.ts

@@ -2,8 +2,8 @@
  * Add event listener to listen to clicks outside of given element
  *
  * @param element Node element outside which to listen to clicks
- * @param fn Function to trigger when clicked outside
- * @returns void
+ * @param callback Function to trigger when clicked outside
+ * @returns Cleanup function to remove the listener
  */
-export declare const addClickOutsideListener: (element: HTMLElement, fn: () => any) => void;
+export declare const addClickOutsideListener: (element: HTMLElement, callback: (event?: Event) => void) => (() => void);
 //# sourceMappingURL=addClickOutsideListener.d.ts.map

package/dist/cjs/dom/addClickOutsideListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addClickOutsideListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS,WAAW,EAAE,IAAI,MAAM,GAAG,KAAG,IAQ7E,CAAC"}
+{"version":3,"file":"addClickOutsideListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,WAAW,EACpB,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAChC,CAAC,MAAM,IAAI,CAcb,CAAC"}

package/dist/cjs/dom/addClickOutsideListener.js

@@ -5,16 +5,20 @@ exports.addClickOutsideListener = void 0;
  * Add event listener to listen to clicks outside of given element
  *
  * @param element Node element outside which to listen to clicks
- * @param fn Function to trigger when clicked outside
- * @returns void
+ * @param callback Function to trigger when clicked outside
+ * @returns Cleanup function to remove the listener
  */
-const addClickOutsideListener = (element, fn) => {
-    document.addEventListener('click', (event) => {
+const addClickOutsideListener = (element, callback) => {
+    const handleClick = (event) => {
         const target = event.target;
         if (!!target && !element.contains(target)) {
-            fn.call(this);
+            callback(event);
         }
-    });
+    };
+    document.addEventListener('click', handleClick);
+    return () => {
+        document.removeEventListener('click', handleClick);
+    };
 };
 exports.addClickOutsideListener = addClickOutsideListener;
 //# sourceMappingURL=addClickOutsideListener.js.map

package/dist/cjs/dom/addClickOutsideListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"addClickOutsideListener.js","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,uBAAuB,GAAG,CAAC,OAAoB,EAAE,EAAa,EAAQ,EAAE;IACnF,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;QAE3C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AARW,QAAA,uBAAuB,2BAQlC"}
+{"version":3,"file":"addClickOutsideListener.js","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,uBAAuB,GAAG,CACrC,OAAoB,EACpB,QAAiC,EACnB,EAAE;IAChB,MAAM,WAAW,GAAG,CAAC,KAAY,EAAQ,EAAE;QACzC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAqB,CAAC;QAE3C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEhD,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,CAAC;AAjBW,QAAA,uBAAuB,2BAiBlC"}

package/dist/cjs/dom/addEventListener.d.ts

@@ -1,8 +1,10 @@
 /**
- * Add event listener(s) to one or more Node elements
+ * Add event listener(s) to one or more elements
  *
- * @param element One or multiple Node element(s) to set listener(s) for
- * @param listeners List of event types and related callback(s)
+ * `listeners` is a map of event name to one handler or an array of handlers. This helper does not take `AddEventListenerOptions` and does not return cleanup.
+ *
+ * @param element One element or a list of elements
+ * @param listeners Event name to handler or handler array
  * @returns void
  */
 export declare const addEventListener: (element: HTMLElement | HTMLElement[] | NodeListOf<HTMLElement> | HTMLCollectionOf<HTMLElement>, listeners: Record<string, EventListenerOrEventListenerObject | EventListenerOrEventListenerObject[]>) => void;

package/dist/cjs/dom/addEventListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addEventListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,WAAW,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,EAC9F,WAAW,MAAM,CACf,MAAM,EACN,kCAAkC,GAAG,kCAAkC,EAAE,CAC1E,KACA,IAkBF,CAAC"}
+{"version":3,"file":"addEventListener.d.ts","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,WAAW,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,EAC9F,WAAW,MAAM,CACf,MAAM,EACN,kCAAkC,GAAG,kCAAkC,EAAE,CAC1E,KACA,IAkBF,CAAC"}

package/dist/cjs/dom/addEventListener.js

@@ -2,20 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addEventListener = void 0;
 /**
- * Add event listener(s) to one or more Node elements
+ * Add event listener(s) to one or more elements
  *
- * @param element One or multiple Node element(s) to set listener(s) for
- * @param listeners List of event types and related callback(s)
+ * `listeners` is a map of event name to one handler or an array of handlers. This helper does not take `AddEventListenerOptions` and does not return cleanup.
+ *
+ * @param element One element or a list of elements
+ * @param listeners Event name to handler or handler array
  * @returns void
  */
 const addEventListener = (element, listeners) => {
     const elementList = (element instanceof Array || element instanceof HTMLCollection || element instanceof NodeList
         ? Array.from(element)
         : [element]);
-    elementList.forEach((element) => {
-        for (let eventName in listeners) {
+    elementList.forEach((targetElement) => {
+        for (const eventName in listeners) {
             const functionList = (listeners[eventName] instanceof Array ? listeners[eventName] : [listeners[eventName]]);
-            functionList.forEach((fn) => element.addEventListener(eventName, fn));
+            functionList.forEach((listener) => targetElement.addEventListener(eventName, listener));
         }
     });
 };

package/dist/cjs/dom/addEventListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"addEventListener.js","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAC9B,OAA8F,EAC9F,SAGC,EACK,EAAE;IACR,MAAM,WAAW,GAAG,CAClB,OAAO,YAAY,KAAK,IAAI,OAAO,YAAY,cAAc,IAAI,OAAO,YAAY,QAAQ;QAC1F,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,CAAC,OAAO,CAAC,CACG,CAAC;IAEnB,WAAW,CAAC,OAAO,CAAC,CAAC,OAAoB,EAAE,EAAE;QAC3C,KAAK,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,CACnB,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAC9C,CAAC;YAE1C,YAAY,CAAC,OAAO,CAAC,CAAC,EAAsC,EAAE,EAAE,CAC9D,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC,CACxC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAxBW,QAAA,gBAAgB,oBAwB3B"}
+{"version":3,"file":"addEventListener.js","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAC9B,OAA8F,EAC9F,SAGC,EACK,EAAE;IACR,MAAM,WAAW,GAAG,CAClB,OAAO,YAAY,KAAK,IAAI,OAAO,YAAY,cAAc,IAAI,OAAO,YAAY,QAAQ;QAC1F,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,CAAC,OAAO,CAAC,CACG,CAAC;IAEnB,WAAW,CAAC,OAAO,CAAC,CAAC,aAA0B,EAAE,EAAE;QACjD,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;YAClC,MAAM,YAAY,GAAG,CACnB,SAAS,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAC9C,CAAC;YAE1C,YAAY,CAAC,OAAO,CAAC,CAAC,QAA4C,EAAE,EAAE,CACpE,aAAa,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CACpD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAxBW,QAAA,gBAAgB,oBAwB3B"}

package/dist/cjs/dom/copyToClipboard.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copy text to clipboard using Clipboard API with textarea fallback
+ *
+ * @param text String text to copy
+ * @returns Promise resolving to boolean indicating success
+ */
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+//# sourceMappingURL=copyToClipboard.d.ts.map

package/dist/cjs/dom/copyToClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyToClipboard.d.ts","sourceRoot":"","sources":["../../../src/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CA4BnE,CAAC"}

package/dist/cjs/dom/copyToClipboard.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyToClipboard = void 0;
+/**
+ * Copy text to clipboard using Clipboard API with textarea fallback
+ *
+ * @param text String text to copy
+ * @returns Promise resolving to boolean indicating success
+ */
+const copyToClipboard = async (text) => {
+    try {
+        if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
+            await navigator.clipboard.writeText(text);
+            return true;
+        }
+    }
+    catch {
+        // Fallback below
+    }
+    try {
+        const tempTextarea = document.createElement('textarea');
+        tempTextarea.value = text;
+        tempTextarea.style.position = 'fixed';
+        tempTextarea.style.opacity = '0';
+        tempTextarea.style.pointerEvents = 'none';
+        document.body.appendChild(tempTextarea);
+        try {
+            tempTextarea.focus();
+            tempTextarea.select();
+            return document.execCommand('copy');
+        }
+        finally {
+            document.body.removeChild(tempTextarea);
+        }
+    }
+    catch {
+        return false;
+    }
+};
+exports.copyToClipboard = copyToClipboard;
+//# sourceMappingURL=copyToClipboard.js.map

package/dist/cjs/dom/copyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyToClipboard.js","sourceRoot":"","sources":["../../../src/dom/copyToClipboard.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;IACtE,IAAI,CAAC;QACH,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;YACvE,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACxD,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC;QAC1B,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;QACtC,YAAY,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;QACjC,YAAY,CAAC,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAExC,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC;YACrB,YAAY,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AA5BW,QAAA,eAAe,mBA4B1B"}

package/dist/cjs/dom/createElement.d.ts

@@ -1,10 +1,13 @@
-import { IExtendingElementProps } from './interfaces/createElement.js';
+import type { TCreateElementProps } from './types/createElement.js';
 /**
  * Method for creating Node element and assigning multiple parameters, event listeners & children in one method call
  *
  * @param tagName Node tag name
  * @param props List of attributes, event listeners or/and children to assign to the newly created element
- * @returns Resulting Node element
+ * @returns Created element; known HTML tags infer their specific element type
  */
-export declare const createElement: <T = HTMLElement>(tagName: string, props?: Partial<Omit<T, "children" | "dataset" | "style">> & IExtendingElementProps) => T;
+export declare const createElement: {
+    <K extends keyof HTMLElementTagNameMap>(tagName: K, props?: TCreateElementProps<HTMLElementTagNameMap[K]>): HTMLElementTagNameMap[K];
+    (tagName: string, props?: TCreateElementProps<HTMLElement>): HTMLElement;
+};
 //# sourceMappingURL=createElement.d.ts.map

package/dist/cjs/dom/createElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createElement.d.ts","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,WAAW,EAC3C,SAAS,MAAM,EACf,QAAQ,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,sBAAsB,KAClF,CA8CF,CAAC"}
+{"version":3,"file":"createElement.d.ts","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE;IAC1B,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACpC,OAAO,EAAE,CAAC,EACV,KAAK,CAAC,EAAE,mBAAmB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GACpD,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;CAiD1E,CAAC"}

package/dist/cjs/dom/createElement.js

@@ -6,13 +6,14 @@ exports.createElement = void 0;
  *
  * @param tagName Node tag name
  * @param props List of attributes, event listeners or/and children to assign to the newly created element
- * @returns Resulting Node element
+ * @returns Created element; known HTML tags infer their specific element type
  */
 const createElement = (tagName, props) => {
     const element = document.createElement(tagName);
     if (props) {
-        for (let key in props) {
-            const value = props[key];
+        const propsRecord = props;
+        for (const key in props) {
+            const value = propsRecord[key];
             if (key === 'role') {
                 element.setAttribute(key, value);
             }
@@ -37,11 +38,11 @@ const createElement = (tagName, props) => {
                 element.appendChild(fragment);
             }
             else if (key === 'listeners') {
-                for (let eventName in props.listeners) {
+                for (const eventName in props.listeners) {
                     const functionList = (props.listeners[eventName] instanceof Array
                         ? props.listeners[eventName]
                         : [props.listeners[eventName]]);
-                    functionList.forEach((fn) => element.addEventListener(eventName, fn));
+                    functionList.forEach((listener) => element.addEventListener(eventName, listener));
                 }
             }
             else if (key === 'dataset') {

package/dist/cjs/dom/createElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"createElement.js","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,CAC3B,OAAe,EACf,KAAmF,EAChF,EAAE;IACL,MAAM,OAAO,GAAgB,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAE7D,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,KAAK,GAAI,KAAa,CAAC,GAAG,CAAC,CAAC;YAElC,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC;iBAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBAC1B,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,CAAC,EAAE,CAAC;oBAC/D,OAAO,CAAC,YAAY,CAAC,QAAQ,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;gBACnD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAS,EAAE,CAAC;oBACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;oBACvD,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBAC/B,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC,SAAU,EAAE,CAAC;oBACvC,MAAM,YAAY,GAAG,CACnB,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC,YAAY,KAAK;wBAC1C,CAAC,CAAC,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC;wBAC7B,CAAC,CAAC,CAAC,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC,CAAC,CACM,CAAC;oBAE1C,YAAY,CAAC,OAAO,CAAC,CAAC,EAAsC,EAAE,EAAE,CAC9D,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC,CACxC,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACL,OAAe,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAuB,CAAC;AACjC,CAAC,CAAC;AAjDW,QAAA,aAAa,iBAiDxB"}
+{"version":3,"file":"createElement.js","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACI,MAAM,aAAa,GAMtB,CAAC,OAAe,EAAE,KAAwC,EAAe,EAAE;IAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,WAAW,GAAG,KAAgC,CAAC;QAErD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAE/B,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnB,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,KAAe,CAAC,CAAC;YAC7C,CAAC;iBAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBAC1B,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAK,CAAC,EAAE,CAAC;oBAC/D,OAAO,CAAC,YAAY,CAAC,QAAQ,OAAO,EAAE,EAAE,SAAmB,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,sBAAsB,EAAE,CAAC;gBACnD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAS,EAAE,CAAC;oBACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC9B,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;oBACvD,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBAC/B,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,SAAU,EAAE,CAAC;oBACzC,MAAM,YAAY,GAAG,CACnB,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC,YAAY,KAAK;wBAC1C,CAAC,CAAC,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC;wBAC7B,CAAC,CAAC,CAAC,KAAK,CAAC,SAAU,CAAC,SAAS,CAAC,CAAC,CACM,CAAC;oBAE1C,YAAY,CAAC,OAAO,CAAC,CAAC,QAA4C,EAAE,EAAE,CACpE,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAC9C,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACL,OAA8C,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAtDW,QAAA,aAAa,iBAsDxB"}

package/dist/cjs/dom/fireEvent.d.ts

@@ -1,9 +1,9 @@
 /**
- * Manually fire event on Node element
+ * Dispatch a native Event on an element
  *
- * @param element Node element on which should be fired event
- * @param eventType Type name of event that should be fired
- * @returns Result of the action
+ * @param element Element to dispatch on
+ * @param eventType Event type name
+ * @returns Result of `dispatchEvent`
  */
 export declare const fireEvent: (element: HTMLElement, eventType: string) => boolean;
 //# sourceMappingURL=fireEvent.d.ts.map

package/dist/cjs/dom/fireEvent.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fireEvent = void 0;
 /**
- * Manually fire event on Node element
+ * Dispatch a native Event on an element
  *
- * @param element Node element on which should be fired event
- * @param eventType Type name of event that should be fired
- * @returns Result of the action
+ * @param element Element to dispatch on
+ * @param eventType Event type name
+ * @returns Result of `dispatchEvent`
  */
 const fireEvent = (element, eventType) => element.dispatchEvent(new Event(eventType));
 exports.fireEvent = fireEvent;

package/dist/cjs/dom/index.d.ts

@@ -1,10 +1,16 @@
 export * from './interfaces/index.js';
+export * from './types/index.js';
 export * from './addAsyncEventListener.js';
 export * from './addClickOutsideListener.js';
 export * from './addEventListener.js';
 export * from './appendAfter.js';
 export * from './appendBefore.js';
+export * from './copyToClipboard.js';
 export * from './createElement.js';
 export * from './fireEvent.js';
 export * from './getElementOffset.js';
+export * from './isInViewport.js';
+export * from './toggleFullscreen.js';
+export * from './toggleFullscreenWithFallback.js';
+export * from './waitForElement.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/dom/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dom/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dom/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC"}

package/dist/cjs/dom/index.js

@@ -1,13 +1,32 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./interfaces/index.js"), exports);
-tslib_1.__exportStar(require("./addAsyncEventListener.js"), exports);
-tslib_1.__exportStar(require("./addClickOutsideListener.js"), exports);
-tslib_1.__exportStar(require("./addEventListener.js"), exports);
-tslib_1.__exportStar(require("./appendAfter.js"), exports);
-tslib_1.__exportStar(require("./appendBefore.js"), exports);
-tslib_1.__exportStar(require("./createElement.js"), exports);
-tslib_1.__exportStar(require("./fireEvent.js"), exports);
-tslib_1.__exportStar(require("./getElementOffset.js"), exports);
+__exportStar(require("./interfaces/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);
+__exportStar(require("./addAsyncEventListener.js"), exports);
+__exportStar(require("./addClickOutsideListener.js"), exports);
+__exportStar(require("./addEventListener.js"), exports);
+__exportStar(require("./appendAfter.js"), exports);
+__exportStar(require("./appendBefore.js"), exports);
+__exportStar(require("./copyToClipboard.js"), exports);
+__exportStar(require("./createElement.js"), exports);
+__exportStar(require("./fireEvent.js"), exports);
+__exportStar(require("./getElementOffset.js"), exports);
+__exportStar(require("./isInViewport.js"), exports);
+__exportStar(require("./toggleFullscreen.js"), exports);
+__exportStar(require("./toggleFullscreenWithFallback.js"), exports);
+__exportStar(require("./waitForElement.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/dom/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dom/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AAEtC,qEAA2C;AAC3C,uEAA6C;AAC7C,gEAAsC;AACtC,2DAAiC;AACjC,4DAAkC;AAClC,6DAAmC;AACnC,yDAA+B;AAC/B,gEAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dom/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,mDAAiC;AAEjC,6DAA2C;AAC3C,+DAA6C;AAC7C,wDAAsC;AACtC,mDAAiC;AACjC,oDAAkC;AAClC,uDAAqC;AACrC,qDAAmC;AACnC,iDAA+B;AAC/B,wDAAsC;AACtC,oDAAkC;AAClC,wDAAsC;AACtC,oEAAkD;AAClD,sDAAoC"}

package/dist/cjs/dom/interfaces/createElement.d.ts

@@ -1,4 +1,4 @@
-export type TAriaLabelKey = 'atomic' | 'busy' | 'controls' | 'current' | 'describedby' | 'details' | 'disables' | 'dropeffect' | 'errormessage' | 'expanded' | 'flowto' | 'grabbed' | 'haspopup' | 'hidden' | 'invalid' | 'keyshortcuts' | 'label' | 'labelledby' | 'live' | 'modal' | 'owns' | 'relevant' | 'roledescription';
+export type TAriaLabelKey = 'atomic' | 'busy' | 'controls' | 'current' | 'describedby' | 'details' | 'disabled' | 'dropeffect' | 'errormessage' | 'expanded' | 'flowto' | 'grabbed' | 'haspopup' | 'hidden' | 'invalid' | 'keyshortcuts' | 'label' | 'labelledby' | 'live' | 'modal' | 'owns' | 'relevant' | 'roledescription';
 export interface IExtendingElementProps {
     children?: (HTMLElement | string | SVGElement)[];
     listeners?: Record<string, EventListenerOrEventListenerObject | EventListenerOrEventListenerObject[]>;

package/dist/cjs/dom/interfaces/index.d.ts

@@ -1,2 +1,3 @@
 export * from './createElement.js';
+export * from './toggleFullscreenWithFallback.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/dom/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dom/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dom/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mCAAmC,CAAC"}

package/dist/cjs/dom/interfaces/index.js

@@ -1,5 +1,19 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./createElement.js"), exports);
+__exportStar(require("./createElement.js"), exports);
+__exportStar(require("./toggleFullscreenWithFallback.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/dom/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dom/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dom/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oEAAkD"}

package/dist/cjs/dom/interfaces/toggleFullscreenWithFallback.d.ts

@@ -0,0 +1,5 @@
+export interface IFullscreenFallbackOptions {
+    className?: string;
+    zIndex?: number;
+}
+//# sourceMappingURL=toggleFullscreenWithFallback.d.ts.map

package/dist/cjs/dom/interfaces/toggleFullscreenWithFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleFullscreenWithFallback.d.ts","sourceRoot":"","sources":["../../../../src/dom/interfaces/toggleFullscreenWithFallback.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/cjs/dom/interfaces/toggleFullscreenWithFallback.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=toggleFullscreenWithFallback.js.map

package/dist/cjs/dom/interfaces/toggleFullscreenWithFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleFullscreenWithFallback.js","sourceRoot":"","sources":["../../../../src/dom/interfaces/toggleFullscreenWithFallback.ts"],"names":[],"mappings":""}

package/dist/cjs/dom/isInViewport.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check if a DOM element is currently within the visible viewport
+ *
+ * @param element Target HTMLElement to check
+ * @param offset Optional margin offset in pixels to expand or shrink the viewport check boundary
+ * @returns Boolean indicating whether element is in viewport
+ */
+export declare const isInViewport: (element: HTMLElement, offset?: number) => boolean;
+//# sourceMappingURL=isInViewport.d.ts.map

package/dist/cjs/dom/isInViewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInViewport.d.ts","sourceRoot":"","sources":["../../../src/dom/isInViewport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,WAAW,EAAE,eAAU,KAAG,OAW/D,CAAC"}

package/dist/cjs/dom/isInViewport.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInViewport = void 0;
+/**
+ * Check if a DOM element is currently within the visible viewport
+ *
+ * @param element Target HTMLElement to check
+ * @param offset Optional margin offset in pixels to expand or shrink the viewport check boundary
+ * @returns Boolean indicating whether element is in viewport
+ */
+const isInViewport = (element, offset = 0) => {
+    const rect = element.getBoundingClientRect();
+    const windowHeight = window.innerHeight || document.documentElement.clientHeight;
+    const windowWidth = window.innerWidth || document.documentElement.clientWidth;
+    return (rect.top <= windowHeight + offset &&
+        rect.bottom >= -offset &&
+        rect.left <= windowWidth + offset &&
+        rect.right >= -offset);
+};
+exports.isInViewport = isInViewport;
+//# sourceMappingURL=isInViewport.js.map

package/dist/cjs/dom/isInViewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isInViewport.js","sourceRoot":"","sources":["../../../src/dom/isInViewport.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,YAAY,GAAG,CAAC,OAAoB,EAAE,MAAM,GAAG,CAAC,EAAW,EAAE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,eAAe,CAAC,YAAY,CAAC;IACjF,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC;IAE9E,OAAO,CACL,IAAI,CAAC,GAAG,IAAI,YAAY,GAAG,MAAM;QACjC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM;QACtB,IAAI,CAAC,IAAI,IAAI,WAAW,GAAG,MAAM;QACjC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CACtB,CAAC;AACJ,CAAC,CAAC;AAXW,QAAA,YAAY,gBAWvB"}