tiny-essentials 1.25.3 → 1.25.5

package/dist/v1/TinyMaInSys.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(t,r)=>{for(var a in r)e.o(r,a)&&!e.o(t,a)&&Object.defineProperty(t,a,{enumerable:!0,get:r[a]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{FuzzySet:()=>s,MamdaniInferenceSystem:()=>u,defuzzifyCentroid:()=>a,trapezoid:()=>n});const r=e=>{if(!Array.isArray(e))throw new TypeError("Parameter 'sets' must be an array.");if(!e.every(e=>e instanceof s))throw new TypeError("All elements in the array must be instances of FuzzySet.")},a=(e,t,a=.5)=>{i(e,"object","defuzzifyCentroid.fuzzyOutput");for(const t in e)i(e[t],"number",`fuzzyOutput['${t}']`);r(t),i(a,"number","defuzzifyCentroid.step");let n=0,s=0;for(let r=0;r<=100;r+=a){let a=0;t.forEach(t=>{const n=e[t.name]||0,i=Math.min(n,t.calculate(r));a=Math.max(a,i)}),n+=r*a,s+=a}return 0===s?0:n/s},n=(e,t,r,a,n)=>{if(e<=t||e>=n)return 0;if(e>=r&&e<=a)return 1;const i=t===r?1:(e-t)/(r-t),s=a===n?1:(n-e)/(n-a),u=Math.max(0,Math.min(i,1,s));return isNaN(u)?0:u},i=(e,t,r)=>{if(typeof e!==t)throw new TypeError(`Parameter '${r}' must be a ${t}.`)};class s{static trapezoid(e,t,r,a,i){return n(e,t,r,a,i)}#e="";#t=0;#r=0;#a=0;#n=0;get name(){return this.#e}set name(e){i(e,"string","FuzzySet.name"),this.#e=e}get a(){return this.#t}set a(e){i(e,"number","FuzzySet.a"),this.#t=e}get b(){return this.#r}set b(e){i(e,"number","FuzzySet.b"),this.#r=e}get c(){return this.#a}set c(e){i(e,"number","FuzzySet.c"),this.#a=e}get d(){return this.#n}set d(e){i(e,"number","FuzzySet.d"),this.#n=e}constructor(e,t,r,a,n){this.name=e,this.a=t,this.b=r,this.c=a,this.d=n}calculate(e){return i(e,"number","calculate.x"),s.trapezoid(e,this.#t,this.#r,this.#a,this.#n)}}class u{#i=new Map;addVariable(e,t){i(e,"string","addVariable.name"),r(t),this.#i.set(e,t)}removeVariable(e){return i(e,"string","removeVariable.name"),this.#i.delete(e)}getVariable(e){i(e,"string","getVariable.name");const t=this.#i.get(e);if(!t)throw new Error(`Linguistic variable '${e}' not found in the inference system.`);return[...t]}hasVariable(e){return i(e,"string","hasVariable.name"),this.#i.has(e)}fuzzify(e,t){i(e,"string","fuzzify.varName"),i(t,"number","fuzzify.value");const r=this.#i.get(e)||[],a={};return r.forEach(e=>{a[e.name]=e.calculate(t)}),a}}window.TinyMaInSys=t})();

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,8 @@ 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');
+var TinyMamdaniInferenceSystem = require('./libs/TinyMamdaniInferenceSystem.cjs');
 
 
 
@@ -179,3 +181,8 @@ exports.TinyLoadingScreen = TinyLoadingScreen;
 exports.TinyColorValidator = TinyColorValidator;
 exports.TinyAnalogClock = TinyAnalogClock;
 exports.TinyTextDiffer = TinyTextDiffer;
+exports.TinyArrayComparator = TinyArrayComparator;
+exports.FuzzySet = TinyMamdaniInferenceSystem.FuzzySet;
+exports.MamdaniInferenceSystem = TinyMamdaniInferenceSystem.MamdaniInferenceSystem;
+exports.defuzzifyCentroid = TinyMamdaniInferenceSystem.defuzzifyCentroid;
+exports.trapezoid = TinyMamdaniInferenceSystem.trapezoid;

package/dist/v1/index.d.mts

@@ -1,3 +1,6 @@
+import { FuzzySet } from './libs/TinyMamdaniInferenceSystem.mjs';
+import { MamdaniInferenceSystem } from './libs/TinyMamdaniInferenceSystem.mjs';
+import TinyArrayComparator from './libs/TinyArrayComparator.mjs';
 import TinyTextDiffer from './libs/TinyTextDiffer.mjs';
 import TinyAnalogClock from './libs/TinyAnalogClock.mjs';
 import TinyColorValidator from './libs/TinyColorValidator.mjs';
@@ -36,6 +39,8 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
+import { defuzzifyCentroid } from './libs/TinyMamdaniInferenceSystem.mjs';
+import { trapezoid } from './libs/TinyMamdaniInferenceSystem.mjs';
 import { diffArrayList } from './basics/array.mjs';
 import { diffStrings } from './basics/text.mjs';
 import { breakdownDuration } from './basics/clock.mjs';
@@ -125,5 +130,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 { FuzzySet, MamdaniInferenceSystem, 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, defuzzifyCentroid, trapezoid, 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,9 @@ 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 { FuzzySet, MamdaniInferenceSystem, trapezoid, defuzzifyCentroid, } from './libs/TinyMamdaniInferenceSystem.mjs';
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
-export { TinyTextDiffer, TinyAnalogClock, 
+export { FuzzySet, MamdaniInferenceSystem, 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, };
+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, defuzzifyCentroid, trapezoid, 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;