cluaupp 1.0.0 → 1.3.0

package/templates/game/libs/Fusion/_impl/Instances/defaultProps.luau

@@ -0,0 +1,194 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Stores 'sensible default' properties to be applied to instances created by
+	the New function.
+]]
+
+return {
+	ScreenGui = {
+		ResetOnSpawn = false,
+		ZIndexBehavior = Enum.ZIndexBehavior.Sibling
+	},
+
+	BillboardGui = {
+		ResetOnSpawn = false,
+		ZIndexBehavior = Enum.ZIndexBehavior.Sibling,
+		Active = true
+	},
+
+	SurfaceGui = {
+		ResetOnSpawn = false,
+		ZIndexBehavior = Enum.ZIndexBehavior.Sibling,
+
+		SizingMode = Enum.SurfaceGuiSizingMode.PixelsPerStud,
+		PixelsPerStud = 50
+	},
+
+	Frame = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0
+	},
+
+	ScrollingFrame = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0,
+
+		ScrollBarImageColor3 = Color3.new(0, 0, 0)
+	},
+
+	TextLabel = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0,
+
+		Font = Enum.Font.SourceSans,
+		Text = "",
+		TextColor3 = Color3.new(0, 0, 0),
+		TextSize = 14
+	},
+
+	TextButton = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0,
+
+		AutoButtonColor = false,
+
+		Font = Enum.Font.SourceSans,
+		Text = "",
+		TextColor3 = Color3.new(0, 0, 0),
+		TextSize = 14
+	},
+
+	TextBox = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0,
+
+		ClearTextOnFocus = false,
+
+		Font = Enum.Font.SourceSans,
+		Text = "",
+		TextColor3 = Color3.new(0, 0, 0),
+		TextSize = 14
+	},
+
+	ImageLabel = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0
+	},
+
+	ImageButton = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0,
+
+		AutoButtonColor = false
+	},
+
+	ViewportFrame = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0
+	},
+
+	VideoFrame = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0
+	},
+	
+	CanvasGroup = {
+		BackgroundColor3 = Color3.new(1, 1, 1),
+		BorderColor3 = Color3.new(0, 0, 0),
+		BorderSizePixel = 0
+	},
+
+	SpawnLocation = {
+		Duration = 0
+	},
+
+	BoxHandleAdornment = {
+		ZIndex = 0
+	},
+	ConeHandleAdornment = {
+		ZIndex = 0
+	},
+	CylinderHandleAdornment = {
+		ZIndex = 0
+	},
+	ImageHandleAdornment = {
+		ZIndex = 0
+	},
+	LineHandleAdornment = {
+		ZIndex = 0
+	},
+	SphereHandleAdornment = {
+		ZIndex = 0
+	},
+	WireframeHandleAdornment = {
+		ZIndex = 0
+	},
+	
+	Part = {
+		Anchored = true,
+		Size = Vector3.one,
+		FrontSurface = Enum.SurfaceType.Smooth,
+		BackSurface = Enum.SurfaceType.Smooth,
+		LeftSurface = Enum.SurfaceType.Smooth,
+		RightSurface = Enum.SurfaceType.Smooth,
+		TopSurface = Enum.SurfaceType.Smooth,
+		BottomSurface = Enum.SurfaceType.Smooth,
+	},
+	
+	TrussPart = {
+		Anchored = true,
+		Size = Vector3.one * 2,
+		FrontSurface = Enum.SurfaceType.Smooth,
+		BackSurface = Enum.SurfaceType.Smooth,
+		LeftSurface = Enum.SurfaceType.Smooth,
+		RightSurface = Enum.SurfaceType.Smooth,
+		TopSurface = Enum.SurfaceType.Smooth,
+		BottomSurface = Enum.SurfaceType.Smooth,
+	},
+
+	MeshPart = {
+		Anchored = true,
+		Size = Vector3.one,
+		FrontSurface = Enum.SurfaceType.Smooth,
+		BackSurface = Enum.SurfaceType.Smooth,
+		LeftSurface = Enum.SurfaceType.Smooth,
+		RightSurface = Enum.SurfaceType.Smooth,
+		TopSurface = Enum.SurfaceType.Smooth,
+		BottomSurface = Enum.SurfaceType.Smooth,
+	},
+
+	CornerWedgePart = {
+		Anchored = true,
+		Size = Vector3.one,
+		FrontSurface = Enum.SurfaceType.Smooth,
+		BackSurface = Enum.SurfaceType.Smooth,
+		LeftSurface = Enum.SurfaceType.Smooth,
+		RightSurface = Enum.SurfaceType.Smooth,
+		TopSurface = Enum.SurfaceType.Smooth,
+		BottomSurface = Enum.SurfaceType.Smooth,
+	},
+
+	VehicleSeat = {
+		Anchored = true,
+		Size = Vector3.one,
+		FrontSurface = Enum.SurfaceType.Smooth,
+		BackSurface = Enum.SurfaceType.Smooth,
+		LeftSurface = Enum.SurfaceType.Smooth,
+		RightSurface = Enum.SurfaceType.Smooth,
+		TopSurface = Enum.SurfaceType.Smooth,
+		BottomSurface = Enum.SurfaceType.Smooth,
+	},
+}

