From 9737c4bb64d97814db8f44df41f95bdd2ab45b94 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Mon, 27 Oct 2025 07:26:29 +0000
Subject: [PATCH] Update config, BasaltLS definitions, bundle and changelog

---
 BasaltLS.lua       | 8941 ++++++++++++++++++++++----------------------
 config.lua         |  700 ++--
 release/basalt.lua | 1105 ++++--
 3 files changed, 5606 insertions(+), 5140 deletions(-)

diff --git a/BasaltLS.lua b/BasaltLS.lua
index ef04a6f..03fcf28 100644
--- a/BasaltLS.lua
+++ b/BasaltLS.lua
@@ -1,5 +1,2704 @@
 ---@meta
 
+---@class BaseElement : PropertySystem
+---@field eventCallbacks table Collection of registered event handler functions
+---@field id string Auto-generated unique identifier for element lookup
+---@field states table Table of currently active states with their priorities
+---@field type string A hierarchical identifier of the element's type chain
+---@field name string User-defined name for the element
+---@field enabled boolean Controls event processing for this element
+local BaseElement = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param event string The event to handle
+---@return boolean ? handled Whether the event was handled
+---@protected
+function BaseElement:dispatchEvent(event) end
+
+---Gets all currently active states sorted by priority
+---@return table states Array of {name, priority} sorted by priority
+function BaseElement:getActiveStates() end
+
+---Manually deactivates a state
+---@param stateName string The state to deactivate
+---@return BaseElement self
+function BaseElement:unsetState(stateName) end
+
+---Removes the element from UI tree and cleans up resources
+function BaseElement:destroy() end
+
+---Propagates render request up the element tree
+---@return table self The BaseElement instance
+function BaseElement:updateRender() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return table self The initialized instance
+---@protected
+function BaseElement:init(props, basalt) end
+
+---Gets the highest priority active state
+---@return string |nil currentState The state with highest priority
+function BaseElement:getCurrentState() end
+
+---Gets the value of the Enabled property.
+---@param self BaseElement self
+---@return boolean BaseElement Controls event processing for this element
+function BaseElement:getEnabled(self) end
+
+---Gets the value of the Id property.
+---@param self BaseElement self
+---@return string BaseElement Auto-generated unique identifier for element lookup
+function BaseElement:getId(self) end
+
+---Starts profiling a method
+---@param methodName string The name of the method to profile
+---@return BaseElement self The element instance
+function BaseElement:startProfile(methodName) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@return table self The BaseElement instance
+---@protected
+function BaseElement:postInit() end
+
+---Gets the value of the EventCallbacks property.
+---@param self BaseElement self
+---@return table BaseElement Collection of registered event handler functions
+function BaseElement:getEventCallbacks(self) end
+
+---Checks if the element matches or inherits from the specified type
+---@param type string The type to check for
+---@return boolean isType Whether the element is of the specified type
+function BaseElement:isType(type) end
+
+---Gets the value of the States property.
+---@param self BaseElement self
+---@return table {} Table of currently active states with their priorities
+function BaseElement:getStates(self) end
+
+---Enables benchmarking for a method
+---@param methodName string The name of the method to benchmark
+---@return BaseElement self The element instance
+function BaseElement:benchmark(methodName) end
+
+---Sets the value of the Name property.
+---@param self BaseElement self
+---@param Name string User-defined name for the element
+function BaseElement:setName(self, Name) end
+
+---Sets the value of the Enabled property.
+---@param self BaseElement self
+---@param Enabled boolean Controls event processing for this element
+function BaseElement:setEnabled(self, Enabled) end
+
+---Sets the value of the Id property.
+---@param self BaseElement self
+---@param Id string Auto-generated unique identifier for element lookup
+function BaseElement:setId(self, Id) end
+
+---Defines a class-level event callback method with automatic event registration
+---@param class table The class to register
+---@param callbackName string The name of the callback to register
+function BaseElement.registerEventCallback(class, callbackName) end
+
+---Ends profiling a method
+---@param methodName string The name of the method to stop profiling
+---@return BaseElement self The element instance
+function BaseElement:endProfile(methodName) end
+
+---Stops benchmarking for a method
+---@param methodName string The name of the method to stop benchmarking
+---@return BaseElement self The element instance
+function BaseElement:stopBenchmark(methodName) end
+
+---Gets the value of the Name property.
+---@param self BaseElement self
+---@return string BaseElement User-defined name for the element
+function BaseElement:getName(self) end
+
+---Sets the value of the States property.
+---@param self BaseElement self
+---@param States table Table of currently active states with their priorities
+function BaseElement:setStates(self, States) end
+
+---Enables debugging for this element
+---@param self BaseElement The element to debug
+---@param level number The debug level
+function BaseElement.debug(self, level) end
+
+---Logs benchmark statistics for a method
+---@param methodName string The name of the method to log
+---@return BaseElement self The element instance
+function BaseElement:logBenchmark(methodName) end
+
+---Gets benchmark statistics for a method
+---@param methodName string The name of the method to get statistics for
+---@return table ? stats The benchmark statistics or nil
+function BaseElement:getBenchmarkStats(methodName) end
+
+---Traverses parent chain to locate the root frame element
+---@return BaseFrame BaseFrame The base frame of the element
+function BaseElement:getBaseFrame() end
+
+---Dumps debug information for this element
+---@param self BaseElement The element to dump debug info for
+function BaseElement.dumpDebug(self) end
+
+---Manually activates a state
+---@param stateName string The state to activate
+---@return BaseElement self
+function BaseElement:setState(stateName) end
+
+---Updates all states that have auto-conditions
+---@return BaseElement self
+function BaseElement:updateConditionalStates() end
+
+---Adds an event handler function with automatic event registration
+---@param event string The event to register the callback for
+---@param callback function The callback function to register
+---@return table self The BaseElement instance
+function BaseElement:registerCallback(event, callback) end
+
+---Checks if a state is currently active
+---@param stateName string The state to check
+---@return boolean isActive
+function BaseElement:hasState(stateName) end
+
+---Removes a state from the registry
+---@param stateName string The state to remove
+---@return BaseElement self
+function BaseElement:unregisterState(stateName) end
+
+---Executes all registered callbacks for the specified event
+---@param event string The event to fire
+---@return table self The BaseElement instance
+function BaseElement:fireEvent(event) end
+
+---Sets the value of the Type property.
+---@param self BaseElement self
+---@param Type string A hierarchical identifier of the element's type chain
+function BaseElement:setType(self, Type) end
+
+---Registers a new state with optional auto-condition
+---@param stateName string The name of the state
+---@return BaseElement self The BaseElement instance
+function BaseElement:registerState(stateName) end
+
+---Sets up a property change observer with immediate callback registration
+---@param property string The property to observe
+---@param callback function The callback to call when the property changes
+---@return table self The BaseElement instance
+function BaseElement:onChange(property, callback) end
+
+---Registers a class-level event listener with optional dependency
+---@param class table The class to register
+---@param eventName string The name of the event to register
+function BaseElement.defineEvent(class, eventName) end
+
+---Gets the value of the Type property.
+---@param self BaseElement self
+---@return string BaseElement A hierarchical identifier of the element's type chain
+function BaseElement:getType(self) end
+
+---Configures event listening behavior with automatic parent notification
+---@param eventName string The name of the event to listen for
+---@return table self The BaseElement instance
+function BaseElement:listenEvent(eventName) end
+
+---Sets the value of the EventCallbacks property.
+---@param self BaseElement self
+---@param EventCallbacks table Collection of registered event handler functions
+function BaseElement:setEventCallbacks(self, EventCallbacks) end
+
+---Applies the current theme to this element
+---@param self BaseElement The element to apply theme to
+---@param applyToChildren boolean ? Whether to apply theme to child elements (default: true)
+---@return BaseElement self The element instance
+function BaseElement:applyTheme(self, applyToChildren) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param event string The event to handle
+---@return boolean ? handled Whether the event was handled
+---@protected
+function BaseElement:handleEvent(event) end
+
+---Gets the theme properties for this element
+---@param self BaseElement The element to get theme for
+---@return table styles The theme properties
+function BaseElement:getTheme(self) end
+
+---@class Button : VisualElement
+---@field text string Label text displayed centered within the button
+local Button = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function Button:init(props, basalt) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Button:render() end
+
+---Sets the value of the Text property.
+---@param self Button self
+---@param Text string Label text displayed centered within the button
+function Button:setText(self, Text) end
+
+---Gets the value of the Text property.
+---@param self Button self
+---@return string Button Label text displayed centered within the button
+function Button:getText(self) end
+
+---@class TabControl : Container
+---@field tabHeight number Height of the tab header area
+---@field activeTab number The currently active tab ID
+---@field tabs table List of tab definitions
+---@field scrollableTab boolean Enables scroll mode for tabs if they exceed width
+---@field tabScrollOffset number Current scroll offset for tabs in scrollable mode
+---@field activeTabTextColor color Foreground color for the active tab text
+---@field headerBackground color Background color for the tab header area
+---@field activeTabBackground color Background color for the active tab
+local TabControl = {}
+
+---Sets the value of the HeaderBackground property.
+---@param self TabControl self
+---@param HeaderBackground color Background color for the tab header area
+function TabControl:setHeaderBackground(self, HeaderBackground) end
+
+---@param elementType string The type of element to add
+---@param tabId number Optional tab ID, defaults to active tab
+---@return table element The created element
+function TabControl:addElement(elementType, tabId) end
+
+function TabControl:_getHeaderMetrics() end
+
+---Sets the value of the Tabs property.
+---@param self TabControl self
+---@param Tabs table List of tab definitions
+function TabControl:setTabs(self, Tabs) end
+
+function TabControl:mouse_up() end
+
+---@param tabId number The ID of the tab to activate
+function TabControl:setActiveTab(tabId) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param child table The child element to check
+---@return boolean Whether the child should be visible
+---@protected
+function TabControl:isChildVisible(child) end
+
+function TabControl:drawText() end
+
+function TabControl:mouse_move() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click (global)
+---@param y number The y position of the click (global)
+---@return boolean Whether the event was handled
+---@protected
+function TabControl:mouse_click(button, x, y) end
+
+---Gets the value of the ActiveTab property.
+---@param self TabControl self
+---@return number nil The currently active tab ID
+function TabControl:getActiveTab(self) end
+
+---Gets the value of the Tabs property.
+---@param self TabControl self
+---@return table {} List of tab definitions
+function TabControl:getTabs(self) end
+
+function TabControl:mouse_drag() end
+
+function TabControl:drawBg() end
+
+function TabControl:textBg() end
+
+function TabControl:setCursor() end
+
+---Gets the value of the HeaderBackground property.
+---@param self TabControl self
+---@return color gray Background color for the tab header area
+function TabControl:getHeaderBackground(self) end
+
+---Gets the value of the TabHeight property.
+---@param self TabControl self
+---@return number 1 Height of the tab header area
+function TabControl:getTabHeight(self) end
+
+function TabControl:textFg() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function TabControl:sortChildrenEvents() end
+
+---Sets the value of the ActiveTabBackground property.
+---@param self TabControl self
+---@param ActiveTabBackground color Background color for the active tab
+function TabControl:setActiveTabBackground(self, ActiveTabBackground) end
+
+---Sets the value of the TabHeight property.
+---@param self TabControl self
+---@param TabHeight number Height of the tab header area
+function TabControl:setTabHeight(self, TabHeight) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function TabControl:render() end
+
+function TabControl:mouse_scroll() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param child table The child element to add
+---@return Container self For method chaining
+---@protected
+function TabControl:addChild(child) end
+
+function TabControl:mouse_release() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function TabControl:init(props, basalt) end
+
+---@param element table The element to assign to a tab
+---@param tabId number The ID of the tab to assign the element to
+---@return TabControl self For method chaining
+function TabControl:setTab(element, tabId) end
+
+---Sets the value of the TabScrollOffset property.
+---@param self TabControl self
+---@param TabScrollOffset number Current scroll offset for tabs in scrollable mode
+function TabControl:setTabScrollOffset(self, TabScrollOffset) end
+
+---Sets the value of the ScrollableTab property.
+---@param self TabControl self
+---@param ScrollableTab boolean Enables scroll mode for tabs if they exceed width
+function TabControl:setScrollableTab(self, ScrollableTab) end
+
+---Gets the value of the ActiveTabBackground property.
+---@param self TabControl self
+---@return color white Background color for the active tab
+function TabControl:getActiveTabBackground(self) end
+
+---Gets the value of the TabScrollOffset property.
+---@param self TabControl self
+---@return number 0 Current scroll offset for tabs in scrollable mode
+function TabControl:getTabScrollOffset(self) end
+
+function TabControl:blit() end
+
+function TabControl:drawFg() end
+
+---Gets the value of the ActiveTabTextColor property.
+---@param self TabControl self
+---@return color black Foreground color for the active tab text
+function TabControl:getActiveTabTextColor(self) end
+
+---Scrolls the tab header left or right if scrollableTab is enabled
+---@param direction number -1 to scroll left, 1 to scroll right
+---@return TabControl self For method chaining
+function TabControl:scrollTabs(direction) end
+
+---returns a proxy for adding elements to the tab
+---@param title string The title of the tab
+---@return table tabHandler The tab handler proxy for adding elements to the new tab
+function TabControl:newTab(title) end
+
+---Gets the value of the ScrollableTab property.
+---@param self TabControl self
+---@return boolean false Enables scroll mode for tabs if they exceed width
+function TabControl:getScrollableTab(self) end
+
+---Sets the value of the ActiveTabTextColor property.
+---@param self TabControl self
+---@param ActiveTabTextColor color Foreground color for the active tab text
+function TabControl:setActiveTabTextColor(self, ActiveTabTextColor) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@return number yOffset The Y offset for content
+---@protected
+function TabControl:getContentYOffset() end
+
+function TabControl:multiBlit() end
+
+function TabControl:getRelativePosition() end
+
+---@class Render
+local Render = {}
+
+---Clears the screen
+---@param bg colors The background color to clear the screen with
+---@return Render 
+function Render:clear(bg) end
+
+---Blits a foreground color to the screen
+---@param x number The x position
+---@param y number The y position
+---@param fg string The foreground color to blit
+---@return Render 
+function Render:fg(x, y, fg) end
+
+---Merges two rectangles
+---@param target table The target rectangle
+---@param source table The source rectangle
+---@return Render 
+function Render:mergeRects(target, source) end
+
+---Sets the cursor position
+---@param x number The x position of the cursor
+---@param y number The y position of the cursor
+---@param blink boolean Whether the cursor should blink
+---@return Render 
+function Render:setCursor(x, y, blink) end
+
+---Sets the size of the render
+---@param width number The width of the render
+---@param height number The height of the render
+---@return Render 
+function Render:setSize(width, height) end
+
+---Blits text to the screen with a foreground color
+---@param x number The x position to blit to
+---@param y number The y position to blit to
+---@param text string The text to blit
+---@param fg colors The foreground color of the text
+---@return Render 
+function Render:textFg(x, y, text, fg) end
+
+---Blits text to the screen
+---@param x number The x position to blit to
+---@param y number The y position to blit to
+---@param text string The text to blit
+---@return Render 
+function Render:text(x, y, text) end
+
+---Creates a new Render object
+---@param terminal table The terminal object to render to
+---@return Render 
+function Render.new(terminal) end
+
+---Blits a background color to the screen
+---@param x number The x position
+---@param y number The y position
+---@param bg string The background color to blit
+---@return Render 
+function Render:bg(x, y, bg) end
+
+---Gets the size of the render
+---@return number , number
+function Render:getSize() end
+
+---Checks if two rectangles overlap
+---@param r1 table The first rectangle
+---@param r2 table The second rectangle
+---@return boolean 
+function Render:rectOverlaps(r1, r2) end
+
+---Blits text to the screen with a background color
+---@param x number The x position to blit to
+---@param y number The y position to blit to
+---@param text string The text to blit
+---@param bg colors The background color of the text
+---@return Render 
+function Render:textBg(x, y, text, bg) end
+
+---Blits text to the screen
+---@param x number The x position to blit to
+---@param y number The y position to blit to
+---@param text string The text to blit
+---@param fg string The foreground color of the text
+---@param bg string The background color of the text
+---@return Render 
+function Render:blit(x, y, text, fg, bg) end
+
+---Blits text to the screen with multiple lines
+---@param x number The x position to blit to
+---@param y number The y position to blit to
+---@param width number The width of the text
+---@param height number The height of the text
+---@param text string The text to blit
+---@param fg colors The foreground color of the text
+---@param bg colors The background color of the text
+---@return Render 
+function Render:multiBlit(x, y, width, height, text, fg, bg) end
+
+---Adds a dirty rectangle to the buffer
+---@param x number The x position of the rectangle
+---@param y number The y position of the rectangle
+---@param width number The width of the rectangle
+---@param height number The height of the rectangle
+---@return Render 
+function Render:addDirtyRect(x, y, width, height) end
+
+---Clears an area of the screen
+---@param x number The x position of the area
+---@param y number The y position of the area
+---@param width number The width of the area
+---@param height number The height of the area
+---@param bg colors The background color to clear the area with
+---@return Render 
+function Render:clearArea(x, y, width, height, bg) end
+
+---Renders the buffer to the screen
+---@return Render 
+function Render:render() end
+
+---@class Slider : VisualElement
+---@field horizontal boolean Whether the slider is horizontal (false for vertical)
+---@field max number Maximum value for value conversion (maps slider position to this range)
+---@field barColor color Color of the slider track
+---@field step number Current position of the slider handle (1 to width/height)
+---@field sliderColor color Color of the slider handle
+local Slider = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button that was released
+---@param x number The x position of the release
+---@param y number The y position of the release
+---@return boolean handled Whether the event was handled
+---@protected
+function Slider:mouse_scroll(button, x, y) end
+
+---Gets the value of the Max property.
+---@param self Slider self
+---@return number 100 Maximum value for value conversion (maps slider position to this range)
+function Slider:getMax(self) end
+
+---Gets the value of the Step property.
+---@param self Slider self
+---@return number 1 Current position of the slider handle (1 to width/height)
+function Slider:getStep(self) end
+
+---Registers a function to handle the onChange event.
+---@param value number
+---@param self Slider self
+---@param func function The function to be called when the event fires
+function Slider:onOnChange(self, func) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Slider:render() end
+
+---Sets the value of the Step property.
+---@param self Slider self
+---@param Step number Current position of the slider handle (1 to width/height)
+function Slider:setStep(self, Step) end
+
+---Sets the value of the Horizontal property.
+---@param self Slider self
+---@param Horizontal boolean Whether the slider is horizontal (false for vertical)
+function Slider:setHorizontal(self, Horizontal) end
+
+---Gets the value of the SliderColor property.
+---@param self Slider self
+---@return color blue Color of the slider handle
+function Slider:getSliderColor(self) end
+
+---Sets the value of the Max property.
+---@param self Slider self
+---@param Max number Maximum value for value conversion (maps slider position to this range)
+function Slider:setMax(self, Max) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Slider:mouse_click(button, x, y) end
+
+---Gets the value of the Horizontal property.
+---@param self Slider self
+---@return boolean true Whether the slider is horizontal (false for vertical)
+function Slider:getHorizontal(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Slider self The initialized instance
+---@protected
+function Slider:init(props, basalt) end
+
+---Sets the value of the BarColor property.
+---@param self Slider self
+---@param BarColor color Color of the slider track
+function Slider:setBarColor(self, BarColor) end
+
+---Gets the value of the BarColor property.
+---@param self Slider self
+---@return color gray Color of the slider track
+function Slider:getBarColor(self) end
+
+---Gets the current value of the slider
+---@return number value The current value (0 to max)
+function Slider:getValue() end
+
+---Sets the value of the SliderColor property.
+---@param self Slider self
+---@param SliderColor color Color of the slider handle
+function Slider:setSliderColor(self, SliderColor) end
+
+---@class BigFont : VisualElement
+---@field text string The text string to display in enlarged format
+---@field fontSize number Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
+local BigFont = {}
+
+---Sets the value of the FontSize property.
+---@param self BigFont self
+---@param FontSize number Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
+function BigFont:setFontSize(self, FontSize) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function BigFont:render() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function BigFont:init(props, basalt) end
+
+---Gets the value of the Text property.
+---@param self BigFont self
+---@return string BigFont The text string to display in enlarged format
+function BigFont:getText(self) end
+
+---Sets the value of the Text property.
+---@param self BigFont self
+---@param Text string The text string to display in enlarged format
+function BigFont:setText(self, Text) end
+
+---Gets the value of the FontSize property.
+---@param self BigFont self
+---@return number 1 Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
+function BigFont:getFontSize(self) end
+
+---@class Table : VisualElement
+---@field selectedColor color Background color of selected row
+---@field sortDirection string Sort direction ("asc" or "desc")
+---@field data table The table data as array of row arrays
+---@field columns table List of column definitions with {name, width} properties
+---@field selectedRow number nil Currently selected row index
+---@field scrollOffset number Current scroll position
+---@field customSortFunction table Custom sort functions for columns
+---@field headerColor color Color of the column headers
+---@field gridColor color Color of grid lines
+---@field sortColumn number nil Currently sorted column index
+local Table = {}
+
+---Gets the value of the Data property.
+---@param self Table self
+---@return table {} The table data as array of row arrays
+function Table:getData(self) end
+
+---Gets the value of the Columns property.
+---@param self Table self
+---@return table {} List of column definitions with {name, width} properties
+function Table:getColumns(self) end
+
+---Gets the value of the HeaderColor property.
+---@param self Table self
+---@return color blue Color of the column headers
+function Table:getHeaderColor(self) end
+
+---Sets the value of the GridColor property.
+---@param self Table self
+---@param GridColor color Color of grid lines
+function Table:setGridColor(self, GridColor) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Table:render() end
+
+---Adds a new column to the table
+---@param name string The name of the column
+---@param width number The width of the column
+---@return Table self The Table instance
+function Table:addColumn(name, width) end
+
+---Sets the value of the HeaderColor property.
+---@param self Table self
+---@param HeaderColor color Color of the column headers
+function Table:setHeaderColor(self, HeaderColor) end
+
+---Sets the value of the ScrollOffset property.
+---@param self Table self
+---@param ScrollOffset number Current scroll position
+function Table:setScrollOffset(self, ScrollOffset) end
+
+---Gets the value of the GridColor property.
+---@param self Table self
+---@return color gray Color of grid lines
+function Table:getGridColor(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction (-1 up, 1 down)
+---@param x number The x position of the scroll
+---@param y number The y position of the scroll
+---@return boolean handled Whether the event was handled
+---@protected
+function Table:mouse_scroll(direction, x, y) end
+
+---Gets the value of the ScrollOffset property.
+---@param self Table self
+---@return number 0 Current scroll position
+function Table:getScrollOffset(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Table:mouse_click(button, x, y) end
+
+---Gets the value of the SortDirection property.
+---@param self Table self
+---@return string "asc" Sort direction ("asc" or "desc")
+function Table:getSortDirection(self) end
+
+---Sets the value of the SortDirection property.
+---@param self Table self
+---@param SortDirection string Sort direction ("asc" or "desc")
+function Table:setSortDirection(self, SortDirection) end
+
+---Sorts the table data by column
+---@param columnIndex number The index of the column to sort by
+---@param fn function ? Optional custom sorting function
+---@return Table self The Table instance
+function Table:sortData(columnIndex, fn) end
+
+---Sets the value of the SortColumn property.
+---@param self Table self
+---@param SortColumn number nil Currently sorted column index
+function Table:setSortColumn(self, SortColumn) end
+
+---Sets the value of the SelectedColor property.
+---@param self Table self
+---@param SelectedColor color Background color of selected row
+function Table:setSelectedColor(self, SelectedColor) end
+
+---Sets the value of the SelectedRow property.
+---@param self Table self
+---@param SelectedRow number nil Currently selected row index
+function Table:setSelectedRow(self, SelectedRow) end
+
+---Adds data with both display and sort values
+---@param displayData table The formatted data for display
+---@param sortData table The raw data for sorting (optional)
+---@return Table self The Table instance
+function Table:setFormattedData(displayData, sortData) end
+
+---Sets a custom sort function for a specific column
+---@param columnIndex number The index of the column
+---@param sortFn function Function that takes (rowA, rowB) and returns comparison result
+---@return Table self The Table instance
+function Table:setColumnSortFunction(columnIndex, sortFn) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Table self The initialized instance
+---@protected
+function Table:init(props, basalt) end
+
+---Gets the value of the SelectedRow property.
+---@param self Table self
+---@return number ? nil Currently selected row index
+function Table:getSelectedRow(self) end
+
+---Adds a new row of data to the table
+---@return Table self The Table instance
+function Table:addData() end
+
+---Set data with automatic formatting
+---@param rawData table The raw data array
+---@param formatters table Optional formatter functions for columns {[2] = function(value) return value end}
+---@return Table self The Table instance
+function Table:setData(rawData, formatters) end
+
+---Sets the value of the CustomSortFunction property.
+---@param self Table self
+---@param CustomSortFunction table Custom sort functions for columns
+function Table:setCustomSortFunction(self, CustomSortFunction) end
+
+---Gets the value of the SelectedColor property.
+---@param self Table self
+---@return color lightBlue Background color of selected row
+function Table:getSelectedColor(self) end
+
+---Gets the value of the CustomSortFunction property.
+---@param self Table self
+---@return table {} Custom sort functions for columns
+function Table:getCustomSortFunction(self) end
+
+---Sets the value of the Columns property.
+---@param self Table self
+---@param Columns table List of column definitions with {name, width} properties
+function Table:setColumns(self, Columns) end
+
+---Gets the value of the SortColumn property.
+---@param self Table self
+---@return number ? nil Currently sorted column index
+function Table:getSortColumn(self) end
+
+---@class ThemeAPI
+local ThemeAPI = {}
+
+---Sets the current theme
+---@param newTheme table The theme configuration to set
+function ThemeAPI.setTheme(newTheme) end
+
+---Loads a theme from a JSON file
+---@param path string Path to the theme JSON file
+function ThemeAPI.loadTheme(path) end
+
+---Gets the current theme configuration
+---@return table theme The current theme configuration
+function ThemeAPI.getTheme() end
+
+---@class DropDown : List
+---@field dropSymbol string Indicator for dropdown state
+---@field dropdownHeight number Maximum visible items when expanded
+---@field selectedText string Text shown when no selection made
+local DropDown = {}
+
+---Sets the value of the DropdownHeight property.
+---@param self DropDown self
+---@param DropdownHeight number Maximum visible items when expanded
+function DropDown:setDropdownHeight(self, DropdownHeight) end
+
+---Gets the value of the SelectedText property.
+---@param self DropDown self
+---@return string "" Text shown when no selection made
+function DropDown:getSelectedText(self) end
+
+---Sets the value of the SelectedText property.
+---@param self DropDown self
+---@param SelectedText string Text shown when no selection made
+function DropDown:setSelectedText(self, SelectedText) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function DropDown:mouse_click(button, x, y) end
+
+---Called when the DropDown loses focus
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function DropDown:blur() end
+
+---Gets the value of the DropdownHeight property.
+---@param self DropDown self
+---@return number 5 Maximum visible items when expanded
+function DropDown:getDropdownHeight(self) end
+
+---Called when the DropDown gains focus
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function DropDown:focus() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function DropDown:render() end
+
+---Gets the value of the DropSymbol property.
+---@param self DropDown self
+---@return string "\31" Indicator for dropdown state
+function DropDown:getDropSymbol(self) end
+
+---Sets the value of the DropSymbol property.
+---@param self DropDown self
+---@param DropSymbol string Indicator for dropdown state
+function DropDown:setDropSymbol(self, DropSymbol) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return DropDown self The initialized instance
+---@protected
+function DropDown:init(props, basalt) end
+
+---@class Container : VisualElement
+---@field childrenSorted boolean Indicates if children are sorted by z-index
+---@field childrenEventsSorted boolean Indicates if event handlers are properly sorted
+---@field offsetX number Horizontal scroll/content offset
+---@field focusedChild table Currently focused child element (receives keyboard events)
+---@field visibleChildrenEvents table Event handlers for currently visible children
+---@field visibleChildren table Currently visible child elements (calculated based on viewport)
+---@field childrenEvents table Registered event handlers for all children
+---@field offsetY number Vertical scroll/content offset
+---@field children table Collection of all child elements
+---@field eventListenerCount table Number of listeners per event type
+local Container = {}
+
+---Creates a new LineChart element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return LineChart element A new LineChart element.
+function Container:addLineChart(self, props) end
+
+---Unregisters the children events of the container
+---@param child table The child to unregister events for
+---@return Container self The container instance
+function Container:removeChildrenEvents(child) end
+
+---Creates a new Program element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Program element A new Program element.
+function Container:addProgram(self, props) end
+
+---Removes an element from this container's hierarchy and cleans up its events
+---@param child table The element to remove
+---@return Container self For method chaining
+function Container:removeChild(child) end
+
+---Creates a new ScrollBar element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return ScrollBar element A new ScrollBar element.
+function Container:addScrollBar(self, props) end
+
+---Registers an event handler for a specific child element
+---@param child table The child element to register events for
+---@param eventName string The name of the event to register
+---@return Container self For method chaining
+function Container:registerChildEvent(child, eventName) end
+
+---Creates a new Tree element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Tree element A new Tree element.
+function Container:addTree(self, props) end
+
+---Creates a new Input element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Input element A new Input element.
+function Container:addInput(self, props) end
+
+---Creates a new VisualElement element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return VisualElement element A new VisualElement element.
+function Container:addVisualElement(self, props) end
+
+---Creates a new Switch element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Switch element A new Switch element.
+function Container:addSwitch(self, props) end
+
+---Creates a new Menu element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Menu element A new Menu element.
+function Container:addMenu(self, props) end
+
+---Creates a new Collection element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Collection element A new Collection element.
+function Container:addCollection(self, props) end
+
+---Creates a new BarChart element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return BarChart element A new BarChart element.
+function Container:addBarChart(self, props) end
+
+---Sets the value of the FocusedChild property.
+---@param self Container self
+---@param FocusedChild table Currently focused child element (receives keyboard events)
+function Container:setFocusedChild(self, FocusedChild) end
+
+---Gets the value of the FocusedChild property.
+---@param self Container self
+---@return table nil Currently focused child element (receives keyboard events)
+function Container:getFocusedChild(self) end
+
+---Creates a new Timer element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Timer element A new Timer element.
+function Container:addTimer(self, props) end
+
+---Sets the value of the Children property.
+---@param self Container self
+---@param Children table Collection of all child elements
+function Container:setChildren(self, Children) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function Container:init(props, basalt) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param key number The key that was released
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:key_up(key) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:mouse_click(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to draw the text
+---@param y number The y position to draw the text
+---@param text string The text to draw
+---@param fg color The foreground color of the text
+---@return Container self The container instance
+---@protected
+function Container:textFg(x, y, text, fg) end
+
+---Sets the value of the ChildrenEventsSorted property.
+---@param self Container self
+---@param ChildrenEventsSorted boolean Indicates if event handlers are properly sorted
+function Container:setChildrenEventsSorted(self, ChildrenEventsSorted) end
+
+---Creates a new Container element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Container element A new Container element.
+function Container:addContainer(self, props) end
+
+---Sets the value of the VisibleChildrenEvents property.
+---@param self Container self
+---@param VisibleChildrenEvents table Event handlers for currently visible children
+function Container:setVisibleChildrenEvents(self, VisibleChildrenEvents) end
+
+---Calls a event on all children
+---@param visibleOnly boolean Whether to only call the event on visible children
+---@param event string The event to call
+---@return boolean handled Whether the event was handled
+---@return table ? child The child that handled the event
+function Container:callChildrenEvent(visibleOnly, event) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param char string The character that was pressed
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:char(char) end
+
+---Creates a new List element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return List element A new List element.
+function Container:addList(self, props) end
+
+---Adds a new element to this container's hierarchy
+---@param child table The element to add as a child
+---@return Container self For method chaining
+function Container:addChild(child) end
+
+---Registers the children events of the container
+---@param child table The child to register events for
+---@return Container self The container instance
+function Container:registerChildrenEvents(child) end
+
+---Locates a child element using a path-like syntax (e.g. "panel/button1")
+---@param path string Path to the child (e.g. "panel/button1", "header/title")
+---@return Element ? child The found element or nil if not found
+function Container:getChild(path) end
+
+---Gets the value of the EventListenerCount property.
+---@param self Container self
+---@return table {} Number of listeners per event type
+function Container:getEventListenerCount(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The direction of the scroll
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:mouse_scroll(direction, x, y) end
+
+---Enables debugging for this container and all its children
+---@param self Container The container to debug
+---@param level number The debug level
+function Container.debugChildren(self, level) end
+
+---Stops benchmarking for a container and all its children
+---@param methodName string The method to stop benchmarking
+---@return Container self The container instance
+function Container:stopContainerBenchmark(methodName) end
+
+---Creates a new FlexBox element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return FlexBox element A new FlexBox element.
+function Container:addFlexBox(self, props) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to draw the text
+---@param y number The y position to draw the text
+---@param text string The text to draw
+---@param fg string The foreground color of the text
+---@param bg string The background color of the text
+---@return Container self The container instance
+---@protected
+function Container:blit(x, y, text, fg, bg) end
+
+---Gets the value of the ChildrenEvents property.
+---@param self Container self
+---@return table {} Registered event handlers for all children
+function Container:getChildrenEvents(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to draw the text
+---@param y number The y position to draw the text
+---@param width number The width of the text
+---@param height number The height of the text
+---@param text string The text to draw
+---@param fg string The foreground color of the text
+---@param bg string The background color of the text
+---@return Container self The container instance
+---@protected
+function Container:multiBlit(x, y, width, height, text, fg, bg) end
+
+---Gets the value of the OffsetX property.
+---@param self Container self
+---@return number 0 Horizontal scroll/content offset
+function Container:getOffsetX(self) end
+
+---Gets the value of the VisibleChildren property.
+---@param self Container self
+---@return table {} Currently visible child elements (calculated based on viewport)
+function Container:getVisibleChildren(self) end
+
+---Sets the value of the EventListenerCount property.
+---@param self Container self
+---@param EventListenerCount table Number of listeners per event type
+function Container:setEventListenerCount(self, EventListenerCount) end
+
+---Creates a new TabControl element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return TabControl element A new TabControl element.
+function Container:addTabControl(self, props) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to draw the text
+---@param y number The y position to draw the text
+---@param text string The text to draw
+---@param bg color The background color of the text
+---@return Container self The container instance
+---@protected
+function Container:textBg(x, y, text, bg) end
+
+---Sorts the children events of the container
+---@param eventName string The event name to sort
+---@return Container self The container instance
+function Container:sortChildrenEvents(eventName) end
+
+---Creates a new Graph element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Graph element A new Graph element.
+function Container:addGraph(self, props) end
+
+---Gets the value of the ChildrenEventsSorted property.
+---@param self Container self
+---@return boolean true Indicates if event handlers are properly sorted
+function Container:getChildrenEventsSorted(self) end
+
+---Enables benchmarking for a container and all its children
+---@param methodName string The method to benchmark
+---@return Container self The container instance
+function Container:benchmarkContainer(methodName) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param _ number unknown
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:mouse_move(_, x, y) end
+
+---Creates a new Image element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Image element A new Image element.
+function Container:addImage(self, props) end
+
+---Sets the value of the ChildrenSorted property.
+---@param self Container self
+---@param ChildrenSorted boolean Indicates if children are sorted by z-index
+function Container:setChildrenSorted(self, ChildrenSorted) end
+
+---Sets the value of the OffsetY property.
+---@param self Container self
+---@param OffsetY number Vertical scroll/content offset
+function Container:setOffsetY(self, OffsetY) end
+
+function Container:drawFg() end
+
+---Removes all child elements and resets the container's state
+---@return Container self For method chaining
+function Container:clear() end
+
+---Tests whether a child element is currently visible within the container's viewport
+---@param child table The child element to check
+---@return boolean isVisible Whether the child is within view bounds
+function Container:isChildVisible(child) end
+
+---Creates a new Frame element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Frame element A new Frame element.
+function Container:addFrame(self, props) end
+
+---Creates a new Button element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Button element A new Button element.
+function Container:addButton(self, props) end
+
+---Creates a new TextBox element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return TextBox element A new TextBox element.
+function Container:addTextBox(self, props) end
+
+---Creates a new Slider element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Slider element A new Slider element.
+function Container:addSlider(self, props) end
+
+---Creates a new ProgressBar element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return ProgressBar element A new ProgressBar element.
+function Container:addProgressBar(self, props) end
+
+---Creates a new BaseFrame element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return BaseFrame element A new BaseFrame element.
+function Container:addBaseFrame(self, props) end
+
+---Creates a new ComboBox element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return ComboBox element A new ComboBox element.
+function Container:addComboBox(self, props) end
+
+---Creates a new Display element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Display element A new Display element.
+function Container:addDisplay(self, props) end
+
+---Creates a new DropDown element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return DropDown element A new DropDown element.
+function Container:addDropDown(self, props) end
+
+---Gets the value of the ChildrenSorted property.
+---@param self Container self
+---@return boolean true Indicates if children are sorted by z-index
+function Container:getChildrenSorted(self) end
+
+---Creates a new SideNav element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return SideNav element A new SideNav element.
+function Container:addSideNav(self, props) end
+
+---Creates a new BaseElement element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return BaseElement element A new BaseElement element.
+function Container:addBaseElement(self, props) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param event string The event to handle
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:handleEvent(event) end
+
+---Sets the value of the ChildrenEvents property.
+---@param self Container self
+---@param ChildrenEvents table Registered event handlers for all children
+function Container:setChildrenEvents(self, ChildrenEvents) end
+
+function Container:drawText() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param key number The key that was pressed
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:key(key) end
+
+---Sets the value of the VisibleChildren property.
+---@param self Container self
+---@param VisibleChildren table Currently visible child elements (calculated based on viewport)
+function Container:setVisibleChildren(self, VisibleChildren) end
+
+---Logs benchmark statistics for a container and all its children
+---@param methodName string The method to log
+---@return Container self The container instance
+function Container:logContainerBenchmarks(methodName) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@protected
+function Container:mouse_release(button, x, y) end
+
+---Re-sorts children by their z-index and updates visibility
+---@return Container self For method chaining
+function Container:sortChildren() end
+
+---Creates a new Table element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Table element A new Table element.
+function Container:addTable(self, props) end
+
+---Unregisters the children events of the container
+---@param child table The child to unregister events for
+---@param eventName string The event name to unregister
+---@return Container self The container instance
+function Container:unregisterChildEvent(child, eventName) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Container:render() end
+
+function Container:drawBg() end
+
+---Creates a new Label element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return Label element A new Label element.
+function Container:addLabel(self, props) end
+
+---Gets the value of the OffsetY property.
+---@param self Container self
+---@return number 0 Vertical scroll/content offset
+function Container:getOffsetY(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:mouse_drag(button, x, y) end
+
+---Sets the value of the OffsetX property.
+---@param self Container self
+---@param OffsetX number Horizontal scroll/content offset
+function Container:setOffsetX(self, OffsetX) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Container:mouse_up(button, x, y) end
+
+---Creates a new CheckBox element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return CheckBox element A new CheckBox element.
+function Container:addCheckBox(self, props) end
+
+---Gets the value of the Children property.
+---@param self Container self
+---@return table {} Collection of all child elements
+function Container:getChildren(self) end
+
+---Gets the value of the VisibleChildrenEvents property.
+---@param self Container self
+---@return table {} Event handlers for currently visible children
+function Container:getVisibleChildrenEvents(self) end
+
+---Creates a new BigFont element.
+---@param self Container self
+---@param props? table Optional: properties for the element.
+---@return BigFont element A new BigFont element.
+function Container:addBigFont(self, props) end
+
+---@class Program : VisualElement
+---@field running boolean Whether the program is running
+---@field errorCallback function The error callback function
+---@field doneCallback function The done callback function
+---@field path string The path to the program
+---@field program table The program instance
+local Program = {}
+
+---Gets the value of the ErrorCallback property.
+---@param self Program self
+---@return function nil The error callback function
+function Program:getErrorCallback(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param event string The event to handle
+---@return any result The event result
+---@protected
+function Program:dispatchEvent(event) end
+
+---Stops the program
+---@return Program self The Program instance
+function Program:stop() end
+
+---Registers a callback for the program's done event
+---@param fn function The callback function to register
+---@return Program self The Program instance
+function Program:onDone(fn) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Program self The initialized instance
+---@protected
+function Program:init(props, basalt) end
+
+---Executes a program
+---@param path string The path to the program
+---@return Program self The Program instance
+function Program:execute(path) end
+
+---Gets the value of the Running property.
+---@param self Program self
+---@return boolean false Whether the program is running
+function Program:getRunning(self) end
+
+---Sets the value of the DoneCallback property.
+---@param self Program self
+---@param DoneCallback function The done callback function
+function Program:setDoneCallback(self, DoneCallback) end
+
+---Sets the value of the ErrorCallback property.
+---@param self Program self
+---@param ErrorCallback function The error callback function
+function Program:setErrorCallback(self, ErrorCallback) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Program:render() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Program:focus() end
+
+---Sets the value of the Program property.
+---@param self Program self
+---@param Program table The program instance
+function Program:setProgram(self, Program) end
+
+---Gets the value of the Path property.
+---@param self Program self
+---@return string "" The path to the program
+function Program:getPath(self) end
+
+---Registers a callback for the program's error event, if the function returns false, the program won't stop
+---@param fn function The callback function to register
+---@return Program self The Program instance
+function Program:onError(fn) end
+
+---Sets the value of the Path property.
+---@param self Program self
+---@param Path string The path to the program
+function Program:setPath(self, Path) end
+
+---Sets the value of the Running property.
+---@param self Program self
+---@param Running boolean Whether the program is running
+function Program:setRunning(self, Running) end
+
+---Sends an event to the program
+---@param event string The event to send
+---@return Program self The Program instance
+function Program:sendEvent(event) end
+
+---Gets the value of the DoneCallback property.
+---@param self Program self
+---@return function nil The done callback function
+function Program:getDoneCallback(self) end
+
+function BasaltProgram:setArgs() end
+
+---Gets the value of the Program property.
+---@param self Program self
+---@return table nil The program instance
+function Program:getProgram(self) end
+
+---@class ElementManager
+local ElementManager = {}
+
+---Gets an Plugin API by name
+---@param name string The name of the API to get
+---@return table API The API
+function ElementManager.getAPI(name) end
+
+---Loads an element by name. This will load the element and apply any plugins to it.
+---@param name string The name of the element to load
+function ElementManager.loadElement(name) end
+
+---Checks if an element exists (is registered)
+---@param name string The element name
+---@return boolean exists Whether the element exists
+function ElementManager.hasElement(name) end
+
+---Registers a disk mount point for loading elements
+---@param mountPath string The path to the disk mount
+function ElementManager.registerDiskMount(mountPath) end
+
+---Preloads elements into the global cache
+---@param elementNames table List of element names to preload
+function ElementManager.preloadElements(elementNames) end
+
+---Gets cache statistics
+---@return table stats Cache statistics with size and element names
+function ElementManager.getCacheStats() end
+
+---Clears the global cache (_G)
+function ElementManager.clearGlobalCache() end
+
+---Checks if an element is loaded
+---@param name string The element name
+---@return boolean loaded Whether the element is loaded
+function ElementManager.isElementLoaded(name) end
+
+---Gets a list of all elements
+---@return table ElementList A list of all elements
+function ElementManager.getElementList() end
+
+---Registers a remote source for an element
+---@param elementName string The name of the element
+---@param url string The URL to load the element from
+function ElementManager.registerRemoteSource(elementName, url) end
+
+---Tries to load an element from any available source
+---@param name string The element name
+---@return boolean success Whether the element was loaded
+function ElementManager.tryAutoLoad(name) end
+
+---Configures the ElementManager
+---@param config table Configuration options
+function ElementManager.configure(config) end
+
+---Gets an element by name. If the element is not loaded, it will try to load it first.
+---@param name string The name of the element to get
+---@return table Element The element class
+function ElementManager.getElement(name) end
+
+---@class Frame : Container
+---@field draggingMap table The map of dragging positions
+---@field scrollable boolean Whether the frame is scrollable
+---@field draggable boolean Whether the frame is draggable
+local Frame = {}
+
+---Sets the value of the Scrollable property.
+---@param self Frame self
+---@param Scrollable boolean Whether the frame is scrollable
+function Frame:setScrollable(self, Scrollable) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@return number height The total height needed for all children
+---@protected
+function Frame:getChildrenHeight() end
+
+---Gets the value of the DraggingMap property.
+---@param self Frame self
+---@return table {} The map of dragging positions
+function Frame:getDraggingMap(self) end
+
+---Gets the value of the Draggable property.
+---@param self Frame self
+---@return boolean false Whether the frame is draggable
+function Frame:getDraggable(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction
+---@param x number The x position of the scroll
+---@param y number The y position of the scroll
+---@return boolean handled Whether the event was handled
+---@protected
+function Frame:mouse_scroll(direction, x, y) end
+
+---Gets the value of the Scrollable property.
+---@param self Frame self
+---@return boolean false Whether the frame is scrollable
+function Frame:getScrollable(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the drag position
+---@param y number The y position of the drag position
+---@return boolean handled Whether the event was handled
+---@protected
+function Frame:mouse_drag(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Frame self The initialized instance
+---@protected
+function Frame:init(props, basalt) end
+
+---Sets the value of the DraggingMap property.
+---@param self Frame self
+---@param DraggingMap table The map of dragging positions
+function Frame:setDraggingMap(self, DraggingMap) end
+
+---Sets the value of the Draggable property.
+---@param self Frame self
+---@param Draggable boolean Whether the frame is draggable
+function Frame:setDraggable(self, Draggable) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Frame:mouse_click(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was released
+---@param x number The x position of the release
+---@param y number The y position of the release
+---@return boolean handled Whether the event was handled
+---@protected
+function Frame:mouse_up(button, x, y) end
+
+---@class Switch : VisualElement
+---@field text string to display next to switch
+---@field autoSize boolean to automatically size the element to fit switch and text
+---@field onBackground number color when ON
+---@field offBackground number color when OFF
+---@field checked boolean switch is checked
+local Switch = {}
+
+---Gets the value of the Text property.
+---@param self Switch self
+---@return string Text to display next to switch
+function Switch:getText(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Switch:render() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean Whether the event was handled
+---@protected
+function Switch:mouse_click(button, x, y) end
+
+---Sets the value of the Text property.
+---@param self Switch self
+---@param Text string to display next to switch
+function Switch:setText(self, Text) end
+
+---Gets the value of the OnBackground property.
+---@param self Switch self
+---@return number Background color when ON
+function Switch:getOnBackground(self) end
+
+---Sets the value of the OffBackground property.
+---@param self Switch self
+---@param OffBackground number color when OFF
+function Switch:setOffBackground(self, OffBackground) end
+
+---Gets the value of the Checked property.
+---@param self Switch self
+---@return boolean Whether switch is checked
+function Switch:getChecked(self) end
+
+---Gets the value of the OffBackground property.
+---@param self Switch self
+---@return number Background color when OFF
+function Switch:getOffBackground(self) end
+
+---Sets the value of the AutoSize property.
+---@param self Switch self
+---@param AutoSize boolean to automatically size the element to fit switch and text
+function Switch:setAutoSize(self, AutoSize) end
+
+---Sets the value of the Checked property.
+---@param self Switch self
+---@param Checked boolean switch is checked
+function Switch:setChecked(self, Checked) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function Switch:init(props, basalt) end
+
+---Sets the value of the OnBackground property.
+---@param self Switch self
+---@param OnBackground number color when ON
+function Switch:setOnBackground(self, OnBackground) end
+
+---Gets the value of the AutoSize property.
+---@param self Switch self
+---@return boolean Whether to automatically size the element to fit switch and text
+function Switch:getAutoSize(self) end
+
+---@class SideNav : Container
+---@field sidebarWidth number Width of the sidebar navigation area
+---@field activeTab number The currently active navigation item ID
+---@field tabs table List of navigation item definitions
+---@field sidebarPosition string Position of the sidebar ("left" or "right")
+---@field sidebarScrollOffset number Current scroll offset for navigation items in scrollable mode
+---@field activeTabTextColor color Foreground color for the active navigation item text
+---@field activeTabBackground color Background color for the active navigation item
+---@field sidebarBackground color Background color for the sidebar area
+local SideNav = {}
+
+---Gets the value of the SidebarWidth property.
+---@param self SideNav self
+---@return number 12 Width of the sidebar navigation area
+function SideNav:getSidebarWidth(self) end
+
+function SideNav:multiBlit() end
+
+---Sets the value of the SidebarScrollOffset property.
+---@param self SideNav self
+---@param SidebarScrollOffset number Current scroll offset for navigation items in scrollable mode
+function SideNav:setSidebarScrollOffset(self, SidebarScrollOffset) end
+
+---Sets the value of the ActiveTabTextColor property.
+---@param self SideNav self
+---@param ActiveTabTextColor color Foreground color for the active navigation item text
+function SideNav:setActiveTabTextColor(self, ActiveTabTextColor) end
+
+---Gets the value of the ActiveTabBackground property.
+---@param self SideNav self
+---@return color white Background color for the active navigation item
+function SideNav:getActiveTabBackground(self) end
+
+function SideNav:mouse_move() end
+
+---Sets the value of the SidebarBackground property.
+---@param self SideNav self
+---@param SidebarBackground color Background color for the sidebar area
+function SideNav:setSidebarBackground(self, SidebarBackground) end
+
+function SideNav:drawBg() end
+
+---Gets the value of the Tabs property.
+---@param self SideNav self
+---@return table {} List of navigation item definitions
+function SideNav:getTabs(self) end
+
+---Sets the value of the ActiveTabBackground property.
+---@param self SideNav self
+---@param ActiveTabBackground color Background color for the active navigation item
+function SideNav:setActiveTabBackground(self, ActiveTabBackground) end
+
+---@param element table The element to assign to a navigation item
+---@param tabId number The ID of the navigation item to assign the element to
+---@return SideNav self For method chaining
+function SideNav:setTab(element, tabId) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click (global)
+---@param y number The y position of the click (global)
+---@return boolean Whether the event was handled
+---@protected
+function SideNav:mouse_click(button, x, y) end
+
+---Gets the value of the SidebarPosition property.
+---@param self SideNav self
+---@return string left Position of the sidebar ("left" or "right")
+function SideNav:getSidebarPosition(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param child table The child element to add
+---@return Container self For method chaining
+---@protected
+function SideNav:addChild(child) end
+
+---Sets the value of the Tabs property.
+---@param self SideNav self
+---@param Tabs table List of navigation item definitions
+function SideNav:setTabs(self, Tabs) end
+
+---Gets the value of the SidebarScrollOffset property.
+---@param self SideNav self
+---@return number 0 Current scroll offset for navigation items in scrollable mode
+function SideNav:getSidebarScrollOffset(self) end
+
+function SideNav:mouse_scroll() end
+
+---Gets the value of the SidebarBackground property.
+---@param self SideNav self
+---@return color gray Background color for the sidebar area
+function SideNav:getSidebarBackground(self) end
+
+function SideNav:textFg() end
+
+---@param elementType string The type of element to add
+---@param tabId number Optional navigation item ID, defaults to active item
+---@return table element The created element
+function SideNav:addElement(elementType, tabId) end
+
+---Gets the value of the ActiveTabTextColor property.
+---@param self SideNav self
+---@return color black Foreground color for the active navigation item text
+function SideNav:getActiveTabTextColor(self) end
+
+---returns a proxy for adding elements to the navigation item
+---@param title string The title of the navigation item
+---@return table tabHandler The navigation item handler proxy for adding elements
+function SideNav:newTab(title) end
+
+function SideNav:textBg() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function SideNav:render() end
+
+function SideNav:mouse_up() end
+
+function SideNav:setCursor() end
+
+---Scrolls the sidebar up or down
+---@param direction number -1 to scroll up, 1 to scroll down
+---@return SideNav self For method chaining
+function SideNav:scrollSidebar(direction) end
+
+function SideNav:getRelativePosition() end
+
+function SideNav:mouse_drag() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function SideNav:init(props, basalt) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@return number xOffset The X offset for content
+---@protected
+function SideNav:getContentXOffset() end
+
+---Sets the value of the SidebarWidth property.
+---@param self SideNav self
+---@param SidebarWidth number Width of the sidebar navigation area
+function SideNav:setSidebarWidth(self, SidebarWidth) end
+
+---Gets the value of the ActiveTab property.
+---@param self SideNav self
+---@return number nil The currently active navigation item ID
+function SideNav:getActiveTab(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function SideNav:sortChildrenEvents() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param child table The child element to check
+---@return boolean Whether the child should be visible
+---@protected
+function SideNav:isChildVisible(child) end
+
+function SideNav:mouse_release() end
+
+---@param tabId number The ID of the navigation item to activate
+function SideNav:setActiveTab(tabId) end
+
+function SideNav:blit() end
+
+function SideNav:drawText() end
+
+function SideNav:_getSidebarMetrics() end
+
+---Sets the value of the SidebarPosition property.
+---@param self SideNav self
+---@param SidebarPosition string Position of the sidebar ("left" or "right")
+function SideNav:setSidebarPosition(self, SidebarPosition) end
+
+function SideNav:drawFg() end
+
+---@class Tree : VisualElement
+---@field nodes table The tree structure containing node objects with {text, children} properties
+---@field selectedNode table nil Currently selected node
+---@field selectedBackgroundColor color background color of selected node
+---@field scrollOffset number Current vertical scroll position
+---@field expandedNodes table Table of nodes that are currently expanded
+---@field selectedForegroundColor color foreground color of selected node
+---@field horizontalOffset number Current horizontal scroll position
+local Tree = {}
+
+---Gets the value of the Nodes property.
+---@param self Tree self
+---@return table {} The tree structure containing node objects with {text, children} properties
+function Tree:getNodes(self) end
+
+---Gets the size of the tree
+---@return number width The width of the tree
+---@return number height The height of the tree
+function Tree:getNodeSize() end
+
+---Toggles a node's expanded state
+---@param node table The node to toggle
+---@return Tree self The Tree instance
+function Tree:toggleNode(node) end
+
+---Gets the value of the ScrollOffset property.
+---@param self Tree self
+---@return number 0 Current vertical scroll position
+function Tree:getScrollOffset(self) end
+
+---Expands a node
+---@param node table The node to expand
+---@return Tree self The Tree instance
+function Tree:expandNode(node) end
+
+---Sets the value of the ExpandedNodes property.
+---@param self Tree self
+---@param ExpandedNodes table Table of nodes that are currently expanded
+function Tree:setExpandedNodes(self, ExpandedNodes) end
+
+---Gets the value of the SelectedForegroundColor property.
+---@param self Tree self
+---@return color white foreground color of selected node
+function Tree:getSelectedForegroundColor(self) end
+
+---Sets the value of the HorizontalOffset property.
+---@param self Tree self
+---@param HorizontalOffset number Current horizontal scroll position
+function Tree:setHorizontalOffset(self, HorizontalOffset) end
+
+---Gets the value of the HorizontalOffset property.
+---@param self Tree self
+---@return number 0 Current horizontal scroll position
+function Tree:getHorizontalOffset(self) end
+
+---Gets the value of the ExpandedNodes property.
+---@param self Tree self
+---@return table {} Table of nodes that are currently expanded
+function Tree:getExpandedNodes(self) end
+
+---Sets the value of the SelectedBackgroundColor property.
+---@param self Tree self
+---@param SelectedBackgroundColor color background color of selected node
+function Tree:setSelectedBackgroundColor(self, SelectedBackgroundColor) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Tree:render() end
+
+---Sets the value of the Nodes property.
+---@param self Tree self
+---@param Nodes table The tree structure containing node objects with {text, children} properties
+function Tree:setNodes(self, Nodes) end
+
+---Sets the value of the SelectedForegroundColor property.
+---@param self Tree self
+---@param SelectedForegroundColor color foreground color of selected node
+function Tree:setSelectedForegroundColor(self, SelectedForegroundColor) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction (1 for up, -1 for down)
+---@param x number The x position of the scroll
+---@param y number The y position of the scroll
+---@return boolean handled Whether the event was handled
+---@protected
+function Tree:mouse_scroll(direction, x, y) end
+
+---Sets the value of the ScrollOffset property.
+---@param self Tree self
+---@param ScrollOffset number Current vertical scroll position
+function Tree:setScrollOffset(self, ScrollOffset) end
+
+---Initializes the Tree instance
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Tree self The initialized instance
+---@protected
+function Tree:init(props, basalt) end
+
+---Handles mouse click events
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean handled Whether the event was handled
+---@protected
+function Tree:mouse_click(button, x, y) end
+
+---Registers a callback for when a node is selected
+---@param callback function The callback function
+---@return Tree self The Tree instance
+function Tree:onSelect(callback) end
+
+---Gets the value of the SelectedNode property.
+---@param self Tree self
+---@return table ? nil Currently selected node
+function Tree:getSelectedNode(self) end
+
+---Collapses a node
+---@param node table The node to collapse
+---@return Tree self The Tree instance
+function Tree:collapseNode(node) end
+
+---Gets the value of the SelectedBackgroundColor property.
+---@param self Tree self
+---@return color lightBlue background color of selected node
+function Tree:getSelectedBackgroundColor(self) end
+
+---Sets the value of the SelectedNode property.
+---@param self Tree self
+---@param SelectedNode table nil Currently selected node
+function Tree:setSelectedNode(self, SelectedNode) end
+
+---@class Graph : VisualElement
+---@field maxValue number The maximum value of the graph
+---@field series table The series of the graph
+---@field minValue number The minimum value of the graph
+local Graph = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Graph:render() end
+
+---Clears all points from a series
+---@return Graph self The graph instance
+function Graph:clear() end
+
+---@param name string The name of the series
+---@return table ? series The series
+function Graph:getSeries(name) end
+
+---Gets the value of the MaxValue property.
+---@param self Graph self
+---@return number 100 The maximum value of the graph
+function Graph:getMaxValue(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Graph self The initialized instance
+---@protected
+function Graph:init(props, basalt) end
+
+---@param name string The name of the series
+---@param visible boolean Whether the series should be visible
+---@return Graph self The graph instance
+function Graph:changeSeriesVisibility(name, visible) end
+
+---@param name string The name of the series
+---@return Graph self The graph instance
+function Graph:focusSeries(name) end
+
+---@param name string The name of the series
+---@param value number The value of the point
+---@return Graph self The graph instance
+function Graph:addPoint(name, value) end
+
+---@param name string The name of the series
+---@param symbol string The symbol of the series
+---@param bgCol number The background color of the series
+---@param fgCol number The foreground color of the series
+---@param pointCount number The number of points in the series
+---@return Graph self The graph instance
+function Graph:addSeries(name, symbol, bgCol, fgCol, pointCount) end
+
+---Gets the value of the MinValue property.
+---@param self Graph self
+---@return number 0 The minimum value of the graph
+function Graph:getMinValue(self) end
+
+---Sets the value of the MaxValue property.
+---@param self Graph self
+---@param MaxValue number The maximum value of the graph
+function Graph:setMaxValue(self, MaxValue) end
+
+---@param name string The name of the series
+---@return Graph self The graph instance
+function Graph:removeSeries(name) end
+
+---Sets the value of the MinValue property.
+---@param self Graph self
+---@param MinValue number The minimum value of the graph
+function Graph:setMinValue(self, MinValue) end
+
+---@param name string The name of the series
+---@param count number The number of points in the series
+---@return Graph self The graph instance
+function Graph:setSeriesPointCount(name, count) end
+
+---Sets the value of the Series property.
+---@param self Graph self
+---@param Series table The series of the graph
+function Graph:setSeries(self, Series) end
+
+---@class FlexBox : Container
+---@field flexWrap boolean Whether to wrap flex items onto multiple lines
+---@field flexSpacing number The spacing between flex items
+---@field flexCrossPadding number The padding on both sides of the cross axis
+---@field flexAlignItems string The alignment of flex items along the cross axis
+---@field flexJustifyContent string The alignment of flex items along the main axis
+---@field flexUpdateLayout boolean Whether to update the layout of the flexbox
+---@field flexDirection string The direction of the flexbox layout "row" or "column"
+local FlexBox = {}
+
+---Gets the value of the FlexUpdateLayout property.
+---@param self FlexBox self
+---@return boolean false Whether to update the layout of the flexbox
+function FlexBox:getFlexUpdateLayout(self) end
+
+---Gets the value of the FlexJustifyContent property.
+---@param self FlexBox self
+---@return string "flex-start" The alignment of flex items along the main axis
+function FlexBox:getFlexJustifyContent(self) end
+
+---Gets the value of the FlexWrap property.
+---@param self FlexBox self
+---@return boolean false Whether to wrap flex items onto multiple lines
+function FlexBox:getFlexWrap(self) end
+
+---Gets the value of the FlexAlignItems property.
+---@param self FlexBox self
+---@return string "flex-start" The alignment of flex items along the cross axis
+function FlexBox:getFlexAlignItems(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param element Element The child element to remove
+---@return FlexBox self The flexbox instance
+---@protected
+function FlexBox:removeChild(element) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return FlexBox self The initialized instance
+---@protected
+function FlexBox:init(props, basalt) end
+
+---Adds a child element to the flexbox
+---@param element Element The child element to add
+---@return FlexBox self The flexbox instance
+function FlexBox:addChild(element) end
+
+---Sets the value of the FlexUpdateLayout property.
+---@param self FlexBox self
+---@param FlexUpdateLayout boolean Whether to update the layout of the flexbox
+function FlexBox:setFlexUpdateLayout(self, FlexUpdateLayout) end
+
+---Sets the value of the FlexAlignItems property.
+---@param self FlexBox self
+---@param FlexAlignItems string The alignment of flex items along the cross axis
+function FlexBox:setFlexAlignItems(self, FlexAlignItems) end
+
+---Sets the value of the FlexWrap property.
+---@param self FlexBox self
+---@param FlexWrap boolean Whether to wrap flex items onto multiple lines
+function FlexBox:setFlexWrap(self, FlexWrap) end
+
+---Sets the value of the FlexJustifyContent property.
+---@param self FlexBox self
+---@param FlexJustifyContent string The alignment of flex items along the main axis
+function FlexBox:setFlexJustifyContent(self, FlexJustifyContent) end
+
+---Gets the value of the FlexDirection property.
+---@param self FlexBox self
+---@return string "row" The direction of the flexbox layout "row" or "column"
+function FlexBox:getFlexDirection(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function FlexBox:render() end
+
+---Gets the value of the FlexCrossPadding property.
+---@param self FlexBox self
+---@return number 0 The padding on both sides of the cross axis
+function FlexBox:getFlexCrossPadding(self) end
+
+---Adds a new line break to the flexbox
+---@param self FlexBox The element itself
+---@return FlexBox 
+function FlexBox:addLineBreak(self) end
+
+---Sets the value of the FlexCrossPadding property.
+---@param self FlexBox self
+---@param FlexCrossPadding number The padding on both sides of the cross axis
+function FlexBox:setFlexCrossPadding(self, FlexCrossPadding) end
+
+---Gets the value of the FlexSpacing property.
+---@param self FlexBox self
+---@return number 1 The spacing between flex items
+function FlexBox:getFlexSpacing(self) end
+
+---Sets the value of the FlexSpacing property.
+---@param self FlexBox self
+---@param FlexSpacing number The spacing between flex items
+function FlexBox:setFlexSpacing(self, FlexSpacing) end
+
+---Sets the value of the FlexDirection property.
+---@param self FlexBox self
+---@param FlexDirection string The direction of the flexbox layout "row" or "column"
+function FlexBox:setFlexDirection(self, FlexDirection) end
+
+---@class CheckBox : VisualElement
+---@field checkedText string Text shown when the checkbox is checked
+---@field checked boolean The current state of the checkbox (true=checked, false=unchecked)
+---@field text string Text shown when the checkbox is unchecked
+---@field autoSize boolean Automatically adjusts width based on text length
+local CheckBox = {}
+
+---Sets the value of the Text property.
+---@param self CheckBox self
+---@param Text string Text shown when the checkbox is unchecked
+function CheckBox:setText(self, Text) end
+
+---Gets the value of the Text property.
+---@param self CheckBox self
+---@return string empty Text shown when the checkbox is unchecked
+function CheckBox:getText(self) end
+
+---Sets the value of the CheckedText property.
+---@param self CheckBox self
+---@param CheckedText string Text shown when the checkbox is checked
+function CheckBox:setCheckedText(self, CheckedText) end
+
+---Gets the value of the Checked property.
+---@param self CheckBox self
+---@return boolean false The current state of the checkbox (true=checked, false=unchecked)
+function CheckBox:getChecked(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function CheckBox:init(props, basalt) end
+
+---Sets the value of the AutoSize property.
+---@param self CheckBox self
+---@param AutoSize boolean Automatically adjusts width based on text length
+function CheckBox:setAutoSize(self, AutoSize) end
+
+---Sets the value of the Checked property.
+---@param self CheckBox self
+---@param Checked boolean The current state of the checkbox (true=checked, false=unchecked)
+function CheckBox:setChecked(self, Checked) end
+
+---Gets the value of the CheckedText property.
+---@param self CheckBox self
+---@return string x Text shown when the checkbox is checked
+function CheckBox:getCheckedText(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function CheckBox:render() end
+
+---Handles mouse interactions to toggle the checkbox state
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean Clicked Whether the event was handled
+---@protected
+function CheckBox:mouse_click(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@return CheckBox self The created instance
+---@protected
+function CheckBox.new() end
+
+---Gets the value of the AutoSize property.
+---@param self CheckBox self
+---@return boolean true Automatically adjusts width based on text length
+function CheckBox:getAutoSize(self) end
+
+---@class Image : VisualElement
+---@field autoResize boolean Whether to automatically resize the image when content exceeds bounds
+---@field offsetY number Vertical offset for viewing larger images
+---@field currentFrame number Current animation frame
+---@field offsetX number Horizontal offset for viewing larger images
+---@field bimg table The bimg image data
+local Image = {}
+
+---Sets the metadata of the image
+---@param key string The key of the metadata to set
+---@param value string The value of the metadata to set
+---@return Image self The Image instance
+function Image:setMetadata(key, value) end
+
+---Sets the text at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param text string The text to set
+---@return Image self The Image instance
+function Image:setText(x, y, text) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Image:render() end
+
+---Sets the value of the CurrentFrame property.
+---@param self Image self
+---@param CurrentFrame number Current animation frame
+function Image:setCurrentFrame(self, CurrentFrame) end
+
+---Gets the value of the Bimg property.
+---@param self Image self
+---@return table {} The bimg image data
+function Image:getBimg(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Image self The initialized instance
+---@protected
+function Image:init(props, basalt) end
+
+---Resizes the image to the specified width and height
+---@param width number The new width of the image
+---@param height number The new height of the image
+---@return Image self The Image instance
+function Image:resizeImage(width, height) end
+
+---Gets pixel information at position
+---@param x number X position
+---@param y number Y position
+---@return number ? fg Foreground color
+---@return number ? bg Background color
+---@return string ? char Character at position
+function Image:getPixelData(x, y) end
+
+---Sets the value of the OffsetY property.
+---@param self Image self
+---@param OffsetY number Vertical offset for viewing larger images
+function Image:setOffsetY(self, OffsetY) end
+
+---Gets the value of the AutoResize property.
+---@param self Image self
+---@return boolean false Whether to automatically resize the image when content exceeds bounds
+function Image:getAutoResize(self) end
+
+---Gets the value of the CurrentFrame property.
+---@param self Image self
+---@return number 1 Current animation frame
+function Image:getCurrentFrame(self) end
+
+---Gets the metadata of the image
+---@return table metadata The metadata of the image
+function Image:getMetadata() end
+
+---Advances to the next frame in the animation
+---@return Image self The Image instance
+function Image:nextFrame() end
+
+---Sets the value of the AutoResize property.
+---@param self Image self
+---@param AutoResize boolean Whether to automatically resize the image when content exceeds bounds
+function Image:setAutoResize(self, AutoResize) end
+
+---Sets the foreground color at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param pattern string The foreground color pattern
+---@return Image self The Image instance
+function Image:setFg(x, y, pattern) end
+
+---Gets the specified frame
+---@param frameIndex number The index of the frame to get
+---@return table frame The frame data
+function Image:getFrame(frameIndex) end
+
+---Updates the specified frame with the provided data
+---@param frameIndex number The index of the frame to update
+---@param frame table The new frame data
+---@return Image self The Image instance
+function Image:updateFrame(frameIndex, frame) end
+
+---Adds a new frame to the image
+---@return Image self The Image instance
+function Image:addFrame() end
+
+---Sets the value of the OffsetX property.
+---@param self Image self
+---@param OffsetX number Horizontal offset for viewing larger images
+function Image:setOffsetX(self, OffsetX) end
+
+---Sets the pixel at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param char string The character to set
+---@param fg string The foreground color pattern
+---@param bg string The background color pattern
+---@return Image self The Image instance
+function Image:setPixel(x, y, char, fg, bg) end
+
+---Gets the size of the image
+---@return number width The width of the image
+---@return number height The height of the image
+function Image:getImageSize() end
+
+---Gets the value of the OffsetY property.
+---@param self Image self
+---@return number 0 Vertical offset for viewing larger images
+function Image:getOffsetY(self) end
+
+---Gets the background color at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param length number The length of the background color pattern to get
+---@return string bg The background color pattern
+function Image:getBg(x, y, length) end
+
+---Gets the text at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param length number The length of the text to get
+---@return string text The text at the specified position
+function Image:getText(x, y, length) end
+
+---Sets the background color at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param pattern string The background color pattern
+---@return Image self The Image instance
+function Image:setBg(x, y, pattern) end
+
+---Gets the value of the OffsetX property.
+---@param self Image self
+---@return number 0 Horizontal offset for viewing larger images
+function Image:getOffsetX(self) end
+
+---Gets the foreground color at the specified position
+---@param x number The x position
+---@param y number The y position
+---@param length number The length of the foreground color pattern to get
+---@return string fg The foreground color pattern
+function Image:getFg(x, y, length) end
+
+---Sets the value of the Bimg property.
+---@param self Image self
+---@param Bimg table The bimg image data
+function Image:setBimg(self, Bimg) end
+
+---@class PropertySystem
+local PropertySystem = {}
+
+---Combines multiple properties into a single getter and setter
+---@param class table The element class to combine the properties for
+---@param name string The name of the combined property
+function PropertySystem.combineProperties(class, name) end
+
+---Removes an observer from a property
+---@param name string The name of the property
+---@param callback function The callback function to remove
+---@return table self The PropertySystem
+function PropertySystem:removeObserver(name, callback) end
+
+---Defines a property for an element class
+---@param class table The element class to define the property for
+---@param name string The name of the property
+---@param config table The configuration of the property
+function PropertySystem.defineProperty(class, name, config) end
+
+---Gets a property configuration
+---@param name string The name of the property
+---@return table config The configuration of the property
+function PropertySystem:getPropertyConfig(name) end
+
+---Adds a setter hook to the PropertySystem. Setter hooks are functions that are called before a property is set.
+---@param hook function The hook function to add
+function PropertySystem.addSetterHook(hook) end
+
+---Removes a property from the PropertySystem on instance level
+---@param name string The name of the property
+---@return table self The PropertySystem
+function PropertySystem:removeProperty(name) end
+
+---Adds a property to the PropertySystem on instance level
+---@param name string The name of the property
+---@param config table The configuration of the property
+---@return table self The PropertySystem
+function PropertySystem:instanceProperty(name, config) end
+
+---Removes all observers from a property
+---@return table self The PropertySystem
+function PropertySystem:removeAllObservers() end
+
+---Initializes the PropertySystem IS USED INTERNALLY
+---@return table self The PropertySystem
+function PropertySystem:__init() end
+
+---Creates an element from a blueprint
+---@param elementClass table The element class to create from the blueprint
+---@param blueprint table The blueprint to create the element from
+---@return table element The created element
+function PropertySystem.createFromBlueprint(elementClass, blueprint) end
+
+---Creates a blueprint of an element class with all its properties
+---@param elementClass table The element class to create a blueprint from
+---@return table blueprint A table containing all property definitions
+function PropertySystem.blueprint(elementClass) end
+
+---Observers a property
+---@param name string The name of the property
+---@param callback function The callback function to call when the property changes
+---@return table self The PropertySystem
+function PropertySystem:observe(name, callback) end
+
+---Update call for a property IS USED INTERNALLY
+---@param name string The name of the property
+---@param value any The value of the property
+---@return table self The PropertySystem
+function PropertySystem:_updateProperty(name, value) end
+
+---@class Label : VisualElement
+---@field text string The text content to display. Can be a string or a function that returns a string
+---@field autoSize boolean Whether the label should automatically resize its width based on the text content
+local Label = {}
+
+---Gets the value of the AutoSize property.
+---@param self Label self
+---@return boolean true Whether the label should automatically resize its width based on the text content
+function Label:getAutoSize(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Label:render() end
+
+---Gets the wrapped lines of the Label
+---@return table wrappedText The wrapped lines of the Label
+function Label:getWrappedText() end
+
+---Sets the value of the Text property.
+---@param self Label self
+---@param Text string The text content to display. Can be a string or a function that returns a string
+function Label:setText(self, Text) end
+
+---Gets the value of the Text property.
+---@param self Label self
+---@return string Label The text content to display. Can be a string or a function that returns a string
+function Label:getText(self) end
+
+---Sets the value of the AutoSize property.
+---@param self Label self
+---@param AutoSize boolean Whether the label should automatically resize its width based on the text content
+function Label:setAutoSize(self, AutoSize) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Label self The initialized instance
+---@protected
+function Label:init(props, basalt) end
+
+---@class Display : VisualElement
+local Display = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Display:render() end
+
+---Retrieves the underlying ComputerCraft window object
+---@return table window A CC window object with all standard terminal methods
+function Display:getWindow() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function Display:init(props, basalt) end
+
+---Writes text directly to the display with optional colors
+---@param x number X position (1-based)
+---@param y number Y position (1-based)
+---@param text string Text to write
+---@return Display self For method chaining
+function Display:write(x, y, text) end
+
+---@class List : Collection
+---@field offset number Current scroll offset for viewing long lists
+local List = {}
+
+---Registers a callback for the select event
+---@param callback function The callback function to register
+---@return List self The List instance
+function List:onSelect(callback) end
+
+---Scrolls the list to the bottom
+---@return List self The List instance
+function List:scrollToBottom() end
+
+---Gets the value of the Offset property.
+---@param self List self
+---@return number 0 Current scroll offset for viewing long lists
+function List:getOffset(self) end
+
+---Scrolls the list to the top
+---@return List self The List instance
+function List:scrollToTop() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function List:render() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return List self The initialized instance
+---@protected
+function List:init(props, basalt) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The direction of the scroll (1 for down, -1 for up)
+---@param x number The x-coordinate of the scroll
+---@param y number The y-coordinate of the scroll
+---@return boolean Whether the event was handled
+---@protected
+function List:mouse_scroll(direction, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button that was clicked
+---@param x number The x-coordinate of the click
+---@param y number The y-coordinate of the click
+---@return boolean Whether the event was handled
+---@protected
+function List:mouse_click(button, x, y) end
+
+---Sets the value of the Offset property.
+---@param self List self
+---@param Offset number Current scroll offset for viewing long lists
+function List:setOffset(self, Offset) end
+
+---Registers a function to handle the onSelect event.
+---@param index number
+---@param item table
+---@param self List self
+---@param func function The function to be called when the event fires
+function List:onOnSelect(self, func) end
+
 ---@class BarChart : Graph
 local BarChart = {}
 
@@ -15,1692 +2714,152 @@ function BarChart:init(props, basalt) end
 ---@protected
 function BarChart:render() end
 
----@class Reactive
-local Reactive = {}
+---@class ComboBox : DropDown
+---@field placeholderColor color Color used for placeholder text
+---@field cursorPos number Current cursor position in the text input
+---@field text string The current text value of the input field
+---@field autoComplete boolean Enables filtering dropdown items while typing
+---@field manuallyOpened boolean Indicates if dropdown was opened by user action
+---@field editable boolean Enables direct text input in the field
+---@field viewOffset number Horizontal scroll position for viewing long text
+---@field placeholder string Text shown when the input is empty
+local ComboBox = {}
 
----@class Frame : Container
----@field draggingMap table The map of dragging positions
----@field draggable boolean Whether the frame is draggable
----@field scrollable boolean Whether the frame is scrollable
-local Frame = {}
+---Sets the value of the Editable property.
+---@param self ComboBox self
+---@param Editable boolean Enables direct text input in the field
+function ComboBox:setEditable(self, Editable) end
 
----Gets the value of the DraggingMap property.
----@param self Frame self
----@return table {} The map of dragging positions
-function Frame:getDraggingMap(self) end
+---Handles key input when editable
+---@param key number The key code that was pressed
+---@param held boolean Whether the key is being held
+function ComboBox:key(key, held) end
+
+---Gets the value of the AutoComplete property.
+---@param self ComboBox self
+---@return boolean false Enables filtering dropdown items while typing
+function ComboBox:getAutoComplete(self) end
+
+---Gets the value of the CursorPos property.
+---@param self ComboBox self
+---@return number 1 Current cursor position in the text input
+function ComboBox:getCursorPos(self) end
+
+---Sets the value of the PlaceholderColor property.
+---@param self ComboBox self
+---@param PlaceholderColor color Color used for placeholder text
+function ComboBox:setPlaceholderColor(self, PlaceholderColor) end
+
+---Creates a new ComboBox instance
+---@return ComboBox self The newly created ComboBox instance
+function ComboBox.new() end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was released
----@param x number The x position of the release
----@param y number The y position of the release
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return ComboBox self The initialized instance
+---@protected
+function ComboBox:init(props, basalt) end
+
+---Sets the value of the AutoComplete property.
+---@param self ComboBox self
+---@param AutoComplete boolean Enables filtering dropdown items while typing
+function ComboBox:setAutoComplete(self, AutoComplete) end
+
+---Gets the value of the Placeholder property.
+---@param self ComboBox self
+---@return string "..." Text shown when the input is empty
+function ComboBox:getPlaceholder(self) end
+
+---Gets the value of the Text property.
+---@param self ComboBox self
+---@return string "" The current text value of the input field
+function ComboBox:getText(self) end
+
+---Renders the ComboBox
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function ComboBox:render() end
+
+---Handles character input when editable
+---@param char string The character that was typed
+function ComboBox:char(char) end
+
+---Gets the value of the ViewOffset property.
+---@param self ComboBox self
+---@return number 0 Horizontal scroll position for viewing long text
+function ComboBox:getViewOffset(self) end
+
+---Sets the value of the Text property.
+---@param self ComboBox self
+---@param Text string The current text value of the input field
+function ComboBox:setText(self, Text) end
+
+---Sets the value of the Placeholder property.
+---@param self ComboBox self
+---@param Placeholder string Text shown when the input is empty
+function ComboBox:setPlaceholder(self, Placeholder) end
+
+---Handles mouse clicks
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button (1 = left, 2 = right, 3 = middle)
+---@param x number The x coordinate of the click
+---@param y number The y coordinate of the click
 ---@return boolean handled Whether the event was handled
 ---@protected
-function Frame:mouse_up(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Frame:mouse_click(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Frame self The initialized instance
----@protected
-function Frame:init(props, basalt) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@return number height The total height needed for all children
----@protected
-function Frame:getChildrenHeight() end
-
----Gets the value of the Scrollable property.
----@param self Frame self
----@return boolean false Whether the frame is scrollable
-function Frame:getScrollable(self) end
-
----Sets the value of the Draggable property.
----@param self Frame self
----@param Draggable boolean Whether the frame is draggable
-function Frame:setDraggable(self, Draggable) end
-
----Gets the value of the Draggable property.
----@param self Frame self
----@return boolean false Whether the frame is draggable
-function Frame:getDraggable(self) end
-
----Sets the value of the DraggingMap property.
----@param self Frame self
----@param DraggingMap table The map of dragging positions
-function Frame:setDraggingMap(self, DraggingMap) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the drag position
----@param y number The y position of the drag position
----@return boolean handled Whether the event was handled
----@protected
-function Frame:mouse_drag(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction
----@param x number The x position of the scroll
----@param y number The y position of the scroll
----@return boolean handled Whether the event was handled
----@protected
-function Frame:mouse_scroll(direction, x, y) end
-
----Sets the value of the Scrollable property.
----@param self Frame self
----@param Scrollable boolean Whether the frame is scrollable
-function Frame:setScrollable(self, Scrollable) end
-
----@class basalt
-local basalt = {}
-
----Returns the element manager instance
----@return table ElementManager The element manager
-function basalt.getElementManager() end
-
----Sets the active frame
----@param frame BaseFrame The frame to set as active
-function basalt.setActiveFrame(frame) end
-
----Starts the Basalt runtime
-function basalt.run() end
-
----Returns the error manager instance
----@return table ErrorManager The error manager
-function basalt.getErrorManager() end
-
----Runs basalt once, can be used to update the UI manually, but you have to feed it the events
-function basalt.update() end
-
----Gets or creates the main frame
----@return BaseFrame BaseFrame The main frame instance
-function basalt.getMainFrame() end
-
----Stops the Basalt runtime
-function basalt.stop() end
-
----Returns the active frame
----@return BaseFrame ? BaseFrame The frame to set as active
-function basalt.getActiveFrame() end
-
----Returns an element's class without creating a instance
----@param name string The name of the element
----@return table Element The element class
-function basalt.getElementClass(name) end
-
----Registers a callback function for a specific event
----@param eventName string The name of the event to listen for (e.g. "mouse_click", "key", "timer")
----@param callback function The callback function to execute when the event occurs
-function basalt.onEvent(eventName, callback) end
-
----Creates and returns a new UI element of the specified type.
----@param type string The type of element to create (e.g. "Button", "Label", "BaseFrame")
----@return table element The created element instance
-function basalt.create(type) end
-
----Returns the focused frame
----@return BaseFrame ? BaseFrame The focused frame
-function basalt.getFocus() end
-
----Returns a Plugin API
----@param name string The name of the plugin
----@return table Plugin The plugin API
-function basalt.getAPI(name) end
-
----Sets a frame as focused
----@param frame BaseFrame The frame to set as focused
-function basalt.setFocus(frame) end
-
----Triggers a custom event and calls all registered callbacks
----@param eventName string The name of the event to trigger
-function basalt.triggerEvent(eventName) end
-
----Removes a callback function for a specific event
----@param eventName string The name of the event
----@param callback function The callback function to remove
----@return boolean success Whether the callback was found and removed
-function basalt.removeEvent(eventName, callback) end
-
----Schedules a function to run in a coroutine
----@param func function The function to schedule
----@return thread func The scheduled function
-function basalt.schedule(func) end
-
----Creates and returns a new BaseFrame
----@return BaseFrame BaseFrame The created frame instance
-function basalt.createFrame() end
-
----Removes a scheduled update
----@param func thread The scheduled function to remove
----@return boolean success Whether the scheduled function was removed
-function basalt.removeSchedule(func) end
-
----@class BaseFrame : Container
----@field term term term.current() The terminal or (monitor) peripheral object to render to
-local BaseFrame = {}
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function BaseFrame:term_resize() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param char string The character that was pressed
----@protected
-function BaseFrame:char(char) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was pressed
----@protected
-function BaseFrame:key(key) end
-
----Sets the cursor position
----@param x number The x position to set the cursor to
----@param y number The y position to set the cursor to
----@param blink boolean Whether the cursor should blink
-function BaseFrame:setCursor(x, y, blink) end
-
----Toggles the debug log frame
----@param self BaseFrame The frame to toggle debug log for
-function BaseFrame.toggleConsole(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param fg colors The foreground color
----@protected
-function BaseFrame:drawFg(x, y, fg) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param bg colors The background color
----@protected
-function BaseFrame:drawBg(x, y, bg) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return table self The initialized instance
----@protected
-function BaseFrame:init(props, basalt) end
-
----Initializes a new state for this element
----@param self BaseFrame The element to initialize state for
----@param name string The name of the state
----@param default any The default value of the state
----@return BaseFrame self The element instance
-function BaseFrame:initializeState(self, name, default) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was released
----@protected
-function BaseFrame:key_up(key) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param text string The text to render
----@param fg string The foreground color
----@param bg string The background color
----@protected
-function BaseFrame:blit(x, y, text, fg, bg) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the mouse
----@param y number The y position of the mouse
----@protected
-function BaseFrame:mouse_click(button, x, y) end
-
----Shows the debug log frame
----@param self BaseFrame The frame to show debug log in
-function BaseFrame.openConsole(self) end
-
-function BaseFrame:dispatchEvent() end
-
----Sets the value of the Term property.
----@param self BaseFrame self
----@param Term term term.current() The terminal or (monitor) peripheral object to render to
-function BaseFrame:setTerm(self, Term) end
-
----Hides the debug log frame
----@param self BaseFrame The frame to hide debug log for
-function BaseFrame.closeConsole(self) end
-
-function BaseFrame.setup() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param text string The text to render
----@param fg colors The foreground color
----@protected
-function BaseFrame:textFg(x, y, text, fg) end
-
----Gets the value of the Term property.
----@param self BaseFrame self
----@return term |peripheral term.current() The terminal or (monitor) peripheral object to render to
-function BaseFrame:getTerm(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param text string The text to render
----@protected
-function BaseFrame:drawText(x, y, text) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function BaseFrame:render() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was released
----@param x number The x position of the mouse
----@param y number The y position of the mouse
----@protected
-function BaseFrame:mouse_up(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param text string The text to render
----@param bg colors The background color
----@protected
-function BaseFrame:textBg(x, y, text, bg) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param name string The name of the monitor that was touched
----@param x number The x position of the mouse
----@param y number The y position of the mouse
----@protected
-function BaseFrame:monitor_touch(name, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to render to
----@param y number The y position to render to
----@param width number The width of the text
----@param height number The height of the text
----@param text string The text to render
----@param fg string The foreground color
----@param bg string The background color
----@protected
-function BaseFrame:multiBlit(x, y, width, height, text, fg, bg) end
-
----@class ElementManager
-local ElementManager = {}
-
----Loads an element by name. This will load the element and apply any plugins to it.
----@param name string The name of the element to load
-function ElementManager.loadElement(name) end
-
----Gets an element by name. If the element is not loaded, it will try to load it first.
----@param name string The name of the element to get
----@return table Element The element class
-function ElementManager.getElement(name) end
-
----Gets a list of all elements
----@return table ElementList A list of all elements
-function ElementManager.getElementList() end
-
----Gets an Plugin API by name
----@param name string The name of the API to get
----@return table API The API
-function ElementManager.getAPI(name) end
-
----@class PropertySystem
-local PropertySystem = {}
-
----Initializes the PropertySystem IS USED INTERNALLY
----@return table self The PropertySystem
-function PropertySystem:__init() end
-
----Adds a property to the PropertySystem on instance level
----@param name string The name of the property
----@param config table The configuration of the property
----@return table self The PropertySystem
-function PropertySystem:instanceProperty(name, config) end
-
----Observers a property
----@param name string The name of the property
----@param callback function The callback function to call when the property changes
----@return table self The PropertySystem
-function PropertySystem:observe(name, callback) end
-
----Update call for a property IS USED INTERNALLY
----@param name string The name of the property
----@param value any The value of the property
----@return table self The PropertySystem
-function PropertySystem:_updateProperty(name, value) end
-
----Gets a property configuration
----@param name string The name of the property
----@return table config The configuration of the property
-function PropertySystem:getPropertyConfig(name) end
-
----Adds a setter hook to the PropertySystem. Setter hooks are functions that are called before a property is set.
----@param hook function The hook function to add
-function PropertySystem.addSetterHook(hook) end
-
----Removes a property from the PropertySystem on instance level
----@param name string The name of the property
----@return table self The PropertySystem
-function PropertySystem:removeProperty(name) end
-
----Removes an observer from a property
----@param name string The name of the property
----@param callback function The callback function to remove
----@return table self The PropertySystem
-function PropertySystem:removeObserver(name, callback) end
-
----Removes all observers from a property
----@return table self The PropertySystem
-function PropertySystem:removeAllObservers() end
-
----Combines multiple properties into a single getter and setter
----@param class table The element class to combine the properties for
----@param name string The name of the combined property
-function PropertySystem.combineProperties(class, name) end
-
----Defines a property for an element class
----@param class table The element class to define the property for
----@param name string The name of the property
----@param config table The configuration of the property
-function PropertySystem.defineProperty(class, name, config) end
-
----Creates an element from a blueprint
----@param elementClass table The element class to create from the blueprint
----@param blueprint table The blueprint to create the element from
----@return table element The created element
-function PropertySystem.createFromBlueprint(elementClass, blueprint) end
-
----Creates a blueprint of an element class with all its properties
----@param elementClass table The element class to create a blueprint from
----@return table blueprint A table containing all property definitions
-function PropertySystem.blueprint(elementClass) end
-
----@class Animation
-local Animation = {}
-
----Creates a new sequence
----@return Animation self The animation instance
-function Animation:sequence() end
-
----Registers a new easing function
----@param name string The name of the easing function
----@param func function The easing function (takes progress 0-1, returns modified progress)
-function Animation.registerEasing(name, func) end
-
----Adds a new animation to the sequence
----@param type string The type of animation
----@param args table The animation arguments
----@param duration number The duration in seconds
----@param easing string The easing function name
-function Animation:addAnimation(type, args, duration, easing) end
-
----Registers a callback for the update event
----@param callback function The callback function to register
----@return Animation self The animation instance
-function Animation:onUpdate(callback) end
-
----Registers a callback for the complete event
----@param callback function The callback function to register
----@return Animation self The animation instance
-function Animation:onComplete(callback) end
-
----Stops the animation immediately: cancels timers, completes running anim instances and clears the element property
-function Animation:stop() end
-
----The event handler for the animation (listens to timer events)
----@param event string The event type
----@param timerId number The timer ID
-function Animation:event(event, timerId) end
-
----Registers a callback for the start event
----@param callback function The callback function to register
-function Animation:onStart(callback) end
-
----Registers a new animation type
----@param name string The name of the animation
----@param handlers table Table containing start, update and complete handlers
-function Animation.registerAnimation(name, handlers) end
-
----Starts the animation
----@return Animation self The animation instance
-function Animation:start() end
-
----Creates a new Animation
----@param element VisualElement The element to animate
----@return Animation The new animation
-function Animation.new(element) end
-
----@class List : VisualElement
----@field offset number Current scroll offset for viewing long lists
----@field multiSelection boolean Whether multiple items can be selected at once
----@field selectedForeground color Text color for selected items
----@field selectedBackground color Background color for selected items
----@field items table List of items to display. Items can be tables with properties including selected state
----@field selectable boolean Whether items in the list can be selected
-local List = {}
-
----Gets the currently selected items
----@return table selected List of selected items
-function List:getSelectedItems() end
-
----Registers a function to handle the onSelect event.
----@param index number
----@param item table
----@param self List self
----@param func function The function to be called when the event fires
-function List:onOnSelect(self, func) end
-
----Gets the value of the SelectedForeground property.
----@param self List self
----@return color white Text color for selected items
-function List:getSelectedForeground(self) end
-
----Gets the value of the SelectedBackground property.
----@param self List self
----@return color blue Background color for selected items
-function List:getSelectedBackground(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function List:render() end
-
----Gets the value of the Selectable property.
----@param self List self
----@return boolean true Whether items in the list can be selected
-function List:getSelectable(self) end
-
----Sets the value of the SelectedBackground property.
----@param self List self
----@param SelectedBackground color Background color for selected items
-function List:setSelectedBackground(self, SelectedBackground) end
-
----Sets the value of the MultiSelection property.
----@param self List self
----@param MultiSelection boolean Whether multiple items can be selected at once
-function List:setMultiSelection(self, MultiSelection) end
-
----Removes an item from the list
----@param index number The index of the item to remove
----@return List self The List instance
-function List:removeItem(index) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return List self The initialized instance
----@protected
-function List:init(props, basalt) end
-
----Adds an item to the list
----@param text string |table The item to add (string or item table)
----@return List self The List instance
-function List:addItem(text) end
-
----Sets the value of the Items property.
----@param self List self
----@param Items table List of items to display. Items can be tables with properties including selected state
-function List:setItems(self, Items) end
-
----Scrolls the list to the bottom
----@return List self The List instance
-function List:scrollToBottom() end
-
----Scrolls the list to the top
----@return List self The List instance
-function List:scrollToTop() end
-
----Gets the value of the Items property.
----@param self List self
----@return table {} List of items to display. Items can be tables with properties including selected state
-function List:getItems(self) end
-
----Registers a callback for the select event
----@param callback function The callback function to register
----@return List self The List instance
-function List:onSelect(callback) end
-
----Sets the value of the Selectable property.
----@param self List self
----@param Selectable boolean Whether items in the list can be selected
-function List:setSelectable(self, Selectable) end
-
----Gets first selected item
----@return table ? selected The first item
-function List:getSelectedItem() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button that was clicked
----@param x number The x-coordinate of the click
----@param y number The y-coordinate of the click
----@return boolean Whether the event was handled
----@protected
-function List:mouse_click(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The direction of the scroll (1 for down, -1 for up)
----@param x number The x-coordinate of the scroll
----@param y number The y-coordinate of the scroll
----@return boolean Whether the event was handled
----@protected
-function List:mouse_scroll(direction, x, y) end
-
----Clears all items from the list
----@return List self The List instance
-function List:clear() end
-
----Gets the value of the MultiSelection property.
----@param self List self
----@return boolean false Whether multiple items can be selected at once
-function List:getMultiSelection(self) end
-
----Gets the value of the Offset property.
----@param self List self
----@return number 0 Current scroll offset for viewing long lists
-function List:getOffset(self) end
-
----Sets the value of the SelectedForeground property.
----@param self List self
----@param SelectedForeground color Text color for selected items
-function List:setSelectedForeground(self, SelectedForeground) end
-
----Sets the value of the Offset property.
----@param self List self
----@param Offset number Current scroll offset for viewing long lists
-function List:setOffset(self, Offset) end
-
----@class Image : VisualElement
----@field currentFrame number Current animation frame
----@field autoResize boolean Whether to automatically resize the image when content exceeds bounds
----@field offsetY number Vertical offset for viewing larger images
----@field offsetX number Horizontal offset for viewing larger images
----@field bimg table The bimg image data
-local Image = {}
-
----Gets the value of the CurrentFrame property.
----@param self Image self
----@return number 1 Current animation frame
-function Image:getCurrentFrame(self) end
-
----Sets the background color at the specified position
----@param x number The x position
----@param y number The y position
----@param pattern string The background color pattern
----@return Image self The Image instance
-function Image:setBg(x, y, pattern) end
-
----Gets the foreground color at the specified position
----@param x number The x position
----@param y number The y position
----@param length number The length of the foreground color pattern to get
----@return string fg The foreground color pattern
-function Image:getFg(x, y, length) end
-
----Sets the value of the OffsetX property.
----@param self Image self
----@param OffsetX number Horizontal offset for viewing larger images
-function Image:setOffsetX(self, OffsetX) end
-
----Sets the value of the AutoResize property.
----@param self Image self
----@param AutoResize boolean Whether to automatically resize the image when content exceeds bounds
-function Image:setAutoResize(self, AutoResize) end
-
----Gets the value of the OffsetY property.
----@param self Image self
----@return number 0 Vertical offset for viewing larger images
-function Image:getOffsetY(self) end
-
----Sets the text at the specified position
----@param x number The x position
----@param y number The y position
----@param text string The text to set
----@return Image self The Image instance
-function Image:setText(x, y, text) end
-
----Gets the value of the Bimg property.
----@param self Image self
----@return table {} The bimg image data
-function Image:getBimg(self) end
-
----Gets the specified frame
----@param frameIndex number The index of the frame to get
----@return table frame The frame data
-function Image:getFrame(frameIndex) end
-
----Gets the text at the specified position
----@param x number The x position
----@param y number The y position
----@param length number The length of the text to get
----@return string text The text at the specified position
-function Image:getText(x, y, length) end
-
----Sets the value of the OffsetY property.
----@param self Image self
----@param OffsetY number Vertical offset for viewing larger images
-function Image:setOffsetY(self, OffsetY) end
-
----Gets the metadata of the image
----@return table metadata The metadata of the image
-function Image:getMetadata() end
-
----Updates the specified frame with the provided data
----@param frameIndex number The index of the frame to update
----@param frame table The new frame data
----@return Image self The Image instance
-function Image:updateFrame(frameIndex, frame) end
-
----Resizes the image to the specified width and height
----@param width number The new width of the image
----@param height number The new height of the image
----@return Image self The Image instance
-function Image:resizeImage(width, height) end
-
----Sets the value of the CurrentFrame property.
----@param self Image self
----@param CurrentFrame number Current animation frame
-function Image:setCurrentFrame(self, CurrentFrame) end
-
----Adds a new frame to the image
----@return Image self The Image instance
-function Image:addFrame() end
-
----Advances to the next frame in the animation
----@return Image self The Image instance
-function Image:nextFrame() end
-
----Gets the size of the image
----@return number width The width of the image
----@return number height The height of the image
-function Image:getImageSize() end
-
----Gets pixel information at position
----@param x number X position
----@param y number Y position
----@return number ? fg Foreground color
----@return number ? bg Background color
----@return string ? char Character at position
-function Image:getPixelData(x, y) end
-
----Sets the pixel at the specified position
----@param x number The x position
----@param y number The y position
----@param char string The character to set
----@param fg string The foreground color pattern
----@param bg string The background color pattern
----@return Image self The Image instance
-function Image:setPixel(x, y, char, fg, bg) end
-
----Sets the foreground color at the specified position
----@param x number The x position
----@param y number The y position
----@param pattern string The foreground color pattern
----@return Image self The Image instance
-function Image:setFg(x, y, pattern) end
-
----Gets the background color at the specified position
----@param x number The x position
----@param y number The y position
----@param length number The length of the background color pattern to get
----@return string bg The background color pattern
-function Image:getBg(x, y, length) end
-
----Gets the value of the OffsetX property.
----@param self Image self
----@return number 0 Horizontal offset for viewing larger images
-function Image:getOffsetX(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Image:render() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Image self The initialized instance
----@protected
-function Image:init(props, basalt) end
-
----Sets the value of the Bimg property.
----@param self Image self
----@param Bimg table The bimg image data
-function Image:setBimg(self, Bimg) end
-
----Gets the value of the AutoResize property.
----@param self Image self
----@return boolean false Whether to automatically resize the image when content exceeds bounds
-function Image:getAutoResize(self) end
-
----Sets the metadata of the image
----@param key string The key of the metadata to set
----@param value string The value of the metadata to set
----@return Image self The Image instance
-function Image:setMetadata(key, value) end
-
----@class Render
-local Render = {}
-
----Gets the size of the render
----@return number , number
-function Render:getSize() end
-
----Blits a background color to the screen
----@param x number The x position
----@param y number The y position
----@param bg string The background color to blit
----@return Render 
-function Render:bg(x, y, bg) end
-
----Checks if two rectangles overlap
----@param r1 table The first rectangle
----@param r2 table The second rectangle
----@return boolean 
-function Render:rectOverlaps(r1, r2) end
-
----Adds a dirty rectangle to the buffer
----@param x number The x position of the rectangle
----@param y number The y position of the rectangle
----@param width number The width of the rectangle
----@param height number The height of the rectangle
----@return Render 
-function Render:addDirtyRect(x, y, width, height) end
-
----Blits text to the screen
----@param x number The x position to blit to
----@param y number The y position to blit to
----@param text string The text to blit
----@return Render 
-function Render:text(x, y, text) end
-
----Renders the buffer to the screen
----@return Render 
-function Render:render() end
-
----Merges two rectangles
----@param target table The target rectangle
----@param source table The source rectangle
----@return Render 
-function Render:mergeRects(target, source) end
-
----Blits text to the screen with a background color
----@param x number The x position to blit to
----@param y number The y position to blit to
----@param text string The text to blit
----@param bg colors The background color of the text
----@return Render 
-function Render:textBg(x, y, text, bg) end
-
----Clears an area of the screen
----@param x number The x position of the area
----@param y number The y position of the area
----@param width number The width of the area
----@param height number The height of the area
----@param bg colors The background color to clear the area with
----@return Render 
-function Render:clearArea(x, y, width, height, bg) end
-
----Sets the size of the render
----@param width number The width of the render
----@param height number The height of the render
----@return Render 
-function Render:setSize(width, height) end
-
----Creates a new Render object
----@param terminal table The terminal object to render to
----@return Render 
-function Render.new(terminal) end
-
----Clears the screen
----@param bg colors The background color to clear the screen with
----@return Render 
-function Render:clear(bg) end
-
----Blits text to the screen with multiple lines
----@param x number The x position to blit to
----@param y number The y position to blit to
----@param width number The width of the text
----@param height number The height of the text
----@param text string The text to blit
----@param fg colors The foreground color of the text
----@param bg colors The background color of the text
----@return Render 
-function Render:multiBlit(x, y, width, height, text, fg, bg) end
-
----Blits a foreground color to the screen
----@param x number The x position
----@param y number The y position
----@param fg string The foreground color to blit
----@return Render 
-function Render:fg(x, y, fg) end
-
----Blits text to the screen with a foreground color
----@param x number The x position to blit to
----@param y number The y position to blit to
----@param text string The text to blit
----@param fg colors The foreground color of the text
----@return Render 
-function Render:textFg(x, y, text, fg) end
-
----Sets the cursor position
----@param x number The x position of the cursor
----@param y number The y position of the cursor
----@param blink boolean Whether the cursor should blink
----@return Render 
-function Render:setCursor(x, y, blink) end
-
----Blits text to the screen
----@param x number The x position to blit to
----@param y number The y position to blit to
----@param text string The text to blit
----@param fg string The foreground color of the text
----@param bg string The background color of the text
----@return Render 
-function Render:blit(x, y, text, fg, bg) end
-
----@class Program : VisualElement
----@field path string The path to the program
----@field running boolean Whether the program is running
----@field errorCallback function The error callback function
----@field doneCallback function The done callback function
----@field program table The program instance
-local Program = {}
-
----Sets the value of the Program property.
----@param self Program self
----@param Program table The program instance
-function Program:setProgram(self, Program) end
-
----Executes a program
----@param path string The path to the program
----@return Program self The Program instance
-function Program:execute(path) end
-
----Gets the value of the ErrorCallback property.
----@param self Program self
----@return function nil The error callback function
-function Program:getErrorCallback(self) end
-
----Gets the value of the DoneCallback property.
----@param self Program self
----@return function nil The done callback function
-function Program:getDoneCallback(self) end
-
----Sends an event to the program
----@param event string The event to send
----@return Program self The Program instance
-function Program:sendEvent(event) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Program self The initialized instance
----@protected
-function Program:init(props, basalt) end
-
-function BasaltProgram:setArgs() end
-
----Registers a callback for the program's done event
----@param fn function The callback function to register
----@return Program self The Program instance
-function Program:onDone(fn) end
-
----Gets the value of the Running property.
----@param self Program self
----@return boolean false Whether the program is running
-function Program:getRunning(self) end
-
----Gets the value of the Path property.
----@param self Program self
----@return string "" The path to the program
-function Program:getPath(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Program:render() end
-
----Sets the value of the DoneCallback property.
----@param self Program self
----@param DoneCallback function The done callback function
-function Program:setDoneCallback(self, DoneCallback) end
-
----Registers a callback for the program's error event, if the function returns false, the program won't stop
----@param fn function The callback function to register
----@return Program self The Program instance
-function Program:onError(fn) end
-
----Stops the program
----@return Program self The Program instance
-function Program:stop() end
-
----Sets the value of the ErrorCallback property.
----@param self Program self
----@param ErrorCallback function The error callback function
-function Program:setErrorCallback(self, ErrorCallback) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Program:focus() end
-
----Sets the value of the Path property.
----@param self Program self
----@param Path string The path to the program
-function Program:setPath(self, Path) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param event string The event to handle
----@return any result The event result
----@protected
-function Program:dispatchEvent(event) end
-
----Sets the value of the Running property.
----@param self Program self
----@param Running boolean Whether the program is running
-function Program:setRunning(self, Running) end
-
----Gets the value of the Program property.
----@param self Program self
----@return table nil The program instance
-function Program:getProgram(self) end
-
----@class TabControl : Container
----@field activeTabTextColor color Foreground color for the active tab text
----@field activeTabBackground color Background color for the active tab
----@field tabScrollOffset number Current scroll offset for tabs in scrollable mode
----@field activeTab number The currently active tab ID
----@field scrollableTab boolean Enables scroll mode for tabs if they exceed width
----@field headerBackground color Background color for the tab header area
----@field tabs table List of tab definitions
----@field tabHeight number Height of the tab header area
-local TabControl = {}
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function TabControl:init(props, basalt) end
-
----Gets the value of the ActiveTabBackground property.
----@param self TabControl self
----@return color white Background color for the active tab
-function TabControl:getActiveTabBackground(self) end
-
----Gets the value of the Tabs property.
----@param self TabControl self
----@return table {} List of tab definitions
-function TabControl:getTabs(self) end
-
----Sets the value of the ActiveTabTextColor property.
----@param self TabControl self
----@param ActiveTabTextColor color Foreground color for the active tab text
-function TabControl:setActiveTabTextColor(self, ActiveTabTextColor) end
-
-function TabControl:drawText() end
-
-function TabControl:textFg() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@return number yOffset The Y offset for content
----@protected
-function TabControl:getContentYOffset() end
-
-function TabControl:mouse_move() end
-
----Sets the value of the HeaderBackground property.
----@param self TabControl self
----@param HeaderBackground color Background color for the tab header area
-function TabControl:setHeaderBackground(self, HeaderBackground) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param child table The child element to check
----@return boolean Whether the child should be visible
----@protected
-function TabControl:isChildVisible(child) end
-
----Sets the value of the ScrollableTab property.
----@param self TabControl self
----@param ScrollableTab boolean Enables scroll mode for tabs if they exceed width
-function TabControl:setScrollableTab(self, ScrollableTab) end
-
----returns a proxy for adding elements to the tab
----@param title string The title of the tab
----@return table tabHandler The tab handler proxy for adding elements to the new tab
-function TabControl:newTab(title) end
-
-function TabControl:multiBlit() end
-
-function TabControl:drawFg() end
-
-function TabControl:blit() end
-
----Gets the value of the ActiveTab property.
----@param self TabControl self
----@return number nil The currently active tab ID
-function TabControl:getActiveTab(self) end
-
----Sets the value of the TabScrollOffset property.
----@param self TabControl self
----@param TabScrollOffset number Current scroll offset for tabs in scrollable mode
-function TabControl:setTabScrollOffset(self, TabScrollOffset) end
-
----@param tabId number The ID of the tab to activate
-function TabControl:setActiveTab(tabId) end
-
-function TabControl:mouse_up() end
-
----Gets the value of the HeaderBackground property.
----@param self TabControl self
----@return color gray Background color for the tab header area
-function TabControl:getHeaderBackground(self) end
-
----Gets the value of the ScrollableTab property.
----@param self TabControl self
----@return boolean false Enables scroll mode for tabs if they exceed width
-function TabControl:getScrollableTab(self) end
-
-function TabControl:setCursor() end
-
----@param elementType string The type of element to add
----@param tabId number Optional tab ID, defaults to active tab
----@return table element The created element
-function TabControl:addElement(elementType, tabId) end
-
-function TabControl:mouse_release() end
-
----Scrolls the tab header left or right if scrollableTab is enabled
----@param direction number -1 to scroll left, 1 to scroll right
----@return TabControl self For method chaining
-function TabControl:scrollTabs(direction) end
-
-function TabControl:textBg() end
-
-function TabControl:mouse_drag() end
-
-function TabControl:mouse_scroll() end
-
----Sets the value of the TabHeight property.
----@param self TabControl self
----@param TabHeight number Height of the tab header area
-function TabControl:setTabHeight(self, TabHeight) end
-
----Sets the value of the Tabs property.
----@param self TabControl self
----@param Tabs table List of tab definitions
-function TabControl:setTabs(self, Tabs) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param child table The child element to add
----@return Container self For method chaining
----@protected
-function TabControl:addChild(child) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function TabControl:sortChildrenEvents() end
-
----Gets the value of the TabHeight property.
----@param self TabControl self
----@return number 1 Height of the tab header area
-function TabControl:getTabHeight(self) end
-
-function TabControl:getRelativePosition() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function TabControl:render() end
-
-function TabControl:_getHeaderMetrics() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click (global)
----@param y number The y position of the click (global)
----@return boolean Whether the event was handled
----@protected
-function TabControl:mouse_click(button, x, y) end
-
----Gets the value of the ActiveTabTextColor property.
----@param self TabControl self
----@return color black Foreground color for the active tab text
-function TabControl:getActiveTabTextColor(self) end
-
-function TabControl:drawBg() end
-
----Sets the value of the ActiveTabBackground property.
----@param self TabControl self
----@param ActiveTabBackground color Background color for the active tab
-function TabControl:setActiveTabBackground(self, ActiveTabBackground) end
-
----@param element table The element to assign to a tab
----@param tabId number The ID of the tab to assign the element to
----@return TabControl self For method chaining
-function TabControl:setTab(element, tabId) end
-
----Gets the value of the TabScrollOffset property.
----@param self TabControl self
----@return number 0 Current scroll offset for tabs in scrollable mode
-function TabControl:getTabScrollOffset(self) end
-
----@class Menu : List
----@field separatorColor color The color used for separator items in the menu
-local Menu = {}
-
----Sets the value of the SeparatorColor property.
----@param self Menu self
----@param SeparatorColor color The color used for separator items in the menu
-function Menu:setSeparatorColor(self, SeparatorColor) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean Whether the event was handled
----@protected
-function Menu:mouse_click(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Menu:render() end
-
----Sets the menu items
----@param items table [] List of items with {text, separator, callback, foreground, background} properties
----@return Menu self The Menu instance
-function Menu:setItems(items) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Menu self The initialized instance
----@protected
-function Menu:init(props, basalt) end
-
----Gets the value of the SeparatorColor property.
----@param self Menu self
----@return color gray The color used for separator items in the menu
-function Menu:getSeparatorColor(self) end
-
----@class AnimationInstance
-local AnimationInstance = {}
-
----Creates a new AnimationInstance
----@param element VisualElement The element to animate
----@param animType string The type of animation
----@param args table The animation arguments
----@param duration number Duration in seconds
----@param easing string The easing function name
----@return AnimationInstance The new animation instance
-function AnimationInstance.new(element, animType, args, duration, easing) end
-
----Gets called when the animation is completed
-function AnimationInstance:complete() end
-
----Starts the animation
----@return AnimationInstance self The animation instance
-function AnimationInstance:start() end
-
----Updates the animation
----@param elapsed number The elapsed time in seconds
----@return boolean Whether the animation is finished
-function AnimationInstance:update(elapsed) end
-
----@class Slider : VisualElement
----@field sliderColor color Color of the slider handle
----@field horizontal boolean Whether the slider is horizontal (false for vertical)
----@field barColor color Color of the slider track
----@field step number Current position of the slider handle (1 to width/height)
----@field max number Maximum value for value conversion (maps slider position to this range)
-local Slider = {}
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Slider:render() end
-
----Gets the current value of the slider
----@return number value The current value (0 to max)
-function Slider:getValue() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button that was released
----@param x number The x position of the release
----@param y number The y position of the release
----@return boolean handled Whether the event was handled
----@protected
-function Slider:mouse_scroll(button, x, y) end
-
----Sets the value of the Step property.
----@param self Slider self
----@param Step number Current position of the slider handle (1 to width/height)
-function Slider:setStep(self, Step) end
-
----Sets the value of the SliderColor property.
----@param self Slider self
----@param SliderColor color Color of the slider handle
-function Slider:setSliderColor(self, SliderColor) end
-
----Sets the value of the BarColor property.
----@param self Slider self
----@param BarColor color Color of the slider track
-function Slider:setBarColor(self, BarColor) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Slider:mouse_click(button, x, y) end
-
----Gets the value of the SliderColor property.
----@param self Slider self
----@return color blue Color of the slider handle
-function Slider:getSliderColor(self) end
-
----Gets the value of the Step property.
----@param self Slider self
----@return number 1 Current position of the slider handle (1 to width/height)
-function Slider:getStep(self) end
-
----Registers a function to handle the onChange event.
----@param value number
----@param self Slider self
----@param func function The function to be called when the event fires
-function Slider:onOnChange(self, func) end
-
----Gets the value of the BarColor property.
----@param self Slider self
----@return color gray Color of the slider track
-function Slider:getBarColor(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Slider self The initialized instance
----@protected
-function Slider:init(props, basalt) end
-
----Gets the value of the Horizontal property.
----@param self Slider self
----@return boolean true Whether the slider is horizontal (false for vertical)
-function Slider:getHorizontal(self) end
-
----Sets the value of the Max property.
----@param self Slider self
----@param Max number Maximum value for value conversion (maps slider position to this range)
-function Slider:setMax(self, Max) end
-
----Gets the value of the Max property.
----@param self Slider self
----@return number 100 Maximum value for value conversion (maps slider position to this range)
-function Slider:getMax(self) end
-
----Sets the value of the Horizontal property.
----@param self Slider self
----@param Horizontal boolean Whether the slider is horizontal (false for vertical)
-function Slider:setHorizontal(self, Horizontal) end
-
----@class BaseElement : PropertySystem
----@field name string User-defined name for the element
----@field type string A hierarchical identifier of the element's type chain
----@field eventCallbacks table Collection of registered event handler functions
----@field enabled boolean Controls event processing for this element
----@field id string Auto-generated unique identifier for element lookup
-local BaseElement = {}
-
----Stops benchmarking for a method
----@param methodName string The name of the method to stop benchmarking
----@return BaseElement self The element instance
-function BaseElement:stopBenchmark(methodName) end
-
----Removes the element from UI tree and cleans up resources
-function BaseElement:destroy() end
-
----Configures event listening behavior with automatic parent notification
----@param eventName string The name of the event to listen for
----@return table self The BaseElement instance
-function BaseElement:listenEvent(eventName) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param event string The event to handle
----@return boolean ? handled Whether the event was handled
----@protected
-function BaseElement:handleEvent(event) end
-
----Sets the value of a state
----@param self BaseElement The element to set state for
----@param name string The name of the state
----@param value any The new value for the state
----@return BaseElement self The element instance
-function BaseElement:setState(self, name, value) end
-
----Sets the value of the Name property.
----@param self BaseElement self
----@param Name string User-defined name for the element
-function BaseElement:setName(self, Name) end
-
----Sets the value of the EventCallbacks property.
----@param self BaseElement self
----@param EventCallbacks table Collection of registered event handler functions
-function BaseElement:setEventCallbacks(self, EventCallbacks) end
-
----Gets the value of a state
----@param self BaseElement The element to get state from
----@param name string The name of the state
----@return any value The current state value
-function BaseElement:getState(self, name) end
-
----Adds an event handler function with automatic event registration
----@param event string The event to register the callback for
----@param callback function The callback function to register
----@return table self The BaseElement instance
-function BaseElement:registerCallback(event, callback) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param event string The event to handle
----@return boolean ? handled Whether the event was handled
----@protected
-function BaseElement:dispatchEvent(event) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return table self The initialized instance
----@protected
-function BaseElement:init(props, basalt) end
-
----Binds a property to a state
----@param self BaseElement The element to bind
----@param propertyName string The property to bind
----@param stateName string The state to bind to (optional, uses propertyName if not provided)
----@return BaseElement self The element instance
-function BaseElement:bind(self, propertyName, stateName) end
-
----Applies the current theme to this element
----@param self BaseElement The element to apply theme to
----@param applyToChildren boolean ? Whether to apply theme to child elements (default: true)
----@return BaseElement self The element instance
-function BaseElement:applyTheme(self, applyToChildren) end
-
----Enables debugging for this element
----@param self BaseElement The element to debug
----@param level number The debug level
-function BaseElement.debug(self, level) end
-
----Sets the value of the Enabled property.
----@param self BaseElement self
----@param Enabled boolean Controls event processing for this element
-function BaseElement:setEnabled(self, Enabled) end
-
----Executes all registered callbacks for the specified event
----@param event string The event to fire
----@return table self The BaseElement instance
-function BaseElement:fireEvent(event) end
-
----Removes a state change observer
----@param self BaseElement The element to remove observer from
----@param stateName string The state to remove observer from
----@param callback function The callback function to remove
----@return BaseElement self The element instance
-function BaseElement:removeStateChange(self, stateName, callback) end
-
----Starts profiling a method
----@param methodName string The name of the method to profile
----@return BaseElement self The element instance
-function BaseElement:startProfile(methodName) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@return table self The BaseElement instance
----@protected
-function BaseElement:postInit() end
-
----Propagates render request up the element tree
----@return table self The BaseElement instance
-function BaseElement:updateRender() end
-
----Gets the value of the EventCallbacks property.
----@param self BaseElement self
----@return table BaseElement Collection of registered event handler functions
-function BaseElement:getEventCallbacks(self) end
-
----Gets the theme properties for this element
----@param self BaseElement The element to get theme for
----@return table styles The theme properties
-function BaseElement:getTheme(self) end
-
----Enables benchmarking for a method
----@param methodName string The name of the method to benchmark
----@return BaseElement self The element instance
-function BaseElement:benchmark(methodName) end
-
----Gets the value of the Name property.
----@param self BaseElement self
----@return string BaseElement User-defined name for the element
-function BaseElement:getName(self) end
-
----Logs benchmark statistics for a method
----@param methodName string The name of the method to log
----@return BaseElement self The element instance
-function BaseElement:logBenchmark(methodName) end
-
----Sets up a property change observer with immediate callback registration
----@param property string The property to observe
----@param callback function The callback to call when the property changes
----@return table self The BaseElement instance
-function BaseElement:onChange(property, callback) end
-
----Registers a class-level event listener with optional dependency
----@param class table The class to register
----@param eventName string The name of the event to register
-function BaseElement.defineEvent(class, eventName) end
-
----Checks if the element matches or inherits from the specified type
----@param type string The type to check for
----@return boolean isType Whether the element is of the specified type
-function BaseElement:isType(type) end
-
----Traverses parent chain to locate the root frame element
----@return BaseFrame BaseFrame The base frame of the element
-function BaseElement:getBaseFrame() end
-
----Registers a callback for state changes
----@param self BaseElement The element to watch
----@param stateName string The state to watch
----@param callback function Called with (element, newValue, oldValue)
----@return BaseElement self The element instance
-function BaseElement:onStateChange(self, stateName, callback) end
-
----Dumps debug information for this element
----@param self BaseElement The element to dump debug info for
-function BaseElement.dumpDebug(self) end
-
----Sets the value of the Type property.
----@param self BaseElement self
----@param Type string A hierarchical identifier of the element's type chain
-function BaseElement:setType(self, Type) end
-
----Gets the value of the Type property.
----@param self BaseElement self
----@return string BaseElement A hierarchical identifier of the element's type chain
-function BaseElement:getType(self) end
-
----Ends profiling a method
----@param methodName string The name of the method to stop profiling
----@return BaseElement self The element instance
-function BaseElement:endProfile(methodName) end
-
----Gets the value of the Enabled property.
----@param self BaseElement self
----@return boolean BaseElement Controls event processing for this element
-function BaseElement:getEnabled(self) end
-
----Gets benchmark statistics for a method
----@param methodName string The name of the method to get statistics for
----@return table ? stats The benchmark statistics or nil
-function BaseElement:getBenchmarkStats(methodName) end
-
-function BaseElement:computed() end
-
----Sets the value of the Id property.
----@param self BaseElement self
----@param Id string Auto-generated unique identifier for element lookup
-function BaseElement:setId(self, Id) end
-
----Gets the value of the Id property.
----@param self BaseElement self
----@return string BaseElement Auto-generated unique identifier for element lookup
-function BaseElement:getId(self) end
-
----Defines a class-level event callback method with automatic event registration
----@param class table The class to register
----@param callbackName string The name of the callback to register
-function BaseElement.registerEventCallback(class, callbackName) end
-
----@class Benchmark
-local Benchmark = {}
-
----Clears a specific benchmark
----@param name string The name of the benchmark to clear
-function API.clear(name) end
-
----Starts a custom benchmark
----@param name string The name of the benchmark
-function API.start(name) end
-
----Gets statistics for a benchmark
----@param name string The name of the benchmark
----@return table ? stats The benchmark statistics or nil
-function API.getStats(name) end
-
----Clears all custom benchmarks
-function API.clearAll() end
-
----Stops a custom benchmark
----@param name string The name of the benchmark to stop
-function API.stop(name) end
+function ComboBox:mouse_click(button, x, y) end
+
+---Sets the value of the CursorPos property.
+---@param self ComboBox self
+---@param CursorPos number Current cursor position in the text input
+function ComboBox:setCursorPos(self, CursorPos) end
+
+---Gets the value of the PlaceholderColor property.
+---@param self ComboBox self
+---@return color gray Color used for placeholder text
+function ComboBox:getPlaceholderColor(self) end
+
+---Gets the value of the ManuallyOpened property.
+---@param self ComboBox self
+---@return boolean false Indicates if dropdown was opened by user action
+function ComboBox:getManuallyOpened(self) end
+
+---Sets the value of the ViewOffset property.
+---@param self ComboBox self
+---@param ViewOffset number Horizontal scroll position for viewing long text
+function ComboBox:setViewOffset(self, ViewOffset) end
+
+---Sets the value of the ManuallyOpened property.
+---@param self ComboBox self
+---@param ManuallyOpened boolean Indicates if dropdown was opened by user action
+function ComboBox:setManuallyOpened(self, ManuallyOpened) end
+
+---Gets the value of the Editable property.
+---@param self ComboBox self
+---@return boolean true Enables direct text input in the field
+function ComboBox:getEditable(self) end
 
 ---@class Input : VisualElement
 ---@field text string The current text content of the input
----@field focusedForeground color Foreground color when input is focused
----@field cursorPos number The current cursor position in the text
----@field cursorColor number Color of the cursor
----@field maxLength number nil Maximum length of input text (optional)
----@field focusedBackground color Background color when input is focused
 ---@field replaceChar string Character to replace the input with (for password fields)
+---@field cursorPos number The current cursor position in the text
+---@field placeholderColor color Color of the placeholder text
+---@field maxLength number nil Maximum length of input text (optional)
 ---@field viewOffset number The horizontal scroll offset for viewing long text
 ---@field placeholder string Text to display when input is empty
 ---@field pattern string nil Regular expression pattern for input validation
----@field placeholderColor color Color of the placeholder text
+---@field cursorColor number Color of the cursor
 local Input = {}
 
----Sets the value of the CursorPos property.
----@param self Input self
----@param CursorPos number The current cursor position in the text
-function Input:setCursorPos(self, CursorPos) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Input:render() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Input:paste() end
-
----Sets the value of the CursorColor property.
----@param self Input self
----@param CursorColor number Color of the cursor
-function Input:setCursorColor(self, CursorColor) end
-
----Sets the cursor position and color
----@param x number The x position of the cursor
----@param y number The y position of the cursor
----@param blink boolean Whether the cursor should blink
----@param color number The color of the cursor
-function Input:setCursor(x, y, blink, color) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Input:blur() end
-
----Sets the value of the Placeholder property.
----@param self Input self
----@param Placeholder string Text to display when input is empty
-function Input:setPlaceholder(self, Placeholder) end
-
----Updates the input's viewport
----@return Input self The updated instance
-function Input:updateViewport() end
-
----Gets the value of the FocusedForeground property.
----@param self Input self
----@return color white Foreground color when input is focused
-function Input:getFocusedForeground(self) end
-
----Sets the value of the Text property.
----@param self Input self
----@param Text string The current text content of the input
-function Input:setText(self, Text) end
-
----Sets the value of the FocusedForeground property.
----@param self Input self
----@param FocusedForeground color Foreground color when input is focused
-function Input:setFocusedForeground(self, FocusedForeground) end
-
----Sets the value of the Pattern property.
----@param self Input self
----@param Pattern string nil Regular expression pattern for input validation
-function Input:setPattern(self, Pattern) end
-
----Sets the value of the MaxLength property.
----@param self Input self
----@param MaxLength number nil Maximum length of input text (optional)
-function Input:setMaxLength(self, MaxLength) end
-
 ---Sets the value of the ReplaceChar property.
 ---@param self Input self
 ---@param ReplaceChar string Character to replace the input with (for password fields)
 function Input:setReplaceChar(self, ReplaceChar) end
 
----Gets the value of the ReplaceChar property.
+---Sets the value of the CursorPos property.
 ---@param self Input self
----@return string nil Character to replace the input with (for password fields)
-function Input:getReplaceChar(self) end
-
----Gets the value of the FocusedBackground property.
----@param self Input self
----@return color blue Background color when input is focused
-function Input:getFocusedBackground(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Input:focus() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param char string The character that was typed
----@return boolean handled Whether the event was handled
----@protected
-function Input:char(char) end
-
----Gets the value of the CursorColor property.
----@param self Input self
----@return number nil Color of the cursor
-function Input:getCursorColor(self) end
-
----Gets the value of the Pattern property.
----@param self Input self
----@return string ? nil Regular expression pattern for input validation
-function Input:getPattern(self) end
-
----Sets the value of the PlaceholderColor property.
----@param self Input self
----@param PlaceholderColor color Color of the placeholder text
-function Input:setPlaceholderColor(self, PlaceholderColor) end
+---@param CursorPos number The current cursor position in the text
+function Input:setCursorPos(self, CursorPos) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param props table The properties to initialize the element with
@@ -1709,11 +2868,34 @@ function Input:setPlaceholderColor(self, PlaceholderColor) end
 ---@protected
 function Input:init(props, basalt) end
 
+---Updates the input's viewport
+---@return Input self The updated instance
+function Input:updateViewport() end
+
+---Sets the value of the PlaceholderColor property.
+---@param self Input self
+---@param PlaceholderColor color Color of the placeholder text
+function Input:setPlaceholderColor(self, PlaceholderColor) end
+
+---Sets the value of the Text property.
+---@param self Input self
+---@param Text string The current text content of the input
+function Input:setText(self, Text) end
+
+---Gets the value of the ReplaceChar property.
+---@param self Input self
+---@return string nil Character to replace the input with (for password fields)
+function Input:getReplaceChar(self) end
+
 ---Gets the value of the Placeholder property.
 ---@param self Input self
 ---@return string ... Text to display when input is empty
 function Input:getPlaceholder(self) end
 
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Input:render() end
+
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param button number The button that was clicked
 ---@param x number The x position of the click
@@ -1722,215 +2904,423 @@ function Input:getPlaceholder(self) end
 ---@protected
 function Input:mouse_click(button, x, y) end
 
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Input:focus() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Input:blur() end
+
+---Gets the value of the MaxLength property.
+---@param self Input self
+---@return number ? nil Maximum length of input text (optional)
+function Input:getMaxLength(self) end
+
+---Sets the value of the Placeholder property.
+---@param self Input self
+---@param Placeholder string Text to display when input is empty
+function Input:setPlaceholder(self, Placeholder) end
+
+---Gets the value of the CursorPos property.
+---@param self Input self
+---@return number 1 The current cursor position in the text
+function Input:getCursorPos(self) end
+
 ---Gets the value of the ViewOffset property.
 ---@param self Input self
 ---@return number 0 The horizontal scroll offset for viewing long text
 function Input:getViewOffset(self) end
 
+---Sets the value of the MaxLength property.
+---@param self Input self
+---@param MaxLength number nil Maximum length of input text (optional)
+function Input:setMaxLength(self, MaxLength) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param char string The character that was typed
+---@return boolean handled Whether the event was handled
+---@protected
+function Input:char(char) end
+
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param key number The key that was pressed
 ---@return boolean handled Whether the event was handled
 ---@protected
 function Input:key(key) end
 
----Gets the value of the MaxLength property.
+---Sets the value of the CursorColor property.
 ---@param self Input self
----@return number ? nil Maximum length of input text (optional)
-function Input:getMaxLength(self) end
-
----Gets the value of the CursorPos property.
----@param self Input self
----@return number 1 The current cursor position in the text
-function Input:getCursorPos(self) end
+---@param CursorColor number Color of the cursor
+function Input:setCursorColor(self, CursorColor) end
 
 ---Gets the value of the PlaceholderColor property.
 ---@param self Input self
 ---@return color gray Color of the placeholder text
 function Input:getPlaceholderColor(self) end
 
----Gets the value of the Text property.
----@param self Input self
----@return string - The current text content of the input
-function Input:getText(self) end
-
 ---Sets the value of the ViewOffset property.
 ---@param self Input self
 ---@param ViewOffset number The horizontal scroll offset for viewing long text
 function Input:setViewOffset(self, ViewOffset) end
 
----Sets the value of the FocusedBackground property.
+---Sets the cursor position and color
+---@param x number The x position of the cursor
+---@param y number The y position of the cursor
+---@param blink boolean Whether the cursor should blink
+---@param color number The color of the cursor
+function Input:setCursor(x, y, blink, color) end
+
+---Gets the value of the Pattern property.
 ---@param self Input self
----@param FocusedBackground color Background color when input is focused
-function Input:setFocusedBackground(self, FocusedBackground) end
+---@return string ? nil Regular expression pattern for input validation
+function Input:getPattern(self) end
 
----@class Table : VisualElement
----@field headerColor color Color of the column headers
----@field data table The table data as array of row arrays
----@field scrollOffset number Current scroll position
----@field selectedRow number nil Currently selected row index
----@field gridColor color Color of grid lines
----@field customSortFunction table Custom sort functions for columns
----@field sortDirection string Sort direction ("asc" or "desc")
----@field columns table List of column definitions with {name, width} properties
----@field selectedColor color Background color of selected row
----@field sortColumn number nil Currently sorted column index
-local Table = {}
-
----Sets the value of the HeaderColor property.
----@param self Table self
----@param HeaderColor color Color of the column headers
-function Table:setHeaderColor(self, HeaderColor) end
+---Gets the value of the Text property.
+---@param self Input self
+---@return string - The current text content of the input
+function Input:getText(self) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@protected
-function Table:render() end
+function Input:paste() end
 
----Sets the value of the SortDirection property.
----@param self Table self
----@param SortDirection string Sort direction ("asc" or "desc")
-function Table:setSortDirection(self, SortDirection) end
+---Sets the value of the Pattern property.
+---@param self Input self
+---@param Pattern string nil Regular expression pattern for input validation
+function Input:setPattern(self, Pattern) end
+
+---Gets the value of the CursorColor property.
+---@param self Input self
+---@return number nil Color of the cursor
+function Input:getCursorColor(self) end
+
+---@class Timer : BaseElement
+---@field action function The action to be performed when the timer triggers.
+---@field amount number The amount of time the timer should run.
+---@field interval number The interval in seconds at which the timer will trigger its action.
+---@field running boolean Indicates whether the timer is currently running or not.
+local Timer = {}
+
+---Gets the value of the Interval property.
+---@param self Timer self
+---@return number 1 The interval in seconds at which the timer will trigger its action.
+function Timer:getInterval(self) end
+
+---Sets the value of the Interval property.
+---@param self Timer self
+---@param Interval number The interval in seconds at which the timer will trigger its action.
+function Timer:setInterval(self, Interval) end
+
+---Gets the value of the Running property.
+---@param self Timer self
+---@return boolean false Indicates whether the timer is currently running or not.
+function Timer:getRunning(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Timer:dispatchEvent() end
+
+---Starts the timer with the specified interval.
+---@param self Timer The Timer instance to start
+---@return Timer self The Timer instance
+function Timer:start(self) end
+
+---Stops the timer if it is currently running.
+---@param self Timer The Timer instance to stop
+---@return Timer self The Timer instance
+function Timer:stop(self) end
+
+---Gets the value of the Action property.
+---@param self Timer self
+---@return function function The action to be performed when the timer triggers.
+function Timer:getAction(self) end
+
+---Sets the value of the Running property.
+---@param self Timer self
+---@param Running boolean Indicates whether the timer is currently running or not.
+function Timer:setRunning(self, Running) end
+
+---Gets the value of the Amount property.
+---@param self Timer self
+---@return number -1 The amount of time the timer should run.
+function Timer:getAmount(self) end
+
+---Sets the value of the Amount property.
+---@param self Timer self
+---@param Amount number The amount of time the timer should run.
+function Timer:setAmount(self, Amount) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param props table The properties to initialize the element with
 ---@param basalt table The basalt instance
----@return Table self The initialized instance
 ---@protected
-function Table:init(props, basalt) end
+function Timer:init(props, basalt) end
 
----Sets the value of the ScrollOffset property.
----@param self Table self
----@param ScrollOffset number Current scroll position
-function Table:setScrollOffset(self, ScrollOffset) end
+---Sets the value of the Action property.
+---@param self Timer self
+---@param Action function The action to be performed when the timer triggers.
+function Timer:setAction(self, Action) end
 
----Sets a custom sort function for a specific column
----@param columnIndex number The index of the column
----@param sortFn function Function that takes (rowA, rowB) and returns comparison result
----@return Table self The Table instance
-function Table:setColumnSortFunction(columnIndex, sortFn) end
-
----Gets the value of the SelectedRow property.
----@param self Table self
----@return number ? nil Currently selected row index
-function Table:getSelectedRow(self) end
-
----Sorts the table data by column
----@param columnIndex number The index of the column to sort by
----@param fn function ? Optional custom sorting function
----@return Table self The Table instance
-function Table:sortData(columnIndex, fn) end
-
----Sets the value of the GridColor property.
----@param self Table self
----@param GridColor color Color of grid lines
-function Table:setGridColor(self, GridColor) end
+---@class ProgressBar : VisualElement
+---@field progress number Current progress value (0-100)
+---@field progressColor color The color used for the filled portion of the progress bar
+---@field showPercentage boolean Whether to show the percentage text in the center
+---@field direction string The direction of the progress bar ("up", "down", "left", "right")
+local ProgressBar = {}
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return ProgressBar self The initialized instance
 ---@protected
-function Table:mouse_click(button, x, y) end
+function ProgressBar:init(props, basalt) end
 
----Sets the value of the SelectedRow property.
----@param self Table self
----@param SelectedRow number nil Currently selected row index
-function Table:setSelectedRow(self, SelectedRow) end
+---Gets the value of the Progress property.
+---@param self ProgressBar self
+---@return number 0 Current progress value (0-100)
+function ProgressBar:getProgress(self) end
 
----Sets the value of the SelectedColor property.
----@param self Table self
----@param SelectedColor color Background color of selected row
-function Table:setSelectedColor(self, SelectedColor) end
+---Sets the value of the ShowPercentage property.
+---@param self ProgressBar self
+---@param ShowPercentage boolean Whether to show the percentage text in the center
+function ProgressBar:setShowPercentage(self, ShowPercentage) end
 
----Adds a new row of data to the table
----@return Table self The Table instance
-function Table:addData() end
+---Sets the value of the ProgressColor property.
+---@param self ProgressBar self
+---@param ProgressColor color The color used for the filled portion of the progress bar
+function ProgressBar:setProgressColor(self, ProgressColor) end
 
----Gets the value of the ScrollOffset property.
----@param self Table self
----@return number 0 Current scroll position
-function Table:getScrollOffset(self) end
-
----Gets the value of the HeaderColor property.
----@param self Table self
----@return color blue Color of the column headers
-function Table:getHeaderColor(self) end
-
----Gets the value of the SelectedColor property.
----@param self Table self
----@return color lightBlue Background color of selected row
-function Table:getSelectedColor(self) end
-
----Gets the value of the Data property.
----@param self Table self
----@return table {} The table data as array of row arrays
-function Table:getData(self) end
-
----Adds a new column to the table
----@param name string The name of the column
----@param width number The width of the column
----@return Table self The Table instance
-function Table:addColumn(name, width) end
+---Gets the value of the Direction property.
+---@param self ProgressBar self
+---@return string right The direction of the progress bar ("up", "down", "left", "right")
+function ProgressBar:getDirection(self) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction (-1 up, 1 down)
+---@protected
+function ProgressBar:render() end
+
+---Gets the value of the ShowPercentage property.
+---@param self ProgressBar self
+---@return boolean false Whether to show the percentage text in the center
+function ProgressBar:getShowPercentage(self) end
+
+---Gets the value of the ProgressColor property.
+---@param self ProgressBar self
+---@return color lime The color used for the filled portion of the progress bar
+function ProgressBar:getProgressColor(self) end
+
+---Sets the value of the Direction property.
+---@param self ProgressBar self
+---@param Direction string The direction of the progress bar ("up", "down", "left", "right")
+function ProgressBar:setDirection(self, Direction) end
+
+---Sets the value of the Progress property.
+---@param self ProgressBar self
+---@param Progress number Current progress value (0-100)
+function ProgressBar:setProgress(self, Progress) end
+
+---@class ScrollBar : VisualElement
+---@field minValue number 0 Minimum value or function that returns it
+---@field backgroundSymbol string Symbol used for the ScrollBar background
+---@field value number Current scroll value
+---@field orientation string Orientation of the ScrollBar ("vertical" or "horizontal")
+---@field handleSize number Size of the ScrollBar handle in characters
+---@field symbol string " Symbol used for the ScrollBar handle
+---@field maxValue number 100 Maximum value or function that returns it
+---@field max number Maximum scroll value
+---@field attachedProperty string nil The property being controlled
+---@field attachedElement table nil The element this ScrollBar is attached to
+---@field dragMultiplier number How fast the ScrollBar moves when dragging
+---@field step number Step size for scroll operations
+---@field symbolBackgroundColor color Background color of the ScrollBar handle
+---@field min number Minimum scroll value
+local ScrollBar = {}
+
+---Sets the value of the DragMultiplier property.
+---@param self ScrollBar self
+---@param DragMultiplier number How fast the ScrollBar moves when dragging
+function ScrollBar:setDragMultiplier(self, DragMultiplier) end
+
+---Sets the value of the Max property.
+---@param self ScrollBar self
+---@param Max number Maximum scroll value
+function ScrollBar:setMax(self, Max) end
+
+---Gets the value of the BackgroundSymbol property.
+---@param self ScrollBar self
+---@return string "\127" Symbol used for the ScrollBar background
+function ScrollBar:getBackgroundSymbol(self) end
+
+---Gets the value of the DragMultiplier property.
+---@param self ScrollBar self
+---@return number 1 How fast the ScrollBar moves when dragging
+function ScrollBar:getDragMultiplier(self) end
+
+---Sets the value of the BackgroundSymbol property.
+---@param self ScrollBar self
+---@param BackgroundSymbol string Symbol used for the ScrollBar background
+function ScrollBar:setBackgroundSymbol(self, BackgroundSymbol) end
+
+---Sets the value of the AttachedElement property.
+---@param self ScrollBar self
+---@param AttachedElement table nil The element this ScrollBar is attached to
+function ScrollBar:setAttachedElement(self, AttachedElement) end
+
+---Sets the value of the Min property.
+---@param self ScrollBar self
+---@param Min number Minimum scroll value
+function ScrollBar:setMin(self, Min) end
+
+---Sets the value of the AttachedProperty property.
+---@param self ScrollBar self
+---@param AttachedProperty string nil The property being controlled
+function ScrollBar:setAttachedProperty(self, AttachedProperty) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return ScrollBar self The initialized instance
+---@protected
+function ScrollBar:init(props, basalt) end
+
+---Sets the value of the Value property.
+---@param self ScrollBar self
+---@param Value number Current scroll value
+function ScrollBar:setValue(self, Value) end
+
+---Gets the value of the Min property.
+---@param self ScrollBar self
+---@return number 0 Minimum scroll value
+function ScrollBar:getMin(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction (1 for up, -1 for down)
 ---@param x number The x position of the scroll
 ---@param y number The y position of the scroll
----@return boolean handled Whether the event was handled
+---@return boolean Whether the event was handled
 ---@protected
-function Table:mouse_scroll(direction, x, y) end
+function ScrollBar:mouse_scroll(direction, x, y) end
 
----Gets the value of the SortDirection property.
----@param self Table self
----@return string "asc" Sort direction ("asc" or "desc")
-function Table:getSortDirection(self) end
+---Sets the value of the Symbol property.
+---@param self ScrollBar self
+---@param Symbol string " Symbol used for the ScrollBar handle
+function ScrollBar:setSymbol(self, Symbol) end
 
----Sets the value of the Columns property.
----@param self Table self
----@param Columns table List of column definitions with {name, width} properties
-function Table:setColumns(self, Columns) end
+---Sets the value of the SymbolBackgroundColor property.
+---@param self ScrollBar self
+---@param SymbolBackgroundColor color Background color of the ScrollBar handle
+function ScrollBar:setSymbolBackgroundColor(self, SymbolBackgroundColor) end
 
----Set data with automatic formatting
----@param rawData table The raw data array
----@param formatters table Optional formatter functions for columns {[2] = function(value) return value end}
----@return Table self The Table instance
-function Table:setData(rawData, formatters) end
+---Gets the value of the SymbolBackgroundColor property.
+---@param self ScrollBar self
+---@return color black Background color of the ScrollBar handle
+function ScrollBar:getSymbolBackgroundColor(self) end
 
----Gets the value of the SortColumn property.
----@param self Table self
----@return number ? nil Currently sorted column index
-function Table:getSortColumn(self) end
+---Sets the value of the Orientation property.
+---@param self ScrollBar self
+---@param Orientation string Orientation of the ScrollBar ("vertical" or "horizontal")
+function ScrollBar:setOrientation(self, Orientation) end
 
----Sets the value of the CustomSortFunction property.
----@param self Table self
----@param CustomSortFunction table Custom sort functions for columns
-function Table:setCustomSortFunction(self, CustomSortFunction) end
+---Gets the value of the AttachedProperty property.
+---@param self ScrollBar self
+---@return string ? nil The property being controlled
+function ScrollBar:getAttachedProperty(self) end
 
----Gets the value of the CustomSortFunction property.
----@param self Table self
----@return table {} Custom sort functions for columns
-function Table:getCustomSortFunction(self) end
+---Sets the value of the Step property.
+---@param self ScrollBar self
+---@param Step number Step size for scroll operations
+function ScrollBar:setStep(self, Step) end
 
----Sets the value of the SortColumn property.
----@param self Table self
----@param SortColumn number nil Currently sorted column index
-function Table:setSortColumn(self, SortColumn) end
+---Gets the value of the MinValue property.
+---@param self ScrollBar self
+---@return number |function 0 Minimum value or function that returns it
+function ScrollBar:getMinValue(self) end
 
----Gets the value of the Columns property.
----@param self Table self
----@return table {} List of column definitions with {name, width} properties
-function Table:getColumns(self) end
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function ScrollBar:render() end
 
----Adds data with both display and sort values
----@param displayData table The formatted data for display
----@param sortData table The raw data for sorting (optional)
----@return Table self The Table instance
-function Table:setFormattedData(displayData, sortData) end
+---Gets the value of the Step property.
+---@param self ScrollBar self
+---@return number 1 Step size for scroll operations
+function ScrollBar:getStep(self) end
 
----Gets the value of the GridColor property.
----@param self Table self
----@return color gray Color of grid lines
-function Table:getGridColor(self) end
+---Attaches the ScrollBar to an element's property
+---@param element BaseElement The element to attach to
+---@param config table Configuration {property = "propertyName", min = number|function, max = number|function}
+---@return ScrollBar self The ScrollBar instance
+function ScrollBar:attach(element, config) end
+
+---Gets the value of the Max property.
+---@param self ScrollBar self
+---@return number 100 Maximum scroll value
+function ScrollBar:getMax(self) end
+
+---Gets the value of the Orientation property.
+---@param self ScrollBar self
+---@return string vertical Orientation of the ScrollBar ("vertical" or "horizontal")
+function ScrollBar:getOrientation(self) end
+
+---Sets the value of the MaxValue property.
+---@param self ScrollBar self
+---@param MaxValue number 100 Maximum value or function that returns it
+function ScrollBar:setMaxValue(self, MaxValue) end
+
+---Gets the value of the HandleSize property.
+---@param self ScrollBar self
+---@return number 2 Size of the ScrollBar handle in characters
+function ScrollBar:getHandleSize(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button being dragged
+---@param x number The x position of the drag
+---@param y number The y position of the drag
+---@return boolean Whether the event was handled
+---@protected
+function ScrollBar:mouse_drag(button, x, y) end
+
+---Updates the attached element's property based on the ScrollBar value
+---@return ScrollBar self The ScrollBar instance
+function ScrollBar:updateAttachedElement() end
+
+---Sets the value of the HandleSize property.
+---@param self ScrollBar self
+---@param HandleSize number Size of the ScrollBar handle in characters
+function ScrollBar:setHandleSize(self, HandleSize) end
+
+---Gets the value of the AttachedElement property.
+---@param self ScrollBar self
+---@return table ? nil The element this ScrollBar is attached to
+function ScrollBar:getAttachedElement(self) end
+
+---Gets the value of the Value property.
+---@param self ScrollBar self
+---@return number 0 Current scroll value
+function ScrollBar:getValue(self) end
+
+---Sets the value of the MinValue property.
+---@param self ScrollBar self
+---@param MinValue number 0 Minimum value or function that returns it
+function ScrollBar:setMinValue(self, MinValue) end
+
+---Gets the value of the Symbol property.
+---@param self ScrollBar self
+---@return string " " Symbol used for the ScrollBar handle
+function ScrollBar:getSymbol(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The mouse button clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean Whether the event was handled
+---@protected
+function ScrollBar:mouse_click(button, x, y) end
+
+---Gets the value of the MaxValue property.
+---@param self ScrollBar self
+---@return number |function 100 Maximum value or function that returns it
+function ScrollBar:getMaxValue(self) end
 
 ---@class LineChart : Graph
 local LineChart = {}
@@ -1946,644 +3336,136 @@ function LineChart:init(props, basalt) end
 ---@protected
 function LineChart:render() end
 
----@class TextBox : VisualElement
----@field autoPairEnabled boolean Whether automatic bracket/quote pairing is enabled
----@field autoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup
----@field cursorColor number Color of the cursor
----@field autoCompleteTokenPattern string Pattern used to extract the current token for suggestions
----@field autoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
----@field scrollX number Horizontal scroll offset
----@field scrollY number Vertical scroll offset
----@field autoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width)
----@field syntaxPatterns table Syntax highlighting patterns
----@field autoCompleteShowBorder boolean Whether to render a character border around the popup
----@field autoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively
----@field cursorX number Cursor X position
----@field autoCompleteSelectedForeground color Foreground color for the selected suggestion
----@field autoCompleteSelectedBackground color Background color for the selected suggestion
----@field autoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox
----@field autoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately
----@field autoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge
----@field autoCompleteProvider function Optional suggestion provider returning a list for the current prefix
----@field autoCompleteMaxItems number Maximum number of visible suggestions
----@field autoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion
----@field autoCompleteItems table List of suggestions used when no provider is supplied
----@field cursorY number Cursor Y position (line number)
----@field autoCompleteBorderColor color Color of the popup border when enabled
----@field autoPairOverType boolean When pressing a closing char that matches the next char, move over it instead of inserting
----@field editable boolean Whether text can be edited
----@field autoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned
----@field lines table Array of text lines
----@field autoCompleteEnabled boolean Whether autocomplete suggestions are enabled
----@field autoCompleteZOffset number Z-index offset applied to the popup frame
----@field autoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor
----@field autoCompleteMinChars number Minimum characters required before showing suggestions
----@field autoCompleteBackground color Background color of the suggestion popup
----@field autoCompleteForeground color Foreground color of the suggestion popup
-local TextBox = {}
-
----Gets the value of the ScrollY property.
----@param self TextBox self
----@return number 0 Vertical scroll offset
-function TextBox:getScrollY(self) end
-
----Sets the value of the AutoCompleteAcceptOnClick property.
----@param self TextBox self
----@param AutoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately
-function TextBox:setAutoCompleteAcceptOnClick(self, AutoCompleteAcceptOnClick) end
-
----Sets the value of the CursorColor property.
----@param self TextBox self
----@param CursorColor number Color of the cursor
-function TextBox:setCursorColor(self, CursorColor) end
-
----Gets the value of the AutoCompleteAcceptOnEnter property.
----@param self TextBox self
----@return boolean true Whether pressing Enter accepts the current suggestion
-function TextBox:getAutoCompleteAcceptOnEnter(self) end
-
----Gets the value of the AutoCompleteForeground property.
----@param self TextBox self
----@return color black Foreground color of the suggestion popup
-function TextBox:getAutoCompleteForeground(self) end
-
----Gets the value of the AutoPairOverType property.
----@param self TextBox self
----@return boolean true When pressing a closing char that matches the next char, move over it instead of inserting
-function TextBox:getAutoPairOverType(self) end
-
----Sets the value of the Lines property.
----@param self TextBox self
----@param Lines table Array of text lines
-function TextBox:setLines(self, Lines) end
-
----Clears all syntax highlighting patterns
----@return TextBox self
-function TextBox:clearSyntaxPatterns() end
-
----Gets the value of the AutoCompleteShowBorder property.
----@param self TextBox self
----@return boolean true Whether to render a character border around the popup
-function TextBox:getAutoCompleteShowBorder(self) end
-
----Gets the value of the AutoCompleteOffsetX property.
----@param self TextBox self
----@return number 0 Horizontal offset applied to the popup frame relative to the TextBox
-function TextBox:getAutoCompleteOffsetX(self) end
-
----Sets the value of the AutoCompleteEnabled property.
----@param self TextBox self
----@param AutoCompleteEnabled boolean Whether autocomplete suggestions are enabled
-function TextBox:setAutoCompleteEnabled(self, AutoCompleteEnabled) end
-
----Sets the value of the AutoCompleteAcceptOnEnter property.
----@param self TextBox self
----@param AutoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion
-function TextBox:setAutoCompleteAcceptOnEnter(self, AutoCompleteAcceptOnEnter) end
-
----Sets the value of the AutoCompleteZOffset property.
----@param self TextBox self
----@param AutoCompleteZOffset number Z-index offset applied to the popup frame
-function TextBox:setAutoCompleteZOffset(self, AutoCompleteZOffset) end
-
----Sets the value of the AutoCompleteMaxItems property.
----@param self TextBox self
----@param AutoCompleteMaxItems number Maximum number of visible suggestions
-function TextBox:setAutoCompleteMaxItems(self, AutoCompleteMaxItems) end
-
----Gets the value of the AutoCompleteSelectedForeground property.
----@param self TextBox self
----@return color white Foreground color for the selected suggestion
-function TextBox:getAutoCompleteSelectedForeground(self) end
-
----Sets the value of the AutoCompleteForeground property.
----@param self TextBox self
----@param AutoCompleteForeground color Foreground color of the suggestion popup
-function TextBox:setAutoCompleteForeground(self, AutoCompleteForeground) end
-
----Sets the value of the AutoCompleteMaxWidth property.
----@param self TextBox self
----@param AutoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width)
-function TextBox:setAutoCompleteMaxWidth(self, AutoCompleteMaxWidth) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was pressed
----@return boolean handled Whether the event was handled
----@protected
-function TextBox:key(key) end
-
----Gets the value of the AutoPairCharacters property.
----@param self TextBox self
----@return table { ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
-function TextBox:getAutoPairCharacters(self) end
-
----Sets the value of the AutoCompleteItems property.
----@param self TextBox self
----@param AutoCompleteItems table List of suggestions used when no provider is supplied
-function TextBox:setAutoCompleteItems(self, AutoCompleteItems) end
-
----Gets the value of the AutoCompleteItems property.
----@param self TextBox self
----@return table {} List of suggestions used when no provider is supplied
-function TextBox:getAutoCompleteItems(self) end
-
----Removes a syntax pattern by index (1-based)
----@param index number The index of the pattern to remove
----@return TextBox self
-function TextBox:removeSyntaxPattern(index) end
-
----Sets the value of the AutoCompleteBorderColor property.
----@param self TextBox self
----@param AutoCompleteBorderColor color Color of the popup border when enabled
-function TextBox:setAutoCompleteBorderColor(self, AutoCompleteBorderColor) end
-
----Gets the value of the AutoCompleteMaxItems property.
----@param self TextBox self
----@return number 6 Maximum number of visible suggestions
-function TextBox:getAutoCompleteMaxItems(self) end
-
----Sets the value of the AutoPairOverType property.
----@param self TextBox self
----@param AutoPairOverType boolean When pressing a closing char that matches the next char, move over it instead of inserting
-function TextBox:setAutoPairOverType(self, AutoPairOverType) end
-
----Gets the value of the Editable property.
----@param self TextBox self
----@return boolean true Whether text can be edited
-function TextBox:getEditable(self) end
-
----Sets the value of the AutoCompleteProvider property.
----@param self TextBox self
----@param AutoCompleteProvider function Optional suggestion provider returning a list for the current prefix
-function TextBox:setAutoCompleteProvider(self, AutoCompleteProvider) end
-
----Sets the value of the ScrollX property.
----@param self TextBox self
----@param ScrollX number Horizontal scroll offset
-function TextBox:setScrollX(self, ScrollX) end
-
----Gets the value of the ScrollX property.
----@param self TextBox self
----@return number 0 Horizontal scroll offset
-function TextBox:getScrollX(self) end
-
----Sets the value of the AutoCompleteCaseInsensitive property.
----@param self TextBox self
----@param AutoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively
-function TextBox:setAutoCompleteCaseInsensitive(self, AutoCompleteCaseInsensitive) end
-
----Gets the value of the AutoCompleteProvider property.
----@param self TextBox self
----@return function nil Optional suggestion provider returning a list for the current prefix
-function TextBox:getAutoCompleteProvider(self) end
-
----Gets the value of the AutoCompleteAcceptOnClick property.
----@param self TextBox self
----@return boolean true Whether clicking a suggestion accepts it immediately
-function TextBox:getAutoCompleteAcceptOnClick(self) end
-
----Sets the value of the AutoCompleteMinChars property.
----@param self TextBox self
----@param AutoCompleteMinChars number Minimum characters required before showing suggestions
-function TextBox:setAutoCompleteMinChars(self, AutoCompleteMinChars) end
-
-function TextBox:destroy() end
-
----Sets the value of the SyntaxPatterns property.
----@param self TextBox self
----@param SyntaxPatterns table Syntax highlighting patterns
-function TextBox:setSyntaxPatterns(self, SyntaxPatterns) end
-
----Gets the value of the CursorX property.
----@param self TextBox self
----@return number 1 Cursor X position
-function TextBox:getCursorX(self) end
-
----Gets the value of the AutoCompleteCloseOnEscape property.
----@param self TextBox self
----@return boolean true Whether pressing Escape closes the popup
-function TextBox:getAutoCompleteCloseOnEscape(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function TextBox:render() end
-
----Gets the value of the SyntaxPatterns property.
----@param self TextBox self
----@return table {} Syntax highlighting patterns
-function TextBox:getSyntaxPatterns(self) end
-
----Gets the text of the TextBox
----@return string text The text of the TextBox
-function TextBox:getText() end
-
----Sets the value of the AutoCompleteSelectedForeground property.
----@param self TextBox self
----@param AutoCompleteSelectedForeground color Foreground color for the selected suggestion
-function TextBox:setAutoCompleteSelectedForeground(self, AutoCompleteSelectedForeground) end
-
----Sets the value of the AutoCompleteBackground property.
----@param self TextBox self
----@param AutoCompleteBackground color Background color of the suggestion popup
-function TextBox:setAutoCompleteBackground(self, AutoCompleteBackground) end
-
----Sets the text of the TextBox
----@param text string The text to set
----@return TextBox self The TextBox instance
-function TextBox:setText(text) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function TextBox:paste() end
-
----Sets the value of the CursorY property.
----@param self TextBox self
----@param CursorY number Cursor Y position (line number)
-function TextBox:setCursorY(self, CursorY) end
-
----Sets the value of the ScrollY property.
----@param self TextBox self
----@param ScrollY number Vertical scroll offset
-function TextBox:setScrollY(self, ScrollY) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction
----@param x number The x position of the scroll
----@param y number The y position of the scroll
----@return boolean handled Whether the event was handled
----@protected
-function TextBox:mouse_scroll(direction, x, y) end
-
----Gets the value of the AutoCompleteZOffset property.
----@param self TextBox self
----@return number 1 Z-index offset applied to the popup frame
-function TextBox:getAutoCompleteZOffset(self) end
-
----Gets the value of the AutoCompleteMinChars property.
----@param self TextBox self
----@return number 1 Minimum characters required before showing suggestions
-function TextBox:getAutoCompleteMinChars(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param char string The character that was typed
----@return boolean handled Whether the event was handled
----@protected
-function TextBox:char(char) end
-
----Updates the viewport to keep the cursor in view
----@return TextBox self The TextBox instance
-function TextBox:updateViewport() end
-
----Adds a new syntax highlighting pattern
----@param pattern string The regex pattern to match
----@param color number The color to apply
----@return TextBox self The TextBox instance
-function TextBox:addSyntaxPattern(pattern, color) end
-
----Sets the value of the AutoPairEnabled property.
----@param self TextBox self
----@param AutoPairEnabled boolean Whether automatic bracket/quote pairing is enabled
-function TextBox:setAutoPairEnabled(self, AutoPairEnabled) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return TextBox self The initialized instance
----@protected
-function TextBox:init(props, basalt) end
-
----Sets the value of the AutoCompleteCloseOnEscape property.
----@param self TextBox self
----@param AutoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup
-function TextBox:setAutoCompleteCloseOnEscape(self, AutoCompleteCloseOnEscape) end
-
----Gets the value of the AutoCompleteBorderColor property.
----@param self TextBox self
----@return color black Color of the popup border when enabled
-function TextBox:getAutoCompleteBorderColor(self) end
-
----Gets the value of the AutoPairNewlineIndent property.
----@param self TextBox self
----@return boolean true On Enter between matching braces, create blank line and keep closing aligned
-function TextBox:getAutoPairNewlineIndent(self) end
-
----Sets the value of the AutoPairNewlineIndent property.
----@param self TextBox self
----@param AutoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned
-function TextBox:setAutoPairNewlineIndent(self, AutoPairNewlineIndent) end
-
----Sets the value of the AutoCompleteShowBorder property.
----@param self TextBox self
----@param AutoCompleteShowBorder boolean Whether to render a character border around the popup
-function TextBox:setAutoCompleteShowBorder(self, AutoCompleteShowBorder) end
-
----Gets the value of the CursorColor property.
----@param self TextBox self
----@return number nil Color of the cursor
-function TextBox:getCursorColor(self) end
-
----Gets the value of the AutoCompleteOffsetY property.
----@param self TextBox self
----@return number 1 Vertical offset applied to the popup frame relative to the TextBox bottom edge
-function TextBox:getAutoCompleteOffsetY(self) end
-
----Gets the value of the AutoCompleteBackground property.
----@param self TextBox self
----@return color lightGray Background color of the suggestion popup
-function TextBox:getAutoCompleteBackground(self) end
-
----Sets the value of the AutoPairSkipClosing property.
----@param self TextBox self
----@param AutoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor
-function TextBox:setAutoPairSkipClosing(self, AutoPairSkipClosing) end
-
----Gets the value of the Lines property.
----@param self TextBox self
----@return table {} Array of text lines
-function TextBox:getLines(self) end
-
----Gets the value of the AutoPairEnabled property.
----@param self TextBox self
----@return boolean true Whether automatic bracket/quote pairing is enabled
-function TextBox:getAutoPairEnabled(self) end
-
----Sets the value of the AutoCompleteOffsetX property.
----@param self TextBox self
----@param AutoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox
-function TextBox:setAutoCompleteOffsetX(self, AutoCompleteOffsetX) end
-
----Gets the value of the AutoCompleteCaseInsensitive property.
----@param self TextBox self
----@return boolean true Whether suggestions should match case-insensitively
-function TextBox:getAutoCompleteCaseInsensitive(self) end
-
----Sets the value of the Editable property.
----@param self TextBox self
----@param Editable boolean Whether text can be edited
-function TextBox:setEditable(self, Editable) end
-
----Gets the value of the AutoCompleteTokenPattern property.
----@param self TextBox self
----@return string "[%w_]+" Pattern used to extract the current token for suggestions
-function TextBox:getAutoCompleteTokenPattern(self) end
-
----Gets the value of the AutoCompleteMaxWidth property.
----@param self TextBox self
----@return number 0 Maximum width of the autocomplete popup (0 uses the textbox width)
-function TextBox:getAutoCompleteMaxWidth(self) end
-
----Sets the value of the AutoCompleteSelectedBackground property.
----@param self TextBox self
----@param AutoCompleteSelectedBackground color Background color for the selected suggestion
-function TextBox:setAutoCompleteSelectedBackground(self, AutoCompleteSelectedBackground) end
-
----Sets the value of the CursorX property.
----@param self TextBox self
----@param CursorX number Cursor X position
-function TextBox:setCursorX(self, CursorX) end
-
----Sets the value of the AutoCompleteOffsetY property.
----@param self TextBox self
----@param AutoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge
-function TextBox:setAutoCompleteOffsetY(self, AutoCompleteOffsetY) end
-
----Sets the value of the AutoCompleteTokenPattern property.
----@param self TextBox self
----@param AutoCompleteTokenPattern string Pattern used to extract the current token for suggestions
-function TextBox:setAutoCompleteTokenPattern(self, AutoCompleteTokenPattern) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function TextBox:mouse_click(button, x, y) end
-
----Sets the value of the AutoPairCharacters property.
----@param self TextBox self
----@param AutoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
-function TextBox:setAutoPairCharacters(self, AutoPairCharacters) end
-
----Gets the value of the AutoPairSkipClosing property.
----@param self TextBox self
----@return boolean true Skip inserting a closing char if the same one is already at cursor
-function TextBox:getAutoPairSkipClosing(self) end
-
----Gets the value of the CursorY property.
----@param self TextBox self
----@return number 1 Cursor Y position (line number)
-function TextBox:getCursorY(self) end
-
----Gets the value of the AutoCompleteEnabled property.
----@param self TextBox self
----@return boolean false Whether autocomplete suggestions are enabled
-function TextBox:getAutoCompleteEnabled(self) end
-
----Gets the value of the AutoCompleteSelectedBackground property.
----@param self TextBox self
----@return color gray Background color for the selected suggestion
-function TextBox:getAutoCompleteSelectedBackground(self) end
-
----@class SideNav : Container
----@field activeTabTextColor color Foreground color for the active navigation item text
----@field activeTabBackground color Background color for the active navigation item
----@field sidebarScrollOffset number Current scroll offset for navigation items in scrollable mode
----@field activeTab number The currently active navigation item ID
----@field sidebarPosition string Position of the sidebar ("left" or "right")
----@field sidebarWidth number Width of the sidebar navigation area
----@field tabs table List of navigation item definitions
----@field sidebarBackground color Background color for the sidebar area
-local SideNav = {}
-
----@param element table The element to assign to a navigation item
----@param tabId number The ID of the navigation item to assign the element to
----@return SideNav self For method chaining
-function SideNav:setTab(element, tabId) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function SideNav:init(props, basalt) end
-
----Sets the value of the SidebarBackground property.
----@param self SideNav self
----@param SidebarBackground color Background color for the sidebar area
-function SideNav:setSidebarBackground(self, SidebarBackground) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click (global)
----@param y number The y position of the click (global)
----@return boolean Whether the event was handled
----@protected
-function SideNav:mouse_click(button, x, y) end
-
----Sets the value of the SidebarPosition property.
----@param self SideNav self
----@param SidebarPosition string Position of the sidebar ("left" or "right")
-function SideNav:setSidebarPosition(self, SidebarPosition) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@return number xOffset The X offset for content
----@protected
-function SideNav:getContentXOffset() end
-
----@param elementType string The type of element to add
----@param tabId number Optional navigation item ID, defaults to active item
----@return table element The created element
-function SideNav:addElement(elementType, tabId) end
-
-function SideNav:mouse_scroll() end
-
-function SideNav:blit() end
-
----returns a proxy for adding elements to the navigation item
----@param title string The title of the navigation item
----@return table tabHandler The navigation item handler proxy for adding elements
-function SideNav:newTab(title) end
-
----Sets the value of the Tabs property.
----@param self SideNav self
----@param Tabs table List of navigation item definitions
-function SideNav:setTabs(self, Tabs) end
-
----Sets the value of the SidebarWidth property.
----@param self SideNav self
----@param SidebarWidth number Width of the sidebar navigation area
-function SideNav:setSidebarWidth(self, SidebarWidth) end
-
-function SideNav:mouse_up() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param child table The child element to add
----@return Container self For method chaining
----@protected
-function SideNav:addChild(child) end
-
-function SideNav:textBg() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function SideNav:render() end
-
----Gets the value of the ActiveTab property.
----@param self SideNav self
----@return number nil The currently active navigation item ID
-function SideNav:getActiveTab(self) end
-
-function SideNav:getRelativePosition() end
-
----Sets the value of the ActiveTabBackground property.
----@param self SideNav self
----@param ActiveTabBackground color Background color for the active navigation item
-function SideNav:setActiveTabBackground(self, ActiveTabBackground) end
-
----Sets the value of the ActiveTabTextColor property.
----@param self SideNav self
----@param ActiveTabTextColor color Foreground color for the active navigation item text
-function SideNav:setActiveTabTextColor(self, ActiveTabTextColor) end
-
----Gets the value of the ActiveTabBackground property.
----@param self SideNav self
----@return color white Background color for the active navigation item
-function SideNav:getActiveTabBackground(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function SideNav:sortChildrenEvents() end
-
-function SideNav:setCursor() end
-
-function SideNav:drawFg() end
-
----Sets the value of the SidebarScrollOffset property.
----@param self SideNav self
----@param SidebarScrollOffset number Current scroll offset for navigation items in scrollable mode
-function SideNav:setSidebarScrollOffset(self, SidebarScrollOffset) end
-
----Scrolls the sidebar up or down
----@param direction number -1 to scroll up, 1 to scroll down
----@return SideNav self For method chaining
-function SideNav:scrollSidebar(direction) end
-
-function SideNav:mouse_move() end
-
-function SideNav:mouse_drag() end
-
----@param tabId number The ID of the navigation item to activate
-function SideNav:setActiveTab(tabId) end
-
-function SideNav:mouse_release() end
-
-function SideNav:drawBg() end
-
----Gets the value of the SidebarPosition property.
----@param self SideNav self
----@return string left Position of the sidebar ("left" or "right")
-function SideNav:getSidebarPosition(self) end
-
-function SideNav:drawText() end
-
----Gets the value of the ActiveTabTextColor property.
----@param self SideNav self
----@return color black Foreground color for the active navigation item text
-function SideNav:getActiveTabTextColor(self) end
-
-function SideNav:multiBlit() end
-
----Gets the value of the SidebarScrollOffset property.
----@param self SideNav self
----@return number 0 Current scroll offset for navigation items in scrollable mode
-function SideNav:getSidebarScrollOffset(self) end
-
----Gets the value of the SidebarBackground property.
----@param self SideNav self
----@return color gray Background color for the sidebar area
-function SideNav:getSidebarBackground(self) end
-
----Gets the value of the Tabs property.
----@param self SideNav self
----@return table {} List of navigation item definitions
-function SideNav:getTabs(self) end
-
----Gets the value of the SidebarWidth property.
----@param self SideNav self
----@return number 12 Width of the sidebar navigation area
-function SideNav:getSidebarWidth(self) end
-
-function SideNav:_getSidebarMetrics() end
-
-function SideNav:textFg() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param child table The child element to check
----@return boolean Whether the child should be visible
----@protected
-function SideNav:isChildVisible(child) end
-
 ---@class VisualElement : BaseElement
----@field borderTop boolean Draw top border
----@field borderRight boolean Draw right border
----@field backgroundEnabled boolean Whether to render the background
----@field clicked boolean Whether the element is currently clicked
+---@field visible boolean Whether the element is visible
+---@field borderColor color Border color
+---@field height number The height of the element
 ---@field borderBottom boolean Draw bottom border
 ---@field width number The width of the element
----@field x number The horizontal position relative to parent
----@field focused boolean Whether the element has input focus
----@field z number The z-index for layering elements
----@field y number The vertical position relative to parent
----@field borderLeft boolean Draw left border
----@field borderColor color Border color
----@field foreground color The text/foreground color
----@field height number The height of the element
----@field ignoreOffset boolean Whether to ignore the parent's offset
----@field visible boolean Whether the element is visible
----@field hover boolean Whether the mouse is currently hover over the element (Craftos-PC only)
+---@field borderRight boolean Draw right border
 ---@field background color The background color
+---@field y number The vertical position relative to parent
+---@field foreground color The text/foreground color
+---@field backgroundEnabled boolean Whether to render the background
+---@field borderLeft boolean Draw left border
+---@field ignoreOffset boolean Whether to ignore the parent's offset
+---@field x number The horizontal position relative to parent
+---@field borderTop boolean Draw top border
+---@field z number The z-index for layering elements
 local VisualElement = {}
 
+---Aligns the element's bottom edge to its parent's bottom edge with optional gap
+---@return VisualElement self
+function VisualElement:toBottom() end
+
+---Returns the relative position of the element or the given coordinates.
+---@return number x The relative x position
+---@return number y The relative y position
+function VisualElement:getRelativePosition() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function VisualElement:render() end
+
+---Registers a function to handle the onClick event.
+---@param button string
+---@param x number
+---@param y number
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnClick(self, func) end
+
+---Sets the value of the Y property.
+---@param self VisualElement self
+---@param Y number The vertical position relative to parent
+function VisualElement:setY(self, Y) end
+
+---Matches the element's height to the target's height with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:matchHeight(target) end
+
+function VisualElement:drawText() end
+
+---Sets or removes focus from this element
+---@param focused boolean Whether to focus or blur
+---@return VisualElement self
+function VisualElement:setFocused(focused) end
+
+---Positions the element below the target with optional gap
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:below(target) end
+
+---Resolves all constraints for the element
+---@return VisualElement self The element instance
+function VisualElement:resolveAllConstraints() end
+
+---Aligns the element's top edge to the target's top edge with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:alignTop(target) end
+
+---Sets the value of the BackgroundEnabled property.
+---@param self VisualElement self
+---@param BackgroundEnabled boolean Whether to render the background
+function VisualElement:setBackgroundEnabled(self, BackgroundEnabled) end
+
+---Gets the value of the Width property.
+---@param self VisualElement self
+---@return number 1 The width of the element
+function VisualElement:getWidth(self) end
+
+---Gets the value of the Height property.
+---@param self VisualElement self
+---@return number 1 The height of the element
+function VisualElement:getHeight(self) end
+
+function VisualElement:drawFg() end
+
+function VisualElement:destroy() end
+
+---Sets the value of the IgnoreOffset property.
+---@param self VisualElement self
+---@param IgnoreOffset boolean Whether to ignore the parent's offset
+function VisualElement:setIgnoreOffset(self, IgnoreOffset) end
+
+---Sets the element's width as a percentage of the target's width
+---@param target BaseElement |string The target element or "parent"
+---@param percent number Percentage of target's width (0-100)
+---@return VisualElement self
+function VisualElement:widthPercent(target, percent) end
+
+---Sets the value of the BorderTop property.
+---@param self VisualElement self
+---@param BorderTop boolean Draw top border
+function VisualElement:setBorderTop(self, BorderTop) end
+
+---Gets the value of the BorderBottom property.
+---@param self VisualElement self
+---@return boolean false Draw bottom border
+function VisualElement:getBorderBottom(self) end
+
+---Sets the element's height as a percentage of the target's height
+---@param target BaseElement |string The target element or "parent"
+---@param percent number Percentage of target's height (0-100)
+---@return VisualElement self
+function VisualElement:heightPercent(target, percent) end
+
+---Gets the value of the Z property.
+---@param self VisualElement self
+---@return number 1 The z-index for layering elements
+function VisualElement:getZ(self) end
+
+---Stretches the element to fill its parent's width with optional margin
+---@return VisualElement self
+function VisualElement:fillWidth() end
+
+---Stretches the element to match the target's height with optional margin
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:stretchHeight(target) end
+
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param button number The button that was clicked
 ---@param x number The x position of the click
@@ -2592,116 +3474,83 @@ local VisualElement = {}
 ---@protected
 function VisualElement:mouse_click(button, x, y) end
 
----Sets the value of the Y property.
+---Gets the value of the BorderLeft property.
 ---@param self VisualElement self
----@param Y number The vertical position relative to parent
-function VisualElement:setY(self, Y) end
-
-function VisualElement:drawBg() end
-
----Registers a function to handle the onRelease event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnRelease(self, func) end
-
----Gets the value of the Visible property.
----@param self VisualElement self
----@return boolean true Whether the element is visible
-function VisualElement:getVisible(self) end
-
----Gets the value of the Width property.
----@param self VisualElement self
----@return number 1 The width of the element
-function VisualElement:getWidth(self) end
-
----Gets the value of the Z property.
----@param self VisualElement self
----@return number 1 The z-index for layering elements
-function VisualElement:getZ(self) end
-
----Gets the value of the Clicked property.
----@param self VisualElement self
----@return boolean false Whether the element is currently clicked
-function VisualElement:getClicked(self) end
-
----Gets the value of the Height property.
----@param self VisualElement self
----@return number 1 The height of the element
-function VisualElement:getHeight(self) end
-
----Registers a function to handle the onLeave event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnLeave(self, func) end
-
----Sets the value of the Height property.
----@param self VisualElement self
----@param Height number The height of the element
-function VisualElement:setHeight(self, Height) end
-
----Creates a new Animation Object
----@return Animation animation The new animation
-function VisualElement:animate() end
-
----Adds or updates a drawable character border around the element using the canvas plugin.
-The border will automatically adapt to size/background changes because the command
-reads current properties each render.
----@param colorOrOptions any Border color or options table
----@return VisualElement self
-function VisualElement:addBorder(colorOrOptions) end
-
----Sets the value of the Z property.
----@param self VisualElement self
----@param Z number The z-index for layering elements
-function VisualElement:setZ(self, Z) end
+---@return boolean false Draw left border
+function VisualElement:getBorderLeft(self) end
 
 ---Gets the value of the Foreground property.
 ---@param self VisualElement self
 ---@return color white The text/foreground color
 function VisualElement:getForeground(self) end
 
----Gets the value of the BorderBottom property.
+---Sets a constraint on a property relative to another element's property
+---@param property string The property to constrain (x, y, width, height, left, right, top, bottom, centerX, centerY)
+---@param targetElement BaseElement |string The target element or "parent"
+---@param targetProperty string The target property to constrain to (left, right, top, bottom, centerX, centerY, width, height)
+---@param offset number The offset to apply (negative = inside, positive = outside, fractional = percentage)
+---@return VisualElement self The element instance
+function VisualElement:setConstraint(property, targetElement, targetProperty, offset) end
+
+---Sets the value of the X property.
 ---@param self VisualElement self
----@return boolean false Draw bottom border
-function VisualElement:getBorderBottom(self) end
+---@param X number The horizontal position relative to parent
+function VisualElement:setX(self, X) end
+
+---Sets the value of the Height property.
+---@param self VisualElement self
+---@param Height number The height of the element
+function VisualElement:setHeight(self, Height) end
+
+---Registers a function to handle the onKeyUp event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnKeyUp(self, func) end
+
+---Registers a function to handle the onLeave event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnLeave(self, func) end
+
+---Positions the element above the target with optional gap
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:above(target) end
+
+---Sets the value of the Width property.
+---@param self VisualElement self
+---@param Width number The width of the element
+function VisualElement:setWidth(self, Width) end
+
+---Aligns the element's top edge to its parent's top edge with optional gap
+---@return VisualElement self
+function VisualElement:toTop() end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was released
----@param x number The x position of the release
----@param y number The y position of the release
+---@param key number The key that was released
 ---@protected
-function VisualElement:mouse_release(button, x, y) end
+function VisualElement:key_up(key) end
+
+---Centers the element horizontally relative to the target with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:centerHorizontal(target) end
+
+---Removes a constraint from the element
+---@param property string The property of the constraint to remove
+---@return VisualElement self The element instance
+function VisualElement:removeConstraint(property) end
+
+---Centers the element vertically relative to the target with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:centerVertical(target) end
 
 ---Sets the value of the Foreground property.
 ---@param self VisualElement self
 ---@param Foreground color The text/foreground color
 function VisualElement:setForeground(self, Foreground) end
 
----Gets the value of the BorderColor property.
----@param self VisualElement self
----@return color white Border color
-function VisualElement:getBorderColor(self) end
-
----Registers a function to handle the onDrag event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnDrag(self, func) end
-
----Gets the value of the Focused property.
----@param self VisualElement self
----@return boolean false Whether the element has input focus
-function VisualElement:getFocused(self) end
-
----Gets the value of the IgnoreOffset property.
----@param self VisualElement self
----@return boolean false Whether to ignore the parent's offset
-function VisualElement:getIgnoreOffset(self) end
-
----Returns the absolute position of the element or the given coordinates.
----@return number x The absolute x position
----@return number y The absolute y position
-function VisualElement:getAbsolutePosition() end
-
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param x number The x position to draw
 ---@param y number The y position to draw
@@ -2711,39 +3560,272 @@ function VisualElement:getAbsolutePosition() end
 ---@protected
 function VisualElement:blit(x, y, text, fg, bg) end
 
----Gets the value of the BorderLeft property.
+---Gets the value of the Y property.
 ---@param self VisualElement self
----@return boolean false Draw left border
-function VisualElement:getBorderLeft(self) end
+---@return number 1 The vertical position relative to parent
+function VisualElement:getY(self) end
 
----Gets the value of the BorderRight property.
+---Gets the value of the BorderColor property.
 ---@param self VisualElement self
----@return boolean false Draw right border
-function VisualElement:getBorderRight(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function VisualElement:postRender() end
+---@return color white Border color
+function VisualElement:getBorderColor(self) end
 
 ---Calculates the position of the element relative to its parent
 ---@return number x The x position
 ---@return number y The y position
 function VisualElement:calculatePosition() end
 
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@protected
+function VisualElement:init(props, basalt) end
+
+---Sets the value of the Background property.
+---@param self VisualElement self
+---@param Background color The background color
+function VisualElement:setBackground(self, Background) end
+
+---Centers the element both horizontally and vertically relative to the target
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:centerIn(target) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function VisualElement:postRender() end
+
+---Registers a function to handle the onKey event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnKey(self, func) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked while dragging
+---@param x number The x position of the drag
+---@param y number The y position of the drag
+---@return boolean drag Whether the element was dragged
+---@protected
+function VisualElement:mouse_drag(button, x, y) end
+
+---Stretches the element to match the target's width with optional margin
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:stretchWidth(target) end
+
+---Matches the element's width to the target's width with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:matchWidth(target) end
+
+---Registers a function to handle the onFocus event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnFocus(self, func) end
+
+---Gets the value of the X property.
+---@param self VisualElement self
+---@return number 1 The horizontal position relative to parent
+function VisualElement:getX(self) end
+
+---Registers a function to handle the onBlur event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnBlur(self, func) end
+
+---Centers the element within its parent both horizontally and vertically
+---@return VisualElement self
+function VisualElement:center() end
+
+---Registers a function to handle the onMouseUp event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnMouseUp(self, func) end
+
+---Sets the value of the BorderBottom property.
+---@param self VisualElement self
+---@param BorderBottom boolean Draw bottom border
+function VisualElement:setBorderBottom(self, BorderBottom) end
+
+---Stretches the element to match the target's width and height with optional margin
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:stretch(target) end
+
+---Updates all constraints, recalculating positions and sizes
+---@return VisualElement self The element instance
+function VisualElement:updateConstraints() end
+
 ---Gets the value of the Background property.
 ---@param self VisualElement self
 ---@return color black The background color
 function VisualElement:getBackground(self) end
 
----Sets the value of the BorderRight property.
+---Sets the value of the BorderLeft property.
 ---@param self VisualElement self
----@param BorderRight boolean Draw right border
-function VisualElement:setBorderRight(self, BorderRight) end
+---@param BorderLeft boolean Draw left border
+function VisualElement:setBorderLeft(self, BorderLeft) end
 
----Sets the value of the Focused property.
+---Creates a new Animation Object
+---@return Animation animation The new animation
+function VisualElement:animate() end
+
+---Sets the value of the BorderColor property.
 ---@param self VisualElement self
----@param Focused boolean Whether the element has input focus
-function VisualElement:setFocused(self, Focused) end
+---@param BorderColor color Border color
+function VisualElement:setBorderColor(self, BorderColor) end
+
+---Registers a function to handle the onRelease event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnRelease(self, func) end
+
+---Aligns the element's right edge to its parent's right edge with optional gap
+---@return VisualElement self
+function VisualElement:toRight() end
+
+---Sets the value of the Z property.
+---@param self VisualElement self
+---@param Z number The z-index for layering elements
+function VisualElement:setZ(self, Z) end
+
+---Gets whether this element is focused
+---@return boolean isFocused
+function VisualElement:isFocused() end
+
+---Stretches the element to fill its parent's height with optional margin
+---@return VisualElement self
+function VisualElement:fillHeight() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param _ number unknown
+---@param x number The x position of the mouse
+---@param y number The y position of the mouse
+---@return boolean hover Whether the mouse has moved over the element
+---@protected
+function VisualElement:mouse_move(_, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to draw
+---@param y number The y position to draw
+---@param text string The text char to draw
+---@param bg color The background color
+---@protected
+function VisualElement:textBg(x, y, text, bg) end
+
+---Sets the value of the Visible property.
+---@param self VisualElement self
+---@param Visible boolean Whether the element is visible
+function VisualElement:setVisible(self, Visible) end
+
+---Stretches the element to fill its parent's width and height with optional margin
+---@return VisualElement self
+function VisualElement:fillParent() end
+
+---Aligns the element's bottom edge to the target's bottom edge with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:alignBottom(target) end
+
+---Adds or updates a drawable character border around the element using the canvas plugin.
+The border will automatically adapt to size/background changes because the command
+reads current properties each render.
+---@param colorOrOptions any Border color or options table
+---@return VisualElement self
+function VisualElement:addBorder(colorOrOptions) end
+
+---Registers a function to handle the onChar event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnChar(self, func) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function VisualElement:focus() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction
+---@param x number The x position of the scroll
+---@param y number The y position of the scroll
+---@return boolean scroll Whether the element was scrolled
+---@protected
+function VisualElement:mouse_scroll(direction, x, y) end
+
+---Positions the element to the left of the target with optional gap
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:leftOf(target) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was released
+---@param x number The x position of the release
+---@param y number The y position of the release
+---@return boolean release Whether the element was released on the element
+---@protected
+function VisualElement:mouse_up(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param key number The key that was pressed
+---@protected
+function VisualElement:key(key) end
+
+---Returns the absolute position of the element or the given coordinates.
+---@return number x The absolute x position
+---@return number y The absolute y position
+function VisualElement:getAbsolutePosition() end
+
+---Gets the value of the Visible property.
+---@param self VisualElement self
+---@return boolean true Whether the element is visible
+function VisualElement:getVisible(self) end
+
+---Registers a function to handle the onDrag event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnDrag(self, func) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function VisualElement:blur() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param char string The character that was pressed
+---@protected
+function VisualElement:char(char) end
+
+---Gets the value of the BorderRight property.
+---@param self VisualElement self
+---@return boolean false Draw right border
+function VisualElement:getBorderRight(self) end
+
+---Gets the value of the IgnoreOffset property.
+---@param self VisualElement self
+---@return boolean false Whether to ignore the parent's offset
+function VisualElement:getIgnoreOffset(self) end
+
+---Aligns the element's left edge to the target's left edge with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:alignLeft(target) end
+
+---Positions the element to the right of the target with optional gap
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:rightOf(target) end
+
+---Registers a function to handle the onEnter event.
+---@param self VisualElement self
+---@param func function The function to be called when the event fires
+function VisualElement:onOnEnter(self, func) end
+
+---Aligns the element's right edge to the target's right edge with optional offset
+---@param target BaseElement |string The target element or "parent"
+---@return VisualElement self
+function VisualElement:alignRight(target) end
+
+---Aligns the element's left edge to its parent's left edge with optional gap
+---@return VisualElement self
+function VisualElement:toLeft() end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param x number The x position to draw
@@ -2753,33 +3835,43 @@ function VisualElement:setFocused(self, Focused) end
 ---@protected
 function VisualElement:textFg(x, y, text, fg) end
 
----Sets the value of the IgnoreOffset property.
----@param self VisualElement self
----@param IgnoreOffset boolean Whether to ignore the parent's offset
-function VisualElement:setIgnoreOffset(self, IgnoreOffset) end
-
----Sets the value of the Visible property.
----@param self VisualElement self
----@param Visible boolean Whether the element is visible
-function VisualElement:setVisible(self, Visible) end
-
----Sets the value of the BorderBottom property.
----@param self VisualElement self
----@param BorderBottom boolean Draw bottom border
-function VisualElement:setBorderBottom(self, BorderBottom) end
-
----Sets the value of the Width property.
----@param self VisualElement self
----@param Width number The width of the element
-function VisualElement:setWidth(self, Width) end
+---Checks if the specified coordinates are within the bounds of the element
+---@param x number The x position to check
+---@param y number The y position to check
+---@return boolean isInBounds Whether the coordinates are within the bounds of the element
+function VisualElement:isInBounds(x, y) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to draw
----@param y number The y position to draw
----@param text string The text char to draw
----@param bg color The background color
+---@param x number The x position of the cursor
+---@param y number The y position of the cursor
+---@param blink boolean Whether the cursor should blink
+---@param color number The color of the cursor
+---@return VisualElement self The VisualElement instance
 ---@protected
-function VisualElement:textBg(x, y, text, bg) end
+function VisualElement:setCursor(x, y, blink, color) end
+
+function VisualElement:drawBg() end
+
+---This function is used to prioritize the element by moving it to the top of its parent's children. It removes the element from its parent and adds it back, effectively changing its order.
+---@return VisualElement self The VisualElement instance
+function VisualElement:prioritize() end
+
+---Gets the value of the BackgroundEnabled property.
+---@param self VisualElement self
+---@return boolean true Whether to render the background
+function VisualElement:getBackgroundEnabled(self) end
+
+---Removes the previously added border (if any)
+---@return VisualElement self
+function VisualElement:removeBorder() end
+
+---Convenience to stop animations from the element
+function VisualElement.stopAnimation() end
+
+---Gets the value of the BorderTop property.
+---@param self VisualElement self
+---@return boolean false Draw top border
+function VisualElement:getBorderTop(self) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param x number The x position to draw
@@ -2792,298 +3884,148 @@ function VisualElement:textBg(x, y, text, bg) end
 ---@protected
 function VisualElement:multiBlit(x, y, width, height, text, fg, bg) end
 
----Removes the previously added border (if any)
----@return VisualElement self
-function VisualElement:removeBorder() end
-
----Registers a function to handle the onBlur event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnBlur(self, func) end
-
----Registers a function to handle the onEnter event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnEnter(self, func) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param char string The character that was pressed
----@protected
-function VisualElement:char(char) end
-
----Returns the relative position of the element or the given coordinates.
----@return number x The relative x position
----@return number y The relative y position
-function VisualElement:getRelativePosition() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction
----@param x number The x position of the scroll
----@param y number The y position of the scroll
----@return boolean scroll Whether the element was scrolled
----@protected
-function VisualElement:mouse_scroll(direction, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function VisualElement:blur() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param _ number unknown
----@param x number The x position of the mouse
----@param y number The y position of the mouse
----@return boolean hover Whether the mouse has moved over the element
----@protected
-function VisualElement:mouse_move(_, x, y) end
-
----Gets the value of the Hover property.
----@param self VisualElement self
----@return boolean false Whether the mouse is currently hover over the element (Craftos-PC only)
-function VisualElement:getHover(self) end
-
----Registers a function to handle the onChar event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnChar(self, func) end
-
----Gets the value of the X property.
----@param self VisualElement self
----@return number 1 The horizontal position relative to parent
-function VisualElement:getX(self) end
-
----Registers a function to handle the onClick event.
----@param button string
----@param x number
----@param y number
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnClick(self, func) end
-
-function VisualElement:drawText() end
-
----Sets the value of the Clicked property.
----@param self VisualElement self
----@param Clicked boolean Whether the element is currently clicked
-function VisualElement:setClicked(self, Clicked) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function VisualElement:init(props, basalt) end
-
----Convenience to stop animations from the element
-function VisualElement.stopAnimation() end
-
----Sets the value of the X property.
----@param self VisualElement self
----@param X number The horizontal position relative to parent
-function VisualElement:setX(self, X) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked while dragging
----@param x number The x position of the drag
----@param y number The y position of the drag
----@return boolean drag Whether the element was dragged
----@protected
-function VisualElement:mouse_drag(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was released
----@protected
-function VisualElement:key_up(key) end
-
----Registers a function to handle the onKeyUp event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnKeyUp(self, func) end
-
----Registers a function to handle the onFocus event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnFocus(self, func) end
-
 ---Registers a function to handle the onScroll event.
 ---@param self VisualElement self
 ---@param func function The function to be called when the event fires
 function VisualElement:onOnScroll(self, func) end
 
----Gets the value of the BorderTop property.
+---Sets the value of the BorderRight property.
 ---@param self VisualElement self
----@return boolean false Draw top border
-function VisualElement:getBorderTop(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function VisualElement:focus() end
-
----Sets the value of the BackgroundEnabled property.
----@param self VisualElement self
----@param BackgroundEnabled boolean Whether to render the background
-function VisualElement:setBackgroundEnabled(self, BackgroundEnabled) end
-
----Sets the value of the BorderColor property.
----@param self VisualElement self
----@param BorderColor color Border color
-function VisualElement:setBorderColor(self, BorderColor) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function VisualElement:render() end
-
----Sets the value of the BorderLeft property.
----@param self VisualElement self
----@param BorderLeft boolean Draw left border
-function VisualElement:setBorderLeft(self, BorderLeft) end
-
----Registers a function to handle the onKey event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnKey(self, func) end
-
-function VisualElement:destroy() end
-
----Checks if the specified coordinates are within the bounds of the element
----@param x number The x position to check
----@param y number The y position to check
----@return boolean isInBounds Whether the coordinates are within the bounds of the element
-function VisualElement:isInBounds(x, y) end
-
----Registers a function to handle the onMouseUp event.
----@param self VisualElement self
----@param func function The function to be called when the event fires
-function VisualElement:onOnMouseUp(self, func) end
-
----This function is used to prioritize the element by moving it to the top of its parent's children. It removes the element from its parent and adds it back, effectively changing its order.
----@return VisualElement self The VisualElement instance
-function VisualElement:prioritize() end
-
----Sets the value of the Background property.
----@param self VisualElement self
----@param Background color The background color
-function VisualElement:setBackground(self, Background) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position of the cursor
----@param y number The y position of the cursor
----@param blink boolean Whether the cursor should blink
----@param color number The color of the cursor
----@return VisualElement self The VisualElement instance
----@protected
-function VisualElement:setCursor(x, y, blink, color) end
-
-function VisualElement:drawFg() end
-
----Gets the value of the BackgroundEnabled property.
----@param self VisualElement self
----@return boolean true Whether to render the background
-function VisualElement:getBackgroundEnabled(self) end
+---@param BorderRight boolean Draw right border
+function VisualElement:setBorderRight(self, BorderRight) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param button number The button that was released
 ---@param x number The x position of the release
 ---@param y number The y position of the release
----@return boolean release Whether the element was released on the element
 ---@protected
-function VisualElement:mouse_up(button, x, y) end
+function VisualElement:mouse_release(button, x, y) end
 
----Sets the value of the BorderTop property.
----@param self VisualElement self
----@param BorderTop boolean Draw top border
-function VisualElement:setBorderTop(self, BorderTop) end
+---@class TextBox : VisualElement
+---@field autoCompleteTokenPattern string Pattern used to extract the current token for suggestions
+---@field autoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively
+---@field autoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox
+---@field autoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned
+---@field autoCompleteProvider function Optional suggestion provider returning a list for the current prefix
+---@field lines table Array of text lines
+---@field autoCompleteEnabled boolean Whether autocomplete suggestions are enabled
+---@field scrollX number Horizontal scroll offset
+---@field autoCompleteMaxItems number Maximum number of visible suggestions
+---@field syntaxPatterns table Syntax highlighting patterns
+---@field autoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion
+---@field cursorX number Cursor X position
+---@field autoCompleteSelectedForeground color Foreground color for the selected suggestion
+---@field autoCompleteSelectedBackground color Background color for the selected suggestion
+---@field autoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width)
+---@field autoCompleteBorderColor color Color of the popup border when enabled
+---@field autoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor
+---@field autoCompleteMinChars number Minimum characters required before showing suggestions
+---@field cursorY number Cursor Y position (line number)
+---@field autoPairOverType boolean When pressing a closing char that matches the next char, move over it instead of inserting
+---@field cursorColor number Color of the cursor
+---@field autoCompleteItems table List of suggestions used when no provider is supplied
+---@field autoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge
+---@field editable boolean Whether text can be edited
+---@field autoCompleteBackground color Background color of the suggestion popup
+---@field autoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup
+---@field autoCompleteForeground color Foreground color of the suggestion popup
+---@field autoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
+---@field autoPairEnabled boolean Whether automatic bracket/quote pairing is enabled
+---@field autoCompleteShowBorder boolean Whether to render a character border around the popup
+---@field scrollY number Vertical scroll offset
+---@field autoCompleteZOffset number Z-index offset applied to the popup frame
+---@field autoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately
+local TextBox = {}
 
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was pressed
----@protected
-function VisualElement:key(key) end
+---Gets the value of the Editable property.
+---@param self TextBox self
+---@return boolean true Whether text can be edited
+function TextBox:getEditable(self) end
 
----Gets the value of the Y property.
----@param self VisualElement self
----@return number 1 The vertical position relative to parent
-function VisualElement:getY(self) end
+---Gets the value of the AutoCompleteBorderColor property.
+---@param self TextBox self
+---@return color black Color of the popup border when enabled
+function TextBox:getAutoCompleteBorderColor(self) end
 
----Sets the value of the Hover property.
----@param self VisualElement self
----@param Hover boolean Whether the mouse is currently hover over the element (Craftos-PC only)
-function VisualElement:setHover(self, Hover) end
+---Sets the value of the SyntaxPatterns property.
+---@param self TextBox self
+---@param SyntaxPatterns table Syntax highlighting patterns
+function TextBox:setSyntaxPatterns(self, SyntaxPatterns) end
 
----@class BigFont : VisualElement
----@field fontSize number Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
----@field text string The text string to display in enlarged format
-local BigFont = {}
+---Sets the value of the AutoCompleteShowBorder property.
+---@param self TextBox self
+---@param AutoCompleteShowBorder boolean Whether to render a character border around the popup
+function TextBox:setAutoCompleteShowBorder(self, AutoCompleteShowBorder) end
 
----Sets the value of the FontSize property.
----@param self BigFont self
----@param FontSize number Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
-function BigFont:setFontSize(self, FontSize) end
+---Sets the text of the TextBox
+---@param text string The text to set
+---@return TextBox self The TextBox instance
+function TextBox:setText(text) end
 
----Sets the value of the Text property.
----@param self BigFont self
----@param Text string The text string to display in enlarged format
-function BigFont:setText(self, Text) end
+---Sets the value of the AutoCompleteMaxWidth property.
+---@param self TextBox self
+---@param AutoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width)
+function TextBox:setAutoCompleteMaxWidth(self, AutoCompleteMaxWidth) end
 
----Gets the value of the Text property.
----@param self BigFont self
----@return string BigFont The text string to display in enlarged format
-function BigFont:getText(self) end
+---Sets the value of the AutoCompleteSelectedForeground property.
+---@param self TextBox self
+---@param AutoCompleteSelectedForeground color Foreground color for the selected suggestion
+function TextBox:setAutoCompleteSelectedForeground(self, AutoCompleteSelectedForeground) end
 
----Gets the value of the FontSize property.
----@param self BigFont self
----@return number 1 Scale factor for text size (1-3, where 1 is 3x3 pixels per character)
-function BigFont:getFontSize(self) end
+---Sets the value of the AutoCompleteOffsetY property.
+---@param self TextBox self
+---@param AutoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge
+function TextBox:setAutoCompleteOffsetY(self, AutoCompleteOffsetY) end
 
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function BigFont:init(props, basalt) end
+---Gets the value of the AutoCompleteItems property.
+---@param self TextBox self
+---@return table {} List of suggestions used when no provider is supplied
+function TextBox:getAutoCompleteItems(self) end
 
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function BigFont:render() end
+---Gets the value of the CursorX property.
+---@param self TextBox self
+---@return number 1 Cursor X position
+function TextBox:getCursorX(self) end
 
----@class DropDown : List
----@field isOpen boolean Controls the expanded/collapsed state
----@field dropSymbol string Indicator for dropdown state
----@field dropdownHeight number Maximum visible items when expanded
----@field selectedText string Text shown when no selection made
-local DropDown = {}
+---Gets the value of the AutoCompleteCaseInsensitive property.
+---@param self TextBox self
+---@return boolean true Whether suggestions should match case-insensitively
+function TextBox:getAutoCompleteCaseInsensitive(self) end
 
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return DropDown self The initialized instance
----@protected
-function DropDown:init(props, basalt) end
+---Gets the value of the AutoCompleteShowBorder property.
+---@param self TextBox self
+---@return boolean true Whether to render a character border around the popup
+function TextBox:getAutoCompleteShowBorder(self) end
 
----Gets the value of the SelectedText property.
----@param self DropDown self
----@return string "" Text shown when no selection made
-function DropDown:getSelectedText(self) end
+---Gets the value of the AutoCompleteMaxItems property.
+---@param self TextBox self
+---@return number 6 Maximum number of visible suggestions
+function TextBox:getAutoCompleteMaxItems(self) end
 
----Gets the value of the DropdownHeight property.
----@param self DropDown self
----@return number 5 Maximum visible items when expanded
-function DropDown:getDropdownHeight(self) end
+---Gets the value of the ScrollX property.
+---@param self TextBox self
+---@return number 0 Horizontal scroll offset
+function TextBox:getScrollX(self) end
 
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function DropDown:render() end
+---Sets the value of the AutoPairCharacters property.
+---@param self TextBox self
+---@param AutoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
+function TextBox:setAutoPairCharacters(self, AutoPairCharacters) end
 
----Sets the value of the IsOpen property.
----@param self DropDown self
----@param IsOpen boolean Controls the expanded/collapsed state
-function DropDown:setIsOpen(self, IsOpen) end
+---Gets the value of the AutoCompleteForeground property.
+---@param self TextBox self
+---@return color black Foreground color of the suggestion popup
+function TextBox:getAutoCompleteForeground(self) end
 
----Sets the value of the DropSymbol property.
----@param self DropDown self
----@param DropSymbol string Indicator for dropdown state
-function DropDown:setDropSymbol(self, DropSymbol) end
+---Gets the value of the AutoCompleteAcceptOnClick property.
+---@param self TextBox self
+---@return boolean true Whether clicking a suggestion accepts it immediately
+function TextBox:getAutoCompleteAcceptOnClick(self) end
 
----Gets the value of the IsOpen property.
----@param self DropDown self
----@return boolean false Controls the expanded/collapsed state
-function DropDown:getIsOpen(self) end
+---Sets the value of the Editable property.
+---@param self TextBox self
+---@param Editable boolean Whether text can be edited
+function TextBox:setEditable(self, Editable) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param button number The button that was clicked
@@ -3091,99 +4033,462 @@ function DropDown:getIsOpen(self) end
 ---@param y number The y position of the click
 ---@return boolean handled Whether the event was handled
 ---@protected
-function DropDown:mouse_click(button, x, y) end
+function TextBox:mouse_click(button, x, y) end
 
----Sets the value of the SelectedText property.
----@param self DropDown self
----@param SelectedText string Text shown when no selection made
-function DropDown:setSelectedText(self, SelectedText) end
+---Sets the value of the CursorX property.
+---@param self TextBox self
+---@param CursorX number Cursor X position
+function TextBox:setCursorX(self, CursorX) end
 
----Sets the value of the DropdownHeight property.
----@param self DropDown self
----@param DropdownHeight number Maximum visible items when expanded
-function DropDown:setDropdownHeight(self, DropdownHeight) end
+---Gets the value of the AutoPairEnabled property.
+---@param self TextBox self
+---@return boolean true Whether automatic bracket/quote pairing is enabled
+function TextBox:getAutoPairEnabled(self) end
 
----Gets the value of the DropSymbol property.
----@param self DropDown self
----@return string "\31" Indicator for dropdown state
-function DropDown:getDropSymbol(self) end
+---Sets the value of the AutoCompleteCloseOnEscape property.
+---@param self TextBox self
+---@param AutoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup
+function TextBox:setAutoCompleteCloseOnEscape(self, AutoCompleteCloseOnEscape) end
 
----@class CheckBox : VisualElement
----@field autoSize boolean Automatically adjusts width based on text length
----@field text string Text shown when the checkbox is unchecked
----@field checkedText string Text shown when the checkbox is checked
----@field checked boolean The current state of the checkbox (true=checked, false=unchecked)
-local CheckBox = {}
+---Sets the value of the AutoCompleteMaxItems property.
+---@param self TextBox self
+---@param AutoCompleteMaxItems number Maximum number of visible suggestions
+function TextBox:setAutoCompleteMaxItems(self, AutoCompleteMaxItems) end
+
+---Sets the value of the AutoCompleteMinChars property.
+---@param self TextBox self
+---@param AutoCompleteMinChars number Minimum characters required before showing suggestions
+function TextBox:setAutoCompleteMinChars(self, AutoCompleteMinChars) end
+
+---Sets the value of the AutoCompleteBackground property.
+---@param self TextBox self
+---@param AutoCompleteBackground color Background color of the suggestion popup
+function TextBox:setAutoCompleteBackground(self, AutoCompleteBackground) end
+
+---Gets the value of the AutoCompleteAcceptOnEnter property.
+---@param self TextBox self
+---@return boolean true Whether pressing Enter accepts the current suggestion
+function TextBox:getAutoCompleteAcceptOnEnter(self) end
+
+---Sets the value of the AutoPairOverType property.
+---@param self TextBox self
+---@param AutoPairOverType boolean When pressing a closing char that matches the next char, move over it instead of inserting
+function TextBox:setAutoPairOverType(self, AutoPairOverType) end
+
+---Gets the value of the AutoPairNewlineIndent property.
+---@param self TextBox self
+---@return boolean true On Enter between matching braces, create blank line and keep closing aligned
+function TextBox:getAutoPairNewlineIndent(self) end
+
+---Sets the value of the AutoCompleteOffsetX property.
+---@param self TextBox self
+---@param AutoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox
+function TextBox:setAutoCompleteOffsetX(self, AutoCompleteOffsetX) end
+
+---Sets the value of the AutoCompleteAcceptOnClick property.
+---@param self TextBox self
+---@param AutoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately
+function TextBox:setAutoCompleteAcceptOnClick(self, AutoCompleteAcceptOnClick) end
+
+---Gets the value of the AutoPairCharacters property.
+---@param self TextBox self
+---@return table { ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing
+function TextBox:getAutoPairCharacters(self) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@return CheckBox self The created instance
+---@param key number The key that was pressed
+---@return boolean handled Whether the event was handled
 ---@protected
-function CheckBox.new() end
+function TextBox:key(key) end
 
----Gets the value of the AutoSize property.
----@param self CheckBox self
----@return boolean true Automatically adjusts width based on text length
-function CheckBox:getAutoSize(self) end
+---Sets the value of the AutoPairNewlineIndent property.
+---@param self TextBox self
+---@param AutoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned
+function TextBox:setAutoPairNewlineIndent(self, AutoPairNewlineIndent) end
+
+---Gets the value of the AutoCompleteTokenPattern property.
+---@param self TextBox self
+---@return string "[%w_]+" Pattern used to extract the current token for suggestions
+function TextBox:getAutoCompleteTokenPattern(self) end
+
+---Gets the value of the ScrollY property.
+---@param self TextBox self
+---@return number 0 Vertical scroll offset
+function TextBox:getScrollY(self) end
+
+---Sets the value of the CursorColor property.
+---@param self TextBox self
+---@param CursorColor number Color of the cursor
+function TextBox:setCursorColor(self, CursorColor) end
+
+---Sets the value of the AutoCompleteForeground property.
+---@param self TextBox self
+---@param AutoCompleteForeground color Foreground color of the suggestion popup
+function TextBox:setAutoCompleteForeground(self, AutoCompleteForeground) end
+
+---Adds a new syntax highlighting pattern
+---@param pattern string The regex pattern to match
+---@param color number The color to apply
+---@return TextBox self The TextBox instance
+function TextBox:addSyntaxPattern(pattern, color) end
+
+---Sets the value of the AutoCompleteAcceptOnEnter property.
+---@param self TextBox self
+---@param AutoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion
+function TextBox:setAutoCompleteAcceptOnEnter(self, AutoCompleteAcceptOnEnter) end
+
+---Sets the value of the AutoCompleteCaseInsensitive property.
+---@param self TextBox self
+---@param AutoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively
+function TextBox:setAutoCompleteCaseInsensitive(self, AutoCompleteCaseInsensitive) end
+
+---Sets the value of the AutoCompleteItems property.
+---@param self TextBox self
+---@param AutoCompleteItems table List of suggestions used when no provider is supplied
+function TextBox:setAutoCompleteItems(self, AutoCompleteItems) end
+
+---Clears all syntax highlighting patterns
+---@return TextBox self
+function TextBox:clearSyntaxPatterns() end
+
+---Gets the value of the AutoCompleteZOffset property.
+---@param self TextBox self
+---@return number 1 Z-index offset applied to the popup frame
+function TextBox:getAutoCompleteZOffset(self) end
+
+---Sets the value of the AutoPairEnabled property.
+---@param self TextBox self
+---@param AutoPairEnabled boolean Whether automatic bracket/quote pairing is enabled
+function TextBox:setAutoPairEnabled(self, AutoPairEnabled) end
+
+---Sets the value of the AutoCompleteSelectedBackground property.
+---@param self TextBox self
+---@param AutoCompleteSelectedBackground color Background color for the selected suggestion
+function TextBox:setAutoCompleteSelectedBackground(self, AutoCompleteSelectedBackground) end
+
+---Sets the value of the ScrollX property.
+---@param self TextBox self
+---@param ScrollX number Horizontal scroll offset
+function TextBox:setScrollX(self, ScrollX) end
+
+---Sets the value of the Lines property.
+---@param self TextBox self
+---@param Lines table Array of text lines
+function TextBox:setLines(self, Lines) end
+
+function TextBox:destroy() end
 
----Handles mouse interactions to toggle the checkbox state
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean Clicked Whether the event was handled
 ---@protected
-function CheckBox:mouse_click(button, x, y) end
+function TextBox:render() end
 
----Sets the value of the Text property.
----@param self CheckBox self
----@param Text string Text shown when the checkbox is unchecked
-function CheckBox:setText(self, Text) end
+---Gets the value of the AutoCompleteOffsetX property.
+---@param self TextBox self
+---@return number 0 Horizontal offset applied to the popup frame relative to the TextBox
+function TextBox:getAutoCompleteOffsetX(self) end
 
----Sets the value of the CheckedText property.
----@param self CheckBox self
----@param CheckedText string Text shown when the checkbox is checked
-function CheckBox:setCheckedText(self, CheckedText) end
+---Updates the viewport to keep the cursor in view
+---@return TextBox self The TextBox instance
+function TextBox:updateViewport() end
+
+---Sets the value of the AutoCompleteBorderColor property.
+---@param self TextBox self
+---@param AutoCompleteBorderColor color Color of the popup border when enabled
+function TextBox:setAutoCompleteBorderColor(self, AutoCompleteBorderColor) end
+
+---Sets the value of the CursorY property.
+---@param self TextBox self
+---@param CursorY number Cursor Y position (line number)
+function TextBox:setCursorY(self, CursorY) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function TextBox:paste() end
+
+---Gets the value of the Lines property.
+---@param self TextBox self
+---@return table {} Array of text lines
+function TextBox:getLines(self) end
+
+---Sets the value of the AutoCompleteTokenPattern property.
+---@param self TextBox self
+---@param AutoCompleteTokenPattern string Pattern used to extract the current token for suggestions
+function TextBox:setAutoCompleteTokenPattern(self, AutoCompleteTokenPattern) end
+
+---Gets the value of the AutoCompleteOffsetY property.
+---@param self TextBox self
+---@return number 1 Vertical offset applied to the popup frame relative to the TextBox bottom edge
+function TextBox:getAutoCompleteOffsetY(self) end
+
+---Sets the value of the AutoCompleteProvider property.
+---@param self TextBox self
+---@param AutoCompleteProvider function Optional suggestion provider returning a list for the current prefix
+function TextBox:setAutoCompleteProvider(self, AutoCompleteProvider) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param direction number The scroll direction
+---@param x number The x position of the scroll
+---@param y number The y position of the scroll
+---@return boolean handled Whether the event was handled
+---@protected
+function TextBox:mouse_scroll(direction, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param char string The character that was typed
+---@return boolean handled Whether the event was handled
+---@protected
+function TextBox:char(char) end
+
+---Removes a syntax pattern by index (1-based)
+---@param index number The index of the pattern to remove
+---@return TextBox self
+function TextBox:removeSyntaxPattern(index) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
 ---@param props table The properties to initialize the element with
 ---@param basalt table The basalt instance
+---@return TextBox self The initialized instance
 ---@protected
-function CheckBox:init(props, basalt) end
+function TextBox:init(props, basalt) end
 
----Gets the value of the CheckedText property.
----@param self CheckBox self
----@return string x Text shown when the checkbox is checked
-function CheckBox:getCheckedText(self) end
+---Gets the value of the AutoCompleteMaxWidth property.
+---@param self TextBox self
+---@return number 0 Maximum width of the autocomplete popup (0 uses the textbox width)
+function TextBox:getAutoCompleteMaxWidth(self) end
+
+---Sets the value of the AutoCompleteEnabled property.
+---@param self TextBox self
+---@param AutoCompleteEnabled boolean Whether autocomplete suggestions are enabled
+function TextBox:setAutoCompleteEnabled(self, AutoCompleteEnabled) end
+
+---Gets the value of the AutoCompleteEnabled property.
+---@param self TextBox self
+---@return boolean false Whether autocomplete suggestions are enabled
+function TextBox:getAutoCompleteEnabled(self) end
+
+---Gets the value of the SyntaxPatterns property.
+---@param self TextBox self
+---@return table {} Syntax highlighting patterns
+function TextBox:getSyntaxPatterns(self) end
+
+---Gets the value of the AutoCompleteCloseOnEscape property.
+---@param self TextBox self
+---@return boolean true Whether pressing Escape closes the popup
+function TextBox:getAutoCompleteCloseOnEscape(self) end
+
+---Gets the value of the CursorColor property.
+---@param self TextBox self
+---@return number nil Color of the cursor
+function TextBox:getCursorColor(self) end
+
+---Gets the value of the AutoCompleteSelectedForeground property.
+---@param self TextBox self
+---@return color white Foreground color for the selected suggestion
+function TextBox:getAutoCompleteSelectedForeground(self) end
+
+---Gets the value of the AutoPairOverType property.
+---@param self TextBox self
+---@return boolean true When pressing a closing char that matches the next char, move over it instead of inserting
+function TextBox:getAutoPairOverType(self) end
+
+---Sets the value of the AutoPairSkipClosing property.
+---@param self TextBox self
+---@param AutoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor
+function TextBox:setAutoPairSkipClosing(self, AutoPairSkipClosing) end
+
+---Sets the value of the AutoCompleteZOffset property.
+---@param self TextBox self
+---@param AutoCompleteZOffset number Z-index offset applied to the popup frame
+function TextBox:setAutoCompleteZOffset(self, AutoCompleteZOffset) end
+
+---Sets the value of the ScrollY property.
+---@param self TextBox self
+---@param ScrollY number Vertical scroll offset
+function TextBox:setScrollY(self, ScrollY) end
+
+---Gets the value of the AutoCompleteSelectedBackground property.
+---@param self TextBox self
+---@return color gray Background color for the selected suggestion
+function TextBox:getAutoCompleteSelectedBackground(self) end
+
+---Gets the text of the TextBox
+---@return string text The text of the TextBox
+function TextBox:getText() end
+
+---Gets the value of the AutoCompleteMinChars property.
+---@param self TextBox self
+---@return number 1 Minimum characters required before showing suggestions
+function TextBox:getAutoCompleteMinChars(self) end
+
+---Gets the value of the CursorY property.
+---@param self TextBox self
+---@return number 1 Cursor Y position (line number)
+function TextBox:getCursorY(self) end
+
+---Gets the value of the AutoCompleteBackground property.
+---@param self TextBox self
+---@return color lightGray Background color of the suggestion popup
+function TextBox:getAutoCompleteBackground(self) end
+
+---Gets the value of the AutoPairSkipClosing property.
+---@param self TextBox self
+---@return boolean true Skip inserting a closing char if the same one is already at cursor
+function TextBox:getAutoPairSkipClosing(self) end
+
+---Gets the value of the AutoCompleteProvider property.
+---@param self TextBox self
+---@return function nil Optional suggestion provider returning a list for the current prefix
+function TextBox:getAutoCompleteProvider(self) end
+
+---@class Collection : VisualElement
+---@field multiSelection boolean Whether multiple items can be selected at once
+---@field selectable boolean Whether items can be selected
+---@field selectedForeground color Text color for selected items
+---@field selectedBackground color Background color for selected items
+local Collection = {}
+
+---Removes an item from the Collection
+---@param index number The index of the item to remove
+---@return Collection self The Collection instance
+function Collection:removeItem(index) end
+
+---Sets the value of the SelectedForeground property.
+---@param self Collection self
+---@param SelectedForeground color Text color for selected items
+function Collection:setSelectedForeground(self, SelectedForeground) end
+
+---Gets the value of the Selectable property.
+---@param self Collection self
+---@return boolean true Whether items can be selected
+function Collection:getSelectable(self) end
+
+---Gets first selected item
+---@return table ? selected The first item
+function Collection:getSelectedItem() end
+
+---Sets the value of the MultiSelection property.
+---@param self Collection self
+---@param MultiSelection boolean Whether multiple items can be selected at once
+function Collection:setMultiSelection(self, MultiSelection) end
+
+---Sets the value of the Selectable property.
+---@param self Collection self
+---@param Selectable boolean Whether items can be selected
+function Collection:setSelectable(self, Selectable) end
+
+function Collection:selectItem() end
+
+---Adds an item to the Collection
+---@param text string |table The item to add (string or item table)
+---@return Collection self The Collection instance
+function Collection:addItem(text) end
+
+---Gets the currently selected items
+---@return table selected Collection of selected items
+function Collection:getSelectedItems() end
+
+---Registers a callback for the select event
+---@param callback function The callback function to register
+---@return Collection self The Collection instance
+function Collection:onSelect(callback) end
+
+function Collection:clearItemSelection() end
+
+function Collection:unselectItem() end
+
+---Gets the value of the SelectedForeground property.
+---@param self Collection self
+---@return color white Text color for selected items
+function Collection:getSelectedForeground(self) end
 
 ---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Collection self The initialized instance
 ---@protected
-function CheckBox:render() end
+function Collection:init(props, basalt) end
 
----Sets the value of the AutoSize property.
----@param self CheckBox self
----@param AutoSize boolean Automatically adjusts width based on text length
-function CheckBox:setAutoSize(self, AutoSize) end
+---Clears all items from the Collection
+---@return Collection self The Collection instance
+function Collection:clear() end
 
----Gets the value of the Text property.
----@param self CheckBox self
----@return string empty Text shown when the checkbox is unchecked
-function CheckBox:getText(self) end
+---Sets the value of the SelectedBackground property.
+---@param self Collection self
+---@param SelectedBackground color Background color for selected items
+function Collection:setSelectedBackground(self, SelectedBackground) end
 
----Sets the value of the Checked property.
----@param self CheckBox self
----@param Checked boolean The current state of the checkbox (true=checked, false=unchecked)
-function CheckBox:setChecked(self, Checked) end
+---Gets the value of the SelectedBackground property.
+---@param self Collection self
+---@return color blue Background color for selected items
+function Collection:getSelectedBackground(self) end
 
----Gets the value of the Checked property.
----@param self CheckBox self
----@return boolean false The current state of the checkbox (true=checked, false=unchecked)
-function CheckBox:getChecked(self) end
+---Registers a function to handle the onSelect event.
+---@param index number
+---@param item table
+---@param self Collection self
+---@param func function The function to be called when the event fires
+function Collection:onOnSelect(self, func) end
+
+---Gets the value of the MultiSelection property.
+---@param self Collection self
+---@return boolean false Whether multiple items can be selected at once
+function Collection:getMultiSelection(self) end
+
+---@class Benchmark
+local Benchmark = {}
+
+---Clears a specific benchmark
+---@param name string The name of the benchmark to clear
+function API.clear(name) end
+
+---Clears all custom benchmarks
+function API.clearAll() end
+
+---Starts a custom benchmark
+---@param name string The name of the benchmark
+function API.start(name) end
+
+---Stops a custom benchmark
+---@param name string The name of the benchmark to stop
+function API.stop(name) end
+
+---Gets statistics for a benchmark
+---@param name string The name of the benchmark
+---@return table ? stats The benchmark statistics or nil
+function API.getStats(name) end
+
+---@class AnimationInstance
+local AnimationInstance = {}
+
+---Gets called when the animation is completed
+function AnimationInstance:complete() end
+
+---Creates a new AnimationInstance
+---@param element VisualElement The element to animate
+---@param animType string The type of animation
+---@param args table The animation arguments
+---@param duration number Duration in seconds
+---@param easing string The easing function name
+---@return AnimationInstance The new animation instance
+function AnimationInstance.new(element, animType, args, duration, easing) end
+
+---Updates the animation
+---@param elapsed number The elapsed time in seconds
+---@return boolean Whether the animation is finished
+function AnimationInstance:update(elapsed) end
+
+---Starts the animation
+---@return AnimationInstance self The animation instance
+function AnimationInstance:start() end
+
+---@class Reactive
+local Reactive = {}
 
 ---@class Log
 local Log = {}
 
----Sends an error message to the logger.
-function Log.error() end
+---Sets if the logger should log to a file.
+function Log.setLogToFile() end
 
 ---Sends an info message to the logger.
 function Log.info() end
@@ -3191,14 +4496,350 @@ function Log.info() end
 ---Sends a debug message to the logger.
 function Log.debug() end
 
+---Sends an error message to the logger.
+function Log.error() end
+
 ---Sends a warning message to the logger.
 function Log.warn() end
 
 ---Sets if the logger should log
 function Log.setEnabled() end
 
----Sets if the logger should log to a file.
-function Log.setLogToFile() end
+---@class BaseFrame : Container
+---@field term term term.current() The terminal or (monitor) peripheral object to render to
+local BaseFrame = {}
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param name string The name of the monitor that was touched
+---@param x number The x position of the mouse
+---@param y number The y position of the mouse
+---@protected
+function BaseFrame:monitor_touch(name, x, y) end
+
+---Sets the value of the Term property.
+---@param self BaseFrame self
+---@param Term term term.current() The terminal or (monitor) peripheral object to render to
+function BaseFrame:setTerm(self, Term) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param key number The key that was pressed
+---@protected
+function BaseFrame:key(key) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param text string The text to render
+---@param fg colors The foreground color
+---@protected
+function BaseFrame:textFg(x, y, text, fg) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function BaseFrame:render() end
+
+---Gets the value of the Term property.
+---@param self BaseFrame self
+---@return term |peripheral term.current() The terminal or (monitor) peripheral object to render to
+function BaseFrame:getTerm(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param fg colors The foreground color
+---@protected
+function BaseFrame:drawFg(x, y, fg) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function BaseFrame:term_resize() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param text string The text to render
+---@param fg string The foreground color
+---@param bg string The background color
+---@protected
+function BaseFrame:blit(x, y, text, fg, bg) end
+
+---Toggles the debug log frame
+---@param self BaseFrame The frame to toggle debug log for
+function BaseFrame.toggleConsole(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return table self The initialized instance
+---@protected
+function BaseFrame:init(props, basalt) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param text string The text to render
+---@protected
+function BaseFrame:drawText(x, y, text) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param key number The key that was released
+---@protected
+function BaseFrame:key_up(key) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param bg colors The background color
+---@protected
+function BaseFrame:drawBg(x, y, bg) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was released
+---@param x number The x position of the mouse
+---@param y number The y position of the mouse
+---@protected
+function BaseFrame:mouse_up(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the mouse
+---@param y number The y position of the mouse
+---@protected
+function BaseFrame:mouse_click(button, x, y) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param text string The text to render
+---@param bg colors The background color
+---@protected
+function BaseFrame:textBg(x, y, text, bg) end
+
+---Shows the debug log frame
+---@param self BaseFrame The frame to show debug log in
+function BaseFrame.openConsole(self) end
+
+function BaseFrame:dispatchEvent() end
+
+---Hides the debug log frame
+---@param self BaseFrame The frame to hide debug log for
+function BaseFrame.closeConsole(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param x number The x position to render to
+---@param y number The y position to render to
+---@param width number The width of the text
+---@param height number The height of the text
+---@param text string The text to render
+---@param fg string The foreground color
+---@param bg string The background color
+---@protected
+function BaseFrame:multiBlit(x, y, width, height, text, fg, bg) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param char string The character that was pressed
+---@protected
+function BaseFrame:char(char) end
+
+---Sets the cursor position
+---@param x number The x position to set the cursor to
+---@param y number The y position to set the cursor to
+---@param blink boolean Whether the cursor should blink
+function BaseFrame:setCursor(x, y, blink) end
+
+---@class Menu : List
+---@field separatorColor color The color used for separator items in the menu
+local Menu = {}
+
+---Sets the value of the SeparatorColor property.
+---@param self Menu self
+---@param SeparatorColor color The color used for separator items in the menu
+function Menu:setSeparatorColor(self, SeparatorColor) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param props table The properties to initialize the element with
+---@param basalt table The basalt instance
+---@return Menu self The initialized instance
+---@protected
+function Menu:init(props, basalt) end
+
+---Sets the menu items
+---@param items table [] List of items with {text, separator, callback, foreground, background} properties
+---@return Menu self The Menu instance
+function Menu:setItems(items) end
+
+---Gets the value of the SeparatorColor property.
+---@param self Menu self
+---@return color gray The color used for separator items in the menu
+function Menu:getSeparatorColor(self) end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@protected
+function Menu:render() end
+
+---This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
+---@param button number The button that was clicked
+---@param x number The x position of the click
+---@param y number The y position of the click
+---@return boolean Whether the event was handled
+---@protected
+function Menu:mouse_click(button, x, y) end
+
+---@class Animation
+local Animation = {}
+
+---Stops the animation immediately: cancels timers, completes running anim instances and clears the element property
+function Animation:stop() end
+
+---Starts the animation
+---@return Animation self The animation instance
+function Animation:start() end
+
+---The event handler for the animation (listens to timer events)
+---@param event string The event type
+---@param timerId number The timer ID
+function Animation:event(event, timerId) end
+
+---Registers a callback for the complete event
+---@param callback function The callback function to register
+---@return Animation self The animation instance
+function Animation:onComplete(callback) end
+
+---Registers a new animation type
+---@param name string The name of the animation
+---@param handlers table Table containing start, update and complete handlers
+function Animation.registerAnimation(name, handlers) end
+
+---Registers a callback for the start event
+---@param callback function The callback function to register
+function Animation:onStart(callback) end
+
+---Registers a new easing function
+---@param name string The name of the easing function
+---@param func function The easing function (takes progress 0-1, returns modified progress)
+function Animation.registerEasing(name, func) end
+
+---Creates a new sequence
+---@return Animation self The animation instance
+function Animation:sequence() end
+
+---Adds a new animation to the sequence
+---@param type string The type of animation
+---@param args table The animation arguments
+---@param duration number The duration in seconds
+---@param easing string The easing function name
+function Animation:addAnimation(type, args, duration, easing) end
+
+---Creates a new Animation
+---@param element VisualElement The element to animate
+---@return Animation The new animation
+function Animation.new(element) end
+
+---Registers a callback for the update event
+---@param callback function The callback function to register
+---@return Animation self The animation instance
+function Animation:onUpdate(callback) end
+
+---@class basalt
+local basalt = {}
+
+---Returns the element manager instance
+---@return table ElementManager The element manager
+function basalt.getElementManager() end
+
+---Starts the Basalt runtime
+function basalt.run() end
+
+---Configures the ElementManager (shortcut to elementManager.configure)
+---@param config table Configuration options
+function basalt.configure(config) end
+
+---Requires specific elements and validates they are available
+---@param elements table |string List of element names or single element name
+function basalt.requireElements(elements) end
+
+---Stops the Basalt runtime
+function basalt.stop() end
+
+---Creates and returns a new UI element of the specified type.
+---@param type string The type of element to create (e.g. "Button", "Label", "BaseFrame")
+---@return table element The created element instance
+function basalt.create(type) end
+
+---Installs an element interactively or from a specified source
+---@param elementName string The name of the element to install
+function basalt.install(elementName) end
+
+---Returns an element's class without creating a instance
+---@param name string The name of the element
+---@return table Element The element class
+function basalt.getElementClass(name) end
+
+---Returns the error manager instance
+---@return table ErrorManager The error manager
+function basalt.getErrorManager() end
+
+---Triggers a custom event and calls all registered callbacks
+---@param eventName string The name of the event to trigger
+function basalt.triggerEvent(eventName) end
+
+---Returns the focused frame
+---@return BaseFrame ? BaseFrame The focused frame
+function basalt.getFocus() end
+
+---Returns the active frame
+---@return BaseFrame ? BaseFrame The frame to set as active
+function basalt.getActiveFrame() end
+
+---Removes a callback function for a specific event
+---@param eventName string The name of the event
+---@param callback function The callback function to remove
+---@return boolean success Whether the callback was found and removed
+function basalt.removeEvent(eventName, callback) end
+
+---Creates and returns a new BaseFrame
+---@return BaseFrame BaseFrame The created frame instance
+function basalt.createFrame() end
+
+---Loads a manifest file that describes element requirements and configuration
+---@param path string The path to the manifest file
+---@return table manifest The loaded manifest data
+function basalt.loadManifest(path) end
+
+---Returns a Plugin API
+---@param name string The name of the plugin
+---@return table Plugin The plugin API
+function basalt.getAPI(name) end
+
+---Removes a scheduled update
+---@param func thread The scheduled function to remove
+---@return boolean success Whether the scheduled function was removed
+function basalt.removeSchedule(func) end
+
+---Runs basalt once, can be used to update the UI manually, but you have to feed it the events
+function basalt.update() end
+
+---Sets the active frame
+---@param frame BaseFrame The frame to set as active
+function basalt.setActiveFrame(frame) end
+
+---Sets a frame as focused
+---@param frame BaseFrame The frame to set as focused
+function basalt.setFocus(frame) end
+
+---Schedules a function to run in a coroutine
+---@param func function The function to schedule
+---@return thread func The scheduled function
+function basalt.schedule(func) end
+
+---Registers a callback function for a specific event
+---@param eventName string The name of the event to listen for (e.g. "mouse_click", "key", "timer")
+---@param callback function The callback function to execute when the event occurs
+function basalt.onEvent(eventName, callback) end
+
+---Gets or creates the main frame
+---@return BaseFrame BaseFrame The main frame instance
+function basalt.getMainFrame() end
 
 ---@class ErrorHandler
 local ErrorHandler = {}
@@ -3207,1492 +4848,6 @@ local ErrorHandler = {}
 ---@param errMsg string The error message
 function errorHandler.error(errMsg) end
 
----@class ScrollBar : VisualElement
----@field value number Current scroll value
----@field attachedElement table nil The element this ScrollBar is attached to
----@field dragMultiplier number How fast the ScrollBar moves when dragging
----@field min number Minimum scroll value
----@field orientation string Orientation of the ScrollBar ("vertical" or "horizontal")
----@field max number Maximum scroll value
----@field minValue number 0 Minimum value or function that returns it
----@field symbol string " Symbol used for the ScrollBar handle
----@field attachedProperty string nil The property being controlled
----@field handleSize number Size of the ScrollBar handle in characters
----@field maxValue number 100 Maximum value or function that returns it
----@field symbolBackgroundColor color Background color of the ScrollBar handle
----@field step number Step size for scroll operations
----@field backgroundSymbol string Symbol used for the ScrollBar background
-local ScrollBar = {}
-
----Gets the value of the SymbolBackgroundColor property.
----@param self ScrollBar self
----@return color black Background color of the ScrollBar handle
-function ScrollBar:getSymbolBackgroundColor(self) end
-
----Sets the value of the Min property.
----@param self ScrollBar self
----@param Min number Minimum scroll value
-function ScrollBar:setMin(self, Min) end
-
----Gets the value of the AttachedProperty property.
----@param self ScrollBar self
----@return string ? nil The property being controlled
-function ScrollBar:getAttachedProperty(self) end
-
----Gets the value of the AttachedElement property.
----@param self ScrollBar self
----@return table ? nil The element this ScrollBar is attached to
-function ScrollBar:getAttachedElement(self) end
-
----Gets the value of the DragMultiplier property.
----@param self ScrollBar self
----@return number 1 How fast the ScrollBar moves when dragging
-function ScrollBar:getDragMultiplier(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return ScrollBar self The initialized instance
----@protected
-function ScrollBar:init(props, basalt) end
-
----Gets the value of the Value property.
----@param self ScrollBar self
----@return number 0 Current scroll value
-function ScrollBar:getValue(self) end
-
----Gets the value of the Symbol property.
----@param self ScrollBar self
----@return string " " Symbol used for the ScrollBar handle
-function ScrollBar:getSymbol(self) end
-
----Sets the value of the MaxValue property.
----@param self ScrollBar self
----@param MaxValue number 100 Maximum value or function that returns it
-function ScrollBar:setMaxValue(self, MaxValue) end
-
----Gets the value of the MinValue property.
----@param self ScrollBar self
----@return number |function 0 Minimum value or function that returns it
-function ScrollBar:getMinValue(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean Whether the event was handled
----@protected
-function ScrollBar:mouse_click(button, x, y) end
-
----Updates the attached element's property based on the ScrollBar value
----@return ScrollBar self The ScrollBar instance
-function ScrollBar:updateAttachedElement() end
-
----Sets the value of the Max property.
----@param self ScrollBar self
----@param Max number Maximum scroll value
-function ScrollBar:setMax(self, Max) end
-
----Gets the value of the BackgroundSymbol property.
----@param self ScrollBar self
----@return string "\127" Symbol used for the ScrollBar background
-function ScrollBar:getBackgroundSymbol(self) end
-
----Sets the value of the BackgroundSymbol property.
----@param self ScrollBar self
----@param BackgroundSymbol string Symbol used for the ScrollBar background
-function ScrollBar:setBackgroundSymbol(self, BackgroundSymbol) end
-
----Sets the value of the SymbolBackgroundColor property.
----@param self ScrollBar self
----@param SymbolBackgroundColor color Background color of the ScrollBar handle
-function ScrollBar:setSymbolBackgroundColor(self, SymbolBackgroundColor) end
-
----Gets the value of the Step property.
----@param self ScrollBar self
----@return number 1 Step size for scroll operations
-function ScrollBar:getStep(self) end
-
----Sets the value of the Step property.
----@param self ScrollBar self
----@param Step number Step size for scroll operations
-function ScrollBar:setStep(self, Step) end
-
----Sets the value of the Symbol property.
----@param self ScrollBar self
----@param Symbol string " Symbol used for the ScrollBar handle
-function ScrollBar:setSymbol(self, Symbol) end
-
----Sets the value of the Value property.
----@param self ScrollBar self
----@param Value number Current scroll value
-function ScrollBar:setValue(self, Value) end
-
----Gets the value of the HandleSize property.
----@param self ScrollBar self
----@return number 2 Size of the ScrollBar handle in characters
-function ScrollBar:getHandleSize(self) end
-
----Gets the value of the Min property.
----@param self ScrollBar self
----@return number 0 Minimum scroll value
-function ScrollBar:getMin(self) end
-
----Gets the value of the MaxValue property.
----@param self ScrollBar self
----@return number |function 100 Maximum value or function that returns it
-function ScrollBar:getMaxValue(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function ScrollBar:render() end
-
----Gets the value of the Orientation property.
----@param self ScrollBar self
----@return string vertical Orientation of the ScrollBar ("vertical" or "horizontal")
-function ScrollBar:getOrientation(self) end
-
----Sets the value of the HandleSize property.
----@param self ScrollBar self
----@param HandleSize number Size of the ScrollBar handle in characters
-function ScrollBar:setHandleSize(self, HandleSize) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button being dragged
----@param x number The x position of the drag
----@param y number The y position of the drag
----@return boolean Whether the event was handled
----@protected
-function ScrollBar:mouse_drag(button, x, y) end
-
----Sets the value of the MinValue property.
----@param self ScrollBar self
----@param MinValue number 0 Minimum value or function that returns it
-function ScrollBar:setMinValue(self, MinValue) end
-
----Gets the value of the Max property.
----@param self ScrollBar self
----@return number 100 Maximum scroll value
-function ScrollBar:getMax(self) end
-
----Sets the value of the AttachedElement property.
----@param self ScrollBar self
----@param AttachedElement table nil The element this ScrollBar is attached to
-function ScrollBar:setAttachedElement(self, AttachedElement) end
-
----Sets the value of the AttachedProperty property.
----@param self ScrollBar self
----@param AttachedProperty string nil The property being controlled
-function ScrollBar:setAttachedProperty(self, AttachedProperty) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction (1 for up, -1 for down)
----@param x number The x position of the scroll
----@param y number The y position of the scroll
----@return boolean Whether the event was handled
----@protected
-function ScrollBar:mouse_scroll(direction, x, y) end
-
----Sets the value of the Orientation property.
----@param self ScrollBar self
----@param Orientation string Orientation of the ScrollBar ("vertical" or "horizontal")
-function ScrollBar:setOrientation(self, Orientation) end
-
----Sets the value of the DragMultiplier property.
----@param self ScrollBar self
----@param DragMultiplier number How fast the ScrollBar moves when dragging
-function ScrollBar:setDragMultiplier(self, DragMultiplier) end
-
----Attaches the ScrollBar to an element's property
----@param element BaseElement The element to attach to
----@param config table Configuration {property = "propertyName", min = number|function, max = number|function}
----@return ScrollBar self The ScrollBar instance
-function ScrollBar:attach(element, config) end
-
----@class Timer : BaseElement
----@field action function The action to be performed when the timer triggers.
----@field amount number The amount of time the timer should run.
----@field interval number The interval in seconds at which the timer will trigger its action.
----@field running boolean Indicates whether the timer is currently running or not.
-local Timer = {}
-
----Sets the value of the Action property.
----@param self Timer self
----@param Action function The action to be performed when the timer triggers.
-function Timer:setAction(self, Action) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Timer:dispatchEvent() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function Timer:init(props, basalt) end
-
----Gets the value of the Running property.
----@param self Timer self
----@return boolean false Indicates whether the timer is currently running or not.
-function Timer:getRunning(self) end
-
----Sets the value of the Interval property.
----@param self Timer self
----@param Interval number The interval in seconds at which the timer will trigger its action.
-function Timer:setInterval(self, Interval) end
-
----Gets the value of the Interval property.
----@param self Timer self
----@return number 1 The interval in seconds at which the timer will trigger its action.
-function Timer:getInterval(self) end
-
----Stops the timer if it is currently running.
----@param self Timer The Timer instance to stop
----@return Timer self The Timer instance
-function Timer:stop(self) end
-
----Gets the value of the Action property.
----@param self Timer self
----@return function function The action to be performed when the timer triggers.
-function Timer:getAction(self) end
-
----Gets the value of the Amount property.
----@param self Timer self
----@return number -1 The amount of time the timer should run.
-function Timer:getAmount(self) end
-
----Starts the timer with the specified interval.
----@param self Timer The Timer instance to start
----@return Timer self The Timer instance
-function Timer:start(self) end
-
----Sets the value of the Amount property.
----@param self Timer self
----@param Amount number The amount of time the timer should run.
-function Timer:setAmount(self, Amount) end
-
----Sets the value of the Running property.
----@param self Timer self
----@param Running boolean Indicates whether the timer is currently running or not.
-function Timer:setRunning(self, Running) end
-
 ---@class BigFontText
 local BigFontText = {}
 
----@class Display : VisualElement
-local Display = {}
-
----Retrieves the underlying ComputerCraft window object
----@return table window A CC window object with all standard terminal methods
-function Display:getWindow() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Display:render() end
-
----Writes text directly to the display with optional colors
----@param x number X position (1-based)
----@param y number Y position (1-based)
----@param text string Text to write
----@return Display self For method chaining
-function Display:write(x, y, text) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function Display:init(props, basalt) end
-
----@class Switch : VisualElement
----@field autoSize boolean to automatically size the element to fit switch and text
----@field text string to display next to switch
----@field offBackground number color when OFF
----@field onBackground number color when ON
----@field checked boolean switch is checked
-local Switch = {}
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Switch:render() end
-
----Sets the value of the OffBackground property.
----@param self Switch self
----@param OffBackground number color when OFF
-function Switch:setOffBackground(self, OffBackground) end
-
----Sets the value of the AutoSize property.
----@param self Switch self
----@param AutoSize boolean to automatically size the element to fit switch and text
-function Switch:setAutoSize(self, AutoSize) end
-
----Gets the value of the Checked property.
----@param self Switch self
----@return boolean Whether switch is checked
-function Switch:getChecked(self) end
-
----Gets the value of the AutoSize property.
----@param self Switch self
----@return boolean Whether to automatically size the element to fit switch and text
-function Switch:getAutoSize(self) end
-
----Sets the value of the Text property.
----@param self Switch self
----@param Text string to display next to switch
-function Switch:setText(self, Text) end
-
----Gets the value of the OffBackground property.
----@param self Switch self
----@return number Background color when OFF
-function Switch:getOffBackground(self) end
-
----Sets the value of the OnBackground property.
----@param self Switch self
----@param OnBackground number color when ON
-function Switch:setOnBackground(self, OnBackground) end
-
----Sets the value of the Checked property.
----@param self Switch self
----@param Checked boolean switch is checked
-function Switch:setChecked(self, Checked) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function Switch:init(props, basalt) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean Whether the event was handled
----@protected
-function Switch:mouse_click(button, x, y) end
-
----Gets the value of the OnBackground property.
----@param self Switch self
----@return number Background color when ON
-function Switch:getOnBackground(self) end
-
----Gets the value of the Text property.
----@param self Switch self
----@return string Text to display next to switch
-function Switch:getText(self) end
-
----@class ThemeAPI
-local ThemeAPI = {}
-
----Loads a theme from a JSON file
----@param path string Path to the theme JSON file
-function ThemeAPI.loadTheme(path) end
-
----Sets the current theme
----@param newTheme table The theme configuration to set
-function ThemeAPI.setTheme(newTheme) end
-
----Gets the current theme configuration
----@return table theme The current theme configuration
-function ThemeAPI.getTheme() end
-
----@class Label : VisualElement
----@field autoSize boolean Whether the label should automatically resize its width based on the text content
----@field text string The text content to display. Can be a string or a function that returns a string
-local Label = {}
-
----Sets the value of the Text property.
----@param self Label self
----@param Text string The text content to display. Can be a string or a function that returns a string
-function Label:setText(self, Text) end
-
----Sets the value of the AutoSize property.
----@param self Label self
----@param AutoSize boolean Whether the label should automatically resize its width based on the text content
-function Label:setAutoSize(self, AutoSize) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Label self The initialized instance
----@protected
-function Label:init(props, basalt) end
-
----Gets the value of the Text property.
----@param self Label self
----@return string Label The text content to display. Can be a string or a function that returns a string
-function Label:getText(self) end
-
----Gets the value of the AutoSize property.
----@param self Label self
----@return boolean true Whether the label should automatically resize its width based on the text content
-function Label:getAutoSize(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Label:render() end
-
----Gets the wrapped lines of the Label
----@return table wrappedText The wrapped lines of the Label
-function Label:getWrappedText() end
-
----@class Tree : VisualElement
----@field expandedNodes table Table of nodes that are currently expanded
----@field nodes table The tree structure containing node objects with {text, children} properties
----@field horizontalOffset number Current horizontal scroll position
----@field selectedNode table nil Currently selected node
----@field selectedForegroundColor color foreground color of selected node
----@field selectedBackgroundColor color background color of selected node
----@field scrollOffset number Current vertical scroll position
-local Tree = {}
-
----Sets the value of the ScrollOffset property.
----@param self Tree self
----@param ScrollOffset number Current vertical scroll position
-function Tree:setScrollOffset(self, ScrollOffset) end
-
----Handles mouse click events
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Tree:mouse_click(button, x, y) end
-
----Sets the value of the SelectedNode property.
----@param self Tree self
----@param SelectedNode table nil Currently selected node
-function Tree:setSelectedNode(self, SelectedNode) end
-
----Expands a node
----@param node table The node to expand
----@return Tree self The Tree instance
-function Tree:expandNode(node) end
-
----Gets the value of the SelectedForegroundColor property.
----@param self Tree self
----@return color white foreground color of selected node
-function Tree:getSelectedForegroundColor(self) end
-
----Collapses a node
----@param node table The node to collapse
----@return Tree self The Tree instance
-function Tree:collapseNode(node) end
-
----Sets the value of the SelectedBackgroundColor property.
----@param self Tree self
----@param SelectedBackgroundColor color background color of selected node
-function Tree:setSelectedBackgroundColor(self, SelectedBackgroundColor) end
-
----Gets the value of the Nodes property.
----@param self Tree self
----@return table {} The tree structure containing node objects with {text, children} properties
-function Tree:getNodes(self) end
-
----Sets the value of the ExpandedNodes property.
----@param self Tree self
----@param ExpandedNodes table Table of nodes that are currently expanded
-function Tree:setExpandedNodes(self, ExpandedNodes) end
-
----Gets the value of the ExpandedNodes property.
----@param self Tree self
----@return table {} Table of nodes that are currently expanded
-function Tree:getExpandedNodes(self) end
-
----Sets the value of the SelectedForegroundColor property.
----@param self Tree self
----@param SelectedForegroundColor color foreground color of selected node
-function Tree:setSelectedForegroundColor(self, SelectedForegroundColor) end
-
----Initializes the Tree instance
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Tree self The initialized instance
----@protected
-function Tree:init(props, basalt) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The scroll direction (1 for up, -1 for down)
----@param x number The x position of the scroll
----@param y number The y position of the scroll
----@return boolean handled Whether the event was handled
----@protected
-function Tree:mouse_scroll(direction, x, y) end
-
----Registers a callback for when a node is selected
----@param callback function The callback function
----@return Tree self The Tree instance
-function Tree:onSelect(callback) end
-
----Sets the value of the Nodes property.
----@param self Tree self
----@param Nodes table The tree structure containing node objects with {text, children} properties
-function Tree:setNodes(self, Nodes) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Tree:render() end
-
----Sets the value of the HorizontalOffset property.
----@param self Tree self
----@param HorizontalOffset number Current horizontal scroll position
-function Tree:setHorizontalOffset(self, HorizontalOffset) end
-
----Gets the value of the HorizontalOffset property.
----@param self Tree self
----@return number 0 Current horizontal scroll position
-function Tree:getHorizontalOffset(self) end
-
----Gets the value of the SelectedBackgroundColor property.
----@param self Tree self
----@return color lightBlue background color of selected node
-function Tree:getSelectedBackgroundColor(self) end
-
----Toggles a node's expanded state
----@param node table The node to toggle
----@return Tree self The Tree instance
-function Tree:toggleNode(node) end
-
----Gets the value of the SelectedNode property.
----@param self Tree self
----@return table ? nil Currently selected node
-function Tree:getSelectedNode(self) end
-
----Gets the value of the ScrollOffset property.
----@param self Tree self
----@return number 0 Current vertical scroll position
-function Tree:getScrollOffset(self) end
-
----Gets the size of the tree
----@return number width The width of the tree
----@return number height The height of the tree
-function Tree:getNodeSize() end
-
----@class ProgressBar : VisualElement
----@field direction string The direction of the progress bar ("up", "down", "left", "right")
----@field showPercentage boolean Whether to show the percentage text in the center
----@field progress number Current progress value (0-100)
----@field progressColor color The color used for the filled portion of the progress bar
-local ProgressBar = {}
-
----Gets the value of the Progress property.
----@param self ProgressBar self
----@return number 0 Current progress value (0-100)
-function ProgressBar:getProgress(self) end
-
----Sets the value of the ProgressColor property.
----@param self ProgressBar self
----@param ProgressColor color The color used for the filled portion of the progress bar
-function ProgressBar:setProgressColor(self, ProgressColor) end
-
----Sets the value of the Progress property.
----@param self ProgressBar self
----@param Progress number Current progress value (0-100)
-function ProgressBar:setProgress(self, Progress) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function ProgressBar:render() end
-
----Gets the value of the ProgressColor property.
----@param self ProgressBar self
----@return color lime The color used for the filled portion of the progress bar
-function ProgressBar:getProgressColor(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return ProgressBar self The initialized instance
----@protected
-function ProgressBar:init(props, basalt) end
-
----Gets the value of the ShowPercentage property.
----@param self ProgressBar self
----@return boolean false Whether to show the percentage text in the center
-function ProgressBar:getShowPercentage(self) end
-
----Sets the value of the Direction property.
----@param self ProgressBar self
----@param Direction string The direction of the progress bar ("up", "down", "left", "right")
-function ProgressBar:setDirection(self, Direction) end
-
----Sets the value of the ShowPercentage property.
----@param self ProgressBar self
----@param ShowPercentage boolean Whether to show the percentage text in the center
-function ProgressBar:setShowPercentage(self, ShowPercentage) end
-
----Gets the value of the Direction property.
----@param self ProgressBar self
----@return string right The direction of the progress bar ("up", "down", "left", "right")
-function ProgressBar:getDirection(self) end
-
----@class Container : VisualElement
----@field focusedChild table Currently focused child element (receives keyboard events)
----@field children table Collection of all child elements
----@field visibleChildren table Currently visible child elements (calculated based on viewport)
----@field eventListenerCount table Number of listeners per event type
----@field childrenEventsSorted boolean Indicates if event handlers are properly sorted
----@field visibleChildrenEvents table Event handlers for currently visible children
----@field childrenEvents table Registered event handlers for all children
----@field childrenSorted boolean Indicates if children are sorted by z-index
----@field offsetX number Horizontal scroll/content offset
----@field offsetY number Vertical scroll/content offset
-local Container = {}
-
----Re-sorts children by their z-index and updates visibility
----@return Container self For method chaining
-function Container:sortChildren() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param _ number unknown
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Container:mouse_move(_, x, y) end
-
----Creates a new VisualElement element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return VisualElement element A new VisualElement element.
-function Container:addVisualElement(self, props) end
-
----Sets the value of the EventListenerCount property.
----@param self Container self
----@param EventListenerCount table Number of listeners per event type
-function Container:setEventListenerCount(self, EventListenerCount) end
-
----Gets the value of the VisibleChildrenEvents property.
----@param self Container self
----@return table {} Event handlers for currently visible children
-function Container:getVisibleChildrenEvents(self) end
-
----Creates a new Table element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Table element A new Table element.
-function Container:addTable(self, props) end
-
----Creates a new Label element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Label element A new Label element.
-function Container:addLabel(self, props) end
-
----Unregisters the children events of the container
----@param child table The child to unregister events for
----@return Container self The container instance
-function Container:removeChildrenEvents(child) end
-
----Creates a new Slider element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Slider element A new Slider element.
-function Container:addSlider(self, props) end
-
----Gets the value of the Children property.
----@param self Container self
----@return table {} Collection of all child elements
-function Container:getChildren(self) end
-
----Sets the value of the FocusedChild property.
----@param self Container self
----@param FocusedChild table Currently focused child element (receives keyboard events)
-function Container:setFocusedChild(self, FocusedChild) end
-
----Creates a new BarChart element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return BarChart element A new BarChart element.
-function Container:addBarChart(self, props) end
-
----Adds a new element to this container's hierarchy
----@param child table The element to add as a child
----@return Container self For method chaining
-function Container:addChild(child) end
-
----Creates a new CheckBox element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return CheckBox element A new CheckBox element.
-function Container:addCheckBox(self, props) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was pressed
----@return boolean handled Whether the event was handled
----@protected
-function Container:key(key) end
-
----Creates a new BaseElement element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return BaseElement element A new BaseElement element.
-function Container:addBaseElement(self, props) end
-
----Locates a child element using a path-like syntax (e.g. "panel/button1")
----@param path string Path to the child (e.g. "panel/button1", "header/title")
----@return Element ? child The found element or nil if not found
-function Container:getChild(path) end
-
----Creates a new DropDown element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return DropDown element A new DropDown element.
-function Container:addDropDown(self, props) end
-
----Gets the value of the ChildrenEvents property.
----@param self Container self
----@return table {} Registered event handlers for all children
-function Container:getChildrenEvents(self) end
-
----Gets the value of the EventListenerCount property.
----@param self Container self
----@return table {} Number of listeners per event type
-function Container:getEventListenerCount(self) end
-
----Creates a new Program element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Program element A new Program element.
-function Container:addProgram(self, props) end
-
----Creates a new Menu element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Menu element A new Menu element.
-function Container:addMenu(self, props) end
-
----Creates a new TextBox element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return TextBox element A new TextBox element.
-function Container:addTextBox(self, props) end
-
----Creates a new LineChart element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return LineChart element A new LineChart element.
-function Container:addLineChart(self, props) end
-
----Calls a event on all children
----@param visibleOnly boolean Whether to only call the event on visible children
----@param event string The event to call
----@return boolean handled Whether the event was handled
----@return table ? child The child that handled the event
-function Container:callChildrenEvent(visibleOnly, event) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param char string The character that was pressed
----@return boolean handled Whether the event was handled
----@protected
-function Container:char(char) end
-
----Creates a new SideNav element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return SideNav element A new SideNav element.
-function Container:addSideNav(self, props) end
-
----Gets the value of the ChildrenEventsSorted property.
----@param self Container self
----@return boolean true Indicates if event handlers are properly sorted
-function Container:getChildrenEventsSorted(self) end
-
----Registers the children events of the container
----@param child table The child to register events for
----@return Container self The container instance
-function Container:registerChildrenEvents(child) end
-
----Gets the value of the FocusedChild property.
----@param self Container self
----@return table nil Currently focused child element (receives keyboard events)
-function Container:getFocusedChild(self) end
-
----Gets the value of the OffsetY property.
----@param self Container self
----@return number 0 Vertical scroll/content offset
-function Container:getOffsetY(self) end
-
----Creates a new Image element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Image element A new Image element.
-function Container:addImage(self, props) end
-
----Creates a new Switch element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Switch element A new Switch element.
-function Container:addSwitch(self, props) end
-
----Creates a new Graph element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Graph element A new Graph element.
-function Container:addGraph(self, props) end
-
----Sets the value of the VisibleChildrenEvents property.
----@param self Container self
----@param VisibleChildrenEvents table Event handlers for currently visible children
-function Container:setVisibleChildrenEvents(self, VisibleChildrenEvents) end
-
----Enables debugging for this container and all its children
----@param self Container The container to debug
----@param level number The debug level
-function Container.debugChildren(self, level) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Container:mouse_click(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to draw the text
----@param y number The y position to draw the text
----@param width number The width of the text
----@param height number The height of the text
----@param text string The text to draw
----@param fg string The foreground color of the text
----@param bg string The background color of the text
----@return Container self The container instance
----@protected
-function Container:multiBlit(x, y, width, height, text, fg, bg) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@protected
-function Container:mouse_release(button, x, y) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param event string The event to handle
----@return boolean handled Whether the event was handled
----@protected
-function Container:handleEvent(event) end
-
----Creates a new Tree element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Tree element A new Tree element.
-function Container:addTree(self, props) end
-
----Removes an element from this container's hierarchy and cleans up its events
----@param child table The element to remove
----@return Container self For method chaining
-function Container:removeChild(child) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to draw the text
----@param y number The y position to draw the text
----@param text string The text to draw
----@param bg color The background color of the text
----@return Container self The container instance
----@protected
-function Container:textBg(x, y, text, bg) end
-
----Sets the value of the OffsetY property.
----@param self Container self
----@param OffsetY number Vertical scroll/content offset
-function Container:setOffsetY(self, OffsetY) end
-
-function Container:drawText() end
-
----Creates a new Frame element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Frame element A new Frame element.
-function Container:addFrame(self, props) end
-
----Enables benchmarking for a container and all its children
----@param methodName string The method to benchmark
----@return Container self The container instance
-function Container:benchmarkContainer(methodName) end
-
----Sets the value of the ChildrenEvents property.
----@param self Container self
----@param ChildrenEvents table Registered event handlers for all children
-function Container:setChildrenEvents(self, ChildrenEvents) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to draw the text
----@param y number The y position to draw the text
----@param text string The text to draw
----@param fg color The foreground color of the text
----@return Container self The container instance
----@protected
-function Container:textFg(x, y, text, fg) end
-
----Creates a new ComboBox element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return ComboBox element A new ComboBox element.
-function Container:addComboBox(self, props) end
-
----Creates a new Container element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Container element A new Container element.
-function Container:addContainer(self, props) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param direction number The direction of the scroll
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Container:mouse_scroll(direction, x, y) end
-
----Logs benchmark statistics for a container and all its children
----@param methodName string The method to log
----@return Container self The container instance
-function Container:logContainerBenchmarks(methodName) end
-
----Creates a new BigFont element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return BigFont element A new BigFont element.
-function Container:addBigFont(self, props) end
-
-function Container:drawBg() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param key number The key that was released
----@return boolean handled Whether the event was handled
----@protected
-function Container:key_up(key) end
-
----Unregisters the children events of the container
----@param child table The child to unregister events for
----@param eventName string The event name to unregister
----@return Container self The container instance
-function Container:unregisterChildEvent(child, eventName) end
-
----Creates a new Timer element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Timer element A new Timer element.
-function Container:addTimer(self, props) end
-
----Gets the value of the OffsetX property.
----@param self Container self
----@return number 0 Horizontal scroll/content offset
-function Container:getOffsetX(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Container:render() end
-
----Stops benchmarking for a container and all its children
----@param methodName string The method to stop benchmarking
----@return Container self The container instance
-function Container:stopContainerBenchmark(methodName) end
-
----Creates a new BaseFrame element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return BaseFrame element A new BaseFrame element.
-function Container:addBaseFrame(self, props) end
-
----Removes all child elements and resets the container's state
----@return Container self For method chaining
-function Container:clear() end
-
----Sets the value of the VisibleChildren property.
----@param self Container self
----@param VisibleChildren table Currently visible child elements (calculated based on viewport)
-function Container:setVisibleChildren(self, VisibleChildren) end
-
----Sets the value of the ChildrenEventsSorted property.
----@param self Container self
----@param ChildrenEventsSorted boolean Indicates if event handlers are properly sorted
-function Container:setChildrenEventsSorted(self, ChildrenEventsSorted) end
-
----Creates a new List element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return List element A new List element.
-function Container:addList(self, props) end
-
----Sets the value of the OffsetX property.
----@param self Container self
----@param OffsetX number Horizontal scroll/content offset
-function Container:setOffsetX(self, OffsetX) end
-
----Creates a new ScrollBar element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return ScrollBar element A new ScrollBar element.
-function Container:addScrollBar(self, props) end
-
----Creates a new Input element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Input element A new Input element.
-function Container:addInput(self, props) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Container:mouse_up(button, x, y) end
-
----Sets the value of the ChildrenSorted property.
----@param self Container self
----@param ChildrenSorted boolean Indicates if children are sorted by z-index
-function Container:setChildrenSorted(self, ChildrenSorted) end
-
----Creates a new FlexBox element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return FlexBox element A new FlexBox element.
-function Container:addFlexBox(self, props) end
-
----Registers an event handler for a specific child element
----@param child table The child element to register events for
----@param eventName string The name of the event to register
----@return Container self For method chaining
-function Container:registerChildEvent(child, eventName) end
-
-function Container:drawFg() end
-
----Sorts the children events of the container
----@param eventName string The event name to sort
----@return Container self The container instance
-function Container:sortChildrenEvents(eventName) end
-
----Sets the value of the Children property.
----@param self Container self
----@param Children table Collection of all child elements
-function Container:setChildren(self, Children) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The button that was clicked
----@param x number The x position of the click
----@param y number The y position of the click
----@return boolean handled Whether the event was handled
----@protected
-function Container:mouse_drag(button, x, y) end
-
----Creates a new TabControl element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return TabControl element A new TabControl element.
-function Container:addTabControl(self, props) end
-
----Tests whether a child element is currently visible within the container's viewport
----@param child table The child element to check
----@return boolean isVisible Whether the child is within view bounds
-function Container:isChildVisible(child) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function Container:init(props, basalt) end
-
----Creates a new Display element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Display element A new Display element.
-function Container:addDisplay(self, props) end
-
----Gets the value of the VisibleChildren property.
----@param self Container self
----@return table {} Currently visible child elements (calculated based on viewport)
-function Container:getVisibleChildren(self) end
-
----Creates a new Button element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return Button element A new Button element.
-function Container:addButton(self, props) end
-
----Gets the value of the ChildrenSorted property.
----@param self Container self
----@return boolean true Indicates if children are sorted by z-index
-function Container:getChildrenSorted(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param x number The x position to draw the text
----@param y number The y position to draw the text
----@param text string The text to draw
----@param fg string The foreground color of the text
----@param bg string The background color of the text
----@return Container self The container instance
----@protected
-function Container:blit(x, y, text, fg, bg) end
-
----Creates a new ProgressBar element.
----@param self Container self
----@param props? table Optional: properties for the element.
----@return ProgressBar element A new ProgressBar element.
-function Container:addProgressBar(self, props) end
-
----@class Button : VisualElement
----@field text string Label text displayed centered within the button
-local Button = {}
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Button:render() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@protected
-function Button:init(props, basalt) end
-
----Gets the value of the Text property.
----@param self Button self
----@return string Button Label text displayed centered within the button
-function Button:getText(self) end
-
----Sets the value of the Text property.
----@param self Button self
----@param Text string Label text displayed centered within the button
-function Button:setText(self, Text) end
-
----@class FlexBox : Container
----@field flexSpacing number The spacing between flex items
----@field flexDirection string The direction of the flexbox layout "row" or "column"
----@field flexUpdateLayout boolean Whether to update the layout of the flexbox
----@field flexAlignItems string The alignment of flex items along the cross axis
----@field flexJustifyContent string The alignment of flex items along the main axis
----@field flexWrap boolean Whether to wrap flex items onto multiple lines
----@field flexCrossPadding number The padding on both sides of the cross axis
-local FlexBox = {}
-
----Gets the value of the FlexDirection property.
----@param self FlexBox self
----@return string "row" The direction of the flexbox layout "row" or "column"
-function FlexBox:getFlexDirection(self) end
-
----Sets the value of the FlexSpacing property.
----@param self FlexBox self
----@param FlexSpacing number The spacing between flex items
-function FlexBox:setFlexSpacing(self, FlexSpacing) end
-
----Sets the value of the FlexUpdateLayout property.
----@param self FlexBox self
----@param FlexUpdateLayout boolean Whether to update the layout of the flexbox
-function FlexBox:setFlexUpdateLayout(self, FlexUpdateLayout) end
-
----Gets the value of the FlexCrossPadding property.
----@param self FlexBox self
----@return number 0 The padding on both sides of the cross axis
-function FlexBox:getFlexCrossPadding(self) end
-
----Adds a child element to the flexbox
----@param element Element The child element to add
----@return FlexBox self The flexbox instance
-function FlexBox:addChild(element) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function FlexBox:render() end
-
----Sets the value of the FlexWrap property.
----@param self FlexBox self
----@param FlexWrap boolean Whether to wrap flex items onto multiple lines
-function FlexBox:setFlexWrap(self, FlexWrap) end
-
----Gets the value of the FlexWrap property.
----@param self FlexBox self
----@return boolean false Whether to wrap flex items onto multiple lines
-function FlexBox:getFlexWrap(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return FlexBox self The initialized instance
----@protected
-function FlexBox:init(props, basalt) end
-
----Gets the value of the FlexSpacing property.
----@param self FlexBox self
----@return number 1 The spacing between flex items
-function FlexBox:getFlexSpacing(self) end
-
----Gets the value of the FlexUpdateLayout property.
----@param self FlexBox self
----@return boolean false Whether to update the layout of the flexbox
-function FlexBox:getFlexUpdateLayout(self) end
-
----Sets the value of the FlexAlignItems property.
----@param self FlexBox self
----@param FlexAlignItems string The alignment of flex items along the cross axis
-function FlexBox:setFlexAlignItems(self, FlexAlignItems) end
-
----Adds a new line break to the flexbox
----@param self FlexBox The element itself
----@return FlexBox 
-function FlexBox:addLineBreak(self) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param element Element The child element to remove
----@return FlexBox self The flexbox instance
----@protected
-function FlexBox:removeChild(element) end
-
----Sets the value of the FlexCrossPadding property.
----@param self FlexBox self
----@param FlexCrossPadding number The padding on both sides of the cross axis
-function FlexBox:setFlexCrossPadding(self, FlexCrossPadding) end
-
----Gets the value of the FlexJustifyContent property.
----@param self FlexBox self
----@return string "flex-start" The alignment of flex items along the main axis
-function FlexBox:getFlexJustifyContent(self) end
-
----Sets the value of the FlexJustifyContent property.
----@param self FlexBox self
----@param FlexJustifyContent string The alignment of flex items along the main axis
-function FlexBox:setFlexJustifyContent(self, FlexJustifyContent) end
-
----Sets the value of the FlexDirection property.
----@param self FlexBox self
----@param FlexDirection string The direction of the flexbox layout "row" or "column"
-function FlexBox:setFlexDirection(self, FlexDirection) end
-
----Gets the value of the FlexAlignItems property.
----@param self FlexBox self
----@return string "flex-start" The alignment of flex items along the cross axis
-function FlexBox:getFlexAlignItems(self) end
-
----@class Graph : VisualElement
----@field minValue number The minimum value of the graph
----@field series table The series of the graph
----@field maxValue number The maximum value of the graph
-local Graph = {}
-
----Sets the value of the MaxValue property.
----@param self Graph self
----@param MaxValue number The maximum value of the graph
-function Graph:setMaxValue(self, MaxValue) end
-
----@param name string The name of the series
----@return Graph self The graph instance
-function Graph:removeSeries(name) end
-
----Gets the value of the MinValue property.
----@param self Graph self
----@return number 0 The minimum value of the graph
-function Graph:getMinValue(self) end
-
----@param name string The name of the series
----@return Graph self The graph instance
-function Graph:focusSeries(name) end
-
----Sets the value of the Series property.
----@param self Graph self
----@param Series table The series of the graph
-function Graph:setSeries(self, Series) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@protected
-function Graph:render() end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return Graph self The initialized instance
----@protected
-function Graph:init(props, basalt) end
-
----@param name string The name of the series
----@param symbol string The symbol of the series
----@param bgCol number The background color of the series
----@param fgCol number The foreground color of the series
----@param pointCount number The number of points in the series
----@return Graph self The graph instance
-function Graph:addSeries(name, symbol, bgCol, fgCol, pointCount) end
-
----Clears all points from a series
----@return Graph self The graph instance
-function Graph:clear() end
-
----@param name string The name of the series
----@param visible boolean Whether the series should be visible
----@return Graph self The graph instance
-function Graph:changeSeriesVisibility(name, visible) end
-
----@param name string The name of the series
----@param value number The value of the point
----@return Graph self The graph instance
-function Graph:addPoint(name, value) end
-
----@param name string The name of the series
----@param count number The number of points in the series
----@return Graph self The graph instance
-function Graph:setSeriesPointCount(name, count) end
-
----@param name string The name of the series
----@return table ? series The series
-function Graph:getSeries(name) end
-
----Sets the value of the MinValue property.
----@param self Graph self
----@param MinValue number The minimum value of the graph
-function Graph:setMinValue(self, MinValue) end
-
----Gets the value of the MaxValue property.
----@param self Graph self
----@return number 100 The maximum value of the graph
-function Graph:getMaxValue(self) end
-
----@class ComboBox : DropDown
----@field text string The current text value of the input field
----@field focusedForeground color Text color when input is focused
----@field cursorPos number Current cursor position in the text input
----@field editable boolean Enables direct text input in the field
----@field placeholder string Text shown when the input is empty
----@field manuallyOpened boolean Indicates if dropdown was opened by user action
----@field autoComplete boolean Enables filtering dropdown items while typing
----@field viewOffset number Horizontal scroll position for viewing long text
----@field focusedBackground color Background color when input is focused
----@field placeholderColor color Color used for placeholder text
-local ComboBox = {}
-
----Gets the value of the CursorPos property.
----@param self ComboBox self
----@return number 1 Current cursor position in the text input
-function ComboBox:getCursorPos(self) end
-
----Gets the current text content
----@return string text The current text
-function ComboBox:getText() end
-
----Gets the value of the Editable property.
----@param self ComboBox self
----@return boolean true Enables direct text input in the field
-function ComboBox:getEditable(self) end
-
----Gets the value of the Placeholder property.
----@param self ComboBox self
----@return string "..." Text shown when the input is empty
-function ComboBox:getPlaceholder(self) end
-
----Called when the ComboBox loses focus
-function ComboBox:blur() end
-
----Sets whether the ComboBox is editable
----@param editable boolean Whether the ComboBox should be editable
----@return ComboBox self
-function ComboBox:setEditable(editable) end
-
----Handles mouse clicks
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param button number The mouse button (1 = left, 2 = right, 3 = middle)
----@param x number The x coordinate of the click
----@param y number The y coordinate of the click
----@return boolean handled Whether the event was handled
----@protected
-function ComboBox:mouse_click(button, x, y) end
-
----Gets the value of the AutoComplete property.
----@param self ComboBox self
----@return boolean false Enables filtering dropdown items while typing
-function ComboBox:getAutoComplete(self) end
-
----Renders the ComboBox
-function ComboBox:render() end
-
----Sets the value of the FocusedForeground property.
----@param self ComboBox self
----@param FocusedForeground color Text color when input is focused
-function ComboBox:setFocusedForeground(self, FocusedForeground) end
-
----Handles character input when editable
----@param char string The character that was typed
-function ComboBox:char(char) end
-
----Sets the value of the FocusedBackground property.
----@param self ComboBox self
----@param FocusedBackground color Background color when input is focused
-function ComboBox:setFocusedBackground(self, FocusedBackground) end
-
----Handles key input when editable
----@param key number The key code that was pressed
----@param held boolean Whether the key is being held
-function ComboBox:key(key, held) end
-
----Sets the value of the AutoComplete property.
----@param self ComboBox self
----@param AutoComplete boolean Enables filtering dropdown items while typing
-function ComboBox:setAutoComplete(self, AutoComplete) end
-
----Sets the value of the ManuallyOpened property.
----@param self ComboBox self
----@param ManuallyOpened boolean Indicates if dropdown was opened by user action
-function ComboBox:setManuallyOpened(self, ManuallyOpened) end
-
----Creates a new ComboBox instance
----@return ComboBox self The newly created ComboBox instance
-function ComboBox.new() end
-
----Gets the value of the ManuallyOpened property.
----@param self ComboBox self
----@return boolean false Indicates if dropdown was opened by user action
-function ComboBox:getManuallyOpened(self) end
-
----Sets the value of the PlaceholderColor property.
----@param self ComboBox self
----@param PlaceholderColor color Color used for placeholder text
-function ComboBox:setPlaceholderColor(self, PlaceholderColor) end
-
----This function is protected and should not be called outside of basalt, however you can overwrite it if you know what you're doing.
----@param props table The properties to initialize the element with
----@param basalt table The basalt instance
----@return ComboBox self The initialized instance
----@protected
-function ComboBox:init(props, basalt) end
-
----Gets the value of the ViewOffset property.
----@param self ComboBox self
----@return number 0 Horizontal scroll position for viewing long text
-function ComboBox:getViewOffset(self) end
-
----Called when the ComboBox gains focus
-function ComboBox:focus() end
-
----Sets the text content of the ComboBox
----@param text string The text to set
----@return ComboBox self
-function ComboBox:setText(text) end
-
----Sets the value of the CursorPos property.
----@param self ComboBox self
----@param CursorPos number Current cursor position in the text input
-function ComboBox:setCursorPos(self, CursorPos) end
-
----Gets the value of the PlaceholderColor property.
----@param self ComboBox self
----@return color gray Color used for placeholder text
-function ComboBox:getPlaceholderColor(self) end
-
----Gets the value of the FocusedForeground property.
----@param self ComboBox self
----@return color white Text color when input is focused
-function ComboBox:getFocusedForeground(self) end
-
----Gets the value of the FocusedBackground property.
----@param self ComboBox self
----@return color blue Background color when input is focused
-function ComboBox:getFocusedBackground(self) end
-
----Sets the value of the ViewOffset property.
----@param self ComboBox self
----@param ViewOffset number Horizontal scroll position for viewing long text
-function ComboBox:setViewOffset(self, ViewOffset) end
-
----Sets the value of the Placeholder property.
----@param self ComboBox self
----@param Placeholder string Text shown when the input is empty
-function ComboBox:setPlaceholder(self, Placeholder) end
-
diff --git a/config.lua b/config.lua
index 8d0ae05..2fe0627 100644
--- a/config.lua
+++ b/config.lua
@@ -3,446 +3,454 @@ return {
     ["plugins"] = {
       ["files"] = {
         ["xml"] = {
-          ["default"] = true,
-          ["size"] = 9940,
+          ["description"] = "",
           ["path"] = "plugins/xml.lua",
+          ["size"] = 9940,
           ["requires"] = {
           },
-          ["description"] = "",
-        },
-        ["canvas"] = {
           ["default"] = true,
-          ["size"] = 7873,
-          ["path"] = "plugins/canvas.lua",
+        },
+        ["debug"] = {
+          ["description"] = "",
+          ["path"] = "plugins/debug.lua",
+          ["size"] = 6250,
           ["requires"] = {
           },
+          ["default"] = true,
+        },
+        ["theme"] = {
           ["description"] = "",
+          ["path"] = "plugins/theme.lua",
+          ["size"] = 6775,
+          ["requires"] = {
+          },
+          ["default"] = true,
         },
         ["animation"] = {
-          ["default"] = true,
-          ["size"] = 18421,
+          ["description"] = "",
           ["path"] = "plugins/animation.lua",
+          ["size"] = 18421,
           ["requires"] = {
           },
+          ["default"] = true,
+        },
+        ["reactive"] = {
           ["description"] = "",
+          ["path"] = "plugins/reactive.lua",
+          ["size"] = 8619,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["canvas"] = {
+          ["description"] = "",
+          ["path"] = "plugins/canvas.lua",
+          ["size"] = 7873,
+          ["requires"] = {
+          },
+          ["default"] = true,
         },
         ["benchmark"] = {
-          ["default"] = true,
-          ["size"] = 12581,
+          ["description"] = "",
           ["path"] = "plugins/benchmark.lua",
+          ["size"] = 12581,
           ["requires"] = {
             [1] = "VisualElement",
           },
-          ["description"] = "",
-        },
-        ["theme"] = {
           ["default"] = true,
-          ["size"] = 7042,
-          ["path"] = "plugins/theme.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["debug"] = {
-          ["default"] = true,
-          ["size"] = 6250,
-          ["path"] = "plugins/debug.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["reactive"] = {
-          ["default"] = true,
-          ["size"] = 8619,
-          ["path"] = "plugins/reactive.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["state"] = {
-          ["default"] = true,
-          ["size"] = 6896,
-          ["path"] = "plugins/state.lua",
-          ["requires"] = {
-            [1] = "Container",
-          },
-          ["description"] = "",
         },
       },
       ["description"] = "Plugins",
     },
-    ["core"] = {
-      ["files"] = {
-        ["log"] = {
-          ["default"] = true,
-          ["size"] = 3142,
-          ["path"] = "log.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["render"] = {
-          ["default"] = true,
-          ["size"] = 12422,
-          ["path"] = "render.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["init"] = {
-          ["default"] = true,
-          ["size"] = 622,
-          ["path"] = "init.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["elementManager"] = {
-          ["default"] = true,
-          ["size"] = 6297,
-          ["path"] = "elementManager.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["main"] = {
-          ["default"] = true,
-          ["size"] = 14085,
-          ["path"] = "main.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["propertySystem"] = {
-          ["default"] = true,
-          ["size"] = 15524,
-          ["path"] = "propertySystem.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["errorManager"] = {
-          ["default"] = true,
-          ["size"] = 3789,
-          ["path"] = "errorManager.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-      },
-      ["description"] = "Core Files",
-    },
     ["libraries"] = {
       ["files"] = {
-        ["colorHex"] = {
-          ["default"] = true,
-          ["size"] = 132,
-          ["path"] = "libraries/colorHex.lua",
+        ["expect"] = {
+          ["description"] = "",
+          ["path"] = "libraries/expect.lua",
+          ["size"] = 846,
           ["requires"] = {
           },
-          ["description"] = "",
+          ["default"] = true,
         },
         ["utils"] = {
-          ["default"] = true,
-          ["size"] = 2661,
+          ["description"] = "",
           ["path"] = "libraries/utils.lua",
+          ["size"] = 2661,
           ["requires"] = {
           },
-          ["description"] = "",
-        },
-        ["expect"] = {
           ["default"] = true,
-          ["size"] = 846,
-          ["path"] = "libraries/expect.lua",
+        },
+        ["colorHex"] = {
+          ["description"] = "",
+          ["path"] = "libraries/colorHex.lua",
+          ["size"] = 132,
           ["requires"] = {
           },
+          ["default"] = true,
+        },
+        ["collectionentry"] = {
           ["description"] = "",
+          ["path"] = "libraries/collectionentry.lua",
+          ["size"] = 3551,
+          ["requires"] = {
+          },
+          ["default"] = true,
         },
       },
       ["description"] = "Libraries",
     },
     ["elements"] = {
       ["files"] = {
-        ["SideNav"] = {
-          ["default"] = true,
-          ["size"] = 20221,
-          ["path"] = "elements/SideNav.lua",
-          ["requires"] = {
-            [1] = "Container",
-          },
-          ["description"] = "A SideNav element that provides sidebar navigation with multiple content areas.",
-        },
-        ["ProgressBar"] = {
-          ["default"] = true,
-          ["size"] = 3397,
-          ["path"] = "elements/ProgressBar.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "",
-        },
         ["Slider"] = {
-          ["default"] = true,
-          ["size"] = 4977,
-          ["path"] = "elements/Slider.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
           ["description"] = "",
-        },
-        ["VisualElement"] = {
-          ["default"] = true,
-          ["size"] = 22428,
-          ["path"] = "elements/VisualElement.lua",
-          ["requires"] = {
-            [1] = "BaseElement",
-          },
-          ["description"] = "The Visual Element class which is the base class for all visual UI elements",
-        },
-        ["List"] = {
-          ["default"] = true,
-          ["size"] = 8758,
-          ["path"] = "elements/List.lua",
+          ["path"] = "elements/Slider.lua",
+          ["size"] = 4977,
           ["requires"] = {
             [1] = "VisualElement",
           },
-          ["description"] = "A scrollable list of selectable items",
+          ["default"] = true,
         },
         ["Menu"] = {
-          ["default"] = true,
-          ["size"] = 4679,
+          ["description"] = "A horizontal menu bar with selectable items.",
           ["path"] = "elements/Menu.lua",
+          ["size"] = 4679,
           ["requires"] = {
             [1] = "List",
           },
-          ["description"] = "A horizontal menu bar with selectable items.",
-        },
-        ["Timer"] = {
           ["default"] = true,
-          ["size"] = 2914,
-          ["path"] = "elements/Timer.lua",
+        },
+        ["BaseElement"] = {
+          ["description"] = "The base class for all UI elements in Basalt.",
+          ["path"] = "elements/BaseElement.lua",
+          ["size"] = 13859,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["LineChart"] = {
+          ["description"] = "",
+          ["path"] = "elements/LineChart.lua",
+          ["size"] = 3227,
+          ["requires"] = {
+          },
+          ["default"] = false,
+        },
+        ["Switch"] = {
+          ["description"] = "The Switch is a standard Switch element with click handling and state management.",
+          ["path"] = "elements/Switch.lua",
+          ["size"] = 3269,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["CheckBox"] = {
+          ["description"] = "This is a checkbox. It is a visual element that can be checked.",
+          ["path"] = "elements/CheckBox.lua",
+          ["size"] = 3763,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["DropDown"] = {
+          ["description"] = "A DropDown menu that shows a list of selectable items",
+          ["path"] = "elements/DropDown.lua",
+          ["size"] = 8100,
+          ["requires"] = {
+            [1] = "List",
+          },
+          ["default"] = false,
+        },
+        ["Graph"] = {
+          ["description"] = "A point based graph element",
+          ["path"] = "elements/Graph.lua",
+          ["size"] = 6989,
+          ["requires"] = {
+          },
+          ["default"] = false,
+        },
+        ["TextBox"] = {
+          ["description"] = "A multi-line text editor component with cursor support and text manipulation features",
+          ["path"] = "elements/TextBox.lua",
+          ["size"] = 43530,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = false,
+        },
+        ["ProgressBar"] = {
+          ["description"] = "",
+          ["path"] = "elements/ProgressBar.lua",
+          ["size"] = 3397,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["BaseFrame"] = {
+          ["description"] = "This is the base frame class. It is the root element of all elements and the only element without a parent.",
+          ["path"] = "elements/BaseFrame.lua",
+          ["size"] = 9017,
+          ["requires"] = {
+            [1] = "Container",
+          },
+          ["default"] = true,
+        },
+        ["Button"] = {
+          ["description"] = "The Button is a standard button element with click handling and state management.",
+          ["path"] = "elements/Button.lua",
+          ["size"] = 2556,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["Image"] = {
+          ["description"] = "An element that displays an image in bimg format",
+          ["path"] = "elements/Image.lua",
+          ["size"] = 15125,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = false,
+        },
+        ["Table"] = {
+          ["description"] = "",
+          ["path"] = "elements/Table.lua",
+          ["size"] = 16214,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["ScrollBar"] = {
+          ["description"] = "A ScrollBar element that can be attached to other elements to control their scroll properties.",
+          ["path"] = "elements/ScrollBar.lua",
+          ["size"] = 9665,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["Input"] = {
+          ["description"] = "A text input field with various features",
+          ["path"] = "elements/Input.lua",
+          ["size"] = 9200,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["TabControl"] = {
+          ["description"] = "A TabControl element that provides tabbed interface with multiple content areas.",
+          ["path"] = "elements/TabControl.lua",
+          ["size"] = 18961,
+          ["requires"] = {
+            [1] = "Container",
+          },
+          ["default"] = true,
+        },
+        ["Container"] = {
+          ["description"] = "The container class. It is a visual element that can contain other elements. It is the base class for all containers",
+          ["path"] = "elements/Container.lua",
+          ["size"] = 26177,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["VisualElement"] = {
+          ["description"] = "The Visual Element class which is the base class for all visual UI elements",
+          ["path"] = "elements/VisualElement.lua",
+          ["size"] = 43326,
           ["requires"] = {
             [1] = "BaseElement",
           },
+          ["default"] = true,
+        },
+        ["Tree"] = {
           ["description"] = "",
-        },
-        ["FlexBox"] = {
-          ["default"] = true,
-          ["size"] = 32431,
-          ["path"] = "elements/FlexBox.lua",
-          ["requires"] = {
-            [1] = "Container",
-          },
-          ["description"] = "A flexbox container that arranges its children in a flexible layout.",
-        },
-        ["Container"] = {
-          ["default"] = true,
-          ["size"] = 26148,
-          ["path"] = "elements/Container.lua",
+          ["path"] = "elements/Tree.lua",
+          ["size"] = 8519,
           ["requires"] = {
             [1] = "VisualElement",
           },
-          ["description"] = "The container class. It is a visual element that can contain other elements. It is the base class for all containers",
-        },
-        ["Image"] = {
-          ["default"] = false,
-          ["size"] = 15125,
-          ["path"] = "elements/Image.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "An element that displays an image in bimg format",
-        },
-        ["Graph"] = {
-          ["default"] = false,
-          ["size"] = 6989,
-          ["path"] = "elements/Graph.lua",
-          ["requires"] = {
-          },
-          ["description"] = "A point based graph element",
-        },
-        ["TabControl"] = {
           ["default"] = true,
-          ["size"] = 18961,
-          ["path"] = "elements/TabControl.lua",
-          ["requires"] = {
-            [1] = "Container",
-          },
-          ["description"] = "A TabControl element that provides tabbed interface with multiple content areas.",
         },
-        ["Display"] = {
-          ["default"] = false,
-          ["size"] = 5071,
-          ["path"] = "elements/Display.lua",
+        ["Label"] = {
+          ["description"] = "A simple text display element that automatically resizes its width based on the text content.",
+          ["path"] = "elements/Label.lua",
+          ["size"] = 3092,
           ["requires"] = {
             [1] = "VisualElement",
           },
-          ["description"] = "The Display is a special element which uses the CC Window API which you can use.",
-        },
-        ["TextBox"] = {
-          ["default"] = false,
-          ["size"] = 43466,
-          ["path"] = "elements/TextBox.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "A multi-line text editor component with cursor support and text manipulation features",
-        },
-        ["Program"] = {
           ["default"] = true,
-          ["size"] = 11430,
-          ["path"] = "elements/Program.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "",
-        },
-        ["CheckBox"] = {
-          ["default"] = true,
-          ["size"] = 3731,
-          ["path"] = "elements/CheckBox.lua",
-          ["requires"] = {
-          },
-          ["description"] = "This is a checkbox. It is a visual element that can be checked.",
         },
         ["ComboBox"] = {
-          ["default"] = false,
-          ["size"] = 15122,
+          ["description"] = "A ComboBox that combines dropdown selection with editable text input",
           ["path"] = "elements/ComboBox.lua",
+          ["size"] = 13718,
           ["requires"] = {
             [1] = "DropDown",
           },
-          ["description"] = "A ComboBox that combines dropdown selection with editable text input",
-        },
-        ["BaseFrame"] = {
-          ["default"] = true,
-          ["size"] = 9017,
-          ["path"] = "elements/BaseFrame.lua",
-          ["requires"] = {
-            [1] = "Container",
-          },
-          ["description"] = "This is the base frame class. It is the root element of all elements and the only element without a parent.",
-        },
-        ["ScrollBar"] = {
-          ["default"] = true,
-          ["size"] = 9665,
-          ["path"] = "elements/ScrollBar.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "A ScrollBar element that can be attached to other elements to control their scroll properties.",
-        },
-        ["Table"] = {
-          ["default"] = true,
-          ["size"] = 16214,
-          ["path"] = "elements/Table.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "",
-        },
-        ["Input"] = {
-          ["default"] = true,
-          ["size"] = 9558,
-          ["path"] = "elements/Input.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "A text input field with various features",
-        },
-        ["LineChart"] = {
           ["default"] = false,
-          ["size"] = 3227,
-          ["path"] = "elements/LineChart.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
         },
-        ["Label"] = {
-          ["default"] = true,
-          ["size"] = 3092,
-          ["path"] = "elements/Label.lua",
+        ["Display"] = {
+          ["description"] = "The Display is a special element which uses the CC Window API which you can use.",
+          ["path"] = "elements/Display.lua",
+          ["size"] = 5071,
           ["requires"] = {
             [1] = "VisualElement",
           },
-          ["description"] = "A simple text display element that automatically resizes its width based on the text content.",
-        },
-        ["BaseElement"] = {
-          ["default"] = true,
-          ["size"] = 10012,
-          ["path"] = "elements/BaseElement.lua",
-          ["requires"] = {
-          },
-          ["description"] = "The base class for all UI elements in Basalt.",
-        },
-        ["Button"] = {
-          ["default"] = true,
-          ["size"] = 2540,
-          ["path"] = "elements/Button.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "The Button is a standard button element with click handling and state management.",
-        },
-        ["Switch"] = {
-          ["default"] = true,
-          ["size"] = 3269,
-          ["path"] = "elements/Switch.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "The Switch is a standard Switch element with click handling and state management.",
-        },
-        ["Tree"] = {
-          ["default"] = true,
-          ["size"] = 8519,
-          ["path"] = "elements/Tree.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "",
-        },
-        ["DropDown"] = {
           ["default"] = false,
-          ["size"] = 7642,
-          ["path"] = "elements/DropDown.lua",
-          ["requires"] = {
-            [1] = "List",
-          },
-          ["description"] = "A DropDown menu that shows a list of selectable items",
         },
-        ["BarChart"] = {
+        ["Timer"] = {
+          ["description"] = "",
+          ["path"] = "elements/Timer.lua",
+          ["size"] = 2914,
+          ["requires"] = {
+            [1] = "BaseElement",
+          },
           ["default"] = true,
-          ["size"] = 3590,
-          ["path"] = "elements/BarChart.lua",
-          ["requires"] = {
-          },
-          ["description"] = "",
-        },
-        ["BigFont"] = {
-          ["default"] = false,
-          ["size"] = 21649,
-          ["path"] = "elements/BigFont.lua",
-          ["requires"] = {
-            [1] = "VisualElement",
-          },
-          ["description"] = "",
         },
         ["Frame"] = {
-          ["default"] = true,
-          ["size"] = 6508,
+          ["description"] = "A frame element that serves as a grouping container for other elements.",
           ["path"] = "elements/Frame.lua",
+          ["size"] = 6508,
           ["requires"] = {
             [1] = "Container",
           },
-          ["description"] = "A frame element that serves as a grouping container for other elements.",
+          ["default"] = true,
+        },
+        ["FlexBox"] = {
+          ["description"] = "A flexbox container that arranges its children in a flexible layout.",
+          ["path"] = "elements/FlexBox.lua",
+          ["size"] = 32431,
+          ["requires"] = {
+            [1] = "Container",
+          },
+          ["default"] = true,
+        },
+        ["List"] = {
+          ["description"] = "A scrollable list of selectable items",
+          ["path"] = "elements/List.lua",
+          ["size"] = 6039,
+          ["requires"] = {
+            [1] = "Collection",
+          },
+          ["default"] = true,
+        },
+        ["SideNav"] = {
+          ["description"] = "A SideNav element that provides sidebar navigation with multiple content areas.",
+          ["path"] = "elements/SideNav.lua",
+          ["size"] = 20221,
+          ["requires"] = {
+            [1] = "Container",
+          },
+          ["default"] = true,
+        },
+        ["Collection"] = {
+          ["description"] = "A collection of items",
+          ["path"] = "elements/Collection.lua",
+          ["size"] = 6008,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["BarChart"] = {
+          ["description"] = "",
+          ["path"] = "elements/BarChart.lua",
+          ["size"] = 3590,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["Program"] = {
+          ["description"] = "",
+          ["path"] = "elements/Program.lua",
+          ["size"] = 11435,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = true,
+        },
+        ["BigFont"] = {
+          ["description"] = "",
+          ["path"] = "elements/BigFont.lua",
+          ["size"] = 21649,
+          ["requires"] = {
+            [1] = "VisualElement",
+          },
+          ["default"] = false,
         },
       },
       ["description"] = "UI Elements",
     },
+    ["core"] = {
+      ["files"] = {
+        ["log"] = {
+          ["description"] = "",
+          ["path"] = "log.lua",
+          ["size"] = 3142,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["propertySystem"] = {
+          ["description"] = "",
+          ["path"] = "propertySystem.lua",
+          ["size"] = 18186,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["elementManager"] = {
+          ["description"] = "",
+          ["path"] = "elementManager.lua",
+          ["size"] = 15411,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["render"] = {
+          ["description"] = "",
+          ["path"] = "render.lua",
+          ["size"] = 12422,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["init"] = {
+          ["description"] = "",
+          ["path"] = "init.lua",
+          ["size"] = 622,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["errorManager"] = {
+          ["description"] = "",
+          ["path"] = "errorManager.lua",
+          ["size"] = 3789,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+        ["main"] = {
+          ["description"] = "",
+          ["path"] = "main.lua",
+          ["size"] = 19883,
+          ["requires"] = {
+          },
+          ["default"] = true,
+        },
+      },
+      ["description"] = "Core Files",
+    },
   },
   ["metadata"] = {
     ["version"] = "2.0",
-    ["generated"] = "Sun Oct 12 20:37:36 2025",
+    ["generated"] = "Mon Oct 27 07:26:27 2025",
   },
 }
\ No newline at end of file
diff --git a/release/basalt.lua b/release/basalt.lua
index f10dd00..42d40fe 100644
--- a/release/basalt.lua
+++ b/release/basalt.lua
@@ -36,10 +36,10 @@ minified_elementDirectory["ProgressBar"] = {}
 minified_elementDirectory["CheckBox"] = {}
 minified_elementDirectory["BaseElement"] = {}
 minified_elementDirectory["List"] = {}
+minified_elementDirectory["Collection"] = {}
 minified_pluginDirectory["canvas"] = {}
 minified_pluginDirectory["theme"] = {}
 minified_pluginDirectory["reactive"] = {}
-minified_pluginDirectory["state"] = {}
 minified_pluginDirectory["xml"] = {}
 minified_pluginDirectory["debug"] = {}
 minified_pluginDirectory["animation"] = {}
@@ -345,7 +345,7 @@ function ab:dispatchEvent(_c,...)
 local ac=self.get("program")local bc=da.dispatchEvent(self,_c,...)
 if ac then ac:resume(_c,...)
 if
-(self.get("focused"))then local cc=ac.window.getCursorBlink()
+(self:hasState("focused"))then local cc=ac.window.getCursorBlink()
 local dc,_d=ac.window.getCursorPos()
 self:setCursor(dc,_d,cc,ac.window.getTextColor())end;self:updateRender()end;return bc end
 function ab:focus()
@@ -487,13 +487,12 @@ project["elements/ComboBox.lua"] = function(...) local _a=require("elements/Visu
 local aa=require("elements/DropDown")local ba=require("libraries/colorHex")
 local ca=setmetatable({},aa)ca.__index=ca
 ca.defineProperty(ca,"editable",{default=true,type="boolean",canTriggerRender=true})
-ca.defineProperty(ca,"text",{default="",type="string",canTriggerRender=true})
+ca.defineProperty(ca,"text",{default="",type="string",canTriggerRender=true,seetter=function(da,_b)
+da.set("cursorPos",#da.get("text")+1)da:updateViewport()end})
 ca.defineProperty(ca,"cursorPos",{default=1,type="number"})
 ca.defineProperty(ca,"viewOffset",{default=0,type="number",canTriggerRender=true})
 ca.defineProperty(ca,"placeholder",{default="...",type="string"})
 ca.defineProperty(ca,"placeholderColor",{default=colors.gray,type="color"})
-ca.defineProperty(ca,"focusedBackground",{default=colors.blue,type="color"})
-ca.defineProperty(ca,"focusedForeground",{default=colors.white,type="color"})
 ca.defineProperty(ca,"autoComplete",{default=false,type="boolean"})
 ca.defineProperty(ca,"manuallyOpened",{default=false,type="boolean"})function ca.new()local da=setmetatable({},ca):__init()
 da.class=ca;da.set("width",16)da.set("height",1)da.set("z",8)
@@ -501,37 +500,33 @@ return da end
 function ca:init(da,_b)
 aa.init(self,da,_b)self.set("type","ComboBox")
 self.set("cursorPos",1)self.set("viewOffset",0)return self end
-function ca:setText(da)if da==nil then da=""end
-self.set("text",tostring(da))
-self.set("cursorPos",#self.get("text")+1)self:updateViewport()return self end;function ca:getText()return self.get("text")end;function ca:setEditable(da)
-self.set("editable",da)return self end
-function ca:getFilteredItems()
-local da=self.get("items")or{}local _b=self.get("text"):lower()if not
-self.get("autoComplete")or#_b==0 then return da end
-local ab={}
+function ca:getFilteredItems()local da=self.get("items")or{}
+local _b=self.get("text"):lower()
+if not self.get("autoComplete")or#_b==0 then return da end;local ab={}
 for bb,cb in ipairs(da)do local db=""
-if type(cb)=="string"then db=cb:lower()elseif type(cb)=="table"and
-cb.text then db=cb.text:lower()end;if db:find(_b,1,true)then table.insert(ab,cb)end end;return ab end
+if type(cb)=="string"then db=cb:lower()elseif
+type(cb)=="table"and cb.text then db=cb.text:lower()end;if db:find(_b,1,true)then table.insert(ab,cb)end end;return ab end
 function ca:updateFilteredDropdown()
 if not self.get("autoComplete")then return end;local da=self:getFilteredItems()local _b=#da>0 and
 #self.get("text")>0
-if _b then self.set("isOpen",true)
+if _b then self:setState("opened")
 self.set("manuallyOpened",false)local ab=self.get("dropdownHeight")or 5
-local bb=math.min(ab,#da)self.set("height",1 +bb)else self.set("isOpen",false)
-self.set("manuallyOpened",false)self.set("height",1)end;self:updateRender()end
+local bb=math.min(ab,#da)self.set("height",1 +bb)else
+self:unsetState("opened")self.set("manuallyOpened",false)
+self.set("height",1)end;self:updateRender()end
 function ca:updateViewport()local da=self.get("text")
 local _b=self.get("cursorPos")local ab=self.get("width")local bb=self.get("dropSymbol")
 local cb=ab-#bb;if cb<1 then cb=1 end;local db=self.get("viewOffset")if _b-db>cb then db=_b-cb elseif
 _b-1 <db then db=math.max(0,_b-1)end
 self.set("viewOffset",db)end
 function ca:char(da)if not self.get("editable")then return end;if not
-self.get("focused")then return end;local _b=self.get("text")
+self:hasState("focused")then return end;local _b=self.get("text")
 local ab=self.get("cursorPos")local bb=_b:sub(1,ab-1)..da.._b:sub(ab)
 self.set("text",bb)self.set("cursorPos",ab+1)self:updateViewport()
 if
 self.get("autoComplete")then self:updateFilteredDropdown()else self:updateRender()end end
 function ca:key(da,_b)if not self.get("editable")then return end;if not
-self.get("focused")then return end;local ab=self.get("text")
+self:hasState("focused")then return end;local ab=self.get("text")
 local bb=self.get("cursorPos")
 if da==keys.left then
 self.set("cursorPos",math.max(1,bb-1))self:updateViewport()elseif da==keys.right then
@@ -546,56 +541,56 @@ if
 self.get("autoComplete")then self:updateFilteredDropdown()else self:updateRender()end end elseif da==keys.home then self.set("cursorPos",1)
 self:updateViewport()elseif da==keys["end"]then self.set("cursorPos",#ab+1)
 self:updateViewport()elseif da==keys.enter then
-self.set("isOpen",not self.get("isOpen"))self:updateRender()end end
+if self:hasState("opened")then
+self:unsetState("opened")else self:setState("opened")end;self:updateRender()end end
 function ca:mouse_click(da,_b,ab)
 if not _a.mouse_click(self,da,_b,ab)then return false end;local bb,cb=self:getRelativePosition(_b,ab)
 local db=self.get("width")local _c=self.get("dropSymbol")
+local ac=self:hasState("opened")
 if cb==1 then
-if
-bb>=db-#_c+1 and bb<=db then local ac=self.get("isOpen")self.set("isOpen",not ac)
-if
-self.get("isOpen")then local bc=self.get("items")or{}
+if bb>=db-#_c+1 and bb<=db then if ac then
+self:unsetState("opened")else self:setState("opened")end
+if not ac then local bc=
+self.get("items")or{}
 local cc=self.get("dropdownHeight")or 5;local dc=math.min(cc,#bc)self.set("height",1 +dc)
 self.set("manuallyOpened",true)else self.set("height",1)
 self.set("manuallyOpened",false)end;self:updateRender()return true end
 if bb<=db-#_c and self.get("editable")then
-local ac=self.get("text")local bc=self.get("viewOffset")local cc=#ac+1
-local dc=math.min(cc,bc+bb)self.set("cursorPos",dc)self:updateRender()return true end;return true elseif
-self.get("isOpen")and cb>1 and self.get("selectable")then local ac=(cb-1)+self.get("offset")
-local bc=self.get("items")
-if ac<=#bc then local cc=bc[ac]
-if type(cc)=="string"then cc={text=cc}bc[ac]=cc end
-if not self.get("multiSelection")then for dc,_d in ipairs(bc)do if type(_d)=="table"then
-_d.selected=false end end end;cc.selected=true;if cc.text then self:setText(cc.text)end
-self.set("isOpen",false)self.set("height",1)self:updateRender()return true end end;return false end
-function ca:render()_a.render(self)local da=self.get("text")
-local _b=self.get("width")local ab=self.get("dropSymbol")local bb=self.get("focused")
-local cb=self.get("isOpen")local db=self.get("viewOffset")
-local _c=self.get("placeholder")
-local ac=bb and self.get("focusedBackground")or self.get("background")
-local bc=bb and self.get("focusedForeground")or self.get("foreground")local cc=da;local dc=_b-#ab;if#da==0 and not bb and#_c>0 then cc=_c
-bc=self.get("placeholderColor")end
-if#cc>0 then cc=cc:sub(db+1,db+dc)end;cc=cc..string.rep(" ",dc-#cc)local _d=cc..
-(cb and"\31"or"\17")
-self:blit(1,1,_d,string.rep(ba[bc],_b),string.rep(ba[ac],_b))
-if bb and self.get("editable")then local ad=self.get("cursorPos")
-local bd=ad-db;if bd>=1 and bd<=dc then
-self:setCursor(bd,1,true,self.get("foreground"))end end
-if cb then local ad
+local bc=self.get("text")local cc=self.get("viewOffset")local dc=#bc+1
+local _d=math.min(dc,cc+bb)self.set("cursorPos",_d)self:updateRender()return true end;return true elseif ac and cb>1 and self.get("selectable")then local bc=(cb-1)+
+self.get("offset")local cc=self.get("items")
+if bc<=#cc then
+local dc=cc[bc]if type(dc)=="string"then dc={text=dc}cc[bc]=dc end
+if not
+self.get("multiSelection")then for _d,ad in ipairs(cc)do
+if type(ad)=="table"then ad.selected=false end end end;dc.selected=true;if dc.text then self:setText(dc.text)end
+self:unsetState("opened")self.set("height",1)self:updateRender()return true end end;return false end
+function ca:render()_a.render(self)local da=self.getResolved("text")
+local _b=self.get("width")local ab=self.getResolved("dropSymbol")
+local bb=self:hasState("focused")local cb=self:hasState("opened")
+local db=self.get("viewOffset")local _c=self.getResolved("placeholder")
+local ac=self.getResolved("background")local bc=self.getResolved("foreground")local cc=da;local dc=_b-#ab;if
+#da==0 and not bb and#_c>0 then cc=_c
+bc=self.get("placeholderColor")end;if#cc>0 then
+cc=cc:sub(db+1,db+dc)end;cc=cc..string.rep(" ",dc-#cc)local _d=
+cc.. (cb and"\31"or"\17")
+self:blit(1,1,_d,string.rep(ba[bc],_b),string.rep(ba[ac],_b))if bb and self.get("editable")then local ad=self.get("cursorPos")
+local bd=ad-db
+if bd>=1 and bd<=dc then self:setCursor(bd,1,true,bc)end end
+if cb then
+local ad
 if
 self.get("autoComplete")and not self.get("manuallyOpened")then ad=self:getFilteredItems()else ad=self.get("items")end
 local bd=math.min(self.get("dropdownHeight"),#ad)
 if bd>0 then local cd=self.get("offset")
 for i=1,bd do local dd=i+cd
 if ad[dd]then local __a=ad[dd]
-local a_a=__a.text or""local b_a=__a.selected or false
-local c_a=
-b_a and self.get("selectedBackground")or self.get("background")
-local d_a=b_a and self.get("selectedForeground")or self.get("foreground")if#a_a>_b then a_a=a_a:sub(1,_b)end;a_a=a_a..
-string.rep(" ",_b-#a_a)
-self:blit(1,i+1,a_a,string.rep(ba[d_a],_b),string.rep(ba[c_a],_b))end end end end end;function ca:focus()aa.focus(self)end
-function ca:blur()aa.blur(self)
-self.set("isOpen",false)self.set("height",1)self:updateRender()end;return ca end
+local a_a=__a.text or""local b_a=__a.selected or false;local c_a=
+b_a and self.get("selectedBackground")or ac;local d_a=b_a and
+self.get("selectedForeground")or bc;if
+#a_a>_b then a_a=a_a:sub(1,_b)end
+a_a=a_a..string.rep(" ",_b-#a_a)
+self:blit(1,i+1,a_a,string.rep(ba[d_a],_b),string.rep(ba[c_a],_b))end end end end end;return ca end
 project["elements/TabControl.lua"] = function(...) local ba=require("elementManager")
 local ca=require("elements/VisualElement")local da=ba.getElement("Container")
 local _b=require("libraries/colorHex")local ab=require("log")local bb=setmetatable({},da)bb.__index=bb
@@ -929,7 +924,7 @@ aab:setZ(c_b.get("z")+c_b.get("autoCompleteZOffset"))aaa(c_b,dab,_bb)if bab and
 bab:updateRender()end;aab:updateRender()end
 local function _da(c_b)
 if not c_b.get("autoCompleteEnabled")then aba(c_b,true)return end
-if not c_b.get("focused")then aba(c_b,true)return end;local d_b,_ab=dba(c_b)c_b._autoCompleteToken=d_b
+if not c_b:hasState("focused")then aba(c_b,true)return end;local d_b,_ab=dba(c_b)c_b._autoCompleteToken=d_b
 c_b._autoCompleteTokenStart=_ab
 if#d_b<c_b.get("autoCompleteMinChars")then aba(c_b)return end;local aab=bca(c_b,d_b)if#aab==0 then aba(c_b)return end
 local bab=cba(c_b)if not bab then return end;bab:setOffset(0)bab:setItems(aab)
@@ -963,15 +958,14 @@ c_b.class=d_a;c_b.set("width",20)c_b.set("height",10)return c_b end
 function d_a:init(c_b,d_b)b_a.init(self,c_b,d_b)
 self.set("type","TextBox")
 local function _ab()if
-self.get("autoCompleteEnabled")and self.get("focused")then _da(self)end end;local function aab()daa(self)end
+self.get("autoCompleteEnabled")and self:hasState("focused")then _da(self)end end;local function aab()daa(self)end
 local function bab()
 if baa(self)then
 local cab=rawget(self,"_autoCompleteSuggestions")or{}
 dca(self,math.max(#cab,1),rawget(self,"_autoCompletePopupWidth")or
 self.get("width"))end end
-self:observe("autoCompleteEnabled",function(cab,dab)if not dab then aba(self,true)elseif self.get("focused")then
-_da(self)end end)
-self:observe("focused",function(cab,dab)if dab then _ab()else aba(self,true)end end)self:observe("foreground",aab)
+self:observe("autoCompleteEnabled",function(cab,dab)if not dab then aba(self,true)elseif self:hasState("focused")then
+_da(self)end end)self:observe("foreground",aab)
 self:observe("background",aab)self:observe("autoCompleteBackground",aab)
 self:observe("autoCompleteForeground",aab)
 self:observe("autoCompleteSelectedBackground",aab)
@@ -1028,36 +1022,37 @@ if c_b-_ab>bab then
 self.set("scrollX",c_b-bab)elseif c_b-_ab<1 then self.set("scrollX",c_b-1)end
 if d_b-aab>cab then self.set("scrollY",d_b-cab)elseif d_b-aab<1 then self.set("scrollY",
 d_b-1)end;return self end
-function d_a:char(c_b)if
-not self.get("editable")or not self.get("focused")then return false end
-local d_b=self.get("autoPairEnabled")
-if d_b and#c_b==1 then
-local _ab=self.get("autoPairCharacters")or{}local aab=self.get("lines")local bab=self.get("cursorX")
-local cab=self.get("cursorY")local dab=aab[cab]or""local _bb=dab:sub(bab,bab)local abb=_ab[c_b]
-if abb then
-cda(self,c_b)
-if self.get("autoPairSkipClosing")then
-if _bb~=abb then cda(self,abb)self.set("cursorX",
-self.get("cursorX")-1)end else cda(self,abb)
-self.set("cursorX",self.get("cursorX")-1)end;_da(self)return true end
+function d_a:char(c_b)
+if not self.get("editable")or
+not self:hasState("focused")then return false end;local d_b=self.get("autoPairEnabled")
+if d_b and#c_b==1 then local _ab=
+self.get("autoPairCharacters")or{}local aab=self.get("lines")
+local bab=self.get("cursorX")local cab=self.get("cursorY")local dab=aab[cab]or""
+local _bb=dab:sub(bab,bab)local abb=_ab[c_b]
+if abb then cda(self,c_b)
+if self.get("autoPairSkipClosing")then if _bb~=abb then
+cda(self,abb)
+self.set("cursorX",self.get("cursorX")-1)end else cda(self,abb)self.set("cursorX",
+self.get("cursorX")-1)end;_da(self)return true end
 if self.get("autoPairOverType")then
 for bbb,cbb in pairs(_ab)do if c_b==cbb and _bb==cbb then
 self.set("cursorX",bab+1)_da(self)return true end end end end;cda(self,c_b)_da(self)return true end
-function d_a:key(c_b)if
-not self.get("editable")or not self.get("focused")then return false end
-if ada(self,c_b)then return true end;local d_b=self.get("lines")local _ab=self.get("cursorX")
-local aab=self.get("cursorY")
+function d_a:key(c_b)
+if not self.get("editable")or
+not self:hasState("focused")then return false end;if ada(self,c_b)then return true end;local d_b=self.get("lines")
+local _ab=self.get("cursorX")local aab=self.get("cursorY")
 if c_b==keys.enter then
-if self.get("autoPairEnabled")and
-self.get("autoPairNewlineIndent")then local bab=self.get("lines")
-local cab=self.get("cursorX")local dab=self.get("cursorY")local _bb=bab[dab]or""
-local abb=_bb:sub(1,cab-1)local bbb=_bb:sub(cab)
-local cbb=self.get("autoPairCharacters")or{}local dbb={}for bcb,ccb in pairs(cbb)do dbb[ccb]=bcb end;local _cb=abb:sub(-1)
-local acb=bbb:sub(1,1)
-if _cb~=""and acb~=""and cbb[_cb]==acb then bab[dab]=abb;table.insert(bab,
-dab+1,"")table.insert(bab,dab+2,bbb)self.set("cursorY",
-dab+1)self.set("cursorX",1)
-self:updateViewport()self:updateRender()_da(self)return true end end;__b(self)elseif c_b==keys.backspace then a_b(self)elseif c_b==keys.left then
+if
+self.get("autoPairEnabled")and self.get("autoPairNewlineIndent")then
+local bab=self.get("lines")local cab=self.get("cursorX")local dab=self.get("cursorY")local _bb=
+bab[dab]or""local abb=_bb:sub(1,cab-1)local bbb=_bb:sub(cab)local cbb=
+self.get("autoPairCharacters")or{}local dbb={}
+for bcb,ccb in pairs(cbb)do dbb[ccb]=bcb end;local _cb=abb:sub(-1)local acb=bbb:sub(1,1)
+if _cb~=""and acb~=""and
+cbb[_cb]==acb then bab[dab]=abb;table.insert(bab,dab+1,"")table.insert(bab,
+dab+2,bbb)self.set("cursorY",dab+1)
+self.set("cursorX",1)self:updateViewport()self:updateRender()_da(self)return
+true end end;__b(self)elseif c_b==keys.backspace then a_b(self)elseif c_b==keys.left then
 if _ab>1 then self.set("cursorX",
 _ab-1)elseif aab>1 then self.set("cursorY",aab-1)self.set("cursorX",
 #d_b[aab-1]+1)end elseif c_b==keys.right then if _ab<=#d_b[aab]then
@@ -1086,10 +1081,10 @@ bbb+1))end;self:updateRender()_da(self)return true end
 if baa(self)then local aab=self._autoCompleteFrame;if
 not
 (aab and aab:isInBounds(d_b,_ab))and not self:isInBounds(d_b,_ab)then aba(self)end end;return false end
-function d_a:paste(c_b)if
-not self.get("editable")or not self.get("focused")then return false end
-for d_b in c_b:gmatch(".")do if d_b=="\n"then
-__b(self)else cda(self,d_b)end end;_da(self)return true end
+function d_a:paste(c_b)
+if not self.get("editable")or
+not self:hasState("focused")then return false end;for d_b in c_b:gmatch(".")do
+if d_b=="\n"then __b(self)else cda(self,d_b)end end;_da(self)return true end
 function d_a:setText(c_b)local d_b={}
 if c_b==""then d_b={""}else for _ab in(c_b.."\n"):gmatch("([^\n]*)\n")do
 table.insert(d_b,_ab)end end;self.set("lines",d_b)aba(self,true)return self end
@@ -1114,7 +1109,7 @@ aab-#dbb
 if acb>0 then dbb=dbb..string.rep(" ",acb)_cb=_cb..
 string.rep(c_a[self.get("foreground")],acb)end
 self:blit(1,y,dbb,_cb,string.rep(dab,#dbb))end
-if self.get("focused")then local _bb=self.get("cursorX")-d_b;local abb=
+if self:hasState("focused")then local _bb=self.get("cursorX")-d_b;local abb=
 self.get("cursorY")-_ab;if _bb>=1 and _bb<=aab and abb>=1 and
 abb<=bab then
 self:setCursor(_bb,abb,true,self.get("cursorColor")or
@@ -1132,10 +1127,10 @@ da.class=ca;da.set("width",10)da.set("height",3)da.set("z",5)
 return da end;function ca:init(da,_b)
 aa.init(self,da,_b)self.set("type","Button")end
 function ca:render()
-aa.render(self)local da=self.get("text")
+aa.render(self)local da=self.getResolved("text")
 da=da:sub(1,self.get("width"))
 local _b,ab=ba(da,self.get("width"),self.get("height"))
-self:textFg(_b,ab,da,self.get("foreground"))end;return ca end
+self:textFg(_b,ab,da,self.getResolved("foreground"))end;return ca end
 project["elements/Label.lua"] = function(...) local _a=require("elementManager")
 local aa=_a.getElement("VisualElement")local ba=require("libraries/utils").wrapText
 local ca=setmetatable({},aa)ca.__index=ca
@@ -1339,45 +1334,46 @@ aa.defineProperty(aa,"viewOffset",{default=0,type="number",canTriggerRender=true
 aa.defineProperty(aa,"maxLength",{default=nil,type="number"})
 aa.defineProperty(aa,"placeholder",{default="...",type="string"})
 aa.defineProperty(aa,"placeholderColor",{default=colors.gray,type="color"})
-aa.defineProperty(aa,"focusedBackground",{default=colors.blue,type="color"})
-aa.defineProperty(aa,"focusedForeground",{default=colors.white,type="color"})
 aa.defineProperty(aa,"pattern",{default=nil,type="string"})
 aa.defineProperty(aa,"cursorColor",{default=nil,type="number"})
 aa.defineProperty(aa,"replaceChar",{default=nil,type="string",canTriggerRender=true})aa.defineEvent(aa,"mouse_click")
-aa.defineEvent(aa,"key")aa.defineEvent(aa,"char")
+aa.defineEvent(aa,"mouse_up")aa.defineEvent(aa,"key")aa.defineEvent(aa,"char")
 aa.defineEvent(aa,"paste")
 function aa.new()local ba=setmetatable({},aa):__init()
 ba.class=aa;ba.set("width",8)ba.set("z",3)return ba end
 function aa:init(ba,ca)d.init(self,ba,ca)self.set("type","Input")return self end
 function aa:setCursor(ba,ca,da,_b)
 ba=math.min(self.get("width"),math.max(1,ba))return d.setCursor(self,ba,ca,da,_b)end
-function aa:char(ba)if not self.get("focused")then return false end
-local ca=self.get("text")local da=self.get("cursorPos")local _b=self.get("maxLength")
-local ab=self.get("pattern")if _b and#ca>=_b then return false end;if ab and not ba:match(ab)then return
-false end
-self.set("text",ca:sub(1,da-1)..ba..ca:sub(da))self.set("cursorPos",da+1)self:updateViewport()local bb=
+function aa:char(ba)
+if not self:hasState("focused")then return false end;local ca=self.get("text")local da=self.get("cursorPos")
+local _b=self.get("maxLength")local ab=self.get("pattern")
+if _b and#ca>=_b then return false end;if ab and not ba:match(ab)then return false end
+self.set("text",ca:sub(1,
+da-1)..ba..ca:sub(da))self.set("cursorPos",da+1)self:updateViewport()local bb=
 self.get("cursorPos")-self.get("viewOffset")
 self:setCursor(bb,1,true,
 self.get("cursorColor")or self.get("foreground"))d.char(self,ba)return true end
-function aa:key(ba,ca)if not self.get("focused")then return false end
-local da=self.get("cursorPos")local _b=self.get("text")local ab=self.get("viewOffset")
-local bb=self.get("width")
-if ba==keys.left then if da>1 then self.set("cursorPos",da-1)
-if da-1 <=ab then self.set("viewOffset",math.max(0,
-da-2))end end elseif ba==keys.right then if da<=#_b then self.set("cursorPos",
-da+1)if da-ab>=bb then
-self.set("viewOffset",da-bb+1)end end elseif
-ba==keys.backspace then if da>1 then
+function aa:key(ba,ca)
+if not self:hasState("focused")then return false end;local da=self.get("cursorPos")local _b=self.get("text")
+local ab=self.get("viewOffset")local bb=self.get("width")
+if ba==keys.left then
+if da>1 then
+self.set("cursorPos",da-1)if da-1 <=ab then
+self.set("viewOffset",math.max(0,da-2))end end elseif ba==keys.right then
+if da<=#_b then self.set("cursorPos",da+1)if da-ab>=bb then self.set("viewOffset",
+da-bb+1)end end elseif ba==keys.backspace then if da>1 then
 self.set("text",_b:sub(1,da-2).._b:sub(da))self.set("cursorPos",da-1)self:updateRender()
 self:updateViewport()end end
 local cb=self.get("cursorPos")-self.get("viewOffset")
-self:setCursor(cb,1,true,self.get("cursorColor")or self.get("foreground"))d.key(self,ba,ca)return true end
+self:setCursor(cb,1,true,self.getResolved("cursorColor")or
+self.getResolved("foreground"))d.key(self,ba,ca)return true end
 function aa:mouse_click(ba,ca,da)
 if d.mouse_click(self,ba,ca,da)then
 local _b,ab=self:getRelativePosition(ca,da)local bb=self.get("text")local cb=self.get("viewOffset")
 local db=#bb+1;local _c=math.min(db,cb+_b)self.set("cursorPos",_c)
 local ac=_c-cb
-self:setCursor(ac,1,true,self.get("cursorColor")or self.get("foreground"))return true end;return false end
+self:setCursor(ac,1,true,self.getResolved("cursorColor")or
+self.getResolved("foreground"))return true end;return false end
 function aa:updateViewport()local ba=self.get("width")
 local ca=self.get("cursorPos")local da=self.get("viewOffset")
 local _b=#self.get("text")
@@ -1386,29 +1382,28 @@ ca-1)end
 self.set("viewOffset",math.max(0,math.min(self.get("viewOffset"),_b-ba+1)))return self end
 function aa:focus()d.focus(self)
 self:setCursor(self.get("cursorPos")-
-self.get("viewOffset"),1,true,self.get("cursorColor")or self.get("foreground"))self:updateRender()end
+self.get("viewOffset"),1,true,self.getResolved("cursorColor")or
+self.getResolved("foreground"))self:updateRender()end
 function aa:blur()d.blur(self)
-self:setCursor(1,1,false,self.get("cursorColor")or
-self.get("foreground"))self:updateRender()end
-function aa:paste(ba)if not self.get("focused")then return false end
-local ca=self.get("text")local da=self.get("cursorPos")local _b=self.get("maxLength")
-local ab=self.get("pattern")local bb=ca:sub(1,da-1)..ba..ca:sub(da)if
-_b and#bb>_b then bb=bb:sub(1,_b)end;if ab and not bb:match(ab)then
-return false end;self.set("text",bb)
-self.set("cursorPos",da+#ba)self:updateViewport()end
-function aa:render()local ba=self.get("text")local ca=self.get("viewOffset")
-local da=self.get("width")local _b=self.get("placeholder")
-local ab=self.get("focusedBackground")local bb=self.get("focusedForeground")
-local cb=self.get("focused")local db,_c=self.get("width"),self.get("height")
-local ac=self.get("replaceChar")
-self:multiBlit(1,1,db,_c," ",_a[cb and bb or self.get("foreground")],_a[
-cb and ab or self.get("background")])if
-#ba==0 and#_b~=0 and self.get("focused")==false then
-self:textFg(1,1,_b:sub(1,db),self.get("placeholderColor"))return end;if(cb)then
+self:setCursor(1,1,false,self.getResolved("cursorColor")or
+self.getResolved("foreground"))self:updateRender()end
+function aa:paste(ba)
+if not self:hasState("focused")then return false end;local ca=self.get("text")local da=self.get("cursorPos")
+local _b=self.get("maxLength")local ab=self.get("pattern")
+local bb=ca:sub(1,da-1)..ba..ca:sub(da)if _b and#bb>_b then bb=bb:sub(1,_b)end;if
+ab and not bb:match(ab)then return false end;self.set("text",bb)self.set("cursorPos",da+
+#ba)self:updateViewport()end
+function aa:render()local ba=self.getResolved("text")
+local ca=self.get("viewOffset")local da=self.getResolved("placeholder")
+local _b=self:hasState("focused")local ab,bb=self.get("width"),self.get("height")
+local cb=self.getResolved("replaceChar")
+self:multiBlit(1,1,ab,bb," ",_a[self.getResolved("foreground")],_a[self.getResolved("background")])if#ba==0 and#da~=0 and not _b then
+self:textFg(1,1,da:sub(1,ab),self.getResolved("placeholderColor"))return end;if(_b)then
 self:setCursor(
-self.get("cursorPos")-ca,1,true,self.get("cursorColor")or self.get("foreground"))end
-local bc=ba:sub(ca+1,ca+db)if ac and#ac>0 then bc=ac:rep(#bc)end
-self:textFg(1,1,bc,self.get("foreground"))end;return aa end
+self.get("cursorPos")-ca,1,true,self.getResolved("cursorColor")or
+self.getResolved("foreground"))end
+local db=ba:sub(ca+1,ca+ab)if cb and#cb>0 then db=cb:rep(#db)end
+self:textFg(1,1,db,self.getResolved("foreground"))end;return aa end
 project["elements/BigFont.lua"] = function(...) local _b=require("libraries/colorHex")
 local ab={{"\32\32\32\137\156\148\158\159\148\135\135\144\159\139\32\136\157\32\159\139\32\32\143\32\32\143\32\32\32\32\32\32\32\32\147\148\150\131\148\32\32\32\151\140\148\151\140\147","\32\32\32\149\132\149\136\156\149\144\32\133\139\159\129\143\159\133\143\159\133\138\32\133\138\32\133\32\32\32\32\32\32\150\150\129\137\156\129\32\32\32\133\131\129\133\131\132","\32\32\32\130\131\32\130\131\32\32\129\32\32\32\32\130\131\32\130\131\32\32\32\32\143\143\143\32\32\32\32\32\32\130\129\32\130\135\32\32\32\32\131\32\32\131\32\131","\139\144\32\32\143\148\135\130\144\149\32\149\150\151\149\158\140\129\32\32\32\135\130\144\135\130\144\32\149\32\32\139\32\159\148\32\32\32\32\159\32\144\32\148\32\147\131\132","\159\135\129\131\143\149\143\138\144\138\32\133\130\149\149\137\155\149\159\143\144\147\130\132\32\149\32\147\130\132\131\159\129\139\151\129\148\32\32\139\131\135\133\32\144\130\151\32","\32\32\32\32\32\32\130\135\32\130\32\129\32\129\129\131\131\32\130\131\129\140\141\132\32\129\32\32\129\32\32\32\32\32\32\32\131\131\129\32\32\32\32\32\32\32\32\32","\32\32\32\32\149\32\159\154\133\133\133\144\152\141\132\133\151\129\136\153\32\32\154\32\159\134\129\130\137\144\159\32\144\32\148\32\32\32\32\32\32\32\32\32\32\32\151\129","\32\32\32\32\133\32\32\32\32\145\145\132\141\140\132\151\129\144\150\146\129\32\32\32\138\144\32\32\159\133\136\131\132\131\151\129\32\144\32\131\131\129\32\144\32\151\129\32","\32\32\32\32\129\32\32\32\32\130\130\32\32\129\32\129\32\129\130\129\129\32\32\32\32\130\129\130\129\32\32\32\32\32\32\32\32\133\32\32\32\32\32\129\32\129\32\32","\150\156\148\136\149\32\134\131\148\134\131\148\159\134\149\136\140\129\152\131\32\135\131\149\150\131\148\150\131\148\32\148\32\32\148\32\32\152\129\143\143\144\130\155\32\134\131\148","\157\129\149\32\149\32\152\131\144\144\131\148\141\140\149\144\32\149\151\131\148\32\150\32\150\131\148\130\156\133\32\144\32\32\144\32\130\155\32\143\143\144\32\152\129\32\134\32","\130\131\32\131\131\129\131\131\129\130\131\32\32\32\129\130\131\32\130\131\32\32\129\32\130\131\32\130\129\32\32\129\32\32\133\32\32\32\129\32\32\32\130\32\32\32\129\32","\150\140\150\137\140\148\136\140\132\150\131\132\151\131\148\136\147\129\136\147\129\150\156\145\138\143\149\130\151\32\32\32\149\138\152\129\149\32\32\157\152\149\157\144\149\150\131\148","\149\143\142\149\32\149\149\32\149\149\32\144\149\32\149\149\32\32\149\32\32\149\32\149\149\32\149\32\149\32\144\32\149\149\130\148\149\32\32\149\32\149\149\130\149\149\32\149","\130\131\129\129\32\129\131\131\32\130\131\32\131\131\32\131\131\129\129\32\32\130\131\32\129\32\129\130\131\32\130\131\32\129\32\129\131\131\129\129\32\129\129\32\129\130\131\32","\136\140\132\150\131\148\136\140\132\153\140\129\131\151\129\149\32\149\149\32\149\149\32\149\137\152\129\137\152\129\131\156\133\149\131\32\150\32\32\130\148\32\152\137\144\32\32\32","\149\32\32\149\159\133\149\32\149\144\32\149\32\149\32\149\32\149\150\151\129\138\155\149\150\130\148\32\149\32\152\129\32\149\32\32\32\150\32\32\149\32\32\32\32\32\32\32","\129\32\32\130\129\129\129\32\129\130\131\32\32\129\32\130\131\32\32\129\32\129\32\129\129\32\129\32\129\32\131\131\129\130\131\32\32\32\129\130\131\32\32\32\32\140\140\132","\32\154\32\159\143\32\149\143\32\159\143\32\159\144\149\159\143\32\159\137\145\159\143\144\149\143\32\32\145\32\32\32\145\149\32\144\32\149\32\143\159\32\143\143\32\159\143\32","\32\32\32\152\140\149\151\32\149\149\32\145\149\130\149\157\140\133\32\149\32\154\143\149\151\32\149\32\149\32\144\32\149\149\153\32\32\149\32\149\133\149\149\32\149\149\32\149","\32\32\32\130\131\129\131\131\32\130\131\32\130\131\129\130\131\129\32\129\32\140\140\129\129\32\129\32\129\32\137\140\129\130\32\129\32\130\32\129\32\129\129\32\129\130\131\32","\144\143\32\159\144\144\144\143\32\159\143\144\159\138\32\144\32\144\144\32\144\144\32\144\144\32\144\144\32\144\143\143\144\32\150\129\32\149\32\130\150\32\134\137\134\134\131\148","\136\143\133\154\141\149\151\32\129\137\140\144\32\149\32\149\32\149\154\159\133\149\148\149\157\153\32\154\143\149\159\134\32\130\148\32\32\149\32\32\151\129\32\32\32\32\134\32","\133\32\32\32\32\133\129\32\32\131\131\32\32\130\32\130\131\129\32\129\32\130\131\129\129\32\129\140\140\129\131\131\129\32\130\129\32\129\32\130\129\32\32\32\32\32\129\32","\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32","\32\32\32\32\32\32\32\32\32\32\32\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\32\32\32\32\32\32\32\32\32\32\32","\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32\32","\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32\32\32\32\32\149\32\32\149\32\32\32\32","\32\32\32\32\32\32\32\32\32\32\32\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\32\32\32\32\32\32\32\32\32\32\32","\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32\32\149\32","\32\32\32\32\145\32\159\139\32\151\131\132\155\143\132\134\135\145\32\149\32\158\140\129\130\130\32\152\147\155\157\134\32\32\144\144\32\32\32\32\32\32\152\131\155\131\131\129","\32\32\32\32\149\32\149\32\145\148\131\32\149\32\149\140\157\132\32\148\32\137\155\149\32\32\32\149\154\149\137\142\32\153\153\32\131\131\149\131\131\129\149\135\145\32\32\32","\32\32\32\32\129\32\130\135\32\131\131\129\134\131\132\32\129\32\32\129\32\131\131\32\32\32\32\130\131\129\32\32\32\32\129\129\32\32\32\32\32\32\130\131\129\32\32\32","\150\150\32\32\148\32\134\32\32\132\32\32\134\32\32\144\32\144\150\151\149\32\32\32\32\32\32\145\32\32\152\140\144\144\144\32\133\151\129\133\151\129\132\151\129\32\145\32","\130\129\32\131\151\129\141\32\32\142\32\32\32\32\32\149\32\149\130\149\149\32\143\32\32\32\32\142\132\32\154\143\133\157\153\132\151\150\148\151\158\132\151\150\148\144\130\148","\32\32\32\140\140\132\32\32\32\32\32\32\32\32\32\151\131\32\32\129\129\32\32\32\32\134\32\32\32\32\32\32\32\129\129\32\129\32\129\129\130\129\129\32\129\130\131\32","\156\143\32\159\141\129\153\140\132\153\137\32\157\141\32\159\142\32\150\151\129\150\131\132\140\143\144\143\141\145\137\140\148\141\141\144\157\142\32\159\140\32\151\134\32\157\141\32","\157\140\149\157\140\149\157\140\149\157\140\149\157\140\149\157\140\149\151\151\32\154\143\132\157\140\32\157\140\32\157\140\32\157\140\32\32\149\32\32\149\32\32\149\32\32\149\32","\129\32\129\129\32\129\129\32\129\129\32\129\129\32\129\129\32\129\129\131\129\32\134\32\131\131\129\131\131\129\131\131\129\131\131\129\130\131\32\130\131\32\130\131\32\130\131\32","\151\131\148\152\137\145\155\140\144\152\142\145\153\140\132\153\137\32\154\142\144\155\159\132\150\156\148\147\32\144\144\130\145\136\137\32\146\130\144\144\130\145\130\136\32\151\140\132","\151\32\149\151\155\149\149\32\149\149\32\149\149\32\149\149\32\149\149\32\149\152\137\144\157\129\149\149\32\149\149\32\149\149\32\149\149\32\149\130\150\32\32\157\129\149\32\149","\131\131\32\129\32\129\130\131\32\130\131\32\130\131\32\130\131\32\130\131\32\32\32\32\130\131\32\130\131\32\130\131\32\130\131\32\130\131\32\32\129\32\130\131\32\133\131\32","\156\143\32\159\141\129\153\140\132\153\137\32\157\141\32\159\142\32\159\159\144\152\140\144\156\143\32\159\141\129\153\140\132\157\141\32\130\145\32\32\147\32\136\153\32\130\146\32","\152\140\149\152\140\149\152\140\149\152\140\149\152\140\149\152\140\149\149\157\134\154\143\132\157\140\133\157\140\133\157\140\133\157\140\133\32\149\32\32\149\32\32\149\32\32\149\32","\130\131\129\130\131\129\130\131\129\130\131\129\130\131\129\130\131\129\130\130\131\32\134\32\130\131\129\130\131\129\130\131\129\130\131\129\32\129\32\32\129\32\32\129\32\32\129\32","\159\134\144\137\137\32\156\143\32\159\141\129\153\140\132\153\137\32\157\141\32\32\132\32\159\143\32\147\32\144\144\130\145\136\137\32\146\130\144\144\130\145\130\138\32\146\130\144","\149\32\149\149\32\149\149\32\149\149\32\149\149\32\149\149\32\149\149\32\149\131\147\129\138\134\149\149\32\149\149\32\149\149\32\149\149\32\149\154\143\149\32\157\129\154\143\149","\130\131\32\129\32\129\130\131\32\130\131\32\130\131\32\130\131\32\130\131\32\32\32\32\130\131\32\130\131\129\130\131\129\130\131\129\130\131\129\140\140\129\130\131\32\140\140\129"},{"000110000110110000110010101000000010000000100101","000000110110000000000010101000000010000000100101","000000000000000000000000000000000000000000000000","100010110100000010000110110000010100000100000110","000000110000000010110110000110000000000000110000","000000000000000000000000000000000000000000000000","000000110110000010000000100000100000000000000010","000000000110110100010000000010000000000000000100","000000000000000000000000000000000000000000000000","010000000000100110000000000000000000000110010000","000000000000000000000000000010000000010110000000","000000000000000000000000000000000000000000000000","011110110000000100100010110000000100000000000000","000000000000000000000000000000000000000000000000","000000000000000000000000000000000000000000000000","110000110110000000000000000000010100100010000000","000010000000000000110110000000000100010010000000","000000000000000000000000000000000000000000000000","010110010110100110110110010000000100000110110110","000000000000000000000110000000000110000000000000","000000000000000000000000000000000000000000000000","010100010110110000000000000000110000000010000000","110110000000000000110000110110100000000010000000","000000000000000000000000000000000000000000000000","000100011111000100011111000100011111000100011111","000000000000100100100100011011011011111111111111","000000000000000000000000000000000000000000000000","000100011111000100011111000100011111000100011111","000000000000100100100100011011011011111111111111","100100100100100100100100100100100100100100100100","000000110100110110000010000011110000000000011000","000000000100000000000010000011000110000000001000","000000000000000000000000000000000000000000000000","010000100100000000000000000100000000010010110000","000000000000000000000000000000110110110110110000","000000000000000000000000000000000000000000000000","110110110110110110000000110110110110110110110110","000000000000000000000110000000000000000000000000","000000000000000000000000000000000000000000000000","000000000000110110000110010000000000000000010010","000010000000000000000000000000000000000000000000","000000000000000000000000000000000000000000000000","110110110110110110110000110110110110000000000000","000000000000000000000110000000000000000000000000","000000000000000000000000000000000000000000000000","110110110110110110110000110000000000000000010000","000000000000000000000000100000000000000110000110","000000000000000000000000000000000000000000000000"}}local bb={}local cb={}
 do local dc=0;local _d=#ab[1]local ad=#ab[1][1]
@@ -1559,9 +1554,9 @@ db.defineProperty(db,"eventListenerCount",{default={},type="table"})
 db.defineProperty(db,"focusedChild",{default=nil,type="table",allowNil=true,setter=function(bc,cc,dc)local _d=bc._values.focusedChild
 if cc==_d then return cc end
 if _d then
-if _d:isType("Container")then _d.set("focusedChild",nil,true)end;_d.set("focused",false,true)end
-if cc and not dc then cc.set("focused",true,true)if bc.parent then
-bc.parent:setFocusedChild(bc)end end;return cc end})
+if _d:isType("Container")then _d.set("focusedChild",nil,true)end;_d:setFocused(false,true)end;if cc and not dc then cc:setFocused(true,true)if bc.parent then
+bc.parent:setFocusedChild(bc)end end;return
+cc end})
 db.defineProperty(db,"visibleChildren",{default={},type="table"})
 db.defineProperty(db,"visibleChildrenEvents",{default={},type="table"})
 db.defineProperty(db,"offsetX",{default=0,type="number",canTriggerRender=true,setter=function(bc,cc)bc.set("childrenSorted",false)
@@ -1668,8 +1663,9 @@ if ab.mouse_click(self,bc,cc,dc)then
 local _d=ac(self,"mouse_click",bc,cc,dc)
 local ad,bd=self:callChildrenEvent(true,"mouse_click",table.unpack(_d))
 if(ad)then self.set("focusedChild",bd)return true end;self.set("focusedChild",nil)return true end;return false end
-function db:mouse_up(bc,cc,dc)
-if ab.mouse_up(self,bc,cc,dc)then local _d=ac(self,"mouse_up",bc,cc,dc)
+function db:mouse_up(bc,cc,dc)self:mouse_release(bc,cc,dc)
+if ab.mouse_up(self,bc,cc,dc)then
+local _d=ac(self,"mouse_up",bc,cc,dc)
 local ad,bd=self:callChildrenEvent(true,"mouse_up",table.unpack(_d))if(ad)then return true end end;return false end
 function db:mouse_release(bc,cc,dc)ab.mouse_release(self,bc,cc,dc)
 local _d=ac(self,"mouse_release",bc,cc,dc)
@@ -1805,56 +1801,62 @@ self.get("width")-#a_a)
 local c_a=ca[cd]:rep(#b_a)or ca[colors.black]:rep(#b_a)
 local d_a=ca[dd]:rep(#b_a)or ca[colors.white]:rep(#b_a)self:blit(1,y,b_a,d_a,c_a)else
 self:blit(1,y,string.rep(" ",self.get("width")),ca[self.get("foreground")]:rep(self.get("width")),ca[self.get("background")]:rep(self.get("width")))end end end;return da end
-project["elements/DropDown.lua"] = function(...) local _a=require("elements/VisualElement")
-local aa=require("elements/List")local ba=require("libraries/colorHex")
-local ca=setmetatable({},aa)ca.__index=ca
-ca.defineProperty(ca,"isOpen",{default=false,type="boolean",canTriggerRender=true})
-ca.defineProperty(ca,"dropdownHeight",{default=5,type="number"})
-ca.defineProperty(ca,"selectedText",{default="",type="string"})
-ca.defineProperty(ca,"dropSymbol",{default="\31",type="string"})function ca.new()local da=setmetatable({},ca):__init()
-da.class=ca;da.set("width",16)da.set("height",1)da.set("z",8)
-return da end
-function ca:init(da,_b)
-aa.init(self,da,_b)self.set("type","DropDown")return self end
-function ca:mouse_click(da,_b,ab)
-if not _a.mouse_click(self,da,_b,ab)then return false end;local bb,cb=self:getRelativePosition(_b,ab)
-if cb==1 then self.set("isOpen",not
-self.get("isOpen"))if
-not self.get("isOpen")then self.set("height",1)else
-self.set("height",1 +math.min(self.get("dropdownHeight"),#
-self.get("items")))end
-return true elseif
-self.get("isOpen")and cb>1 and self.get("selectable")then local db=(cb-1)+self.get("offset")
-local _c=self.get("items")
-if db<=#_c then local ac=_c[db]
-if type(ac)=="string"then ac={text=ac}_c[db]=ac end
-if not self.get("multiSelection")then for bc,cc in ipairs(_c)do if type(cc)=="table"then
-cc.selected=false end end end;ac.selected=not ac.selected
-if ac.callback then ac.callback(self)end;self:fireEvent("select",db,ac)
-self.set("isOpen",false)self.set("height",1)self:updateRender()return true end end;return false end
-function ca:render()_a.render(self)local da=self.get("selectedText")
-local _b=self:getSelectedItems()if#_b>0 then local ab=_b[1]da=ab.text or""
-da=da:sub(1,self.get("width")-2)end
-self:blit(1,1,da..string.rep(" ",self.get("width")-#
-da-1).. (
-self.get("isOpen")and"\31"or"\17"),string.rep(ba[self.get("foreground")],self.get("width")),string.rep(ba[self.get("background")],self.get("width")))
-if self.get("isOpen")then local ab=self.get("items")
-local bb=self.get("height")-1;local cb=self.get("offset")local db=self.get("width")
-for i=1,bb do local _c=i+cb
-local ac=ab[_c]
-if ac then if type(ac)=="string"then ac={text=ac}ab[_c]=ac end
+project["elements/DropDown.lua"] = function(...) local aa=require("elements/VisualElement")
+local ba=require("elements/List")local ca=require("elements/ScrollBar")
+local da=require("libraries/colorHex")local _b=setmetatable({},ba)_b.__index=_b
+_b.defineProperty(_b,"dropdownHeight",{default=5,type="number"})
+_b.defineProperty(_b,"selectedText",{default="",type="string"})
+_b.defineProperty(_b,"dropSymbol",{default="\31",type="string"})function _b.new()local ab=setmetatable({},_b):__init()
+ab.class=_b;ab.set("width",16)ab.set("height",1)ab.set("z",8)
+return ab end;function _b:init(ab,bb)
+ba.init(self,ab,bb)self.set("type","DropDown")
+self:registerState("opened",nil,200)return self end
+function _b:mouse_click(ab,bb,cb)
 if
-ac.separator then local bc=(ac.text or"-"):sub(1,1)
-local cc=string.rep(bc,db)local dc=ac.foreground or self.get("foreground")local _d=
-ac.background or self.get("background")self:textBg(1,
-i+1,string.rep(" ",db),_d)
-self:textFg(1,i+1,cc,dc)else local bc=ac.text;local cc=ac.selected;bc=bc:sub(1,db)
-local dc=cc and(ac.selectedBackground or
-self.get("selectedBackground"))or(ac.background or
-self.get("background"))
-local _d=
-cc and(ac.selectedForeground or self.get("selectedForeground"))or(ac.foreground or self.get("foreground"))self:textBg(1,i+1,string.rep(" ",db),dc)self:textFg(1,
-i+1,bc,_d)end end end end end;return ca end
+not aa.mouse_click(self,ab,bb,cb)then return false end;local db,_c=self:getRelativePosition(bb,cb)
+local ac=self:hasState("opened")
+if _c==1 then
+if ac then self.set("height",1)self:unsetState("opened")else
+self.set("height",
+1 +
+math.min(self.get("dropdownHeight"),#self.get("items")))self:setState("opened")end;return true elseif ac and _c>1 and self.get("selectable")then local bc=(_c-1)+
+self.get("offset")local cc=self.get("items")
+if bc<=#cc then
+local dc=cc[bc]if type(dc)=="string"then dc={text=dc}cc[bc]=dc end
+if not
+self.get("multiSelection")then for _d,ad in ipairs(cc)do
+if type(ad)=="table"then ad.selected=false end end end;dc.selected=not dc.selected
+if dc.callback then dc.callback(self)end;self:fireEvent("select",bc,dc)
+self:unsetState("opened")self:unsetState("clicked")self.set("height",1)
+self:updateRender()return true end end;return false end
+function _b:render()aa.render(self)local ab=self.get("selectedText")
+local bb=self:hasState("opened")local cb=self:getSelectedItems()
+if#cb>0 then local db=cb[1]
+ab=db.text or""ab=ab:sub(1,self.get("width")-2)end
+self:blit(1,1,ab..
+string.rep(" ",self.get("width")-#ab-1).. (bb and"\31"or"\17"),string.rep(da[self.getResolved("foreground")],self.get("width")),string.rep(da[self.getResolved("background")],self.get("width")))
+if bb then local db=self.get("items")
+local _c=self.get("height")-1;local ac=self.get("offset")local bc=self.get("width")
+for i=1,_c do local cc=i+ac
+local dc=db[cc]
+if dc then if type(dc)=="string"then dc={text=dc}db[cc]=dc end
+if
+dc.separator then local _d=(dc.text or"-"):sub(1,1)
+local ad=string.rep(_d,bc)
+local bd=dc.fg or self.getResolved("foreground")
+local cd=dc.bg or self.getResolved("background")self:textBg(1,i+1,string.rep(" ",bc),cd)self:textFg(1,
+i+1,ad,bd)else local _d=dc.text;local ad=dc.selected
+_d=_d:sub(1,bc)
+local bd=ad and
+(dc.selectedBg or self.getResolved("selectedBackground"))or
+(dc.bg or self.getResolved("background"))
+local cd=ad and
+(dc.selectedFg or self.getResolved("selectedForeground"))or
+(dc.fg or self.getResolved("foreground"))self:textBg(1,i+1,string.rep(" ",bc),bd)self:textFg(1,
+i+1,_d,cd)end end end end end
+function _b:focus()aa.focus(self)self:setState("opened")end
+function _b:blur()aa.blur(self)self:unsetState("opened")
+self.set("height",1)self:updateRender()end;return _b end
 project["elements/Display.lua"] = function(...) local ba=require("elementManager")
 local ca=ba.getElement("VisualElement")
 local da=require("libraries/utils").getCenteredPosition;local _b=require("libraries/utils").deepcopy
@@ -2414,25 +2416,20 @@ _b.defineProperty(_b,"x",{default=1,type="number",canTriggerRender=true})
 _b.defineProperty(_b,"y",{default=1,type="number",canTriggerRender=true})
 _b.defineProperty(_b,"z",{default=1,type="number",canTriggerRender=true,setter=function(cb,db)
 if cb.parent then cb.parent:sortChildren()end;return db end})
+_b.defineProperty(_b,"constraints",{default={},type="table"})
 _b.defineProperty(_b,"width",{default=1,type="number",canTriggerRender=true})
 _b.defineProperty(_b,"height",{default=1,type="number",canTriggerRender=true})
 _b.defineProperty(_b,"background",{default=colors.black,type="color",canTriggerRender=true})
 _b.defineProperty(_b,"foreground",{default=colors.white,type="color",canTriggerRender=true})
-_b.defineProperty(_b,"clicked",{default=false,type="boolean"})
-_b.defineProperty(_b,"hover",{default=false,type="boolean"})
 _b.defineProperty(_b,"backgroundEnabled",{default=true,type="boolean",canTriggerRender=true})
 _b.defineProperty(_b,"borderTop",{default=false,type="boolean",canTriggerRender=true})
 _b.defineProperty(_b,"borderBottom",{default=false,type="boolean",canTriggerRender=true})
 _b.defineProperty(_b,"borderLeft",{default=false,type="boolean",canTriggerRender=true})
 _b.defineProperty(_b,"borderRight",{default=false,type="boolean",canTriggerRender=true})
 _b.defineProperty(_b,"borderColor",{default=colors.white,type="color",canTriggerRender=true})
-_b.defineProperty(_b,"focused",{default=false,type="boolean",setter=function(cb,db,_c)local ac=cb.get("focused")
-if db==ac then return db end;if db then cb:focus()else cb:blur()end;if not _c and cb.parent then
-if db then
-cb.parent:setFocusedChild(cb)else cb.parent:setFocusedChild(nil)end end;return db end})
 _b.defineProperty(_b,"visible",{default=true,type="boolean",canTriggerRender=true,setter=function(cb,db)
 if(cb.parent~=nil)then
-cb.parent.set("childrenSorted",false)cb.parent.set("childrenEventsSorted",false)end;if(db==false)then cb.set("clicked",false)end;return db end})
+cb.parent.set("childrenSorted",false)cb.parent.set("childrenEventsSorted",false)end;if(db==false)then cb:unsetState("clicked")end;return db end})
 _b.defineProperty(_b,"ignoreOffset",{default=false,type="boolean"})_b.combineProperties(_b,"position","x","y")
 _b.combineProperties(_b,"size","width","height")
 _b.combineProperties(_b,"color","foreground","background")_b.defineEvent(_b,"focus")
@@ -2449,6 +2446,9 @@ local ab,bb=math.max,math.min;function _b.new()local cb=setmetatable({},_b):__in
 cb.class=_b;return cb end
 function _b:init(cb,db)
 ca.init(self,cb,db)self.set("type","VisualElement")
+self:registerState("disabled",nil,1000)self:registerState("clicked",nil,500)
+self:registerState("hover",nil,400)self:registerState("focused",nil,300)
+self:registerState("dragging",nil,600)
 self:observe("x",function()if self.parent then
 self.parent.set("childrenSorted",false)end end)
 self:observe("y",function()if self.parent then
@@ -2459,6 +2459,102 @@ self:observe("height",function()if self.parent then
 self.parent.set("childrenSorted",false)end end)
 self:observe("visible",function()if self.parent then
 self.parent.set("childrenSorted",false)end end)end
+function _b:setConstraint(cb,db,_c,ac)local bc=self.get("constraints")if bc[cb]then
+self:_removeConstraintObservers(cb,bc[cb])end
+bc[cb]={element=db,property=_c,offset=ac or 0}self.set("constraints",bc)
+self:_addConstraintObservers(cb,bc[cb])self._constraintsDirty=true;self:updateRender()return self end
+function _b:resolveAllConstraints()if not self._constraintsDirty then return self end
+local cb=self.get("constraints")if not cb or not next(cb)then return self end
+local db={"width","height","left","right","top","bottom","x","y","centerX","centerY"}
+for _c,ac in ipairs(db)do if cb[ac]then local bc=self:_resolveConstraint(ac,cb[ac])
+self:_applyConstraintValue(ac,bc)end end;self._constraintsDirty=false;return self end
+function _b:_applyConstraintValue(cb,db)
+if cb=="x"or cb=="left"then self.set("x",db)elseif cb=="y"or
+cb=="top"then self.set("y",db)elseif cb=="right"then local _c=self.get("width")self.set("x",
+db-_c+1)elseif cb=="bottom"then local _c=self.get("height")self.set("y",
+db-_c+1)elseif cb=="centerX"then local _c=self.get("width")self.set("x",
+db-math.floor(_c/2))elseif cb=="centerY"then
+local _c=self.get("height")self.set("y",db-math.floor(_c/2))elseif
+cb=="width"then self.set("width",db)elseif cb=="height"then self.set("height",db)end end
+function _b:_addConstraintObservers(cb,db)local _c=db.element;local ac=db.property
+if _c=="parent"then _c=self.parent end;if not _c then return end
+local bc=function()self._constraintsDirty=true
+self:resolveAllConstraints()self:updateRender()end
+if not self._constraintObserverCallbacks then self._constraintObserverCallbacks={}end;if not self._constraintObserverCallbacks[cb]then
+self._constraintObserverCallbacks[cb]={}end;local cc={}
+if
+ac=="left"or ac=="x"then cc={"x"}elseif ac=="right"then cc={"x","width"}elseif ac=="top"or ac=="y"then cc={"y"}elseif ac==
+"bottom"then cc={"y","height"}elseif ac=="centerX"then cc={"x","width"}elseif ac=="centerY"then
+cc={"y","height"}elseif ac=="width"then cc={"width"}elseif ac=="height"then cc={"height"}end;for dc,_d in ipairs(cc)do _c:observe(_d,bc)
+table.insert(self._constraintObserverCallbacks[cb],{element=_c,property=_d,callback=bc})end end
+function _b:_removeConstraintObservers(cb,db)
+if not self._constraintObserverCallbacks or not
+self._constraintObserverCallbacks[cb]then return end;for _c,ac in ipairs(self._constraintObserverCallbacks[cb])do
+ac.element:removeObserver(ac.property,ac.callback)end;self._constraintObserverCallbacks[cb]=
+nil end
+function _b:_removeAllConstraintObservers()
+if not self._constraintObserverCallbacks then return end
+for cb,db in pairs(self._constraintObserverCallbacks)do for _c,ac in ipairs(db)do
+ac.element:removeObserver(ac.property,ac.callback)end end;self._constraintObserverCallbacks=nil end
+function _b:removeConstraint(cb)local db=self.get("constraints")db[cb]=nil
+self.set("constraints",db)self:updateConstraints()return self end
+function _b:updateConstraints()local cb=self.get("constraints")
+for db,_c in pairs(cb)do
+local ac=self:_resolveConstraint(db,_c)
+if db=="x"or db=="left"then self.set("x",ac)elseif db=="y"or db=="top"then
+self.set("y",ac)elseif db=="right"then local bc=self.get("width")
+self.set("x",ac-bc+1)elseif db=="bottom"then local bc=self.get("height")
+self.set("y",ac-bc+1)elseif db=="centerX"then local bc=self.get("width")
+self.set("x",ac-math.floor(bc/2))elseif db=="centerY"then local bc=self.get("height")
+self.set("y",ac-math.floor(bc/2))elseif db=="width"then self.set("width",ac)elseif db=="height"then
+self.set("height",ac)end end end
+function _b:_resolveConstraint(cb,db)local _c=db.element;local ac=db.property;local bc=db.offset;if _c=="parent"then
+_c=self.parent end
+if not _c then return self.get(cb)or 1 end;local cc
+if ac=="left"or ac=="x"then cc=_c.get("x")elseif ac=="right"then cc=_c.get("x")+
+_c.get("width")-1 elseif ac=="top"or ac=="y"then
+cc=_c.get("y")elseif ac=="bottom"then
+cc=_c.get("y")+_c.get("height")-1 elseif ac=="centerX"then
+cc=_c.get("x")+math.floor(_c.get("width")/2)elseif ac=="centerY"then
+cc=_c.get("y")+math.floor(_c.get("height")/2)elseif ac=="width"then cc=_c.get("width")elseif ac=="height"then cc=_c.get("height")end
+if type(bc)=="number"then if bc>-1 and bc<1 and bc~=0 then
+return math.floor(cc*bc)else return cc+bc end end;return cc end;function _b:alignRight(cb,db)db=db or 0
+return self:setConstraint("right",cb,"right",db)end;function _b:alignLeft(cb,db)db=db or 0;return
+self:setConstraint("left",cb,"left",db)end
+function _b:alignTop(cb,db)db=
+db or 0;return self:setConstraint("top",cb,"top",db)end;function _b:alignBottom(cb,db)db=db or 0
+return self:setConstraint("bottom",cb,"bottom",db)end
+function _b:centerHorizontal(cb,db)db=db or 0;return
+self:setConstraint("centerX",cb,"centerX",db)end;function _b:centerVertical(cb,db)db=db or 0
+return self:setConstraint("centerY",cb,"centerY",db)end;function _b:centerIn(cb)return
+self:centerHorizontal(cb):centerVertical(cb)end
+function _b:rightOf(cb,db)
+db=db or 0;return self:setConstraint("left",cb,"right",db)end;function _b:leftOf(cb,db)db=db or 0
+return self:setConstraint("right",cb,"left",-db)end;function _b:below(cb,db)db=db or 0;return
+self:setConstraint("top",cb,"bottom",db)end
+function _b:above(cb,db)
+db=db or 0;return self:setConstraint("bottom",cb,"top",-db)end;function _b:stretchWidth(cb,db)db=db or 0
+return self:setConstraint("left",cb,"left",db):setConstraint("right",cb,"right",
+-db)end;function _b:stretchHeight(cb,db)db=
+db or 0
+return self:setConstraint("top",cb,"top",db):setConstraint("bottom",cb,"bottom",
+-db)end;function _b:stretch(cb,db)return
+self:stretchWidth(cb,db):stretchHeight(cb,db)end
+function _b:widthPercent(cb,db)return self:setConstraint("width",cb,"width",
+db/100)end;function _b:heightPercent(cb,db)
+return self:setConstraint("height",cb,"height",db/100)end;function _b:matchWidth(cb,db)db=db or 0;return
+self:setConstraint("width",cb,"width",db)end;function _b:matchHeight(cb,db)db=
+db or 0
+return self:setConstraint("height",cb,"height",db)end;function _b:fillParent(cb)return
+self:stretch("parent",cb)end;function _b:fillWidth(cb)return
+self:stretchWidth("parent",cb)end;function _b:fillHeight(cb)return
+self:stretchHeight("parent",cb)end;function _b:center()return
+self:centerIn("parent")end;function _b:toRight(cb)return
+self:alignRight("parent",- (cb or 0))end;function _b:toLeft(cb)return self:alignLeft("parent",
+cb or 0)end;function _b:toTop(cb)return self:alignTop("parent",
+cb or 0)end
+function _b:toBottom(cb)return self:alignBottom("parent",
+- (cb or 0))end
 function _b:multiBlit(cb,db,_c,ac,bc,cc,dc)local _d,ad=self:calculatePosition()cb=cb+_d-1
 db=db+ad-1;self.parent:multiBlit(cb,db,_c,ac,bc,cc,dc)end
 function _b:textFg(cb,db,_c,ac)local bc,cc=self:calculatePosition()cb=cb+bc-1
@@ -2479,14 +2575,16 @@ if(self.parent)then
 cb=cb-self.parent.get("offsetX")db=db-self.parent.get("offsetY")end end;return
 cb>=_c and cb<=
 _c+bc-1 and db>=ac and db<=ac+cc-1 end
-function _b:mouse_click(cb,db,_c)if self:isInBounds(db,_c)then self.set("clicked",true)
+function _b:mouse_click(cb,db,_c)if self:isInBounds(db,_c)then self:setState("clicked")
 self:fireEvent("mouse_click",cb,self:getRelativePosition(db,_c))return true end;return
 false end
-function _b:mouse_up(cb,db,_c)if self:isInBounds(db,_c)then self.set("clicked",false)
-self:fireEvent("mouse_up",cb,self:getRelativePosition(db,_c))return true end;return
-false end
+function _b:mouse_up(cb,db,_c)
+if self:isInBounds(db,_c)then self:unsetState("clicked")
+self:unsetState("dragging")
+self:fireEvent("mouse_up",cb,self:getRelativePosition(db,_c))return true end;return false end
 function _b:mouse_release(cb,db,_c)
-self:fireEvent("mouse_release",cb,self:getRelativePosition(db,_c))self.set("clicked",false)end
+self:fireEvent("mouse_release",cb,self:getRelativePosition(db,_c))self:unsetState("clicked")
+self:unsetState("dragging")end
 function _b:mouse_move(cb,db,_c)if(db==nil)or(_c==nil)then return false end
 local ac=self.get("hover")
 if(self:isInBounds(db,_c))then if(not ac)then self.set("hover",true)
@@ -2495,15 +2593,24 @@ self.set("hover",false)
 self:fireEvent("mouse_leave",self:getRelativePosition(db,_c))end end;return false end
 function _b:mouse_scroll(cb,db,_c)if(self:isInBounds(db,_c))then
 self:fireEvent("mouse_scroll",cb,self:getRelativePosition(db,_c))return true end;return false end
-function _b:mouse_drag(cb,db,_c)if(self.get("clicked"))then
-self:fireEvent("mouse_drag",cb,self:getRelativePosition(db,_c))return true end;return false end;function _b:focus()self:fireEvent("focus")end;function _b:blur()
+function _b:mouse_drag(cb,db,_c)if(self:hasState("clicked"))then
+self:fireEvent("mouse_drag",cb,self:getRelativePosition(db,_c))return true end;return false end
+function _b:setFocused(cb,db)local _c=self:hasState("focused")
+if cb==_c then return self end
+if cb then self:setState("focused")self:focus()
+if
+not db and self.parent then self.parent:setFocusedChild(self)end else self:unsetState("focused")self:blur()
+if
+not db and self.parent then self.parent:setFocusedChild(nil)end end;return self end
+function _b:isFocused()return self:hasState("focused")end;function _b:focus()self:fireEvent("focus")end;function _b:blur()
 self:fireEvent("blur")
 pcall(function()
-self:setCursor(1,1,false,self.get and self.get("foreground"))end)end
-function _b:addBorder(cb,db)
-local _c=nil;local ac=nil
-if type(cb)=="table"and
-(cb.color or cb.top~=nil or cb.left~=nil)then _c=cb.color;ac=cb else _c=cb;ac=db end
+self:setCursor(1,1,false,self.get and self.getResolved("foreground"))end)end;function _b:isFocused()return
+self:hasState("focused")end
+function _b:addBorder(cb,db)local _c=nil;local ac=nil
+if
+type(cb)==
+"table"and(cb.color or cb.top~=nil or cb.left~=nil)then _c=cb.color;ac=cb else _c=cb;ac=db end
 if ac then
 if ac.top~=nil then self.set("borderTop",ac.top)end
 if ac.bottom~=nil then self.set("borderBottom",ac.bottom)end
@@ -2514,13 +2621,14 @@ self.set("borderRight",true)end;if _c then self.set("borderColor",_c)end;return
 function _b:removeBorder()self.set("borderTop",false)
 self.set("borderBottom",false)self.set("borderLeft",false)
 self.set("borderRight",false)return self end;function _b:key(cb,db)
-if(self.get("focused"))then self:fireEvent("key",cb,db)end end;function _b:key_up(cb)if(self.get("focused"))then
-self:fireEvent("key_up",cb)end end
-function _b:char(cb)if
-(self.get("focused"))then self:fireEvent("char",cb)end end
-function _b:calculatePosition()local cb,db=self.get("x"),self.get("y")
-if not
-self.get("ignoreOffset")then if self.parent~=nil then
+if(self:hasState("focused"))then self:fireEvent("key",cb,db)end end
+function _b:key_up(cb)if
+(self:hasState("focused"))then self:fireEvent("key_up",cb)end end;function _b:char(cb)
+if(self:hasState("focused"))then self:fireEvent("char",cb)end end
+function _b:calculatePosition()
+self:resolveAllConstraints()local cb,db=self.get("x"),self.get("y")
+if
+not self.get("ignoreOffset")then if self.parent~=nil then
 local _c,ac=self.parent.get("offsetX"),self.parent.get("offsetY")cb=cb-_c;db=db-ac end end;return cb,db end
 function _b:getAbsolutePosition(cb,db)local _c,ac=self.get("x"),self.get("y")if(cb~=nil)then
 _c=_c+cb-1 end;if(db~=nil)then ac=ac+db-1 end;local bc=self.parent
@@ -2542,24 +2650,21 @@ function _b:prioritize()
 if(self.parent)then local cb=self.parent;cb:removeChild(self)
 cb:addChild(self)self:updateRender()end;return self end
 function _b:render()
-if(not self.get("backgroundEnabled"))then return end;local cb,db=self.get("width"),self.get("height")
-local _c=da[self.get("foreground")]local ac=da[self.get("background")]
-self:multiBlit(1,1,cb,db," ",_c,ac)
+if(not self.getResolved("backgroundEnabled"))then return end;local cb,db=self.get("width"),self.get("height")
+local _c=da[self.getResolved("foreground")]local ac=da[self.getResolved("background")]
+local bc,cc,dc,_d=self.getResolved("borderTop"),self.getResolved("borderBottom"),self.getResolved("borderLeft"),self.getResolved("borderRight")self:multiBlit(1,1,cb,db," ",_c,ac)
 if
-(self.get("borderTop")or self.get("borderBottom")or
-self.get("borderLeft")or self.get("borderRight"))then
-local bc=self.get("borderColor")or self.get("foreground")local cc=da[bc]or _c;if self.get("borderTop")then
-self:textFg(1,1,("\131"):rep(cb),bc)end;if self.get("borderBottom")then
-self:multiBlit(1,db,cb,1,"\143",ac,cc)end;if self.get("borderLeft")then
-self:multiBlit(1,1,1,db,"\149",cc,ac)end;if self.get("borderRight")then
-self:multiBlit(cb,1,1,db,"\149",ac,cc)end
-if self.get("borderTop")and
-self.get("borderLeft")then self:blit(1,1,"\151",cc,ac)end;if self.get("borderTop")and self.get("borderRight")then
-self:blit(cb,1,"\148",ac,cc)end
-if self.get("borderBottom")and
-self.get("borderLeft")then self:blit(1,db,"\138",ac,cc)end;if self.get("borderBottom")and self.get("borderRight")then
-self:blit(cb,db,"\133",ac,cc)end end end;function _b:postRender()end;function _b:destroy()self.set("visible",false)
-ca.destroy(self)end;return _b end
+(bc or cc or dc or _d)then
+local ad=self.getResolved("borderColor")or self.getResolved("foreground")local bd=da[ad]or _c;if bc then
+self:textFg(1,1,("\131"):rep(cb),ad)end;if cc then
+self:multiBlit(1,db,cb,1,"\143",ac,bd)end;if dc then
+self:multiBlit(1,1,1,db,"\149",bd,ac)end;if _d then
+self:multiBlit(cb,1,1,db,"\149",ac,bd)end
+if bc and dc then self:blit(1,1,"\151",bd,ac)end;if bc and _d then self:blit(cb,1,"\148",ac,bd)end;if
+cc and dc then self:blit(1,db,"\138",ac,bd)end;if cc and _d then
+self:blit(cb,db,"\133",ac,bd)end end end;function _b:postRender()end
+function _b:destroy()
+self:_removeAllConstraintObservers()self.set("visible",false)ca.destroy(self)end;return _b end
 project["elements/ProgressBar.lua"] = function(...) local d=require("elements/VisualElement")
 local _a=require("libraries/colorHex")local aa=setmetatable({},d)aa.__index=aa
 aa.defineProperty(aa,"progress",{default=0,type="number",canTriggerRender=true})
@@ -2597,9 +2702,10 @@ function d:init(_a,aa)
 c.init(self,_a,aa)self.set("type","CheckBox")end
 function d:mouse_click(_a,aa,ba)if c.mouse_click(self,_a,aa,ba)then
 self.set("checked",not self.get("checked"))return true end;return false end
-function d:render()c.render(self)local _a=self.get("checked")
-local aa=self.get("text")local ba=self.get("checkedText")
-local ca=string.sub(_a and ba or aa,1,self.get("width"))self:textFg(1,1,ca,self.get("foreground"))end;return d end
+function d:render()c.render(self)local _a=self.getResolved("checked")
+local aa=self.getResolved("text")local ba=self.getResolved("checkedText")
+local ca=string.sub(_a and ba or aa,1,self.get("width"))
+self:textFg(1,1,ca,self.getResolved("foreground"))end;return d end
 project["elements/BaseElement.lua"] = function(...) local _a=require("propertySystem")
 local aa=require("libraries/utils").uuid;local ba=require("errorManager")local ca=setmetatable({},_a)
 ca.__index=ca
@@ -2611,6 +2717,7 @@ ca.defineProperty(ca,"id",{default="",type="string",readonly=true})
 ca.defineProperty(ca,"name",{default="",type="string"})
 ca.defineProperty(ca,"eventCallbacks",{default={},type="table"})
 ca.defineProperty(ca,"enabled",{default=true,type="boolean"})
+ca.defineProperty(ca,"states",{default={},type="table",canTriggerRender=true})
 function ca.defineEvent(da,_b,ab)
 if not rawget(da,'_eventConfigs')then da._eventConfigs={}end;da._eventConfigs[_b]={requires=ab and ab or _b}end
 function ca.registerEventCallback(da,_b,...)
@@ -2621,8 +2728,8 @@ db:listenEvent(ac,true)end end;db:registerCallback(cb,...)return db end end;func
 da.class=ca;return da end
 function ca:init(da,_b)
 if self._initialized then return self end;self._initialized=true;self._props=da;self._values.id=aa()
-self.basalt=_b;self._registeredEvents={}local ab=getmetatable(self).__index
-local bb={}ab=self.class
+self.basalt=_b;self._registeredEvents={}self._registeredStates={}
+local ab=getmetatable(self).__index;local bb={}ab=self.class
 while ab do
 if type(ab)=="table"and ab._eventConfigs then for cb,db in
 pairs(ab._eventConfigs)do if not bb[cb]then bb[cb]=db end end end
@@ -2647,10 +2754,30 @@ function ca:registerCallback(da,_b)if not self._registeredEvents[da]then
 self:listenEvent(da,true)end
 if
 not self._values.eventCallbacks[da]then self._values.eventCallbacks[da]={}end
-table.insert(self._values.eventCallbacks[da],_b)return self end
+table.insert(self._values.eventCallbacks[da],_b)return self end;function ca:registerState(da,_b,ab)
+self._registeredStates[da]={condition=_b,priority=ab or 0}return self end
+function ca:setState(da,_b)
+local ab=self.get("states")if not _b and self._registeredStates[da]then
+_b=self._registeredStates[da].priority end;ab[da]=_b or 0
+self.set("states",ab)return self end
+function ca:unsetState(da)local _b=self.get("states")if _b[da]~=nil then _b[da]=nil
+self.set("states",_b)end;return self end
+function ca:hasState(da)local _b=self.get("states")return _b[da]~=nil end
+function ca:getCurrentState()local da=self.get("states")local _b=-math.huge;local ab=nil;for bb,cb in
+pairs(da)do if cb>_b then _b=cb;ab=bb end end;return ab end
+function ca:getActiveStates()local da=self.get("states")local _b={}for ab,bb in pairs(da)do
+table.insert(_b,{name=ab,priority=bb})end
+table.sort(_b,function(ab,bb)
+return ab.priority>bb.priority end)return _b end
+function ca:updateConditionalStates()
+for da,_b in pairs(self._registeredStates)do
+if _b.condition then if _b.condition(self)then
+self:setState(da,_b.priority)else self:unsetState(da)end end end;return self end;function ca:unregisterState(da)self._stateRegistry[da]=nil
+self:unsetState(da)return self end
 function ca:fireEvent(da,...)
-if self.get("eventCallbacks")[da]then for _b,ab in
-ipairs(self.get("eventCallbacks")[da])do local bb=ab(self,...)return bb end end;return self end
+if
+self.get("eventCallbacks")[da]then for _b,ab in ipairs(self.get("eventCallbacks")[da])do
+local bb=ab(self,...)return bb end end;return self end
 function ca:dispatchEvent(da,...)
 if self.get("enabled")==false then return false end;if self[da]then return self[da](self,...)end;return
 self:handleEvent(da,...)end;function ca:handleEvent(da,...)return false end;function ca:onChange(da,_b)
@@ -2661,63 +2788,89 @@ if(self.parent)then self.parent:removeChild(self)end;self._destroyed=true;self:r
 self:setFocused(false)end;function ca:updateRender()
 if
 (self.parent)then self.parent:updateRender()else self._renderUpdate=true end;return self end;return ca end
-project["elements/List.lua"] = function(...) local c=require("elements/VisualElement")
-local d=setmetatable({},c)d.__index=d
-d.defineProperty(d,"items",{default={},type="table",canTriggerRender=true})
-d.defineProperty(d,"selectable",{default=true,type="boolean"})
-d.defineProperty(d,"multiSelection",{default=false,type="boolean"})
-d.defineProperty(d,"offset",{default=0,type="number",canTriggerRender=true})
-d.defineProperty(d,"selectedBackground",{default=colors.blue,type="color"})
-d.defineProperty(d,"selectedForeground",{default=colors.white,type="color"})d.defineEvent(d,"mouse_click")
-d.defineEvent(d,"mouse_scroll")
-function d.new()local _a=setmetatable({},d):__init()_a.class=d
-_a.set("width",16)_a.set("height",8)_a.set("z",5)
-_a.set("background",colors.gray)return _a end
-function d:init(_a,aa)c.init(self,_a,aa)self.set("type","List")return self end;function d:addItem(_a)local aa=self.get("items")table.insert(aa,_a)
+project["elements/List.lua"] = function(...) local d=require("elements/Collection")
+local _a=setmetatable({},d)_a.__index=_a
+_a.defineProperty(_a,"offset",{default=0,type="number",canTriggerRender=true})_a.defineEvent(_a,"mouse_click")
+_a.defineEvent(_a,"mouse_up")_a.defineEvent(_a,"mouse_scroll")
+local aa={text={type="string",default="Entry"},bg={type="number",default=
+nil},fg={type="number",default=nil},selectedBg={type="number",default=nil},selectedFg={type="number",default=nil},callback={type="function",default=
+nil}}
+function _a.new()local ba=setmetatable({},_a):__init()
+ba.class=_a;ba.set("width",16)ba.set("height",8)ba.set("z",5)
+ba.set("background",colors.gray)return ba end;function _a:init(ba,ca)d.init(self,ba,ca)self._entrySchema=aa
+self.set("type","List")return self end
+function _a:mouse_click(ba,ca,da)
+if
+d.mouse_click(self,ba,ca,da)and self.get("selectable")then
+local _b,ab=self:getRelativePosition(ca,da)local bb=ab+self.get("offset")
+local cb=self.get("items")
+if bb<=#cb then local db=cb[bb]if not self.get("multiSelection")then
+for _c,ac in ipairs(cb)do if
+type(ac)=="table"then ac.selected=false end end end
+db.selected=not db.selected;if db.callback then db.callback(self)end
+self:fireEvent("select",bb,db)self:updateRender()end;return true end;return false end
+function _a:mouse_scroll(ba,ca,da)
+if d.mouse_scroll(self,ba,ca,da)then local _b=self.get("offset")
+local ab=math.max(0,#
+self.get("items")-self.get("height"))_b=math.min(ab,math.max(0,_b+ba))
+self.set("offset",_b)return true end;return false end
+function _a:onSelect(ba)self:registerCallback("select",ba)return self end
+function _a:scrollToBottom()
+local ba=math.max(0,#self.get("items")-self.get("height"))self.set("offset",ba)return self end
+function _a:scrollToTop()self.set("offset",0)return self end
+function _a:render()d.render(self)local ba=self.get("items")
+local ca=self.get("height")local da=self.get("offset")local _b=self.get("width")
+local ab=self.getResolved("background")local bb=self.getResolved("foreground")
+for i=1,ca do local cb=i+da;local db=ba[cb]
+if
+db then
+if db.separator then local _c=(db.text or"-"):sub(1,1)
+local ac=string.rep(_c,_b)local bc=db.fg or bb;local cc=db.bg or ab
+self:textBg(1,i,string.rep(" ",_b),cc)self:textFg(1,i,ac:sub(1,_b),bc)else local _c=db.text
+local ac=db.selected
+local bc=ac and
+(db.selectedBg or self.getResolved("selectedBackground"))or(db.bg or ab)
+local cc=ac and
+(db.selectedFg or self.getResolved("selectedForeground"))or(db.fg or bb)self:textBg(1,i,string.rep(" ",_b),bc)
+self:textFg(1,i,_c:sub(1,_b),cc)end end end end;return _a end
+project["elements/Collection.lua"] = function(...) local d=require("elements/VisualElement")
+local _a=require("libraries/collectionentry")local aa=setmetatable({},d)aa.__index=aa
+aa.defineProperty(aa,"items",{default={},type="table"})
+aa.defineProperty(aa,"selectable",{default=true,type="boolean"})
+aa.defineProperty(aa,"multiSelection",{default=false,type="boolean"})
+aa.defineProperty(aa,"selectedBackground",{default=colors.blue,type="color"})
+aa.defineProperty(aa,"selectedForeground",{default=colors.white,type="color"})function aa.new()local ba=setmetatable({},aa):__init()
+ba.class=aa;return ba end
+function aa:init(ba,ca)
+d.init(self,ba,ca)self._entrySchema={}self.set("type","Collection")return self end
+function aa:addItem(ba)if type(ba)=="string"then ba={text=ba}end;if ba.selected==nil then
+ba.selected=false end
+local ca=_a.new(self,ba,self._entrySchema)table.insert(self.get("items"),ca)
+self:updateRender()return ca end
+function aa:removeItem(ba)local ca=self.get("items")if type(ba)=="number"then
+table.remove(ca,ba)else
+for da,_b in pairs(ca)do if _b==ba then table.remove(ca,da)break end end end
 self:updateRender()return self end
-function d:removeItem(_a)
-local aa=self.get("items")table.remove(aa,_a)self:updateRender()return self end
-function d:clear()self.set("items",{})self:updateRender()return self end
-function d:getSelectedItems()local _a={}for aa,ba in ipairs(self.get("items"))do
-if
-type(ba)=="table"and ba.selected then local ca=ba;ca.index=aa;table.insert(_a,ca)end end;return _a end
-function d:getSelectedItem()local _a=self.get("items")for aa,ba in ipairs(_a)do if
-type(ba)=="table"and ba.selected then return ba end end;return
-nil end
-function d:mouse_click(_a,aa,ba)
-if
-self:isInBounds(aa,ba)and self.get("selectable")then local ca,da=self:getRelativePosition(aa,ba)
-local _b=da+self.get("offset")local ab=self.get("items")
-if _b<=#ab then local bb=ab[_b]if type(bb)=="string"then
-bb={text=bb}ab[_b]=bb end;if
-not self.get("multiSelection")then
-for cb,db in ipairs(ab)do if type(db)=="table"then db.selected=false end end end
-bb.selected=not bb.selected;if bb.callback then bb.callback(self)end
-self:fireEvent("mouse_click",_a,aa,ba)self:fireEvent("select",_b,bb)self:updateRender()end;return true end;return false end
-function d:mouse_scroll(_a,aa,ba)
-if self:isInBounds(aa,ba)then local ca=self.get("offset")
-local da=math.max(0,#
-self.get("items")-self.get("height"))ca=math.min(da,math.max(0,ca+_a))
-self.set("offset",ca)self:fireEvent("mouse_scroll",_a,aa,ba)return true end;return false end
-function d:onSelect(_a)self:registerCallback("select",_a)return self end
-function d:scrollToBottom()
-local _a=math.max(0,#self.get("items")-self.get("height"))self.set("offset",_a)return self end;function d:scrollToTop()self.set("offset",0)return self end
-function d:render()
-c.render(self)local _a=self.get("items")local aa=self.get("height")
-local ba=self.get("offset")local ca=self.get("width")
-for i=1,aa do local da=i+ba;local _b=_a[da]
-if _b then if
-type(_b)=="string"then _b={text=_b}_a[da]=_b end
-if _b.separator then
-local ab=(_b.text or"-"):sub(1,1)local bb=string.rep(ab,ca)
-local cb=_b.foreground or self.get("foreground")local db=_b.background or self.get("background")
-self:textBg(1,i,string.rep(" ",ca),db)self:textFg(1,i,bb:sub(1,ca),cb)else local ab=_b.text
-local bb=_b.selected
-local cb=
-bb and(_b.selectedBackground or self.get("selectedBackground"))or(_b.background or self.get("background"))
-local db=
-bb and(_b.selectedForeground or self.get("selectedForeground"))or(_b.foreground or self.get("foreground"))self:textBg(1,i,string.rep(" ",ca),cb)
-self:textFg(1,i,ab:sub(1,ca),db)end end end end;return d end
+function aa:clear()self.set("items",{})self:updateRender()return self end
+function aa:getSelectedItems()local ba={}for ca,da in ipairs(self.get("items"))do
+if type(da)=="table"and
+da.selected then local _b=da;_b.index=ca;table.insert(ba,_b)end end;return ba end
+function aa:getSelectedItem()local ba=self.get("items")
+for ca,da in ipairs(ba)do if type(da)=="table"and
+da.selected then return da end end;return nil end
+function aa:selectItem(ba)local ca=self.get("items")
+if type(ba)=="number"then
+if ca[ba]and
+type(ca[ba])=="table"then ca[ba].selected=true end else for da,_b in pairs(ca)do
+if _b==ba then if type(_b)=="table"then _b.selected=true end;break end end end;self:updateRender()return self end
+function aa:unselectItem(ba)local ca=self.get("items")
+if type(ba)=="number"then
+if ca[ba]and
+type(ca[ba])=="table"then ca[ba].selected=false end else
+for da,_b in pairs(ca)do if _b==ba then
+if type(ca[da])=="table"then ca[da].selected=false end;break end end end;self:updateRender()return self end;function aa:clearItemSelection()local ba=self.get("items")
+for ca,da in ipairs(ba)do da.selected=false end;return self end;function aa:onSelect(ba)
+self:registerCallback("select",ba)return self end;return aa end
 project["plugins/canvas.lua"] = function(...) local ba=require("libraries/colorHex")
 local ca=require("errorManager")local da={}da.__index=da;local _b,ab=string.sub,string.rep
 function da.new(cb)
@@ -2806,7 +2959,7 @@ function bb.hooks.postRender(cb)
 local db=cb.get("canvas")if db and#db.commands.post>0 then for _c,ac in pairs(db.commands.post)do
 ac(cb)end end end;return{VisualElement=bb,API=da} end
 project["plugins/theme.lua"] = function(...) local ab=require("errorManager")
-local bb={default={background=colors.lightGray,foreground=colors.black},BaseFrame={background=colors.white,foreground=colors.black,Frame={background=colors.black,names={basaltDebugLogClose={background=colors.blue,foreground=colors.white}}},Button={background="{self.clicked and colors.black or colors.cyan}",foreground="{self.clicked and colors.cyan or colors.black}"},names={basaltDebugLog={background=colors.red,foreground=colors.white},test={background="{self.clicked and colors.black or colors.green}",foreground="{self.clicked and colors.green or colors.black}"}}}}local cb={default=bb}local db="default"
+local bb={default={background=colors.lightGray,foreground=colors.black},BaseFrame={background=colors.white,foreground=colors.black,Frame={background=colors.black,names={basaltDebugLogClose={background=colors.blue,foreground=colors.white}}},Button={background=colors.cyan,foreground=colors.black},names={basaltDebugLog={background=colors.red,foreground=colors.white}}}}local cb={default=bb}local db="default"
 local _c={hooks={postInit={pre=function(ad)if ad._postInitialized then return ad end
 ad:applyTheme()end}}}
 function _c.____getElementPath(ad,bd)if bd then table.insert(bd,1,ad._values.type)else
@@ -2929,55 +3082,6 @@ bd.hooks={destroy=function(cd)
 if _d[cd]then
 for dd,__a in pairs(_d[cd])do for a_a,b_a in ipairs(__a)do
 b_a.target:removeObserver(b_a.property,b_a.callback)end end;_d[cd]=nil;dc[cd]=nil end end}return{BaseElement=bd} end
-project["plugins/state.lua"] = function(...) local _a=require("propertySystem")
-local aa=require("errorManager")local ba={}function ba.setup(da)
-da.defineProperty(da,"states",{default={},type="table"})
-da.defineProperty(da,"stateObserver",{default={},type="table"})end
-function ba:initializeState(da,_b,ab,bb)
-local cb=self.get("states")if cb[da]then
-aa.error("State '"..da.."' already exists")return self end;local db=bb or"states/"..
-self.get("name")..".state"local _c={}
-if ab and
-fs.exists(db)then local ac=fs.open(db,"r")_c=
-textutils.unserialize(ac.readAll())or{}ac.close()end;cb[da]={value=ab and _c[da]or _b,persist=ab}
-return self end;local ca={}
-function ca:setState(da,_b)local ab=self:getBaseFrame()
-local bb=ab.get("states")local cb=ab.get("stateObserver")
-if not bb[da]then aa.error("State '"..
-da.."' not initialized")end
-if bb[da].persist then
-local db="states/"..ab.get("name")..".state"local _c={}
-if fs.exists(db)then local cc=fs.open(db,"r")_c=
-textutils.unserialize(cc.readAll())or{}cc.close()end;_c[da]=_b;local ac=fs.getDir(db)if not fs.exists(ac)then
-fs.makeDir(ac)end;local bc=fs.open(db,"w")
-bc.write(textutils.serialize(_c))bc.close()end;bb[da].value=_b
-if cb[da]then for db,_c in ipairs(cb[da])do _c(da,_b)end end;for db,_c in pairs(bb)do
-if _c.computed then _c.value=_c.computeFn(self)if cb[db]then for ac,bc in ipairs(cb[db])do
-bc(db,_c.value)end end end end
-return self end
-function ca:getState(da)local _b=self:getBaseFrame()local ab=_b.get("states")if
-not ab[da]then
-aa.error("State '"..da.."' not initialized")end;if ab[da].computed then
-return ab[da].computeFn(self)end;return ab[da].value end
-function ca:onStateChange(da,_b)local ab=self:getBaseFrame()
-local bb=ab.get("states")[da]if not bb then
-aa.error("Cannot observe state '"..da.."': State not initialized")return self end
-local cb=ab.get("stateObserver")if not cb[da]then cb[da]={}end;table.insert(cb[da],_b)
-return self end
-function ca:removeStateChange(da,_b)local ab=self:getBaseFrame()
-local bb=ab.get("stateObserver")
-if bb[da]then for cb,db in ipairs(bb[da])do
-if db==_b then table.remove(bb[da],cb)break end end end;return self end
-function ca:computed(da,_b)local ab=self:getBaseFrame()local bb=ab.get("states")if bb[da]then
-aa.error(
-"Computed state '"..da.."' already exists")return self end
-bb[da]={computeFn=_b,value=_b(self),computed=true}return self end
-function ca:bind(da,_b)_b=_b or da;local ab=self:getBaseFrame()local bb=false
-if
-self.get(da)~=nil then self.set(da,ab:getState(_b))end
-self:onChange(da,function(cb,db)if bb then return end;bb=true;cb:setState(_b,db)bb=false end)
-self:onStateChange(_b,function(cb,db)if bb then return end;bb=true;if self.get(da)~=nil then
-self.set(da,db)end;bb=false end)return self end;return{BaseElement=ca,BaseFrame=ba} end
 project["plugins/xml.lua"] = function(...) local ab=require("errorManager")local bb=require("log")
 local cb={new=function(ad)
 return
@@ -3347,64 +3451,151 @@ function db.getStats(_c)local ac=da[_c]if not ac then return nil end;return
 {averageTime=ac.totalTime/ac.calls,totalTime=ac.totalTime,calls=ac.calls,minTime=ac.minTime,maxTime=ac.maxTime,lastTime=ac.lastTime}end;function db.clear(_c)da[_c]=nil end;function db.clearAll()for _c,ac in pairs(da)do
 if ac.custom then da[_c]=nil end end end;return
 {BaseElement=bb,Container=cb,API=db} end
-project["elementManager.lua"] = function(...) local ab=table.pack(...)
-local bb=fs.getDir(ab[2]or"basalt")local cb=ab[1]if(bb==nil)then
+project["elementManager.lua"] = function(...) local _c=table.pack(...)
+local ac=fs.getDir(_c[2]or"basalt")local bc=_c[1]if(ac==nil)then
 error("Unable to find directory "..
-ab[2].." please report this bug to our discord.")end
-local db=require("log")local _c=package.path;local ac="path;/path/?.lua;/path/?/init.lua;"
-local bc=ac:gsub("path",bb)local cc={}cc._elements={}cc._plugins={}cc._APIs={}
-local dc=fs.combine(bb,"elements")local _d=fs.combine(bb,"plugins")
-db.info("Loading elements from "..dc)
-if fs.exists(dc)then
-for ad,bd in ipairs(fs.list(dc))do local cd=bd:match("(.+).lua")if cd then db.debug(
-"Found element: "..cd)
-cc._elements[cd]={class=nil,plugins={},loaded=false}end end end;db.info("Loading plugins from ".._d)
+_c[2].." please report this bug to our discord.")end
+local cc=require("log")local dc=package.path;local _d="path;/path/?.lua;/path/?/init.lua;"
+local ad=_d:gsub("path",ac)local bd={}bd._elements={}bd._plugins={}bd._APIs={}
+bd._config={autoLoadMissing=false,allowRemoteLoading=false,allowDiskLoading=true,remoteSources={},diskMounts={},useGlobalCache=false,globalCacheName="_BASALT_ELEMENT_CACHE"}local cd=fs.combine(ac,"elements")
+local dd=fs.combine(ac,"plugins")cc.info("Loading elements from "..cd)
 if
-fs.exists(_d)then
-for ad,bd in ipairs(fs.list(_d))do local cd=bd:match("(.+).lua")
-if cd then
-db.debug("Found plugin: "..cd)local dd=require(fs.combine("plugins",cd))
+fs.exists(cd)then
+for d_a,_aa in ipairs(fs.list(cd))do local aaa=_aa:match("(.+).lua")if aaa then cc.debug(
+"Found element: "..aaa)
+bd._elements[aaa]={class=nil,plugins={},loaded=false,source="local",path=nil}end end end;cc.info("Loading plugins from "..dd)
 if
-type(dd)=="table"then
-for __a,a_a in pairs(dd)do if(__a~="API")then
-if(cc._plugins[__a]==nil)then cc._plugins[__a]={}end;table.insert(cc._plugins[__a],a_a)else
-cc._APIs[cd]=a_a end end end end end end
+fs.exists(dd)then
+for d_a,_aa in ipairs(fs.list(dd))do local aaa=_aa:match("(.+).lua")
+if aaa then cc.debug("Found plugin: "..
+aaa)
+local baa=require(fs.combine("plugins",aaa))
+if type(baa)=="table"then
+for caa,daa in pairs(baa)do
+if(caa~="API")then if(bd._plugins[caa]==nil)then
+bd._plugins[caa]={}end
+table.insert(bd._plugins[caa],daa)else bd._APIs[aaa]=daa end end end end end end
 if(minified)then if(minified_elementDirectory==nil)then
-error("Unable to find minified_elementDirectory please report this bug to our discord.")end;for ad,bd in
+error("Unable to find minified_elementDirectory please report this bug to our discord.")end;for d_a,_aa in
 pairs(minified_elementDirectory)do
-cc._elements[ad:gsub(".lua","")]={class=nil,plugins={},loaded=false}end;if
-(minified_pluginDirectory==nil)then
+bd._elements[d_a:gsub(".lua","")]={class=nil,plugins={},loaded=false,source="local",path=nil}end;if(
+minified_pluginDirectory==nil)then
 error("Unable to find minified_pluginDirectory please report this bug to our discord.")end
-for ad,bd in
-pairs(minified_pluginDirectory)do local cd=ad:gsub(".lua","")
-local dd=require(fs.combine("plugins",cd))
-if type(dd)=="table"then
-for __a,a_a in pairs(dd)do
-if(__a~="API")then if(cc._plugins[__a]==nil)then
-cc._plugins[__a]={}end
-table.insert(cc._plugins[__a],a_a)else cc._APIs[cd]=a_a end end end end end
-function cc.loadElement(ad)
-if not cc._elements[ad].loaded then
-package.path=bc.."rom/?"local bd=require(fs.combine("elements",ad))
-package.path=_c;cc._elements[ad]={class=bd,plugins=bd.plugins,loaded=true}db.debug(
-"Loaded element: "..ad)
-if(cc._plugins[ad]~=nil)then
-for cd,dd in
-pairs(cc._plugins[ad])do if(dd.setup)then dd.setup(bd)end
-if(dd.hooks)then
-for __a,a_a in pairs(dd.hooks)do
-local b_a=bd[__a]if(type(b_a)~="function")then
+for d_a,_aa in
+pairs(minified_pluginDirectory)do local aaa=d_a:gsub(".lua","")
+local baa=require(fs.combine("plugins",aaa))
+if type(baa)=="table"then
+for caa,daa in pairs(baa)do
+if(caa~="API")then if(bd._plugins[caa]==nil)then
+bd._plugins[caa]={}end
+table.insert(bd._plugins[caa],daa)else bd._APIs[aaa]=daa end end end end end
+local function __a(d_a,_aa)if not bd._config.useGlobalCache then return end
+if not
+_G[bd._config.globalCacheName]then _G[bd._config.globalCacheName]={}end;_G[bd._config.globalCacheName][d_a]=_aa;cc.debug(
+"Cached element in _G: "..d_a)end
+local function a_a(d_a)if not bd._config.useGlobalCache then return nil end
+if
+
+_G[bd._config.globalCacheName]and _G[bd._config.globalCacheName][d_a]then
+cc.debug("Loaded element from _G cache: "..d_a)return _G[bd._config.globalCacheName][d_a]end;return nil end
+function bd.configure(d_a)for _aa,aaa in pairs(d_a)do
+if bd._config[_aa]~=nil then bd._config[_aa]=aaa end end end
+function bd.registerDiskMount(d_a)if not fs.exists(d_a)then
+error("Disk mount path does not exist: "..d_a)end
+table.insert(bd._config.diskMounts,d_a)cc.info("Registered disk mount: "..d_a)
+local _aa=fs.combine(d_a,"elements")
+if fs.exists(_aa)then
+for aaa,baa in ipairs(fs.list(_aa))do
+local caa=baa:match("(.+).lua")
+if caa then
+if not bd._elements[caa]then
+cc.debug("Found element on disk: "..caa)
+bd._elements[caa]={class=nil,plugins={},loaded=false,source="disk",path=fs.combine(_aa,baa)}end end end end end
+function bd.registerRemoteSource(d_a,_aa)if not bd._config.allowRemoteLoading then
+error("Remote loading is disabled. Enable with ElementManager.configure({allowRemoteLoading = true})")end
+bd._config.remoteSources[d_a]=_aa
+if not bd._elements[d_a]then
+bd._elements[d_a]={class=nil,plugins={},loaded=false,source="remote",path=_aa}else bd._elements[d_a].source="remote"
+bd._elements[d_a].path=_aa end
+cc.info("Registered remote source for "..d_a..": ".._aa)end
+local function b_a(d_a)if not http then
+error("HTTP API is not available. Enable it in your CC:Tweaked config.")end
+cc.info("Loading element from remote: "..d_a)local _aa=http.get(d_a)if not _aa then
+error("Failed to download from: "..d_a)end;local aaa=_aa.readAll()_aa.close()if
+not aaa or aaa==""then
+error("Empty response from: "..d_a)end;local baa,caa=load(aaa,d_a,"t",_ENV)if not baa then
+error(
+"Failed to load element from "..d_a..": "..tostring(caa))end;local daa=baa()return daa end
+local function c_a(d_a)if not fs.exists(d_a)then
+error("Element file does not exist: "..d_a)end
+cc.info("Loading element from disk: "..d_a)local _aa,aaa=loadfile(d_a)if not _aa then
+error("Failed to load element from "..
+d_a..": "..tostring(aaa))end;local baa=_aa()return baa end
+function bd.tryAutoLoad(d_a)
+if bd._config.allowDiskLoading then
+for _aa,aaa in ipairs(bd._config.diskMounts)do
+local baa=fs.combine(aaa,"elements")local caa=fs.combine(baa,d_a..".lua")
+if fs.exists(caa)then
+bd._elements[d_a]={class=
+nil,plugins={},loaded=false,source="disk",path=caa}bd.loadElement(d_a)return true end end end
+if
+bd._config.allowRemoteLoading and bd._config.remoteSources[d_a]then bd.loadElement(d_a)return true end;return false end
+function bd.loadElement(d_a)
+if not bd._elements[d_a]then
+if bd._config.autoLoadMissing then
+local _aa=bd.tryAutoLoad(d_a)if not _aa then
+error("Element '"..d_a.."' not found and could not be auto-loaded")end else
+error("Element '"..d_a.."' not found")end end
+if not bd._elements[d_a].loaded then local _aa=bd._elements[d_a].source or
+"local"local aaa;local baa=false;aaa=a_a(d_a)
+if aaa then
+baa=true
+cc.info("Loaded element from _G cache: "..d_a)elseif _aa=="local"then package.path=ad.."rom/?"
+aaa=require(fs.combine("elements",d_a))package.path=dc elseif _aa=="disk"then if not bd._config.allowDiskLoading then
+error(
+"Disk loading is disabled for element: "..d_a)end
+aaa=c_a(bd._elements[d_a].path)__a(d_a,aaa)elseif _aa=="remote"then if not bd._config.allowRemoteLoading then
+error(
+"Remote loading is disabled for element: "..d_a)end
+aaa=b_a(bd._elements[d_a].path)__a(d_a,aaa)else
+error("Unknown source type: ".._aa)end
+bd._elements[d_a]={class=aaa,plugins=aaa.plugins,loaded=true,source=baa and"cache"or _aa,path=bd._elements[d_a].path}if not baa then
+cc.debug("Loaded element: "..d_a.." from ".._aa)end
+if(bd._plugins[d_a]~=nil)then
+for caa,daa in
+pairs(bd._plugins[d_a])do if(daa.setup)then daa.setup(aaa)end
+if(daa.hooks)then
+for _ba,aba in pairs(daa.hooks)do
+local bba=aaa[_ba]if(type(bba)~="function")then
 error("Element "..
-ad.." does not have a method "..__a)end
-if(type(a_a)=="function")then
-bd[__a]=function(c_a,...)
-local d_a=b_a(c_a,...)local _aa=a_a(c_a,...)return _aa==nil and d_a or _aa end elseif(type(a_a)=="table")then
-bd[__a]=function(c_a,...)if a_a.pre then a_a.pre(c_a,...)end
-local d_a=b_a(c_a,...)if a_a.post then a_a.post(c_a,...)end;return d_a end end end end;for __a,a_a in pairs(dd)do
-if __a~="setup"and __a~="hooks"then bd[__a]=a_a end end end end end end
-function cc.getElement(ad)if not cc._elements[ad].loaded then
-cc.loadElement(ad)end;return cc._elements[ad].class end;function cc.getElementList()return cc._elements end;function cc.getAPI(ad)
-return cc._APIs[ad]end;return cc end
+d_a.." does not have a method ".._ba)end
+if(type(aba)=="function")then
+aaa[_ba]=function(cba,...)
+local dba=bba(cba,...)local _ca=aba(cba,...)return _ca==nil and dba or _ca end elseif(type(aba)=="table")then
+aaa[_ba]=function(cba,...)if aba.pre then aba.pre(cba,...)end
+local dba=bba(cba,...)if aba.post then aba.post(cba,...)end;return dba end end end end;for _ba,aba in pairs(daa)do
+if _ba~="setup"and _ba~="hooks"then aaa[_ba]=aba end end end end end end
+function bd.getElement(d_a)
+if not bd._elements[d_a]then
+if bd._config.autoLoadMissing then
+local _aa=bd.tryAutoLoad(d_a)if not _aa then
+error("Element '"..d_a.."' not found")end else
+error("Element '"..d_a.."' not found")end end
+if not bd._elements[d_a].loaded then bd.loadElement(d_a)end;return bd._elements[d_a].class end;function bd.getElementList()return bd._elements end;function bd.getAPI(d_a)
+return bd._APIs[d_a]end
+function bd.hasElement(d_a)return bd._elements[d_a]~=nil end
+function bd.isElementLoaded(d_a)return
+bd._elements[d_a]and bd._elements[d_a].loaded or false end
+function bd.clearGlobalCache()if _G[bd._config.globalCacheName]then _G[bd._config.globalCacheName]=
+nil
+cc.info("Cleared global element cache")end end
+function bd.getCacheStats()if not _G[bd._config.globalCacheName]then
+return{size=0,elements={}}end;local d_a={}for _aa,aaa in
+pairs(_G[bd._config.globalCacheName])do table.insert(d_a,_aa)end;return
+{size=#d_a,elements=d_a}end
+function bd.preloadElements(d_a)for _aa,aaa in ipairs(d_a)do
+if bd._elements[aaa]and
+not bd._elements[aaa].loaded then bd.loadElement(aaa)end end end;return bd end
 project["log.lua"] = function(...) local aa={}aa._logs={}aa._enabled=false;aa._logToFile=false
 aa._logFile="basalt.log"fs.delete(aa._logFile)
 aa.LEVEL={DEBUG=1,INFO=2,WARN=3,ERROR=4}
@@ -3441,7 +3632,11 @@ type(cc)~="function"then
 if _c.type=="table"then if cc==nil then
 if not _c.allowNil then ca(2,cc,_c.type)end end else ca(2,cc,_c.type)end end;if
 _c.setter then cc=_c.setter(bc,cc,...)end
-bc:_updateProperty(db,cc)return bc end end
+bc:_updateProperty(db,cc)return bc end
+cb["get"..ac.."State"]=function(bc,cc,...)ca(1,bc,"element")return
+bc.getPropertyState(db,cc,...)end
+cb["set"..ac.."State"]=function(bc,cc,dc,...)ca(1,bc,"element")
+bc.setPropertyState(db,cc,dc,...)return bc end end
 function _b.combineProperties(cb,db,...)local _c={...}for bc,cc in pairs(_c)do
 if not cb._properties[cc]then da.error("Property not found: "..
 cc)end end;local ac=
@@ -3481,7 +3676,7 @@ return ab[cb][dc]end})return bc end
 function _b.createFromBlueprint(cb,db,_c)local ac=cb.new({},_c)
 for bc,cc in pairs(db._values)do if type(cc)=="table"then
 ac._values[bc]=ba(cc)else ac._values[bc]=cc end end;return ac end
-function _b:__init()self._values={}self._observers={}
+function _b:__init()self._values={}self._observers={}self._states={}
 self.set=function(bc,cc,...)
 local dc=self._values[bc]local _d=self._properties[bc]
 if(_d~=nil)then if(_d.setter)then
@@ -3493,7 +3688,30 @@ self.get=function(bc,...)local cc=self._values[bc]local dc=self._properties[bc]
 if
 (dc==nil)then da.error("Property not found: "..bc)return end;if type(cc)=="function"and dc.type~="function"then
 cc=cc(self)end;return
-dc.getter and dc.getter(self,cc,...)or cc end;local cb={}local db=getmetatable(self).__index
+dc.getter and dc.getter(self,cc,...)or cc end
+self.setPropertyState=function(bc,cc,dc,...)local _d=self._properties[bc]
+if(_d~=nil)then if(_d.setter)then
+dc=_d.setter(self,dc,...)end;dc=bb(self,bc,dc,_d)if
+not self._states[cc]then self._states[cc]={}end
+self._states[cc][bc]=dc;local ad=self._values.currentState
+if ad==cc then if _d.canTriggerRender then
+self:updateRender()end
+if self._observers[bc]then for bd,cd in
+ipairs(self._observers[bc])do cd(self,dc,nil)end end end end end
+self.getPropertyState=function(bc,cc,...)local dc=self._states and self._states[cc]and
+self._states[cc][bc]local _d=
+dc~=nil and dc or self._values[bc]
+local ad=self._properties[bc]if(ad==nil)then da.error("Property not found: "..bc)
+return end;if
+type(_d)=="function"and ad.type~="function"then _d=_d(self)end;return
+ad.getter and ad.getter(self,_d,...)or _d end
+self.getResolved=function(bc,...)local cc=self:getCurrentState()local dc
+if
+cc and self._states and
+self._states[cc]and self._states[cc][bc]~=nil then dc=self._states[cc][bc]else dc=self._values[bc]end;local _d=self._properties[bc]if(_d==nil)then
+da.error("Property not found: "..bc)return end;if
+type(dc)=="function"and _d.type~="function"then dc=dc(self)end;return
+_d.getter and _d.getter(self,dc,...)or dc end;local cb={}local db=getmetatable(self).__index
 while db do if
 rawget(db,'_properties')then
 for bc,cc in pairs(db._properties)do if not cb[bc]then cb[bc]=cc end end end;db=getmetatable(db)and
@@ -3529,7 +3747,8 @@ function _b:instanceProperty(cb,db)
 _b.defineProperty(self,cb,db)self._values[cb]=db.default;return self end
 function _b:removeProperty(cb)self._values[cb]=nil;self._properties[cb]=nil;self._observers[cb]=
 nil
-local db=cb:sub(1,1):upper()..cb:sub(2)self["get"..db]=nil;self["set"..db]=nil;return self end
+local db=cb:sub(1,1):upper()..cb:sub(2)self["get"..db]=nil;self["set"..db]=nil;self["get"..db.."State"]=
+nil;self["set"..db.."State"]=nil;return self end
 function _b:getPropertyConfig(cb)return self._properties[cb]end;return _b end
 project["main.lua"] = function(...) local ad=require("elementManager")
 local bd=require("errorManager")local cd=require("propertySystem")
@@ -3623,7 +3842,55 @@ if __a._events[aca]then
 for bca,cca in
 ipairs(__a._events[aca])do local dca,_da=pcall(cca,...)if not dca then bd.header="Basalt Event Callback Error"
 bd.error(
-"Error in event callback for '"..aca.."': "..tostring(_da))end end end end;return __a end
+"Error in event callback for '"..aca.."': "..tostring(_da))end end end end
+function __a.requireElements(aca,bca)if type(aca)=="string"then aca={aca}end
+dd(1,aca,"table")if bca~=nil then dd(2,bca,"boolean")end;local cca={}local dca={}for _da,ada in
+ipairs(aca)do
+if not ad.hasElement(ada)then table.insert(cca,ada)elseif not
+ad.isElementLoaded(ada)then table.insert(dca,ada)end end
+if
+#dca>0 then
+for _da,ada in ipairs(dca)do local bda,cda=pcall(ad.loadElement,ada)
+if not bda then
+__a.LOGGER.warn(
+"Failed to load element "..ada..": "..tostring(cda))table.insert(cca,ada)end end end
+if#cca>0 then
+if bca then local _da={}for ada,bda in ipairs(cca)do local cda=ad.tryAutoLoad(bda)if not cda then
+table.insert(_da,bda)end end
+if
+#_da>0 then
+local ada="Missing required elements: "..table.concat(_da,", ")
+ada=ada.."\n\nThese elements could not be auto-loaded."
+ada=ada.."\nPlease install them or register remote sources."bd.error(ada)end else
+local _da="Missing required elements: "..table.concat(cca,", ")_da=_da.."\n\nSuggestions:"
+_da=_da.."\n  • Use basalt.requireElements({...}, true) to auto-load"
+_da=_da.."\n  • Register remote sources with elementManager.registerRemoteSource()"
+_da=_da.."\n  • Register disk mounts with elementManager.registerDiskMount()"bd.error(_da)end end
+__a.LOGGER.info("All required elements are available: "..table.concat(aca,", "))return true end
+function __a.loadManifest(aca)dd(1,aca,"string")
+if not fs.exists(aca)then bd.error(
+"Manifest file not found: "..aca)end;local bca;local cca,dca=pcall(dofile,aca)if not cca then
+bd.error("Failed to load manifest: "..tostring(dca))end;bca=dca;if type(bca)~="table"then
+bd.error("Manifest must return a table")end
+if bca.config then
+ad.configure(bca.config)__a.LOGGER.debug("Applied manifest config")end;if bca.diskMounts then
+for _da,ada in ipairs(bca.diskMounts)do ad.registerDiskMount(ada)end end;if bca.remoteSources then
+for _da,ada in
+pairs(bca.remoteSources)do ad.registerRemoteSource(_da,ada)end end;if bca.requiredElements then local _da=
+bca.autoLoadMissing~=false
+__a.requireElements(bca.requiredElements,_da)end
+if bca.optionalElements then for _da,ada in
+ipairs(bca.optionalElements)do pcall(ad.loadElement,ada)end end
+if bca.preloadElements then ad.preloadElements(bca.preloadElements)end
+__a.LOGGER.info("Manifest loaded successfully: ".. (bca.name or aca))return bca end
+function __a.install(aca,bca)dd(1,aca,"string")
+if bca~=nil then dd(2,bca,"string")end
+if ad.hasElement(aca)and ad.isElementLoaded(aca)then return true end
+if bca then
+if bca:match("^https?://")then ad.registerRemoteSource(aca,bca)else if not
+fs.exists(bca)then
+bd.error("Source file not found: "..bca)end end end;local cca=ad.tryAutoLoad(aca)if cca then return true else return false end end
+function __a.configure(aca)dd(1,aca,"table")ad.configure(aca)end;return __a end
 project["libraries/colorHex.lua"] = function(...) local b={}for i=0,15 do b[2 ^i]=("%x"):format(i)
 b[("%x"):format(i)]=2 ^i end;return b end
 project["libraries/utils.lua"] = function(...) local d,_a=math.floor,string.len;local aa={}
@@ -3649,6 +3916,42 @@ for db,_c in ipairs(cb)do
 local ac=aa.split(_c," ")local bc=""
 for cc,dc in ipairs(ac)do if#bc==0 then bc=dc elseif#bc+#dc+1 <=ca then bc=bc.." "..dc else
 table.insert(da,bc)bc=dc end end;if#bc>0 then table.insert(da,bc)end end;if ab<#_b then table.insert(da,"")end end end;return da end;return aa end
+project["libraries/collectionentry.lua"] = function(...) local b={}
+b.__index=function(c,d)local _a=rawget(b,d)if _a then return _a end;if c._data[d]~=nil then return
+c._data[d]end;local aa=c._parent[d]if aa then return aa end
+return nil end
+function b.new(c,d)local _a={_parent=c,_data=d}return setmetatable(_a,b)end
+function b:_findIndex()for c,d in ipairs(self._parent:getItems())do
+if d==self then return c end end;return nil end;function b:setText(c)self._data.text=c
+self._parent:updateRender()return self end;function b:getText()
+return self._data.text end
+function b:moveUp(c)local d=self._parent:getItems()
+local _a=self:_findIndex()if not _a then return self end;c=c or 1;local aa=math.max(1,_a-c)if _a~=aa then
+table.remove(d,_a)table.insert(d,aa,self)
+self._parent:updateRender()end;return self end
+function b:moveDown(c)local d=self._parent:getItems()
+local _a=self:_findIndex()if not _a then return self end;c=c or 1;local aa=math.min(#d,_a+c)if _a~=aa then
+table.remove(d,_a)table.insert(d,aa,self)
+self._parent:updateRender()end;return self end
+function b:moveToTop()local c=self._parent:getItems()
+local d=self:_findIndex()if not d or d==1 then return self end;table.remove(c,d)
+table.insert(c,1,self)self._parent:updateRender()return self end
+function b:moveToBottom()local c=self._parent:getItems()
+local d=self:_findIndex()if not d or d==#c then return self end;table.remove(c,d)
+table.insert(c,self)self._parent:updateRender()return self end;function b:getIndex()return self:_findIndex()end
+function b:swapWith(c)
+local d=self._parent:getItems()local _a=self:getIndex()local aa=c:getIndex()
+if _a and aa and _a~=aa then
+d[_a],d[aa]=d[aa],d[_a]self._parent:updateRender()end;return self end
+function b:remove()if self._parent and self._parent.removeItem then
+self._parent:removeItem(self)return true end;return false end
+function b:select()if self._parent and self._parent.selectItem then
+self._parent:selectItem(self)end;return self end
+function b:unselect()if self._parent and self._parent.unselectItem then
+self._parent:unselectItem(self)end end
+function b:isSelected()
+if self._parent and self._parent.getSelectedItem then return
+self._parent:getSelectedItem()==self end;return false end;return b end
 project["libraries/expect.lua"] = function(...) local c=require("errorManager")
 local function d(_a,aa,ba)local ca=type(aa)
 if ba=="element"then if ca=="table"and