roblox-opencode 1.0.0

package/vendor/fusion/State/For/Disassembly.luau

@@ -0,0 +1,211 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Breaks down an input table into reactive sub-objects for each pair.
+]]
+
+local Package = script.Parent.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- Graph
+local depend = require(Package.Graph.depend)
+-- State
+local peek = require(Package.State.peek)
+local castToState = require(Package.State.castToState)
+local ForTypes = require(Package.State.For.ForTypes)
+-- Memory
+local doCleanup = require(Package.Memory.doCleanup)
+local deriveScope = require(Package.Memory.deriveScope)
+local scopePool = require(Package.Memory.scopePool)
+-- Utility
+local nameOf = require(Package.Utility.nameOf)
+local nicknames = require(Package.Utility.nicknames)
+
+type Self<S, KI, KO, VI, VO> = ForTypes.Disassembly<S, KI, KO, VI, KO> & {
+	scope: (S & Types.Scope<unknown>)?,
+	_inputTable: Types.UsedAs<{[KI]: VI}>,
+	_constructor: (
+		Types.Scope<S>,
+		initialKey: KI,
+		initialValue: VI
+	) -> ForTypes.SubObject<S, KI, KO, VI, VO>,
+	_subObjects: {[ForTypes.SubObject<S, KI, KO, VI, VO>]: true}
+}
+
+
+local class = {}
+class.type = "Graph"
+class.kind = "For.Disassembly"
+class.timeliness = "lazy"
+
+local METATABLE = table.freeze {__index = class}
+
+local function Disassembly<S, KI, KO, VI, VO>(
+	scope: S & Types.Scope<unknown>,
+	inputTable: Types.UsedAs<{[KI]: VI}>,
+	constructor: (
+		Types.Scope<S>,
+		initialKey: KI,
+		initialValue: VI
+	) -> ForTypes.SubObject<S, KI, KO, VI, VO>
+): ForTypes.Disassembly<S, KI, KO, VI, KO>
+	local createdAt = os.clock()
+	local self = setmetatable(
+		{
+			createdAt = createdAt,
+			dependencySet = {},
+			dependentSet = {},
+			scope = scope,
+			validity = "invalid",
+			_inputTable = inputTable,
+			_constructor = constructor,
+			_subObjects = {}
+		}, 
+		METATABLE
+	) :: any
+
+	local destroy = function()
+		self.scope = nil
+		for dependency in pairs(self.dependencySet) do
+			dependency.dependentSet[self] = nil
+		end
+		for subObject in self._subObjects do
+			if subObject.maybeScope ~= nil then
+				doCleanup(subObject.maybeScope)
+				subObject.maybeScope = nil
+			end
+		end
+	end
+	self.oldestTask = destroy
+	nicknames[self.oldestTask] = "For (internal disassembler)"
+	table.insert(scope, destroy)
+	
+	return self
+end
+
+function class.populate<S, KI, KO, VI, VO>(
+	self: Self<S, KI, KO, VI, VO>,
+	use: Types.Use,
+	output: {[KO]: VO}
+): ()
+	local minArrayIndex = math.huge
+	local maxArrayIndex = -math.huge
+	local hasHoles = false
+	for subObject in self._subObjects do
+		local outputKey, outputValue = subObject:useOutputPair(use)
+		if outputKey == nil or outputValue == nil then
+			hasHoles = true
+			continue
+		elseif output[outputKey] ~= nil then
+			External.logErrorNonFatal("forKeyCollision", nil, tostring(outputKey))
+			continue
+		end
+		output[outputKey] = outputValue
+		if typeof(outputKey) == "number" then
+			minArrayIndex = math.min(minArrayIndex, outputKey)
+			maxArrayIndex = math.max(maxArrayIndex, outputKey)
+		end
+	end
+	-- Be careful of NaN here
+	if hasHoles and maxArrayIndex > minArrayIndex then
+		local output: {[number]: VO} = output :: any
+		local moveToIndex = minArrayIndex
+		for moveFromIndex = minArrayIndex, maxArrayIndex do
+			local outputValue = output[moveFromIndex]
+			if outputValue == nil then
+				continue
+			end
+			-- The ordering is important in case the indices are the same
+			output[moveFromIndex] = nil
+			output[moveToIndex] = outputValue
+			moveToIndex += 1
+		end
+	end
+end
+
+function class._evaluate<S, KI, KO, VI, VO>(
+	self: Self<S, KI, KO, VI, VO>
+): boolean
+	local outerScope = self.scope :: S & Types.Scope<unknown>
+	local inputState = castToState(self._inputTable)
+	if inputState ~= nil then
+		if inputState.scope == nil then
+			External.logError(
+				"useAfterDestroy",
+				nil,
+				`The input {nameOf(inputState, "table")}`,
+				`the For object that is watching it`
+			)
+		end
+		depend(self, inputState)
+	end
+
+	local pendingPairs = {} :: {[KI]: VI}
+	for key, value in peek(self._inputTable) do
+		pendingPairs[key] = value
+	end
+
+	local newSubObjects = {} :: typeof(self._subObjects)
+
+	for subObject in self._subObjects do
+		local reused = false
+		local oldInputKey = subObject.inputKey
+		local oldInputValue = subObject.inputValue
+		local newInputKey: KI
+		-- Reuse when the keys are identical.
+		if not subObject.roamKeys and pendingPairs[oldInputKey] ~= nil then
+			reused = true
+			newInputKey = oldInputKey
+		else -- Try and reuse some other pair instead.
+			for pendingKey, pendingValue in pendingPairs do
+				reused = true
+				newInputKey = pendingKey
+				if subObject.roamValues then
+					break
+				end
+				if pendingValue == oldInputValue then
+					-- If the values are the same, then no need to update those,
+					-- so prefer this choice to any other.
+					break 
+				end
+			end
+		end
+		if reused then
+			local newInputValue = pendingPairs[newInputKey]
+			newSubObjects[subObject] = true
+			if newInputKey ~= oldInputKey then
+				subObject.inputKey = newInputKey
+				subObject:invalidateInputKey()
+			end
+			if newInputValue ~= oldInputValue then
+				subObject.inputValue = newInputValue
+				subObject:invalidateInputValue()
+			end
+			pendingPairs[newInputKey] = nil
+		else -- Too many sub objects for the number of pairs.
+			if subObject.maybeScope ~= nil then
+				doCleanup(subObject.maybeScope)
+				subObject.maybeScope = nil
+			end
+		end
+	end
+
+	-- Generate new objects if needed to cover the remaining pending pairs.
+	for pendingKey, pendingValue in pendingPairs do
+		local subObject = self._constructor(deriveScope(outerScope), pendingKey, pendingValue)
+		if subObject.maybeScope ~= nil then
+			subObject.maybeScope = scopePool.giveIfEmpty(subObject.maybeScope)
+		end
+		newSubObjects[subObject] = true
+	end
+
+	self._subObjects = newSubObjects
+
+	return true
+end
+
+table.freeze(class)
+return Disassembly

