@byloth/core 1.1.7 → 1.2.0-rc.1

package/dist/core.js

@@ -1,15 +1,15 @@
-var l = Object.defineProperty;
-var h = (r, e, t) => e in r ? l(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var n = (r, e, t) => (h(r, typeof e != "symbol" ? e + "" : e, t), t);
-class _ {
+var a = Object.defineProperty;
+var h = (r, e, t) => e in r ? a(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var o = (r, e, t) => (h(r, typeof e != "symbol" ? e + "" : e, t), t);
+class m {
   constructor(e, t) {
-    n(this, "_resolve");
-    n(this, "_reject");
-    n(this, "_promise");
-    let i, s;
-    this._promise = new Promise((c, u) => {
-      i = c, s = u;
-    }).then(e, t), this._resolve = i, this._reject = s;
+    o(this, "_resolve");
+    o(this, "_reject");
+    o(this, "_promise");
+    let n, s;
+    this._promise = new Promise((i, l) => {
+      n = i, s = l;
+    }).then(e, t), this._resolve = n, this._reject = s;
   }
   get resolve() {
     return this._resolve;
@@ -33,32 +33,32 @@ class _ {
     return "DeferredPromise";
   }
 }
-class o extends Error {
+class c extends Error {
   static FromUnknown(e) {
-    if (e instanceof o)
+    if (e instanceof c)
       return e;
     if (e instanceof Error) {
-      const t = new o(e.message);
+      const t = new c(e.message);
       return t.stack = e.stack, t.name = e.name, t;
     }
-    return new o(`${e}`);
+    return new c(`${e}`);
   }
-  constructor(e, t, i = "Exception") {
-    super(e), this.cause = t, this.name = i, t && (t instanceof Error ? this.stack += `
+  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 d {
+class v {
   constructor(e = !0) {
-    n(this, "_preferPersistence");
-    n(this, "_volatile");
-    n(this, "_persistent");
+    o(this, "_preferPersistence");
+    o(this, "_volatile");
+    o(this, "_persistent");
     this._preferPersistence = e, this._volatile = window.sessionStorage, this._persistent = window.localStorage;
   }
-  _get(e, t, i) {
+  _get(e, t, n) {
     const s = e.getItem(t);
     if (s)
       try {
@@ -68,14 +68,14 @@ class d {
           `The "${s}" value for "${t}" property cannot be parsed. Clearing the storage...`
         ), e.removeItem(t);
       }
-    return i;
+    return n;
   }
-  _set(e, t, i) {
-    const s = JSON.stringify(i);
+  _set(e, t, n) {
+    const s = JSON.stringify(n);
     s ? e.setItem(t, s) : e.removeItem(t);
   }
-  get(e, t, i = this._preferPersistence) {
-    const s = i ? this._persistent : this._volatile;
+  get(e, t, n = this._preferPersistence) {
+    const s = n ? this._persistent : this._volatile;
     return this._get(s, e, t);
   }
   recall(e, t) {
@@ -137,8 +137,8 @@ class d {
    * @param newValue The new value to set.
    * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.
    */
-  set(e, t, i = this._preferPersistence) {
-    const s = i ? this._persistent : this._volatile;
+  set(e, t, n = this._preferPersistence) {
+    const s = n ? this._persistent : this._volatile;
     this._set(s, e, t);
   }
   /**
@@ -186,9 +186,69 @@ class d {
     this._volatile.removeItem(e), this._persistent.removeItem(e);
   }
 }
-class m {
+class u {
+  constructor(e) {
+    o(this, "_iterator");
+    o(this, "return");
+    o(this, "throw");
+    e instanceof Function ? this._iterator = e() : Symbol.iterator in e ? this._iterator = e[Symbol.iterator]() : this._iterator = e, this._iterator.return && (this.return = (t) => this._iterator.return(t)), this._iterator.throw && (this.throw = (t) => this._iterator.throw(t));
+  }
+  filter(e) {
+    let t = 0;
+    const n = this._iterator;
+    return new u({
+      *[Symbol.iterator]() {
+        for (; ; ) {
+          const s = n.next();
+          if (s.done)
+            return s.value;
+          e(s.value, t) && (yield s.value), t += 1;
+        }
+      }
+    });
+  }
+  map(e) {
+    let t = 0;
+    const n = this._iterator;
+    return new u({
+      *[Symbol.iterator]() {
+        for (; ; ) {
+          const s = n.next();
+          if (s.done)
+            return s.value;
+          yield e(s.value, t), t += 1;
+        }
+      }
+    });
+  }
+  reduce(e, t) {
+    let n = 0, s = t;
+    for (; ; ) {
+      const i = this._iterator.next();
+      if (i.done)
+        return s;
+      s = e(s, i.value, n), n += 1;
+    }
+  }
+  forEach(e) {
+    let t = 0;
+    for (; ; ) {
+      const n = this._iterator.next();
+      if (n.done)
+        return;
+      e(n.value, t), t += 1;
+    }
+  }
+  next(...e) {
+    return this._iterator.next(...e);
+  }
+  [Symbol.iterator]() {
+    return this;
+  }
+}
+class w {
   constructor() {
-    n(this, "_subscribers");
+    o(this, "_subscribers");
     this._subscribers = [];
   }
   add(e) {
@@ -197,7 +257,7 @@ class m {
   remove(e) {
     const t = this._subscribers.indexOf(e);
     if (t < 0)
-      throw new o("Unable to remove the requested subscriber. It was not found.");
+      throw new c("Unable to remove the requested subscriber. It was not found.");
     this._subscribers.splice(t, 1);
   }
   call(...e) {
@@ -207,26 +267,28 @@ class m {
 async function g(r) {
   return new Promise((e, t) => setTimeout(e, r));
 }
-async function v() {
+async function b() {
   return new Promise((r, e) => requestAnimationFrame(() => r()));
 }
-var a = /* @__PURE__ */ ((r) => (r[r.Second = 1e3] = "Second", r[r.Minute = 6e4] = "Minute", r[r.Hour = 36e5] = "Hour", r[r.Day = 864e5] = "Day", r[r.Week = 6048e5] = "Week", r[r.Month = 2592e6] = "Month", r[r.Year = 31536e6] = "Year", r))(a || {});
-function p(r, e, t = 864e5) {
+var f = /* @__PURE__ */ ((r) => (r[r.Second = 1e3] = "Second", r[r.Minute = 6e4] = "Minute", r[r.Hour = 36e5] = "Hour", r[r.Day = 864e5] = "Day", r[r.Week = 6048e5] = "Week", r[r.Month = 2592e6] = "Month", r[r.Year = 31536e6] = "Year", r))(f || {});
+function y(r, e, t = 864e5) {
   return Math.floor((e.getTime() - r.getTime()) / t);
 }
-function* b(r, e, t = 864e5) {
-  const i = e.getTime();
-  let s = r.getTime();
-  for (; s < i; )
-    yield new Date(s), s += t;
+function p(r, e, t = 864e5) {
+  return new u(function* () {
+    const n = e.getTime();
+    let s = r.getTime();
+    for (; s < n; )
+      yield new Date(s), s += t;
+  });
 }
-function w(r, e = 864e5) {
+function x(r, e = 864e5) {
   return new Date(Math.floor(r.getTime() / e) * e);
 }
-async function y(r, e = "text/javascript") {
-  return new Promise((t, i) => {
+async function S(r, e = "text/javascript") {
+  return new Promise((t, n) => {
     const s = document.createElement("script");
-    s.async = !0, s.defer = !0, s.src = r, s.type = e, s.onload = () => t(), s.onerror = () => i(), document.body.appendChild(s);
+    s.async = !0, s.defer = !0, s.src = r, s.type = e, s.onload = () => t(), s.onerror = () => n(), document.body.appendChild(s);
   });
 }
 function I(r) {
@@ -237,67 +299,108 @@ function I(r) {
     e += 1;
   return e;
 }
-function* S(r, e, t = 1) {
-  e === void 0 && (e = r, r = 0), r > e && (t = t ?? -1);
-  for (let i = r; i < e; i += t)
-    yield i;
+function M(r, e, t = 1) {
+  return new u(function* () {
+    e === void 0 && (e = r, r = 0), r > e && (t = t ?? -1);
+    for (let n = r; n < e; n += t)
+      yield n;
+  });
 }
-function M(r) {
-  let e = 0;
-  for (const t of r)
-    e += t;
+function k(r) {
+  const e = [...r];
+  for (let t = e.length - 1; t > 0; t -= 1) {
+    const n = Math.floor(Math.random() * (t + 1));
+    [e[t], e[n]] = [e[n], e[t]];
+  }
   return e;
 }
-function k(r) {
-  return [...new Set(r)];
+function j(r) {
+  return new u(function* () {
+    const e = /* @__PURE__ */ new Set();
+    for (const t of r)
+      e.has(t) || (e.add(t), yield t);
+  });
+}
+function _(r, e) {
+  return new u(function* () {
+    const t = r[Symbol.iterator](), n = e[Symbol.iterator]();
+    for (; ; ) {
+      const s = t.next(), i = n.next();
+      if (s.done || i.done)
+        break;
+      yield [s.value, i.value];
+    }
+  });
+}
+function P(r, e) {
+  if (e === void 0) {
+    let s = 0, i = 0;
+    for (const l of r)
+      s += l, i += 1;
+    return s / i;
+  }
+  let t = 0, n = 0;
+  for (const [s, i] of _(r, e))
+    t += s * i, n += i;
+  return t / n;
 }
-function P(r) {
+function T(r) {
   let e = 0;
   for (let t = 0; t < r.length; t++) {
-    const i = r.charCodeAt(t);
-    e = (e << 5) - e + i, e |= 0;
+    const n = r.charCodeAt(t);
+    e = (e << 5) - e + n, e |= 0;
   }
   return e;
 }
-function T(r = 1, e, t) {
+function $(r = 1, e, t) {
   if (e === void 0 && (e = r, r = 0), r === e)
     return r;
-  let i;
+  let n;
   if (t === !0)
-    i = (s) => s;
+    n = (s) => s;
   else if (t === void 0)
-    Math.abs(e - r) <= 1 ? i = (s) => s : i = Math.floor;
+    Math.abs(e - r) <= 1 ? n = (s) => s : n = Math.floor;
   else if (t === !1)
-    i = Math.floor;
+    n = Math.floor;
   else {
     const s = 10 ** t;
-    i = (c) => Math.floor(c * s) / s;
+    n = (i) => Math.floor(i * s) / s;
   }
-  return i(Math.random() * (e - r) + r);
+  return n(Math.random() * (e - r) + r);
 }
-function j(r) {
+function A(r) {
+  let e = 0;
+  for (const t of r)
+    e += t;
+  return e;
+}
+function C(r) {
   return `${r.charAt(0).toUpperCase()}${r.slice(1)}`;
 }
-const $ = "1.1.7";
+const E = "1.2.0-rc.1";
 export {
-  a as DateUnit,
-  _ as DeferredPromise,
-  o as Exception,
-  d as JsonStorage,
-  m as Subscribers,
-  $ as VERSION,
-  j as capitalize,
+  f as DateUnit,
+  m as DeferredPromise,
+  c as Exception,
+  v as JsonStorage,
+  u as SmartIterator,
+  w as Subscribers,
+  E as VERSION,
+  P as average,
+  C as capitalize,
   I as count,
-  p as dateDifference,
-  b as dateRange,
-  w as dateRound,
+  y as dateDifference,
+  p as dateRange,
+  x as dateRound,
   g as delay,
-  P as hash,
-  y as loadScript,
-  v as nextAnimationFrame,
-  T as random,
-  S as range,
-  M as sum,
-  k as unique
+  T as hash,
+  S as loadScript,
+  b as nextAnimationFrame,
+  $ as random,
+  M as range,
+  k as shuffle,
+  A as sum,
+  j as unique,
+  _ as zip
 };
 //# 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 { PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from \"../types.js\";\n\nexport default class DeferredPromise<T = void, E = unknown, F = T, R = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter<E>;\n\n    protected _promise: Promise<F | R>;\n\n    public constructor(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R> | null)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        this._promise = new Promise<T>((resolve, reject) =>\n        {\n            _resolve = resolve as PromiseResolver<T>;\n            _reject = reject as PromiseRejecter<E>;\n\n        }).then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public get resolve(): PromiseResolver<T>\n    {\n        return this._resolve;\n    }\n    public get reject(): PromiseRejecter<E>\n    {\n        return this._reject;\n    }\n\n    public then<N = F | R, H = R>(\n        onFulfilled?: FulfilledHandler<F | R, N> | null,\n        onRejected?: RejectedHandler<R, H> | null): Promise<N | H>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<H = R>(onRejected?: RejectedHandler<R, H> | null): Promise<F | R | H>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: (() => void) | null): Promise<F | R>\n    {\n        return this._promise.finally(onFinally);\n    }\n\n    public watch(promise: Promise<T>): this\n    {\n        promise.then(this.resolve, this.reject);\n\n        return this;\n    }\n\n    public get [Symbol.toStringTag]()\n    {\n        return \"DeferredPromise\";\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                // 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                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 hashedValue = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hashedValue = ((hashedValue << 5) - hashedValue) + char;\n        hashedValue |= 0;\n    }\n\n    return hashedValue;\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.7\";\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","resolve","reject","onFinally","promise","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","value","unique","hash","hashedValue","i","char","random","min","max","decimals","rounder","digits","capitalize","VERSION"],"mappings":"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"}
+{"version":3,"file":"core.js","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/smart-iterator.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 } from \"../types.js\";\n\nexport default class DeferredPromise<T = void, E = unknown, F = T, R = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter<E>;\n\n    protected _promise: Promise<F | R>;\n\n    public constructor(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R> | null)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        this._promise = new Promise<T>((resolve, reject) =>\n        {\n            _resolve = resolve as PromiseResolver<T>;\n            _reject = reject as PromiseRejecter<E>;\n\n        }).then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public get resolve(): PromiseResolver<T>\n    {\n        return this._resolve;\n    }\n    public get reject(): PromiseRejecter<E>\n    {\n        return this._reject;\n    }\n\n    public then<N = F | R, H = R>(\n        onFulfilled?: FulfilledHandler<F | R, N> | null,\n        onRejected?: RejectedHandler<R, H> | null): Promise<N | H>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<H = R>(onRejected?: RejectedHandler<R, H> | null): Promise<F | R | H>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: (() => void) | null): Promise<F | R>\n    {\n        return this._promise.finally(onFinally);\n    }\n\n    public watch(promise: Promise<T>): this\n    {\n        promise.then(this.resolve, this.reject);\n\n        return this;\n    }\n\n    public get [Symbol.toStringTag]()\n    {\n        return \"DeferredPromise\";\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                // 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                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 type { GeneratorFunction } from \"../types.js\";\n\nexport default class SmartIterator<T, R = void, N = undefined> implements Iterator<T, R, N>\n{\n    protected _iterator: Iterator<T, R, N>;\n\n    public return?: (value?: R) => IteratorResult<T, R>;\n    public throw?: (error?: unknown) => IteratorResult<T, R>;\n\n    public constructor(iterable: Iterable<T>);\n    public constructor(iterator: Iterator<T, R, N>);\n    public constructor(generatorFn: GeneratorFunction<T, R, N>);\n    public constructor(iterable: Iterable<T> | Iterator<T, R, N> | GeneratorFunction<T, R, N>)\n    {\n        if (iterable instanceof Function)\n        {\n            this._iterator = iterable();\n        }\n        else if (Symbol.iterator in iterable)\n        {\n            this._iterator = iterable[Symbol.iterator]() as Iterator<T, R, N>;\n        }\n        else\n        {\n            this._iterator = iterable;\n        }\n\n        if (this._iterator.return) { this.return = (value?: R) => this._iterator.return!(value); }\n        if (this._iterator.throw) { this.throw = (error?: unknown) => this._iterator.throw!(error); }\n    }\n\n    public filter(callback: (value: T, index: number) => boolean): SmartIterator<T, R, N>\n    {\n        let index = 0;\n        const iterator = this._iterator;\n\n        return new SmartIterator<T, R, N>({\n            *[Symbol.iterator]()\n            {\n                while (true)\n                {\n                    const result = iterator.next();\n                    if (result.done) { return result.value; }\n\n                    if (callback(result.value, index))\n                    {\n                        yield result.value;\n                    }\n\n                    index += 1;\n                }\n            }\n        });\n    }\n    public map<V>(callback: (value: T, index: number) => V): SmartIterator<V, R>\n    {\n        let index = 0;\n        const iterator = this._iterator;\n\n        return new SmartIterator<V, R>({\n            *[Symbol.iterator]()\n            {\n                while (true)\n                {\n                    const result = iterator.next();\n                    if (result.done) { return result.value; }\n\n                    yield callback(result.value, index);\n\n                    index += 1;\n                }\n            }\n        });\n    }\n    public reduce<U>(callback: (accumulator: U, value: T, index: number) => U, initialValue: U): U\n    {\n        let index = 0;\n        let accumulator = initialValue;\n\n        // eslint-disable-next-line no-constant-condition\n        while (true)\n        {\n            const result = this._iterator.next();\n            if (result.done) { return accumulator; }\n\n            accumulator = callback(accumulator, result.value, index);\n\n            index += 1;\n        }\n    }\n\n    public forEach(callback: (value: T, index: number) => void): void\n    {\n        let index = 0;\n\n        // eslint-disable-next-line no-constant-condition\n        while (true)\n        {\n            const result = this._iterator.next();\n            if (result.done) { return; }\n\n            callback(result.value, index);\n\n            index += 1;\n        }\n    }\n\n    public next(...values: N extends undefined ? [] : [N]): IteratorResult<T, R>\n    {\n        return this._iterator.next(...values);\n    }\n\n    public [Symbol.iterator](): SmartIterator<T, R, N> { return this; }\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","import { SmartIterator } from \"../models/index.js\";\n\nexport 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): number\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function dateRange(start: Date, end: Date, offset = DateUnit.Day): SmartIterator<Date>\n{\n    return new SmartIterator<Date>(function* ()\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}\n\nexport function dateRound(date: Date, unit = DateUnit.Day): Date\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","import { SmartIterator } from \"../models/index.js\";\n\nexport 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): SmartIterator<number>;\nexport function range(start: number, end: number): SmartIterator<number>;\nexport function range(start: number, end: number, step: number): SmartIterator<number>;\nexport function range(start: number, end?: number, step = 1): SmartIterator<number>\n{\n    return new SmartIterator<number>(function* ()\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}\n\nexport function shuffle<T>(iterable: Iterable<T>): T[]\n{\n    const array = [...iterable];\n\n    for (let index = array.length - 1; index > 0; index -= 1)\n    {\n        const jndex = Math.floor(Math.random() * (index + 1));\n\n        [array[index], array[jndex]] = [array[jndex], array[index]];\n    }\n\n    return array;\n}\n\nexport function unique<T>(elements: Iterable<T>): SmartIterator<T>\n{\n    return new SmartIterator<T>(function* ()\n    {\n        const seen = new Set<T>();\n\n        for (const element of elements)\n        {\n            if (seen.has(element)) { continue; }\n\n            seen.add(element);\n\n            yield element;\n        }\n    });\n}\n\nexport function zip<T, U>(first: Iterable<T>, second: Iterable<U>): SmartIterator<[T, U]>\n{\n    return new SmartIterator<[T, U]>(function* ()\n    {\n        const firstIterator = first[Symbol.iterator]();\n        const secondIterator = second[Symbol.iterator]();\n\n        while (true)\n        {\n            const firstResult = firstIterator.next();\n            const secondResult = secondIterator.next();\n\n            if ((firstResult.done) || (secondResult.done)) { break; }\n\n            yield [firstResult.value, secondResult.value];\n        }\n    });\n}\n","import { zip } from \"./iterator.js\";\n\nexport function average<T extends number>(values: Iterable<T>): number;\nexport function average<T extends number>(values: Iterable<T>, weights: Iterable<number>): number;\nexport function average<T extends number>(values: Iterable<T>, weights?: Iterable<number>): number\n{\n    if (weights === undefined)\n    {\n        let _sum = 0;\n        let _count = 0;\n\n        for (const value of values)\n        {\n            _sum += value;\n            _count += 1;\n        }\n\n        return _sum / _count;\n    }\n\n    let _sum = 0;\n    let _count = 0;\n\n    for (const [value, weight] of zip(values, weights))\n    {\n        _sum += value * weight;\n        _count += weight;\n    }\n\n    return _sum / _count;\n}\n\nexport function hash(value: string): number\n{\n    let hashedValue = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hashedValue = ((hashedValue << 5) - hashedValue) + char;\n        hashedValue |= 0;\n    }\n\n    return hashedValue;\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\nexport function sum<T extends number>(values: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of values) { _sum += value; }\n\n    return _sum;\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.2.0-rc.1\";\n\nexport { DeferredPromise, Exception, JsonStorage, SmartIterator, Subscribers } from \"./models/index.js\";\nexport {\n    average,\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    shuffle,\n    sum,\n    unique,\n    zip\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","resolve","reject","onFinally","promise","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","SmartIterator","iterable","value","callback","index","iterator","result","initialValue","accumulator","values","Subscribers","subscriber","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","shuffle","array","jndex","unique","seen","element","zip","first","second","firstIterator","secondIterator","firstResult","secondResult","average","weights","_sum","weight","hash","hashedValue","i","char","random","min","max","decimals","rounder","digits","sum","capitalize","VERSION"],"mappings":"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"}

package/dist/core.umd.cjs

@@ -1,6 +1,6 @@
-(function(n,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):(n=typeof globalThis<"u"?globalThis:n||self,o(n.Core={}))})(this,function(n){"use strict";var k=Object.defineProperty;var A=(n,o,c)=>o in n?k(n,o,{enumerable:!0,configurable:!0,writable:!0,value:c}):n[o]=c;var u=(n,o,c)=>(A(n,typeof o!="symbol"?o+"":o,c),c);class o{constructor(e,t){u(this,"_resolve");u(this,"_reject");u(this,"_promise");let i,s;this._promise=new Promise((a,j)=>{i=a,s=j}).then(e,t),this._resolve=i,this._reject=s}get resolve(){return this._resolve}get reject(){return this._reject}then(e,t){return this._promise.then(e,t)}catch(e){return this._promise.catch(e)}finally(e){return this._promise.finally(e)}watch(e){return e.then(this.resolve,this.reject),this}get[Symbol.toStringTag](){return"DeferredPromise"}}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(s,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(s=typeof globalThis<"u"?globalThis:s||self,u(s.Core={}))})(this,function(s){"use strict";var E=Object.defineProperty;var $=(s,u,c)=>u in s?E(s,u,{enumerable:!0,configurable:!0,writable:!0,value:c}):s[u]=c;var a=(s,u,c)=>($(s,typeof u!="symbol"?u+"":u,c),c);class u{constructor(e,t){a(this,"_resolve");a(this,"_reject");a(this,"_promise");let i,n;this._promise=new Promise((o,h)=>{i=o,n=h}).then(e,t),this._resolve=i,this._reject=n}get resolve(){return this._resolve}get reject(){return this._reject}then(e,t){return this._promise.then(e,t)}catch(e){return this._promise.catch(e)}finally(e){return this._promise.finally(e)}watch(e){return e.then(this.resolve,this.reject),this}get[Symbol.toStringTag](){return"DeferredPromise"}}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+=`
 
 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 s=e.getItem(t);if(s)try{return JSON.parse(s)}catch{console.warn(`The "${s}" value for "${t}" property cannot be parsed. Clearing the storage...`),e.removeItem(t)}return i}_set(e,t,i){const s=JSON.stringify(i);s?e.setItem(t,s):e.removeItem(t)}get(e,t,i=this._preferPersistence){const s=i?this._persistent:this._volatile;return this._get(s,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 s=i?this._persistent:this._volatile;this._set(s,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(r){return new Promise((e,t)=>setTimeout(e,r))}async function _(){return new Promise((r,e)=>requestAnimationFrame(()=>r()))}var l=(r=>(r[r.Second=1e3]="Second",r[r.Minute=6e4]="Minute",r[r.Hour=36e5]="Hour",r[r.Day=864e5]="Day",r[r.Week=6048e5]="Week",r[r.Month=2592e6]="Month",r[r.Year=31536e6]="Year",r))(l||{});function m(r,e,t=864e5){return Math.floor((e.getTime()-r.getTime())/t)}function*g(r,e,t=864e5){const i=e.getTime();let s=r.getTime();for(;s<i;)yield new Date(s),s+=t}function v(r,e=864e5){return new Date(Math.floor(r.getTime()/e)*e)}async function b(r,e="text/javascript"){return new Promise((t,i)=>{const s=document.createElement("script");s.async=!0,s.defer=!0,s.src=r,s.type=e,s.onload=()=>t(),s.onerror=()=>i(),document.body.appendChild(s)})}function w(r){if(Array.isArray(r))return r.length;let e=0;for(const t of r)e+=1;return e}function*y(r,e,t=1){e===void 0&&(e=r,r=0),r>e&&(t=t??-1);for(let i=r;i<e;i+=t)yield i}function S(r){let e=0;for(const t of r)e+=t;return e}function p(r){return[...new Set(r)]}function I(r){let e=0;for(let t=0;t<r.length;t++){const i=r.charCodeAt(t);e=(e<<5)-e+i,e|=0}return e}function T(r=1,e,t){if(e===void 0&&(e=r,r=0),r===e)return r;let i;if(t===!0)i=s=>s;else if(t===void 0)Math.abs(e-r)<=1?i=s=>s:i=Math.floor;else if(t===!1)i=Math.floor;else{const s=10**t;i=a=>Math.floor(a*s)/s}return i(Math.random()*(e-r)+r)}function M(r){return`${r.charAt(0).toUpperCase()}${r.slice(1)}`}const P="1.1.7";n.DateUnit=l,n.DeferredPromise=o,n.Exception=c,n.JsonStorage=h,n.Subscribers=f,n.VERSION=P,n.capitalize=M,n.count=w,n.dateDifference=m,n.dateRange=g,n.dateRound=v,n.delay=d,n.hash=I,n.loadScript=b,n.nextAnimationFrame=_,n.random=T,n.range=y,n.sum=S,n.unique=p,Object.defineProperty(n,Symbol.toStringTag,{value:"Module"})});
+Caused by ${t}`)}}class _{constructor(e=!0){a(this,"_preferPersistence");a(this,"_volatile");a(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{console.warn(`The "${n}" value for "${t}" property cannot be parsed. Clearing the storage...`),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 l{constructor(e){a(this,"_iterator");a(this,"return");a(this,"throw");e instanceof Function?this._iterator=e():Symbol.iterator in e?this._iterator=e[Symbol.iterator]():this._iterator=e,this._iterator.return&&(this.return=t=>this._iterator.return(t)),this._iterator.throw&&(this.throw=t=>this._iterator.throw(t))}filter(e){let t=0;const i=this._iterator;return new l({*[Symbol.iterator](){for(;;){const n=i.next();if(n.done)return n.value;e(n.value,t)&&(yield n.value),t+=1}}})}map(e){let t=0;const i=this._iterator;return new l({*[Symbol.iterator](){for(;;){const n=i.next();if(n.done)return n.value;yield e(n.value,t),t+=1}}})}reduce(e,t){let i=0,n=t;for(;;){const o=this._iterator.next();if(o.done)return n;n=e(n,o.value,i),i+=1}}forEach(e){let t=0;for(;;){const i=this._iterator.next();if(i.done)return;e(i.value,t),t+=1}}next(...e){return this._iterator.next(...e)}[Symbol.iterator](){return this}}class m{constructor(){a(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 v(r){return new Promise((e,t)=>setTimeout(e,r))}async function g(){return new Promise((r,e)=>requestAnimationFrame(()=>r()))}var f=(r=>(r[r.Second=1e3]="Second",r[r.Minute=6e4]="Minute",r[r.Hour=36e5]="Hour",r[r.Day=864e5]="Day",r[r.Week=6048e5]="Week",r[r.Month=2592e6]="Month",r[r.Year=31536e6]="Year",r))(f||{});function w(r,e,t=864e5){return Math.floor((e.getTime()-r.getTime())/t)}function b(r,e,t=864e5){return new l(function*(){const i=e.getTime();let n=r.getTime();for(;n<i;)yield new Date(n),n+=t})}function y(r,e=864e5){return new Date(Math.floor(r.getTime()/e)*e)}async function S(r,e="text/javascript"){return new Promise((t,i)=>{const n=document.createElement("script");n.async=!0,n.defer=!0,n.src=r,n.type=e,n.onload=()=>t(),n.onerror=()=>i(),document.body.appendChild(n)})}function I(r){if(Array.isArray(r))return r.length;let e=0;for(const t of r)e+=1;return e}function p(r,e,t=1){return new l(function*(){e===void 0&&(e=r,r=0),r>e&&(t=t??-1);for(let i=r;i<e;i+=t)yield i})}function M(r){const e=[...r];for(let t=e.length-1;t>0;t-=1){const i=Math.floor(Math.random()*(t+1));[e[t],e[i]]=[e[i],e[t]]}return e}function T(r){return new l(function*(){const e=new Set;for(const t of r)e.has(t)||(e.add(t),yield t)})}function d(r,e){return new l(function*(){const t=r[Symbol.iterator](),i=e[Symbol.iterator]();for(;;){const n=t.next(),o=i.next();if(n.done||o.done)break;yield[n.value,o.value]}})}function j(r,e){if(e===void 0){let n=0,o=0;for(const h of r)n+=h,o+=1;return n/o}let t=0,i=0;for(const[n,o]of d(r,e))t+=n*o,i+=o;return t/i}function P(r){let e=0;for(let t=0;t<r.length;t++){const i=r.charCodeAt(t);e=(e<<5)-e+i,e|=0}return e}function k(r=1,e,t){if(e===void 0&&(e=r,r=0),r===e)return r;let i;if(t===!0)i=n=>n;else if(t===void 0)Math.abs(e-r)<=1?i=n=>n:i=Math.floor;else if(t===!1)i=Math.floor;else{const n=10**t;i=o=>Math.floor(o*n)/n}return i(Math.random()*(e-r)+r)}function R(r){let e=0;for(const t of r)e+=t;return e}function A(r){return`${r.charAt(0).toUpperCase()}${r.slice(1)}`}const C="1.2.0-rc.1";s.DateUnit=f,s.DeferredPromise=u,s.Exception=c,s.JsonStorage=_,s.SmartIterator=l,s.Subscribers=m,s.VERSION=C,s.average=j,s.capitalize=A,s.count=I,s.dateDifference=w,s.dateRange=b,s.dateRound=y,s.delay=v,s.hash=P,s.loadScript=S,s.nextAnimationFrame=g,s.random=k,s.range=p,s.shuffle=M,s.sum=R,s.unique=T,s.zip=d,Object.defineProperty(s,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 { PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from \"../types.js\";\n\nexport default class DeferredPromise<T = void, E = unknown, F = T, R = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter<E>;\n\n    protected _promise: Promise<F | R>;\n\n    public constructor(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R> | null)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        this._promise = new Promise<T>((resolve, reject) =>\n        {\n            _resolve = resolve as PromiseResolver<T>;\n            _reject = reject as PromiseRejecter<E>;\n\n        }).then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public get resolve(): PromiseResolver<T>\n    {\n        return this._resolve;\n    }\n    public get reject(): PromiseRejecter<E>\n    {\n        return this._reject;\n    }\n\n    public then<N = F | R, H = R>(\n        onFulfilled?: FulfilledHandler<F | R, N> | null,\n        onRejected?: RejectedHandler<R, H> | null): Promise<N | H>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<H = R>(onRejected?: RejectedHandler<R, H> | null): Promise<F | R | H>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: (() => void) | null): Promise<F | R>\n    {\n        return this._promise.finally(onFinally);\n    }\n\n    public watch(promise: Promise<T>): this\n    {\n        promise.then(this.resolve, this.reject);\n\n        return this;\n    }\n\n    public get [Symbol.toStringTag]()\n    {\n        return \"DeferredPromise\";\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                // 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                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 hashedValue = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hashedValue = ((hashedValue << 5) - hashedValue) + char;\n        hashedValue |= 0;\n    }\n\n    return hashedValue;\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.7\";\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","resolve","reject","onFinally","promise","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","value","unique","hash","hashedValue","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/smart-iterator.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 } from \"../types.js\";\n\nexport default class DeferredPromise<T = void, E = unknown, F = T, R = never>\n{\n    protected _resolve!: PromiseResolver<T>;\n    protected _reject!: PromiseRejecter<E>;\n\n    protected _promise: Promise<F | R>;\n\n    public constructor(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R> | null)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        this._promise = new Promise<T>((resolve, reject) =>\n        {\n            _resolve = resolve as PromiseResolver<T>;\n            _reject = reject as PromiseRejecter<E>;\n\n        }).then(onFulfilled, onRejected);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public get resolve(): PromiseResolver<T>\n    {\n        return this._resolve;\n    }\n    public get reject(): PromiseRejecter<E>\n    {\n        return this._reject;\n    }\n\n    public then<N = F | R, H = R>(\n        onFulfilled?: FulfilledHandler<F | R, N> | null,\n        onRejected?: RejectedHandler<R, H> | null): Promise<N | H>\n    {\n        return this._promise.then(onFulfilled, onRejected);\n    }\n    public catch<H = R>(onRejected?: RejectedHandler<R, H> | null): Promise<F | R | H>\n    {\n        return this._promise.catch(onRejected);\n    }\n    public finally(onFinally?: (() => void) | null): Promise<F | R>\n    {\n        return this._promise.finally(onFinally);\n    }\n\n    public watch(promise: Promise<T>): this\n    {\n        promise.then(this.resolve, this.reject);\n\n        return this;\n    }\n\n    public get [Symbol.toStringTag]()\n    {\n        return \"DeferredPromise\";\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                // 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                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 type { GeneratorFunction } from \"../types.js\";\n\nexport default class SmartIterator<T, R = void, N = undefined> implements Iterator<T, R, N>\n{\n    protected _iterator: Iterator<T, R, N>;\n\n    public return?: (value?: R) => IteratorResult<T, R>;\n    public throw?: (error?: unknown) => IteratorResult<T, R>;\n\n    public constructor(iterable: Iterable<T>);\n    public constructor(iterator: Iterator<T, R, N>);\n    public constructor(generatorFn: GeneratorFunction<T, R, N>);\n    public constructor(iterable: Iterable<T> | Iterator<T, R, N> | GeneratorFunction<T, R, N>)\n    {\n        if (iterable instanceof Function)\n        {\n            this._iterator = iterable();\n        }\n        else if (Symbol.iterator in iterable)\n        {\n            this._iterator = iterable[Symbol.iterator]() as Iterator<T, R, N>;\n        }\n        else\n        {\n            this._iterator = iterable;\n        }\n\n        if (this._iterator.return) { this.return = (value?: R) => this._iterator.return!(value); }\n        if (this._iterator.throw) { this.throw = (error?: unknown) => this._iterator.throw!(error); }\n    }\n\n    public filter(callback: (value: T, index: number) => boolean): SmartIterator<T, R, N>\n    {\n        let index = 0;\n        const iterator = this._iterator;\n\n        return new SmartIterator<T, R, N>({\n            *[Symbol.iterator]()\n            {\n                while (true)\n                {\n                    const result = iterator.next();\n                    if (result.done) { return result.value; }\n\n                    if (callback(result.value, index))\n                    {\n                        yield result.value;\n                    }\n\n                    index += 1;\n                }\n            }\n        });\n    }\n    public map<V>(callback: (value: T, index: number) => V): SmartIterator<V, R>\n    {\n        let index = 0;\n        const iterator = this._iterator;\n\n        return new SmartIterator<V, R>({\n            *[Symbol.iterator]()\n            {\n                while (true)\n                {\n                    const result = iterator.next();\n                    if (result.done) { return result.value; }\n\n                    yield callback(result.value, index);\n\n                    index += 1;\n                }\n            }\n        });\n    }\n    public reduce<U>(callback: (accumulator: U, value: T, index: number) => U, initialValue: U): U\n    {\n        let index = 0;\n        let accumulator = initialValue;\n\n        // eslint-disable-next-line no-constant-condition\n        while (true)\n        {\n            const result = this._iterator.next();\n            if (result.done) { return accumulator; }\n\n            accumulator = callback(accumulator, result.value, index);\n\n            index += 1;\n        }\n    }\n\n    public forEach(callback: (value: T, index: number) => void): void\n    {\n        let index = 0;\n\n        // eslint-disable-next-line no-constant-condition\n        while (true)\n        {\n            const result = this._iterator.next();\n            if (result.done) { return; }\n\n            callback(result.value, index);\n\n            index += 1;\n        }\n    }\n\n    public next(...values: N extends undefined ? [] : [N]): IteratorResult<T, R>\n    {\n        return this._iterator.next(...values);\n    }\n\n    public [Symbol.iterator](): SmartIterator<T, R, N> { return this; }\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","import { SmartIterator } from \"../models/index.js\";\n\nexport 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): number\n{\n    return Math.floor((end.getTime() - start.getTime()) / unit);\n}\n\nexport function dateRange(start: Date, end: Date, offset = DateUnit.Day): SmartIterator<Date>\n{\n    return new SmartIterator<Date>(function* ()\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}\n\nexport function dateRound(date: Date, unit = DateUnit.Day): Date\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","import { SmartIterator } from \"../models/index.js\";\n\nexport 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): SmartIterator<number>;\nexport function range(start: number, end: number): SmartIterator<number>;\nexport function range(start: number, end: number, step: number): SmartIterator<number>;\nexport function range(start: number, end?: number, step = 1): SmartIterator<number>\n{\n    return new SmartIterator<number>(function* ()\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}\n\nexport function shuffle<T>(iterable: Iterable<T>): T[]\n{\n    const array = [...iterable];\n\n    for (let index = array.length - 1; index > 0; index -= 1)\n    {\n        const jndex = Math.floor(Math.random() * (index + 1));\n\n        [array[index], array[jndex]] = [array[jndex], array[index]];\n    }\n\n    return array;\n}\n\nexport function unique<T>(elements: Iterable<T>): SmartIterator<T>\n{\n    return new SmartIterator<T>(function* ()\n    {\n        const seen = new Set<T>();\n\n        for (const element of elements)\n        {\n            if (seen.has(element)) { continue; }\n\n            seen.add(element);\n\n            yield element;\n        }\n    });\n}\n\nexport function zip<T, U>(first: Iterable<T>, second: Iterable<U>): SmartIterator<[T, U]>\n{\n    return new SmartIterator<[T, U]>(function* ()\n    {\n        const firstIterator = first[Symbol.iterator]();\n        const secondIterator = second[Symbol.iterator]();\n\n        while (true)\n        {\n            const firstResult = firstIterator.next();\n            const secondResult = secondIterator.next();\n\n            if ((firstResult.done) || (secondResult.done)) { break; }\n\n            yield [firstResult.value, secondResult.value];\n        }\n    });\n}\n","import { zip } from \"./iterator.js\";\n\nexport function average<T extends number>(values: Iterable<T>): number;\nexport function average<T extends number>(values: Iterable<T>, weights: Iterable<number>): number;\nexport function average<T extends number>(values: Iterable<T>, weights?: Iterable<number>): number\n{\n    if (weights === undefined)\n    {\n        let _sum = 0;\n        let _count = 0;\n\n        for (const value of values)\n        {\n            _sum += value;\n            _count += 1;\n        }\n\n        return _sum / _count;\n    }\n\n    let _sum = 0;\n    let _count = 0;\n\n    for (const [value, weight] of zip(values, weights))\n    {\n        _sum += value * weight;\n        _count += weight;\n    }\n\n    return _sum / _count;\n}\n\nexport function hash(value: string): number\n{\n    let hashedValue = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hashedValue = ((hashedValue << 5) - hashedValue) + char;\n        hashedValue |= 0;\n    }\n\n    return hashedValue;\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\nexport function sum<T extends number>(values: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of values) { _sum += value; }\n\n    return _sum;\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.2.0-rc.1\";\n\nexport { DeferredPromise, Exception, JsonStorage, SmartIterator, Subscribers } from \"./models/index.js\";\nexport {\n    average,\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    shuffle,\n    sum,\n    unique,\n    zip\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","resolve","reject","onFinally","promise","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","SmartIterator","iterable","value","callback","index","iterator","result","initialValue","accumulator","values","Subscribers","subscriber","args","delay","milliseconds","nextAnimationFrame","DateUnit","dateDifference","start","end","unit","dateRange","offset","endTime","unixTime","dateRound","date","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","step","shuffle","array","jndex","unique","seen","element","zip","first","second","firstIterator","secondIterator","firstResult","secondResult","average","weights","_sum","weight","hash","hashedValue","i","char","random","min","max","decimals","rounder","digits","sum","capitalize","VERSION"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byloth/core",
-  "version": "1.1.7",
+  "version": "1.2.0-rc.1",
   "description": "An unopinionated collection of useful functions and classes that I use widely in all my projects. 🔧",
   "keywords": [
     "Core",
@@ -56,11 +56,11 @@
     "ci": "yarn install --frozen-lockfile"
   },
   "devDependencies": {
-    "@byloth/eslint-config-typescript": "^2.6.7",
-    "@typescript-eslint/eslint-plugin": "^6.12.0",
-    "@typescript-eslint/parser": "^6.12.0",
-    "eslint": "^8.54.0",
-    "typescript": "^5.3.2",
-    "vite": "^5.0.2"
+    "@byloth/eslint-config-typescript": "^2.6.8",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "typescript": "^5.3.3",
+    "vite": "^5.0.10"
   }
 }

package/src/index.ts

@@ -1,7 +1,8 @@
-export const VERSION = "1.1.7";
+export const VERSION = "1.2.0-rc.1";
 
-export { DeferredPromise, Exception, JsonStorage, Subscribers } from "./models/index.js";
+export { DeferredPromise, Exception, JsonStorage, SmartIterator, Subscribers } from "./models/index.js";
 export {
+    average,
     capitalize,
     count,
     delay,
@@ -14,8 +15,10 @@ export {
     nextAnimationFrame,
     random,
     range,
+    shuffle,
     sum,
-    unique
+    unique,
+    zip
 
 } from "./utils/index.js";
 

package/src/models/index.ts

@@ -1,6 +1,7 @@
 import DeferredPromise from "./deferred-promise.js";
 import Exception from "./exception.js";
 import JsonStorage from "./json-storage.js";
+import SmartIterator from "./smart-iterator.js";
 import Subscribers from "./subscribers.js";
 
-export { DeferredPromise, Exception, JsonStorage, Subscribers };
+export { DeferredPromise, Exception, JsonStorage, SmartIterator, Subscribers };

package/src/models/smart-iterator.ts

@@ -0,0 +1,114 @@
+import type { GeneratorFunction } from "../types.js";
+
+export default class SmartIterator<T, R = void, N = undefined> implements Iterator<T, R, N>
+{
+    protected _iterator: Iterator<T, R, N>;
+
+    public return?: (value?: R) => IteratorResult<T, R>;
+    public throw?: (error?: unknown) => IteratorResult<T, R>;
+
+    public constructor(iterable: Iterable<T>);
+    public constructor(iterator: Iterator<T, R, N>);
+    public constructor(generatorFn: GeneratorFunction<T, R, N>);
+    public constructor(iterable: Iterable<T> | Iterator<T, R, N> | GeneratorFunction<T, R, N>)
+    {
+        if (iterable instanceof Function)
+        {
+            this._iterator = iterable();
+        }
+        else if (Symbol.iterator in iterable)
+        {
+            this._iterator = iterable[Symbol.iterator]() as Iterator<T, R, N>;
+        }
+        else
+        {
+            this._iterator = iterable;
+        }
+
+        if (this._iterator.return) { this.return = (value?: R) => this._iterator.return!(value); }
+        if (this._iterator.throw) { this.throw = (error?: unknown) => this._iterator.throw!(error); }
+    }
+
+    public filter(callback: (value: T, index: number) => boolean): SmartIterator<T, R, N>
+    {
+        let index = 0;
+        const iterator = this._iterator;
+
+        return new SmartIterator<T, R, N>({
+            *[Symbol.iterator]()
+            {
+                while (true)
+                {
+                    const result = iterator.next();
+                    if (result.done) { return result.value; }
+
+                    if (callback(result.value, index))
+                    {
+                        yield result.value;
+                    }
+
+                    index += 1;
+                }
+            }
+        });
+    }
+    public map<V>(callback: (value: T, index: number) => V): SmartIterator<V, R>
+    {
+        let index = 0;
+        const iterator = this._iterator;
+
+        return new SmartIterator<V, R>({
+            *[Symbol.iterator]()
+            {
+                while (true)
+                {
+                    const result = iterator.next();
+                    if (result.done) { return result.value; }
+
+                    yield callback(result.value, index);
+
+                    index += 1;
+                }
+            }
+        });
+    }
+    public reduce<U>(callback: (accumulator: U, value: T, index: number) => U, initialValue: U): U
+    {
+        let index = 0;
+        let accumulator = initialValue;
+
+        // eslint-disable-next-line no-constant-condition
+        while (true)
+        {
+            const result = this._iterator.next();
+            if (result.done) { return accumulator; }
+
+            accumulator = callback(accumulator, result.value, index);
+
+            index += 1;
+        }
+    }
+
+    public forEach(callback: (value: T, index: number) => void): void
+    {
+        let index = 0;
+
+        // eslint-disable-next-line no-constant-condition
+        while (true)
+        {
+            const result = this._iterator.next();
+            if (result.done) { return; }
+
+            callback(result.value, index);
+
+            index += 1;
+        }
+    }
+
+    public next(...values: N extends undefined ? [] : [N]): IteratorResult<T, R>
+    {
+        return this._iterator.next(...values);
+    }
+
+    public [Symbol.iterator](): SmartIterator<T, R, N> { return this; }
+}

package/src/types.ts

@@ -1,4 +1,6 @@
-export type Constructor<T extends object, P extends Array<unknown> = []> = new (...args: P) => T;
+export type Constructor<T extends object, P extends unknown[] = []> = new (...args: P) => T;
+export type GeneratorFunction<T, R = void, N = undefined> = () => Generator<T, R, N>;
+
 export type MaybePromise<T> = T | PromiseLike<T>;
 
 export type FulfilledHandler<T = void, R = T> = (value: T) => MaybePromise<R>;

package/src/utils/date.ts

@@ -1,3 +1,5 @@
+import { SmartIterator } from "../models/index.js";
+
 export enum DateUnit
 {
     Second = 1000,
@@ -9,25 +11,28 @@ export enum DateUnit
     Year = 365 * Day
 }
 
-export function dateDifference(start: Date, end: Date, unit = DateUnit.Day)
+export function dateDifference(start: Date, end: Date, unit = DateUnit.Day): number
 {
     return Math.floor((end.getTime() - start.getTime()) / unit);
 }
 
-export function* dateRange(start: Date, end: Date, offset = DateUnit.Day)
+export function dateRange(start: Date, end: Date, offset = DateUnit.Day): SmartIterator<Date>
 {
-    const endTime = end.getTime();
-
-    let unixTime: number = start.getTime();
-    while (unixTime < endTime)
+    return new SmartIterator<Date>(function* ()
     {
-        yield new Date(unixTime);
+        const endTime = end.getTime();
+
+        let unixTime: number = start.getTime();
+        while (unixTime < endTime)
+        {
+            yield new Date(unixTime);
 
-        unixTime += offset;
-    }
+            unixTime += offset;
+        }
+    });
 }
 
-export function dateRound(date: Date, unit = DateUnit.Day)
+export function dateRound(date: Date, unit = DateUnit.Day): Date
 {
     return new Date(Math.floor(date.getTime() / unit) * unit);
 }

package/src/utils/index.ts

@@ -1,6 +1,6 @@
 export { delay, nextAnimationFrame } from "./async.js";
 export { dateDifference, dateRange, dateRound, DateUnit } from "./date.js";
 export { loadScript } from "./dom.js";
-export { count, range, sum, unique } from "./iterator.js";
-export { hash, random } from "./math.js";
+export { count, range, shuffle, unique, zip } from "./iterator.js";
+export { average, hash, random, sum } from "./math.js";
 export { capitalize } from "./string.js";

package/src/utils/iterator.ts

@@ -1,3 +1,5 @@
+import { SmartIterator } from "../models/index.js";
+
 export function count<T>(elements: Iterable<T>): number
 {
     if (Array.isArray(elements)) { return elements.length; }
@@ -8,31 +10,71 @@ export function count<T>(elements: Iterable<T>): number
     return _count;
 }
 
-export function range(end: number): Generator<number, void>;
-export function range(start: number, end: number): Generator<number, void>;
-export function range(start: number, end: number, step: number): Generator<number, void>;
-export function* range(start: number, end?: number, step = 1): Generator<number, void>
+export function range(end: number): SmartIterator<number>;
+export function range(start: number, end: number): SmartIterator<number>;
+export function range(start: number, end: number, step: number): SmartIterator<number>;
+export function range(start: number, end?: number, step = 1): SmartIterator<number>
 {
-    if (end === undefined)
+    return new SmartIterator<number>(function* ()
     {
-        end = start;
-        start = 0;
-    }
+        if (end === undefined)
+        {
+            end = start;
+            start = 0;
+        }
 
-    if (start > end) { step = step ?? -1; }
+        if (start > end) { step = step ?? -1; }
 
-    for (let index = start; index < end; index += step) { yield index; }
+        for (let index = start; index < end; index += step) { yield index; }
+    });
 }
 
-export function sum<T extends number>(elements: Iterable<T>): number
+export function shuffle<T>(iterable: Iterable<T>): T[]
 {
-    let _sum = 0;
-    for (const value of elements) { _sum += value; }
+    const array = [...iterable];
 
-    return _sum;
+    for (let index = array.length - 1; index > 0; index -= 1)
+    {
+        const jndex = Math.floor(Math.random() * (index + 1));
+
+        [array[index], array[jndex]] = [array[jndex], array[index]];
+    }
+
+    return array;
 }
 
-export function unique<T>(elements: Iterable<T>): T[]
+export function unique<T>(elements: Iterable<T>): SmartIterator<T>
 {
-    return [...new Set(elements)];
+    return new SmartIterator<T>(function* ()
+    {
+        const seen = new Set<T>();
+
+        for (const element of elements)
+        {
+            if (seen.has(element)) { continue; }
+
+            seen.add(element);
+
+            yield element;
+        }
+    });
+}
+
+export function zip<T, U>(first: Iterable<T>, second: Iterable<U>): SmartIterator<[T, U]>
+{
+    return new SmartIterator<[T, U]>(function* ()
+    {
+        const firstIterator = first[Symbol.iterator]();
+        const secondIterator = second[Symbol.iterator]();
+
+        while (true)
+        {
+            const firstResult = firstIterator.next();
+            const secondResult = secondIterator.next();
+
+            if ((firstResult.done) || (secondResult.done)) { break; }
+
+            yield [firstResult.value, secondResult.value];
+        }
+    });
 }

package/src/utils/math.ts

@@ -1,3 +1,35 @@
+import { zip } from "./iterator.js";
+
+export function average<T extends number>(values: Iterable<T>): number;
+export function average<T extends number>(values: Iterable<T>, weights: Iterable<number>): number;
+export function average<T extends number>(values: Iterable<T>, weights?: Iterable<number>): number
+{
+    if (weights === undefined)
+    {
+        let _sum = 0;
+        let _count = 0;
+
+        for (const value of values)
+        {
+            _sum += value;
+            _count += 1;
+        }
+
+        return _sum / _count;
+    }
+
+    let _sum = 0;
+    let _count = 0;
+
+    for (const [value, weight] of zip(values, weights))
+    {
+        _sum += value * weight;
+        _count += weight;
+    }
+
+    return _sum / _count;
+}
+
 export function hash(value: string): number
 {
     let hashedValue = 0;
@@ -59,3 +91,11 @@ export function random(min: number = 1, max?: number, decimals?: boolean | numbe
 
     return rounder(Math.random() * (max - min) + min);
 }
+
+export function sum<T extends number>(values: Iterable<T>): number
+{
+    let _sum = 0;
+    for (const value of values) { _sum += value; }
+
+    return _sum;
+}