Reconnect

There are occasions where you :Disconnect and end up calling :Connect again with a new function, with :Reconnect that stops being a problem because reconnecting uses that exact function you passed in your connection and simply links it back to the signal.

INFO

:Once connections retain their behavior, as in they will get disconnected again on the next :Fire

local signal = LemonSignal.new()

local connection1 = signal:Connect(function()
    print("Used Connect")
end)

local connection2 = signal:Once(function()
    print("Used Once")
end)

signal:Fire()
--> Used Once
--> Used Connect

connection1:Disconnect()

signal:Fire() -- both connections are disconnected, nothing will fire

connection1:Reconnect()
connection2:Reconnect()

signal:Fire()
--> Used Once
--> Used Connect

print(connection2.Connected) -- prints false, the :Once connection retains its behavior

signal:Fire()
--> Used Connect

Variadic connections

Another cool feature is the ability to connect a function while passing varargs which so you can use the same function for all your objects for a clean and flyweight code.

INFO

:Fire varargs get appended to a connection's varargs, meaning that :Connect and :Once varargs will always come before :Fire's

local signal = LemonSignal.new()

local function foo(str1: string, str2: string)
    print(str1 .. " " .. str2)
end

signal:Connect(foo, "Hello")

signal:Fire("world!")
--> Hello world!

Signal wrapping

This lets you "turn" an RBXScriptSignal into a LemonSignal by firing the latter signal every time the former fires, so you can use all the new API as if the RBXScriptSignal had it.

local bindable = Instance.new("BindableEvent")

local signal = LemonSignal.wrap(bindable.Event)

signal:Connect(function(str: string)
    print("Wrapped", str)
end)

bindable:Fire("signal")
--> Wrapped signal