feat(timer): add timer package

packages/timer/config.toml

@@ -0,0 +1,6 @@
+name = "timer"
+description = "Schedule functions to be called at a future time."
+version = "1.0.0"
+
+bundle = "timer"
+dependencies = ["env", "future", "threadpool"]

packages/timer/init.luau

@@ -0,0 +1,30 @@
+local Future = require("../future")
+local env = require("../env")
+local threadpool = require("../threadpool")
+
+local task = env.libs.task
+
+local timer = {}
+
+function timer.delay(duration: number): Future.Future<number>
+	return Future.spawn(task.wait, duration)
+end
+
+function timer.interval<T...>(duration: number, f: (T...) -> (), ...: T...): () -> ()
+	-- selene: allow(shadowing)
+	local function inner(duration: number, f: (T...) -> (), ...: T...)
+		local nextTick = os.clock() + duration
+		while true do
+			task.wait(nextTick - os.clock())
+			threadpool.spawn(f, ...)
+			nextTick += duration
+		end
+	end
+
+	local thread = task.spawn(inner, duration, f, ...)
+	return function()
+		task.cancel(thread)
+	end
+end
+
+return timer