package/templates/game/libs/Fusion/_impl/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Daniel P H Fox
+
+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/templates/game/libs/Fusion/_impl/Logging/formatError.luau

@@ -0,0 +1,49 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Formats a Fusion-specific error message.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local messages = require(Package.Logging.messages)
+
+local ERROR_INFO_URL = "https://elttob.uk/Fusion/0.3/api-reference/general/errors/#"
+
+local function formatError(
+	externalProvider: Types.ExternalProvider?,
+	messageID: string,
+	errorOrTrace: Types.Error | string | nil,
+	...: unknown
+): string
+	local originalMessageID = messageID
+	local error: Types.Error? = if typeof(errorOrTrace) == "table" then errorOrTrace else nil
+	local trace: string? = if typeof(errorOrTrace) == "table" then errorOrTrace.trace else errorOrTrace
+	local messageText = messages[messageID]
+	if messageText == nil then
+		messageID = "unknownMessage"
+		messageText = messages[messageID]
+	end
+	messageText = messageText:format(...)
+	if error ~= nil then
+		messageText = messageText:gsub("ERROR_MESSAGE", error.message)
+		if error.context ~= nil then
+			messageText ..= ` ({error.context})`
+		end
+	else
+		messageText = messageText:gsub("ERROR_MESSAGE", originalMessageID)
+	end
+	messageText = `[Fusion] {messageText} \nID: {messageID}`
+	if externalProvider ~= nil and externalProvider.policies.allowWebLinks then
+		messageText ..= `\nLearn more: {ERROR_INFO_URL}{messageID:lower()}`
+	end
+	if trace ~= nil then
+		messageText ..= ` \n---- Stack trace ----\n{trace}`
+	end
+	return messageText:gsub("\n", "\n    ")
+end
+
+return formatError

package/templates/game/libs/Fusion/_impl/Logging/messages.luau

