@develia/commons 0.3.29 → 0.3.31

package/dist/develia-commons.js

@@ -24,7 +24,7 @@
      * @template TKey The type of the key.
      * @template TValue The type of the value.
      */
-    class Pair {
+    class KeyValuePair {
         get value() {
             return this._value;
         }
@@ -102,6 +102,54 @@
     function isFunction(value) {
         return typeof value === 'function';
     }
+    /**
+     * Compares two objects or arrays to check if they have the same fields and values,
+     * or the same elements if they are arrays.
+     *
+     * @param {any} a - The first object or array.
+     * @param {any} b - The second object or array.
+     * @return {boolean} - Returns true if the objects/arrays are equal, otherwise false.
+     */
+    function deepEqual(a, b) {
+        if (a === b) {
+            // If both values are strictly equal, return true
+            return true;
+        }
+        // If either value is null or their types differ, return false
+        if (a === null || b === null || typeof a !== typeof b) {
+            return false;
+        }
+        // Check if both values are arrays
+        if (Array.isArray(a) && Array.isArray(b)) {
+            // Compare lengths and elements recursively
+            if (a.length !== b.length) {
+                return false;
+            }
+            for (let i = 0; i < a.length; i++) {
+                if (!deepEqual(a[i], b[i])) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // Check if both values are objects
+        if (typeof a === "object" && typeof b === "object") {
+            const keysA = Object.keys(a);
+            const keysB = Object.keys(b);
+            // Compare the keys length and check if all keys/values match
+            if (keysA.length !== keysB.length) {
+                return false;
+            }
+            for (const key of keysA) {
+                if (!keysB.includes(key) || !deepEqual(a[key], b[key])) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // For all other data types (e.g., numbers, strings, booleans), use strict equality
+        return false;
+    }
     /**
      * Pauses the execution of an asynchronous function for a specified duration.
      *
@@ -211,12 +259,12 @@
      * Converts an object into an array of key-value pairs.
      *
      * @param {Record<string, any>} obj - The object to convert.
-     * @return {Pair<string, any>[]} - The array of key-value pairs.
+     * @return {KeyValuePair<string, any>[]} - The array of key-value pairs.
      */
     function toPairs(obj) {
         let output = [];
         for (const key in obj) {
-            output.push(new Pair(key, obj[key]));
+            output.push(new KeyValuePair(key, obj[key]));
         }
         return output;
     }
@@ -1193,6 +1241,7 @@
      * Represents a class for manipulating an array of items.
      *
      * @template T - The type of items in the array.
+     * @deprecated
      */
     class ArrayManipulator {
         constructor(array) {
@@ -1321,61 +1370,91 @@
     }
 
     class AsyncPoolExecutor {
-        constructor(maxConcurrency) {
+        get maxConcurrency() {
+            return this._maxConcurrency;
+        }
+        set maxConcurrency(value) {
+            this._maxConcurrency = value;
+        }
+        /**
+         * @param {number} maxConcurrency - The maximum number of concurrent tasks allowed.
+         * @param {number} [checkInterval=50] - The interval, in milliseconds, to check for capacity to run new tasks. Defaults to 50 ms.
+         */
+        constructor(maxConcurrency, checkInterval = 50) {
             this._taskQueue = [];
-            this._activeTasks = 0;
             this._maxConcurrency = maxConcurrency;
+            this._checkIntervalMs = checkInterval;
+            this._activeTasks = 0;
         }
         /**
          * Submits a deferred task to a queue for asynchronous execution and returns a Promise resolving to its result.
          * @template T
-         * @param {Deferred<T>} task - The deferred task to be executed asynchronously.
-         * @return {Promise<T>} A Promise that resolves with the result of the executed task, or rejects if an error occurs during execution.
+         * @param {Supplier<T>} task - The deferred task to be executed asynchronously.
          */
         submit(task) {
-            return new Promise((resolve, reject) => {
-                this._taskQueue.push(async () => {
-                    try {
-                        this._activeTasks++;
-                        resolve(await promisify(task));
-                    }
-                    catch (error) {
-                        reject(error);
+            this._taskQueue.push(task);
+            if (this._proccess != null)
+                return;
+            this._proccess = setTimeout(async () => {
+                while (this._taskQueue.length > 0) {
+                    while (this._activeTasks >= this._maxConcurrency) {
+                        await delay(this._checkIntervalMs);
                     }
-                    finally {
-                        this._activeTasks--;
-                        this._runNext(); // Intenta ejecutar la siguiente tarea
+                    const task = this._taskQueue.shift();
+                    if (task) {
+                        this._activeTasks++;
+                        setTimeout(async () => {
+                            try {
+                                await task();
+                            }
+                            finally {
+                                this._activeTasks--;
+                            }
+                        });
                     }
-                });
-                this._runNext();
-            });
-        }
-        _runNext() {
-            while (this._activeTasks < this._maxConcurrency && this._taskQueue.length > 0) {
-                const nextTask = this._taskQueue.shift();
-                nextTask && nextTask();
-            }
+                }
+                this._proccess = null;
+            }, 0);
         }
         /**
-         * Gracefully shuts down the system by waiting for all queued and active tasks to complete.
-         * The method ensures that no tasks remain in the queue and no tasks are actively running
-         * before resolving the promise.
+         * Waits until all tasks (both queued and active) are completed.
+         * This method resolves only when there are no pending tasks.
          *
-         * @return {Promise<void>} A promise that resolves when the shutdown process is complete.
+         * @return {Promise<void>} A promise that resolves when all tasks are complete.
          */
         async shutdown() {
             while (this._taskQueue.length > 0 || this._activeTasks > 0) {
-                await new Promise((resolve) => setTimeout(resolve, 50));
+                await delay(this._checkIntervalMs);
             }
         }
     }
 
+    /**
+     * Removes all given values from the provided array and returns the number of removed elements.
+     * The operation mutates the original array.
+     * @template T
+     * @param {Array<T>} array - The array to modify by removing specified items.
+     * @param {...T} items - The values to remove from the array.
+     * @return {number} The number of elements removed from the array.
+     */
+    function pull(array, ...items) {
+        let output = 0;
+        for (const item of items) {
+            const index = array.indexOf(item);
+            if (index !== -1) {
+                array.splice(index, 1);
+                output++;
+            }
+        }
+        return output;
+    }
+
     exports.ArrayManipulator = ArrayManipulator;
     exports.AsyncPoolExecutor = AsyncPoolExecutor;
     exports.CacheDictionary = CacheDictionary;
     exports.From = From;
+    exports.KeyValuePair = KeyValuePair;
     exports.Lazy = Lazy;
-    exports.Pair = Pair;
     exports.TimeSpan = TimeSpan;
     exports.Timer = Timer;
     exports.ajaxSubmission = ajaxSubmission;
@@ -1383,6 +1462,7 @@
     exports.array = array;
     exports.clamp = clamp;
     exports.deepClone = deepClone;
+    exports.deepEqual = deepEqual;
     exports.delay = delay;
     exports.ensurePrefix = ensurePrefix;
     exports.ensureSuffix = ensureSuffix;
@@ -1407,6 +1487,7 @@
     exports.lerp = lerp;
     exports.objectToFormData = objectToFormData;
     exports.promisify = promisify;
+    exports.pull = pull;
     exports.toPairs = toPairs;
 
 })(this.window = this.window || {});

package/dist/develia-commons.min.js

@@ -1 +1 @@
-!function(t){"use strict";var e;t.Type=void 0,(e=t.Type||(t.Type={})).Undefined="undefined",e.Number="number",e.String="string",e.Boolean="boolean",e.Object="object",e.Function="function",e.Symbol="symbol",e.BigInt="bigint",e.Null="null";class r{get value(){return this._value}get key(){return this._key}constructor(t,e){this._key=t,this._value=e}}function n(t){return"function"==typeof t}async function i(t){const e="string"==typeof t?document.querySelector(t):t;if(!(e instanceof HTMLFormElement))throw new Error("Invalid element.");return await fetch(e.action,{method:e.method,body:new FormData(e)})}function s(t){let e=[];for(const n in t)e.push(new r(n,t[n]));return e}function o(t){return t instanceof Promise?t:n(t)?new Promise(((e,r)=>{try{e(t())}catch(t){r(t)}})):Promise.resolve(t)}function l(t,e,r=""){for(const n in t)if(t.hasOwnProperty(n)){const i=t[n];i instanceof Date?e.append(r?`${r}[${n}]`:n,i.toISOString()):i instanceof File?e.append(r?`${r}[${n}]`:n,i):"object"!=typeof i||Array.isArray(i)?Array.isArray(i)?i.forEach(((t,i)=>{const s=`${r?`${r}[${n}]`:n}[${i}]`;"object"!=typeof t||Array.isArray(t)?e.append(s,t):l(t,e,s)})):e.append(r?`${r}[${n}]`:n,i):l(i,e,r?`${r}[${n}]`:n)}return e}class a{static object(t){return new a((function(){return s(t)}))}static _shallowEqual(t,e){const r=Object.keys(t),n=Object.keys(e);if(r.length!==n.length)return!1;for(let n of r)if(t[n]!==e[n])return!1;return!0}constructor(t){this._fn=t}static fn(t){return new a(t)}collect(){const t=Array.from(this);return a.iterable(t)}static iterable(t){return a.fn((function*(){for(const e of t)yield e}))}map(t){const e=this;return a.fn((function*(){for(let r of e)yield t(r)}))}*[Symbol.iterator](){yield*this._fn()}all(t){for(let e of this._fn())if(!t(e))return!1;return!0}any(t=void 0){for(let e of this)if(null==t||t(e))return!0;return!1}get length(){return this.count()}count(t=void 0){let e=0;for(let r of this)(null==t||t(r))&&e++;return e}filter(t){const e=this;return a.fn((function*(){for(let r of e)t(r)&&(yield r)}))}contains(t){for(let e of this)if(e===t)return!0;return!1}first(t){if(t){for(let e of this)if(!t||t(e))return e}else for(let t of this)return t}append(t){const e=this;return a.fn((function*(){for(let t of e)yield t;yield t}))}prepend(t){const e=this;return a.fn((function*(){yield t;for(let t of e)yield t}))}at(t){let e=0;for(let r of this)if(e++===t)return r}last(t){let e;if(t)for(let r of this)t&&!t(r)||(e=r);else for(let t of this)e=t;return e}mapMany(t){const e=this;return a.fn((function*(){for(const r of e){const e=t(r);for(const t of e)yield t}}))}flatten(){const t=this;return a.fn((function*(){for(let e of t){let t=e;for(let e of t)yield e}}))}sum(t){let e=0;if(t)for(let r of this)e+=t(r);else for(let t of this)e+=t;return e}avg(t){let e=0,r=0;if(t)for(let n of this)e+=t(n),r++;else for(let t of this)e+=t,r++;return r>0?e/r:0}max(t){let e=-1/0;for(let r of this){let n=t(r);e=n>e?n:e}return e}min(t){let e=1/0;for(let r of this){let n=t(r);e=n<e?n:e}return e}maxBy(t){let e,r=-1/0;for(let n of this){let i=t(n);i>r&&(r=i,e=n)}return e}minBy(t){let e,r=1/0;for(let n of this){let i=t(n);i<r&&(r=i,e=n)}return e}orderBy(t){const e=Array.from(this._fn());return e.sort(((e,r)=>{const n=t(e),i=t(r);return n>i?1:n<i?-1:0})),a.iterable(e)}groupBy(t,e){e=null==e?a._shallowEqual:e;const r=this;return a.fn((function*(){const n=[];for(let i of r){const r=t(i);let s=!1;for(let[t,o]of n)if(e(r,t)){o.push(i),s=!0;break}s||n.push([r,[i]])}yield*n.map((([t,e])=>new u(t,e)))}))}head(t){const e=this;return a.fn((function*(){let r=0;for(let n of e){if(!(r++<t))return;yield n}}))}tail(t){const e=this;return a.fn((function*(){let r=[];for(let n of e)r.push(n),r.length>t&&r.shift();yield*r}))}forEach(t){for(let e of this)t(e)}toArray(){return Array.from(this)}instancesOf(t){return this.filter((e=>typeof e===t))}allInstanceOf(t){for(let e of this)if(!(e instanceof t))return!1;return!0}distinct(t){null==t&&(t=a._shallowEqual);const e=this;return a.fn((function*(){const r=[];for(let n of e)a.iterable(r).any((e=>t(e,n)))||(r.push(n),yield n)}))}insert(t,e){const r=this;return a.fn((function*(){let n=0,i=!1;for(let s of r)n===e&&(yield t,i=!0),yield s,n++;i||(yield t)}))}skip(t){const e=this;return a.fn((function*(){let r=0;for(let n of e)r>=t&&(yield n),r++}))}union(t){const e=this;return a.fn((function*(){yield*e,yield*t}))}innerJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t)s.set(r(e),e);return Array.from(i).filter((t=>s.has(e(t)))).map((t=>n(t,s.get(e(t)))))}))}leftJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t)s.set(r(e),e);return Array.from(i).map((t=>n(t,s.get(e(t)))))}))}leftGroupJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t){const t=r(e);s.has(t)||s.set(t,[]),s.get(t).push(e)}return Array.from(i).map((t=>n(t,s.get(e(t))||[])))}))}rightGroupJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let t of i){const r=e(t);s.has(r)||s.set(r,[]),s.get(r).push(t)}return Array.from(t).map((t=>n(s.get(r(t))||[],t)))}))}rightJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let t of i)s.set(e(t),t);return Array.from(t).map((t=>n(s.get(r(t)),t)))}))}}class u extends a{get key(){return this._key}constructor(t,e){super((()=>e)),this._key=t}}class c{constructor(t){this.milliseconds=t}seconds(){return this.milliseconds/1e3}minutes(){return this.milliseconds/6e4}hours(){return this.milliseconds/36e5}days(){return this.milliseconds/864e5}weeks(){return this.milliseconds/6048e5}static fromMilliseconds(t){return new c(t)}static fromSeconds(t){return new c(1e3*t)}static fromMinutes(t){return new c(1e3*t*60)}static fromHours(t){return new c(1e3*t*60*60)}static fromDays(t){return new c(1e3*t*60*60*24)}static fromWeeks(t){return new c(1e3*t*60*60*24*7)}addMilliseconds(t){return new c(this.milliseconds+t)}addSeconds(t){return this.addMilliseconds(1e3*t)}addMinutes(t){return this.addMilliseconds(1e3*t*60)}addHours(t){return this.addMilliseconds(1e3*t*60*60)}addDays(t){return this.addMilliseconds(1e3*t*60*60*24)}addWeeks(t){return this.addMilliseconds(1e3*t*60*60*24*7)}subtractMilliseconds(t){return new c(this.milliseconds-t)}subtractSeconds(t){return this.subtractMilliseconds(1e3*t)}subtractMinutes(t){return this.subtractMilliseconds(1e3*t*60)}subtractHours(t){return this.subtractMilliseconds(1e3*t*60*60)}subtractDays(t){return this.subtractMilliseconds(1e3*t*60*60*24)}subtractWeeks(t){return this.subtractMilliseconds(1e3*t*60*60*24*7)}add(t){return new c(this.milliseconds+t.milliseconds)}subtract(t){return new c(this.milliseconds-t.milliseconds)}addTo(t){return new Date(t.getTime()+this.milliseconds)}subtractFrom(t){return new Date(t.getTime()-this.milliseconds)}static fromDifference(t,e){return new c(e.getTime()-t.getTime())}format(t="hh:mm:ss"){const e=t.toLowerCase(),r=e.includes("h"),n=e.includes("m");let i=0,s=0,o=Math.floor(this.milliseconds/1e3);r&&(i=Math.floor(o/3600),o-=3600*i),n&&(s=Math.floor(o/60),o-=60*s);const l=String(i).padStart(2,"0"),a=String(s).padStart(2,"0"),u=String(o).padStart(2,"0");return e.replace("hh",l).replace("h",i.toString()).replace("mm",a).replace("m",s.toString()).replace("ss",u).replace("s",o.toString())}eq(t){return this.milliseconds===t.milliseconds}le(t){return this.milliseconds<=t.milliseconds}lt(t){return this.milliseconds<t.milliseconds}ge(t){return this.milliseconds>=t.milliseconds}gt(t){return this.milliseconds>t.milliseconds}multiply(t){return new c(this.milliseconds*t)}divide(t){return new c(this.milliseconds/t)}abs(){return new c(Math.abs(this.milliseconds))}isInfinite(){return this.milliseconds===Number.POSITIVE_INFINITY||this.milliseconds===Number.NEGATIVE_INFINITY}isPositiveInfinite(){return this.milliseconds===Number.POSITIVE_INFINITY}isNegativeInfinite(){return this.milliseconds===Number.NEGATIVE_INFINITY}}c.INFINITE=new c(Number.POSITIVE_INFINITY),c.NEGATIVE_INFINITE=new c(Number.NEGATIVE_INFINITY);class f{constructor(t){this._array=t}[Symbol.iterator](){return this._array[Symbol.iterator]()}at(t,e=void 0){if(void 0===e)return this._array[t];this._array[t]=e}remove(t){const e=this._array.indexOf(t);return-1!==e&&this._array.splice(e,1),this}map(t){for(let e=0;e<this._array.length;e++)this._array[e]=t(this._array[e]);return this}filter(t){for(let e=0;e<this._array.length;e++)t(this._array[e])||(this._array.splice(e,1),e--);return this}head(t){return this._array.splice(t),this}slice(t,e=void 0){return this._array.splice(0,t),void 0!==e&&this._array.splice(e),this}mapMany(t){let e=0;for(;e<this._array.length;){let r=t(this._array[e]);Array.isArray(r)||(r=Array.from(r)),this._array.splice(e,1,...r),e+=r.length}return this}tail(t){const e=this._array.length-t;return this._array.splice(0,e),this}append(...t){return this._array.push(...t),this}prepend(...t){return this._array.unshift(...t),this}get array(){return this._array}}t.ArrayManipulator=f,t.AsyncPoolExecutor=class{constructor(t){this._taskQueue=[],this._activeTasks=0,this._maxConcurrency=t}submit(t){return new Promise(((e,r)=>{this._taskQueue.push((async()=>{try{this._activeTasks++,e(await o(t))}catch(t){r(t)}finally{this._activeTasks--,this._runNext()}})),this._runNext()}))}_runNext(){for(;this._activeTasks<this._maxConcurrency&&this._taskQueue.length>0;){const t=this._taskQueue.shift();t&&t()}}async shutdown(){for(;this._taskQueue.length>0||this._activeTasks>0;)await new Promise((t=>setTimeout(t,50)))}},t.CacheDictionary=class{constructor(t=null,e=null){this.fallback=t,this.cache={},this.defaultDuration=e,this.expiration={}}getExpiration(t){return this.expiration[t]}setExpiration(t,e){this.expiration[t]=e}setDuration(t,e){if(null===e)delete this.expiration[t];else{const r=new Date;r.setSeconds(r.getSeconds()+e),this.expiration[t]=r}}get(t){if(!this.cache.hasOwnProperty(t)){if(!this.fallback)return null;this.cache[t]=this.fallback(t),this.expiration[t]=this.calculateExpiration(this.defaultDuration)}return this.isExpired(t)?(this.remove(t),null):this.cache[t]}set(t,e,r=null){this.cache[t]=e,this.expiration[t]=this.calculateExpiration(r)}remove(t){delete this.cache[t],delete this.expiration[t]}isExpired(t){const e=this.expiration[t];return e instanceof Date&&e<new Date}calculateExpiration(t){if(null===t)return;const e=new Date;return e.setSeconds(e.getSeconds()+t),e}},t.From=a,t.Lazy=class{constructor(t){this._valueCreated=!1,this._value=null,this._factoryMethod=t}get valueCreated(){return this._valueCreated}get value(){return this._valueCreated||(this._value=this._factoryMethod(),this._valueCreated=!0),this._value}reset(){this._valueCreated=!1,this._value=null}},t.Pair=r,t.TimeSpan=c,t.Timer=class{constructor(t,e){this._callback=t,this._interval=e,this._intervalId=null}get running(){return null!==this._intervalId&&void 0!==this._intervalId}get interval(){return this._interval}set interval(t){t!=this._interval&&(this._interval=t,this.running&&this.restart())}get callback(){return this._callback}set callback(t){t!=this._callback&&(this._callback=t)}start(){null===this._intervalId&&(this._intervalId=setInterval((()=>{null!=this._callback&&this._callback()}),this._interval))}stop(){null!==this._intervalId&&(clearInterval(this._intervalId),this._intervalId=null)}restart(){this.stop(),this.start()}},t.ajaxSubmission=function(t,e=void 0,r=void 0){const n="string"==typeof t?document.querySelector(t):t;n instanceof HTMLFormElement&&n.addEventListener("submit",(async t=>{t.preventDefault();let s=i(n);s&&(e&&(s=s.then(e)),r&&s.catch(r))}))},t.ajaxSubmit=i,t.array=function(t){return new f(t)},t.clamp=function(t,e,r){return t<=e?e:t>=r?r:t},t.deepClone=function t(e){if(null===e||"object"!=typeof e)return e;if(Array.isArray(e)){const r=[];for(const n of e)r.push(t(n));return r}const r={};for(const n in e)e.hasOwnProperty(n)&&(r[n]=t(e[n]));return r},t.delay=async function(t){await new Promise((e=>setTimeout(e,t)))},t.ensurePrefix=function(t,e){return t.startsWith(e)?t:e+t},t.ensureSuffix=function(t,e){return t.endsWith(e)?t:t+e},t.format=function(t,...e){let r;return 1===e.length&&"object"==typeof e[0]?(e=e[0],r=/{(.+?)}/g):r=/{(\d+?)}/g,t.replace(r,((t,r)=>void 0!==e[r]?e[r]:""))},t.from=function(t){if(null==t)throw"Source is null.";if("function"==typeof t)return a.fn(t);if("function"==typeof t[Symbol.iterator])return a.iterable(t);if("object"==typeof t)return a.object(t);throw"Invalid source."},t.getType=function(e){return null===e?t.Type.Null:t.Type[typeof e]},t.isArray=function(t){return Array.isArray(t)},t.isBigInt=function(t){return"bigint"==typeof t},t.isBoolean=function(t){return"boolean"==typeof t},t.isDefined=function(t){return void 0!==t},t.isEmpty=function(t){return Array.isArray(t)&&0===t.length||"string"==typeof t&&""===t||null==t},t.isEmptyOrWhitespace=function(t){return Array.isArray(t)&&0===t.length||"string"==typeof t&&""===t.trim()||null==t},t.isFunction=n,t.isIterable=function(t){return"function"===t[Symbol.iterator]},t.isNull=function(t){return null===t},t.isNullOrUndefined=function(t){return null==t},t.isNumber=function(t){return"number"==typeof t},t.isObject=function(t){return null!=t&&"object"==typeof t&&!Array.isArray(t)},t.isString=function(t){return"string"==typeof t},t.isSymbol=function(t){return"symbol"==typeof t},t.isUndefined=function(t){return void 0===t},t.lerp=function(t,e,r,n,i){return n+(t-e)/(r-e)*(i-n)},t.objectToFormData=function(t){return l(t,new FormData)},t.promisify=o,t.toPairs=s}(this.window=this.window||{});
+!function(t){"use strict";var e;t.Type=void 0,(e=t.Type||(t.Type={})).Undefined="undefined",e.Number="number",e.String="string",e.Boolean="boolean",e.Object="object",e.Function="function",e.Symbol="symbol",e.BigInt="bigint",e.Null="null";class r{get value(){return this._value}get key(){return this._key}constructor(t,e){this._key=t,this._value=e}}function n(t){return"function"==typeof t}async function i(t){await new Promise((e=>setTimeout(e,t)))}async function s(t){const e="string"==typeof t?document.querySelector(t):t;if(!(e instanceof HTMLFormElement))throw new Error("Invalid element.");return await fetch(e.action,{method:e.method,body:new FormData(e)})}function o(t){let e=[];for(const n in t)e.push(new r(n,t[n]));return e}function l(t,e,r=""){for(const n in t)if(t.hasOwnProperty(n)){const i=t[n];i instanceof Date?e.append(r?`${r}[${n}]`:n,i.toISOString()):i instanceof File?e.append(r?`${r}[${n}]`:n,i):"object"!=typeof i||Array.isArray(i)?Array.isArray(i)?i.forEach(((t,i)=>{const s=`${r?`${r}[${n}]`:n}[${i}]`;"object"!=typeof t||Array.isArray(t)?e.append(s,t):l(t,e,s)})):e.append(r?`${r}[${n}]`:n,i):l(i,e,r?`${r}[${n}]`:n)}return e}class a{static object(t){return new a((function(){return o(t)}))}static _shallowEqual(t,e){const r=Object.keys(t),n=Object.keys(e);if(r.length!==n.length)return!1;for(let n of r)if(t[n]!==e[n])return!1;return!0}constructor(t){this._fn=t}static fn(t){return new a(t)}collect(){const t=Array.from(this);return a.iterable(t)}static iterable(t){return a.fn((function*(){for(const e of t)yield e}))}map(t){const e=this;return a.fn((function*(){for(let r of e)yield t(r)}))}*[Symbol.iterator](){yield*this._fn()}all(t){for(let e of this._fn())if(!t(e))return!1;return!0}any(t=void 0){for(let e of this)if(null==t||t(e))return!0;return!1}get length(){return this.count()}count(t=void 0){let e=0;for(let r of this)(null==t||t(r))&&e++;return e}filter(t){const e=this;return a.fn((function*(){for(let r of e)t(r)&&(yield r)}))}contains(t){for(let e of this)if(e===t)return!0;return!1}first(t){if(t){for(let e of this)if(!t||t(e))return e}else for(let t of this)return t}append(t){const e=this;return a.fn((function*(){for(let t of e)yield t;yield t}))}prepend(t){const e=this;return a.fn((function*(){yield t;for(let t of e)yield t}))}at(t){let e=0;for(let r of this)if(e++===t)return r}last(t){let e;if(t)for(let r of this)t&&!t(r)||(e=r);else for(let t of this)e=t;return e}mapMany(t){const e=this;return a.fn((function*(){for(const r of e){const e=t(r);for(const t of e)yield t}}))}flatten(){const t=this;return a.fn((function*(){for(let e of t){let t=e;for(let e of t)yield e}}))}sum(t){let e=0;if(t)for(let r of this)e+=t(r);else for(let t of this)e+=t;return e}avg(t){let e=0,r=0;if(t)for(let n of this)e+=t(n),r++;else for(let t of this)e+=t,r++;return r>0?e/r:0}max(t){let e=-1/0;for(let r of this){let n=t(r);e=n>e?n:e}return e}min(t){let e=1/0;for(let r of this){let n=t(r);e=n<e?n:e}return e}maxBy(t){let e,r=-1/0;for(let n of this){let i=t(n);i>r&&(r=i,e=n)}return e}minBy(t){let e,r=1/0;for(let n of this){let i=t(n);i<r&&(r=i,e=n)}return e}orderBy(t){const e=Array.from(this._fn());return e.sort(((e,r)=>{const n=t(e),i=t(r);return n>i?1:n<i?-1:0})),a.iterable(e)}groupBy(t,e){e=null==e?a._shallowEqual:e;const r=this;return a.fn((function*(){const n=[];for(let i of r){const r=t(i);let s=!1;for(let[t,o]of n)if(e(r,t)){o.push(i),s=!0;break}s||n.push([r,[i]])}yield*n.map((([t,e])=>new u(t,e)))}))}head(t){const e=this;return a.fn((function*(){let r=0;for(let n of e){if(!(r++<t))return;yield n}}))}tail(t){const e=this;return a.fn((function*(){let r=[];for(let n of e)r.push(n),r.length>t&&r.shift();yield*r}))}forEach(t){for(let e of this)t(e)}toArray(){return Array.from(this)}instancesOf(t){return this.filter((e=>typeof e===t))}allInstanceOf(t){for(let e of this)if(!(e instanceof t))return!1;return!0}distinct(t){null==t&&(t=a._shallowEqual);const e=this;return a.fn((function*(){const r=[];for(let n of e)a.iterable(r).any((e=>t(e,n)))||(r.push(n),yield n)}))}insert(t,e){const r=this;return a.fn((function*(){let n=0,i=!1;for(let s of r)n===e&&(yield t,i=!0),yield s,n++;i||(yield t)}))}skip(t){const e=this;return a.fn((function*(){let r=0;for(let n of e)r>=t&&(yield n),r++}))}union(t){const e=this;return a.fn((function*(){yield*e,yield*t}))}innerJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t)s.set(r(e),e);return Array.from(i).filter((t=>s.has(e(t)))).map((t=>n(t,s.get(e(t)))))}))}leftJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t)s.set(r(e),e);return Array.from(i).map((t=>n(t,s.get(e(t)))))}))}leftGroupJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let e of t){const t=r(e);s.has(t)||s.set(t,[]),s.get(t).push(e)}return Array.from(i).map((t=>n(t,s.get(e(t))||[])))}))}rightGroupJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let t of i){const r=e(t);s.has(r)||s.set(r,[]),s.get(r).push(t)}return Array.from(t).map((t=>n(s.get(r(t))||[],t)))}))}rightJoin(t,e,r,n){const i=this;return a.fn((()=>{const s=new Map;for(let t of i)s.set(e(t),t);return Array.from(t).map((t=>n(s.get(r(t)),t)))}))}}class u extends a{get key(){return this._key}constructor(t,e){super((()=>e)),this._key=t}}class c{constructor(t){this.milliseconds=t}seconds(){return this.milliseconds/1e3}minutes(){return this.milliseconds/6e4}hours(){return this.milliseconds/36e5}days(){return this.milliseconds/864e5}weeks(){return this.milliseconds/6048e5}static fromMilliseconds(t){return new c(t)}static fromSeconds(t){return new c(1e3*t)}static fromMinutes(t){return new c(1e3*t*60)}static fromHours(t){return new c(1e3*t*60*60)}static fromDays(t){return new c(1e3*t*60*60*24)}static fromWeeks(t){return new c(1e3*t*60*60*24*7)}addMilliseconds(t){return new c(this.milliseconds+t)}addSeconds(t){return this.addMilliseconds(1e3*t)}addMinutes(t){return this.addMilliseconds(1e3*t*60)}addHours(t){return this.addMilliseconds(1e3*t*60*60)}addDays(t){return this.addMilliseconds(1e3*t*60*60*24)}addWeeks(t){return this.addMilliseconds(1e3*t*60*60*24*7)}subtractMilliseconds(t){return new c(this.milliseconds-t)}subtractSeconds(t){return this.subtractMilliseconds(1e3*t)}subtractMinutes(t){return this.subtractMilliseconds(1e3*t*60)}subtractHours(t){return this.subtractMilliseconds(1e3*t*60*60)}subtractDays(t){return this.subtractMilliseconds(1e3*t*60*60*24)}subtractWeeks(t){return this.subtractMilliseconds(1e3*t*60*60*24*7)}add(t){return new c(this.milliseconds+t.milliseconds)}subtract(t){return new c(this.milliseconds-t.milliseconds)}addTo(t){return new Date(t.getTime()+this.milliseconds)}subtractFrom(t){return new Date(t.getTime()-this.milliseconds)}static fromDifference(t,e){return new c(e.getTime()-t.getTime())}format(t="hh:mm:ss"){const e=t.toLowerCase(),r=e.includes("h"),n=e.includes("m");let i=0,s=0,o=Math.floor(this.milliseconds/1e3);r&&(i=Math.floor(o/3600),o-=3600*i),n&&(s=Math.floor(o/60),o-=60*s);const l=String(i).padStart(2,"0"),a=String(s).padStart(2,"0"),u=String(o).padStart(2,"0");return e.replace("hh",l).replace("h",i.toString()).replace("mm",a).replace("m",s.toString()).replace("ss",u).replace("s",o.toString())}eq(t){return this.milliseconds===t.milliseconds}le(t){return this.milliseconds<=t.milliseconds}lt(t){return this.milliseconds<t.milliseconds}ge(t){return this.milliseconds>=t.milliseconds}gt(t){return this.milliseconds>t.milliseconds}multiply(t){return new c(this.milliseconds*t)}divide(t){return new c(this.milliseconds/t)}abs(){return new c(Math.abs(this.milliseconds))}isInfinite(){return this.milliseconds===Number.POSITIVE_INFINITY||this.milliseconds===Number.NEGATIVE_INFINITY}isPositiveInfinite(){return this.milliseconds===Number.POSITIVE_INFINITY}isNegativeInfinite(){return this.milliseconds===Number.NEGATIVE_INFINITY}}c.INFINITE=new c(Number.POSITIVE_INFINITY),c.NEGATIVE_INFINITE=new c(Number.NEGATIVE_INFINITY);class f{constructor(t){this._array=t}[Symbol.iterator](){return this._array[Symbol.iterator]()}at(t,e=void 0){if(void 0===e)return this._array[t];this._array[t]=e}remove(t){const e=this._array.indexOf(t);return-1!==e&&this._array.splice(e,1),this}map(t){for(let e=0;e<this._array.length;e++)this._array[e]=t(this._array[e]);return this}filter(t){for(let e=0;e<this._array.length;e++)t(this._array[e])||(this._array.splice(e,1),e--);return this}head(t){return this._array.splice(t),this}slice(t,e=void 0){return this._array.splice(0,t),void 0!==e&&this._array.splice(e),this}mapMany(t){let e=0;for(;e<this._array.length;){let r=t(this._array[e]);Array.isArray(r)||(r=Array.from(r)),this._array.splice(e,1,...r),e+=r.length}return this}tail(t){const e=this._array.length-t;return this._array.splice(0,e),this}append(...t){return this._array.push(...t),this}prepend(...t){return this._array.unshift(...t),this}get array(){return this._array}}t.ArrayManipulator=f,t.AsyncPoolExecutor=class{get maxConcurrency(){return this._maxConcurrency}set maxConcurrency(t){this._maxConcurrency=t}constructor(t,e=50){this._taskQueue=[],this._maxConcurrency=t,this._checkIntervalMs=e,this._activeTasks=0}submit(t){this._taskQueue.push(t),null==this._proccess&&(this._proccess=setTimeout((async()=>{for(;this._taskQueue.length>0;){for(;this._activeTasks>=this._maxConcurrency;)await i(this._checkIntervalMs);const t=this._taskQueue.shift();t&&(this._activeTasks++,setTimeout((async()=>{try{await t()}finally{this._activeTasks--}})))}this._proccess=null}),0))}async shutdown(){for(;this._taskQueue.length>0||this._activeTasks>0;)await i(this._checkIntervalMs)}},t.CacheDictionary=class{constructor(t=null,e=null){this.fallback=t,this.cache={},this.defaultDuration=e,this.expiration={}}getExpiration(t){return this.expiration[t]}setExpiration(t,e){this.expiration[t]=e}setDuration(t,e){if(null===e)delete this.expiration[t];else{const r=new Date;r.setSeconds(r.getSeconds()+e),this.expiration[t]=r}}get(t){if(!this.cache.hasOwnProperty(t)){if(!this.fallback)return null;this.cache[t]=this.fallback(t),this.expiration[t]=this.calculateExpiration(this.defaultDuration)}return this.isExpired(t)?(this.remove(t),null):this.cache[t]}set(t,e,r=null){this.cache[t]=e,this.expiration[t]=this.calculateExpiration(r)}remove(t){delete this.cache[t],delete this.expiration[t]}isExpired(t){const e=this.expiration[t];return e instanceof Date&&e<new Date}calculateExpiration(t){if(null===t)return;const e=new Date;return e.setSeconds(e.getSeconds()+t),e}},t.From=a,t.KeyValuePair=r,t.Lazy=class{constructor(t){this._valueCreated=!1,this._value=null,this._factoryMethod=t}get valueCreated(){return this._valueCreated}get value(){return this._valueCreated||(this._value=this._factoryMethod(),this._valueCreated=!0),this._value}reset(){this._valueCreated=!1,this._value=null}},t.TimeSpan=c,t.Timer=class{constructor(t,e){this._callback=t,this._interval=e,this._intervalId=null}get running(){return null!==this._intervalId&&void 0!==this._intervalId}get interval(){return this._interval}set interval(t){t!=this._interval&&(this._interval=t,this.running&&this.restart())}get callback(){return this._callback}set callback(t){t!=this._callback&&(this._callback=t)}start(){null===this._intervalId&&(this._intervalId=setInterval((()=>{null!=this._callback&&this._callback()}),this._interval))}stop(){null!==this._intervalId&&(clearInterval(this._intervalId),this._intervalId=null)}restart(){this.stop(),this.start()}},t.ajaxSubmission=function(t,e=void 0,r=void 0){const n="string"==typeof t?document.querySelector(t):t;n instanceof HTMLFormElement&&n.addEventListener("submit",(async t=>{t.preventDefault();let i=s(n);i&&(e&&(i=i.then(e)),r&&i.catch(r))}))},t.ajaxSubmit=s,t.array=function(t){return new f(t)},t.clamp=function(t,e,r){return t<=e?e:t>=r?r:t},t.deepClone=function t(e){if(null===e||"object"!=typeof e)return e;if(Array.isArray(e)){const r=[];for(const n of e)r.push(t(n));return r}const r={};for(const n in e)e.hasOwnProperty(n)&&(r[n]=t(e[n]));return r},t.deepEqual=function t(e,r){if(e===r)return!0;if(null===e||null===r||typeof e!=typeof r)return!1;if(Array.isArray(e)&&Array.isArray(r)){if(e.length!==r.length)return!1;for(let n=0;n<e.length;n++)if(!t(e[n],r[n]))return!1;return!0}if("object"==typeof e&&"object"==typeof r){const n=Object.keys(e),i=Object.keys(r);if(n.length!==i.length)return!1;for(const s of n)if(!i.includes(s)||!t(e[s],r[s]))return!1;return!0}return!1},t.delay=i,t.ensurePrefix=function(t,e){return t.startsWith(e)?t:e+t},t.ensureSuffix=function(t,e){return t.endsWith(e)?t:t+e},t.format=function(t,...e){let r;return 1===e.length&&"object"==typeof e[0]?(e=e[0],r=/{(.+?)}/g):r=/{(\d+?)}/g,t.replace(r,((t,r)=>void 0!==e[r]?e[r]:""))},t.from=function(t){if(null==t)throw"Source is null.";if("function"==typeof t)return a.fn(t);if("function"==typeof t[Symbol.iterator])return a.iterable(t);if("object"==typeof t)return a.object(t);throw"Invalid source."},t.getType=function(e){return null===e?t.Type.Null:t.Type[typeof e]},t.isArray=function(t){return Array.isArray(t)},t.isBigInt=function(t){return"bigint"==typeof t},t.isBoolean=function(t){return"boolean"==typeof t},t.isDefined=function(t){return void 0!==t},t.isEmpty=function(t){return Array.isArray(t)&&0===t.length||"string"==typeof t&&""===t||null==t},t.isEmptyOrWhitespace=function(t){return Array.isArray(t)&&0===t.length||"string"==typeof t&&""===t.trim()||null==t},t.isFunction=n,t.isIterable=function(t){return"function"===t[Symbol.iterator]},t.isNull=function(t){return null===t},t.isNullOrUndefined=function(t){return null==t},t.isNumber=function(t){return"number"==typeof t},t.isObject=function(t){return null!=t&&"object"==typeof t&&!Array.isArray(t)},t.isString=function(t){return"string"==typeof t},t.isSymbol=function(t){return"symbol"==typeof t},t.isUndefined=function(t){return void 0===t},t.lerp=function(t,e,r,n,i){return n+(t-e)/(r-e)*(i-n)},t.objectToFormData=function(t){return l(t,new FormData)},t.promisify=function(t){return t instanceof Promise?t:n(t)?new Promise(((e,r)=>{try{e(t())}catch(t){r(t)}})):Promise.resolve(t)},t.pull=function(t,...e){let r=0;for(const n of e){const e=t.indexOf(n);-1!==e&&(t.splice(e,1),r++)}return r},t.toPairs=o}(this.window=this.window||{});

