roblox-opencode 1.0.0 → 1.0.2

package/vendor/fusion/Graph/Observer.luau

@@ -1,114 +1,114 @@
---!strict
---!nolint LocalUnused
---!nolint LocalShadow
-local task = nil -- Disable usage of Roblox's task scheduler
-
---[[
-	A graph object that runs user code when it's updated by the reactive graph.
-
-	http://elttob.uk/Fusion/0.3/api-reference/state/types/observer/
-]]
-
-local Package = script.Parent.Parent
-local Types = require(Package.Types)
-local External = require(Package.External)
--- Memory
-local checkLifetime = require(Package.Memory.checkLifetime)
--- Graph
-local castToGraph = require(Package.Graph.castToGraph)
-local depend = require(Package.Graph.depend)
-local evaluate = require(Package.Graph.evaluate)
--- Utility
-local nicknames = require(Package.Utility.nicknames)
-
-type Self = Types.Observer & {
-	_watchingGraph: Types.GraphObject?,
-	_changeListeners: {[unknown]: () -> ()}
-}
-
-local class = {}
-class.type = "Observer"
-class.timeliness = "eager"
-class.dependentSet = table.freeze {}
-
-local METATABLE = table.freeze {__index = class}
-
-local function Observer(
-	scope: Types.Scope<unknown>,
-	watching: unknown
-): Types.Observer
-	local createdAt = os.clock()
-	if watching == nil then
-		External.logError("scopeMissing", nil, "Observers", "myScope:Observer(watching)")
-	end
-
-	local self: Self = setmetatable(
-		{
-			scope = scope,
-			createdAt = createdAt,
-			dependencySet = {},
-			lastChange = nil,
-			validity = "invalid",
-			_watchingGraph = castToGraph(watching),
-			_changeListeners = {}
-		},
-		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] = "Observer"
-	table.insert(scope, destroy)
-
-	if self._watchingGraph ~= nil then
-		checkLifetime.bOutlivesA(
-			scope, self.oldestTask,
-			self._watchingGraph.scope, self._watchingGraph.oldestTask,
-			checkLifetime.formatters.observer
-		)
-	end
-
-	-- Eagerly evaluated objects need to evaluate themselves so that they're
-	-- valid at all times.
-	evaluate(self, true)
-
-	return self
-end
-
-function class.onBind(
-	self: Self,
-	callback: () -> ()
-): () -> ()
-	External.doTaskImmediate(callback)
-	return self:onChange(callback)
-end
-
-function class.onChange(
-	self: Self,
-	callback: () -> ()
-): () -> ()
-	local uniqueIdentifier = table.freeze {}
-	self._changeListeners[uniqueIdentifier] = callback
-	return function()
-		self._changeListeners[uniqueIdentifier] = nil
-	end
-end
-
-function class._evaluate(
-	self: Self
-): ()
-	if self._watchingGraph ~= nil then
-		depend(self, self._watchingGraph)
-	end
-	for _, callback in self._changeListeners do
-		External.doTaskImmediate(callback)
-	end
-	return true
-end
-
-table.freeze(class)
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	A graph object that runs user code when it's updated by the reactive graph.
+
+	http://elttob.uk/Fusion/0.3/api-reference/state/types/observer/
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+-- Memory
+local checkLifetime = require(Package.Memory.checkLifetime)
+-- Graph
+local castToGraph = require(Package.Graph.castToGraph)
+local depend = require(Package.Graph.depend)
+local evaluate = require(Package.Graph.evaluate)
+-- Utility
+local nicknames = require(Package.Utility.nicknames)
+
+type Self = Types.Observer & {
+	_watchingGraph: Types.GraphObject?,
+	_changeListeners: {[unknown]: () -> ()}
+}
+
+local class = {}
+class.type = "Observer"
+class.timeliness = "eager"
+class.dependentSet = table.freeze {}
+
+local METATABLE = table.freeze {__index = class}
+
+local function Observer(
+	scope: Types.Scope<unknown>,
+	watching: unknown
+): Types.Observer
+	local createdAt = os.clock()
+	if watching == nil then
+		External.logError("scopeMissing", nil, "Observers", "myScope:Observer(watching)")
+	end
+
+	local self: Self = setmetatable(
+		{
+			scope = scope,
+			createdAt = createdAt,
+			dependencySet = {},
+			lastChange = nil,
+			validity = "invalid",
+			_watchingGraph = castToGraph(watching),
+			_changeListeners = {}
+		},
+		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] = "Observer"
+	table.insert(scope, destroy)
+
+	if self._watchingGraph ~= nil then
+		checkLifetime.bOutlivesA(
+			scope, self.oldestTask,
+			self._watchingGraph.scope, self._watchingGraph.oldestTask,
+			checkLifetime.formatters.observer
+		)
+	end
+
+	-- Eagerly evaluated objects need to evaluate themselves so that they're
+	-- valid at all times.
+	evaluate(self, true)
+
+	return self
+end
+
+function class.onBind(
+	self: Self,
+	callback: () -> ()
+): () -> ()
+	External.doTaskImmediate(callback)
+	return self:onChange(callback)
+end
+
+function class.onChange(
+	self: Self,
+	callback: () -> ()
+): () -> ()
+	local uniqueIdentifier = table.freeze {}
+	self._changeListeners[uniqueIdentifier] = callback
+	return function()
+		self._changeListeners[uniqueIdentifier] = nil
+	end
+end
+
+function class._evaluate(
+	self: Self
+): ()
+	if self._watchingGraph ~= nil then
+		depend(self, self._watchingGraph)
+	end
+	for _, callback in self._changeListeners do
+		External.doTaskImmediate(callback)
+	end
+	return true
+end
+
+table.freeze(class)
 return Observer :: Types.ObserverConstructor

