@mary-ext/simple-event-emitter 1.0.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Mary
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,15 @@
+# simple-event-emitter
+
+a really simple event emitter
+
+```ts
+type UserStatus = 'online' | 'away' | 'offline';
+
+const userStatusChanged = new SimpleEventEmitter<[username: string, status: UserStatus]>();
+
+const cleanup = userStatusChanged.subscribe((username, status) => {
+	console.log(`@${username} is now ${status}`);
+});
+
+userStatusChanged.emit('mary', 'offline');
+```

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type EventListener<TArgs extends unknown[]> = (...args: TArgs) => void;
+export type CleanupFunction = () => void;
+export declare class SimpleEventEmitter<TArgs extends unknown[]> {
+    #private;
+    emit(...args: TArgs): boolean;
+    subscribe(listener: EventListener<TArgs>): CleanupFunction;
+    unsubscribe(listener: EventListener<TArgs>): void;
+}

package/dist/index.js

@@ -0,0 +1,53 @@
+export class SimpleEventEmitter {
+    #listener;
+    emit(...args) {
+        const listener = this.#listener;
+        if (listener === undefined) {
+            return false;
+        }
+        if (typeof listener === 'function') {
+            listener.apply(this, args);
+        }
+        else {
+            for (let idx = 0, len = listener.length; idx < len; idx++) {
+                listener[idx].apply(this, args);
+            }
+        }
+        return true;
+    }
+    subscribe(listener) {
+        const existing = this.#listener;
+        if (existing === undefined) {
+            this.#listener = listener;
+        }
+        else if (typeof existing === 'function') {
+            this.#listener = [existing, listener];
+        }
+        else {
+            this.#listener = existing.concat(listener);
+        }
+        return this.unsubscribe.bind(listener);
+    }
+    unsubscribe(listener) {
+        const existing = this.#listener;
+        if (existing === undefined) {
+            return;
+        }
+        if (existing === listener) {
+            this.#listener = undefined;
+        }
+        else if (typeof existing !== 'function') {
+            const index = existing.indexOf(listener);
+            if (index !== -1) {
+                if (existing.length === 2) {
+                    // ^ flips the bit, it's either 0 or 1 here.
+                    this.#listener = existing[index ^ 1];
+                }
+                else {
+                    this.#listener = existing.toSpliced(index, 1);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IAC9B,SAAS,CAA+C;IAExD,IAAI,CAAC,GAAG,IAAW;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACd,CAAC;QAED,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACpC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACP,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;gBAC3D,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS,CAAC,QAA8B;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC3B,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAoB,CAAC;IAC3D,CAAC;IAED,WAAW,CAAC,QAA8B;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACR,CAAC;QAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEzC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,4CAA4C;oBAC5C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACtC,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC/C,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;CACD"}

package/lib/index.ts

@@ -0,0 +1,63 @@
+type MaybeArray<T> = T | T[];
+
+export type EventListener<TArgs extends unknown[]> = (...args: TArgs) => void;
+export type CleanupFunction = () => void;
+
+export class SimpleEventEmitter<TArgs extends unknown[]> {
+	#listener: MaybeArray<EventListener<TArgs>> | undefined;
+
+	emit(...args: TArgs): boolean {
+		const listener = this.#listener;
+
+		if (listener === undefined) {
+			return false;
+		}
+
+		if (typeof listener === 'function') {
+			listener.apply(this, args);
+		} else {
+			for (let idx = 0, len = listener.length; idx < len; idx++) {
+				listener[idx].apply(this, args);
+			}
+		}
+
+		return true;
+	}
+
+	subscribe(listener: EventListener<TArgs>): CleanupFunction {
+		const existing = this.#listener;
+
+		if (existing === undefined) {
+			this.#listener = listener;
+		} else if (typeof existing === 'function') {
+			this.#listener = [existing, listener];
+		} else {
+			this.#listener = existing.concat(listener);
+		}
+
+		return this.unsubscribe.bind(listener) as CleanupFunction;
+	}
+
+	unsubscribe(listener: EventListener<TArgs>): void {
+		const existing = this.#listener;
+
+		if (existing === undefined) {
+			return;
+		}
+
+		if (existing === listener) {
+			this.#listener = undefined;
+		} else if (typeof existing !== 'function') {
+			const index = existing.indexOf(listener);
+
+			if (index !== -1) {
+				if (existing.length === 2) {
+					// ^ flips the bit, it's either 0 or 1 here.
+					this.#listener = existing[index ^ 1];
+				} else {
+					this.#listener = existing.toSpliced(index, 1);
+				}
+			}
+		}
+	}
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+	"type": "module",
+	"name": "@mary-ext/simple-event-emitter",
+	"version": "1.0.0",
+	"description": "A really simple event emitter",
+	"license": "BSD-3-Clause",
+	"repository": {
+		"url": "https://codeberg.org/mary-ext/npm-simple-event-emitter"
+	},
+	"files": [
+		"dist/",
+		"lib/",
+		"!lib/**/*.bench.ts",
+		"!lib/**/*.test.ts"
+	],
+	"exports": {
+		".": "./dist/index.js"
+	},
+	"scripts": {
+		"build": "tsc --project tsconfig.build.json",
+		"fmt": "prettier --cache --write .",
+		"prepack": "rm -rf dist; bun run build"
+	},
+	"devDependencies": {
+		"prettier": "^3.5.3",
+		"typescript": "~5.8.3"
+	}
+}