roblox-opencode 1.0.0

package/vendor/fusion/Memory/doCleanup.luau

@@ -0,0 +1,79 @@
+--!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 scopePool = require(Package.Memory.scopePool)
+local poisonScope = require(Package.Memory.poisonScope)
+
+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)?}
+
+		-- 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
+
+			if External.isTimeCritical() then
+				scopePool.giveIfEmpty(task)
+			else
+				poisonScope(task, "`doCleanup()` was previously called on this scope. Ensure you are not reusing scopes after cleanup.")
+			end
+		end
+	end
+	
+	alreadyDestroying[task] = nil
+end
+
+return doCleanup

package/vendor/fusion/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/vendor/fusion/Memory/legacyCleanup.luau

@@ -0,0 +1,18 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+local doCleanup = require(Package.Memory.doCleanup)
+
+local function legacyCleanup(
+	value: Types.Task
+)
+	External.logWarn("cleanupWasRenamed")
+	return doCleanup(value)
+end
+
+return legacyCleanup

package/vendor/fusion/Memory/needsDestruction.luau

@@ -0,0 +1,17 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Returns true if the given value is not automatically memory managed, and
+	requires manual cleanup.
+]]
+
+local function needsDestruction(
+	x: unknown
+): boolean
+	return typeof(x) == "Instance"
+end
+
+return needsDestruction

package/vendor/fusion/Memory/poisonScope.luau

@@ -0,0 +1,34 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	'Poisons' the given scope; if the scope is used again, then it will cause
+	the program to crash.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+
+local function poisonScope(
+	scope: Types.Scope,
+	context: string
+): ()
+	local mt = getmetatable(scope)
+	if typeof(mt) == "table" and mt._FUSION_POISONED then
+		return
+	end
+	table.clear(scope)
+	setmetatable(scope :: any, {
+		_FUSION_POISONED = true,
+		__index = function()
+			External.logError("poisonedScope", nil, context)
+		end,
+		__newindex = function()
+			External.logError("poisonedScope", nil, context)
+		end
+	})
+end
+
+return poisonScope

package/vendor/fusion/Memory/scopePool.luau

@@ -0,0 +1,55 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local poisonScope = require(Package.Memory.poisonScope)
+local ExternalDebug = require(Package.ExternalDebug)
+
+local ENABLE_POOLING = false
+local MAX_POOL_SIZE = 16 -- TODO: need to test what an ideal number for this is
+
+local pool = {}
+local poolSize = 0
+
+return {
+	giveIfEmpty = function<S>(
+		scope: Types.Scope<S>
+	): Types.Scope<S>?
+		if next(scope) == nil then
+			ExternalDebug.untrackScope(scope)
+			if ENABLE_POOLING and poolSize < MAX_POOL_SIZE then
+				poolSize += 1
+				pool[poolSize] = scope
+			else
+				poisonScope(scope, "previously passed to the internal scope pool, which indicates a Fusion bug.")
+			end
+			return nil
+		else
+			return scope
+		end
+	end,
+	clearAndGive = function(
+		scope: Types.Scope<unknown>
+	)
+		ExternalDebug.untrackScope(scope)
+		table.clear(scope)
+		if ENABLE_POOLING and poolSize < MAX_POOL_SIZE then
+			poolSize += 1
+			pool[poolSize] = scope :: any
+		else
+			poisonScope(scope, "previously passed to the internal scope pool, which indicates a Fusion bug.")
+		end
+	end,
+	reuseAny = function(): Types.Scope<unknown>
+		if poolSize == 0 then
+			return nil :: any
+		else
+			local scope = pool[poolSize]
+			poolSize -= 1
+			return scope
+		end
+	end
+}

package/vendor/fusion/Memory/scoped.luau

@@ -0,0 +1,27 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Creates cleanup tables with access to constructors as methods.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local ExternalDebug = require(Package.ExternalDebug)
+local merge = require(Package.Utility.merge)
+local scopePool = require(Package.Memory.scopePool)
+
+local function scoped(
+	...: {[unknown]: unknown}
+): any
+	local scope = setmetatable(
+		scopePool.reuseAny() :: any or {},
+		{__index = merge(false, {}, ...)}
+	) :: any
+	ExternalDebug.trackScope(scope)
+	return scope
+end
+
+return (scoped :: any) :: Types.ScopedConstructor

package/vendor/fusion/Memory/whichLivesLonger.luau