package/vendor/fusion/State/For/ForTypes.luau

@@ -0,0 +1,30 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Stores types that are commonly used between For objects.
+]]
+
+local Package = script.Parent.Parent.Parent
+local Types = require(Package.Types)
+
+export type SubObject<S, KI, KO, VI, VO> = {
+	-- Not all sub objects need to store a scope, for example if the scope
+	-- remains empty, it'll be given back to the scope pool.
+	maybeScope: Types.Scope<S>?,
+	inputKey: KI,
+	inputValue: VI,
+	roamKeys: boolean,
+	roamValues: boolean,
+	invalidateInputKey: (SubObject<S, KI, KO, VI, VO>) -> (),
+	invalidateInputValue: (SubObject<S, KI, KO, VI, VO>) -> (),
+	useOutputPair: (SubObject<S, KI, KO, VI, VO>, Types.Use) -> (KO?, VO?)
+}
+
+export type Disassembly<S, KI, KO, VI, VO> = Types.GraphObject & {
+	populate: (Disassembly<S, KI, KO, VI, VO>, Types.Use, output: {[KO]: VO}) -> ()
+}
+
+return nil

package/vendor/fusion/State/For/init.luau

@@ -0,0 +1,110 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	The generic implementation for all `For` objects.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- Graph
+local depend = require(Package.Graph.depend)
+-- State
+local peek = require(Package.State.peek)
+local castToState = require(Package.State.castToState)
+local ForTypes = require(Package.State.For.ForTypes)
+-- Utility
+local never = require(Package.Utility.never)
+local nicknames = require(Package.Utility.nicknames)
+
+local Disassembly = require(Package.State.For.Disassembly)
+
+type Self<S, KI, KO, VI, VO> = Types.For<KO, VO> & {
+	_disassembly: ForTypes.Disassembly<S, KI, KO, VI, VO>
+}
+
+local class = {}
+class.type = "State"
+class.kind = "For"
+class.timeliness = "lazy"
+
+local METATABLE = table.freeze {__index = class}
+
+local function For<S, KI, KO, VI, VO>(
+	scope: Types.Scope<S>,
+	inputTable: Types.UsedAs<{[KI]: VI}>,
+	constructor: (
+		Types.Scope<S>,
+		initialKey: KI,
+		initialValue: VI
+	) -> ForTypes.SubObject<S, KI, KO, VI, VO>
+): Types.For<KO, VO>
+	local createdAt = os.clock()
+	local self: Self<S, KI, KO, VI, VO> = setmetatable(
+		{
+			createdAt = createdAt,
+			dependencySet = {},
+			dependentSet = {},
+			scope = scope,
+			validity = "invalid",
+			_EXTREMELY_DANGEROUS_usedAsValue = {},
+			_disassembly = Disassembly(
+				scope,
+				inputTable,
+				constructor
+			)
+		}, 
+		METATABLE
+	) :: any
+
+	local destroy = function()
+		self.scope = nil
+		for dependency in pairs(self.dependencySet) do
+			dependency.dependentSet[self] = nil
+		end
+	end
+	self.oldestTask = destroy
+	nicknames[self.oldestTask] = "For"
+	table.insert(scope, destroy)
+
+	return self
+end
+
+function class.get<S, KI, KO, VI, VO>(
+	_self: Self<S, KI, KO, VI, VO>
+): never
+	External.logError("stateGetWasRemoved")
+	return never()
+end
+
+function class._evaluate<S, KI, KO, VI, VO>(
+	self: Self<S, KI, KO, VI, VO>
+): boolean
+	if self.scope == nil then
+		return false
+	end
+	local outerScope = self.scope :: S & Types.Scope<unknown>
+
+	depend(self, self._disassembly)
+	table.clear(self._EXTREMELY_DANGEROUS_usedAsValue)
+	self._disassembly:populate(
+		function<T>(
+			maybeState: Types.UsedAs<T>
+		): T
+			local state = castToState(maybeState)
+			if state ~= nil then
+				depend(self, state)
+			end
+			return peek(maybeState)
+		end,
+		self._EXTREMELY_DANGEROUS_usedAsValue
+	)
+
+	return true
+end
+
+table.freeze(class)
+return For

