@wxn0brp/event-emitter 0.0.4 → 0.0.6

package/README.md

@@ -54,6 +54,11 @@ emitter.emit('data', 42, new Date()); // Typescript suggests number and Date par
 
 // You can still emit events without strict type checking
 emitter.emit('unknown_event', 'any', 'data'); // This is still allowed at runtime
+
+// Catch-all event listener for all events
+emitter.on('*', (originalEvent, ...originalArgs) => {
+  console.log(`Received event "${originalEvent}":`, originalArgs);
+});
 ```
 
 ## API
@@ -78,6 +83,17 @@ Removes an event listener.
 
 Emits an event.
 
+### Catch-all Event Listener
+
+The special `*` event acts as a catch-all that receives all emitted events. When any event is emitted, it will also trigger listeners registered for the `*` event with the original event name as the first argument, followed by the original arguments.
+
+Example:
+```typescript
+emitter.on("*", (originalEvent, ...originalArgs) => {
+  console.log(`Caught event "${originalEvent}" with args:`, originalArgs);
+});
+```
+
 ### `listenerCount(event: string): number`
 
 Returns the number of listeners for the given event.

package/dist/index.d.ts

@@ -12,25 +12,26 @@ export declare class VEE<T extends EventMap = {}> {
      * @param {K} event - event name
      * @param {Function} listener - function to be called when event occurs
      */
-    on<K extends EventName<T>>(event: K, listener: (...args: EventArgs<T, K>) => void): void;
+    on<K extends EventName<T>>(event: K, listener: T[K]): () => this;
     /**
      * Registers a one-time event listener
      * @param {K} event - event name
      * @param {Function} listener - function to be called once
      */
-    once<K extends EventName<T>>(event: K, listener: (...args: EventArgs<T, K>) => void): void;
+    once<K extends EventName<T>>(event: K, listener: T[K]): () => this;
     /**
      * Removes an event listener.
      * @param {K} event - event name
      * @param {Function} listener - listener to remove
      */
-    off<K extends EventName<T>>(event: K, listener: (...args: EventArgs<T, K>) => void): void;
+    off<K extends EventName<T>>(event: K, listener: T[K]): this;
+    _emit(event: string, ...args: any[]): this;
     /**
      * Emits an event
      * @param {K} event - event name
      * @param {...EventArgs<T, K>} args - arguments to be passed to listeners
      */
-    emit<K extends EventName<T>>(event: K, ...args: EventArgs<T, K>): void;
+    emit<K extends EventName<T>>(event: K, ...args: EventArgs<T, K>): this;
     /**
      * Returns the number of listeners for the given event
      * @param {K} event - event name

package/dist/index.js

@@ -10,6 +10,7 @@ export class VEE {
         if (!this._events[_event])
             this._events[_event] = [];
         this._events[_event].push(listener);
+        return () => this.off(event, listener);
     }
     /**
      * Registers a one-time event listener
@@ -21,7 +22,7 @@ export class VEE {
             this.off(event, onceListener);
             listener(...args);
         };
-        this.on(event, onceListener);
+        return this.on(event, onceListener);
     }
     /**
      * Removes an event listener.
@@ -31,8 +32,16 @@ export class VEE {
     off(event, listener) {
         const _event = event;
         if (!this._events[_event])
-            return;
+            return this;
         this._events[_event] = this._events[_event].filter(l => l !== listener);
+        return this;
+    }
+    _emit(event, ...args) {
+        const listeners = this._events[event];
+        if (!listeners?.length)
+            return this;
+        listeners.forEach(listener => listener(...args));
+        return this;
     }
     /**
      * Emits an event
@@ -40,12 +49,9 @@ export class VEE {
      * @param {...EventArgs<T, K>} args - arguments to be passed to listeners
      */
     emit(event, ...args) {
-        const listeners = this._events[event];
-        if (listeners && listeners.length > 0) {
-            listeners.forEach(listener => {
-                listener(...args);
-            });
-        }
+        this._emit(event, ...args);
+        this._emit("*", event, ...args);
+        return this;
     }
     /**
      * Returns the number of listeners for the given event

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wxn0brp/event-emitter",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "wxn0brP",
@@ -13,7 +13,8 @@
   },
   "homepage": "https://github.com/wxn0brP/EventEmitter",
   "devDependencies": {
-    "typescript": "^5.7.3"
+    "@wxn0brp/biome": "*",
+    "typescript": "^7"
   },
   "files": [
     "dist"