tool-shack 0.0.42 → 1.0.0

package/dist/cjs/browser/networkStatusListener.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.networkStatusListener = void 0;
+/**
+ * Set callbacks for when browser goes online or offline
+ *
+ * @param onOnline Callback when connection is restored
+ * @param onOffline Callback when connection is lost
+ * @returns Cleanup function to remove event listeners
+ */
+const networkStatusListener = (onOnline, onOffline) => {
+    const handleOnline = () => onOnline?.();
+    const handleOffline = () => onOffline?.();
+    window.addEventListener('online', handleOnline);
+    window.addEventListener('offline', handleOffline);
+    return () => {
+        window.removeEventListener('online', handleOnline);
+        window.removeEventListener('offline', handleOffline);
+    };
+};
+exports.networkStatusListener = networkStatusListener;
+//# sourceMappingURL=networkStatusListener.js.map

package/dist/cjs/browser/networkStatusListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkStatusListener.js","sourceRoot":"","sources":["../../../src/browser/networkStatusListener.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,MAAM,qBAAqB,GAAG,CACnC,QAAqB,EACrB,SAAsB,EACR,EAAE;IAChB,MAAM,YAAY,GAAG,GAAS,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,GAAS,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC;IAEhD,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IAElD,OAAO,GAAG,EAAE;QACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,qBAAqB,yBAchC"}

