tiny-essentials 1.28.1 → 1.28.2

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

@@ -1,11 +1,5 @@
-export default TinyLocalStorage;
-/**
- * A function that encodes a value into a serializable JSON-compatible format.
- */
+import { EventEmitter } from 'events';
 export type EncodeFn = (value: any, encodeSpecialJson: encodeSpecialJson) => any;
-/**
- * An object that defines how to check and decode a specific serialized type.
- */
 export type DecodeFn = {
     /**
      * - Checks if the value matches the custom encoded structure.
@@ -16,25 +10,8 @@ export type DecodeFn = {
      */
     decode: (value: any, decodeSpecialJson: decodeSpecialJson) => any;
 };
-/**
- * Encodes extended JSON-compatible structures recursively.
- */
 export type encodeSpecialJson = (value: any) => any;
-/**
- * Decodes extended JSON-compatible structures recursively.
- */
 export type decodeSpecialJson = (value: any) => any;
-/**
- * Represents a value that can be safely stored and restored using JSON in `localStorage`,
- * including structures like arrays, plain objects, Map and Set.
- *
- * - `Record<string|number|symbol, any>` → plain object (e.g., `{ key: value }`)
- * - `any[]` → array of any JSON-serializable values
- * - `Map<string|number|symbol, any>` → converted to `{ __map__: true, data: [[k, v], ...] }`
- * - `Set<any>` → converted to `{ __set__: true, data: [v1, v2, ...] }`
- *
- * These conversions allow complex structures to be restored after JSON serialization.
- */
 export type LocalStorageJsonValue = (Record<string | number | symbol, any> | any[] | Map<string | number | symbol, any> | Set<any>);
 /**
  * A function that encodes a value into a serializable JSON-compatible format.
@@ -100,7 +77,8 @@ export type LocalStorageJsonValue = (Record<string | number | symbol, any> | any
  *
  * This class is suitable for applications that require structured persistence in the browser.
  */
