tool-shack 0.0.42 → 1.1.0

package/dist/esm/browser/tabFocusListener.d.ts

@@ -1,9 +1,6 @@
 /**
- * Set callbacks for if current browser tab is in focus
- *
- * @param focusCallback Function to be called when current browser tab goes into focus
- * @param blurCallback Function to be called when current browser tab goes out of focus
- * @returns void
+ * @deprecated Use {@link pageVisibilityListener}. Same `visibilitychange`
+ * listener; not window focus or blur.
  */
-export declare const tabFocusListener: (focusCallback?: () => void, blurCallback?: () => void) => void;
+export declare const tabFocusListener: (onVisible?: () => void, onHidden?: () => void) => (() => void);
 //# sourceMappingURL=tabFocusListener.d.ts.map

package/dist/esm/browser/tabFocusListener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabFocusListener.d.ts","sourceRoot":"","sources":["../../../src/browser/tabFocusListener.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,gBAAgB,MAAM,IAAI,EAAE,eAAe,MAAM,IAAI,KAAG,IAQxF,CAAC"}
+{"version":3,"file":"tabFocusListener.d.ts","sourceRoot":"","sources":["../../../src/browser/tabFocusListener.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,iEAAyB,CAAC"}

package/dist/esm/browser/tabFocusListener.js

@@ -1,19 +1,7 @@
-import { isTabFocused } from './isTabFocused.js';
+import { pageVisibilityListener } from './pageVisibilityListener.js';
 /**
- * Set callbacks for if current browser tab is in focus
- *
- * @param focusCallback Function to be called when current browser tab goes into focus
- * @param blurCallback Function to be called when current browser tab goes out of focus
- * @returns void
+ * @deprecated Use {@link pageVisibilityListener}. Same `visibilitychange`
+ * listener; not window focus or blur.
  */
-export const tabFocusListener = (focusCallback, blurCallback) => {
-    document.addEventListener('visibilitychange', () => {
-        if (isTabFocused()) {
-            focusCallback?.call(this);
-        }
-        else {
-            blurCallback?.call(this);
-        }
-    });
-};
+export const tabFocusListener = pageVisibilityListener;
 //# sourceMappingURL=tabFocusListener.js.map

package/dist/esm/browser/tabFocusListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"tabFocusListener.js","sourceRoot":"","sources":["../../../src/browser/tabFocusListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,aAA0B,EAAE,YAAyB,EAAQ,EAAE;IAC9F,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACjD,IAAI,YAAY,EAAE,EAAE,CAAC;YACnB,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"tabFocusListener.js","sourceRoot":"","sources":["../../../src/browser/tabFocusListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC"}

package/dist/esm/dateTime/dateAsIso.d.ts

@@ -1,8 +1,10 @@
 /**
- * Return date in ISO format with timezone
+ * Format a Date as local calendar date-time with numeric timezone offset
  *
- * @param date Date to be converted
- * @returns ISO format with timezone
+ * Output shape: `YYYY-MM-DDTHH:mm:ss±HH:mm` (no milliseconds, not UTC `Z`).
+ *
+ * @param date Date to format
+ * @returns Local ISO-like string with timezone offset
  */
 export declare const dateAsIso: (date: Date) => string;
 //# sourceMappingURL=dateAsIso.d.ts.map

package/dist/esm/dateTime/dateAsIso.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dateAsIso.d.ts","sourceRoot":"","sources":["../../../src/dateTime/dateAsIso.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,WAenC,CAAC"}
+{"version":3,"file":"dateAsIso.d.ts","sourceRoot":"","sources":["../../../src/dateTime/dateAsIso.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,MAetC,CAAC"}

package/dist/esm/dateTime/dateAsIso.js

@@ -1,8 +1,10 @@
 /**
- * Return date in ISO format with timezone
+ * Format a Date as local calendar date-time with numeric timezone offset
  *
- * @param date Date to be converted
- * @returns ISO format with timezone
+ * Output shape: `YYYY-MM-DDTHH:mm:ss±HH:mm` (no milliseconds, not UTC `Z`).
+ *
+ * @param date Date to format
+ * @returns Local ISO-like string with timezone offset
  */
 export const dateAsIso = (date) => {
     const timezoneOffset = date.getTimezoneOffset();

package/dist/esm/dateTime/dateAsIso.js.map

@@ -1 +1 @@
-{"version":3,"file":"dateAsIso.js","sourceRoot":"","sources":["../../../src/dateTime/dateAsIso.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAE,EAAE;IACtC,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAEhD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,SAAS,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,SAAS,CAC/E,IAAI,CAAC,OAAO,EAAE,CACf,EAAE,CAAC;IACJ,SAAS,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,SAAS,CACtF,IAAI,CAAC,UAAU,EAAE,CAClB,EAAE,CAAC;IACJ,SAAS,IAAI,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CACzD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;IAEhD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"dateAsIso.js","sourceRoot":"","sources":["../../../src/dateTime/dateAsIso.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAU,EAAU,EAAE;IAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAEhD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,SAAS,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,SAAS,CAC/E,IAAI,CAAC,OAAO,EAAE,CACf,EAAE,CAAC;IACJ,SAAS,IAAI,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,SAAS,CACtF,IAAI,CAAC,UAAU,EAAE,CAClB,EAAE,CAAC;IACJ,SAAS,IAAI,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CACzD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAC1C,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;IAEhD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/dist/esm/dateTime/index.d.ts

@@ -1,4 +1,6 @@
 export * from './interfaces/index.js';
 export * from './dateAsIso.js';
+export * from './isSameDay.js';
 export * from './parseDuration.js';
+export * from './timeAgo.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/dateTime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/esm/dateTime/index.js

@@ -1,4 +1,6 @@
 export * from './interfaces/index.js';
 export * from './dateAsIso.js';
+export * from './isSameDay.js';
 export * from './parseDuration.js';
+export * from './timeAgo.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/dateTime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/esm/dateTime/isSameDay.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check if two dates fall on the same calendar day
+ *
+ * @param firstDate First Date object or timestamp
+ * @param secondDate Second Date object or timestamp
+ * @returns Boolean indicating if both dates have matching day, month, and year
+ */
+export declare const isSameDay: (firstDate: Date | number | string, secondDate: Date | number | string) => boolean;
+//# sourceMappingURL=isSameDay.d.ts.map

package/dist/esm/dateTime/isSameDay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSameDay.d.ts","sourceRoot":"","sources":["../../../src/dateTime/isSameDay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GACpB,WAAW,IAAI,GAAG,MAAM,GAAG,MAAM,EACjC,YAAY,IAAI,GAAG,MAAM,GAAG,MAAM,KACjC,OASF,CAAC"}

package/dist/esm/dateTime/isSameDay.js

@@ -0,0 +1,15 @@
+/**
+ * Check if two dates fall on the same calendar day
+ *
+ * @param firstDate First Date object or timestamp
+ * @param secondDate Second Date object or timestamp
+ * @returns Boolean indicating if both dates have matching day, month, and year
+ */
+export const isSameDay = (firstDate, secondDate) => {
+    const dateA = firstDate instanceof Date ? firstDate : new Date(firstDate);
+    const dateB = secondDate instanceof Date ? secondDate : new Date(secondDate);
+    return (dateA.getFullYear() === dateB.getFullYear() &&
+        dateA.getMonth() === dateB.getMonth() &&
+        dateA.getDate() === dateB.getDate());
+};
+//# sourceMappingURL=isSameDay.js.map

package/dist/esm/dateTime/isSameDay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSameDay.js","sourceRoot":"","sources":["../../../src/dateTime/isSameDay.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,SAAiC,EACjC,UAAkC,EACzB,EAAE;IACX,MAAM,KAAK,GAAG,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC;IAE7E,OAAO,CACL,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE;QAC3C,KAAK,CAAC,QAAQ,EAAE,KAAK,KAAK,CAAC,QAAQ,EAAE;QACrC,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CACpC,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/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/esm/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/esm/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/esm/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/esm/dateTime/timeAgo.js

@@ -0,0 +1,35 @@
+/**
+ * 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 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');
+};
+//# sourceMappingURL=timeAgo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeAgo.js","sourceRoot":"","sources":["../../../src/dateTime/timeAgo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/dom/addAsyncEventListener.js

@@ -4,23 +4,35 @@
  * @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 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();
+        });
+    };
 };
 //# sourceMappingURL=addAsyncEventListener.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"addAsyncEventListener.js","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,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"}
+{"version":3,"file":"addAsyncEventListener.js","sourceRoot":"","sources":["../../../src/dom/addAsyncEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/dom/addClickOutsideListener.js

@@ -2,15 +2,19 @@
  * 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 const addClickOutsideListener = (element, fn) => {
-    document.addEventListener('click', (event) => {
+export 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);
+    };
 };
 //# sourceMappingURL=addClickOutsideListener.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"addClickOutsideListener.js","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,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"}
+{"version":3,"file":"addClickOutsideListener.js","sourceRoot":"","sources":["../../../src/dom/addClickOutsideListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/dom/addEventListener.js

@@ -1,18 +1,20 @@
 /**
- * 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 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/esm/dom/addEventListener.js.map

@@ -1 +1 @@
-{"version":3,"file":"addEventListener.js","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,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"}
+{"version":3,"file":"addEventListener.js","sourceRoot":"","sources":["../../../src/dom/addEventListener.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/dom/copyToClipboard.js

@@ -0,0 +1,37 @@
+/**
+ * Copy text to clipboard using Clipboard API with textarea fallback
+ *
+ * @param text String text to copy
+ * @returns Promise resolving to boolean indicating success
+ */
+export 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;
+    }
+};
+//# sourceMappingURL=copyToClipboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"copyToClipboard.js","sourceRoot":"","sources":["../../../src/dom/copyToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/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/esm/dom/createElement.js

@@ -3,13 +3,14 @@
  *
  * @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 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);
             }
@@ -34,11 +35,11 @@ export 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/esm/dom/createElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"createElement.js","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,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"}
+{"version":3,"file":"createElement.js","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,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"}

package/dist/esm/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/esm/dom/fireEvent.js

@@ -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 const fireEvent = (element, eventType) => element.dispatchEvent(new Event(eventType));
 //# sourceMappingURL=fireEvent.js.map

package/dist/esm/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/esm/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"}