@byloth/core 1.0.4 → 1.1.0

package/dist/core.js

@@ -3,13 +3,13 @@ var h = (s, e, t) => e in s ? a(s, e, { enumerable: !0, configurable: !0, writab
 var n = (s, e, t) => (h(s, typeof e != "symbol" ? e + "" : e, t), t);
 class f extends Promise {
   constructor(t) {
-    let r, i, o;
-    t ? o = (c, u) => {
-      r = c, i = u, t(c, u);
-    } : o = (c, u) => {
-      r = c, i = u;
+    let r, i, c;
+    t ? c = (u, l) => {
+      r = u, i = l, t(u, l);
+    } : c = (u, l) => {
+      r = u, i = l;
     };
-    super(o);
+    super(c);
     n(this, "_resolve");
     n(this, "_reject");
     this._resolve = r, this._reject = i;
@@ -30,15 +30,15 @@ class f extends Promise {
     return super.finally(t), this;
   }
 }
-class l extends Error {
+class o extends Error {
   static FromUnknown(e) {
-    if (e instanceof l)
+    if (e instanceof o)
       return e;
     if (e instanceof Error) {
-      const t = new l(e.message);
+      const t = new o(e.message);
       return t.stack = e.stack, t.name = e.name, t;
     }
-    return new l(`${e}`);
+    return new o(`${e}`);
   }
   constructor(e, t, r = "Exception") {
     super(e), this.cause = t, this.name = r, t && (t instanceof Error ? this.stack += `
@@ -192,7 +192,7 @@ class d {
   remove(e) {
     const t = this._subscribers.indexOf(e);
     if (t < 0)
-      throw new Error("Unable to remove the requested subscriber. It was not found.");
+      throw new o("Unable to remove the requested subscriber. It was not found.");
     this._subscribers.splice(t, 1);
   }
   call(...e) {
@@ -244,10 +244,10 @@ function x(s) {
 function P(s) {
   return `${s.charAt(0).toUpperCase()}${s.slice(1)}`;
 }
-const S = "1.0.4";
+const S = "1.1.0";
 export {
   f as DeferredPromise,
-  l as Exception,
+  o as Exception,
   m as JsonStorage,
   d as Subscribers,
   S as VERSION,

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

package/dist/core.umd.cjs

@@ -2,5 +2,5 @@
 
 Caused by ${t.stack}`:this.stack+=`
 
-Caused by ${t}`)}}class f{constructor(e=!0){u(this,"_preferPersistence");u(this,"_volatile");u(this,"_persistent");this._preferPersistence=e,this._volatile=window.sessionStorage,this._persistent=window.localStorage}_get(e,t,i){const n=e.getItem(t);if(n)try{return JSON.parse(n)}catch{e.removeItem(t)}return i}_set(e,t,i){const n=JSON.stringify(i);n?e.setItem(t,n):e.removeItem(t)}get(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;return this._get(n,e,t)}recall(e,t){return this._get(this._volatile,e,t)}retrieve(e,t){return this.recall(e)??this.read(e,t)}read(e,t){return this._get(this._persistent,e,t)}has(e,t){return(t?this._persistent:this._volatile).getItem(e)!==null}knows(e){return this._volatile.getItem(e)!==null}find(e){return this.knows(e)??this.exists(e)}exists(e){return this._persistent.getItem(e)!==null}set(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;this._set(n,e,t)}remember(e,t){this._set(this._volatile,e,t)}write(e,t){this._set(this._persistent,e,t)}forget(e){this._volatile.removeItem(e)}erase(e){this._persistent.removeItem(e)}clear(e){this._volatile.removeItem(e),this._persistent.removeItem(e)}}class _{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 Error("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 m(){return new Promise((r,e)=>requestAnimationFrame(()=>r()))}async function g(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 b(r){if("length"in r)return r.length;let e=0;for(const t of r)e+=1;return e}function*v(r,e,t){r>e?t=t??-1:t=t??1;for(let i=r;i<e;i+=t)yield i}function p(r){let e=0;for(const t of r)e+=t;return e}function w(r){return[...new Set(r)]}function y(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 S(r){return`${r.charAt(0).toUpperCase()}${r.slice(1)}`}const I="1.0.4";s.DeferredPromise=o,s.Exception=c,s.JsonStorage=f,s.Subscribers=_,s.VERSION=I,s.capitalize=S,s.count=b,s.delay=d,s.hash=y,s.loadScript=g,s.nextAnimationFrame=m,s.range=v,s.sum=p,s.unique=w,Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
+Caused by ${t}`)}}class f{constructor(e=!0){u(this,"_preferPersistence");u(this,"_volatile");u(this,"_persistent");this._preferPersistence=e,this._volatile=window.sessionStorage,this._persistent=window.localStorage}_get(e,t,i){const n=e.getItem(t);if(n)try{return JSON.parse(n)}catch{e.removeItem(t)}return i}_set(e,t,i){const n=JSON.stringify(i);n?e.setItem(t,n):e.removeItem(t)}get(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;return this._get(n,e,t)}recall(e,t){return this._get(this._volatile,e,t)}retrieve(e,t){return this.recall(e)??this.read(e,t)}read(e,t){return this._get(this._persistent,e,t)}has(e,t){return(t?this._persistent:this._volatile).getItem(e)!==null}knows(e){return this._volatile.getItem(e)!==null}find(e){return this.knows(e)??this.exists(e)}exists(e){return this._persistent.getItem(e)!==null}set(e,t,i=this._preferPersistence){const n=i?this._persistent:this._volatile;this._set(n,e,t)}remember(e,t){this._set(this._volatile,e,t)}write(e,t){this._set(this._persistent,e,t)}forget(e){this._volatile.removeItem(e)}erase(e){this._persistent.removeItem(e)}clear(e){this._volatile.removeItem(e),this._persistent.removeItem(e)}}class _{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 m(){return new Promise((r,e)=>requestAnimationFrame(()=>r()))}async function g(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 b(r){if("length"in r)return r.length;let e=0;for(const t of r)e+=1;return e}function*v(r,e,t){r>e?t=t??-1:t=t??1;for(let i=r;i<e;i+=t)yield i}function p(r){let e=0;for(const t of r)e+=t;return e}function w(r){return[...new Set(r)]}function y(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 S(r){return`${r.charAt(0).toUpperCase()}${r.slice(1)}`}const I="1.1.0";s.DeferredPromise=o,s.Exception=c,s.JsonStorage=f,s.Subscribers=_,s.VERSION=I,s.capitalize=S,s.count=b,s.delay=d,s.hash=y,s.loadScript=g,s.nextAnimationFrame=m,s.range=v,s.sum=p,s.unique=w,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/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type { PromiseExecutor, PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from \"../types\";\n\nexport default class DeferredPromise<T, E = unknown> extends Promise<T>\n{\n    protected _resolve: PromiseResolver<T>;\n    protected _reject: PromiseRejecter<E>;\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 constructor(executor?: PromiseExecutor<T>)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        let _executor: PromiseExecutor<T>;\n\n        if (executor)\n        {\n            _executor = (resolve, reject) =>\n            {\n                _resolve = resolve;\n                _reject = reject;\n\n                executor(resolve, reject);\n            };\n        }\n        else\n        {\n            _executor = (resolve, reject) =>\n            {\n                _resolve = resolve;\n                _reject = reject;\n            };\n        }\n\n        super(_executor);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public then<F = T, R = E>(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R>)\n        : DeferredPromise<F, R>\n    {\n        super.then(onFulfilled, onRejected);\n\n        return (this as unknown) as DeferredPromise<F, R>;\n    }\n    public catch<R = E>(onRejected?: RejectedHandler<E, R>): DeferredPromise<T, R>\n    {\n        super.catch(onRejected);\n\n        return (this as unknown) as DeferredPromise<T, R>;\n    }\n    public finally(onFinally?: (() => void) | null): DeferredPromise<T, E>\n    {\n        super.finally(onFinally);\n\n        return this;\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","export 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 Error(\"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 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 (\"length\" in elements) { return elements.length as number; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function* range(start: number, end: number, step?: number): Iterable<number>\n{\n    if (start > end) { step = step ?? -1; }\n    else { step = step ?? 1; }\n\n    for (let i = start; i < end; i += step) { yield i; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.0.4\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models\";\nexport {\n    capitalize,\n    count,\n    delay,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    range,\n    sum,\n    unique\n\n} from \"./utils\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types\";\n"],"names":["DeferredPromise","executor","_resolve","_reject","_executor","resolve","reject","__publicField","onFulfilled","onRejected","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","start","end","step","sum","_sum","value","unique","hash","i","char","capitalize","VERSION"],"mappings":"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"}
+{"version":3,"file":"core.umd.cjs","sources":["../src/models/deferred-promise.ts","../src/models/exception.ts","../src/models/json-storage.ts","../src/models/subscribers.ts","../src/utils/async.ts","../src/utils/dom.ts","../src/utils/iterator.ts","../src/utils/math.ts","../src/utils/string.ts","../src/index.ts"],"sourcesContent":["import type { PromiseExecutor, PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from \"../types.js\";\n\nexport default class DeferredPromise<T, E = unknown> extends Promise<T>\n{\n    protected _resolve: PromiseResolver<T>;\n    protected _reject: PromiseRejecter<E>;\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 constructor(executor?: PromiseExecutor<T>)\n    {\n        let _resolve: PromiseResolver<T>;\n        let _reject: PromiseRejecter<E>;\n\n        let _executor: PromiseExecutor<T>;\n\n        if (executor)\n        {\n            _executor = (resolve, reject) =>\n            {\n                _resolve = resolve;\n                _reject = reject;\n\n                executor(resolve, reject);\n            };\n        }\n        else\n        {\n            _executor = (resolve, reject) =>\n            {\n                _resolve = resolve;\n                _reject = reject;\n            };\n        }\n\n        super(_executor);\n\n        this._resolve = _resolve!;\n        this._reject = _reject!;\n    }\n\n    public then<F = T, R = E>(onFulfilled?: FulfilledHandler<T, F> | null, onRejected?: RejectedHandler<E, R>)\n        : DeferredPromise<F, R>\n    {\n        super.then(onFulfilled, onRejected);\n\n        return (this as unknown) as DeferredPromise<F, R>;\n    }\n    public catch<R = E>(onRejected?: RejectedHandler<E, R>): DeferredPromise<T, R>\n    {\n        super.catch(onRejected);\n\n        return (this as unknown) as DeferredPromise<T, R>;\n    }\n    public finally(onFinally?: (() => void) | null): DeferredPromise<T, E>\n    {\n        super.finally(onFinally);\n\n        return this;\n    }\n}\n","export default class Exception extends Error\n{\n    public static FromUnknown(error: unknown): Exception\n    {\n        if (error instanceof Exception)\n        {\n            return error;\n        }\n        if (error instanceof Error)\n        {\n            const exc = new Exception(error.message);\n\n            exc.stack = error.stack;\n            exc.name = error.name;\n\n            return exc;\n        }\n\n        return new Exception(`${error}`);\n    }\n\n    public constructor(message: string, cause?: unknown, name = \"Exception\")\n    {\n        super(message);\n\n        this.cause = cause;\n        this.name = name;\n\n        if (cause)\n        {\n            if (cause instanceof Error)\n            {\n                this.stack += `\\n\\nCaused by ${cause.stack}`;\n            }\n            else\n            {\n                this.stack += `\\n\\nCaused by ${cause}`;\n            }\n        }\n    }\n}\n","/* eslint-disable no-trailing-spaces */\n\n/**\n * A wrapper around the `Storage` API to store and retrieve JSON values.\n *\n * It allows to handle either the `sessionStorage` or the `localStorage`\n * storage at the same time, depending on the required use case.\n */\nexport default class JsonStorage\n{\n    protected _preferPersistence: boolean;\n\n    protected _volatile: Storage;\n    protected _persistent: Storage;\n\n    public constructor(preferPersistence = true)\n    {\n        this._preferPersistence = preferPersistence;\n\n        this._volatile = window.sessionStorage;\n        this._persistent = window.localStorage;\n    }\n\n    protected _get<T>(storage: Storage, propertyName: string): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue: T): T;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined;\n    protected _get<T>(storage: Storage, propertyName: string, defaultValue?: T): T | undefined\n    {\n        const propertyValue = storage.getItem(propertyName);\n        if (propertyValue)\n        {\n            try\n            {\n                return JSON.parse(propertyValue);\n            }\n            catch (error)\n            {\n                if (import.meta.env.DEV)\n                {\n                    // eslint-disable-next-line no-console\n                    console.warn(\n                        `The \"${propertyValue}\" value for \"${propertyName}\"` +\n                        \" property cannot be parsed. Clearing the storage...\");\n                }\n\n                storage.removeItem(propertyName);\n            }\n        }\n\n        return defaultValue;\n    }\n    protected _set<T>(storage: Storage, propertyName: string, newValue?: T): void\n    {\n        const encodedValue = JSON.stringify(newValue);\n        if (encodedValue)\n        {\n            storage.setItem(propertyName, encodedValue);\n        }\n        else\n        {\n            storage.removeItem(propertyName);\n        }\n    }\n\n    /**\n     * Retrieves the value with the specified name from the corresponding storage.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public get<T>(propertyName: string, defaultValue: undefined, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue: T, persistent?: boolean): T ;\n    public get<T>(propertyName: string, defaultValue?: T, persistent?: boolean): T | undefined;\n    public get<T>(propertyName: string, defaultValue?: T, persistent = this._preferPersistence): T | undefined\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return this._get<T>(storage, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public recall<T>(propertyName: string): T | undefined;\n    public recall<T>(propertyName: string, defaultValue: T): T;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public recall<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._volatile, propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public retrieve<T>(propertyName: string): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue: T): T;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public retrieve<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this.recall<T>(propertyName) ?? this.read<T>(propertyName, defaultValue);\n    }\n    /**\n     * Retrieves the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to retrieve.\n     * @param defaultValue The default value to return if the property does not exist.\n     *\n     * @returns The value of the property or the default value if the property does not exist.\n     */\n    public read<T>(propertyName: string): T | undefined;\n    public read<T>(propertyName: string, defaultValue: T): T;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined;\n    public read<T>(propertyName: string, defaultValue?: T): T | undefined\n    {\n        return this._get<T>(this._persistent, propertyName, defaultValue);\n    }\n\n    /**\n     * Checks whether the property with the specified name exists in the corresponding storage.\n     *\n     * @param propertyName The name of the property to check.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public has(propertyName: string, persistent?: boolean): boolean\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        return storage.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists in the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public knows(propertyName: string): boolean\n    {\n        return this._volatile.getItem(propertyName) !== null;\n    }\n    /**\n     * Checks whether the property with the specified name exists looking first in the\n     * volatile `sessionStorage` and then in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public find(propertyName: string): boolean\n    {\n        return this.knows(propertyName) ?? this.exists(propertyName);\n    }\n    /**\n     * Checks whether the property with the specified name exists in the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to check.\n     *\n     * @returns `true` if the property exists, `false` otherwise.\n     */\n    public exists(propertyName: string): boolean\n    {\n        return this._persistent.getItem(propertyName) !== null;\n    }\n\n    /**\n     * Sets the value with the specified name in the corresponding storage.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     * @param persistent Whether to use the persistent `localStorage` or the volatile `sessionStorage`.\n     */\n    public set<T>(propertyName: string, newValue?: T, persistent = this._preferPersistence): void\n    {\n        const storage = persistent ? this._persistent : this._volatile;\n\n        this._set<T>(storage, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the volatile `sessionStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public remember<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._volatile, propertyName, newValue);\n    }\n    /**\n     * Sets the value with the specified name in the persistent `localStorage`.\n     * If the value is `undefined`, the property is removed from the storage.\n     *\n     * @param propertyName The name of the property to set.\n     * @param newValue The new value to set.\n     */\n    public write<T>(propertyName: string, newValue?: T): void\n    {\n        this._set<T>(this._persistent, propertyName, newValue);\n    }\n\n    /**\n     * Removes the value with the specified name from the volatile `sessionStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public forget(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from the persistent `localStorage`.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public erase(propertyName: string): void\n    {\n        this._persistent.removeItem(propertyName);\n    }\n    /**\n     * Removes the value with the specified name from all the storages.\n     *\n     * @param propertyName The name of the property to remove.\n     */\n    public clear(propertyName: string): void\n    {\n        this._volatile.removeItem(propertyName);\n        this._persistent.removeItem(propertyName);\n    }\n}\n","import Exception from \"./exception.js\";\n\nexport default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>\n{\n    protected _subscribers: T[];\n\n    public constructor()\n    {\n        this._subscribers = [];\n    }\n\n    public add(subscriber: T): void\n    {\n        this._subscribers.push(subscriber);\n    }\n    public remove(subscriber: T): void\n    {\n        const index = this._subscribers.indexOf(subscriber);\n        if (index < 0)\n        {\n            throw new Exception(\"Unable to remove the requested subscriber. It was not found.\");\n        }\n\n        this._subscribers.splice(index, 1);\n    }\n\n    public call(...args: P): R[]\n    {\n        return this._subscribers\n            .slice()\n            .map((subscriber) => subscriber(...args));\n    }\n}\n","export async function delay(milliseconds: number): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => setTimeout(resolve, milliseconds));\n}\n\nexport async function nextAnimationFrame(): Promise<void>\n{\n    return new Promise<void>((resolve, reject) => requestAnimationFrame(() => resolve()));\n}\n","export 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 (\"length\" in elements) { return elements.length as number; }\n\n    let _count = 0;\n    for (const _ of elements) { _count += 1; }\n\n    return _count;\n}\n\nexport function* range(start: number, end: number, step?: number): Iterable<number>\n{\n    if (start > end) { step = step ?? -1; }\n    else { step = step ?? 1; }\n\n    for (let i = start; i < end; i += step) { yield i; }\n}\n\nexport function sum<T extends number>(elements: Iterable<T>): number\n{\n    let _sum = 0;\n    for (const value of elements) { _sum += value; }\n\n    return _sum;\n}\n\nexport function unique<T>(elements: Iterable<T>): T[]\n{\n    return [...new Set(elements)];\n}\n","export function hash(value: string): number\n{\n    let hash = 0;\n    for (let i = 0; i < value.length; i++)\n    {\n        const char = value.charCodeAt(i);\n        hash = ((hash << 5) - hash) + char;\n        hash |= 0;\n    }\n\n    return hash;\n}\n","export function capitalize(value: string): string\n{\n    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;\n}\n","export const VERSION = \"1.1.0\";\n\nexport { DeferredPromise, Exception, JsonStorage, Subscribers } from \"./models/index.js\";\nexport {\n    capitalize,\n    count,\n    delay,\n    hash,\n    loadScript,\n    nextAnimationFrame,\n    range,\n    sum,\n    unique\n\n} from \"./utils/index.js\";\n\nexport type {\n    Constructor,\n    FulfilledHandler,\n    MaybePromise,\n    PromiseExecutor,\n    PromiseRejecter,\n    PromiseResolver,\n    RejectedHandler\n\n} from \"./types.js\";\n"],"names":["DeferredPromise","executor","_resolve","_reject","_executor","resolve","reject","__publicField","onFulfilled","onRejected","onFinally","Exception","error","exc","message","cause","name","JsonStorage","preferPersistence","storage","propertyName","defaultValue","propertyValue","newValue","encodedValue","persistent","Subscribers","subscriber","index","args","delay","milliseconds","nextAnimationFrame","loadScript","scriptUrl","scriptType","script","count","elements","_count","_","range","start","end","step","sum","_sum","value","unique","hash","i","char","capitalize","VERSION"],"mappings":"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"}

package/package.json

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

package/src/index.ts

@@ -1,6 +1,6 @@
-export const VERSION = "1.0.4";
+export const VERSION = "1.1.0";
 
-export { DeferredPromise, Exception, JsonStorage, Subscribers } from "./models";
+export { DeferredPromise, Exception, JsonStorage, Subscribers } from "./models/index.js";
 export {
     capitalize,
     count,
@@ -12,7 +12,7 @@ export {
     sum,
     unique
 
-} from "./utils";
+} from "./utils/index.js";
 
 export type {
     Constructor,
@@ -23,4 +23,4 @@ export type {
     PromiseResolver,
     RejectedHandler
 
-} from "./types";
+} from "./types.js";

package/src/models/deferred-promise.ts

@@ -1,4 +1,4 @@
-import type { PromiseExecutor, PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from "../types";
+import type { PromiseExecutor, PromiseResolver, PromiseRejecter, FulfilledHandler, RejectedHandler } from "../types.js";
 
 export default class DeferredPromise<T, E = unknown> extends Promise<T>
 {

package/src/models/index.ts

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

package/src/models/subscribers.ts

@@ -1,3 +1,5 @@
+import Exception from "./exception.js";
+
 export default class Subscribers<P extends unknown[] = [], R = void, T extends (...args: P) => R = (...args: P) => R>
 {
     protected _subscribers: T[];
@@ -16,7 +18,7 @@ export default class Subscribers<P extends unknown[] = [], R = void, T extends (
         const index = this._subscribers.indexOf(subscriber);
         if (index < 0)
         {
-            throw new Error("Unable to remove the requested subscriber. It was not found.");
+            throw new Exception("Unable to remove the requested subscriber. It was not found.");
         }
 
         this._subscribers.splice(index, 1);

package/src/utils/index.ts

@@ -1,5 +1,5 @@
-export { delay, nextAnimationFrame } from "./async";
-export { loadScript } from "./dom";
-export { count, range, sum, unique } from "./iterator";
-export { hash } from "./math";
-export { capitalize } from "./string";
+export { delay, nextAnimationFrame } from "./async.js";
+export { loadScript } from "./dom.js";
+export { count, range, sum, unique } from "./iterator.js";
+export { hash } from "./math.js";
+export { capitalize } from "./string.js";