@@ -0,0 +1,46 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Stores templates for different kinds of logging messages.
+]]
+
+return {
+	callbackError = "Error in callback:\nERROR_MESSAGE",
+	cannotAssignProperty = "The class type '%s' has no assignable property '%s'.",
+	cannotConnectChange = "The %s class doesn't have a property called '%s'.",
+	cannotConnectEvent = "The %s class doesn't have an event called '%s'.",
+	cannotCreateClass = "Can't create a new instance of class '%s'.",
+	cannotDepend = "%s can't depend on %s.",
+	destroyedTwice = "`doCleanup()` was given something that it is already cleaning up. Unclear how to proceed.",
+	forKeyCollision = "The key '%s' was returned multiple times simultaneously, which is not allowed in `For` objects.",
+	infiniteLoop = "Detected an infinite loop. Consider adding an explicit breakpoint to your code to prevent a cyclic dependency.",
+	invalidAttributeChangeHandler = "The change handler for the '%s' attribute must be a function.",
+	invalidAttributeOutType = "[AttributeOut] properties must be given Value objects.",
+	invalidChangeHandler = "The change handler for the '%s' property must be a function.",
+	invalidEventHandler = "The handler for the '%s' event must be a function.",
+	invalidOutProperty = "The %s class doesn't have a property called '%s'.",
+	invalidOutType = "[Out] properties must be given Value objects.",
+	invalidPropertyType = "'%s.%s' expected a '%s' type, but got a '%s' type.",
+	invalidSpringDamping = "The damping ratio for a spring must be >= 0. (damping was %.2f)",
+	invalidSpringSpeed = "The speed of a spring must be >= 0. (speed was %.2f)",
+	mergeConflict = "Multiple definitions for '%s' found while merging.",
+	mistypedSpringDamping = "The damping ratio for a spring must be a number. (got a %s)",
+	mistypedSpringSpeed = "The speed of a spring must be a number. (got a %s)",
+	mistypedTweenInfo = "The tween info of a tween must be a TweenInfo. (got a %s)",
+	noTaskScheduler = "Fusion is not connected to an external task scheduler.",
+	poisonedScope = "Attempted to use a scope after it's been destroyed; %s",
+	propertySetError = "Error setting property:\nERROR_MESSAGE",
+	springNanGoal = "A spring was given a NaN goal, so some simulation has been skipped. Ensure no springs have NaN goals.",
+	springNanMotion = "A spring encountered NaN during motion, so has snapped to the goal position. Ensure no springs have NaN positions or velocities.",
+	springTypeMismatch = "The type '%s' doesn't match the spring's type '%s'.",
+	tweenNanGoal = "A tween was given a NaN goal, so some animation has been skipped. Ensure no tweens have NaN goals.",
+	tweenNanMotion = "A tween encountered NaN during motion, so has snapped to the goal. Ensure no tweens have NaN in their tween infos.",
+	unknownMessage = "Unknown error:\nERROR_MESSAGE",
+	unrecognisedChildType = "'%s' type children aren't accepted by `[Children]`.",
+	unrecognisedPropertyKey = "'%s' keys aren't accepted in property tables.",
+	unrecognisedPropertyStage = "'%s' isn't a valid stage for a special key to be applied at.",
+	useAfterDestroy = "%s is no longer valid - it was destroyed before %s. See discussion #292 on GitHub for advice."
+}

package/templates/game/libs/Fusion/_impl/Logging/parseError.luau

@@ -0,0 +1,25 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	An xpcall() error handler to collect and parse useful information about
+	errors, such as clean messages and stack traces.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+
+local function parseError(
+	err: string
+): Types.Error
+	return {
+		type = "Error",
+		raw = err,
+		message = err:gsub("^.+:%d+:%s*", ""),
+		trace = debug.traceback(nil, 2)
+	}
+end
+
+return parseError

package/templates/game/libs/Fusion/_impl/Memory/checkLifetime.luau

