tiny-essentials 1.0.0 → 1.1.1

package/README.md

@@ -11,18 +11,19 @@
 </p>
 </div>
 
-# Tiny Essentials
+# 🧩 Tiny Essentials
 
 **Tiny Essentials** is a collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility. From date calculations to formatting, object manipulations, and array operations, these scripts serve as building blocks for more complex applications.
 
-## Features
+## ✨ Features
 
-- **Array Manipulations**: Functions like `shuffleArray` to randomize elements in place.
-- **Time Calculations**: Easily calculate durations, format timers, and more.
-- **Object Utilities**: Perform type checks, count object properties, and calculate percentages.
-- **Custom Utilities**: Includes various helper functions like `ruleOfThree` for proportion calculations and `getAge` to calculate the age based on a given birth date.
+- 🔀 **Array Manipulations**: Functions like `shuffleArray` to randomize elements in place.
+- ⏱️ **Time Calculations**: Easily calculate durations, format timers, and more.
+- 🧠 **Object Utilities**: Perform type checks, count object properties, and calculate percentages.
+- 🛠️ **Custom Utilities**: Includes various helper functions like `ruleOfThree` for proportion calculations and `getAge` to calculate the age based on a given birth date.
+- 🔐 **Encryption Tools**: Use `TinyCrypto` to securely encrypt and decrypt values using AES-256-GCM, with full support for complex JavaScript data types like RegExp, Date, Buffer, and DOM elements (in browsers).
 
-## Installation
+## 📦 Installation
 
 You can install Tiny Essentials via npm:
 
@@ -32,7 +33,7 @@ npm install tiny-essentials
 
 Or download the scripts directly from this repository.
 
-## Legacy Code
+## 🗃️ Legacy Code
 
 Some scripts in this repository have been preserved for backwards compatibility. These include modules like:
 
@@ -43,25 +44,33 @@ Some scripts in this repository have been preserved for backwards compatibility.
 
 These modules have been updated to work with modern environments but may not be actively developed further.
 
-## Module Versions
+## 🧪 Module Versions
+
 The core version of Tiny Essentials (version 1) is located in the folder [`/src/v1`](./src/v1).  
 
 A detailed README is available inside the [`v1`](./src/v1) folder, which contains a full description of all utility modules and their functionalities.  
 We recommend checking it out if you want to see all available tools in this version and how to use them individually or collectively via the `index.mjs` global module.
 
-## Contributions
+## 📚 Documentation
+
+Looking for detailed module explanations and usage examples?  
+Check out the full documentation here:
+
+👉 [Go to docs page](./docs/README.md)
+
+## 🤝 Contributions
 
 Feel free to fork, contribute, and create pull requests for improvements! Whether it's a bug fix or an additional feature, contributions are always welcome.
 
-## License
+## 📝 License
 
 This project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details.
 
 ---
 
-### Credits
+### 💡 Credits
 
 This project was inspired by the need for lightweight, reusable code that can be used across many different kinds of applications. Contributions and suggestions are always appreciated!
 