package/vendor/fusion/Graph/castToGraph.luau

@@ -1,29 +1,29 @@
---!strict
---!nolint LocalUnused
---!nolint LocalShadow
-local task = nil -- Disable usage of Roblox's task scheduler
-
---[[
-	Returns the input *only* if it is a graph object.
-]]
-
-local Package = script.Parent.Parent
-local Types = require(Package.Types)
-
-local function castToGraph(
-	target: any
-): Types.GraphObject?
-	if 
-		typeof(target) == "table" and
-		typeof(target.validity) == "string" and
-		typeof(target.timeliness) == "string" and
-		typeof(target.dependencySet) == "table" and
-		typeof(target.dependentSet) == "table"
-	then
-		return target
-	else
-		return nil
-	end
-end
-
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Returns the input *only* if it is a graph object.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+
+local function castToGraph(
+	target: any
+): Types.GraphObject?
+	if 
+		typeof(target) == "table" and
+		typeof(target.validity) == "string" and
+		typeof(target.timeliness) == "string" and
+		typeof(target.dependencySet) == "table" and
+		typeof(target.dependentSet) == "table"
+	then
+		return target
+	else
+		return nil
+	end
+end
+
 return castToGraph

package/vendor/fusion/Graph/change.luau

@@ -1,81 +1,81 @@
---!strict
---!nolint LocalUnused
---!nolint LocalShadow
-local task = nil -- Disable usage of Roblox's task scheduler
-
---[[
-	Prompts a graph object to re-evaluate its own value. If it meaningfully
-	changes, then dependents will have to re-evaluate their own values in the
-	future.
-
-	https://fluff.blog/2024/04/16/monotonic-painting.html
-]]
-
-local Package = script.Parent.Parent
-local Types = require(Package.Types)
-local External = require(Package.External)
-local evaluate = require(Package.Graph.evaluate)
-
--- How long should this function run before it's considered to be in an infinite
--- cycle and error out?
-local TERMINATION_TIME = 1
-
-local function change(
-	target: Types.GraphObject
-): ()
-	if target.validity == "busy" then
-		return External.logError("infiniteLoop")
-	end
-
-	local meaningfullyChanged = evaluate(target, true)
-	if not meaningfullyChanged then
-		return
-	end
-
-	local searchInNow: {Types.GraphObject} = {}
-	local searchInNext: {Types.GraphObject} = {}
-	local invalidateList: {Types.GraphObject} = {}
-
-	searchInNow[1] = target
-	local terminateBy = os.clock() + TERMINATION_TIME * External.safetyTimerMultiplier
-	repeat
-		if os.clock() > terminateBy then
-			return External.logError("infiniteLoop")
-		end
-		local done = true
-		for _, searchTarget in searchInNow do
-			for dependent in searchTarget.dependentSet do
-				if dependent.validity == "valid" then
-					done = false
-					table.insert(invalidateList, dependent)
-					table.insert(searchInNext, dependent)
-				elseif dependent.validity == "busy" then
-					return External.logError("infiniteLoop")
-				end
-			end
-		end
-		searchInNow, searchInNext = searchInNext, searchInNow
-		table.clear(searchInNext)
-	until done
-
-	local eagerList: {Types.GraphObject} = {}
-
-	for _, invalidateTarget in invalidateList do
-		invalidateTarget.validity = "invalid"
-		if invalidateTarget.timeliness == "eager" then
-			table.insert(eagerList, invalidateTarget)
-		end
-	end
-	-- If objects are not executed in order of creations, then dynamic graphs
-	-- may experience 'glitches' where nested graph objects see intermediate
-	-- values before being destroyed.
-	-- https://fluff.blog/2024/07/14/glitches-in-dynamic-reactive-graphs.html
-	table.sort(eagerList, function(a, b)
-		return a.createdAt < b.createdAt
-	end)
-	for _, eagerTarget in eagerList do
-		evaluate(eagerTarget, false)
-	end
-end
-
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Prompts a graph object to re-evaluate its own value. If it meaningfully
+	changes, then dependents will have to re-evaluate their own values in the
+	future.
+
+	https://fluff.blog/2024/04/16/monotonic-painting.html
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+local evaluate = require(Package.Graph.evaluate)
+
+-- How long should this function run before it's considered to be in an infinite
+-- cycle and error out?
+local TERMINATION_TIME = 1
+
+local function change(
+	target: Types.GraphObject
+): ()
+	if target.validity == "busy" then
+		return External.logError("infiniteLoop")
+	end
+
+	local meaningfullyChanged = evaluate(target, true)
+	if not meaningfullyChanged then
+		return
+	end
+
+	local searchInNow: {Types.GraphObject} = {}
+	local searchInNext: {Types.GraphObject} = {}
+	local invalidateList: {Types.GraphObject} = {}
+
+	searchInNow[1] = target
+	local terminateBy = os.clock() + TERMINATION_TIME * External.safetyTimerMultiplier
+	repeat
+		if os.clock() > terminateBy then
+			return External.logError("infiniteLoop")
+		end
+		local done = true
+		for _, searchTarget in searchInNow do
+			for dependent in searchTarget.dependentSet do
+				if dependent.validity == "valid" then
+					done = false
+					table.insert(invalidateList, dependent)
+					table.insert(searchInNext, dependent)
+				elseif dependent.validity == "busy" then
+					return External.logError("infiniteLoop")
+				end
+			end
+		end
+		searchInNow, searchInNext = searchInNext, searchInNow
+		table.clear(searchInNext)
+	until done
+
+	local eagerList: {Types.GraphObject} = {}
+
+	for _, invalidateTarget in invalidateList do
+		invalidateTarget.validity = "invalid"
+		if invalidateTarget.timeliness == "eager" then
+			table.insert(eagerList, invalidateTarget)
+		end
+	end
+	-- If objects are not executed in order of creations, then dynamic graphs
+	-- may experience 'glitches' where nested graph objects see intermediate
+	-- values before being destroyed.
+	-- https://fluff.blog/2024/07/14/glitches-in-dynamic-reactive-graphs.html
+	table.sort(eagerList, function(a, b)
+		return a.createdAt < b.createdAt
+	end)
+	for _, eagerTarget in eagerList do
+		evaluate(eagerTarget, false)
+	end
+end
+
 return change