@@ -0,0 +1,134 @@
+
+
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Procedures for checking lifetimes and printing helpful warnings about them.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+local nameOf = require(Package.Utility.nameOf)
+
+local checkLifetime = {}
+
+checkLifetime.formatters = {}
+
+function checkLifetime.formatters.useFunction(
+	self: unknown,
+	used: unknown
+): (string, string)
+	local selfName = nameOf(self, "object")
+	local usedName = nameOf(used, "object")
+	return `The use()-d {usedName}`, `the {selfName}`
+end
+	
+function checkLifetime.formatters.boundProperty(
+	instance: Instance,
+	bound: unknown,
+	property: string
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "value")
+	return `The {boundName} (bound to the {property} property)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.boundAttribute(
+	instance: Instance,
+	bound: unknown,
+	attribute: string
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "value")
+	return `The {boundName} (bound to the {attribute} attribute)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.boundTag(
+	instance: Instance,
+	bound: unknown,
+	tag: string
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "value")
+	return `The {boundName} (bound to the {tag} CollectionService tag)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.propertyOutputsTo(
+	instance: Instance,
+	bound: unknown,
+	property: string
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "object")
+	return `The {boundName} (which the {property} property outputs to)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.attributeOutputsTo(
+	instance: Instance,
+	bound: unknown,
+	attribute: string
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "object")
+	return `The {boundName} (which the {attribute} attribute outputs to)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.refOutputsTo(
+	instance: Instance,
+	bound: unknown
+): (string, string)
+	local selfName = instance.Name
+	local boundName = nameOf(bound, "object")
+	return `The {boundName} (which the Ref key outputs to)`, `the {selfName} instance`
+end
+
+function checkLifetime.formatters.animationGoal(
+	self: unknown,
+	goal: unknown
+): (string, string)
+	local selfName = nameOf(self, "object")
+	local goalName = nameOf(goal, "object")
+	return `The goal {goalName}`, `the {selfName} that is following it`
+end
+
+function checkLifetime.formatters.parameter(
+	self: unknown,
+	used: unknown,
+	parameterName: string | false
+): (string, string)
+	local selfName = nameOf(self, "object")
+	local usedName = nameOf(used, "object")
+	if parameterName == false then
+		return `The {usedName} parameter`, `the {selfName} that it was used for`
+	else
+		return `The {usedName} representing the {parameterName} parameter`, `the {selfName} that it was used for`
+	end
+end
+
+function checkLifetime.formatters.observer(
+	self: unknown,
+	watched: unknown
+): (string, string)
+	local selfName = nameOf(self, "object")
+	local watchedName = nameOf(watched, "object")
+	return `The watched {watchedName}`, `the {selfName} that's observing it for changes`
+end
+
+function checkLifetime.bOutlivesA<A, B, Args...>(
+	scopeA: Types.Scope<unknown>,
+	a: A,
+	scopeB: Types.Scope<unknown>?,
+	b: B,
+	formatter: (a: A, b: B, Args...) -> (string, string),
+	...: Args...
+)
+	if scopeB == nil then
+		External.logError("useAfterDestroy", nil, formatter(a, b, ...))
+	end
+end
+
+return checkLifetime

package/templates/game/libs/Fusion/_impl/Memory/deriveScope.luau

@@ -0,0 +1,24 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Creates an empty scope with the same metatables as the original scope. Used
+	for preserving access to constructors when creating inner scopes.
+
+	This is the public version of the function, which implements external
+	debugging hooks.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local ExternalDebug = require(Package.ExternalDebug)
+local deriveScopeImpl = require(Package.Memory.deriveScopeImpl)
+
+local function deriveScope(...)
+	local scope = deriveScopeImpl(...)
+	ExternalDebug.trackScope(scope)
+	return scope
+end
+
+return deriveScope :: Types.DeriveScopeConstructor

package/templates/game/libs/Fusion/_impl/Memory/deriveScopeImpl.luau

@@ -0,0 +1,40 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Creates an empty scope with the same metatables as the original scope. Used
+	for preserving access to constructors when creating inner scopes.
+
+	This is the internal version of the function, which does not implement
+	external debugging hooks.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local merge = require(Package.Utility.merge)
+
+-- This return type is technically a lie, but it's required for useful type
+-- checking behaviour.
+local function deriveScopeImpl<T>(
+	existing: Types.Scope<T>,
+	methods: {[unknown]: unknown}?,
+	...: {[unknown]: unknown}
+): any
+	local metatable = getmetatable(existing)
+	if methods ~= nil then
+		metatable = table.clone(metatable)
+		metatable.__index = merge(
+			true, {}, 
+			metatable.__index, 
+			merge(
+				false, {},
+				methods, 
+				...
+			)
+		)
+	end
+	return setmetatable({}, metatable)
+end
+
+return (deriveScopeImpl :: any) :: Types.DeriveScopeConstructor

package/templates/game/libs/Fusion/_impl/Memory/doCleanup.luau