package/vendor/fusion/State/ForKeys.luau

@@ -0,0 +1,94 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Constructs and returns a new For state object which processes keys and
+	preserves values.
+
+	https://elttob.uk/Fusion/0.3/api-reference/state/members/forkeys/
+
+	TODO: the sub objects constructed here can be more efficiently implemented
+	as a dedicated state object.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- Memory
+local doCleanup = require(Package.Memory.doCleanup)
+-- State
+local For = require(Package.State.For)
+local Value = require(Package.State.Value)
+local Computed = require(Package.State.Computed)
+local ForTypes = require(Package.State.For.ForTypes)
+-- Logging
+local parseError = require(Package.Logging.parseError)
+
+local SUB_OBJECT_META = {
+	__index = {
+		roamKeys = false,
+		roamValues = true,
+		invalidateInputKey = function(self): ()
+			self._inputKeyState:set(self.inputKey)
+		end,
+		invalidateInputValue = function(self): ()
+			-- do nothing
+		end,
+		useOutputPair = function(self, use)
+			return use(self._outputKeyState), self.inputValue
+		end
+	}
+}
+
+local function SubObject<KI, KO, V, S>(
+	scope: Types.Scope<S>,
+	initialKey: KI,
+	initialValue: V,
+	processor: (Types.Use, Types.Scope<S>, KI) -> KO
+): ForTypes.SubObject<S, KI, KO, V, V>
+	local self = {}
+	self.maybeScope = scope
+	self.inputKey = initialKey
+	self.inputValue = initialValue
+	self._inputKeyState = Value(scope, initialKey)
+	self._processor = processor
+	self._outputKeyState = Computed(scope, function(use, scope): KO?
+		local inputKey = use(self._inputKeyState)
+		local ok, outputKey = xpcall(self._processor, parseError, use, scope, inputKey)
+		if ok then
+			return outputKey
+		else
+			local error: Types.Error = outputKey :: any
+			error.context = `while processing key {tostring(inputKey)}`
+			External.logErrorNonFatal("callbackError", error)
+			doCleanup(scope)
+			table.clear(scope)
+			return nil
+		end
+	end)
+	return setmetatable(self, SUB_OBJECT_META) :: any
+end
+
+local function ForKeys<KI, KO, V, S>(
+	scope: Types.Scope<S>,
+	inputTable: Types.UsedAs<{[KI]: V}>,
+	processor: (Types.Use, Types.Scope<S>, KI) -> KO,
+	destructor: unknown?
+): Types.For<KO, V>
+	if typeof(inputTable) == "function" then
+		External.logError("scopeMissing", nil, "ForKeys", "myScope:ForKeys(inputTable, function(scope, use, key) ... end)")
+	elseif destructor ~= nil then
+		External.logWarn("destructorRedundant", "ForKeys")
+	end
+	return For(
+		scope, 
+		inputTable, 
+		function(scope, initialKey, initialValue)
+			return SubObject(scope, initialKey, initialValue, processor)
+		end
+	)
+end
+
+return ForKeys :: Types.ForKeysConstructor