-declare class TinyLocalStorage extends EventEmitter<any> {
+declare class TinyLocalStorage extends EventEmitter {
+    #private;
     /**
      * Checks whether a JSON-serializable type is already registered.
      *
@@ -128,8 +106,12 @@ declare class TinyLocalStorage extends EventEmitter<any> {
      * @throws {Error} Throws an error if the type is frozen and cannot be unregistered.
      */
     static deleteJsonType(type: any): boolean;
-    static encodeSpecialJson(value: any): any;
-    static decodeSpecialJson(value: any): any;
+    /**
+     * Gets the current destruction status of the instance.
+     *
+     * @returns {boolean} True if the instance is destroyed, false otherwise.
+     */
+    get destroyed(): boolean;
     /**
      * Initializes the TinyLocalStorage instance and sets up cross-tab sync.
      *
@@ -137,12 +119,6 @@ declare class TinyLocalStorage extends EventEmitter<any> {
      * @param {string} [dbName] - Unique database name.
      */
     constructor(dbName?: string);
-    /**
-     * Gets the current destruction status of the instance.
-     *
-     * @returns {boolean} True if the instance is destroyed, false otherwise.
-     */
-    get destroyed(): boolean;
     /**
      * Updates the version of the storage and triggers migration if needed.
      *
@@ -195,7 +171,7 @@ declare class TinyLocalStorage extends EventEmitter<any> {
      * @param {'array'|'obj'|'map'|'set'|'null'} [defaultData] - Default fallback format if value is invalid.
      * @returns {LocalStorageJsonValue|null} The parsed object or fallback.
      */
-    getJson(name: string, defaultData?: "array" | "obj" | "map" | "set" | "null"): LocalStorageJsonValue | null;
+    getJson(name: string, defaultData?: 'array' | 'obj' | 'map' | 'set' | 'null'): LocalStorageJsonValue | null;
     /**
      * Stores a Date in localStorage.
      * @param {string} name
@@ -322,7 +298,6 @@ declare class TinyLocalStorage extends EventEmitter<any> {
      * Destroys the storage instance by removing the storage event listener.
      */
     destroy(): void;
-    #private;
 }
-import { EventEmitter } from 'events';
+export default TinyLocalStorage;
 //# sourceMappingURL=TinyLocalStorage.d.mts.map

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

@@ -1,11 +1,27 @@
-export function defuzzifyCentroid(fuzzyOutput: {
-    [x: string]: number;
-}, outputSets: FuzzySet[], step?: number): number;
-export function trapezoid(value: number, a: number, b: number, c: number, d: number, optimize?: boolean): number;
+/**
+ * Performs defuzzification using the Centroid (Center of Gravity) method.
+ * @param {Object.<string, number>} fuzzyOutput - Results from rule evaluation.
+ * @param {FuzzySet[]} outputSets - The sets defining the output range.
+ * @param {number} [step=0.5] - Resolution of the integral approximation.
+ * @returns {number} The crisp output value.
+ */
+export declare const defuzzifyCentroid: (fuzzyOutput: Record<string, number>, outputSets: FuzzySet[], step?: number) => number;
+/**
+ * Utility to calculate fuzzy membership using a trapezoidal shape safely.
+ * @param {number} value - The input value to check.
+ * @param {number} a - Start of the rise.
+ * @param {number} b - End of the rise (start of plateau).
+ * @param {number} c - Start of the fall (end of plateau).
+ * @param {number} d - End of the fall.
+ * @param {boolean} [optimize=false] - Optimizes performance by skipping math for absolute bounds.
+ * @returns {number} Degree of membership [0, 1].
+ */
+export declare const trapezoid: (value: number, a: number, b: number, c: number, d: number, optimize?: boolean) => number;
 /**
  * Represents a single Membership Function (Trapezoidal).
  */
-export class FuzzySet {
+declare class FuzzySet {
+    #private;
     /**
      * Utility to calculate fuzzy membership using a trapezoidal shape.
      * @param {number} value - The input value to check.
@@ -17,6 +33,18 @@ export class FuzzySet {
      * @returns {number} Degree of membership [0, 1].
      */
     static trapezoid(value: number, a: number, b: number, c: number, d: number, optimize?: boolean): number;
+    get name(): string;
+    set name(value: string);
+    get a(): number;
+    set a(value: number);
+    get b(): number;
+    set b(value: number);
+    get c(): number;
+    set c(value: number);
+    get d(): number;
+    set d(value: number);
+    get optimize(): boolean;
+    set optimize(value: boolean);
     /**
      * @param {string} name - Name of the set (e.g., "Hot").
      * @param {number} a - Left foot.
@@ -26,30 +54,18 @@ export class FuzzySet {
      * @param {boolean} [optimize=false] - Enables performance optimization.
      */
     constructor(name: string, a: number, b: number, c: number, d: number, optimize?: boolean);
-    set name(value: string);
-    get name(): string;
-    set a(value: number);
-    get a(): number;
-    set b(value: number);
-    get b(): number;
-    set c(value: number);
-    get c(): number;
-    set d(value: number);
-    get d(): number;
-    set optimize(value: boolean);
-    get optimize(): boolean;
     /**
      * Calculates the membership degree.
      * @param {number} x - Crisp input.
      * @returns {number}
      */
     calculate(x: number): number;
-    #private;
 }
 /**
  * The Inference Engine handles linguistic variables and defuzzification.
  */
-export class MamdaniInferenceSystem {
+declare class MamdaniInferenceSystem {
+    #private;
     /**
      * Registers a linguistic variable and its sets.
      * @param {string} name - Variable name (e.g., "temperature").
@@ -80,9 +96,7 @@ export class MamdaniInferenceSystem {
      * @param {number} value
      * @returns {Object.<string, number>}
      */
-    fuzzify(varName: string, value: number): {
-        [x: string]: number;
-    };
-    #private;
+    fuzzify(varName: string, value: number): Record<string, number>;
 }
+export { FuzzySet, MamdaniInferenceSystem };
 //# sourceMappingURL=TinyMamdaniInferenceSystem.d.mts.map

package/dist/v1/libs/TinyMediaPlayer.cjs

@@ -7,9 +7,10 @@ var utils = require('./utils.cjs');
 const checkDestroy = utils.createCheckDestroyed('TinyMediaPlayer');
 
 /**
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
  * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
@@ -17,6 +18,7 @@ const checkDestroy = utils.createCheckDestroyed('TinyMediaPlayer');
  */
 
 /**
+ * The loop configuration modes.
  * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
  */
 
@@ -673,7 +675,7 @@ class TinyMediaPlayer extends events.EventEmitter {
 
   /**
    * Searches the playlist for tracks matching a string query or a custom evaluation function.
-   * @param {string | function(MediaContent): boolean} query - The search string (checked against title, artist, album) or a callback returning a boolean.
+   * @param {string | ((content: MediaContent) => boolean)} query - The search string (checked against title, artist, album) or a callback returning a boolean.
    * @returns {SearchResult[]} An array containing the matched tracks and their corresponding indices.
    * @throws {TypeError} If the query is neither a string nor a function.
    */

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

@@ -1,28 +1,90 @@
-export default TinyMediaPlayer;
-export type MediaContent = import("../basics/mediaContent.mjs").MediaContent;
-export type MediaContentBase = import("../basics/mediaContent.mjs").MediaContentBase;
-export type MediaContentMetadata = import("../basics/mediaContent.mjs").MediaContentMetadata;
-export type ParseMediaContentMetadata = import("../basics/mediaContent.mjs").ParseMediaContentMetadata;
-export type LoadingMediaProgress = import("../basics/mediaContent.mjs").LoadingMediaProgress;
-export type MediaLoadingErrorData = import("../basics/mediaContent.mjs").MediaLoadingErrorData;
-export type UnknownArtistGetter = import("../basics/mediaContent.mjs").UnknownArtistGetter;
-export type LoopModeType = "NONE" | "TRACK" | "PLAYLIST";
-/**
- * Configuration options for initializing the UniversalMediaPlayer.
- */
+import { EventEmitter } from 'events';
+export type PictureDataType = import('../basics/mediaContent.mjs').PictureDataType;
+export type MediaContent = import('../basics/mediaContent.mjs').MediaContent<PictureDataType>;
+export type MediaContentBase = import('../basics/mediaContent.mjs').MediaContentBase;
+export type MediaContentMetadata = import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>;
+export type ParseMediaContentMetadata = import('../basics/mediaContent.mjs').ParseMediaContentMetadata;
+export type LoadingMediaProgress = import('../basics/mediaContent.mjs').LoadingMediaProgress;
+export type MediaLoadingErrorData = import('../basics/mediaContent.mjs').MediaLoadingErrorData;
+export type UnknownArtistGetter = import('../basics/mediaContent.mjs').UnknownArtistGetter;
+export type LoopModeType = 'NONE' | 'TRACK' | 'PLAYLIST';
 export type TinyMediaPlayerOptions = {
     /**
      * - Whether to automatically save the volume in localStorage.
      */
-    persistVolume?: boolean | undefined;
+    persistVolume?: boolean;
     /**
      * - The specific key name used for localStorage cache.
      */
-    volumeStorageKey?: string | undefined;
+    volumeStorageKey?: string;
 };
 /**
- * Represents a search match containing the media object and its exact playlist index.
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
+ * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
+ * @typedef {import('../basics/mediaContent.mjs').UnknownArtistGetter} UnknownArtistGetter
  */
+/**
+ * The loop configuration modes.
+ * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
+ */
+/**
+ * Configuration options for initializing the UniversalMediaPlayer.
+ * @typedef {Object} TinyMediaPlayerOptions
+ * @property {boolean} [persistVolume=false] - Whether to automatically save the volume in localStorage.
+ * @property {string} [volumeStorageKey='universal_media_player_volume'] - The specific key name used for localStorage cache.
+ */
+/**
+ * Interface definition for a Media Provider Adapter.
+ * All specific API wrappers must extend and implement this class.
+ * @abstract
+ */
+declare class BaseMediaAdapter {
+    constructor();
+    /**
+     * Determines if this adapter can play the provided content.
+     * @param {MediaContent} content - The media content to evaluate.
+     * @returns {boolean} True if the adapter can handle the content, false otherwise.
+     */
+    canHandle(content: MediaContent): boolean;
+    /**
+     * Starts or resumes playback of the provided content.
+     * @param {MediaContent} content - The media content to play.
+     * @returns {Promise<void>}
+     */
+    play(content: MediaContent): Promise<void>;
+    /**
+     * Pauses the current playback.
+     * @returns {Promise<void>}
+     */
+    pause(): Promise<void>;
+    /**
+     * Stops the playback completely and resets the internal platform state.
+     * @returns {Promise<void>}
+     */
+    stop(): Promise<void>;
+    /**
+     * Seeks to a specific time in the media timeline.
+     * @param {number} timeMs - The target time in milliseconds.
+     * @returns {Promise<void>}
+     */
+    seek(timeMs: number): Promise<void>;
+    /**
+     * Retrieves the current playback time from the underlying API.
+     * @returns {number} The current time in milliseconds.
+     */
+    getCurrentTime(): number;
+    /**
+     * Sets the playback volume for the underlying API.
+     * @param {number} volume - The volume level from 0.0 to 1.0.
+     * @returns {void}
+     */
+    setVolume(volume: number): void;
+}
 export type SearchResult = {
     /**
      * - The matched media content.
@@ -42,24 +104,20 @@ export type SearchResult = {
 /**
  * A universal media player manager capable of orchestrating multiple API adapters.
  */
-declare class TinyMediaPlayer extends EventEmitter<any> {
+declare class TinyMediaPlayer extends EventEmitter {
+    #private;
     static BaseMediaAdapter: typeof BaseMediaAdapter;
     /**
-     * @type {UnknownArtistGetter}
-     * The default identifier or function used when an artist cannot be determined.
+     * Gets the current value used to represent unknown artists.
+     * @returns {UnknownArtistGetter}
      */
-    static #unknownArtist: UnknownArtistGetter;
+    static get unknownArtist(): UnknownArtistGetter;
     /**
      * Sets the value used to represent unknown artists.
      * @param {UnknownArtistGetter} value - A string or a function that returns a string.
      * @throws {TypeError} If the value is neither a string nor a function.
      */
     static set unknownArtist(value: UnknownArtistGetter);
-    /**
-     * Gets the current value used to represent unknown artists.
-     * @returns {UnknownArtistGetter}
-     */
-    static get unknownArtist(): UnknownArtistGetter;
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.
@@ -81,14 +139,14 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
         id?: string;
         weight?: number;
     }, parseFile?: ParseMediaContentMetadata, callbacks?: {
-        onProgress?: ((progress: LoadingMediaProgress) => void) | undefined;
-        onError?: ((error: MediaLoadingErrorData) => void) | undefined;
+        onProgress?: (progress: LoadingMediaProgress) => void;
+        onError?: (error: MediaLoadingErrorData) => void;
     }): Promise<MediaContent>;
+    get destroyed(): boolean;
     /**
      * @param {TinyMediaPlayerOptions} [options={}] - Configuration parameters for the player.
      */
     constructor(options?: TinyMediaPlayerOptions);
-    get destroyed(): boolean;
     /**
      * Calculates a random index based on the weighted probability of each track,
      * strictly excluding the currently active track to prevent immediate repetition.
@@ -96,59 +154,59 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
      * @private
      */
     private _getWeightedRandomIndex;
+    /** @returns {MediaContent[]} A shallow copy of the current playlist. */
+    get playlist(): MediaContent[];
     /**
      * @param {MediaContent[]} value - The new playlist array.
      * @throws {TypeError} If the value is not an array.
      */
     set playlist(value: MediaContent[]);
-    /** @returns {MediaContent[]} A shallow copy of the current playlist. */
-    get playlist(): MediaContent[];
+    /** @returns {number} The current active index in the playlist. */
+    get currentIndex(): number;
     /**
      * @param {number} value - The index to set as current.
      * @throws {TypeError} If the value is not a number.
      * @throws {RangeError} If the index is out of the playlist bounds (unless -1 for empty).
      */
     set currentIndex(value: number);
-    /** @returns {number} The current active index in the playlist. */
-    get currentIndex(): number;
+    /** @returns {LoopModeType} The current loop configuration. */
+    get loopMode(): LoopModeType;
     /**
      * @param {LoopModeType} value - The desired loop mode.
      * @throws {TypeError} If the value is not a valid LoopModeType.
      */
     set loopMode(value: LoopModeType);
-    /** @returns {LoopModeType} The current loop configuration. */
-    get loopMode(): LoopModeType;
+    /** @returns {boolean} The current random mode status. */
+    get isRandom(): boolean;
     /**
      * @param {boolean} value - True to enable random playback, false otherwise.
      * @throws {TypeError} If the value is not a boolean.
      */
     set isRandom(value: boolean);
-    /** @returns {boolean} The current random mode status. */
-    get isRandom(): boolean;
     /** @returns {boolean} True if media is actively playing. */
     get isPlaying(): boolean;
+    /** @returns {number} The current volume level (0.0 to 1.0). */
+    get volume(): number;
     /**
      * @param {number} value - The volume level to set.
      * @throws {TypeError} If the value is not a number.
      * @throws {RangeError} If the value is outside the 0.0 to 1.0 range.
      */
     set volume(value: number);
-    /** @returns {number} The current volume level (0.0 to 1.0). */
-    get volume(): number;
+    /** @returns {boolean} Whether the volume cache is currently enabled. */
+    get persistVolume(): boolean;
     /**
      * @param {boolean} value - True to save volume dynamically to localStorage.
      * @throws {TypeError} If the value is not a boolean.
      */
     set persistVolume(value: boolean);
-    /** @returns {boolean} Whether the volume cache is currently enabled. */
-    get persistVolume(): boolean;
+    /** @returns {string} The localStorage key used for volume caching. */
+    get volumeStorageKey(): string;
     /**
      * @param {string} value - The custom storage key string.
      * @throws {TypeError} If the value is not a string or is empty.
      */
     set volumeStorageKey(value: string);
-    /** @returns {string} The localStorage key used for volume caching. */
-    get volumeStorageKey(): string;
     /**
      * Registers a new media API adapter.
      * @param {string} id - Unique identifier for the platform (e.g., 'youtube', 'spotify').
@@ -188,11 +246,11 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
     removeTrack(index: number): Promise<void>;
     /**
      * Searches the playlist for tracks matching a string query or a custom evaluation function.
-     * @param {string | function(MediaContent): boolean} query - The search string (checked against title, artist, album) or a callback returning a boolean.
+     * @param {string | ((content: MediaContent) => boolean)} query - The search string (checked against title, artist, album) or a callback returning a boolean.
      * @returns {SearchResult[]} An array containing the matched tracks and their corresponding indices.
      * @throws {TypeError} If the query is neither a string nor a function.
      */
-    searchTrack(query: string | ((arg0: MediaContent) => boolean)): SearchResult[];
+    searchTrack(query: string | ((content: MediaContent) => boolean)): SearchResult[];
     /**
      * Clears the entire playlist and stops playback.
      */
@@ -246,71 +304,6 @@ declare class TinyMediaPlayer extends EventEmitter<any> {
      * @returns {Promise<void>} A promise that resolves when the destruction sequence is complete.
      */
     destroy(): Promise<void>;
-    #private;
-}
-import { EventEmitter } from 'events';
-/**
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
- * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
- * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
- * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
- * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
- * @typedef {import('../basics/mediaContent.mjs').UnknownArtistGetter} UnknownArtistGetter
- */
-/**
- * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
- */
-/**
- * Configuration options for initializing the UniversalMediaPlayer.
- * @typedef {Object} TinyMediaPlayerOptions
- * @property {boolean} [persistVolume=false] - Whether to automatically save the volume in localStorage.
- * @property {string} [volumeStorageKey='universal_media_player_volume'] - The specific key name used for localStorage cache.
- */
-/**
- * Interface definition for a Media Provider Adapter.
- * All specific API wrappers must extend and implement this class.
- * @abstract
- */
-declare class BaseMediaAdapter {
-    /**
-     * Determines if this adapter can play the provided content.
-     * @param {MediaContent} content - The media content to evaluate.
-     * @returns {boolean} True if the adapter can handle the content, false otherwise.
-     */
-    canHandle(content: MediaContent): boolean;
-    /**
-     * Starts or resumes playback of the provided content.
-     * @param {MediaContent} content - The media content to play.
-     * @returns {Promise<void>}
-     */
-    play(content: MediaContent): Promise<void>;
-    /**
-     * Pauses the current playback.
-     * @returns {Promise<void>}
-     */
-    pause(): Promise<void>;
-    /**
-     * Stops the playback completely and resets the internal platform state.
-     * @returns {Promise<void>}
-     */
-    stop(): Promise<void>;
-    /**
-     * Seeks to a specific time in the media timeline.
-     * @param {number} timeMs - The target time in milliseconds.
-     * @returns {Promise<void>}
-     */
-    seek(timeMs: number): Promise<void>;
-    /**
-     * Retrieves the current playback time from the underlying API.
-     * @returns {number} The current time in milliseconds.
-     */
-    getCurrentTime(): number;
-    /**
-     * Sets the playback volume for the underlying API.
-     * @param {number} volume - The volume level from 0.0 to 1.0.
-     * @returns {void}
-     */
-    setVolume(volume: number): void;
 }
+export default TinyMediaPlayer;
 //# sourceMappingURL=TinyMediaPlayer.d.mts.map

package/dist/v1/libs/TinyMediaPlayer.mjs

@@ -3,15 +3,17 @@ import { getMediaContentBase, getMediaContentMetadata, parseMediaMetadata, valMe
 import { createCheckDestroyed } from './utils.mjs';
 const checkDestroy = createCheckDestroyed('TinyMediaPlayer');
 /**
- * @typedef {import('../basics/mediaContent.mjs').MediaContent} MediaContent
+ * @typedef {import('../basics/mediaContent.mjs').PictureDataType} PictureDataType
+ * @typedef {import('../basics/mediaContent.mjs').MediaContent<PictureDataType>} MediaContent
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
- * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
+ * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata<PictureDataType>} MediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').ParseMediaContentMetadata} ParseMediaContentMetadata
  * @typedef {import('../basics/mediaContent.mjs').LoadingMediaProgress} LoadingMediaProgress
  * @typedef {import('../basics/mediaContent.mjs').MediaLoadingErrorData} MediaLoadingErrorData
  * @typedef {import('../basics/mediaContent.mjs').UnknownArtistGetter} UnknownArtistGetter
  */
 /**
+ * The loop configuration modes.
  * @typedef {'NONE' | 'TRACK' | 'PLAYLIST'} LoopModeType
  */
 /**
@@ -600,7 +602,7 @@ class TinyMediaPlayer extends EventEmitter {
     }
     /**
      * Searches the playlist for tracks matching a string query or a custom evaluation function.
-     * @param {string | function(MediaContent): boolean} query - The search string (checked against title, artist, album) or a callback returning a boolean.
+     * @param {string | ((content: MediaContent) => boolean)} query - The search string (checked against title, artist, album) or a callback returning a boolean.
      * @returns {SearchResult[]} An array containing the matched tracks and their corresponding indices.
      * @throws {TypeError} If the query is neither a string nor a function.
      */