@rbxts/centurion-ui 1.0.2 → 1.0.3

package/out/app/centurion-app.luau

@@ -4,12 +4,12 @@ local UserInputService = TS.import(script, TS.getModule(script, "@rbxts", "servi
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local derive = _vide.derive
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 local _components = TS.import(script, script.Parent.Parent, "components")
 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")

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

@@ -16,14 +16,35 @@ 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()
 	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)
 	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)
@@ -38,6 +59,17 @@ do
 		end)
 	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

@@ -3,8 +3,8 @@ local TS = _G[script]
 local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local derive = _vide.derive
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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 Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame

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

@@ -5,7 +5,7 @@ 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 useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).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 ScrollingFrame = TS.import(script, script.Parent.Parent, "ui", "scrolling-frame").ScrollingFrame

package/out/components/suggestions/badge.luau

@@ -1,7 +1,7 @@
 -- 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 useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).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 Frame = TS.import(script, script.Parent.Parent, "ui", "frame").Frame

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

@@ -4,10 +4,10 @@ local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local Vide = _vide
 local read = _vide.read
 local spring = _vide.spring
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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

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

@@ -6,8 +6,8 @@ local Vide = _vide
 local derive = _vide.derive
 local For = _vide.For
 local read = _vide.read
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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

package/out/components/suggestions/suggestions.luau

@@ -7,10 +7,10 @@ local cleanup = _vide.cleanup
 local derive = _vide.derive
 local source = _vide.source
 local spring = _vide.spring
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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")

package/out/components/terminal/suggestion.luau

@@ -171,7 +171,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/terminal-text-field.luau

@@ -1,12 +1,12 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
-local subscribe = TS.import(script, TS.getModule(script, "@rbxts", "charm").src).subscribe
+local subscribe = TS.import(script, TS.getModule(script, "@rbxts", "Charm")).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 source = _vide.source
-local useAtom = TS.import(script, script.Parent.Parent.Parent.Parent, "hooks", "use-atom").useAtom
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).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

package/out/components/terminal/terminal.luau

@@ -8,8 +8,8 @@ local Vide = _vide
 local derive = _vide.derive
 local source = _vide.source
 local spring = _vide.spring
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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

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

@@ -3,7 +3,7 @@ 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 useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 local interfaceOptions = TS.import(script, script.Parent.Parent.Parent, "store").interfaceOptions
 local function TextField(props)
 	local options = useAtom(interfaceOptions)

package/out/components/ui/text.luau

@@ -3,7 +3,7 @@ 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 useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).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 function Text(props)

package/out/hooks/use-history.luau

@@ -5,9 +5,9 @@ local _vide = TS.import(script, TS.getModule(script, "@rbxts", "vide").src)
 local cleanup = _vide.cleanup
 local derive = _vide.derive
 local source = _vide.source
+local useAtom = TS.import(script, TS.getModule(script, "@rbxts", "VideCharm")).useAtom
 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 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

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

@@ -8,7 +8,7 @@ export declare const commandArgIndex: import("@rbxts/charm").Atom<number | undef
 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 terminalTextParts: import("@rbxts/charm").Selector<string[]>;
+export declare const atNextPart: import("@rbxts/charm").Selector<boolean>;
 export declare const terminalTextValid: import("@rbxts/charm").Atom<boolean>;
 export declare const currentTextPart: import("@rbxts/charm").Atom<string | undefined>;

package/out/store.luau

@@ -1,7 +1,7 @@
 -- 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 _charm = TS.import(script, TS.getModule(script, "@rbxts", "Charm"))
 local atom = _charm.atom
 local computed = _charm.computed
 local DEFAULT_INTERFACE_OPTIONS = TS.import(script, script.Parent, "constants", "options").DEFAULT_INTERFACE_OPTIONS

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.3",
   "author": "paradoxuum",
   "license": "MIT",
   "main": "out/init.lua",
@@ -32,20 +32,21 @@
     "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/charm": "^0.8.1",
     "@rbxts/services": "^1.5.5",
     "@rbxts/set-timeout": "^1.1.2",
-    "@rbxts/vide": "^0.4.6"
+    "@rbxts/vide": "^0.5.0",
+    "@rbxts/vide-charm": "^0.1.1"
   },
   "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,
-}