tool-shack 1.0.0 → 1.1.1

package/dist/esm/browser/isPageVisible.js

@@ -0,0 +1,10 @@
+/**
+ * Check whether the page is currently visible
+ *
+ * Uses the Page Visibility API (`document.hidden`). This is not window or tab
+ * input focus.
+ *
+ * @returns Whether the document is currently visible
+ */
+export const isPageVisible = () => !document.hidden;
+//# sourceMappingURL=isPageVisible.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isPageVisible.js","sourceRoot":"","sources":["../../../src/browser/isPageVisible.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC"}

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

@@ -1,7 +1,10 @@
 /**
- * Check if user's browser supports push notifications
+ * Check whether the environment supports the Web Push API
  *
- * @returns Boolean indicating if user's browser supports push notifications
+ * Requires Notification, Service Worker, and PushManager. Does not check
+ * permission and does not register a service worker.
+ *
+ * @returns Whether Web Push is supported
  */
 export declare const isPushNotificationSupported: () => boolean;
 //# sourceMappingURL=isPushNotificationSupported.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPushNotificationSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAAO,OACa,CAAC"}
+{"version":3,"file":"isPushNotificationSupported.d.ts","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,QAAO,OACsC,CAAC"}

package/dist/esm/browser/isPushNotificationSupported.js

@@ -1,7 +1,10 @@
 /**
- * Check if user's browser supports push notifications
+ * Check whether the environment supports the Web Push API
  *
- * @returns Boolean indicating if user's browser supports push notifications
+ * Requires Notification, Service Worker, and PushManager. Does not check
+ * permission and does not register a service worker.
+ *
+ * @returns Whether Web Push is supported
  */
-export const isPushNotificationSupported = () => !!(window.Notification || 'webkitNotifications' in window);
+export const isPushNotificationSupported = () => 'Notification' in window && 'serviceWorker' in navigator && 'PushManager' in window;
 //# sourceMappingURL=isPushNotificationSupported.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isPushNotificationSupported.js","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAY,EAAE,CACvD,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,qBAAqB,IAAI,MAAM,CAAC,CAAC"}
