@byloth/core 1.1.1 → 1.1.2

package/dist/core.js

@@ -1,14 +1,16 @@
-var u = Object.defineProperty;
-var h = (s, e, t) => e in s ? u(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
-var n = (s, e, t) => (h(s, typeof e != "symbol" ? e + "" : e, t), t);
-class f {
-  constructor(e) {
+var h = Object.defineProperty;
+var a = (s, e, t) => e in s ? h(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
+var n = (s, e, t) => (a(s, typeof e != "symbol" ? e + "" : e, t), t);
+class d {
+  constructor(e, t) {
     n(this, "_resolve");
     n(this, "_reject");
     n(this, "_promise");
-    this._promise = new Promise((t, r) => {
-      this._resolve = t, this._reject = r, e == null || e(t, r);
+    let i, r;
+    const c = new Promise((u, l) => {
+      i = u, r = l;
     });
+    this._promise = c.then(e, t), this._resolve = i, this._reject = r;
   }
   resolve(e) {
     this._resolve(e);
@@ -36,38 +38,38 @@ class o extends Error {
     }
     return new o(`${e}`);
   }
-  constructor(e, t, r = "Exception") {
-    super(e), this.cause = t, this.name = r, t && (t instanceof Error ? this.stack += `
+  constructor(e, t, i = "Exception") {
+    super(e), this.cause = t, this.name = i, t && (t instanceof Error ? this.stack += `
 
 Caused by ${t.stack}` : this.stack += `
 
 Caused by ${t}`);
   }
 }
-class _ {
+class m {
   constructor(e = !0) {
     n(this, "_preferPersistence");
     n(this, "_volatile");
     n(this, "_persistent");
     this._preferPersistence = e, this._volatile = window.sessionStorage, this._persistent = window.localStorage;
   }
-  _get(e, t, r) {
-    const i = e.getItem(t);
-    if (i)
+  _get(e, t, i) {
+    const r = e.getItem(t);
+    if (r)
       try {
-        return JSON.parse(i);
+        return JSON.parse(r);
       } catch {
         e.removeItem(t);
       }
-    return r;
+    return i;
   }
-  _set(e, t, r) {
-    const i = JSON.stringify(r);
-    i ? e.setItem(t, i) : e.removeItem(t);
+  _set(e, t, i) {
+    const r = JSON.stringify(i);
+    r ? e.setItem(t, r) : e.removeItem(t);
   }
-  get(e, t, r = this._preferPersistence) {
-    const i = r ? this._persistent : this._volatile;
-    return this._get(i, e, t);
+  get(e, t, i = this._preferPersistence) {
+    const r = i ? this._persistent : this._volatile;
+    return this._get(r, e, t);
   }
   recall(e, t) {
     return this._get(this._volatile, e, t);
@@ -128,9 +130,9 @@ class _ {
    * @param newValue The new value to set.
    * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.
    */
-  set(e, t, r = this._preferPersistence) {
-    const i = r ? this._persistent : this._volatile;
-    this._set(i, e, t);
+  set(e, t, i = this._preferPersistence) {
+    const r = i ? this._persistent : this._volatile;
+    this._set(r, e, t);
   }
   /**
    * Sets the value with the specified name in the volatile `sessionStorage`.
@@ -177,7 +179,7 @@ class _ {
     this._volatile.removeItem(e), this._persistent.removeItem(e);
   }
 }
-class d {
+class v {
   constructor() {
     n(this, "_subscribers");
     this._subscribers = [];
@@ -195,32 +197,32 @@ class d {
     return this._subscribers.slice().map((t) => t(...e));
   }
 }
-async function m(s) {
+async function g(s) {
   return new Promise((e, t) => setTimeout(e, s));
 }
-async function g() {
+async function p() {
   return new Promise((s, e) => requestAnimationFrame(() => s()));
 }
-var l = /* @__PURE__ */ ((s) => (s[s.Second = 1e3] = "Second", s[s.Minute = 6e4] = "Minute", s[s.Hour = 36e5] = "Hour", s[s.Day = 864e5] = "Day", s[s.Week = 6048e5] = "Week", s[s.Month = 2592e6] = "Month", s[s.Year = 31536e6] = "Year", s))(l || {});
-function v(s, e, t = 864e5) {
+var f = /* @__PURE__ */ ((s) => (s[s.Second = 1e3] = "Second", s[s.Minute = 6e4] = "Minute", s[s.Hour = 36e5] = "Hour", s[s.Day = 864e5] = "Day", s[s.Week = 6048e5] = "Week", s[s.Month = 2592e6] = "Month", s[s.Year = 31536e6] = "Year", s))(f || {});
+function b(s, e, t = 864e5) {
   return Math.floor((e.getTime() - s.getTime()) / t);
 }
-function* p(s, e, t = 864e5) {
-  const r = e.getTime();
-  let i = s.getTime();
-  for (; i < r; )
-    yield new Date(i), i += t;
+function* w(s, e, t = 864e5) {
+  const i = e.getTime();
+  let r = s.getTime();
+  for (; r < i; )
+    yield new Date(r), r += t;
 }
-function b(s, e = 864e5) {
+function y(s, e = 864e5) {
   return new Date(Math.floor(s.getTime() / e) * e);
 }
-async function w(s, e = "text/javascript") {
-  return new Promise((t, r) => {
-    const i = document.createElement("script");
-    i.async = !0, i.defer = !0, i.src = s, i.type = e, i.onload = () => t(), i.onerror = () => r(), document.body.appendChild(i);
+async function I(s, e = "text/javascript") {
+  return new Promise((t, i) => {
+    const r = document.createElement("script");
+    r.async = !0, r.defer = !0, r.src = s, r.type = e, r.onload = () => t(), r.onerror = () => i(), document.body.appendChild(r);
   });
 }
-function y(s) {
+function M(s) {
   if (Array.isArray(s))
     return s.length;
   let e = 0;
@@ -228,67 +230,67 @@ function y(s) {
     e += 1;
   return e;
 }
-function* I(s, e, t = 1) {
+function* S(s, e, t = 1) {
   e === void 0 && (e = s, s = 0), s > e && (t = t ?? -1);
-  for (let r = s; r < e; r += t)
-    yield r;
+  for (let i = s; i < e; i += t)
+    yield i;
 }
-function M(s) {
+function k(s) {
   let e = 0;
   for (const t of s)
     e += t;
   return e;
 }
-function S(s) {
+function P(s) {
   return [...new Set(s)];
 }
-function k(s) {
+function j(s) {
   let e = 0;
   for (let t = 0; t < s.length; t++) {
-    const r = s.charCodeAt(t);
-    e = (e << 5) - e + r, e |= 0;
+    const i = s.charCodeAt(t);
+    e = (e << 5) - e + i, e |= 0;
   }
   return e;
 }
-function P(s = 1, e, t) {
+function T(s = 1, e, t) {
   if (e === void 0 && (e = s, s = 0), s === e)
     return s;
-  let r;
+  let i;
   if (t === !0)
-    r = (i) => i;
+    i = (r) => r;
   else if (t === void 0)
-    Math.abs(e - s) <= 1 ? r = (i) => i : r = Math.floor;
+    Math.abs(e - s) <= 1 ? i = (r) => r : i = Math.floor;
   else if (t === !1)
-    r = Math.floor;
+    i = Math.floor;
   else {
-    const i = 10 ** t;
-    r = (c) => Math.floor(c * i) / i;
+    const r = 10 ** t;
+    i = (c) => Math.floor(c * r) / r;
   }
-  return r(Math.random() * (e - s) + s);
+  return i(Math.random() * (e - s) + s);
 }
-function T(s) {
+function x(s) {
   return `${s.charAt(0).toUpperCase()}${s.slice(1)}`;
 }
-const j = "1.1.1";
+const A = "1.1.2";
 export {
-  l as DateUnit,
-  f as DeferredPromise,
+  f as DateUnit,
+  d as DeferredPromise,
   o as Exception,
-  _ as JsonStorage,
-  d as Subscribers,
-  j as VERSION,
-  T as capitalize,
-  y as count,
-  v as dateDifference,
-  p as dateRange,
-  b as dateRound,
-  m as delay,
-  k as hash,
-  w as loadScript,
-  g as nextAnimationFrame,
-  P as random,
-  I as range,
-  M as sum,
-  S as unique
+  m as JsonStorage,
+  v as Subscribers,
+  A as VERSION,
+  x as capitalize,
+  M as count,
+  b as dateDifference,
+  w as dateRange,
+  y as dateRound,
+  g as delay,
+  j as hash,
+  I as loadScript,
+  p as nextAnimationFrame,
+  T as random,
+  S as range,
+  k as sum,
+  P as unique
 };
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/subscribers.ts","../src/utils/async.ts","../src/utils/date.ts","../src/utils/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type {\n    PromiseExecutor,\n    PromiseResolver,\n    PromiseRejecter,\n    FulfilledHandler,\n    RejectedHandler,\n    MaybePromise\n\n} from \"../types.js\";\n\nexport default class DeferredPromise<T>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter;\n\n    protected _promise: Promise<T>;\n\n    public constructor(executor?: PromiseExecutor<T>)\n    {\n        this._promise = new Promise((resolve, reject) =>\n        {\n            this._resolve = resolve;\n            this._reject = reject;\n\n            executor?.(resolve, reject);\n        });\n    }\n\n    public resolve(value: MaybePromise<T>)\n    {\n        this._resolve(value);\n    }\n    public reject(reason: unknown)\n    {\n        this._reject(reason);\n    }\n\n    public then<F = T, R = never>(onFulfilled?: FulfilledHandler<T, F>, onRejected?: RejectedHandler<unknown, R>)\n        : Promise<F | R>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | R>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: () => void): Promise<T>\n    {\n        return this._promise.finally(onFinally);\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","import Exception from \"./exception.js\";\n\nexport default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>\n{\n    protected _subscribers: T[];\n\n    public constructor()\n    {\n        this._subscribers = [];\n    }\n\n    public add(subscriber: T): void\n    {\n        this._subscribers.push(subscriber);\n    }\n    public remove(subscriber: T): void\n    {\n        const index = this._subscribers.indexOf(subscriber);\n        if (index < 0)\n        {\n            throw new Exception(\"Unable to remove the requested subscriber. It was not found.\");\n        }\n\n        this._subscribers.splice(index, 1);\n    }\n\n    public call(...args: P): R[]\n    {\n        return this._subscribers\n            .slice()\n            .map((subscriber) => subscriber(...args));\n    }\n}\n","export async function delay(milliseconds: number): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => setTimeout(resolve, milliseconds));\n}\n\nexport async function nextAnimationFrame(): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => requestAnimationFrame(() => resolve()));\n}\n","export enum DateUnit\n{\n    Second = 1000,\n    Minute = 60 * Second,\n    Hour = 60 * Minute,\n    Day = 24 * Hour,\n    Week = 7 * Day,\n    Month = 30 * Day,\n    Year = 365 * Day\n}\n\nexport function dateDifference(start: Date, end: Date, unit = DateUnit.Day)\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function* dateRange(start: Date, end: Date, offset = DateUnit.Day)\n{\n    const endTime = end.getTime();\n\n    let unixTime: number = start.getTime();\n    while (unixTime < endTime)\n    {\n        yield new Date(unixTime);\n\n        unixTime += offset;\n    }\n}\n\nexport function dateRound(date: Date, unit = DateUnit.Day)\n{\n    return new Date(Math.floor(date.getTime() / unit) * unit);\n}\n","export async function loadScript(scriptUrl: string, scriptType = \"text/javascript\"): Promise<void>\n{\n    return new Promise<void>((resolve, reject) =>\n    {\n        const script = document.createElement(\"script\");\n\n        script.async = true;\n        script.defer = true;\n        script.src = scriptUrl;\n        script.type = scriptType;\n\n        script.onload = () => resolve();\n        script.onerror = () => reject();\n\n        document.body.appendChild(script);\n    });\n}\n","export function count<T>(elements: Iterable<T>): number\n{\n    if (Array.isArray(elements)) { return elements.length; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function range(end: number): Generator<number, void>;\nexport function range(start: number, end: number): Generator<number, void>;\nexport function range(start: number, end: number, step: number): Generator<number, void>;\nexport function* range(start: number, end?: number, step = 1): Generator<number, void>\n{\n    if (end === undefined)\n    {\n        end = start;\n        start = 0;\n    }\n\n    if (start > end) { step = step ?? -1; }\n\n    for (let index = start; index < end; index += step) { yield index; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n\nexport function random(): number;\nexport function random(max: number): number;\nexport function random(min: number, max: number): number;\nexport function random(min: number, max: number, isDecimal: boolean): number;\nexport function random(min: number, max: number, digits: number): number;\nexport function random(min: number = 1, max?: number, decimals?: boolean | number): number\n{\n    if (max === undefined)\n    {\n        max = min;\n        min = 0;\n    }\n\n    if (min === max)\n    {\n        return min;\n    }\n\n    let rounder: (value: number) => number;\n\n    if (decimals === true)\n    {\n        rounder = (value) => value;\n    }\n    else if (decimals === undefined)\n    {\n        if (Math.abs(max - min) <= 1)\n        {\n            rounder = (value) => value;\n        }\n        else\n        {\n            rounder = Math.floor;\n        }\n    }\n    else if (decimals === false)\n    {\n        rounder = Math.floor;\n    }\n    else\n    {\n        const digits = 10 ** decimals;\n\n        rounder = (value) => Math.floor(value * digits) / digits;\n    }\n\n    return rounder(Math.random() * (max - min) + min);\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.1.1\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models/index.js\";\nexport {\n    capitalize,\n    count,\n    delay,\n    dateDifference,\n    dateRange,\n    dateRound,\n    DateUnit,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    random,\n    range,\n    sum,\n    unique\n\n} from \"./utils/index.js\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types.js\";\n"],"names":["DeferredPromise","executor","__publicField","resolve","reject","value","reason","onFulfilled","onRejected","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","sum","_sum","unique","hash","i","char","random","min","max","decimals","rounder","digits","capitalize","VERSION"],"mappings":";;;AAUA,MAAqBA,EACrB;AAAA,EAMW,YAAYC,GACnB;AANU,IAAAC,EAAA;AACA,IAAAA,EAAA;AAEA,IAAAA,EAAA;AAIN,SAAK,WAAW,IAAI,QAAQ,CAACC,GAASC,MACtC;AACI,WAAK,WAAWD,GAChB,KAAK,UAAUC,GAEfH,KAAA,QAAAA,EAAWE,GAASC;AAAA,IAAM,CAC7B;AAAA,EACL;AAAA,EAEO,QAAQC,GACf;AACI,SAAK,SAASA,CAAK;AAAA,EACvB;AAAA,EACO,OAAOC,GACd;AACI,SAAK,QAAQA,CAAM;AAAA,EACvB;AAAA,EAEO,KAAuBC,GAAsCC,GAEpE;AACI,WAAO,KAAK,SAAS,KAAKD,GAAaC,CAAU;AAAA,EACrD;AAAA,EACO,MAAiBA,GACxB;AACW,WAAA,KAAK,SAAS,MAAMA,CAAU;AAAA,EACzC;AAAA,EACO,QAAQC,GACf;AACW,WAAA,KAAK,SAAS,QAAQA,CAAS;AAAA,EAC1C;AACJ;AClDA,MAAqBC,UAAkB,MACvC;AAAA,EACI,OAAc,YAAYC,GAC1B;AACI,QAAIA,aAAiBD;AAEV,aAAAC;AAEX,QAAIA,aAAiB,OACrB;AACI,YAAMC,IAAM,IAAIF,EAAUC,EAAM,OAAO;AAEvC,aAAAC,EAAI,QAAQD,EAAM,OAClBC,EAAI,OAAOD,EAAM,MAEVC;AAAA,IACX;AAEA,WAAO,IAAIF,EAAU,GAAGC,CAAK,EAAE;AAAA,EACnC;AAAA,EAEO,YAAYE,GAAiBC,GAAiBC,IAAO,aAC5D;AACI,UAAMF,CAAO,GAEb,KAAK,QAAQC,GACb,KAAK,OAAOC,GAERD,MAEIA,aAAiB,QAEjB,KAAK,SAAS;AAAA;AAAA,YAAiBA,EAAM,KAAK,KAI1C,KAAK,SAAS;AAAA;AAAA,YAAiBA,CAAK;AAAA,EAGhD;AACJ;AChCA,MAAqBE,EACrB;AAAA,EAMW,YAAYC,IAAoB,IACvC;AANU,IAAAf,EAAA;AAEA,IAAAA,EAAA;AACA,IAAAA,EAAA;AAIN,SAAK,qBAAqBe,GAE1B,KAAK,YAAY,OAAO,gBACxB,KAAK,cAAc,OAAO;AAAA,EAC9B;AAAA,EAKU,KAAQC,GAAkBC,GAAsBC,GAC1D;AACU,UAAAC,IAAgBH,EAAQ,QAAQC,CAAY;AAClD,QAAIE;AAGA,UAAA;AACW,eAAA,KAAK,MAAMA,CAAa;AAAA,cAGnC;AASI,QAAAH,EAAQ,WAAWC,CAAY;AAAA,MACnC;AAGG,WAAAC;AAAA,EACX;AAAA,EACU,KAAQF,GAAkBC,GAAsBG,GAC1D;AACU,UAAAC,IAAe,KAAK,UAAUD,CAAQ;AAC5C,IAAIC,IAEQL,EAAA,QAAQC,GAAcI,CAAY,IAI1CL,EAAQ,WAAWC,CAAY;AAAA,EAEvC;AAAA,EAcO,IAAOA,GAAsBC,GAAkBI,IAAa,KAAK,oBACxE;AACI,UAAMN,IAAUM,IAAa,KAAK,cAAc,KAAK;AAErD,WAAO,KAAK,KAAQN,GAASC,GAAcC,CAAY;AAAA,EAC3D;AAAA,EAYO,OAAUD,GAAsBC,GACvC;AACI,WAAO,KAAK,KAAQ,KAAK,WAAWD,GAAcC,CAAY;AAAA,EAClE;AAAA,EAaO,SAAYD,GAAsBC,GACzC;AACI,WAAO,KAAK,OAAUD,CAAY,KAAK,KAAK,KAAQA,GAAcC,CAAY;AAAA,EAClF;AAAA,EAYO,KAAQD,GAAsBC,GACrC;AACI,WAAO,KAAK,KAAQ,KAAK,aAAaD,GAAcC,CAAY;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,IAAID,GAAsBK,GACjC;AAGW,YAFSA,IAAa,KAAK,cAAc,KAAK,WAEtC,QAAQL,CAAY,MAAM;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,MAAMA,GACb;AACI,WAAO,KAAK,UAAU,QAAQA,CAAY,MAAM;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,KAAKA,GACZ;AACI,WAAO,KAAK,MAAMA,CAAY,KAAK,KAAK,OAAOA,CAAY;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,OAAOA,GACd;AACI,WAAO,KAAK,YAAY,QAAQA,CAAY,MAAM;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,IAAOA,GAAsBG,GAAcE,IAAa,KAAK,oBACpE;AACI,UAAMN,IAAUM,IAAa,KAAK,cAAc,KAAK;AAEhD,SAAA,KAAQN,GAASC,GAAcG,CAAQ;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,SAAYH,GAAsBG,GACzC;AACI,SAAK,KAAQ,KAAK,WAAWH,GAAcG,CAAQ;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,MAASH,GAAsBG,GACtC;AACI,SAAK,KAAQ,KAAK,aAAaH,GAAcG,CAAQ;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,OAAOH,GACd;AACS,SAAA,UAAU,WAAWA,CAAY;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,MAAMA,GACb;AACS,SAAA,YAAY,WAAWA,CAAY;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,MAAMA,GACb;AACS,SAAA,UAAU,WAAWA,CAAY,GACjC,KAAA,YAAY,WAAWA,CAAY;AAAA,EAC5C;AACJ;ACjPA,MAAqBM,EACrB;AAAA,EAGW,cACP;AAHU,IAAAvB,EAAA;AAIN,SAAK,eAAe;EACxB;AAAA,EAEO,IAAIwB,GACX;AACS,SAAA,aAAa,KAAKA,CAAU;AAAA,EACrC;AAAA,EACO,OAAOA,GACd;AACI,UAAMC,IAAQ,KAAK,aAAa,QAAQD,CAAU;AAClD,QAAIC,IAAQ;AAEF,YAAA,IAAIjB,EAAU,8DAA8D;AAGjF,SAAA,aAAa,OAAOiB,GAAO,CAAC;AAAA,EACrC;AAAA,EAEO,QAAQC,GACf;AACW,WAAA,KAAK,aACP,QACA,IAAI,CAACF,MAAeA,EAAW,GAAGE,CAAI,CAAC;AAAA,EAChD;AACJ;AChCA,eAAsBC,EAAMC,GAC5B;AACW,SAAA,IAAI,QAAc,CAAC3B,GAASC,MAAW,WAAWD,GAAS2B,CAAY,CAAC;AACnF;AAEA,eAAsBC,IACtB;AACW,SAAA,IAAI,QAAc,CAAC5B,GAASC,MAAW,sBAAsB,MAAMD,EAAS,CAAA,CAAC;AACxF;ACRY,IAAA6B,sBAAAA,OAERA,EAAAA,EAAA,SAAS,GAAT,IAAA,UACAA,EAAAA,EAAA,SAAS,GAAT,IAAA,UACAA,EAAAA,EAAA,OAAO,IAAP,IAAA,QACAA,EAAAA,EAAA,MAAM,KAAN,IAAA,OACAA,EAAAA,EAAA,OAAO,MAAP,IAAA,QACAA,EAAAA,EAAA,QAAQ,MAAR,IAAA,SACAA,EAAAA,EAAA,OAAO,OAAP,IAAA,QARQA,IAAAA,KAAA,CAAA,CAAA;AAWL,SAASC,EAAeC,GAAaC,GAAWC,IAAO,OAC9D;AACW,SAAA,KAAK,OAAOD,EAAI,YAAYD,EAAM,aAAaE,CAAI;AAC9D;AAEO,UAAUC,EAAUH,GAAaC,GAAWG,IAAS,OAC5D;AACU,QAAAC,IAAUJ,EAAI;AAEhB,MAAAK,IAAmBN,EAAM;AAC7B,SAAOM,IAAWD;AAER,UAAA,IAAI,KAAKC,CAAQ,GAEXA,KAAAF;AAEpB;AAEgB,SAAAG,EAAUC,GAAYN,IAAO,OAC7C;AACW,SAAA,IAAI,KAAK,KAAK,MAAMM,EAAK,YAAYN,CAAI,IAAIA,CAAI;AAC5D;AChCsB,eAAAO,EAAWC,GAAmBC,IAAa,mBACjE;AACI,SAAO,IAAI,QAAc,CAAC1C,GAASC,MACnC;AACU,UAAA0C,IAAS,SAAS,cAAc,QAAQ;AAE9C,IAAAA,EAAO,QAAQ,IACfA,EAAO,QAAQ,IACfA,EAAO,MAAMF,GACbE,EAAO,OAAOD,GAEPC,EAAA,SAAS,MAAM3C,KACf2C,EAAA,UAAU,MAAM1C,KAEd,SAAA,KAAK,YAAY0C,CAAM;AAAA,EAAA,CACnC;AACL;AChBO,SAASC,EAASC,GACzB;AACQ,MAAA,MAAM,QAAQA,CAAQ;AAAK,WAAOA,EAAS;AAE/C,MAAIC,IAAS;AACb,aAAWC,KAAKF;AAAsB,IAAAC,KAAA;AAE/B,SAAAA;AACX;AAKO,UAAUE,EAAMjB,GAAeC,GAAciB,IAAO,GAC3D;AACI,EAAIjB,MAAQ,WAEFA,IAAAD,GACEA,IAAA,IAGRA,IAAQC,MAAOiB,IAAOA,KAAQ;AAElC,WAASzB,IAAQO,GAAOP,IAAQQ,GAAKR,KAASyB;AAAc,UAAAzB;AAChE;AAEO,SAAS0B,EAAsBL,GACtC;AACI,MAAIM,IAAO;AACX,aAAWjD,KAAS2C;AAAoB,IAAAM,KAAAjD;AAEjC,SAAAiD;AACX;AAEO,SAASC,EAAUP,GAC1B;AACI,SAAO,CAAC,GAAG,IAAI,IAAIA,CAAQ,CAAC;AAChC;ACrCO,SAASQ,EAAKnD,GACrB;AACI,MAAImD,IAAO;AACX,WAASC,IAAI,GAAGA,IAAIpD,EAAM,QAAQoD,KAClC;AACU,UAAAC,IAAOrD,EAAM,WAAWoD,CAAC;AAC/BD,IAAAA,KAASA,KAAQ,KAAKA,IAAQE,GAC9BF,KAAQ;AAAA,EACZ;AAEOA,SAAAA;AACX;AAOO,SAASG,EAAOC,IAAc,GAAGC,GAAcC,GACtD;AAOI,MANID,MAAQ,WAEFA,IAAAD,GACAA,IAAA,IAGNA,MAAQC;AAED,WAAAD;AAGP,MAAAG;AAEJ,MAAID,MAAa;AAEb,IAAAC,IAAU,CAAC1D,MAAUA;AAAA,WAEhByD,MAAa;AAElB,IAAI,KAAK,IAAID,IAAMD,CAAG,KAAK,IAEvBG,IAAU,CAAC1D,MAAUA,IAIrB0D,IAAU,KAAK;AAAA,WAGdD,MAAa;AAElB,IAAAC,IAAU,KAAK;AAAA,OAGnB;AACI,UAAMC,IAAS,MAAMF;AAErB,IAAAC,IAAU,CAAC1D,MAAU,KAAK,MAAMA,IAAQ2D,CAAM,IAAIA;AAAA,EACtD;AAEA,SAAOD,EAAQ,KAAK,OAAA,KAAYF,IAAMD,KAAOA,CAAG;AACpD;AC5DO,SAASK,EAAW5D,GAC3B;AACW,SAAA,GAAGA,EAAM,OAAO,CAAC,EAAE,aAAa,GAAGA,EAAM,MAAM,CAAC,CAAC;AAC5D;ACHO,MAAM6D,IAAU;"}
+{"version":3,"file":"core.js","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/subscribers.ts","../src/utils/async.ts","../src/utils/date.ts","../src/utils/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type { PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler, MaybePromise } from \"../types.js\";\n\nexport default class DeferredPromise<T, E = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter;\n\n    protected _promise: Promise<T | E>;\n\n    public constructor(onFulfilled?: FulfilledHandler<unknown, T>, onRejected?: RejectedHandler<unknown, E>)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter;\n\n        const _promise = new Promise<T | E>((resolve, reject) =>\n        {\n            _resolve = resolve;\n            _reject = reject;\n        });\n\n        this._promise = _promise.then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public resolve(value: MaybePromise<T>)\n    {\n        this._resolve(value);\n    }\n    public reject(reason: unknown)\n    {\n        this._reject(reason);\n    }\n\n    public then<F = T | E, R = never>(\n        onFulfilled?: FulfilledHandler<T | E, F>,\n        onRejected?: RejectedHandler<unknown, R>): Promise<F | R>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | E | R>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: () => void): Promise<T | E>\n    {\n        return this._promise.finally(onFinally);\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","import Exception from \"./exception.js\";\n\nexport default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>\n{\n    protected _subscribers: T[];\n\n    public constructor()\n    {\n        this._subscribers = [];\n    }\n\n    public add(subscriber: T): void\n    {\n        this._subscribers.push(subscriber);\n    }\n    public remove(subscriber: T): void\n    {\n        const index = this._subscribers.indexOf(subscriber);\n        if (index < 0)\n        {\n            throw new Exception(\"Unable to remove the requested subscriber. It was not found.\");\n        }\n\n        this._subscribers.splice(index, 1);\n    }\n\n    public call(...args: P): R[]\n    {\n        return this._subscribers\n            .slice()\n            .map((subscriber) => subscriber(...args));\n    }\n}\n","export async function delay(milliseconds: number): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => setTimeout(resolve, milliseconds));\n}\n\nexport async function nextAnimationFrame(): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => requestAnimationFrame(() => resolve()));\n}\n","export enum DateUnit\n{\n    Second = 1000,\n    Minute = 60 * Second,\n    Hour = 60 * Minute,\n    Day = 24 * Hour,\n    Week = 7 * Day,\n    Month = 30 * Day,\n    Year = 365 * Day\n}\n\nexport function dateDifference(start: Date, end: Date, unit = DateUnit.Day)\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function* dateRange(start: Date, end: Date, offset = DateUnit.Day)\n{\n    const endTime = end.getTime();\n\n    let unixTime: number = start.getTime();\n    while (unixTime < endTime)\n    {\n        yield new Date(unixTime);\n\n        unixTime += offset;\n    }\n}\n\nexport function dateRound(date: Date, unit = DateUnit.Day)\n{\n    return new Date(Math.floor(date.getTime() / unit) * unit);\n}\n","export async function loadScript(scriptUrl: string, scriptType = \"text/javascript\"): Promise<void>\n{\n    return new Promise<void>((resolve, reject) =>\n    {\n        const script = document.createElement(\"script\");\n\n        script.async = true;\n        script.defer = true;\n        script.src = scriptUrl;\n        script.type = scriptType;\n\n        script.onload = () => resolve();\n        script.onerror = () => reject();\n\n        document.body.appendChild(script);\n    });\n}\n","export function count<T>(elements: Iterable<T>): number\n{\n    if (Array.isArray(elements)) { return elements.length; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function range(end: number): Generator<number, void>;\nexport function range(start: number, end: number): Generator<number, void>;\nexport function range(start: number, end: number, step: number): Generator<number, void>;\nexport function* range(start: number, end?: number, step = 1): Generator<number, void>\n{\n    if (end === undefined)\n    {\n        end = start;\n        start = 0;\n    }\n\n    if (start > end) { step = step ?? -1; }\n\n    for (let index = start; index < end; index += step) { yield index; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n\nexport function random(): number;\nexport function random(max: number): number;\nexport function random(min: number, max: number): number;\nexport function random(min: number, max: number, isDecimal: boolean): number;\nexport function random(min: number, max: number, digits: number): number;\nexport function random(min: number = 1, max?: number, decimals?: boolean | number): number\n{\n    if (max === undefined)\n    {\n        max = min;\n        min = 0;\n    }\n\n    if (min === max)\n    {\n        return min;\n    }\n\n    let rounder: (value: number) => number;\n\n    if (decimals === true)\n    {\n        rounder = (value) => value;\n    }\n    else if (decimals === undefined)\n    {\n        if (Math.abs(max - min) <= 1)\n        {\n            rounder = (value) => value;\n        }\n        else\n        {\n            rounder = Math.floor;\n        }\n    }\n    else if (decimals === false)\n    {\n        rounder = Math.floor;\n    }\n    else\n    {\n        const digits = 10 ** decimals;\n\n        rounder = (value) => Math.floor(value * digits) / digits;\n    }\n\n    return rounder(Math.random() * (max - min) + min);\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.1.2\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models/index.js\";\nexport {\n    capitalize,\n    count,\n    delay,\n    dateDifference,\n    dateRange,\n    dateRound,\n    DateUnit,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    random,\n    range,\n    sum,\n    unique\n\n} from \"./utils/index.js\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types.js\";\n"],"names":["DeferredPromise","onFulfilled","onRejected","__publicField","_resolve","_reject","_promise","resolve","reject","value","reason","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","sum","_sum","unique","hash","i","char","random","min","max","decimals","rounder","digits","capitalize","VERSION"],"mappings":"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"}

package/dist/core.umd.cjs

@@ -1,6 +1,6 @@
-(function(r,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(r=typeof globalThis<"u"?globalThis:r||self,o(r.Core={}))})(this,function(r){"use strict";var k=Object.defineProperty;var j=(r,o,c)=>o in r?k(r,o,{enumerable:!0,configurable:!0,writable:!0,value:c}):r[o]=c;var u=(r,o,c)=>(j(r,typeof o!="symbol"?o+"":o,c),c);class o{constructor(e){u(this,"_resolve");u(this,"_reject");u(this,"_promise");this._promise=new Promise((t,i)=>{this._resolve=t,this._reject=i,e==null||e(t,i)})}resolve(e){this._resolve(e)}reject(e){this._reject(e)}then(e,t){return this._promise.then(e,t)}catch(e){return this._promise.catch(e)}finally(e){return this._promise.finally(e)}}class c extends Error{static FromUnknown(e){if(e instanceof c)return e;if(e instanceof Error){const t=new c(e.message);return t.stack=e.stack,t.name=e.name,t}return new c(`${e}`)}constructor(e,t,i="Exception"){super(e),this.cause=t,this.name=i,t&&(t instanceof Error?this.stack+=`
+(function(i,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(i=typeof globalThis<"u"?globalThis:i||self,o(i.Core={}))})(this,function(i){"use strict";var A=Object.defineProperty;var C=(i,o,c)=>o in i?A(i,o,{enumerable:!0,configurable:!0,writable:!0,value:c}):i[o]=c;var u=(i,o,c)=>(C(i,typeof o!="symbol"?o+"":o,c),c);class o{constructor(e,t){u(this,"_resolve");u(this,"_reject");u(this,"_promise");let n,r;const l=new Promise((j,k)=>{n=j,r=k});this._promise=l.then(e,t),this._resolve=n,this._reject=r}resolve(e){this._resolve(e)}reject(e){this._reject(e)}then(e,t){return this._promise.then(e,t)}catch(e){return this._promise.catch(e)}finally(e){return this._promise.finally(e)}}class c extends Error{static FromUnknown(e){if(e instanceof c)return e;if(e instanceof Error){const t=new c(e.message);return t.stack=e.stack,t.name=e.name,t}return new c(`${e}`)}constructor(e,t,n="Exception"){super(e),this.cause=t,this.name=n,t&&(t instanceof Error?this.stack+=`
 
 Caused by ${t.stack}`:this.stack+=`
 
-Caused by ${t}`)}}class h{constructor(e=!0){u(this,"_preferPersistence");u(this,"_volatile");u(this,"_persistent");this._preferPersistence=e,this._volatile=window.sessionStorage,this._persistent=window.localStorage}_get(e,t,i){const n=e.getItem(t);if(n)try{return JSON.parse(n)}catch{e.removeItem(t)}return i}_set(e,t,i){const n=JSON.stringify(i);n?e.setItem(t,n):e.removeItem(t)}get(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;return this._get(n,e,t)}recall(e,t){return this._get(this._volatile,e,t)}retrieve(e,t){return this.recall(e)??this.read(e,t)}read(e,t){return this._get(this._persistent,e,t)}has(e,t){return(t?this._persistent:this._volatile).getItem(e)!==null}knows(e){return this._volatile.getItem(e)!==null}find(e){return this.knows(e)??this.exists(e)}exists(e){return this._persistent.getItem(e)!==null}set(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;this._set(n,e,t)}remember(e,t){this._set(this._volatile,e,t)}write(e,t){this._set(this._persistent,e,t)}forget(e){this._volatile.removeItem(e)}erase(e){this._persistent.removeItem(e)}clear(e){this._volatile.removeItem(e),this._persistent.removeItem(e)}}class f{constructor(){u(this,"_subscribers");this._subscribers=[]}add(e){this._subscribers.push(e)}remove(e){const t=this._subscribers.indexOf(e);if(t<0)throw new c("Unable to remove the requested subscriber. It was not found.");this._subscribers.splice(t,1)}call(...e){return this._subscribers.slice().map(t=>t(...e))}}async function d(s){return new Promise((e,t)=>setTimeout(e,s))}async function _(){return new Promise((s,e)=>requestAnimationFrame(()=>s()))}var a=(s=>(s[s.Second=1e3]="Second",s[s.Minute=6e4]="Minute",s[s.Hour=36e5]="Hour",s[s.Day=864e5]="Day",s[s.Week=6048e5]="Week",s[s.Month=2592e6]="Month",s[s.Year=31536e6]="Year",s))(a||{});function m(s,e,t=864e5){return Math.floor((e.getTime()-s.getTime())/t)}function*g(s,e,t=864e5){const i=e.getTime();let n=s.getTime();for(;n<i;)yield new Date(n),n+=t}function b(s,e=864e5){return new Date(Math.floor(s.getTime()/e)*e)}async function v(s,e="text/javascript"){return new Promise((t,i)=>{const n=document.createElement("script");n.async=!0,n.defer=!0,n.src=s,n.type=e,n.onload=()=>t(),n.onerror=()=>i(),document.body.appendChild(n)})}function w(s){if(Array.isArray(s))return s.length;let e=0;for(const t of s)e+=1;return e}function*y(s,e,t=1){e===void 0&&(e=s,s=0),s>e&&(t=t??-1);for(let i=s;i<e;i+=t)yield i}function S(s){let e=0;for(const t of s)e+=t;return e}function p(s){return[...new Set(s)]}function I(s){let e=0;for(let t=0;t<s.length;t++){const i=s.charCodeAt(t);e=(e<<5)-e+i,e|=0}return e}function M(s=1,e,t){if(e===void 0&&(e=s,s=0),s===e)return s;let i;if(t===!0)i=n=>n;else if(t===void 0)Math.abs(e-s)<=1?i=n=>n:i=Math.floor;else if(t===!1)i=Math.floor;else{const n=10**t;i=l=>Math.floor(l*n)/n}return i(Math.random()*(e-s)+s)}function P(s){return`${s.charAt(0).toUpperCase()}${s.slice(1)}`}const T="1.1.1";r.DateUnit=a,r.DeferredPromise=o,r.Exception=c,r.JsonStorage=h,r.Subscribers=f,r.VERSION=T,r.capitalize=P,r.count=w,r.dateDifference=m,r.dateRange=g,r.dateRound=b,r.delay=d,r.hash=I,r.loadScript=v,r.nextAnimationFrame=_,r.random=M,r.range=y,r.sum=S,r.unique=p,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});
+Caused by ${t}`)}}class h{constructor(e=!0){u(this,"_preferPersistence");u(this,"_volatile");u(this,"_persistent");this._preferPersistence=e,this._volatile=window.sessionStorage,this._persistent=window.localStorage}_get(e,t,n){const r=e.getItem(t);if(r)try{return JSON.parse(r)}catch{e.removeItem(t)}return n}_set(e,t,n){const r=JSON.stringify(n);r?e.setItem(t,r):e.removeItem(t)}get(e,t,n=this._preferPersistence){const r=n?this._persistent:this._volatile;return this._get(r,e,t)}recall(e,t){return this._get(this._volatile,e,t)}retrieve(e,t){return this.recall(e)??this.read(e,t)}read(e,t){return this._get(this._persistent,e,t)}has(e,t){return(t?this._persistent:this._volatile).getItem(e)!==null}knows(e){return this._volatile.getItem(e)!==null}find(e){return this.knows(e)??this.exists(e)}exists(e){return this._persistent.getItem(e)!==null}set(e,t,n=this._preferPersistence){const r=n?this._persistent:this._volatile;this._set(r,e,t)}remember(e,t){this._set(this._volatile,e,t)}write(e,t){this._set(this._persistent,e,t)}forget(e){this._volatile.removeItem(e)}erase(e){this._persistent.removeItem(e)}clear(e){this._volatile.removeItem(e),this._persistent.removeItem(e)}}class f{constructor(){u(this,"_subscribers");this._subscribers=[]}add(e){this._subscribers.push(e)}remove(e){const t=this._subscribers.indexOf(e);if(t<0)throw new c("Unable to remove the requested subscriber. It was not found.");this._subscribers.splice(t,1)}call(...e){return this._subscribers.slice().map(t=>t(...e))}}async function d(s){return new Promise((e,t)=>setTimeout(e,s))}async function _(){return new Promise((s,e)=>requestAnimationFrame(()=>s()))}var a=(s=>(s[s.Second=1e3]="Second",s[s.Minute=6e4]="Minute",s[s.Hour=36e5]="Hour",s[s.Day=864e5]="Day",s[s.Week=6048e5]="Week",s[s.Month=2592e6]="Month",s[s.Year=31536e6]="Year",s))(a||{});function m(s,e,t=864e5){return Math.floor((e.getTime()-s.getTime())/t)}function*g(s,e,t=864e5){const n=e.getTime();let r=s.getTime();for(;r<n;)yield new Date(r),r+=t}function v(s,e=864e5){return new Date(Math.floor(s.getTime()/e)*e)}async function b(s,e="text/javascript"){return new Promise((t,n)=>{const r=document.createElement("script");r.async=!0,r.defer=!0,r.src=s,r.type=e,r.onload=()=>t(),r.onerror=()=>n(),document.body.appendChild(r)})}function w(s){if(Array.isArray(s))return s.length;let e=0;for(const t of s)e+=1;return e}function*y(s,e,t=1){e===void 0&&(e=s,s=0),s>e&&(t=t??-1);for(let n=s;n<e;n+=t)yield n}function S(s){let e=0;for(const t of s)e+=t;return e}function p(s){return[...new Set(s)]}function I(s){let e=0;for(let t=0;t<s.length;t++){const n=s.charCodeAt(t);e=(e<<5)-e+n,e|=0}return e}function M(s=1,e,t){if(e===void 0&&(e=s,s=0),s===e)return s;let n;if(t===!0)n=r=>r;else if(t===void 0)Math.abs(e-s)<=1?n=r=>r:n=Math.floor;else if(t===!1)n=Math.floor;else{const r=10**t;n=l=>Math.floor(l*r)/r}return n(Math.random()*(e-s)+s)}function P(s){return`${s.charAt(0).toUpperCase()}${s.slice(1)}`}const T="1.1.2";i.DateUnit=a,i.DeferredPromise=o,i.Exception=c,i.JsonStorage=h,i.Subscribers=f,i.VERSION=T,i.capitalize=P,i.count=w,i.dateDifference=m,i.dateRange=g,i.dateRound=v,i.delay=d,i.hash=I,i.loadScript=b,i.nextAnimationFrame=_,i.random=M,i.range=y,i.sum=S,i.unique=p,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})});
 //# sourceMappingURL=core.umd.cjs.map

package/dist/core.umd.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.umd.cjs","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/subscribers.ts","../src/utils/async.ts","../src/utils/date.ts","../src/utils/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type {\n    PromiseExecutor,\n    PromiseResolver,\n    PromiseRejecter,\n    FulfilledHandler,\n    RejectedHandler,\n    MaybePromise\n\n} from \"../types.js\";\n\nexport default class DeferredPromise<T>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter;\n\n    protected _promise: Promise<T>;\n\n    public constructor(executor?: PromiseExecutor<T>)\n    {\n        this._promise = new Promise((resolve, reject) =>\n        {\n            this._resolve = resolve;\n            this._reject = reject;\n\n            executor?.(resolve, reject);\n        });\n    }\n\n    public resolve(value: MaybePromise<T>)\n    {\n        this._resolve(value);\n    }\n    public reject(reason: unknown)\n    {\n        this._reject(reason);\n    }\n\n    public then<F = T, R = never>(onFulfilled?: FulfilledHandler<T, F>, onRejected?: RejectedHandler<unknown, R>)\n        : Promise<F | R>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | R>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: () => void): Promise<T>\n    {\n        return this._promise.finally(onFinally);\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","import Exception from \"./exception.js\";\n\nexport default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>\n{\n    protected _subscribers: T[];\n\n    public constructor()\n    {\n        this._subscribers = [];\n    }\n\n    public add(subscriber: T): void\n    {\n        this._subscribers.push(subscriber);\n    }\n    public remove(subscriber: T): void\n    {\n        const index = this._subscribers.indexOf(subscriber);\n        if (index < 0)\n        {\n            throw new Exception(\"Unable to remove the requested subscriber. It was not found.\");\n        }\n\n        this._subscribers.splice(index, 1);\n    }\n\n    public call(...args: P): R[]\n    {\n        return this._subscribers\n            .slice()\n            .map((subscriber) => subscriber(...args));\n    }\n}\n","export async function delay(milliseconds: number): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => setTimeout(resolve, milliseconds));\n}\n\nexport async function nextAnimationFrame(): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => requestAnimationFrame(() => resolve()));\n}\n","export enum DateUnit\n{\n    Second = 1000,\n    Minute = 60 * Second,\n    Hour = 60 * Minute,\n    Day = 24 * Hour,\n    Week = 7 * Day,\n    Month = 30 * Day,\n    Year = 365 * Day\n}\n\nexport function dateDifference(start: Date, end: Date, unit = DateUnit.Day)\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function* dateRange(start: Date, end: Date, offset = DateUnit.Day)\n{\n    const endTime = end.getTime();\n\n    let unixTime: number = start.getTime();\n    while (unixTime < endTime)\n    {\n        yield new Date(unixTime);\n\n        unixTime += offset;\n    }\n}\n\nexport function dateRound(date: Date, unit = DateUnit.Day)\n{\n    return new Date(Math.floor(date.getTime() / unit) * unit);\n}\n","export async function loadScript(scriptUrl: string, scriptType = \"text/javascript\"): Promise<void>\n{\n    return new Promise<void>((resolve, reject) =>\n    {\n        const script = document.createElement(\"script\");\n\n        script.async = true;\n        script.defer = true;\n        script.src = scriptUrl;\n        script.type = scriptType;\n\n        script.onload = () => resolve();\n        script.onerror = () => reject();\n\n        document.body.appendChild(script);\n    });\n}\n","export function count<T>(elements: Iterable<T>): number\n{\n    if (Array.isArray(elements)) { return elements.length; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function range(end: number): Generator<number, void>;\nexport function range(start: number, end: number): Generator<number, void>;\nexport function range(start: number, end: number, step: number): Generator<number, void>;\nexport function* range(start: number, end?: number, step = 1): Generator<number, void>\n{\n    if (end === undefined)\n    {\n        end = start;\n        start = 0;\n    }\n\n    if (start > end) { step = step ?? -1; }\n\n    for (let index = start; index < end; index += step) { yield index; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n\nexport function random(): number;\nexport function random(max: number): number;\nexport function random(min: number, max: number): number;\nexport function random(min: number, max: number, isDecimal: boolean): number;\nexport function random(min: number, max: number, digits: number): number;\nexport function random(min: number = 1, max?: number, decimals?: boolean | number): number\n{\n    if (max === undefined)\n    {\n        max = min;\n        min = 0;\n    }\n\n    if (min === max)\n    {\n        return min;\n    }\n\n    let rounder: (value: number) => number;\n\n    if (decimals === true)\n    {\n        rounder = (value) => value;\n    }\n    else if (decimals === undefined)\n    {\n        if (Math.abs(max - min) <= 1)\n        {\n            rounder = (value) => value;\n        }\n        else\n        {\n            rounder = Math.floor;\n        }\n    }\n    else if (decimals === false)\n    {\n        rounder = Math.floor;\n    }\n    else\n    {\n        const digits = 10 ** decimals;\n\n        rounder = (value) => Math.floor(value * digits) / digits;\n    }\n\n    return rounder(Math.random() * (max - min) + min);\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.1.1\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models/index.js\";\nexport {\n    capitalize,\n    count,\n    delay,\n    dateDifference,\n    dateRange,\n    dateRound,\n    DateUnit,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    random,\n    range,\n    sum,\n    unique\n\n} from \"./utils/index.js\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types.js\";\n"],"names":["DeferredPromise","executor","__publicField","resolve","reject","value","reason","onFulfilled","onRejected","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","sum","_sum","unique","hash","i","char","random","min","max","decimals","rounder","digits","capitalize","VERSION"],"mappings":"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"}
+{"version":3,"file":"core.umd.cjs","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/subscribers.ts","../src/utils/async.ts","../src/utils/date.ts","../src/utils/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type { PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler, MaybePromise } from \"../types.js\";\n\nexport default class DeferredPromise<T, E = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter;\n\n    protected _promise: Promise<T | E>;\n\n    public constructor(onFulfilled?: FulfilledHandler<unknown, T>, onRejected?: RejectedHandler<unknown, E>)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter;\n\n        const _promise = new Promise<T | E>((resolve, reject) =>\n        {\n            _resolve = resolve;\n            _reject = reject;\n        });\n\n        this._promise = _promise.then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public resolve(value: MaybePromise<T>)\n    {\n        this._resolve(value);\n    }\n    public reject(reason: unknown)\n    {\n        this._reject(reason);\n    }\n\n    public then<F = T | E, R = never>(\n        onFulfilled?: FulfilledHandler<T | E, F>,\n        onRejected?: RejectedHandler<unknown, R>): Promise<F | R>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | E | R>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: () => void): Promise<T | E>\n    {\n        return this._promise.finally(onFinally);\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","import Exception from \"./exception.js\";\n\nexport default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>\n{\n    protected _subscribers: T[];\n\n    public constructor()\n    {\n        this._subscribers = [];\n    }\n\n    public add(subscriber: T): void\n    {\n        this._subscribers.push(subscriber);\n    }\n    public remove(subscriber: T): void\n    {\n        const index = this._subscribers.indexOf(subscriber);\n        if (index < 0)\n        {\n            throw new Exception(\"Unable to remove the requested subscriber. It was not found.\");\n        }\n\n        this._subscribers.splice(index, 1);\n    }\n\n    public call(...args: P): R[]\n    {\n        return this._subscribers\n            .slice()\n            .map((subscriber) => subscriber(...args));\n    }\n}\n","export async function delay(milliseconds: number): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => setTimeout(resolve, milliseconds));\n}\n\nexport async function nextAnimationFrame(): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => requestAnimationFrame(() => resolve()));\n}\n","export enum DateUnit\n{\n    Second = 1000,\n    Minute = 60 * Second,\n    Hour = 60 * Minute,\n    Day = 24 * Hour,\n    Week = 7 * Day,\n    Month = 30 * Day,\n    Year = 365 * Day\n}\n\nexport function dateDifference(start: Date, end: Date, unit = DateUnit.Day)\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function* dateRange(start: Date, end: Date, offset = DateUnit.Day)\n{\n    const endTime = end.getTime();\n\n    let unixTime: number = start.getTime();\n    while (unixTime < endTime)\n    {\n        yield new Date(unixTime);\n\n        unixTime += offset;\n    }\n}\n\nexport function dateRound(date: Date, unit = DateUnit.Day)\n{\n    return new Date(Math.floor(date.getTime() / unit) * unit);\n}\n","export async function loadScript(scriptUrl: string, scriptType = \"text/javascript\"): Promise<void>\n{\n    return new Promise<void>((resolve, reject) =>\n    {\n        const script = document.createElement(\"script\");\n\n        script.async = true;\n        script.defer = true;\n        script.src = scriptUrl;\n        script.type = scriptType;\n\n        script.onload = () => resolve();\n        script.onerror = () => reject();\n\n        document.body.appendChild(script);\n    });\n}\n","export function count<T>(elements: Iterable<T>): number\n{\n    if (Array.isArray(elements)) { return elements.length; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function range(end: number): Generator<number, void>;\nexport function range(start: number, end: number): Generator<number, void>;\nexport function range(start: number, end: number, step: number): Generator<number, void>;\nexport function* range(start: number, end?: number, step = 1): Generator<number, void>\n{\n    if (end === undefined)\n    {\n        end = start;\n        start = 0;\n    }\n\n    if (start > end) { step = step ?? -1; }\n\n    for (let index = start; index < end; index += step) { yield index; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n\nexport function random(): number;\nexport function random(max: number): number;\nexport function random(min: number, max: number): number;\nexport function random(min: number, max: number, isDecimal: boolean): number;\nexport function random(min: number, max: number, digits: number): number;\nexport function random(min: number = 1, max?: number, decimals?: boolean | number): number\n{\n    if (max === undefined)\n    {\n        max = min;\n        min = 0;\n    }\n\n    if (min === max)\n    {\n        return min;\n    }\n\n    let rounder: (value: number) => number;\n\n    if (decimals === true)\n    {\n        rounder = (value) => value;\n    }\n    else if (decimals === undefined)\n    {\n        if (Math.abs(max - min) <= 1)\n        {\n            rounder = (value) => value;\n        }\n        else\n        {\n            rounder = Math.floor;\n        }\n    }\n    else if (decimals === false)\n    {\n        rounder = Math.floor;\n    }\n    else\n    {\n        const digits = 10 ** decimals;\n\n        rounder = (value) => Math.floor(value * digits) / digits;\n    }\n\n    return rounder(Math.random() * (max - min) + min);\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.1.2\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models/index.js\";\nexport {\n    capitalize,\n    count,\n    delay,\n    dateDifference,\n    dateRange,\n    dateRound,\n    DateUnit,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    random,\n    range,\n    sum,\n    unique\n\n} from \"./utils/index.js\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types.js\";\n"],"names":["DeferredPromise","onFulfilled","onRejected","__publicField","_resolve","_reject","_promise","resolve","reject","value","reason","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","sum","_sum","unique","hash","i","char","random","min","max","decimals","rounder","digits","capitalize","VERSION"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byloth/core",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "An unopinionated collection of useful functions and classes that I use widely in all my projects. 🔧",
   "keywords": [
     "Core",

package/src/index.ts

@@ -1,4 +1,4 @@
-export const VERSION = "1.1.1";
+export const VERSION = "1.1.2";
 
 export { DeferredPromise, Exception, JsonStorage, Subscribers } from "./models/index.js";
 export {

package/src/models/deferred-promise.ts

@@ -1,29 +1,27 @@
-import type {
-    PromiseExecutor,
-    PromiseResolver,
-    PromiseRejecter,
-    FulfilledHandler,
-    RejectedHandler,
-    MaybePromise
+import type { PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler, MaybePromise } from "../types.js";
 
-} from "../types.js";
-
-export default class DeferredPromise<T>
+export default class DeferredPromise<T, E = never>
 {
     protected _resolve!: PromiseResolver<T>;
     protected _reject!: PromiseRejecter;
 
-    protected _promise: Promise<T>;
+    protected _promise: Promise<T | E>;
 
-    public constructor(executor?: PromiseExecutor<T>)
+    public constructor(onFulfilled?: FulfilledHandler<unknown, T>, onRejected?: RejectedHandler<unknown, E>)
     {
-        this._promise = new Promise((resolve, reject) =>
-        {
-            this._resolve = resolve;
-            this._reject = reject;
+        let _resolve: PromiseResolver<T>;
+        let _reject: PromiseRejecter;
 
-            executor?.(resolve, reject);
+        const _promise = new Promise<T | E>((resolve, reject) =>
+        {
+            _resolve = resolve;
+            _reject = reject;
         });
+
+        this._promise = _promise.then(onFulfilled, onRejected);
+
+        this._resolve = _resolve!;
+        this._reject = _reject!;
     }
 
     public resolve(value: MaybePromise<T>)
@@ -35,16 +33,17 @@ export default class DeferredPromise<T>
         this._reject(reason);
     }
 
-    public then<F = T, R = never>(onFulfilled?: FulfilledHandler<T, F>, onRejected?: RejectedHandler<unknown, R>)
-        : Promise<F | R>
+    public then<F = T | E, R = never>(
+        onFulfilled?: FulfilledHandler<T | E, F>,
+        onRejected?: RejectedHandler<unknown, R>): Promise<F | R>
     {
         return this._promise.then(onFulfilled, onRejected);
     }
-    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | R>
+    public catch<R = never>(onRejected?: RejectedHandler<unknown, R>): Promise<T | E | R>
     {
         return this._promise.catch(onRejected);
     }
-    public finally(onFinally?: () => void): Promise<T>
+    public finally(onFinally?: () => void): Promise<T | E>
     {
         return this._promise.finally(onFinally);
     }