package/vendor/fusion/State/ForPairs.luau

@@ -0,0 +1,97 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Constructs and returns a new For state object which processes keys and
+	values in pairs.
+
+	https://elttob.uk/Fusion/0.3/api-reference/state/members/forpairs/
+
+	TODO: the sub objects constructed here can be more efficiently implemented
+	as a dedicated state object.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- State
+local For = require(Package.State.For)
+local Value = require(Package.State.Value)
+local Computed = require(Package.State.Computed)
+local ForTypes = require(Package.State.For.ForTypes)
+-- Logging
+local parseError = require(Package.Logging.parseError)
+-- Memory
+local doCleanup = require(Package.Memory.doCleanup)
+
+local SUB_OBJECT_META = {
+	__index = {
+		roamKeys = false,
+		roamValues = false,
+		invalidateInputKey = function(self): ()
+			self._inputKeyState:set(self.inputKey)
+		end,
+		invalidateInputValue = function(self): ()
+			self._inputValueState:set(self.inputValue)
+		end,
+		useOutputPair = function(self, use)
+			local pair = use(self._outputPairState)
+			return pair.key, pair.value
+		end
+	}
+}
+
+local function SubObject<KI, KO, VI, VO, S>(
+	scope: Types.Scope<S>,
+	initialKey: KI,
+	initialValue: VI,
+	processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO)
+): ForTypes.SubObject<S, KI, KO, VI, VO>
+	local self = {}
+	self.maybeScope = scope
+	self.inputKey = initialKey
+	self.inputValue = initialValue
+	self._inputKeyState = Value(scope, initialKey)
+	self._inputValueState = Value(scope, initialValue)
+	self._processor = processor
+	self._outputPairState = Computed(scope, function(use, scope): {key: KO?, value: VO?}
+		local inputKey = use(self._inputKeyState)
+		local inputValue = use(self._inputValueState)
+		local ok, outputKey, outputValue = xpcall(self._processor, parseError, use, scope, inputKey, inputValue)
+		if ok then
+			return {key = outputKey, value = outputValue}
+		else
+			local error: Types.Error = outputKey :: any
+			error.context = `while processing key {tostring(inputValue)} and value {tostring(inputValue)}`
+			External.logErrorNonFatal("callbackError", error)
+			doCleanup(scope)
+			table.clear(scope)
+			return {key = nil, value = nil}
+		end
+	end)
+	return setmetatable(self, SUB_OBJECT_META) :: any
+end
+
+local function ForPairs<KI, KO, VI, VO, S>(
+	scope: Types.Scope<S>,
+	inputTable: Types.UsedAs<{[KI]: VI}>,
+	processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO),
+	destructor: unknown?
+): Types.For<KO, VO>
+	if typeof(inputTable) == "function" then
+		External.logError("scopeMissing", nil, "ForPairs", "myScope:ForPairs(inputTable, function(scope, use, key, value) ... end)")
+	elseif destructor ~= nil then
+		External.logWarn("destructorRedundant", "ForPairs")
+	end
+	return For(
+		scope,
+		inputTable,
+		function(scope, initialKey, initialValue)
+			return SubObject(scope, initialKey, initialValue, processor)
+		end
+	)
+end
+
+return ForPairs :: Types.ForPairsConstructor

