tiny-essentials 1.28.12 → 1.28.14

package/dist/v1/index.cjs

@@ -168,8 +168,8 @@ exports.getElsRelativeCenterOffset = collision.getElsRelativeCenterOffset;
 exports.getRectCenter = collision.getRectCenter;
 exports.extractMediaId3Tags = mediaContent.extractMediaId3Tags;
 exports.parseMediaMetadata = mediaContent.parseMediaMetadata;
+exports.valFetchMediaContent = mediaContent.valFetchMediaContent;
 exports.valMediaContentMetadata = mediaContent.valMediaContentMetadata;
-exports.valMediaContentMetadataPartial = mediaContent.valMediaContentMetadataPartial;
 exports.TinyHtml = TinyHtml;
 exports.TinyAfterScrollWatcher = TinyAfterScrollWatcher;
 exports.UltraRandomMsgGen = UltraRandomMsgGen;

package/dist/v1/index.d.mts

@@ -19,7 +19,7 @@ import TinyDragger from './libs/TinyDragger.mjs';
 import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails } from './basics/collision.mjs';
-import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valMediaContentMetadataPartial } from './basics/mediaContent.mjs';
+import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valFetchMediaContent } from './basics/mediaContent.mjs';
 import TinyHtml from './libs/TinyHtml.mjs';
 import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
 import UltraRandomMsgGen from './libs/UltraRandomMsgGen.mjs';
@@ -56,5 +56,5 @@ import { createCheckDestroyed } from './libs/utils.mjs';
 import { createSingletonTask, waitForTrue } from './basics/promiseUtils.mjs';
 import TinyDebugger from './libs/TinyDebugger.mjs';
 import { browserIs, getBrowserCssPrefix, getBrowserPings, getDuckTyping, isBrowserAgent } from './basics/browserDetector.mjs';