+{"version":3,"file":"isPushNotificationSupported.js","sourceRoot":"","sources":["../../../src/browser/isPushNotificationSupported.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAY,EAAE,CACvD,cAAc,IAAI,MAAM,IAAI,eAAe,IAAI,SAAS,IAAI,aAAa,IAAI,MAAM,CAAC"}

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

@@ -1,7 +1,6 @@
 /**
- * Check if current browser tab is in focus
- *
- * @returns Boolean indicating if current browser tab is in focus
+ * @deprecated Use {@link isPageVisible}. Same as `!document.hidden`; not window
+ * or tab input focus.
  */
 export declare const isTabFocused: () => boolean;
 //# sourceMappingURL=isTabFocused.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTabFocused.d.ts","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAO,OAA2B,CAAC"}
+{"version":3,"file":"isTabFocused.d.ts","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,YAAY,eAAgB,CAAC"}

package/dist/esm/browser/isTabFocused.js

@@ -1,7 +1,7 @@
+import { isPageVisible } from './isPageVisible.js';
 /**
- * Check if current browser tab is in focus
- *
- * @returns Boolean indicating if current browser tab is in focus
+ * @deprecated Use {@link isPageVisible}. Same as `!document.hidden`; not window
+ * or tab input focus.
  */
-export const isTabFocused = () => !document.hidden;
+export const isTabFocused = isPageVisible;
 //# sourceMappingURL=isTabFocused.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isTabFocused.js","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC"}
+{"version":3,"file":"isTabFocused.js","sourceRoot":"","sources":["../../../src/browser/isTabFocused.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Subscribe to Page Visibility changes
+ *
+ * Uses `visibilitychange` and `document.hidden`. This is not window focus or
+ * blur.
+ *
+ * @param onVisible Called when the page becomes visible
+ * @param onHidden Called when the page becomes hidden
+ * @returns Cleanup function to remove the listener
+ */
+export declare const pageVisibilityListener: (onVisible?: () => void, onHidden?: () => void) => (() => void);
+//# sourceMappingURL=pageVisibilityListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageVisibilityListener.d.ts","sourceRoot":"","sources":["../../../src/browser/pageVisibilityListener.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,IAAI,EACtB,WAAW,MAAM,IAAI,KACpB,CAAC,MAAM,IAAI,CAcb,CAAC"}

package/dist/esm/browser/pageVisibilityListener.js

@@ -0,0 +1,26 @@
+import { isPageVisible } from './isPageVisible.js';
+/**
+ * Subscribe to Page Visibility changes
+ *
+ * Uses `visibilitychange` and `document.hidden`. This is not window focus or
+ * blur.
+ *
+ * @param onVisible Called when the page becomes visible
+ * @param onHidden Called when the page becomes hidden
+ * @returns Cleanup function to remove the listener
+ */
+export const pageVisibilityListener = (onVisible, onHidden) => {
+    const handleVisibilityChange = () => {
+        if (isPageVisible()) {
+            onVisible?.();
+        }
+        else {
+            onHidden?.();
+        }
+    };
+    document.addEventListener('visibilitychange', handleVisibilityChange);
+    return () => {
+        document.removeEventListener('visibilitychange', handleVisibilityChange);
+    };
+};
+//# sourceMappingURL=pageVisibilityListener.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageVisibilityListener.js","sourceRoot":"","sources":["../../../src/browser/pageVisibilityListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,SAAsB,EACtB,QAAqB,EACP,EAAE;IAChB,MAAM,sBAAsB,GAAG,GAAS,EAAE;QACxC,IAAI,aAAa,EAAE,EAAE,CAAC;YACpB,SAAS,EAAE,EAAE,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,QAAQ,EAAE,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;IAEtE,OAAO,GAAG,EAAE;QACV,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC,CAAC"}

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

@@ -11,9 +11,11 @@ export declare const preferLightColorScheme: () => boolean;
  */
 export declare const preferDarkColorScheme: () => boolean;
 /**
- * Check what color scheme (light or dark) is prefered by user
+ * Check what color scheme the user prefers
  *
- * @returns String indicating prefered light color scheme ('light') or dark color scheme ('dark')
+ * Returns `'light'` when `(prefers-color-scheme: light)` matches; otherwise `'dark'`.
+ *
+ * @returns `'light'` or `'dark'`
  */
 export declare const preferColorScheme: () => "light" | "dark";
 //# sourceMappingURL=preferColorScheme.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"preferColorScheme.d.ts","sourceRoot":"","sources":["../../../src/browser/preferColorScheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,OACoB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,OACoB,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,OAAO,GAAG,MACF,CAAC"}
+{"version":3,"file":"preferColorScheme.d.ts","sourceRoot":"","sources":["../../../src/browser/preferColorScheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,OACoB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,OACoB,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAO,OAAO,GAAG,MACF,CAAC"}

package/dist/esm/browser/preferColorScheme.js

@@ -11,9 +11,11 @@ export const preferLightColorScheme = () => !!window.matchMedia('(prefers-color-
  */
 export const preferDarkColorScheme = () => !!window.matchMedia('(prefers-color-scheme: dark)').matches;
 /**
- * Check what color scheme (light or dark) is prefered by user
+ * Check what color scheme the user prefers
  *
- * @returns String indicating prefered light color scheme ('light') or dark color scheme ('dark')
+ * Returns `'light'` when `(prefers-color-scheme: light)` matches; otherwise `'dark'`.
+ *
+ * @returns `'light'` or `'dark'`
  */
 export const preferColorScheme = () => preferLightColorScheme() ? 'light' : 'dark';
 //# sourceMappingURL=preferColorScheme.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"preferColorScheme.js","sourceRoot":"","sources":["../../../src/browser/preferColorScheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAY,EAAE,CAClD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC,OAAO,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,EAAE,CACjD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAqB,EAAE,CACtD,sBAAsB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC"}
+{"version":3,"file":"preferColorScheme.js","sourceRoot":"","sources":["../../../src/browser/preferColorScheme.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAY,EAAE,CAClD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC,OAAO,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,EAAE,CACjD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAqB,EAAE,CACtD,sBAAsB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC"}

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,KAAG,MAetC,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,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"}
+{"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/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) => {
+    const removals = [];
     for (const eventName in listeners) {
         const functionList = (listeners[eventName] instanceof Array ? listeners[eventName] : [listeners[eventName]]);
-        functionList.forEach((listener) => document.addEventListener(eventName, (event) => {
-            const target = event.target;
-            if (!target) {
-                return;
-            }
-            if (!acceptBubbling && target.matches(elementSelector)) {
-                listener.call(this, event);
-            }
-            else if (acceptBubbling && target.closest(elementSelector)) {
-                listener.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,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,CAC/C,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,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;iBAAM,IAAI,cAAc,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7D,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC7B,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

@@ -3,7 +3,7 @@
  *
  * @param element Node element outside which to listen to clicks
  * @param callback Function to trigger when clicked outside
- * @returns void
+ * @returns Cleanup function to remove the listener
  */
-export declare const addClickOutsideListener: (element: HTMLElement, callback: (event?: Event) => void) => 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,GAClC,SAAS,WAAW,EACpB,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAChC,IAQF,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

@@ -3,14 +3,18 @@
  *
  * @param element Node element outside which to listen to clicks
  * @param callback Function to trigger when clicked outside
- * @returns void
+ * @returns Cleanup function to remove the listener
  */
 export const addClickOutsideListener = (element, callback) => {
-    document.addEventListener('click', (event) => {
+    const handleClick = (event) => {
         const target = event.target;
         if (!!target && !element.contains(target)) {
-            callback.call(this, event);
+            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,CACrC,OAAoB,EACpB,QAAiC,EAC3B,EAAE;IACR,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,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,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,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 const addEventListener = (element, listeners) => {

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,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"}
+{"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.map

@@ -1 +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,CAyBnE,CAAC"}
+{"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

@@ -21,11 +21,14 @@ export const copyToClipboard = async (text) => {
         tempTextarea.style.opacity = '0';
         tempTextarea.style.pointerEvents = 'none';
         document.body.appendChild(tempTextarea);
-        tempTextarea.focus();
-        tempTextarea.select();
-        const success = document.execCommand('copy');
-        document.body.removeChild(tempTextarea);
-        return success;
+        try {
+            tempTextarea.focus();
+            tempTextarea.select();
+            return document.execCommand('copy');
+        }
+        finally {
+            document.body.removeChild(tempTextarea);
+        }
     }
     catch {
         return false;

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

@@ -1 +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;QACxC,YAAY,CAAC,KAAK,EAAE,CAAC;QACrB,YAAY,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC"}
+{"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,12 @@
-import type { IExtendingElementProps } from './interfaces/createElement.js';
+import type { TCreateElementNode, TCreateElementPropsFor } from './types/createElement.js';
 /**
- * Method for creating Node element and assigning multiple parameters, event listeners & children in one method call
+ * Method for creating Node element and assigning multiple parameters, event listeners & children in one method call.
+ * A known tag name selects that element's properties, so `input` accepts `type`, `checked`, and `disabled`.
+ * An explicit element type does the same for a string tag: `createElement<HTMLInputElement>(tag, props)`.
  *
  * @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 function createElement<T extends HTMLElement | string>(tagName: T extends HTMLElement ? string : T, props?: TCreateElementPropsFor<T>): TCreateElementNode<T>;
 //# 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,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E;;;;;;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,CAgDF,CAAC"}
+{"version":3,"file":"createElement.d.ts","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,MAAM,EAC1D,OAAO,EAAE,CAAC,SAAS,WAAW,GAAG,MAAM,GAAG,CAAC,EAC3C,KAAK,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAChC,kBAAkB,CAAC,CAAC,CAAC,CAAC"}

package/dist/esm/dom/createElement.js

@@ -1,11 +1,11 @@
 /**
- * Method for creating Node element and assigning multiple parameters, event listeners & children in one method call
+ * Creates the element and assigns properties.
  *
  * @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
  */
-export const createElement = (tagName, props) => {
+export function createElement(tagName, props) {
     const element = document.createElement(tagName);
     if (props) {
         const propsRecord = props;
@@ -51,5 +51,5 @@ export const createElement = (tagName, props) => {
         }
     }
     return element;
-};
+}
 //# sourceMappingURL=createElement.js.map

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,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,OAAuB,CAAC;AACjC,CAAC,CAAC"}
+{"version":3,"file":"createElement.js","sourceRoot":"","sources":["../../../src/dom/createElement.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,KAAwC;IAExC,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"}

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,4 +1,5 @@
 export * from './interfaces/index.js';
+export * from './types/index.js';
 export * from './addAsyncEventListener.js';
 export * from './addClickOutsideListener.js';
 export * from './addEventListener.js';

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,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"}
+{"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/esm/dom/index.js

@@ -1,4 +1,5 @@
 export * from './interfaces/index.js';
+export * from './types/index.js';
 export * from './addAsyncEventListener.js';
 export * from './addClickOutsideListener.js';
 export * from './addEventListener.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","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,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"}
+{"version":3,"file":"index.js","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"}