tiny-essentials 1.25.2 → 1.25.4

package/dist/v1/TinyIframeEvents.min.js

@@ -1 +1 @@
-(()=>{"use strict";var e={d:(t,n)=>{for(var s in n)e.o(n,s)&&!e.o(t,s)&&Object.defineProperty(t,s,{enumerable:!0,get:n[s]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyIframeEvents:()=>r});const n=class{#e=new Map;#t=10;#n=!1;#s(e,t){if("string"==typeof e)return[e];if(Array.isArray(e)&&e.every(e=>"string"==typeof e))return e;throw new TypeError(`${t}(event): event must be a string or string[]`)}setThrowOnMaxListeners(e){if("boolean"!=typeof e)throw new TypeError("setThrowOnMaxListeners(value): value must be a boolean");this.#n=e}getThrowOnMaxListeners(){return this.#n}#r(e,t,{once:n=!1}={}){let s=this.#e.get(e);Array.isArray(s)||(s=[],this.#e.set(e,s)),s.unshift({handler:t,config:{once:n}});const r=this.#t;if(r>0&&s.length>r){const t=`Possible memory leak detected. ${s.length} "${e}" listeners added. Use setMaxListeners() to increase limit.`;if(this.#n)throw new Error(t);console.warn(t)}}prependListener(e,t){const n=this.#s(e,"prependListener");if("function"!=typeof t)throw new TypeError("prependListener(event, handler): handler must be a function");for(const e of n)this.#r(e,t)}prependListenerOnce(e,t){const n=this.#s(e,"prependListenerOnce");if("function"!=typeof t)throw new TypeError("prependListenerOnce(event, handler): handler must be a function");const s=[];for(const e of n){const n=(...s)=>{this.off(e,n),t(...s)};this.#r(e,n,{once:!0}),s.push(n)}return s}#i(e,t,{once:n=!1}={}){const s=this.#s(e,"on");for(const e of s){let s=this.#e.get(e);Array.isArray(s)||(s=[],this.#e.set(e,s)),s.push({handler:t,config:{once:n}});const r=this.#t;if(r>0&&s.length>r){const t=`Possible memory leak detected. ${s.length} "${e}" listeners added. Use setMaxListeners() to increase limit.`;if(this.#n)throw new Error(t);console.warn(t)}}}on(e,t){if("function"!=typeof t)throw new TypeError("on(event, handler): handler must be a function");return this.#i(e,t)}once(e,t){const n=this.#s(e,"once");if("function"!=typeof t)throw new TypeError("once(event, handler): handler must be a function");const s=[];for(const e of n){const n=(...s)=>{this.off(e,n),t(...s)};this.#i(e,n,{once:!0}),s.push(n)}return s}appendListener(e,t){return this.on(e,t)}appendListenerOnce(e,t){return this.once(e,t)}off(e,t){const n=this.#s(e,"off");if("function"!=typeof t)throw new TypeError("off(event, handler): handler must be a function");for(const e of n){const n=this.#e.get(e);if(!Array.isArray(n))continue;const s=n.findIndex(e=>e.handler===t);-1!==s&&n.splice(s,1),0===n.length&&this.#e.delete(e)}}offAll(e){const t=this.#s(e,"offAll");for(const e of t)this.#e.delete(e)}offAllTypes(){this.#e.clear()}listenerCount(e){if("string"!=typeof e)throw new TypeError("listenerCount(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?t.length:0}listeners(e){if("string"!=typeof e)throw new TypeError("listeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].filter(e=>!e.config.once).map(e=>e.handler):[]}onceListeners(e){if("string"!=typeof e)throw new TypeError("onceListeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].filter(e=>e.config.once).map(e=>e.handler):[]}allListeners(e){if("string"!=typeof e)throw new TypeError("allListeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].map(e=>e.handler):[]}eventNames(){return[...this.#e.keys()]}emit(e,...t){const n=this.#s(e,"emit"),s=[];for(const e of n){const n=this.#e.get(e);Array.isArray(n)&&0!==n.length?(n.forEach(e=>e.handler(...t)),s.push(!0)):s.push(!1)}return s}setMaxListeners(e){if(!Number.isInteger(e)||e<0)throw new TypeError("setMaxListeners(n): n must be a non-negative integer");this.#t=e}getMaxListeners(){return this.#t}},s=new WeakMap,r=class{#o=new n;setThrowOnMaxListeners(e){return this.#o.setThrowOnMaxListeners(e)}getThrowOnMaxListeners(){return this.#o.getThrowOnMaxListeners()}prependListener(e,t){return this.#o.prependListener(e,t)}prependListenerOnce(e,t){return this.#o.prependListenerOnce(e,t)}appendListener(e,t){return this.#o.appendListener(e,t)}appendListenerOnce(e,t){return this.#o.appendListenerOnce(e,t)}on(e,t){return this.#o.on(e,t)}once(e,t){return this.#o.once(e,t)}off(e,t){return this.#o.off(e,t)}offAll(e){return this.#o.offAll(e)}offAllTypes(){return this.#o.offAllTypes()}listenerCount(e){return this.#o.listenerCount(e)}listeners(e){return this.#o.listeners(e)}onceListeners(e){return this.#o.onceListeners(e)}allListeners(e){return this.#o.allListeners(e)}eventNames(){return this.#o.eventNames()}setMaxListeners(e){return this.#o.setMaxListeners(e)}getMaxListeners(){return this.#o.getMaxListeners()}#a;#h;#d;#f=!1;#c=!1;#l=[];#p="__tinyIframeEvent__";get secretEventName(){return this.#p}set secretEventName(e){if("string"!=typeof e)throw new TypeError("TinyIframeEvents: secretEventName must be a string.");this.#p=e}constructor({targetIframe:e,targetOrigin:t}={}){if(!(void 0===e||e instanceof HTMLIFrameElement&&e.contentWindow))throw new TypeError('[TinyIframeEvents] Invalid "targetIframe" provided: expected a HTML Iframe Element, received '+typeof e);if(void 0!==t&&"string"!=typeof t)throw new TypeError('[TinyIframeEvents] Invalid "targetOrigin" provided: expected a string, received '+typeof t);if(this.#a=e?.contentWindow??window.parent,this.#h=t??window.location.origin,this.#d=e?"parent":"iframe",s.has(this.#a))throw new Error("Duplicate window reference.");this._boundOnMessage=this.#u.bind(this),this._boundOnceMessage=this.#g.bind(this),"complete"===this.#a.document.readyState||"interactive"===this.#a.document.readyState?this.#g():(this.#a.addEventListener("load",this._boundOnceMessage,!1),this.#a.addEventListener("DOMContentLoaded",this._boundOnceMessage,!1)),window.addEventListener("message",this._boundOnMessage,!1),s.set(this.#a,this)}#g(){this.#c||(this.#c=!0,this.#y())}#u(e){const{data:t,source:n}=e;if(null===(s=t)||"object"!=typeof s||Array.isArray(s)||"[object Object]"!==Object.prototype.toString.call(s)||!t[this.#p])return;var s;const{eventName:r,payload:i,direction:o}=t;n===this.#a&&("iframe"===this.#d&&"iframe"!==o||"parent"===this.#d&&"parent"!==o||this.#o.emit(r,i,e))}emit(e,t){if("string"!=typeof e)throw new TypeError("Event name must be a string.");if(this.#f)throw new Error("Cannot emit: instance has been destroyed.");const n={[this.#p]:!0,eventName:e,payload:t,direction:"parent"===this.#d?"iframe":"parent"};this.#c?this.#a.postMessage(n,this.#h):this.#l.push(n)}#y(){for(;this.#l.length;){const e=this.#l.shift();e&&this.#a.postMessage(e,this.#h)}}isDestroyed(){return this.#f}destroy(){this.#f=!0,window.removeEventListener("message",this._boundOnMessage),this.#a.removeEventListener("load",this._boundOnceMessage,!1),this.#a.removeEventListener("DOMContentLoaded",this._boundOnceMessage,!1),this.#o.offAllTypes(),this.#l=[],s.delete(this.#a)}};window.TinyIframeEvents=t.TinyIframeEvents})();
+(()=>{"use strict";var e={d:(t,n)=>{for(var s in n)e.o(n,s)&&!e.o(t,s)&&Object.defineProperty(t,s,{enumerable:!0,get:n[s]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};function n(e){return null!==e&&"object"==typeof e&&!Array.isArray(e)&&"[object Object]"===Object.prototype.toString.call(e)}e.d(t,{TinyIframeEvents:()=>i});const s=class{#e=new Map;#t=10;#n=!1;#s(e,t){if("string"==typeof e)return[e];if(Array.isArray(e)&&e.every(e=>"string"==typeof e))return e;throw new TypeError(`${t}(event): event must be a string or string[]`)}setThrowOnMaxListeners(e){if("boolean"!=typeof e)throw new TypeError("setThrowOnMaxListeners(value): value must be a boolean");this.#n=e}getThrowOnMaxListeners(){return this.#n}#r(e,t,{once:n=!1}={}){let s=this.#e.get(e);Array.isArray(s)||(s=[],this.#e.set(e,s)),s.unshift({handler:t,config:{once:n}});const r=this.#t;if(r>0&&s.length>r){const t=`Possible memory leak detected. ${s.length} "${e}" listeners added. Use setMaxListeners() to increase limit.`;if(this.#n)throw new Error(t);console.warn(t)}}prependListener(e,t){const n=this.#s(e,"prependListener");if("function"!=typeof t)throw new TypeError("prependListener(event, handler): handler must be a function");for(const e of n)this.#r(e,t)}prependListenerOnce(e,t){const n=this.#s(e,"prependListenerOnce");if("function"!=typeof t)throw new TypeError("prependListenerOnce(event, handler): handler must be a function");const s=[];for(const e of n){const n=(...s)=>{this.off(e,n),t(...s)};this.#r(e,n,{once:!0}),s.push(n)}return s}#i(e,t,{once:n=!1}={}){const s=this.#s(e,"on");for(const e of s){let s=this.#e.get(e);Array.isArray(s)||(s=[],this.#e.set(e,s)),s.push({handler:t,config:{once:n}});const r=this.#t;if(r>0&&s.length>r){const t=`Possible memory leak detected. ${s.length} "${e}" listeners added. Use setMaxListeners() to increase limit.`;if(this.#n)throw new Error(t);console.warn(t)}}}on(e,t){if("function"!=typeof t)throw new TypeError("on(event, handler): handler must be a function");return this.#i(e,t)}once(e,t){const n=this.#s(e,"once");if("function"!=typeof t)throw new TypeError("once(event, handler): handler must be a function");const s=[];for(const e of n){const n=(...s)=>{this.off(e,n),t(...s)};this.#i(e,n,{once:!0}),s.push(n)}return s}appendListener(e,t){return this.on(e,t)}appendListenerOnce(e,t){return this.once(e,t)}off(e,t){const n=this.#s(e,"off");if("function"!=typeof t)throw new TypeError("off(event, handler): handler must be a function");for(const e of n){const n=this.#e.get(e);if(!Array.isArray(n))continue;const s=n.findIndex(e=>e.handler===t);-1!==s&&n.splice(s,1),0===n.length&&this.#e.delete(e)}}offAll(e){const t=this.#s(e,"offAll");for(const e of t)this.#e.delete(e)}offAllTypes(){this.#e.clear()}listenerCount(e){if("string"!=typeof e)throw new TypeError("listenerCount(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?t.length:0}listeners(e){if("string"!=typeof e)throw new TypeError("listeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].filter(e=>!e.config.once).map(e=>e.handler):[]}onceListeners(e){if("string"!=typeof e)throw new TypeError("onceListeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].filter(e=>e.config.once).map(e=>e.handler):[]}allListeners(e){if("string"!=typeof e)throw new TypeError("allListeners(event): event name must be a string");const t=this.#e.get(e);return Array.isArray(t)?[...t].map(e=>e.handler):[]}eventNames(){return[...this.#e.keys()]}emit(e,...t){const n=this.#s(e,"emit"),s=[];for(const e of n){const n=this.#e.get(e);Array.isArray(n)&&0!==n.length?(n.forEach(e=>e.handler(...t)),s.push(!0)):s.push(!1)}return s}setMaxListeners(e){if(!Number.isInteger(e)||e<0)throw new TypeError("setMaxListeners(n): n must be a non-negative integer");this.#t=e}getMaxListeners(){return this.#t}},r=new WeakMap,i=class{#o=new s;setThrowOnMaxListeners(e){return this.#o.setThrowOnMaxListeners(e)}getThrowOnMaxListeners(){return this.#o.getThrowOnMaxListeners()}prependListener(e,t){return this.#o.prependListener(e,t)}prependListenerOnce(e,t){return this.#o.prependListenerOnce(e,t)}appendListener(e,t){return this.#o.appendListener(e,t)}appendListenerOnce(e,t){return this.#o.appendListenerOnce(e,t)}on(e,t){return this.#o.on(e,t)}once(e,t){return this.#o.once(e,t)}off(e,t){return this.#o.off(e,t)}offAll(e){return this.#o.offAll(e)}offAllTypes(){return this.#o.offAllTypes()}listenerCount(e){return this.#o.listenerCount(e)}listeners(e){return this.#o.listeners(e)}onceListeners(e){return this.#o.onceListeners(e)}allListeners(e){return this.#o.allListeners(e)}eventNames(){return this.#o.eventNames()}setMaxListeners(e){return this.#o.setMaxListeners(e)}getMaxListeners(){return this.#o.getMaxListeners()}#a;get targetWindow(){return this.#a}#h;get targetIframeElement(){return this.#h}#d;get targetOrigin(){return this.#d}#f;get selfType(){return this.#f}#l=!1;#p=!1;get ready(){return this.#p}onReady(e){this.#p?e():this.#o.once(this.#m,e)}#c=null;#y=[];#u;#g;#m;#v=null;constructor({targetIframe:e,targetOrigin:t=window.location.origin,secretEventName:n="__tinyIframeEvent__",handshakeEventName:s="__tinyIframeHandshake__",readyEventName:i="__tinyIframeReady__"}={}){if(!(void 0===e||e instanceof HTMLIFrameElement&&e.contentWindow))throw new TypeError('[TinyIframeEvents] Invalid "targetIframe": expected HTMLIFrameElement, received '+typeof e);if("string"!=typeof t)throw new TypeError('[TinyIframeEvents] Invalid "targetOrigin": expected string, received '+typeof t);if(this.#h=e,this.#a=e?.contentWindow??window.parent,this.#d=t,this.#f=e?"parent":"iframe",this.#u=n,this.#g=s,this.#m=i,r.has(this.#a))throw new Error("Duplicate window reference.");this._boundWindowMessage=this.#w.bind(this),this._boundPortMessage=this.#E.bind(this),this.#L(),r.set(this.#a,this)}get secretEventName(){return this.#u}set secretEventName(e){if("string"!=typeof e)throw new TypeError("TinyIframeEvents: secretEventName must be a string.");this.#u=e}get handshakeEventName(){return this.#g}set handshakeEventName(e){if("string"!=typeof e)throw new TypeError("TinyIframeEvents: handshakeEventName must be a string.");this.#g=e}get readyEventName(){return this.#m}set readyEventName(e){if("string"!=typeof e)throw new TypeError("TinyIframeEvents: readyEventName must be a string.");this.#m=e}#L(){"parent"===this.#f?(this.#v=()=>{if(this.#l)return;this.#c&&this.#c.close();const e=new MessageChannel;this.#c=e.port1,this.#c.onmessage=this._boundPortMessage,this.#p=!1,this.#a.postMessage({type:this.#g},this.#d,[e.port2])},this.#h&&(this.#h.addEventListener("load",this.#v),this.#v())):window.addEventListener("message",this._boundWindowMessage,!1)}#w(e){const t=e.data,s=e.ports;n(t)&&t.type===this.#g&&0!==s.length&&(this.#c=s[0],this.#c.onmessage=this._boundPortMessage,window.removeEventListener("message",this._boundWindowMessage),this.#c.postMessage({type:`${this.#g}_ACK`}),this.#T())}#E(e){const t=e.data;if(n(t)&&t.type===`${this.#g}_ACK`)return void this.#T();if(!n(t)||!t[this.#u])return;const s=t.eventName,r=t.payload,i=t.direction;"string"!=typeof s||"iframe"===this.#f&&"iframe"!==i||"parent"===this.#f&&"parent"!==i||this.#o.emit(s,r,e)}#T(){this.#p||(this.#p=!0,this.#b(),this.#o.emit(this.#m))}#b(){for(;this.#y.length>0;){const e=this.#y.shift();e&&this.#c&&this.#c.postMessage(e)}}emit(e,t){if("string"!=typeof e)throw new TypeError("Event name must be a string.");if(this.#l)throw new Error("Cannot emit: instance has been destroyed.");const n={[this.#u]:!0,eventName:e,payload:t,direction:"parent"===this.#f?"iframe":"parent"};this.#p&&this.#c?this.#c.postMessage(n):this.#y.push(n)}isDestroyed(){return this.#l}destroy(){this.#l=!0,this.#p=!1,window.removeEventListener("message",this._boundWindowMessage),this.#h&&this.#v&&this.#h.removeEventListener("load",this.#v),this.#c&&(this.#c.close(),this.#c=null),this.#o.offAllTypes(),this.#y=[],r.delete(this.#a)}};window.TinyIframeEvents=t.TinyIframeEvents})();

package/dist/v1/build/TinyArrayComparator.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var TinyArrayComparator = require('../libs/TinyArrayComparator.cjs');
+
+
+
+exports.TinyArrayComparator = TinyArrayComparator;

package/dist/v1/build/TinyArrayComparator.d.mts

@@ -0,0 +1,3 @@
+export { TinyArrayComparator };
+import TinyArrayComparator from '../libs/TinyArrayComparator.mjs';
+//# sourceMappingURL=TinyArrayComparator.d.mts.map

package/dist/v1/build/TinyArrayComparator.mjs

@@ -0,0 +1,2 @@
+import TinyArrayComparator from '../libs/TinyArrayComparator.mjs';
+export { TinyArrayComparator };

package/dist/v1/index.cjs

@@ -49,6 +49,7 @@ var TinyLoadingScreen = require('./libs/TinyLoadingScreen.cjs');
 var TinyColorValidator = require('./libs/TinyColorValidator.cjs');
 var TinyAnalogClock = require('./libs/TinyAnalogClock.cjs');
 var TinyTextDiffer = require('./libs/TinyTextDiffer.cjs');
+var TinyArrayComparator = require('./libs/TinyArrayComparator.cjs');
 
 
 
@@ -179,3 +180,4 @@ exports.TinyLoadingScreen = TinyLoadingScreen;
 exports.TinyColorValidator = TinyColorValidator;
 exports.TinyAnalogClock = TinyAnalogClock;
 exports.TinyTextDiffer = TinyTextDiffer;
+exports.TinyArrayComparator = TinyArrayComparator;

package/dist/v1/index.d.mts

@@ -1,3 +1,4 @@
+import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
 import TinyTextDiffer from './libs/TinyTextDiffer.mjs';
 import TinyAnalogClock from './libs/TinyAnalogClock.mjs';
 import TinyColorValidator from './libs/TinyColorValidator.mjs';
@@ -125,5 +126,5 @@ 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 { TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -47,7 +47,8 @@ import TinyLoadingScreen from './libs/TinyLoadingScreen.mjs';
 import TinyColorValidator from './libs/TinyColorValidator.mjs';
 import TinyAnalogClock from './libs/TinyAnalogClock.mjs';
 import TinyTextDiffer from './libs/TinyTextDiffer.mjs';
+import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
-export { TinyTextDiffer, TinyAnalogClock, 
+export { TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
 // TinyHtmlElems,
 TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyEvents, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, diffArrayList, diffStrings, breakdownDuration, calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, isDirEmptyAsync, fileSizeAsync, dirSizeAsync, listFilesAsync, listDirsAsync, getLatestBackupPath, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, readJsonFile, writeJsonFile, ensureDirectory, clearDirectoryAsync, clearDirectory, fileExists, dirExists, isDirEmpty, ensureCopyFile, tryDeleteFile, writeTextFile, listFiles, listDirs, fileSize, dirSize, backupFile, restoreLatestBackup, renameFileBatch, renameFileRegex, renameFileAddPrefixSuffix, renameFileNormalizeCase, renameFilePadNumbers, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, checkObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyArrayComparator.cjs

@@ -0,0 +1,130 @@
+'use strict';
+
+/**
+ * @fileoverview Array comparison utility.
+ * @module TinyArrayComparator
+ */
+
+/**
+ * @typedef {Object} InternalState
+ * Holds the internal tracking variables during the comparison process.
+ * @property {Map<string, any>} oldItemsMap - A map storing the hash as the key and the original item as the value.
+ * @property {AffectedItems} affectedItems - The final array that collects added or deleted items.
+ */
+
+/**
+ * The final array that collects added or deleted items.
+ * @typedef {Array<{item: any, status: 'added'|'deleted'}>} AffectedItems
+ */
+
+/**
+ * Compares two arrays efficiently by hashing their items to detect additions and deletions.
+ */
+class TinyArrayComparator {
+  /**
+   * Generates a simple 32-bit integer hash converted to a base36 string.
+   * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+   * @returns {string} The unique hash representing the item's value.
+   */
+  static generateHash(item) {
+    const stringified = typeof item === 'object' ? JSON.stringify(item) : String(item);
+    let hash = 0;
+
+    for (let i = 0, len = stringified.length; i < len; i++) {
+      const char = stringified.charCodeAt(i);
+      hash = (hash << 5) - hash + char;
+      hash |= 0; // Convert to 32bit integer
+    }
+
+    return hash.toString(36);
+  }
+
+  /**
+   * Internal storage for the base array.
+   * @type {any[]}
+   */
+  #oldArray = [];
+
+  /**
+   * Gets the current base array used for comparisons.
+   * @returns {any[]} The current initial state of the array.
+   */
+  get oldArray() {
+    return this.#oldArray;
+  }
+
+  /**
+   * Sets a new base array for future comparisons.
+   * @param {Array<any>} oldArray - The initial state of the array.
+   * @throws {TypeError} Throws an error if the provided value is not an array.
+   */
+  set oldArray(oldArray) {
+    if (!Array.isArray(oldArray))
+      throw new TypeError('The provided oldArray must be a valid Array.');
+    this.#oldArray = oldArray;
+  }
+
+  /**
+   * Initializes the comparator with an optional base array.
+   * @param {Array<any>} [oldArray] - The initial state of the array to be stored.
+   */
+  constructor(oldArray) {
+    if (typeof oldArray !== 'undefined') this.oldArray = oldArray;
+  }
+
+  /**
+   * Proxy to generates a hash converted to a string.
+   * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+   * @returns {string} The unique hash representing the item's value.
+   * @private
+   */
+  _generateHash(item) {
+    return TinyArrayComparator.generateHash(item);
+  }
+
+  /**
+   * Compares the stored older array with a newer array and identifies missing or new items.
+   *
+   * @param {Array<any>} newArray - The modified state of the array.
+   * @returns {AffectedItems} An array containing the affected items and their status.
+   * @throws {TypeError} Throws an error if the provided value is not an array.
+   */
+  compare(newArray) {
+    if (!Array.isArray(newArray))
+      throw new TypeError('The provided newArray must be a valid Array.');
+
+    /** @type {InternalState} */
+    const state = {
+      oldItemsMap: new Map(),
+      affectedItems: [],
+    };
+
+    // Step 1: Hash and store all items from the first array
+    for (const item of this.#oldArray) {
+      const hashKey = this._generateHash(item);
+      state.oldItemsMap.set(hashKey, item);
+    }
+
+    // Step 2: Iterate through the second array to find matches or additions
+    for (const item of newArray) {
+      const hashKey = this._generateHash(item);
+
+      if (state.oldItemsMap.has(hashKey)) {
+        // Item exists in both, so it is unchanged. Remove from map.
+        state.oldItemsMap.delete(hashKey);
+      } else {
+        // Item was not in the old array, so it is an addition.
+        state.affectedItems.push({ item, status: 'added' });
+      }
+    }
+
+    // Step 3: Any item left in the oldItemsMap was not present in the new array (deleted)
+    for (const item of state.oldItemsMap.values()) {
+      state.affectedItems.push({ item, status: 'deleted' });
+    }
+
+    return state.affectedItems;
+  }
+}
+
+module.exports = TinyArrayComparator;

package/dist/v1/libs/TinyArrayComparator.d.mts

@@ -0,0 +1,79 @@
+export default TinyArrayComparator;
+/**
+ * Holds the internal tracking variables during the comparison process.
+ */
+export type InternalState = {
+    /**
+     * - A map storing the hash as the key and the original item as the value.
+     */
+    oldItemsMap: Map<string, any>;
+    /**
+     * - The final array that collects added or deleted items.
+     */
+    affectedItems: AffectedItems;
+};
+/**
+ * The final array that collects added or deleted items.
+ */
+export type AffectedItems = Array<{
+    item: any;
+    status: "added" | "deleted";
+}>;
+/**
+ * @fileoverview Array comparison utility.
+ * @module TinyArrayComparator
+ */
+/**
+ * @typedef {Object} InternalState
+ * Holds the internal tracking variables during the comparison process.
+ * @property {Map<string, any>} oldItemsMap - A map storing the hash as the key and the original item as the value.
+ * @property {AffectedItems} affectedItems - The final array that collects added or deleted items.
+ */
+/**
+ * The final array that collects added or deleted items.
+ * @typedef {Array<{item: any, status: 'added'|'deleted'}>} AffectedItems
+ */
+/**
+ * Compares two arrays efficiently by hashing their items to detect additions and deletions.
+ */
+declare class TinyArrayComparator {
+    /**
+     * Generates a simple 32-bit integer hash converted to a base36 string.
+     * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+     * @returns {string} The unique hash representing the item's value.
+     */
+    static generateHash(item: any): string;
+    /**
+     * Initializes the comparator with an optional base array.
+     * @param {Array<any>} [oldArray] - The initial state of the array to be stored.
+     */
+    constructor(oldArray?: Array<any>);
+    /**
+     * Sets a new base array for future comparisons.
+     * @param {Array<any>} oldArray - The initial state of the array.
+     * @throws {TypeError} Throws an error if the provided value is not an array.
+     */
+    set oldArray(oldArray: Array<any>);
+    /**
+     * Gets the current base array used for comparisons.
+     * @returns {any[]} The current initial state of the array.
+     */
+    get oldArray(): any[];
+    /**
+     * Proxy to generates a hash converted to a string.
+     * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+     * @returns {string} The unique hash representing the item's value.
+     * @private
+     */
+    private _generateHash;
+    /**
+     * Compares the stored older array with a newer array and identifies missing or new items.
+     *
+     * @param {Array<any>} newArray - The modified state of the array.
+     * @returns {AffectedItems} An array containing the affected items and their status.
+     * @throws {TypeError} Throws an error if the provided value is not an array.
+     */
+    compare(newArray: Array<any>): AffectedItems;
+    #private;
+}
+//# sourceMappingURL=TinyArrayComparator.d.mts.map

package/dist/v1/libs/TinyArrayComparator.mjs

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview Array comparison utility.
+ * @module TinyArrayComparator
+ */
+/**
+ * @typedef {Object} InternalState
+ * Holds the internal tracking variables during the comparison process.
+ * @property {Map<string, any>} oldItemsMap - A map storing the hash as the key and the original item as the value.
+ * @property {AffectedItems} affectedItems - The final array that collects added or deleted items.
+ */
+/**
+ * The final array that collects added or deleted items.
+ * @typedef {Array<{item: any, status: 'added'|'deleted'}>} AffectedItems
+ */
+/**
+ * Compares two arrays efficiently by hashing their items to detect additions and deletions.
+ */
+class TinyArrayComparator {
+    /**
+     * Generates a simple 32-bit integer hash converted to a base36 string.
+     * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+     * @returns {string} The unique hash representing the item's value.
+     */
+    static generateHash(item) {
+        const stringified = typeof item === 'object' ? JSON.stringify(item) : String(item);
+        let hash = 0;
+        for (let i = 0, len = stringified.length; i < len; i++) {
+            const char = stringified.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash |= 0; // Convert to 32bit integer
+        }
+        return hash.toString(36);
+    }
+    /**
+     * Internal storage for the base array.
+     * @type {any[]}
+     */
+    #oldArray = [];
+    /**
+     * Gets the current base array used for comparisons.
+     * @returns {any[]} The current initial state of the array.
+     */
+    get oldArray() {
+        return this.#oldArray;
+    }
+    /**
+     * Sets a new base array for future comparisons.
+     * @param {Array<any>} oldArray - The initial state of the array.
+     * @throws {TypeError} Throws an error if the provided value is not an array.
+     */
+    set oldArray(oldArray) {
+        if (!Array.isArray(oldArray))
+            throw new TypeError('The provided oldArray must be a valid Array.');
+        this.#oldArray = oldArray;
+    }
+    /**
+     * Initializes the comparator with an optional base array.
+     * @param {Array<any>} [oldArray] - The initial state of the array to be stored.
+     */
+    constructor(oldArray) {
+        if (typeof oldArray !== 'undefined')
+            this.oldArray = oldArray;
+    }
+    /**
+     * Proxy to generates a hash converted to a string.
+     * @param {any} item - The item to be hashed (can be an object, array, string, or number).
+     * @returns {string} The unique hash representing the item's value.
+     * @private
+     */
+    _generateHash(item) {
+        return TinyArrayComparator.generateHash(item);
+    }
+    /**
+     * Compares the stored older array with a newer array and identifies missing or new items.
+     *
+     * @param {Array<any>} newArray - The modified state of the array.
+     * @returns {AffectedItems} An array containing the affected items and their status.
+     * @throws {TypeError} Throws an error if the provided value is not an array.
+     */
+    compare(newArray) {
+        if (!Array.isArray(newArray))
+            throw new TypeError('The provided newArray must be a valid Array.');
+        /** @type {InternalState} */
+        const state = {
+            oldItemsMap: new Map(),
+            affectedItems: [],
+        };
+        // Step 1: Hash and store all items from the first array
+        for (const item of this.#oldArray) {
+            const hashKey = this._generateHash(item);
+            state.oldItemsMap.set(hashKey, item);
+        }
+        // Step 2: Iterate through the second array to find matches or additions
+        for (const item of newArray) {
+            const hashKey = this._generateHash(item);
+            if (state.oldItemsMap.has(hashKey)) {
+                // Item exists in both, so it is unchanged. Remove from map.
+                state.oldItemsMap.delete(hashKey);
+            }
+            else {
+                // Item was not in the old array, so it is an addition.
+                state.affectedItems.push({ item, status: 'added' });
+            }
+        }
+        // Step 3: Any item left in the oldItemsMap was not present in the new array (deleted)
+        for (const item of state.oldItemsMap.values()) {
+            state.affectedItems.push({ item, status: 'deleted' });
+        }
+        return state.affectedItems;
+    }
+}
+export default TinyArrayComparator;