tiny-essentials 1.22.2 → 1.22.4

package/dist/v1/libs/TinyAdvancedRaffle.cjs

@@ -124,9 +124,9 @@ class TinyAdvancedRaffle {
   /**
    * Emits an event, triggering all registered handlers for that event.
    *
-   * @param {string} event - The event name to emit.
+   * @param {string|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.
+   * @returns {boolean[]} True if any listeners were called, false otherwise.
    */
   #emit(event, ...payload) {
     return this.#events.emit(event, ...payload);
@@ -155,7 +155,7 @@ class TinyAdvancedRaffle {
   /**
    * Adds a listener to the beginning of the listeners array for the specified event.
    *
-   * @param {string} event - Event name.
+   * @param {string|string[]} event - Event name.
    * @param {handler} handler - The callback function.
    */
   prependListener(event, handler) {
@@ -165,9 +165,9 @@ class TinyAdvancedRaffle {
   /**
    * Adds a one-time listener to the beginning of the listeners array for the specified event.
    *
-   * @param {string} event - Event name.
+   * @param {string|string[]} event - Event name.
    * @param {handler} handler - The callback function.
-   * @returns {handler} - The wrapped handler used internally.
+   * @returns {handler[]} - The wrapped handler used internally.
    */
   prependListenerOnce(event, handler) {
     return this.#events.prependListenerOnce(event, handler);
@@ -178,7 +178,7 @@ class TinyAdvancedRaffle {
   /**
    * Adds a event listener.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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) {
@@ -188,9 +188,9 @@ class TinyAdvancedRaffle {
   /**
    * Registers an event listener that runs only once, then is removed.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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.
+   * @returns {handler[]} - The wrapped version of the handler.
    */
   appendListenerOnce(event, handler) {
     return this.#events.appendListenerOnce(event, handler);
@@ -199,7 +199,7 @@ class TinyAdvancedRaffle {
   /**
    * Adds a event listener.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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) {
@@ -209,9 +209,9 @@ class TinyAdvancedRaffle {
   /**
    * Registers an event listener that runs only once, then is removed.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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.
+   * @returns {handler[]} - The wrapped version of the handler.
    */
   once(event, handler) {
     return this.#events.once(event, handler);
@@ -222,7 +222,7 @@ class TinyAdvancedRaffle {
   /**
    * Removes a previously registered event listener.
    *
-   * @param {string} event - The name of the event to remove the handler from.
+   * @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) {
@@ -232,7 +232,7 @@ class TinyAdvancedRaffle {
   /**
    * Removes all event listeners of a specific type from the element.
    *
-   * @param {string} event - The event type to remove (e.g. 'onScrollBoundary').
+   * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
    */
   offAll(event) {
     return this.#events.offAll(event);

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

@@ -288,61 +288,61 @@ declare class TinyAdvancedRaffle {
     /**
      * Adds a listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
      */
-    prependListener(event: string, handler: handler): void;
+    prependListener(event: string | string[], handler: handler): void;
     /**
      * Adds a one-time listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
-     * @returns {handler} - The wrapped handler used internally.
+     * @returns {handler[]} - The wrapped handler used internally.
      */
-    prependListenerOnce(event: string, handler: handler): handler;
+    prependListenerOnce(event: string | string[], handler: handler): handler[];
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
      * @param {handler} handler - Callback function to be called when event fires.
      */
-    appendListener(event: string, handler: handler): void;
+    appendListener(event: string | string[], handler: handler): void;
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
-    appendListenerOnce(event: string, handler: handler): handler;
+    appendListenerOnce(event: string | string[], handler: handler): handler[];
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
      * @param {handler} handler - Callback function to be called when event fires.
      */
-    on(event: string, handler: handler): void;
+    on(event: string | string[], handler: handler): void;
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
-    once(event: string, handler: handler): handler;
+    once(event: string | string[], handler: handler): handler[];
     /**
      * Removes a previously registered event listener.
      *
-     * @param {string} event - The name of the event to remove the handler from.
+     * @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: string, handler: handler): void;
+    off(event: string | string[], handler: handler): void;
     /**
      * Removes all event listeners of a specific type from the element.
      *
-     * @param {string} event - The event type to remove (e.g. 'onScrollBoundary').
+     * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
      */
-    offAll(event: string): void;
+    offAll(event: string | string[]): void;
     /**
      * Removes all event listeners of all types from the element.
      */

package/dist/v1/libs/TinyAdvancedRaffle.mjs

@@ -106,9 +106,9 @@ class TinyAdvancedRaffle {
     /**
      * Emits an event, triggering all registered handlers for that event.
      *
-     * @param {string} event - The event name to emit.
+     * @param {string|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.
+     * @returns {boolean[]} True if any listeners were called, false otherwise.
      */
     #emit(event, ...payload) {
         return this.#events.emit(event, ...payload);
@@ -133,7 +133,7 @@ class TinyAdvancedRaffle {
     /**
      * Adds a listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
      */
     prependListener(event, handler) {
@@ -142,9 +142,9 @@ class TinyAdvancedRaffle {
     /**
      * Adds a one-time listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
-     * @returns {handler} - The wrapped handler used internally.
+     * @returns {handler[]} - The wrapped handler used internally.
      */
     prependListenerOnce(event, handler) {
         return this.#events.prependListenerOnce(event, handler);
@@ -153,7 +153,7 @@ class TinyAdvancedRaffle {
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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) {
@@ -162,9 +162,9 @@ class TinyAdvancedRaffle {
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
     appendListenerOnce(event, handler) {
         return this.#events.appendListenerOnce(event, handler);
@@ -172,7 +172,7 @@ class TinyAdvancedRaffle {
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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) {
@@ -181,9 +181,9 @@ class TinyAdvancedRaffle {
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
     once(event, handler) {
         return this.#events.once(event, handler);
@@ -192,7 +192,7 @@ class TinyAdvancedRaffle {
     /**
      * Removes a previously registered event listener.
      *
-     * @param {string} event - The name of the event to remove the handler from.
+     * @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) {
@@ -201,7 +201,7 @@ class TinyAdvancedRaffle {
     /**
      * Removes all event listeners of a specific type from the element.
      *
-     * @param {string} event - The event type to remove (e.g. 'onScrollBoundary').
+     * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
      */
     offAll(event) {
         return this.#events.offAll(event);

package/dist/v1/libs/TinyEvents.cjs

@@ -34,6 +34,19 @@ class TinyEvents {
   /** @type {boolean} */
   #throwMaxListeners = false;
 
+  /**
+   * Normalizes the event parameter into an array of strings.
+   *
+   * @param {string|string[]} event
+   * @param {string} method
+   * @returns {string[]}
+   */
+  #normalizeEvents(event, method) {
+    if (typeof event === 'string') return [event];
+    if (Array.isArray(event) && event.every((e) => typeof e === 'string')) return event;
+    throw new TypeError(`${method}(event): event must be a string or string[]`);
+  }
+
   /**
    * Enables or disables throwing an error when the maximum number of listeners is exceeded.
    *
@@ -85,38 +98,39 @@ class TinyEvents {
   /**
    * Adds a listener to the beginning of the listeners array for the specified event.
    *
-   * @param {string} event - Event name.
+   * @param {string|string[]} event - Event name.
    * @param {handler} handler - The callback function.
    */
   prependListener(event, handler) {
-    if (typeof event !== 'string')
-      throw new TypeError('prepend(event, handler): event name must be a string');
+    const events = this.#normalizeEvents(event, 'prependListener');
     if (typeof handler !== 'function')
-      throw new TypeError('prepend(event, handler): handler must be a function');
-    this.#prepend(event, handler);
+      throw new TypeError('prependListener(event, handler): handler must be a function');
+    for (const ev of events) this.#prepend(ev, handler);
   }
 
   /**
    * Adds a one-time listener to the beginning of the listeners array for the specified event.
    *
-   * @param {string} event - Event name.
+   * @param {string|string[]} event - Event name.
    * @param {handler} handler - The callback function.
-   * @returns {handler} - The wrapped handler used internally.
+   * @returns {handler[]} - The wrapped handler used internally.
    */
   prependListenerOnce(event, handler) {
-    if (typeof event !== 'string')
-      throw new TypeError('prependOnceListener(event, handler): event name must be a string');
+    const events = this.#normalizeEvents(event, 'prependListenerOnce');
     if (typeof handler !== 'function')
-      throw new TypeError('prependOnceListener(event, handler): handler must be a function');
-
-    /** @type {handler} */
-    const wrapped = (...args) => {
-      this.off(event, wrapped);
-      handler(...args);
-    };
-
-    this.#prepend(event, wrapped, { once: true });
-    return wrapped;
+      throw new TypeError('prependListenerOnce(event, handler): handler must be a function');
+
+    const wrappedHandlers = [];
+    for (const ev of events) {
+      /** @type {handler} */
+      const wrapped = (...args) => {
+        this.off(ev, wrapped);
+        handler(...args);
+      };
+      this.#prepend(ev, wrapped, { once: true });
+      wrappedHandlers.push(wrapped);
+    }
+    return wrappedHandlers;
   }
 
   ////////////////////////////////////////////////////////////
@@ -124,38 +138,39 @@ class TinyEvents {
   /**
    * Adds a event listener.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
    * @param {handler} handler - Callback function to be called when event fires.
    * @param {Object} [settings={}] - Optional settings.
    * @param {boolean} [settings.once=false] - This is a once event.
    */
   #on(event, handler, { once = false } = {}) {
-    let eventData = this.#listeners.get(event);
-    if (!Array.isArray(eventData)) {
-      eventData = [];
-      this.#listeners.set(event, eventData);
-    }
-    eventData.push({ handler, config: { once } });
-    // Warn if listener count exceeds the max allowed
-    const max = this.#maxListeners;
-    if (max > 0 && eventData.length > max) {
-      const warnMessage =
-        `Possible memory leak detected. ${eventData.length} "${event}" listeners added. ` +
-        `Use setMaxListeners() to increase limit.`;
-      if (!this.#throwMaxListeners) console.warn(warnMessage);
-      else throw new Error(warnMessage);
+    const events = this.#normalizeEvents(event, 'on');
+    for (const ev of events) {
+      let eventData = this.#listeners.get(ev);
+      if (!Array.isArray(eventData)) {
+        eventData = [];
+        this.#listeners.set(ev, eventData);
+      }
+      eventData.push({ handler, config: { once } });
+      // Warn if listener count exceeds the max allowed
+      const max = this.#maxListeners;
+      if (max > 0 && eventData.length > max) {
+        const warnMessage =
+          `Possible memory leak detected. ${eventData.length} "${ev}" listeners added. ` +
+          `Use setMaxListeners() to increase limit.`;
+        if (!this.#throwMaxListeners) console.warn(warnMessage);
+        else throw new Error(warnMessage);
+      }
     }
   }
 
   /**
    * Adds a event listener.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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) {
-    if (typeof event !== 'string')
-      throw new TypeError('on(event, handler): event name must be a string');
     if (typeof handler !== 'function')
       throw new TypeError('on(event, handler): handler must be a function');
     return this.#on(event, handler);
@@ -164,28 +179,32 @@ class TinyEvents {
   /**
    * Registers an event listener that runs only once, then is removed.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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.
+   * @returns {handler[]} - The wrapped version of the handler.
    */
   once(event, handler) {
-    if (typeof event !== 'string') throw new TypeError('The event name must be a string.');
+    const events = this.#normalizeEvents(event, 'once');
     if (typeof handler !== 'function')
       throw new TypeError('once(event, handler): handler must be a function');
 
-    /** @type {handler} */
-    const wrapped = (e) => {
-      this.off(event, wrapped);
-      if (typeof handler === 'function') handler(e);
-    };
-    this.#on(event, wrapped, { once: true });
-    return wrapped;
+    const wrappedHandlers = [];
+    for (const ev of events) {
+      /** @type {handler} */
+      const wrapped = (...args) => {
+        this.off(ev, wrapped);
+        handler(...args);
+      };
+      this.#on(ev, wrapped, { once: true });
+      wrappedHandlers.push(wrapped);
+    }
+    return wrappedHandlers;
   }
 
   /**
    * Adds a event listener.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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) {
@@ -195,9 +214,9 @@ class TinyEvents {
   /**
    * Registers an event listener that runs only once, then is removed.
    *
-   * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+   * @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.
+   * @returns {handler[]} - The wrapped version of the handler.
    */
   appendListenerOnce(event, handler) {
     return this.once(event, handler);
@@ -208,33 +227,34 @@ class TinyEvents {
   /**
    * Removes a previously registered event listener.
    *
-   * @param {string} event - The name of the event to remove the handler from.
+   * @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) {
-    if (typeof event !== 'string')
-      throw new TypeError('off(event, handler): event name must be a string');
+    const events = this.#normalizeEvents(event, 'off');
     if (typeof handler !== 'function')
       throw new TypeError('off(event, handler): handler must be a function');
 
-    const listeners = this.#listeners.get(event);
-    if (!Array.isArray(listeners)) return;
+    for (const ev of events) {
+      const listeners = this.#listeners.get(ev);
+      if (!Array.isArray(listeners)) continue;
 
-    const index = listeners.findIndex((listener) => listener.handler === handler);
-    if (index !== -1) listeners.splice(index, 1);
+      const index = listeners.findIndex((listener) => listener.handler === handler);
+      if (index !== -1) listeners.splice(index, 1);
 
-    // Optionally clean up empty arrays (optional)
-    if (listeners.length === 0) this.#listeners.delete(event);
+      // Optionally clean up empty arrays (optional)
+      if (listeners.length === 0) this.#listeners.delete(ev);
+    }
   }
 
   /**
    * Removes all event listeners of a specific type from the element.
    *
-   * @param {string} event - The event type to remove (e.g. 'onScrollBoundary').
+   * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
    */
   offAll(event) {
-    if (typeof event !== 'string') throw new TypeError('The event name must be a string.');
-    this.#listeners.delete(event);
+    const events = this.#normalizeEvents(event, 'offAll');
+    for (const ev of events) this.#listeners.delete(ev);
   }
 
   /**
@@ -321,20 +341,25 @@ class TinyEvents {
   /**
    * Emits an event, triggering all registered handlers for that event.
    *
-   * @param {string} event - The event name to emit.
+   * @param {string|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.
+   * @returns {boolean[]} True if any listeners were called, false otherwise.
    */
   emit(event, ...payload) {
-    if (typeof event !== 'string')
-      throw new TypeError('emit(event, data): event name must be a string');
-
-    const listeners = this.#listeners.get(event);
-    if (!Array.isArray(listeners) || listeners.length === 0) return false;
-
-    // Call all listeners with the provided data
-    listeners.forEach((listener) => listener.handler(...payload));
-    return true;
+    const events = this.#normalizeEvents(event, 'emit');
+    const called = [];
+    for (const ev of events) {
+      const listeners = this.#listeners.get(ev);
+      if (!Array.isArray(listeners) || listeners.length === 0) {
+        called.push(false);
+        continue;
+      }
+
+      // Call all listeners with the provided data
+      listeners.forEach((listener) => listener.handler(...payload));
+      called.push(true);
+    }
+    return called;
   }
 
   ///////////////////////////////////

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

@@ -42,61 +42,61 @@ declare class TinyEvents {
     /**
      * Adds a listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
      */
-    prependListener(event: string, handler: handler): void;
+    prependListener(event: string | string[], handler: handler): void;
     /**
      * Adds a one-time listener to the beginning of the listeners array for the specified event.
      *
-     * @param {string} event - Event name.
+     * @param {string|string[]} event - Event name.
      * @param {handler} handler - The callback function.
-     * @returns {handler} - The wrapped handler used internally.
+     * @returns {handler[]} - The wrapped handler used internally.
      */
-    prependListenerOnce(event: string, handler: handler): handler;
+    prependListenerOnce(event: string | string[], handler: handler): handler[];
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
      * @param {handler} handler - Callback function to be called when event fires.
      */
-    on(event: string, handler: handler): void;
+    on(event: string | string[], handler: handler): void;
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
-    once(event: string, handler: handler): handler;
+    once(event: string | string[], handler: handler): handler[];
     /**
      * Adds a event listener.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @param {string|string[]} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
      * @param {handler} handler - Callback function to be called when event fires.
      */
-    appendListener(event: string, handler: handler): void;
+    appendListener(event: string | string[], handler: handler): void;
     /**
      * Registers an event listener that runs only once, then is removed.
      *
-     * @param {string} event - Event name, such as 'onScrollBoundary' or 'onAutoScroll'.
+     * @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.
+     * @returns {handler[]} - The wrapped version of the handler.
      */
-    appendListenerOnce(event: string, handler: handler): handler;
+    appendListenerOnce(event: string | string[], handler: handler): handler[];
     /**
      * Removes a previously registered event listener.
      *
-     * @param {string} event - The name of the event to remove the handler from.
+     * @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: string, handler: handler): void;
+    off(event: string | string[], handler: handler): void;
     /**
      * Removes all event listeners of a specific type from the element.
      *
-     * @param {string} event - The event type to remove (e.g. 'onScrollBoundary').
+     * @param {string|string[]} event - The event type to remove (e.g. 'onScrollBoundary').
      */
-    offAll(event: string): void;
+    offAll(event: string | string[]): void;
     /**
      * Removes all event listeners of all types from the element.
      */
@@ -138,11 +138,11 @@ declare class TinyEvents {
     /**
      * Emits an event, triggering all registered handlers for that event.
      *
-     * @param {string} event - The event name to emit.
+     * @param {string|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.
+     * @returns {boolean[]} True if any listeners were called, false otherwise.
      */
-    emit(event: string, ...payload: any[]): boolean;
+    emit(event: string | string[], ...payload: any[]): boolean[];
     /**
      * Sets the maximum number of listeners per event before a warning is shown.
      *