-export { TinyDebugger, TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getUserTimeFormat, getBrowserPings, isBrowserAgent, getBrowserCssPrefix, getDuckTyping, browserIs, isValidObj, createSingletonTask, waitForTrue, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, 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, objTypeName, isObjType, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
+export { TinyDebugger, TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getUserTimeFormat, getBrowserPings, isBrowserAgent, getBrowserCssPrefix, getDuckTyping, browserIs, isValidObj, createSingletonTask, waitForTrue, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valFetchMediaContent, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, 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, objTypeName, isObjType, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -19,7 +19,7 @@ import TinyDragger from './libs/TinyDragger.mjs';
 import TinyDomReadyManager from './libs/TinyDomReadyManager.mjs';
 import TinyNotifications from './libs/TinyNotifications.mjs';
 import { areElsCollTop, areElsCollBottom, areElsCollLeft, areElsCollRight, areElsCollPerfTop, areElsCollPerfBottom, areElsCollPerfLeft, areElsCollPerfRight, areElsColliding, areElsPerfColliding, getElsColliding, getElsPerfColliding, getElsCollOverlap, getElsCollOverlapPos, getRectCenter, getElsRelativeCenterOffset, getElsCollDirDepth, getElsCollDetails, } from './basics/collision.mjs';
-import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valMediaContentMetadataPartial, } from './basics/mediaContent.mjs';
+import { extractMediaId3Tags, parseMediaMetadata, valMediaContentMetadata, valFetchMediaContent, } from './basics/mediaContent.mjs';
 import TinyHtml from './libs/TinyHtml.mjs';
 import TinyAfterScrollWatcher from './libs/TinyAfterScrollWatcher.mjs';
 import UltraRandomMsgGen from './libs/UltraRandomMsgGen.mjs';
@@ -59,4 +59,4 @@ import { browserIs, getBrowserCssPrefix, getBrowserPings, getDuckTyping, isBrows
 // import TinyHtmlElems from './libs/TinyHtml/index.mjs';
 export { TinyDebugger, TinyMediaPlayer, TinyRadioFm, TinyClassManager, FuzzySet, MamdaniInferenceSystem, TinyArrayComparator, TinyTextDiffer, TinyAnalogClock, 
 // TinyHtmlElems,
-TinyColorValidator, TinyLoadingScreen, TinyElementObserver, TinySimpleDice, TinyNeedBar, TinyI18, TinyCookieConsent, TinyInventory, TinyInventoryTrader, TinyArrayPaginator, TinyAdvancedRaffle, TinyDayNightCycle, TinyGamepad, TinyTextarea, TinyNewWinEvents, TinyIframeEvents, TinyLocalStorage, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getUserTimeFormat, getBrowserPings, isBrowserAgent, getBrowserCssPrefix, getDuckTyping, browserIs, isValidObj, createSingletonTask, waitForTrue, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valMediaContentMetadataPartial, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, 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, objTypeName, isObjType, 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, TinyTimeout, TinyColorConverter, TinyClipboard, TinyTextRangeEditor, TinySmartScroller, UltraRandomMsgGen, TinyAfterScrollWatcher, TinyHtml, TinyNotifications, TinyDomReadyManager, TinyDragger, TinyDragDropDetector, TinyToastNotify, TinyNotifyCenter, TinyRateLimiter, ColorSafeStringify, TinyPromiseQueue, TinyLevelUp, getUserTimeFormat, getBrowserPings, isBrowserAgent, getBrowserCssPrefix, getDuckTyping, browserIs, isValidObj, createSingletonTask, waitForTrue, multiplyArrayBlocks, createCheckDestroyed, valMediaContentMetadata, valFetchMediaContent, parseMediaMetadata, extractMediaId3Tags, defuzzifyCentroid, trapezoid, diffArrayList, diffStrings, diffObjList, 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, objTypeName, isObjType, objType, ruleOfThree, getSimplePerc, asyncReplace, getAge, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, shuffleArray, toTitleCase, toTitleCaseLowerFirst, };

package/dist/v1/libs/TinyMediaPlayer.cjs

@@ -1058,7 +1058,7 @@ class TinyMediaPlayer extends TinyDebugger {
     }
 
     /** @type {MediaContent} */
-    const newContent = { ...mediaContent.getMediaContentBase(), ...mediaContent.getMediaContentMetadata(), ...content };
+    const newContent = { ...mediaContent.getMediaContentBase(), ...content };
     mediaContent.valMediaContentMetadata(newContent);
 
     const newLength = this.#playlist.push(newContent);

package/dist/v1/libs/TinyMediaPlayer.mjs

@@ -1,5 +1,5 @@
 import TinyDebugger from './TinyDebugger.mjs';
-import { getMediaContentBase, getMediaContentMetadata, parseMediaMetadata, valMediaContentMetadata, } from '../basics/mediaContent.mjs';
+import { getMediaContentBase, parseMediaMetadata, valMediaContentMetadata, } from '../basics/mediaContent.mjs';
 import { createCheckDestroyed } from './utils.mjs';
 import { BaseMediaAdapter } from './TinyMediaPlayer/index.mjs';
 import { isValidObj } from '../basics/objChecker.mjs';
@@ -937,7 +937,7 @@ class TinyMediaPlayer extends TinyDebugger {
             throw new TypeError('Track content must be a valid MediaContent object containing a URL.');
         }
         /** @type {MediaContent} */
-        const newContent = { ...getMediaContentBase(), ...getMediaContentMetadata(), ...content };
+        const newContent = { ...getMediaContentBase(), ...content };
         valMediaContentMetadata(newContent);
         const newLength = this.#playlist.push(newContent);
         this.log('info', `Track added. New length: ${newLength}`, newContent);

package/dist/v1/libs/TinyRadioFm.cjs

@@ -3,6 +3,7 @@
 var events = require('events');
 var mediaContent = require('../basics/mediaContent.cjs');
 var utils = require('./utils.cjs');
+var objChecker = require('../basics/objChecker.cjs');
 
 const checkDestroy = utils.createCheckDestroyed('TinyRadioFm');
 
@@ -160,7 +161,7 @@ class TinyRadioFm extends events.EventEmitter {
     metadata,
     parseFile,
     callbacks,
-    convertBase64toBlob,
+    convertBase64toBlob = true,
   ) {
     return mediaContent.parseMediaMetadata(
       source,
@@ -612,6 +613,7 @@ class TinyRadioFm extends events.EventEmitter {
       throw new TypeError('smartQueue must be a boolean.');
     }
 
+    mediaContent.valMediaContentMetadata(data);
     const newItem = structuredClone(data);
     this._ccBase64ToBlobUrl(newItem);
     if (type === 'music') {
@@ -688,6 +690,13 @@ class TinyRadioFm extends events.EventEmitter {
       if (eventAtTime) finalTimestamp = eventAtTime.absoluteEnd;
     }
 
+    if (
+      objChecker.isJsonObject(payload) &&
+      // @ts-ignore
+      typeof payload.newIndex !== 'number'
+    )
+      // @ts-ignore
+      mediaContent.valMediaContentMetadata(payload);
     /** @type {ScheduledTask} */
     const task = { timestamp: finalTimestamp, action, type, payload };
     this.#scheduledTasks.push(task);
@@ -838,6 +847,7 @@ class TinyRadioFm extends events.EventEmitter {
   async _processListForExport(list) {
     return Promise.all(
       list.map(async (item) => {
+        mediaContent.valMediaContentMetadata(item);
         const newItem = structuredClone(item);
         await this._rcblobUrlToBase64(newItem);
         return newItem;
@@ -1506,6 +1516,7 @@ class TinyRadioFm extends events.EventEmitter {
 
     const processListForImport = (/** @type {MediaContent[]} */ list) =>
       list.map((item) => {
+        mediaContent.valMediaContentMetadata(item);
         const newItem = structuredClone(item);
         this._ccBase64ToBlobUrl(newItem);
         return newItem;

package/dist/v1/libs/TinyRadioFm.mjs

@@ -1,6 +1,7 @@
 import { EventEmitter } from 'events';
-import { blobUrlToBase64, convertToBlobUrl, parseMediaMetadata, revokeContentUrls, } from '../basics/mediaContent.mjs';
+import { blobUrlToBase64, convertToBlobUrl, parseMediaMetadata, revokeContentUrls, valMediaContentMetadata, } from '../basics/mediaContent.mjs';
 import { createCheckDestroyed } from './utils.mjs';
+import { isJsonObject } from '../basics/objChecker.mjs';
 const checkDestroy = createCheckDestroyed('TinyRadioFm');
 /**
  * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
@@ -132,7 +133,7 @@ class TinyRadioFm extends EventEmitter {
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
-    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob) {
+    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob = true) {
         return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob, TinyRadioFm.#unknownArtist);
     }
     /**
@@ -516,6 +517,7 @@ class TinyRadioFm extends EventEmitter {
         if (typeof smartQueue !== 'boolean') {
             throw new TypeError('smartQueue must be a boolean.');
         }
+        valMediaContentMetadata(data);
         const newItem = structuredClone(data);
         this._ccBase64ToBlobUrl(newItem);
         if (type === 'music') {
@@ -584,6 +586,11 @@ class TinyRadioFm extends EventEmitter {
             if (eventAtTime)
                 finalTimestamp = eventAtTime.absoluteEnd;
         }
+        if (isJsonObject(payload) &&
+            // @ts-ignore
+            typeof payload.newIndex !== 'number')
+            // @ts-ignore
+            valMediaContentMetadata(payload);
         /** @type {ScheduledTask} */
         const task = { timestamp: finalTimestamp, action, type, payload };
         this.#scheduledTasks.push(task);
@@ -710,6 +717,7 @@ class TinyRadioFm extends EventEmitter {
      */
     async _processListForExport(list) {
         return Promise.all(list.map(async (item) => {
+            valMediaContentMetadata(item);
             const newItem = structuredClone(item);
             await this._rcblobUrlToBase64(newItem);
             return newItem;
@@ -1245,6 +1253,7 @@ class TinyRadioFm extends EventEmitter {
             }
         });
         const processListForImport = (/** @type {MediaContent[]} */ list) => list.map((item) => {
+            valMediaContentMetadata(item);
             const newItem = structuredClone(item);
             this._ccBase64ToBlobUrl(newItem);
             return newItem;

package/docs/v1/basics/mediaContent.md

@@ -54,9 +54,8 @@ Used to provide specific context when something goes wrong during the media prep
 | Function | Description |
 | :--- | :--- |
 | `getMediaContentBase` | Returns a fresh, empty `MediaContentBase` object. |
-| `getMediaContentMetadata` | Returns a fresh, empty `MediaContentMetadata` object. |
 | `valMediaContentMetadata` | Performs strict validation on a full `MediaContentMetadata` object. |
-| `valMediaContentMetadataPartial` | Performs validation on a partial metadata object (useful for patches/updates). |
+| `valFetchMediaContent` | Performs strict validation on a full `MediaContentFetchData` object. |
 
 ### Data & Memory Management
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.28.12",
+  "version": "1.28.14",
   "description": "Collection of small, essential scripts designed to be used across various projects. These simple utilities are crafted for speed, ease of use, and versatility.",
   "bin": {
     "tiny-essentials-fork": "./TinyFork.mjs"