tiny-essentials 1.28.19 → 1.29.0

package/dist/v1/libs/html/scroll/TinySmartScroller.d.mts

@@ -1,4 +1,3 @@
-import { EventEmitter } from 'events';
 import TinyHtml from '../TinyHtml.mjs';
 import * as TinyCollision from '../../../basics/collision.mjs';
 export type NodeSizes = {
@@ -19,6 +18,24 @@ export type NodeSizesEvent = (elem: Element, sizes: {
     now: number;
 }) => NodeSizes | undefined;
 export type ScrollListenersFunc = (payload: any) => void;
+export type TinySmartScrollerEvents = {
+    /**
+     * - Emitted when the scroll boundary state changes.
+     */
+    onScrollBoundary: (data: any) => void;
+    /**
+     * - Emitted when the custom scroll boundary state changes.
+     */
+    onExtraScrollBoundary: (data: any) => void;
+    /**
+     * - Emitted when an auto-scroll occurs.
+     */
+    onAutoScroll: (data: any) => void;
+    /**
+     * - Emitted when auto-scroll is paused.
+     */
+    onScrollPause: (data: any) => void;
+};
 /**
  * Represents the dimensions of a DOM element.
  *
@@ -42,6 +59,16 @@ export type ScrollListenersFunc = (payload: any) => void;
  * @param {any} payload - The data payload passed when the scroll event is triggered. The type may vary depending on the event.
  * @returns {void}
  */
+/**
+ * Event map for {@link TinySmartScroller}.
+ * @typedef {Object} TinySmartScrollerEvents
+ * @property {(data: any) => void} onScrollBoundary - Emitted when the scroll boundary state changes.
+ * @property {(data: any) => void} onExtraScrollBoundary - Emitted when the custom scroll boundary state changes.
+ * @property {(data: any) => void} onAutoScroll - Emitted when an auto-scroll occurs.
+ * @property {(data: any) => void} onScrollPause - Emitted when auto-scroll is paused.
+ */
+/** @type {new (...args: any[]) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinySmartScrollerEvents>} */
+declare const TypedEventEmitter: new (...args: any[]) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinySmartScrollerEvents>;
 /**
  * TinySmartScroller is a utility class designed to enhance and manage scroll behaviors within containers or the window.
  *
@@ -60,7 +87,7 @@ export type ScrollListenersFunc = (payload: any) => void;
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
  * @template {Element|Window} HTMLTarget
  */
-declare class TinySmartScroller<HTMLTarget extends Element | Window> extends EventEmitter {
+declare class TinySmartScroller<HTMLTarget extends Element | Window> extends TypedEventEmitter {
     #private;
     static Utils: {
         areElsCollTop: (rect1: TinyCollision.ObjRect, rect2: TinyCollision.ObjRect) => boolean;

package/dist/v1/libs/html/scroll/TinySmartScroller.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinySmartScroller.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/scroll/TinySmartScroller.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"TinySmartScroller.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/html/scroll/TinySmartScroller.mjs"],"names":[],"mappings":"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"}

package/dist/v1/libs/html/scroll/TinySmartScroller.mjs

@@ -26,6 +26,16 @@ const checkDestroy = createCheckDestroyed('TinySmartScroller');
  * @param {any} payload - The data payload passed when the scroll event is triggered. The type may vary depending on the event.
  * @returns {void}
  */
+/**
+ * Event map for {@link TinySmartScroller}.
+ * @typedef {Object} TinySmartScrollerEvents
+ * @property {(data: any) => void} onScrollBoundary - Emitted when the scroll boundary state changes.
+ * @property {(data: any) => void} onExtraScrollBoundary - Emitted when the custom scroll boundary state changes.
+ * @property {(data: any) => void} onAutoScroll - Emitted when an auto-scroll occurs.
+ * @property {(data: any) => void} onScrollPause - Emitted when auto-scroll is paused.
+ */
+/** @type {new (...args: any[]) => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinySmartScrollerEvents>} */
+const TypedEventEmitter = /** @type {any} */ (EventEmitter);
 /**
  * TinySmartScroller is a utility class designed to enhance and manage scroll behaviors within containers or the window.
  *
@@ -44,7 +54,7 @@ const checkDestroy = createCheckDestroyed('TinySmartScroller');
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
  * @template {Element|Window} HTMLTarget
  */
-class TinySmartScroller extends EventEmitter {
+class TinySmartScroller extends TypedEventEmitter {
     static Utils = { ...TinyCollision, TinyHtml };
     /** @type {WeakMap<Element, NodeSizes>} */
     #oldSizes = new WeakMap();

package/dist/v1/libs/math/TinyAdvancedRaffle.cjs

@@ -107,6 +107,18 @@ const checkDestroy = tools.createCheckDestroyed('TinyAdvancedRaffle');
  * @param {any} event - Metadata about the emitted event.
  */
 
+/**
+ * Event map for {@link TinyAdvancedRaffle}.
+ * @typedef {Object} TinyAdvancedRaffleEvents
+ * @property {(item: ItemData) => void} itemAdded - Emitted when an item is added.
+ * @property {(id: string) => void} itemRemoved - Emitted when an item is removed.
+ * @property {(data: { id: string, weight: number }) => void} weightChanged - Emitted when an item's base weight changes.
+ * @property {(result: DrawOne) => void} draw - Emitted after a successful draw.
+ */
+
+/** @type {new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyAdvancedRaffleEvents>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * TinyAdvancedRaffle — A high-performance, fully customizable raffle system.
  *
@@ -121,7 +133,7 @@ const checkDestroy = tools.createCheckDestroyed('TinyAdvancedRaffle');
  *
  * @class
  */
-class TinyAdvancedRaffle extends events.EventEmitter {
+class TinyAdvancedRaffle extends TypedEventEmitter {
   /**
    * Whether this instance has been destroyed.
    * @type {boolean}

package/dist/v1/libs/math/TinyAdvancedRaffle.d.mts

@@ -1,4 +1,3 @@
-import { EventEmitter } from 'events';
 export type Normalization = 'relative' | 'softmax';
 export type RngGenerator = () => number;
 export type TempModifier = {
@@ -115,6 +114,27 @@ export type DrawOne = {
     prob: number;
 };
 export type handler = (payload: any, event: any) => any;
+export type TinyAdvancedRaffleEvents = {
+    /**
+     * - Emitted when an item is added.
+     */
+    itemAdded: (item: ItemData) => void;
+    /**
+     * - Emitted when an item is removed.
+     */
+    itemRemoved: (id: string) => void;
+    /**
+     * - Emitted when an item's base weight changes.
+     */
+    weightChanged: (data: {
+        id: string;
+        weight: number;
+    }) => void;
+    /**
+     * - Emitted after a successful draw.
+     */
+    draw: (result: DrawOne) => void;
+};
 /**
  * Defines the available normalization strategies for probability weight calculations.
  * @typedef {'relative' | 'softmax'} Normalization
@@ -203,6 +223,16 @@ export type handler = (payload: any, event: any) => any;
  * @param {any} payload - The data sent by the emitter.
  * @param {any} event - Metadata about the emitted event.
  */
+/**
+ * Event map for {@link TinyAdvancedRaffle}.
+ * @typedef {Object} TinyAdvancedRaffleEvents
+ * @property {(item: ItemData) => void} itemAdded - Emitted when an item is added.
+ * @property {(id: string) => void} itemRemoved - Emitted when an item is removed.
+ * @property {(data: { id: string, weight: number }) => void} weightChanged - Emitted when an item's base weight changes.
+ * @property {(result: DrawOne) => void} draw - Emitted after a successful draw.
+ */
+/** @type {new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyAdvancedRaffleEvents>} */
+declare const TypedEventEmitter: new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyAdvancedRaffleEvents>;
 /**
  * TinyAdvancedRaffle — A high-performance, fully customizable raffle system.
  *
@@ -217,7 +247,7 @@ export type handler = (payload: any, event: any) => any;
  *
  * @class
  */
-declare class TinyAdvancedRaffle extends EventEmitter {
+declare class TinyAdvancedRaffle extends TypedEventEmitter {
     #private;
     /**
      * Indicates whether this instance has been destroyed.

package/dist/v1/libs/math/TinyAdvancedRaffle.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyAdvancedRaffle.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/math/TinyAdvancedRaffle.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"TinyAdvancedRaffle.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/math/TinyAdvancedRaffle.mjs"],"names":[],"mappings":"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"}

package/dist/v1/libs/math/TinyAdvancedRaffle.mjs

@@ -89,6 +89,16 @@ const checkDestroy = createCheckDestroyed('TinyAdvancedRaffle');
  * @param {any} payload - The data sent by the emitter.
  * @param {any} event - Metadata about the emitted event.
  */
+/**
+ * Event map for {@link TinyAdvancedRaffle}.
+ * @typedef {Object} TinyAdvancedRaffleEvents
+ * @property {(item: ItemData) => void} itemAdded - Emitted when an item is added.
+ * @property {(id: string) => void} itemRemoved - Emitted when an item is removed.
+ * @property {(data: { id: string, weight: number }) => void} weightChanged - Emitted when an item's base weight changes.
+ * @property {(result: DrawOne) => void} draw - Emitted after a successful draw.
+ */
+/** @type {new () => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyAdvancedRaffleEvents>} */
+const TypedEventEmitter = /** @type {any} */ (EventEmitter);
 /**
  * TinyAdvancedRaffle — A high-performance, fully customizable raffle system.
  *
@@ -103,7 +113,7 @@ const checkDestroy = createCheckDestroyed('TinyAdvancedRaffle');
  *
  * @class
  */
-class TinyAdvancedRaffle extends EventEmitter {
+class TinyAdvancedRaffle extends TypedEventEmitter {
     /**
      * Whether this instance has been destroyed.
      * @type {boolean}

package/dist/v1/libs/math/TinyTimeout.cjs

@@ -145,20 +145,6 @@ class TinyTimeout {
     return setTimeout(callback, typeof limit === 'number' ? Math.min(delay, limit) : delay);
   }
 
-  /**
-   * Waits until a provided function returns `true`, checking repeatedly at the defined interval.
-   * Useful for polling asynchronous conditions.
-   *
-   * @param {() => boolean} getValue - A function that returns `true` when the condition is met.
-   * @param {number} [checkInterval=100] - How often (in ms) to check the condition.
-   * @returns {Promise<void>} Resolves when the condition is met.
-   * @throws {TypeError} If arguments are invalid.
-   * @deprecated Script migrated to `src/v1/basics/promiseUtils.mjs`.
-   */
-  static waitForTrue(getValue, checkInterval = 100) {
-    return promiseUtils.waitForTrue(getValue, checkInterval);
-  }
-
   /**
    * Instance version of `waitForTrue`, which defaults to using the instance's
    * cooldownWatcherTime if not explicitly provided.

package/dist/v1/libs/math/TinyTimeout.d.mts

@@ -59,17 +59,6 @@ declare class TinyTimeout {
      * @throws {Error} Throws if the instance has been destroyed or arguments are invalid.
      */
     set(id: string, callback: Function, value: number, limit?: number | null): number;
-    /**
-     * Waits until a provided function returns `true`, checking repeatedly at the defined interval.
-     * Useful for polling asynchronous conditions.
-     *
-     * @param {() => boolean} getValue - A function that returns `true` when the condition is met.
-     * @param {number} [checkInterval=100] - How often (in ms) to check the condition.
-     * @returns {Promise<void>} Resolves when the condition is met.
-     * @throws {TypeError} If arguments are invalid.
-     * @deprecated Script migrated to `src/v1/basics/promiseUtils.mjs`.
-     */
-    static waitForTrue(getValue: () => boolean, checkInterval?: number): Promise<void>;
     /**
      * Instance version of `waitForTrue`, which defaults to using the instance's
      * cooldownWatcherTime if not explicitly provided.

package/dist/v1/libs/math/TinyTimeout.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"TinyTimeout.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/math/TinyTimeout.mjs"],"names":[],"mappings":"AAKA;;;GAGG;AACH,cAAM,WAAW;;IAqBf;;;;;;OAMG;IACH,YAAY,EAAE,mBAA0B,EAAE,qBAA6B,EAAE,AAJtE,CAGF,EAFE;QAAyB,mBAAmB,AAA5C,CACA,EADQ,MAAM,CACd;QAA0B,qBAAqB,AAA/C,CACF,EADU,OAAO,CACjB;KAC6E,EAQ7E;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;;OAIG;IACH,wBAAwB,IAFX,OAAO,CAKnB;IAED;;;;OAIG;IACH,sBAAsB,IAFT,MAAM,CAKlB;IAED;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAFnB,OAEmB,QAI7B;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAFjB,MAEiB,QAc3B;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,EAPK,MAOL,EAAE,QAAQ,UAAA,EAAE,KAAK,EALZ,MAKY,EAAE,KAAK,AAJ3B,CACA,EADQ,MAAM,GAAC,IAImB,GAHxB,MAAM,CAyBlB;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EANhB,MAAM,OAMU,EAAE,aAAa,AALvC,CACA,EADQ,MAKqC,GAJnC,OAAO,CAAC,IAAI,CAAC,CAMzB;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EALT,MAAM,OAKG,EAAE,aAAa,AAJhC,CACA,EADQ,MAAM,GAAC,IAIuB,GAH5B,OAAO,CAAC,IAAI,CAAC,CAWzB;IAED;;;OAGG;IACH,OAAO,SAMN;CACF;eAEc,WAAW"}
+{"version":3,"file":"TinyTimeout.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/math/TinyTimeout.mjs"],"names":[],"mappings":"AAKA;;;GAGG;AACH,cAAM,WAAW;;IAqBf;;;;;;OAMG;IACH,YAAY,EAAE,mBAA0B,EAAE,qBAA6B,EAAE,AAJtE,CAGF,EAFE;QAAyB,mBAAmB,AAA5C,CACA,EADQ,MAAM,CACd;QAA0B,qBAAqB,AAA/C,CACF,EADU,OAAO,CACjB;KAC6E,EAQ7E;IAED;;;;OAIG;IACH,WAAW,IAFE,OAAO,CAInB;IAED;;;;OAIG;IACH,wBAAwB,IAFX,OAAO,CAKnB;IAED;;;;OAIG;IACH,sBAAsB,IAFT,MAAM,CAKlB;IAED;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAFnB,OAEmB,QAI7B;IAED;;;;;OAKG;IACH,sBAAsB,CAAC,KAAK,EAFjB,MAEiB,QAc3B;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,EAPK,MAOL,EAAE,QAAQ,UAAA,EAAE,KAAK,EALZ,MAKY,EAAE,KAAK,AAJ3B,CACA,EADQ,MAAM,GAAC,IAImB,GAHxB,MAAM,CAyBlB;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EALT,MAAM,OAKG,EAAE,aAAa,AAJhC,CACA,EADQ,MAAM,GAAC,IAIuB,GAH5B,OAAO,CAAC,IAAI,CAAC,CAWzB;IAED;;;OAGG;IACH,OAAO,SAMN;CACF;eAEc,WAAW"}

package/dist/v1/libs/math/TinyTimeout.mjs

@@ -129,19 +129,6 @@ class TinyTimeout {
         entry.now++;
         return setTimeout(callback, typeof limit === 'number' ? Math.min(delay, limit) : delay);
     }
-    /**
-     * Waits until a provided function returns `true`, checking repeatedly at the defined interval.
-     * Useful for polling asynchronous conditions.
-     *
-     * @param {() => boolean} getValue - A function that returns `true` when the condition is met.
-     * @param {number} [checkInterval=100] - How often (in ms) to check the condition.
-     * @returns {Promise<void>} Resolves when the condition is met.
-     * @throws {TypeError} If arguments are invalid.
-     * @deprecated Script migrated to `src/v1/basics/promiseUtils.mjs`.
-     */
-    static waitForTrue(getValue, checkInterval = 100) {
-        return waitForTrue(getValue, checkInterval);
-    }
     /**
      * Instance version of `waitForTrue`, which defaults to using the instance's
      * cooldownWatcherTime if not explicitly provided.

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

@@ -32,12 +32,36 @@ var tools = require('../../utils/tools.cjs');
 
 const checkDestroy = tools.createCheckDestroyed('BaseMediaAdapter');
 
+/**
+ * Event map for {@link BaseMediaAdapter}.
+ *
+ * Adapters bridge third-party players, so the event map is kept open
+ * (`Record<string, ...>`) to allow forwarding arbitrary player events while
+ * still providing autocomplete for the well-known ones.
+ *
+ * @typedef {{
+ *   destroyed: () => void,
+ *   volumeChange: (volume: number) => void,
+ *   seek: (time: number) => void,
+ *   play: () => void,
+ *   pause: () => void,
+ *   ended: () => void,
+ *   timeupdate: (data: ContentTimeData) => void,
+ *   onReady: () => void,
+ *   error: (error: any) => void,
+ *   onStateChange: (event: any) => void,
+ * } & Record<string, (...args: any[]) => void>} BaseMediaAdapterEvents
+ */
+
+/** @type {new () => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<BaseMediaAdapterEvents>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * Interface definition for a Media Provider Adapter.
  * All specific API wrappers must extend and implement this class.
  * @abstract
  */
-class BaseMediaAdapter extends events.EventEmitter {
+class BaseMediaAdapter extends TypedEventEmitter {
   constructor() {
     if (new.target === BaseMediaAdapter) {
       throw new Error('BaseMediaAdapter is an abstract class and cannot be instantiated directly.');

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

@@ -1,4 +1,3 @@
-import { EventEmitter } from 'events';
 export type PictureDataType = import('../../../basics/mediaContent.mjs').PictureDataType;
 export type MediaContent = import('../../../basics/mediaContent.mjs').MediaContent<PictureDataType>;
 export type ContentTimeData = {
@@ -57,12 +56,46 @@ export type ContentData = {
      */
     url?: string;
 };
+export type BaseMediaAdapterEvents = {
+    destroyed: () => void;
+    volumeChange: (volume: number) => void;
+    seek: (time: number) => void;
+    play: () => void;
+    pause: () => void;
+    ended: () => void;
+    timeupdate: (data: ContentTimeData) => void;
+    onReady: () => void;
+    error: (error: any) => void;
+    onStateChange: (event: any) => void;
+} & Record<string, (...args: any[]) => void>;
+/**
+ * Event map for {@link BaseMediaAdapter}.
+ *
+ * Adapters bridge third-party players, so the event map is kept open
+ * (`Record<string, ...>`) to allow forwarding arbitrary player events while
+ * still providing autocomplete for the well-known ones.
+ *
+ * @typedef {{
+ *   destroyed: () => void,
+ *   volumeChange: (volume: number) => void,
+ *   seek: (time: number) => void,
+ *   play: () => void,
+ *   pause: () => void,
+ *   ended: () => void,
+ *   timeupdate: (data: ContentTimeData) => void,
+ *   onReady: () => void,
+ *   error: (error: any) => void,
+ *   onStateChange: (event: any) => void,
+ * } & Record<string, (...args: any[]) => void>} BaseMediaAdapterEvents
+ */
+/** @type {new () => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<BaseMediaAdapterEvents>} */
+declare const TypedEventEmitter: new () => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<BaseMediaAdapterEvents>;
 /**
  * Interface definition for a Media Provider Adapter.
  * All specific API wrappers must extend and implement this class.
  * @abstract
  */
-declare class BaseMediaAdapter extends EventEmitter {
+declare class BaseMediaAdapter extends TypedEventEmitter {
     #private;
     constructor();
     get destroyed(): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/media/TinyMediaPlayer/index.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAInC,YAAsE,eAAe,GAA3E,OAAO,kCAAkC,EAAE,eAAe,CAAiB;AACrF,YAAoF,YAAY,GAAtF,OAAO,kCAAkC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAc;AAIhG,YAAkB,eAAe,GACjC;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,OAAO,EAAf,MAAM,CACjB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,kBAAkB,EAA1B,MAAM,CACnB;CAAA,CAAA;AAIE,YAAkB,WAAW,GAC7B;;;;IAAmB,EAAE,EAAV,MAAM,CACjB;;;;IAAmB,SAAS,EAAjB,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAmB,QAAQ,EAAhB,MAAM,CACjB;;;;IAAmB,QAAQ,EAAhB,MAAM,CACjB;;;;IAAoB,UAAU,AAA9B,CACA,EADW,MAAM,CACjB;;;;IAAoB,WAAW,AAA/B,CACA,EADW,MAAM,CACjB;;;;IAAoB,MAAM,AAA1B,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACF,EADa,MAAM,CACnB;CAAA,CAAA;AAID;;;;GAIG;AACH,cAAM,gBAAiB,SAAQ,YAAY;;IACzC,cAKC;IAKD,IAAI,SAAS,YAEZ;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAJnB,MAImB,GAHjB,MAAM,CAQlB;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAHb,YAGa,GAFX,OAAO,CAInB;IAED;;;OAGG;IACH,OAAO,IAFM,OAAO,CAKnB;IAED;;;OAGG;IACH,QAAQ,IAFK,OAAO,CAKnB;IAED;;;OAGG;IACH,OAAO,IAFM,OAAO,CAKnB;IAED;;;OAGG;IACG,WAAW,IAFJ,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAHN,YAGM,GAFJ,OAAO,CAKnB;IAED;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAHP,YAGO,GAFL,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACG,KAAK,IAFE,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACG,IAAI,IAFG,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAHN,MAGM,GAFJ,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACH,OAAO,IAFM,OAAO,GAAC,IAAI,CAKxB;IAED;;;OAGG;IACG,IAAI,IAFG,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACG,MAAM,IAFC,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACH,cAAc,IAFD,MAAM,CAKlB;IAED;;;OAGG;IACH,gBAAgB,IAFH,MAAM,CAKlB;IAED;;;OAGG;IACH,gBAAgB,IAFH,MAAM,CAKlB;IAED;;;OAGG;IACH,qBAAqB,IAFR,MAAM,CAKlB;IAED;;;OAGG;IACH,WAAW,IAFE,eAAe,CAK3B;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAHL,MAGK,GAFH,IAAI,CAKhB;IAED;;;OAGG;IACH,SAAS,IAFI,MAAM,CAKlB;IAED;;;;OAIG;IACG,cAAc,IAFP,OAAO,CAAC,WAAW,CAAC,CAKhC;IAED;;;OAGG;IACH,OAAO,IAFM,IAAI,CAOhB;CACF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/media/TinyMediaPlayer/index.mjs"],"names":[],"mappings":"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"}

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

@@ -25,12 +25,34 @@ import { createCheckDestroyed } from '../../utils/tools.mjs';
  * @property {string} [url] - The URL to access the content (optional).
  */
 const checkDestroy = createCheckDestroyed('BaseMediaAdapter');
+/**
+ * Event map for {@link BaseMediaAdapter}.
+ *
+ * Adapters bridge third-party players, so the event map is kept open
+ * (`Record<string, ...>`) to allow forwarding arbitrary player events while
+ * still providing autocomplete for the well-known ones.
+ *
+ * @typedef {{
+ *   destroyed: () => void,
+ *   volumeChange: (volume: number) => void,
+ *   seek: (time: number) => void,
+ *   play: () => void,
+ *   pause: () => void,
+ *   ended: () => void,
+ *   timeupdate: (data: ContentTimeData) => void,
+ *   onReady: () => void,
+ *   error: (error: any) => void,
+ *   onStateChange: (event: any) => void,
+ * } & Record<string, (...args: any[]) => void>} BaseMediaAdapterEvents
+ */
+/** @type {new () => import('../../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<BaseMediaAdapterEvents>} */
+const TypedEventEmitter = /** @type {any} */ (EventEmitter);
 /**
  * Interface definition for a Media Provider Adapter.
  * All specific API wrappers must extend and implement this class.
  * @abstract
  */
-class BaseMediaAdapter extends EventEmitter {
+class BaseMediaAdapter extends TypedEventEmitter {
     constructor() {
         if (new.target === BaseMediaAdapter) {
             throw new Error('BaseMediaAdapter is an abstract class and cannot be instantiated directly.');

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

@@ -36,7 +36,7 @@ const checkDestroy = tools.createCheckDestroyed('TinyMediaPlayer');
  * @property {boolean} [smoothStopVolume=false] - If true, volume fades smoothly to zero when stopping.
  * @property {boolean} [debugMode=false] - Whether to enable internal debug logging.
  * @property {boolean} [useLogColors=false] - Whether to enable log color support.
- * @property {Console} [logger=console] - A custom logger object (must implement console methods).
+ * @property {Partial<Console>} [logger=console] - A custom logger object (must implement console methods).
  */
 
 /**
@@ -284,7 +284,7 @@ class TinyMediaPlayer extends TinyDebugger {
 
     // Debug Configuration
     super({
-      id: '[_blue_TinyMediaPlayer_reset_] :debug:',
+      id: '[_main_class_TinyMediaPlayer_reset_]',
       logger: options.logger ?? console,
       debugMode: options.debugMode ?? false,
       useLogColors: options.useLogColors ?? false,

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

@@ -43,7 +43,7 @@ export type TinyMediaPlayerOptions = {
     /**
      * - A custom logger object (must implement console methods).
      */
-    logger?: Console;
+    logger?: Partial<Console>;
 };
 export type SearchResult = {
     /**
@@ -81,7 +81,7 @@ export type SearchResult = {
  * @property {boolean} [smoothStopVolume=false] - If true, volume fades smoothly to zero when stopping.
  * @property {boolean} [debugMode=false] - Whether to enable internal debug logging.
  * @property {boolean} [useLogColors=false] - Whether to enable log color support.
- * @property {Console} [logger=console] - A custom logger object (must implement console methods).
+ * @property {Partial<Console>} [logger=console] - A custom logger object (must implement console methods).
  */
 /**
  * Represents a search match containing the media object and its exact playlist index.

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

@@ -1 +1 @@
-{"version":3,"file":"TinyMediaPlayer.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/media/TinyMediaPlayer.mjs"],"names":[],"mappings":"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"}
+{"version":3,"file":"TinyMediaPlayer.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/media/TinyMediaPlayer.mjs"],"names":[],"mappings":"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"}

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

@@ -30,7 +30,7 @@ const checkDestroy = createCheckDestroyed('TinyMediaPlayer');
  * @property {boolean} [smoothStopVolume=false] - If true, volume fades smoothly to zero when stopping.
  * @property {boolean} [debugMode=false] - Whether to enable internal debug logging.
  * @property {boolean} [useLogColors=false] - Whether to enable log color support.
- * @property {Console} [logger=console] - A custom logger object (must implement console methods).
+ * @property {Partial<Console>} [logger=console] - A custom logger object (must implement console methods).
  */
 /**
  * Represents a search match containing the media object and its exact playlist index.
@@ -227,7 +227,7 @@ class TinyMediaPlayer extends TinyDebugger {
         }
         // Debug Configuration
         super({
-            id: '[_blue_TinyMediaPlayer_reset_] :debug:',
+            id: '[_main_class_TinyMediaPlayer_reset_]',
             logger: options.logger ?? console,
             debugMode: options.debugMode ?? false,
             useLogColors: options.useLogColors ?? false,

package/dist/v1/libs/media/TinyRadioFm.cjs

@@ -137,11 +137,29 @@ const checkDestroy = tools.createCheckDestroyed('TinyRadioFm');
 
 //////////////////////////////////////////////////////////////////
 
+/**
+ * Event map for {@link TinyRadioFm}.
+ * @typedef {Object} TinyRadioFmEvents
+ * @property {(data: { seed: number }) => void} seedChanged - Emitted when the seed changes.
+ * @property {(data: { config: RadioConfig }) => void} configChanged - Emitted when the configuration changes.
+ * @property {(data: { type: string, data: MediaContent }) => void} contentAdded - Emitted when content is added.
+ * @property {(data: { id: string }) => void} contentRemoved - Emitted when content is removed.
+ * @property {(task: ScheduledTask) => void} taskScheduled - Emitted when a task is scheduled.
+ * @property {(task: ScheduledTask) => void} taskExecuted - Emitted when a scheduled task is executed.
+ * @property {(data: { contentId: string }) => void} customPositionExpired - Emitted when a custom position expires.
+ * @property {(data: { targetDate: number, limit: number, resultCount: number }) => void} timelineQueried - Emitted after a timeline query.
+ * @property {(data: { data: TinyRadioFmImport }) => void} stateImported - Emitted after a state import.
+ * @property {(data: { timestamp: number }) => void} destroyed - Emitted when the instance is destroyed.
+ */
+
+/** @type {new (initialData?: TinyRadioFmImport|null, seed?: number) => import('../../jsdoc/EventEmitter.mjs').ICustomEventEmitter<TinyRadioFmEvents>} */
+const TypedEventEmitter = /** @type {any} */ (events.EventEmitter);
+
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
  * @beta
  */
-class TinyRadioFm extends events.EventEmitter {
+class TinyRadioFm extends TypedEventEmitter {
   /**
    * A Static Factory Method that prepares a MediaContent object by
    * extracting metadata from an audio source.