@@ -0,0 +1,75 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Calculates how the lifetimes of the two values relate. Specifically, it
+	calculates which value will be destroyed earlier or later, if it is possible
+	to infer this from their scopes.
+]]
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+
+local function whichScopeLivesLonger(
+	scopeA: Types.Scope<unknown>,
+	scopeB: Types.Scope<unknown>
+): "definitely-a" | "definitely-b" | "unsure"
+	-- If we can prove one scope is inside of the other scope, then the outer
+	-- scope must live longer than the inner scope (assuming idiomatic scopes).
+	-- So, we will search the scopes recursively until we find one of them, at
+	-- which point we know they must have been found inside the other scope.
+	local openSet: {Types.Scope<unknown>} = {scopeA, scopeB}
+	local nextOpenSet: {Types.Scope<unknown>} = {}
+	local openSetSize, nextOpenSetSize = 2, 0
+	local closedSet = {}
+	while openSetSize > 0 do
+		for _, scope in openSet do
+			closedSet[scope] = true
+			for _, inScope in ipairs(scope) do
+				if inScope == scopeA then
+					return "definitely-b"
+				elseif inScope == scopeB then
+					return "definitely-a"
+				elseif typeof(inScope) == "table" then
+					local inScope = inScope :: {unknown}
+					if inScope[1] ~= nil and closedSet[scope] == nil then
+						nextOpenSetSize += 1
+						nextOpenSet[nextOpenSetSize] = inScope :: Types.Scope<unknown>
+					end
+				end 
+			end
+		end
+		table.clear(openSet)
+		openSet, nextOpenSet = nextOpenSet, openSet
+		openSetSize, nextOpenSetSize = nextOpenSetSize, 0
+	end
+	return "unsure"
+end
+
+local function whichLivesLonger(
+	scopeA: Types.Scope<unknown>,
+	a: unknown,
+	scopeB: Types.Scope<unknown>,
+	b: unknown
+): "definitely-a" | "definitely-b" | "unsure"
+	if External.isTimeCritical() then
+		return "unsure"
+	elseif scopeA == scopeB then
+		local scopeA: {unknown} = scopeA
+		for index = #scopeA, 1, -1 do
+			local value = scopeA[index]
+			if value == a then
+				return "definitely-b"
+			elseif value == b then
+				return "definitely-a"
+			end
+		end
+		return "unsure"
+	else
+		return whichScopeLivesLonger(scopeA, scopeB)
+	end
+end
+
+return whichLivesLonger

package/vendor/fusion/RobloxExternal.luau

@@ -0,0 +1,98 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+
+--[[
+	Roblox implementation for Fusion's abstract provider layer.
+]]
+
+local RunService = game:GetService("RunService")
+local HttpService = game:GetService("HttpService")
+
+local Package = script.Parent
+local External = require(Package.External)
+
+local RobloxExternal = {}
+
+RobloxExternal.policies = {
+	allowWebLinks = RunService:IsStudio()
+}
+
+--[[
+   Sends an immediate task to the external provider. Throws if none is set.
+]]
+function RobloxExternal.doTaskImmediate(
+	resume: () -> ()
+)
+   task.spawn(resume)
+end
+
+--[[
+	Sends a deferred task to the external provider. Throws if none is set.
+]]
+function RobloxExternal.doTaskDeferred(
+	resume: () -> ()
+)
+	task.defer(resume)
+end
+
+--[[
+	Errors in a different thread to preserve the flow of execution.
+]]
+function RobloxExternal.logErrorNonFatal(
+	errorString: string
+)
+	task.spawn(error, errorString, 0)
+end
+
+--[[
+	Shows a warning message in the output.
+]]
+RobloxExternal.logWarn = warn
+
+--[[
+	Sends an update step to Fusion using the Roblox clock time.
+]]
+local function performUpdateStep()
+	External.performUpdateStep(os.clock())
+end
+
+--[[
+	Binds Fusion's update step to RunService step events.
+]]
+local stopSchedulerFunc = nil :: (() -> ())?
+function RobloxExternal.startScheduler()
+	if stopSchedulerFunc ~= nil then
+		return
+	end
+	if RunService:IsClient() then
+		-- In cases where multiple Fusion modules are running simultaneously,
+		-- this prevents collisions.
+		local id = "FusionUpdateStep_" .. HttpService:GenerateGUID()
+		RunService:BindToRenderStep(
+			id,
+			Enum.RenderPriority.First.Value,
+			performUpdateStep
+		)
+		stopSchedulerFunc = function()
+			RunService:UnbindFromRenderStep(id)
+		end
+	else
+		local connection = RunService.Heartbeat:Connect(performUpdateStep)
+		stopSchedulerFunc = function()
+			connection:Disconnect()
+		end
+	end
+end
+
+--[[
+	Unbinds Fusion's update step from RunService step events.
+]]
+function RobloxExternal.stopScheduler()
+	if stopSchedulerFunc ~= nil then
+		stopSchedulerFunc()
+		stopSchedulerFunc = nil
+	end
+end
+
+return RobloxExternal

