tiny-essentials 1.28.9 → 1.28.11

package/dist/v1/basics/mediaContent.cjs

@@ -412,11 +412,12 @@ 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.
  */
-const extractMediaId3Tags = async (url, parseFile) => {
+const extractMediaId3Tags = async (url, parseFile, convertBase64toBlob = true) => {
   // Argument Validation
   checkString(url, 'url');
   checkFunction(parseFile, 'parseFile');
@@ -459,7 +460,7 @@ const extractMediaId3Tags = async (url, parseFile) => {
       picture:
         common?.picture?.map((value) => ({
           ...value,
-          data: convertToBlobUrl(value.data, value.format),
+          data: convertBase64toBlob ? convertToBlobUrl(value.data, value.format) : value.data,
         })) ?? [],
     };
   } catch (error) {
@@ -480,6 +481,7 @@ 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.
@@ -520,6 +522,7 @@ const parseMediaMetadata = async (
     return new Promise((resolve, reject) => reject(new TypeError('parseFile library not found.')));
   },
   callbacks = {},
+  convertBase64toBlob = true,
   unknownArtist = 'null',
 ) => {
   // Argument Validation
@@ -645,11 +648,11 @@ const parseMediaMetadata = async (
     };
 
     // 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,
       // but we still notify the developer via onError.

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

@@ -223,11 +223,12 @@ export declare const valMediaContentMetadataPartial: (common: Partial<ContentMet
  *
  * @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 declare const extractMediaId3Tags: (url: string, parseFile: ParseMediaContentMetadata) => Promise<MediaContentMetadata<string>>;
+export declare const extractMediaId3Tags: (url: string, parseFile: ParseMediaContentMetadata, convertBase64toBlob?: boolean) => Promise<MediaContentMetadata<PictureDataType>>;
 /**
  * A Static Factory Method that prepares a MediaContent object by
  * extracting metadata from an audio source.
@@ -240,6 +241,7 @@ export declare const extractMediaId3Tags: (url: string, parseFile: ParseMediaCon
  * @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.
@@ -280,5 +282,5 @@ export declare const parseMediaMetadata: <PictureData extends PictureDataType>(s
 }, parseFile?: ParseMediaContentMetadata, callbacks?: {
     onProgress?: (progress: LoadingMediaProgress) => void;
     onError?: (error: MediaLoadingErrorData) => void;
-}, unknownArtist?: UnknownArtistGetter) => Promise<MediaContent<PictureData>>;
+}, convertBase64toBlob?: boolean, unknownArtist?: UnknownArtistGetter) => Promise<MediaContent<PictureData>>;
 //# sourceMappingURL=mediaContent.d.mts.map

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/libs/TinyHtml.cjs

@@ -1042,16 +1042,6 @@ class TinyHtml {
     return true;
   }
 
-  /**
-   * @deprecated Use the getter {@link elements} instead.
-   * Returns the current targets held by this instance.
-   *
-   * @returns {ConstructorElValues[]} - The instance's targets element.
-   */
-  getAll() {
-    return [...this.#el];
-  }
-
   ////////////////////////////////////////////////
 
   // TITLE: Element Getter (Private) (Pt1)

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

@@ -463,13 +463,6 @@ declare class TinyHtml<TinyHtmlT extends TinyHtmlConstructor> {
      * @returns {boolean} - True if the element exists; otherwise, false.
      */
     exists(index: number): boolean;
-    /**
-     * @deprecated Use the getter {@link elements} instead.
-     * Returns the current targets held by this instance.
-     *
-     * @returns {ConstructorElValues[]} - The instance's targets element.
-     */
-    getAll(): ConstructorElValues[];
     /**
      * Returns the current Element held by this instance.
      *

package/dist/v1/libs/TinyHtml.mjs

@@ -909,15 +909,6 @@ class TinyHtml {
             return false;
         return true;
     }
-    /**
-     * @deprecated Use the getter {@link elements} instead.
-     * Returns the current targets held by this instance.
-     *
-     * @returns {ConstructorElValues[]} - The instance's targets element.
-     */
-    getAll() {
-        return [...this.#el];
-    }
     ////////////////////////////////////////////////
     // TITLE: Element Getter (Private) (Pt1)
     /**

package/dist/v1/libs/TinyMediaPlayer/index.cjs

@@ -52,6 +52,19 @@ class BaseMediaAdapter extends events.EventEmitter {
     return this.#destroyed;
   }
 
+  /**
+   * Returns the thumbnail URL for the currently loaded track.
+   * @param {string} trackId - The SoundCloud track ID.
+   * @returns {string} The thumbnail URL.
+   * @throws {TypeError} If the trackId is not a valid string.
+   */
+  static getThumbnailUrl(trackId) {
+    if (typeof trackId !== 'string' || trackId.trim() === '') {
+      throw new TypeError('The "trackId" must be a non-empty string.');
+    }
+    return ``;
+  }
+
   /**
    * Determines if this adapter can play the provided content.
    * @param {MediaContent} content - The media content to evaluate.

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

@@ -66,6 +66,13 @@ declare class BaseMediaAdapter extends EventEmitter {
     #private;
     constructor();
     get destroyed(): boolean;
+    /**
+     * Returns the thumbnail URL for the currently loaded track.
+     * @param {string} trackId - The SoundCloud track ID.
+     * @returns {string} The thumbnail URL.
+     * @throws {TypeError} If the trackId is not a valid string.
+     */
+    static getThumbnailUrl(trackId: string): string;
     /**
      * Determines if this adapter can play the provided content.
      * @param {MediaContent} content - The media content to evaluate.

package/dist/v1/libs/TinyMediaPlayer/index.mjs

@@ -42,6 +42,18 @@ class BaseMediaAdapter extends EventEmitter {
     get destroyed() {
         return this.#destroyed;
     }
+    /**
+     * Returns the thumbnail URL for the currently loaded track.
+     * @param {string} trackId - The SoundCloud track ID.
+     * @returns {string} The thumbnail URL.
+     * @throws {TypeError} If the trackId is not a valid string.
+     */
+    static getThumbnailUrl(trackId) {
+        if (typeof trackId !== 'string' || trackId.trim() === '') {
+            throw new TypeError('The "trackId" must be a non-empty string.');
+        }
+        return ``;
+    }
     /**
      * Determines if this adapter can play the provided content.
      * @param {MediaContent} content - The media content to evaluate.

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/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

@@ -14,6 +14,7 @@ To support different media platforms, `TinyMediaPlayer` relies on **Adapters**.
 #### Methods
 | Method | Description | Parameters | Returns |
 | :--- | :--- | :--- | :--- |
+| `static getThumbnailUrl` | Returns the thumbnail URL for the provided track ID. Throws `TypeError` if `trackId` is invalid. | `trackId: string` | `string` |
 | `static canHandle` | Determines if the adapter can play the provided content. | `content: MediaContent` | `boolean` |
 | `canHandle` | Determines if the adapter can play the provided content. | `content: MediaContent` | `boolean` |
 | `isReady` | Synchronously checks if the adapter is ready. | None | `boolean` |
@@ -180,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`
@@ -188,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>`.
 
 ---
@@ -231,7 +233,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
 * **`registerAdapter(adapter)`**: Registers a new provider.
     * `adapter`: An instance of a class extending `BaseMediaAdapter`.
 * **`removeAdapter(adapter)`**: Removes a specific registered adapter.
-* **`destroyAdapter(adapter)`**: Destroys and removes a specific registered adapter.
+* **`destroyAdapter(adapter)`**: Destroys and removes a specific registered media adapter.
 * **`hasAdapter(adapter)`**: Checks if a specific adapter is registered.
 * **`clearAdapters()`**: Clears the list of adapters (does not call `destroy` on them).
 * **`destroyAllAdapters()`**: Destroys and removes all registered media adapters.
@@ -254,7 +256,7 @@ When initializing `new TinyMediaPlayer(options)`, you can pass the following `Ti
 * **`removeTrack(index)`**: **(Async)** Removes a track and adjusts the current index/playback accordingly.
 * **`searchTrack(query)`**: Searches the playlist (string or function).
     * `query`: A `string` (searches title, artist, or album) or a `function` (custom logic).
-    * **Returns**: `SearchResult[]` (array of objects containing the track and their corresponding indices).
+    * `Returns`: `SearchResult[]` (array of objects containing the track and their corresponding indices).
 * **`clearPlaylist()`**: **(Async)** Stops playback and empties the entire playlist.
 
 #### ⏯️ Playback Controls

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.9",
+  "version": "1.28.11",
   "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"