@rbxts/centurion-ui 1.0.1 → 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

@@ -1,17 +1,17 @@
 -- Compiled with roblox-ts v3.0.0
 local TS = _G[script]
 local Players = TS.import(script, TS.getModule(script, "@rbxts", "services")).Players
-local MAX_OTHER_SUGGESTIONS = 3
-local function formatText(text)
-	return if #{ string.match(text, "%s") } == 0 then text else `"{text}"`
-end
+local _string = TS.import(script, script.Parent.Parent.Parent, "utils", "string")
+local containsSpace = _string.containsSpace
+local getQuoteChar = _string.getQuoteChar
 local function getMatches(strings, text)
 	if text == nil then
 		table.sort(strings)
 		-- ▼ ReadonlyArray.map ▼
 		local _newValue = table.create(#strings)
 		local _callback = function(str, i)
-			return { i, str, #str }
+			local formatted = if containsSpace(str) then `"{str}"` else str
+			return { i, formatted, #formatted }
 		end
 		for _k, _v in strings do
 			_newValue[_k] = _callback(_v, _k - 1, strings)
@@ -21,39 +21,35 @@ local function getMatches(strings, text)
 	end
 	local textLower = string.lower(text)
 	local textEndIndex = #text
-	-- ▼ ReadonlyArray.mapFiltered ▼
-	local _newValue = {}
-	local _callback = function(str, i)
+	local quoteChar = getQuoteChar(text)
+	local quoted = quoteChar ~= nil
+	local results = {}
+	for i = 0, #strings - 1 do
+		local str = strings[i + 1]
+		if quoted then
+			str = `{quoteChar}{str}{quoteChar}`
+		elseif containsSpace(str) then
+			str = `"{str}"`
+		end
 		local part = string.sub(string.lower(str), 0, textEndIndex)
 		if part == textLower then
-			return { i, str, #str }
-		end
-	end
-	local _length = 0
-	for _k, _v in strings do
-		local _result = _callback(_v, _k - 1, strings)
-		if _result ~= nil then
-			_length += 1
-			_newValue[_length] = _result
+			local _arg0 = { i, str, #str }
+			table.insert(results, _arg0)
 		end
 	end
-	-- ▲ ReadonlyArray.mapFiltered ▲
-	table.sort(_newValue, function(a, b)
+	table.sort(results, function(a, b)
 		return a[2] < b[2]
 	end)
-	return _newValue
+	return results
 end
 local function getArgumentSuggestion(arg, textPart)
 	local _result
 	if arg.options.suggestions ~= nil then
-		local _exp = arg.options.suggestions
-		-- ▼ ReadonlyArray.map ▼
-		local _newValue = table.create(#_exp)
-		for _k, _v in _exp do
-			_newValue[_k] = formatText(_v, _k - 1, _exp)
-		end
-		-- ▲ ReadonlyArray.map ▲
-		_result = _newValue
+		local _array = {}
+		local _length = #_array
+		local _array_1 = arg.options.suggestions
+		table.move(_array_1, 1, #_array_1, _length + 1, _array)
+		_result = _array
 	else
 		_result = {}
 	end
@@ -80,8 +76,7 @@ local function getArgumentSuggestion(arg, textPart)
 	local typeSuggestions = _result_1
 	if typeSuggestions ~= nil then
 		for _, text in typeSuggestions do
-			local _arg0 = formatText(text)
-			table.insert(suggestions, _arg0)
+			table.insert(suggestions, text)
 		end
 	end
 	local errorText
@@ -176,14 +171,14 @@ local function getCommandSuggestion(registry, parentPath, text)
 	end
 	local _object = {
 		type = "command",
-		title = firstPath:tail(),
+		title = mainData.name,
 	}
 	local _left = "others"
 	-- ▼ ReadonlyArray.map ▼
 	local _newValue_1 = table.create(#sortedPaths)
 	local _callback_1 = function(_param)
 		local str = _param[2]
-		return formatText(str)
+		return str
 	end
 	for _k, _v in sortedPaths do
 		_newValue_1[_k] = _callback_1(_v, _k - 1, sortedPaths)

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
@@ -37,7 +37,6 @@ local getCommandSuggestion = _suggestion.getCommandSuggestion
 local TerminalTextField = TS.import(script, script.Parent, "terminal-text-field").TerminalTextField
 local MAX_HEIGHT = HISTORY_TEXT_SIZE * 10
 local TEXT_FIELD_HEIGHT = 40
-local START_QUOTE_PATTERN = `^(['"])`
 local TRAILING_SPACE_PATTERN = "(%s+)$"
 local function Terminal()
 	local client = useClient()

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,10 +1,13 @@
 -- 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
+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)
@@ -19,19 +22,10 @@ end)
 local atNextPart = computed(function()
 	local parts = terminalTextParts()
 	local textPart = parts[#parts]
-	local _startQuote = textPart
-	if _startQuote ~= nil then
-		local _arg0 = `^(['"])`
-		_startQuote = string.match(_startQuote, _arg0)
+	local quoted = false
+	if textPart ~= nil then
+		quoted = isQuoteStarted(textPart) and not isQuoteEnded(textPart)
 	end
-	local startQuote = _startQuote
-	local _endQuote = textPart
-	if _endQuote ~= nil then
-		local _arg0 = `(['"])%s*$`
-		_endQuote = string.match(_endQuote, _arg0)
-	end
-	local endQuote = _endQuote
-	local quoted = startQuote ~= nil and endQuote == nil
 	return string.sub(terminalText(), -1) == " " and not quoted
 end)
 local terminalTextValid = atom(false)

package/out/utils/string.d.ts

@@ -0,0 +1,5 @@
+export declare function containsSpace(text: string): boolean;
+export declare function stripQuotes(text: string): string;
+export declare function getQuoteChar(text: string): string;
+export declare function isQuoteStarted(text: string): boolean;
+export declare function isQuoteEnded(text: string): boolean;

package/out/utils/string.luau

@@ -0,0 +1,25 @@
+-- Compiled with roblox-ts v3.0.0
+local START_QUOTE_PATTERN = `^(['"])`
+local END_QUOTE_PATTERN = `(['"])%s*$`
+local function containsSpace(text)
+	return not (#{ string.match(text, "%s") } == 0)
+end
+local function stripQuotes(text)
+	return (string.gsub((string.gsub(text, START_QUOTE_PATTERN, "")), END_QUOTE_PATTERN, ""))
+end
+local function getQuoteChar(text)
+	return (string.match(text, START_QUOTE_PATTERN))
+end
+local function isQuoteStarted(text)
+	return (string.match(text, START_QUOTE_PATTERN)) ~= nil
+end
+local function isQuoteEnded(text)
+	return (string.match(text, END_QUOTE_PATTERN)) ~= nil
+end
+return {
+	containsSpace = containsSpace,
+	stripQuotes = stripQuotes,
+	getQuoteChar = getQuoteChar,
+	isQuoteStarted = isQuoteStarted,
+	isQuoteEnded = isQuoteEnded,
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rbxts/centurion-ui",
   "description": "Terminal UI for the Centurion command framework",
-  "version": "1.0.1",
+  "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,
-}