evnty 4.1.0 → 4.2.0

package/build/index.cjs

@@ -60,8 +60,15 @@ class Callable extends Function {
     }
 }
 class Unsubscribe extends Callable {
+    _done = false;
     constructor(callback){
-        super(callback);
+        super(()=>{
+            this._done = true;
+            callback();
+        });
+    }
+    get done() {
+        return this._done;
     }
     pre(callback) {
         return new Unsubscribe(async ()=>{
@@ -83,15 +90,22 @@ class Unsubscribe extends Callable {
         });
     }
 }
+var SpyType;
+(function(SpyType) {
+    SpyType[SpyType["Add"] = 0] = "Add";
+    SpyType[SpyType["Remove"] = 1] = "Remove";
+})(SpyType || (SpyType = {}));
 class Event extends Callable {
     listeners;
     spies = [];
+    _disposed = false;
     dispose;
     constructor(dispose){
         const listeners = [];
         super(async (value)=>Promise.all(listeners.map(async (listener)=>listener(await value))));
         this.listeners = listeners;
         this.dispose = async ()=>{
+            this._disposed = true;
             void this.clear();
             await this._error?.dispose();
             await dispose?.();
@@ -104,6 +118,9 @@ class Event extends Callable {
     get size() {
         return this.listeners.length;
     }
+    get disposed() {
+        return this._disposed;
+    }
     lacks(listener) {
         return this.listeners.indexOf(listener) === -1;
     }
@@ -114,12 +131,17 @@ class Event extends Callable {
         if (removeListener(this.listeners, listener) && this.spies.length) {
             [
                 ...this.spies
-            ].forEach((spy)=>spy(listener));
+            ].forEach((spy)=>spy(listener, 1));
         }
         return this;
     }
     on(listener) {
         this.listeners.push(listener);
+        if (this.spies.length) {
+            [
+                ...this.spies
+            ].forEach((spy)=>spy(listener, 0));
+        }
         return new Unsubscribe(()=>{
             void this.off(listener);
         });
@@ -136,7 +158,7 @@ class Event extends Callable {
         if (this.spies.length) {
             [
                 ...this.spies
-            ].forEach((spy)=>spy());
+            ].forEach((spy)=>spy(undefined, 1));
         }
         return this;
     }
@@ -159,8 +181,8 @@ class Event extends Callable {
             queue.splice(0);
             await doneEvent.dispose();
         });
-        const spy = (target = emitEvent)=>{
-            if (target === emitEvent) {
+        const spy = (target = emitEvent, action)=>{
+            if (target === emitEvent && action === 1) {
                 void doneEvent(true);
                 void unsubscribe();
             }
@@ -207,8 +229,8 @@ class Event extends Callable {
         const unsubscribe = this.on(emitEvent).pre(()=>{
             removeListener(this.spies, spy);
         });
-        const spy = (target = emitEvent)=>{
-            if (target === emitEvent) {
+        const spy = (target = emitEvent, action)=>{
+            if (target === emitEvent && action === 1) {
                 void unsubscribe();
             }
         };
@@ -354,6 +376,9 @@ class Event extends Callable {
             get stopped () {
                 return done;
             },
+            then (onfulfilled, onrejected) {
+                return this.pop().then(onfulfilled, onrejected);
+            },
             [Symbol.asyncIterator] () {
                 return {
                     next: async ()=>{

package/build/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type MaybePromise<T> = Promise<T> | PromiseLike<T> | T;\n\nexport interface Callback<R = void> {\n  (): MaybePromise<R>;\n}\n\nexport interface Listener<T, R = unknown> {\n  (event: T): MaybePromise<R | void>;\n}\n\nexport interface FilterFunction<T> {\n  (event: T): MaybePromise<boolean>;\n}\n\nexport interface Predicate<T, P extends T> {\n  (event: T): event is P;\n}\n\nexport type Filter<T, P extends T> = Predicate<T, P> | FilterFunction<T>;\n\nexport interface Mapper<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\nexport interface Reducer<T, R> {\n  (result: R, event: T): MaybePromise<R>;\n}\n\nexport interface Expander<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\n/**\n * Removes a listener from the provided array of listeners. It searches for the listener and removes all instances of it from the array.\n * This method ensures that the listener is fully unregistered, preventing any residual calls to a potentially deprecated handler.\n *\n * @internal\n * @param {Listener<T, R>[]} listeners - The array of listeners from which to remove the listener.\n * @param {Listener<T, R>} listener - The listener function to remove from the list of listeners.\n * @returns {boolean} - Returns `true` if the listener was found and removed, `false` otherwise.\n *\n * @template T - The type of the event that listeners are associated with.\n * @template R - The type of the return value that listeners are expected to return.\n *\n * ```typescript\n * // Assuming an array of listeners for click events\n * const listeners = [onClickHandler1, onClickHandler2];\n * const wasRemoved = removeListener(listeners, onClickHandler1);\n * console.log(wasRemoved); // Output: true\n * ```\n */\nexport const removeListener = <T, R>(listeners: Listener<T, R>[], listener: Listener<T, R>): boolean => {\n  let index = listeners.indexOf(listener);\n  const wasRemoved = index !== -1;\n  while (~index) {\n    listeners.splice(index, 1);\n    index = listeners.indexOf(listener);\n  }\n  return wasRemoved;\n};\n\n/**\n * @internal\n * @param timeout\n * @param signal\n * @returns\n */\nexport const setTimeoutAsync = (timeout: number, signal?: AbortSignal) =>\n  new Promise<boolean>((resolve) => {\n    const timerId = setTimeout(resolve, timeout, true);\n    signal?.addEventListener('abort', () => {\n      clearTimeout(timerId);\n      resolve(false);\n    });\n  });\n\n/**\n * An abstract class that extends the built-in Function class. It allows instances of the class\n * to be called as functions. When an instance of Callable is called as a function, it will\n * call the function passed to its constructor with the same arguments.\n * @internal\n */\nexport abstract class Callable extends Function {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  constructor(func: Function) {\n    super();\n    return Object.setPrototypeOf(func, new.target.prototype);\n  }\n}\n\nexport interface Unsubscribe {\n  (): MaybePromise<void>;\n}\n\n/**\n * @internal\n */\nexport class Unsubscribe extends Callable {\n  constructor(callback: Callback) {\n    super(callback);\n  }\n\n  pre(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await callback();\n      await this();\n    });\n  }\n\n  post(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await this();\n      await callback();\n    });\n  }\n\n  countdown(count: number): Unsubscribe {\n    return new Unsubscribe(async () => {\n      if (!--count) {\n        await this();\n      }\n    });\n  }\n}\n\nexport interface Queue<T> extends AsyncIterable<T> {\n  pop(): MaybePromise<T>;\n  stop(): MaybePromise<void>;\n  stopped: boolean;\n}\n\nexport interface Event<T = any, R = any> {\n  (event: T): Promise<(void | Awaited<R>)[]>;\n}\n\n/**\n * A class representing an anonymous event that can be listened to or triggered.\n *\n * @template T - The event type.\n * @template R - The return type of the event.\n */\nexport class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLike<T> {\n  /**\n   * The array of listeners for the event.\n   */\n  private listeners: Listener<T, R>[];\n\n  private spies: Array<(listener: Listener<T, R> | void) => void> = [];\n\n  /**\n   * A function that disposes of the event and its listeners.\n   */\n  readonly dispose: Callback;\n\n  /**\n   * Creates a new event.\n   *\n   * @param dispose - A function to call on the event disposal.\n   *\n   * ```typescript\n   * // Create a click event.\n   * const clickEvent = new Event<[x: number, y: number], void>();\n   * clickEvent.on(([x, y]) => console.log(`Clicked at ${x}, ${y}`));\n   * ```\n   */\n  constructor(dispose?: Callback) {\n    const listeners: Listener<T, R>[] = [];\n    // passes listeners exceptions to catch method\n    super(async (value: T): Promise<(void | Awaited<R>)[]> => Promise.all(listeners.map(async (listener) => listener(await value))));\n    this.listeners = listeners;\n\n    this.dispose = async () => {\n      void this.clear();\n      await this._error?.dispose();\n      await dispose?.();\n    };\n  }\n\n  private _error?: Event<unknown>;\n\n  /**\n   * Error event that emits errors.\n   *\n   * @returns {Event<unknown>} The error event.\n   */\n  get error(): Event<unknown> {\n    return (this._error ??= new Event<unknown>());\n  }\n\n  /**\n   * The number of listeners for the event.\n   *\n   * @readonly\n   * @type {number}\n   */\n  get size(): number {\n    return this.listeners.length;\n  }\n\n  /**\n   * Checks if the given listener is NOT registered for this event.\n   *\n   * @param listener - The listener function to check against the registered listeners.\n   * @returns `true` if the listener is not already registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Check if a listener is not already added\n   * if (event.lacks(myListener)) {\n   *   event.on(myListener);\n   * }\n   * ```\n   */\n  lacks(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) === -1;\n  }\n\n  /**\n   * Checks if the given listener is registered for this event.\n   *\n   * @param listener - The listener function to check.\n   * @returns `true` if the listener is currently registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Verify if a listener is registered\n   * if (event.has(myListener)) {\n   *   console.log('Listener is already registered');\n   * }\n   * ```\n   */\n  has(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) !== -1;\n  }\n\n  /**\n   * Removes a specific listener from this event.\n   *\n   * @param listener - The listener to remove.\n   * @returns The event instance, allowing for method chaining.\n   *\n   * ```typescript\n   * // Remove a listener\n   * event.off(myListener);\n   * ```\n   */\n  off(listener: Listener<T, R>): this {\n    if (removeListener(this.listeners, listener) && this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener));\n    }\n    return this;\n  }\n\n  /**\n   * Registers a listener that gets triggered whenever the event is emitted.\n   * This is the primary method for adding event handlers that will react to the event being triggered.\n   *\n   * @param listener - The function to call when the event occurs.\n   * @returns An object that can be used to unsubscribe the listener, ensuring easy cleanup.\n   *\n   * ```typescript\n   * // Add a listener to an event\n   * const unsubscribe = event.on((data) => {\n   *   console.log('Event data:', data);\n   * });\n   * ```\n   */\n  on(listener: Listener<T, R>): Unsubscribe {\n    this.listeners.push(listener);\n    return new Unsubscribe(() => {\n      void this.off(listener);\n    });\n  }\n\n  /**\n   * Adds a listener that will be called only once the next time the event is emitted.\n   * This method is useful for one-time notifications or single-trigger scenarios.\n   *\n   * @param listener - The listener to trigger once.\n   * @returns An object that can be used to remove the listener if the event has not yet occurred.\n   *\n   * ```typescript\n   * // Register a one-time listener\n   * const onceUnsubscribe = event.once((data) => {\n   *   console.log('Received data once:', data);\n   * });\n   * ```\n   */\n  once(listener: Listener<T, R>): Unsubscribe {\n    const oneTimeListener = (event: T) => {\n      void this.off(oneTimeListener);\n      return listener(event);\n    };\n    return this.on(oneTimeListener);\n  }\n\n  /**\n   * Removes all listeners from the event, effectively resetting it. This is useful when you need to\n   * cleanly dispose of all event handlers to prevent memory leaks or unwanted triggerings after certain conditions.\n   *\n   * @returns {this} The instance of the event, allowing for method chaining.\n   *\n   * ```typescript\n   * const myEvent = new Event();\n   * myEvent.on(data => console.log(data));\n   * myEvent.clear(); // Clears all listeners\n   * ```\n   */\n  clear(): this {\n    this.listeners.splice(0);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy());\n    }\n    return this;\n  }\n\n  /**\n   * Enables the `Event` to be used in a Promise chain, resolving with the first emitted value.\n   *\n   * @template TResult1 - The type of the fulfilled value returned by `onfulfilled` (defaults to the event's type).\n   * @template TResult2 - The type of the rejected value returned by `onrejected` (defaults to `never`).\n   * @param onfulfilled - A function called when the event emits its first value.\n   * @param onrejected - A function called if an error occurs before the event emits.\n   * @returns A Promise that resolves with the result of `onfulfilled` or `onrejected`.\n   *\n   * ```typescript\n   * const clickEvent = new Event<[number, number]>();\n   * await clickEvent;\n   * ```\n   */\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n  ): Promise<TResult1 | TResult2> {\n    const promise = new Promise<T>((resolve) => this.once(resolve));\n\n    return promise.then(onfulfilled, onrejected);\n  }\n\n  /**\n   * A promise that resolves with the first emitted value from this event.\n   *\n   * @returns {Promise<T>} The promise value.\n   */\n  get promise(): Promise<T> {\n    return this.then((v) => v);\n  }\n\n  /**\n   * Makes this event iterable using `for await...of` loops.\n   *\n   * @returns An async iterator that yields values as they are emitted by this event.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers\n   * const numberEvent = new Event<number>();\n   * (async () => {\n   *   for await (const num of numberEvent) {\n   *     console.log('Number:', num);\n   *   }\n   * })();\n   * await numberEvent(1);\n   * await numberEvent(2);\n   * await numberEvent(3);\n   * ```\n   */\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    const queue: T[] = [];\n    const doneEvent = new Event<boolean>();\n    const emitEvent = async (value: T) => {\n      queue.push(value);\n      await doneEvent(false);\n    };\n    const unsubscribe = this.on(emitEvent).pre(async () => {\n      removeListener(this.spies, spy);\n      queue.splice(0);\n      await doneEvent.dispose();\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent) => {\n      if (target === emitEvent) {\n        void doneEvent(true);\n        void unsubscribe();\n      }\n    };\n\n    this.spies.push(spy);\n    return {\n      async next() {\n        if (queue.length) {\n          return { value: queue.shift()!, done: false };\n        }\n        if (!(await doneEvent)) {\n          return { value: queue.shift()!, done: false };\n        }\n        return { value: undefined, done: true };\n      },\n      async return(value: unknown) {\n        await unsubscribe();\n        return { done: true, value };\n      },\n    };\n  }\n\n  /**\n   * Transforms the event's values using a generator function, creating a new `Event` that emits the transformed values.\n   *\n   * @template PT - The type of values emitted by the transformed `Event`.\n   * @template PR - The return type of the listeners of the transformed `Event`.\n   * @param generator - A function that takes the original event's value and returns a generator (sync or async) that yields the transformed values.\n   * @returns A new `Event` instance that emits the transformed values.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  pipe<PT, R>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): Event<PT, R> {\n    const emitEvent = async (value: T) => {\n      try {\n        for await (const generatedValue of generator(value)) {\n          await result(generatedValue).catch((e) => result.error(e));\n        }\n      } catch (e) {\n        await result.error(e);\n      }\n    };\n\n    const unsubscribe = this.on(emitEvent).pre(() => {\n      removeListener(this.spies, spy);\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent) => {\n      if (target === emitEvent) {\n        void unsubscribe();\n      }\n    };\n    this.spies.push(spy);\n\n    const result = new Event<PT, R>(unsubscribe);\n    return result;\n  }\n\n  /**\n   * Creates an async generator that yields values as they are emitted by this event.\n   *\n   * @template PT - The type of values yielded by the async generator.\n   * @param generator - An optional function that takes the original event's value and returns a generator (sync or async)\n   *                  that yields values to include in the async generator.\n   * @returns An async generator that yields values from this event as they occur.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  async *generator<PT>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): AsyncGenerator<Awaited<PT>, void, unknown> {\n    for await (const value of this.pipe(generator)) {\n      yield value;\n    }\n  }\n\n  /**\n   * Filters events, creating a new event that only triggers when the provided filter function returns `true`.\n   * This method can be used to selectively process events that meet certain criteria.\n   *\n   * @param {Filter<T, P>} predicate The filter function or predicate to apply to each event.\n   * @returns {Event<P, R>} A new event that only triggers for filtered events.\n   *\n   * ```typescript\n   * const keyPressedEvent = new Event<string>();\n   * const enterPressedEvent = keyPressedEvent.filter(key => key === 'Enter');\n   * enterPressedEvent.on(() => console.log('Enter key was pressed.'));\n   * ```\n   */\n  filter<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  filter<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  filter<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    return this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that will only be triggered once when the provided filter function returns `true`.\n   * This method is useful for handling one-time conditions in a stream of events.\n   *\n   * @param {Filter<T, P>} predicate - The filter function or predicate.\n   * @returns {Event<P, R>} A new event that will be triggered only once when the filter condition is met.\n   *\n   * ```typescript\n   * const sizeChangeEvent = new Event<number>();\n   * const sizeReachedEvent = sizeChangeEvent.first(size => size > 1024);\n   * sizeReachedEvent.on(() => console.log('Size threshold exceeded.'));\n   * ```\n   */\n  first<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  first<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  first<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    const filteredEvent = this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n        await filteredEvent.dispose();\n      }\n    });\n    return filteredEvent;\n  }\n\n  /**\n   * Transforms the data emitted by this event using a mapping function. Each emitted event is processed by the `mapper`\n   * function, which returns a new value that is then emitted by the returned `Event` instance. This is useful for data transformation\n   * or adapting the event's data structure.\n   *\n   * @template M The type of data that the mapper function will produce.\n   * @template MR The type of data emitted by the mapped event, usually related to or the same as `M`.\n   * @param {Mapper<T, M>} mapper A function that takes the original event data and returns the transformed data.\n   * @returns {Event<M, MR>} A new `Event` instance that emits the mapped values.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers, create a new event that emits their squares.\n   * const numberEvent = new Event<number>();\n   * const squaredEvent = numberEvent.map(num => num * num);\n   * squaredEvent.on(squared => console.log('Squared number:', squared));\n   * await numberEvent(5); // Logs: \"Squared number: 25\"\n   * ```\n   */\n  map<M, MR = R>(mapper: Mapper<T, M>): Event<Awaited<M>, MR> {\n    return this.pipe(async function* (value) {\n      yield await mapper(value);\n    });\n  }\n\n  /**\n   * Accumulates the values emitted by this event using a reducer function, starting from an initial value. The reducer\n   * function takes the accumulated value and the latest emitted event data, then returns a new accumulated value. This\n   * new value is then emitted by the returned `Event` instance. This is particularly useful for accumulating state over time.\n   *\n   * @template A The type of the accumulator value.\n   * @template AR The type of data emitted by the reduced event, usually the same as `A`.\n   * @param {Reducer<T, A>} reducer A function that takes the current accumulated value and the new event data, returning the new accumulated value.\n   * @param {A} init The initial value of the accumulator.\n   * @returns {Event<A, AR>} A new `Event` instance that emits the reduced value.\n   *\n   * ```typescript\n   * const sumEvent = numberEvent.reduce((a, b) => a + b, 0);\n   * sumEvent.on((sum) => console.log(sum)); // 1, 3, 6\n   * await sumEvent(1);\n   * await sumEvent(2);\n   * await sumEvent(3);\n   * ```\n   */\n  reduce<A, AR = R>(reducer: Reducer<T, A>, init?: A): Event<Awaited<A>, AR>;\n  reduce<A, AR = R>(reducer: Reducer<T, A>, ...init: unknown[]): Event<Awaited<A>, AR> {\n    let hasInit = init.length === 1;\n    let result = init[0] as A | undefined;\n\n    return this.pipe(async function* (value) {\n      if (hasInit) {\n        result = await reducer(result!, value);\n        yield result;\n      } else {\n        result = value as unknown as A;\n        hasInit = true;\n      }\n    });\n  }\n\n  /**\n   * Transforms each event's data into multiple events using an expander function. The expander function takes\n   * the original event's data and returns an array of new data elements, each of which will be emitted individually\n   * by the returned `Event` instance. This method is useful for scenarios where an event's data can naturally\n   * be expanded into multiple, separate pieces of data which should each trigger further processing independently.\n   *\n   * @template ET - The type of data elements in the array returned by the expander function.\n   * @template ER - The type of responses emitted by the expanded event, usually related to or the same as `ET`.\n   * @param {Expander<T, ET[]>} expander - A function that takes the original event data and returns an array of new data elements.\n   * @returns {Event<ET, ER>} - A new `Event` instance that emits each value from the array returned by the expander function.\n   *\n   * ```typescript\n   * // Assuming an event that emits a sentence, create a new event that emits each word from the sentence separately.\n   * const sentenceEvent = new Event<string>();\n   * const wordEvent = sentenceEvent.expand(sentence => sentence.split(' '));\n   * wordEvent.on(word => console.log('Word:', word));\n   * await sentenceEvent('Hello world'); // Logs: \"Word: Hello\", \"Word: world\"\n   * ```\n   */\n  expand<ET, ER>(expander: Expander<T, ET[]>): Event<Awaited<ET>, ER> {\n    return this.pipe(async function* (value) {\n      const values = await expander(value);\n      for (const value of values) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that emits values based on a conductor event. The orchestrated event will emit the last value\n   * captured from the original event each time the conductor event is triggered. This method is useful for synchronizing\n   * events, where the emission of one event controls the timing of another.\n   *\n   * @template T The type of data emitted by the original event.\n   * @template R The type of data emitted by the orchestrated event, usually the same as `T`.\n   * @param {Event<unknown, unknown>} conductor An event that signals when the orchestrated event should emit.\n   * @returns {Event<T, R>} An orchestrated event that emits values based on the conductor's trigger.\n   *\n   * ```typescript\n   * const rightClickPositionEvent = mouseMoveEvent.orchestrate(mouseRightClickEvent);\n   * ```\n   *\n   * ```typescript\n   * // An event that emits whenever a \"tick\" event occurs.\n   * const tickEvent = new Event<void>();\n   * const dataEvent = new Event<string>();\n   * const synchronizedEvent = dataEvent.orchestrate(tickEvent);\n   * synchronizedEvent.on(data => console.log('Data on tick:', data));\n   * await dataEvent('Hello');\n   * await dataEvent('World!');\n   * await tickEvent(); // Logs: \"Data on tick: World!\"\n   * ```\n   */\n  orchestrate(conductor: Event<any, any>): Event<T, R> {\n    let initialized = false;\n    let lastValue: T;\n    const unsubscribe = this.on(async (event) => {\n      initialized = true;\n      lastValue = event;\n    });\n    const unsubscribeConductor = conductor.on(async () => {\n      if (initialized) {\n        await orchestratedEvent(lastValue);\n        initialized = false;\n      }\n    });\n\n    const orchestratedEvent = new Event<T, R>(unsubscribe.post(unsubscribeConductor));\n    return orchestratedEvent;\n  }\n  /**\n   * Creates a debounced event that delays triggering until after a specified interval has elapsed\n   * following the last time it was invoked. This method is particularly useful for limiting the rate\n   * at which a function is executed. Common use cases include handling rapid user inputs, window resizing,\n   * or scroll events.\n   *\n   * @param {number} interval - The amount of time to wait (in milliseconds) before firing the debounced event.\n   * @returns {Event<T, R>} An event of debounced events.\n   *\n   * ```typescript\n   * const debouncedEvent = textInputEvent.debounce(100);\n   * debouncedEvent.on((str) => console.log(str)); // only 'text' is emitted\n   * await event('t');\n   * await event('te');\n   * await event('tex');\n   * await event('text');\n   * ```\n   */\n  debounce(interval: number): Event<Awaited<T>, unknown> {\n    let controller = new AbortController();\n\n    return this.pipe(async function* (value) {\n      controller.abort();\n      controller = new AbortController();\n      const complete = await setTimeoutAsync(interval, controller.signal);\n      if (complete) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a throttled event that emits values at most once per specified interval.\n   *\n   * This is useful for controlling the rate of event emissions, especially for high-frequency events.\n   * The throttled event will immediately emit the first value, and then only emit subsequent values\n   * if the specified interval has passed since the last emission.\n   *\n   * @param interval - The time interval (in milliseconds) between allowed emissions.\n   * @returns A new Event that emits throttled values.\n   *\n   * ```typescript\n   * const scrollEvent = new Event();\n   * const throttledScroll = scrollEvent.throttle(100); // Emit at most every 100ms\n   * throttledScroll.on(() => console.log(\"Throttled scroll event\"));\n   * ```\n   */\n  throttle(interval: number): Event<Awaited<T>, unknown> {\n    let timeout = 0;\n    let pendingValue: T;\n    let hasPendingValue = false;\n\n    return this.pipe(async function* (value) {\n      const now = Date.now();\n      if (timeout <= now) {\n        timeout = now + interval;\n        yield value;\n      } else {\n        pendingValue = value;\n        if (!hasPendingValue) {\n          hasPendingValue = true;\n          await setTimeoutAsync(timeout - now);\n          timeout = now + interval;\n          hasPendingValue = false;\n          yield pendingValue;\n        }\n      }\n    });\n  }\n\n  /**\n   * Aggregates multiple event emissions into batches and emits the batched events either at specified\n   * time intervals or when the batch reaches a predefined size. This method is useful for grouping\n   * a high volume of events into manageable chunks, such as logging or processing data in bulk.\n   *\n   * @param {number} interval - The time in milliseconds between batch emissions.\n   * @param {number} [size] - Optional. The maximum size of each batch. If specified, triggers a batch emission\n   * once the batch reaches this size, regardless of the interval.\n   * @returns {Event<T[], R>} An event of the batched results.\n   *\n   * ```typescript\n   * // Batch messages for bulk processing every 1 second or when 10 messages are collected\n   * const messageEvent = createEvent<string, void>();\n   * const batchedMessageEvent = messageEvent.batch(1000, 10);\n   * batchedMessageEvent.on((messages) => console.log('Batched Messages:', messages));\n   * ```\n   */\n  batch(interval: number, size?: number): Event<T[], R> {\n    let controller = new AbortController();\n    const batch: T[] = [];\n\n    return this.pipe(async function* (value) {\n      batch.push(value);\n      if (size !== undefined && batch.length >= size) {\n        controller.abort();\n        yield batch.splice(0);\n      }\n      if (batch.length === 1) {\n        controller = new AbortController();\n        const complete = await setTimeoutAsync(interval, controller.signal);\n        if (complete) {\n          yield batch.splice(0);\n        }\n      }\n    });\n  }\n\n  /**\n   * Creates a queue from the event, where each emitted value is sequentially processed. The returned object allows popping elements\n   * from the queue, ensuring that elements are handled one at a time. This method is ideal for scenarios where order and sequential processing are critical.\n   *\n   * @returns {Queue<T>} An object representing the queue. The 'pop' method retrieves the next element from the queue, while 'stop' halts further processing.\n   *\n   * ```typescript\n   * // Queueing tasks for sequential execution\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 2\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   * ```\n   */\n  queue(): Queue<T> {\n    const queue: T[] = [];\n    let done = false;\n    const valueEvent = new Event<void>();\n    const unsubscribe = this.on(async (value) => {\n      queue.push(value);\n      await valueEvent();\n    });\n\n    const pop = async () => {\n      if (!queue.length) {\n        await valueEvent;\n      }\n      return queue.shift()!;\n    };\n    const stop = async () => {\n      await unsubscribe();\n      done = true;\n      await valueEvent();\n    };\n\n    return {\n      pop,\n      stop,\n      get stopped() {\n        return done;\n      },\n      [Symbol.asyncIterator]() {\n        return {\n          next: async () => {\n            return { value: await pop(), done };\n          },\n        };\n      },\n    };\n  }\n}\n\nexport type EventParameters<T> = T extends Event<infer P, any> ? P : never;\n\nexport type EventResult<T> = T extends Event<any, infer R> ? R : never;\n\nexport type AllEventsParameters<T extends Event<any, any>[]> = { [K in keyof T]: EventParameters<T[K]> }[number];\n\nexport type AllEventsResults<T extends Event<any, any>[]> = { [K in keyof T]: EventResult<T[K]> }[number];\n\n/**\n * Merges multiple events into a single event. This function takes any number of `Event` instances\n * and returns a new `Event` that triggers whenever any of the input events trigger. The parameters\n * and results of the merged event are derived from the input events, providing a flexible way to\n * handle multiple sources of events in a unified manner.\n *\n * @template Events - An array of `Event` instances.\n * @param {...Events} events - A rest parameter that takes multiple events to be merged.\n * @returns {Event<AllEventsParameters<Events>, AllEventsResults<Events>>} - Returns a new `Event` instance\n *           that triggers with the parameters and results of any of the merged input events.\n *\n * ```typescript\n * // Merging mouse and keyboard events into a single event\n * const mouseEvent = createEvent<MouseEvent>();\n * const keyboardEvent = createEvent<KeyboardEvent>();\n * const inputEvent = merge(mouseEvent, keyboardEvent);\n * inputEvent.on(event => console.log('Input event:', event));\n * ```\n */\nexport const merge = <Events extends Event<any, any>[]>(...events: Events): Event<AllEventsParameters<Events>, AllEventsResults<Events>> => {\n  const mergedEvent = new Event<AllEventsParameters<Events>, AllEventsResults<Events>>();\n  events.forEach((event) => event.on(mergedEvent));\n  return mergedEvent;\n};\n\n/**\n * Creates a periodic event that triggers at a specified interval. The event will automatically emit\n * an incrementing counter value each time it triggers, starting from zero. This function is useful\n * for creating time-based triggers within an application, such as updating UI elements, polling,\n * or any other timed operation.\n *\n * @template R - The return type of the event handler function, defaulting to `void`.\n * @param {number} interval - The interval in milliseconds at which the event should trigger.\n * @returns {Event<number, R>} - An `Event` instance that triggers at the specified interval,\n *           emitting an incrementing counter value.\n *\n * ```typescript\n * // Creating an interval event that logs a message every second\n * const tickEvent = createInterval(1000);\n * tickEvent.on(tickNumber => console.log('Tick:', tickNumber));\n * ```\n */\nexport const createInterval = <R = unknown>(interval: number): Event<number, R> => {\n  let counter = 0;\n  const intervalEvent = new Event<number, R>(() => clearInterval(timerId));\n  const timerId: ReturnType<typeof setInterval> = setInterval(() => intervalEvent(counter++), interval);\n  return intervalEvent;\n};\n\n/**\n * Creates a new instance of the `Event` class, which allows for the registration of event handlers that get called when the event is emitted.\n * This factory function simplifies the creation of events by encapsulating the instantiation logic, providing a clean and simple API for event creation.\n *\n * @typeParam T - The tuple of argument types that the event will accept.\n * @typeParam R - The return type of the event handler function, which is emitted after processing the event data.\n * @returns {Event<T, R>} - A new instance of the `Event` class, ready to have listeners added to it.\n *\n * ```typescript\n * // Create a new event that accepts a string and returns the string length\n * const myEvent = createEvent<string, number>();\n * myEvent.on((str: string) => str.length);\n * myEvent('hello').then(results => console.log(results)); // Logs: [5]\n * ```\n */\nexport const createEvent = <T = unknown, R = unknown>(): Event<T, R> => new Event<T, R>();\n\nexport default createEvent;\n\n/**\n * A type helper that extracts the event listener type\n *\n * @typeParam E - The event type.\n */\nexport type EventHandler<E> = E extends Event<infer T, infer R> ? Listener<T, R> : never;\n\n/**\n * A type helper that extracts the event filter type\n *\n * @typeParam E The event type to filter.\n */\nexport type EventFilter<E> = FilterFunction<EventParameters<E>>;\n\n/**\n * A type helper that extracts the event predicate type\n *\n * @typeParam E The event type to predicate.\n */\nexport type EventPredicate<E, P extends EventParameters<E>> = Predicate<EventParameters<E>, P>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The event type to map.\n * @typeParam M The new type to map `E` to.\n */\nexport type EventMapper<E, M> = Mapper<EventParameters<E>, M>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The type of event to reduce.\n * @typeParam M The type of reduced event.\n */\nexport type EventReducer<E, R> = Reducer<EventParameters<E>, R>;\n"],"names":["Callable","Event","Unsubscribe","createEvent","createInterval","merge","removeListener","setTimeoutAsync","listeners","listener","index","indexOf","wasRemoved","splice","timeout","signal","Promise","resolve","timerId","setTimeout","addEventListener","clearTimeout","Function","constructor","func","Object","setPrototypeOf","prototype","callback","pre","post","countdown","count","spies","dispose","value","all","map","clear","_error","error","size","length","lacks","has","off","forEach","spy","on","push","once","oneTimeListener","event","then","onfulfilled","onrejected","promise","v","Symbol","asyncIterator","queue","doneEvent","emitEvent","unsubscribe","target","next","shift","done","undefined","return","pipe","generator","generatedValue","result","catch","e","filter","first","filteredEvent","mapper","reduce","reducer","init","hasInit","expand","expander","values","orchestrate","conductor","initialized","lastValue","unsubscribeConductor","orchestratedEvent","debounce","interval","controller","AbortController","abort","complete","throttle","pendingValue","hasPendingValue","now","Date","batch","valueEvent","pop","stop","stopped","events","mergedEvent","counter","intervalEvent","clearInterval","setInterval"],"mappings":"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"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type MaybePromise<T> = Promise<T> | PromiseLike<T> | T;\n\nexport interface Callback<R = void> {\n  (): MaybePromise<R>;\n}\n\nexport interface Listener<T, R = unknown> {\n  (event: T): MaybePromise<R | void>;\n}\n\nexport interface FilterFunction<T> {\n  (event: T): MaybePromise<boolean>;\n}\n\nexport interface Predicate<T, P extends T> {\n  (event: T): event is P;\n}\n\nexport type Filter<T, P extends T> = Predicate<T, P> | FilterFunction<T>;\n\nexport interface Mapper<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\nexport interface Reducer<T, R> {\n  (result: R, event: T): MaybePromise<R>;\n}\n\nexport interface Expander<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\n/**\n * Removes a listener from the provided array of listeners. It searches for the listener and removes all instances of it from the array.\n * This method ensures that the listener is fully unregistered, preventing any residual calls to a potentially deprecated handler.\n *\n * @internal\n * @param {Listener<T, R>[]} listeners - The array of listeners from which to remove the listener.\n * @param {Listener<T, R>} listener - The listener function to remove from the list of listeners.\n * @returns {boolean} - Returns `true` if the listener was found and removed, `false` otherwise.\n *\n * @template T - The type of the event that listeners are associated with.\n * @template R - The type of the return value that listeners are expected to return.\n *\n * ```typescript\n * // Assuming an array of listeners for click events\n * const listeners = [onClickHandler1, onClickHandler2];\n * const wasRemoved = removeListener(listeners, onClickHandler1);\n * console.log(wasRemoved); // Output: true\n * ```\n */\nexport const removeListener = (listeners: unknown[], listener: unknown): boolean => {\n  let index = listeners.indexOf(listener);\n  const wasRemoved = index !== -1;\n  while (~index) {\n    listeners.splice(index, 1);\n    index = listeners.indexOf(listener);\n  }\n  return wasRemoved;\n};\n\n/**\n * @internal\n * @param timeout\n * @param signal\n * @returns\n */\nexport const setTimeoutAsync = (timeout: number, signal?: AbortSignal) =>\n  new Promise<boolean>((resolve) => {\n    const timerId = setTimeout(resolve, timeout, true);\n    signal?.addEventListener('abort', () => {\n      clearTimeout(timerId);\n      resolve(false);\n    });\n  });\n\n/**\n * An abstract class that extends the built-in Function class. It allows instances of the class\n * to be called as functions. When an instance of Callable is called as a function, it will\n * call the function passed to its constructor with the same arguments.\n * @internal\n */\nexport abstract class Callable extends Function {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  constructor(func: Function) {\n    super();\n    return Object.setPrototypeOf(func, new.target.prototype);\n  }\n}\n\nexport interface Unsubscribe {\n  (): MaybePromise<void>;\n}\n\n/**\n * @internal\n */\nexport class Unsubscribe extends Callable {\n  private _done = false;\n\n  constructor(callback: Callback) {\n    super(() => {\n      this._done = true;\n      callback();\n    });\n  }\n\n  get done() {\n    return this._done;\n  }\n\n  pre(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await callback();\n      await this();\n    });\n  }\n\n  post(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await this();\n      await callback();\n    });\n  }\n\n  countdown(count: number): Unsubscribe {\n    return new Unsubscribe(async () => {\n      if (!--count) {\n        await this();\n      }\n    });\n  }\n}\n\nexport interface Event<T = any, R = any> {\n  (event: T): Promise<(void | Awaited<R>)[]>;\n}\n\nenum SpyType {\n  Add,\n  Remove,\n}\n\n/**\n * A class representing an anonymous event that can be listened to or triggered.\n *\n * @template T - The event type.\n * @template R - The return type of the event.\n */\nexport class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLike<T> {\n  /**\n   * The array of listeners for the event.\n   */\n  private listeners: Listener<T, R>[];\n\n  private spies: Array<(listener: Listener<T, R> | void, type: SpyType) => void> = [];\n\n  private _disposed = false;\n\n  /**\n   * A function that disposes of the event and its listeners.\n   */\n  readonly dispose: Callback;\n\n  /**\n   * Creates a new event.\n   *\n   * @param dispose - A function to call on the event disposal.\n   *\n   * ```typescript\n   * // Create a click event.\n   * const clickEvent = new Event<[x: number, y: number], void>();\n   * clickEvent.on(([x, y]) => console.log(`Clicked at ${x}, ${y}`));\n   * ```\n   */\n  constructor(dispose?: Callback) {\n    const listeners: Listener<T, R>[] = [];\n    // passes listeners exceptions to catch method\n    super(async (value: T): Promise<(void | Awaited<R>)[]> => Promise.all(listeners.map(async (listener) => listener(await value))));\n    this.listeners = listeners;\n\n    this.dispose = async () => {\n      this._disposed = true;\n      void this.clear();\n      await this._error?.dispose();\n      await dispose?.();\n    };\n  }\n\n  private _error?: Event<unknown>;\n\n  /**\n   * Error event that emits errors.\n   *\n   * @returns {Event<unknown>} The error event.\n   */\n  get error(): Event<unknown> {\n    return (this._error ??= new Event<unknown>());\n  }\n\n  /**\n   * The number of listeners for the event.\n   *\n   * @readonly\n   * @type {number}\n   */\n  get size(): number {\n    return this.listeners.length;\n  }\n\n  /**\n   * Checks if the event has been disposed.\n   * @returns {boolean} `true` if the event has been disposed; otherwise, `false`.\n   */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /**\n   * Checks if the given listener is NOT registered for this event.\n   *\n   * @param listener - The listener function to check against the registered listeners.\n   * @returns `true` if the listener is not already registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Check if a listener is not already added\n   * if (event.lacks(myListener)) {\n   *   event.on(myListener);\n   * }\n   * ```\n   */\n  lacks(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) === -1;\n  }\n\n  /**\n   * Checks if the given listener is registered for this event.\n   *\n   * @param listener - The listener function to check.\n   * @returns `true` if the listener is currently registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Verify if a listener is registered\n   * if (event.has(myListener)) {\n   *   console.log('Listener is already registered');\n   * }\n   * ```\n   */\n  has(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) !== -1;\n  }\n\n  /**\n   * Removes a specific listener from this event.\n   *\n   * @param listener - The listener to remove.\n   * @returns The event instance, allowing for method chaining.\n   *\n   * ```typescript\n   * // Remove a listener\n   * event.off(myListener);\n   * ```\n   */\n  off(listener: Listener<T, R>): this {\n    if (removeListener(this.listeners, listener) && this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener, SpyType.Remove));\n    }\n    return this;\n  }\n\n  /**\n   * Registers a listener that gets triggered whenever the event is emitted.\n   * This is the primary method for adding event handlers that will react to the event being triggered.\n   *\n   * @param listener - The function to call when the event occurs.\n   * @returns An object that can be used to unsubscribe the listener, ensuring easy cleanup.\n   *\n   * ```typescript\n   * // Add a listener to an event\n   * const unsubscribe = event.on((data) => {\n   *   console.log('Event data:', data);\n   * });\n   * ```\n   */\n  on(listener: Listener<T, R>): Unsubscribe {\n    this.listeners.push(listener);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener, SpyType.Add));\n    }\n    return new Unsubscribe(() => {\n      void this.off(listener);\n    });\n  }\n\n  /**\n   * Adds a listener that will be called only once the next time the event is emitted.\n   * This method is useful for one-time notifications or single-trigger scenarios.\n   *\n   * @param listener - The listener to trigger once.\n   * @returns An object that can be used to remove the listener if the event has not yet occurred.\n   *\n   * ```typescript\n   * // Register a one-time listener\n   * const onceUnsubscribe = event.once((data) => {\n   *   console.log('Received data once:', data);\n   * });\n   * ```\n   */\n  once(listener: Listener<T, R>): Unsubscribe {\n    const oneTimeListener = (event: T) => {\n      void this.off(oneTimeListener);\n      return listener(event);\n    };\n    return this.on(oneTimeListener);\n  }\n\n  /**\n   * Removes all listeners from the event, effectively resetting it. This is useful when you need to\n   * cleanly dispose of all event handlers to prevent memory leaks or unwanted triggerings after certain conditions.\n   *\n   * @returns {this} The instance of the event, allowing for method chaining.\n   *\n   * ```typescript\n   * const myEvent = new Event();\n   * myEvent.on(data => console.log(data));\n   * myEvent.clear(); // Clears all listeners\n   * ```\n   */\n  clear(): this {\n    this.listeners.splice(0);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy(undefined, SpyType.Remove));\n    }\n    return this;\n  }\n\n  /**\n   * Enables the `Event` to be used in a Promise chain, resolving with the first emitted value.\n   *\n   * @template TResult1 - The type of the fulfilled value returned by `onfulfilled` (defaults to the event's type).\n   * @template TResult2 - The type of the rejected value returned by `onrejected` (defaults to `never`).\n   * @param onfulfilled - A function called when the event emits its first value.\n   * @param onrejected - A function called if an error occurs before the event emits.\n   * @returns A Promise that resolves with the result of `onfulfilled` or `onrejected`.\n   *\n   * ```typescript\n   * const clickEvent = new Event<[number, number]>();\n   * await clickEvent;\n   * ```\n   */\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n  ): Promise<TResult1 | TResult2> {\n    const promise = new Promise<T>((resolve) => this.once(resolve));\n\n    return promise.then(onfulfilled, onrejected);\n  }\n\n  /**\n   * A promise that resolves with the first emitted value from this event.\n   *\n   * @returns {Promise<T>} The promise value.\n   */\n  get promise(): Promise<T> {\n    return this.then((v) => v);\n  }\n\n  /**\n   * Makes this event iterable using `for await...of` loops.\n   *\n   * @returns An async iterator that yields values as they are emitted by this event.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers\n   * const numberEvent = new Event<number>();\n   * (async () => {\n   *   for await (const num of numberEvent) {\n   *     console.log('Number:', num);\n   *   }\n   * })();\n   * await numberEvent(1);\n   * await numberEvent(2);\n   * await numberEvent(3);\n   * ```\n   */\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    const queue: T[] = [];\n    const doneEvent = new Event<boolean>();\n    const emitEvent = async (value: T) => {\n      queue.push(value);\n      await doneEvent(false);\n    };\n    const unsubscribe = this.on(emitEvent).pre(async () => {\n      removeListener(this.spies, spy);\n      queue.splice(0);\n      await doneEvent.dispose();\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {\n      if (target === emitEvent && action === SpyType.Remove) {\n        void doneEvent(true);\n        void unsubscribe();\n      }\n    };\n\n    this.spies.push(spy);\n    return {\n      async next() {\n        if (queue.length) {\n          return { value: queue.shift()!, done: false };\n        }\n        if (!(await doneEvent)) {\n          return { value: queue.shift()!, done: false };\n        }\n        return { value: undefined, done: true };\n      },\n      async return(value: unknown) {\n        await unsubscribe();\n        return { done: true, value };\n      },\n    };\n  }\n\n  /**\n   * Transforms the event's values using a generator function, creating a new `Event` that emits the transformed values.\n   *\n   * @template PT - The type of values emitted by the transformed `Event`.\n   * @template PR - The return type of the listeners of the transformed `Event`.\n   * @param generator - A function that takes the original event's value and returns a generator (sync or async) that yields the transformed values.\n   * @returns A new `Event` instance that emits the transformed values.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  pipe<PT, R>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): Event<PT, R> {\n    const emitEvent = async (value: T) => {\n      try {\n        for await (const generatedValue of generator(value)) {\n          await result(generatedValue).catch((e) => result.error(e));\n        }\n      } catch (e) {\n        await result.error(e);\n      }\n    };\n\n    const unsubscribe = this.on(emitEvent).pre(() => {\n      removeListener(this.spies, spy);\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {\n      if (target === emitEvent && action === SpyType.Remove) {\n        void unsubscribe();\n      }\n    };\n    this.spies.push(spy);\n\n    const result = new Event<PT, R>(unsubscribe);\n    return result;\n  }\n\n  /**\n   * Creates an async generator that yields values as they are emitted by this event.\n   *\n   * @template PT - The type of values yielded by the async generator.\n   * @param generator - An optional function that takes the original event's value and returns a generator (sync or async)\n   *                  that yields values to include in the async generator.\n   * @returns An async generator that yields values from this event as they occur.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  async *generator<PT>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): AsyncGenerator<Awaited<PT>, void, unknown> {\n    for await (const value of this.pipe(generator)) {\n      yield value;\n    }\n  }\n\n  /**\n   * Filters events, creating a new event that only triggers when the provided filter function returns `true`.\n   * This method can be used to selectively process events that meet certain criteria.\n   *\n   * @param {Filter<T, P>} predicate The filter function or predicate to apply to each event.\n   * @returns {Event<P, R>} A new event that only triggers for filtered events.\n   *\n   * ```typescript\n   * const keyPressedEvent = new Event<string>();\n   * const enterPressedEvent = keyPressedEvent.filter(key => key === 'Enter');\n   * enterPressedEvent.on(() => console.log('Enter key was pressed.'));\n   * ```\n   */\n  filter<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  filter<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  filter<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    return this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that will only be triggered once when the provided filter function returns `true`.\n   * This method is useful for handling one-time conditions in a stream of events.\n   *\n   * @param {Filter<T, P>} predicate - The filter function or predicate.\n   * @returns {Event<P, R>} A new event that will be triggered only once when the filter condition is met.\n   *\n   * ```typescript\n   * const sizeChangeEvent = new Event<number>();\n   * const sizeReachedEvent = sizeChangeEvent.first(size => size > 1024);\n   * sizeReachedEvent.on(() => console.log('Size threshold exceeded.'));\n   * ```\n   */\n  first<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  first<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  first<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    const filteredEvent = this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n        await filteredEvent.dispose();\n      }\n    });\n    return filteredEvent;\n  }\n\n  /**\n   * Transforms the data emitted by this event using a mapping function. Each emitted event is processed by the `mapper`\n   * function, which returns a new value that is then emitted by the returned `Event` instance. This is useful for data transformation\n   * or adapting the event's data structure.\n   *\n   * @template M The type of data that the mapper function will produce.\n   * @template MR The type of data emitted by the mapped event, usually related to or the same as `M`.\n   * @param {Mapper<T, M>} mapper A function that takes the original event data and returns the transformed data.\n   * @returns {Event<M, MR>} A new `Event` instance that emits the mapped values.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers, create a new event that emits their squares.\n   * const numberEvent = new Event<number>();\n   * const squaredEvent = numberEvent.map(num => num * num);\n   * squaredEvent.on(squared => console.log('Squared number:', squared));\n   * await numberEvent(5); // Logs: \"Squared number: 25\"\n   * ```\n   */\n  map<M, MR = R>(mapper: Mapper<T, M>): Event<Awaited<M>, MR> {\n    return this.pipe(async function* (value) {\n      yield await mapper(value);\n    });\n  }\n\n  /**\n   * Accumulates the values emitted by this event using a reducer function, starting from an initial value. The reducer\n   * function takes the accumulated value and the latest emitted event data, then returns a new accumulated value. This\n   * new value is then emitted by the returned `Event` instance. This is particularly useful for accumulating state over time.\n   *\n   * @template A The type of the accumulator value.\n   * @template AR The type of data emitted by the reduced event, usually the same as `A`.\n   * @param {Reducer<T, A>} reducer A function that takes the current accumulated value and the new event data, returning the new accumulated value.\n   * @param {A} init The initial value of the accumulator.\n   * @returns {Event<A, AR>} A new `Event` instance that emits the reduced value.\n   *\n   * ```typescript\n   * const sumEvent = numberEvent.reduce((a, b) => a + b, 0);\n   * sumEvent.on((sum) => console.log(sum)); // 1, 3, 6\n   * await sumEvent(1);\n   * await sumEvent(2);\n   * await sumEvent(3);\n   * ```\n   */\n  reduce<A, AR = R>(reducer: Reducer<T, A>, init?: A): Event<Awaited<A>, AR>;\n  reduce<A, AR = R>(reducer: Reducer<T, A>, ...init: unknown[]): Event<Awaited<A>, AR> {\n    let hasInit = init.length === 1;\n    let result = init[0] as A | undefined;\n\n    return this.pipe(async function* (value) {\n      if (hasInit) {\n        result = await reducer(result!, value);\n        yield result;\n      } else {\n        result = value as unknown as A;\n        hasInit = true;\n      }\n    });\n  }\n\n  /**\n   * Transforms each event's data into multiple events using an expander function. The expander function takes\n   * the original event's data and returns an array of new data elements, each of which will be emitted individually\n   * by the returned `Event` instance. This method is useful for scenarios where an event's data can naturally\n   * be expanded into multiple, separate pieces of data which should each trigger further processing independently.\n   *\n   * @template ET - The type of data elements in the array returned by the expander function.\n   * @template ER - The type of responses emitted by the expanded event, usually related to or the same as `ET`.\n   * @param {Expander<T, ET[]>} expander - A function that takes the original event data and returns an array of new data elements.\n   * @returns {Event<ET, ER>} - A new `Event` instance that emits each value from the array returned by the expander function.\n   *\n   * ```typescript\n   * // Assuming an event that emits a sentence, create a new event that emits each word from the sentence separately.\n   * const sentenceEvent = new Event<string>();\n   * const wordEvent = sentenceEvent.expand(sentence => sentence.split(' '));\n   * wordEvent.on(word => console.log('Word:', word));\n   * await sentenceEvent('Hello world'); // Logs: \"Word: Hello\", \"Word: world\"\n   * ```\n   */\n  expand<ET, ER>(expander: Expander<T, ET[]>): Event<Awaited<ET>, ER> {\n    return this.pipe(async function* (value) {\n      const values = await expander(value);\n      for (const value of values) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that emits values based on a conductor event. The orchestrated event will emit the last value\n   * captured from the original event each time the conductor event is triggered. This method is useful for synchronizing\n   * events, where the emission of one event controls the timing of another.\n   *\n   * @template T The type of data emitted by the original event.\n   * @template R The type of data emitted by the orchestrated event, usually the same as `T`.\n   * @param {Event<unknown, unknown>} conductor An event that signals when the orchestrated event should emit.\n   * @returns {Event<T, R>} An orchestrated event that emits values based on the conductor's trigger.\n   *\n   * ```typescript\n   * const rightClickPositionEvent = mouseMoveEvent.orchestrate(mouseRightClickEvent);\n   * ```\n   *\n   * ```typescript\n   * // An event that emits whenever a \"tick\" event occurs.\n   * const tickEvent = new Event<void>();\n   * const dataEvent = new Event<string>();\n   * const synchronizedEvent = dataEvent.orchestrate(tickEvent);\n   * synchronizedEvent.on(data => console.log('Data on tick:', data));\n   * await dataEvent('Hello');\n   * await dataEvent('World!');\n   * await tickEvent(); // Logs: \"Data on tick: World!\"\n   * ```\n   */\n  orchestrate(conductor: Event<any, any>): Event<T, R> {\n    let initialized = false;\n    let lastValue: T;\n    const unsubscribe = this.on(async (event) => {\n      initialized = true;\n      lastValue = event;\n    });\n    const unsubscribeConductor = conductor.on(async () => {\n      if (initialized) {\n        await orchestratedEvent(lastValue);\n        initialized = false;\n      }\n    });\n\n    const orchestratedEvent = new Event<T, R>(unsubscribe.post(unsubscribeConductor));\n    return orchestratedEvent;\n  }\n  /**\n   * Creates a debounced event that delays triggering until after a specified interval has elapsed\n   * following the last time it was invoked. This method is particularly useful for limiting the rate\n   * at which a function is executed. Common use cases include handling rapid user inputs, window resizing,\n   * or scroll events.\n   *\n   * @param {number} interval - The amount of time to wait (in milliseconds) before firing the debounced event.\n   * @returns {Event<T, R>} An event of debounced events.\n   *\n   * ```typescript\n   * const debouncedEvent = textInputEvent.debounce(100);\n   * debouncedEvent.on((str) => console.log(str)); // only 'text' is emitted\n   * await event('t');\n   * await event('te');\n   * await event('tex');\n   * await event('text');\n   * ```\n   */\n  debounce(interval: number): Event<Awaited<T>, unknown> {\n    let controller = new AbortController();\n\n    return this.pipe(async function* (value) {\n      controller.abort();\n      controller = new AbortController();\n      const complete = await setTimeoutAsync(interval, controller.signal);\n      if (complete) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a throttled event that emits values at most once per specified interval.\n   *\n   * This is useful for controlling the rate of event emissions, especially for high-frequency events.\n   * The throttled event will immediately emit the first value, and then only emit subsequent values\n   * if the specified interval has passed since the last emission.\n   *\n   * @param interval - The time interval (in milliseconds) between allowed emissions.\n   * @returns A new Event that emits throttled values.\n   *\n   * ```typescript\n   * const scrollEvent = new Event();\n   * const throttledScroll = scrollEvent.throttle(100); // Emit at most every 100ms\n   * throttledScroll.on(() => console.log(\"Throttled scroll event\"));\n   * ```\n   */\n  throttle(interval: number): Event<Awaited<T>, unknown> {\n    let timeout = 0;\n    let pendingValue: T;\n    let hasPendingValue = false;\n\n    return this.pipe(async function* (value) {\n      const now = Date.now();\n      if (timeout <= now) {\n        timeout = now + interval;\n        yield value;\n      } else {\n        pendingValue = value;\n        if (!hasPendingValue) {\n          hasPendingValue = true;\n          await setTimeoutAsync(timeout - now);\n          timeout = now + interval;\n          hasPendingValue = false;\n          yield pendingValue;\n        }\n      }\n    });\n  }\n\n  /**\n   * Aggregates multiple event emissions into batches and emits the batched events either at specified\n   * time intervals or when the batch reaches a predefined size. This method is useful for grouping\n   * a high volume of events into manageable chunks, such as logging or processing data in bulk.\n   *\n   * @param {number} interval - The time in milliseconds between batch emissions.\n   * @param {number} [size] - Optional. The maximum size of each batch. If specified, triggers a batch emission\n   * once the batch reaches this size, regardless of the interval.\n   * @returns {Event<T[], R>} An event of the batched results.\n   *\n   * ```typescript\n   * // Batch messages for bulk processing every 1 second or when 10 messages are collected\n   * const messageEvent = createEvent<string, void>();\n   * const batchedMessageEvent = messageEvent.batch(1000, 10);\n   * batchedMessageEvent.on((messages) => console.log('Batched Messages:', messages));\n   * ```\n   */\n  batch(interval: number, size?: number): Event<T[], R> {\n    let controller = new AbortController();\n    const batch: T[] = [];\n\n    return this.pipe(async function* (value) {\n      batch.push(value);\n      if (size !== undefined && batch.length >= size) {\n        controller.abort();\n        yield batch.splice(0);\n      }\n      if (batch.length === 1) {\n        controller = new AbortController();\n        const complete = await setTimeoutAsync(interval, controller.signal);\n        if (complete) {\n          yield batch.splice(0);\n        }\n      }\n    });\n  }\n\n  /**\n   * Creates a queue from the event, where each emitted value is sequentially processed. The returned object allows popping elements\n   * from the queue, ensuring that elements are handled one at a time. This method is ideal for scenarios where order and sequential processing are critical.\n   *\n   * @returns {Queue<T>} An object representing the queue. The 'pop' method retrieves the next element from the queue, while 'stop' halts further processing.\n   *\n   * ```typescript\n   * // Queueing tasks for sequential execution\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1\n   *   // Queue also can be used as a Promise\n   *   console.log('Processing:', await taskQueue); // Processing: Task 2\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   *```\n   *\n   *```typescript\n   * // Additionally, the queue can be used as an async iterator\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   for await (const task of taskQueue) {\n   *     console.log('Processing:', task);\n   *   }\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   * ```\n   *\n   */\n  queue(): Queue<T> {\n    const queue: T[] = [];\n    let done = false;\n    const valueEvent = new Event<void>();\n\n    const unsubscribe = this.on(async (value) => {\n      queue.push(value);\n      await valueEvent();\n    });\n\n    const pop = async () => {\n      if (!queue.length) {\n        await valueEvent;\n      }\n      return queue.shift()!;\n    };\n    const stop = async () => {\n      await unsubscribe();\n      done = true;\n      await valueEvent();\n    };\n\n    return {\n      pop,\n      stop,\n      get stopped() {\n        return done;\n      },\n      then<TResult1 = T, TResult2 = never>(\n        onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n        onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n      ): Promise<TResult1 | TResult2> {\n        return this.pop().then(onfulfilled, onrejected);\n      },\n      [Symbol.asyncIterator]() {\n        return {\n          next: async () => {\n            return { value: await pop(), done };\n          },\n        };\n      },\n    };\n  }\n}\n\nexport interface Queue<T> extends AsyncIterable<T>, PromiseLike<T> {\n  pop(): Promise<T>;\n  stop(): Promise<void>;\n  stopped: boolean;\n}\n\nexport type EventParameters<T> = T extends Event<infer P, any> ? P : never;\n\nexport type EventResult<T> = T extends Event<any, infer R> ? R : never;\n\nexport type AllEventsParameters<T extends Event<any, any>[]> = { [K in keyof T]: EventParameters<T[K]> }[number];\n\nexport type AllEventsResults<T extends Event<any, any>[]> = { [K in keyof T]: EventResult<T[K]> }[number];\n\n/**\n * Merges multiple events into a single event. This function takes any number of `Event` instances\n * and returns a new `Event` that triggers whenever any of the input events trigger. The parameters\n * and results of the merged event are derived from the input events, providing a flexible way to\n * handle multiple sources of events in a unified manner.\n *\n * @template Events - An array of `Event` instances.\n * @param {...Events} events - A rest parameter that takes multiple events to be merged.\n * @returns {Event<AllEventsParameters<Events>, AllEventsResults<Events>>} - Returns a new `Event` instance\n *           that triggers with the parameters and results of any of the merged input events.\n *\n * ```typescript\n * // Merging mouse and keyboard events into a single event\n * const mouseEvent = createEvent<MouseEvent>();\n * const keyboardEvent = createEvent<KeyboardEvent>();\n * const inputEvent = merge(mouseEvent, keyboardEvent);\n * inputEvent.on(event => console.log('Input event:', event));\n * ```\n */\nexport const merge = <Events extends Event<any, any>[]>(...events: Events): Event<AllEventsParameters<Events>, AllEventsResults<Events>> => {\n  const mergedEvent = new Event<AllEventsParameters<Events>, AllEventsResults<Events>>();\n  events.forEach((event) => event.on(mergedEvent));\n  return mergedEvent;\n};\n\n/**\n * Creates a periodic event that triggers at a specified interval. The event will automatically emit\n * an incrementing counter value each time it triggers, starting from zero. This function is useful\n * for creating time-based triggers within an application, such as updating UI elements, polling,\n * or any other timed operation.\n *\n * @template R - The return type of the event handler function, defaulting to `void`.\n * @param {number} interval - The interval in milliseconds at which the event should trigger.\n * @returns {Event<number, R>} - An `Event` instance that triggers at the specified interval,\n *           emitting an incrementing counter value.\n *\n * ```typescript\n * // Creating an interval event that logs a message every second\n * const tickEvent = createInterval(1000);\n * tickEvent.on(tickNumber => console.log('Tick:', tickNumber));\n * ```\n */\nexport const createInterval = <R = unknown>(interval: number): Event<number, R> => {\n  let counter = 0;\n  const intervalEvent = new Event<number, R>(() => clearInterval(timerId));\n  const timerId: ReturnType<typeof setInterval> = setInterval(() => intervalEvent(counter++), interval);\n  return intervalEvent;\n};\n\n/**\n * Creates a new instance of the `Event` class, which allows for the registration of event handlers that get called when the event is emitted.\n * This factory function simplifies the creation of events by encapsulating the instantiation logic, providing a clean and simple API for event creation.\n *\n * @typeParam T - The tuple of argument types that the event will accept.\n * @typeParam R - The return type of the event handler function, which is emitted after processing the event data.\n * @returns {Event<T, R>} - A new instance of the `Event` class, ready to have listeners added to it.\n *\n * ```typescript\n * // Create a new event that accepts a string and returns the string length\n * const myEvent = createEvent<string, number>();\n * myEvent.on((str: string) => str.length);\n * myEvent('hello').then(results => console.log(results)); // Logs: [5]\n * ```\n */\nexport const createEvent = <T = unknown, R = unknown>(): Event<T, R> => new Event<T, R>();\n\nexport default createEvent;\n\n/**\n * A type helper that extracts the event listener type\n *\n * @typeParam E - The event type.\n */\nexport type EventHandler<E> = E extends Event<infer T, infer R> ? Listener<T, R> : never;\n\n/**\n * A type helper that extracts the event filter type\n *\n * @typeParam E The event type to filter.\n */\nexport type EventFilter<E> = FilterFunction<EventParameters<E>>;\n\n/**\n * A type helper that extracts the event predicate type\n *\n * @typeParam E The event type to predicate.\n */\nexport type EventPredicate<E, P extends EventParameters<E>> = Predicate<EventParameters<E>, P>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The event type to map.\n * @typeParam M The new type to map `E` to.\n */\nexport type EventMapper<E, M> = Mapper<EventParameters<E>, M>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The type of event to reduce.\n * @typeParam M The type of reduced event.\n */\nexport type EventReducer<E, R> = Reducer<EventParameters<E>, R>;\n"],"names":["Callable","Event","Unsubscribe","createEvent","createInterval","merge","removeListener","setTimeoutAsync","listeners","listener","index","indexOf","wasRemoved","splice","timeout","signal","Promise","resolve","timerId","setTimeout","addEventListener","clearTimeout","Function","constructor","func","Object","setPrototypeOf","prototype","_done","callback","done","pre","post","countdown","count","SpyType","spies","_disposed","dispose","value","all","map","clear","_error","error","size","length","disposed","lacks","has","off","forEach","spy","on","push","once","oneTimeListener","event","undefined","then","onfulfilled","onrejected","promise","v","Symbol","asyncIterator","queue","doneEvent","emitEvent","unsubscribe","target","action","next","shift","return","pipe","generator","generatedValue","result","catch","e","filter","first","filteredEvent","mapper","reduce","reducer","init","hasInit","expand","expander","values","orchestrate","conductor","initialized","lastValue","unsubscribeConductor","orchestratedEvent","debounce","interval","controller","AbortController","abort","complete","throttle","pendingValue","hasPendingValue","now","Date","batch","valueEvent","pop","stop","stopped","events","mergedEvent","counter","intervalEvent","clearInterval","setInterval"],"mappings":"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"}

package/build/index.d.ts

@@ -40,7 +40,7 @@ export interface Expander<T, R> {
  * console.log(wasRemoved); // Output: true
  * ```
  */
-export declare const removeListener: <T, R>(listeners: Listener<T, R>[], listener: Listener<T, R>) => boolean;
+export declare const removeListener: (listeners: unknown[], listener: unknown) => boolean;
 /**
  * @internal
  * @param timeout
@@ -64,16 +64,13 @@ export interface Unsubscribe {
  * @internal
  */
 export declare class Unsubscribe extends Callable {
+    private _done;
     constructor(callback: Callback);
+    get done(): boolean;
     pre(callback: Callback): Unsubscribe;
     post(callback: Callback): Unsubscribe;
     countdown(count: number): Unsubscribe;
 }
-export interface Queue<T> extends AsyncIterable<T> {
-    pop(): MaybePromise<T>;
-    stop(): MaybePromise<void>;
-    stopped: boolean;
-}
 export interface Event<T = any, R = any> {
     (event: T): Promise<(void | Awaited<R>)[]>;
 }
@@ -89,6 +86,7 @@ export declare class Event<T, R> extends Callable implements AsyncIterable<T>, P
      */
     private listeners;
     private spies;
+    private _disposed;
     /**
      * A function that disposes of the event and its listeners.
      */
@@ -119,6 +117,11 @@ export declare class Event<T, R> extends Callable implements AsyncIterable<T>, P
      * @type {number}
      */
     get size(): number;
+    /**
+     * Checks if the event has been disposed.
+     * @returns {boolean} `true` if the event has been disposed; otherwise, `false`.
+     */
+    get disposed(): boolean;
     /**
      * Checks if the given listener is NOT registered for this event.
      *
@@ -467,14 +470,34 @@ export declare class Event<T, R> extends Callable implements AsyncIterable<T>, P
      * const taskQueue = taskEvent.queue();
      * (async () => {
      *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1
-     *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 2
+     *   // Queue also can be used as a Promise
+     *   console.log('Processing:', await taskQueue); // Processing: Task 2
+     * })();
+     * await taskEvent('Task 1');
+     * await taskEvent('Task 2');
+     *```
+     *
+     *```typescript
+     * // Additionally, the queue can be used as an async iterator
+     * const taskEvent = new Event<string>();
+     * const taskQueue = taskEvent.queue();
+     * (async () => {
+     *   for await (const task of taskQueue) {
+     *     console.log('Processing:', task);
+     *   }
      * })();
      * await taskEvent('Task 1');
      * await taskEvent('Task 2');
      * ```
+     *
      */
     queue(): Queue<T>;
 }
+export interface Queue<T> extends AsyncIterable<T>, PromiseLike<T> {
+    pop(): Promise<T>;
+    stop(): Promise<void>;
+    stopped: boolean;
+}
 export type EventParameters<T> = T extends Event<infer P, any> ? P : never;
 export type EventResult<T> = T extends Event<any, infer R> ? R : never;
 export type AllEventsParameters<T extends Event<any, any>[]> = {

package/build/index.js

@@ -21,8 +21,15 @@ export class Callable extends Function {
     }
 }
 export class Unsubscribe extends Callable {
+    _done = false;
     constructor(callback){
-        super(callback);
+        super(()=>{
+            this._done = true;
+            callback();
+        });
+    }
+    get done() {
+        return this._done;
     }
     pre(callback) {
         return new Unsubscribe(async ()=>{
@@ -44,15 +51,22 @@ export class Unsubscribe extends Callable {
         });
     }
 }
+var SpyType;
+(function(SpyType) {
+    SpyType[SpyType["Add"] = 0] = "Add";
+    SpyType[SpyType["Remove"] = 1] = "Remove";
+})(SpyType || (SpyType = {}));
 export class Event extends Callable {
     listeners;
     spies = [];
+    _disposed = false;
     dispose;
     constructor(dispose){
         const listeners = [];
         super(async (value)=>Promise.all(listeners.map(async (listener)=>listener(await value))));
         this.listeners = listeners;
         this.dispose = async ()=>{
+            this._disposed = true;
             void this.clear();
             await this._error?.dispose();
             await dispose?.();
@@ -65,6 +79,9 @@ export class Event extends Callable {
     get size() {
         return this.listeners.length;
     }
+    get disposed() {
+        return this._disposed;
+    }
     lacks(listener) {
         return this.listeners.indexOf(listener) === -1;
     }
@@ -75,12 +92,17 @@ export class Event extends Callable {
         if (removeListener(this.listeners, listener) && this.spies.length) {
             [
                 ...this.spies
-            ].forEach((spy)=>spy(listener));
+            ].forEach((spy)=>spy(listener, 1));
         }
         return this;
     }
     on(listener) {
         this.listeners.push(listener);
+        if (this.spies.length) {
+            [
+                ...this.spies
+            ].forEach((spy)=>spy(listener, 0));
+        }
         return new Unsubscribe(()=>{
             void this.off(listener);
         });
@@ -97,7 +119,7 @@ export class Event extends Callable {
         if (this.spies.length) {
             [
                 ...this.spies
-            ].forEach((spy)=>spy());
+            ].forEach((spy)=>spy(undefined, 1));
         }
         return this;
     }
@@ -120,8 +142,8 @@ export class Event extends Callable {
             queue.splice(0);
             await doneEvent.dispose();
         });
-        const spy = (target = emitEvent)=>{
-            if (target === emitEvent) {
+        const spy = (target = emitEvent, action)=>{
+            if (target === emitEvent && action === 1) {
                 void doneEvent(true);
                 void unsubscribe();
             }
@@ -168,8 +190,8 @@ export class Event extends Callable {
         const unsubscribe = this.on(emitEvent).pre(()=>{
             removeListener(this.spies, spy);
         });
-        const spy = (target = emitEvent)=>{
-            if (target === emitEvent) {
+        const spy = (target = emitEvent, action)=>{
+            if (target === emitEvent && action === 1) {
                 void unsubscribe();
             }
         };
@@ -315,6 +337,9 @@ export class Event extends Callable {
             get stopped () {
                 return done;
             },
+            then (onfulfilled, onrejected) {
+                return this.pop().then(onfulfilled, onrejected);
+            },
             [Symbol.asyncIterator] () {
                 return {
                     next: async ()=>{

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type MaybePromise<T> = Promise<T> | PromiseLike<T> | T;\n\nexport interface Callback<R = void> {\n  (): MaybePromise<R>;\n}\n\nexport interface Listener<T, R = unknown> {\n  (event: T): MaybePromise<R | void>;\n}\n\nexport interface FilterFunction<T> {\n  (event: T): MaybePromise<boolean>;\n}\n\nexport interface Predicate<T, P extends T> {\n  (event: T): event is P;\n}\n\nexport type Filter<T, P extends T> = Predicate<T, P> | FilterFunction<T>;\n\nexport interface Mapper<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\nexport interface Reducer<T, R> {\n  (result: R, event: T): MaybePromise<R>;\n}\n\nexport interface Expander<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\n/**\n * Removes a listener from the provided array of listeners. It searches for the listener and removes all instances of it from the array.\n * This method ensures that the listener is fully unregistered, preventing any residual calls to a potentially deprecated handler.\n *\n * @internal\n * @param {Listener<T, R>[]} listeners - The array of listeners from which to remove the listener.\n * @param {Listener<T, R>} listener - The listener function to remove from the list of listeners.\n * @returns {boolean} - Returns `true` if the listener was found and removed, `false` otherwise.\n *\n * @template T - The type of the event that listeners are associated with.\n * @template R - The type of the return value that listeners are expected to return.\n *\n * ```typescript\n * // Assuming an array of listeners for click events\n * const listeners = [onClickHandler1, onClickHandler2];\n * const wasRemoved = removeListener(listeners, onClickHandler1);\n * console.log(wasRemoved); // Output: true\n * ```\n */\nexport const removeListener = <T, R>(listeners: Listener<T, R>[], listener: Listener<T, R>): boolean => {\n  let index = listeners.indexOf(listener);\n  const wasRemoved = index !== -1;\n  while (~index) {\n    listeners.splice(index, 1);\n    index = listeners.indexOf(listener);\n  }\n  return wasRemoved;\n};\n\n/**\n * @internal\n * @param timeout\n * @param signal\n * @returns\n */\nexport const setTimeoutAsync = (timeout: number, signal?: AbortSignal) =>\n  new Promise<boolean>((resolve) => {\n    const timerId = setTimeout(resolve, timeout, true);\n    signal?.addEventListener('abort', () => {\n      clearTimeout(timerId);\n      resolve(false);\n    });\n  });\n\n/**\n * An abstract class that extends the built-in Function class. It allows instances of the class\n * to be called as functions. When an instance of Callable is called as a function, it will\n * call the function passed to its constructor with the same arguments.\n * @internal\n */\nexport abstract class Callable extends Function {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  constructor(func: Function) {\n    super();\n    return Object.setPrototypeOf(func, new.target.prototype);\n  }\n}\n\nexport interface Unsubscribe {\n  (): MaybePromise<void>;\n}\n\n/**\n * @internal\n */\nexport class Unsubscribe extends Callable {\n  constructor(callback: Callback) {\n    super(callback);\n  }\n\n  pre(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await callback();\n      await this();\n    });\n  }\n\n  post(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await this();\n      await callback();\n    });\n  }\n\n  countdown(count: number): Unsubscribe {\n    return new Unsubscribe(async () => {\n      if (!--count) {\n        await this();\n      }\n    });\n  }\n}\n\nexport interface Queue<T> extends AsyncIterable<T> {\n  pop(): MaybePromise<T>;\n  stop(): MaybePromise<void>;\n  stopped: boolean;\n}\n\nexport interface Event<T = any, R = any> {\n  (event: T): Promise<(void | Awaited<R>)[]>;\n}\n\n/**\n * A class representing an anonymous event that can be listened to or triggered.\n *\n * @template T - The event type.\n * @template R - The return type of the event.\n */\nexport class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLike<T> {\n  /**\n   * The array of listeners for the event.\n   */\n  private listeners: Listener<T, R>[];\n\n  private spies: Array<(listener: Listener<T, R> | void) => void> = [];\n\n  /**\n   * A function that disposes of the event and its listeners.\n   */\n  readonly dispose: Callback;\n\n  /**\n   * Creates a new event.\n   *\n   * @param dispose - A function to call on the event disposal.\n   *\n   * ```typescript\n   * // Create a click event.\n   * const clickEvent = new Event<[x: number, y: number], void>();\n   * clickEvent.on(([x, y]) => console.log(`Clicked at ${x}, ${y}`));\n   * ```\n   */\n  constructor(dispose?: Callback) {\n    const listeners: Listener<T, R>[] = [];\n    // passes listeners exceptions to catch method\n    super(async (value: T): Promise<(void | Awaited<R>)[]> => Promise.all(listeners.map(async (listener) => listener(await value))));\n    this.listeners = listeners;\n\n    this.dispose = async () => {\n      void this.clear();\n      await this._error?.dispose();\n      await dispose?.();\n    };\n  }\n\n  private _error?: Event<unknown>;\n\n  /**\n   * Error event that emits errors.\n   *\n   * @returns {Event<unknown>} The error event.\n   */\n  get error(): Event<unknown> {\n    return (this._error ??= new Event<unknown>());\n  }\n\n  /**\n   * The number of listeners for the event.\n   *\n   * @readonly\n   * @type {number}\n   */\n  get size(): number {\n    return this.listeners.length;\n  }\n\n  /**\n   * Checks if the given listener is NOT registered for this event.\n   *\n   * @param listener - The listener function to check against the registered listeners.\n   * @returns `true` if the listener is not already registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Check if a listener is not already added\n   * if (event.lacks(myListener)) {\n   *   event.on(myListener);\n   * }\n   * ```\n   */\n  lacks(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) === -1;\n  }\n\n  /**\n   * Checks if the given listener is registered for this event.\n   *\n   * @param listener - The listener function to check.\n   * @returns `true` if the listener is currently registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Verify if a listener is registered\n   * if (event.has(myListener)) {\n   *   console.log('Listener is already registered');\n   * }\n   * ```\n   */\n  has(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) !== -1;\n  }\n\n  /**\n   * Removes a specific listener from this event.\n   *\n   * @param listener - The listener to remove.\n   * @returns The event instance, allowing for method chaining.\n   *\n   * ```typescript\n   * // Remove a listener\n   * event.off(myListener);\n   * ```\n   */\n  off(listener: Listener<T, R>): this {\n    if (removeListener(this.listeners, listener) && this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener));\n    }\n    return this;\n  }\n\n  /**\n   * Registers a listener that gets triggered whenever the event is emitted.\n   * This is the primary method for adding event handlers that will react to the event being triggered.\n   *\n   * @param listener - The function to call when the event occurs.\n   * @returns An object that can be used to unsubscribe the listener, ensuring easy cleanup.\n   *\n   * ```typescript\n   * // Add a listener to an event\n   * const unsubscribe = event.on((data) => {\n   *   console.log('Event data:', data);\n   * });\n   * ```\n   */\n  on(listener: Listener<T, R>): Unsubscribe {\n    this.listeners.push(listener);\n    return new Unsubscribe(() => {\n      void this.off(listener);\n    });\n  }\n\n  /**\n   * Adds a listener that will be called only once the next time the event is emitted.\n   * This method is useful for one-time notifications or single-trigger scenarios.\n   *\n   * @param listener - The listener to trigger once.\n   * @returns An object that can be used to remove the listener if the event has not yet occurred.\n   *\n   * ```typescript\n   * // Register a one-time listener\n   * const onceUnsubscribe = event.once((data) => {\n   *   console.log('Received data once:', data);\n   * });\n   * ```\n   */\n  once(listener: Listener<T, R>): Unsubscribe {\n    const oneTimeListener = (event: T) => {\n      void this.off(oneTimeListener);\n      return listener(event);\n    };\n    return this.on(oneTimeListener);\n  }\n\n  /**\n   * Removes all listeners from the event, effectively resetting it. This is useful when you need to\n   * cleanly dispose of all event handlers to prevent memory leaks or unwanted triggerings after certain conditions.\n   *\n   * @returns {this} The instance of the event, allowing for method chaining.\n   *\n   * ```typescript\n   * const myEvent = new Event();\n   * myEvent.on(data => console.log(data));\n   * myEvent.clear(); // Clears all listeners\n   * ```\n   */\n  clear(): this {\n    this.listeners.splice(0);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy());\n    }\n    return this;\n  }\n\n  /**\n   * Enables the `Event` to be used in a Promise chain, resolving with the first emitted value.\n   *\n   * @template TResult1 - The type of the fulfilled value returned by `onfulfilled` (defaults to the event's type).\n   * @template TResult2 - The type of the rejected value returned by `onrejected` (defaults to `never`).\n   * @param onfulfilled - A function called when the event emits its first value.\n   * @param onrejected - A function called if an error occurs before the event emits.\n   * @returns A Promise that resolves with the result of `onfulfilled` or `onrejected`.\n   *\n   * ```typescript\n   * const clickEvent = new Event<[number, number]>();\n   * await clickEvent;\n   * ```\n   */\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n  ): Promise<TResult1 | TResult2> {\n    const promise = new Promise<T>((resolve) => this.once(resolve));\n\n    return promise.then(onfulfilled, onrejected);\n  }\n\n  /**\n   * A promise that resolves with the first emitted value from this event.\n   *\n   * @returns {Promise<T>} The promise value.\n   */\n  get promise(): Promise<T> {\n    return this.then((v) => v);\n  }\n\n  /**\n   * Makes this event iterable using `for await...of` loops.\n   *\n   * @returns An async iterator that yields values as they are emitted by this event.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers\n   * const numberEvent = new Event<number>();\n   * (async () => {\n   *   for await (const num of numberEvent) {\n   *     console.log('Number:', num);\n   *   }\n   * })();\n   * await numberEvent(1);\n   * await numberEvent(2);\n   * await numberEvent(3);\n   * ```\n   */\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    const queue: T[] = [];\n    const doneEvent = new Event<boolean>();\n    const emitEvent = async (value: T) => {\n      queue.push(value);\n      await doneEvent(false);\n    };\n    const unsubscribe = this.on(emitEvent).pre(async () => {\n      removeListener(this.spies, spy);\n      queue.splice(0);\n      await doneEvent.dispose();\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent) => {\n      if (target === emitEvent) {\n        void doneEvent(true);\n        void unsubscribe();\n      }\n    };\n\n    this.spies.push(spy);\n    return {\n      async next() {\n        if (queue.length) {\n          return { value: queue.shift()!, done: false };\n        }\n        if (!(await doneEvent)) {\n          return { value: queue.shift()!, done: false };\n        }\n        return { value: undefined, done: true };\n      },\n      async return(value: unknown) {\n        await unsubscribe();\n        return { done: true, value };\n      },\n    };\n  }\n\n  /**\n   * Transforms the event's values using a generator function, creating a new `Event` that emits the transformed values.\n   *\n   * @template PT - The type of values emitted by the transformed `Event`.\n   * @template PR - The return type of the listeners of the transformed `Event`.\n   * @param generator - A function that takes the original event's value and returns a generator (sync or async) that yields the transformed values.\n   * @returns A new `Event` instance that emits the transformed values.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  pipe<PT, R>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): Event<PT, R> {\n    const emitEvent = async (value: T) => {\n      try {\n        for await (const generatedValue of generator(value)) {\n          await result(generatedValue).catch((e) => result.error(e));\n        }\n      } catch (e) {\n        await result.error(e);\n      }\n    };\n\n    const unsubscribe = this.on(emitEvent).pre(() => {\n      removeListener(this.spies, spy);\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent) => {\n      if (target === emitEvent) {\n        void unsubscribe();\n      }\n    };\n    this.spies.push(spy);\n\n    const result = new Event<PT, R>(unsubscribe);\n    return result;\n  }\n\n  /**\n   * Creates an async generator that yields values as they are emitted by this event.\n   *\n   * @template PT - The type of values yielded by the async generator.\n   * @param generator - An optional function that takes the original event's value and returns a generator (sync or async)\n   *                  that yields values to include in the async generator.\n   * @returns An async generator that yields values from this event as they occur.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  async *generator<PT>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): AsyncGenerator<Awaited<PT>, void, unknown> {\n    for await (const value of this.pipe(generator)) {\n      yield value;\n    }\n  }\n\n  /**\n   * Filters events, creating a new event that only triggers when the provided filter function returns `true`.\n   * This method can be used to selectively process events that meet certain criteria.\n   *\n   * @param {Filter<T, P>} predicate The filter function or predicate to apply to each event.\n   * @returns {Event<P, R>} A new event that only triggers for filtered events.\n   *\n   * ```typescript\n   * const keyPressedEvent = new Event<string>();\n   * const enterPressedEvent = keyPressedEvent.filter(key => key === 'Enter');\n   * enterPressedEvent.on(() => console.log('Enter key was pressed.'));\n   * ```\n   */\n  filter<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  filter<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  filter<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    return this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that will only be triggered once when the provided filter function returns `true`.\n   * This method is useful for handling one-time conditions in a stream of events.\n   *\n   * @param {Filter<T, P>} predicate - The filter function or predicate.\n   * @returns {Event<P, R>} A new event that will be triggered only once when the filter condition is met.\n   *\n   * ```typescript\n   * const sizeChangeEvent = new Event<number>();\n   * const sizeReachedEvent = sizeChangeEvent.first(size => size > 1024);\n   * sizeReachedEvent.on(() => console.log('Size threshold exceeded.'));\n   * ```\n   */\n  first<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  first<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  first<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    const filteredEvent = this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n        await filteredEvent.dispose();\n      }\n    });\n    return filteredEvent;\n  }\n\n  /**\n   * Transforms the data emitted by this event using a mapping function. Each emitted event is processed by the `mapper`\n   * function, which returns a new value that is then emitted by the returned `Event` instance. This is useful for data transformation\n   * or adapting the event's data structure.\n   *\n   * @template M The type of data that the mapper function will produce.\n   * @template MR The type of data emitted by the mapped event, usually related to or the same as `M`.\n   * @param {Mapper<T, M>} mapper A function that takes the original event data and returns the transformed data.\n   * @returns {Event<M, MR>} A new `Event` instance that emits the mapped values.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers, create a new event that emits their squares.\n   * const numberEvent = new Event<number>();\n   * const squaredEvent = numberEvent.map(num => num * num);\n   * squaredEvent.on(squared => console.log('Squared number:', squared));\n   * await numberEvent(5); // Logs: \"Squared number: 25\"\n   * ```\n   */\n  map<M, MR = R>(mapper: Mapper<T, M>): Event<Awaited<M>, MR> {\n    return this.pipe(async function* (value) {\n      yield await mapper(value);\n    });\n  }\n\n  /**\n   * Accumulates the values emitted by this event using a reducer function, starting from an initial value. The reducer\n   * function takes the accumulated value and the latest emitted event data, then returns a new accumulated value. This\n   * new value is then emitted by the returned `Event` instance. This is particularly useful for accumulating state over time.\n   *\n   * @template A The type of the accumulator value.\n   * @template AR The type of data emitted by the reduced event, usually the same as `A`.\n   * @param {Reducer<T, A>} reducer A function that takes the current accumulated value and the new event data, returning the new accumulated value.\n   * @param {A} init The initial value of the accumulator.\n   * @returns {Event<A, AR>} A new `Event` instance that emits the reduced value.\n   *\n   * ```typescript\n   * const sumEvent = numberEvent.reduce((a, b) => a + b, 0);\n   * sumEvent.on((sum) => console.log(sum)); // 1, 3, 6\n   * await sumEvent(1);\n   * await sumEvent(2);\n   * await sumEvent(3);\n   * ```\n   */\n  reduce<A, AR = R>(reducer: Reducer<T, A>, init?: A): Event<Awaited<A>, AR>;\n  reduce<A, AR = R>(reducer: Reducer<T, A>, ...init: unknown[]): Event<Awaited<A>, AR> {\n    let hasInit = init.length === 1;\n    let result = init[0] as A | undefined;\n\n    return this.pipe(async function* (value) {\n      if (hasInit) {\n        result = await reducer(result!, value);\n        yield result;\n      } else {\n        result = value as unknown as A;\n        hasInit = true;\n      }\n    });\n  }\n\n  /**\n   * Transforms each event's data into multiple events using an expander function. The expander function takes\n   * the original event's data and returns an array of new data elements, each of which will be emitted individually\n   * by the returned `Event` instance. This method is useful for scenarios where an event's data can naturally\n   * be expanded into multiple, separate pieces of data which should each trigger further processing independently.\n   *\n   * @template ET - The type of data elements in the array returned by the expander function.\n   * @template ER - The type of responses emitted by the expanded event, usually related to or the same as `ET`.\n   * @param {Expander<T, ET[]>} expander - A function that takes the original event data and returns an array of new data elements.\n   * @returns {Event<ET, ER>} - A new `Event` instance that emits each value from the array returned by the expander function.\n   *\n   * ```typescript\n   * // Assuming an event that emits a sentence, create a new event that emits each word from the sentence separately.\n   * const sentenceEvent = new Event<string>();\n   * const wordEvent = sentenceEvent.expand(sentence => sentence.split(' '));\n   * wordEvent.on(word => console.log('Word:', word));\n   * await sentenceEvent('Hello world'); // Logs: \"Word: Hello\", \"Word: world\"\n   * ```\n   */\n  expand<ET, ER>(expander: Expander<T, ET[]>): Event<Awaited<ET>, ER> {\n    return this.pipe(async function* (value) {\n      const values = await expander(value);\n      for (const value of values) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that emits values based on a conductor event. The orchestrated event will emit the last value\n   * captured from the original event each time the conductor event is triggered. This method is useful for synchronizing\n   * events, where the emission of one event controls the timing of another.\n   *\n   * @template T The type of data emitted by the original event.\n   * @template R The type of data emitted by the orchestrated event, usually the same as `T`.\n   * @param {Event<unknown, unknown>} conductor An event that signals when the orchestrated event should emit.\n   * @returns {Event<T, R>} An orchestrated event that emits values based on the conductor's trigger.\n   *\n   * ```typescript\n   * const rightClickPositionEvent = mouseMoveEvent.orchestrate(mouseRightClickEvent);\n   * ```\n   *\n   * ```typescript\n   * // An event that emits whenever a \"tick\" event occurs.\n   * const tickEvent = new Event<void>();\n   * const dataEvent = new Event<string>();\n   * const synchronizedEvent = dataEvent.orchestrate(tickEvent);\n   * synchronizedEvent.on(data => console.log('Data on tick:', data));\n   * await dataEvent('Hello');\n   * await dataEvent('World!');\n   * await tickEvent(); // Logs: \"Data on tick: World!\"\n   * ```\n   */\n  orchestrate(conductor: Event<any, any>): Event<T, R> {\n    let initialized = false;\n    let lastValue: T;\n    const unsubscribe = this.on(async (event) => {\n      initialized = true;\n      lastValue = event;\n    });\n    const unsubscribeConductor = conductor.on(async () => {\n      if (initialized) {\n        await orchestratedEvent(lastValue);\n        initialized = false;\n      }\n    });\n\n    const orchestratedEvent = new Event<T, R>(unsubscribe.post(unsubscribeConductor));\n    return orchestratedEvent;\n  }\n  /**\n   * Creates a debounced event that delays triggering until after a specified interval has elapsed\n   * following the last time it was invoked. This method is particularly useful for limiting the rate\n   * at which a function is executed. Common use cases include handling rapid user inputs, window resizing,\n   * or scroll events.\n   *\n   * @param {number} interval - The amount of time to wait (in milliseconds) before firing the debounced event.\n   * @returns {Event<T, R>} An event of debounced events.\n   *\n   * ```typescript\n   * const debouncedEvent = textInputEvent.debounce(100);\n   * debouncedEvent.on((str) => console.log(str)); // only 'text' is emitted\n   * await event('t');\n   * await event('te');\n   * await event('tex');\n   * await event('text');\n   * ```\n   */\n  debounce(interval: number): Event<Awaited<T>, unknown> {\n    let controller = new AbortController();\n\n    return this.pipe(async function* (value) {\n      controller.abort();\n      controller = new AbortController();\n      const complete = await setTimeoutAsync(interval, controller.signal);\n      if (complete) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a throttled event that emits values at most once per specified interval.\n   *\n   * This is useful for controlling the rate of event emissions, especially for high-frequency events.\n   * The throttled event will immediately emit the first value, and then only emit subsequent values\n   * if the specified interval has passed since the last emission.\n   *\n   * @param interval - The time interval (in milliseconds) between allowed emissions.\n   * @returns A new Event that emits throttled values.\n   *\n   * ```typescript\n   * const scrollEvent = new Event();\n   * const throttledScroll = scrollEvent.throttle(100); // Emit at most every 100ms\n   * throttledScroll.on(() => console.log(\"Throttled scroll event\"));\n   * ```\n   */\n  throttle(interval: number): Event<Awaited<T>, unknown> {\n    let timeout = 0;\n    let pendingValue: T;\n    let hasPendingValue = false;\n\n    return this.pipe(async function* (value) {\n      const now = Date.now();\n      if (timeout <= now) {\n        timeout = now + interval;\n        yield value;\n      } else {\n        pendingValue = value;\n        if (!hasPendingValue) {\n          hasPendingValue = true;\n          await setTimeoutAsync(timeout - now);\n          timeout = now + interval;\n          hasPendingValue = false;\n          yield pendingValue;\n        }\n      }\n    });\n  }\n\n  /**\n   * Aggregates multiple event emissions into batches and emits the batched events either at specified\n   * time intervals or when the batch reaches a predefined size. This method is useful for grouping\n   * a high volume of events into manageable chunks, such as logging or processing data in bulk.\n   *\n   * @param {number} interval - The time in milliseconds between batch emissions.\n   * @param {number} [size] - Optional. The maximum size of each batch. If specified, triggers a batch emission\n   * once the batch reaches this size, regardless of the interval.\n   * @returns {Event<T[], R>} An event of the batched results.\n   *\n   * ```typescript\n   * // Batch messages for bulk processing every 1 second or when 10 messages are collected\n   * const messageEvent = createEvent<string, void>();\n   * const batchedMessageEvent = messageEvent.batch(1000, 10);\n   * batchedMessageEvent.on((messages) => console.log('Batched Messages:', messages));\n   * ```\n   */\n  batch(interval: number, size?: number): Event<T[], R> {\n    let controller = new AbortController();\n    const batch: T[] = [];\n\n    return this.pipe(async function* (value) {\n      batch.push(value);\n      if (size !== undefined && batch.length >= size) {\n        controller.abort();\n        yield batch.splice(0);\n      }\n      if (batch.length === 1) {\n        controller = new AbortController();\n        const complete = await setTimeoutAsync(interval, controller.signal);\n        if (complete) {\n          yield batch.splice(0);\n        }\n      }\n    });\n  }\n\n  /**\n   * Creates a queue from the event, where each emitted value is sequentially processed. The returned object allows popping elements\n   * from the queue, ensuring that elements are handled one at a time. This method is ideal for scenarios where order and sequential processing are critical.\n   *\n   * @returns {Queue<T>} An object representing the queue. The 'pop' method retrieves the next element from the queue, while 'stop' halts further processing.\n   *\n   * ```typescript\n   * // Queueing tasks for sequential execution\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 2\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   * ```\n   */\n  queue(): Queue<T> {\n    const queue: T[] = [];\n    let done = false;\n    const valueEvent = new Event<void>();\n    const unsubscribe = this.on(async (value) => {\n      queue.push(value);\n      await valueEvent();\n    });\n\n    const pop = async () => {\n      if (!queue.length) {\n        await valueEvent;\n      }\n      return queue.shift()!;\n    };\n    const stop = async () => {\n      await unsubscribe();\n      done = true;\n      await valueEvent();\n    };\n\n    return {\n      pop,\n      stop,\n      get stopped() {\n        return done;\n      },\n      [Symbol.asyncIterator]() {\n        return {\n          next: async () => {\n            return { value: await pop(), done };\n          },\n        };\n      },\n    };\n  }\n}\n\nexport type EventParameters<T> = T extends Event<infer P, any> ? P : never;\n\nexport type EventResult<T> = T extends Event<any, infer R> ? R : never;\n\nexport type AllEventsParameters<T extends Event<any, any>[]> = { [K in keyof T]: EventParameters<T[K]> }[number];\n\nexport type AllEventsResults<T extends Event<any, any>[]> = { [K in keyof T]: EventResult<T[K]> }[number];\n\n/**\n * Merges multiple events into a single event. This function takes any number of `Event` instances\n * and returns a new `Event` that triggers whenever any of the input events trigger. The parameters\n * and results of the merged event are derived from the input events, providing a flexible way to\n * handle multiple sources of events in a unified manner.\n *\n * @template Events - An array of `Event` instances.\n * @param {...Events} events - A rest parameter that takes multiple events to be merged.\n * @returns {Event<AllEventsParameters<Events>, AllEventsResults<Events>>} - Returns a new `Event` instance\n *           that triggers with the parameters and results of any of the merged input events.\n *\n * ```typescript\n * // Merging mouse and keyboard events into a single event\n * const mouseEvent = createEvent<MouseEvent>();\n * const keyboardEvent = createEvent<KeyboardEvent>();\n * const inputEvent = merge(mouseEvent, keyboardEvent);\n * inputEvent.on(event => console.log('Input event:', event));\n * ```\n */\nexport const merge = <Events extends Event<any, any>[]>(...events: Events): Event<AllEventsParameters<Events>, AllEventsResults<Events>> => {\n  const mergedEvent = new Event<AllEventsParameters<Events>, AllEventsResults<Events>>();\n  events.forEach((event) => event.on(mergedEvent));\n  return mergedEvent;\n};\n\n/**\n * Creates a periodic event that triggers at a specified interval. The event will automatically emit\n * an incrementing counter value each time it triggers, starting from zero. This function is useful\n * for creating time-based triggers within an application, such as updating UI elements, polling,\n * or any other timed operation.\n *\n * @template R - The return type of the event handler function, defaulting to `void`.\n * @param {number} interval - The interval in milliseconds at which the event should trigger.\n * @returns {Event<number, R>} - An `Event` instance that triggers at the specified interval,\n *           emitting an incrementing counter value.\n *\n * ```typescript\n * // Creating an interval event that logs a message every second\n * const tickEvent = createInterval(1000);\n * tickEvent.on(tickNumber => console.log('Tick:', tickNumber));\n * ```\n */\nexport const createInterval = <R = unknown>(interval: number): Event<number, R> => {\n  let counter = 0;\n  const intervalEvent = new Event<number, R>(() => clearInterval(timerId));\n  const timerId: ReturnType<typeof setInterval> = setInterval(() => intervalEvent(counter++), interval);\n  return intervalEvent;\n};\n\n/**\n * Creates a new instance of the `Event` class, which allows for the registration of event handlers that get called when the event is emitted.\n * This factory function simplifies the creation of events by encapsulating the instantiation logic, providing a clean and simple API for event creation.\n *\n * @typeParam T - The tuple of argument types that the event will accept.\n * @typeParam R - The return type of the event handler function, which is emitted after processing the event data.\n * @returns {Event<T, R>} - A new instance of the `Event` class, ready to have listeners added to it.\n *\n * ```typescript\n * // Create a new event that accepts a string and returns the string length\n * const myEvent = createEvent<string, number>();\n * myEvent.on((str: string) => str.length);\n * myEvent('hello').then(results => console.log(results)); // Logs: [5]\n * ```\n */\nexport const createEvent = <T = unknown, R = unknown>(): Event<T, R> => new Event<T, R>();\n\nexport default createEvent;\n\n/**\n * A type helper that extracts the event listener type\n *\n * @typeParam E - The event type.\n */\nexport type EventHandler<E> = E extends Event<infer T, infer R> ? Listener<T, R> : never;\n\n/**\n * A type helper that extracts the event filter type\n *\n * @typeParam E The event type to filter.\n */\nexport type EventFilter<E> = FilterFunction<EventParameters<E>>;\n\n/**\n * A type helper that extracts the event predicate type\n *\n * @typeParam E The event type to predicate.\n */\nexport type EventPredicate<E, P extends EventParameters<E>> = Predicate<EventParameters<E>, P>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The event type to map.\n * @typeParam M The new type to map `E` to.\n */\nexport type EventMapper<E, M> = Mapper<EventParameters<E>, M>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The type of event to reduce.\n * @typeParam M The type of reduced event.\n */\nexport type EventReducer<E, R> = Reducer<EventParameters<E>, R>;\n"],"names":["removeListener","listeners","listener","index","indexOf","wasRemoved","splice","setTimeoutAsync","timeout","signal","Promise","resolve","timerId","setTimeout","addEventListener","clearTimeout","Callable","Function","constructor","func","Object","setPrototypeOf","prototype","Unsubscribe","callback","pre","post","countdown","count","Event","spies","dispose","value","all","map","clear","_error","error","size","length","lacks","has","off","forEach","spy","on","push","once","oneTimeListener","event","then","onfulfilled","onrejected","promise","v","Symbol","asyncIterator","queue","doneEvent","emitEvent","unsubscribe","target","next","shift","done","undefined","return","pipe","generator","generatedValue","result","catch","e","filter","first","filteredEvent","mapper","reduce","reducer","init","hasInit","expand","expander","values","orchestrate","conductor","initialized","lastValue","unsubscribeConductor","orchestratedEvent","debounce","interval","controller","AbortController","abort","complete","throttle","pendingValue","hasPendingValue","now","Date","batch","valueEvent","pop","stop","stopped","merge","events","mergedEvent","createInterval","counter","intervalEvent","clearInterval","setInterval","createEvent"],"mappings":"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"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type MaybePromise<T> = Promise<T> | PromiseLike<T> | T;\n\nexport interface Callback<R = void> {\n  (): MaybePromise<R>;\n}\n\nexport interface Listener<T, R = unknown> {\n  (event: T): MaybePromise<R | void>;\n}\n\nexport interface FilterFunction<T> {\n  (event: T): MaybePromise<boolean>;\n}\n\nexport interface Predicate<T, P extends T> {\n  (event: T): event is P;\n}\n\nexport type Filter<T, P extends T> = Predicate<T, P> | FilterFunction<T>;\n\nexport interface Mapper<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\nexport interface Reducer<T, R> {\n  (result: R, event: T): MaybePromise<R>;\n}\n\nexport interface Expander<T, R> {\n  (event: T): MaybePromise<R>;\n}\n\n/**\n * Removes a listener from the provided array of listeners. It searches for the listener and removes all instances of it from the array.\n * This method ensures that the listener is fully unregistered, preventing any residual calls to a potentially deprecated handler.\n *\n * @internal\n * @param {Listener<T, R>[]} listeners - The array of listeners from which to remove the listener.\n * @param {Listener<T, R>} listener - The listener function to remove from the list of listeners.\n * @returns {boolean} - Returns `true` if the listener was found and removed, `false` otherwise.\n *\n * @template T - The type of the event that listeners are associated with.\n * @template R - The type of the return value that listeners are expected to return.\n *\n * ```typescript\n * // Assuming an array of listeners for click events\n * const listeners = [onClickHandler1, onClickHandler2];\n * const wasRemoved = removeListener(listeners, onClickHandler1);\n * console.log(wasRemoved); // Output: true\n * ```\n */\nexport const removeListener = (listeners: unknown[], listener: unknown): boolean => {\n  let index = listeners.indexOf(listener);\n  const wasRemoved = index !== -1;\n  while (~index) {\n    listeners.splice(index, 1);\n    index = listeners.indexOf(listener);\n  }\n  return wasRemoved;\n};\n\n/**\n * @internal\n * @param timeout\n * @param signal\n * @returns\n */\nexport const setTimeoutAsync = (timeout: number, signal?: AbortSignal) =>\n  new Promise<boolean>((resolve) => {\n    const timerId = setTimeout(resolve, timeout, true);\n    signal?.addEventListener('abort', () => {\n      clearTimeout(timerId);\n      resolve(false);\n    });\n  });\n\n/**\n * An abstract class that extends the built-in Function class. It allows instances of the class\n * to be called as functions. When an instance of Callable is called as a function, it will\n * call the function passed to its constructor with the same arguments.\n * @internal\n */\nexport abstract class Callable extends Function {\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type\n  constructor(func: Function) {\n    super();\n    return Object.setPrototypeOf(func, new.target.prototype);\n  }\n}\n\nexport interface Unsubscribe {\n  (): MaybePromise<void>;\n}\n\n/**\n * @internal\n */\nexport class Unsubscribe extends Callable {\n  private _done = false;\n\n  constructor(callback: Callback) {\n    super(() => {\n      this._done = true;\n      callback();\n    });\n  }\n\n  get done() {\n    return this._done;\n  }\n\n  pre(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await callback();\n      await this();\n    });\n  }\n\n  post(callback: Callback): Unsubscribe {\n    return new Unsubscribe(async () => {\n      await this();\n      await callback();\n    });\n  }\n\n  countdown(count: number): Unsubscribe {\n    return new Unsubscribe(async () => {\n      if (!--count) {\n        await this();\n      }\n    });\n  }\n}\n\nexport interface Event<T = any, R = any> {\n  (event: T): Promise<(void | Awaited<R>)[]>;\n}\n\nenum SpyType {\n  Add,\n  Remove,\n}\n\n/**\n * A class representing an anonymous event that can be listened to or triggered.\n *\n * @template T - The event type.\n * @template R - The return type of the event.\n */\nexport class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLike<T> {\n  /**\n   * The array of listeners for the event.\n   */\n  private listeners: Listener<T, R>[];\n\n  private spies: Array<(listener: Listener<T, R> | void, type: SpyType) => void> = [];\n\n  private _disposed = false;\n\n  /**\n   * A function that disposes of the event and its listeners.\n   */\n  readonly dispose: Callback;\n\n  /**\n   * Creates a new event.\n   *\n   * @param dispose - A function to call on the event disposal.\n   *\n   * ```typescript\n   * // Create a click event.\n   * const clickEvent = new Event<[x: number, y: number], void>();\n   * clickEvent.on(([x, y]) => console.log(`Clicked at ${x}, ${y}`));\n   * ```\n   */\n  constructor(dispose?: Callback) {\n    const listeners: Listener<T, R>[] = [];\n    // passes listeners exceptions to catch method\n    super(async (value: T): Promise<(void | Awaited<R>)[]> => Promise.all(listeners.map(async (listener) => listener(await value))));\n    this.listeners = listeners;\n\n    this.dispose = async () => {\n      this._disposed = true;\n      void this.clear();\n      await this._error?.dispose();\n      await dispose?.();\n    };\n  }\n\n  private _error?: Event<unknown>;\n\n  /**\n   * Error event that emits errors.\n   *\n   * @returns {Event<unknown>} The error event.\n   */\n  get error(): Event<unknown> {\n    return (this._error ??= new Event<unknown>());\n  }\n\n  /**\n   * The number of listeners for the event.\n   *\n   * @readonly\n   * @type {number}\n   */\n  get size(): number {\n    return this.listeners.length;\n  }\n\n  /**\n   * Checks if the event has been disposed.\n   * @returns {boolean} `true` if the event has been disposed; otherwise, `false`.\n   */\n  get disposed(): boolean {\n    return this._disposed;\n  }\n\n  /**\n   * Checks if the given listener is NOT registered for this event.\n   *\n   * @param listener - The listener function to check against the registered listeners.\n   * @returns `true` if the listener is not already registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Check if a listener is not already added\n   * if (event.lacks(myListener)) {\n   *   event.on(myListener);\n   * }\n   * ```\n   */\n  lacks(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) === -1;\n  }\n\n  /**\n   * Checks if the given listener is registered for this event.\n   *\n   * @param listener - The listener function to check.\n   * @returns `true` if the listener is currently registered; otherwise, `false`.\n   *\n   * ```typescript\n   * // Verify if a listener is registered\n   * if (event.has(myListener)) {\n   *   console.log('Listener is already registered');\n   * }\n   * ```\n   */\n  has(listener: Listener<T, R>): boolean {\n    return this.listeners.indexOf(listener) !== -1;\n  }\n\n  /**\n   * Removes a specific listener from this event.\n   *\n   * @param listener - The listener to remove.\n   * @returns The event instance, allowing for method chaining.\n   *\n   * ```typescript\n   * // Remove a listener\n   * event.off(myListener);\n   * ```\n   */\n  off(listener: Listener<T, R>): this {\n    if (removeListener(this.listeners, listener) && this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener, SpyType.Remove));\n    }\n    return this;\n  }\n\n  /**\n   * Registers a listener that gets triggered whenever the event is emitted.\n   * This is the primary method for adding event handlers that will react to the event being triggered.\n   *\n   * @param listener - The function to call when the event occurs.\n   * @returns An object that can be used to unsubscribe the listener, ensuring easy cleanup.\n   *\n   * ```typescript\n   * // Add a listener to an event\n   * const unsubscribe = event.on((data) => {\n   *   console.log('Event data:', data);\n   * });\n   * ```\n   */\n  on(listener: Listener<T, R>): Unsubscribe {\n    this.listeners.push(listener);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy(listener, SpyType.Add));\n    }\n    return new Unsubscribe(() => {\n      void this.off(listener);\n    });\n  }\n\n  /**\n   * Adds a listener that will be called only once the next time the event is emitted.\n   * This method is useful for one-time notifications or single-trigger scenarios.\n   *\n   * @param listener - The listener to trigger once.\n   * @returns An object that can be used to remove the listener if the event has not yet occurred.\n   *\n   * ```typescript\n   * // Register a one-time listener\n   * const onceUnsubscribe = event.once((data) => {\n   *   console.log('Received data once:', data);\n   * });\n   * ```\n   */\n  once(listener: Listener<T, R>): Unsubscribe {\n    const oneTimeListener = (event: T) => {\n      void this.off(oneTimeListener);\n      return listener(event);\n    };\n    return this.on(oneTimeListener);\n  }\n\n  /**\n   * Removes all listeners from the event, effectively resetting it. This is useful when you need to\n   * cleanly dispose of all event handlers to prevent memory leaks or unwanted triggerings after certain conditions.\n   *\n   * @returns {this} The instance of the event, allowing for method chaining.\n   *\n   * ```typescript\n   * const myEvent = new Event();\n   * myEvent.on(data => console.log(data));\n   * myEvent.clear(); // Clears all listeners\n   * ```\n   */\n  clear(): this {\n    this.listeners.splice(0);\n    if (this.spies.length) {\n      [...this.spies].forEach((spy) => spy(undefined, SpyType.Remove));\n    }\n    return this;\n  }\n\n  /**\n   * Enables the `Event` to be used in a Promise chain, resolving with the first emitted value.\n   *\n   * @template TResult1 - The type of the fulfilled value returned by `onfulfilled` (defaults to the event's type).\n   * @template TResult2 - The type of the rejected value returned by `onrejected` (defaults to `never`).\n   * @param onfulfilled - A function called when the event emits its first value.\n   * @param onrejected - A function called if an error occurs before the event emits.\n   * @returns A Promise that resolves with the result of `onfulfilled` or `onrejected`.\n   *\n   * ```typescript\n   * const clickEvent = new Event<[number, number]>();\n   * await clickEvent;\n   * ```\n   */\n  then<TResult1 = T, TResult2 = never>(\n    onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n  ): Promise<TResult1 | TResult2> {\n    const promise = new Promise<T>((resolve) => this.once(resolve));\n\n    return promise.then(onfulfilled, onrejected);\n  }\n\n  /**\n   * A promise that resolves with the first emitted value from this event.\n   *\n   * @returns {Promise<T>} The promise value.\n   */\n  get promise(): Promise<T> {\n    return this.then((v) => v);\n  }\n\n  /**\n   * Makes this event iterable using `for await...of` loops.\n   *\n   * @returns An async iterator that yields values as they are emitted by this event.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers\n   * const numberEvent = new Event<number>();\n   * (async () => {\n   *   for await (const num of numberEvent) {\n   *     console.log('Number:', num);\n   *   }\n   * })();\n   * await numberEvent(1);\n   * await numberEvent(2);\n   * await numberEvent(3);\n   * ```\n   */\n  [Symbol.asyncIterator](): AsyncIterator<T> {\n    const queue: T[] = [];\n    const doneEvent = new Event<boolean>();\n    const emitEvent = async (value: T) => {\n      queue.push(value);\n      await doneEvent(false);\n    };\n    const unsubscribe = this.on(emitEvent).pre(async () => {\n      removeListener(this.spies, spy);\n      queue.splice(0);\n      await doneEvent.dispose();\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {\n      if (target === emitEvent && action === SpyType.Remove) {\n        void doneEvent(true);\n        void unsubscribe();\n      }\n    };\n\n    this.spies.push(spy);\n    return {\n      async next() {\n        if (queue.length) {\n          return { value: queue.shift()!, done: false };\n        }\n        if (!(await doneEvent)) {\n          return { value: queue.shift()!, done: false };\n        }\n        return { value: undefined, done: true };\n      },\n      async return(value: unknown) {\n        await unsubscribe();\n        return { done: true, value };\n      },\n    };\n  }\n\n  /**\n   * Transforms the event's values using a generator function, creating a new `Event` that emits the transformed values.\n   *\n   * @template PT - The type of values emitted by the transformed `Event`.\n   * @template PR - The return type of the listeners of the transformed `Event`.\n   * @param generator - A function that takes the original event's value and returns a generator (sync or async) that yields the transformed values.\n   * @returns A new `Event` instance that emits the transformed values.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  pipe<PT, R>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): Event<PT, R> {\n    const emitEvent = async (value: T) => {\n      try {\n        for await (const generatedValue of generator(value)) {\n          await result(generatedValue).catch((e) => result.error(e));\n        }\n      } catch (e) {\n        await result.error(e);\n      }\n    };\n\n    const unsubscribe = this.on(emitEvent).pre(() => {\n      removeListener(this.spies, spy);\n    });\n\n    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {\n      if (target === emitEvent && action === SpyType.Remove) {\n        void unsubscribe();\n      }\n    };\n    this.spies.push(spy);\n\n    const result = new Event<PT, R>(unsubscribe);\n    return result;\n  }\n\n  /**\n   * Creates an async generator that yields values as they are emitted by this event.\n   *\n   * @template PT - The type of values yielded by the async generator.\n   * @param generator - An optional function that takes the original event's value and returns a generator (sync or async)\n   *                  that yields values to include in the async generator.\n   * @returns An async generator that yields values from this event as they occur.\n   *\n   * ```typescript\n   * const numbersEvent = new Event<number>();\n   * const evenNumbersEvent = numbersEvent.pipe(function*(value) {\n   *    if (value % 2 === 0) {\n   *      yield value;\n   *    }\n   * });\n   * evenNumbersEvent.on((evenNumber) => console.log(evenNumber));\n   * await numbersEvent(1);\n   * await numbersEvent(2);\n   * await numbersEvent(3);\n   * ```\n   */\n  async *generator<PT>(generator: (event: T) => AsyncGenerator<PT, void, unknown> | Generator<PT, void, unknown>): AsyncGenerator<Awaited<PT>, void, unknown> {\n    for await (const value of this.pipe(generator)) {\n      yield value;\n    }\n  }\n\n  /**\n   * Filters events, creating a new event that only triggers when the provided filter function returns `true`.\n   * This method can be used to selectively process events that meet certain criteria.\n   *\n   * @param {Filter<T, P>} predicate The filter function or predicate to apply to each event.\n   * @returns {Event<P, R>} A new event that only triggers for filtered events.\n   *\n   * ```typescript\n   * const keyPressedEvent = new Event<string>();\n   * const enterPressedEvent = keyPressedEvent.filter(key => key === 'Enter');\n   * enterPressedEvent.on(() => console.log('Enter key was pressed.'));\n   * ```\n   */\n  filter<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  filter<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  filter<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    return this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that will only be triggered once when the provided filter function returns `true`.\n   * This method is useful for handling one-time conditions in a stream of events.\n   *\n   * @param {Filter<T, P>} predicate - The filter function or predicate.\n   * @returns {Event<P, R>} A new event that will be triggered only once when the filter condition is met.\n   *\n   * ```typescript\n   * const sizeChangeEvent = new Event<number>();\n   * const sizeReachedEvent = sizeChangeEvent.first(size => size > 1024);\n   * sizeReachedEvent.on(() => console.log('Size threshold exceeded.'));\n   * ```\n   */\n  first<P extends T>(predicate: Predicate<T, P>): Event<P, R>;\n  first<P extends T>(filter: FilterFunction<T>): Event<P, R>;\n  first<P extends T>(filter: Filter<T, P>): Event<P, R> {\n    const filteredEvent = this.pipe<P, R>(async function* (value: T) {\n      if (await filter(value)) {\n        yield value as P;\n        await filteredEvent.dispose();\n      }\n    });\n    return filteredEvent;\n  }\n\n  /**\n   * Transforms the data emitted by this event using a mapping function. Each emitted event is processed by the `mapper`\n   * function, which returns a new value that is then emitted by the returned `Event` instance. This is useful for data transformation\n   * or adapting the event's data structure.\n   *\n   * @template M The type of data that the mapper function will produce.\n   * @template MR The type of data emitted by the mapped event, usually related to or the same as `M`.\n   * @param {Mapper<T, M>} mapper A function that takes the original event data and returns the transformed data.\n   * @returns {Event<M, MR>} A new `Event` instance that emits the mapped values.\n   *\n   * ```typescript\n   * // Assuming an event that emits numbers, create a new event that emits their squares.\n   * const numberEvent = new Event<number>();\n   * const squaredEvent = numberEvent.map(num => num * num);\n   * squaredEvent.on(squared => console.log('Squared number:', squared));\n   * await numberEvent(5); // Logs: \"Squared number: 25\"\n   * ```\n   */\n  map<M, MR = R>(mapper: Mapper<T, M>): Event<Awaited<M>, MR> {\n    return this.pipe(async function* (value) {\n      yield await mapper(value);\n    });\n  }\n\n  /**\n   * Accumulates the values emitted by this event using a reducer function, starting from an initial value. The reducer\n   * function takes the accumulated value and the latest emitted event data, then returns a new accumulated value. This\n   * new value is then emitted by the returned `Event` instance. This is particularly useful for accumulating state over time.\n   *\n   * @template A The type of the accumulator value.\n   * @template AR The type of data emitted by the reduced event, usually the same as `A`.\n   * @param {Reducer<T, A>} reducer A function that takes the current accumulated value and the new event data, returning the new accumulated value.\n   * @param {A} init The initial value of the accumulator.\n   * @returns {Event<A, AR>} A new `Event` instance that emits the reduced value.\n   *\n   * ```typescript\n   * const sumEvent = numberEvent.reduce((a, b) => a + b, 0);\n   * sumEvent.on((sum) => console.log(sum)); // 1, 3, 6\n   * await sumEvent(1);\n   * await sumEvent(2);\n   * await sumEvent(3);\n   * ```\n   */\n  reduce<A, AR = R>(reducer: Reducer<T, A>, init?: A): Event<Awaited<A>, AR>;\n  reduce<A, AR = R>(reducer: Reducer<T, A>, ...init: unknown[]): Event<Awaited<A>, AR> {\n    let hasInit = init.length === 1;\n    let result = init[0] as A | undefined;\n\n    return this.pipe(async function* (value) {\n      if (hasInit) {\n        result = await reducer(result!, value);\n        yield result;\n      } else {\n        result = value as unknown as A;\n        hasInit = true;\n      }\n    });\n  }\n\n  /**\n   * Transforms each event's data into multiple events using an expander function. The expander function takes\n   * the original event's data and returns an array of new data elements, each of which will be emitted individually\n   * by the returned `Event` instance. This method is useful for scenarios where an event's data can naturally\n   * be expanded into multiple, separate pieces of data which should each trigger further processing independently.\n   *\n   * @template ET - The type of data elements in the array returned by the expander function.\n   * @template ER - The type of responses emitted by the expanded event, usually related to or the same as `ET`.\n   * @param {Expander<T, ET[]>} expander - A function that takes the original event data and returns an array of new data elements.\n   * @returns {Event<ET, ER>} - A new `Event` instance that emits each value from the array returned by the expander function.\n   *\n   * ```typescript\n   * // Assuming an event that emits a sentence, create a new event that emits each word from the sentence separately.\n   * const sentenceEvent = new Event<string>();\n   * const wordEvent = sentenceEvent.expand(sentence => sentence.split(' '));\n   * wordEvent.on(word => console.log('Word:', word));\n   * await sentenceEvent('Hello world'); // Logs: \"Word: Hello\", \"Word: world\"\n   * ```\n   */\n  expand<ET, ER>(expander: Expander<T, ET[]>): Event<Awaited<ET>, ER> {\n    return this.pipe(async function* (value) {\n      const values = await expander(value);\n      for (const value of values) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a new event that emits values based on a conductor event. The orchestrated event will emit the last value\n   * captured from the original event each time the conductor event is triggered. This method is useful for synchronizing\n   * events, where the emission of one event controls the timing of another.\n   *\n   * @template T The type of data emitted by the original event.\n   * @template R The type of data emitted by the orchestrated event, usually the same as `T`.\n   * @param {Event<unknown, unknown>} conductor An event that signals when the orchestrated event should emit.\n   * @returns {Event<T, R>} An orchestrated event that emits values based on the conductor's trigger.\n   *\n   * ```typescript\n   * const rightClickPositionEvent = mouseMoveEvent.orchestrate(mouseRightClickEvent);\n   * ```\n   *\n   * ```typescript\n   * // An event that emits whenever a \"tick\" event occurs.\n   * const tickEvent = new Event<void>();\n   * const dataEvent = new Event<string>();\n   * const synchronizedEvent = dataEvent.orchestrate(tickEvent);\n   * synchronizedEvent.on(data => console.log('Data on tick:', data));\n   * await dataEvent('Hello');\n   * await dataEvent('World!');\n   * await tickEvent(); // Logs: \"Data on tick: World!\"\n   * ```\n   */\n  orchestrate(conductor: Event<any, any>): Event<T, R> {\n    let initialized = false;\n    let lastValue: T;\n    const unsubscribe = this.on(async (event) => {\n      initialized = true;\n      lastValue = event;\n    });\n    const unsubscribeConductor = conductor.on(async () => {\n      if (initialized) {\n        await orchestratedEvent(lastValue);\n        initialized = false;\n      }\n    });\n\n    const orchestratedEvent = new Event<T, R>(unsubscribe.post(unsubscribeConductor));\n    return orchestratedEvent;\n  }\n  /**\n   * Creates a debounced event that delays triggering until after a specified interval has elapsed\n   * following the last time it was invoked. This method is particularly useful for limiting the rate\n   * at which a function is executed. Common use cases include handling rapid user inputs, window resizing,\n   * or scroll events.\n   *\n   * @param {number} interval - The amount of time to wait (in milliseconds) before firing the debounced event.\n   * @returns {Event<T, R>} An event of debounced events.\n   *\n   * ```typescript\n   * const debouncedEvent = textInputEvent.debounce(100);\n   * debouncedEvent.on((str) => console.log(str)); // only 'text' is emitted\n   * await event('t');\n   * await event('te');\n   * await event('tex');\n   * await event('text');\n   * ```\n   */\n  debounce(interval: number): Event<Awaited<T>, unknown> {\n    let controller = new AbortController();\n\n    return this.pipe(async function* (value) {\n      controller.abort();\n      controller = new AbortController();\n      const complete = await setTimeoutAsync(interval, controller.signal);\n      if (complete) {\n        yield value;\n      }\n    });\n  }\n\n  /**\n   * Creates a throttled event that emits values at most once per specified interval.\n   *\n   * This is useful for controlling the rate of event emissions, especially for high-frequency events.\n   * The throttled event will immediately emit the first value, and then only emit subsequent values\n   * if the specified interval has passed since the last emission.\n   *\n   * @param interval - The time interval (in milliseconds) between allowed emissions.\n   * @returns A new Event that emits throttled values.\n   *\n   * ```typescript\n   * const scrollEvent = new Event();\n   * const throttledScroll = scrollEvent.throttle(100); // Emit at most every 100ms\n   * throttledScroll.on(() => console.log(\"Throttled scroll event\"));\n   * ```\n   */\n  throttle(interval: number): Event<Awaited<T>, unknown> {\n    let timeout = 0;\n    let pendingValue: T;\n    let hasPendingValue = false;\n\n    return this.pipe(async function* (value) {\n      const now = Date.now();\n      if (timeout <= now) {\n        timeout = now + interval;\n        yield value;\n      } else {\n        pendingValue = value;\n        if (!hasPendingValue) {\n          hasPendingValue = true;\n          await setTimeoutAsync(timeout - now);\n          timeout = now + interval;\n          hasPendingValue = false;\n          yield pendingValue;\n        }\n      }\n    });\n  }\n\n  /**\n   * Aggregates multiple event emissions into batches and emits the batched events either at specified\n   * time intervals or when the batch reaches a predefined size. This method is useful for grouping\n   * a high volume of events into manageable chunks, such as logging or processing data in bulk.\n   *\n   * @param {number} interval - The time in milliseconds between batch emissions.\n   * @param {number} [size] - Optional. The maximum size of each batch. If specified, triggers a batch emission\n   * once the batch reaches this size, regardless of the interval.\n   * @returns {Event<T[], R>} An event of the batched results.\n   *\n   * ```typescript\n   * // Batch messages for bulk processing every 1 second or when 10 messages are collected\n   * const messageEvent = createEvent<string, void>();\n   * const batchedMessageEvent = messageEvent.batch(1000, 10);\n   * batchedMessageEvent.on((messages) => console.log('Batched Messages:', messages));\n   * ```\n   */\n  batch(interval: number, size?: number): Event<T[], R> {\n    let controller = new AbortController();\n    const batch: T[] = [];\n\n    return this.pipe(async function* (value) {\n      batch.push(value);\n      if (size !== undefined && batch.length >= size) {\n        controller.abort();\n        yield batch.splice(0);\n      }\n      if (batch.length === 1) {\n        controller = new AbortController();\n        const complete = await setTimeoutAsync(interval, controller.signal);\n        if (complete) {\n          yield batch.splice(0);\n        }\n      }\n    });\n  }\n\n  /**\n   * Creates a queue from the event, where each emitted value is sequentially processed. The returned object allows popping elements\n   * from the queue, ensuring that elements are handled one at a time. This method is ideal for scenarios where order and sequential processing are critical.\n   *\n   * @returns {Queue<T>} An object representing the queue. The 'pop' method retrieves the next element from the queue, while 'stop' halts further processing.\n   *\n   * ```typescript\n   * // Queueing tasks for sequential execution\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1\n   *   // Queue also can be used as a Promise\n   *   console.log('Processing:', await taskQueue); // Processing: Task 2\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   *```\n   *\n   *```typescript\n   * // Additionally, the queue can be used as an async iterator\n   * const taskEvent = new Event<string>();\n   * const taskQueue = taskEvent.queue();\n   * (async () => {\n   *   for await (const task of taskQueue) {\n   *     console.log('Processing:', task);\n   *   }\n   * })();\n   * await taskEvent('Task 1');\n   * await taskEvent('Task 2');\n   * ```\n   *\n   */\n  queue(): Queue<T> {\n    const queue: T[] = [];\n    let done = false;\n    const valueEvent = new Event<void>();\n\n    const unsubscribe = this.on(async (value) => {\n      queue.push(value);\n      await valueEvent();\n    });\n\n    const pop = async () => {\n      if (!queue.length) {\n        await valueEvent;\n      }\n      return queue.shift()!;\n    };\n    const stop = async () => {\n      await unsubscribe();\n      done = true;\n      await valueEvent();\n    };\n\n    return {\n      pop,\n      stop,\n      get stopped() {\n        return done;\n      },\n      then<TResult1 = T, TResult2 = never>(\n        onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,\n        onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,\n      ): Promise<TResult1 | TResult2> {\n        return this.pop().then(onfulfilled, onrejected);\n      },\n      [Symbol.asyncIterator]() {\n        return {\n          next: async () => {\n            return { value: await pop(), done };\n          },\n        };\n      },\n    };\n  }\n}\n\nexport interface Queue<T> extends AsyncIterable<T>, PromiseLike<T> {\n  pop(): Promise<T>;\n  stop(): Promise<void>;\n  stopped: boolean;\n}\n\nexport type EventParameters<T> = T extends Event<infer P, any> ? P : never;\n\nexport type EventResult<T> = T extends Event<any, infer R> ? R : never;\n\nexport type AllEventsParameters<T extends Event<any, any>[]> = { [K in keyof T]: EventParameters<T[K]> }[number];\n\nexport type AllEventsResults<T extends Event<any, any>[]> = { [K in keyof T]: EventResult<T[K]> }[number];\n\n/**\n * Merges multiple events into a single event. This function takes any number of `Event` instances\n * and returns a new `Event` that triggers whenever any of the input events trigger. The parameters\n * and results of the merged event are derived from the input events, providing a flexible way to\n * handle multiple sources of events in a unified manner.\n *\n * @template Events - An array of `Event` instances.\n * @param {...Events} events - A rest parameter that takes multiple events to be merged.\n * @returns {Event<AllEventsParameters<Events>, AllEventsResults<Events>>} - Returns a new `Event` instance\n *           that triggers with the parameters and results of any of the merged input events.\n *\n * ```typescript\n * // Merging mouse and keyboard events into a single event\n * const mouseEvent = createEvent<MouseEvent>();\n * const keyboardEvent = createEvent<KeyboardEvent>();\n * const inputEvent = merge(mouseEvent, keyboardEvent);\n * inputEvent.on(event => console.log('Input event:', event));\n * ```\n */\nexport const merge = <Events extends Event<any, any>[]>(...events: Events): Event<AllEventsParameters<Events>, AllEventsResults<Events>> => {\n  const mergedEvent = new Event<AllEventsParameters<Events>, AllEventsResults<Events>>();\n  events.forEach((event) => event.on(mergedEvent));\n  return mergedEvent;\n};\n\n/**\n * Creates a periodic event that triggers at a specified interval. The event will automatically emit\n * an incrementing counter value each time it triggers, starting from zero. This function is useful\n * for creating time-based triggers within an application, such as updating UI elements, polling,\n * or any other timed operation.\n *\n * @template R - The return type of the event handler function, defaulting to `void`.\n * @param {number} interval - The interval in milliseconds at which the event should trigger.\n * @returns {Event<number, R>} - An `Event` instance that triggers at the specified interval,\n *           emitting an incrementing counter value.\n *\n * ```typescript\n * // Creating an interval event that logs a message every second\n * const tickEvent = createInterval(1000);\n * tickEvent.on(tickNumber => console.log('Tick:', tickNumber));\n * ```\n */\nexport const createInterval = <R = unknown>(interval: number): Event<number, R> => {\n  let counter = 0;\n  const intervalEvent = new Event<number, R>(() => clearInterval(timerId));\n  const timerId: ReturnType<typeof setInterval> = setInterval(() => intervalEvent(counter++), interval);\n  return intervalEvent;\n};\n\n/**\n * Creates a new instance of the `Event` class, which allows for the registration of event handlers that get called when the event is emitted.\n * This factory function simplifies the creation of events by encapsulating the instantiation logic, providing a clean and simple API for event creation.\n *\n * @typeParam T - The tuple of argument types that the event will accept.\n * @typeParam R - The return type of the event handler function, which is emitted after processing the event data.\n * @returns {Event<T, R>} - A new instance of the `Event` class, ready to have listeners added to it.\n *\n * ```typescript\n * // Create a new event that accepts a string and returns the string length\n * const myEvent = createEvent<string, number>();\n * myEvent.on((str: string) => str.length);\n * myEvent('hello').then(results => console.log(results)); // Logs: [5]\n * ```\n */\nexport const createEvent = <T = unknown, R = unknown>(): Event<T, R> => new Event<T, R>();\n\nexport default createEvent;\n\n/**\n * A type helper that extracts the event listener type\n *\n * @typeParam E - The event type.\n */\nexport type EventHandler<E> = E extends Event<infer T, infer R> ? Listener<T, R> : never;\n\n/**\n * A type helper that extracts the event filter type\n *\n * @typeParam E The event type to filter.\n */\nexport type EventFilter<E> = FilterFunction<EventParameters<E>>;\n\n/**\n * A type helper that extracts the event predicate type\n *\n * @typeParam E The event type to predicate.\n */\nexport type EventPredicate<E, P extends EventParameters<E>> = Predicate<EventParameters<E>, P>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The event type to map.\n * @typeParam M The new type to map `E` to.\n */\nexport type EventMapper<E, M> = Mapper<EventParameters<E>, M>;\n\n/**\n * A type helper that extracts the event mapper type\n *\n * @typeParam E The type of event to reduce.\n * @typeParam M The type of reduced event.\n */\nexport type EventReducer<E, R> = Reducer<EventParameters<E>, R>;\n"],"names":["removeListener","listeners","listener","index","indexOf","wasRemoved","splice","setTimeoutAsync","timeout","signal","Promise","resolve","timerId","setTimeout","addEventListener","clearTimeout","Callable","Function","constructor","func","Object","setPrototypeOf","prototype","Unsubscribe","_done","callback","done","pre","post","countdown","count","SpyType","Event","spies","_disposed","dispose","value","all","map","clear","_error","error","size","length","disposed","lacks","has","off","forEach","spy","on","push","once","oneTimeListener","event","undefined","then","onfulfilled","onrejected","promise","v","Symbol","asyncIterator","queue","doneEvent","emitEvent","unsubscribe","target","action","next","shift","return","pipe","generator","generatedValue","result","catch","e","filter","first","filteredEvent","mapper","reduce","reducer","init","hasInit","expand","expander","values","orchestrate","conductor","initialized","lastValue","unsubscribeConductor","orchestratedEvent","debounce","interval","controller","AbortController","abort","complete","throttle","pendingValue","hasPendingValue","now","Date","batch","valueEvent","pop","stop","stopped","merge","events","mergedEvent","createInterval","counter","intervalEvent","clearInterval","setInterval","createEvent"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "evnty",
   "description": "0-Deps, simple, fast, for browser and node js reactive anonymous event library",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "type": "module",
   "types": "build/index.d.ts",
   "main": "build/index.cjs",

package/src/index.ts

@@ -49,7 +49,7 @@ export interface Expander<T, R> {
  * console.log(wasRemoved); // Output: true
  * ```
  */
-export const removeListener = <T, R>(listeners: Listener<T, R>[], listener: Listener<T, R>): boolean => {
+export const removeListener = (listeners: unknown[], listener: unknown): boolean => {
   let index = listeners.indexOf(listener);
   const wasRemoved = index !== -1;
   while (~index) {
@@ -96,8 +96,17 @@ export interface Unsubscribe {
  * @internal
  */
 export class Unsubscribe extends Callable {
+  private _done = false;
+
   constructor(callback: Callback) {
-    super(callback);
+    super(() => {
+      this._done = true;
+      callback();
+    });
+  }
+
+  get done() {
+    return this._done;
   }
 
   pre(callback: Callback): Unsubscribe {
@@ -123,16 +132,15 @@ export class Unsubscribe extends Callable {
   }
 }
 
-export interface Queue<T> extends AsyncIterable<T> {
-  pop(): MaybePromise<T>;
-  stop(): MaybePromise<void>;
-  stopped: boolean;
-}
-
 export interface Event<T = any, R = any> {
   (event: T): Promise<(void | Awaited<R>)[]>;
 }
 
+enum SpyType {
+  Add,
+  Remove,
+}
+
 /**
  * A class representing an anonymous event that can be listened to or triggered.
  *
@@ -145,7 +153,9 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
    */
   private listeners: Listener<T, R>[];
 
-  private spies: Array<(listener: Listener<T, R> | void) => void> = [];
+  private spies: Array<(listener: Listener<T, R> | void, type: SpyType) => void> = [];
+
+  private _disposed = false;
 
   /**
    * A function that disposes of the event and its listeners.
@@ -170,6 +180,7 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
     this.listeners = listeners;
 
     this.dispose = async () => {
+      this._disposed = true;
       void this.clear();
       await this._error?.dispose();
       await dispose?.();
@@ -197,6 +208,14 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
     return this.listeners.length;
   }
 
+  /**
+   * Checks if the event has been disposed.
+   * @returns {boolean} `true` if the event has been disposed; otherwise, `false`.
+   */
+  get disposed(): boolean {
+    return this._disposed;
+  }
+
   /**
    * Checks if the given listener is NOT registered for this event.
    *
@@ -244,7 +263,7 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
    */
   off(listener: Listener<T, R>): this {
     if (removeListener(this.listeners, listener) && this.spies.length) {
-      [...this.spies].forEach((spy) => spy(listener));
+      [...this.spies].forEach((spy) => spy(listener, SpyType.Remove));
     }
     return this;
   }
@@ -265,6 +284,9 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
    */
   on(listener: Listener<T, R>): Unsubscribe {
     this.listeners.push(listener);
+    if (this.spies.length) {
+      [...this.spies].forEach((spy) => spy(listener, SpyType.Add));
+    }
     return new Unsubscribe(() => {
       void this.off(listener);
     });
@@ -307,7 +329,7 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
   clear(): this {
     this.listeners.splice(0);
     if (this.spies.length) {
-      [...this.spies].forEach((spy) => spy());
+      [...this.spies].forEach((spy) => spy(undefined, SpyType.Remove));
     }
     return this;
   }
@@ -375,8 +397,8 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
       await doneEvent.dispose();
     });
 
-    const spy: (typeof this.spies)[number] = (target = emitEvent) => {
-      if (target === emitEvent) {
+    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {
+      if (target === emitEvent && action === SpyType.Remove) {
         void doneEvent(true);
         void unsubscribe();
       }
@@ -436,8 +458,8 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
       removeListener(this.spies, spy);
     });
 
-    const spy: (typeof this.spies)[number] = (target = emitEvent) => {
-      if (target === emitEvent) {
+    const spy: (typeof this.spies)[number] = (target = emitEvent, action) => {
+      if (target === emitEvent && action === SpyType.Remove) {
         void unsubscribe();
       }
     };
@@ -770,16 +792,32 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
    * const taskQueue = taskEvent.queue();
    * (async () => {
    *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 1
-   *   console.log('Processing:', await taskQueue.pop()); // Processing: Task 2
+   *   // Queue also can be used as a Promise
+   *   console.log('Processing:', await taskQueue); // Processing: Task 2
+   * })();
+   * await taskEvent('Task 1');
+   * await taskEvent('Task 2');
+   *```
+   *
+   *```typescript
+   * // Additionally, the queue can be used as an async iterator
+   * const taskEvent = new Event<string>();
+   * const taskQueue = taskEvent.queue();
+   * (async () => {
+   *   for await (const task of taskQueue) {
+   *     console.log('Processing:', task);
+   *   }
    * })();
    * await taskEvent('Task 1');
    * await taskEvent('Task 2');
    * ```
+   *
    */
   queue(): Queue<T> {
     const queue: T[] = [];
     let done = false;
     const valueEvent = new Event<void>();
+
     const unsubscribe = this.on(async (value) => {
       queue.push(value);
       await valueEvent();
@@ -803,6 +841,12 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
       get stopped() {
         return done;
       },
+      then<TResult1 = T, TResult2 = never>(
+        onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined,
+        onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null | undefined,
+      ): Promise<TResult1 | TResult2> {
+        return this.pop().then(onfulfilled, onrejected);
+      },
       [Symbol.asyncIterator]() {
         return {
           next: async () => {
@@ -814,6 +858,12 @@ export class Event<T, R> extends Callable implements AsyncIterable<T>, PromiseLi
   }
 }
 
+export interface Queue<T> extends AsyncIterable<T>, PromiseLike<T> {
+  pop(): Promise<T>;
+  stop(): Promise<void>;
+  stopped: boolean;
+}
+
 export type EventParameters<T> = T extends Event<infer P, any> ? P : never;
 
 export type EventResult<T> = T extends Event<any, infer R> ? R : never;