package/dist/index.cjs.js

@@ -23,7 +23,7 @@ exports.Type = void 0;
  * @template TKey The type of the key.
  * @template TValue The type of the value.
  */
-class Pair {
+class KeyValuePair {
     get value() {
         return this._value;
     }
@@ -101,6 +101,54 @@ function isArray(value) {
 function isFunction(value) {
     return typeof value === 'function';
 }
+/**
+ * Compares two objects or arrays to check if they have the same fields and values,
+ * or the same elements if they are arrays.
+ *
+ * @param {any} a - The first object or array.
+ * @param {any} b - The second object or array.
+ * @return {boolean} - Returns true if the objects/arrays are equal, otherwise false.
+ */
+function deepEqual(a, b) {
+    if (a === b) {
+        // If both values are strictly equal, return true
+        return true;
+    }
+    // If either value is null or their types differ, return false
+    if (a === null || b === null || typeof a !== typeof b) {
+        return false;
+    }
+    // Check if both values are arrays
+    if (Array.isArray(a) && Array.isArray(b)) {
+        // Compare lengths and elements recursively
+        if (a.length !== b.length) {
+            return false;
+        }
+        for (let i = 0; i < a.length; i++) {
+            if (!deepEqual(a[i], b[i])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // Check if both values are objects
+    if (typeof a === "object" && typeof b === "object") {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        // Compare the keys length and check if all keys/values match
+        if (keysA.length !== keysB.length) {
+            return false;
+        }
+        for (const key of keysA) {
+            if (!keysB.includes(key) || !deepEqual(a[key], b[key])) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // For all other data types (e.g., numbers, strings, booleans), use strict equality
+    return false;
+}
 /**
  * Pauses the execution of an asynchronous function for a specified duration.
  *
@@ -210,12 +258,12 @@ async function ajaxSubmit(selectorOrElement) {
  * Converts an object into an array of key-value pairs.
  *
  * @param {Record<string, any>} obj - The object to convert.
- * @return {Pair<string, any>[]} - The array of key-value pairs.
+ * @return {KeyValuePair<string, any>[]} - The array of key-value pairs.
  */
 function toPairs(obj) {
     let output = [];
     for (const key in obj) {
-        output.push(new Pair(key, obj[key]));
+        output.push(new KeyValuePair(key, obj[key]));
     }
     return output;
 }
@@ -1192,6 +1240,7 @@ class Lazy {
  * Represents a class for manipulating an array of items.
  *
  * @template T - The type of items in the array.
+ * @deprecated
  */
 class ArrayManipulator {
     constructor(array) {
@@ -1320,61 +1369,91 @@ function array(array) {
 }
 
 class AsyncPoolExecutor {
-    constructor(maxConcurrency) {
+    get maxConcurrency() {
+        return this._maxConcurrency;
+    }
+    set maxConcurrency(value) {
+        this._maxConcurrency = value;
+    }
+    /**
+     * @param {number} maxConcurrency - The maximum number of concurrent tasks allowed.
+     * @param {number} [checkInterval=50] - The interval, in milliseconds, to check for capacity to run new tasks. Defaults to 50 ms.
+     */
+    constructor(maxConcurrency, checkInterval = 50) {
         this._taskQueue = [];
-        this._activeTasks = 0;
         this._maxConcurrency = maxConcurrency;
+        this._checkIntervalMs = checkInterval;
+        this._activeTasks = 0;
     }
     /**
      * Submits a deferred task to a queue for asynchronous execution and returns a Promise resolving to its result.
      * @template T
-     * @param {Deferred<T>} task - The deferred task to be executed asynchronously.
-     * @return {Promise<T>} A Promise that resolves with the result of the executed task, or rejects if an error occurs during execution.
+     * @param {Supplier<T>} task - The deferred task to be executed asynchronously.
      */
     submit(task) {
-        return new Promise((resolve, reject) => {
-            this._taskQueue.push(async () => {
-                try {
-                    this._activeTasks++;
-                    resolve(await promisify(task));
-                }
-                catch (error) {
-                    reject(error);
+        this._taskQueue.push(task);
+        if (this._proccess != null)
+            return;
+        this._proccess = setTimeout(async () => {
+            while (this._taskQueue.length > 0) {
+                while (this._activeTasks >= this._maxConcurrency) {
+                    await delay(this._checkIntervalMs);
                 }
-                finally {
-                    this._activeTasks--;
-                    this._runNext(); // Intenta ejecutar la siguiente tarea
+                const task = this._taskQueue.shift();
+                if (task) {
+                    this._activeTasks++;
+                    setTimeout(async () => {
+                        try {
+                            await task();
+                        }
+                        finally {
+                            this._activeTasks--;
+                        }
+                    });
                 }
-            });
-            this._runNext();
-        });
-    }
-    _runNext() {
-        while (this._activeTasks < this._maxConcurrency && this._taskQueue.length > 0) {
-            const nextTask = this._taskQueue.shift();
-            nextTask && nextTask();
-        }
+            }
+            this._proccess = null;
+        }, 0);
     }
     /**
-     * Gracefully shuts down the system by waiting for all queued and active tasks to complete.
-     * The method ensures that no tasks remain in the queue and no tasks are actively running
-     * before resolving the promise.
+     * Waits until all tasks (both queued and active) are completed.
+     * This method resolves only when there are no pending tasks.
      *
-     * @return {Promise<void>} A promise that resolves when the shutdown process is complete.
+     * @return {Promise<void>} A promise that resolves when all tasks are complete.
      */
     async shutdown() {
         while (this._taskQueue.length > 0 || this._activeTasks > 0) {
-            await new Promise((resolve) => setTimeout(resolve, 50));
+            await delay(this._checkIntervalMs);
         }
     }
 }
 
+/**
+ * Removes all given values from the provided array and returns the number of removed elements.
+ * The operation mutates the original array.
+ * @template T
+ * @param {Array<T>} array - The array to modify by removing specified items.
+ * @param {...T} items - The values to remove from the array.
+ * @return {number} The number of elements removed from the array.
+ */
+function pull(array, ...items) {
+    let output = 0;
+    for (const item of items) {
+        const index = array.indexOf(item);
+        if (index !== -1) {
+            array.splice(index, 1);
+            output++;
+        }
+    }
+    return output;
+}
+
 exports.ArrayManipulator = ArrayManipulator;
 exports.AsyncPoolExecutor = AsyncPoolExecutor;
 exports.CacheDictionary = CacheDictionary;
 exports.From = From;
+exports.KeyValuePair = KeyValuePair;
 exports.Lazy = Lazy;
-exports.Pair = Pair;
 exports.TimeSpan = TimeSpan;
 exports.Timer = Timer;
 exports.ajaxSubmission = ajaxSubmission;
@@ -1382,6 +1461,7 @@ exports.ajaxSubmit = ajaxSubmit;
 exports.array = array;
 exports.clamp = clamp;
 exports.deepClone = deepClone;
+exports.deepEqual = deepEqual;
 exports.delay = delay;
 exports.ensurePrefix = ensurePrefix;
 exports.ensureSuffix = ensureSuffix;
@@ -1406,5 +1486,6 @@ exports.isUndefined = isUndefined;
 exports.lerp = lerp;
 exports.objectToFormData = objectToFormData;
 exports.promisify = promisify;
+exports.pull = pull;
 exports.toPairs = toPairs;
 //# sourceMappingURL=index.cjs.js.map