package/dist/cjs/browser/scrollToElement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollToElement.d.ts","sourceRoot":"","sources":["../../../src/browser/scrollToElement.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,WAAW,EACpB,SAAQ,MAAU,EAClB,eAAc,OAAc,KAC3B,IAEF,CAAC"}
+{"version":3,"file":"scrollToElement.d.ts","sourceRoot":"","sources":["../../../src/browser/scrollToElement.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,WAAW,EAAE,eAAU,EAAE,sBAAmB,KAAG,IAEvF,CAAC"}

package/dist/cjs/browser/scrollToElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrollToElement.js","sourceRoot":"","sources":["../../../src/browser/scrollToElement.ts"],"names":[],"mappings":";;;AAAA,oEAA8D;AAC9D,+DAAyD;AAEzD;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,CAC7B,OAAoB,EACpB,SAAiB,CAAC,EAClB,eAAwB,IAAI,EACtB,EAAE;IACR,IAAA,sCAAgB,EAAC,CAAC,EAAE,IAAA,sCAAgB,EAAC,OAAO,CAAC,CAAC,GAAG,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;AAC5E,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B"}
+{"version":3,"file":"scrollToElement.js","sourceRoot":"","sources":["../../../src/browser/scrollToElement.ts"],"names":[],"mappings":";;;AAAA,oEAA8D;AAC9D,+DAAyD;AAEzD;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,CAAC,OAAoB,EAAE,MAAM,GAAG,CAAC,EAAE,YAAY,GAAG,IAAI,EAAQ,EAAE;IAC7F,IAAA,sCAAgB,EAAC,CAAC,EAAE,IAAA,sCAAgB,EAAC,OAAO,CAAC,CAAC,GAAG,GAAG,MAAM,EAAE,YAAY,CAAC,CAAC;AAC5E,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B"}

package/dist/cjs/browser/scrollToPosition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scrollToPosition.d.ts","sourceRoot":"","sources":["../../../src/browser/scrollToPosition.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,GAAG,MAAM,EACT,GAAG,MAAM,EACT,eAAc,OAAc,EAC5B,SAAQ,MAAM,GAAG,WAAoB,KACpC,IAUF,CAAC"}
+{"version":3,"file":"scrollToPosition.d.ts","sourceRoot":"","sources":["../../../src/browser/scrollToPosition.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,GAAG,MAAM,EACT,GAAG,MAAM,EACT,sBAAmB,EACnB,SAAQ,MAAM,GAAG,WAAoB,KACpC,IAUF,CAAC"}

package/dist/cjs/browser/scrollToPosition.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrollToPosition.js","sourceRoot":"","sources":["../../../src/browser/scrollToPosition.ts"],"names":[],"mappings":";;;AAAA,iFAA2E;AAE3E;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAC9B,CAAS,EACT,CAAS,EACT,eAAwB,IAAI,EAC5B,SAA+B,MAAM,EAC/B,EAAE;IACR,IAAI,YAAY,IAAI,IAAA,wDAAyB,GAAE,EAAE,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC;YACd,GAAG,EAAE,CAAC;YACN,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC;AAfW,QAAA,gBAAgB,oBAe3B"}
+{"version":3,"file":"scrollToPosition.js","sourceRoot":"","sources":["../../../src/browser/scrollToPosition.ts"],"names":[],"mappings":";;;AAAA,iFAA2E;AAE3E;;;;;;;;GAQG;AACI,MAAM,gBAAgB,GAAG,CAC9B,CAAS,EACT,CAAS,EACT,YAAY,GAAG,IAAI,EACnB,SAA+B,MAAM,EAC/B,EAAE;IACR,IAAI,YAAY,IAAI,IAAA,wDAAyB,GAAE,EAAE,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC;YACd,GAAG,EAAE,CAAC;YACN,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC;AAfW,QAAA,gBAAgB,oBAe3B"}

package/dist/cjs/browser/setCookie.d.ts

@@ -0,0 +1,11 @@
+import type { ICookieOptions } from './interfaces/setCookie.js';
+/**
+ * Set a browser cookie
+ *
+ * @param name Cookie name
+ * @param value Cookie value
+ * @param options Cookie options (days, path, domain, secure, sameSite)
+ * @returns void
+ */
+export declare const setCookie: (name: string, value: string, options?: ICookieOptions) => void;
+//# sourceMappingURL=setCookie.d.ts.map

package/dist/cjs/browser/setCookie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setCookie.d.ts","sourceRoot":"","sources":["../../../src/browser/setCookie.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,UAAU,cAAc,KAAG,IAuBjF,CAAC"}

package/dist/cjs/browser/setCookie.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCookie = void 0;
+/**
+ * Set a browser cookie
+ *
+ * @param name Cookie name
+ * @param value Cookie value
+ * @param options Cookie options (days, path, domain, secure, sameSite)
+ * @returns void
+ */
+const setCookie = (name, value, options) => {
+    let cookieString = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+    if (options?.days !== undefined) {
+        const expires = new Date(Date.now() + options.days * 86400000).toUTCString();
+        cookieString += `; expires=${expires}`;
+    }
+    cookieString += `; path=${options?.path ?? '/'}`;
+    if (options?.domain) {
+        cookieString += `; domain=${options.domain}`;
+    }
+    if (options?.secure) {
+        cookieString += '; secure';
+    }
+    if (options?.sameSite) {
+        cookieString += `; samesite=${options.sameSite}`;
+    }
+    document.cookie = cookieString;
+};
+exports.setCookie = setCookie;
+//# sourceMappingURL=setCookie.js.map

package/dist/cjs/browser/setCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setCookie.js","sourceRoot":"","sources":["../../../src/browser/setCookie.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACI,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,OAAwB,EAAQ,EAAE;IACvF,IAAI,YAAY,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IAE9E,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7E,YAAY,IAAI,aAAa,OAAO,EAAE,CAAC;IACzC,CAAC;IAED,YAAY,IAAI,UAAU,OAAO,EAAE,IAAI,IAAI,GAAG,EAAE,CAAC;IAEjD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,IAAI,YAAY,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,IAAI,UAAU,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,YAAY,IAAI,cAAc,OAAO,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;IAED,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC;AACjC,CAAC,CAAC;AAvBW,QAAA,SAAS,aAuBpB"}

package/dist/cjs/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;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,IAAI,KAAG,MAetC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"dateAsIso.js","sourceRoot":"","sources":["../../../src/dateTime/dateAsIso.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACI,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;AAfW,QAAA,SAAS,aAepB;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;;;;;GAKG;AACI,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;AAfW,QAAA,SAAS,aAepB;AAEF,MAAM,SAAS,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/dist/cjs/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/cjs/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/cjs/dateTime/index.js

@@ -3,5 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./interfaces/index.js"), exports);
 tslib_1.__exportStar(require("./dateAsIso.js"), exports);
+tslib_1.__exportStar(require("./isSameDay.js"), exports);
 tslib_1.__exportStar(require("./parseDuration.js"), exports);
+tslib_1.__exportStar(require("./timeAgo.js"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AAEtC,yDAA+B;AAC/B,6DAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dateTime/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AAEtC,yDAA+B;AAC/B,yDAA+B;AAC/B,6DAAmC;AACnC,uDAA6B"}

package/dist/cjs/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/cjs/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/cjs/dateTime/isSameDay.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSameDay = void 0;
+/**
+ * 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
+ */
+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());
+};
+exports.isSameDay = isSameDay;
+//# sourceMappingURL=isSameDay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"isSameDay.js","sourceRoot":"","sources":["../../../src/dateTime/isSameDay.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACI,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;AAZW,QAAA,SAAS,aAYpB"}

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

@@ -10,18 +10,18 @@ exports.addAsyncEventListener = void 0;
  * @returns void
  */
 const addAsyncEventListener = (elementSelector, listeners, acceptBubbling = true) => {
-    for (let eventName in listeners) {
+    for (const eventName in listeners) {
         const functionList = (listeners[eventName] instanceof Array ? listeners[eventName] : [listeners[eventName]]);
-        functionList.forEach((fn) => document.addEventListener(eventName, (event) => {
+        functionList.forEach((listener) => document.addEventListener(eventName, (event) => {
             const target = event.target;
             if (!target) {
                 return;
             }
             if (!acceptBubbling && target.matches(elementSelector)) {
-                fn.call(this, event);
+                listener.call(this, event);
             }
             else if (acceptBubbling && target.closest(elementSelector)) {
-                fn.call(this, event);
+                listener.call(this, event);
             }
         }));
     }

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,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;AAzBW,QAAA,qBAAqB,yBAyBhC"}

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
+ * @param callback Function to trigger when clicked outside
  * @returns void
  */
-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,IAQF,CAAC"}

package/dist/cjs/dom/addClickOutsideListener.js

@@ -5,14 +5,14 @@ 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
+ * @param callback Function to trigger when clicked outside
  * @returns void
  */
-const addClickOutsideListener = (element, fn) => {
+const addClickOutsideListener = (element, callback) => {
     document.addEventListener('click', (event) => {
         const target = event.target;
         if (!!target && !element.contains(target)) {
-            fn.call(this);
+            callback.call(this, event);
         }
     });
 };

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,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;AAXW,QAAA,uBAAuB,2BAWlC"}

package/dist/cjs/dom/addEventListener.js

@@ -12,10 +12,10 @@ 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;;;;;;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,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,CAyBnE,CAAC"}

package/dist/cjs/dom/copyToClipboard.js

@@ -0,0 +1,38 @@
+"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);
+        tempTextarea.focus();
+        tempTextarea.select();
+        const success = document.execCommand('copy');
+        document.body.removeChild(tempTextarea);
+        return success;
+    }
+    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;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;AAzBW,QAAA,eAAe,mBAyB1B"}

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

@@ -1,4 +1,4 @@
-import { IExtendingElementProps } from './interfaces/createElement.js';
+import type { IExtendingElementProps } from './interfaces/createElement.js';
 /**
  * Method for creating Node element and assigning multiple parameters, event listeners & children in one method call
  *

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,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"}

package/dist/cjs/dom/createElement.js

@@ -11,8 +11,9 @@ exports.createElement = void 0;
 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,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;AAnDW,QAAA,aAAa,iBAmDxB"}

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

@@ -4,7 +4,12 @@ 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;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"}

package/dist/cjs/dom/index.js

@@ -7,7 +7,12 @@ 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("./copyToClipboard.js"), exports);
 tslib_1.__exportStar(require("./createElement.js"), exports);
 tslib_1.__exportStar(require("./fireEvent.js"), exports);
 tslib_1.__exportStar(require("./getElementOffset.js"), exports);
+tslib_1.__exportStar(require("./isInViewport.js"), exports);
+tslib_1.__exportStar(require("./toggleFullscreen.js"), exports);
+tslib_1.__exportStar(require("./toggleFullscreenWithFallback.js"), exports);
+tslib_1.__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,gEAAsC;AAEtC,qEAA2C;AAC3C,uEAA6C;AAC7C,gEAAsC;AACtC,2DAAiC;AACjC,4DAAkC;AAClC,+DAAqC;AACrC,6DAAmC;AACnC,yDAA+B;AAC/B,gEAAsC;AACtC,4DAAkC;AAClC,gEAAsC;AACtC,4EAAkD;AAClD,8DAAoC"}

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

@@ -2,4 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./createElement.js"), exports);
+tslib_1.__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,6DAAmC;AACnC,4EAAkD"}

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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Toggle fullscreen mode for a given element or document root
+ *
+ * @param element Target HTMLElement to toggle fullscreen for (defaults to documentElement)
+ * @returns Promise resolving when fullscreen state transition completes
+ */
+export declare const toggleFullscreen: (element?: HTMLElement) => Promise<void>;
+//# sourceMappingURL=toggleFullscreen.d.ts.map