-> **Note**: This documentation was written by [ChatGPT](https://openai.com/chatgpt), an AI assistant developed by OpenAI, based on the project structure and descriptions provided by the repository author.  
+> 🧠 **Note**: This documentation was written by [ChatGPT](https://openai.com/chatgpt), an AI assistant developed by OpenAI, based on the project structure and descriptions provided by the repository author.  
 > If you find any inaccuracies or need improvements, feel free to contribute or open an issue!

package/dist/TinyEssentials.min.js

@@ -1 +1 @@
-var TinyEssentials=function(e){"use strict";function t(e,t="seconds",r="{time}"){e=Math.max(0,Math.floor(e));const a=["seconds","minutes","hours","days","months","years"].indexOf(t),s=a>=5,n=a>=4,o=a>=3,l=a>=2,i=a>=1,u=a>=0,c={years:s?0:NaN,months:n?0:NaN,days:o?0:NaN,hours:l?0:NaN,minutes:i?0:NaN,seconds:u?0:NaN,total:NaN};let h=e;if(s||n||o){const e=new Date(1980,0,1),t=new Date(e.getTime()+1e3*h),r=new Date(e);if(s)for(;new Date(r.getFullYear()+1,r.getMonth(),r.getDate())<=t;)r.setFullYear(r.getFullYear()+1),c.years++;if(n)for(;new Date(r.getFullYear(),r.getMonth()+1,r.getDate())<=t;)r.setMonth(r.getMonth()+1),c.months++;if(o)for(;new Date(r.getFullYear(),r.getMonth(),r.getDate()+1)<=t;)r.setDate(r.getDate()+1),c.days++;h=Math.floor((t-r)/1e3)}l&&(c.hours=Math.floor(h/3600),h%=3600),i&&(c.minutes=Math.floor(h/60),h%=60),u&&(c.seconds=h);const p={seconds:u?e:NaN,minutes:i?e/60:NaN,hours:l?e/3600:NaN,days:o?e/86400:NaN,months:n?12*c.years+c.months+(c.days||0)/30:NaN,years:s?c.years+(c.months||0)/12+(c.days||0)/365:NaN};c.total=+(p[t]||0).toFixed(2).replace(/\.00$/,"");const g=e=>isNaN(e)?"NaN":String(e).padStart(2,"0"),f=[l?g(c.hours):null,i?g(c.minutes):null,u?g(c.seconds):null].filter((e=>null!==e)).join(":");return r.replace(/\{years\}/g,c.years).replace(/\{months\}/g,c.months).replace(/\{days\}/g,c.days).replace(/\{hours\}/g,g(c.hours)).replace(/\{minutes\}/g,g(c.minutes)).replace(/\{seconds\}/g,g(c.seconds)).replace(/\{time\}/g,f).replace(/\{total\}/g,c.total).trim()}function r(e,t){if(void 0!==e){const r=Object.prototype.toString.call(e).toLowerCase();return"string"==typeof t?r===`[object ${t}]`:r.substring(8,r.length-1)}return null}return e.TinyLevelUp=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const r=this.expLevel*e.level;return e.exp>=r&&(e.level++,t=e.exp-r,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let r=1;r<=e.level;r++)t+=this.expLevel*r;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,r="add",a=1){return"add"===r?e.exp+=this.expGenerator(a)+t:"extra"===r&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,r="add",a=1){return"add"===r?e.exp-=this.expGenerator(a)+t:"extra"===r&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}},e.asyncReplace=async function(e,t,r){const a=[];e.replace(t,((e,...t)=>(a.push(r(e,...t)),e)));const s=await Promise.all(a);return e.replace(t,(()=>s.shift()))},e.countObj=function(e){return Array.isArray(e)?e.length:r(e,"object")?Object.keys(e).length:0},e.formatCustomTimer=t,e.formatDayTimer=function(e){return t(e,"days","{days}d {hours}:{minutes}:{seconds}")},e.formatTimer=function(e){return t(e,"hours","{hours}:{minutes}:{seconds}")},e.getAge=function(e=0,t=null){if(null!=e&&0!==e){const r=new Date(e);if(isNaN(r))return null;const a=t instanceof Date?t:new Date;let s=a.getFullYear()-r.getFullYear();const n=a.getMonth(),o=r.getMonth(),l=a.getDate(),i=r.getDate();return(n<o||n===o&&l<i)&&s--,Math.abs(s)}return null},e.getSimplePerc=function(e,t){return e*(t/100)},e.getTimeDuration=function(e=new Date,t="asSeconds",r=null){if(e instanceof Date){const a=e-(r instanceof Date?r:new Date);switch(t){case"asMilliseconds":return a;case"asSeconds":default:return a/1e3;case"asMinutes":return a/6e4;case"asHours":return a/36e5;case"asDays":return a/864e5}}return null},e.objType=r,e.ruleOfThree=function(e,t,r,a){return a?Number(e*t)/r:Number(r*t)/e},e.shuffleArray=function(e){let t,r=e.length;for(;0!==r;)t=Math.floor(Math.random()*r),r--,[e[r],e[t]]=[e[t],e[r]];return e},e.toTitleCase=function(e){return e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()))},e.toTitleCaseLowerFirst=function(e){const t=e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()));return t.charAt(0).toLowerCase()+t.slice(1)},e}({});
+var TinyEssentials=function(e){"use strict";function t(e,t="seconds",n="{time}"){e=Math.max(0,Math.floor(e));const r=["seconds","minutes","hours","days","months","years"].indexOf(t),i=r>=5,o=r>=4,a=r>=3,s=r>=2,u=r>=1,l=r>=0,c={years:i?0:NaN,months:o?0:NaN,days:a?0:NaN,hours:s?0:NaN,minutes:u?0:NaN,seconds:l?0:NaN,total:NaN};let p=e;if(i||o||a){const e=new Date(1980,0,1),t=new Date(e.getTime()+1e3*p),n=new Date(e);if(i)for(;new Date(n.getFullYear()+1,n.getMonth(),n.getDate())<=t;)n.setFullYear(n.getFullYear()+1),c.years++;if(o)for(;new Date(n.getFullYear(),n.getMonth()+1,n.getDate())<=t;)n.setMonth(n.getMonth()+1),c.months++;if(a)for(;new Date(n.getFullYear(),n.getMonth(),n.getDate()+1)<=t;)n.setDate(n.getDate()+1),c.days++;p=Math.floor((t-n)/1e3)}s&&(c.hours=Math.floor(p/3600),p%=3600),u&&(c.minutes=Math.floor(p/60),p%=60),l&&(c.seconds=p);const g={seconds:l?e:NaN,minutes:u?e/60:NaN,hours:s?e/3600:NaN,days:a?e/86400:NaN,months:o?12*c.years+c.months+(c.days||0)/30:NaN,years:i?c.years+(c.months||0)/12+(c.days||0)/365:NaN};c.total=+(g[t]||0).toFixed(2).replace(/\.00$/,"");const h=e=>isNaN(e)?"NaN":String(e).padStart(2,"0"),f=[s?h(c.hours):null,u?h(c.minutes):null,l?h(c.seconds):null].filter((e=>null!==e)).join(":");return n.replace(/\{years\}/g,c.years).replace(/\{months\}/g,c.months).replace(/\{days\}/g,c.days).replace(/\{hours\}/g,h(c.hours)).replace(/\{minutes\}/g,h(c.minutes)).replace(/\{seconds\}/g,h(c.seconds)).replace(/\{time\}/g,f).replace(/\{total\}/g,c.total).trim()}const n={items:{undefined:e=>void 0===e,null:e=>null===e,boolean:e=>"boolean"==typeof e,number:e=>"number"==typeof e&&!isNaN(e),bigint:e=>"bigint"==typeof e,string:e=>"string"==typeof e,symbol:e=>"symbol"==typeof e,function:e=>"function"==typeof e,array:e=>Array.isArray(e),date:e=>e instanceof Date,regexp:e=>e instanceof RegExp,map:e=>e instanceof Map,set:e=>e instanceof Set,weakmap:e=>e instanceof WeakMap,weakset:e=>e instanceof WeakSet,promise:e=>e instanceof Promise,buffer:e=>"undefined"!=typeof Buffer&&Buffer.isBuffer(e),htmlelement:e=>"undefined"!=typeof HTMLElement&&e instanceof HTMLElement,object:e=>"object"==typeof e&&null!==e},order:["undefined","null","boolean","number","bigint","string","symbol","function","array","buffer","date","regexp","map","set","weakmap","weakset","promise","htmlelement","object"]};function r(e,t){if(void 0===e)return null;const r=(e=>{if(null===e)return"null";for(const t of n.order)if(!n.items[t]||n.items[t](e))return t;return"unknown"})(e);return"string"==typeof t?r===t.toLowerCase():r}var i={},o={};const a="undefined"!=typeof window&&void 0!==window.document;return e.TinyCrypto=class{constructor(e={}){this.algorithm=e.algorithm||"aes-256-gcm",this.outputEncoding=e.outputEncoding||"hex",this.inputEncoding=e.inputEncoding||"utf8",this.authTagLength=e.authTagLength||16,this.key=e.key||this.generateKey()}generateKey(e=32){return i.randomBytes(e)}generateIV(e=12){return i.randomBytes(e)}encrypt(e,t=this.generateIV()){const n=this.#e(e),r=i.createCipheriv(this.algorithm,this.key,t,{authTagLength:this.authTagLength});let o=r.update(n,this.inputEncoding);o=Buffer.concat([o,r.final()]);const a=r.getAuthTag();return{iv:t.toString(this.outputEncoding),encrypted:o.toString(this.outputEncoding),authTag:a.toString(this.outputEncoding)}}decrypt({iv:e,encrypted:t,authTag:n},r=null){const o=Buffer.from(e,this.outputEncoding),a=Buffer.from(t,this.outputEncoding),s=Buffer.from(n,this.outputEncoding),u=i.createDecipheriv(this.algorithm,this.key,o,{authTagLength:this.authTagLength});u.setAuthTag(s);let l=u.update(a,null,this.inputEncoding);l+=u.final(this.inputEncoding);const{value:c,type:p}=this.#t(l);return r&&this.#n(r,p),c}getTypeFromEncrypted({iv:e,encrypted:t,authTag:n}){const r=Buffer.from(e,this.outputEncoding),o=Buffer.from(t,this.outputEncoding),a=Buffer.from(n,this.outputEncoding),s=i.createDecipheriv(this.algorithm,this.key,r,{authTagLength:this.authTagLength});s.setAuthTag(a);let u=s.update(o,null,this.inputEncoding);u+=s.final(this.inputEncoding);const{type:l}=this.#t(u);return"string"==typeof l?l:"unknown"}saveKeyToFile(e="secret.key"){const t=this.key.toString("hex");if(a){const n=new Blob([t],{type:"text/plain"}),r=URL.createObjectURL(n),i=document.createElement("a");i.href=r,i.download=e,i.click(),URL.revokeObjectURL(r)}else o.writeFileSync(e,t)}saveConfigToFile(e="crypto-config.json"){const t=JSON.stringify(this.exportConfig(),null,2);if(a){const n=new Blob([t],{type:"application/json"}),r=URL.createObjectURL(n),i=document.createElement("a");i.href=r,i.download=e,i.click(),URL.revokeObjectURL(r)}else o.writeFileSync(e,t)}async loadConfigFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{try{const e=JSON.parse(r.result);t(this.importConfig(e))}catch(e){n(new Error("Invalid config JSON file"))}},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=o.readFileSync(e,"utf8"),n=JSON.parse(t);return this.importConfig(n)}}async loadKeyFromFile(e){if(a)return new Promise(((t,n)=>{const r=new FileReader;r.onload=()=>{const e=r.result.trim(),n=Buffer.from(e,"hex");this.key=n,t(n)},r.onerror=()=>n(r.error),r.readAsText(e)}));{const t=o.readFileSync(e,"utf8"),n=Buffer.from(t,"hex");return this.key=n,n}}exportConfig(){return{algorithm:this.algorithm,outputEncoding:this.outputEncoding,inputEncoding:this.inputEncoding,key:this.key.toString("hex"),authTagLength:this.authTagLength}}importConfig(e){if("string"==typeof e.algorithm)this.algorithm=e.algorithm;else if(void 0!==e.algorithm)throw new Error('Invalid or missing "algorithm" property. Expected a string.');if("string"==typeof e.outputEncoding)this.outputEncoding=e.outputEncoding;else if(void 0!==e.outputEncoding)throw new Error('Invalid or missing "outputEncoding" property. Expected a string.');if("string"==typeof e.inputEncoding)this.inputEncoding=e.inputEncoding;else if(void 0!==e.inputEncoding)throw new Error('Invalid or missing "inputEncoding" property. Expected a string.');if("number"==typeof e.authTagLength)this.authTagLength=e.authTagLength;else if(void 0!==e.authTagLength)throw new Error('Invalid or missing "authTagLength" property. Expected a number.');if("string"==typeof e.key)this.key=Buffer.from(e.key,"hex");else if(void 0!==e.key)throw new Error('Invalid or missing "key" property. Expected a hexadecimal string.')}#r={weakmap:()=>{throw new Error("WeakMap cannot be serialized")},weakset:()=>{throw new Error("WeakSet cannot be serialized")},promise:()=>{throw new Error("Promise cannot be serialized")},function:()=>{throw new Error("Function cannot be serialized")},regexp:e=>JSON.stringify({__type:"regexp",value:e.toString()}),htmlElement:e=>JSON.stringify({__type:"htmlelement",value:e.outerHTML}),date:e=>JSON.stringify({__type:"date",value:e.toISOString()}),bigint:e=>JSON.stringify({__type:"bigint",value:e.toString()}),number:e=>JSON.stringify({__type:"number",value:e}),boolean:e=>JSON.stringify({__type:"boolean",value:e}),string:e=>JSON.stringify({__type:"string",value:e}),null:e=>JSON.stringify({__type:"null"}),undefined:e=>JSON.stringify({__type:"undefined"}),map:e=>JSON.stringify({__type:"map",value:Array.from(e.entries())}),set:e=>JSON.stringify({__type:"set",value:Array.from(e.values())}),symbol:e=>JSON.stringify({__type:"symbol",value:e.description}),array:e=>JSON.stringify({__type:"array",value:e}),object:e=>JSON.stringify({__type:"object",value:e}),buffer:e=>JSON.stringify({__type:"buffer",value:e.toString("base64")})};#i={regexp:e=>{const t=e.match(/^\/(.*)\/([gimsuy]*)$/);return t?new RegExp(t[1],t[2]):new RegExp(e)},htmlelement:e=>{if("undefined"==typeof document)throw new Error("HTMLElement deserialization is only supported in browsers");const t=document.createElement("div");return t.innerHTML=e,t.firstElementChild},date:e=>new Date(e),bigint:e=>BigInt(e),number:e=>Number(e),boolean:e=>Boolean(e),null:e=>null,undefined:e=>{},map:e=>new Map(e),set:e=>new Set(e),symbol:e=>Symbol(e),array:e=>e,object:e=>e,string:e=>String(e),buffer:e=>Buffer.from(e,"base64")};#e(e){const t=r(e)||"undefined";if(this.#r[t])return this.#r[t](e);throw new Error(`Unsupported data type for encryption: ${t}`)}#t(e){try{const t=JSON.parse(e),n=t.__type;return"string"!=typeof n?{value:e,type:"string"}:"function"==typeof this.#i[n]?{value:this.#i[n](t.value),type:n}:{value:e,type:"Unknown"}}catch{return{value:e,type:"Unknown"}}}#n(e,t){if(e!==t)throw new Error(`Type mismatch: expected ${e}, but got ${t}`)}},e.TinyLevelUp=class{constructor(e,t){this.giveExp=e,this.expLevel=t}expValidator(e){let t=0;const n=this.expLevel*e.level;return e.exp>=n&&(e.level++,t=e.exp-n,e.exp=0,t>0)?this.give(e,t,"extra"):e.exp<1&&e.level>1&&(e.level--,t=Math.abs(e.exp),e.exp=this.expLevel*e.level,t>0)?this.remove(e,t,"extra"):e}getTotalExp(e){let t=0;for(let n=1;n<=e.level;n++)t+=this.expLevel*n;return t+=e.exp,t}expGenerator(e=1){return Math.floor(Math.random()*this.giveExp)+1*e}progress(e){return this.expLevel*e.level}getProgress(e){return this.expLevel*e.level}set(e,t){return e.exp=t,this.expValidator(e),e.totalExp=this.getTotalExp(e),e}give(e,t=0,n="add",r=1){return"add"===n?e.exp+=this.expGenerator(r)+t:"extra"===n&&(e.exp+=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}remove(e,t=0,n="add",r=1){return"add"===n?e.exp-=this.expGenerator(r)+t:"extra"===n&&(e.exp-=t),this.expValidator(e),e.totalExp=this.getTotalExp(e),e}},e.asyncReplace=async function(e,t,n){const r=[];e.replace(t,((e,...t)=>(r.push(n(e,...t)),e)));const i=await Promise.all(r);return e.replace(t,(()=>i.shift()))},e.cloneObjTypeOrder=function(){return[...n.order]},e.countObj=function(e){return Array.isArray(e)?e.length:r(e,"object")?Object.keys(e).length:0},e.extendObjType=function(e,t){const r=[];for(const[i,o]of Object.entries(e))if(!n.items.hasOwnProperty(i)){n.items[i]=o;let e="number"==typeof t?t:-1;if(-1===e){const t=n.order.indexOf("object");e=t>-1?t:n.order.length}e=Math.min(Math.max(0,e),n.order.length),n.order.splice(e,0,i),r.push(i)}return r},e.formatCustomTimer=t,e.formatDayTimer=function(e){return t(e,"days","{days}d {hours}:{minutes}:{seconds}")},e.formatTimer=function(e){return t(e,"hours","{hours}:{minutes}:{seconds}")},e.getAge=function(e=0,t=null){if(null!=e&&0!==e){const n=new Date(e);if(isNaN(n))return null;const r=t instanceof Date?t:new Date;let i=r.getFullYear()-n.getFullYear();const o=r.getMonth(),a=n.getMonth(),s=r.getDate(),u=n.getDate();return(o<a||o===a&&s<u)&&i--,Math.abs(i)}return null},e.getSimplePerc=function(e,t){return e*(t/100)},e.getTimeDuration=function(e=new Date,t="asSeconds",n=null){if(e instanceof Date){const r=e-(n instanceof Date?n:new Date);switch(t){case"asMilliseconds":return r;case"asSeconds":default:return r/1e3;case"asMinutes":return r/6e4;case"asHours":return r/36e5;case"asDays":return r/864e5}}return null},e.objType=r,e.reorderObjTypeOrder=function(e){const t=[...n.order];return!!e.every((e=>t.includes(e)))&&(n.order=e.slice(),!0)},e.ruleOfThree=function(e,t,n,r){return r?Number(e*t)/n:Number(n*t)/e},e.shuffleArray=function(e){let t,n=e.length;for(;0!==n;)t=Math.floor(Math.random()*n),n--,[e[n],e[t]]=[e[t],e[n]];return e},e.toTitleCase=function(e){return e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()))},e.toTitleCaseLowerFirst=function(e){const t=e.replace(/\w\S*/g,(e=>e.charAt(0).toUpperCase()+e.substr(1).toLowerCase()));return t.charAt(0).toLowerCase()+t.slice(1)},e}({});

package/dist/v1/basics/objFilter.cjs

@@ -1,5 +1,210 @@
 'use strict';
 
+/**
+ * An object containing type validation functions and their evaluation order.
+ *
+ * Each item in `typeValidator.items` is a function that receives any value
+ * and returns a boolean indicating whether the value matches the corresponding type.
+ *
+ * The `order` array defines the priority in which types should be checked,
+ * which can be useful for functions that infer types in a consistent manner.
+ *
+ * @typedef {Object} TypeValidator
+ * @property {Object.<string, (val: any) => boolean>} items - A dictionary of type validation functions.
+ * @property {string[]} order - The order in which types should be evaluated.
+ */
+
+/**
+ * Validates values against specific types using predefined functions.
+ *
+ * @type {TypeValidator}
+ */
+const typeValidator = {
+  items: {
+    /** Checks if the value is undefined. */
+    undefined: (val) => typeof val === 'undefined',
+
+    /** Checks if the value is null. */
+    null: (val) => val === null,
+
+    /** Checks if the value is a boolean. */
+    boolean: (val) => typeof val === 'boolean',
+
+    /** Checks if the value is a number. */
+    number: (val) => typeof val === 'number' && !isNaN(val),
+
+    /** Checks if the value is a bigint. */
+    bigint: (val) => typeof val === 'bigint',
+
+    /** Checks if the value is a string. */
+    string: (val) => typeof val === 'string',
+
+    /** Checks if the value is a symbol. */
+    symbol: (val) => typeof val === 'symbol',
+
+    /** Checks if the value is a function. */
+    function: (val) => typeof val === 'function',
+
+    /** Checks if the value is an array. */
+    array: (val) => Array.isArray(val),
+
+    /** Checks if the value is a Date object. */
+    date: (val) => val instanceof Date,
+
+    /** Checks if the value is a regular expression. */
+    regexp: (val) => val instanceof RegExp,
+
+    /** Checks if the value is a Map. */
+    map: (val) => val instanceof Map,
+
+    /** Checks if the value is a Set. */
+    set: (val) => val instanceof Set,
+
+    /** Checks if the value is a WeakMap. */
+    weakmap: (val) => val instanceof WeakMap,
+
+    /** Checks if the value is a WeakSet. */
+    weakset: (val) => val instanceof WeakSet,
+
+    /** Checks if the value is a Promise. */
+    promise: (val) => val instanceof Promise,
+
+    /** Checks if the value is a Buffer. */
+    buffer: (val) => typeof Buffer !== 'undefined' && Buffer.isBuffer(val),
+
+    /** Checks if the value is a Html Element. */
+    htmlelement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
+
+    /** Checks if the value is a non-null plain object or instance of a class. */
+    object: (val) => typeof val === 'object' && val !== null,
+  },
+
+  /** Evaluation order of the type checkers. */
+  order: [
+    'undefined',
+    'null',
+    'boolean',
+    'number',
+    'bigint',
+    'string',
+    'symbol',
+    'function',
+    'array',
+    'buffer',
+    'date',
+    'regexp',
+    'map',
+    'set',
+    'weakmap',
+    'weakset',
+    'promise',
+    'htmlelement',
+    'object',
+  ],
+};
+
+/**
+ * Adds new type checkers to the typeValidator without overwriting existing ones.
+ *
+ * Optionally, you can specify the index at which the new type should be inserted in the order.
+ * If no index is provided, the type is inserted just before 'object' (if it exists), or at the end.
+ *
+ * @param {Object.<string, (val: any) => boolean>} newItems - New type validators to be added.
+ * @param {number} [index] - Optional. Position at which to insert each new type. Ignored if the type already exists.
+ * @returns {string[]} - A list of successfully added type names.
+ *
+ * @example
+ * extendObjType({
+ *   htmlElement2: val => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement
+ * });
+ */
+function extendObjType(newItems, index) {
+  const added = [];
+
+  for (const [key, fn] of Object.entries(newItems)) {
+    if (!typeValidator.items.hasOwnProperty(key)) {
+      typeValidator.items[key] = fn;
+
+      let insertAt = typeof index === 'number' ? index : -1; // Default to -1 if index isn't provided
+
+      // Default to before 'object', or to the end
+      if (insertAt === -1) {
+        const objectIndex = typeValidator.order.indexOf('object');
+        insertAt = objectIndex > -1 ? objectIndex : typeValidator.order.length;
+      }
+
+      // Ensure insertAt is a valid number and not out of bounds
+      insertAt = Math.min(Math.max(0, insertAt), typeValidator.order.length);
+
+      typeValidator.order.splice(insertAt, 0, key);
+      added.push(key);
+    }
+  }
+
+  return added;
+}
+
+/**
+ * Reorders the typeValidator.order array according to a custom new order.
+ * All values in the new order must already exist in the current order.
+ * The function does not mutate the original array structure directly.
+ *
+ * @param {string[]} newOrder - The new order of type names.
+ * @returns {boolean} - Returns true if the reorder was successful, false if invalid keys were found.
+ *
+ * @example
+ * reorderObjTypeOrder([
+ *   'string', 'number', 'array', 'object'
+ * ]);
+ */
+function reorderObjTypeOrder(newOrder) {
+  const currentOrder = [...typeValidator.order]; // shallow clone
+
+  // All keys in newOrder must exist in currentOrder
+  const isValid = newOrder.every((type) => currentOrder.includes(type));
+
+  if (!isValid) return false;
+
+  // Reassign only if valid
+  typeValidator.order = newOrder.slice(); // assign shallow copy
+  return true;
+}
+
+/**
+ * Returns a cloned version of the `typeValidator.order` array.
+ * The cloned array will not be affected by future changes to the original `order`.
+ *
+ * @returns {string[]} - A new array with the same values as `typeValidator.order`.
+ */
+function cloneObjTypeOrder() {
+  return [...typeValidator.order]; // Creates a shallow copy of the array
+}
+
+/**
+ * Returns the detected type name of a given value based on predefined type validators.
+ *
+ * This function uses `getType` with a predefined `typeValidator` to determine or compare types safely.
+ * in the specified `typeValidator.order`. The first matching type is returned.
+ *
+ * If `val` is `null`, it immediately returns `'null'`.
+ * If no match is found, it returns `'unknown'`.
+ *
+ * @param {any} val - The value whose type should be determined.
+ * @returns {string} - The type name of the value (e.g., "array", "date", "map"), or "unknown" if no match is found.
+ *
+ * @example
+ * getType([]); // "array"
+ * getType(null); // "null"
+ * getType(new Set()); // "set"
+ * getType(() => {}); // "unknown"
+ */
+const getType = (val) => {
+  if (val === null) return 'null';
+  for (const name of typeValidator.order)
+    if (!typeValidator.items[name] || typeValidator.items[name](val)) return name;
+  return 'unknown';
+};
+
 /**
  * Checks the type of a given object or returns its type as a string.
  *
@@ -15,20 +220,10 @@
  * objType(undefined); // null
  */
 function objType(obj, type) {
-  // Is Defined
-  if (typeof obj !== 'undefined') {
-    // Get Obj Type
-    const result = Object.prototype.toString.call(obj).toLowerCase();
-    // Check Obj Type
-    if (typeof type === 'string') {
-      if (result === `[object ${type}]`) return true;
-      return false;
-    }
-    // Send Result
-    return result.substring(8, result.length - 1);
-  }
-  // Nope
-  return null;
+  if (typeof obj === 'undefined') return null;
+  const result = getType(obj);
+  if (typeof type === 'string') return result === type.toLowerCase();
+  return result;
 }
 
 /**
@@ -51,5 +246,8 @@ function countObj(obj) {
   return 0;
 }
 
+exports.cloneObjTypeOrder = cloneObjTypeOrder;
 exports.countObj = countObj;
+exports.extendObjType = extendObjType;
 exports.objType = objType;
+exports.reorderObjTypeOrder = reorderObjTypeOrder;

package/dist/v1/basics/objFilter.d.mts

@@ -1,3 +1,42 @@
+/**
+ * Adds new type checkers to the typeValidator without overwriting existing ones.
+ *
+ * Optionally, you can specify the index at which the new type should be inserted in the order.
+ * If no index is provided, the type is inserted just before 'object' (if it exists), or at the end.
+ *
+ * @param {Object.<string, (val: any) => boolean>} newItems - New type validators to be added.
+ * @param {number} [index] - Optional. Position at which to insert each new type. Ignored if the type already exists.
+ * @returns {string[]} - A list of successfully added type names.
+ *
+ * @example
+ * extendObjType({
+ *   htmlElement2: val => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement
+ * });
+ */
+export function extendObjType(newItems: {
+    [x: string]: (val: any) => boolean;
+}, index?: number): string[];
+/**
+ * Reorders the typeValidator.order array according to a custom new order.
+ * All values in the new order must already exist in the current order.
+ * The function does not mutate the original array structure directly.
+ *
+ * @param {string[]} newOrder - The new order of type names.
+ * @returns {boolean} - Returns true if the reorder was successful, false if invalid keys were found.
+ *
+ * @example
+ * reorderObjTypeOrder([
+ *   'string', 'number', 'array', 'object'
+ * ]);
+ */
+export function reorderObjTypeOrder(newOrder: string[]): boolean;
+/**
+ * Returns a cloned version of the `typeValidator.order` array.
+ * The cloned array will not be affected by future changes to the original `order`.
+ *
+ * @returns {string[]} - A new array with the same values as `typeValidator.order`.
+ */
+export function cloneObjTypeOrder(): string[];
 /**
  * Checks the type of a given object or returns its type as a string.
  *
@@ -25,3 +64,24 @@ export function objType(obj: any, type?: string): boolean | string | null;
  * countObj('not an object'); // 0
  */
 export function countObj(obj: any): number;
+/**
+ * An object containing type validation functions and their evaluation order.
+ *
+ * Each item in `typeValidator.items` is a function that receives any value
+ * and returns a boolean indicating whether the value matches the corresponding type.
+ *
+ * The `order` array defines the priority in which types should be checked,
+ * which can be useful for functions that infer types in a consistent manner.
+ */
+export type TypeValidator = {
+    /**
+     * - A dictionary of type validation functions.
+     */
+    items: {
+        [x: string]: (val: any) => boolean;
+    };
+    /**
+     * - The order in which types should be evaluated.
+     */
+    order: string[];
+};

package/dist/v1/basics/objFilter.mjs

@@ -1,3 +1,177 @@
+/**
+ * An object containing type validation functions and their evaluation order.
+ *
+ * Each item in `typeValidator.items` is a function that receives any value
+ * and returns a boolean indicating whether the value matches the corresponding type.
+ *
+ * The `order` array defines the priority in which types should be checked,
+ * which can be useful for functions that infer types in a consistent manner.
+ *
+ * @typedef {Object} TypeValidator
+ * @property {Object.<string, (val: any) => boolean>} items - A dictionary of type validation functions.
+ * @property {string[]} order - The order in which types should be evaluated.
+ */
+/**
+ * Validates values against specific types using predefined functions.
+ *
+ * @type {TypeValidator}
+ */
+const typeValidator = {
+    items: {
+        /** Checks if the value is undefined. */
+        undefined: (val) => typeof val === 'undefined',
+        /** Checks if the value is null. */
+        null: (val) => val === null,
+        /** Checks if the value is a boolean. */
+        boolean: (val) => typeof val === 'boolean',
+        /** Checks if the value is a number. */
+        number: (val) => typeof val === 'number' && !isNaN(val),
+        /** Checks if the value is a bigint. */
+        bigint: (val) => typeof val === 'bigint',
+        /** Checks if the value is a string. */
+        string: (val) => typeof val === 'string',
+        /** Checks if the value is a symbol. */
+        symbol: (val) => typeof val === 'symbol',
+        /** Checks if the value is a function. */
+        function: (val) => typeof val === 'function',
+        /** Checks if the value is an array. */
+        array: (val) => Array.isArray(val),
+        /** Checks if the value is a Date object. */
+        date: (val) => val instanceof Date,
+        /** Checks if the value is a regular expression. */
+        regexp: (val) => val instanceof RegExp,
+        /** Checks if the value is a Map. */
+        map: (val) => val instanceof Map,
+        /** Checks if the value is a Set. */
+        set: (val) => val instanceof Set,
+        /** Checks if the value is a WeakMap. */
+        weakmap: (val) => val instanceof WeakMap,
+        /** Checks if the value is a WeakSet. */
+        weakset: (val) => val instanceof WeakSet,
+        /** Checks if the value is a Promise. */
+        promise: (val) => val instanceof Promise,
+        /** Checks if the value is a Buffer. */
+        buffer: (val) => typeof Buffer !== 'undefined' && Buffer.isBuffer(val),
+        /** Checks if the value is a Html Element. */
+        htmlelement: (val) => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement,
+        /** Checks if the value is a non-null plain object or instance of a class. */
+        object: (val) => typeof val === 'object' && val !== null,
+    },
+    /** Evaluation order of the type checkers. */
+    order: [
+        'undefined',
+        'null',
+        'boolean',
+        'number',
+        'bigint',
+        'string',
+        'symbol',
+        'function',
+        'array',
+        'buffer',
+        'date',
+        'regexp',
+        'map',
+        'set',
+        'weakmap',
+        'weakset',
+        'promise',
+        'htmlelement',
+        'object',
+    ],
+};
+/**
+ * Adds new type checkers to the typeValidator without overwriting existing ones.
+ *
+ * Optionally, you can specify the index at which the new type should be inserted in the order.
+ * If no index is provided, the type is inserted just before 'object' (if it exists), or at the end.
+ *
+ * @param {Object.<string, (val: any) => boolean>} newItems - New type validators to be added.
+ * @param {number} [index] - Optional. Position at which to insert each new type. Ignored if the type already exists.
+ * @returns {string[]} - A list of successfully added type names.
+ *
+ * @example
+ * extendObjType({
+ *   htmlElement2: val => typeof HTMLElement !== 'undefined' && val instanceof HTMLElement
+ * });
+ */
+export function extendObjType(newItems, index) {
+    const added = [];
+    for (const [key, fn] of Object.entries(newItems)) {
+        if (!typeValidator.items.hasOwnProperty(key)) {
+            typeValidator.items[key] = fn;
+            let insertAt = typeof index === 'number' ? index : -1; // Default to -1 if index isn't provided
+            // Default to before 'object', or to the end
+            if (insertAt === -1) {
+                const objectIndex = typeValidator.order.indexOf('object');
+                insertAt = objectIndex > -1 ? objectIndex : typeValidator.order.length;
+            }
+            // Ensure insertAt is a valid number and not out of bounds
+            insertAt = Math.min(Math.max(0, insertAt), typeValidator.order.length);
+            typeValidator.order.splice(insertAt, 0, key);
+            added.push(key);
+        }
+    }
+    return added;
+}
+/**
+ * Reorders the typeValidator.order array according to a custom new order.
+ * All values in the new order must already exist in the current order.
+ * The function does not mutate the original array structure directly.
+ *
+ * @param {string[]} newOrder - The new order of type names.
+ * @returns {boolean} - Returns true if the reorder was successful, false if invalid keys were found.
+ *
+ * @example
+ * reorderObjTypeOrder([
+ *   'string', 'number', 'array', 'object'
+ * ]);
+ */
+export function reorderObjTypeOrder(newOrder) {
+    const currentOrder = [...typeValidator.order]; // shallow clone
+    // All keys in newOrder must exist in currentOrder
+    const isValid = newOrder.every((type) => currentOrder.includes(type));
+    if (!isValid)
+        return false;
+    // Reassign only if valid
+    typeValidator.order = newOrder.slice(); // assign shallow copy
+    return true;
+}
+/**
+ * Returns a cloned version of the `typeValidator.order` array.
+ * The cloned array will not be affected by future changes to the original `order`.
+ *
+ * @returns {string[]} - A new array with the same values as `typeValidator.order`.
+ */
+export function cloneObjTypeOrder() {
+    return [...typeValidator.order]; // Creates a shallow copy of the array
+}
+/**
+ * Returns the detected type name of a given value based on predefined type validators.
+ *
+ * This function uses `getType` with a predefined `typeValidator` to determine or compare types safely.
+ * in the specified `typeValidator.order`. The first matching type is returned.
+ *
+ * If `val` is `null`, it immediately returns `'null'`.
+ * If no match is found, it returns `'unknown'`.
+ *
+ * @param {any} val - The value whose type should be determined.
+ * @returns {string} - The type name of the value (e.g., "array", "date", "map"), or "unknown" if no match is found.
+ *
+ * @example
+ * getType([]); // "array"
+ * getType(null); // "null"
+ * getType(new Set()); // "set"
+ * getType(() => {}); // "unknown"
+ */
+const getType = (val) => {
+    if (val === null)
+        return 'null';
+    for (const name of typeValidator.order)
+        if (!typeValidator.items[name] || typeValidator.items[name](val))
+            return name;
+    return 'unknown';
+};
 /**
  * Checks the type of a given object or returns its type as a string.
  *
@@ -13,21 +187,12 @@
  * objType(undefined); // null
  */
 export function objType(obj, type) {
-    // Is Defined
-    if (typeof obj !== 'undefined') {
-        // Get Obj Type
-        const result = Object.prototype.toString.call(obj).toLowerCase();
-        // Check Obj Type
-        if (typeof type === 'string') {
-            if (result === `[object ${type}]`)
-                return true;
-            return false;
-        }
-        // Send Result
-        return result.substring(8, result.length - 1);
-    }
-    // Nope
-    return null;
+    if (typeof obj === 'undefined')
+        return null;
+    const result = getType(obj);
+    if (typeof type === 'string')
+        return result === type.toLowerCase();
+    return result;
 }
 /**
  * Counts the number of elements in an array or the number of properties in an object.

package/dist/v1/index.cjs

@@ -7,6 +7,7 @@ var clock = require('./basics/clock.cjs');
 var objFilter = require('./basics/objFilter.cjs');
 var simpleMath = require('./basics/simpleMath.cjs');
 var text = require('./basics/text.cjs');
+var TinyCrypto = require('./libs/TinyCrypto.cjs');
 
 
 
@@ -17,10 +18,14 @@ exports.formatCustomTimer = clock.formatCustomTimer;
 exports.formatDayTimer = clock.formatDayTimer;
 exports.formatTimer = clock.formatTimer;
 exports.getTimeDuration = clock.getTimeDuration;
+exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.countObj = objFilter.countObj;
+exports.extendObjType = objFilter.extendObjType;
 exports.objType = objFilter.objType;
+exports.reorderObjTypeOrder = objFilter.reorderObjTypeOrder;
 exports.getAge = simpleMath.getAge;
 exports.getSimplePerc = simpleMath.getSimplePerc;
 exports.ruleOfThree = simpleMath.ruleOfThree;
 exports.toTitleCase = text.toTitleCase;
 exports.toTitleCaseLowerFirst = text.toTitleCaseLowerFirst;
+exports.TinyCrypto = TinyCrypto;

package/dist/v1/index.d.mts

@@ -1,4 +1,8 @@
+import TinyCrypto from './libs/TinyCrypto.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { extendObjType } from './basics/objFilter.mjs';
+import { reorderObjTypeOrder } from './basics/objFilter.mjs';
+import { cloneObjTypeOrder } from './basics/objFilter.mjs';
 import { countObj } from './basics/objFilter.mjs';
 import { objType } from './basics/objFilter.mjs';
 import { ruleOfThree } from './basics/simpleMath.mjs';
@@ -12,4 +16,4 @@ import { getTimeDuration } from './basics/clock.mjs';
 import { shuffleArray } from './basics/array.mjs';
 import { toTitleCase } from './basics/text.mjs';
 import { toTitleCaseLowerFirst } from './basics/text.mjs';
-export { TinyLevelUp, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyCrypto, TinyLevelUp, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };