@ektorpu/signal 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ektorpu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,34 @@
+{
+    "name": "@ektorpu/signal",
+    "version": "1.0.0",
+    "description": "Signal library for roblox-ts",
+    "license": "MIT",
+    "keywords": [
+        "roblox",
+        "roblox-ts",
+        "signal"
+    ],
+    "type": "commonjs",
+    "main": "src/signal/index.ts",
+    "files": [
+        "LICENSE",
+        "src/signal"
+    ],
+    "scripts": {
+        "build": "rbxtsc",
+        "watch": "rbxtsc -w"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "peerDependencies": {
+        "roblox-ts": "^3.0.0"
+    },
+    "devDependencies": {
+        "@rbxts/compiler-types": "^3.0.0-types.0",
+        "@rbxts/types": "^1.0.940",
+        "roblox-ts": "^3.0.0",
+        "typescript": "^5.9.3",
+        "prettier": "^3.7.4"
+    }
+}

package/src/signal/index.ts

@@ -0,0 +1,68 @@
+export class Signal<Params extends unknown[] = []> {
+    private readonly connections: Set<Connection<Params>> = new Set();
+    private readonly sleepingThreads: thread[] = [];
+
+    public Fire(...params: Params) {
+        for (const connection of this.connections) {
+            connection.Run(...params);
+        }
+
+        for (const thread of this.sleepingThreads) {
+            task.spawn(thread, ...params);
+        }
+        this.sleepingThreads.clear();
+    }
+
+    private makeConnection(
+        callback: (...params: Params) => unknown,
+        persistent: boolean
+    ) {
+        const connection = new Connection(
+            callback,
+            this.connections,
+            persistent
+        );
+        this.connections.add(connection);
+        return connection;
+    }
+
+    public Connect(callback: (...params: Params) => unknown) {
+        return this.makeConnection(callback, true);
+    }
+
+    public Once(callback: (...params: Params) => unknown) {
+        return this.makeConnection(callback, false);
+    }
+
+    public Await(): Params {
+        this.sleepingThreads.push(coroutine.running());
+        return coroutine.yield() as unknown as Params;
+    }
+}
+
+class Connection<Params extends unknown[]> {
+    private active = true;
+
+    constructor(
+        private readonly callback: (...params: Params) => unknown,
+        private readonly connectionList: Set<Connection<Params>>,
+        private readonly persistent: boolean
+    ) {}
+
+    public Run(...params: Params) {
+        if (!this.active) return;
+
+        try {
+            this.callback(...params);
+        } catch (err) {
+            warn(err);
+        }
+
+        if (!this.persistent) this.Disconnect();
+    }
+
+    public Disconnect() {
+        this.connectionList.delete(this);
+        this.active = false;
+    }
+}