@develia/commons 0.3.17 → 0.3.20

package/dist/develia-commons.min.js

@@ -0,0 +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,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):o(t,e,s)})):e.append(r?`${r}[${n}]`:n,i):o(i,e,r?`${r}[${n}]`:n)}return e}class l{static object(t){return new l((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 l(t)}collect(){const t=Array.from(this);return l.iterable(t)}static iterable(t){return l.fn((function*(){for(const e of t)yield e}))}map(t){const e=this;return l.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){for(let e of this)if(t(e))return!0;return!1}filter(t){const e=this;return l.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 l.fn((function*(){for(let t of e)yield t;yield t}))}prepend(t){const e=this;return l.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 l.fn((function*(){for(const r of e){const e=t(r);for(const t of e)yield t}}))}flatten(){const t=this;return l.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})),l.iterable(e)}groupBy(t,e){e=null==e?l._shallowEqual:e;const r=this;return l.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 a(t,e)))}))}head(t){const e=this;return l.fn((function*(){let r=0;for(let n of e){if(!(r++<t))return;yield n}}))}tail(t){const e=this;return l.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=l._shallowEqual);const e=this;return l.fn((function*(){const r=[];for(let n of e)l.iterable(r).any((e=>t(e,n)))||(r.push(n),yield n)}))}insert(t,e){const r=this;return l.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 l.fn((function*(){let r=0;for(let n of e)r>=t&&(yield n),r++}))}union(t){const e=this;return l.fn((function*(){yield*e,yield*t}))}innerJoin(t,e,r,n){const i=this;return l.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 l.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 l.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 l.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 l.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 a extends l{get key(){return this._key}constructor(t,e){super((()=>e)),this._key=t}}class u{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 u(t)}static fromSeconds(t){return new u(1e3*t)}static fromMinutes(t){return new u(1e3*t*60)}static fromHours(t){return new u(1e3*t*60*60)}static fromDays(t){return new u(1e3*t*60*60*24)}static fromWeeks(t){return new u(1e3*t*60*60*24*7)}addMilliseconds(t){return new u(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 u(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 u(this.milliseconds+t.milliseconds)}subtract(t){return new u(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 u(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 u(this.milliseconds*t)}divide(t){return new u(this.milliseconds/t)}abs(){return new u(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}}u.INFINITE=new u(Number.POSITIVE_INFINITY),u.NEGATIVE_INFINITE=new u(Number.NEGATIVE_INFINITY);class c{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=c,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=l,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=u,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 c(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.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 l.fn(t);if("function"==typeof t[Symbol.iterator])return l.iterable(t);if("object"==typeof t)return l.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 o(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.toPairs=s}(this.window=this.window||{});

package/dist/index.cjs.js

@@ -2,6 +2,29 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+/**
+ * Represents different types in JavaScript.
+ * @enum {string}
+ */
+exports.Type = void 0;
+(function (Type) {
+    Type["Undefined"] = "undefined";
+    Type["Number"] = "number";
+    Type["String"] = "string";
+    Type["Boolean"] = "boolean";
+    Type["Object"] = "object";
+    Type["Function"] = "function";
+    Type["Symbol"] = "symbol";
+    Type["BigInt"] = "bigint";
+    Type["Null"] = "null";
+})(exports.Type || (exports.Type = {}));
+
+/**
+ * Represents a pair of key and value.
+ *
+ * @template TKey The type of the key.
+ * @template TValue The type of the value.
+ */
 class Pair {
     get value() {
         return this._value;
@@ -16,91 +39,153 @@ class Pair {
 }
 
 // noinspection JSUnusedGlobalSymbols
-function isIterable(obj) {
-    return obj[Symbol.iterator] === 'function';
-}
-function clamp(n, min, max) {
-    if (n <= min)
-        return min;
-    if (n >= max)
-        return max;
-    return n;
-}
 /**
- * Linearly remaps a value from its source range [`inMin`, `inMax`] to the destination range [`outMin`, `outMax`]
+ * Checks if an object is iterable.
  *
- * @category Math
- * @example
- * ```
- * const value = remap(0.5, 0, 1, 200, 400) // value will be 300
- * ```
+ * @param {any} obj - The object to check.
+ * @return {boolean} - Returns true if the object is iterable, otherwise false.
  */
-function lerp(n, inMin, inMax, outMin, outMax) {
-    return outMin + (outMax - outMin) * ((n - inMin) / (inMax - inMin));
+function isIterable(obj) {
+    return obj[Symbol.iterator] === 'function';
 }
 /**
- * Ensure prefix of a string
+ * Checks if a given value is a string.
  *
- * @category String
+ * @param {*} value - The value to check.
+ * @return {boolean} - Returns true if the value is a string, otherwise returns false.
  */
-function ensurePrefix(prefix, str) {
-    if (!str.startsWith(prefix))
-        return prefix + str;
-    return str;
+function isString(value) {
+    return typeof value === 'string';
 }
 /**
- * Ensure suffix of a string
+ * Checks if a value is a number.
  *
- * @category String
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is a number, otherwise false.
  */
-function ensureSuffix(suffix, str) {
-    if (!str.endsWith(suffix))
-        return str + suffix;
-    return str;
-}
-function isString(value) {
-    return typeof value === 'string';
-}
 function isNumber(value) {
     return typeof value === 'number';
 }
+/**
+ * Checks if a given value is a boolean.
+ *
+ * @param {any} value - The value to be checked.
+ *
+ * @return {boolean} - Returns true if the value is a boolean, otherwise false.
+ */
 function isBoolean(value) {
     return typeof value === 'boolean';
 }
+/**
+ * Checks if a value is an object.
+ * @param {any} value - The value to be checked.
+ * @returns {boolean} - Returns true if the value is an object, otherwise returns false.
+ */
 function isObject(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value);
+    return value != null && typeof value === 'object' && !Array.isArray(value);
 }
+/**
+ * Determines if a value is an array.
+ *
+ * @param value - The value to be checked.
+ *
+ * @return Whether the value is an array.
+ */
 function isArray(value) {
     return Array.isArray(value);
 }
+/**
+ * Checks if a value is a function.
+ *
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is a function, otherwise returns false.
+ */
 function isFunction(value) {
     return typeof value === 'function';
 }
+/**
+ * Checks if a value is undefined.
+ *
+ * @param {any} value - The value to check.
+ * @returns {boolean} - True if the value is undefined, false otherwise.
+ */
 function isUndefined(value) {
     return typeof value === 'undefined';
 }
+/**
+ * Checks if a value is defined or not.
+ *
+ * @param {any} value - The value to be checked.
+ *
+ * @return {boolean} - True if the value is defined, false otherwise.
+ */
+function isDefined(value) {
+    return typeof value !== 'undefined';
+}
+/**
+ * Checks if a given value is null.
+ *
+ * @param {any} value - The value to check for null.
+ * @return {boolean} - Returns true if the value is null, otherwise returns false.
+ */
 function isNull(value) {
     return value === null;
 }
+/**
+ * Determines whether the given value is of type bigint.
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is of type bigint, false otherwise.
+ */
 function isBigInt(value) {
     return typeof value === 'bigint';
 }
+/**
+ * Checks if a given value is a symbol.
+ *
+ * @param {any} value - The value to be checked.
+ * @return {boolean} - Returns true if the value is a symbol, false otherwise.
+ */
 function isSymbol(value) {
     return typeof value === 'symbol';
 }
+/**
+ * Checks if a value is null or undefined.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is null or undefined, false otherwise.
+ */
 function isNullOrUndefined(value) {
     return value === null || typeof value === 'undefined';
 }
+/**
+ * Checks if a given value is empty.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} - Returns true if the value is empty, otherwise returns false.
+ */
 function isEmpty(value) {
     return (Array.isArray(value) && value.length === 0) ||
         (typeof value === 'string' && value === '') ||
         value === null || typeof value === 'undefined';
 }
+/**
+ * Check if a value is empty or contains only whitespace characters.
+ *
+ * @param {any} value - The value to check.
+ * @return {boolean} Returns true if the value is empty or contains only whitespace characters, otherwise returns false.
+ */
 function isEmptyOrWhitespace(value) {
     return (Array.isArray(value) && value.length === 0) ||
         (typeof value === 'string' && value.trim() === '') ||
         value === null || typeof value === 'undefined';
 }
+/**
+ * Submits a form via AJAX and returns a Promise that resolves to the Response object.
+ *
+ * @param {HTMLFormElement | string} selectorOrElement - The form element or selector.
+ * @return {Promise<Response>} A Promise that resolves to the Response object.
+ * @throws {Error} If the element is invalid.
+ */
 async function ajaxSubmit(selectorOrElement) {
     const form = typeof selectorOrElement === 'string'
         ? document.querySelector(selectorOrElement)
@@ -114,6 +199,12 @@ async function ajaxSubmit(selectorOrElement) {
         body: new FormData(form),
     });
 }
+/**
+ * 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.
+ */
 function toPairs(obj) {
     let output = [];
     for (const key in obj) {
@@ -121,6 +212,12 @@ function toPairs(obj) {
     }
     return output;
 }
+/**
+ * Converts a given thing into a Promise.
+ * @template T
+ * @param {any} thing - The thing to be converted into a Promise.
+ * @returns {Promise<T>} - A Promise representing the given thing.
+ */
 function promisify(thing) {
     if (thing instanceof Promise)
         return thing;
@@ -137,7 +234,7 @@ function promisify(thing) {
     }
     return Promise.resolve(thing);
 }
-function ajaxSubmission(selectorOrElement, onSuccess = null, onFailure = null) {
+function ajaxSubmission(selectorOrElement, onSuccess = undefined, onFailure = undefined) {
     const form = typeof selectorOrElement === 'string'
         ? document.querySelector(selectorOrElement)
         : selectorOrElement;
@@ -155,6 +252,12 @@ function ajaxSubmission(selectorOrElement, onSuccess = null, onFailure = null) {
         }
     });
 }
+/**
+ * Creates a deep clone of the given object.
+ * @template T
+ * @param {T} obj - The object to clone.
+ * @return {T} - The deep clone of the given object.
+ */
 function deepClone(obj) {
     if (obj === null || typeof obj !== 'object') {
         return obj;
@@ -174,6 +277,23 @@ function deepClone(obj) {
     }
     return copy;
 }
+/**
+ * Returns the type of the given value.
+ *
+ * @param {any} value - The value to determine the type of.
+ * @return {Type} - The type of the given value.
+ */
+function getType(value) {
+    return value === null ? exports.Type.Null : exports.Type[typeof value];
+}
+/**
+ * Converts an object to `FormData` format recursively.
+ *
+ * @param {Record<string, any>} data - The object data to convert.
+ * @param {FormData} formData - The `FormData` instance to append data to.
+ * @param {string} parentKey - The parent key to append to child keys in the `FormData`.
+ * @returns {FormData} - The `FormData` instance with the converted data.
+ */
 function _objectToFormData(data, formData, parentKey = '') {
     for (const key in data) {
         if (data.hasOwnProperty(key)) {
@@ -205,11 +325,92 @@ function _objectToFormData(data, formData, parentKey = '') {
     }
     return formData;
 }
+/**
+ * Converts an object into FormData.
+ *
+ * @param {Record<string, any>} data - The object to be converted into FormData.
+ * @return {FormData} - The FormData object representing the converted data.
+ */
 function objectToFormData(data) {
     let formData = new FormData();
     return _objectToFormData(data, formData);
 }
 
+/**
+ * Ensures that a given string has a specific prefix.
+ *
+ * @param {string} str - The string to ensure the prefix on.
+ * @param {string} prefix - The prefix to ensure on the string.
+ * @return {string} - The resulting string with the ensured prefix.
+ */
+function ensurePrefix(str, prefix) {
+    if (!str.startsWith(prefix))
+        return prefix + str;
+    return str;
+}
+/**
+ * Ensures that a string ends with a specified suffix.
+ *
+ * @param {string} str - The original string.
+ * @param {string} suffix - The suffix to ensure.
+ * @return {string} - The modified string with the suffix added if it was not already present.
+ */
+function ensureSuffix(str, suffix) {
+    if (!str.endsWith(suffix))
+        return str + suffix;
+    return str;
+}
+/**
+ * Formats a string using a template and provided arguments.
+ *
+ * @param {string} template - The template string containing placeholders.
+ * @param {any[]} args - Optional arguments to replace the placeholders in the template.
+ * @return {string} The formatted string.
+ */
+function format(template, ...args) {
+    let regex;
+    if (args.length === 1 && typeof args[0] === 'object') {
+        args = args[0];
+        regex = /{(.+?)}/g;
+    }
+    else {
+        regex = /{(\d+?)}/g;
+    }
+    return template.replace(regex, (match, key) => {
+        return typeof args[key] !== 'undefined' ? args[key] : "";
+    });
+}
+
+/**
+ * Linearly interpolates a number between two ranges.
+ *
+ * @param {number} n - The number to interpolate.
+ * @param {number} inMin - The minimum value of the input range.
+ * @param {number} inMax - The maximum value of the input range.
+ * @param {number} outMin - The minimum value of the output range.
+ * @param {number} outMax - The maximum value of the output range.
+ *
+ * @return {number} - The interpolated value.
+ */
+function lerp(n, inMin, inMax, outMin, outMax) {
+    return outMin + (outMax - outMin) * ((n - inMin) / (inMax - inMin));
+}
+/**
+ * Clamps a number between a minimum and maximum value.
+ *
+ * @param {number} n - The value to be clamped.
+ * @param {number} min - The minimum value.
+ * @param {number} max - The maximum value.
+ * @return {number} The clamped value.
+ */
+function clamp(n, min, max) {
+    if (n <= min)
+        return min;
+    if (n >= max)
+        return max;
+    return n;
+}
+
 class CacheDictionary {
     constructor(fallback = null, defaultDuration = null) {
         this.fallback = fallback;
@@ -717,6 +918,9 @@ class Grouping extends From {
     }
 }
 
+/**
+ * A class representing a timer that executes a callback function at a specified interval.
+ */
 class Timer {
     /**
      * @param callback Callback
@@ -768,6 +972,9 @@ class Timer {
     }
 }
 
+/**
+ * Represents a duration of time in milliseconds.
+ */
 class TimeSpan {
     constructor(milliseconds) {
         this.milliseconds = milliseconds;
@@ -936,6 +1143,10 @@ class TimeSpan {
 TimeSpan.INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);
 TimeSpan.NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);
 
+/**
+ * Represents a lazy value that is created only when it is accessed for the first time.
+ * @template T The type of the lazy value.
+ */
 class Lazy {
     constructor(getter) {
         this._valueCreated = false;
@@ -945,9 +1156,9 @@ class Lazy {
     get valueCreated() {
         return this._valueCreated;
     }
-    async getValue() {
+    get value() {
         if (!this._valueCreated) {
-            this._value = await promisify(this._factoryMethod);
+            this._value = this._factoryMethod();
             this._valueCreated = true;
         }
         return this._value;
@@ -958,6 +1169,138 @@ class Lazy {
     }
 }
 
+/**
+ * Represents a class for manipulating an array of items.
+ *
+ * @template T - The type of items in the array.
+ */
+class ArrayManipulator {
+    constructor(array) {
+        this._array = array;
+    }
+    [Symbol.iterator]() {
+        return this._array[Symbol.iterator]();
+    }
+    /**
+     * Retrieves or sets the value at the specified index in the array.
+     * If `item` is not provided, returns the value at index `n`.
+     * If `item` is provided, sets the value at index `n` to the provided value.
+     *
+     * @param {number} n - The index at which to retrieve or set the value.
+     * @param {T | undefined} [item] - The value to set at index `n`, if provided.
+     *
+     * @return {T | void} - If `item` is not provided, returns the value at index `n`.
+     *                    - If `item` is provided, does not return anything.
+     */
+    at(n, item = undefined) {
+        if (item === undefined)
+            return this._array[n];
+        else
+            this._array[n] = item;
+    }
+    /**
+     * Removes the specified item from the array.
+     *
+     * @param {T} item - The item to be removed.
+     * @returns {ArrayManipulator<T>} - The updated ArrayManipulator instance.
+     */
+    remove(item) {
+        const index = this._array.indexOf(item);
+        if (index !== -1) {
+            this._array.splice(index, 1);
+        }
+        return this;
+    }
+    /**
+     * Applies a mapping function to each element in the array, transforming it into a new array.
+     * @template R
+     * @param {UnaryFunction<T, R>} mapFn - The function to be applied to each element.
+     * @return {ArrayManipulator<R>} - The new ArrayManipulator instance with the mapped elements.
+     */
+    map(mapFn) {
+        for (let i = 0; i < this._array.length; i++) {
+            this._array[i] = mapFn(this._array[i]);
+        }
+        return this;
+    }
+    /**
+     * Filters the elements of the array based on a given filter function.
+     * The filter function should return a boolean value, indicating whether the element should be included in the filtered array or not.
+     *
+     * @param {Predicate<T>} filterFn - The function that will be used to filter the elements. It should accept an element of type T and return a boolean value.
+     * @returns {ArrayManipulator<T>} - The filtered ArrayManipulator instance with the elements that passed the filter.
+     */
+    filter(filterFn) {
+        for (let i = 0; i < this._array.length; i++) {
+            if (!filterFn(this._array[i])) {
+                this._array.splice(i, 1);
+                i--;
+            }
+        }
+        return this;
+    }
+    head(n) {
+        this._array.splice(n);
+        return this;
+    }
+    slice(start, count = undefined) {
+        this._array.splice(0, start); // Eliminar los primeros elementos hasta `start`
+        if (count !== undefined) {
+            this._array.splice(count); // Mantener solo `count` elementos restantes
+        }
+        return this;
+    }
+    mapMany(mapper) {
+        let i = 0;
+        while (i < this._array.length) {
+            let mappedItems = mapper(this._array[i]);
+            if (!Array.isArray(mappedItems))
+                mappedItems = Array.from(mappedItems);
+            this._array.splice(i, 1, ...mappedItems);
+            i += mappedItems.length;
+        }
+        return this;
+    }
+    tail(n) {
+        const start = this._array.length - n;
+        this._array.splice(0, start);
+        return this;
+    }
+    /**
+     * Appends one or more items to the array.
+     *
+     * @param {...T} items - The items to be appended to the array.
+     * @return {ArrayManipulator<T>} - The ArrayManipulator instance.
+     */
+    append(...items) {
+        this._array.push(...items);
+        return this;
+    }
+    /**
+     * Prepend items to the beginning of the array.
+     *
+     * @param {...T} items - The items to be prepended.
+     * @return {ArrayManipulator<T>} The ArrayManipulator instance.
+     */
+    prepend(...items) {
+        this._array.unshift(...items);
+        return this;
+    }
+    get array() {
+        return this._array;
+    }
+}
+/**
+ * Creates an instance of ArrayManipulator with the given array.
+ * @template T
+ * @param {T[]} array - The input array.
+ * @return {ArrayManipulator<T>} - An instance of the ArrayManipulator class.
+ */
+function array(array) {
+    return new ArrayManipulator(array);
+}
+
+exports.ArrayManipulator = ArrayManipulator;
 exports.CacheDictionary = CacheDictionary;
 exports.From = From;
 exports.Lazy = Lazy;
@@ -966,14 +1309,18 @@ exports.TimeSpan = TimeSpan;
 exports.Timer = Timer;
 exports.ajaxSubmission = ajaxSubmission;
 exports.ajaxSubmit = ajaxSubmit;
+exports.array = array;
 exports.clamp = clamp;
 exports.deepClone = deepClone;
 exports.ensurePrefix = ensurePrefix;
 exports.ensureSuffix = ensureSuffix;
+exports.format = format;
 exports.from = from;
+exports.getType = getType;
 exports.isArray = isArray;
 exports.isBigInt = isBigInt;
 exports.isBoolean = isBoolean;
+exports.isDefined = isDefined;
 exports.isEmpty = isEmpty;
 exports.isEmptyOrWhitespace = isEmptyOrWhitespace;
 exports.isFunction = isFunction;