package/vendor/fusion/Graph/depend.luau

@@ -1,33 +1,33 @@
---!strict
---!nolint LocalUnused
---!nolint LocalShadow
-local task = nil -- Disable usage of Roblox's task scheduler
-
---[[
-	Forms a dependency on a graph object.
-]]
-
-local Package = script.Parent.Parent
-local Types = require(Package.Types)
-local External = require(Package.External)
-local evaluate = require(Package.Graph.evaluate)
-local nameOf = require(Package.Utility.nameOf)
-
-local function depend<T>(
-	dependent: Types.GraphObject,
-	dependency: Types.GraphObject
-): ()
-	-- Ensure dependencies are evaluated and up-to-date
-	-- when they are depended on. Also, newly created objects
-	-- might not have any transitive dependencies captured yet,
-	-- so ensure that they're present.
-	evaluate(dependency, false)
-
-	if table.isfrozen(dependent.dependencySet) or table.isfrozen(dependency.dependentSet) then
-		External.logError("cannotDepend", nil, nameOf(dependent, "Dependent"), nameOf(dependency, "dependency"))
-	end
-	dependency.dependentSet[dependent] = true
-	dependent.dependencySet[dependency] = true
-end
-
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Forms a dependency on a graph object.
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+local evaluate = require(Package.Graph.evaluate)
+local nameOf = require(Package.Utility.nameOf)
+
+local function depend<T>(
+	dependent: Types.GraphObject,
+	dependency: Types.GraphObject
+): ()
+	-- Ensure dependencies are evaluated and up-to-date
+	-- when they are depended on. Also, newly created objects
+	-- might not have any transitive dependencies captured yet,
+	-- so ensure that they're present.
+	evaluate(dependency, false)
+
+	if table.isfrozen(dependent.dependencySet) or table.isfrozen(dependency.dependentSet) then
+		External.logError("cannotDepend", nil, nameOf(dependent, "Dependent"), nameOf(dependency, "dependency"))
+	end
+	dependency.dependentSet[dependent] = true
+	dependent.dependencySet[dependency] = true
+end
+
 return depend

