tiny-essentials 1.28.10 → 1.28.12

package/dist/v1/basics/mediaContent.mjs

@@ -364,11 +364,12 @@ export const valMediaContentMetadataPartial = (common) => {
  *
  * @param {string} url - The full URL of the audio file to be downloaded.
  * @param {ParseMediaContentMetadata} parseFile - The function used to parse the file data.
- * @returns {Promise<MediaContentMetadata<string>>} A promise that resolves to an object containing the extracted metadata.
+ * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
+ * @returns {Promise<MediaContentMetadata<PictureDataType>>} A promise that resolves to an object containing the extracted metadata.
  * @throws {TypeError} If the provided `url` is not a string or `parseFile` is not a function.
  * @throws {Error} If the network request fails or the parsing process encounters an error.
  */
-export const extractMediaId3Tags = async (url, parseFile) => {
+export const extractMediaId3Tags = async (url, parseFile, convertBase64toBlob = true) => {
     // Argument Validation
     checkString(url, 'url');
     checkFunction(parseFile, 'parseFile');
@@ -403,7 +404,7 @@ export const extractMediaId3Tags = async (url, parseFile) => {
             track: common?.track ? { no: common.track.no, of: common.track.of } : { no: null, of: null },
             picture: common?.picture?.map((value) => ({
                 ...value,
-                data: convertToBlobUrl(value.data, value.format),
+                data: convertBase64toBlob ? convertToBlobUrl(value.data, value.format) : value.data,
             })) ?? [],
         };
     }
@@ -424,6 +425,7 @@ export const extractMediaId3Tags = async (url, parseFile) => {
  * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
  * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
  * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+ * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
  * @param {UnknownArtistGetter} unknownArtist
  * @returns {Promise<MediaContent<PictureData>>} A promise that resolves to a valid MediaContent object.
  * @throws {MediaLoadingError} If the preparation process fails at any stage.
@@ -459,7 +461,7 @@ export const parseMediaMetadata = async (source, defaultMetadata = {}, metadata
     if (!(data instanceof Blob))
         throw new TypeError('Expected "data" to be a Blob.');
     return new Promise((resolve, reject) => reject(new TypeError('parseFile library not found.')));
-}, callbacks = {}, unknownArtist = 'null') => {
+}, callbacks = {}, convertBase64toBlob = true, unknownArtist = 'null') => {
     // Argument Validation
     if (typeof source !== 'string' && !(source instanceof HTMLMediaElement))
         throw new TypeError('Source must be a string or an HTMLMediaElement.');
@@ -564,11 +566,11 @@ export const parseMediaMetadata = async (source, defaultMetadata = {}, metadata
             weight: metadata.weight ?? 1,
         };
         // 4. Automatic Metadata Extraction (ID3 Tags)
-        /** @type {Partial<MediaContentMetadata<string>>} */
+        /** @type {Partial<MediaContentMetadata<PictureDataType>>} */
         let extractedMetadata = {};
         notifyProgress('EXTRACTING_ID3');
         try {
-            extractedMetadata = await extractMediaId3Tags(url, parseFile);
+            extractedMetadata = await extractMediaId3Tags(url, parseFile, convertBase64toBlob);
         }
         catch (err) {
             // We treat ID3 failure as a non-fatal error for the whole process,

package/dist/v1/index.cjs

@@ -71,6 +71,7 @@ exports.formatCustomTimer = clock.formatCustomTimer;
 exports.formatDayTimer = clock.formatDayTimer;
 exports.formatTimer = clock.formatTimer;
 exports.getTimeDuration = clock.getTimeDuration;
+exports.getUserTimeFormat = clock.getUserTimeFormat;
 exports.checkObj = objFilter.checkObj;
 exports.cloneObjTypeOrder = objFilter.cloneObjTypeOrder;
 exports.extendObjType = objFilter.extendObjType;

package/dist/v1/index.d.mts

@@ -1,6 +1,6 @@
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks } from './basics/array.mjs';
-import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration } from './basics/clock.mjs';
+import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, getUserTimeFormat } from './basics/clock.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, objTypeName, isObjType } from './basics/objFilter.mjs';
 import { countObj, isJsonObject, isValidObj } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange } from './basics/fullScreen.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, 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, 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, };
 //# sourceMappingURL=index.d.mts.map

