tiny-essentials 1.27.1 → 1.28.0

package/dist/v1/libs/TinyNewWinEvents.mjs

@@ -1,4 +1,4 @@
-import TinyEvents from './TinyEvents.mjs';
+import { EventEmitter } from 'events';
 /**
  * Stores polling intervals associated with window references.
  * Used to detect when the window is closed.
@@ -21,170 +21,7 @@ const pollClosedInterval = new WeakMap();
  *
  * @class
  */
-class TinyNewWinEvents {
-    #events = new TinyEvents();
-    /**
-     * Enables or disables throwing an error when the maximum number of listeners is exceeded.
-     *
-     * @param {boolean} shouldThrow - If true, an error will be thrown when the max is exceeded.
-     */
-    setThrowOnMaxListeners(shouldThrow) {
-        return this.#events.setThrowOnMaxListeners(shouldThrow);
-    }
-    /**
-     * Checks whether an error will be thrown when the max listener limit is exceeded.
-     *
-     * @returns {boolean} True if an error will be thrown, false if only a warning is shown.
-     */
-    getThrowOnMaxListeners() {
-        return this.#events.getThrowOnMaxListeners();
-    }
-    /////////////////////////////////////////////////////////////
-    /**
-     * Adds a listener to the beginning of the listeners array for the specified event.
-     *
-     * @param {string|string[]} event - Event name.
-     * @param {handler} handler - The callback function.
-     */
-    prependListener(event, handler) {
-        return this.#events.prependListener(event, handler);
-    }
-    /**
-     * Adds a one-time listener to the beginning of the listeners array for the specified event.
-     *
-     * @param {string|string[]} event - Event name.
-     * @param {handler} handler - The callback function.
-     * @returns {handler[]} - The wrapped handler used internally.
-     */
-    prependListenerOnce(event, handler) {
-        return this.#events.prependListenerOnce(event, handler);
-    }
-    //////////////////////////////////////////////////////////////////////
-    /**
-     * Adds a event listener.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - Callback function to be called when event fires.
-     */
-    appendListener(event, handler) {
-        return this.#events.appendListener(event, handler);
-    }
-    /**
-     * Registers an event listener that runs only once, then is removed.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - The callback function to run on event.
-     * @returns {handler[]} - The wrapped version of the handler.
-     */
-    appendListenerOnce(event, handler) {
-        return this.#events.appendListenerOnce(event, handler);
-    }
-    /**
-     * Adds a event listener.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - Callback function to be called when event fires.
-     */
-    on(event, handler) {
-        return this.#events.on(event, handler);
-    }
-    /**
-     * Registers an event listener that runs only once, then is removed.
-     *
-     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-     * @param {handler} handler - The callback function to run on event.
-     * @returns {handler[]} - The wrapped version of the handler.
-     */
-    once(event, handler) {
-        return this.#events.once(event, handler);
-    }
-    ////////////////////////////////////////////////////////////////////
-    /**
-     * Removes a previously registered event listener.
-     *
-     * @param {string|string[]} event - The name of the event to remove the handler from.
-     * @param {handler} handler - The specific callback function to remove.
-     */
-    off(event, handler) {
-        return this.#events.off(event, handler);
-    }
-    /**
-     * Removes all event listeners of a specific type from the element.
-     *
-     * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
-     */
-    offAll(event) {
-        return this.#events.offAll(event);
-    }
-    /**
-     * Removes all event listeners of all types from the element.
-     */
-    offAllTypes() {
-        return this.#events.offAllTypes();
-    }
-    ////////////////////////////////////////////////////////////
-    /**
-     * Returns the number of listeners for a given event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {number} Number of listeners for the event.
-     */
-    listenerCount(event) {
-        return this.#events.listenerCount(event);
-    }
-    /**
-     * Returns a copy of the array of listeners for the specified event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {handler[]} Array of listener functions.
-     */
-    listeners(event) {
-        return this.#events.listeners(event);
-    }
-    /**
-     * Returns a copy of the array of listeners for the specified event.
-     *
-     * @param {string} event - The name of the event.
-     * @returns {handler[]} Array of listener functions.
-     */
-    onceListeners(event) {
-        return this.#events.onceListeners(event);
-    }
-    /**
-     * Returns a copy of the internal listeners array for the specified event,
-     * including wrapper functions like those used by `.once()`.
-     * @param {string | symbol} event - The event name.
-     * @returns {handler[]} An array of raw listener functions.
-     */
-    allListeners(event) {
-        return this.#events.allListeners(event);
-    }
-    /**
-     * Returns an array of event names for which there are registered listeners.
-     *
-     * @returns {string[]} Array of registered event names.
-     */
-    eventNames() {
-        return this.#events.eventNames();
-    }
-    //////////////////////////////////////////////////////
-    /**
-     * Sets the maximum number of listeners per event before a warning is shown.
-     *
-     * @param {number} n - The maximum number of listeners.
-     */
-    setMaxListeners(n) {
-        return this.#events.setMaxListeners(n);
-    }
-    /**
-     * Gets the maximum number of listeners allowed per event.
-     *
-     * @returns {number} The maximum number of listeners.
-     */
-    getMaxListeners() {
-        return this.#events.getMaxListeners();
-    }
-    ///////////////////////////////////////////////////
+class TinyNewWinEvents extends EventEmitter {
     /** @type {Window|null} Reference to the opened or parent window */
     #windowRef;
     /** @type {string} Expected origin for postMessage communication */
@@ -249,6 +86,7 @@ class TinyNewWinEvents {
      * @throws {Error} If the window reference is invalid or already being tracked.
      */
     constructor({ targetOrigin, url, name, features } = {}) {
+        super();
         if (typeof name === 'string' && name === '_blank')
             throw new Error('TinyNewWinEvents: The window name "_blank" is not supported. Please use a custom name to allow tracking.');
         if (typeof targetOrigin !== 'undefined' && typeof targetOrigin !== 'string')
@@ -303,7 +141,7 @@ class TinyNewWinEvents {
             return;
         }
         if (type === this.#routeEventName)
-            this.#events.emit(route, payload, event);
+            this.emit(`win:${route}`, payload, event);
     }
     /**
      * Sends all pending messages queued before handshake completion.
@@ -315,7 +153,7 @@ class TinyNewWinEvents {
             const data = this.#pendingQueue.shift();
             if (data) {
                 const { route, payload } = data;
-                this.emit(route, payload);
+                this.winEmit(route, payload);
             }
         }
     }
@@ -353,7 +191,7 @@ class TinyNewWinEvents {
      * @throws {Error} If the instance is already destroyed.
      * @returns {void}
      */
-    emit(route, payload) {
+    winEmit(route, payload) {
         if (typeof route !== 'string')
             throw new TypeError('Event name must be a string.');
         if (this.isDestroyed())
@@ -382,7 +220,7 @@ class TinyNewWinEvents {
             return;
         this.#pollClosedInterval = setInterval(() => {
             if (this.#windowRef?.closed) {
-                this.#events.emit('WINDOW_REF_CLOSED');
+                this.emit('WINDOW_REF_CLOSED');
                 this.destroy();
             }
         }, 500);
@@ -395,7 +233,7 @@ class TinyNewWinEvents {
      * @returns {void}
      */
     onClose(callback) {
-        return this.#events.on('WINDOW_REF_CLOSED', callback);
+        this.on('WINDOW_REF_CLOSED', callback);
     }
     /**
      * Unregisters a previously registered close callback.
@@ -404,7 +242,7 @@ class TinyNewWinEvents {
      * @returns {void}
      */
     offClose(callback) {
-        return this.#events.off('WINDOW_REF_CLOSED', callback);
+        this.off('WINDOW_REF_CLOSED', callback);
     }
     /**
      * Checks if the communication instance has been destroyed.
@@ -431,7 +269,7 @@ class TinyNewWinEvents {
         this.#pendingQueue = [];
         this.#ready = false;
         this.#windowRef = null;
-        this.#events.offAllTypes();
+        this.removeAllListeners();
     }
 }
 export default TinyNewWinEvents;

package/dist/v1/libs/TinyRadioFm.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
+var events = require('events');
 var mediaContent = require('../basics/mediaContent.cjs');
-var TinyEvents = require('./TinyEvents.cjs');
 
 /**
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
@@ -126,10 +126,9 @@ var TinyEvents = require('./TinyEvents.cjs');
 
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-class TinyRadioFm extends TinyEvents {
+class TinyRadioFm extends events.EventEmitter {
   /**
    * A Static Factory Method that prepares a MediaContent object by
    * extracting metadata from an audio source.

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

@@ -327,10 +327,9 @@ export type TinyRadioFmImport = {
  */
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-declare class TinyRadioFm extends TinyEvents {
+declare class TinyRadioFm extends EventEmitter<any> {
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.
@@ -550,5 +549,5 @@ declare class TinyRadioFm extends TinyEvents {
     destroy(destroyThumbs?: boolean): void;
     #private;
 }
-import TinyEvents from './TinyEvents.mjs';
+import { EventEmitter } from 'events';
 //# sourceMappingURL=TinyRadioFm.d.mts.map

package/dist/v1/libs/TinyRadioFm.mjs

@@ -1,5 +1,5 @@
+import { EventEmitter } from 'events';
 import { blobUrlToBase64, convertToBlobUrl, parseMediaMetadata, revokeContentUrls, } from '../basics/mediaContent.mjs';
-import TinyEvents from './TinyEvents.mjs';
 /**
  * @typedef {import('../basics/mediaContent.mjs').MediaContentBase} MediaContentBase
  * @typedef {import('../basics/mediaContent.mjs').MediaContentMetadata} MediaContentMetadata
@@ -105,10 +105,9 @@ import TinyEvents from './TinyEvents.mjs';
 //////////////////////////////////////////////////////////////////
 /**
  * A deterministic, seed-based radio management system with scheduled adaptations and weighted random generation.
- * @extends TinyEvents
  * @beta
  */
-class TinyRadioFm extends TinyEvents {
+class TinyRadioFm extends EventEmitter {
     /**
      * A Static Factory Method that prepares a MediaContent object by
      * extracting metadata from an audio source.

package/dist/v1/libs/TinySmartScroller.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
+var events = require('events');
 var TinyHtml = require('./TinyHtml.cjs');
 var collision = require('../basics/collision.cjs');
-var TinyEvents = require('./TinyEvents.cjs');
 
 /**
  * Represents the dimensions of a DOM element.
@@ -48,208 +48,9 @@ var TinyEvents = require('./TinyEvents.cjs');
  * This class is **not framework-dependent** and works with vanilla DOM elements and the window object.
  * @template {Element|Window} HTMLTarget
  */
-class TinySmartScroller {
+class TinySmartScroller extends events.EventEmitter {
   static Utils = { ...collision, TinyHtml };
 
-  #events = new TinyEvents();
-
-  /**
-   * Enables or disables throwing an error when the maximum number of listeners is exceeded.
-   *
-   * @param {boolean} shouldThrow - If true, an error will be thrown when the max is exceeded.
-   */
-  setThrowOnMaxListeners(shouldThrow) {
-    return this.#events.setThrowOnMaxListeners(shouldThrow);
-  }
-
-  /**
-   * Checks whether an error will be thrown when the max listener limit is exceeded.
-   *
-   * @returns {boolean} True if an error will be thrown, false if only a warning is shown.
-   */
-  getThrowOnMaxListeners() {
-    return this.#events.getThrowOnMaxListeners();
-  }
-
-  /////////////////////////////////////////////////////////////
-
-  /**
-   * Adds a listener to the beginning of the listeners array for the specified event.
-   *
-   * @param {string|string[]} event - Event name.
-   * @param {ScrollListenersFunc} handler - The callback function.
-   */
-  prependListener(event, handler) {
-    return this.#events.prependListener(event, handler);
-  }
-
-  /**
-   * Adds a one-time listener to the beginning of the listeners array for the specified event.
-   *
-   * @param {string|string[]} event - Event name.
-   * @param {ScrollListenersFunc} handler - The callback function.
-   * @returns {ScrollListenersFunc[]} - The wrapped handler used internally.
-   */
-  prependListenerOnce(event, handler) {
-    return this.#events.prependListenerOnce(event, handler);
-  }
-
-  //////////////////////////////////////////////////////////////////////
-
-  /**
-   * Adds a event listener.
-   *
-   * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-   * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-   */
-  appendListener(event, handler) {
-    return this.#events.appendListener(event, handler);
-  }
-
-  /**
-   * Registers an event listener that runs only once, then is removed.
-   *
-   * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-   * @param {ScrollListenersFunc} handler - The callback function to run on event.
-   * @returns {ScrollListenersFunc[]} - The wrapped version of the handler.
-   */
-  appendListenerOnce(event, handler) {
-    return this.#events.appendListenerOnce(event, handler);
-  }
-
-  /**
-   * Adds a event listener.
-   *
-   * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-   * @param {ScrollListenersFunc} handler - Callback function to be called when event fires.
-   */
-  on(event, handler) {
-    return this.#events.on(event, handler);
-  }
-
-  /**
-   * Registers an event listener that runs only once, then is removed.
-   *
-   * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
-   * @param {ScrollListenersFunc} handler - The callback function to run on event.
-   * @returns {ScrollListenersFunc[]} - The wrapped version of the handler.
-   */
-  once(event, handler) {
-    return this.#events.once(event, handler);
-  }
-
-  ////////////////////////////////////////////////////////////////////
-
-  /**
-   * Removes a previously registered event listener.
-   *
-   * @param {string|string[]} event - The name of the event to remove the handler from.
-   * @param {ScrollListenersFunc} handler - The specific callback function to remove.
-   */
-  off(event, handler) {
-    return this.#events.off(event, handler);
-  }
-
-  /**
-   * Removes all event listeners of a specific type from the element.
-   *
-   * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
-   */
-  offAll(event) {
-    return this.#events.offAll(event);
-  }
-
-  /**
-   * Removes all event listeners of all types from the element.
-   */
-  offAllTypes() {
-    return this.#events.offAllTypes();
-  }
-
-  ////////////////////////////////////////////////////////////
-
-  /**
-   * Returns the number of listeners for a given event.
-   *
-   * @param {string} event - The name of the event.
-   * @returns {number} Number of listeners for the event.
-   */
-  listenerCount(event) {
-    return this.#events.listenerCount(event);
-  }
-
-  /**
-   * Returns a copy of the array of listeners for the specified event.
-   *
-   * @param {string} event - The name of the event.
-   * @returns {ScrollListenersFunc[]} Array of listener functions.
-   */
-  listeners(event) {
-    return this.#events.listeners(event);
-  }
-
-  /**
-   * Returns a copy of the array of listeners for the specified event.
-   *
-   * @param {string} event - The name of the event.
-   * @returns {ScrollListenersFunc[]} Array of listener functions.
-   */
-  onceListeners(event) {
-    return this.#events.onceListeners(event);
-  }
-
-  /**
-   * Returns a copy of the internal listeners array for the specified event,
-   * including wrapper functions like those used by `.once()`.
-   * @param {string | symbol} event - The event name.
-   * @returns {ScrollListenersFunc[]} An array of raw listener functions.
-   */
-  allListeners(event) {
-    return this.#events.allListeners(event);
-  }
-
-  /**
-   * Returns an array of event names for which there are registered listeners.
-   *
-   * @returns {string[]} Array of registered event names.
-   */
-  eventNames() {
-    return this.#events.eventNames();
-  }
-
-  //////////////////////////////////////////////////////
-
-  /**
-   * Emits an event, triggering all registered handlers for that event.
-   *
-   * @param {string} event - The event name to emit.
-   * @param {...any} payload - Optional data to pass to each handler.
-   * @returns {boolean[]} True if any listeners were called, false otherwise.
-   */
-  emit(event, ...payload) {
-    return this.#events.emit(event, ...payload);
-  }
-
-  /**
-   * Sets the maximum number of listeners per event before a warning is shown.
-   *
-   * @param {number} n - The maximum number of listeners.
-   */
-  setMaxListeners(n) {
-    return this.#events.setMaxListeners(n);
-  }
-
-  /**
-   * Gets the maximum number of listeners allowed per event.
-   *
-   * @returns {number} The maximum number of listeners.
-   */
-  getMaxListeners() {
-    return this.#events.getMaxListeners();
-  }
-
-  ///////////////////////////////////////////////////
-
   /** @type {WeakMap<Element, NodeSizes>} */
   #oldSizes = new WeakMap();
   /** @type {WeakMap<Element, NodeSizes>} */
@@ -338,6 +139,7 @@ class TinySmartScroller {
       attributeFilter = ['class', 'style', 'src', 'data-*', 'height', 'width'],
     } = {},
   ) {
+    super();
     // === target ===
     if (!(
       target instanceof Element ||
@@ -1171,7 +973,7 @@ class TinySmartScroller {
     this.#oldVisiblesByTime = new WeakMap();
 
     // Cleans listeners and filters
-    this.#events.offAllTypes();
+    this.removeAllListeners();
     this.#sizeFilter.clear();
     this.#loadTags.clear();
   }