package/vendor/fusion/State/Computed.luau

@@ -0,0 +1,139 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	A specialised state object for tracking single values computed from a
+	user-defined computation.
+
+	https://elttob.uk/Fusion/0.3/api-reference/state/types/computed/
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- Logging
+local parseError = require(Package.Logging.parseError)
+-- Utility
+local isSimilar = require(Package.Utility.isSimilar)
+local never = require(Package.Utility.never)
+-- Graph
+local depend = require(Package.Graph.depend)
+-- State
+local castToState = require(Package.State.castToState)
+local peek = require(Package.State.peek)
+-- Memory
+local doCleanup = require(Package.Memory.doCleanup)
+local deriveScope = require(Package.Memory.deriveScope)
+local checkLifetime = require(Package.Memory.checkLifetime)
+local scopePool = require(Package.Memory.scopePool)
+-- Utility
+local nicknames = require(Package.Utility.nicknames)
+
+type Self<T, S> = Types.Computed<T> & {
+	_innerScope: Types.Scope<S>?,
+	_processor: (Types.Use, Types.Scope<S>) -> T
+}
+
+local class = {}
+class.type = "State"
+class.kind = "Computed"
+class.timeliness = "lazy"
+
+local METATABLE = table.freeze {__index = class}
+
+local function Computed<T, S>(
+	scope: S & Types.Scope<unknown>,
+	processor: (Types.Use, S) -> T,
+	destructor: unknown?
+): Types.Computed<T>
+	local createdAt = os.clock()
+	if typeof(scope) == "function" then
+		External.logError("scopeMissing", nil, "Computeds", "myScope:Computed(function(use, scope) ... end)")
+	elseif destructor ~= nil then
+		External.logWarn("destructorRedundant", "Computed")
+	end
+	local self: Self<T, S> = setmetatable(
+		{
+			createdAt = createdAt,
+			dependencySet = {},
+			dependentSet = {},
+			lastChange = nil,
+			scope = scope,
+			validity = "invalid",
+			_EXTREMELY_DANGEROUS_usedAsValue = nil,
+			_innerScope = nil,
+			_processor = processor
+		}, 
+		METATABLE
+	) :: any
+	local destroy = function()
+		self.scope = nil
+		for dependency in pairs(self.dependencySet) do
+			dependency.dependentSet[self] = nil
+		end
+		if self._innerScope ~= nil then
+			doCleanup(self._innerScope)
+		end
+	end
+	self.oldestTask = destroy
+	nicknames[self.oldestTask] = "Computed"
+	table.insert(scope, destroy)
+	return self
+end
+
+function class.get<T, S>(
+	_self: Self<T, S>
+): never
+	External.logError("stateGetWasRemoved")
+	return never()
+end
+
+function class._evaluate<T, S>(
+	self: Self<T, S>
+): boolean
+	if self.scope == nil then
+		return false
+	end
+	local outerScope = self.scope :: S & Types.Scope<unknown>
+	local innerScope = deriveScope(outerScope)
+	local function use<T>(target: Types.UsedAs<T>): T
+		local targetState = castToState(target)
+		if targetState ~= nil then
+			checkLifetime.bOutlivesA(
+				outerScope, self.oldestTask, 
+				targetState.scope, targetState.oldestTask, 
+				checkLifetime.formatters.useFunction
+			)
+			depend(self, targetState)
+		end
+		return peek(target)
+	end
+	local ok, newValue = xpcall(self._processor, parseError, use, innerScope)
+	local innerScope = scopePool.giveIfEmpty(innerScope)
+	if ok then
+		local similar = isSimilar(self._EXTREMELY_DANGEROUS_usedAsValue, newValue)
+		if self._innerScope ~= nil then
+			doCleanup(self._innerScope)
+		end
+		self._innerScope = innerScope
+
+		self._EXTREMELY_DANGEROUS_usedAsValue = newValue
+		return not similar
+	else
+		local errorObj = (newValue :: any) :: Types.Error
+		if innerScope ~= nil then
+			doCleanup(innerScope)
+		end
+		innerScope = nil
+		
+		-- this needs to be non-fatal, because otherwise it'd disrupt the
+		-- update process
+		External.logErrorNonFatal("callbackError", errorObj)
+		return false
+	end
+end
+
+table.freeze(class)
+return Computed :: Types.ComputedConstructor