package/dist/v1/index.mjs

@@ -1,6 +1,6 @@
 import TinyLevelUp from './libs/TinyLevelUp.mjs';
 import { diffArrayList, shuffleArray, arraySortPositions, multiplyArrayBlocks, } from './basics/array.mjs';
-import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, } from './basics/clock.mjs';
+import { breakdownDuration, formatCustomTimer, formatDayTimer, formatTimer, getTimeDuration, getUserTimeFormat, } from './basics/clock.mjs';
 import { extendObjType, reorderObjTypeOrder, cloneObjTypeOrder, objType, checkObj, objTypeName, isObjType, } from './basics/objFilter.mjs';
 import { countObj, isJsonObject, isValidObj } from './basics/objChecker.mjs';
 import { documentIsFullScreen, isScreenFilled, requestFullScreen, exitFullScreen, isFullScreenMode, onFullScreenChange, offFullScreenChange, } from './basics/fullScreen.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, 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, 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, };

package/dist/v1/libs/TinyMediaPlayer.cjs

@@ -88,16 +88,25 @@ class TinyMediaPlayer extends TinyDebugger {
    * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
    * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
    * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+   * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
    * @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) {
+  static async parseContent(
+    source,
+    defaultMetadata,
+    metadata,
+    parseFile,
+    callbacks,
+    convertBase64toBlob,
+  ) {
     return mediaContent.parseMediaMetadata(
       source,
       defaultMetadata,
       metadata,
       parseFile,
       callbacks,
+      convertBase64toBlob,
       TinyMediaPlayer.#unknownArtist,
     );
   }
@@ -1202,7 +1211,14 @@ class TinyMediaPlayer extends TinyDebugger {
     checkDestroy(this.#destroyed);
     this.log('info', `Attempting to play track at index: ${this.#currentIndex}`);
     const adapter = this.#getActiveAdapter();
-    if (!adapter) return;
+    if (!adapter) {
+      this.log(
+        'error',
+        'Failed to play track:',
+        `Active adapter not found for track at index ${this.#currentIndex}.`,
+      );
+      return;
+    }
 
     // Ensure the adapter aligns with the global volume before playing
     if (this.#smoothPlayPauseVolume) {

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

@@ -117,6 +117,7 @@ declare class TinyMediaPlayer extends TinyDebugger {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
@@ -129,7 +130,7 @@ declare class TinyMediaPlayer extends TinyDebugger {
     }, parseFile?: ParseMediaContentMetadata, callbacks?: {
         onProgress?: (progress: LoadingMediaProgress) => void;
         onError?: (error: MediaLoadingErrorData) => void;
-    }): Promise<MediaContent>;
+    }, convertBase64toBlob?: boolean): Promise<MediaContent>;
     get destroyed(): boolean;
     /** @returns {number} The duration (ms) of the volume fade speed. */
     get fadeVolumeSpeed(): number;

package/dist/v1/libs/TinyMediaPlayer.mjs

@@ -76,11 +76,12 @@ class TinyMediaPlayer extends TinyDebugger {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @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) {
-        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, TinyMediaPlayer.#unknownArtist);
+    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob) {
+        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob, TinyMediaPlayer.#unknownArtist);
     }
     /** @type {boolean} */
     #destroyed = false;
@@ -1073,8 +1074,10 @@ class TinyMediaPlayer extends TinyDebugger {
         checkDestroy(this.#destroyed);
         this.log('info', `Attempting to play track at index: ${this.#currentIndex}`);
         const adapter = this.#getActiveAdapter();
-        if (!adapter)
+        if (!adapter) {
+            this.log('error', 'Failed to play track:', `Active adapter not found for track at index ${this.#currentIndex}.`);
             return;
+        }
         // Ensure the adapter aligns with the global volume before playing
         if (this.#smoothPlayPauseVolume) {
             await this.#fadeAdapterVolume(this.#volume);

package/dist/v1/libs/TinyRadioFm.cjs

@@ -150,16 +150,25 @@ class TinyRadioFm extends events.EventEmitter {
    * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
    * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
    * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+   * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
    * @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) {
+  static async parseContent(
+    source,
+    defaultMetadata,
+    metadata,
+    parseFile,
+    callbacks,
+    convertBase64toBlob,
+  ) {
     return mediaContent.parseMediaMetadata(
       source,
       defaultMetadata,
       metadata,
       parseFile,
       callbacks,
+      convertBase64toBlob,
       TinyRadioFm.#unknownArtist,
     );
   }

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

@@ -341,6 +341,7 @@ declare class TinyRadioFm extends EventEmitter {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @returns {Promise<MediaContent>} A promise that resolves to a valid MediaContent object.
      * @throws {MediaLoadingError} If the preparation process fails at any stage.
      */
@@ -353,7 +354,7 @@ declare class TinyRadioFm extends EventEmitter {
     }, parseFile?: ParseMediaContentMetadata, callbacks?: {
         onProgress?: (progress: LoadingMediaProgress) => void;
         onError?: (error: MediaLoadingErrorData) => void;
-    }): Promise<MediaContent>;
+    }, convertBase64toBlob?: boolean): Promise<MediaContent>;
     /**
      * Gets the current value used to represent unknown artists.
      * @returns {UnknownArtistGetter}

package/dist/v1/libs/TinyRadioFm.mjs

@@ -128,11 +128,12 @@ class TinyRadioFm extends EventEmitter {
      * @param {Object} [callbacks={}] - Callbacks for monitoring the loading process.
      * @param {(progress: LoadingMediaProgress) => void} [callbacks.onProgress] - Callback triggered on stage changes.
      * @param {(error: MediaLoadingErrorData) => void} [callbacks.onError] - Callback triggered when a non-fatal or fatal error occurs.
+     * @param {boolean} [convertBase64toBlob=true] - If the image content needs to be converted directly into a high-performance Blob URL, use this method.
      * @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) {
-        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, TinyRadioFm.#unknownArtist);
+    static async parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob) {
+        return parseMediaMetadata(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob, TinyRadioFm.#unknownArtist);
     }
     /**
      * @type {UnknownArtistGetter}

package/docs/v1/basics/clock.md

@@ -6,6 +6,7 @@ A versatile time utility module for JavaScript that helps you calculate and form
 
 - 🔢 Calculate time differences in various units
 - 🧭 Format durations into clean, readable timer strings
+- 🌍 Locale-aware time cycle detection (12h vs 24h)
 - 🧱 Support for years, months, days, hours, minutes, seconds **and milliseconds**
 - 🎛️ Customizable output with template-based formatting
 - 🛠️ Built-in presets for classic timer formats
@@ -15,6 +16,14 @@ A versatile time utility module for JavaScript that helps you calculate and form
 
 ## 🧠 API Overview
 
+### 🔹 `getUserTimeFormat()`
+
+Detects the user's preferred time format (12-hour or 24-hour) based on the system's locale settings.
+
+**Returns:** `number` — `12` if the user's locale uses a 12-hour cycle, otherwise `24`.
+
+---
+
 ### 🔹 `getTimeDuration(timeData, durationType = 'asSeconds', now = null)`
 
 Calculates how much time remains (or has passed) between now and a given time.
@@ -25,7 +34,7 @@ Calculates how much time remains (or has passed) between now and a given time.
 | `durationType` | `string` | Format to return (`asMilliseconds`, `asSeconds`, `asMinutes`, etc.) |
 | `now`          | `Date`   | Optional custom "now". Defaults to current time.                    |
 
-**Returns:** `number|null` — The duration in the chosen unit.
+**Returns:** `number` — The duration in the chosen unit.
 
 ---
 
@@ -93,15 +102,22 @@ This is useful when you want numeric values to build your own custom formats.
 ## 🧪 Examples
 
 ```js
+// Detect user time preference
+const timeFormat = getUserTimeFormat();
+console.log(timeFormat); // 12 or 24
+
+// Calculate remaining time
 const futureTime = new Date(Date.now() + 10000);
 const secondsLeft = getTimeDuration(futureTime, 'asSeconds');
 
 console.log(formatTimer(secondsLeft)); // e.g. "00:00:09"
 console.log(formatDayTimer(172800 + 3661)); // "2d 01:01:01"
 
+// Custom formatting
 const custom = formatCustomTimer(3600 * 26 + 61, 'days', '{days}d {hours}h {minutes}m {seconds}s');
 console.log(custom); // "1d 2h 1m 1s"
 
+// Detailed breakdown
 const breakdown = breakdownDuration(987654321, 'years');
 console.log(breakdown);
 // {

package/docs/v1/basics/mediaContent.md

@@ -77,6 +77,7 @@ Downloads an audio file and uses a provided parser to extract its internal metad
 *   **Parameters:**
     *   `url` (string): The full URL of the audio file.
     *   `parseFile` (Function): A callback that accepts a `Blob` and returns a promise with metadata.
+    *   `convertBase64toBlob` (boolean): If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 *   **Returns:** `Promise<MediaContentMetadata>`
 *   **Throws:** `TypeError` for invalid arguments or `Error` for network/parsing failures.
 
@@ -94,6 +95,7 @@ Downloads an audio file and uses a provided parser to extract its internal metad
 | `metadata` | `Partial<MediaContent>` | Manual overrides for the metadata (highest priority). |
 | `parseFile` | `ParseMediaContentMetadata` | The library function used to parse the file. |
 | `callbacks` | `Object` | Contains `onProgress` and `onError` listeners. |
+| `convertBase64toBlob` | `boolean` | If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 | `unknownArtist` | `UnknownArtistGetter` | Logic to determine the artist if none is found. |
 
 #### 💡 Usage Examples

package/docs/v1/libs/TinyMediaPlayer.md

@@ -181,7 +181,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
     * **Getter/Setter**: Allows customization of the default event subscription list.
 
 #### Methods
-* **`parseContent(source, defaultMetadata, metadata, parseFile, callbacks)`**: 
+* **`parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob)`**: 
     * A static factory method to prepare a `MediaContent` object by extracting metadata from a URL or HTMLMediaElement.
     * **Parameters**:
         * `source`: `string | HTMLMediaElement`
@@ -189,6 +189,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
         * `metadata`: `Partial<MediaContentBase & MediaContentMetadata>`
         * `parseFile`: `ParseMediaContentMetadata`
         * `callbacks`: `Object` (containing `onProgress` and `onError`)
+        * `convertBase64toBlob`: `boolean`
     * **Returns**: `Promise<MediaContent>`.
 
 ---

package/docs/v1/libs/TinyRadioFm.md

@@ -42,7 +42,7 @@ The behavior of the engine is controlled via the `RadioConfig` object.
 
 ### 🏗️ Static Methods
 
-#### `static parseContent(source, defaultMetadata, metadata, parseFile, callbacks)`
+#### `static parseContent(source, defaultMetadata, metadata, parseFile, callbacks, convertBase64toBlob)`
 Prepares a `MediaContent` object by extracting metadata from an audio source.
 * **Parameters:**
     * `source`: A URL string or an existing `HTMLMediaElement`.
@@ -50,6 +50,7 @@ Prepares a `MediaContent` object by extracting metadata from an audio source.
     * `metadata`: Optional manual overrides.
     * `parseFile`: Internal helper for file parsing.
     * `callbacks`: Object containing `onProgress` and `onError` handlers.
+    * `convertBase64toBlob`: If true, the image content will be converted directly into a high-performance Blob URL, use this method.
 * **Returns:** `Promise<MediaContent>`
 * **Throws:** `MediaLoadingError`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiny-essentials",
-  "version": "1.28.10",
+  "version": "1.28.12",
   "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"