package/vendor/fusion/Graph/evaluate.luau

@@ -1,56 +1,56 @@
---!strict
---!nolint LocalUnused
---!nolint LocalShadow
-local task = nil -- Disable usage of Roblox's task scheduler
-
---[[
-	Evaluates the graph object if necessary, so that it is up to date.
-	Returns true if it meaningfully changed.
-
-	https://fluff.blog/2024/04/16/monotonic-painting.html
-]]
-
-local Package = script.Parent.Parent
-local Types = require(Package.Types)
-local External = require(Package.External)
-
-local function evaluate(
-	target: Types.GraphObject,
-	forceComputation: boolean
-): boolean
-	if target.validity == "busy" then
-		return External.logError("infiniteLoop")
-	end
-	local firstEvaluation = target.lastChange == nil
-	local isInvalid = target.validity == "invalid"
-	if firstEvaluation or isInvalid or forceComputation then
-		local needsComputation = firstEvaluation or forceComputation
-		if not needsComputation then
-			for dependency in target.dependencySet do
-				evaluate(dependency, false)
-				if dependency.lastChange > target.lastChange then
-					needsComputation = true
-					break
-				end
-			end
-		end
-		local targetMeaningfullyChanged = false
-		if needsComputation then
-			for dependency in target.dependencySet do
-				dependency.dependentSet[target] = nil
-				target.dependencySet[dependency] = nil
-			end
-			target.validity = "busy"
-			targetMeaningfullyChanged = target:_evaluate() or firstEvaluation
-		end
-		if targetMeaningfullyChanged then
-			target.lastChange = os.clock()
-		end
-		target.validity = "valid"
-		return targetMeaningfullyChanged
-	else
-		return false
-	end
-end
-
+--!strict
+--!nolint LocalUnused
+--!nolint LocalShadow
+local task = nil -- Disable usage of Roblox's task scheduler
+
+--[[
+	Evaluates the graph object if necessary, so that it is up to date.
+	Returns true if it meaningfully changed.
+
+	https://fluff.blog/2024/04/16/monotonic-painting.html
+]]
+
+local Package = script.Parent.Parent
+local Types = require(Package.Types)
+local External = require(Package.External)
+
+local function evaluate(
+	target: Types.GraphObject,
+	forceComputation: boolean
+): boolean
+	if target.validity == "busy" then
+		return External.logError("infiniteLoop")
+	end
+	local firstEvaluation = target.lastChange == nil
+	local isInvalid = target.validity == "invalid"
+	if firstEvaluation or isInvalid or forceComputation then
+		local needsComputation = firstEvaluation or forceComputation
+		if not needsComputation then
+			for dependency in target.dependencySet do
+				evaluate(dependency, false)
+				if dependency.lastChange > target.lastChange then
+					needsComputation = true
+					break
+				end
+			end
+		end
+		local targetMeaningfullyChanged = false
+		if needsComputation then
+			for dependency in target.dependencySet do
+				dependency.dependentSet[target] = nil
+				target.dependencySet[dependency] = nil
+			end
+			target.validity = "busy"
+			targetMeaningfullyChanged = target:_evaluate() or firstEvaluation
+		end
+		if targetMeaningfullyChanged then
+			target.lastChange = os.clock()
+		end
+		target.validity = "valid"
+		return targetMeaningfullyChanged
+	else
+		return false
+	end
+end
+
 return evaluate