tiny-essentials 1.21.1 → 1.21.2

package/dist/v1/TinyNeedBar.min.js

@@ -1 +1 @@
-(()=>{"use strict";var t={d:(e,r)=>{for(var i in r)t.o(r,i)&&!t.o(e,i)&&Object.defineProperty(e,i,{enumerable:!0,get:r[i]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{TinyNeedBar:()=>i});class r{#t=new Map;#e;#r;#i;get factors(){const t={};for(let[e,r]of this.#t.entries())t[e]={...r};return t}get currentPercent(){return this.#r/this.#e*100}set maxValue(t){this.#e=t,this.#r=Math.min(this.#r,t)}get maxValue(){return this.#e}get currentValue(){return this.#r}set infiniteValue(t){this.#i=t,this.#r=Math.max(0,t),this.#r=Math.min(this.#r,this.#e)}get infiniteValue(){return this.#i}constructor(t=100,e=1,r=1){this.#e=t,this.setFactor("main",e,r),this.#r=t,this.#i=t}getFactor(t){const e=this.#t.get(t);if(!e)throw new Error(`Factor with key "${t}" not found.`);return{...e}}hasFactor(t){return this.#t.has(t)}setFactor(t,e,r=1){this.#t.set(t,{amount:e,multiplier:r})}removeFactor(t){this.#t.delete(t)}tick(){let t=0;for(let[e,r]of this.#t.entries())t+=r.amount*r.multiplier;const e=this.#i;return this.#i-=t,this.#r=Math.max(0,this.#r-t),{prevValue:e,removedTotal:t,removedPercent:t/this.#e*100,currentPercent:this.currentPercent,remainingValue:this.#r,infiniteRemaining:this.#i}}toJSON(){return{maxValue:this.#e,currentValue:this.#r,infiniteValue:this.#i,factors:this.factors}}static fromJSON(t){const e=new r(t.maxValue,0,0);e.infiniteValue=t.infiniteValue,e.#t.clear();for(const[r,i]of Object.entries(t.factors))e.setFactor(r,i.amount,i.multiplier);return e}clone(){return r.fromJSON(this.toJSON())}clearFactors(){this.#t.clear()}}const i=r;window.TinyNeedBar=e.TinyNeedBar})();
+(()=>{"use strict";var e={d:(t,r)=>{for(var i in r)e.o(r,i)&&!e.o(t,i)&&Object.defineProperty(t,i,{enumerable:!0,get:r[i]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t)},t={};e.d(t,{TinyNeedBar:()=>i});class r{#e=new Map;#t;#r;#i;get factors(){const e={};for(let[t,r]of this.#e.entries())e[t]={...r};return e}get currentPercent(){return this.#r/this.#t*100}set maxValue(e){if("number"!=typeof e||Number.isNaN(e)||e<=0)throw new TypeError("maxValue must be a positive number.");this.#t=e,this.#r=Math.min(this.#r,e)}get maxValue(){return this.#t}get currentValue(){return this.#r}set infiniteValue(e){if("number"!=typeof e||Number.isNaN(e))throw new TypeError("infiniteValue must be a number.");this.#i=e,this.#r=Math.max(0,e),this.#r=Math.min(this.#r,this.#t)}get infiniteValue(){return this.#i}constructor(e=100,t=1,r=1){if("number"!=typeof e||Number.isNaN(e)||e<=0)throw new TypeError("maxValue must be a positive number.");this.#t=e,this.setFactor("main",t,r),this.#r=e,this.#i=e}getFactor(e){if("string"!=typeof e||!e)throw new TypeError("Key must be a non-empty string.");const t=this.#e.get(e);if(!t)throw new Error(`Factor with key "${e}" not found.`);return{...t}}hasFactor(e){if("string"!=typeof e||!e)throw new TypeError("Key must be a non-empty string.");return this.#e.has(e)}setFactor(e,t,r=1){if("string"!=typeof e||!e)throw new TypeError("Key must be a non-empty string.");if("number"!=typeof t||Number.isNaN(t))throw new TypeError("Amount must be a valid number.");if("number"!=typeof r||Number.isNaN(r))throw new TypeError("Multiplier must be a valid number.");this.#e.set(e,{amount:t,multiplier:r})}removeFactor(e){if("string"!=typeof e||!e)throw new TypeError("Key must be a non-empty string.");return this.#e.delete(e)}#n(e){const t=this.#i;return this.#i-=e,this.#r=Math.max(0,this.#r-e),{prevValue:t,removedTotal:e,removedPercent:e/this.#t*100,currentPercent:this.currentPercent,remainingValue:this.#r,infiniteRemaining:this.#i}}tick(){let e=0;for(let[t,r]of this.#e.entries())e+=r.amount*r.multiplier;return this.#n(e)}tickWithTempFactor(e){if("object"!=typeof e||null===e)throw new TypeError("You must provide a valid factor object.");if("number"!=typeof e.amount||Number.isNaN(e.amount))throw new TypeError('Temp factor "amount" must be a valid number.');if("multiplier"in e&&("number"!=typeof e.multiplier||Number.isNaN(e.multiplier)))throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');let t=0;for(let[e,r]of this.#e.entries())t+=r.amount*r.multiplier;return e&&(t+=e.amount*(e.multiplier??1)),this.#n(t)}tickSingleFactor(e){if("object"!=typeof e||null===e)throw new TypeError("You must provide a valid factor object.");if("number"!=typeof e.amount||Number.isNaN(e.amount))throw new TypeError('Temp factor "amount" must be a valid number.');if("multiplier"in e&&("number"!=typeof e.multiplier||Number.isNaN(e.multiplier)))throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');if(!e)throw new Error("You must provide a factor to apply.");const t=e.amount*(e.multiplier??1);return this.#n(t)}toJSON(){return{maxValue:this.#t,currentValue:this.#r,infiniteValue:this.#i,factors:this.factors}}static fromJSON(e){const t=new r(e.maxValue,0,0);t.infiniteValue=e.infiniteValue,t.#e.clear();for(const[r,i]of Object.entries(e.factors))t.setFactor(r,i.amount,i.multiplier);return t}clone(){return r.fromJSON(this.toJSON())}clearFactors(){this.#e.clear()}}const i=r;window.TinyNeedBar=t.TinyNeedBar})();

package/dist/v1/TinySimpleDice.min.js

@@ -0,0 +1 @@
+(()=>{"use strict";var e={d:(r,o)=>{for(var a in o)e.o(o,a)&&!e.o(r,a)&&Object.defineProperty(r,a,{enumerable:!0,get:o[a]})},o:(e,r)=>Object.prototype.hasOwnProperty.call(e,r)},r={};e.d(r,{TinySimpleDice:()=>o});const o=class{static rollArrayIndex(e){const r=Array.isArray(e),o=e instanceof Set;if(!r&&!o)throw new TypeError("rollArrayIndex expects an array or Set.");return Math.floor(Math.random()*(r?e.length:e.size))}#e;#r;get maxValue(){return this.#e}set maxValue(e){if(!Number.isInteger(e)||e<0)throw new TypeError("maxValue must be an integer greater than -1.");this.#e=e}get allowZero(){return this.#r}set allowZero(e){if("boolean"!=typeof e)throw new TypeError("allowZero must be a boolean.");this.#r=e}constructor({maxValue:e,allowZero:r=!0}){if("boolean"!=typeof r)throw new TypeError("allowZero must be an boolean.");if(!Number.isInteger(e)||e<0)throw new TypeError("maxValue must be an integer greater than -1.");this.#e=e,this.#r=r}roll(){const e=this.#r?0:1;return Math.floor(Math.random()*(this.#e-e+1))+e}};window.TinySimpleDice=r.TinySimpleDice})();

package/dist/v1/basics/index.cjs

@@ -17,6 +17,7 @@ var collision = require('./collision.cjs');
 exports.arraySortPositions = arraySortPositions;
 exports.asyncReplace = replaceAsync;
 exports.shuffleArray = array.shuffleArray;
+exports.breakdownDuration = clock.breakdownDuration;
 exports.formatCustomTimer = clock.formatCustomTimer;
 exports.formatDayTimer = clock.formatDayTimer;
 exports.formatTimer = clock.formatTimer;

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

@@ -1,3 +1,4 @@
+import { breakdownDuration } from './clock.mjs';
 import { calculateMarketcap } from './simpleMath.mjs';
 import { compareMarketcap } from './simpleMath.mjs';
 import { getPercentage } from './simpleMath.mjs';
@@ -55,5 +56,5 @@ import { getTimeDuration } from './clock.mjs';
 import { shuffleArray } from './array.mjs';
 import { toTitleCase } from './text.mjs';
 import { toTitleCaseLowerFirst } from './text.mjs';
-export { calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
+export { 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, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/basics/index.mjs

@@ -1,7 +1,7 @@
 import arraySortPositions from '../../legacy/libs/arraySortPositions.mjs';
 import asyncReplace from '../../legacy/libs/replaceAsync.mjs';
 import { shuffleArray } from './array.mjs';
-import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './clock.mjs';
+import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './clock.mjs';
 import { readJsonBlob, saveJsonFile, fetchJson, installWindowHiddenScript, readFileBlob, readBase64Blob, fetchText, } from './html.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType } from './objFilter.mjs';
 import { countObj, isJsonObject } from './objChecker.mjs';
@@ -9,4 +9,4 @@ import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen
 import { calculateMarketcap, compareMarketcap, formatBytes, genFibonacciSeq, getAge, getPercentage, getSimplePerc, ruleOfThree, } from './simpleMath.mjs';
 import { addAiMarkerShortcut, safeTextTrim, toTitleCase, toTitleCaseLowerFirst } from './text.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './collision.mjs';
-export { calculateMarketcap, compareMarketcap, getPercentage, areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, safeTextTrim, installWindowHiddenScript, genFibonacciSeq, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { 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, fetchJson, fetchText, readJsonBlob, readFileBlob, readBase64Blob, saveJsonFile, documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, isJsonObject, arraySortPositions, formatBytes, addAiMarkerShortcut, extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, countObj, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/build/TinySimpleDice.cjs

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

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

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

package/dist/v1/build/TinySimpleDice.mjs

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

package/dist/v1/index.cjs

@@ -45,6 +45,7 @@ var TinyInventoryTrader = require('./libs/TinyInventoryTrader.cjs');
 var TinyCookieConsent = require('./libs/TinyCookieConsent.cjs');
 var TinyI18 = require('./libs/TinyI18.cjs');
 var TinyNeedBar = require('./libs/TinyNeedBar.cjs');
+var TinySimpleDice = require('./libs/TinySimpleDice.cjs');
 
 
 
@@ -52,6 +53,7 @@ exports.asyncReplace = replaceAsync;
 exports.TinyLevelUp = userLevel;
 exports.arraySortPositions = arraySortPositions;
 exports.shuffleArray = array.shuffleArray;
+exports.breakdownDuration = clock.breakdownDuration;
 exports.formatCustomTimer = clock.formatCustomTimer;
 exports.formatDayTimer = clock.formatDayTimer;
 exports.formatTimer = clock.formatTimer;
@@ -166,3 +168,4 @@ exports.TinyInventoryTrader = TinyInventoryTrader;
 exports.TinyCookieConsent = TinyCookieConsent;
 exports.TinyI18 = TinyI18;
 exports.TinyNeedBar = TinyNeedBar;
+exports.TinySimpleDice = TinySimpleDice;

package/dist/v1/index.d.mts

@@ -1,3 +1,4 @@
+import TinySimpleDice from './libs/TinySimpleDice.mjs';
 import TinyNeedBar from './libs/TinyNeedBar.mjs';
 import TinyI18 from './libs/TinyI18.mjs';
 import TinyCookieConsent from './libs/TinyCookieConsent.mjs';
@@ -30,6 +31,7 @@ import TinyRateLimiter from './libs/TinyRateLimiter.mjs';
 import ColorSafeStringify from './libs/ColorSafeStringify.mjs';
 import TinyPromiseQueue from './libs/TinyPromiseQueue.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
+import { breakdownDuration } from './basics/clock.mjs';
 import { calculateMarketcap } from './basics/simpleMath.mjs';
 import { compareMarketcap } from './basics/simpleMath.mjs';
 import { getPercentage } from './basics/simpleMath.mjs';
@@ -116,5 +118,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 { 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, 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 { 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, 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

@@ -2,7 +2,7 @@ import asyncReplace from '../legacy/libs/replaceAsync.mjs';
 import TinyLevelUp from '../legacy/libs/userLevel.mjs';
 import arraySortPositions from '../legacy/libs/arraySortPositions.mjs';
 import { shuffleArray } from './basics/array.mjs';
-import { formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
+import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, } from './basics/objFilter.mjs';
 import { countObj, isJsonObject } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.mjs';
@@ -43,4 +43,5 @@ import TinyInventoryTrader from './libs/TinyInventoryTrader.mjs';
 import TinyCookieConsent from './libs/TinyCookieConsent.mjs';
 import TinyI18 from './libs/TinyI18.mjs';
 import TinyNeedBar from './libs/TinyNeedBar.mjs';
-export { 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, 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, };
+import TinySimpleDice from './libs/TinySimpleDice.mjs';
+export { 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, 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/TinyNeedBar.cjs

@@ -93,6 +93,8 @@ class TinyNeedBar {
    * @param {number} value - New maximum value.
    */
   set maxValue(value) {
+    if (typeof value !== 'number' || Number.isNaN(value) || value <= 0)
+      throw new TypeError('maxValue must be a positive number.');
     this.#maxValue = value;
     this.#currentValue = Math.min(this.#currentValue, value);
   }
@@ -123,6 +125,8 @@ class TinyNeedBar {
    * @param {number} value - New infinite value.
    */
   set infiniteValue(value) {
+    if (typeof value !== 'number' || Number.isNaN(value))
+      throw new TypeError('infiniteValue must be a number.');
     this.#infiniteValue = value;
     this.#currentValue = Math.max(0, value);
     this.#currentValue = Math.min(this.#currentValue, this.#maxValue);
@@ -146,6 +150,9 @@ class TinyNeedBar {
    * @param {number} [baseDecayMulti=1] - Multiplier applied to the base decay.
    */
   constructor(maxValue = 100, baseDecay = 1, baseDecayMulti = 1) {
+    if (typeof maxValue !== 'number' || Number.isNaN(maxValue) || maxValue <= 0)
+      throw new TypeError('maxValue must be a positive number.');
+
     this.#maxValue = maxValue;
     this.setFactor('main', baseDecay, baseDecayMulti);
 
@@ -161,6 +168,7 @@ class TinyNeedBar {
    * @throws {Error} If the factor does not exist.
    */
   getFactor(key) {
+    if (typeof key !== 'string' || !key) throw new TypeError('Key must be a non-empty string.');
     const result = this.#factors.get(key);
     if (!result) throw new Error(`Factor with key "${key}" not found.`);
     return { ...result };
@@ -173,6 +181,7 @@ class TinyNeedBar {
    * @returns {boolean} `true` if the factor exists, otherwise `false`.
    */
   hasFactor(key) {
+    if (typeof key !== 'string' || !key) throw new TypeError('Key must be a non-empty string.');
     return this.#factors.has(key);
   }
 
@@ -184,6 +193,11 @@ class TinyNeedBar {
    * @param {number} [multiplier=1] - Multiplier applied to the amount.
    */
   setFactor(key, amount, multiplier = 1) {
+    if (typeof key !== 'string' || !key) throw new TypeError('Key must be a non-empty string.');
+    if (typeof amount !== 'number' || Number.isNaN(amount))
+      throw new TypeError('Amount must be a valid number.');
+    if (typeof multiplier !== 'number' || Number.isNaN(multiplier))
+      throw new TypeError('Multiplier must be a valid number.');
     this.#factors.set(key, { amount, multiplier });
   }
 
@@ -191,23 +205,22 @@ class TinyNeedBar {
    * Removes a decay factor by its key.
    *
    * @param {string} key - The factor key to remove.
+   * @returns {boolean} Returns `true` if the factor existed and was successfully removed,
+   *                    or `false` if the factor did not exist.
    */
   removeFactor(key) {
-    this.#factors.delete(key);
+    if (typeof key !== 'string' || !key) throw new TypeError('Key must be a non-empty string.');
+    return this.#factors.delete(key);
   }
 
   /**
-   * Executes one tick of decay, applying all active factors.
+   * Applies a total decay value to the bar and updates both current and infinite values.
+   * This is a private helper used by the public tick methods.
    *
-   * @returns {TickResult}
+   * @param {number} removedTotal - The total amount to remove from the bar during this tick.
+   * @returns {TickResult} An object containing detailed information about the tick.
    */
-  tick() {
-    let removedTotal = 0;
-
-    for (let [_, factor] of this.#factors.entries()) {
-      removedTotal += factor.amount * factor.multiplier;
-    }
-
+  #tick(removedTotal) {
     const prevValue = this.#infiniteValue;
     this.#infiniteValue -= removedTotal;
     this.#currentValue = Math.max(0, this.#currentValue - removedTotal);
@@ -224,6 +237,66 @@ class TinyNeedBar {
     };
   }
 
+  /**
+   * Executes one tick of decay, applying all active factors.
+   *
+   * @returns {TickResult}
+   */
+  tick() {
+    let removedTotal = 0;
+    for (let [_, factor] of this.#factors.entries()) {
+      removedTotal += factor.amount * factor.multiplier;
+    }
+    return this.#tick(removedTotal);
+  }
+
+  /**
+   * Executes one tick of decay using a temporary factor.
+   *
+   * @param {BarFactor} tempFactor - Temporary factor to apply only in this tick.
+   * @returns {TickResult}
+   */
+  tickWithTempFactor(tempFactor) {
+    if (typeof tempFactor !== 'object' || tempFactor === null)
+      throw new TypeError('You must provide a valid factor object.');
+    if (typeof tempFactor.amount !== 'number' || Number.isNaN(tempFactor.amount))
+      throw new TypeError('Temp factor "amount" must be a valid number.');
+    if (
+      'multiplier' in tempFactor &&
+      (typeof tempFactor.multiplier !== 'number' || Number.isNaN(tempFactor.multiplier))
+    )
+      throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');
+
+    let removedTotal = 0;
+    for (let [_, factor] of this.#factors.entries()) {
+      removedTotal += factor.amount * factor.multiplier;
+    }
+    if (tempFactor) removedTotal += tempFactor.amount * (tempFactor.multiplier ?? 1);
+    return this.#tick(removedTotal);
+  }
+
+  /**
+   * Executes one tick using only the specified factor.
+   *
+   * @param {BarFactor} factor - The single factor to apply.
+   * @returns {TickResult}
+   */
+  tickSingleFactor(factor) {
+    if (typeof factor !== 'object' || factor === null)
+      throw new TypeError('You must provide a valid factor object.');
+    if (typeof factor.amount !== 'number' || Number.isNaN(factor.amount))
+      throw new TypeError('Temp factor "amount" must be a valid number.');
+    if (
+      'multiplier' in factor &&
+      (typeof factor.multiplier !== 'number' || Number.isNaN(factor.multiplier))
+    )
+      throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');
+
+    if (!factor) throw new Error('You must provide a factor to apply.');
+    const removedTotal = factor.amount * (factor.multiplier ?? 1);
+    return this.#tick(removedTotal);
+  }
+
   /**
    * Serializes the current state of the need bar.
    * @returns {SerializedData}

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

@@ -196,14 +196,30 @@ declare class TinyNeedBar {
      * Removes a decay factor by its key.
      *
      * @param {string} key - The factor key to remove.
+     * @returns {boolean} Returns `true` if the factor existed and was successfully removed,
+     *                    or `false` if the factor did not exist.
      */
-    removeFactor(key: string): void;
+    removeFactor(key: string): boolean;
     /**
      * Executes one tick of decay, applying all active factors.
      *
      * @returns {TickResult}
      */
     tick(): TickResult;
+    /**
+     * Executes one tick of decay using a temporary factor.
+     *
+     * @param {BarFactor} tempFactor - Temporary factor to apply only in this tick.
+     * @returns {TickResult}
+     */
+    tickWithTempFactor(tempFactor: BarFactor): TickResult;
+    /**
+     * Executes one tick using only the specified factor.
+     *
+     * @param {BarFactor} factor - The single factor to apply.
+     * @returns {TickResult}
+     */
+    tickSingleFactor(factor: BarFactor): TickResult;
     /**
      * Serializes the current state of the need bar.
      * @returns {SerializedData}

package/dist/v1/libs/TinyNeedBar.mjs

@@ -82,6 +82,8 @@ class TinyNeedBar {
      * @param {number} value - New maximum value.
      */
     set maxValue(value) {
+        if (typeof value !== 'number' || Number.isNaN(value) || value <= 0)
+            throw new TypeError('maxValue must be a positive number.');
         this.#maxValue = value;
         this.#currentValue = Math.min(this.#currentValue, value);
     }
@@ -109,6 +111,8 @@ class TinyNeedBar {
      * @param {number} value - New infinite value.
      */
     set infiniteValue(value) {
+        if (typeof value !== 'number' || Number.isNaN(value))
+            throw new TypeError('infiniteValue must be a number.');
         this.#infiniteValue = value;
         this.#currentValue = Math.max(0, value);
         this.#currentValue = Math.min(this.#currentValue, this.#maxValue);
@@ -130,6 +134,8 @@ class TinyNeedBar {
      * @param {number} [baseDecayMulti=1] - Multiplier applied to the base decay.
      */
     constructor(maxValue = 100, baseDecay = 1, baseDecayMulti = 1) {
+        if (typeof maxValue !== 'number' || Number.isNaN(maxValue) || maxValue <= 0)
+            throw new TypeError('maxValue must be a positive number.');
         this.#maxValue = maxValue;
         this.setFactor('main', baseDecay, baseDecayMulti);
         this.#currentValue = maxValue;
@@ -143,6 +149,8 @@ class TinyNeedBar {
      * @throws {Error} If the factor does not exist.
      */
     getFactor(key) {
+        if (typeof key !== 'string' || !key)
+            throw new TypeError('Key must be a non-empty string.');
         const result = this.#factors.get(key);
         if (!result)
             throw new Error(`Factor with key "${key}" not found.`);
@@ -155,6 +163,8 @@ class TinyNeedBar {
      * @returns {boolean} `true` if the factor exists, otherwise `false`.
      */
     hasFactor(key) {
+        if (typeof key !== 'string' || !key)
+            throw new TypeError('Key must be a non-empty string.');
         return this.#factors.has(key);
     }
     /**
@@ -165,26 +175,34 @@ class TinyNeedBar {
      * @param {number} [multiplier=1] - Multiplier applied to the amount.
      */
     setFactor(key, amount, multiplier = 1) {
+        if (typeof key !== 'string' || !key)
+            throw new TypeError('Key must be a non-empty string.');
+        if (typeof amount !== 'number' || Number.isNaN(amount))
+            throw new TypeError('Amount must be a valid number.');
+        if (typeof multiplier !== 'number' || Number.isNaN(multiplier))
+            throw new TypeError('Multiplier must be a valid number.');
         this.#factors.set(key, { amount, multiplier });
     }
     /**
      * Removes a decay factor by its key.
      *
      * @param {string} key - The factor key to remove.
+     * @returns {boolean} Returns `true` if the factor existed and was successfully removed,
+     *                    or `false` if the factor did not exist.
      */
     removeFactor(key) {
-        this.#factors.delete(key);
+        if (typeof key !== 'string' || !key)
+            throw new TypeError('Key must be a non-empty string.');
+        return this.#factors.delete(key);
     }
     /**
-     * Executes one tick of decay, applying all active factors.
+     * Applies a total decay value to the bar and updates both current and infinite values.
+     * This is a private helper used by the public tick methods.
      *
-     * @returns {TickResult}
+     * @param {number} removedTotal - The total amount to remove from the bar during this tick.
+     * @returns {TickResult} An object containing detailed information about the tick.
      */
-    tick() {
-        let removedTotal = 0;
-        for (let [_, factor] of this.#factors.entries()) {
-            removedTotal += factor.amount * factor.multiplier;
-        }
+    #tick(removedTotal) {
         const prevValue = this.#infiniteValue;
         this.#infiniteValue -= removedTotal;
         this.#currentValue = Math.max(0, this.#currentValue - removedTotal);
@@ -198,6 +216,59 @@ class TinyNeedBar {
             infiniteRemaining: this.#infiniteValue,
         };
     }
+    /**
+     * Executes one tick of decay, applying all active factors.
+     *
+     * @returns {TickResult}
+     */
+    tick() {
+        let removedTotal = 0;
+        for (let [_, factor] of this.#factors.entries()) {
+            removedTotal += factor.amount * factor.multiplier;
+        }
+        return this.#tick(removedTotal);
+    }
+    /**
+     * Executes one tick of decay using a temporary factor.
+     *
+     * @param {BarFactor} tempFactor - Temporary factor to apply only in this tick.
+     * @returns {TickResult}
+     */
+    tickWithTempFactor(tempFactor) {
+        if (typeof tempFactor !== 'object' || tempFactor === null)
+            throw new TypeError('You must provide a valid factor object.');
+        if (typeof tempFactor.amount !== 'number' || Number.isNaN(tempFactor.amount))
+            throw new TypeError('Temp factor "amount" must be a valid number.');
+        if ('multiplier' in tempFactor &&
+            (typeof tempFactor.multiplier !== 'number' || Number.isNaN(tempFactor.multiplier)))
+            throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');
+        let removedTotal = 0;
+        for (let [_, factor] of this.#factors.entries()) {
+            removedTotal += factor.amount * factor.multiplier;
+        }
+        if (tempFactor)
+            removedTotal += tempFactor.amount * (tempFactor.multiplier ?? 1);
+        return this.#tick(removedTotal);
+    }
+    /**
+     * Executes one tick using only the specified factor.
+     *
+     * @param {BarFactor} factor - The single factor to apply.
+     * @returns {TickResult}
+     */
+    tickSingleFactor(factor) {
+        if (typeof factor !== 'object' || factor === null)
+            throw new TypeError('You must provide a valid factor object.');
+        if (typeof factor.amount !== 'number' || Number.isNaN(factor.amount))
+            throw new TypeError('Temp factor "amount" must be a valid number.');
+        if ('multiplier' in factor &&
+            (typeof factor.multiplier !== 'number' || Number.isNaN(factor.multiplier)))
+            throw new TypeError('Temp factor "multiplier" must be a valid number if provided.');
+        if (!factor)
+            throw new Error('You must provide a factor to apply.');
+        const removedTotal = factor.amount * (factor.multiplier ?? 1);
+        return this.#tick(removedTotal);
+    }
     /**
      * Serializes the current state of the need bar.
      * @returns {SerializedData}

package/dist/v1/libs/TinySimpleDice.cjs

@@ -0,0 +1,91 @@
+'use strict';
+
+/**
+ * TinySimpleDice
+ *
+ * A lightweight, flexible dice rolling utility for generating random numbers.
+ * You can configure the dice to allow zero, set a maximum value, and even roll
+ * values suitable for indexing arrays or Sets.
+ */
+class TinySimpleDice {
+  /**
+   * Rolls a dice specifically for choosing an array or Set index.
+   * @param {any[]|Set<any>} arr - The array or Set to get a random index from.
+   * @returns {number} - Valid index for the array or Set.
+   * @throws {TypeError} If the input is not an array or Set.
+   */
+  static rollArrayIndex(arr) {
+    const isArray = Array.isArray(arr);
+    const isSet = arr instanceof Set;
+    if (!isArray && !isSet) throw new TypeError('rollArrayIndex expects an array or Set.');
+    return Math.floor(Math.random() * (isArray ? arr.length : arr.size));
+  }
+
+  /** @type {number} */
+  #maxValue;
+  /** @type {boolean} */
+  #allowZero;
+
+  /**
+   * Maximum value the dice can roll.
+   * @type {number}
+   */
+  get maxValue() {
+    return this.#maxValue;
+  }
+
+  /**
+   * Set the maximum value the dice can roll.
+   * @param {number} value - New maximum value (must be a non-negative integer)
+   * @throws {TypeError} If value is not a non-negative integer
+   */
+  set maxValue(value) {
+    if (!Number.isInteger(value) || value < 0)
+      throw new TypeError('maxValue must be an integer greater than -1.');
+    this.#maxValue = value;
+  }
+
+  /**
+   * Whether 0 is allowed as a result.
+   * @type {boolean}
+   */
+  get allowZero() {
+    return this.#allowZero;
+  }
+
+  /**
+   * Set whether 0 is allowed as a result.
+   * @param {boolean} value - true to allow 0, false to disallow
+   * @throws {TypeError} If value is not a boolean
+   */
+  set allowZero(value) {
+    if (typeof value !== 'boolean') throw new TypeError('allowZero must be a boolean.');
+    this.#allowZero = value;
+  }
+
+  /**
+   * Creates a new TinySimpleDice instance.
+   * @param {Object} options - Configuration options for the dice.
+   * @param {number} options.maxValue - Maximum value the dice can roll.
+   * @param {boolean} [options.allowZero=true] - Whether 0 is allowed as a result.
+   * @throws {TypeError} If maxValue is not a non-negative integer or allowZero is not boolean.
+   */
+  constructor({ maxValue, allowZero = true }) {
+    if (typeof allowZero !== 'boolean') throw new TypeError('allowZero must be an boolean.');
+    if (!Number.isInteger(maxValue) || maxValue < 0)
+      throw new TypeError('maxValue must be an integer greater than -1.');
+    this.#maxValue = maxValue;
+    this.#allowZero = allowZero;
+  }
+
+  /**
+   * Rolls the dice according to the configuration.
+   * @returns {number} - Random number according to the dice configuration.
+   */
+  roll() {
+    const min = this.#allowZero ? 0 : 1;
+    return Math.floor(Math.random() * (this.#maxValue - min + 1)) + min;
+  }
+}
+
+module.exports = TinySimpleDice;

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

@@ -0,0 +1,57 @@
+export default TinySimpleDice;
+/**
+ * TinySimpleDice
+ *
+ * A lightweight, flexible dice rolling utility for generating random numbers.
+ * You can configure the dice to allow zero, set a maximum value, and even roll
+ * values suitable for indexing arrays or Sets.
+ */
+declare class TinySimpleDice {
+    /**
+     * Rolls a dice specifically for choosing an array or Set index.
+     * @param {any[]|Set<any>} arr - The array or Set to get a random index from.
+     * @returns {number} - Valid index for the array or Set.
+     * @throws {TypeError} If the input is not an array or Set.
+     */
+    static rollArrayIndex(arr: any[] | Set<any>): number;
+    /**
+     * Creates a new TinySimpleDice instance.
+     * @param {Object} options - Configuration options for the dice.
+     * @param {number} options.maxValue - Maximum value the dice can roll.
+     * @param {boolean} [options.allowZero=true] - Whether 0 is allowed as a result.
+     * @throws {TypeError} If maxValue is not a non-negative integer or allowZero is not boolean.
+     */
+    constructor({ maxValue, allowZero }: {
+        maxValue: number;
+        allowZero?: boolean | undefined;
+    });
+    /**
+     * Set the maximum value the dice can roll.
+     * @param {number} value - New maximum value (must be a non-negative integer)
+     * @throws {TypeError} If value is not a non-negative integer
+     */
+    set maxValue(value: number);
+    /**
+     * Maximum value the dice can roll.
+     * @type {number}
+     */
+    get maxValue(): number;
+    /**
+     * Set whether 0 is allowed as a result.
+     * @param {boolean} value - true to allow 0, false to disallow
+     * @throws {TypeError} If value is not a boolean
+     */
+    set allowZero(value: boolean);
+    /**
+     * Whether 0 is allowed as a result.
+     * @type {boolean}
+     */
+    get allowZero(): boolean;
+    /**
+     * Rolls the dice according to the configuration.
+     * @returns {number} - Random number according to the dice configuration.
+     */
+    roll(): number;
+    #private;
+}
+//# sourceMappingURL=TinySimpleDice.d.mts.map