@@ -0,0 +1,91 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Cleans up the tasks passed in as the arguments.
+	A task can be any of the following:
+
+	- an Instance - will be destroyed
+	- an RBXScriptConnection - will be disconnected
+	- a function - will be run
+	- a table with a `Destroy` or `destroy` function - will be called
+	- an array - `cleanup` will be called on each item
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+local ExternalDebug = require(Package.ExternalDebug)
+
+local alreadyDestroying: {[Types.Task]: true} = {}
+
+local function doCleanup(
+	task: Types.Task
+): ()
+	if alreadyDestroying[task] then
+		return External.logError("destroyedTwice")
+	end
+	alreadyDestroying[task] = true
+
+	-- case 1: Instance
+	if typeof(task) == "Instance" then
+		task:Destroy()
+
+	-- case 2: RBXScriptConnection
+	elseif typeof(task) == "RBXScriptConnection" then
+		task:Disconnect()
+
+	-- case 3: callback
+	elseif typeof(task) == "function" then
+		task()
+
+	elseif typeof(task) == "table" then
+		local task = (
+			task :: any
+		) :: {
+			Destroy: (...unknown) -> ...unknown?,
+			destroy: (...unknown) -> ...unknown?,
+			Disconnect: (...unknown) -> ...unknown?,
+			disconnect: (...unknown) -> ...unknown?,
+		}
+
+		-- case 4: destroy() function
+		if typeof(task.destroy) == "function" then
+			local task = (task :: any) :: {destroy: (...unknown) -> (...unknown)}
+			task:destroy()
+
+		-- case 5: Destroy() function
+		elseif typeof(task.Destroy) == "function" then
+			local task = (task :: any) :: {Destroy: (...unknown) -> (...unknown)}
+			task:Destroy()
+
+		-- case 6: table of tasks with an array part
+		elseif task[1] ~= nil then
+			local task = task :: {Types.Task}
+
+			-- It is important to iterate backwards through the table, since
+			-- objects are added in order of construction.
+			for index = #task, 1, -1 do
+				doCleanup(task[index])
+				task[index] = nil
+			end
+
+			ExternalDebug.untrackScope(task)
+
+		-- case 7: Disconnect() function
+		elseif typeof(task.Disconnect) == "function" then
+			local task = (task :: any) :: { Disconnect: (...unknown) -> ...unknown }
+			task:Disconnect()
+
+		-- case 8: disconnect() function
+		elseif typeof(task.disconnect) == "function" then
+			local task = (task :: any) :: { disconnect: (...unknown) -> ...unknown }
+			task:disconnect()
+		end
+	end
+	
+	alreadyDestroying[task] = nil
+end
+
+return doCleanup

package/templates/game/libs/Fusion/_impl/Memory/innerScope.luau

@@ -0,0 +1,34 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Derives a new scope that's destroyed exactly once, whether by the user or by
+	the scope that it's inside of.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local ExternalDebug = require(Package.ExternalDebug)
+local deriveScopeImpl = require(Package.Memory.deriveScopeImpl)
+
+local function innerScope<T>(
+	existing: Types.Scope<T>,
+	...: {[unknown]: unknown}
+): any
+	local new = deriveScopeImpl(existing, ...)
+	table.insert(existing, new)
+	table.insert(
+		new, 
+		function()
+			local index = table.find(existing, new)
+			if index ~= nil then
+				table.remove(existing, index)
+			end
+		end
+	)
+	ExternalDebug.trackScope(new)
+	return new
+end
+
+return (innerScope :: any) :: Types.DeriveScopeConstructor

package/templates/game/libs/Fusion/_impl/Memory/insert.luau

@@ -0,0 +1,22 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Inserts clean up tasks passed in to the scope.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+
+local function insert<Tasks...>(
+	scope: Types.Scope<unknown>,
+	...: Tasks...
+): Tasks...
+	for index = 1, select("#", ...) do
+		table.insert(scope, select(index, ...))
+	end
+	return ...
+end
+
+return insert