package/vendor/fusion/State/ForValues.luau

@@ -0,0 +1,94 @@
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Constructs and returns a new For state object which processes values and
+	preserves keys.
+
+	https://elttob.uk/Fusion/0.3/api-reference/state/members/forvalues/
+
+	TODO: the sub objects constructed here can be more efficiently implemented
+	as a dedicated state object.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- State
+local For = require(Package.State.For)
+local Value = require(Package.State.Value)
+local Computed = require(Package.State.Computed)
+local ForTypes = require(Package.State.For.ForTypes)
+-- Logging
+local parseError = require(Package.Logging.parseError)
+-- Memory
+local doCleanup = require(Package.Memory.doCleanup)
+
+local SUB_OBJECT_META = {
+	__index = {
+		roamKeys = true,
+		roamValues = false,
+		invalidateInputKey = function(self): ()
+			-- do nothing
+		end,
+		invalidateInputValue = function(self): ()
+			self._inputValueState:set(self.inputValue)
+		end,
+		useOutputPair = function(self, use)
+			return self.inputKey, use(self._outputValueState)
+		end
+	}
+}
+
+local function SubObject<K, VI, VO, S>(
+	scope: Types.Scope<S>,
+	initialKey: K,
+	initialValue: VI,
+	processor: (Types.Use, Types.Scope<S>, VI) -> VO
+): ForTypes.SubObject<S, K, K, VI, VO>
+	local self = {}
+	self.maybeScope = scope
+	self.inputKey = initialKey
+	self.inputValue = initialValue
+	self._inputValueState = Value(scope, initialValue)
+	self._processor = processor
+	self._outputValueState = Computed(scope, function(use, scope): VO?
+		local inputValue = use(self._inputValueState)
+		local ok, outputValue = xpcall(self._processor, parseError, use, scope, inputValue)
+		if ok then
+			return outputValue
+		else
+			local error: Types.Error = outputValue :: any
+			error.context = `while processing value {tostring(inputValue)}`
+			External.logErrorNonFatal("callbackError", error)
+			doCleanup(scope)
+			table.clear(scope)
+			return nil
+		end
+	end)
+	return setmetatable(self, SUB_OBJECT_META) :: any
+end
+
+local function ForValues<K, VI, VO, S>(
+	scope: Types.Scope<S>,
+	inputTable: Types.UsedAs<{[K]: VI}>,
+	processor: (Types.Use, Types.Scope<S>, VI) -> VO,
+	destructor: unknown?
+): Types.For<K, VO>
+	if typeof(inputTable) == "function" then
+		External.logError("scopeMissing", nil, "ForValues", "myScope:ForValues(inputTable, function(scope, use, value) ... end)")
+	elseif destructor ~= nil then
+		External.logWarn("destructorRedundant", "ForValues")
+	end
+	return For(
+		scope,
+		inputTable,
+		function(scope, initialKey, initialValue)
+			return SubObject(scope, initialKey, initialValue, processor)
+		end
+	)
+end
+
+return ForValues :: Types.ForValuesConstructor