@rbxts/centurion-ui 1.0.2 → 1.0.4

package/out/app/centurion-app.luau

@@ -9,16 +9,15 @@ local Suggestions = _components.Suggestions
 local Terminal = _components.Terminal
 local Group = TS.import(script, script.Parent.Parent, "components", "ui", "group").Group
 local Layer = TS.import(script, script.Parent.Parent, "components", "ui", "layer").Layer
-local useAtom = TS.import(script, script.Parent.Parent, "hooks", "use-atom").useAtom
 local useClient = TS.import(script, script.Parent.Parent, "hooks", "use-client").useClient
 local useEvent = TS.import(script, script.Parent.Parent, "hooks", "use-event").useEvent
 local _use_px = TS.import(script, script.Parent.Parent, "hooks", "use-px")
 local px = _use_px.px
 local usePx = _use_px.usePx
 local _store = TS.import(script, script.Parent.Parent, "store")
-local interfaceOptions = _store.interfaceOptions
-local interfaceVisible = _store.interfaceVisible
 local mouseOverInterface = _store.mouseOverInterface
+local options = _store.options
+local visible = _store.visible
 local MOUSE_INPUT_TYPES = {
 	[Enum.UserInputType.MouseButton1] = true,
 	[Enum.UserInputType.MouseButton2] = true,
@@ -27,8 +26,6 @@ local MOUSE_INPUT_TYPES = {
 local function CenturionApp(client)
 	useClient(client)
 	usePx()
-	local options = useAtom(interfaceOptions)
-	local visible = useAtom(interfaceVisible)
 	local validKeys = derive(function()
 		local _set = {}
 		for _, _v in options().activationKeys do
@@ -44,7 +41,7 @@ local function CenturionApp(client)
 			_condition = not gameProcessed
 		end
 		if _condition then
-			interfaceVisible(not visible())
+			visible(not visible())
 		else
 			local _condition_1 = options().hideOnLostFocus
 			if _condition_1 then
@@ -55,7 +52,7 @@ local function CenturionApp(client)
 				end
 			end
 			if _condition_1 then
-				interfaceVisible(false)
+				visible(false)
 			end
 		end
 	end)

package/out/app/index.d.ts

@@ -1,8 +1,32 @@
 import { CenturionClient } from "@rbxts/centurion";
 import { InterfaceOptions } from "../types";
 export declare namespace CenturionUI {
+    /**
+     * Returns whether the terminal UI is visible.
+     *
+     * @returns Whether the terminal UI is visible.
+     */
     function isVisible(): boolean;
+    /**
+     * Sets the visibility of the terminal UI.
+     *
+     * @param visible Whether the terminal UI should be visible.
+     */
     function setVisible(visible: boolean): void;
+    /**
+     * Updates the terminal UI options.
+     *
+     * @param options The options to update.
+     */
     function updateOptions(options: Partial<InterfaceOptions>): void;
+    /**
+     * Mounts the terminal UI.
+     *
+     * If `registerBuiltInCommands` is **true** (default), client commands
+     * will be registered.
+     *
+     * @param client The Centurion client.
+     * @param options The terminal UI options.
+     */
     function start(client: CenturionClient, options?: Partial<InterfaceOptions>): void;
 }

package/out/app/init.luau

@@ -8,36 +8,66 @@ local mount = TS.import(script, TS.getModule(script, "@rbxts", "vide").src).moun
 local DEFAULT_INTERFACE_OPTIONS = TS.import(script, script.Parent, "constants", "options").DEFAULT_INTERFACE_OPTIONS
 local DefaultPalette = TS.import(script, script.Parent, "palette").DefaultPalette
 local _store = TS.import(script, script.Parent, "store")
-local interfaceOptions = _store.interfaceOptions
-local interfaceVisible = _store.interfaceVisible
+local uiOptions = _store.options
+local uiVisible = _store.visible
 local CenturionApp = TS.import(script, script, "centurion-app").CenturionApp
 local CenturionUI = {}
 do
 	local _container = CenturionUI
 	local MAX_PRELOAD_ATTEMPTS = 3
 	local PRELOAD_ATTEMPT_INTERVAL = 3
+	--[[
+		*
+			 * Returns whether the terminal UI is visible.
+			 *
+			 * @returns Whether the terminal UI is visible.
+			 
+	]]
 	local function isVisible()
-		return interfaceVisible()
+		return uiVisible()
 	end
 	_container.isVisible = isVisible
+	--[[
+		*
+			 * Sets the visibility of the terminal UI.
+			 *
+			 * @param visible Whether the terminal UI should be visible.
+			 
+	]]
 	local function setVisible(visible)
-		interfaceVisible(visible)
+		uiVisible(visible)
 	end
 	_container.setVisible = setVisible
+	--[[
+		*
+			 * Updates the terminal UI options.
+			 *
+			 * @param options The options to update.
+			 
+	]]
 	local function updateOptions(options)
-		interfaceOptions(function(prev)
-			local _object = table.clone(DEFAULT_INTERFACE_OPTIONS)
-			setmetatable(_object, nil)
-			for _k, _v in prev do
-				_object[_k] = _v
-			end
-			for _k, _v in options do
-				_object[_k] = _v
-			end
-			return _object
-		end)
+		local _object = table.clone(DEFAULT_INTERFACE_OPTIONS)
+		setmetatable(_object, nil)
+		for _k, _v in uiOptions() do
+			_object[_k] = _v
+		end
+		for _k, _v in options do
+			_object[_k] = _v
+		end
+		uiOptions(_object)
 	end
 	_container.updateOptions = updateOptions
+	--[[
+		*
+			 * Mounts the terminal UI.
+			 *
+			 * If `registerBuiltInCommands` is **true** (default), client commands
+			 * will be registered.
+			 *
+			 * @param client The Centurion client.
+			 * @param options The terminal UI options.
+			 
+	]]
 	local registerCommands
 	local function start(client, options)
 		if options == nil then

package/out/components/history/history-line.luau

@@ -4,9 +4,8 @@ local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local derive = _vide.derive
 local HISTORY_TEXT_SIZE = TS.import(script, script.Parent.Parent.Parent, "constants", "text").HISTORY_TEXT_SIZE
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
-local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
+local options = TS.import(script, script.Parent.Parent.Parent, "store").options
 local Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame
 local Group = TS.import(script, script.Parent.Parent, "ui", "group").Group
 local Outline = TS.import(script, script.Parent.Parent, "ui", "outline").Outline
@@ -17,7 +16,6 @@ local function HistoryLine(_param)
 	local size = _param.size
 	local position = _param.position
 	local order = _param.order
-	local options = useAtom(interfaceOptions)
 	local date = derive(function()
 		local dateTime = DateTime.fromUnixTimestamp(data.sentAt):FormatLocalTime("LT", "en-us")
 		local dateParts = string.split(dateTime, " ")

package/out/components/history/history-list.luau

@@ -5,9 +5,8 @@ local Vide = _vide
 local derive = _vide.derive
 local For = _vide.For
 local read = _vide.read
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
-local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
+local options = TS.import(script, script.Parent.Parent.Parent, "store").options
 local ScrollingFrame = TS.import(script, script.Parent.Parent, "ui", "scrolling-frame").ScrollingFrame
 local HistoryLine = TS.import(script, script.Parent, "history-line").HistoryLine
 local function HistoryList(_param)
@@ -15,7 +14,6 @@ local function HistoryList(_param)
 	local size = _param.size
 	local position = _param.position
 	local maxHeight = _param.maxHeight
-	local options = useAtom(interfaceOptions)
 	local height = derive(function()
 		return read(data).height - px(8)
 	end)

package/out/components/suggestions/badge.luau

@@ -1,13 +1,11 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
 local Vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
-local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
+local options = TS.import(script, script.Parent.Parent.Parent, "store").options
 local Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame
 local Text = TS.import(script, script.Parent.Parent, "ui", "text").Text
 local function Badge(props)
-	local options = useAtom(interfaceOptions)
 	local _attributes = {
 		text = props.text,
 		textColor = props.textColor,

package/out/components/suggestions/main-suggestion.luau

@@ -7,11 +7,10 @@ local spring = _vide.spring
 local _text = TS.import(script, script.Parent.Parent.Parent, "constants", "text")
 local SUGGESTION_TEXT_SIZE = _text.SUGGESTION_TEXT_SIZE
 local SUGGESTION_TITLE_TEXT_SIZE = _text.SUGGESTION_TITLE_TEXT_SIZE
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
 local _store = TS.import(script, script.Parent.Parent.Parent, "store")
-local interfaceOptions = _store.interfaceOptions
 local mouseOverInterface = _store.mouseOverInterface
+local options = _store.options
 local Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame
 local Padding = TS.import(script, script.Parent.Parent, "ui", "padding").Padding
 local Text = TS.import(script, script.Parent.Parent, "ui", "text").Text
@@ -26,7 +25,6 @@ local function MainSuggestion(_param)
 	local badgeSize = _param.badgeSize
 	local errorSize = _param.errorSize
 	local action = _param.action
-	local options = useAtom(interfaceOptions)
 	return Vide.jsx(Frame, {
 		action = action,
 		size = size,

package/out/components/suggestions/suggestion-list.luau

@@ -7,11 +7,10 @@ local derive = _vide.derive
 local For = _vide.For
 local read = _vide.read
 local SUGGESTION_TEXT_SIZE = TS.import(script, script.Parent.Parent.Parent, "constants", "text").SUGGESTION_TEXT_SIZE
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
 local _store = TS.import(script, script.Parent.Parent.Parent, "store")
-local interfaceOptions = _store.interfaceOptions
 local mouseOverInterface = _store.mouseOverInterface
+local options = _store.options
 local Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame
 local Group = TS.import(script, script.Parent.Parent, "ui", "group").Group
 local Padding = TS.import(script, script.Parent.Parent, "ui", "padding").Padding
@@ -22,7 +21,6 @@ local function SuggestionList(_param)
 	local suggestion = _param.suggestion
 	local currentText = _param.currentText
 	local size = _param.size
-	local options = useAtom(interfaceOptions)
 	local suggestions = derive(function()
 		local _result = read(suggestion)
 		if _result ~= nil then

package/out/components/suggestions/suggestions.luau

@@ -10,22 +10,18 @@ local spring = _vide.spring
 local _text = TS.import(script, script.Parent.Parent.Parent, "constants", "text")
 local SUGGESTION_TEXT_SIZE = _text.SUGGESTION_TEXT_SIZE
 local SUGGESTION_TITLE_TEXT_SIZE = _text.SUGGESTION_TITLE_TEXT_SIZE
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
 local useTextBounds = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-text-bounds").useTextBounds
 local _store = TS.import(script, script.Parent.Parent.Parent, "store")
 local currentSuggestion = _store.currentSuggestion
 local currentTextPart = _store.currentTextPart
-local interfaceOptions = _store.interfaceOptions
+local options = _store.options
 local Group = TS.import(script, script.Parent.Parent, "ui", "group").Group
 local MainSuggestion = TS.import(script, script.Parent, "main-suggestion").MainSuggestion
 local SuggestionList = TS.import(script, script.Parent, "suggestion-list").SuggestionList
 local MAX_SUGGESTION_WIDTH = 180
 local PADDING = 8
 local function Suggestions()
-	local options = useAtom(interfaceOptions)
-	local textPart = useAtom(currentTextPart)
-	local suggestion = useAtom(currentSuggestion)
 	local suggestionRef = source()
 	local offset = function(boundsState)
 		return function()
@@ -35,7 +31,7 @@ local function Suggestions()
 	end
 	local titleBounds = useTextBounds({
 		text = function()
-			local _result = suggestion()
+			local _result = currentSuggestion()
 			if _result ~= nil then
 				_result = _result.title
 			end
@@ -50,7 +46,7 @@ local function Suggestions()
 	})
 	local descriptionBounds = useTextBounds({
 		text = function()
-			local _result = suggestion()
+			local _result = currentSuggestion()
 			if _result ~= nil then
 				_result = _result.description
 			end
@@ -68,15 +64,15 @@ local function Suggestions()
 	})
 	local typeBadgeBounds = useTextBounds({
 		text = function()
-			local currentSuggestion = suggestion()
-			local _result = currentSuggestion
+			local suggestion = currentSuggestion()
+			local _result = suggestion
 			if _result ~= nil then
 				_result = _result.type
 			end
 			if _result == "command" then
 				return nil
 			end
-			local _result_1 = currentSuggestion
+			local _result_1 = suggestion
 			if _result_1 ~= nil then
 				_result_1 = _result_1.dataType
 			end
@@ -91,15 +87,15 @@ local function Suggestions()
 	})
 	local errorBounds = useTextBounds({
 		text = function()
-			local current = suggestion()
-			local _result = current
+			local suggestion = currentSuggestion()
+			local _result = suggestion
 			if _result ~= nil then
 				_result = _result.type
 			end
 			if _result == "command" then
 				return nil
 			end
-			local _result_1 = current
+			local _result_1 = suggestion
 			if _result_1 ~= nil then
 				_result_1 = _result_1.error
 			end
@@ -117,7 +113,7 @@ local function Suggestions()
 	cleanup(listBoundsParams)
 	local listBounds = derive(function()
 		local width = 0
-		local _result = suggestion()
+		local _result = currentSuggestion()
 		if _result ~= nil then
 			_result = _result.others
 		end
@@ -154,8 +150,8 @@ local function Suggestions()
 	return Vide.jsx(Group, {
 		size = UDim2.fromScale(1, 1),
 	}, Vide.jsx(MainSuggestion, {
-		suggestion = suggestion,
-		currentText = textPart,
+		suggestion = currentSuggestion,
+		currentText = currentTextPart,
 		size = spring(windowSize, 0.2),
 		titleSize = offset(titleBounds),
 		descriptionSize = offset(descriptionBounds),
@@ -163,8 +159,8 @@ local function Suggestions()
 		errorSize = offset(errorBounds),
 		action = suggestionRef,
 	}), Vide.jsx(SuggestionList, {
-		suggestion = suggestion,
-		currentText = textPart,
+		suggestion = currentSuggestion,
+		currentText = currentTextPart,
 		size = spring(function()
 			return UDim2.fromOffset(windowSize().X.Offset, listBounds().Y)
 		end, 0.3),

package/out/components/terminal/suggestion.d.ts

@@ -11,7 +11,7 @@ export interface ListArgument {
     kind: "list";
     options: ReadonlyDeep<ArgumentOptions>;
     type: ListArgumentType<unknown>;
-    input: string[];
+    input?: string[];
 }
 export type Argument = SingleArgument | ListArgument;
 export declare function getArgumentSuggestion(arg: Argument, textPart?: string): {

package/out/components/terminal/suggestion.luau

@@ -69,7 +69,7 @@ local function getArgumentSuggestion(arg, textPart)
 	else
 		local _result_2 = arg.type.suggestions
 		if _result_2 ~= nil then
-			_result_2 = _result_2(arg.input, Players.LocalPlayer)
+			_result_2 = _result_2(arg.input or {}, Players.LocalPlayer)
 		end
 		_result_1 = _result_2
 	end
@@ -80,20 +80,10 @@ local function getArgumentSuggestion(arg, textPart)
 		end
 	end
 	local errorText
-	if not arg.type.expensive then
+	local input = arg.input
+	if not arg.type.expensive and input ~= nil then
 		local success, err = pcall(function()
-			local _result_2
-			if singleArg then
-				local _type = arg.type
-				local _condition = arg.input
-				if _condition == nil then
-					_condition = ""
-				end
-				_result_2 = _type.transform(_condition, Players.LocalPlayer)
-			else
-				_result_2 = arg.type.transform(arg.input, Players.LocalPlayer)
-			end
-			local transformResult = _result_2
+			local transformResult = if singleArg then arg.type.transform(input, Players.LocalPlayer) else arg.type.transform(input, Players.LocalPlayer)
 			if transformResult.ok then
 				return nil
 			end
@@ -171,7 +161,7 @@ local function getCommandSuggestion(registry, parentPath, text)
 	end
 	local _object = {
 		type = "command",
-		title = firstPath:tail(),
+		title = mainData.name,
 	}
 	local _left = "others"
 	-- ▼ ReadonlyArray.map ▼

package/out/components/terminal/terminal-text-field/suggestion.d.ts

@@ -1,5 +1,5 @@
 import { BaseRegistry } from "@rbxts/centurion";
 import { Suggestion } from "../../../types";
-export declare function completeCommand(registry: BaseRegistry, text: string, suggestion: string): string;
+export declare function completeCommand(registry: BaseRegistry, text: string, textParts: string[], suggestion: string): string;
 export declare function completeArgument(text: string, suggestion: string, commandArgCount: number): string;
-export declare function getSuggestedText(registry: BaseRegistry, text: string, suggestion?: Suggestion): string;
+export declare function getSuggestedText(registry: BaseRegistry, text: string, textParts: string[], atNextPart: boolean, suggestion?: Suggestion): string;

package/out/components/terminal/terminal-text-field/suggestion.luau

@@ -1,12 +1,10 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
 local _store = TS.import(script, script.Parent.Parent.Parent.Parent, "store")
-local atNextPart = _store.atNextPart
 local commandArgIndex = _store.commandArgIndex
 local currentCommandPath = _store.currentCommandPath
 local currentTextPart = _store.currentTextPart
 local terminalArgIndex = _store.terminalArgIndex
-local terminalTextParts = _store.terminalTextParts
 local _command = TS.import(script, script.Parent.Parent, "command")
 local formatPartsAsPath = _command.formatPartsAsPath
 local getArgumentNames = _command.getArgumentNames
@@ -28,8 +26,7 @@ local function replaceTextPart(text, ...)
 	result ..= table.concat(suggestions, " ")
 	return result
 end
-local function completeCommand(registry, text, suggestion)
-	local textParts = terminalTextParts()
+local function completeCommand(registry, text, textParts, suggestion)
 	local atNextPart = string.sub(text, -1) == " "
 	local _array = {}
 	local _length = #_array
@@ -76,13 +73,12 @@ local function completeArgument(text, suggestion, commandArgCount)
 	end
 	return result
 end
-local function getSuggestedText(registry, text, suggestion)
+local function getSuggestedText(registry, text, textParts, atNextPart, suggestion)
 	if suggestion == nil then
 		return ""
 	end
 	local suggestionText
-	local parts = terminalTextParts()
-	if #parts == 0 or suggestion.type == "command" then
+	if #textParts == 0 or suggestion.type == "command" then
 		suggestionText = suggestion.title
 	else
 		local command = currentCommandPath()
@@ -90,7 +86,7 @@ local function getSuggestedText(registry, text, suggestion)
 		if command == nil or argIndex == nil then
 			return ""
 		end
-		if atNextPart() and argIndex == commandArgIndex() then
+		if atNextPart and argIndex == commandArgIndex() then
 			suggestionText = suggestion.title
 		elseif not (#suggestion.others == 0) then
 			suggestionText = suggestion.others[1]

package/out/components/terminal/terminal-text-field/terminal-text-field.d.ts

@@ -6,6 +6,8 @@ interface TerminalTextFieldProps {
     backgroundTransparency?: Derivable<number>;
     onTextChange?: (text: string) => void;
     onSubmit?: (text: string) => void;
+    textParts: () => string[];
+    atNextPart: () => boolean;
 }
-export declare function TerminalTextField({ anchor, size, position, backgroundTransparency, onTextChange, onSubmit, }: TerminalTextFieldProps): Vide.Node;
+export declare function TerminalTextField({ anchor, size, position, backgroundTransparency, onTextChange, onSubmit, textParts, atNextPart, }: TerminalTextFieldProps): Vide.Node;
 export {};

package/out/components/terminal/terminal-text-field/terminal-text-field.luau

@@ -1,21 +1,19 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
-local subscribe = TS.import(script, TS.getModule(script, "@rbxts", "charm").src).subscribe
 local UserInputService = TS.import(script, TS.getModule(script, "@rbxts", "services")).UserInputService
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
-local cleanup = _vide.cleanup
+local effect = _vide.effect
 local source = _vide.source
-local useAtom = TS.import(script, script.Parent.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local useClient = TS.import(script, script.Parent.Parent.Parent.Parent, "hooks", "use-client").useClient
 local useEvent = TS.import(script, script.Parent.Parent.Parent.Parent, "hooks", "use-event").useEvent
 local px = TS.import(script, script.Parent.Parent.Parent.Parent, "hooks", "use-px").px
 local _store = TS.import(script, script.Parent.Parent.Parent.Parent, "store")
 local currentCommandPath = _store.currentCommandPath
 local currentSuggestion = _store.currentSuggestion
-local interfaceOptions = _store.interfaceOptions
-local interfaceVisible = _store.interfaceVisible
+local options = _store.options
 local terminalTextValid = _store.terminalTextValid
+local visible = _store.visible
 local Frame = TS.import(script, script.Parent.Parent.Parent, "ui", "frame").Frame
 local Padding = TS.import(script, script.Parent.Parent.Parent, "ui", "padding").Padding
 local Text = TS.import(script, script.Parent.Parent.Parent, "ui", "text").Text
@@ -32,17 +30,17 @@ local function TerminalTextField(_param)
 	local backgroundTransparency = _param.backgroundTransparency
 	local onTextChange = _param.onTextChange
 	local onSubmit = _param.onSubmit
+	local textParts = _param.textParts
+	local atNextPart = _param.atNextPart
 	local client = useClient()
-	local options = useAtom(interfaceOptions)
-	local valid = useAtom(terminalTextValid)
 	local ref = source()
 	local commandHistory = source({})
 	local commandHistoryIndex = source(nil)
 	local suggestionText = source("")
 	local currentTextValue = ""
 	-- Focus text field when terminal becomes visible
-	local visibleConnection = subscribe(interfaceVisible, function(visible)
-		if visible then
+	effect(function()
+		if visible() then
 			local _result = ref()
 			if _result ~= nil then
 				_result:CaptureFocus()
@@ -54,7 +52,6 @@ local function TerminalTextField(_param)
 			end
 		end
 	end)
-	cleanup(visibleConnection)
 	local setText = function(text)
 		local textBox = ref()
 		if textBox == nil then
@@ -90,7 +87,7 @@ local function TerminalTextField(_param)
 		setText(history[newIndex + 1])
 		commandHistoryIndex(newIndex)
 	end
-	local suggestionConnection = subscribe(currentSuggestion, function(suggestion)
+	effect(function()
 		local _exp = client.registry
 		local _result = ref()
 		if _result ~= nil then
@@ -100,9 +97,8 @@ local function TerminalTextField(_param)
 		if _condition == nil then
 			_condition = ""
 		end
-		suggestionText(getSuggestedText(_exp, _condition, suggestion))
+		suggestionText(getSuggestedText(_exp, _condition, textParts(), atNextPart(), currentSuggestion()))
 	end)
-	cleanup(suggestionConnection)
 	useEvent(UserInputService.InputBegan, function(input)
 		local textBox = ref()
 		local _condition = textBox == nil
@@ -133,7 +129,7 @@ local function TerminalTextField(_param)
 		end
 		local currentText = textBox.Text
 		if commandPath == nil then
-			setText(completeCommand(client.registry, textBox.Text, suggestion.title))
+			setText(completeCommand(client.registry, textBox.Text, textParts(), suggestion.title))
 			return nil
 		end
 		local _result = client.registry:getCommand(commandPath)
@@ -180,7 +176,7 @@ local function TerminalTextField(_param)
 			return px(TEXT_SIZE)
 		end,
 		textColor = function()
-			return if valid() then options().palette.success else options().palette.error
+			return if terminalTextValid() then options().palette.success else options().palette.error
 		end,
 		textXAlignment = "Left",
 		placeholderText = "Enter command...",

package/out/components/terminal/terminal.luau

@@ -9,22 +9,22 @@ local derive = _vide.derive
 local source = _vide.source
 local spring = _vide.spring
 local HISTORY_TEXT_SIZE = TS.import(script, script.Parent.Parent.Parent, "constants", "text").HISTORY_TEXT_SIZE
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local useClient = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-client").useClient
 local useHistory = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-history").useHistory
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
 local _store = TS.import(script, script.Parent.Parent.Parent, "store")
-local atNextPart = _store.atNextPart
 local commandArgIndex = _store.commandArgIndex
 local currentCommandPath = _store.currentCommandPath
 local currentSuggestion = _store.currentSuggestion
 local currentTextPart = _store.currentTextPart
-local interfaceOptions = _store.interfaceOptions
 local mouseOverInterface = _store.mouseOverInterface
+local options = _store.options
 local terminalArgIndex = _store.terminalArgIndex
 local terminalText = _store.terminalText
-local terminalTextParts = _store.terminalTextParts
 local terminalTextValid = _store.terminalTextValid
+local _string = TS.import(script, script.Parent.Parent.Parent, "utils", "string")
+local isQuoteEnded = _string.isQuoteEnded
+local isQuoteStarted = _string.isQuoteStarted
 local HistoryList = TS.import(script, script.Parent.Parent, "history").HistoryList
 local Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame
 local Padding = TS.import(script, script.Parent.Parent, "ui", "padding").Padding
@@ -40,9 +40,20 @@ local TEXT_FIELD_HEIGHT = 40
 local TRAILING_SPACE_PATTERN = "(%s+)$"
 local function Terminal()
 	local client = useClient()
-	local options = useAtom(interfaceOptions)
 	local missingArgs = source({})
 	local history = useHistory()
+	local terminalTextParts = derive(function()
+		return splitString(terminalText(), " ", true)
+	end)
+	local atNextPart = derive(function()
+		local parts = terminalTextParts()
+		local textPart = parts[#parts]
+		local quoted = false
+		if textPart ~= nil then
+			quoted = isQuoteStarted(textPart) and not isQuoteEnded(textPart)
+		end
+		return string.sub(terminalText(), -1) == " " and not quoted
+	end)
 	local terminalHeight = derive(function()
 		local padding = px.ceil(TEXT_FIELD_HEIGHT + 16)
 		if #history().lines == 0 then
@@ -103,6 +114,8 @@ local function Terminal()
 			end
 			return _condition
 		end,
+		textParts = terminalTextParts,
+		atNextPart = atNextPart,
 		onTextChange = function(text)
 			terminalText(text)
 			terminalTextValid(false)
@@ -236,7 +249,7 @@ local function Terminal()
 					kind = "list",
 					options = currentArg,
 					type = argType,
-					input = textParts,
+					input = if #textParts > 1 then textParts else nil,
 				}, argTextPart)
 			end
 			currentTextPart(argTextPart)

package/out/components/ui/text-field.luau

@@ -3,10 +3,8 @@ local TS = _G[script]
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local read = _vide.read
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
-local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
+local options = TS.import(script, script.Parent.Parent.Parent, "store").options
 local function TextField(props)
-	local options = useAtom(interfaceOptions)
 	local _attributes = {
 		PlaceholderText = props.placeholderText,
 		PlaceholderColor3 = props.placeholderColor,

package/out/components/ui/text.luau

@@ -3,11 +3,9 @@ local TS = _G[script]
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local read = _vide.read
-local useAtom = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-atom").useAtom
 local px = TS.import(script, script.Parent.Parent.Parent, "hooks", "use-px").px
-local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
+local options = TS.import(script, script.Parent.Parent.Parent, "store").options
 local function Text(props)
-	local options = useAtom(interfaceOptions)
 	local _attributes = {
 		FontFace = function()
 			return read(props.font) or options().font.regular

package/out/hooks/use-history.luau

@@ -6,14 +6,12 @@ local cleanup = _vide.cleanup
 local derive = _vide.derive
 local source = _vide.source
 local HISTORY_TEXT_SIZE = TS.import(script, script.Parent.Parent, "constants", "text").HISTORY_TEXT_SIZE
-local interfaceOptions = TS.import(script, script.Parent.Parent, "store").interfaceOptions
-local useAtom = TS.import(script, script.Parent, "use-atom").useAtom
+local options = TS.import(script, script.Parent.Parent, "store").options
 local useClient = TS.import(script, script.Parent, "use-client").useClient
 local useEvent = TS.import(script, script.Parent, "use-event").useEvent
 local px = TS.import(script, script.Parent, "use-px").px
 local function useHistory()
 	local client = useClient()
-	local options = useAtom(interfaceOptions)
 	local history = source(client.dispatcher:getHistory())
 	useEvent(client.dispatcher.historyUpdated, function(entries)
 		local _array = {}

package/out/hooks/use-text-bounds.luau

@@ -3,20 +3,26 @@ local TS = _G[script]
 local TextService = TS.import(script, TS.getModule(script, "@rbxts", "services")).TextService
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local cleanup = _vide.cleanup
-local derive = _vide.derive
+local effect = _vide.effect
 local read = _vide.read
+local source = _vide.source
+local getBounds = TS.Promise.promisify(function(params)
+	return TextService:GetTextBoundsAsync(params)
+end)
 local function useTextBounds(_param)
 	local text = _param.text
 	local font = _param.font
 	local size = _param.size
 	local width = _param.width
+	local bounds = source(Vector2.zero)
 	local params = Instance.new("GetTextBoundsParams")
 	params.RichText = true
 	cleanup(params)
-	return derive(function()
+	effect(function()
 		local textValue = read(text)
 		if textValue == nil then
-			return Vector2.zero
+			bounds(Vector2.zero)
+			return nil
 		end
 		params.Text = textValue
 		local fontValue = read(font)
@@ -31,8 +37,13 @@ local function useTextBounds(_param)
 		if widthValue ~= nil then
 			params.Width = widthValue
 		end
-		return TextService:GetTextBoundsAsync(params)
+		getBounds(params):andThen(function(value)
+			return bounds(value)
+		end):catch(function()
+			return bounds(Vector2.zero)
+		end)
 	end)
+	return bounds
 end
 return {
 	useTextBounds = useTextBounds,

package/out/store.d.ts

@@ -1,14 +1,12 @@
 import { ImmutableRegistryPath } from "@rbxts/centurion";
 import { Suggestion } from "./types";
-export declare const interfaceVisible: import("@rbxts/charm").Atom<boolean>;
-export declare const interfaceOptions: import("@rbxts/charm").Atom<import("./types").InterfaceOptions>;
-export declare const mouseOverInterface: import("@rbxts/charm").Atom<boolean>;
-export declare const currentCommandPath: import("@rbxts/charm").Atom<ImmutableRegistryPath | undefined>;
-export declare const commandArgIndex: import("@rbxts/charm").Atom<number | undefined>;
-export declare const terminalArgIndex: import("@rbxts/charm").Atom<number | undefined>;
-export declare const currentSuggestion: import("@rbxts/charm").Atom<Suggestion | undefined>;
-export declare const terminalText: import("@rbxts/charm").Atom<string>;
-export declare const terminalTextParts: import("@rbxts/charm").Molecule<string[]>;
-export declare const atNextPart: import("@rbxts/charm").Molecule<boolean>;
-export declare const terminalTextValid: import("@rbxts/charm").Atom<boolean>;
-export declare const currentTextPart: import("@rbxts/charm").Atom<string | undefined>;
+export declare const visible: import("@rbxts/vide").Source<boolean>;
+export declare const options: import("@rbxts/vide").Source<import("./types").InterfaceOptions>;
+export declare const mouseOverInterface: import("@rbxts/vide").Source<boolean>;
+export declare const currentCommandPath: import("@rbxts/vide").Source<ImmutableRegistryPath | undefined>;
+export declare const commandArgIndex: import("@rbxts/vide").Source<number | undefined>;
+export declare const terminalArgIndex: import("@rbxts/vide").Source<number | undefined>;
+export declare const currentSuggestion: import("@rbxts/vide").Source<Suggestion | undefined>;
+export declare const terminalText: import("@rbxts/vide").Source<string>;
+export declare const terminalTextValid: import("@rbxts/vide").Source<boolean>;
+export declare const currentTextPart: import("@rbxts/vide").Source<string | undefined>;

package/out/store.luau

@@ -1,46 +1,26 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
-local splitString = TS.import(script, TS.getModule(script, "@rbxts", "centurion").out.shared.util.string).splitString
-local _charm = TS.import(script, TS.getModule(script, "@rbxts", "charm").src)
-local atom = _charm.atom
-local computed = _charm.computed
+local source = TS.import(script, TS.getModule(script, "@rbxts", "vide").src).source
 local DEFAULT_INTERFACE_OPTIONS = TS.import(script, script.Parent, "constants", "options").DEFAULT_INTERFACE_OPTIONS
-local _string = TS.import(script, script.Parent, "utils", "string")
-local isQuoteEnded = _string.isQuoteEnded
-local isQuoteStarted = _string.isQuoteStarted
-local interfaceVisible = atom(false)
-local interfaceOptions = atom(DEFAULT_INTERFACE_OPTIONS)
-local mouseOverInterface = atom(false)
-local currentCommandPath = atom(nil)
-local commandArgIndex = atom(nil)
-local terminalArgIndex = atom(nil)
-local currentSuggestion = atom(nil)
-local terminalText = atom("")
-local terminalTextParts = computed(function()
-	return splitString(terminalText(), " ", true)
-end)
-local atNextPart = computed(function()
-	local parts = terminalTextParts()
-	local textPart = parts[#parts]
-	local quoted = false
-	if textPart ~= nil then
-		quoted = isQuoteStarted(textPart) and not isQuoteEnded(textPart)
-	end
-	return string.sub(terminalText(), -1) == " " and not quoted
-end)
-local terminalTextValid = atom(false)
-local currentTextPart = atom(nil)
+local visible = source(false)
+local options = source(DEFAULT_INTERFACE_OPTIONS)
+local mouseOverInterface = source(false)
+local currentCommandPath = source(nil)
+local commandArgIndex = source(nil)
+local terminalArgIndex = source(nil)
+local currentSuggestion = source(nil)
+local terminalText = source("")
+local terminalTextValid = source(false)
+local currentTextPart = source(nil)
 return {
-	interfaceVisible = interfaceVisible,
-	interfaceOptions = interfaceOptions,
+	visible = visible,
+	options = options,
 	mouseOverInterface = mouseOverInterface,
 	currentCommandPath = currentCommandPath,
 	commandArgIndex = commandArgIndex,
 	terminalArgIndex = terminalArgIndex,
 	currentSuggestion = currentSuggestion,
 	terminalText = terminalText,
-	terminalTextParts = terminalTextParts,
-	atNextPart = atNextPart,
 	terminalTextValid = terminalTextValid,
 	currentTextPart = currentTextPart,
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rbxts/centurion-ui",
   "description": "Terminal UI for the Centurion command framework",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "author": "paradoxuum",
   "license": "MIT",
   "main": "out/init.lua",
@@ -32,20 +32,19 @@
     "dev": "shx rm -rf out && rbxtsc -w"
   },
   "devDependencies": {
-    "@rbxts/centurion": "^1.0.0",
+    "@rbxts/centurion": "^1.0.1",
     "@rbxts/compiler-types": "3.0.0-types.0",
-    "@rbxts/types": "^1.0.809",
+    "@rbxts/types": "^1.0.813",
     "roblox-ts": "3.0.0",
     "shx": "^0.3.4",
-    "typescript": "=5.5.3"
+    "typescript": "5.5.3"
   },
   "dependencies": {
-    "@rbxts/charm": "^0.7.5",
     "@rbxts/services": "^1.5.5",
     "@rbxts/set-timeout": "^1.1.2",
-    "@rbxts/vide": "^0.4.6"
+    "@rbxts/vide": "^0.5.0"
   },
   "peerDependencies": {
-    "@rbxts/centurion": "^1.0.0"
+    "@rbxts/centurion": "^1.0.1"
   }
 }

package/out/hooks/use-atom.d.ts

@@ -1,2 +0,0 @@
-import { Molecule } from "@rbxts/charm";
-export declare function useAtom<T>(atom: Molecule<T>): import("@rbxts/vide").Source<T>;

package/out/hooks/use-atom.luau

@@ -1,17 +0,0 @@
--- Compiled with roblox-ts v3.0.0
-local TS = _G[script]
-local subscribe = TS.import(script, TS.getModule(script, "@rbxts", "charm").src).subscribe
-local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
-local cleanup = _vide.cleanup
-local source = _vide.source
-local function useAtom(atom)
-	local state = source(atom())
-	local disconnect = subscribe(atom, state)
-	cleanup(function()
-		disconnect()
-	end)
-	return state
-end
-return {
-	useAtom = useAtom,
-}