From 424334cfae3d30d27f76600a03eed744eeb11d1a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 4 Nov 2025 21:41:18 +0000 Subject: [PATCH] Update config, BasaltLS definitions, full and core bundles, and changelog --- BasaltLS.lua | 10733 +++++++++++++++++++------------------- config.lua | 768 +-- release/basalt-core.lua | 690 +-- release/basalt-full.lua | 2208 ++++---- 4 files changed, 7319 insertions(+), 7080 deletions(-) diff --git a/BasaltLS.lua b/BasaltLS.lua index 4ba4a2c..a1cce9b 100644 --- a/BasaltLS.lua +++ b/BasaltLS.lua @@ -1,351 +1,1066 @@ ---@meta ----@class AnimationInstance -local AnimationInstance = {} +---@class Animation +local Animation = {} ----Updates the animation ----@param elapsed number The elapsed time in seconds ----@return boolean Whether the animation is finished -function AnimationInstance:update(elapsed) 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 ----Gets called when the animation is completed -function AnimationInstance:complete() end +---Registers a callback for the start event +---@param callback function The callback function to register +function Animation:onStart(callback) end + +---Stops the animation immediately: cancels timers, completes running anim instances and clears the element property +function Animation:stop() 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 + +---Creates a new Animation +---@param element VisualElement The element to animate +---@return Animation The new animation +function Animation.new(element) 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 ---Starts the animation ----@return AnimationInstance self The animation instance -function AnimationInstance:start() end +---@return Animation self The animation instance +function Animation:start() 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 +---Creates a new sequence +---@return Animation self The animation instance +function Animation:sequence() 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 = {} - ----@param name string The name of the series ----@return Graph self The graph instance -function Graph:removeSeries(name) 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 - ----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 - ----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 - ----@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 visible boolean Whether the series should be visible ----@return Graph self The graph instance -function Graph:changeSeriesVisibility(name, visible) 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 - ----@param name string The name of the series ----@return Graph self The graph instance -function Graph:focusSeries(name) 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 - ----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 - ----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 - ----@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 - ----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 MinValue property. ----@param self Graph self ----@param MinValue number The minimum value of the graph -function Graph:setMinValue(self, MinValue) end - ----@class BaseElement : PropertySystem ----@field eventCallbacks table Collection of registered event handler functions ----@field id string Auto-generated unique identifier for element lookup ----@field type string A hierarchical identifier of the element's type chain ----@field enabled boolean Controls event processing for this element ----@field name string User-defined name for the element ----@field states table Table of currently active states with their priorities -local BaseElement = {} - ----Gets the highest priority active state ----@return string |nil currentState The state with highest priority -function BaseElement:getCurrentState() 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 - ----Updates all states that have auto-conditions ----@return BaseElement self -function BaseElement:updateConditionalStates() 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 debugging for this element ----@param self BaseElement The element to debug ----@param level number The debug level -function BaseElement.debug(self, level) 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 - ----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 - ----Propagates render request up the element tree ----@return table self The BaseElement instance -function BaseElement:updateRender() end - ----Traverses parent chain to locate the root frame element ----@return BaseFrame BaseFrame The base frame of the element -function BaseElement:getBaseFrame() 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 Id property. ----@param self BaseElement self ----@return string BaseElement Auto-generated unique identifier for element lookup -function BaseElement:getId(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 - ----Adds an event handler function with automatic event registration ----@param event string The event to register the callback for +---Registers a callback for the complete event ---@param callback function The callback function to register ----@return table self The BaseElement instance -function BaseElement:registerCallback(event, callback) end +---@return Animation self The animation instance +function Animation:onComplete(callback) 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 +---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 ----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 - ----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. ----@return table self The BaseElement instance ----@protected -function BaseElement:postInit() end - ----Gets all currently active states sorted by priority ----@return table states Array of {name, priority} sorted by priority -function BaseElement:getActiveStates() 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 - ----Manually deactivates a state ----@param stateName string The state to deactivate ----@return BaseElement self -function BaseElement:unsetState(stateName) 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 - ----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 - ----Checks if a state is currently active ----@param stateName string The state to check ----@return boolean isActive -function BaseElement:hasState(stateName) end - ----Removes the element from UI tree and cleans up resources -function BaseElement:destroy() end - ----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 the Id property. ----@param self BaseElement self ----@param Id string Auto-generated unique identifier for element lookup -function BaseElement:setId(self, Id) 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 EventCallbacks property. ----@param self BaseElement self ----@return table BaseElement Collection of registered event handler functions -function BaseElement:getEventCallbacks(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 BaseElement:init(props, basalt) 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 Name property. ----@param self BaseElement self ----@param Name string User-defined name for the element -function BaseElement:setName(self, Name) 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 - ----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 - ----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 - ----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 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 - ----Removes a state from the registry ----@param stateName string The state to remove ----@return BaseElement self -function BaseElement:unregisterState(stateName) 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 Type property. ----@param self BaseElement self ----@param Type string A hierarchical identifier of the element's type chain -function BaseElement:setType(self, Type) 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 - ----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 EventCallbacks property. ----@param self BaseElement self ----@param EventCallbacks table Collection of registered event handler functions -function BaseElement:setEventCallbacks(self, EventCallbacks) 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 - ----Manually activates a state ----@param stateName string The state to activate ----@return BaseElement self -function BaseElement:setState(stateName) 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 Reactive local Reactive = {} ----@class Frame : Container ----@field draggable boolean Whether the frame is draggable ----@field scrollable boolean Whether the frame is scrollable ----@field draggingMap table The map of dragging positions -local Frame = {} +---@class Log +local Log = {} ----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 +---Sends a debug message to the logger. +function Log.debug() end + +---Sends an info message to the logger. +function Log.info() end + +---Sets if the logger should log +function Log.setEnabled() end + +---Sets if the logger should log to a file. +function Log.setLogToFile() end + +---Sends a warning message to the logger. +function Log.warn() end + +---Sends an error message to the logger. +function Log.error() 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 = {} + +---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 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 Text property. +---@param self BigFont self +---@return string BigFont The text string to display in enlarged format +function BigFont: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 BigFont:render() 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 + +---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 + +---@class Input : VisualElement +---@field maxLength number nil Maximum length of input text (optional) +---@field text string The current text content of the input +---@field viewOffset number The horizontal scroll offset for viewing long text +---@field placeholderColor color Color of the placeholder text +---@field placeholder string Text to display when input is empty +---@field cursorPos number The current cursor position in the text +---@field replaceChar string Character to replace the input with (for password fields) +---@field cursorColor number Color of the cursor +---@field pattern string nil Regular expression pattern for input validation +local Input = {} + +---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 + +---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 Placeholder property. +---@param self Input self +---@return string ... Text to display when input is empty +function Input:getPlaceholder(self) 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 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 MaxLength property. +---@param self Input self +---@param MaxLength number nil Maximum length of input text (optional) +function Input:setMaxLength(self, MaxLength) 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 + +---Updates the input's viewport +---@return Input self The updated instance +function Input:updateViewport() 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 + +---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 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 + +---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 + +---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 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 Input:mouse_click(button, x, y) 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 + +---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 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. +---@param props table The properties to initialize the element with +---@param basalt table The basalt instance +---@return Input self The initialized instance +---@protected +function Input:init(props, basalt) 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 + +---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 CursorColor property. +---@param self Input self +---@return number nil Color of the cursor +function Input:getCursorColor(self) end + +---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 + +---Sets the value of the CursorColor property. +---@param self Input self +---@param CursorColor number Color of the cursor +function Input:setCursorColor(self, CursorColor) 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 + +---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 + +---Gets the value of the PlaceholderColor property. +---@param self Input self +---@return color gray Color of the placeholder text +function Input:getPlaceholderColor(self) end + +---@class Container : VisualElement +---@field children table Collection of all child elements +---@field offsetY number Vertical scroll/content offset +---@field eventListenerCount table Number of listeners per event type +---@field childrenEventsSorted boolean Indicates if event handlers are properly sorted +---@field childrenSorted boolean Indicates if children are sorted by z-index +---@field focusedChild table Currently focused child element (receives keyboard events) +---@field visibleChildrenEvents table Event handlers for currently visible children +---@field childrenEvents table Registered event handlers for all children +---@field offsetX number Horizontal scroll/content offset +---@field visibleChildren table Currently visible child elements (calculated based on viewport) +local Container = {} + +---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. +---@param char string The character that was pressed +---@return boolean handled Whether the event was handled +---@protected +function Container:char(char) 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 + +---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 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 + +---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 + +---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 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 + +---Creates a new Accordion element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return Accordion element A new Accordion element. +function Container:addAccordion(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 + +---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 + +---Removes all child elements and resets the container's state +---@return Container self For method chaining +function Container:clear() 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 ScrollFrame element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return ScrollFrame element A new ScrollFrame element. +function Container:addScrollFrame(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 + +---Sets the value of the OffsetX property. +---@param self Container self +---@param OffsetX number Horizontal scroll/content offset +function Container:setOffsetX(self, OffsetX) 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 + +---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 ChildrenEvents property. +---@param self Container self +---@param ChildrenEvents table Registered event handlers for all children +function Container:setChildrenEvents(self, ChildrenEvents) 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 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 + +---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 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 + +---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:drawBg() 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 + +---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 + +---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 + +---Re-sorts children by their z-index and updates visibility +---@return Container self For method chaining +function Container:sortChildren() 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 + +---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 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 + +---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 + +---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 _ 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 Toast element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return Toast element A new Toast element. +function Container:addToast(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 color The foreground color of the text +---@return Container self The container instance +---@protected +function Container:textFg(x, y, text, fg) end + +function Container:drawText() end + +---Creates a new Dialog element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return Dialog element A new Dialog element. +function Container:addDialog(self, props) 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 + +---Applies a layout from a file to this container +---@param layoutPath string Path to the layout file (e.g. "layouts/grid") +---@return Container self For method chaining +function Container:applyLayout(layoutPath) end + +---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 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 +---@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. +---@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 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 VisibleChildrenEvents property. +---@param self Container self +---@param VisibleChildrenEvents table Event handlers for currently visible children +function Container:setVisibleChildrenEvents(self, VisibleChildrenEvents) 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 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 ChildrenEvents property. +---@param self Container self +---@return table {} Registered event handlers for all children +function Container:getChildrenEvents(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 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 + +---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 + +---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 OffsetY property. +---@param self Container self +---@return number 0 Vertical scroll/content offset +function Container:getOffsetY(self) 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 + +---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 props table The properties to initialize the element with +---@param basalt table The basalt instance +---@protected +function Container:init(props, basalt) 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 + +---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. +---@protected +function Container:render() 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 + +---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 VisibleChildren property. +---@param self Container self +---@return table {} Currently visible child elements (calculated based on viewport) +function Container:getVisibleChildren(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 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 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 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 EventListenerCount property. +---@param self Container self +---@return table {} Number of listeners per event type +function Container:getEventListenerCount(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 + +---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 + +---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 Breadcrumb element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return Breadcrumb element A new Breadcrumb element. +function Container:addBreadcrumb(self, props) end + +---Updates the current layout (recalculates positions) +---@return Container self For method chaining +function Container:updateLayout() 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 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 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 + +---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 ContextMenu element. +---@param self Container self +---@param props? table Optional: properties for the element. +---@return ContextMenu element A new ContextMenu element. +function Container:addContextMenu(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 + +---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 + +---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 + +---Removes the current layout +---@return Container self For method chaining +function Container:clearLayout() 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 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 ChildrenSorted property. +---@param self Container self +---@return boolean true Indicates if children are sorted by z-index +function Container:getChildrenSorted(self) 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 + +---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 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 + +---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 + +---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 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 + +function Container:drawFg() 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 + +---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 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 + +---@class CheckBox : VisualElement +---@field text string Text shown when the checkbox is unchecked +---@field autoSize boolean Automatically adjusts width based on text length +---@field checked boolean The current state of the checkbox (true=checked, false=unchecked) +---@field checkedText string Text shown when the checkbox is checked +local CheckBox = {} + +---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 Text property. +---@param self CheckBox self +---@return string empty Text shown when the checkbox is unchecked +function CheckBox:getText(self) 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 + +---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 + +---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 + +---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 Checked property. +---@param self CheckBox self +---@return boolean false The current state of the checkbox (true=checked, false=unchecked) +function CheckBox:getChecked(self) 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 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 + +---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 + +---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 + +---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 + +---@class LineChart : Graph +local LineChart = {} + +---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 LineChart: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 LineChart self The initialized instance +---@protected +function LineChart:init(props, basalt) end + +---@class Button : VisualElement +---@field text string Label text displayed centered within the button +local Button = {} + +---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 + +---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 + +---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 + +---@class Render +local Render = {} + +---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 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 +---@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 + +---Gets the size of the render +---@return number , number +function Render:getSize() 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 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 + +---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 + +---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 + +---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 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 + +---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 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 + +---Renders the buffer to the screen +---@return Render +function Render:render() 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 + +---Clears the screen +---@param bg colors The background color to clear the screen with +---@return Render +function Render:clear(bg) 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 = {} ---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 @@ -355,10 +1070,20 @@ function Frame:setDraggingMap(self, DraggingMap) end ---@protected function Frame:mouse_click(button, x, y) end ----Sets the value of the Scrollable property. +---Sets the value of the DraggingMap property. ---@param self Frame self ----@param Scrollable boolean Whether the frame is scrollable -function Frame:setScrollable(self, Scrollable) end +---@param DraggingMap table The map of dragging positions +function Frame:setDraggingMap(self, DraggingMap) 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 ---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 @@ -367,10 +1092,13 @@ function Frame:setScrollable(self, Scrollable) end ---@protected function Frame:init(props, basalt) 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 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 ---Gets the value of the DraggingMap property. ---@param self Frame self @@ -403,698 +1131,38 @@ function Frame:getDraggable(self) end ---@protected function Frame:mouse_up(button, x, y) end ----Gets the value of the Scrollable property. +---Sets 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 - ----@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 = {} - ----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 - ----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 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. ----@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 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 - ----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 - ----@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 - ----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 - ----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 - ----@class ProgressBar : VisualElement ----@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") ----@field progress number Current progress value (0-100) ----@field progressColor color The color used for the filled portion of the progress bar -local ProgressBar = {} - ----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 - ----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 - ----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 - ----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 - ----Gets the value of the Progress property. ----@param self ProgressBar self ----@return number 0 Current progress value (0-100) -function ProgressBar:getProgress(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 - ----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 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 - ----@class PropertySystem -local PropertySystem = {} - ----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 - ----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 - ----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 - ----Initializes the PropertySystem IS USED INTERNALLY ----@return table self The PropertySystem -function PropertySystem:__init() 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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----@class Program : VisualElement ----@field errorCallback function The error callback function ----@field running boolean Whether the program is running ----@field path string The path to the program ----@field program table The program instance ----@field doneCallback function The done callback function -local Program = {} - ----Sends an event to the program ----@param event string The event to send ----@return Program self The Program instance -function Program:sendEvent(event) 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 DoneCallback property. ----@param self Program self ----@return function nil The done callback function -function Program:getDoneCallback(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 DoneCallback property. ----@param self Program self ----@param DoneCallback function The done callback function -function Program:setDoneCallback(self, DoneCallback) 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 ErrorCallback property. ----@param self Program self ----@return function nil The error callback function -function Program:getErrorCallback(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 - ----Sets the value of the ErrorCallback property. ----@param self Program self ----@param ErrorCallback function The error callback function -function Program:setErrorCallback(self, ErrorCallback) end - ----Gets the value of the Program property. ----@param self Program self ----@return table nil The program instance -function Program:getProgram(self) 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 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 - ----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 - ----Executes a program ----@param path string The path to the program ----@return Program self The Program instance -function Program:execute(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 - ----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 - ----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 - ----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 - ----Stops the program ----@return Program self The Program instance -function Program:stop() end - -function BasaltProgram:setArgs() end - ----@class Breadcrumb : VisualElement ----@field path table Array of strings representing the breadcrumb segments ----@field clickable true Whether the segments are clickable ----@field autoSize false Whether to resize the element width automatically based on text -local Breadcrumb = {} - ----Gets the value of the Path property. ----@param self Breadcrumb self ----@return table {} Array of strings representing the breadcrumb segments -function Breadcrumb:getPath(self) end - ----Sets the value of the Clickable property. ----@param self Breadcrumb self ----@param Clickable true Whether the segments are clickable -function Breadcrumb:setClickable(self, Clickable) end - ----Registers a callback for the select event ----@param callback function The callback function to register ----@return Breadcrumb self The Breadcrumb instance -function Breadcrumb:onSelect(callback) end - ----@param props table ----@param basalt table -function Breadcrumb:init(props, basalt) end - ----Sets the value of the Path property. ----@param self Breadcrumb self ----@param Path table Array of strings representing the breadcrumb segments -function Breadcrumb:setPath(self, Path) end - ----Sets the value of the AutoSize property. ----@param self Breadcrumb self ----@param AutoSize false Whether to resize the element width automatically based on text -function Breadcrumb:setAutoSize(self, AutoSize) end - ----Gets the value of the Clickable property. ----@param self Breadcrumb self ----@return true boolean Whether the segments are clickable -function Breadcrumb:getClickable(self) end - ----Gets the value of the AutoSize property. ----@param self Breadcrumb self ----@return false boolean Whether to resize the element width automatically based on text -function Breadcrumb: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 Breadcrumb:render() end - ----@param button number ----@param x number ----@param y number ----@return boolean handled -function Breadcrumb:mouse_click(button, x, y) end - ----@return table self -function Breadcrumb.new() 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 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 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 - ----Gets the size of the render ----@return number , number -function Render:getSize() 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 - ----Creates a new Render object ----@param terminal table The terminal object to render to ----@return Render -function Render.new(terminal) 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 - ----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 - ----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 ----@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 - ----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 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 - ----Renders the buffer to the screen ----@return Render -function Render:render() 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 - ----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 - ----@class Dialog : Frame ----@field primaryColor color Primary button color (OK, confirm actions) ----@field title string The dialog title ----@field secondaryColor color Secondary button color (Cancel, dismiss actions) ----@field buttonForeground color Foreground color for buttons ----@field modal boolean If true, blocks all events outside the dialog -local Dialog = {} - ----Gets the value of the Modal property. ----@param self Dialog self ----@return boolean true If true, blocks all events outside the dialog -function Dialog:getModal(self) end - ----Creates a prompt dialog with input ----@param title string The dialog title ----@param message string The prompt message ----@return Dialog self The Dialog instance -function Dialog:prompt(title, message) end - ----Shows the dialog ----@return Dialog self The Dialog instance -function Dialog:show() end - ----Sets the value of the ButtonForeground property. ----@param self Dialog self ----@param ButtonForeground color Foreground color for buttons -function Dialog:setButtonForeground(self, ButtonForeground) end - ----Handles mouse scroll 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. ----@protected -function Dialog:mouse_scroll() end - ----Creates a confirm dialog ----@param title string The dialog title ----@param message string The confirmation message ----@param callback function Callback (receives boolean result) ----@return Dialog self The Dialog instance -function Dialog:confirm(title, message, callback) end - ----Sets the value of the SecondaryColor property. ----@param self Dialog self ----@param SecondaryColor color Secondary button color (Cancel, dismiss actions) -function Dialog:setSecondaryColor(self, SecondaryColor) end - ----Creates a simple alert dialog ----@param title string The alert title ----@param message string The alert message ----@return Dialog self The Dialog instance -function Dialog:alert(title, message) end - ----Gets the value of the ButtonForeground property. ----@param self Dialog self ----@return color black Foreground color for buttons -function Dialog:getButtonForeground(self) 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. ----@protected -function Dialog:mouse_click() end - ----Gets the value of the SecondaryColor property. ----@param self Dialog self ----@return color lightGray Secondary button color (Cancel, dismiss actions) -function Dialog:getSecondaryColor(self) end - ----Renders the dialog ----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 Dialog:render() end - ----Handles mouse drag 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. ----@protected -function Dialog:mouse_drag() end - ----Handles mouse up 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. ----@protected -function Dialog:mouse_up() end - ----Sets the value of the PrimaryColor property. ----@param self Dialog self ----@param PrimaryColor color Primary button color (OK, confirm actions) -function Dialog:setPrimaryColor(self, PrimaryColor) end - ----Gets the value of the Title property. ----@param self Dialog self ----@return string "" The dialog title -function Dialog:getTitle(self) end - ----Sets the value of the Modal property. ----@param self Dialog self ----@param Modal boolean If true, blocks all events outside the dialog -function Dialog:setModal(self, Modal) end - ----Gets the value of the PrimaryColor property. ----@param self Dialog self ----@return color lime Primary button color (OK, confirm actions) -function Dialog:getPrimaryColor(self) end - ----Closes the dialog ----@return Dialog self The Dialog instance -function Dialog:close() end - ----Sets the value of the Title property. ----@param self Dialog self ----@param Title string The dialog title -function Dialog:setTitle(self, Title) end +---@param Scrollable boolean Whether the frame is scrollable +function Frame:setScrollable(self, Scrollable) end ---@class Collection : VisualElement ----@field selectedBackground color Background color for selected items ----@field selectedForeground color Text color for selected items ---@field selectable boolean Whether items can be selected ---@field multiSelection boolean Whether multiple items can be selected at once +---@field selectedBackground color Background color for selected items +---@field selectedForeground color Text color for selected items local Collection = {} ----Gets the value of the Selectable property. ----@param self Collection self ----@return boolean true Whether items can be selected -function Collection:getSelectable(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 - ----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 - ----Clears all items from the Collection ----@return Collection self The Collection instance -function Collection:clear() end - -function Collection:selectItem() end - ----Selects the next item in the collection ----@return Collection self The Collection instance -function Collection:selectNext() 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 index of the first selected item ----@return number ? index The index of the first selected item, or nil if none selected -function Collection:getSelectedIndex() 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 - ----Gets first selected item ----@return table ? selected The first item -function Collection:getSelectedItem() 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 - ----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 - -function Collection:clearItemSelection() 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 - ----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 - -function Collection:unselectItem() 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 ----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 +function Collection:selectItem() end ----Gets the value of the SelectedForeground property. +---Gets the value of the SelectedBackground property. ---@param self Collection self ----@return color white Text color for selected items -function Collection:getSelectedForeground(self) end +---@return color blue Background color for selected items +function Collection:getSelectedBackground(self) end ----Selects the previous item in the collection +---Clears all items from the Collection ---@return Collection self The Collection instance -function Collection:selectPrevious() end +function Collection:clear() 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 ---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 @@ -1103,3766 +1171,156 @@ function Collection:selectPrevious() end ---@protected function Collection:init(props, basalt) end ----@class TabControl : Container ----@field tabHeight number Height of the tab header area ----@field activeTabTextColor color Foreground color for the active tab text ----@field headerBackground color Background color for the tab header area ----@field activeTab number The currently active tab ID ----@field tabScrollOffset number Current scroll offset for tabs in scrollable mode ----@field scrollableTab boolean Enables scroll mode for tabs if they exceed width ----@field tabs table List of tab definitions ----@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 - ----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:blit() 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. ----@protected -function TabControl:render() 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 - ----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. ----@param child table The child element to add ----@return Container self For method chaining ----@protected -function TabControl:addChild(child) end - -function TabControl:getRelativePosition() 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 - ----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 - ----Gets the value of the Tabs property. ----@param self TabControl self ----@return table {} List of tab definitions -function TabControl:getTabs(self) end - -function TabControl:textFg() end - -function TabControl: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 props table The properties to initialize the element with ----@param basalt table The basalt instance ----@protected -function TabControl:init(props, basalt) end - -function TabControl:_getHeaderMetrics() 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 ActiveTabBackground property. ----@param self TabControl self ----@return color white Background color for the active tab -function TabControl:getActiveTabBackground(self) end - -function TabControl:textBg() 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 - ----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 TabScrollOffset property. ----@param self TabControl self ----@return number 0 Current scroll offset for tabs in scrollable mode -function TabControl:getTabScrollOffset(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 - ----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:setCursor() end - -function TabControl:mouse_drag() 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 check ----@return boolean Whether the child should be visible ----@protected -function TabControl:isChildVisible(child) end - -function TabControl:mouse_move() 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 - ----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 - -function TabControl:mouse_release() end - -function TabControl:mouse_up() 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 - ----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 - ----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. ----@return number yOffset The Y offset for content ----@protected -function TabControl:getContentYOffset() 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 - ----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:multiBlit() end - -function TabControl:drawText() end - -function TabControl:drawFg() 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 - ----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 - ----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 - ----Configures the ElementManager ----@param config table Configuration options -function ElementManager.configure(config) end - ----Preloads elements into the global cache ----@param elementNames table List of element names to preload -function ElementManager.preloadElements(elementNames) 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 - ----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 - ----Clears the global cache (_G) -function ElementManager.clearGlobalCache() 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 - ----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 cache statistics ----@return table stats Cache statistics with size and element names -function ElementManager.getCacheStats() end - ----Registers a disk mount point for loading elements ----@param mountPath string The path to the disk mount -function ElementManager.registerDiskMount(mountPath) end - ----@class Table : Collection ----@field offset number Scroll offset for vertical scrolling ----@field headerColor color Color of the column headers ----@field columns table List of column definitions with {name, width} properties ----@field scrollBarBackgroundColor color Background color of the scrollbar ----@field gridColor color Color of grid lines ----@field scrollBarColor color Color of the scrollbar handle ----@field scrollBarSymbol string " Symbol used for the scrollbar handle ----@field showScrollBar boolean Whether to show the scrollbar when items exceed height ----@field scrollBarBackground string Symbol used for the scrollbar background ----@field sortColumn number nil Currently sorted column index ----@field sortDirection string Sort direction ("asc" or "desc") ----@field customSortFunction table Custom sort functions for columns -local Table = {} - ----Adds a new column to the table ----@param name string The name of the column ----@param width number |string The width of the column (number, "auto", or "30%") ----@return Table self The Table instance -function Table:addColumn(name, width) end - ----Adds a new row to the table ----@return Table self The Table instance -function Table:addRow() end - ----Gets a row by index ----@param rowIndex number The index of the row ----@return table ? row The row data or nil -function Table:getRow(rowIndex) 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 - ----Gets the currently selected row ----@return table ? row The selected row or nil -function Table:getSelectedRow() end - ----Sets the value of the ScrollBarColor property. ----@param self Table self ----@param ScrollBarColor color Color of the scrollbar handle -function Table:setScrollBarColor(self, ScrollBarColor) 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 all table data ----@return table data Array of row cell arrays -function Table:getData() end - ----Set data with automatic formatting ----@param rawData table The raw data array (array of row arrays) ----@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 ScrollBarBackground property. ----@param self Table self ----@param ScrollBarBackground string Symbol used for the scrollbar background -function Table:setScrollBarBackground(self, ScrollBarBackground) end - ----Sets the value of the ScrollBarBackgroundColor property. ----@param self Table self ----@param ScrollBarBackgroundColor color Background color of the scrollbar -function Table:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) 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 - ----Registers a function to handle the onRowSelect event. ----@param rowIndex number ----@param row table ----@param self Table self +---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 + +---Gets first selected item +---@return table ? selected The first item +function Collection:getSelectedItem() 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 + +---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 + +---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 the index of the first selected item +---@return number ? index The index of the first selected item, or nil if none selected +function Collection:getSelectedIndex() 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 + +---Selects the next item in the collection +---@return Collection self The Collection instance +function Collection:selectNext() end + +function Collection:clearItemSelection() 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 + +---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 + +---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 + +---Selects the previous item in the collection +---@return Collection self The Collection instance +function Collection:selectPrevious() end + +function Collection:unselectItem() 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 Table:onOnRowSelect(self, func) end +function Collection:onOnSelect(self, func) end ----Gets the value of the ScrollBarSymbol property. ----@param self Table self ----@return string " " Symbol used for the scrollbar handle -function Table:getScrollBarSymbol(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 - ----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 - ----Removes a row by index ----@param rowIndex number The index of the row to remove ----@return Table self The Table instance -function Table:removeRow(rowIndex) end - ----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:mouse_drag() end - ----Updates a specific cell value ----@param rowIndex number The row index ----@param colIndex number The column index ----@param value any The new value ----@return Table self The Table instance -function Table:updateCell(rowIndex, colIndex, value) end - ----Gets the value of the SortColumn property. ----@param self Table self ----@return number ? nil Currently sorted column index -function Table:getSortColumn(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 - ----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 ScrollBarSymbol property. ----@param self Table self ----@param ScrollBarSymbol string " Symbol used for the scrollbar handle -function Table:setScrollBarSymbol(self, ScrollBarSymbol) end - ----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 - ----Registers callback for row selection ----@param callback function The callback function(rowIndex, row) ----@return Table self The Table instance -function Table:onRowSelect(callback) end - ----Gets the value of the ScrollBarColor property. ----@param self Table self ----@return color lightGray Color of the scrollbar handle -function Table:getScrollBarColor(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 - ----Clears all table data ----@return Table self The Table instance -function Table:clearData() end - ----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:mouse_scroll() end - ----Sets the value of the ShowScrollBar property. ----@param self Table self ----@param ShowScrollBar boolean Whether to show the scrollbar when items exceed height -function Table:setShowScrollBar(self, ShowScrollBar) 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 - ----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:mouse_click() 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:sortByColumn(columnIndex, fn) end - ----Gets the value of the ShowScrollBar property. ----@param self Table self ----@return boolean true Whether to show the scrollbar when items exceed height -function Table:getShowScrollBar(self) end - ----Gets the value of the ScrollBarBackgroundColor property. ----@param self Table self ----@return color gray Background color of the scrollbar -function Table:getScrollBarBackgroundColor(self) end - ----Gets the value of the ScrollBarBackground property. ----@param self Table self ----@return string "\127" Symbol used for the scrollbar background -function Table:getScrollBarBackground(self) 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 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 Offset property. ----@param self Table self ----@param Offset number Scroll offset for vertical scrolling -function Table:setOffset(self, Offset) end - ----Gets the value of the Offset property. ----@param self Table self ----@return number 0 Scroll offset for vertical scrolling -function Table:getOffset(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:mouse_up() 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 - ----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 - ----@class BigFontText -local BigFontText = {} - ----@class Toast : VisualElement ----@field colorMap table of toast types to their colors ----@field title string The title text of the toast ----@field autoHide boolean Whether the toast should automatically hide after duration ----@field active boolean Whether the toast is currently showing a message ----@field toastType string Type of toast: default, success, error, warning, info ----@field message string The message text of the toast ----@field duration number Duration in seconds before the toast auto-hides -local Toast = {} - ----Shows an error toast ----@param titleOrMessage string The title or message ----@return Toast self The Toast instance -function Toast:error(titleOrMessage) end - ----Sets the value of the ColorMap property. ----@param self Toast self ----@param ColorMap table of toast types to their colors -function Toast:setColorMap(self, ColorMap) end - ----Sets the value of the ToastType property. ----@param self Toast self ----@param ToastType string Type of toast: default, success, error, warning, info -function Toast:setToastType(self, ToastType) end - ----Gets the value of the ColorMap property. ----@param self Toast self ----@return table Map of toast types to their colors -function Toast:getColorMap(self) end - ----Sets the value of the Active property. ----@param self Toast self ----@param Active boolean Whether the toast is currently showing a message -function Toast:setActive(self, Active) end - ----Gets the value of the Message property. ----@param self Toast self ----@return string "" The message text of the toast -function Toast:getMessage(self) end - ----Gets the value of the Duration property. ----@param self Toast self ----@return number 3 Duration in seconds before the toast auto-hides -function Toast:getDuration(self) end - ----Hides the toast ----@return Toast self The Toast instance -function Toast:hide() end - ----Renders the toast ----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 Toast:render() end - ----Gets the value of the Active property. ----@param self Toast self ----@return boolean false Whether the toast is currently showing a message -function Toast:getActive(self) end - ----Shows an info toast ----@param titleOrMessage string The title or message ----@return Toast self The Toast instance -function Toast:info(titleOrMessage) end - ----Shows a warning toast ----@param titleOrMessage string The title or message ----@return Toast self The Toast instance -function Toast:warning(titleOrMessage) end - ----Sets the value of the Title property. ----@param self Toast self ----@param Title string The title text of the toast -function Toast:setTitle(self, Title) end - ----Sets the value of the AutoHide property. ----@param self Toast self ----@param AutoHide boolean Whether the toast should automatically hide after duration -function Toast:setAutoHide(self, AutoHide) end - ----Gets the value of the Title property. ----@param self Toast self ----@return string "" The title text of the toast -function Toast:getTitle(self) end - ----Gets the value of the ToastType property. ----@param self Toast self ----@return string "default" Type of toast: default, success, error, warning, info -function Toast:getToastType(self) end - ----Sets the value of the Duration property. ----@param self Toast self ----@param Duration number Duration in seconds before the toast auto-hides -function Toast:setDuration(self, Duration) end - ----Shows a toast message ----@param titleOrMessage string The title (if message provided) or the message (if no message) ----@return Toast self The Toast instance -function Toast:show(titleOrMessage) end - ----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 Toast:dispatchEvent() end - ----Shows a success toast ----@param titleOrMessage string The title or message ----@return Toast self The Toast instance -function Toast:success(titleOrMessage) end - ----Sets the value of the Message property. ----@param self Toast self ----@param Message string The message text of the toast -function Toast:setMessage(self, Message) end - ----Gets the value of the AutoHide property. ----@param self Toast self ----@return boolean true Whether the toast should automatically hide after duration -function Toast:getAutoHide(self) end - ----@class VisualElement : BaseElement ----@field backgroundEnabled boolean Whether to render the background ----@field width number The width of the element ----@field foreground color The text/foreground color ----@field borderTop boolean Draw top border ----@field height number The height of the element ----@field background color The background color ----@field borderColor color Border color ----@field z number The z-index for layering elements ----@field x number The horizontal position relative to parent ----@field borderBottom boolean Draw bottom border ----@field borderLeft boolean Draw left border ----@field y number The vertical position relative to parent ----@field borderRight boolean Draw right border ----@field visible boolean Whether the element is visible ----@field ignoreOffset boolean Whether to ignore the parent's offset ----@field layoutConfig table Configuration for layout systems (grow, shrink, alignSelf, etc.) -local VisualElement = {} - ----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 - ----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 - ----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 - ----Aligns the element's bottom edge to its parent's bottom edge with optional gap ----@return VisualElement self -function VisualElement:toBottom() end - ----Gets the value of the BorderRight property. ----@param self VisualElement self ----@return boolean false Draw right border -function VisualElement:getBorderRight(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 - ----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 - ----Sets the value of the BorderBottom property. ----@param self VisualElement self ----@param BorderBottom boolean Draw bottom border -function VisualElement:setBorderBottom(self, BorderBottom) end - ----Updates a single property in the layoutConfig table ----@param key string The layout config property to update (grow, shrink, basis, alignSelf, order, etc.) ----@param value any The value to set for the property ----@return VisualElement self The element instance -function VisualElement:setLayoutConfigProperty(key, value) 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 - ----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 - -function VisualElement:drawBg() 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 LayoutConfig property. ----@param self VisualElement self ----@return table {} Configuration for layout systems (grow, shrink, alignSelf, etc.) -function VisualElement:getLayoutConfig(self) end - ----Sets the value of the LayoutConfig property. ----@param self VisualElement self ----@param LayoutConfig table Configuration for layout systems (grow, shrink, alignSelf, etc.) -function VisualElement:setLayoutConfig(self, LayoutConfig) 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 - ----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 - ----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 - -function VisualElement:drawFg() 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 BorderRight property. ----@param self VisualElement self ----@param BorderRight boolean Draw right border -function VisualElement:setBorderRight(self, BorderRight) 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 IgnoreOffset property. ----@param self VisualElement self ----@param IgnoreOffset boolean Whether to ignore the parent's offset -function VisualElement:setIgnoreOffset(self, IgnoreOffset) end - ----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 fg color The foreground color ----@protected -function VisualElement:textFg(x, y, text, fg) 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 - ----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 - ----Convenience to stop animations from the element -function VisualElement.stopAnimation() end - ----Aligns the element's top edge to its parent's top edge with optional gap ----@return VisualElement self -function VisualElement:toTop() end - ----Gets a single property from the layoutConfig table ----@param key string The layout config property to get ----@return any value The value of the property, or nil if not set -function VisualElement:getLayoutConfigProperty(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 char string The character that was pressed ----@protected -function VisualElement: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 props table The properties to initialize the element with ----@param basalt table The basalt instance ----@protected -function VisualElement:init(props, basalt) 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 - ----Gets the value of the Width property. ----@param self VisualElement self ----@return number 1 The width of the element -function VisualElement:getWidth(self) 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 - ----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 - ----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 - ----Gets whether this element is focused ----@return boolean isFocused -function VisualElement:isFocused() 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 - ----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:blur() 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 - ----Resolves all constraints for the element ----@return VisualElement self The element instance -function VisualElement:resolveAllConstraints() 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 - ----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 - ----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 BorderBottom property. ----@param self VisualElement self ----@return boolean false Draw bottom border -function VisualElement:getBorderBottom(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 - ----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 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 - ----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 - ----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. ----@param key number The key that was pressed ----@protected -function VisualElement:key(key) 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 - ----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 - ----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 - ----Registers a function to handle the onClickUp event. ----@param self VisualElement self ----@param func function The function to be called when the event fires -function VisualElement:onOnClickUp(self, func) 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 - ----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 BackgroundEnabled property. ----@param self VisualElement self ----@return boolean true Whether to render the background -function VisualElement:getBackgroundEnabled(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 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 - ----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 - ----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 - ----Gets the value of the BorderTop property. ----@param self VisualElement self ----@return boolean false Draw top border -function VisualElement:getBorderTop(self) 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 - ----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 - ----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 Foreground property. ----@param self VisualElement self ----@return color white The text/foreground color -function VisualElement:getForeground(self) end - ----Removes the previously added border (if any) ----@return VisualElement self -function VisualElement:removeBorder() end - ----Sets the value of the BorderLeft property. ----@param self VisualElement self ----@param BorderLeft boolean Draw left border -function VisualElement:setBorderLeft(self, BorderLeft) 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 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 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 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 - ----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 - ----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 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 - ----Sets or removes focus from this element ----@param focused boolean Whether to focus or blur ----@return VisualElement self -function VisualElement:setFocused(focused) end - ----Aligns the element's left edge to its parent's left edge with optional gap ----@return VisualElement self -function VisualElement:toLeft() end - ----Stretches the element to fill its parent's width and height with optional margin ----@return VisualElement self -function VisualElement:fillParent() end - ----Adds or updates a drawable character border around the element. 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 - ----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 - ----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 Visible property. ----@param self VisualElement self ----@return boolean true Whether the element is visible -function VisualElement:getVisible(self) 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 - ----Updates all constraints, recalculating positions and sizes ----@return VisualElement self The element instance -function VisualElement:updateConstraints() end - ----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 - -function VisualElement:destroy() 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 - ----Stretches the element to fill its parent's width with optional margin ----@return VisualElement self -function VisualElement:fillWidth() 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. ----@protected -function VisualElement:render() 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 - ----Aligns the element's right edge to its parent's right edge with optional gap ----@return VisualElement self -function VisualElement:toRight() end - ----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 width number The width of the area to draw ----@param height number The height of the area to draw ----@param text string The text to draw ----@param fg string The foreground color ----@param bg string The background color ----@protected -function VisualElement:multiBlit(x, y, width, height, text, fg, bg) end - ----Centers the element within its parent both horizontally and vertically ----@return VisualElement self -function VisualElement:center() 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 - ----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 fg string The foreground color ----@param bg string The background color ----@protected -function VisualElement: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 click ----@param y number The y position of the click ----@return boolean clicked Whether the element was clicked ----@protected -function VisualElement: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 ----@protected -function VisualElement: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 key number The key that was released ----@protected -function VisualElement:key_up(key) end - ----Gets the value of the Background property. ----@param self VisualElement self ----@return color black The background color -function VisualElement:getBackground(self) end - ----Gets the value of the BorderColor property. ----@param self VisualElement self ----@return color white Border color -function VisualElement:getBorderColor(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 - ----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 - -function VisualElement:drawText() end - ----Stretches the element to fill its parent's height with optional margin ----@return VisualElement self -function VisualElement:fillHeight() end - ----Creates a new Animation Object ----@return Animation animation The new animation -function VisualElement:animate() end - ----Gets the value of the BorderLeft property. ----@param self VisualElement self ----@return boolean false Draw left border -function VisualElement:getBorderLeft(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 ----@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 - ----@class Input : VisualElement ----@field viewOffset number The horizontal scroll offset for viewing long text ----@field text string The current text content of the input ----@field pattern string nil Regular expression pattern for input validation ----@field placeholderColor color Color of the placeholder text ----@field cursorPos number The current cursor position in the text ----@field replaceChar string Character to replace the input with (for password fields) ----@field placeholder string Text to display when input is empty ----@field cursorColor number Color of the cursor ----@field maxLength number nil Maximum length of input text (optional) -local Input = {} - ----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 - ----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 - ----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 - ----Gets the value of the CursorColor property. ----@param self Input self ----@return number nil Color of the cursor -function Input:getCursorColor(self) 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 Placeholder property. ----@param self Input self ----@return string ... Text to display when input is empty -function Input:getPlaceholder(self) 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 - ----Gets the value of the PlaceholderColor property. ----@param self Input self ----@return color gray Color of the placeholder text -function Input:getPlaceholderColor(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. ----@protected -function Input:paste() 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 - ----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 - ----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 - ----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 - ----Updates the input's viewport ----@return Input self The updated instance -function Input:updateViewport() 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 - ----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 ViewOffset property. ----@param self Input self ----@return number 0 The horizontal scroll offset for viewing long text -function Input:getViewOffset(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 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. ----@param key number The key that was pressed ----@return boolean handled Whether the event was handled ----@protected -function Input:key(key) 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 - ----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 Input self The initialized instance ----@protected -function Input:init(props, basalt) 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 Text property. ----@param self Input self ----@return string - The current text content of the input -function Input:getText(self) 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 - ----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 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 PlaceholderColor property. ----@param self Input self ----@param PlaceholderColor color Color of the placeholder text -function Input:setPlaceholderColor(self, PlaceholderColor) end - ----@class Tree : VisualElement ----@field offset number Current vertical scroll position ----@field nodes table The tree structure containing node objects with {text, children} properties ----@field scrollBarBackground string Symbol used for the scrollbar background ----@field horizontalOffset number Current horizontal scroll position ----@field selectedForegroundColor color foreground color of selected node ----@field scrollBarBackgroundColor color Background color of the scrollbar ----@field selectedNode table nil Currently selected node ----@field showScrollBar boolean Whether to show the scrollbar when nodes exceed height ----@field scrollBarSymbol string " Symbol used for the scrollbar handle ----@field selectedBackgroundColor color background color of selected node ----@field scrollBarColor color Color of the scrollbar handle ----@field expandedNodes table Table of nodes that are currently expanded -local Tree = {} - ----Gets the value of the ScrollBarBackgroundColor property. ----@param self Tree self ----@return color gray Background color of the scrollbar -function Tree:getScrollBarBackgroundColor(self) end - ----Gets the value of the ShowScrollBar property. ----@param self Tree self ----@return boolean true Whether to show the scrollbar when nodes exceed height -function Tree:getShowScrollBar(self) end - ----Sets the value of the ScrollBarBackgroundColor property. ----@param self Tree self ----@param ScrollBarBackgroundColor color Background color of the scrollbar -function Tree:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) 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 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 - ----Gets the value of the HorizontalOffset property. ----@param self Tree self ----@return number 0 Current horizontal scroll position -function Tree:getHorizontalOffset(self) end - ----Sets the value of the ShowScrollBar property. ----@param self Tree self ----@param ShowScrollBar boolean Whether to show the scrollbar when nodes exceed height -function Tree:setShowScrollBar(self, ShowScrollBar) 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 ScrollBarColor property. ----@param self Tree self ----@param ScrollBarColor color Color of the scrollbar handle -function Tree:setScrollBarColor(self, ScrollBarColor) end - ----Sets the value of the ScrollBarBackground property. ----@param self Tree self ----@param ScrollBarBackground string Symbol used for the scrollbar background -function Tree:setScrollBarBackground(self, ScrollBarBackground) 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 - ----Sets the value of the Offset property. ----@param self Tree self ----@param Offset number Current vertical scroll position -function Tree:setOffset(self, Offset) end - ----Gets the value of the ScrollBarSymbol property. ----@param self Tree self ----@return string " " Symbol used for the scrollbar handle -function Tree:getScrollBarSymbol(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 SelectedBackgroundColor property. ----@param self Tree self ----@param SelectedBackgroundColor color background color of selected node -function Tree:setSelectedBackgroundColor(self, SelectedBackgroundColor) 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 - ----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-coordinate of the drag ----@param y number The y-coordinate of the drag ----@return boolean Whether the event was handled ----@protected -function Tree:mouse_drag(button, x, y) end - ----Gets the value of the Offset property. ----@param self Tree self ----@return number 0 Current vertical scroll position -function Tree:getOffset(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 - ----Gets the value of the ScrollBarColor property. ----@param self Tree self ----@return color lightGray Color of the scrollbar handle -function Tree:getScrollBarColor(self) end - ----Gets the value of the ScrollBarBackground property. ----@param self Tree self ----@return string "\127" Symbol used for the scrollbar background -function Tree:getScrollBarBackground(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 - ----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 - ----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 value of the SelectedNode property. ----@param self Tree self ----@return table ? nil Currently selected node -function Tree:getSelectedNode(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 ----@protected -function Tree:mouse_scroll(direction, x, y) end - ----Sets the value of the ScrollBarSymbol property. ----@param self Tree self ----@param ScrollBarSymbol string " Symbol used for the scrollbar handle -function Tree:setScrollBarSymbol(self, ScrollBarSymbol) 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 - ----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 - ----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-coordinate of the release ----@param y number The y-coordinate of the release ----@return boolean Whether the event was handled ----@protected -function Tree:mouse_up(button, x, y) 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 - ----Sets the value of the HorizontalOffset property. ----@param self Tree self ----@param HorizontalOffset number Current horizontal scroll position -function Tree:setHorizontalOffset(self, HorizontalOffset) end - ----Collapses a node ----@param node table The node to collapse ----@return Tree self The Tree instance -function Tree:collapseNode(node) end - ----@class CheckBox : VisualElement ----@field autoSize boolean Automatically adjusts width based on text length ----@field checkedText string Text shown when the checkbox is checked ----@field text string Text shown when the checkbox is unchecked ----@field checked boolean The current state of the checkbox (true=checked, false=unchecked) -local CheckBox = {} - ----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 - ----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 - ----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 - ----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 Text property. ----@param self CheckBox self ----@param Text string Text shown when the checkbox is unchecked -function CheckBox:setText(self, 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. ----@return CheckBox self The created instance ----@protected -function CheckBox.new() 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 - ----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 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 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 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 - ----@class Slider : VisualElement ----@field barColor color Color of the slider track ----@field sliderColor color Color of the slider handle ----@field max number Maximum value for value conversion (maps slider position to this range) ----@field horizontal boolean Whether the slider is horizontal (false for vertical) ----@field step number Current position of the slider handle (1 to width/height) -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 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 - ----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 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 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 - ----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 - ----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 - ----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 current value of the slider ----@return number value The current value (0 to max) -function Slider:getValue() 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 - ----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 SliderColor property. ----@param self Slider self ----@return color blue Color of the slider handle -function Slider:getSliderColor(self) 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 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 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 BarColor property. ----@param self Slider self ----@return color gray Color of the slider track -function Slider:getBarColor(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 - ----@class ComboBox : DropDown ----@field viewOffset number Horizontal scroll position for viewing long text ----@field editable boolean Enables direct text input in the field ----@field text string The current text value of the input field ----@field cursorPos number Current cursor position in the text input ----@field autoComplete boolean Enables filtering dropdown items while typing ----@field manuallyOpened boolean Indicates if dropdown was opened by user action -local ComboBox = {} - ----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 - ----Handles mouse up events for item selection ----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-coordinate of the release ----@param y number The y-coordinate of the release ----@return boolean handled Whether the event was handled ----@protected -function ComboBox:mouse_up(button, x, y) 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 - ----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 - ----Handles character input when editable ----@param char string The character that was typed -function ComboBox:char(char) end - ----Creates a new ComboBox instance ----@return ComboBox self The newly created ComboBox instance -function ComboBox.new() end - ----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 ManuallyOpened property. ----@param self ComboBox self ----@return boolean false Indicates if dropdown was opened by user action -function ComboBox:getManuallyOpened(self) 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 - ----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 - ----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 - ----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 ViewOffset property. ----@param self ComboBox self ----@return number 0 Horizontal scroll position for viewing long text -function ComboBox:getViewOffset(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 - ----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 - ----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 AutoComplete property. ----@param self ComboBox self ----@return boolean false Enables filtering dropdown items while typing -function ComboBox:getAutoComplete(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 ComboBox self The initialized instance ----@protected -function ComboBox:init(props, basalt) 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 - ----@class Container : VisualElement ----@field visibleChildren table Currently visible child elements (calculated based on viewport) ----@field offsetX number Horizontal scroll/content offset ----@field offsetY number Vertical scroll/content offset ----@field childrenEvents table Registered event handlers for all children ----@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 children table Collection of all child elements ----@field focusedChild table Currently focused child element (receives keyboard events) ----@field childrenSorted boolean Indicates if children are sorted by z-index -local Container = {} - -function Container:drawBg() 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 - ----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 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 - ----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 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 - ----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 - ----Updates the current layout (recalculates positions) ----@return Container self For method chaining -function Container:updateLayout() 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 - ----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 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 - ----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 - ----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 Breadcrumb element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return Breadcrumb element A new Breadcrumb element. -function Container:addBreadcrumb(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_drag(button, x, y) 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 - ----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 - ----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 - ----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 - ----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 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 Dialog element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return Dialog element A new Dialog element. -function Container:addDialog(self, props) 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 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 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 - ----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 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 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 - ----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 event string The event to handle ----@return boolean handled Whether the event was handled ----@protected -function Container:handleEvent(event) 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 - ----Gets the value of the OffsetX property. ----@param self Container self ----@return number 0 Horizontal scroll/content offset -function Container:getOffsetX(self) 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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 Toast element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return Toast element A new Toast element. -function Container:addToast(self, props) end - -function Container:drawFg() 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 - ----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 - ----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 - ----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 - ----Sets the value of the OffsetY property. ----@param self Container self ----@param OffsetY number Vertical scroll/content offset -function Container:setOffsetY(self, OffsetY) 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 - ----Re-sorts children by their z-index and updates visibility ----@return Container self For method chaining -function Container:sortChildren() 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 - ----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 - ----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 - ----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 - ----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 ContextMenu element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return ContextMenu element A new ContextMenu element. -function Container:addContextMenu(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 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 - ----Gets the value of the OffsetY property. ----@param self Container self ----@return number 0 Vertical scroll/content offset -function Container:getOffsetY(self) 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 - ----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 - ----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 - ----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 - ----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 - ----Removes the current layout ----@return Container self For method chaining -function Container:clearLayout() end - ----Creates a new ScrollFrame element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return ScrollFrame element A new ScrollFrame element. -function Container:addScrollFrame(self, props) 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 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 - ----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 Accordion element. ----@param self Container self ----@param props? table Optional: properties for the element. ----@return Accordion element A new Accordion element. -function Container:addAccordion(self, props) end - ----Removes all child elements and resets the container's state ----@return Container self For method chaining -function Container:clear() end - ----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 _ 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 - ----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 Children property. ----@param self Container self ----@return table {} Collection of all child elements -function Container:getChildren(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 - ----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 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 - ----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 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 - ----Applies a layout from a file to this container ----@param layoutPath string Path to the layout file (e.g. "layouts/grid") ----@return Container self For method chaining -function Container:applyLayout(layoutPath) end - -function Container:drawText() 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 - ----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 - ----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 - ----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 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 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 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 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 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 - ----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 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 - ----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 - ----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 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 - ----@class Image : VisualElement ----@field offsetX number Horizontal offset for viewing larger images ----@field autoResize boolean Whether to automatically resize the image when content exceeds bounds ----@field offsetY number Vertical offset for viewing larger images ----@field bimg table The bimg image data ----@field currentFrame number Current animation frame -local Image = {} - ----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 OffsetY property. ----@param self Image self ----@return number 0 Vertical offset for viewing larger images -function Image:getOffsetY(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 specified frame ----@param frameIndex number The index of the frame to get ----@return table frame The frame data -function Image:getFrame(frameIndex) 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 OffsetX property. ----@param self Image self ----@param OffsetX number Horizontal offset for viewing larger images -function Image:setOffsetX(self, OffsetX) 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 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 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 - ----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 value of the OffsetX property. ----@param self Image self ----@return number 0 Horizontal offset for viewing larger images -function Image:getOffsetX(self) 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 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 - ----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 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 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 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 - ----Sets the value of the Bimg property. ----@param self Image self ----@param Bimg table The bimg image data -function Image:setBimg(self, Bimg) 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 - ----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 - ----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 CurrentFrame property. ----@param self Image self ----@param CurrentFrame number Current animation frame -function Image:setCurrentFrame(self, CurrentFrame) 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 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 Bimg property. ----@param self Image self ----@return table {} The bimg image data -function Image:getBimg(self) 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 - ----@class ScrollFrame : Container ----@field scrollBarBackgroundColor color Background color of the scrollbar ----@field contentHeight number The total height of the content (calculated from children) ----@field scrollBarSymbol string The symbol used for the scrollbar handle ----@field showScrollBar boolean Whether to show scrollbars ----@field scrollBarBackgroundSymbol string The symbol used for the scrollbar background ----@field scrollBarBackgroundColor2 secondary black Background color of the scrollbar ----@field scrollBarColor color Color of the scrollbar handle ----@field contentWidth number The total width of the content (calculated from children) -local ScrollFrame = {} - ----Handles mouse click events for scrollbars and content ----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 Whether the event was handled ----@protected -function ScrollFrame:mouse_click(button, x, y) end - ----Sets the value of the ShowScrollBar property. ----@param self ScrollFrame self ----@param ShowScrollBar boolean Whether to show scrollbars -function ScrollFrame:setShowScrollBar(self, ShowScrollBar) end - ----Gets the value of the ScrollBarBackgroundColor2 property. ----@param self ScrollFrame self ----@return secondary color black Background color of the scrollbar -function ScrollFrame:getScrollBarBackgroundColor2(self) end - ----Gets the value of the ShowScrollBar property. ----@param self ScrollFrame self ----@return boolean true Whether to show scrollbars -function ScrollFrame:getShowScrollBar(self) end - ----Handles mouse scroll 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 direction number 1 for up, -1 for down ----@param x number Mouse x position relative to element ----@param y number Mouse y position relative to element ----@return boolean Whether the event was handled ----@protected -function ScrollFrame:mouse_scroll(direction, x, y) end - ----Sets the value of the ScrollBarColor property. ----@param self ScrollFrame self ----@param ScrollBarColor color Color of the scrollbar handle -function ScrollFrame:setScrollBarColor(self, ScrollBarColor) end - ----Gets the value of the ContentHeight property. ----@param self ScrollFrame self ----@return number 0 The total height of the content (calculated from children) -function ScrollFrame:getContentHeight(self) end - ----Gets the value of the ScrollBarBackgroundColor property. ----@param self ScrollFrame self ----@return color gray Background color of the scrollbar -function ScrollFrame:getScrollBarBackgroundColor(self) end - ----Gets the value of the ContentWidth property. ----@param self ScrollFrame self ----@return number 0 The total width of the content (calculated from children) -function ScrollFrame:getContentWidth(self) end - ----Renders the ScrollFrame and its scrollbars ----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 ScrollFrame:render() end - ----Handles mouse up events to stop scrollbar dragging ----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-coordinate of the release ----@param y number The y-coordinate of the release ----@return boolean Whether the event was handled ----@protected -function ScrollFrame:mouse_up(button, x, y) end - ----Handles mouse drag events for scrollbar ----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-coordinate of the drag ----@param y number The y-coordinate of the drag ----@return boolean Whether the event was handled ----@protected -function ScrollFrame:mouse_drag(button, x, y) end - ----Sets the value of the ContentHeight property. ----@param self ScrollFrame self ----@param ContentHeight number The total height of the content (calculated from children) -function ScrollFrame:setContentHeight(self, ContentHeight) end - ----Gets the value of the ScrollBarSymbol property. ----@param self ScrollFrame self ----@return string "_" The symbol used for the scrollbar handle -function ScrollFrame:getScrollBarSymbol(self) end - ----Sets the value of the ScrollBarBackgroundColor property. ----@param self ScrollFrame self ----@param ScrollBarBackgroundColor color Background color of the scrollbar -function ScrollFrame:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end - ----Gets the value of the ScrollBarBackgroundSymbol property. ----@param self ScrollFrame self ----@return string "\127" The symbol used for the scrollbar background -function ScrollFrame:getScrollBarBackgroundSymbol(self) end - ----Sets the value of the ScrollBarBackgroundSymbol property. ----@param self ScrollFrame self ----@param ScrollBarBackgroundSymbol string The symbol used for the scrollbar background -function ScrollFrame:setScrollBarBackgroundSymbol(self, ScrollBarBackgroundSymbol) end - ----Gets the value of the ScrollBarColor property. ----@param self ScrollFrame self ----@return color lightGray Color of the scrollbar handle -function ScrollFrame:getScrollBarColor(self) end - ----Sets the value of the ScrollBarBackgroundColor2 property. ----@param self ScrollFrame self ----@param ScrollBarBackgroundColor2 secondary black Background color of the scrollbar -function ScrollFrame:setScrollBarBackgroundColor2(self, ScrollBarBackgroundColor2) end - ----Sets the value of the ContentWidth property. ----@param self ScrollFrame self ----@param ContentWidth number The total width of the content (calculated from children) -function ScrollFrame:setContentWidth(self, ContentWidth) end - ----Sets the value of the ScrollBarSymbol property. ----@param self ScrollFrame self ----@param ScrollBarSymbol string The symbol used for the scrollbar handle -function ScrollFrame:setScrollBarSymbol(self, ScrollBarSymbol) end - ----@class Timer : BaseElement ----@field amount number The amount of time the timer should run. ----@field action function The action to be performed when the timer triggers. ----@field running boolean Indicates whether the timer is currently running or not. ----@field interval number The interval in seconds at which the timer will trigger its action. -local Timer = {} - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----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 - ----@class Log -local Log = {} - ----Sets if the logger should log -function Log.setEnabled() end - ----Sets if the logger should log to a file. -function Log.setLogToFile() end - ----Sends an error message to the logger. -function Log.error() end - ----Sends an info message to the logger. -function Log.info() end - ----Sends a warning message to the logger. -function Log.warn() end - ----Sends a debug message to the logger. -function Log.debug() end - ----@class Switch : VisualElement ----@field offBackground number color when OFF ----@field text string to display next to switch ----@field checked boolean switch is checked ----@field onBackground number color when ON ----@field autoSize boolean to automatically size the element to fit switch and text -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. ----@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. ----@protected -function Switch:render() 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 - ----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 - ----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 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 - ----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 Text property. ----@param self Switch self ----@param Text string to display next to switch -function Switch:setText(self, Text) 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 - ----Sets the value of the Checked property. ----@param self Switch self ----@param Checked boolean switch is checked -function Switch:setChecked(self, Checked) end - ----Sets the value of the OffBackground property. ----@param self Switch self ----@param OffBackground number color when OFF -function Switch:setOffBackground(self, OffBackground) end - ----@class TextBox : VisualElement ----@field cursorY number Cursor Y position (line number) ----@field scrollY number Vertical scroll offset ----@field autoPairEnabled boolean Whether automatic bracket/quote pairing is enabled ----@field cursorX number Cursor X position ----@field autoCompleteMaxItems number Maximum number of visible suggestions ----@field autoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately ----@field cursorColor number Color of the cursor ----@field syntaxPatterns table Syntax highlighting patterns ----@field autoCompleteSelectedBackground color Background color for the selected suggestion ----@field autoCompleteShowBorder boolean Whether to render a character border around the popup ----@field autoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor ----@field autoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox ----@field autoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion ----@field autoCompleteProvider function Optional suggestion provider returning a list for the current prefix ----@field autoCompleteZOffset number Z-index offset applied to the popup frame ----@field lines table Array of text lines ----@field autoCompleteTokenPattern string Pattern used to extract the current token for suggestions ----@field autoCompleteForeground color Foreground color of the suggestion popup ----@field autoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup ----@field autoCompleteEnabled boolean Whether autocomplete suggestions are enabled ----@field autoCompleteItems table List of suggestions used when no provider is supplied ----@field scrollX number Horizontal scroll offset ----@field autoCompleteMinChars number Minimum characters required before showing suggestions ----@field autoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned ----@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 autoCompleteBackground color Background color of the suggestion popup ----@field autoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively ----@field autoCompleteSelectedForeground color Foreground color for the selected suggestion ----@field autoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width) ----@field autoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing ----@field autoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge -local TextBox = {} - ----Sets the text of the TextBox ----@param text string The text to set ----@return TextBox self The TextBox instance -function TextBox:setText(text) end - ----Gets the value of the CursorColor property. ----@param self TextBox self ----@return number nil Color of the cursor -function TextBox:getCursorColor(self) 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 - ----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 AutoCompleteMinChars property. ----@param self TextBox self ----@param AutoCompleteMinChars number Minimum characters required before showing suggestions -function TextBox:setAutoCompleteMinChars(self, AutoCompleteMinChars) 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 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 AutoCompleteItems property. ----@param self TextBox self ----@param AutoCompleteItems table List of suggestions used when no provider is supplied -function TextBox:setAutoCompleteItems(self, AutoCompleteItems) 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 - ----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 AutoCompleteZOffset property. ----@param self TextBox self ----@return number 1 Z-index offset applied to the popup frame -function TextBox:getAutoCompleteZOffset(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 key number The key that was pressed ----@return boolean handled Whether the event was handled ----@protected -function TextBox:key(key) 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 text of the TextBox ----@return string text The text of the TextBox -function TextBox:getText() end - ----Sets the value of the CursorX property. ----@param self TextBox self ----@param CursorX number Cursor X position -function TextBox:setCursorX(self, CursorX) 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 - ----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 SyntaxPatterns property. ----@param self TextBox self ----@return table {} Syntax highlighting patterns -function TextBox:getSyntaxPatterns(self) 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 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 - ----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 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 CursorY property. ----@param self TextBox self ----@return number 1 Cursor Y position (line number) -function TextBox:getCursorY(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 ScrollY property. ----@param self TextBox self ----@return number 0 Vertical scroll offset -function TextBox:getScrollY(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 - ----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 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 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 - -function TextBox:destroy() 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 - ----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 - ----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 AutoCompleteProvider property. ----@param self TextBox self ----@return function nil Optional suggestion provider returning a list for the current prefix -function TextBox:getAutoCompleteProvider(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 - ----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 ScrollX property. ----@param self TextBox self ----@param ScrollX number Horizontal scroll offset -function TextBox:setScrollX(self, ScrollX) 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 - ----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 Lines property. ----@param self TextBox self ----@param Lines table Array of text lines -function TextBox:setLines(self, Lines) end - ----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 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 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. ----@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 - ----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 - ----Clears all syntax highlighting patterns ----@return TextBox self -function TextBox:clearSyntaxPatterns() 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 - ----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 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 - ----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 AutoCompleteCloseOnEscape property. ----@param self TextBox self ----@return boolean true Whether pressing Escape closes the popup -function TextBox:getAutoCompleteCloseOnEscape(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 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 SyntaxPatterns property. ----@param self TextBox self ----@param SyntaxPatterns table Syntax highlighting patterns -function TextBox:setSyntaxPatterns(self, SyntaxPatterns) 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 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 AutoPairEnabled property. ----@param self TextBox self ----@param AutoPairEnabled boolean Whether automatic bracket/quote pairing is enabled -function TextBox:setAutoPairEnabled(self, AutoPairEnabled) 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 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 - ----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 - ----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 - ----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 AutoCompleteMinChars property. ----@param self TextBox self ----@return number 1 Minimum characters required before showing suggestions -function TextBox:getAutoCompleteMinChars(self) 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 AutoCompleteTokenPattern property. ----@param self TextBox self ----@return string "[%w_]+" Pattern used to extract the current token for suggestions -function TextBox:getAutoCompleteTokenPattern(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 TextBox:mouse_scroll(direction, x, y) 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 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 AutoCompleteCaseInsensitive property. ----@param self TextBox self ----@return boolean true Whether suggestions should match case-insensitively -function TextBox:getAutoCompleteCaseInsensitive(self) end - ----Gets the value of the ScrollX property. ----@param self TextBox self ----@return number 0 Horizontal scroll offset -function TextBox:getScrollX(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 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 CursorY property. ----@param self TextBox self ----@param CursorY number Cursor Y position (line number) -function TextBox:setCursorY(self, CursorY) 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 ScrollY property. ----@param self TextBox self ----@param ScrollY number Vertical scroll offset -function TextBox:setScrollY(self, ScrollY) 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 - ----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 AutoCompleteSelectedForeground property. ----@param self TextBox self ----@return color white Foreground color for the selected suggestion -function TextBox:getAutoCompleteSelectedForeground(self) end - ----@class SideNav : Container ----@field tabs table List of navigation item definitions ----@field sidebarWidth number Width of the sidebar navigation area ----@field sidebarBackground color Background color for the sidebar area ----@field activeTab number The currently active navigation item ID ----@field sidebarScrollOffset number Current scroll offset for navigation items in scrollable mode ----@field activeTabTextColor color Foreground color for the active navigation item text ----@field sidebarPosition string Position of the sidebar ("left" or "right") ----@field activeTabBackground color Background color for the active navigation item -local SideNav = {} - ----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 SidebarBackground property. ----@param self SideNav self ----@param SidebarBackground color Background color for the sidebar area -function SideNav:setSidebarBackground(self, SidebarBackground) end - -function SideNav:drawFg() 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:mouse_scroll() 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 - ----Gets the value of the Tabs property. ----@param self SideNav self ----@return table {} List of navigation item definitions -function SideNav:getTabs(self) end - -function SideNav:multiBlit() 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 - -function SideNav:blit() end - -function SideNav:textFg() 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 - ----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:mouse_release() end - -function SideNav:mouse_drag() 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 - ----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 - ----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 - ----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 - ----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 SidebarBackground property. ----@param self SideNav self ----@return color gray Background color for the sidebar area -function SideNav:getSidebarBackground(self) 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 - -function SideNav:setCursor() end - -function SideNav:_getSidebarMetrics() 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_up() 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 - ----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:drawBg() 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. ----@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 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 SidebarWidth property. ----@param self SideNav self ----@return number 12 Width of the sidebar navigation area -function SideNav:getSidebarWidth(self) end - ----@param tabId number The ID of the navigation item to activate -function SideNav:setActiveTab(tabId) 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 - ----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 - ----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 - ----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 - ----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 - -function SideNav:getRelativePosition() end - ----@class ContextMenu : Container ----@field openSubmenu table Currently open submenu data ----@field itemHeight number Height of each menu item ----@field items table List of menu items ----@field isOpen boolean Whether the menu is currently open -local ContextMenu = {} - ----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 ContextMenu:render() end - ----Sets the menu items ----@param items table Array of item definitions ----@return ContextMenu self For method chaining -function ContextMenu:setItems(items) end - ----Gets the value of the Items property. ----@param self ContextMenu self ----@return table {} List of menu items -function ContextMenu:getItems(self) end - ----Gets the value of the IsOpen property. ----@param self ContextMenu self ----@return boolean false Whether the menu is currently open -function ContextMenu:getIsOpen(self) end - ----Opens the menu ----@return ContextMenu self For method chaining -function ContextMenu:open() end - ----Sets the value of the OpenSubmenu property. ----@param self ContextMenu self ----@param OpenSubmenu table Currently open submenu data -function ContextMenu:setOpenSubmenu(self, OpenSubmenu) end - ----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 ContextMenu:mouse_click() end - ----Sets the value of the ItemHeight property. ----@param self ContextMenu self ----@param ItemHeight number Height of each menu item -function ContextMenu:setItemHeight(self, ItemHeight) end - ----Closes the entire menu chain (parent and all submenus) ----@return ContextMenu self For method chaining -function ContextMenu:closeAll() end - ----Closes the menu and any submenus ----@return ContextMenu self For method chaining -function ContextMenu:close() end - ----Gets the value of the ItemHeight property. ----@param self ContextMenu self ----@return number 1 Height of each menu item -function ContextMenu:getItemHeight(self) end - ----Gets the value of the OpenSubmenu property. ----@param self ContextMenu self ----@return table nil Currently open submenu data -function ContextMenu:getOpenSubmenu(self) end - ----Sets the value of the IsOpen property. ----@param self ContextMenu self ----@param IsOpen boolean Whether the menu is currently open -function ContextMenu:setIsOpen(self, IsOpen) end - ----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 ContextMenu:init(props, basalt) end - ----@class ErrorHandler -local ErrorHandler = {} - ----Handles an error ----@param errMsg string The error message -function errorHandler.error(errMsg) end - ----@class Accordion : Container ----@field panelHeaderHeight number Height of each panel header ----@field expandedHeaderBackground color Background color for expanded panel headers ----@field headerBackground color Background color for panel headers ----@field allowMultiple boolean Allow multiple panels to be open at once ----@field expandedHeaderTextColor color Text color for expanded panel headers ----@field panels table List of panel definitions ----@field headerTextColor color Text color for panel headers -local Accordion = {} - ----Gets the value of the HeaderTextColor property. ----@param self Accordion self ----@return color white Text color for panel headers -function Accordion:getHeaderTextColor(self) end - ----Sets the value of the AllowMultiple property. ----@param self Accordion self ----@param AllowMultiple boolean Allow multiple panels to be open at once -function Accordion:setAllowMultiple(self, AllowMultiple) end - ----Gets the value of the PanelHeaderHeight property. ----@param self Accordion self ----@return number 1 Height of each panel header -function Accordion:getPanelHeaderHeight(self) end - ----@param panelId number The ID of the panel to expand ----@return Accordion self For method chaining -function Accordion:expandPanel(panelId) end - ----Sets the value of the ExpandedHeaderTextColor property. ----@param self Accordion self ----@param ExpandedHeaderTextColor color Text color for expanded panel headers -function Accordion:setExpandedHeaderTextColor(self, ExpandedHeaderTextColor) end - ----Sets the value of the PanelHeaderHeight property. ----@param self Accordion self ----@param PanelHeaderHeight number Height of each panel header -function Accordion:setPanelHeaderHeight(self, PanelHeaderHeight) end - ----Gets the value of the ExpandedHeaderBackground property. ----@param self Accordion self ----@return color lightGray Background color for expanded panel headers -function Accordion:getExpandedHeaderBackground(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 (global) ----@param y number The y position of the click (global) ----@return boolean Whether the event was handled ----@protected -function Accordion:mouse_click(button, x, y) end - ----Gets the value of the Panels property. ----@param self Accordion self ----@return table {} List of panel definitions -function Accordion:getPanels(self) end - -function Accordion:mouse_scroll() end - ----@param panelId number The ID of the panel ----@return table ? container The panel's container or nil -function Accordion:getPanel(panelId) end - ----Gets the value of the AllowMultiple property. ----@param self Accordion self ----@return boolean false Allow multiple panels to be open at once -function Accordion:getAllowMultiple(self) end - ----Gets the value of the HeaderBackground property. ----@param self Accordion self ----@return color gray Background color for panel headers -function Accordion:getHeaderBackground(self) end - ----Sets the value of the HeaderBackground property. ----@param self Accordion self ----@param HeaderBackground color Background color for panel headers -function Accordion:setHeaderBackground(self, HeaderBackground) end - ----@param panelId number The ID of the panel to collapse ----@return Accordion self For method chaining -function Accordion:collapsePanel(panelId) end - ----Sets the value of the HeaderTextColor property. ----@param self Accordion self ----@param HeaderTextColor color Text color for panel headers -function Accordion:setHeaderTextColor(self, HeaderTextColor) end - ----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 Accordion:init(props, basalt) end - ----@param panelId number The ID of the panel to toggle ----@return Accordion self For method chaining -function Accordion:togglePanel(panelId) end - ----Creates a new panel and returns the panel's container ----@param title string The title of the panel ----@param expanded boolean Whether the panel starts expanded (default: false) ----@return table panelContainer The container for this panel -function Accordion:newPanel(title, expanded) end - ----Sets the value of the Panels property. ----@param self Accordion self ----@param Panels table List of panel definitions -function Accordion:setPanels(self, Panels) end - ----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 Accordion:render() end - ----Sets the value of the ExpandedHeaderBackground property. ----@param self Accordion self ----@param ExpandedHeaderBackground color Background color for expanded panel headers -function Accordion:setExpandedHeaderBackground(self, ExpandedHeaderBackground) end - ----Gets the value of the ExpandedHeaderTextColor property. ----@param self Accordion self ----@return color black Text color for expanded panel headers -function Accordion:getExpandedHeaderTextColor(self) end - ----@class Menu : List ----@field spacing number The number of spaces between menu items ----@field maxWidth number Maximum width before scrolling is enabled (nil = auto-size to items) ----@field separatorColor color The color used for separator items in the menu ----@field horizontalOffset number Current horizontal scroll offset -local Menu = {} - ----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:mouse_click() end - ----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 Spacing property. ----@param self Menu self ----@return number 0 The number of spaces between menu items -function Menu:getSpacing(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:mouse_scroll() end - ----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 - ----Gets the value of the HorizontalOffset property. ----@param self Menu self ----@return number 0 Current horizontal scroll offset -function Menu:getHorizontalOffset(self) end - ----Sets the value of the MaxWidth property. ----@param self Menu self ----@param MaxWidth number Maximum width before scrolling is enabled (nil = auto-size to items) -function Menu:setMaxWidth(self, MaxWidth) 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 - ----Sets the value of the HorizontalOffset property. ----@param self Menu self ----@param HorizontalOffset number Current horizontal scroll offset -function Menu:setHorizontalOffset(self, HorizontalOffset) end - ----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 - ----Gets the value of the MaxWidth property. ----@param self Menu self ----@return number nil Maximum width before scrolling is enabled (nil = auto-size to items) -function Menu:getMaxWidth(self) end - ----Sets the value of the Spacing property. ----@param self Menu self ----@param Spacing number The number of spaces between menu items -function Menu:setSpacing(self, Spacing) end - ----Calculates the total width of all menu items with spacing ----@return number totalWidth The total width of all items -function Menu:getTotalWidth() end +---Gets the currently selected items +---@return table selected Collection of selected items +function Collection:getSelectedItems() end ---@class basalt local basalt = {} +---Starts the Basalt runtime +function basalt.run() end + ---Returns the error manager instance ---@return table ErrorManager The error manager function basalt.getErrorManager() end ----Creates and returns a new BaseFrame ----@return BaseFrame BaseFrame The created frame instance -function basalt.createFrame() end +---Returns the element manager instance +---@return table ElementManager The element manager +function basalt.getElementManager() end ----Sets a frame as focused ----@param frame BaseFrame The frame to set as focused -function basalt.setFocus(frame) end +---Configures the ElementManager (shortcut to elementManager.configure) +---@param config table Configuration options +function basalt.configure(config) end ----Starts the Basalt runtime -function basalt.run() 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 ----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 +---Sets the active frame +---@param frame BaseFrame The frame to set as active +function basalt.setActiveFrame(frame) 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 +---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 + +---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 + +---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 + +---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 + +---Sets a frame as focused +---@param frame BaseFrame The frame to set as focused +function basalt.setFocus(frame) 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 ----Returns the element manager instance ----@return table ElementManager The element manager -function basalt.getElementManager() end +---Runs basalt once, can be used to update the UI manually, but you have to feed it the events +function basalt.update() 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 + +---Triggers a custom event and calls all registered callbacks +---@param eventName string The name of the event to trigger +function basalt.triggerEvent(eventName) end ---Stops the Basalt runtime function basalt.stop() end @@ -4876,478 +1334,822 @@ function basalt.onEvent(eventName, callback) end ---@return BaseFrame BaseFrame The main frame instance function basalt.getMainFrame() end ----Configures the ElementManager (shortcut to elementManager.configure) ----@param config table Configuration options -function basalt.configure(config) 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 - ----Installs an element interactively or from a specified source ----@param elementName string The name of the element to install -function basalt.install(elementName) 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 - ----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 - ----Sets the active frame ----@param frame BaseFrame The frame to set as active -function basalt.setActiveFrame(frame) 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 - ---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 ----Runs basalt once, can be used to update the UI manually, but you have to feed it the events -function basalt.update() end +---Returns the active frame +---@return BaseFrame ? BaseFrame The frame to set as active +function basalt.getActiveFrame() end ----Returns a Plugin API ----@param name string The name of the plugin ----@return table Plugin The plugin API -function basalt.getAPI(name) end +---@class ScrollFrame : Container +---@field scrollBarSymbol string The symbol used for the scrollbar handle +---@field contentHeight number The total height of the content (calculated from children) +---@field contentWidth number The total width of the content (calculated from children) +---@field scrollBarBackgroundColor2 secondary black Background color of the scrollbar +---@field scrollBarColor color Color of the scrollbar handle +---@field showScrollBar boolean Whether to show scrollbars +---@field scrollBarBackgroundColor color Background color of the scrollbar +---@field scrollBarBackgroundSymbol string The symbol used for the scrollbar background +local ScrollFrame = {} ----@class ThemeAPI -local ThemeAPI = {} +---Renders the ScrollFrame and its scrollbars +---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 ScrollFrame:render() end ----Gets the current theme configuration ----@return table theme The current theme configuration -function ThemeAPI.getTheme() end +---Sets the value of the ScrollBarColor property. +---@param self ScrollFrame self +---@param ScrollBarColor color Color of the scrollbar handle +function ScrollFrame:setScrollBarColor(self, ScrollBarColor) end ----Loads a theme from a JSON file ----@param path string Path to the theme JSON file -function ThemeAPI.loadTheme(path) end +---Sets the value of the ScrollBarSymbol property. +---@param self ScrollFrame self +---@param ScrollBarSymbol string The symbol used for the scrollbar handle +function ScrollFrame:setScrollBarSymbol(self, ScrollBarSymbol) end ----Sets the current theme ----@param newTheme table The theme configuration to set -function ThemeAPI.setTheme(newTheme) end +---Gets the value of the ScrollBarBackgroundColor2 property. +---@param self ScrollFrame self +---@return secondary color black Background color of the scrollbar +function ScrollFrame:getScrollBarBackgroundColor2(self) end ----@class Animation -local Animation = {} +---Handles mouse scroll 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 direction number 1 for up, -1 for down +---@param x number Mouse x position relative to element +---@param y number Mouse y position relative to element +---@return boolean Whether the event was handled +---@protected +function ScrollFrame:mouse_scroll(direction, x, y) 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 +---Gets the value of the ScrollBarColor property. +---@param self ScrollFrame self +---@return color lightGray Color of the scrollbar handle +function ScrollFrame:getScrollBarColor(self) 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 +---Gets the value of the ContentWidth property. +---@param self ScrollFrame self +---@return number 0 The total width of the content (calculated from children) +function ScrollFrame:getContentWidth(self) 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 +---Sets the value of the ScrollBarBackgroundSymbol property. +---@param self ScrollFrame self +---@param ScrollBarBackgroundSymbol string The symbol used for the scrollbar background +function ScrollFrame:setScrollBarBackgroundSymbol(self, ScrollBarBackgroundSymbol) end ----Stops the animation immediately: cancels timers, completes running anim instances and clears the element property -function Animation:stop() end +---Gets the value of the ContentHeight property. +---@param self ScrollFrame self +---@return number 0 The total height of the content (calculated from children) +function ScrollFrame:getContentHeight(self) 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 +---Gets the value of the ScrollBarBackgroundColor property. +---@param self ScrollFrame self +---@return color gray Background color of the scrollbar +function ScrollFrame:getScrollBarBackgroundColor(self) end ----Creates a new sequence ----@return Animation self The animation instance -function Animation:sequence() end +---Gets the value of the ShowScrollBar property. +---@param self ScrollFrame self +---@return boolean true Whether to show scrollbars +function ScrollFrame:getShowScrollBar(self) 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 +---Sets the value of the ShowScrollBar property. +---@param self ScrollFrame self +---@param ShowScrollBar boolean Whether to show scrollbars +function ScrollFrame:setShowScrollBar(self, ShowScrollBar) end ----Starts the animation ----@return Animation self The animation instance -function Animation:start() end +---Handles mouse click events for scrollbars and content +---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 Whether the event was handled +---@protected +function ScrollFrame:mouse_click(button, x, y) end ----Creates a new Animation ----@param element VisualElement The element to animate ----@return Animation The new animation -function Animation.new(element) end +---Handles mouse up events to stop scrollbar dragging +---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-coordinate of the release +---@param y number The y-coordinate of the release +---@return boolean Whether the event was handled +---@protected +function ScrollFrame:mouse_up(button, x, y) end ----Registers a callback for the start event ----@param callback function The callback function to register -function Animation:onStart(callback) end +---Sets the value of the ContentHeight property. +---@param self ScrollFrame self +---@param ContentHeight number The total height of the content (calculated from children) +function ScrollFrame:setContentHeight(self, ContentHeight) 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 +---Handles mouse drag events for scrollbar +---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-coordinate of the drag +---@param y number The y-coordinate of the drag +---@return boolean Whether the event was handled +---@protected +function ScrollFrame:mouse_drag(button, x, y) end ----@class BarChart : Graph -local BarChart = {} +---Gets the value of the ScrollBarBackgroundSymbol property. +---@param self ScrollFrame self +---@return string "\127" The symbol used for the scrollbar background +function ScrollFrame:getScrollBarBackgroundSymbol(self) end + +---Sets the value of the ContentWidth property. +---@param self ScrollFrame self +---@param ContentWidth number The total width of the content (calculated from children) +function ScrollFrame:setContentWidth(self, ContentWidth) end + +---Sets the value of the ScrollBarBackgroundColor2 property. +---@param self ScrollFrame self +---@param ScrollBarBackgroundColor2 secondary black Background color of the scrollbar +function ScrollFrame:setScrollBarBackgroundColor2(self, ScrollBarBackgroundColor2) end + +---Sets the value of the ScrollBarBackgroundColor property. +---@param self ScrollFrame self +---@param ScrollBarBackgroundColor color Background color of the scrollbar +function ScrollFrame:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end + +---Gets the value of the ScrollBarSymbol property. +---@param self ScrollFrame self +---@return string "_" The symbol used for the scrollbar handle +function ScrollFrame:getScrollBarSymbol(self) end + +---@class ContextMenu : Container +---@field isOpen boolean Whether the menu is currently open +---@field items table List of menu items +---@field openSubmenu table Currently open submenu data +---@field itemHeight number Height of each menu item +local ContextMenu = {} + +---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 ContextMenu:mouse_click() end + +---Gets the value of the IsOpen property. +---@param self ContextMenu self +---@return boolean false Whether the menu is currently open +function ContextMenu:getIsOpen(self) end + +---Closes the menu and any submenus +---@return ContextMenu self For method chaining +function ContextMenu:close() end + +---Gets the value of the OpenSubmenu property. +---@param self ContextMenu self +---@return table nil Currently open submenu data +function ContextMenu:getOpenSubmenu(self) end + +---Sets the value of the IsOpen property. +---@param self ContextMenu self +---@param IsOpen boolean Whether the menu is currently open +function ContextMenu:setIsOpen(self, IsOpen) end + +---Closes the entire menu chain (parent and all submenus) +---@return ContextMenu self For method chaining +function ContextMenu:closeAll() end + +---Opens the menu +---@return ContextMenu self For method chaining +function ContextMenu:open() end + +---Sets the menu items +---@param items table Array of item definitions +---@return ContextMenu self For method chaining +function ContextMenu:setItems(items) end + +---Sets the value of the ItemHeight property. +---@param self ContextMenu self +---@param ItemHeight number Height of each menu item +function ContextMenu:setItemHeight(self, ItemHeight) end + +---Sets the value of the OpenSubmenu property. +---@param self ContextMenu self +---@param OpenSubmenu table Currently open submenu data +function ContextMenu:setOpenSubmenu(self, OpenSubmenu) end ---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 BarChart self The initialized instance ---@protected -function BarChart:init(props, basalt) end - ----Renders the bar chart by calculating bar positions and heights based on data values ----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 BarChart:render() end - ----@class LineChart : Graph -local LineChart = {} +function ContextMenu: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 LineChart:render() end +function ContextMenu:render() end + +---Gets the value of the ItemHeight property. +---@param self ContextMenu self +---@return number 1 Height of each menu item +function ContextMenu:getItemHeight(self) end + +---Gets the value of the Items property. +---@param self ContextMenu self +---@return table {} List of menu items +function ContextMenu:getItems(self) end + +---@class VisualElement : BaseElement +---@field x number The horizontal position relative to parent +---@field y number The vertical position relative to parent +---@field z number The z-index for layering elements +---@field borderRight boolean Draw right border +---@field background color The background color +---@field backgroundEnabled boolean Whether to render the background +---@field foreground color The text/foreground color +---@field borderLeft boolean Draw left border +---@field borderBottom boolean Draw bottom border +---@field width number The width of the element +---@field ignoreOffset boolean Whether to ignore the parent's offset +---@field visible boolean Whether the element is visible +---@field borderColor color Border color +---@field height number The height of the element +---@field borderTop boolean Draw top border +---@field layoutConfig table Configuration for layout systems (grow, shrink, alignSelf, etc.) +local VisualElement = {} + +---Sets the value of the BorderTop property. +---@param self VisualElement self +---@param BorderTop boolean Draw top border +function VisualElement:setBorderTop(self, BorderTop) 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 + +---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 + +---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 IgnoreOffset property. +---@param self VisualElement self +---@return boolean false Whether to ignore the parent's offset +function VisualElement:getIgnoreOffset(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 + +---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 + +---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. +---@param x number The x position to draw +---@param y number The y position to draw +---@param width number The width of the area to draw +---@param height number The height of the area to draw +---@param text string The text to draw +---@param fg string The foreground color +---@param bg string The background color +---@protected +function VisualElement:multiBlit(x, y, width, height, text, fg, bg) 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 + +---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 + +---Gets the value of the BorderTop property. +---@param self VisualElement self +---@return boolean false Draw top border +function VisualElement:getBorderTop(self) end + +function VisualElement:drawFg() 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 + +---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 + +---Gets whether this element is focused +---@return boolean isFocused +function VisualElement:isFocused() end + +---Sets or removes focus from this element +---@param focused boolean Whether to focus or blur +---@return VisualElement self +function VisualElement:setFocused(focused) end + +---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 + +---Sets the value of the LayoutConfig property. +---@param self VisualElement self +---@param LayoutConfig table Configuration for layout systems (grow, shrink, alignSelf, etc.) +function VisualElement:setLayoutConfig(self, LayoutConfig) 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 + +---Gets a single property from the layoutConfig table +---@param key string The layout config property to get +---@return any value The value of the property, or nil if not set +function VisualElement:getLayoutConfigProperty(key) end + +---Centers the element within its parent both horizontally and vertically +---@return VisualElement self +function VisualElement:center() end + +---Sets the value of the BorderRight property. +---@param self VisualElement self +---@param BorderRight boolean Draw right border +function VisualElement:setBorderRight(self, BorderRight) 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 ---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 LineChart self The initialized instance ---@protected -function LineChart:init(props, basalt) end +function VisualElement:init(props, basalt) 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 = {} +---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 ----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 +---Creates a new Animation Object +---@return Animation animation The new animation +function VisualElement:animate() end ----Gets the wrapped lines of the Label ----@return table wrappedText The wrapped lines of the Label -function Label:getWrappedText() 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 ----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 BackgroundEnabled property. +---@param self VisualElement self +---@return boolean true Whether to render the background +function VisualElement:getBackgroundEnabled(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 BorderLeft property. +---@param self VisualElement self +---@param BorderLeft boolean Draw left border +function VisualElement:setBorderLeft(self, BorderLeft) 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 + +---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 + +---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 + +---Adds or updates a drawable character border around the element. 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 + +---Aligns the element's bottom edge to its parent's bottom edge with optional gap +---@return VisualElement self +function VisualElement:toBottom() end + +---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 + +---Removes the previously added border (if any) +---@return VisualElement self +function VisualElement:removeBorder() end + +---Gets the value of the BorderColor property. +---@param self VisualElement self +---@return color white Border color +function VisualElement:getBorderColor(self) 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 + +---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 + +function VisualElement:drawText() end + +---Stretches the element to fill its parent's width and height with optional margin +---@return VisualElement self +function VisualElement:fillParent() 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 + +---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 the value of the BorderLeft property. +---@param self VisualElement self +---@return boolean false Draw left border +function VisualElement:getBorderLeft(self) 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 + +---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 + +---Gets the value of the Background property. +---@param self VisualElement self +---@return color black The background color +function VisualElement:getBackground(self) end + +---Updates a single property in the layoutConfig table +---@param key string The layout config property to update (grow, shrink, basis, alignSelf, order, etc.) +---@param value any The value to set for the property +---@return VisualElement self The element instance +function VisualElement:setLayoutConfigProperty(key, value) end ---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 - ----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 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 - ----@class Benchmark -local Benchmark = {} - ----Stops a custom benchmark ----@param name string The name of the benchmark to stop -function API.stop(name) end - ----Clears all custom benchmarks -function API.clearAll() end - ----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 - ----@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 = {} - ----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 - ----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 - ----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 - ----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 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 +function VisualElement:postRender() end ---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 +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 + +---Registers a function to handle the onClickUp event. +---@param self VisualElement self +---@param func function The function to be called when the event fires +function VisualElement:onOnClickUp(self, func) end + +---Aligns the element's top edge to its parent's top edge with optional gap +---@return VisualElement self +function VisualElement:toTop() 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 + +---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 + +---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 + +---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 + +---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 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. +---@param self VisualElement self +---@return boolean false Draw bottom border +function VisualElement:getBorderBottom(self) end + +---Resolves all constraints for the element +---@return VisualElement self The element instance +function VisualElement:resolveAllConstraints() 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 _ 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 LayoutConfig property. +---@param self VisualElement self +---@return table {} Configuration for layout systems (grow, shrink, alignSelf, etc.) +function VisualElement:getLayoutConfig(self) 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 + +---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 + +---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 + +---Sets the value of the BorderColor property. +---@param self VisualElement self +---@param BorderColor color Border color +function VisualElement:setBorderColor(self, BorderColor) 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 + +---Stretches the element to fill its parent's height with optional margin +---@return VisualElement self +function VisualElement:fillHeight() 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 + +---Sets the value of the BorderBottom property. +---@param self VisualElement self +---@param BorderBottom boolean Draw bottom border +function VisualElement:setBorderBottom(self, BorderBottom) end + +---Convenience to stop animations from the element +function VisualElement.stopAnimation() 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 + +---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 + +---Aligns the element's right edge to its parent's right edge with optional gap +---@return VisualElement self +function VisualElement:toRight() 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 + +---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 + +---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 + +---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 + +---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 + +---Updates all constraints, recalculating positions and sizes +---@return VisualElement self The element instance +function VisualElement:updateConstraints() 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 + +---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 fg string The foreground color +---@param bg string The background color +---@protected +function VisualElement:blit(x, y, text, fg, bg) end + +---Sets the value of the Background property. +---@param self VisualElement self +---@param Background color The background color +function VisualElement:setBackground(self, Background) end + +---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 + +---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 + +---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 + +---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 fg color The foreground color +---@protected +function VisualElement:textFg(x, y, text, fg) 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 + +---Stretches the element to fill its parent's width with optional margin +---@return VisualElement self +function VisualElement:fillWidth() 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 + +---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 char string The character that was pressed +---@protected +function VisualElement:char(char) end + +function VisualElement:drawBg() end + +function VisualElement:destroy() end + +---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 + +---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 + +---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 + +---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 + +---Gets the value of the BorderRight 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. +---@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 +---@protected +function VisualElement: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 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 + +---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 ---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 +---@return boolean clicked Whether the element was clicked ---@protected -function DropDown:mouse_click(button, x, y) end +function VisualElement:mouse_click(button, x, y) 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. ----@param button number The mouse button that was released ----@param x number The x-coordinate of the release ----@param y number The y-coordinate of the release ----@return boolean Whether the event was handled ----@protected -function DropDown:mouse_up(button, x, y) 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 DropSymbol property. ----@param self DropDown self ----@return string "\31" Indicator for dropdown state -function DropDown:getDropSymbol(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-coordinate of the drag ----@param y number The y-coordinate of the drag ----@return boolean Whether the event was handled ----@protected -function DropDown:mouse_drag(button, x, y) 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 - ----@class List : Collection ----@field offset number Current scroll offset for viewing long lists ----@field emptyText string items" Text to display when the list is empty ----@field scrollBarSymbol string " Symbol used for the scrollbar handle ----@field showScrollBar boolean Whether to show the scrollbar when items exceed height ----@field scrollBarBackgroundColor color Background color of the scrollbar ----@field scrollBarBackground string Symbol used for the scrollbar background ----@field scrollBarColor color Color of the scrollbar handle -local List = {} - ----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 - ----Gets the value of the ScrollBarSymbol property. ----@param self List self ----@return string " " Symbol used for the scrollbar handle -function List:getScrollBarSymbol(self) end - ----Gets the value of the ShowScrollBar property. ----@param self List self ----@return boolean true Whether to show the scrollbar when items exceed height -function List:getShowScrollBar(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-coordinate of the drag ----@param y number The y-coordinate of the drag ----@return boolean Whether the event was handled ----@protected -function List:mouse_drag(button, x, y) 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 - ----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 - ----Sets the value of the ScrollBarColor property. ----@param self List self ----@param ScrollBarColor color Color of the scrollbar handle -function List:setScrollBarColor(self, ScrollBarColor) end - ----Handles key events for keyboard navigation ----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 keyCode number The key code ----@return boolean Whether the event was handled ----@protected -function List:key(keyCode) end - ----Sets the value of the ScrollBarBackground property. ----@param self List self ----@param ScrollBarBackground string Symbol used for the scrollbar background -function List:setScrollBarBackground(self, ScrollBarBackground) end - ----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 - ----Scrolls to make a specific item visible ----@param index number The index of the item to scroll to ----@return List self The List instance -function List:scrollToItem(index) 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. ----@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 - ----Scrolls the list to the bottom ----@return List self The List instance -function List:scrollToBottom() end - ----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-coordinate of the release ----@param y number The y-coordinate of the release ----@return boolean Whether the event was handled ----@protected -function List:mouse_up(button, x, y) end - ----Gets the value of the ScrollBarBackground property. ----@param self List self ----@return string "\127" Symbol used for the scrollbar background -function List:getScrollBarBackground(self) end - ----Gets the value of the ScrollBarColor property. ----@param self List self ----@return color lightGray Color of the scrollbar handle -function List:getScrollBarColor(self) end - ----Gets the value of the ScrollBarBackgroundColor property. ----@param self List self ----@return color gray Background color of the scrollbar -function List:getScrollBarBackgroundColor(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 (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 - ----Gets the value of the EmptyText property. ----@param self List self ----@return string "No items" Text to display when the list is empty -function List:getEmptyText(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 ScrollBarBackgroundColor property. ----@param self List self ----@param ScrollBarBackgroundColor color Background color of the scrollbar -function List:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end - ----Registers a function to handle the onSelect event. ----@param List self ----@param index number ----@param item table ----@param self List self +---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 List:onOnSelect(self, func) end +function VisualElement:onOnBlur(self, func) end ----Sets the value of the ShowScrollBar property. ----@param self List self ----@param ShowScrollBar boolean Whether to show the scrollbar when items exceed height -function List:setShowScrollBar(self, ShowScrollBar) end - ----Sets the value of the EmptyText property. ----@param self List self ----@param EmptyText string items" Text to display when the list is empty -function List:setEmptyText(self, EmptyText) end - ----Sets the value of the ScrollBarSymbol property. ----@param self List self ----@param ScrollBarSymbol string " Symbol used for the scrollbar handle -function List:setScrollBarSymbol(self, ScrollBarSymbol) end +---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 ---@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 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 +---@param key number The key that was pressed ---@protected -function BaseFrame:multiBlit(x, y, width, height, text, fg, bg) end +function BaseFrame:key(key) end + +function BaseFrame: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 button number The button that was released +---@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:mouse_up(button, x, y) end +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 char string The character that was pressed @@ -5364,9 +2166,9 @@ 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 fg colors The foreground color +---@param text string The text to render ---@protected -function BaseFrame:drawFg(x, y, fg) end +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 props table The properties to initialize the element with @@ -5375,54 +2177,41 @@ function BaseFrame:drawFg(x, y, fg) end ---@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 ----@param fg colors The foreground color ----@protected -function BaseFrame:textFg(x, y, text, fg) end +---Shows the debug log frame +---@param self BaseFrame The frame to show debug log in +function BaseFrame.openConsole(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: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 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: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 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 +function BaseFrame:multiBlit(x, y, width, height, text, fg, bg) end ---Toggles the debug log frame ---@param self BaseFrame The frame to toggle debug log for function BaseFrame.toggleConsole(self) 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 +---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 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 x number The x position to render to ---@param y number The y position to render to @@ -5432,11 +2221,13 @@ function BaseFrame.closeConsole(self) end 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 key number The key that was pressed +---@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:key(key) end - -function BaseFrame:dispatchEvent() end +function BaseFrame:blit(x, y, text, fg, bg) end ---Sets the cursor position ---@param x number The x position to set the cursor to @@ -5444,31 +2235,1387 @@ function BaseFrame:dispatchEvent() end ---@param blink boolean Whether the cursor should blink function BaseFrame:setCursor(x, y, blink) 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 x number The x position to render to ---@param y number The y position to render to ----@param bg colors The background color +---@param fg colors The foreground color ---@protected -function BaseFrame:drawBg(x, y, bg) 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 +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 text string The text to render +---@param fg colors The foreground color ---@protected -function BaseFrame:render() end - ----Shows the debug log frame ----@param self BaseFrame The frame to show debug log in -function BaseFrame.openConsole(self) end +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. ---@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. +---@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. +---@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 + +---@class ProgressBar : VisualElement +---@field direction string The direction of the progress bar ("up", "down", "left", "right") +---@field progressColor color The color used for the filled portion of the progress bar +---@field progress number Current progress value (0-100) +---@field showPercentage boolean Whether to show the percentage text in the center +local ProgressBar = {} + +---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 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 + +---Gets the value of the Progress property. +---@param self ProgressBar self +---@return number 0 Current progress value (0-100) +function ProgressBar:getProgress(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 ProgressBar:render() 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 + +---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 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 + +---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 ShowPercentage property. +---@param self ProgressBar self +---@return boolean false Whether to show the percentage text in the center +function ProgressBar:getShowPercentage(self) 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 + +---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 + +---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 + +---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 + +---Removes all observers from a property +---@return table self The PropertySystem +function PropertySystem:removeAllObservers() 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 + +---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 + +---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 + +---Initializes the PropertySystem IS USED INTERNALLY +---@return table self The PropertySystem +function PropertySystem:__init() 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 + +---@class ElementManager +local ElementManager = {} + +---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 + +---Configures the ElementManager +---@param config table Configuration options +function ElementManager.configure(config) end + +---Preloads elements into the global cache +---@param elementNames table List of element names to preload +function ElementManager.preloadElements(elementNames) 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 + +---Gets cache statistics +---@return table stats Cache statistics with size and element names +function ElementManager.getCacheStats() end + +---Registers a disk mount point for loading elements +---@param mountPath string The path to the disk mount +function ElementManager.registerDiskMount(mountPath) 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 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 + +---Gets a list of all elements +---@return table ElementList A list of all elements +function ElementManager.getElementList() 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 + +---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 DropDown : List +---@field selectedText string Text shown when no selection made +---@field dropSymbol string Indicator for dropdown state +---@field dropdownHeight number Maximum visible items when expanded +local DropDown = {} + +---Sets the value of the DropSymbol property. +---@param self DropDown self +---@param DropSymbol string Indicator for dropdown state +function DropDown:setDropSymbol(self, DropSymbol) 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 + +---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-coordinate of the release +---@param y number The y-coordinate of the release +---@return boolean Whether the event was handled +---@protected +function DropDown:mouse_up(button, x, y) 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 + +---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 + +---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 + +---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 DropSymbol property. +---@param self DropDown self +---@return string "\31" Indicator for dropdown state +function DropDown:getDropSymbol(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 + +---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-coordinate of the drag +---@param y number The y-coordinate of the drag +---@return boolean Whether the event was handled +---@protected +function DropDown:mouse_drag(button, x, y) 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 DropdownHeight property. +---@param self DropDown self +---@return number 5 Maximum visible items when expanded +function DropDown:getDropdownHeight(self) end + +---@class Dialog : Frame +---@field title string The dialog title +---@field buttonForeground color Foreground color for buttons +---@field primaryColor color Primary button color (OK, confirm actions) +---@field modal boolean If true, blocks all events outside the dialog +---@field secondaryColor color Secondary button color (Cancel, dismiss actions) +local Dialog = {} + +---Shows the dialog +---@return Dialog self The Dialog instance +function Dialog:show() end + +---Sets the value of the PrimaryColor property. +---@param self Dialog self +---@param PrimaryColor color Primary button color (OK, confirm actions) +function Dialog:setPrimaryColor(self, PrimaryColor) end + +---Creates a prompt dialog with input +---@param title string The dialog title +---@param message string The prompt message +---@return Dialog self The Dialog instance +function Dialog:prompt(title, message) end + +---Sets the value of the ButtonForeground property. +---@param self Dialog self +---@param ButtonForeground color Foreground color for buttons +function Dialog:setButtonForeground(self, ButtonForeground) end + +---Sets the value of the Title property. +---@param self Dialog self +---@param Title string The dialog title +function Dialog:setTitle(self, Title) end + +---Creates a confirm dialog +---@param title string The dialog title +---@param message string The confirmation message +---@param callback function Callback (receives boolean result) +---@return Dialog self The Dialog instance +function Dialog:confirm(title, message, callback) end + +---Closes the dialog +---@return Dialog self The Dialog instance +function Dialog:close() end + +---Gets the value of the Modal property. +---@param self Dialog self +---@return boolean true If true, blocks all events outside the dialog +function Dialog:getModal(self) end + +---Handles mouse scroll 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. +---@protected +function Dialog:mouse_scroll() end + +---Renders the dialog +---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 Dialog:render() end + +---Gets the value of the ButtonForeground property. +---@param self Dialog self +---@return color black Foreground color for buttons +function Dialog:getButtonForeground(self) end + +---Handles mouse up 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. +---@protected +function Dialog:mouse_up() end + +---Handles mouse drag 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. +---@protected +function Dialog:mouse_drag() 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. +---@protected +function Dialog:mouse_click() end + +---Sets the value of the SecondaryColor property. +---@param self Dialog self +---@param SecondaryColor color Secondary button color (Cancel, dismiss actions) +function Dialog:setSecondaryColor(self, SecondaryColor) end + +---Gets the value of the PrimaryColor property. +---@param self Dialog self +---@return color lime Primary button color (OK, confirm actions) +function Dialog:getPrimaryColor(self) end + +---Sets the value of the Modal property. +---@param self Dialog self +---@param Modal boolean If true, blocks all events outside the dialog +function Dialog:setModal(self, Modal) end + +---Gets the value of the Title property. +---@param self Dialog self +---@return string "" The dialog title +function Dialog:getTitle(self) end + +---Gets the value of the SecondaryColor property. +---@param self Dialog self +---@return color lightGray Secondary button color (Cancel, dismiss actions) +function Dialog:getSecondaryColor(self) end + +---Creates a simple alert dialog +---@param title string The alert title +---@param message string The alert message +---@return Dialog self The Dialog instance +function Dialog:alert(title, message) end + +---@class BigFontText +local BigFontText = {} + +---@class Slider : VisualElement +---@field max number Maximum value for value conversion (maps slider position to this range) +---@field horizontal boolean Whether the slider is horizontal (false for vertical) +---@field step number Current position of the slider handle (1 to width/height) +---@field barColor color Color of the slider track +---@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 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 + +---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 + +---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 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 + +---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 SliderColor property. +---@param self Slider self +---@param SliderColor color Color of the slider handle +function Slider:setSliderColor(self, SliderColor) 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 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. +---@protected +function Slider:render() 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 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 + +---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 BarColor property. +---@param self Slider self +---@return color gray Color of the slider track +function Slider:getBarColor(self) 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 + +---@class Accordion : Container +---@field headerBackground color Background color for panel headers +---@field panels table List of panel definitions +---@field panelHeaderHeight number Height of each panel header +---@field expandedHeaderTextColor color Text color for expanded panel headers +---@field headerTextColor color Text color for panel headers +---@field expandedHeaderBackground color Background color for expanded panel headers +---@field allowMultiple boolean Allow multiple panels to be open at once +local Accordion = {} + +---Sets the value of the ExpandedHeaderTextColor property. +---@param self Accordion self +---@param ExpandedHeaderTextColor color Text color for expanded panel headers +function Accordion:setExpandedHeaderTextColor(self, ExpandedHeaderTextColor) end + +---Gets the value of the ExpandedHeaderTextColor property. +---@param self Accordion self +---@return color black Text color for expanded panel headers +function Accordion:getExpandedHeaderTextColor(self) end + +---Gets the value of the AllowMultiple property. +---@param self Accordion self +---@return boolean false Allow multiple panels to be open at once +function Accordion:getAllowMultiple(self) end + +---Sets the value of the HeaderTextColor property. +---@param self Accordion self +---@param HeaderTextColor color Text color for panel headers +function Accordion:setHeaderTextColor(self, HeaderTextColor) end + +---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 Accordion:mouse_click(button, x, y) end + +---@param panelId number The ID of the panel to expand +---@return Accordion self For method chaining +function Accordion:expandPanel(panelId) end + +---Creates a new panel and returns the panel's container +---@param title string The title of the panel +---@param expanded boolean Whether the panel starts expanded (default: false) +---@return table panelContainer The container for this panel +function Accordion:newPanel(title, expanded) end + +---Sets the value of the Panels property. +---@param self Accordion self +---@param Panels table List of panel definitions +function Accordion:setPanels(self, Panels) end + +---Sets the value of the AllowMultiple property. +---@param self Accordion self +---@param AllowMultiple boolean Allow multiple panels to be open at once +function Accordion:setAllowMultiple(self, AllowMultiple) end + +---@param panelId number The ID of the panel to toggle +---@return Accordion self For method chaining +function Accordion:togglePanel(panelId) end + +---Gets the value of the ExpandedHeaderBackground property. +---@param self Accordion self +---@return color lightGray Background color for expanded panel headers +function Accordion:getExpandedHeaderBackground(self) end + +---Gets the value of the Panels property. +---@param self Accordion self +---@return table {} List of panel definitions +function Accordion:getPanels(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 Accordion:render() end + +function Accordion:mouse_scroll() end + +---@param panelId number The ID of the panel +---@return table ? container The panel's container or nil +function Accordion:getPanel(panelId) end + +---Sets the value of the HeaderBackground property. +---@param self Accordion self +---@param HeaderBackground color Background color for panel headers +function Accordion:setHeaderBackground(self, HeaderBackground) end + +---@param panelId number The ID of the panel to collapse +---@return Accordion self For method chaining +function Accordion:collapsePanel(panelId) end + +---Sets the value of the ExpandedHeaderBackground property. +---@param self Accordion self +---@param ExpandedHeaderBackground color Background color for expanded panel headers +function Accordion:setExpandedHeaderBackground(self, ExpandedHeaderBackground) end + +---Gets the value of the HeaderBackground property. +---@param self Accordion self +---@return color gray Background color for panel headers +function Accordion:getHeaderBackground(self) end + +---Gets the value of the PanelHeaderHeight property. +---@param self Accordion self +---@return number 1 Height of each panel header +function Accordion:getPanelHeaderHeight(self) end + +---Sets the value of the PanelHeaderHeight property. +---@param self Accordion self +---@param PanelHeaderHeight number Height of each panel header +function Accordion:setPanelHeaderHeight(self, PanelHeaderHeight) end + +---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 Accordion:init(props, basalt) end + +---Gets the value of the HeaderTextColor property. +---@param self Accordion self +---@return color white Text color for panel headers +function Accordion:getHeaderTextColor(self) end + +---@class Image : VisualElement +---@field autoResize boolean Whether to automatically resize the image when content exceeds bounds +---@field currentFrame number Current animation frame +---@field offsetY number Vertical offset for viewing larger images +---@field bimg table The bimg image data +---@field offsetX number Horizontal offset for viewing larger images +local Image = {} + +---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 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 size of the image +---@return number width The width of the image +---@return number height The height of the image +function Image:getImageSize() 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 + +---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 + +---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 + +---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 + +---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 + +---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 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 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 + +---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 + +---Gets the value of the Bimg property. +---@param self Image self +---@return table {} The bimg image data +function Image:getBimg(self) end + +---Gets the metadata of the image +---@return table metadata The metadata of the image +function Image:getMetadata() end + +---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 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 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 + +---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 CurrentFrame property. +---@param self Image self +---@param CurrentFrame number Current animation frame +function Image:setCurrentFrame(self, CurrentFrame) 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 + +---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 + +---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 + +---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 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 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 + +---@class BaseElement : PropertySystem +---@field eventCallbacks table Collection of registered event handler functions +---@field id string Auto-generated unique identifier for element lookup +---@field enabled boolean Controls event processing for this element +---@field type string A hierarchical identifier of the element's type chain +---@field name string User-defined name for the element +---@field states table Table of currently active states with their priorities +local BaseElement = {} + +---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 + +---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 + +---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 + +---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 + +---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 + +---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 + +---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 + +---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 highest priority active state +---@return string |nil currentState The state with highest priority +function BaseElement:getCurrentState() end + +---Creates a responsive builder for defining responsive states +---@param self BaseElement The element to create the builder for +---@return ResponsiveBuilder builder The responsive builder instance +function BaseElement:responsive(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 + +---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 + +---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 + +---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 + +---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 + +---Dumps debug information for this element +---@param self BaseElement The element to dump debug info for +function BaseElement.dumpDebug(self) 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 + +---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 + +---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 + +---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 + +---Propagates render request up the element tree +---@return table self The BaseElement instance +function BaseElement:updateRender() end + +---Manually activates a state +---@param stateName string The state to activate +---@return BaseElement self +function BaseElement:setState(stateName) 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 + +---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 + +---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 + +---Removes the element from UI tree and cleans up resources +function BaseElement:destroy() 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 + +---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 + +---Manually deactivates a state +---@param stateName string The state to deactivate +---@return BaseElement self +function BaseElement:unsetState(stateName) 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 + +---Registers a responsive state that reacts to parent size changes +---@param stateName string The name of the state +---@param condition string |function Condition as string expression or function: function(element) return boolean end +---@return BaseElement self +function BaseElement:registerResponsiveState(stateName, condition) 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 + +---Removes a state from the registry +---@param stateName string The state to remove +---@return BaseElement self +function BaseElement:unregisterState(stateName) end + +---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 all currently active states sorted by priority +---@return table states Array of {name, priority} sorted by priority +function BaseElement:getActiveStates() 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 + +---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 + +---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 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 + +---Traverses parent chain to locate the root frame element +---@return BaseFrame BaseFrame The base frame of the element +function BaseElement:getBaseFrame() 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 + +---Checks if a state is currently active +---@param stateName string The state to check +---@return boolean isActive +function BaseElement:hasState(stateName) 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 + +---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 + +---@class Tree : VisualElement +---@field scrollBarSymbol string " Symbol used for the scrollbar handle +---@field expandedNodes table Table of nodes that are currently expanded +---@field selectedForegroundColor color foreground color of selected node +---@field offset number Current vertical scroll position +---@field selectedNode table nil Currently selected node +---@field nodes table The tree structure containing node objects with {text, children} properties +---@field selectedBackgroundColor color background color of selected node +---@field scrollBarBackground string Symbol used for the scrollbar background +---@field scrollBarColor color Color of the scrollbar handle +---@field showScrollBar boolean Whether to show the scrollbar when nodes exceed height +---@field scrollBarBackgroundColor color Background color of the scrollbar +---@field horizontalOffset number Current horizontal scroll position +local Tree = {} + +---Gets the value of the SelectedBackgroundColor property. +---@param self Tree self +---@return color lightBlue background color of selected node +function Tree:getSelectedBackgroundColor(self) end + +---Gets the value of the ShowScrollBar property. +---@param self Tree self +---@return boolean true Whether to show the scrollbar when nodes exceed height +function Tree:getShowScrollBar(self) end + +---Gets the value of the HorizontalOffset property. +---@param self Tree self +---@return number 0 Current horizontal scroll position +function Tree:getHorizontalOffset(self) end + +---Sets the value of the ScrollBarBackgroundColor property. +---@param self Tree self +---@param ScrollBarBackgroundColor color Background color of the scrollbar +function Tree:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end + +---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 + +---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 + +---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 + +---Sets the value of the Offset property. +---@param self Tree self +---@param Offset number Current vertical scroll position +function Tree:setOffset(self, Offset) end + +---Sets the value of the ScrollBarBackground property. +---@param self Tree self +---@param ScrollBarBackground string Symbol used for the scrollbar background +function Tree:setScrollBarBackground(self, ScrollBarBackground) 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 + +---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 button number The mouse button being dragged +---@param x number The x-coordinate of the drag +---@param y number The y-coordinate of the drag +---@return boolean Whether the event was handled +---@protected +function Tree: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 button number The mouse button that was released +---@param x number The x-coordinate of the release +---@param y number The y-coordinate of the release +---@return boolean Whether the event was handled +---@protected +function Tree:mouse_up(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 + +---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 + +---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 + +---Collapses a node +---@param node table The node to collapse +---@return Tree self The Tree instance +function Tree:collapseNode(node) 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 + +---Sets the value of the ScrollBarSymbol property. +---@param self Tree self +---@param ScrollBarSymbol string " Symbol used for the scrollbar handle +function Tree:setScrollBarSymbol(self, ScrollBarSymbol) 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 SelectedNode property. +---@param self Tree self +---@return table ? nil Currently selected node +function Tree:getSelectedNode(self) 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 + +---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 ScrollBarColor property. +---@param self Tree self +---@param ScrollBarColor color Color of the scrollbar handle +function Tree:setScrollBarColor(self, ScrollBarColor) 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 + +---Gets the value of the ScrollBarSymbol property. +---@param self Tree self +---@return string " " Symbol used for the scrollbar handle +function Tree:getScrollBarSymbol(self) end + +---Gets the value of the Offset property. +---@param self Tree self +---@return number 0 Current vertical scroll position +function Tree:getOffset(self) end + +---Sets the value of the ShowScrollBar property. +---@param self Tree self +---@param ShowScrollBar boolean Whether to show the scrollbar when nodes exceed height +function Tree:setShowScrollBar(self, ShowScrollBar) 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 + +---Gets the value of the ScrollBarBackground property. +---@param self Tree self +---@return string "\127" Symbol used for the scrollbar background +function Tree:getScrollBarBackground(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 + +---Gets the value of the ScrollBarBackgroundColor property. +---@param self Tree self +---@return color gray Background color of the scrollbar +function Tree:getScrollBarBackgroundColor(self) end + +---Gets the value of the ScrollBarColor property. +---@param self Tree self +---@return color lightGray Color of the scrollbar handle +function Tree:getScrollBarColor(self) end + +---@class Program : VisualElement +---@field path string The path to the program +---@field doneCallback function The done callback function +---@field errorCallback function The error callback function +---@field program table The program instance +---@field running boolean Whether the program is running +local Program = {} + +function BasaltProgram:setArgs() 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 + +---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 Program property. +---@param self Program self +---@return table nil The program instance +function Program:getProgram(self) end + +---Stops the program +---@return Program self The Program instance +function Program:stop() end + +---Gets the value of the DoneCallback property. +---@param self Program self +---@return function nil The done callback function +function Program:getDoneCallback(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 + +---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 + +---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 + +---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 Path property. +---@param self Program self +---@return string "" The path to the program +function Program:getPath(self) 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 + +---Sets the value of the DoneCallback property. +---@param self Program self +---@param DoneCallback function The done callback function +function Program:setDoneCallback(self, DoneCallback) end + +---Gets the value of the ErrorCallback property. +---@param self Program self +---@return function nil The error callback function +function Program:getErrorCallback(self) 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 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 + +---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 Program property. +---@param self Program self +---@param Program table The program instance +function Program:setProgram(self, Program) end + +---@class AnimationInstance +local AnimationInstance = {} + +---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 + +---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 + ---@class Display : VisualElement local Display = {} @@ -5485,35 +3632,905 @@ function Display:init(props, basalt) end ---@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. ----@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. +---@protected +function Display:render() 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 = {} + +---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 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 + +---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 + +---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 wrapped lines of the Label +---@return table wrappedText The wrapped lines of the Label +function Label:getWrappedText() 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 + +---@class BarChart : Graph +local BarChart = {} + +---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 BarChart self The initialized instance +---@protected +function BarChart:init(props, basalt) end + +---Renders the bar chart by calculating bar positions and heights based on data values +---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 BarChart:render() end + +---@class ComboBox : DropDown +---@field text string The current text value of the input field +---@field viewOffset number Horizontal scroll position for viewing long text +---@field cursorPos number Current cursor position in the text input +---@field manuallyOpened boolean Indicates if dropdown was opened by user action +---@field autoComplete boolean Enables filtering dropdown items while typing +---@field editable boolean Enables direct text input in the field +local ComboBox = {} + +---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 + +---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 + +---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 + +---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 ManuallyOpened property. +---@param self ComboBox self +---@return boolean false Indicates if dropdown was opened by user action +function ComboBox:getManuallyOpened(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 + +---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 + +---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 value of the ViewOffset property. +---@param self ComboBox self +---@return number 0 Horizontal scroll position for viewing long text +function ComboBox:getViewOffset(self) end + +---Handles mouse up events for item selection +---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-coordinate of the release +---@param y number The y-coordinate of the release +---@return boolean handled Whether the event was handled +---@protected +function ComboBox:mouse_up(button, x, y) 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 + +---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 + +---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 + +---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 + +---Creates a new ComboBox instance +---@return ComboBox self The newly created ComboBox instance +function ComboBox.new() 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 + +---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 + +---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 + +---@class TextBox : VisualElement +---@field autoCompleteMaxWidth number Maximum width of the autocomplete popup (0 uses the textbox width) +---@field autoPairSkipClosing boolean Skip inserting a closing char if the same one is already at cursor +---@field scrollX number Horizontal scroll offset +---@field scrollY number Vertical scroll offset +---@field lines table Array of text lines +---@field autoCompleteProvider function Optional suggestion provider returning a list for the current prefix +---@field autoCompleteAcceptOnClick boolean Whether clicking a suggestion accepts it immediately +---@field autoCompleteTokenPattern string Pattern used to extract the current token for suggestions +---@field autoCompleteEnabled boolean Whether autocomplete suggestions are enabled +---@field autoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively +---@field autoPairEnabled boolean Whether automatic bracket/quote pairing is enabled +---@field autoCompleteForeground color Foreground color of the suggestion popup +---@field cursorX number Cursor X position +---@field autoCompleteOffsetX number Horizontal offset applied to the popup frame relative to the TextBox +---@field autoCompleteZOffset number Z-index offset applied to the popup frame +---@field cursorColor number Color of the cursor +---@field autoCompleteAcceptOnEnter boolean Whether pressing Enter accepts the current suggestion +---@field autoCompleteItems table List of suggestions used when no provider is supplied +---@field autoCompleteShowBorder boolean Whether to render a character border around the popup +---@field autoCompleteSelectedForeground color Foreground color for the selected suggestion +---@field autoCompleteMaxItems number Maximum number of visible suggestions +---@field autoCompleteMinChars number Minimum characters required before showing suggestions +---@field syntaxPatterns table Syntax highlighting patterns +---@field autoCompleteCloseOnEscape boolean Whether pressing Escape closes the popup +---@field autoCompleteBorderColor color Color of the popup border when enabled +---@field cursorY number Cursor Y position (line number) +---@field editable boolean Whether text can be edited +---@field autoPairCharacters table ["("]=")", ["["]="]", ["{"]="}", ['"']='"', ['\'']='\'', ['`']='`'} Mapping of opening to closing characters for auto pairing +---@field autoCompleteSelectedBackground color Background color for the selected suggestion +---@field autoCompleteOffsetY number Vertical offset applied to the popup frame relative to the TextBox bottom edge +---@field autoPairOverType boolean When pressing a closing char that matches the next char, move over it instead of inserting +---@field autoPairNewlineIndent boolean On Enter between matching braces, create blank line and keep closing aligned +---@field autoCompleteBackground color Background color of the suggestion popup +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. +---@protected +function TextBox:paste() 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 CursorY property. +---@param self TextBox self +---@param CursorY number Cursor Y position (line number) +function TextBox:setCursorY(self, CursorY) end + +---Updates the viewport to keep the cursor in view +---@return TextBox self The TextBox instance +function TextBox:updateViewport() 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 AutoCompleteItems property. +---@param self TextBox self +---@param AutoCompleteItems table List of suggestions used when no provider is supplied +function TextBox:setAutoCompleteItems(self, AutoCompleteItems) 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 + +---Gets the value of the CursorX property. +---@param self TextBox self +---@return number 1 Cursor X position +function TextBox:getCursorX(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 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 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 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 + +---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 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 AutoCompleteSelectedBackground property. +---@param self TextBox self +---@param AutoCompleteSelectedBackground color Background color for the selected suggestion +function TextBox:setAutoCompleteSelectedBackground(self, AutoCompleteSelectedBackground) 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 Editable property. +---@param self TextBox self +---@return boolean true Whether text can be edited +function TextBox:getEditable(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 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 AutoCompleteEnabled property. +---@param self TextBox self +---@return boolean false Whether autocomplete suggestions are enabled +function TextBox:getAutoCompleteEnabled(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 AutoCompleteSelectedBackground property. +---@param self TextBox self +---@return color gray Background color for the selected suggestion +function TextBox:getAutoCompleteSelectedBackground(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 + +---Sets the value of the ScrollX property. +---@param self TextBox self +---@param ScrollX number Horizontal scroll offset +function TextBox:setScrollX(self, ScrollX) end + +function TextBox:destroy() 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 + +---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 AutoCompleteCaseInsensitive property. +---@param self TextBox self +---@param AutoCompleteCaseInsensitive boolean Whether suggestions should match case-insensitively +function TextBox:setAutoCompleteCaseInsensitive(self, AutoCompleteCaseInsensitive) end + +---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 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 AutoCompleteMaxItems property. +---@param self TextBox self +---@param AutoCompleteMaxItems number Maximum number of visible suggestions +function TextBox:setAutoCompleteMaxItems(self, AutoCompleteMaxItems) end + +---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 + +---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 + +---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 + +---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 + +---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 AutoCompleteShowBorder property. +---@param self TextBox self +---@return boolean true Whether to render a character border around the popup +function TextBox:getAutoCompleteShowBorder(self) end + +---Clears all syntax highlighting patterns +---@return TextBox self +function TextBox:clearSyntaxPatterns() 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 + +---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 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 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 + +---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 AutoCompleteCloseOnEscape property. +---@param self TextBox self +---@return boolean true Whether pressing Escape closes the popup +function TextBox:getAutoCompleteCloseOnEscape(self) end + +---Sets the value of the ScrollY property. +---@param self TextBox self +---@param ScrollY number Vertical scroll offset +function TextBox:setScrollY(self, ScrollY) 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 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 AutoCompleteBackground property. +---@param self TextBox self +---@param AutoCompleteBackground color Background color of the suggestion popup +function TextBox:setAutoCompleteBackground(self, AutoCompleteBackground) 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 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 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 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. +---@protected +function TextBox:render() 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 + +---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 CursorY property. +---@param self TextBox self +---@return number 1 Cursor Y position (line number) +function TextBox:getCursorY(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 + +---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 + +---Gets the value of the CursorColor property. +---@param self TextBox self +---@return number nil Color of the cursor +function TextBox:getCursorColor(self) 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 CursorColor property. +---@param self TextBox self +---@param CursorColor number Color of the cursor +function TextBox:setCursorColor(self, CursorColor) 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 AutoCompleteForeground property. +---@param self TextBox self +---@param AutoCompleteForeground color Foreground color of the suggestion popup +function TextBox:setAutoCompleteForeground(self, AutoCompleteForeground) 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 AutoCompleteItems property. +---@param self TextBox self +---@return table {} List of suggestions used when no provider is supplied +function TextBox:getAutoCompleteItems(self) end + +---Gets the value of the SyntaxPatterns property. +---@param self TextBox self +---@return table {} Syntax highlighting patterns +function TextBox:getSyntaxPatterns(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 + +---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 Lines property. +---@param self TextBox self +---@param Lines table Array of text lines +function TextBox:setLines(self, Lines) 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 + +---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 + +---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 + +---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 Lines property. +---@param self TextBox self +---@return table {} Array of text lines +function TextBox:getLines(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 + +---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 ScrollX property. +---@param self TextBox self +---@return number 0 Horizontal scroll offset +function TextBox:getScrollX(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 + +---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 + +---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 + +---@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 + +---@param name string The name of the series +---@return Graph self The graph instance +function Graph:focusSeries(name) end + +---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 +---@return Graph self The graph instance +function Graph:removeSeries(name) 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 +---@return table ? series The series +function Graph:getSeries(name) 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 MaxValue property. +---@param self Graph self +---@return number 100 The maximum value of the graph +function Graph:getMaxValue(self) 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 + +---@class SideNav : Container +---@field sidebarWidth number Width of the sidebar navigation area +---@field sidebarPosition string Position of the sidebar ("left" or "right") +---@field activeTab number The currently active navigation item ID +---@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 +---@field tabs table List of navigation item definitions +local SideNav = {} + +---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 + +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:textBg() end + +function SideNav:getRelativePosition() 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:drawText() end + +function SideNav: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 child table The child element to check +---@return boolean Whether the child should be visible +---@protected +function SideNav:isChildVisible(child) 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 ActiveTabTextColor property. +---@param self SideNav self +---@return color black Foreground color for the active navigation item text +function SideNav:getActiveTabTextColor(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 (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 + +---@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 + +---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 + +---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 + +---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 + +---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:mouse_move() 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 + +---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_scroll() end + +function SideNav:mouse_up() end + +function SideNav:textFg() 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:multiBlit() 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:_getSidebarMetrics() end + +function SideNav:drawFg() 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. +---@param props table The properties to initialize the element with +---@param basalt table The basalt instance +---@protected +function SideNav:init(props, basalt) end + +function SideNav:blit() 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 + +---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 + +function SideNav:mouse_drag() end + +---@param tabId number The ID of the navigation item to activate +function SideNav: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 add +---@return Container self For method chaining +---@protected +function SideNav:addChild(child) 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 + +---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 ActiveTab property. +---@param self SideNav self +---@return number nil The currently active navigation item ID +function SideNav:getActiveTab(self) end + +function SideNav:drawBg() 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 + +---Gets the value of the Tabs property. +---@param self SideNav self +---@return table {} List of navigation item definitions +function SideNav:getTabs(self) end + ---@class ScrollBar : VisualElement +---@field max number Maximum scroll value ---@field symbol string " Symbol used for the ScrollBar handle +---@field symbolBackgroundColor color Background color of the ScrollBar handle +---@field orientation string Orientation of the ScrollBar ("vertical" or "horizontal") +---@field attachedProperty string nil The property being controlled +---@field maxValue number 100 Maximum value or function that returns it +---@field minValue number 0 Minimum value or function that returns it +---@field min number Minimum scroll value ---@field handleSize number Size of the ScrollBar handle in characters ---@field attachedElement table nil The element this ScrollBar is attached to ---@field backgroundSymbol string Symbol used for the ScrollBar background ----@field symbolBackgroundColor color Background color of the ScrollBar handle ----@field orientation string Orientation of the ScrollBar ("vertical" or "horizontal") ----@field value number Current scroll value ----@field maxValue number 100 Maximum value or function that returns it ----@field minValue number 0 Minimum value or function that returns it ---@field step number Step size for scroll operations ----@field attachedProperty string nil The property being controlled ----@field max number Maximum scroll value ---@field dragMultiplier number How fast the ScrollBar moves when dragging ----@field min number Minimum scroll value +---@field value number Current scroll value local ScrollBar = {} ----Gets the value of the MinValue property. +---Gets the value of the SymbolBackgroundColor property. ---@param self ScrollBar self ----@return number |function 0 Minimum value or function that returns it -function ScrollBar:getMinValue(self) end +---@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 ---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) @@ -5523,15 +4540,123 @@ function ScrollBar:getMinValue(self) end ---@protected function ScrollBar:mouse_scroll(direction, x, y) end ----Sets the value of the Step property. +---Sets the value of the AttachedElement property. ---@param self ScrollBar self ----@param Step number Step size for scroll operations -function ScrollBar:setStep(self, Step) end +---@param AttachedElement table nil The element this ScrollBar is attached to +function ScrollBar:setAttachedElement(self, AttachedElement) end ----Gets the value of the SymbolBackgroundColor property. +---Sets the value of the MinValue property. ---@param self ScrollBar self ----@return color black Background color of the ScrollBar handle -function ScrollBar:getSymbolBackgroundColor(self) end +---@param MinValue number 0 Minimum value or function that returns it +function ScrollBar:setMinValue(self, MinValue) 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 + +---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 SymbolBackgroundColor property. +---@param self ScrollBar self +---@param SymbolBackgroundColor color Background color of the ScrollBar handle +function ScrollBar:setSymbolBackgroundColor(self, SymbolBackgroundColor) 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 + +---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 + +---Gets the value of the Symbol property. +---@param self ScrollBar self +---@return string " " Symbol used for the ScrollBar handle +function ScrollBar:getSymbol(self) 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 MinValue property. +---@param self ScrollBar self +---@return number |function 0 Minimum value or function that returns it +function ScrollBar:getMinValue(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 Value property. +---@param self ScrollBar self +---@return number 0 Current scroll value +function ScrollBar:getValue(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 + +---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 Step property. +---@param self ScrollBar self +---@return number 1 Step size for scroll operations +function ScrollBar:getStep(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 + +---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 DragMultiplier property. +---@param self ScrollBar self +---@return number 1 How fast the ScrollBar moves when dragging +function ScrollBar:getDragMultiplier(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 + +---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 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 MaxValue property. +---@param self ScrollBar self +---@param MaxValue number 100 Maximum value or function that returns it +function ScrollBar:setMaxValue(self, MaxValue) end ---Sets the value of the Max property. ---@param self ScrollBar self @@ -5543,155 +4668,1041 @@ function ScrollBar:setMax(self, Max) end ---@return table ? nil The element this ScrollBar is attached to function ScrollBar:getAttachedElement(self) end ----Sets the value of the BackgroundSymbol property. +---Sets the value of the Step property. ---@param self ScrollBar self ----@param BackgroundSymbol string Symbol used for the ScrollBar background -function ScrollBar:setBackgroundSymbol(self, BackgroundSymbol) end - ----Gets the value of the Min property. ----@param self ScrollBar self ----@return number 0 Minimum scroll value -function ScrollBar:getMin(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 Value property. ----@param self ScrollBar self ----@param Value number Current scroll value -function ScrollBar:setValue(self, Value) end - ----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 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 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 Step property. ----@param self ScrollBar self ----@return number 1 Step size for scroll operations -function ScrollBar:getStep(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 - ----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 - ----Updates the attached element's property based on the ScrollBar value ----@return ScrollBar self The ScrollBar instance -function ScrollBar:updateAttachedElement() 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 Max property. ----@param self ScrollBar self ----@return number 100 Maximum scroll value -function ScrollBar:getMax(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 - ----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 - ----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 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 MaxValue property. ----@param self ScrollBar self ----@param MaxValue number 100 Maximum value or function that returns it -function ScrollBar:setMaxValue(self, MaxValue) end - ----Sets the value of the Min property. ----@param self ScrollBar self ----@param Min number Minimum scroll value -function ScrollBar:setMin(self, Min) end - ----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 - ----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 - ----Gets the value of the AttachedProperty property. ----@param self ScrollBar self ----@return string ? nil The property being controlled -function ScrollBar:getAttachedProperty(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 - ----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 Orientation property. ----@param self ScrollBar self ----@return string vertical Orientation of the ScrollBar ("vertical" or "horizontal") -function ScrollBar:getOrientation(self) end +---@param Step number Step size for scroll operations +function ScrollBar:setStep(self, Step) 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 MaxValue property. +---Gets the value of the AttachedProperty property. ---@param self ScrollBar self ----@return number |function 100 Maximum value or function that returns it -function ScrollBar:getMaxValue(self) end +---@return string ? nil The property being controlled +function ScrollBar:getAttachedProperty(self) end ----Sets the value of the Orientation property. +---Sets the value of the Value property. ---@param self ScrollBar self ----@param Orientation string Orientation of the ScrollBar ("vertical" or "horizontal") -function ScrollBar:setOrientation(self, Orientation) end +---@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 +---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 Min property. +---@param self ScrollBar self +---@return number 0 Minimum scroll value +function ScrollBar:getMin(self) end + +---Updates the attached element's property based on the ScrollBar value +---@return ScrollBar self The ScrollBar instance +function ScrollBar:updateAttachedElement() end + +---@class Benchmark +local Benchmark = {} + +---Clears all custom benchmarks +function API.clearAll() end + +---Clears a specific benchmark +---@param name string The name of the benchmark to clear +function API.clear(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 + +---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 + +---@class Menu : List +---@field maxWidth number Maximum width before scrolling is enabled (nil = auto-size to items) +---@field spacing number The number of spaces between menu items +---@field separatorColor color The color used for separator items in the menu +---@field horizontalOffset number Current horizontal scroll offset +local Menu = {} + +---Gets the value of the MaxWidth property. +---@param self Menu self +---@return number nil Maximum width before scrolling is enabled (nil = auto-size to items) +function Menu:getMaxWidth(self) end + +---Gets the value of the HorizontalOffset property. +---@param self Menu self +---@return number 0 Current horizontal scroll offset +function Menu:getHorizontalOffset(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 Menu self The initialized instance +---@protected +function Menu:init(props, basalt) end + +---Gets the value of the Spacing property. +---@param self Menu self +---@return number 0 The number of spaces between menu items +function Menu:getSpacing(self) end + +---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 + +---Calculates the total width of all menu items with spacing +---@return number totalWidth The total width of all items +function Menu:getTotalWidth() 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: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. +---@protected +function Menu:mouse_click() end + +---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 value of the HorizontalOffset property. +---@param self Menu self +---@param HorizontalOffset number Current horizontal scroll offset +function Menu:setHorizontalOffset(self, HorizontalOffset) end + +---Sets the value of the Spacing property. +---@param self Menu self +---@param Spacing number The number of spaces between menu items +function Menu:setSpacing(self, Spacing) end + +---Sets the value of the MaxWidth property. +---@param self Menu self +---@param MaxWidth number Maximum width before scrolling is enabled (nil = auto-size to items) +function Menu:setMaxWidth(self, MaxWidth) end + +---@class ErrorHandler +local ErrorHandler = {} + +---Handles an error +---@param errMsg string The error message +function errorHandler.error(errMsg) end + +---@class TabControl : Container +---@field tabHeight number Height of the tab header area +---@field scrollableTab boolean Enables scroll mode for tabs if they exceed width +---@field activeTab number The currently active tab ID +---@field tabScrollOffset number Current scroll offset for tabs in scrollable mode +---@field activeTabTextColor color Foreground color for the active tab text +---@field activeTabBackground color Background color for the active tab +---@field tabs table List of tab definitions +---@field headerBackground color Background color for the tab header area +local TabControl = {} + +---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 + +function TabControl:mouse_up() end + +function TabControl: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 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 + +---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 + +---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 + +function TabControl:mouse_drag() end + +function TabControl:mouse_scroll() 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. +---@return number yOffset The Y offset for content +---@protected +function TabControl:getContentYOffset() end + +---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:drawFg() 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 HeaderBackground property. +---@param self TabControl self +---@return color gray Background color for the tab header area +function TabControl:getHeaderBackground(self) 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 + +---@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 + +---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 + +---@param tabId number The ID of the tab to activate +function TabControl:setActiveTab(tabId) end + +function TabControl:blit() 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 + +---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 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. +---@protected +function TabControl:render() end + +function TabControl:setCursor() 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 + +function TabControl:mouse_move() end + +function TabControl:drawBg() 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:textBg() 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. +---@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 ActiveTabTextColor property. +---@param self TabControl self +---@return color black Foreground color for the active tab text +function TabControl:getActiveTabTextColor(self) end + +function TabControl:getRelativePosition() 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 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 ActiveTabBackground property. +---@param self TabControl self +---@return color white Background color for the active tab +function TabControl:getActiveTabBackground(self) 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 + +---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 + +---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:_getHeaderMetrics() end + +function TabControl:multiBlit() end + +---@class Toast : VisualElement +---@field autoHide boolean Whether the toast should automatically hide after duration +---@field duration number Duration in seconds before the toast auto-hides +---@field toastType string Type of toast: default, success, error, warning, info +---@field message string The message text of the toast +---@field colorMap table of toast types to their colors +---@field active boolean Whether the toast is currently showing a message +---@field title string The title text of the toast +local Toast = {} + +---Gets the value of the Duration property. +---@param self Toast self +---@return number 3 Duration in seconds before the toast auto-hides +function Toast:getDuration(self) end + +---Sets the value of the ToastType property. +---@param self Toast self +---@param ToastType string Type of toast: default, success, error, warning, info +function Toast:setToastType(self, ToastType) end + +---Shows a warning toast +---@param titleOrMessage string The title or message +---@return Toast self The Toast instance +function Toast:warning(titleOrMessage) end + +---Sets the value of the Message property. +---@param self Toast self +---@param Message string The message text of the toast +function Toast:setMessage(self, Message) end + +---Gets the value of the AutoHide property. +---@param self Toast self +---@return boolean true Whether the toast should automatically hide after duration +function Toast:getAutoHide(self) end + +---Shows an error toast +---@param titleOrMessage string The title or message +---@return Toast self The Toast instance +function Toast:error(titleOrMessage) end + +---Gets the value of the Message property. +---@param self Toast self +---@return string "" The message text of the toast +function Toast:getMessage(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 Toast:dispatchEvent() end + +---Shows a success toast +---@param titleOrMessage string The title or message +---@return Toast self The Toast instance +function Toast:success(titleOrMessage) end + +---Hides the toast +---@return Toast self The Toast instance +function Toast:hide() end + +---Renders the toast +---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 Toast:render() end + +---Gets the value of the ColorMap property. +---@param self Toast self +---@return table Map of toast types to their colors +function Toast:getColorMap(self) end + +---Gets the value of the Title property. +---@param self Toast self +---@return string "" The title text of the toast +function Toast:getTitle(self) end + +---Shows a toast message +---@param titleOrMessage string The title (if message provided) or the message (if no message) +---@return Toast self The Toast instance +function Toast:show(titleOrMessage) end + +---Shows an info toast +---@param titleOrMessage string The title or message +---@return Toast self The Toast instance +function Toast:info(titleOrMessage) end + +---Gets the value of the Active property. +---@param self Toast self +---@return boolean false Whether the toast is currently showing a message +function Toast:getActive(self) end + +---Sets the value of the AutoHide property. +---@param self Toast self +---@param AutoHide boolean Whether the toast should automatically hide after duration +function Toast:setAutoHide(self, AutoHide) end + +---Sets the value of the Title property. +---@param self Toast self +---@param Title string The title text of the toast +function Toast:setTitle(self, Title) end + +---Sets the value of the ColorMap property. +---@param self Toast self +---@param ColorMap table of toast types to their colors +function Toast:setColorMap(self, ColorMap) end + +---Sets the value of the Duration property. +---@param self Toast self +---@param Duration number Duration in seconds before the toast auto-hides +function Toast:setDuration(self, Duration) end + +---Gets the value of the ToastType property. +---@param self Toast self +---@return string "default" Type of toast: default, success, error, warning, info +function Toast:getToastType(self) end + +---Sets the value of the Active property. +---@param self Toast self +---@param Active boolean Whether the toast is currently showing a message +function Toast:setActive(self, Active) end + +---@class Breadcrumb : VisualElement +---@field path table Array of strings representing the breadcrumb segments +---@field autoSize false Whether to resize the element width automatically based on text +---@field clickable true Whether the segments are clickable +local Breadcrumb = {} + +---Sets the value of the Clickable property. +---@param self Breadcrumb self +---@param Clickable true Whether the segments are clickable +function Breadcrumb:setClickable(self, Clickable) end + +---Gets the value of the Path property. +---@param self Breadcrumb self +---@return table {} Array of strings representing the breadcrumb segments +function Breadcrumb:getPath(self) end + +---Gets the value of the AutoSize property. +---@param self Breadcrumb self +---@return false boolean Whether to resize the element width automatically based on text +function Breadcrumb:getAutoSize(self) end + +---Gets the value of the Clickable property. +---@param self Breadcrumb self +---@return true boolean Whether the segments are clickable +function Breadcrumb:getClickable(self) end + +---Registers a callback for the select event +---@param callback function The callback function to register +---@return Breadcrumb self The Breadcrumb instance +function Breadcrumb:onSelect(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. +---@protected +function Breadcrumb:render() end + +---@return table self +function Breadcrumb.new() end + +---@param button number +---@param x number +---@param y number +---@return boolean handled +function Breadcrumb:mouse_click(button, x, y) end + +---Sets the value of the Path property. +---@param self Breadcrumb self +---@param Path table Array of strings representing the breadcrumb segments +function Breadcrumb:setPath(self, Path) end + +---@param props table +---@param basalt table +function Breadcrumb:init(props, basalt) end + +---Sets the value of the AutoSize property. +---@param self Breadcrumb self +---@param AutoSize false Whether to resize the element width automatically based on text +function Breadcrumb:setAutoSize(self, AutoSize) end + +---@class Table : Collection +---@field customSortFunction table Custom sort functions for columns +---@field sortColumn number nil Currently sorted column index +---@field headerColor color Color of the column headers +---@field offset number Scroll offset for vertical scrolling +---@field sortDirection string Sort direction ("asc" or "desc") +---@field scrollBarSymbol string " Symbol used for the scrollbar handle +---@field gridColor color Color of grid lines +---@field columns table List of column definitions with {name, width} properties +---@field scrollBarColor color Color of the scrollbar handle +---@field showScrollBar boolean Whether to show the scrollbar when items exceed height +---@field scrollBarBackgroundColor color Background color of the scrollbar +---@field scrollBarBackground string Symbol used for the scrollbar background +local Table = {} + +---Clears all table data +---@return Table self The Table instance +function Table:clearData() 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 ScrollBarColor property. +---@param self Table self +---@return color lightGray Color of the scrollbar handle +function Table:getScrollBarColor(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 HeaderColor property. +---@param self Table self +---@param HeaderColor color Color of the column headers +function Table:setHeaderColor(self, HeaderColor) end + +---Gets the currently selected row +---@return table ? row The selected row or nil +function Table:getSelectedRow() end + +---Gets the value of the ScrollBarBackgroundColor property. +---@param self Table self +---@return color gray Background color of the scrollbar +function Table:getScrollBarBackgroundColor(self) 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 + +---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: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. +---@protected +function Table:mouse_click() end + +---Removes a row by index +---@param rowIndex number The index of the row to remove +---@return Table self The Table instance +function Table:removeRow(rowIndex) 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 ScrollBarBackground property. +---@param self Table self +---@return string "\127" Symbol used for the scrollbar background +function Table:getScrollBarBackground(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 + +---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:mouse_up() 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 ShowScrollBar property. +---@param self Table self +---@return boolean true Whether to show the scrollbar when items exceed height +function Table:getShowScrollBar(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 ScrollBarSymbol property. +---@param self Table self +---@return string " " Symbol used for the scrollbar handle +function Table:getScrollBarSymbol(self) end + +---Sets the value of the ScrollBarBackground property. +---@param self Table self +---@param ScrollBarBackground string Symbol used for the scrollbar background +function Table:setScrollBarBackground(self, ScrollBarBackground) end + +---Gets a row by index +---@param rowIndex number The index of the row +---@return table ? row The row data or nil +function Table:getRow(rowIndex) end + +---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 + +---Sets the value of the ShowScrollBar property. +---@param self Table self +---@param ShowScrollBar boolean Whether to show the scrollbar when items exceed height +function Table:setShowScrollBar(self, ShowScrollBar) end + +---Registers callback for row selection +---@param callback function The callback function(rowIndex, row) +---@return Table self The Table instance +function Table:onRowSelect(callback) 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:sortByColumn(columnIndex, fn) end + +---Sets the value of the Offset property. +---@param self Table self +---@param Offset number Scroll offset for vertical scrolling +function Table:setOffset(self, Offset) end + +---Gets all table data +---@return table data Array of row cell arrays +function Table:getData() end + +---Updates a specific cell value +---@param rowIndex number The row index +---@param colIndex number The column index +---@param value any The new value +---@return Table self The Table instance +function Table:updateCell(rowIndex, colIndex, value) end + +---Adds a new row to the table +---@return Table self The Table instance +function Table:addRow() 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 HeaderColor property. +---@param self Table self +---@return color blue Color of the column headers +function Table:getHeaderColor(self) end + +---Set data with automatic formatting +---@param rawData table The raw data array (array of row arrays) +---@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 GridColor property. +---@param self Table self +---@param GridColor color Color of grid lines +function Table:setGridColor(self, GridColor) end + +---Registers a function to handle the onRowSelect event. +---@param rowIndex number +---@param row table +---@param self Table self +---@param func function The function to be called when the event fires +function Table:onOnRowSelect(self, func) end + +---Sets the value of the ScrollBarBackgroundColor property. +---@param self Table self +---@param ScrollBarBackgroundColor color Background color of the scrollbar +function Table:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end + +---Gets the value of the GridColor property. +---@param self Table self +---@return color gray Color of grid lines +function Table:getGridColor(self) end + +---Gets the value of the Offset property. +---@param self Table self +---@return number 0 Scroll offset for vertical scrolling +function Table:getOffset(self) end + +---Sets the value of the ScrollBarColor property. +---@param self Table self +---@param ScrollBarColor color Color of the scrollbar handle +function Table:setScrollBarColor(self, ScrollBarColor) end + +---Sets the value of the ScrollBarSymbol property. +---@param self Table self +---@param ScrollBarSymbol string " Symbol used for the scrollbar handle +function Table:setScrollBarSymbol(self, ScrollBarSymbol) end + +---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:mouse_drag() end + +---Gets the value of the SortColumn property. +---@param self Table self +---@return number ? nil Currently sorted column index +function Table:getSortColumn(self) end + +---Adds a new column to the table +---@param name string The name of the column +---@param width number |string The width of the column (number, "auto", or "30%") +---@return Table self The Table instance +function Table:addColumn(name, width) 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 + +---@class Switch : VisualElement +---@field text string to display next to switch +---@field checked boolean switch is checked +---@field autoSize boolean to automatically size the element to fit switch and text +---@field offBackground number color when OFF +---@field onBackground number color when ON +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 + +---Gets the value of the OffBackground property. +---@param self Switch self +---@return number Background color when OFF +function Switch:getOffBackground(self) end + +---Gets the value of the Checked property. +---@param self Switch self +---@return boolean Whether switch is checked +function Switch: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 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 OnBackground property. +---@param self Switch self +---@param OnBackground number color when ON +function Switch:setOnBackground(self, OnBackground) 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 + +---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 + +---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 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 Checked property. +---@param self Switch self +---@param Checked boolean switch is checked +function Switch:setChecked(self, Checked) 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 OffBackground property. +---@param self Switch self +---@param OffBackground number color when OFF +function Switch:setOffBackground(self, OffBackground) end + +---Gets the value of the OnBackground property. +---@param self Switch self +---@return number Background color when ON +function Switch:getOnBackground(self) end + +---@class List : Collection +---@field emptyText string items" Text to display when the list is empty +---@field scrollBarBackgroundColor color Background color of the scrollbar +---@field scrollBarSymbol string " Symbol used for the scrollbar handle +---@field scrollBarColor color Color of the scrollbar handle +---@field showScrollBar boolean Whether to show the scrollbar when items exceed height +---@field offset number Current scroll offset for viewing long lists +---@field scrollBarBackground string Symbol used for the scrollbar background +local List = {} + +---Gets the value of the EmptyText property. +---@param self List self +---@return string "No items" Text to display when the list is empty +function List:getEmptyText(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-coordinate of the drag +---@param y number The y-coordinate of the drag +---@return boolean Whether the event was handled +---@protected +function List: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. +---@protected +function List:render() end + +---Gets the value of the ScrollBarBackground property. +---@param self List self +---@return string "\127" Symbol used for the scrollbar background +function List:getScrollBarBackground(self) end + +---Scrolls the list to the top +---@return List self The List instance +function List:scrollToTop() 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 + +---Gets the value of the ShowScrollBar property. +---@param self List self +---@return boolean true Whether to show the scrollbar when items exceed height +function List:getShowScrollBar(self) end + +---Sets the value of the ScrollBarColor property. +---@param self List self +---@param ScrollBarColor color Color of the scrollbar handle +function List:setScrollBarColor(self, ScrollBarColor) end + +---Sets the value of the ShowScrollBar property. +---@param self List self +---@param ShowScrollBar boolean Whether to show the scrollbar when items exceed height +function List:setShowScrollBar(self, ShowScrollBar) end + +---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 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 + +---Sets the value of the ScrollBarSymbol property. +---@param self List self +---@param ScrollBarSymbol string " Symbol used for the scrollbar handle +function List:setScrollBarSymbol(self, ScrollBarSymbol) 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 + +---Handles key events for keyboard navigation +---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 keyCode number The key code +---@return boolean Whether the event was handled +---@protected +function List:key(keyCode) end + +---Scrolls the list to the bottom +---@return List self The List instance +function List:scrollToBottom() end + +---Gets the value of the ScrollBarColor property. +---@param self List self +---@return color lightGray Color of the scrollbar handle +function List:getScrollBarColor(self) end + +---Registers a function to handle the onSelect event. +---@param List self +---@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 + +---Scrolls to make a specific item visible +---@param index number The index of the item to scroll to +---@return List self The List instance +function List:scrollToItem(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 button number The mouse button that was released +---@param x number The x-coordinate of the release +---@param y number The y-coordinate of the release +---@return boolean Whether the event was handled +---@protected +function List: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 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 + +---Sets the value of the ScrollBarBackgroundColor property. +---@param self List self +---@param ScrollBarBackgroundColor color Background color of the scrollbar +function List:setScrollBarBackgroundColor(self, ScrollBarBackgroundColor) end + +---Sets the value of the ScrollBarBackground property. +---@param self List self +---@param ScrollBarBackground string Symbol used for the scrollbar background +function List:setScrollBarBackground(self, ScrollBarBackground) 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 EmptyText property. +---@param self List self +---@param EmptyText string items" Text to display when the list is empty +function List:setEmptyText(self, EmptyText) end + +---Gets the value of the ScrollBarBackgroundColor property. +---@param self List self +---@return color gray Background color of the scrollbar +function List:getScrollBarBackgroundColor(self) end + +---Gets the value of the ScrollBarSymbol property. +---@param self List self +---@return string " " Symbol used for the scrollbar handle +function List:getScrollBarSymbol(self) end + +---@class Timer : BaseElement +---@field interval number The interval in seconds at which the timer will trigger its action. +---@field amount number The amount of time the timer should run. +---@field running boolean Indicates whether the timer is currently running or not. +---@field action function The action to be performed when the timer triggers. +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 + +---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 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 + +---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 + +---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 + +---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 Action property. +---@param self Timer self +---@return function function The action to be performed when the timer triggers. +function Timer:getAction(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 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 + +---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 + +---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 + +---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 + +---@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 + diff --git a/config.lua b/config.lua index 2f85eb7..25098a1 100644 --- a/config.lua +++ b/config.lua @@ -1,509 +1,517 @@ return { + ["metadata"] = { + ["version"] = "2.0", + ["generated"] = "Tue Nov 4 21:41:15 2025", + }, ["categories"] = { - ["core"] = { - ["description"] = "Core Files", + ["libraries"] = { ["files"] = { - ["main"] = { - ["size"] = 19883, - ["path"] = "main.lua", + ["utils"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "libraries/utils.lua", + ["size"] = 2661, ["default"] = true, + ["description"] = "", }, - ["errorManager"] = { - ["size"] = 3789, - ["path"] = "errorManager.lua", + ["collectionentry"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "libraries/collectionentry.lua", + ["size"] = 3551, ["default"] = true, + ["description"] = "", }, - ["elementManager"] = { - ["size"] = 15411, - ["path"] = "elementManager.lua", + ["expect"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "libraries/expect.lua", + ["size"] = 846, ["default"] = true, + ["description"] = "", }, - ["render"] = { - ["size"] = 12422, - ["path"] = "render.lua", + ["colorHex"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "libraries/colorHex.lua", + ["size"] = 132, ["default"] = true, - }, - ["propertySystem"] = { - ["size"] = 18186, - ["path"] = "propertySystem.lua", - ["requires"] = { - }, ["description"] = "", - ["default"] = true, - }, - ["layoutManager"] = { - ["size"] = 3634, - ["path"] = "layoutManager.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - ["init"] = { - ["size"] = 622, - ["path"] = "init.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - ["log"] = { - ["size"] = 3142, - ["path"] = "log.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, }, }, + ["description"] = "Libraries", + }, + ["core"] = { + ["files"] = { + ["init"] = { + ["requires"] = { + }, + ["path"] = "init.lua", + ["size"] = 622, + ["default"] = true, + ["description"] = "", + }, + ["elementManager"] = { + ["requires"] = { + }, + ["path"] = "elementManager.lua", + ["size"] = 15411, + ["default"] = true, + ["description"] = "", + }, + ["errorManager"] = { + ["requires"] = { + }, + ["path"] = "errorManager.lua", + ["size"] = 3789, + ["default"] = true, + ["description"] = "", + }, + ["log"] = { + ["requires"] = { + }, + ["path"] = "log.lua", + ["size"] = 3142, + ["default"] = true, + ["description"] = "", + }, + ["propertySystem"] = { + ["requires"] = { + }, + ["path"] = "propertySystem.lua", + ["size"] = 18186, + ["default"] = true, + ["description"] = "", + }, + ["render"] = { + ["requires"] = { + }, + ["path"] = "render.lua", + ["size"] = 12422, + ["default"] = true, + ["description"] = "", + }, + ["layoutManager"] = { + ["requires"] = { + }, + ["path"] = "layoutManager.lua", + ["size"] = 3634, + ["default"] = true, + ["description"] = "", + }, + ["main"] = { + ["requires"] = { + }, + ["path"] = "main.lua", + ["size"] = 19883, + ["default"] = true, + ["description"] = "", + }, + }, + ["description"] = "Core Files", }, ["elements"] = { - ["description"] = "UI Elements", ["files"] = { - ["Program"] = { - ["size"] = 12753, - ["path"] = "elements/Program.lua", + ["ContextMenu"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/ContextMenu.lua", + ["size"] = 10836, + ["default"] = false, + ["description"] = "A ContextMenu element that displays a menu with items and submenus.", + }, + ["Table"] = { + ["requires"] = { + [1] = "Collection", + }, + ["path"] = "elements/Table.lua", + ["size"] = 25766, + ["default"] = false, + ["description"] = "The Table is a sortable data grid with customizable columns, row selection, and scrolling capabilities.", + }, + ["Input"] = { ["requires"] = { [1] = "VisualElement", }, - ["description"] = "", - ["default"] = false, + ["path"] = "elements/Input.lua", + ["size"] = 9456, + ["default"] = true, + ["description"] = "A text input field with various features", }, - ["LineChart"] = { - ["size"] = 3172, - ["path"] = "elements/LineChart.lua", + ["BaseElement"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "elements/BaseElement.lua", + ["size"] = 18432, ["default"] = true, + ["description"] = "The base class for all UI elements in Basalt.", }, ["BarChart"] = { - ["size"] = 3507, - ["path"] = "elements/BarChart.lua", ["requires"] = { }, - ["description"] = "", + ["path"] = "elements/BarChart.lua", + ["size"] = 3547, ["default"] = true, + ["description"] = "", + }, + ["List"] = { + ["requires"] = { + [1] = "Collection", + }, + ["path"] = "elements/List.lua", + ["size"] = 15754, + ["default"] = true, + ["description"] = "A scrollable list of selectable items", + }, + ["BaseFrame"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/BaseFrame.lua", + ["size"] = 8972, + ["default"] = true, + ["description"] = "This is the base frame class. It is the root element of all elements and the only element without a parent.", + }, + ["Switch"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Switch.lua", + ["size"] = 3375, + ["default"] = false, + ["description"] = "The Switch is a standard Switch element with click handling and state management.", + }, + ["Image"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Image.lua", + ["size"] = 15372, + ["default"] = true, + ["description"] = "", + }, + ["Program"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Program.lua", + ["size"] = 12833, + ["default"] = false, + ["description"] = "", + }, + ["ProgressBar"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/ProgressBar.lua", + ["size"] = 3440, + ["default"] = true, + ["description"] = "", + }, + ["TabControl"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/TabControl.lua", + ["size"] = 21136, + ["default"] = false, + ["description"] = "A TabControl element that provides tabbed interface with multiple content areas.", + }, + ["Accordion"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/Accordion.lua", + ["size"] = 15169, + ["default"] = false, + ["description"] = "An Accordion element that provides collapsible panels with headers.", + }, + ["SideNav"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/SideNav.lua", + ["size"] = 22429, + ["default"] = false, + ["description"] = "A SideNav element that provides sidebar navigation with multiple content areas.", + }, + ["Toast"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Toast.lua", + ["size"] = 7945, + ["default"] = false, + ["description"] = "A toast notification element that displays temporary messages.", }, ["Timer"] = { - ["size"] = 2938, - ["path"] = "elements/Timer.lua", ["requires"] = { [1] = "BaseElement", }, - ["description"] = "", + ["path"] = "elements/Timer.lua", + ["size"] = 2962, ["default"] = false, - }, - ["List"] = { - ["size"] = 15474, - ["path"] = "elements/List.lua", - ["requires"] = { - [1] = "Collection", - }, - ["description"] = "A scrollable list of selectable items", - ["default"] = true, - }, - ["Image"] = { - ["size"] = 15076, - ["path"] = "elements/Image.lua", - ["requires"] = { - [1] = "VisualElement", - }, ["description"] = "", - ["default"] = true, - }, - ["Input"] = { - ["size"] = 9200, - ["path"] = "elements/Input.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A text input field with various features", - ["default"] = true, - }, - ["Collection"] = { - ["size"] = 7778, - ["path"] = "elements/Collection.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A collection of items", - ["default"] = true, - }, - ["SideNav"] = { - ["size"] = 22159, - ["path"] = "elements/SideNav.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "A SideNav element that provides sidebar navigation with multiple content areas.", - ["default"] = false, - }, - ["ProgressBar"] = { - ["size"] = 3398, - ["path"] = "elements/ProgressBar.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "", - ["default"] = true, - }, - ["Label"] = { - ["size"] = 3088, - ["path"] = "elements/Label.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A simple text display element that automatically resizes its width based on the text content.", - ["default"] = true, - }, - ["TextBox"] = { - ["size"] = 43530, - ["path"] = "elements/TextBox.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A multi-line text editor component with cursor support and text manipulation features", - ["default"] = false, }, ["Display"] = { - ["size"] = 4493, - ["path"] = "elements/Display.lua", ["requires"] = { [1] = "VisualElement", }, + ["path"] = "elements/Display.lua", + ["size"] = 4549, + ["default"] = false, ["description"] = "The Display is a special element which uses the CC Window API which you can use.", - ["default"] = false, - }, - ["Graph"] = { - ["size"] = 6933, - ["path"] = "elements/Graph.lua", - ["requires"] = { - }, - ["description"] = "A point based graph element", - ["default"] = false, - }, - ["BaseElement"] = { - ["size"] = 13870, - ["path"] = "elements/BaseElement.lua", - ["requires"] = { - }, - ["description"] = "The base class for all UI elements in Basalt.", - ["default"] = true, - }, - ["Accordion"] = { - ["size"] = 14937, - ["path"] = "elements/Accordion.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "An Accordion element that provides collapsible panels with headers.", - ["default"] = false, - }, - ["ContextMenu"] = { - ["size"] = 10660, - ["path"] = "elements/ContextMenu.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "A ContextMenu element that displays a menu with items and submenus.", - ["default"] = false, - }, - ["CheckBox"] = { - ["size"] = 3700, - ["path"] = "elements/CheckBox.lua", - ["requires"] = { - }, - ["description"] = "This is a checkbox. It is a visual element that can be checked.", - ["default"] = true, }, ["Button"] = { - ["size"] = 2437, + ["requires"] = { + [1] = "VisualElement", + }, ["path"] = "elements/Button.lua", - ["requires"] = { - [1] = "VisualElement", - }, + ["size"] = 2461, + ["default"] = true, ["description"] = "The Button is a standard button element with click handling and state management.", - ["default"] = true, - }, - ["Breadcrumb"] = { - ["size"] = 4381, - ["path"] = "elements/Breadcrumb.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A breadcrumb navigation element that displays the current path.", - ["default"] = false, - }, - ["Table"] = { - ["size"] = 25512, - ["path"] = "elements/Table.lua", - ["requires"] = { - [1] = "Collection", - }, - ["description"] = "The Table is a sortable data grid with customizable columns, row selection, and scrolling capabilities.", - ["default"] = false, - }, - ["ComboBox"] = { - ["size"] = 14751, - ["path"] = "elements/ComboBox.lua", - ["requires"] = { - [1] = "DropDown", - }, - ["description"] = "A ComboBox that combines dropdown selection with editable text input", - ["default"] = false, - }, - ["ScrollBar"] = { - ["size"] = 9689, - ["path"] = "elements/ScrollBar.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "A ScrollBar element that can be attached to other elements to control their scroll properties.", - ["default"] = false, - }, - ["BigFont"] = { - ["size"] = 21551, - ["path"] = "elements/BigFont.lua", - ["requires"] = { - [1] = "VisualElement", - }, - ["description"] = "", - ["default"] = false, - }, - ["Menu"] = { - ["size"] = 8582, - ["path"] = "elements/Menu.lua", - ["requires"] = { - [1] = "List", - }, - ["description"] = "A horizontal menu bar with selectable items.", - ["default"] = true, - }, - ["TabControl"] = { - ["size"] = 20900, - ["path"] = "elements/TabControl.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "A TabControl element that provides tabbed interface with multiple content areas.", - ["default"] = false, - }, - ["ScrollFrame"] = { - ["size"] = 17463, - ["path"] = "elements/ScrollFrame.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "A scrollable container that automatically displays scrollbars when content overflows.", - ["default"] = false, }, ["Slider"] = { - ["size"] = 5043, - ["path"] = "elements/Slider.lua", ["requires"] = { [1] = "VisualElement", }, - ["description"] = "A slider control element for selecting a value within a range.", + ["path"] = "elements/Slider.lua", + ["size"] = 5211, ["default"] = false, + ["description"] = "A slider control element for selecting a value within a range.", }, ["DropDown"] = { - ["size"] = 7886, - ["path"] = "elements/DropDown.lua", ["requires"] = { [1] = "List", }, + ["path"] = "elements/DropDown.lua", + ["size"] = 7988, + ["default"] = false, ["description"] = "A DropDown menu that shows a list of selectable items", - ["default"] = false, }, - ["Container"] = { - ["size"] = 27475, - ["path"] = "elements/Container.lua", + ["Label"] = { ["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", + ["path"] = "elements/Label.lua", + ["size"] = 3184, ["default"] = true, + ["description"] = "A simple text display element that automatically resizes its width based on the text content.", }, - ["Tree"] = { - ["size"] = 22168, - ["path"] = "elements/Tree.lua", + ["ScrollBar"] = { ["requires"] = { [1] = "VisualElement", }, - ["description"] = "", + ["path"] = "elements/ScrollBar.lua", + ["size"] = 9941, ["default"] = false, + ["description"] = "A ScrollBar element that can be attached to other elements to control their scroll properties.", + }, + ["Frame"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/Frame.lua", + ["size"] = 6742, + ["default"] = true, + ["description"] = "A frame element that serves as a grouping container for other elements.", + }, + ["CheckBox"] = { + ["requires"] = { + }, + ["path"] = "elements/CheckBox.lua", + ["size"] = 3748, + ["default"] = true, + ["description"] = "This is a checkbox. It is a visual element that can be checked.", + }, + ["BigFont"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/BigFont.lua", + ["size"] = 21675, + ["default"] = false, + ["description"] = "", + }, + ["TextBox"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/TextBox.lua", + ["size"] = 44462, + ["default"] = false, + ["description"] = "A multi-line text editor component with cursor support and text manipulation features", + }, + ["VisualElement"] = { + ["requires"] = { + [1] = "BaseElement", + }, + ["path"] = "elements/VisualElement.lua", + ["size"] = 45338, + ["default"] = true, + ["description"] = "The Visual Element class which is the base class for all visual UI elements", }, ["Dialog"] = { - ["size"] = 8901, - ["path"] = "elements/Dialog.lua", ["requires"] = { [1] = "Frame", }, + ["path"] = "elements/Dialog.lua", + ["size"] = 9125, + ["default"] = false, ["description"] = "A dialog overlay system with common presets (alert, confirm, prompt).", - ["default"] = false, }, - ["Switch"] = { - ["size"] = 3293, - ["path"] = "elements/Switch.lua", + ["Breadcrumb"] = { ["requires"] = { [1] = "VisualElement", }, - ["description"] = "The Switch is a standard Switch element with click handling and state management.", + ["path"] = "elements/Breadcrumb.lua", + ["size"] = 4461, ["default"] = false, + ["description"] = "A breadcrumb navigation element that displays the current path.", }, - ["Frame"] = { - ["size"] = 6646, - ["path"] = "elements/Frame.lua", - ["requires"] = { - [1] = "Container", - }, - ["description"] = "A frame element that serves as a grouping container for other elements.", - ["default"] = true, - }, - ["BaseFrame"] = { - ["size"] = 8972, - ["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.", - ["default"] = true, - }, - ["Toast"] = { - ["size"] = 7897, - ["path"] = "elements/Toast.lua", + ["Collection"] = { ["requires"] = { [1] = "VisualElement", }, - ["description"] = "A toast notification element that displays temporary messages.", - ["default"] = false, - }, - ["VisualElement"] = { - ["size"] = 45082, - ["path"] = "elements/VisualElement.lua", - ["requires"] = { - [1] = "BaseElement", - }, - ["description"] = "The Visual Element class which is the base class for all visual UI elements", + ["path"] = "elements/Collection.lua", + ["size"] = 7874, ["default"] = true, + ["description"] = "A collection of items", + }, + ["ScrollFrame"] = { + ["requires"] = { + [1] = "Container", + }, + ["path"] = "elements/ScrollFrame.lua", + ["size"] = 17831, + ["default"] = false, + ["description"] = "A scrollable container that automatically displays scrollbars when content overflows.", + }, + ["Tree"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Tree.lua", + ["size"] = 22552, + ["default"] = false, + ["description"] = "", + }, + ["Menu"] = { + ["requires"] = { + [1] = "List", + }, + ["path"] = "elements/Menu.lua", + ["size"] = 8758, + ["default"] = true, + ["description"] = "A horizontal menu bar with selectable items.", + }, + ["ComboBox"] = { + ["requires"] = { + [1] = "DropDown", + }, + ["path"] = "elements/ComboBox.lua", + ["size"] = 15143, + ["default"] = false, + ["description"] = "A ComboBox that combines dropdown selection with editable text input", + }, + ["Container"] = { + ["requires"] = { + [1] = "VisualElement", + }, + ["path"] = "elements/Container.lua", + ["size"] = 27731, + ["default"] = true, + ["description"] = "The container class. It is a visual element that can contain other elements. It is the base class for all containers", + }, + ["Graph"] = { + ["requires"] = { + }, + ["path"] = "elements/Graph.lua", + ["size"] = 7045, + ["default"] = false, + ["description"] = "A point based graph element", + }, + ["LineChart"] = { + ["requires"] = { + }, + ["path"] = "elements/LineChart.lua", + ["size"] = 3228, + ["default"] = true, + ["description"] = "", }, }, + ["description"] = "UI Elements", }, ["plugins"] = { - ["description"] = "Plugins", ["files"] = { ["xml"] = { - ["size"] = 14068, + ["requires"] = { + }, ["path"] = "plugins/xml.lua", - ["requires"] = { - }, - ["description"] = "", + ["size"] = 14068, ["default"] = false, + ["description"] = "", }, - ["theme"] = { - ["size"] = 6801, - ["path"] = "plugins/theme.lua", + ["canvas"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "plugins/canvas.lua", + ["size"] = 7897, ["default"] = false, - }, - ["animation"] = { - ["size"] = 18446, - ["path"] = "plugins/animation.lua", - ["requires"] = { - }, ["description"] = "", - ["default"] = false, }, ["debug"] = { - ["size"] = 6274, - ["path"] = "plugins/debug.lua", ["requires"] = { }, - ["description"] = "", + ["path"] = "plugins/debug.lua", + ["size"] = 6274, ["default"] = false, + ["description"] = "", }, ["reactive"] = { - ["size"] = 11869, - ["path"] = "plugins/reactive.lua", ["requires"] = { }, - ["description"] = "", + ["path"] = "plugins/reactive.lua", + ["size"] = 11869, ["default"] = false, + ["description"] = "", }, ["benchmark"] = { - ["size"] = 12604, - ["path"] = "plugins/benchmark.lua", ["requires"] = { [1] = "VisualElement", }, - ["description"] = "", + ["path"] = "plugins/benchmark.lua", + ["size"] = 12604, ["default"] = false, + ["description"] = "", }, - ["canvas"] = { - ["size"] = 7897, - ["path"] = "plugins/canvas.lua", + ["theme"] = { ["requires"] = { }, - ["description"] = "", + ["path"] = "plugins/theme.lua", + ["size"] = 6801, ["default"] = false, + ["description"] = "", + }, + ["responsive"] = { + ["requires"] = { + }, + ["path"] = "plugins/responsive.lua", + ["size"] = 5529, + ["default"] = false, + ["description"] = "", + }, + ["animation"] = { + ["requires"] = { + }, + ["path"] = "plugins/animation.lua", + ["size"] = 18446, + ["default"] = false, + ["description"] = "", }, }, + ["description"] = "Plugins", }, - ["libraries"] = { - ["description"] = "Libraries", - ["files"] = { - ["utils"] = { - ["size"] = 2661, - ["path"] = "libraries/utils.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - ["colorHex"] = { - ["size"] = 132, - ["path"] = "libraries/colorHex.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - ["expect"] = { - ["size"] = 846, - ["path"] = "libraries/expect.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - ["collectionentry"] = { - ["size"] = 3551, - ["path"] = "libraries/collectionentry.lua", - ["requires"] = { - }, - ["description"] = "", - ["default"] = true, - }, - }, - }, - }, - ["metadata"] = { - ["version"] = "2.0", - ["generated"] = "Tue Nov 4 09:01:43 2025", }, } \ No newline at end of file diff --git a/release/basalt-core.lua b/release/basalt-core.lua index 5d023fc..d1aea27 100644 --- a/release/basalt-core.lua +++ b/release/basalt-core.lua @@ -236,7 +236,7 @@ ab.class=ca;ab.set("width",12)ab.set("height",6) ab.set("background",colors.black)ab.set("z",5)return ab end;function ca:init(ab,bb)ba.init(self,ab,bb)self.set("type","Image") return self end function ca:resizeImage(ab,bb) -local cb=self.get("bimg") +local cb=self.getResolved("bimg") for db,_c in ipairs(cb)do local ac={} for y=1,bb do local bc=string.rep(" ",ab) local cc=string.rep("f",ab)local dc=string.rep("0",ab) @@ -245,19 +245,19 @@ local ad=_c[y][2]local bd=_c[y][3] bc=(_d..string.rep(" ",ab)):sub(1,ab) cc=(ad..string.rep("f",ab)):sub(1,ab) dc=(bd..string.rep("0",ab)):sub(1,ab)end;ac[y]={bc,cc,dc}end;cb[db]=ac end;self:updateRender()return self end -function ca:getImageSize()local ab=self.get("bimg")if not ab[1]or not ab[1][1]then -return 0,0 end;return#ab[1][1][1],#ab[1]end +function ca:getImageSize()local ab=self.getResolved("bimg")if +not ab[1]or not ab[1][1]then return 0,0 end;return#ab[1][1][1],#ab[1]end function ca:getPixelData(ab,bb) -local cb=self.get("bimg")[self.get("currentFrame")]if not cb or not cb[bb]then return end;local db=cb[bb][1] +local cb=self.getResolved("bimg")[self.getResolved("currentFrame")]if not cb or not cb[bb]then return end;local db=cb[bb][1] local _c=cb[bb][2]local ac=cb[bb][3] if not db or not _c or not ac then return end;local bc=tonumber(_c:sub(ab,ab),16) local cc=tonumber(ac:sub(ab,ab),16)local dc=db:sub(ab,ab)return bc,cc,dc end local function da(ab,bb) -local cb=ab.get("bimg")[ab.get("currentFrame")]if not cb then cb={} -ab.get("bimg")[ab.get("currentFrame")]=cb end +local cb=ab.getResolved("bimg")[ab.getResolved("currentFrame")]if not cb then cb={} +ab.getResolved("bimg")[ab.getResolved("currentFrame")]=cb end if not cb[bb]then cb[bb]={"","",""}end;return cb end -local function _b(ab,bb,cb)if not ab.get("autoResize")then return end -local db=ab.get("bimg")local _c=bb;local ac=cb +local function _b(ab,bb,cb)if not ab.getResolved("autoResize")then return end +local db=ab.getResolved("bimg")local _c=bb;local ac=cb for bc,cc in ipairs(db)do for dc,_d in pairs(cc)do _c=math.max(_c,#_d[1]) ac=math.max(ac,dc)end end for bc,cc in ipairs(db)do @@ -267,68 +267,69 @@ dc[2]=dc[2].."f"end;while#dc[3]<_c do dc[3]=dc[3].."0"end end end end function ca:setText(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][1]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][1] db[bb][1]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getText(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][1]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][1]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab,ab)end end function ca:setFg(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][2]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][2] db[bb][2]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getFg(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][2]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][2]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab)end end function ca:setBg(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][3]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][3] db[bb][3]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getBg(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][3]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][3]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab)end end function ca:setPixel(ab,bb,cb,db,_c)if cb then self:setText(ab,bb,cb)end;if db then self:setFg(ab,bb,db)end;if _c then self:setBg(ab,bb,_c)end;return self end -function ca:nextFrame() -if not self.get("bimg").animation then return self end;local ab=self.get("bimg")local bb=self.get("currentFrame") -local cb=bb+1;if cb>#ab then cb=1 end;self.set("currentFrame",cb)return self end -function ca:addFrame()local ab=self.get("bimg") +function ca:nextFrame()if not self.getResolved("bimg").animation then +return self end;local ab=self.getResolved("bimg") +local bb=self.getResolved("currentFrame")local cb=bb+1;if cb>#ab then cb=1 end;self.set("currentFrame",cb) +return self end +function ca:addFrame()local ab=self.getResolved("bimg") local bb=ab.width or#ab[1][1][1]local cb=ab.height or#ab[1]local db={}local _c=string.rep(" ",bb) local ac=string.rep("f",bb)local bc=string.rep("0",bb)for y=1,cb do db[y]={_c,ac,bc}end -table.insert(ab,db)return self end;function ca:updateFrame(ab,bb)local cb=self.get("bimg")cb[ab]=bb +table.insert(ab,db)return self end;function ca:updateFrame(ab,bb)local cb=self.getResolved("bimg")cb[ab]=bb self:updateRender()return self end;function ca:getFrame(ab) -local bb=self.get("bimg") -return bb[ab or self.get("currentFrame")]end +local bb=self.getResolved("bimg") +return bb[ab or self.getResolved("currentFrame")]end function ca:getMetadata()local ab={} -local bb=self.get("bimg") +local bb=self.getResolved("bimg") for cb,db in pairs(bb)do if(type(db)=="string")then ab[cb]=db end end;return ab end function ca:setMetadata(ab,bb)if(type(ab)=="table")then for db,_c in pairs(ab)do self:setMetadata(db,_c)end;return self end -local cb=self.get("bimg")if(type(bb)=="string")then cb[ab]=bb end;return self end +local cb=self.getResolved("bimg")if(type(bb)=="string")then cb[ab]=bb end;return self end function ca:render()ba.render(self) -local ab=self.get("bimg")[self.get("currentFrame")]if not ab then return end;local bb=self.get("offsetX") -local cb=self.get("offsetY")local db=self.get("width")local _c=self.get("height") -for y=1,_c do local ac=y+cb -local bc=ab[ac] +local ab=self.getResolved("bimg")[self.getResolved("currentFrame")]if not ab then return end;local bb=self.getResolved("offsetX") +local cb=self.getResolved("offsetY")local db=self.getResolved("width") +local _c=self.getResolved("height") +for y=1,_c do local ac=y+cb;local bc=ab[ac] if bc then local cc=bc[1]local dc=bc[2]local _d=bc[3] -if cc and dc and _d then -local ad=db-math.max(0,bb) -if ad>0 then if bb<0 then local bd=math.abs(bb)+1;cc=cc:sub(bd)dc=dc:sub(bd) -_d=_d:sub(bd)end;cc=cc:sub(1,ad) -dc=dc:sub(1,ad)_d=_d:sub(1,ad) +if cc and dc and _d then local ad=db- +math.max(0,bb) +if ad>0 then if bb<0 then local bd=math.abs(bb)+1 +cc=cc:sub(bd)dc=dc:sub(bd)_d=_d:sub(bd)end +cc=cc:sub(1,ad)dc=dc:sub(1,ad)_d=_d:sub(1,ad) self:blit(math.max(1,1 +bb),y,cc,dc,_d)end end end end end;return ca end project["elements/BarChart.lua"] = function(...) local aa=require("elementManager") local ba=aa.getElement("VisualElement")local ca=aa.getElement("Graph") @@ -336,13 +337,13 @@ local da=require("libraries/colorHex")local _b=setmetatable({},ca)_b.__index=_b; local ab=setmetatable({},_b):__init()ab.class=_b;return ab end function _b:init(ab,bb) ca.init(self,ab,bb)self.set("type","BarChart")return self end -function _b:render()ba.render(self)local ab=self.get("width") -local bb=self.get("height")local cb=self.get("minValue")local db=self.get("maxValue") -local _c=self.get("series")local ac=0;local bc={} -for ad,bd in pairs(_c)do if(bd.visible)then if#bd.data>0 then ac=ac+1 -table.insert(bc,bd)end end end;local cc=ac;local dc=1 -local _d=math.min(bc[1]and bc[1].pointCount or 0,math.floor((ab+dc)/ ( -cc+dc))) +function _b:render()ba.render(self)local ab=self.getResolved("width") +local bb=self.getResolved("height")local cb=self.getResolved("minValue") +local db=self.getResolved("maxValue")local _c=self.getResolved("series")local ac=0;local bc={}for ad,bd in pairs(_c)do +if(bd.visible)then if# +bd.data>0 then ac=ac+1;table.insert(bc,bd)end end end;local cc=ac;local dc=1 +local _d=math.min(bc[1]and +bc[1].pointCount or 0,math.floor((ab+dc)/ (cc+dc))) for groupIndex=1,_d do local ad=( (groupIndex-1)* (cc+dc))+1 for bd,cd in ipairs(bc)do local dd=cd.data[groupIndex] @@ -359,32 +360,33 @@ 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.getResolved("text") -da=da:sub(1,self.get("width")) -local _b,ab=ba(da,self.get("width"),self.get("height")) +da=da:sub(1,self.getResolved("width")) +local _b,ab=ba(da,self.getResolved("width"),self.getResolved("height")) 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 ca.defineProperty(ca,"text",{default="Label",type="string",canTriggerRender=true,setter=function(da,_b) if(type(_b)=="function")then _b=_b()end -if(da.get("autoSize"))then da.set("width",#_b)else da.set("height",# -ba(_b,da.get("width")))end;return _b end}) +if(da.getResolved("autoSize"))then da.set("width",#_b)else da.set("height",# +ba(_b,da.getResolved("width")))end;return _b end}) ca.defineProperty(ca,"autoSize",{default=true,type="boolean",canTriggerRender=true,setter=function(da,_b)if(_b)then -da.set("width",#da.get("text"))else -da.set("height",#ba(da.get("text"),da.get("width")))end;return _b end}) +da.set("width",#da.getResolved("text"))else +da.set("height",# +ba(da.getResolved("text"),da.getResolved("width")))end;return _b end}) function ca.new()local da=setmetatable({},ca):__init() da.class=ca;da.set("z",3)da.set("foreground",colors.black) da.set("backgroundEnabled",false)return da end function ca:init(da,_b)aa.init(self,da,_b)if(self.parent)then self.set("background",self.parent.get("background")) self.set("foreground",self.parent.get("foreground"))end -self.set("type","Label")return self end;function ca:getWrappedText()local da=self.get("text") -local _b=ba(da,self.get("width"))return _b end +self.set("type","Label")return self end;function ca:getWrappedText()local da=self.getResolved("text") +local _b=ba(da,self.getResolved("width"))return _b end function ca:render() -aa.render(self)local da=self.get("text") -if(self.get("autoSize"))then -self:textFg(1,1,da,self.get("foreground"))else local _b=ba(da,self.get("width"))for ab,bb in ipairs(_b)do -self:textFg(1,ab,bb,self.get("foreground"))end end end;return ca end +aa.render(self)local da=self.getResolved("text") +if(self.getResolved("autoSize"))then +self:textFg(1,1,da,self.getResolved("foreground"))else local _b=ba(da,self.getResolved("width"))for ab,bb in ipairs(_b)do +self:textFg(1,ab,bb,self.getResolved("foreground"))end end end;return ca end project["elements/Input.lua"] = function(...) local d=require("elements/VisualElement") local _a=require("libraries/colorHex")local aa=setmetatable({},d)aa.__index=aa aa.defineProperty(aa,"text",{default="",type="string",canTriggerRender=true}) @@ -402,66 +404,70 @@ 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 +ba=math.min(self.getResolved("width"),math.max(1,ba))return d.setCursor(self,ba,ca,da,_b)end 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 +if not self:hasState("focused")then return false end;local ca=self.getResolved("text") +local da=self.getResolved("cursorPos")local _b=self.getResolved("maxLength") +local ab=self.getResolved("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.getResolved("cursorPos")-self.getResolved("viewOffset") +self:setCursor(bb,1,true,self.getResolved("cursorColor")or +self.getResolved("foreground"))d.char(self,ba)return true end 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 +if not self:hasState("focused")then return false end;local da=self.getResolved("cursorPos") +local _b=self.getResolved("text")local ab=self.getResolved("viewOffset") +local bb=self.getResolved("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") +local cb=self.getResolved("cursorPos")-self.getResolved("viewOffset") 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 +local _b,ab=self:getRelativePosition(ca,da)local bb=self.getResolved("text") +local cb=self.getResolved("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.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") -if ca-da>=ba then self.set("viewOffset",ca-ba+1)elseif ca<=da then self.set("viewOffset", -ca-1)end -self.set("viewOffset",math.max(0,math.min(self.get("viewOffset"),_b-ba+1)))return self end +function aa:updateViewport()local ba=self.getResolved("width") +local ca=self.getResolved("cursorPos")local da=self.getResolved("viewOffset")local _b=# +self.getResolved("text") +if ca-da>=ba then +self.set("viewOffset",ca-ba+1)elseif ca<=da then self.set("viewOffset",ca-1)end +self.set("viewOffset",math.max(0,math.min(self.getResolved("viewOffset"),_b-ba+1)))return self end function aa:focus()d.focus(self) -self:setCursor(self.get("cursorPos")- -self.get("viewOffset"),1,true,self.getResolved("cursorColor")or +self:setCursor(self.getResolved("cursorPos")- +self.getResolved("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.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 +if not self:hasState("focused")then return false end;local ca=self.getResolved("text") +local da=self.getResolved("cursorPos")local _b=self.getResolved("maxLength") +local ab=self.getResolved("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") +local ca=self.getResolved("viewOffset")local da=self.getResolved("placeholder") +local _b=self:hasState("focused") +local ab,bb=self.getResolved("width"),self.getResolved("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.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.getResolved("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/Frame.lua"] = function(...) local aa=require("elementManager") local ba=aa.getElement("VisualElement")local ca=aa.getElement("Container")local da=setmetatable({},ca) @@ -478,39 +484,39 @@ return self end function da:mouse_click(ab,bb,cb) if self:isInBounds(bb,cb)then if -self.get("draggable")then local db,_c=self:getRelativePosition(bb,cb) -local ac=self.get("draggingMap") -for bc,cc in ipairs(ac)do local dc=cc.width or 1;local _d=cc.height or 1;if -type(dc)=="string"and dc=="width"then dc=self.get("width")elseif -type(dc)=="function"then dc=dc(self)end -if type(_d)== -"string"and _d=="height"then _d=self.get("height")elseif -type(_d)=="function"then _d=_d(self)end;local ad=cc.y or 1 +self.getResolved("draggable")then local db,_c=self:getRelativePosition(bb,cb) +local ac=self.getResolved("draggingMap") +for bc,cc in ipairs(ac)do local dc=cc.width or 1;local _d=cc.height or 1 +if +type(dc)=="string"and dc=="width"then dc=self.getResolved("width")elseif type(dc)== +"function"then dc=dc(self)end +if type(_d)=="string"and _d=="height"then +_d=self.getResolved("height")elseif type(_d)=="function"then _d=_d(self)end;local ad=cc.y or 1 if db>=cc.x and db<=cc.x+dc-1 and _c>=ad and _c<=ad+_d-1 then -self.dragStartX=bb-self.get("x")self.dragStartY=cb-self.get("y")self.dragging=true -return true end end end;return ca.mouse_click(self,ab,bb,cb)end;return false end +self.dragStartX=bb-self.getResolved("x")self.dragStartY=cb-self.getResolved("y") +self.dragging=true;return true end end end;return ca.mouse_click(self,ab,bb,cb)end;return false end function da:mouse_up(ab,bb,cb)if self.dragging then self.dragging=false;self.dragStartX=nil self.dragStartY=nil;return true end;return ca.mouse_up(self,ab,bb,cb)end function da:mouse_drag(ab,bb,cb) if self.dragging then local db=bb-self.dragStartX local _c=cb-self.dragStartY;self.set("x",db)self.set("y",_c)return true end;return ca.mouse_drag(self,ab,bb,cb)end -function da:getChildrenHeight()local ab=0;local bb=self.get("children") +function da:getChildrenHeight()local ab=0;local bb=self.getResolved("children") for cb,db in ipairs(bb)do if db.get("visible")then local _c=db.get("y")local ac=db.get("height")local bc=_c+ac-1 if bc>ab then ab=bc end end end;return ab end local function _b(ab,bb,...)local cb={...} if bb and bb:find("mouse_")then local db,_c,ac=... -local bc,cc=ab.get("offsetX"),ab.get("offsetY")local dc,_d=ab:getRelativePosition(_c+bc,ac+cc) +local bc,cc=ab.getResolved("offsetX"),ab.getResolved("offsetY")local dc,_d=ab:getRelativePosition(_c+bc,ac+cc) cb={db,dc,_d}end;return cb end function da:mouse_scroll(ab,bb,cb) if(ba.mouse_scroll(self,ab,bb,cb))then local db=_b(self,"mouse_scroll",ab,bb,cb) local _c,ac=self:callChildrenEvent(true,"mouse_scroll",table.unpack(db))if _c then return true end -if self.get("scrollable")then -local bc=self.get("height")local cc=self:getChildrenHeight() -local dc=self.get("offsetY")local _d=math.max(0,cc-bc)local ad=dc+ab +if self.getResolved("scrollable")then +local bc=self.getResolved("height")local cc=self:getChildrenHeight() +local dc=self.getResolved("offsetY")local _d=math.max(0,cc-bc)local ad=dc+ab ad=math.max(0,math.min(_d,ad))self.set("offsetY",ad)return true end end;return false end;return da end project["elements/Container.lua"] = function(...) local _b=require("elementManager") local ab=require("errorManager")local bb=_b.getElement("VisualElement") @@ -552,11 +558,11 @@ self.set("childrenEventsSorted",false)self:updateRender()end)end function ac:isChildVisible(dc) if not dc:isType("VisualElement")then return false end;if(dc.get("visible")==false)then return false end;if(dc._destroyed)then return false end -local _d,ad=self.get("width"),self.get("height")local bd,cd=self.get("offsetX"),self.get("offsetY") -local dd,__a=dc.get("x"),dc.get("y")local a_a,b_a=dc.get("width"),dc.get("height")local c_a;local d_a;if -(dc.get("ignoreOffset"))then c_a=dd;d_a=__a else c_a=dd-bd;d_a=__a-cd end;return -(c_a+ -a_a>0)and(c_a<=_d)and(d_a+b_a>0)and(d_a<=ad)end +local _d,ad=self.getResolved("width"),self.getResolved("height") +local bd,cd=self.getResolved("offsetX"),self.getResolved("offsetY")local dd,__a=dc.get("x"),dc.get("y") +local a_a,b_a=dc.get("width"),dc.get("height")local c_a;local d_a +if(dc.get("ignoreOffset"))then c_a=dd;d_a=__a else c_a=dd-bd;d_a=__a-cd end;return +(c_a+a_a>0)and(c_a<=_d)and(d_a+b_a>0)and(d_a<=ad)end function ac:addChild(dc) if dc==self then error("Cannot add container to itself")end;if(dc~=nil)then table.insert(self._values.children,dc) dc.parent=self;dc:postInit()self.set("childrenSorted",false) @@ -618,15 +624,15 @@ if#_d==1 then return bd else if(bd:isType("Container"))then return bd:find(table.concat(_d,"/",2))end end end end end;return nil end local function cc(dc,_d,...)local ad={...} if _d and _d:find("mouse_")then local bd,cd,dd=... -local __a,a_a=dc.get("offsetX"),dc.get("offsetY")local b_a,c_a=dc:getRelativePosition(cd+__a,dd+a_a) +local __a,a_a=dc.getResolved("offsetX"),dc.getResolved("offsetY")local b_a,c_a=dc:getRelativePosition(cd+__a,dd+a_a) ad={bd,b_a,c_a}end;return ad end function ac:callChildrenEvent(dc,_d,...) if -dc and not self.get("childrenEventsSorted")then for bd in pairs(self._values.childrenEvents)do -self:sortChildrenEvents(bd)end end;local ad=dc and self.get("visibleChildrenEvents")or -self.get("childrenEvents") -if -ad[_d]then local bd=ad[_d]for i=#bd,1,-1 do local cd=bd[i] +dc and not self.getResolved("childrenEventsSorted")then for bd in pairs(self._values.childrenEvents)do +self:sortChildrenEvents(bd)end end +local ad=dc and self.getResolved("visibleChildrenEvents")or +self.getResolved("childrenEvents") +if ad[_d]then local bd=ad[_d]for i=#bd,1,-1 do local cd=bd[i] if(cd:dispatchEvent(_d,...))then return true,cd end end end if(ad["*"])then local bd=ad["*"]for i=#bd,1,-1 do local cd=bd[i] if(cd:dispatchEvent(_d,...))then return true,cd end end end;return false end @@ -655,63 +661,66 @@ local cd,dd=self:callChildrenEvent(true,"mouse_drag",table.unpack(bd))if(cd)then function ac:mouse_scroll(dc,_d,ad) if(bb.mouse_scroll(self,dc,_d,ad))then local bd=cc(self,"mouse_scroll",dc,_d,ad) -local cd,dd=self:callChildrenEvent(true,"mouse_scroll",table.unpack(bd))return true end;return false end;function ac:key(dc)if self.get("focusedChild")then return -self.get("focusedChild"):dispatchEvent("key",dc)end -return true end -function ac:char(dc)if -self.get("focusedChild")then -return self.get("focusedChild"):dispatchEvent("char",dc)end;return true end;function ac:key_up(dc) -if self.get("focusedChild")then return -self.get("focusedChild"):dispatchEvent("key_up",dc)end;return true end +local cd,dd=self:callChildrenEvent(true,"mouse_scroll",table.unpack(bd))return true end;return false end +function ac:key(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("key",dc)end;return true end +function ac:char(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("char",dc)end;return true end +function ac:key_up(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("key_up",dc)end;return true end function ac:multiBlit(dc,_d,ad,bd,cd,dd,__a) -local a_a,b_a=self.get("width"),self.get("height")ad=dc<1 and math.min(ad+dc-1,a_a)or +local a_a,b_a=self.getResolved("width"),self.getResolved("height")ad=dc<1 and math.min(ad+dc-1,a_a)or math.min(ad,math.max(0,a_a-dc+1))bd=_d<1 and math.min( bd+_d-1,b_a)or math.min(bd,math.max(0,b_a-_d+1))if ad<=0 or bd<=0 then return self end bb.multiBlit(self,math.max(1,dc),math.max(1,_d),ad,bd,cd,dd,__a)return self end -function ac:textFg(dc,_d,ad,bd)local cd,dd=self.get("width"),self.get("height")if -_d<1 or _d>dd then return self end;local __a=dc<1 and(2 -dc)or 1 -local a_a=math.min(#ad- -__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end +function ac:textFg(dc,_d,ad,bd) +local cd,dd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>dd then return self end +local __a=dc<1 and(2 -dc)or 1 +local a_a=math.min(#ad-__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end bb.textFg(self,math.max(1,dc),math.max(1,_d),ad:sub(__a, __a+a_a-1),bd)return self end -function ac:textBg(dc,_d,ad,bd)local cd,dd=self.get("width"),self.get("height")if -_d<1 or _d>dd then return self end;local __a=dc<1 and(2 -dc)or 1 -local a_a=math.min(#ad- -__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end +function ac:textBg(dc,_d,ad,bd) +local cd,dd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>dd then return self end +local __a=dc<1 and(2 -dc)or 1 +local a_a=math.min(#ad-__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end bb.textBg(self,math.max(1,dc),math.max(1,_d),ad:sub(__a, __a+a_a-1),bd)return self end -function ac:drawText(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if _d<1 or -_d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min( -#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawText(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawText(self,math.max(1,dc),math.max(1,_d),ad:sub(dd, dd+__a-1))return self end -function ac:drawFg(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if -_d<1 or _d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min(#ad- -dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawFg(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawFg(self,math.max(1,dc),math.max(1,_d),ad:sub(dd,dd+__a-1))return self end -function ac:drawBg(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if -_d<1 or _d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min(#ad- -dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawBg(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawBg(self,math.max(1,dc),math.max(1,_d),ad:sub(dd,dd+__a-1))return self end -function ac:blit(dc,_d,ad,bd,cd)local dd,__a=self.get("width"),self.get("height")if -_d<1 or _d>__a then return self end;local a_a=dc<1 and(2 -dc)or 1 -local b_a=math.min( -#ad-a_a+1,dd-math.max(1,dc)+1) +function ac:blit(dc,_d,ad,bd,cd) +local dd,__a=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>__a then return self end +local a_a=dc<1 and(2 -dc)or 1 +local b_a=math.min(#ad-a_a+1,dd-math.max(1,dc)+1) local c_a=math.min(#bd-a_a+1,dd-math.max(1,dc)+1) local d_a=math.min(#cd-a_a+1,dd-math.max(1,dc)+1)if b_a<=0 then return self end;local _aa=ad:sub(a_a,a_a+b_a-1)local aaa=bd:sub(a_a, a_a+c_a-1) local baa=cd:sub(a_a,a_a+d_a-1) bb.blit(self,math.max(1,dc),math.max(1,_d),_aa,aaa,baa)return self end -function ac:render()bb.render(self)if not self.get("childrenSorted")then -self:sortChildren()end -if -not self.get("childrenEventsSorted")then for dc in pairs(self._values.childrenEvents)do -self:sortChildrenEvents(dc)end end;for dc,_d in ipairs(self.get("visibleChildren"))do if _d==self then +function ac:render()bb.render(self)if +not self.getResolved("childrenSorted")then self:sortChildren()end +if not +self.getResolved("childrenEventsSorted")then for dc in pairs(self._values.childrenEvents)do +self:sortChildrenEvents(dc)end end +for dc,_d in ipairs(self.getResolved("visibleChildren"))do if _d==self then ab.error("CIRCULAR REFERENCE DETECTED!")return end;_d:render() _d:postRender()end end function ac:applyLayout(dc,_d) @@ -736,19 +745,20 @@ da.init(self,cb,db)self.set("type","LineChart")return self end local function bb(cb,db,_c,ac,bc,cc,dc,_d)local ad=ac-db;local bd=bc-_c local cd=math.max(math.abs(ad),math.abs(bd)) for i=0,cd do local dd=cd==0 and 0 or i/cd -local __a=math.floor(db+ad*dd)local a_a=math.floor(_c+bd*dd) -if - -__a>=1 and __a<=cb.get("width")and a_a>=1 and a_a<=cb.get("height")then cb:blit(__a,a_a,cc,_b[dc],_b[_d])end end end -function ab:render()ca.render(self)local cb=self.get("width") -local db=self.get("height")local _c=self.get("minValue")local ac=self.get("maxValue") -local bc=self.get("series") +local __a=math.floor(db+ad*dd)local a_a=math.floor(_c+bd*dd)if __a>=1 and +__a<=cb.getResolved("width")and a_a>=1 and +a_a<=cb.getResolved("height")then +cb:blit(__a,a_a,cc,_b[dc],_b[_d])end end end +function ab:render()ca.render(self)local cb=self.getResolved("width") +local db=self.getResolved("height")local _c=self.getResolved("minValue") +local ac=self.getResolved("maxValue")local bc=self.getResolved("series") for cc,dc in pairs(bc)do -if(dc.visible)then local _d,ad;local bd=#dc.data -local cd=(cb-1)/math.max((bd-1),1) -for dd,__a in ipairs(dc.data)do local a_a=math.floor(( (dd-1)*cd)+1)local b_a= -(__a-_c)/ (ac-_c) -local c_a=math.floor(db- (b_a* (db-1)))c_a=math.max(1,math.min(c_a,db))if _d then +if(dc.visible)then local _d,ad +local bd=#dc.data;local cd=(cb-1)/math.max((bd-1),1) +for dd,__a in ipairs(dc.data)do local a_a=math.floor(( ( +dd-1)*cd)+1) +local b_a=(__a-_c)/ (ac-_c)local c_a=math.floor(db- (b_a* (db-1))) +c_a=math.max(1,math.min(c_a,db))if _d then bb(self,_d,ad,a_a,c_a,dc.symbol,dc.bgColor,dc.fgColor)end;_d,ad=a_a,c_a end end end end;return ab end project["elements/Menu.lua"] = function(...) local _a=require("elements/VisualElement") local aa=require("elements/List")local ba=require("libraries/colorHex") @@ -756,23 +766,24 @@ local ca=setmetatable({},aa)ca.__index=ca ca.defineProperty(ca,"separatorColor",{default=colors.gray,type="color"}) ca.defineProperty(ca,"spacing",{default=1,type="number",canTriggerRender=true}) ca.defineProperty(ca,"horizontalOffset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b) -local ab=math.max(0,da:getTotalWidth()-da.get("width"))return math.min(ab,math.max(0,_b))end}) +local ab=math.max(0,da:getTotalWidth()-da.getResolved("width"))return math.min(ab,math.max(0,_b))end}) ca.defineProperty(ca,"maxWidth",{default=nil,type="number",canTriggerRender=true}) function ca.new()local da=setmetatable({},ca):__init() da.class=ca;da.set("width",30)da.set("height",1) da.set("background",colors.gray)return da end function ca:init(da,_b)aa.init(self,da,_b)self.set("type","Menu") self:observe("items",function() -local ab=self.get("maxWidth")if ab then +local ab=self.getResolved("maxWidth")if ab then self.set("width",math.min(ab,self:getTotalWidth()),true)else self.set("width",self:getTotalWidth(),true)end end)return self end -function ca:getTotalWidth()local da=self.get("items")local _b=self.get("spacing") -local ab=0;for bb,cb in ipairs(da)do if type(cb)=="table"then ab=ab+#cb.text else ab= -ab+#tostring(cb)+2 end -if bb<#da then ab=ab+_b end end;return ab end -function ca:render()_a.render(self)local da=self.get("width") -local _b=self.get("spacing")local ab=self.get("horizontalOffset") -local bb=self.get("items")local cb={}local db=1 +function ca:getTotalWidth()local da=self.getResolved("items") +local _b=self.getResolved("spacing")local ab=0 +for bb,cb in ipairs(da)do if type(cb)=="table"then ab=ab+#cb.text else ab=ab+ +#tostring(cb)+2 end;if bb<#da then +ab=ab+_b end end;return ab end +function ca:render()_a.render(self)local da=self.getResolved("width") +local _b=self.getResolved("spacing")local ab=self.getResolved("horizontalOffset") +local bb=self.getResolved("items")local cb={}local db=1 for _c,ac in ipairs(bb)do if type(ac)=="string"then ac={text=" "..ac.." "}bb[_c]=ac end cb[_c]={startX=db,endX=db+#ac.text-1,text=ac.text,item=ac}db=db+#ac.text;if _c<#bb and _b>0 then db=db+_b end end @@ -783,36 +794,38 @@ local bd=math.max(1,1 -cc+1) local cd=math.min(#ac.text,#ac.text- (dc-da))local dd=ac.text:sub(bd,cd) if#dd>0 then local __a=bc.selected local a_a= -bc.selectable==false and self.get("separatorColor")or(__a and(bc.selectedForeground or -self.get("selectedForeground"))or(bc.foreground or -self.get("foreground"))) -local b_a= -__a and(bc.selectedBackground or self.get("selectedBackground"))or(bc.background or self.get("background")) +bc.selectable==false and self.getResolved("separatorColor")or +( +__a and( +bc.selectedForeground or self.getResolved("selectedForeground"))or(bc.foreground or self.getResolved("foreground"))) +local b_a=__a and +(bc.selectedBackground or self.getResolved("selectedBackground"))or +(bc.background or self.getResolved("background")) self:blit(_d,1,dd,string.rep(ba[a_a],#dd),string.rep(ba[b_a],#dd))end if _c<#bb and _b>0 then local __a=ac.endX+1 -ab;local a_a=__a+_b-1 if a_a>=1 and __a<=da then local b_a=math.max(1,__a)local c_a=math.min(da,a_a) local d_a=c_a-b_a+1 if d_a>0 then local _aa=string.rep(" ",d_a) -self:blit(b_a,1,_aa,string.rep(ba[self.get("foreground")],d_a),string.rep(ba[self.get("background")],d_a))end end end end end end +self:blit(b_a,1,_aa,string.rep(ba[self.getResolved("foreground")],d_a),string.rep(ba[self.getResolved("background")],d_a))end end end end end end function ca:mouse_click(da,_b,ab) if not _a.mouse_click(self,da,_b,ab)then return false end -if(self.get("selectable")==false)then return false end -local bb=select(1,self:getRelativePosition(_b,ab))local cb=self.get("horizontalOffset") -local db=self.get("spacing")local _c=self.get("items")local ac=bb+cb;local bc=1 -for cc,dc in ipairs(_c)do local _d=#dc.text -if ac>= -bc and ac=bc and ac0 then bc=bc+db end end;return false end function ca:mouse_scroll(da,_b,ab) if _a.mouse_scroll(self,da,_b,ab)then -local bb=self.get("horizontalOffset") -local cb=math.max(0,self:getTotalWidth()-self.get("width"))bb=math.min(cb,math.max(0,bb+ (da*3))) +local bb=self.getResolved("horizontalOffset") +local cb=math.max(0,self:getTotalWidth()-self.getResolved("width"))bb=math.min(cb,math.max(0,bb+ (da*3))) self.set("horizontalOffset",bb)return true end;return false end;return ca end project["elements/VisualElement.lua"] = function(...) local ba=require("elementManager") local ca=ba.getElement("BaseElement")local da=require("libraries/colorHex") @@ -865,15 +878,16 @@ 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 +function _b:setConstraint(cb,db,_c,ac)local bc=self.getResolved("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:setLayoutConfigProperty(cb,db)local _c=self.get("layoutConfig")_c[cb]=db -self.set("layoutConfig",_c)return self end;function _b:getLayoutConfigProperty(cb) -local db=self.get("layoutConfig")return db[cb]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 +self:_addConstraintObservers(cb,bc[cb])self._constraintsDirty=true;self:updateRender()return self end +function _b:setLayoutConfigProperty(cb,db)local _c=self.getResolved("layoutConfig") +_c[cb]=db;self.set("layoutConfig",_c)return self end;function _b:getLayoutConfigProperty(cb)local db=self.getResolved("layoutConfig") +return db[cb]end +function _b:resolveAllConstraints()if +not self._constraintsDirty then return self end +local cb=self.getResolved("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,cb)end end;self._constraintsDirty=false;return self end @@ -882,13 +896,13 @@ 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 if _c.left then local ac=self:_resolveConstraint("left",_c.left)local bc=db-ac+1;self.set("width",bc)self.set("x",ac)else -local ac=self.get("width")self.set("x",db-ac+1)end elseif cb=="bottom"then +local ac=self.getResolved("width")self.set("x",db-ac+1)end elseif cb=="bottom"then if _c.top then local ac=self:_resolveConstraint("top",_c.top)local bc=db-ac+1;self.set("height",bc)self.set("y",ac)else -local ac=self.get("height")self.set("y",db-ac+1)end elseif cb=="centerX"then local ac=self.get("width") -self.set("x",db-math.floor(ac/2))elseif cb=="centerY"then local ac=self.get("height") -self.set("y",db-math.floor(ac/2))elseif cb=="width"then self.set("width",db)elseif cb=="height"then -self.set("height",db)end end +local ac=self.getResolved("height")self.set("y",db-ac+1)end elseif cb=="centerX"then local ac=self.getResolved("width")self.set("x",db- +math.floor(ac/2))elseif cb=="centerY"then +local ac=self.getResolved("height")self.set("y",db-math.floor(ac/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 @@ -909,21 +923,21 @@ 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 +function _b:removeConstraint(cb)local db=self.getResolved("constraints")db[cb]=nil self.set("constraints",db)self:updateConstraints()return self end -function _b:updateConstraints()local cb=self.get("constraints") +function _b:updateConstraints()local cb=self.getResolved("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 +self.set("y",ac)elseif db=="right"then local bc=self.getResolved("width") +self.set("x",ac-bc+1)elseif db=="bottom"then local bc=self.getResolved("height") +self.set("y",ac-bc+1)elseif db=="centerX"then local bc=self.getResolved("width")self.set("x",ac- +math.floor(bc/2))elseif db=="centerY"then +local bc=self.getResolved("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 not _c then return self.getResolved(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 @@ -982,12 +996,13 @@ function _b:drawBg(cb,db,_c)local ac,bc=self:calculatePosition()cb=cb+ac-1 db=db+bc-1;self.parent:drawBg(cb,db,_c)end function _b:blit(cb,db,_c,ac,bc)local cc,dc=self:calculatePosition()cb=cb+cc-1 db=db+dc-1;self.parent:blit(cb,db,_c,ac,bc)end -function _b:isInBounds(cb,db)local _c,ac=self.get("x"),self.get("y") -local bc,cc=self.get("width"),self.get("height")if(self.get("ignoreOffset"))then -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:isInBounds(cb,db) +local _c,ac=self.getResolved("x"),self.getResolved("y") +local bc,cc=self.getResolved("width"),self.getResolved("height") +if(self.getResolved("ignoreOffset"))then 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:setState("clicked") self:fireEvent("mouse_click",cb,self:getRelativePosition(db,_c))return true end;return false end @@ -999,7 +1014,7 @@ function _b:mouse_release(cb,db,_c) 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") +local ac=self.getResolved("hover") if(self:isInBounds(db,_c))then if(not ac)then self.set("hover",true) self:fireEvent("mouse_enter",self:getRelativePosition(db,_c))end;return true else if(ac)then self.set("hover",false) @@ -1039,18 +1054,18 @@ 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 +self:resolveAllConstraints()local cb,db=self.getResolved("x"),self.getResolved("y") +if not +self.getResolved("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 -while bc do -local cc,dc=bc.get("x"),bc.get("y")_c=_c+cc-1;ac=ac+dc-1;bc=bc.parent end;return _c,ac end +function _b:getAbsolutePosition(cb,db) +local _c,ac=self.getResolved("x"),self.getResolved("y")if(cb~=nil)then _c=_c+cb-1 end;if(db~=nil)then ac=ac+db-1 end +local bc=self.parent;while bc do local cc,dc=bc.get("x"),bc.get("y")_c=_c+cc-1;ac=ac+dc-1 +bc=bc.parent end;return _c,ac end function _b:getRelativePosition(cb,db)if(cb==nil)or(db==nil)then -cb,db=self.get("x"),self.get("y")end;local _c,ac=1,1;if self.parent then +cb,db=self.getResolved("x"),self.getResolved("y")end;local _c,ac=1,1;if self.parent then _c,ac=self.parent:getRelativePosition()end -local bc,cc=self.get("x"),self.get("y")return cb- (bc-1)- (_c-1),db- (cc-1)- (ac-1)end +local bc,cc=self.getResolved("x"),self.getResolved("y")return cb- (bc-1)- (_c-1),db- (cc-1)- (ac-1)end function _b:setCursor(cb,db,_c,ac) if self.parent then local bc,cc=self:calculatePosition() if @@ -1063,8 +1078,9 @@ 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.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")] +if(not self.getResolved("backgroundEnabled"))then return end +local cb,db=self.getResolved("width"),self.getResolved("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 (bc or cc or dc or _d)then @@ -1088,36 +1104,37 @@ function aa.new()local ba=setmetatable({},aa):__init() ba.class=aa;ba.set("width",25)ba.set("height",3)return ba end;function aa:init(ba,ca)d.init(self,ba,ca) self.set("type","ProgressBar")end function aa:render()d.render(self) -local ba=self.get("width")local ca=self.get("height") -local da=math.min(100,math.max(0,self.get("progress")))local _b=math.floor((ba*da)/100) -local ab=math.floor((ca*da)/100)local bb=self.get("direction") -local cb=self.get("progressColor") +local ba=self.getResolved("width")local ca=self.getResolved("height") +local da=math.min(100,math.max(0,self.getResolved("progress")))local _b=math.floor((ba*da)/100) +local ab=math.floor((ca*da)/100)local bb=self.getResolved("direction") +local cb=self.getResolved("progressColor")local db=self.getResolved("foreground") if bb=="right"then -self:multiBlit(1,1,_b,ca," ",_a[self.get("foreground")],_a[cb])elseif bb=="left"then -self:multiBlit(ba-_b+1,1,_b,ca," ",_a[self.get("foreground")],_a[cb])elseif bb=="up"then -self:multiBlit(1,ca-ab+1,ba,ab," ",_a[self.get("foreground")],_a[cb])elseif bb=="down"then -self:multiBlit(1,1,ba,ab," ",_a[self.get("foreground")],_a[cb])end -if self.get("showPercentage")then local db=tostring(da).."%"local _c=math.floor( -(ba-#db)/2)+1 -local ac=math.floor((ca-1)/2)+1 -self:textFg(_c,ac,db,self.get("foreground"))end end;return aa end +self:multiBlit(1,1,_b,ca," ",_a[db],_a[cb])elseif bb=="left"then +self:multiBlit(ba-_b+1,1,_b,ca," ",_a[db],_a[cb])elseif bb=="up"then +self:multiBlit(1,ca-ab+1,ba,ab," ",_a[db],_a[cb])elseif bb=="down"then +self:multiBlit(1,1,ba,ab," ",_a[db],_a[cb])end +if self.getResolved("showPercentage")then local _c=tostring(da).."%"local ac=math.floor(( +ba-#_c)/2)+1;local bc= +math.floor((ca-1)/2)+1;self:textFg(ac,bc,_c,db)end end;return aa end project["elements/CheckBox.lua"] = function(...) local c=require("elements/VisualElement") local d=setmetatable({},c)d.__index=d d.defineProperty(d,"checked",{default=false,type="boolean",canTriggerRender=true}) -d.defineProperty(d,"text",{default=" ",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.get("checkedText") -local ca=math.max(#aa,#ba)if(_a.get("autoSize"))then _a.set("width",ca)end;return aa end}) -d.defineProperty(d,"checkedText",{default="x",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.get("text") -local ca=math.max(#aa,#ba)if(_a.get("autoSize"))then _a.set("width",ca)end;return aa end}) +d.defineProperty(d,"text",{default=" ",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.getResolved("checkedText")local ca=math.max(#aa, +#ba)if(_a.getResolved("autoSize"))then +_a.set("width",ca)end;return aa end}) +d.defineProperty(d,"checkedText",{default="x",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.getResolved("text") +local ca=math.max(#aa,#ba) +if(_a.getResolved("autoSize"))then _a.set("width",ca)end;return aa end}) d.defineProperty(d,"autoSize",{default=true,type="boolean"})d.defineEvent(d,"mouse_click") d.defineEvent(d,"mouse_up")function d.new()local _a=setmetatable({},d):__init()_a.class=d _a.set("backgroundEnabled",false)return _a end 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 +self.set("checked",not self.getResolved("checked"))return true end;return false 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")) +local ca=string.sub(_a and ba or aa,1,self.getResolved("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) @@ -1170,7 +1187,7 @@ not self._values.eventCallbacks[da]then self._values.eventCallbacks[da]={}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 +local ab=self.getResolved("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 @@ -1185,14 +1202,47 @@ 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:setState(da,_b.priority)else self:unsetState(da)end end end;return self end +function ca:registerResponsiveState(da,_b,ab)local bb=100;local cb={} +if type(ab)=="number"then bb=ab elseif type(ab)=="table"then bb= +ab.priority or 100;cb=ab.observe or{}end;local db;local _c=type(_b)=="string" +if _c then +db=self:_parseResponsiveExpression(_b)local ac=self:_detectDependencies(_b)for bc,cc in ipairs(ac)do +table.insert(cb,cc)end else db=_b end;self:registerState(da,db,bb) +for ac,bc in ipairs(cb)do +local cc=bc.element or bc[1]local dc=bc.property or bc[2]if cc and dc then +cc:observe(dc,function() +self:updateConditionalStates()end)end end;self:updateConditionalStates()return self end +function ca:_parseResponsiveExpression(da)local _b={colors=true,math=true,clamp=true,round=true} +local ab={clamp=function(ac,bc,cc)return +math.min(math.max(ac,bc),cc)end,round=function(ac) +return math.floor(ac+0.5)end,floor=math.floor,ceil=math.ceil,abs=math.abs} +da=da:gsub("([%w_]+)%.([%w_]+)",function(ac,bc) +if _b[ac]or tonumber(ac)then return ac.."."..bc end +return string.format('__getProperty("%s", "%s")',ac,bc)end)local bb=self +local cb=setmetatable({colors=colors,math=math,tostring=tostring,tonumber=tonumber,__getProperty=function(ac,bc) +if ac=="self"then +if bb._properties[bc]then return bb.get(bc)end elseif ac=="parent"then if bb.parent and bb.parent._properties[bc]then return +bb.parent.get(bc)end else +local cc=bb:getBaseFrame():getChild(ac) +if cc and cc._properties[bc]then return cc.get(bc)end end;return nil end},{__index=ab})local db,_c=load("return "..da,"responsive","t",cb) +if not db then error( +"Invalid responsive expression: ".._c)end;return +function(ac)local bc,cc=pcall(db)return bc and cc or false end end +function ca:_detectDependencies(da)local _b={} +local ab={colors=true,math=true,clamp=true,round=true} +for bb,cb in da:gmatch("([%w_]+)%.([%w_]+)")do +if not ab[bb]and not tonumber(bb)then +local db;if bb=="self"then db=self elseif bb=="parent"then db=self.parent else +db=self:getBaseFrame():getChild(bb)end;if db then +table.insert(_b,{element=db,property=cb})end end end;return _b 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 local _b;for ab,bb in ipairs(self.get("eventCallbacks")[da])do -_b=bb(self,...)end;return _b end;return self end +self.getResolved("eventCallbacks")[da]then local _b;for ab,bb in +ipairs(self.getResolved("eventCallbacks")[da])do _b=bb(self,...)end;return _b 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 +if self.getResolved("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) self:observe(da,_b)return self end function ca:getBaseFrame()if self.parent then return @@ -1205,7 +1255,7 @@ project["elements/List.lua"] = function(...) local _a=require("elements/Collecti local aa=require("libraries/colorHex")local ba=setmetatable({},_a)ba.__index=ba ba.defineProperty(ba,"offset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b) local ab=math.max(0,# -da.get("items")-da.get("height"))return math.min(ab,math.max(0,_b))end}) +da.getResolved("items")-da.getResolved("height"))return math.min(ab,math.max(0,_b))end}) ba.defineProperty(ba,"emptyText",{default="No items",type="string",canTriggerRender=true}) ba.defineProperty(ba,"showScrollBar",{default=true,type="boolean",canTriggerRender=true}) ba.defineProperty(ba,"scrollBarSymbol",{default=" ",type="string",canTriggerRender=true}) @@ -1222,34 +1272,36 @@ da.set("background",colors.gray)return da end function ba:init(da,_b)_a.init(self,da,_b)self._entrySchema=ca self.set("type","List") self:observe("items",function() -local ab=math.max(0,#self.get("items")-self.get("height")) -if self.get("offset")>ab then self.set("offset",ab)end end) +local ab=math.max(0,#self.getResolved("items")- +self.getResolved("height")) +if self.getResolved("offset")>ab then self.set("offset",ab)end end) self:observe("height",function() -local ab=math.max(0,#self.get("items")-self.get("height")) -if self.get("offset")>ab then self.set("offset",ab)end end)return self end +local ab=math.max(0,#self.getResolved("items")- +self.getResolved("height")) +if self.getResolved("offset")>ab then self.set("offset",ab)end end)return self end function ba:mouse_click(da,_b,ab) if _a.mouse_click(self,da,_b,ab)then -local bb,cb=self:getRelativePosition(_b,ab)local db=self.get("width")local _c=self.get("items") -local ac=self.get("height")local bc=self.get("showScrollBar") -if bc and#_c>ac and bb==db then local cc= -#_c-ac -local dc=math.max(1,math.floor((ac/#_c)*ac)) -local _d=cc>0 and(self.get("offset")/cc*100)or 0 -local ad=math.floor((_d/100)* (ac-dc))+1 -if cb>=ad and cbac and bb==db then local cc=#_c-ac +local dc=math.max(1,math.floor((ac/#_c)*ac))local _d= +cc>0 and(self.getResolved("offset")/cc*100)or 0;local ad= +math.floor((_d/100)* (ac-dc))+1 +if cb>=ad and cb +function ba:scrollToItem(da)local _b=self.getResolved("height") +local ab=self.getResolved("offset") +if da ab+_b then self.set("offset",da-_b)end;return self end function ba:key(da) -if _a.key(self,da)and self.get("selectable")then -local _b=self.get("items")local ab=self:getSelectedIndex() +if _a.key(self,da)and self.getResolved("selectable")then +local _b=self.getResolved("items")local ab=self:getSelectedIndex() if da==keys.up then self:selectPrevious()if ab and ab>1 then self:scrollToItem(ab-1)end return true elseif da==keys.down then self:selectNext()if ab and ab<#_b then self:scrollToItem(ab+1)end;return true elseif da==keys.home then self:clearItemSelection()self:selectItem(1)self:scrollToTop()return true elseif da==keys["end"]then self:clearItemSelection()self:selectItem(#_b) -self:scrollToBottom()return true elseif da==keys.pageUp then local bb=self.get("height") -local cb=math.max(1,(ab or 1)-bb)self:clearItemSelection()self:selectItem(cb) -self:scrollToItem(cb)return true elseif da==keys.pageDown then local bb=self.get("height") +self:scrollToBottom()return true elseif da==keys.pageUp then local bb=self.getResolved("height")local cb=math.max(1,( +ab or 1)-bb) +self:clearItemSelection()self:selectItem(cb)self:scrollToItem(cb)return true elseif da== +keys.pageDown then local bb=self.getResolved("height") local cb=math.min(#_b,(ab or 1)+bb)self:clearItemSelection()self:selectItem(cb) self:scrollToItem(cb)return true end end;return false end -function ba:render(da)da=da or 0;_a.render(self)local _b=self.get("items") -local ab=self.get("height")local bb=self.get("offset")local cb=self.get("width") +function ba:render(da)da=da or 0;_a.render(self) +local _b=self.getResolved("items")local ab=self.getResolved("height") +local bb=self.getResolved("offset")local cb=self.getResolved("width") local db=self.getResolved("background")local _c=self.getResolved("foreground") -local ac=self.get("showScrollBar")local bc=ac and#_b>ab;local cc=bc and cb-1 or cb +local ac=self.getResolved("showScrollBar")local bc=ac and#_b>ab;local cc=bc and cb-1 or cb if#_b==0 then -local dc=self.get("emptyText")local _d=math.floor(ab/2)+da;local ad=math.max(1, +local dc=self.getResolved("emptyText")local _d=math.floor(ab/2)+da;local ad=math.max(1, math.floor((cb-#dc)/2)+1)for i=1,ab do self:textBg(1,i,string.rep(" ",cb),db)end;if _d>=1 and _d<=ab then self:textFg(ad,_d+da,dc,colors.gray)end;return end @@ -1331,45 +1386,46 @@ 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 +local ca=_a.new(self,ba,self._entrySchema) +table.insert(self.getResolved("items"),ca)self:updateRender()return ca end +function aa:removeItem(ba)local ca=self.getResolved("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 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") +function aa:getSelectedItems()local ba={}for ca,da in ipairs(self.getResolved("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.getResolved("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.getResolved("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 +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") +function aa:unselectItem(ba)local ca=self.getResolved("items") if type(ba)=="number"then -if ca[ba]and -type(ca[ba])=="table"then ca[ba].selected=false end else +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;self:updateRender()return self end -function aa:getSelectedIndex()local ba=self.get("items") -for ca,da in ipairs(ba)do if type(da)=="table"and -da.selected then return ca end end;return nil end -function aa:selectNext()local ba=self.get("items") +function aa:clearItemSelection()local ba=self.getResolved("items")for ca,da in ipairs(ba)do +da.selected=false end;self:updateRender()return self end +function aa:getSelectedIndex()local ba=self.getResolved("items") +for ca,da in ipairs(ba)do if +type(da)=="table"and da.selected then return ca end end;return nil end +function aa:selectNext()local ba=self.getResolved("items") local ca=self:getSelectedIndex() if not ca then if#ba>0 then self:selectItem(1)end elseif ca<#ba then if not -self.get("multiSelection")then self:clearItemSelection()end;self:selectItem(ca+1)end;self:updateRender()return self end -function aa:selectPrevious()local ba=self.get("items") +self.getResolved("multiSelection")then self:clearItemSelection()end;self:selectItem(ca+1)end;self:updateRender()return self end +function aa:selectPrevious()local ba=self.getResolved("items") local ca=self:getSelectedIndex() if not ca then if#ba>0 then self:selectItem(#ba)end elseif ca>1 then if not -self.get("multiSelection")then self:clearItemSelection()end;self:selectItem(ca-1)end;self:updateRender()return self end +self.getResolved("multiSelection")then self:clearItemSelection()end;self:selectItem(ca-1)end;self:updateRender()return self end function aa:onSelect(ba)self:registerCallback("select",ba)return self end;return aa end project["elementManager.lua"] = function(...) local _c=table.pack(...) local ac=fs.getDir(_c[2]or"basalt")local bc=_c[1]if(ac==nil)then diff --git a/release/basalt-full.lua b/release/basalt-full.lua index cafd2b8..19c0b99 100644 --- a/release/basalt-full.lua +++ b/release/basalt-full.lua @@ -49,6 +49,7 @@ minified_pluginDirectory["xml"] = {} minified_pluginDirectory["debug"] = {} minified_pluginDirectory["animation"] = {} minified_pluginDirectory["benchmark"] = {} +minified_pluginDirectory["responsive"] = {} project["errorManager.lua"] = function(...) local d=require("log") local _a={tracebackEnabled=true,header="Basalt Error"}local function aa(ba,ca)term.setTextColor(ca)print(ba) term.setTextColor(colors.white)end @@ -259,17 +260,18 @@ aa.defineProperty(aa,"running",{default=false,type="boolean"}) aa.defineProperty(aa,"amount",{default=-1,type="number"})aa.defineEvent(aa,"timer")function aa.new() local ba=setmetatable({},aa):__init()ba.class=aa;return ba end;function aa:init(ba,ca) _a.init(self,ba,ca)self.set("type","Timer")end -function aa:start()if -not self.running then self.running=true;local ba=self.get("interval") -self.timerId=os.startTimer(ba)end;return self end +function aa:start() +if +not self.running then self.running=true +local ba=self.getResolved("interval")self.timerId=os.startTimer(ba)end;return self end function aa:stop()if self.running then self.running=false os.cancelTimer(self.timerId)end;return self end function aa:dispatchEvent(ba,...)_a.dispatchEvent(self,ba,...) if ba=="timer"then local ca=select(1,...) -if ca==self.timerId then self.action()local da=self.get("amount")if da>0 then self.set("amount", -da-1)end;if da~=0 then -self.timerId=os.startTimer(self.get("interval"))end end end end;return aa end +if ca==self.timerId then self.action() +local da=self.getResolved("amount")if da>0 then self.set("amount",da-1)end;if da~=0 then +self.timerId=os.startTimer(self.getResolved("interval"))end end end end;return aa end project["elements/Program.lua"] = function(...) local ca=require("elementManager") local da=ca.getElement("VisualElement")local _b=require("errorManager")local ab=setmetatable({},da) ab.__index=ab @@ -334,30 +336,30 @@ return _c end function ab:init(_c,ac) da.init(self,_c,ac)self.set("type","Program") self:observe("width",function(bc,cc) -local dc=bc.get("program") -if dc then dc:resize(cc,bc.get("height"))end end) -self:observe("height",function(bc,cc)local dc=bc.get("program")if dc then -dc:resize(bc.get("width"),cc)end end)return self end +local dc=bc.getResolved("program") +if dc then dc:resize(cc,bc.getResolved("height"))end end) +self:observe("height",function(bc,cc)local dc=bc.getResolved("program")if dc then +dc:resize(bc.getResolved("width"),cc)end end)return self end function ab:execute(_c,ac,bc,...)self.set("path",_c)self.set("running",true) local cc=bb.new(self,ac,bc)self.set("program",cc)cc:setArgs(...) -cc:run(_c,self.get("width"),self.get("height"),...)self:updateRender()return self end;function ab:stop()local _c=self.get("program")if _c then _c:stop() +cc:run(_c,self.getResolved("width"),self.getResolved("height"),...)self:updateRender()return self end;function ab:stop()local _c=self.getResolved("program")if _c then _c:stop() self.set("running",false)self.set("program",nil)end return self end;function ab:sendEvent(_c,...) self:dispatchEvent(_c,...)return self end;function ab:onError(_c) self.set("errorCallback",_c)return self end;function ab:onDone(_c) self.set("doneCallback",_c)return self end function ab:dispatchEvent(_c,...) -local ac=self.get("program")local bc=da.dispatchEvent(self,_c,...) +local ac=self.getResolved("program")local bc=da.dispatchEvent(self,_c,...) if ac then ac:resume(_c,...) if (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() -if(da.focus(self))then local _c=self.get("program")if _c then +if(da.focus(self))then local _c=self.getResolved("program")if _c then local ac=_c.window.getCursorBlink()local bc,cc=_c.window.getCursorPos() self:setCursor(bc,cc,ac,_c.window.getTextColor())end end end -function ab:render()da.render(self)local _c=self.get("program") +function ab:render()da.render(self)local _c=self.getResolved("program") if _c then local ac,bc=_c.window.getSize()for y=1,bc do local cc,dc,_d=_c.window.getLine(y)if cc then self:blit(1,y,cc,dc,_d)end end end end;return ab end @@ -374,7 +376,7 @@ ab.class=ca;ab.set("width",12)ab.set("height",6) ab.set("background",colors.black)ab.set("z",5)return ab end;function ca:init(ab,bb)ba.init(self,ab,bb)self.set("type","Image") return self end function ca:resizeImage(ab,bb) -local cb=self.get("bimg") +local cb=self.getResolved("bimg") for db,_c in ipairs(cb)do local ac={} for y=1,bb do local bc=string.rep(" ",ab) local cc=string.rep("f",ab)local dc=string.rep("0",ab) @@ -383,19 +385,19 @@ local ad=_c[y][2]local bd=_c[y][3] bc=(_d..string.rep(" ",ab)):sub(1,ab) cc=(ad..string.rep("f",ab)):sub(1,ab) dc=(bd..string.rep("0",ab)):sub(1,ab)end;ac[y]={bc,cc,dc}end;cb[db]=ac end;self:updateRender()return self end -function ca:getImageSize()local ab=self.get("bimg")if not ab[1]or not ab[1][1]then -return 0,0 end;return#ab[1][1][1],#ab[1]end +function ca:getImageSize()local ab=self.getResolved("bimg")if +not ab[1]or not ab[1][1]then return 0,0 end;return#ab[1][1][1],#ab[1]end function ca:getPixelData(ab,bb) -local cb=self.get("bimg")[self.get("currentFrame")]if not cb or not cb[bb]then return end;local db=cb[bb][1] +local cb=self.getResolved("bimg")[self.getResolved("currentFrame")]if not cb or not cb[bb]then return end;local db=cb[bb][1] local _c=cb[bb][2]local ac=cb[bb][3] if not db or not _c or not ac then return end;local bc=tonumber(_c:sub(ab,ab),16) local cc=tonumber(ac:sub(ab,ab),16)local dc=db:sub(ab,ab)return bc,cc,dc end local function da(ab,bb) -local cb=ab.get("bimg")[ab.get("currentFrame")]if not cb then cb={} -ab.get("bimg")[ab.get("currentFrame")]=cb end +local cb=ab.getResolved("bimg")[ab.getResolved("currentFrame")]if not cb then cb={} +ab.getResolved("bimg")[ab.getResolved("currentFrame")]=cb end if not cb[bb]then cb[bb]={"","",""}end;return cb end -local function _b(ab,bb,cb)if not ab.get("autoResize")then return end -local db=ab.get("bimg")local _c=bb;local ac=cb +local function _b(ab,bb,cb)if not ab.getResolved("autoResize")then return end +local db=ab.getResolved("bimg")local _c=bb;local ac=cb for bc,cc in ipairs(db)do for dc,_d in pairs(cc)do _c=math.max(_c,#_d[1]) ac=math.max(ac,dc)end end for bc,cc in ipairs(db)do @@ -405,68 +407,69 @@ dc[2]=dc[2].."f"end;while#dc[3]<_c do dc[3]=dc[3].."0"end end end end function ca:setText(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][1]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][1] db[bb][1]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getText(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][1]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][1]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab,ab)end end function ca:setFg(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][2]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][2] db[bb][2]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getFg(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][2]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][2]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab)end end function ca:setBg(ab,bb,cb)if type(cb)~="string"or#cb<1 or ab<1 or bb<1 then return self end if -not self.get("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.get("autoResize")then +not self.getResolved("autoResize")then local ac,bc=self:getImageSize()if bb>bc then return self end end;local db=da(self,bb)if self.getResolved("autoResize")then _b(self,ab+#cb-1,bb)else local ac=#db[bb][3]if ab>ac then return self end cb=cb:sub(1,ac-ab+1)end local _c=db[bb][3] db[bb][3]=_c:sub(1,ab-1)..cb.._c:sub(ab+#cb)self:updateRender()return self end function ca:getBg(ab,bb,cb)if not ab or not bb then return""end -local db=self.get("bimg")[self.get("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][3]if not _c then +local db=self.getResolved("bimg")[self.getResolved("currentFrame")]if not db or not db[bb]then return""end;local _c=db[bb][3]if not _c then return""end if cb then return _c:sub(ab,ab+cb-1)else return _c:sub(ab)end end function ca:setPixel(ab,bb,cb,db,_c)if cb then self:setText(ab,bb,cb)end;if db then self:setFg(ab,bb,db)end;if _c then self:setBg(ab,bb,_c)end;return self end -function ca:nextFrame() -if not self.get("bimg").animation then return self end;local ab=self.get("bimg")local bb=self.get("currentFrame") -local cb=bb+1;if cb>#ab then cb=1 end;self.set("currentFrame",cb)return self end -function ca:addFrame()local ab=self.get("bimg") +function ca:nextFrame()if not self.getResolved("bimg").animation then +return self end;local ab=self.getResolved("bimg") +local bb=self.getResolved("currentFrame")local cb=bb+1;if cb>#ab then cb=1 end;self.set("currentFrame",cb) +return self end +function ca:addFrame()local ab=self.getResolved("bimg") local bb=ab.width or#ab[1][1][1]local cb=ab.height or#ab[1]local db={}local _c=string.rep(" ",bb) local ac=string.rep("f",bb)local bc=string.rep("0",bb)for y=1,cb do db[y]={_c,ac,bc}end -table.insert(ab,db)return self end;function ca:updateFrame(ab,bb)local cb=self.get("bimg")cb[ab]=bb +table.insert(ab,db)return self end;function ca:updateFrame(ab,bb)local cb=self.getResolved("bimg")cb[ab]=bb self:updateRender()return self end;function ca:getFrame(ab) -local bb=self.get("bimg") -return bb[ab or self.get("currentFrame")]end +local bb=self.getResolved("bimg") +return bb[ab or self.getResolved("currentFrame")]end function ca:getMetadata()local ab={} -local bb=self.get("bimg") +local bb=self.getResolved("bimg") for cb,db in pairs(bb)do if(type(db)=="string")then ab[cb]=db end end;return ab end function ca:setMetadata(ab,bb)if(type(ab)=="table")then for db,_c in pairs(ab)do self:setMetadata(db,_c)end;return self end -local cb=self.get("bimg")if(type(bb)=="string")then cb[ab]=bb end;return self end +local cb=self.getResolved("bimg")if(type(bb)=="string")then cb[ab]=bb end;return self end function ca:render()ba.render(self) -local ab=self.get("bimg")[self.get("currentFrame")]if not ab then return end;local bb=self.get("offsetX") -local cb=self.get("offsetY")local db=self.get("width")local _c=self.get("height") -for y=1,_c do local ac=y+cb -local bc=ab[ac] +local ab=self.getResolved("bimg")[self.getResolved("currentFrame")]if not ab then return end;local bb=self.getResolved("offsetX") +local cb=self.getResolved("offsetY")local db=self.getResolved("width") +local _c=self.getResolved("height") +for y=1,_c do local ac=y+cb;local bc=ab[ac] if bc then local cc=bc[1]local dc=bc[2]local _d=bc[3] -if cc and dc and _d then -local ad=db-math.max(0,bb) -if ad>0 then if bb<0 then local bd=math.abs(bb)+1;cc=cc:sub(bd)dc=dc:sub(bd) -_d=_d:sub(bd)end;cc=cc:sub(1,ad) -dc=dc:sub(1,ad)_d=_d:sub(1,ad) +if cc and dc and _d then local ad=db- +math.max(0,bb) +if ad>0 then if bb<0 then local bd=math.abs(bb)+1 +cc=cc:sub(bd)dc=dc:sub(bd)_d=_d:sub(bd)end +cc=cc:sub(1,ad)dc=dc:sub(1,ad)_d=_d:sub(1,ad) self:blit(math.max(1,1 +bb),y,cc,dc,_d)end end end end end;return ca end project["elements/BarChart.lua"] = function(...) local aa=require("elementManager") local ba=aa.getElement("VisualElement")local ca=aa.getElement("Graph") @@ -474,13 +477,13 @@ local da=require("libraries/colorHex")local _b=setmetatable({},ca)_b.__index=_b; local ab=setmetatable({},_b):__init()ab.class=_b;return ab end function _b:init(ab,bb) ca.init(self,ab,bb)self.set("type","BarChart")return self end -function _b:render()ba.render(self)local ab=self.get("width") -local bb=self.get("height")local cb=self.get("minValue")local db=self.get("maxValue") -local _c=self.get("series")local ac=0;local bc={} -for ad,bd in pairs(_c)do if(bd.visible)then if#bd.data>0 then ac=ac+1 -table.insert(bc,bd)end end end;local cc=ac;local dc=1 -local _d=math.min(bc[1]and bc[1].pointCount or 0,math.floor((ab+dc)/ ( -cc+dc))) +function _b:render()ba.render(self)local ab=self.getResolved("width") +local bb=self.getResolved("height")local cb=self.getResolved("minValue") +local db=self.getResolved("maxValue")local _c=self.getResolved("series")local ac=0;local bc={}for ad,bd in pairs(_c)do +if(bd.visible)then if# +bd.data>0 then ac=ac+1;table.insert(bc,bd)end end end;local cc=ac;local dc=1 +local _d=math.min(bc[1]and +bc[1].pointCount or 0,math.floor((ab+dc)/ (cc+dc))) for groupIndex=1,_d do local ad=( (groupIndex-1)* (cc+dc))+1 for bd,cd in ipairs(bc)do local dd=cd.data[groupIndex] @@ -502,80 +505,86 @@ return ab end function _b:init(ab,bb) ca.init(self,ab,bb)self.set("type","ComboBox") self.set("cursorPos",1)self.set("viewOffset",0)return self end -function _b:getFilteredItems()local ab=self.get("items")or{} -local bb=self.get("text"):lower() -if not self.get("autoComplete")or#bb==0 then return ab end;local cb={} -for db,_c in ipairs(ab)do local ac="" -if type(_c)=="string"then ac=_c:lower()elseif -type(_c)=="table"and _c.text then ac=_c.text:lower()end;if ac:find(bb,1,true)then table.insert(cb,_c)end end;return cb end +function _b:getFilteredItems()local ab=self.getResolved("items")or{} +local bb=self.getResolved("text"):lower()if +not self.getResolved("autoComplete")or#bb==0 then return ab end;local cb={} +for db,_c in ipairs(ab)do local ac=""if +type(_c)=="string"then ac=_c:lower()elseif type(_c)=="table"and _c.text then +ac=_c.text:lower()end;if ac:find(bb,1,true)then +table.insert(cb,_c)end end;return cb end function _b:updateFilteredDropdown() -if not self.get("autoComplete")then return end;local ab=self:getFilteredItems()local bb=#ab>0 and -#self.get("text")>0 -if bb then self:setState("opened") -self.set("manuallyOpened",false)local cb=self.get("dropdownHeight")or 5 -local db=math.min(cb,#ab)self.set("height",1 +db)else -self:unsetState("opened")self.set("manuallyOpened",false) -self.set("height",1)end;self:updateRender()end -function _b:updateViewport()local ab=self.get("text") -local bb=self.get("cursorPos")local cb=self.get("width")local db=self.get("dropSymbol") -local _c=cb-#db;if _c<1 then _c=1 end;local ac=self.get("viewOffset")if bb-ac>_c then ac=bb-_c elseif -bb-1 0 and +#self.getResolved("text")>0 +if bb then +self:setState("opened")self.set("manuallyOpened",false)local cb= +self.getResolved("dropdownHeight")or 5;local db=math.min(cb,#ab)self.set("height", +1 +db)else self:unsetState("opened") +self.set("manuallyOpened",false)self.set("height",1)end;self:updateRender()end +function _b:updateViewport()local ab=self.getResolved("text") +local bb=self.getResolved("cursorPos")local cb=self.getResolved("width") +local db=self.getResolved("dropSymbol")local _c=cb-#db;if _c<1 then _c=1 end +local ac=self.getResolved("viewOffset") +if bb-ac>_c then ac=bb-_c elseif bb-1 1 then local _c=cb:sub(1,db-2).. cb:sub(db)self.set("text",_c) -self.set("cursorPos",db-1)self:updateViewport()if self.get("autoComplete")then +self.set("cursorPos",db-1)self:updateViewport() +if self.getResolved("autoComplete")then self:updateFilteredDropdown()else self:updateRender()end end elseif ab==keys.delete then if db<=#cb then local _c=cb:sub(1,db-1)..cb:sub(db+1)self.set("text",_c)self:updateViewport() if -self.get("autoComplete")then self:updateFilteredDropdown()else self:updateRender()end end elseif ab==keys.home then self.set("cursorPos",1) +self.getResolved("autoComplete")then self:updateFilteredDropdown()else self:updateRender()end end elseif ab==keys.home then self.set("cursorPos",1) self:updateViewport()elseif ab==keys["end"]then self.set("cursorPos",#cb+1) self:updateViewport()elseif ab==keys.enter then if self:hasState("opened")then self:unsetState("opened")else self:setState("opened")end;self:updateRender()end end function _b:mouse_click(ab,bb,cb) if not aa.mouse_click(self,ab,bb,cb)then return false end;local db,_c=self:getRelativePosition(bb,cb) -local ac=self.get("width")local bc=self.get("dropSymbol") +local ac=self.getResolved("width")local bc=self.getResolved("dropSymbol") local cc=self:hasState("opened") if _c==1 then if db>=ac-#bc+1 and db<=ac then if cc then self:unsetState("opened")self.set("height",1) self.set("manuallyOpened",false)else self:setState("opened") -local dc=self.get("items")or{}local _d=self.get("dropdownHeight")or 5 -local ad=math.min(_d,#dc)self.set("height",1 +ad) +local dc=self.getResolved("items")or{} +local _d=self.getResolved("dropdownHeight")or 5;local ad=math.min(_d,#dc)self.set("height",1 +ad) self.set("manuallyOpened",true)end;self:updateRender()return true end -if db<=ac-#bc and self.get("editable")then -local dc=self.get("text")local _d=self.get("viewOffset")local ad=#dc+1 +if db<=ac-#bc and self.getResolved("editable")then +local dc=self.getResolved("text")local _d=self.getResolved("viewOffset")local ad=#dc+1 local bd=math.min(ad,_d+db)self.set("cursorPos",bd) if not cc then -self:setState("opened")local cd=self.get("items")or{} -local dd=self.get("dropdownHeight")or 5;local __a=math.min(dd,#cd)self.set("height",1 +__a) +self:setState("opened")local cd=self.getResolved("items")or{}local dd= +self.getResolved("dropdownHeight")or 5;local __a=math.min(dd,#cd)self.set("height", +1 +__a) self.set("manuallyOpened",true)end;self:updateRender()return true end;return true elseif cc and _c>1 then return ca.mouse_click(self,ab,bb,cb)end;return false end function _b:mouse_up(ab,bb,cb) if self:hasState("opened")then local db,_c=self:getRelativePosition(bb,cb) -if -_c>1 and self.get("selectable")and not self._scrollBarDragging then local ac=(_c-1)+self.get("offset")local bc -if -self.get("autoComplete")and not self.get("manuallyOpened")then -bc=self:getFilteredItems()else bc=self.get("items")end -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 +if _c>1 and self.getResolved("selectable")and +not self._scrollBarDragging then +local ac=(_c-1)+self.getResolved("offset")local bc;if self.getResolved("autoComplete")and +not self.getResolved("manuallyOpened")then bc=self:getFilteredItems()else +bc=self.getResolved("items")end +if ac<= +#bc then local cc=bc[ac] +if type(cc)=="string"then cc={text=cc}bc[ac]=cc end;if not self.getResolved("multiSelection")then for dc,_d in -ipairs(self.get("items"))do if type(_d)=="table"then _d.selected=false end end end +ipairs(self.getResolved("items"))do if type(_d)=="table"then _d.selected=false end end end cc.selected=true if cc.text then self.set("text",cc.text) self.set("cursorPos",#cc.text+1)self:updateViewport()end;if cc.callback then cc.callback(self)end @@ -583,28 +592,30 @@ self:fireEvent("select",ac,cc)self:unsetState("opened") self:unsetState("clicked")self.set("height",1) self.set("manuallyOpened",false)self:updateRender()return true end end;return ca.mouse_up(self,ab,bb,cb)end;return aa.mouse_up and aa.mouse_up(self,ab,bb,cb)or false end -function _b:render()aa.render(self)local ab=self.get("text") -local bb=self.get("width")local cb=self.get("dropSymbol") +function _b:render()aa.render(self)local ab=self.getResolved("text") +local bb=self.getResolved("width")local cb=self.getResolved("dropSymbol") local db=self:hasState("focused")local _c=self:hasState("opened") -local ac=self.get("viewOffset")local bc=self.getResolved("selectedText") +local ac=self.getResolved("viewOffset")local bc=self.getResolved("selectedText") local cc=self.getResolved("background")local dc=self.getResolved("foreground")local _d=ab;local ad=bb-#cb if #ab==0 and not db and#bc>0 then _d=bc;dc=colors.gray end;if#_d>0 then _d=_d:sub(ac+1,ac+ad)end;_d=_d.. string.rep(" ",ad-#_d) local bd=_d.. (_c and"\31"or"\17") -self:blit(1,1,bd,string.rep(da[dc],bb),string.rep(da[cc],bb))if db and self.get("editable")then local cd=self.get("cursorPos") -local dd=cd-ac +self:blit(1,1,bd,string.rep(da[dc],bb),string.rep(da[cc],bb)) +if db and self.getResolved("editable")then +local cd=self.getResolved("cursorPos")local dd=cd-ac if dd>=1 and dd<=ad then self:setCursor(dd,1,true,dc)end end -if _c then -local cd=self.get("height")local dd=self.get("items")if self.get("autoComplete")and not -self.get("manuallyOpened")then -dd=self:getFilteredItems()end;local __a=math.min(self.get("dropdownHeight"), -#dd) -local a_a=self._values.items;self._values.items=dd;self.set("height",__a) -ba.render(self,1)self._values.items=a_a;self.set("height",cd) -self:blit(1,1,bd,string.rep(da[dc],bb),string.rep(da[cc],bb))if db and self.get("editable")then local b_a=self.get("cursorPos")local c_a=b_a- -ac -if c_a>=1 and c_a<=ad then self:setCursor(c_a,1,true,dc)end end end end;return _b end +if _c then local cd=self.getResolved("height") +local dd=self.getResolved("items") +if self.getResolved("autoComplete")and +not self.getResolved("manuallyOpened")then dd=self:getFilteredItems()end +local __a=math.min(self.getResolved("dropdownHeight"),#dd)local a_a=self._values.items;self._values.items=dd +self.set("height",__a)ba.render(self,1)self._values.items=a_a +self.set("height",cd) +self:blit(1,1,bd,string.rep(da[dc],bb),string.rep(da[cc],bb)) +if db and self.getResolved("editable")then +local b_a=self.getResolved("cursorPos")local c_a=b_a-ac;if c_a>=1 and c_a<=ad then +self:setCursor(c_a,1,true,dc)end end end end;return _b end project["elements/ScrollFrame.lua"] = function(...) local _a=require("elementManager") local aa=_a.getElement("Container")local ba=require("libraries/colorHex") local ca=setmetatable({},aa)ca.__index=ca @@ -614,12 +625,12 @@ ca.defineProperty(ca,"scrollBarBackgroundSymbol",{default="\127",type="string",c ca.defineProperty(ca,"scrollBarColor",{default=colors.lightGray,type="color",canTriggerRender=true}) ca.defineProperty(ca,"scrollBarBackgroundColor",{default=colors.gray,type="color",canTriggerRender=true}) ca.defineProperty(ca,"scrollBarBackgroundColor2",{default=colors.black,type="color",canTriggerRender=true}) -ca.defineProperty(ca,"contentWidth",{default=0,type="number",getter=function(da)local _b=0;local ab=da.get("children") -for bb,cb in ipairs(ab)do -local db=cb.get("x")local _c=cb.get("width")local ac=db+_c-1;if ac>_b then _b=ac end end;return _b end}) -ca.defineProperty(ca,"contentHeight",{default=0,type="number",getter=function(da)local _b=0;local ab=da.get("children") -for bb,cb in ipairs(ab)do -local db=cb.get("y")local _c=cb.get("height")local ac=db+_c-1;if ac>_b then _b=ac end end;return _b end})ca.defineEvent(ca,"mouse_click") +ca.defineProperty(ca,"contentWidth",{default=0,type="number",getter=function(da)local _b=0;local ab=da.getResolved("children")for bb,cb in +ipairs(ab)do local db=cb.get("x")local _c=cb.get("width")local ac=db+_c-1 +if ac>_b then _b=ac end end;return _b end}) +ca.defineProperty(ca,"contentHeight",{default=0,type="number",getter=function(da)local _b=0;local ab=da.getResolved("children")for bb,cb in +ipairs(ab)do local db=cb.get("y")local _c=cb.get("height")local ac=db+_c-1 +if ac>_b then _b=ac end end;return _b end})ca.defineEvent(ca,"mouse_click") ca.defineEvent(ca,"mouse_drag")ca.defineEvent(ca,"mouse_up") ca.defineEvent(ca,"mouse_scroll")function ca.new()local da=setmetatable({},ca):__init() da.class=ca;da.set("width",20)da.set("height",10)da.set("z",5) @@ -628,42 +639,46 @@ function ca:init(da,_b) aa.init(self,da,_b)self.set("type","ScrollFrame")return self end function ca:mouse_click(da,_b,ab) if aa.mouse_click(self,da,_b,ab)then -local bb,cb=self:getRelativePosition(_b,ab)local db=self.get("width")local _c=self.get("height") -local ac=self.get("showScrollBar")local bc=self.get("contentWidth") -local cc=self.get("contentHeight")local dc=ac and bc>db;local _d=dc and _c-1 or _c -local ad=ac and cc>_d;local bd=ad and db-1 or db -if -ad and bb==db and(not dc or cb<_c)then local cd=_d -local dd=math.max(1,math.floor((_d/cc)*cd))local __a=cc-_d;local a_a= -__a>0 and(self.get("offsetY")/__a*100)or 0;local b_a= -math.floor((a_a/100)* (cd-dd))+1 -if cb>=b_a and cbdb;local _d=dc and _c-1 or _c;local ad=ac and cc>_d +local bd=ad and db-1 or db +if ad and bb==db and(not dc or cb<_c)then local cd=_d +local dd=math.max(1,math.floor((_d/cc)*cd))local __a=cc-_d +local a_a=__a>0 and +(self.getResolved("offsetY")/__a*100)or 0 +local b_a=math.floor((a_a/100)* (cd-dd))+1 +if cb>=b_a and cb0 and(self.get("offsetX")/__a*100)or 0;local b_a= -math.floor((a_a/100)* (cd-dd))+1 -if bb>=b_a and bb0 and +(self.getResolved("offsetX")/__a*100)or 0 +local b_a=math.floor((a_a/100)* (cd-dd))+1 +if bb>=b_a and bbbc;local dc=cc and db-1 or db;local _d=dc +local db=self.getResolved("height")local _c=self.getResolved("contentWidth") +local ac=self.getResolved("contentHeight")local bc=self.getResolved("width")local cc= +self.getResolved("showScrollBar")and _c>bc +local dc=cc and db-1 or db;local _d=dc local ad=math.max(1,math.floor((dc/ac)*_d))local bd=ac-dc;cb=math.max(1,math.min(_d,cb))local cd=cb- ( self._scrollBarDragOffset or 0)local dd= ( (cd-1)/ (_d-ad))*100 local __a=math.floor((dd/100)*bd+0.5) self.set("offsetY",math.max(0,math.min(bd,__a)))return true end if self._hScrollBarDragging then local bb,cb=self:getRelativePosition(_b,ab) -local db=self.get("width")local _c=self.get("contentWidth") -local ac=self.get("contentHeight")local bc=self.get("height") -local cc=self.get("showScrollBar")and _c>db;local dc=cc and bc-1 or bc -local _d=self.get("showScrollBar")and ac>dc;local ad=_d and db-1 or db;local bd=ad +local db=self.getResolved("width")local _c=self.getResolved("contentWidth") +local ac=self.getResolved("contentHeight")local bc=self.getResolved("height")local cc= +self.getResolved("showScrollBar")and _c>db +local dc=cc and bc-1 or bc +local _d=self.getResolved("showScrollBar")and ac>dc;local ad=_d and db-1 or db;local bd=ad local cd=math.max(1,math.floor((ad/_c)*bd))local dd=_c-ad;bb=math.max(1,math.min(bd,bb))local __a=bb- ( self._hScrollBarDragOffset or 0)local a_a= ( (__a-1)/ (bd-cd))*100 @@ -677,35 +692,39 @@ self._hScrollBarDragging=false;self._hScrollBarDragOffset=nil;return true end;re aa.mouse_up and aa.mouse_up(self,da,_b,ab)or false end function ca:mouse_scroll(da,_b,ab) if self:isInBounds(_b,ab)then -local bb,cb=self.get("offsetX"),self.get("offsetY")local db,_c=self:getRelativePosition(_b+bb,ab+cb) -local ac,bc=self:callChildrenEvent(true,"mouse_scroll",da,db,_c)if ac then return true end;local cc=self.get("height") -local dc=self.get("width")local _d=self.get("offsetY")local ad=self.get("offsetX") -local bd=self.get("contentWidth")local cd=self.get("contentHeight") -local dd=self.get("showScrollBar")and bd>dc;local __a=dd and cc-1 or cc -local a_a=self.get("showScrollBar")and cd>__a;local b_a=a_a and dc-1 or dc +local bb,cb=self.getResolved("offsetX"),self.getResolved("offsetY")local db,_c=self:getRelativePosition(_b+bb,ab+cb) +local ac,bc=self:callChildrenEvent(true,"mouse_scroll",da,db,_c)if ac then return true end;local cc=self.getResolved("height") +local dc=self.getResolved("width")local _d=self.getResolved("offsetY") +local ad=self.getResolved("offsetX")local bd=self.getResolved("contentWidth") +local cd=self.getResolved("contentHeight") +local dd=self.getResolved("showScrollBar")and bd>dc;local __a=dd and cc-1 or cc +local a_a=self.getResolved("showScrollBar")and cd>__a;local b_a=a_a and dc-1 or dc if a_a then local c_a=math.max(0,cd-__a)local d_a=math.min(c_a,math.max(0, _d+da)) self.set("offsetY",d_a)elseif dd then local c_a=math.max(0,bd-b_a) local d_a=math.min(c_a,math.max(0,ad+da))self.set("offsetX",d_a)end;return true end;return false end -function ca:render()aa.render(self)local da=self.get("height") -local _b=self.get("width")local ab=self.get("offsetY")local bb=self.get("offsetX") -local cb=self.get("showScrollBar")local db=self.get("contentWidth") -local _c=self.get("contentHeight")local ac=cb and db>_b;local bc=ac and da-1 or da -local cc=cb and _c>bc;local dc=cc and _b-1 or _b +function ca:render()aa.render(self)local da=self.getResolved("height") +local _b=self.getResolved("width")local ab=self.getResolved("offsetY") +local bb=self.getResolved("offsetX")local cb=self.getResolved("showScrollBar") +local db=self.getResolved("contentWidth")local _c=self.getResolved("contentHeight") +local ac=cb and db>_b;local bc=ac and da-1 or da;local cc=cb and _c>bc +local dc=cc and _b-1 or _b if cc then local _d=bc -local ad=math.max(1,math.floor((bc/_c)*_d))local bd=_c-bc;local cd=self.get("scrollBarBackgroundSymbol") -local dd=self.get("scrollBarColor")local __a=self.get("scrollBarBackgroundColor") -local a_a=self.get("scrollBarBackgroundColor2")local b_a=bd>0 and(ab/bd*100)or 0;local c_a= +local ad=math.max(1,math.floor((bc/_c)*_d))local bd=_c-bc +local cd=self.getResolved("scrollBarBackgroundSymbol")local dd=self.getResolved("scrollBarColor") +local __a=self.getResolved("scrollBarBackgroundColor")local a_a=self.getResolved("scrollBarBackgroundColor2")local b_a= +bd>0 and(ab/bd*100)or 0;local c_a= math.floor((b_a/100)* (_d-ad))+1;for i=1,_d do if i>=c_a and i0 and(bb/bd*100)or 0;local c_a= +local ad=math.max(1,math.floor((dc/db)*_d))local bd=db-dc +local cd=self.getResolved("scrollBarBackgroundSymbol")local dd=self.getResolved("scrollBarColor") +local __a=self.getResolved("scrollBarBackgroundColor")local a_a=self.getResolved("scrollBarBackgroundColor2")local b_a= +bd>0 and(bb/bd*100)or 0;local c_a= math.floor((b_a/100)* (_d-ad))+1;for i=1,_d do if i>=c_a and i0 then ab._tabId=1;self:updateTabVisibility()end end;return self end;function _b:updateTabVisibility()self.set("childrenSorted",false) self.set("childrenEventsSorted",false)end function _b:setActiveTab(ab) -local bb=self.get("activeTab")if bb==ab then return self end;self.set("activeTab",ab) +local bb=self.getResolved("activeTab")if bb==ab then return self end;self.set("activeTab",ab) self:updateTabVisibility()self:dispatchEvent("tabChanged",ab,bb)return self end function _b:isChildVisible(ab) -if not ca.isChildVisible(self,ab)then return false end -if ab._tabId then return ab._tabId==self.get("activeTab")end;return true end +if not ca.isChildVisible(self,ab)then return false end;if ab._tabId then +return ab._tabId==self.getResolved("activeTab")end;return true end function _b:getContentYOffset()local ab=self:_getHeaderMetrics()return ab.headerHeight end -function _b:_getHeaderMetrics()local ab=self.get("tabs")or{} -local bb=self.get("width")or 1;local cb=self.get("tabHeight")or 1 -local db=self.get("scrollableTab")local _c={} -if db then local ac=self.get("tabScrollOffset")or 0 -local bc=1;local cc=0 -for dc,_d in ipairs(ab)do local ad=#_d.title+2;if ad>bb then ad=bb end;local bd=bc-ac -local cd=0;local dd=0;if bd<1 then cd=1 -bd end -if bd+ad-1 >bb then dd=(bd+ad-1)-bb end -if bd+ad>1 and bd<=bb then local __a=math.max(1,bd)local a_a=ad-cd-dd -table.insert(_c,{id=_d.id,title=_d.title,line=1,x1=__a,x2= -__a+a_a-1,width=ad,displayWidth=a_a,actualX=bc,startClip=cd,endClip=dd})end;bc=bc+ad end;cc=bc-1;return +function _b:_getHeaderMetrics()local ab=self.getResolved("tabs")or{}local bb= +self.getResolved("width")or 1 +local cb=self.getResolved("tabHeight")or 1;local db=self.getResolved("scrollableTab")local _c={} +if db then local ac= +self.getResolved("tabScrollOffset")or 0;local bc=1;local cc=0 +for dc,_d in ipairs(ab)do +local ad=#_d.title+2;if ad>bb then ad=bb end;local bd=bc-ac;local cd=0;local dd=0;if bd<1 then cd=1 -bd end;if +bd+ad-1 >bb then dd=(bd+ad-1)-bb end +if bd+ad>1 and bd<=bb then +local __a=math.max(1,bd)local a_a=ad-cd-dd +table.insert(_c,{id=_d.id,title=_d.title,line=1,x1=__a,x2=__a+a_a-1,width=ad,displayWidth=a_a,actualX=bc,startClip=cd,endClip=dd})end;bc=bc+ad end;cc=bc-1;return {headerHeight=1,lines=1,positions=_c,totalWidth=cc,scrollOffset=ac,maxScroll=math.max(0,cc-bb)}else local ac=1;local bc=1 for _d,ad in ipairs(ab)do local bd=# ad.title+2;if bd>bb then bd=bb end @@ -813,14 +832,15 @@ if ba.mouse_drag(self,ab,bb,cb)then local db,_c=ba.getRelativePosition(self,bb,cb)local ac=self:_getHeaderMetrics().headerHeight;if _c<=ac then return true end;return ca.mouse_drag(self,ab,bb,cb)end;return false end function _b:scrollTabs(ab) -if not self.get("scrollableTab")then return self end;local bb=self:_getHeaderMetrics() -local cb=self.get("tabScrollOffset")or 0;local db=bb.maxScroll or 0;local _c=cb+ (ab*5) -_c=math.max(0,math.min(db,_c))self.set("tabScrollOffset",_c)return self end +if not self.getResolved("scrollableTab")then return self end;local bb=self:_getHeaderMetrics()local cb= +self.getResolved("tabScrollOffset")or 0;local db=bb.maxScroll or 0;local _c=cb+ ( +ab*5)_c=math.max(0,math.min(db,_c)) +self.set("tabScrollOffset",_c)return self end function _b:mouse_scroll(ab,bb,cb) if ba.mouse_scroll(self,ab,bb,cb)then -local db=self:_getHeaderMetrics().headerHeight;if self.get("scrollableTab")and cb==self.get("y")then -self:scrollTabs(ab)return true end;return -ca.mouse_scroll(self,ab,bb,cb)end;return false end +local db=self:_getHeaderMetrics().headerHeight +if +self.getResolved("scrollableTab")and cb==self.getResolved("y")then self:scrollTabs(ab)return true end;return ca.mouse_scroll(self,ab,bb,cb)end;return false end function _b:setCursor(ab,bb,cb,db)local _c=self:_getHeaderMetrics().headerHeight if self.parent then local ac,bc=self:calculatePosition()local cc=ab+ac-1 @@ -828,25 +848,27 @@ local dc=bb+bc-1 +_c if (cc<1)or(cc>self.parent.get("width"))or(dc<1)or(dc>self.parent.get("height"))then return self.parent:setCursor(cc,dc,false)end;return self.parent:setCursor(cc,dc,cb,db)end;return self end -function _b:render()ba.render(self)local ab=self.get("width") -local bb=self:_getHeaderMetrics()local cb=bb.headerHeight or 1 -ba.multiBlit(self,1,1,ab,cb," ",da[self.get("foreground")],da[self.get("headerBackground")])local db=self.get("activeTab") -for _c,ac in ipairs(bb.positions)do -local bc=(ac.id==db)and -self.get("activeTabBackground")or self.get("headerBackground")local cc=(ac.id==db)and self.get("activeTabTextColor")or -self.get("foreground") -ba.multiBlit(self,ac.x1,ac.line, -ac.displayWidth or(ac.x2 -ac.x1 +1),1," ",da[self.get("foreground")],da[bc])local dc=ac.title;local _d=1 + (ac.startClip or 0) -local ad=#ac.title- (ac.startClip or -0)- (ac.endClip or 0)if ad>0 then dc=ac.title:sub(_d,_d+ad-1)local bd=ac.x1;if -(ac.startClip or 0)==0 then bd=bd+1 end -ba.textFg(self,bd,ac.line,dc,cc)end end -if not self.get("childrenSorted")then self:sortChildren()end -if not self.get("childrenEventsSorted")then for _c in pairs(self._values.childrenEvents or -{})do -self:sortChildrenEvents(_c)end end -for _c,ac in ipairs(self.get("visibleChildren")or{})do if ac==self then -error("CIRCULAR REFERENCE DETECTED!")return end;ac:render()ac:postRender()end end +function _b:render()ba.render(self)local ab=self.getResolved("width") +local bb=self.getResolved("foreground")local cb=self.getResolved("headerBackground") +local db=self:_getHeaderMetrics()local _c=db.headerHeight or 1 +ba.multiBlit(self,1,1,ab,_c," ",da[bb],da[cb])local ac=self.getResolved("activeTab") +for bc,cc in ipairs(db.positions)do +local dc= +(cc.id==ac)and self.getResolved("activeTabBackground")or cb;local _d= +(cc.id==ac)and self.getResolved("activeTabTextColor")or bb +ba.multiBlit(self,cc.x1,cc.line, +cc.displayWidth or(cc.x2 -cc.x1 +1),1," ",da[bb],da[dc])local ad=cc.title;local bd=1 + (cc.startClip or 0) +local cd=#cc.title- (cc.startClip or +0)- (cc.endClip or 0)if cd>0 then ad=cc.title:sub(bd,bd+cd-1)local dd=cc.x1;if +(cc.startClip or 0)==0 then dd=dd+1 end +ba.textFg(self,dd,cc.line,ad,_d)end end;if not self.getResolved("childrenSorted")then +self:sortChildren()end +if +not self.getResolved("childrenEventsSorted")then for bc in pairs(self._values.childrenEvents or{})do +self:sortChildrenEvents(bc)end end +for bc,cc in +ipairs(self.getResolved("visibleChildren")or{})do +if cc==self then error("CIRCULAR REFERENCE DETECTED!")return end;cc:render()cc:postRender()end end function _b:sortChildrenEvents(ab) local bb=self._values.childrenEvents and self._values.childrenEvents[ab] if bb then local cb={}for db,_c in ipairs(bb)do @@ -896,18 +918,18 @@ d_a.defineEvent(d_a,"mouse_scroll")d_a.defineEvent(d_a,"paste") d_a.defineEvent(d_a,"auto_complete_open")d_a.defineEvent(d_a,"auto_complete_close") d_a.defineEvent(d_a,"auto_complete_accept")local _aa;local aaa;local function baa(c_b)local d_b=c_b._autoCompleteFrame return -d_b and not d_b._destroyed and d_b.get and d_b.get("visible")end -local function caa(c_b)return -c_b.get("autoCompleteShowBorder")and 1 or 0 end -local function daa(c_b)local d_b=c_b._autoCompleteFrame;local _ab=c_b._autoCompleteList;if -not d_b or d_b._destroyed then return end -d_b:setBackground(c_b.get("autoCompleteBackground")) -d_b:setForeground(c_b.get("autoCompleteForeground")) +d_b and not d_b._destroyed and d_b.get and d_b.get("visible")end;local function caa(c_b) +return +c_b.getResolved("autoCompleteShowBorder")and 1 or 0 end +local function daa(c_b)local d_b=c_b._autoCompleteFrame +local _ab=c_b._autoCompleteList;if not d_b or d_b._destroyed then return end +d_b:setBackground(c_b.getResolved("autoCompleteBackground")) +d_b:setForeground(c_b.getResolved("autoCompleteForeground")) if _ab and not _ab._destroyed then -_ab:setBackground(c_b.get("autoCompleteBackground")) -_ab:setForeground(c_b.get("autoCompleteForeground")) -_ab:setSelectedBackground(c_b.get("autoCompleteSelectedBackground")) -_ab:setSelectedForeground(c_b.get("autoCompleteSelectedForeground"))_ab:updateRender()end;aaa(c_b)_aa(c_b)d_b:updateRender()end +_ab:setBackground(c_b.getResolved("autoCompleteBackground")) +_ab:setForeground(c_b.getResolved("autoCompleteForeground")) +_ab:setSelectedBackground(c_b.getResolved("autoCompleteSelectedBackground")) +_ab:setSelectedForeground(c_b.getResolved("autoCompleteSelectedForeground"))_ab:updateRender()end;aaa(c_b)_aa(c_b)d_b:updateRender()end local function _ba(c_b,d_b,_ab)local aab=c_b._autoCompleteList if not aab or aab._destroyed then return end;local bab=aab.get("items")local cab=#bab;if cab==0 then return end if d_b<1 then d_b=1 end;if d_b>cab then d_b=cab end;c_b._autoCompleteIndex=d_b @@ -924,26 +946,27 @@ c_b._autoCompleteIndex=nil;c_b._autoCompleteSuggestions=nil;c_b._autoCompleteTok c_b._autoCompleteTokenStart=nil;c_b._autoCompletePopupWidth=nil end local function bba(c_b,d_b)local _ab=c_b._autoCompleteSuggestions or{} local aab=c_b._autoCompleteIndex or 1;local bab=d_b or _ab[aab]if not bab then return end -local cab=bab.insert or bab.text or""if cab==""then return end;local dab=c_b.get("lines") -local _bb=c_b.get("cursorY")local abb=c_b.get("cursorX")local bbb=dab[_bb]or"" -local cbb=c_b._autoCompleteTokenStart or abb;if cbb<1 then cbb=1 end;local dbb=bbb:sub(1,cbb-1)local _cb=bbb:sub(abb)dab[_bb]= -dbb..cab.._cb;c_b.set("cursorX",cbb+#cab) -c_b:updateViewport()c_b:updateRender()aba(c_b,true) +local cab=bab.insert or bab.text or""if cab==""then return end;local dab=c_b.getResolved("lines") +local _bb=c_b.getResolved("cursorY")local abb=c_b.getResolved("cursorX")local bbb=dab[_bb]or""local cbb= +c_b._autoCompleteTokenStart or abb;if cbb<1 then cbb=1 end +local dbb=bbb:sub(1,cbb-1)local _cb=bbb:sub(abb)dab[_bb]=dbb..cab.._cb +c_b.set("cursorX",cbb+#cab)c_b:updateViewport()c_b:updateRender() +aba(c_b,true) c_b:fireEvent("auto_complete_accept",cab,bab.source or bab)end local function cba(c_b) -if not c_b.get("autoCompleteEnabled")then return nil end;local d_b=c_b._autoCompleteFrame;if d_b and not d_b._destroyed then +if not c_b.getResolved("autoCompleteEnabled")then return nil end;local d_b=c_b._autoCompleteFrame;if d_b and not d_b._destroyed then return c_b._autoCompleteList end;local _ab=c_b:getBaseFrame()if not _ab or not _ab.addFrame then return nil end -d_b=_ab:addFrame({width=c_b.get("width"),height=1,x=1,y=1,visible=false,background=c_b.get("autoCompleteBackground"),foreground=c_b.get("autoCompleteForeground"),ignoreOffset=true,z= -c_b.get("z")+c_b.get("autoCompleteZOffset")})d_b:setIgnoreOffset(true)d_b:setVisible(false) +d_b=_ab:addFrame({width=c_b.getResolved("width"),height=1,x=1,y=1,visible=false,background=c_b.getResolved("autoCompleteBackground"),foreground=c_b.getResolved("autoCompleteForeground"),ignoreOffset=true,z= +c_b.getResolved("z")+c_b.getResolved("autoCompleteZOffset")})d_b:setIgnoreOffset(true)d_b:setVisible(false) local aab=caa(c_b) local bab=d_b:addList({x=aab+1,y=aab+1,width=math.max(1,d_b.get("width")-aab*2),height=math.max(1, -d_b.get("height")-aab*2),selectable=true,multiSelection=false,background=c_b.get("autoCompleteBackground"),foreground=c_b.get("autoCompleteForeground")}) -bab:setSelectedBackground(c_b.get("autoCompleteSelectedBackground")) -bab:setSelectedForeground(c_b.get("autoCompleteSelectedForeground"))bab:setOffset(0) +d_b.get("height")-aab*2),selectable=true,multiSelection=false,background=c_b.getResolved("autoCompleteBackground"),foreground=c_b.getResolved("autoCompleteForeground")}) +bab:setSelectedBackground(c_b.getResolved("autoCompleteSelectedBackground")) +bab:setSelectedForeground(c_b.getResolved("autoCompleteSelectedForeground"))bab:setOffset(0) bab:onSelect(function(cab,dab,_bb)if not baa(c_b)then return end _ba(c_b,dab) -if c_b.get("autoCompleteAcceptOnClick")then bba(c_b,_bb)end end)c_b._autoCompleteFrame=d_b;c_b._autoCompleteList=bab;daa(c_b)return bab end +if c_b.getResolved("autoCompleteAcceptOnClick")then bba(c_b,_bb)end end)c_b._autoCompleteFrame=d_b;c_b._autoCompleteList=bab;daa(c_b)return bab end aaa=function(c_b,d_b,_ab)local aab=c_b._autoCompleteFrame;local bab=c_b._autoCompleteList if not aab or aab._destroyed or not bab or bab._destroyed then return end;local cab=caa(c_b) @@ -961,9 +984,9 @@ _aa=function(c_b)local d_b=c_b._autoCompleteFrame if not d_b or d_b._destroyed then return end;local _ab=d_b.get and d_b.get("canvas") if not _ab then return end;_ab:setType("post") if d_b._autoCompleteBorderCommand then -_ab:removeCommand(d_b._autoCompleteBorderCommand)d_b._autoCompleteBorderCommand=nil end;if not c_b.get("autoCompleteShowBorder")then -d_b:updateRender()return end;local aab=c_b.get("autoCompleteBorderColor")or -colors.black +_ab:removeCommand(d_b._autoCompleteBorderCommand)d_b._autoCompleteBorderCommand=nil end;if not c_b.getResolved("autoCompleteShowBorder")then +d_b:updateRender()return end;local aab= +c_b.getResolved("autoCompleteBorderColor")or colors.black local bab=_ab:addCommand(function(cab)local dab= cab.get("width")or 0;local _bb=cab.get("height")or 0;if dab<1 or _bb<1 then return end @@ -973,11 +996,12 @@ cab:textFg(1,1,("\131"):rep(dab),aab)cab:multiBlit(1,_bb,dab,1,"\143",bbb,cbb) cab:multiBlit(1,1,1,_bb,"\149",cbb,bbb)cab:multiBlit(dab,1,1,_bb,"\149",bbb,cbb) cab:blit(1,1,"\151",cbb,bbb)cab:blit(dab,1,"\148",bbb,cbb) cab:blit(1,_bb,"\138",bbb,cbb)cab:blit(dab,_bb,"\133",bbb,cbb)end)d_b._autoCompleteBorderCommand=bab;d_b:updateRender()end -local function dba(c_b)local d_b=c_b.get("lines")local _ab=c_b.get("cursorY") -local aab=c_b.get("cursorX")local bab=d_b[_ab]or"" -local cab=bab:sub(1,math.max(aab-1,0)) -local dab=c_b.get("autoCompleteTokenPattern")or"[%w_]+"local _bb=""if dab~=""then -_bb=cab:match("("..dab..")$")or""end;local abb=aab-#_bb;if abb<1 then abb=1 end;return _bb,abb end +local function dba(c_b)local d_b=c_b.getResolved("lines") +local _ab=c_b.getResolved("cursorY")local aab=c_b.getResolved("cursorX")local bab=d_b[_ab]or""local cab=bab:sub(1,math.max( +aab-1,0))local dab= +c_b.getResolved("autoCompleteTokenPattern")or"[%w_]+"local _bb="" +if +dab~=""then _bb=cab:match("("..dab..")$")or""end;local abb=aab-#_bb;if abb<1 then abb=1 end;return _bb,abb end local function _ca(c_b) if type(c_b)=="string"then return{text=c_b,insert=c_b,source=c_b}elseif type(c_b)=="table"then local d_b= @@ -991,41 +1015,43 @@ if c_b.icon then _ab.icon=c_b.icon end;if c_b.info then _ab.info=c_b.info end;re local function aca(c_b,d_b)if type(c_b)~="table"then return end;local _ab=#c_b if _ab>0 then for index=1,_ab do d_b(c_b[index])end else for aab,bab in pairs(c_b)do d_b(bab)end end end -local function bca(c_b,d_b)local _ab=c_b.get("autoCompleteProvider")local aab={} +local function bca(c_b,d_b)local _ab=c_b.getResolved("autoCompleteProvider")local aab={} if _ab then local abb,bbb=pcall(_ab,c_b,d_b)if abb and type(bbb)=="table"then aab=bbb end else aab= -c_b.get("autoCompleteItems")or{}end;local bab={}local cab=c_b.get("autoCompleteCaseInsensitive")local dab=cab and -d_b:lower()or d_b +c_b.getResolved("autoCompleteItems")or{}end;local bab={} +local cab=c_b.getResolved("autoCompleteCaseInsensitive")local dab=cab and d_b:lower()or d_b aca(aab,function(abb)local bbb=_ca(abb) -if bbb and bbb.text then -local cbb= -cab and bbb.text:lower()or bbb.text;if dab==""or cbb:find(dab,1,true)==1 then -table.insert(bab,bbb)end end end)local _bb=c_b.get("autoCompleteMaxItems")if#bab>_bb then while#bab>_bb do -table.remove(bab)end end;return bab end +if bbb and +bbb.text then +local cbb=cab and bbb.text:lower()or bbb.text;if dab==""or cbb:find(dab,1,true)==1 then +table.insert(bab,bbb)end end end)local _bb=c_b.getResolved("autoCompleteMaxItems") +if#bab>_bb then while +#bab>_bb do table.remove(bab)end end;return bab end local function cca(c_b,d_b)local _ab=0 for _bb,abb in ipairs(d_b)do local bbb=abb;if type(abb)=="table"then bbb= abb.text or abb.label or abb.value or abb.insert or abb[1]end;if bbb~=nil then -local cbb=#tostring(bbb)if cbb>_ab then _ab=cbb end end end;local aab=c_b.get("autoCompleteMaxWidth") -local bab=c_b.get("width")if aab and aab>0 then bab=math.min(bab,aab)end +local cbb=#tostring(bbb)if cbb>_ab then _ab=cbb end end end;local aab=c_b.getResolved("autoCompleteMaxWidth") +local bab=c_b.getResolved("width")if aab and aab>0 then bab=math.min(bab,aab)end local cab=caa(c_b)local dab=c_b:getBaseFrame() if dab and dab.get then local _bb=dab.get("width")if _bb and _bb>0 then local abb=_bb-cab*2;if abb<1 then abb=1 end bab=math.min(bab,abb)end end;_ab=math.min(_ab,bab)return math.max(1,_ab)end local function dca(c_b,d_b,_ab)local aab=c_b._autoCompleteFrame;local bab=c_b._autoCompleteList;if not aab or aab._destroyed then return end;local cab=caa(c_b) -local dab=math.max(1,_ab or c_b.get("width"))local _bb=math.max(1,d_b or 1)local abb=c_b:getBaseFrame()if not abb then +local dab=math.max(1,_ab or c_b.getResolved("width"))local _bb=math.max(1,d_b or 1)local abb=c_b:getBaseFrame()if not abb then return end;local bbb=abb.get and abb.get("width")local cbb=abb.get and abb.get("height") if bbb and bbb>0 then local bac=bbb-cab*2;if bac<1 then bac=1 end;if dab>bac then dab=bac end end;if cbb and cbb>0 then local bac=cbb-cab*2;if bac<1 then bac=1 end if _bb>bac then _bb=bac end end;local dbb=dab+cab*2 local _cb=_bb+cab*2;local acb,bcb=c_b:calculatePosition() -local ccb=c_b.get("scrollX")or 0;local dcb=c_b.get("scrollY")or 0;local _db=(c_b._autoCompleteTokenStart or -c_b.get("cursorX"))local adb=_db-ccb -adb=math.max(1,math.min(c_b.get("width"),adb))local bdb=c_b.get("cursorY")-dcb -bdb=math.max(1,math.min(c_b.get("height"),bdb))local cdb=c_b.get("autoCompleteOffsetX") -local ddb=c_b.get("autoCompleteOffsetY")local __c=acb+adb-1 +cdb;local a_c=__c-cab +local ccb=c_b.getResolved("scrollX")or 0;local dcb=c_b.getResolved("scrollY")or 0 +local _db=( +c_b._autoCompleteTokenStart or c_b.getResolved("cursorX"))local adb=_db-ccb +adb=math.max(1,math.min(c_b.getResolved("width"),adb))local bdb=c_b.getResolved("cursorY")-dcb +bdb=math.max(1,math.min(c_b.getResolved("height"),bdb))local cdb=c_b.getResolved("autoCompleteOffsetX") +local ddb=c_b.getResolved("autoCompleteOffsetY")local __c=acb+adb-1 +cdb;local a_c=__c-cab if cab>0 then a_c=a_c+1 end;local b_c=bcb+bdb+ddb;local c_c=bcb+bdb-ddb-1;local d_c=b_c-cab;local _ac= c_c-_bb+1 -cab;local aac=d_c if bbb and bbb>0 then if dbb>bbb then dbb=bbb @@ -1036,21 +1062,22 @@ if aac+_cb-1 >cbb then aac=_ac;if cab>0 then aac=aac-cab end;if aac<1 then aac=math.max(1,cbb-_cb+1)end end;if aac<1 then aac=1 end else if aac<1 then aac=1 end;if aac==_ac and cab>0 then aac=math.max(1,aac-cab)end end;aab:setPosition(a_c,aac)aab:setWidth(dbb) aab:setHeight(_cb) -aab:setZ(c_b.get("z")+c_b.get("autoCompleteZOffset"))aaa(c_b,dab,_bb)if bab and not bab._destroyed then +aab:setZ(c_b.getResolved("z")+c_b.getResolved("autoCompleteZOffset"))aaa(c_b,dab,_bb)if bab and not bab._destroyed then 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: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_b0 then local dab=cca(self,cab)self._autoCompletePopupWidth=dab dca(self,math.max(#cab,1),dab)end end end)return self end;function d_a:addSyntaxPattern(c_b,d_b) -table.insert(self.get("syntaxPatterns"),{pattern=c_b,color=d_b})return self end +table.insert(self.getResolved("syntaxPatterns"),{pattern=c_b,color=d_b})return self end function d_a:removeSyntaxPattern(c_b)local d_b= -self.get("syntaxPatterns")or{} +self.getResolved("syntaxPatterns")or{} if type(c_b)~="number"then return self end if c_b>=1 and c_b<=#d_b then table.remove(d_b,c_b) self.set("syntaxPatterns",d_b)self:updateRender()end;return self end;function d_a:clearSyntaxPatterns()self.set("syntaxPatterns",{}) self:updateRender()return self end local function cda(c_b,d_b) -local _ab=c_b.get("lines")local aab=c_b.get("cursorX")local bab=c_b.get("cursorY") -local cab=_ab[bab] +local _ab=c_b.getResolved("lines")local aab=c_b.getResolved("cursorX") +local bab=c_b.getResolved("cursorY")local cab=_ab[bab] _ab[bab]=cab:sub(1,aab-1)..d_b..cab:sub(aab)c_b.set("cursorX",aab+1)c_b:updateViewport() c_b:updateRender()end local function dda(c_b,d_b)for i=1,#d_b do cda(c_b,d_b:sub(i,i))end end -local function __b(c_b)local d_b=c_b.get("lines")local _ab=c_b.get("cursorX") -local aab=c_b.get("cursorY")local bab=d_b[aab]local cab=bab:sub(_ab) -d_b[aab]=bab:sub(1,_ab-1)table.insert(d_b,aab+1,cab)c_b.set("cursorX",1)c_b.set("cursorY", -aab+1)c_b:updateViewport() -c_b:updateRender()end -local function a_b(c_b)local d_b=c_b.get("lines")local _ab=c_b.get("cursorX") -local aab=c_b.get("cursorY")local bab=d_b[aab] -if _ab>1 then -d_b[aab]=bab:sub(1,_ab-2)..bab:sub(_ab)c_b.set("cursorX",_ab-1)elseif aab>1 then local cab=d_b[aab-1]c_b.set("cursorX", -#cab+1)c_b.set("cursorY",aab-1)d_b[aab-1]= -cab..bab;table.remove(d_b,aab)end;c_b:updateViewport()c_b:updateRender()end -function d_a:updateViewport()local c_b=self.get("cursorX") -local d_b=self.get("cursorY")local _ab=self.get("scrollX")local aab=self.get("scrollY") -local bab=self.get("width")local cab=self.get("height") -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 +local function __b(c_b)local d_b=c_b.getResolved("lines") +local _ab=c_b.getResolved("cursorX")local aab=c_b.getResolved("cursorY")local bab=d_b[aab] +local cab=bab:sub(_ab)d_b[aab]=bab:sub(1,_ab-1) +table.insert(d_b,aab+1,cab)c_b.set("cursorX",1)c_b.set("cursorY",aab+1) +c_b:updateViewport()c_b:updateRender()end +local function a_b(c_b)local d_b=c_b.getResolved("lines") +local _ab=c_b.getResolved("cursorX")local aab=c_b.getResolved("cursorY")local bab=d_b[aab] +if _ab>1 then d_b[aab]=bab:sub(1, +_ab-2)..bab:sub(_ab) +c_b.set("cursorX",_ab-1)elseif aab>1 then local cab=d_b[aab-1]c_b.set("cursorX",#cab+1)c_b.set("cursorY", +aab-1)d_b[aab-1]=cab..bab +table.remove(d_b,aab)end;c_b:updateViewport()c_b:updateRender()end +function d_a:updateViewport()local c_b=self.getResolved("cursorX") +local d_b=self.getResolved("cursorY")local _ab=self.getResolved("scrollX") +local aab=self.getResolved("scrollY")local bab=self.getResolved("width") +local cab=self.getResolved("height") +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:hasState("focused")then return false end;local d_b=self.get("autoPairEnabled") +if not self.getResolved("editable")or not +self:hasState("focused")then return false end;local d_b=self.getResolved("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 +self.getResolved("autoPairCharacters")or{} +local aab=self.getResolved("lines")local bab=self.getResolved("cursorX") +local cab=self.getResolved("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.getResolved("autoPairSkipClosing")then +if _bb~=abb then cda(self,abb)self.set("cursorX", +self.getResolved("cursorX")-1)end else cda(self,abb) +self.set("cursorX",self.getResolved("cursorX")-1)end;_da(self)return true end +if self.getResolved("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: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 not self.getResolved("editable")or +not self:hasState("focused")then return false end;if ada(self,c_b)then return true end +local d_b=self.getResolved("lines")local _ab=self.getResolved("cursorX") +local aab=self.getResolved("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.getResolved("autoPairEnabled")and +self.getResolved("autoPairNewlineIndent")then +local bab=self.getResolved("lines")local cab=self.getResolved("cursorX") +local dab=self.getResolved("cursorY")local _bb=bab[dab]or""local abb=_bb:sub(1,cab-1) +local bbb=_bb:sub(cab) +local cbb=self.getResolved("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 @@ -1182,14 +1215,14 @@ self.set("cursorX",math.min(_ab,#d_b[aab+1]+1))end;self:updateRender()self:updat true end function d_a:mouse_scroll(c_b,d_b,_ab)if bda(self,c_b)then return true end if self:isInBounds(d_b,_ab)then -local aab=self.get("scrollY")local bab=self.get("height")local cab=self.get("lines")local dab=math.max(0,#cab- -bab+2) +local aab=self.getResolved("scrollY")local bab=self.getResolved("height") +local cab=self.getResolved("lines")local dab=math.max(0,#cab-bab+2) local _bb=math.max(0,math.min(dab,aab+c_b))self.set("scrollY",_bb)self:updateRender()return true end;return false end function d_a:mouse_click(c_b,d_b,_ab) if b_a.mouse_click(self,c_b,d_b,_ab)then -local aab,bab=self:getRelativePosition(d_b,_ab)local cab=self.get("scrollX")local dab=self.get("scrollY")local _bb= -(bab or 0)+ (dab or 0) -local abb=self.get("lines")or{}if _bb<1 then _bb=1 end +local aab,bab=self:getRelativePosition(d_b,_ab)local cab=self.getResolved("scrollX") +local dab=self.getResolved("scrollY")local _bb=(bab or 0)+ (dab or 0) +local abb=self.getResolved("lines")or{}if _bb<1 then _bb=1 end if _bb<=#abb and abb[_bb]~=nil then self.set("cursorY",_bb)local bbb=#tostring(abb[_bb]) self.set("cursorX",math.min((aab or 1)+ (cab or 0), @@ -1198,38 +1231,39 @@ 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:hasState("focused")then return false end;for d_b in c_b:gmatch(".")do +if not self.getResolved("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 -function d_a:getText()return table.concat(self.get("lines"),"\n")end -local function b_b(c_b,d_b)local _ab=d_b -local aab=string.rep(c_a[c_b.get("foreground")],#_ab)local bab=c_b.get("syntaxPatterns") +table.insert(d_b,_ab)end end;self.set("lines",d_b)aba(self,true)return self end;function d_a:getText() +return table.concat(self.getResolved("lines"),"\n")end +local function b_b(c_b,d_b)local _ab=d_b;local aab=string.rep(c_a[c_b.getResolved("foreground")], +#_ab) +local bab=c_b.getResolved("syntaxPatterns") for cab,dab in ipairs(bab)do local _bb=1 -while true do -local abb,bbb=_ab:find(dab.pattern,_bb)if not abb then break end;local cbb=bbb-abb+1 +while true do local abb,bbb=_ab:find(dab.pattern,_bb) +if not abb then break end;local cbb=bbb-abb+1 if cbb<=0 then aab=aab:sub(1,abb-1).. string.rep(c_a[dab.color],1)..aab:sub(abb+1)_bb=abb+1 else aab=aab:sub(1,abb-1)..string.rep(c_a[dab.color],cbb)..aab:sub( bbb+1)_bb=bbb+1 end end end;return _ab,aab end -function d_a:render()b_a.render(self)local c_b=self.get("lines") -local d_b=self.get("scrollX")local _ab=self.get("scrollY")local aab=self.get("width") -local bab=self.get("height")local cab=c_a[self.get("foreground")] -local dab=c_a[self.get("background")] -for y=1,bab do local _bb=y+_ab;local abb=c_b[_bb]or""local bbb,cbb=b_b(self,abb)local dbb=bbb:sub(d_b+1,d_b+ -aab)local _cb=cbb:sub(d_b+1,d_b+aab)local acb= -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: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 -self.get("foreground"))end end end +function d_a:render()b_a.render(self)local c_b=self.getResolved("lines") +local d_b=self.getResolved("scrollX")local _ab=self.getResolved("scrollY") +local aab=self.getResolved("width")local bab=self.getResolved("height") +local cab=self.getResolved("foreground")local dab=self.getResolved("background")local _bb=c_a[cab] +local abb=c_a[dab] +for y=1,bab do local bbb=y+_ab;local cbb=c_b[bbb]or""local dbb,_cb=b_b(self,cbb)local acb=dbb:sub(d_b+1,d_b+ +aab)local bcb=_cb:sub(d_b+1,d_b+aab)local ccb= +aab-#acb;if ccb>0 then acb=acb..string.rep(" ",ccb)bcb=bcb.. +string.rep(c_a[cab],ccb)end;self:blit(1,y,acb,bcb,string.rep(abb, +#acb))end +if self:hasState("focused")then +local bbb=self.getResolved("cursorX")-d_b;local cbb=self.getResolved("cursorY")-_ab;if bbb>=1 and +bbb<=aab and cbb>=1 and cbb<=bab then +self:setCursor(bbb,cbb,true, +self.getResolved("cursorColor")or cab)end end end function d_a:destroy() if self._autoCompleteFrame and not self._autoCompleteFrame._destroyed then self._autoCompleteFrame:destroy()end;self._autoCompleteFrame=nil;self._autoCompleteList=nil @@ -1244,32 +1278,33 @@ 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.getResolved("text") -da=da:sub(1,self.get("width")) -local _b,ab=ba(da,self.get("width"),self.get("height")) +da=da:sub(1,self.getResolved("width")) +local _b,ab=ba(da,self.getResolved("width"),self.getResolved("height")) 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 ca.defineProperty(ca,"text",{default="Label",type="string",canTriggerRender=true,setter=function(da,_b) if(type(_b)=="function")then _b=_b()end -if(da.get("autoSize"))then da.set("width",#_b)else da.set("height",# -ba(_b,da.get("width")))end;return _b end}) +if(da.getResolved("autoSize"))then da.set("width",#_b)else da.set("height",# +ba(_b,da.getResolved("width")))end;return _b end}) ca.defineProperty(ca,"autoSize",{default=true,type="boolean",canTriggerRender=true,setter=function(da,_b)if(_b)then -da.set("width",#da.get("text"))else -da.set("height",#ba(da.get("text"),da.get("width")))end;return _b end}) +da.set("width",#da.getResolved("text"))else +da.set("height",# +ba(da.getResolved("text"),da.getResolved("width")))end;return _b end}) function ca.new()local da=setmetatable({},ca):__init() da.class=ca;da.set("z",3)da.set("foreground",colors.black) da.set("backgroundEnabled",false)return da end function ca:init(da,_b)aa.init(self,da,_b)if(self.parent)then self.set("background",self.parent.get("background")) self.set("foreground",self.parent.get("foreground"))end -self.set("type","Label")return self end;function ca:getWrappedText()local da=self.get("text") -local _b=ba(da,self.get("width"))return _b end +self.set("type","Label")return self end;function ca:getWrappedText()local da=self.getResolved("text") +local _b=ba(da,self.getResolved("width"))return _b end function ca:render() -aa.render(self)local da=self.get("text") -if(self.get("autoSize"))then -self:textFg(1,1,da,self.get("foreground"))else local _b=ba(da,self.get("width"))for ab,bb in ipairs(_b)do -self:textFg(1,ab,bb,self.get("foreground"))end end end;return ca end +aa.render(self)local da=self.getResolved("text") +if(self.getResolved("autoSize"))then +self:textFg(1,1,da,self.getResolved("foreground"))else local _b=ba(da,self.getResolved("width"))for ab,bb in ipairs(_b)do +self:textFg(1,ab,bb,self.getResolved("foreground"))end end end;return ca end project["elements/SideNav.lua"] = function(...) local aa=require("elementManager") local ba=require("elements/VisualElement")local ca=aa.getElement("Container") local da=require("libraries/colorHex")local _b=setmetatable({},ca)_b.__index=_b @@ -1287,11 +1322,11 @@ local ab=setmetatable({},_b):__init()ab.class=_b;ab.set("width",30)ab.set("heigh ab.set("z",10)return ab end function _b:init(ab,bb) ca.init(self,ab,bb)self.set("type","SideNav")end -function _b:newTab(ab)local bb=self.get("tabs")or{}local cb=#bb+1 -table.insert(bb,{id=cb,title=tostring( -ab or("Item "..cb))})self.set("tabs",bb)if not self.get("activeTab")then -self.set("activeTab",cb)end;self:updateTabVisibility() -local db=self;local _c={} +function _b:newTab(ab)local bb=self.getResolved("tabs")or{} +local cb=#bb+1 +table.insert(bb,{id=cb,title=tostring(ab or("Item "..cb))})self.set("tabs",bb)if +not self.getResolved("activeTab")then self.set("activeTab",cb)end +self:updateTabVisibility()local db=self;local _c={} setmetatable(_c,{__index=function(ac,bc) if type(bc)=="string"and bc:sub(1,3)=="add"and type(db[bc])=="function"then @@ -1303,23 +1338,24 @@ db.set("childrenEventsSorted",false)db:updateRender()end;return _d end end;local return function(dc,...)return cc(db,...)end end;return cc end})return _c end;_b.addTab=_b.newTab;function _b:setTab(ab,bb)ab._tabId=bb self:updateTabVisibility()return self end function _b:addElement(ab,bb) -local cb=ca.addElement(self,ab)local db=bb or self.get("activeTab")if db then cb._tabId=db -self:updateTabVisibility()end;return cb end +local cb=ca.addElement(self,ab)local db=bb or self.getResolved("activeTab")if db then +cb._tabId=db;self:updateTabVisibility()end;return cb end function _b:addChild(ab)ca.addChild(self,ab)if not ab._tabId then -local bb=self.get("tabs")or{} +local bb=self.getResolved("tabs")or{} if#bb>0 then ab._tabId=1;self:updateTabVisibility()end end;return self end;function _b:updateTabVisibility()self.set("childrenSorted",false) self.set("childrenEventsSorted",false)end function _b:setActiveTab(ab) -local bb=self.get("activeTab")if bb==ab then return self end;self.set("activeTab",ab) +local bb=self.getResolved("activeTab")if bb==ab then return self end;self.set("activeTab",ab) self:updateTabVisibility()self:dispatchEvent("tabChanged",ab,bb)return self end function _b:isChildVisible(ab) -if not ca.isChildVisible(self,ab)then return false end -if ab._tabId then return ab._tabId==self.get("activeTab")end;return true end +if not ca.isChildVisible(self,ab)then return false end;if ab._tabId then +return ab._tabId==self.getResolved("activeTab")end;return true end function _b:getContentXOffset()local ab=self:_getSidebarMetrics()return ab.sidebarWidth end -function _b:_getSidebarMetrics()local ab=self.get("tabs")or{} -local bb=self.get("height")or 1;local cb=self.get("sidebarWidth")or 12;local db= -self.get("sidebarScrollOffset")or 0 -local _c=self.get("sidebarPosition")or"left"local ac={}local bc=1;local cc=#ab +function _b:_getSidebarMetrics()local ab=self.getResolved("tabs")or{}local bb= +self.getResolved("height")or 1 +local cb=self.getResolved("sidebarWidth")or 12 +local db=self.getResolved("sidebarScrollOffset")or 0 +local _c=self.getResolved("sidebarPosition")or"left"local ac={}local bc=1;local cc=#ab for dc,_d in ipairs(ab)do local ad=1;local bd=bc-db;local cd=0;local dd=0 if bd<1 then cd=1 -bd end;if bd+ad-1 >bb then dd=(bd+ad-1)-bb end if @@ -1328,7 +1364,7 @@ table.insert(ac,{id=_d.id,title=_d.title,y1=__a,y2=__a+a_a-1,height=ad,displayHe {sidebarWidth=cb,sidebarPosition=_c,positions=ac,totalHeight=cc,scrollOffset=db,maxScroll=math.max(0,cc-bb)}end function _b:mouse_click(ab,bb,cb) if not ba.mouse_click(self,ab,bb,cb)then return false end;local db,_c=ba.getRelativePosition(self,bb,cb) -local ac=self:_getSidebarMetrics()local bc=self.get("width")or 1;local cc=false;if +local ac=self:_getSidebarMetrics()local bc=self.getResolved("width")or 1;local cc=false;if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end if cc then if#ac.positions==0 then @@ -1336,11 +1372,12 @@ return true end;for dc,_d in ipairs(ac.positions)do if _c>=_d.y1 and _c<=_d.y2 then self:setActiveTab(_d.id)self.set("focusedChild",nil)return true end end return true end;return ca.mouse_click(self,ab,bb,cb)end -function _b:getRelativePosition(ab,bb)local cb=self:_getSidebarMetrics() -local db=self.get("width")or 1 -if ab==nil or bb==nil then return ba.getRelativePosition(self)else -local _c,ac=ba.getRelativePosition(self,ab,bb) -if cb.sidebarPosition=="right"then return _c,ac else return _c-cb.sidebarWidth,ac end end end +function _b:getRelativePosition(ab,bb)local cb=self:_getSidebarMetrics()local db= +self.getResolved("width")or 1 +if ab==nil or bb==nil then return +ba.getRelativePosition(self)else local _c,ac=ba.getRelativePosition(self,ab,bb) +if +cb.sidebarPosition=="right"then return _c,ac else return _c-cb.sidebarWidth,ac end end end function _b:multiBlit(ab,bb,cb,db,_c,ac,bc)local cc=self:_getSidebarMetrics() if cc.sidebarPosition=="right"then return ca.multiBlit(self,ab,bb,cb,db,_c,ac,bc)else @@ -1372,19 +1409,19 @@ ca.blit(self,ab,bb,cb,db,_c)else return ca.blit(self,(ab or 1)+ac.sidebarWidth,bb,cb,db,_c)end end function _b:mouse_up(ab,bb,cb) if not ba.mouse_up(self,ab,bb,cb)then return false end;local db,_c=ba.getRelativePosition(self,bb,cb) -local ac=self:_getSidebarMetrics()local bc=self.get("width")or 1;local cc=false;if +local ac=self:_getSidebarMetrics()local bc=self.getResolved("width")or 1;local cc=false;if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end;if cc then return true end;return ca.mouse_up(self,ab,bb,cb)end function _b:mouse_release(ab,bb,cb)ba.mouse_release(self,ab,bb,cb) local db,_c=ba.getRelativePosition(self,bb,cb)local ac=self:_getSidebarMetrics() -local bc=self.get("width")or 1;local cc=false +local bc=self.getResolved("width")or 1;local cc=false if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end;if cc then return end;return ca.mouse_release(self,ab,bb,cb)end function _b:mouse_move(ab,bb,cb) if ba.mouse_move(self,ab,bb,cb)then local db,_c=ba.getRelativePosition(self,bb,cb)local ac=self:_getSidebarMetrics() -local bc=self.get("width")or 1;local cc=false +local bc=self.getResolved("width")or 1;local cc=false if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end;if cc then return true end local dc={self:getRelativePosition(bb,cb)} @@ -1392,17 +1429,17 @@ local _d,ad=self:callChildrenEvent(true,"mouse_move",table.unpack(dc))if _d then function _b:mouse_drag(ab,bb,cb) if ba.mouse_drag(self,ab,bb,cb)then local db,_c=ba.getRelativePosition(self,bb,cb)local ac=self:_getSidebarMetrics() -local bc=self.get("width")or 1;local cc=false +local bc=self.getResolved("width")or 1;local cc=false if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end;if cc then return true end;return ca.mouse_drag(self,ab,bb,cb)end;return false end function _b:scrollSidebar(ab)local bb=self:_getSidebarMetrics()local cb= -self.get("sidebarScrollOffset")or 0;local db=bb.maxScroll or 0;local _c=cb+ -(ab*2)_c=math.max(0,math.min(db,_c)) +self.getResolved("sidebarScrollOffset")or 0 +local db=bb.maxScroll or 0;local _c=cb+ (ab*2)_c=math.max(0,math.min(db,_c)) self.set("sidebarScrollOffset",_c)return self end function _b:mouse_scroll(ab,bb,cb) if ba.mouse_scroll(self,ab,bb,cb)then local db,_c=ba.getRelativePosition(self,bb,cb)local ac=self:_getSidebarMetrics() -local bc=self.get("width")or 1;local cc=false +local bc=self.getResolved("width")or 1;local cc=false if ac.sidebarPosition=="right"then cc=db> (bc-ac.sidebarWidth)else cc=db<=ac.sidebarWidth end;if cc then self:scrollSidebar(ab)return true end;return ca.mouse_scroll(self,ab,bb,cb)end;return false end @@ -1414,25 +1451,25 @@ _c.sidebarWidth;dc=bb+bc-1 end if (cc<1)or(cc>self.parent.get("width"))or(dc<1)or(dc>self.parent.get("height"))then return self.parent:setCursor(cc,dc,false)end;return self.parent:setCursor(cc,dc,cb,db)end;return self end -function _b:render()ba.render(self)local ab=self.get("height") -local bb=self:_getSidebarMetrics()local cb=bb.sidebarWidth or 12;for y=1,ab do -ba.multiBlit(self,1,y,cb,1," ",da[self.get("foreground")],da[self.get("sidebarBackground")])end -local db=self.get("activeTab") -for _c,ac in ipairs(bb.positions)do -local bc= -(ac.id==db)and self.get("activeTabBackground")or self.get("sidebarBackground")local cc=(ac.id==db)and self.get("activeTabTextColor")or -self.get("foreground")local dc= -ac.displayHeight or(ac.y2 -ac.y1 +1)for dy=0,dc-1 do -ba.multiBlit(self,1, -ac.y1 +dy,cb,1," ",da[self.get("foreground")],da[bc])end;local _d=ac.title;if#_d>cb-2 then _d=_d:sub(1, -cb-2)end -ba.textFg(self,2,ac.y1,_d,cc)end -if not self.get("childrenSorted")then self:sortChildren()end -if not self.get("childrenEventsSorted")then for _c in pairs(self._values.childrenEvents or -{})do -self:sortChildrenEvents(_c)end end -for _c,ac in ipairs(self.get("visibleChildren")or{})do if ac==self then -error("CIRCULAR REFERENCE DETECTED!")return end;ac:render()ac:postRender()end end +function _b:render()ba.render(self)local ab=self.getResolved("height") +local bb=self.getResolved("foreground")local cb=self.getResolved("sidebarBackground") +local db=self:_getSidebarMetrics()local _c=db.sidebarWidth or 12;for y=1,ab do +ba.multiBlit(self,1,y,_c,1," ",da[bb],da[cb])end +local ac=self.getResolved("activeTab") +for bc,cc in ipairs(db.positions)do local dc= +(cc.id==ac)and self.getResolved("activeTabBackground")or cb +local _d= +(cc.id==ac)and self.getResolved("activeTabTextColor")or bb;local ad=cc.displayHeight or(cc.y2 -cc.y1 +1)for dy=0,ad-1 +do +ba.multiBlit(self,1,cc.y1 +dy,_c,1," ",da[bb],da[dc])end;local bd=cc.title;if#bd>_c-2 then +bd=bd:sub(1,_c-2)end;ba.textFg(self,2,cc.y1,bd,_d)end;if not self.getResolved("childrenSorted")then +self:sortChildren()end +if +not self.getResolved("childrenEventsSorted")then for bc in pairs(self._values.childrenEvents or{})do +self:sortChildrenEvents(bc)end end +for bc,cc in +ipairs(self.getResolved("visibleChildren")or{})do +if cc==self then error("CIRCULAR REFERENCE DETECTED!")return end;cc:render()cc:postRender()end end function _b:sortChildrenEvents(ab) local bb=self._values.childrenEvents and self._values.childrenEvents[ab] if bb then local cb={}for db,_c in ipairs(bb)do @@ -1459,66 +1496,70 @@ 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 +ba=math.min(self.getResolved("width"),math.max(1,ba))return d.setCursor(self,ba,ca,da,_b)end 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 +if not self:hasState("focused")then return false end;local ca=self.getResolved("text") +local da=self.getResolved("cursorPos")local _b=self.getResolved("maxLength") +local ab=self.getResolved("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.getResolved("cursorPos")-self.getResolved("viewOffset") +self:setCursor(bb,1,true,self.getResolved("cursorColor")or +self.getResolved("foreground"))d.char(self,ba)return true end 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 +if not self:hasState("focused")then return false end;local da=self.getResolved("cursorPos") +local _b=self.getResolved("text")local ab=self.getResolved("viewOffset") +local bb=self.getResolved("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") +local cb=self.getResolved("cursorPos")-self.getResolved("viewOffset") 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 +local _b,ab=self:getRelativePosition(ca,da)local bb=self.getResolved("text") +local cb=self.getResolved("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.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") -if ca-da>=ba then self.set("viewOffset",ca-ba+1)elseif ca<=da then self.set("viewOffset", -ca-1)end -self.set("viewOffset",math.max(0,math.min(self.get("viewOffset"),_b-ba+1)))return self end +function aa:updateViewport()local ba=self.getResolved("width") +local ca=self.getResolved("cursorPos")local da=self.getResolved("viewOffset")local _b=# +self.getResolved("text") +if ca-da>=ba then +self.set("viewOffset",ca-ba+1)elseif ca<=da then self.set("viewOffset",ca-1)end +self.set("viewOffset",math.max(0,math.min(self.getResolved("viewOffset"),_b-ba+1)))return self end function aa:focus()d.focus(self) -self:setCursor(self.get("cursorPos")- -self.get("viewOffset"),1,true,self.getResolved("cursorColor")or +self:setCursor(self.getResolved("cursorPos")- +self.getResolved("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.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 +if not self:hasState("focused")then return false end;local ca=self.getResolved("text") +local da=self.getResolved("cursorPos")local _b=self.getResolved("maxLength") +local ab=self.getResolved("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") +local ca=self.getResolved("viewOffset")local da=self.getResolved("placeholder") +local _b=self:hasState("focused") +local ab,bb=self.getResolved("width"),self.getResolved("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.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.getResolved("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/Toast.lua"] = function(...) local d=require("elementManager") local _a=d.getElement("VisualElement")local aa=setmetatable({},_a)aa.__index=aa @@ -1534,12 +1575,13 @@ ba.set("z",100)return ba end;function aa:init(ba,ca) _a.init(self,ba,ca)return self end function aa:show(ba,ca,da)local _b,ab,bb if type(ca)=="string"then _b=ba -ab=ca;bb=da or self.get("duration")elseif type(ca)=="number"then _b="" -ab=ba;bb=ca else _b=""ab=ba;bb=self.get("duration")end;self.set("title",_b)self.set("message",ab) +ab=ca;bb=da or self.getResolved("duration")elseif type(ca)== +"number"then _b=""ab=ba;bb=ca else _b=""ab=ba +bb=self.getResolved("duration")end;self.set("title",_b)self.set("message",ab) self.set("active",true)if self._hideTimerId then os.cancelTimer(self._hideTimerId) self._hideTimerId=nil end if -self.get("autoHide")and bb>0 then self._hideTimerId=os.startTimer(bb)end;return self end +self.getResolved("autoHide")and bb>0 then self._hideTimerId=os.startTimer(bb)end;return self end function aa:hide()self.set("active",false)self.set("title","") self.set("message","")if self._hideTimerId then os.cancelTimer(self._hideTimerId) self._hideTimerId=nil end;return self end;function aa:success(ba,ca,da)self.set("toastType","success") @@ -1552,14 +1594,15 @@ function aa:dispatchEvent(ba,...) _a.dispatchEvent(self,ba,...)if ba=="timer"then local ca=select(1,...) if ca==self._hideTimerId then self:hide()end end end function aa:render()_a.render(self) -if not self.get("active")then return end;local ba=self.get("width")local ca=self.get("height") -local da=self.getResolved("title")local _b=self.getResolved("message") -local ab=self.getResolved("toastType")local bb=self.getResolved("colorMap") -local cb=bb[ab]or bb.default;local db=self.getResolved("foreground")local _c=1;local ac=1 -if da~=""then local bc=da:sub(1, -ba-_c+1)self:textFg(_c,ac,bc,cb)ac=ac+1 end -if _b~=""and ac<=ca then local bc=ba-_c+1;local cc={}for _d in _b:gmatch("%S+")do -table.insert(cc,_d)end;local dc="" +if not self.getResolved("active")then return end;local ba=self.getResolved("width") +local ca=self.getResolved("height")local da=self.getResolved("title") +local _b=self.getResolved("message")local ab=self.getResolved("toastType") +local bb=self.getResolved("colorMap")local cb=bb[ab]or bb.default +local db=self.getResolved("foreground")local _c=1;local ac=1;if da~=""then local bc=da:sub(1,ba-_c+1) +self:textFg(_c,ac,bc,cb)ac=ac+1 end +if _b~=""and ac<=ca then +local bc=ba-_c+1;local cc={} +for _d in _b:gmatch("%S+")do table.insert(cc,_d)end;local dc="" for _d,ad in ipairs(cc)do if#dc+#ad+1 >bc then if ac<=ca then self:textFg(_c,ac,dc,db)ac=ac+1;dc=ad else break end else dc=dc==""and ad or dc.." "..ad end end @@ -1615,24 +1658,24 @@ cd and{["0"]=bd:sub(i,i),["1"]=ad:sub(i,i)}or caa)end;_aa[nLine]=table.concat(da aaa[nLine]=table.concat(_ba)end;return{c_a,_aa,aaa}end;local ac=require("elementManager") local bc=ac.getElement("VisualElement")local cc=setmetatable({},bc)cc.__index=cc cc.defineProperty(cc,"text",{default="BigFont",type="string",canTriggerRender=true,setter=function(dc,_d) -dc.bigfontText=_c(dc.get("fontSize"),_d,dc.get("foreground"),dc.get("background"))return _d end}) +dc.bigfontText=_c(dc.getResolved("fontSize"),_d,dc.getResolved("foreground"),dc.getResolved("background"))return _d end}) cc.defineProperty(cc,"fontSize",{default=1,type="number",canTriggerRender=true,setter=function(dc,_d) -dc.bigfontText=_c(_d,dc.get("text"),dc.get("foreground"),dc.get("background"))return _d end})function cc.new()local dc=setmetatable({},cc):__init() +dc.bigfontText=_c(_d,dc.getResolved("text"),dc.getResolved("foreground"),dc.getResolved("background"))return _d end})function cc.new()local dc=setmetatable({},cc):__init() dc.class=cc;dc.set("width",16)dc.set("height",3)dc.set("z",5) return dc end function cc:init(dc,_d) bc.init(self,dc,_d)self.set("type","BigFont") self:observe("background",function(ad,bd) -ad.bigfontText=_c(ad.get("fontSize"),ad.get("text"),ad.get("foreground"),bd)end) +ad.bigfontText=_c(ad.getResolved("fontSize"),ad.getResolved("text"),ad.getResolved("foreground"),bd)end) self:observe("foreground",function(ad,bd) -ad.bigfontText=_c(ad.get("fontSize"),ad.get("text"),bd,ad.get("background"))end)end +ad.bigfontText=_c(ad.getResolved("fontSize"),ad.getResolved("text"),bd,ad.getResolved("background"))end)end function cc:render()bc.render(self) if(self.bigfontText)then -local dc,_d=self.get("x"),self.get("y") +local dc,_d=self.getResolved("x"),self.getResolved("y")local ad=self.getResolved("width") for i=1,#self.bigfontText[1]do -local ad=self.bigfontText[1][i]:sub(1,self.get("width")) -local bd=self.bigfontText[2][i]:sub(1,self.get("width")) -local cd=self.bigfontText[3][i]:sub(1,self.get("width"))self:blit(dc,_d+i-1,ad,bd,cd)end end end;return cc end +local bd=self.bigfontText[1][i]:sub(1,ad) +local cd=self.bigfontText[2][i]:sub(1,ad) +local dd=self.bigfontText[3][i]:sub(1,ad)self:blit(dc,_d+i-1,bd,cd,dd)end end end;return cc end project["elements/Switch.lua"] = function(...) local _a=require("elementManager") local aa=_a.getElement("VisualElement")local ba=require("libraries/colorHex") local ca=setmetatable({},aa)ca.__index=ca @@ -1647,13 +1690,14 @@ da.class=ca;da.set("width",2)da.set("height",1)da.set("z",5) da.set("backgroundEnabled",true)return da end function ca:init(da,_b)aa.init(self,da,_b)self.set("type","Switch")end function ca:mouse_click(da,_b,ab)if aa.mouse_click(self,da,_b,ab)then -self.set("checked",not self.get("checked"))return true end;return false end -function ca:render()local da=self.get("checked")local _b=self.get("text") -local ab=self.get("width")local bb=self.get("height")local cb=da and self.get("onBackground")or -self.get("offBackground") -self:multiBlit(1,1,ab,bb," ",ba[self.get("foreground")],ba[cb])local db=math.floor(ab/2)local _c=da and(ab-db+1)or 1 -self:multiBlit(_c,1,db,bb," ",ba[self.get("foreground")],ba[self.get("background")])if _b~=""then -self:textFg(ab+2,1,_b,self.get("foreground"))end end;return ca end +self.set("checked",not self.getResolved("checked"))return true end;return false end +function ca:render()local da=self.getResolved("checked") +local _b=self.getResolved("text")local ab=self.getResolved("width") +local bb=self.getResolved("height")local cb=self.getResolved("foreground") +local db=da and +self.getResolved("onBackground")or self.getResolved("offBackground")self:multiBlit(1,1,ab,bb," ",ba[cb],ba[db]) +local _c=math.floor(ab/2)local ac=da and(ab-_c+1)or 1 +self:multiBlit(ac,1,_c,bb," ",ba[cb],ba[self.getResolved("background")])if _b~=""then self:textFg(ab+2,1,_b,cb)end end;return ca end project["elements/Frame.lua"] = function(...) local aa=require("elementManager") local ba=aa.getElement("VisualElement")local ca=aa.getElement("Container")local da=setmetatable({},ca) da.__index=da @@ -1669,39 +1713,39 @@ return self end function da:mouse_click(ab,bb,cb) if self:isInBounds(bb,cb)then if -self.get("draggable")then local db,_c=self:getRelativePosition(bb,cb) -local ac=self.get("draggingMap") -for bc,cc in ipairs(ac)do local dc=cc.width or 1;local _d=cc.height or 1;if -type(dc)=="string"and dc=="width"then dc=self.get("width")elseif -type(dc)=="function"then dc=dc(self)end -if type(_d)== -"string"and _d=="height"then _d=self.get("height")elseif -type(_d)=="function"then _d=_d(self)end;local ad=cc.y or 1 +self.getResolved("draggable")then local db,_c=self:getRelativePosition(bb,cb) +local ac=self.getResolved("draggingMap") +for bc,cc in ipairs(ac)do local dc=cc.width or 1;local _d=cc.height or 1 +if +type(dc)=="string"and dc=="width"then dc=self.getResolved("width")elseif type(dc)== +"function"then dc=dc(self)end +if type(_d)=="string"and _d=="height"then +_d=self.getResolved("height")elseif type(_d)=="function"then _d=_d(self)end;local ad=cc.y or 1 if db>=cc.x and db<=cc.x+dc-1 and _c>=ad and _c<=ad+_d-1 then -self.dragStartX=bb-self.get("x")self.dragStartY=cb-self.get("y")self.dragging=true -return true end end end;return ca.mouse_click(self,ab,bb,cb)end;return false end +self.dragStartX=bb-self.getResolved("x")self.dragStartY=cb-self.getResolved("y") +self.dragging=true;return true end end end;return ca.mouse_click(self,ab,bb,cb)end;return false end function da:mouse_up(ab,bb,cb)if self.dragging then self.dragging=false;self.dragStartX=nil self.dragStartY=nil;return true end;return ca.mouse_up(self,ab,bb,cb)end function da:mouse_drag(ab,bb,cb) if self.dragging then local db=bb-self.dragStartX local _c=cb-self.dragStartY;self.set("x",db)self.set("y",_c)return true end;return ca.mouse_drag(self,ab,bb,cb)end -function da:getChildrenHeight()local ab=0;local bb=self.get("children") +function da:getChildrenHeight()local ab=0;local bb=self.getResolved("children") for cb,db in ipairs(bb)do if db.get("visible")then local _c=db.get("y")local ac=db.get("height")local bc=_c+ac-1 if bc>ab then ab=bc end end end;return ab end local function _b(ab,bb,...)local cb={...} if bb and bb:find("mouse_")then local db,_c,ac=... -local bc,cc=ab.get("offsetX"),ab.get("offsetY")local dc,_d=ab:getRelativePosition(_c+bc,ac+cc) +local bc,cc=ab.getResolved("offsetX"),ab.getResolved("offsetY")local dc,_d=ab:getRelativePosition(_c+bc,ac+cc) cb={db,dc,_d}end;return cb end function da:mouse_scroll(ab,bb,cb) if(ba.mouse_scroll(self,ab,bb,cb))then local db=_b(self,"mouse_scroll",ab,bb,cb) local _c,ac=self:callChildrenEvent(true,"mouse_scroll",table.unpack(db))if _c then return true end -if self.get("scrollable")then -local bc=self.get("height")local cc=self:getChildrenHeight() -local dc=self.get("offsetY")local _d=math.max(0,cc-bc)local ad=dc+ab +if self.getResolved("scrollable")then +local bc=self.getResolved("height")local cc=self:getChildrenHeight() +local dc=self.getResolved("offsetY")local _d=math.max(0,cc-bc)local ad=dc+ab ad=math.max(0,math.min(_d,ad))self.set("offsetY",ad)return true end end;return false end;return da end project["elements/Container.lua"] = function(...) local _b=require("elementManager") local ab=require("errorManager")local bb=_b.getElement("VisualElement") @@ -1743,11 +1787,11 @@ self.set("childrenEventsSorted",false)self:updateRender()end)end function ac:isChildVisible(dc) if not dc:isType("VisualElement")then return false end;if(dc.get("visible")==false)then return false end;if(dc._destroyed)then return false end -local _d,ad=self.get("width"),self.get("height")local bd,cd=self.get("offsetX"),self.get("offsetY") -local dd,__a=dc.get("x"),dc.get("y")local a_a,b_a=dc.get("width"),dc.get("height")local c_a;local d_a;if -(dc.get("ignoreOffset"))then c_a=dd;d_a=__a else c_a=dd-bd;d_a=__a-cd end;return -(c_a+ -a_a>0)and(c_a<=_d)and(d_a+b_a>0)and(d_a<=ad)end +local _d,ad=self.getResolved("width"),self.getResolved("height") +local bd,cd=self.getResolved("offsetX"),self.getResolved("offsetY")local dd,__a=dc.get("x"),dc.get("y") +local a_a,b_a=dc.get("width"),dc.get("height")local c_a;local d_a +if(dc.get("ignoreOffset"))then c_a=dd;d_a=__a else c_a=dd-bd;d_a=__a-cd end;return +(c_a+a_a>0)and(c_a<=_d)and(d_a+b_a>0)and(d_a<=ad)end function ac:addChild(dc) if dc==self then error("Cannot add container to itself")end;if(dc~=nil)then table.insert(self._values.children,dc) dc.parent=self;dc:postInit()self.set("childrenSorted",false) @@ -1809,15 +1853,15 @@ if#_d==1 then return bd else if(bd:isType("Container"))then return bd:find(table.concat(_d,"/",2))end end end end end;return nil end local function cc(dc,_d,...)local ad={...} if _d and _d:find("mouse_")then local bd,cd,dd=... -local __a,a_a=dc.get("offsetX"),dc.get("offsetY")local b_a,c_a=dc:getRelativePosition(cd+__a,dd+a_a) +local __a,a_a=dc.getResolved("offsetX"),dc.getResolved("offsetY")local b_a,c_a=dc:getRelativePosition(cd+__a,dd+a_a) ad={bd,b_a,c_a}end;return ad end function ac:callChildrenEvent(dc,_d,...) if -dc and not self.get("childrenEventsSorted")then for bd in pairs(self._values.childrenEvents)do -self:sortChildrenEvents(bd)end end;local ad=dc and self.get("visibleChildrenEvents")or -self.get("childrenEvents") -if -ad[_d]then local bd=ad[_d]for i=#bd,1,-1 do local cd=bd[i] +dc and not self.getResolved("childrenEventsSorted")then for bd in pairs(self._values.childrenEvents)do +self:sortChildrenEvents(bd)end end +local ad=dc and self.getResolved("visibleChildrenEvents")or +self.getResolved("childrenEvents") +if ad[_d]then local bd=ad[_d]for i=#bd,1,-1 do local cd=bd[i] if(cd:dispatchEvent(_d,...))then return true,cd end end end if(ad["*"])then local bd=ad["*"]for i=#bd,1,-1 do local cd=bd[i] if(cd:dispatchEvent(_d,...))then return true,cd end end end;return false end @@ -1846,63 +1890,66 @@ local cd,dd=self:callChildrenEvent(true,"mouse_drag",table.unpack(bd))if(cd)then function ac:mouse_scroll(dc,_d,ad) if(bb.mouse_scroll(self,dc,_d,ad))then local bd=cc(self,"mouse_scroll",dc,_d,ad) -local cd,dd=self:callChildrenEvent(true,"mouse_scroll",table.unpack(bd))return true end;return false end;function ac:key(dc)if self.get("focusedChild")then return -self.get("focusedChild"):dispatchEvent("key",dc)end -return true end -function ac:char(dc)if -self.get("focusedChild")then -return self.get("focusedChild"):dispatchEvent("char",dc)end;return true end;function ac:key_up(dc) -if self.get("focusedChild")then return -self.get("focusedChild"):dispatchEvent("key_up",dc)end;return true end +local cd,dd=self:callChildrenEvent(true,"mouse_scroll",table.unpack(bd))return true end;return false end +function ac:key(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("key",dc)end;return true end +function ac:char(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("char",dc)end;return true end +function ac:key_up(dc) +if self.getResolved("focusedChild")then return +self.getResolved("focusedChild"):dispatchEvent("key_up",dc)end;return true end function ac:multiBlit(dc,_d,ad,bd,cd,dd,__a) -local a_a,b_a=self.get("width"),self.get("height")ad=dc<1 and math.min(ad+dc-1,a_a)or +local a_a,b_a=self.getResolved("width"),self.getResolved("height")ad=dc<1 and math.min(ad+dc-1,a_a)or math.min(ad,math.max(0,a_a-dc+1))bd=_d<1 and math.min( bd+_d-1,b_a)or math.min(bd,math.max(0,b_a-_d+1))if ad<=0 or bd<=0 then return self end bb.multiBlit(self,math.max(1,dc),math.max(1,_d),ad,bd,cd,dd,__a)return self end -function ac:textFg(dc,_d,ad,bd)local cd,dd=self.get("width"),self.get("height")if -_d<1 or _d>dd then return self end;local __a=dc<1 and(2 -dc)or 1 -local a_a=math.min(#ad- -__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end +function ac:textFg(dc,_d,ad,bd) +local cd,dd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>dd then return self end +local __a=dc<1 and(2 -dc)or 1 +local a_a=math.min(#ad-__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end bb.textFg(self,math.max(1,dc),math.max(1,_d),ad:sub(__a, __a+a_a-1),bd)return self end -function ac:textBg(dc,_d,ad,bd)local cd,dd=self.get("width"),self.get("height")if -_d<1 or _d>dd then return self end;local __a=dc<1 and(2 -dc)or 1 -local a_a=math.min(#ad- -__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end +function ac:textBg(dc,_d,ad,bd) +local cd,dd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>dd then return self end +local __a=dc<1 and(2 -dc)or 1 +local a_a=math.min(#ad-__a+1,cd-math.max(1,dc)+1)if a_a<=0 then return self end bb.textBg(self,math.max(1,dc),math.max(1,_d),ad:sub(__a, __a+a_a-1),bd)return self end -function ac:drawText(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if _d<1 or -_d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min( -#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawText(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawText(self,math.max(1,dc),math.max(1,_d),ad:sub(dd, dd+__a-1))return self end -function ac:drawFg(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if -_d<1 or _d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min(#ad- -dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawFg(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawFg(self,math.max(1,dc),math.max(1,_d),ad:sub(dd,dd+__a-1))return self end -function ac:drawBg(dc,_d,ad)local bd,cd=self.get("width"),self.get("height")if -_d<1 or _d>cd then return self end;local dd=dc<1 and(2 -dc)or 1 -local __a=math.min(#ad- -dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end +function ac:drawBg(dc,_d,ad) +local bd,cd=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>cd then return self end +local dd=dc<1 and(2 -dc)or 1 +local __a=math.min(#ad-dd+1,bd-math.max(1,dc)+1)if __a<=0 then return self end bb.drawBg(self,math.max(1,dc),math.max(1,_d),ad:sub(dd,dd+__a-1))return self end -function ac:blit(dc,_d,ad,bd,cd)local dd,__a=self.get("width"),self.get("height")if -_d<1 or _d>__a then return self end;local a_a=dc<1 and(2 -dc)or 1 -local b_a=math.min( -#ad-a_a+1,dd-math.max(1,dc)+1) +function ac:blit(dc,_d,ad,bd,cd) +local dd,__a=self.getResolved("width"),self.getResolved("height")if _d<1 or _d>__a then return self end +local a_a=dc<1 and(2 -dc)or 1 +local b_a=math.min(#ad-a_a+1,dd-math.max(1,dc)+1) local c_a=math.min(#bd-a_a+1,dd-math.max(1,dc)+1) local d_a=math.min(#cd-a_a+1,dd-math.max(1,dc)+1)if b_a<=0 then return self end;local _aa=ad:sub(a_a,a_a+b_a-1)local aaa=bd:sub(a_a, a_a+c_a-1) local baa=cd:sub(a_a,a_a+d_a-1) bb.blit(self,math.max(1,dc),math.max(1,_d),_aa,aaa,baa)return self end -function ac:render()bb.render(self)if not self.get("childrenSorted")then -self:sortChildren()end -if -not self.get("childrenEventsSorted")then for dc in pairs(self._values.childrenEvents)do -self:sortChildrenEvents(dc)end end;for dc,_d in ipairs(self.get("visibleChildren"))do if _d==self then +function ac:render()bb.render(self)if +not self.getResolved("childrenSorted")then self:sortChildren()end +if not +self.getResolved("childrenEventsSorted")then for dc in pairs(self._values.childrenEvents)do +self:sortChildrenEvents(dc)end end +for dc,_d in ipairs(self.getResolved("visibleChildren"))do if _d==self then ab.error("CIRCULAR REFERENCE DETECTED!")return end;_d:render() _d:postRender()end end function ac:applyLayout(dc,_d) @@ -1933,52 +1980,53 @@ ba.set("foreground",colors.white)ba.set("borderColor",colors.cyan)return ba end function aa:init(ba,ca)_a.init(self,ba,ca) self:addBorder({left=true,right=true,top=true,bottom=true})self.set("type","Dialog")return self end function aa:show()self:center()self.set("visible",true)if -self.get("modal")then self:setFocused(true)end;return self end;function aa:close()self.set("visible",false) +self.getResolved("modal")then self:setFocused(true)end;return self end;function aa:close()self.set("visible",false) self:fireEvent("close")return self end function aa:alert(ba,ca,da)self:clear() self.set("title",ba)self.set("height",8) -self:addLabel({text=ca,x=2,y=3,width=self.get("width")-3,height=3,foreground=colors.white})local _b=10 -local ab=math.floor((self.get("width")-_b)/2)+1 -self:addButton({text="OK",x=ab,y=self.get("height")-2,width=_b,height=1,background=self.get("primaryColor"),foreground=self.get("buttonForeground")}):onClick(function()if +self:addLabel({text=ca,x=2,y=3,width=self.getResolved("width")-3,height=3,foreground=colors.white})local _b=10;local ab= +math.floor((self.getResolved("width")-_b)/2)+1 +self:addButton({text="OK",x=ab,y= +self.getResolved("height")-2,width=_b,height=1,background=self.getResolved("primaryColor"),foreground=self.getResolved("buttonForeground")}):onClick(function()if da then da()end;self:close()end)return self:show()end function aa:confirm(ba,ca,da)self:clear()self.set("title",ba) self.set("height",8) -self:addLabel({text=ca,x=2,y=3,width=self.get("width")-3,height=3,foreground=colors.white})local _b=10;local ab=2;local bb=_b*2 +ab;local cb= -math.floor((self.get("width")-bb)/2)+1 -self:addButton({text="Cancel",x=cb,y= -self.get("height")-2,width=_b,height=1,background=self.get("secondaryColor"),foreground=self.get("buttonForeground")}):onClick(function()if +self:addLabel({text=ca,x=2,y=3,width=self.getResolved("width")-3,height=3,foreground=colors.white})local _b=10;local ab=2;local bb=_b*2 +ab +local cb=math.floor( +(self.getResolved("width")-bb)/2)+1 +self:addButton({text="Cancel",x=cb,y=self.getResolved("height")-2,width=_b,height=1,background=self.getResolved("secondaryColor"),foreground=self.getResolved("buttonForeground")}):onClick(function()if da then da(false)end;self:close()end) -self:addButton({text="OK",x=cb+_b+ab,y=self.get("height")-2,width=_b,height=1,background=self.get("primaryColor"),foreground=self.get("buttonForeground")}):onClick(function()if +self:addButton({text="OK",x=cb+_b+ab,y=self.getResolved("height")-2,width=_b,height=1,background=self.getResolved("primaryColor"),foreground=self.getResolved("buttonForeground")}):onClick(function()if da then da(true)end;self:close()end)return self:show()end function aa:prompt(ba,ca,da,_b)self:clear()self.set("title",ba) self.set("height",11) self:addLabel({text=ca,x=2,y=3,foreground=colors.white}) -local ab=self:addInput({x=2,y=5,width=self.get("width")-3,height=1,defaultText=da or"",background=colors.white,foreground=colors.black})local bb=10;local cb=2;local db=bb*2 +cb;local _c= -math.floor((self.get("width")-db)/2)+1 -self:addButton({text="Cancel",x=_c,y= -self.get("height")-2,width=bb,height=1,background=self.get("secondaryColor"),foreground=self.get("buttonForeground")}):onClick(function()if +local ab=self:addInput({x=2,y=5,width=self.getResolved("width")-3,height=1,defaultText=da or"",background=colors.white,foreground=colors.black})local bb=10;local cb=2;local db=bb*2 +cb +local _c=math.floor( +(self.getResolved("width")-db)/2)+1 +self:addButton({text="Cancel",x=_c,y=self.getResolved("height")-2,width=bb,height=1,background=self.getResolved("secondaryColor"),foreground=self.getResolved("buttonForeground")}):onClick(function()if _b then _b(nil)end;self:close()end) -self:addButton({text="OK",x=_c+bb+cb,y=self.get("height")-2,width=bb,height=1,background=self.get("primaryColor"),foreground=self.get("buttonForeground")}):onClick(function()if +self:addButton({text="OK",x=_c+bb+cb,y=self.getResolved("height")-2,width=bb,height=1,background=self.getResolved("primaryColor"),foreground=self.getResolved("buttonForeground")}):onClick(function()if _b then _b(ab.get("text")or"")end self:close()end)return self:show()end -function aa:render()_a.render(self)local ba=self.get("title")if ba~=""then -local ca=self.get("width")local da=ba:sub(1,ca-4) +function aa:render()_a.render(self)local ba=self.getResolved("title")if +ba~=""then local ca=self.getResolved("width")local da=ba:sub(1,ca-4) self:textFg(2,2,da,colors.white)end end function aa:mouse_click(ba,ca,da) -if self.get("modal")then if self:isInBounds(ca,da)then return +if self.getResolved("modal")then if self:isInBounds(ca,da)then return _a.mouse_click(self,ba,ca,da)end;return true end;return _a.mouse_click(self,ba,ca,da)end function aa:mouse_drag(ba,ca,da) -if self.get("modal")then if self:isInBounds(ca,da)then +if self.getResolved("modal")then if self:isInBounds(ca,da)then return _a.mouse_drag and _a.mouse_drag(self,ba,ca,da)or false end;return true end;return _a.mouse_drag and _a.mouse_drag(self,ba,ca,da)or false end function aa:mouse_up(ba,ca,da) -if self.get("modal")then if self:isInBounds(ca,da)then +if self.getResolved("modal")then if self:isInBounds(ca,da)then return _a.mouse_up and _a.mouse_up(self,ba,ca,da)or false end;return true end;return _a.mouse_up and _a.mouse_up(self,ba,ca,da)or false end function aa:mouse_scroll(ba,ca,da) -if self.get("modal")then if self:isInBounds(ca,da)then +if self.getResolved("modal")then if self:isInBounds(ca,da)then return _a.mouse_scroll and _a.mouse_scroll(self,ba,ca,da)or false end;return true end;return _a.mouse_scroll and _a.mouse_scroll(self,ba,ca,da)or false end;return aa end @@ -1988,7 +2036,7 @@ local function da(ab,bb,cb,db)db=db or{}cb=cb or 0;for _c,ac in ipairs(ab)do table.insert(db,{node=ac,level=cb}) if bb[ac]and ac.children then da(ac.children,bb,cb+1,db)end end;return db end;local _b=setmetatable({},aa)_b.__index=_b _b.defineProperty(_b,"nodes",{default={},type="table",canTriggerRender=true,setter=function(ab,bb)if#bb>0 then -ab.get("expandedNodes")[bb[1]]=true end;return bb end}) +ab.getResolved("expandedNodes")[bb[1]]=true end;return bb end}) _b.defineProperty(_b,"selectedNode",{default=nil,type="table",canTriggerRender=true}) _b.defineProperty(_b,"expandedNodes",{default={},type="table",canTriggerRender=true}) _b.defineProperty(_b,"offset",{default=0,type="number",canTriggerRender=true,setter=function(ab,bb)return math.max(0,bb)end}) @@ -2005,58 +2053,62 @@ _b.defineEvent(_b,"mouse_scroll")function _b.new()local ab=setmetatable({},_b):_ ab.class=_b;ab.set("width",30)ab.set("height",10)ab.set("z",5) return ab end function _b:init(ab,bb) -aa.init(self,ab,bb)self.set("type","Tree")return self end;function _b:expandNode(ab)self.get("expandedNodes")[ab]=true -self:updateRender()return self end -function _b:collapseNode(ab)self.get("expandedNodes")[ab]= -nil;self:updateRender()return self end;function _b:toggleNode(ab)if self.get("expandedNodes")[ab]then -self:collapseNode(ab)else self:expandNode(ab)end -return self end +aa.init(self,ab,bb)self.set("type","Tree")return self end +function _b:expandNode(ab) +self.getResolved("expandedNodes")[ab]=true;self:updateRender()return self end +function _b:collapseNode(ab) +self.getResolved("expandedNodes")[ab]=nil;self:updateRender()return self end +function _b:toggleNode(ab) +if self.getResolved("expandedNodes")[ab]then +self:collapseNode(ab)else self:expandNode(ab)end;return self end function _b:mouse_click(ab,bb,cb) -if -aa.mouse_click(self,ab,bb,cb)then local db,_c=self:getRelativePosition(bb,cb) -local ac=self.get("width")local bc=self.get("height") -local cc=da(self.get("nodes"),self.get("expandedNodes"))local dc=self.get("showScrollBar") +if aa.mouse_click(self,ab,bb,cb)then +local db,_c=self:getRelativePosition(bb,cb)local ac=self.getResolved("width") +local bc=self.getResolved("height") +local cc=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local dc=self.getResolved("showScrollBar") local _d,ad=self:getNodeSize()local bd=dc and _d>ac;local cd=bd and bc-1 or bc local dd=dc and#cc>cd if dd and db==ac and(not bd or _c0 and(self.get("offset")/c_a*100)or 0;local _aa= -math.floor((d_a/100)* (a_a-b_a))+1 -if _c>=_aa and _c<_aa+b_a then -self._scrollBarDragging=true;self._scrollBarDragOffset=_c-_aa else -local aaa=( (_c-1)/ (a_a-b_a))*100;local baa=math.floor((aaa/100)*c_a+0.5) +local b_a=math.max(1,math.floor((cd/#cc)*a_a))local c_a=#cc-cd +local d_a=c_a>0 and +(self.getResolved("offset")/c_a*100)or 0 +local _aa=math.floor((d_a/100)* (a_a-b_a))+1 +if _c>=_aa and _c<_aa+b_a then self._scrollBarDragging=true;self._scrollBarDragOffset=_c- +_aa else local aaa=( (_c-1)/ (a_a-b_a))*100;local baa=math.floor(( +aaa/100)*c_a+0.5) self.set("offset",math.max(0,math.min(c_a,baa)))end;return true end if bd and _c==bc and(not dd or db0 and -(self.get("horizontalOffset")/c_a*100)or 0 +local d_a=c_a>0 and( +self.getResolved("horizontalOffset")/c_a*100)or 0 local _aa=math.floor((d_a/100)* (a_a-b_a))+1 if db>=_aa and db<_aa+b_a then self._hScrollBarDragging=true;self._hScrollBarDragOffset= db-_aa else local aaa=( (db-1)/ (a_a-b_a))*100;local baa=math.floor(( aaa/100)*c_a+0.5) -self.set("horizontalOffset",math.max(0,math.min(c_a,baa)))end;return true end;local __a=_c+self.get("offset") -if cc[__a]then local a_a=cc[__a] -local b_a=a_a.node +self.set("horizontalOffset",math.max(0,math.min(c_a,baa)))end;return true end;local __a=_c+self.getResolved("offset") +if cc[__a]then +local a_a=cc[__a]local b_a=a_a.node if db<=a_a.level*2 +2 then self:toggleNode(b_a)end;self.set("selectedNode",b_a) self:fireEvent("node_select",b_a)end;return true end;return false end function _b:onSelect(ab)self:registerCallback("node_select",ab)return self end function _b:mouse_drag(ab,bb,cb) if self._scrollBarDragging then local db,_c=self:getRelativePosition(bb,cb) -local ac=da(self.get("nodes"),self.get("expandedNodes"))local bc=self.get("height")local cc,dc=self:getNodeSize() -local _d= -self.get("showScrollBar")and cc>self.get("width")local ad=_d and bc-1 or bc;local bd=ad +local ac=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local bc=self.getResolved("height") +local cc,dc=self:getNodeSize() +local _d=self.getResolved("showScrollBar")and cc>self.getResolved("width")local ad=_d and bc-1 or bc;local bd=ad local cd=math.max(1,math.floor((ad/#ac)*bd))local dd=#ac-ad;_c=math.max(1,math.min(bd,_c))local __a=_c- ( self._scrollBarDragOffset or 0)local a_a= ( (__a-1)/ (bd-cd))*100 local b_a=math.floor((a_a/100)*dd+0.5) self.set("offset",math.max(0,math.min(dd,b_a)))return true end if self._hScrollBarDragging then local db,_c=self:getRelativePosition(bb,cb) -local ac=self.get("width")local bc,cc=self:getNodeSize() -local dc=da(self.get("nodes"),self.get("expandedNodes"))local _d=self.get("height") -local ad=self.get("showScrollBar")and bc>ac;local bd=ad and _d-1 or _d -local cd=self.get("showScrollBar")and#dc>bd;local dd=cd and ac-1 or ac +local ac=self.getResolved("width")local bc,cc=self:getNodeSize() +local dc=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local _d=self.getResolved("height")local ad= +self.getResolved("showScrollBar")and bc>ac +local bd=ad and _d-1 or _d +local cd=self.getResolved("showScrollBar")and#dc>bd;local dd=cd and ac-1 or ac local __a=math.max(1,math.floor((dd/bc)*dd))local a_a=bc-dd;db=math.max(1,math.min(dd,db))local b_a=db- ( self._hScrollBarDragOffset or 0)local c_a= ( (b_a-1)/ (dd-__a))*100 @@ -2070,38 +2122,41 @@ self._hScrollBarDragging=false;self._hScrollBarDragOffset=nil;return true end;re aa.mouse_up and aa.mouse_up(self,ab,bb,cb)or false end function _b:mouse_scroll(ab,bb,cb) if aa.mouse_scroll(self,ab,bb,cb)then -local db=da(self.get("nodes"),self.get("expandedNodes"))local _c=self.get("height")local ac=self.get("width") -local bc=self.get("showScrollBar")local cc,dc=self:getNodeSize()local _d=bc and cc>ac -local ad=_d and _c-1 or _c;local bd=math.max(0,#db-ad) -local cd=math.min(bd,math.max(0,self.get("offset")+ab))self.set("offset",cd)return true end;return false end +local db=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local _c=self.getResolved("height") +local ac=self.getResolved("width")local bc=self.getResolved("showScrollBar") +local cc,dc=self:getNodeSize()local _d=bc and cc>ac;local ad=_d and _c-1 or _c +local bd=math.max(0,#db-ad) +local cd=math.min(bd,math.max(0,self.getResolved("offset")+ab))self.set("offset",cd)return true end;return false end function _b:getNodeSize()local ab,bb=0,0 -local cb=da(self.get("nodes"),self.get("expandedNodes"))local db=self.get("expandedNodes") -for _c,ac in ipairs(cb)do local bc=ac.node -local cc=ac.level;local dc=string.rep(" ",cc)local _d=" "if -bc.children and#bc.children>0 then _d=db[bc]and"\31"or"\16"end -local ad=dc.._d.. -" ".. (bc.text or"Node")ab=math.max(ab,#ad)end;bb=#cb;return ab,bb end +local cb=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local db=self.getResolved("expandedNodes") +for _c,ac in ipairs(cb)do +local bc=ac.node;local cc=ac.level;local dc=string.rep(" ",cc)local _d=" " +if bc.children and +#bc.children>0 then _d=db[bc]and"\31"or"\16"end +local ad=dc.._d.." ".. (bc.text or"Node")ab=math.max(ab,#ad)end;bb=#cb;return ab,bb end function _b:render()aa.render(self) -local ab=da(self.get("nodes"),self.get("expandedNodes"))local bb=self.get("height")local cb=self.get("width") -local db=self.get("selectedNode")local _c=self.get("expandedNodes") -local ac=self.get("offset")local bc=self.get("horizontalOffset") -local cc=self.get("showScrollBar")local dc,_d=self:getNodeSize()local ad=cc and dc>cb -local bd=ad and bb-1 or bb;local cd=cc and#ab>bd;local dd=cd and cb-1 or cb -for y=1,bd do -local _aa=ab[y+ac] -if _aa then local aaa=_aa.node;local baa=_aa.level;local caa=string.rep(" ",baa) -local daa=" "if aaa.children and#aaa.children>0 then -daa=_c[aaa]and"\31"or"\16"end;local _ba=aaa==db -local aba=_ba and -self.get("selectedBackgroundColor")or -(aaa.background or aaa.bg or self.get("background")) -local bba=_ba and self.get("selectedForegroundColor")or( -aaa.foreground or aaa.fg or self.get("foreground")) +local ab=da(self.getResolved("nodes"),self.getResolved("expandedNodes"))local bb=self.getResolved("height") +local cb=self.getResolved("width")local db=self.getResolved("selectedNode") +local _c=self.getResolved("expandedNodes")local ac=self.getResolved("offset") +local bc=self.getResolved("horizontalOffset")local cc=self.getResolved("showScrollBar") +local dc,_d=self:getNodeSize()local ad=cc and dc>cb;local bd=ad and bb-1 or bb +local cd=cc and#ab>bd;local dd=cd and cb-1 or cb +for y=1,bd do local _aa=ab[y+ac] +if _aa then local aaa=_aa.node +local baa=_aa.level;local caa=string.rep(" ",baa)local daa=" " +if +aaa.children and#aaa.children>0 then daa=_c[aaa]and"\31"or"\16"end;local _ba=aaa==db +local aba= +_ba and self.getResolved("selectedBackgroundColor")or +(aaa.background or aaa.bg or self.getResolved("background")) +local bba=_ba and self.getResolved("selectedForegroundColor")or +( +aaa.foreground or aaa.fg or self.getResolved("foreground")) local cba=caa..daa.." ".. (aaa.text or"Node")local dba=ba(cba,bc+1,bc+dd) local _ca=dba..string.rep(" ",dd-#dba) local aca=ca[aba]:rep(#_ca)or ca[colors.black]:rep(#_ca) local bca=ca[bba]:rep(#_ca)or ca[colors.white]:rep(#_ca)self:blit(1,y,_ca,bca,aca)else -self:blit(1,y,string.rep(" ",dd),ca[self.get("foreground")]:rep(dd),ca[self.get("background")]:rep(dd))end end;local __a=self.getResolved("scrollBarSymbol") +self:blit(1,y,string.rep(" ",dd),ca[self.getResolved("foreground")]:rep(dd),ca[self.getResolved("background")]:rep(dd))end end;local __a=self.getResolved("scrollBarSymbol") local a_a=self.getResolved("scrollBarBackground")local b_a=self.getResolved("scrollBarColor") local c_a=self.getResolved("scrollBarBackgroundColor")local d_a=self.getResolved("foreground") if cd then @@ -2117,7 +2172,7 @@ local daa=math.floor(( caa/100)* (_aa-aaa))+1 for i=1,_aa do self:blit(i,bb,a_a,ca[d_a],ca[c_a])end;for i=daa,math.min(_aa,daa+aaa-1)do self:blit(i,bb,__a,ca[b_a],ca[c_a])end end;if cd and ad then -self:blit(cb,bb," ",ca[d_a],ca[self.get("background")])end end;return _b end +self:blit(cb,bb," ",ca[d_a],ca[self.getResolved("background")])end end;return _b 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 @@ -2136,34 +2191,36 @@ if cb==1 then if db 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 db and cb>1 then return aa.mouse_click(self,da,_b,ab-1)end;return false end +math.min(self.getResolved("dropdownHeight"),#self.getResolved("items")))self:setState("opened")end;return true elseif db and cb>1 then return aa.mouse_click(self,da,_b,ab-1)end;return false end function ca:mouse_drag(da,_b,ab)if self:hasState("opened")then return aa.mouse_drag(self,da,_b,ab-1)end;return _a.mouse_drag and _a.mouse_drag(self,da,_b,ab)or false end function ca:mouse_up(da,_b,ab) if self:hasState("opened")then local bb,cb=self:getRelativePosition(_b,ab) -if -cb>1 and self.get("selectable")and not self._scrollBarDragging 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 cb>1 and self.getResolved("selectable")and +not self._scrollBarDragging then +local db=(cb-1)+self.getResolved("offset")local _c=self.getResolved("items") +if db<=#_c then local ac=_c[db]if +type(ac)=="string"then ac={text=ac}_c[db]=ac end +if not +self.getResolved("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:unsetState("opened")self:unsetState("clicked")self.set("height",1) self:updateRender()return true end end;aa.mouse_up(self,da,_b,ab-1) self:unsetState("clicked")return true end;return _a.mouse_up and _a.mouse_up(self,da,_b,ab)or false end -function ca:render()_a.render(self)local da=self.get("selectedText") -local _b=self:hasState("opened")local ab=self:getSelectedItems() -if#ab>0 then local bb=ab[1] -da=bb.text or""da=da:sub(1,self.get("width")-2)end -if _b then local bb=self.get("height")local cb=math.min(self.get("dropdownHeight"),# -self.get("items")) -self.set("height",cb)aa.render(self,1)self.set("height",bb)end -self:blit(1,1,da.. -string.rep(" ",self.get("width")-#da-1).. (_b and"\31"or"\17"),string.rep(ba[self.getResolved("foreground")],self.get("width")),string.rep(ba[self.getResolved("background")],self.get("width")))end;function ca:focus()_a.focus(self)self:prioritize() +function ca:render()_a.render(self)local da=self.getResolved("width") +local _b=self.getResolved("height")local ab=self.getResolved("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,da-2)end +if bb then local db=_b +local _c=math.min(self.getResolved("dropdownHeight"), +#self.getResolved("items"))self.set("height",_c)aa.render(self,1) +self.set("height",db)end +self:blit(1,1,ab.. +string.rep(" ",da-#ab-1).. (bb and"\31"or"\17"),string.rep(ba[self.getResolved("foreground")],da),string.rep(ba[self.getResolved("background")],da))end;function ca:focus()_a.focus(self)self:prioritize() self:setState("opened")end function ca:blur()_a.blur(self) self:unsetState("opened")self.set("height",1)self:updateRender()end;return ca end @@ -2173,19 +2230,20 @@ local ba=setmetatable({},aa):__init()ba.class=aa;ba.set("width",25)ba.set("heigh ba.set("z",5)return ba end function aa:init(ba,ca) _a.init(self,ba,ca)self.set("type","Display") -self._window=window.create(ca.getActiveFrame():getTerm(),1,1,self.get("width"),self.get("height"),false)local da=self._window.reposition;local _b=self._window.blit +self._window=window.create(ca.getActiveFrame():getTerm(),1,1,self.getResolved("width"),self.getResolved("height"),false)local da=self._window.reposition;local _b=self._window.blit local ab=self._window.write self._window.reposition=function(bb,cb,db,_c)self.set("x",bb)self.set("y",cb) -self.set("width",db)self.set("height",_c)da(1,1,db,_c)end -self._window.getPosition=function(bb)return bb.get("x"),bb.get("y")end -self._window.setVisible=function(bb)self.set("visible",bb)end -self._window.isVisible=function(bb)return bb.get("visible")end -self._window.blit=function(bb,cb,db,_c,ac)_b(bb,cb,db,_c,ac)self:updateRender()end +self.set("width",db)self.set("height",_c)da(1,1,db,_c)end;self._window.getPosition=function(bb) +return bb.getResolved("x"),bb.getResolved("y")end;self._window.setVisible=function(bb) +self.set("visible",bb)end;self._window.isVisible=function(bb)return +bb.getResolved("visible")end +self._window.blit=function(bb,cb,db,_c,ac) +_b(bb,cb,db,_c,ac)self:updateRender()end self._window.write=function(bb,cb,db)ab(bb,cb,db)self:updateRender()end self:observe("width",function(bb,cb)local db=bb._window;if db then -db.reposition(1,1,cb,bb.get("height"))end end) +db.reposition(1,1,cb,bb.getResolved("height"))end end) self:observe("height",function(bb,cb)local db=bb._window;if db then -db.reposition(1,1,bb.get("width"),cb)end end)end;function aa:getWindow()return self._window end +db.reposition(1,1,bb.getResolved("width"),cb)end end)end;function aa:getWindow()return self._window end function aa:write(ba,ca,da,_b,ab)local bb=self._window if bb then if _b then bb.setTextColor(_b)end;if ab then bb.setBackgroundColor(ab)end @@ -2204,21 +2262,22 @@ function aa.new()local ba=setmetatable({},aa):__init() ba.class=aa;ba.set("z",5)ba.set("height",1) ba.set("backgroundEnabled",false)return ba end;function aa:init(ba,ca)_a.init(self,ba,ca) self.set("type","Breadcrumb")end -function aa:mouse_click(ba,ca,da)if -not self.get("clickable")then return false end -if _a.mouse_click(self,ba,ca,da)then -local _b=self.get("path")local ab=self.get("separator")local bb=1 -for cb,db in ipairs(_b)do local _c=#db;if -ca>=bb and ca=bb and caab then local _c="... > "local ac=ab- -#_c +function aa:render()local ba=self.getResolved("path") +local ca=self.getResolved("separator")local da=self.getResolved("foreground") +local _b=self.getResolved("clickable")local ab=self.getResolved("width")local bb=""for _c,ac in ipairs(ba)do bb=bb..ac;if +_c<#ba then bb=bb..ca end end +if +self.getResolved("autoSize")then self.getResolved("width",#bb)else if#bb>ab then local _c="... > " +local ac=ab-#_c if ac>0 then bb=_c..bb:sub(-ac)else bb=_c:sub(1,ab)end end end;local cb=1;local db for _c in bb:gmatch("[^"..ca.."]+")do db=da self:textFg(cb,1,_c,db)cb=cb+#_c;local ac=bb:find(ca,cb,true)if ac then @@ -2233,19 +2292,20 @@ da.init(self,cb,db)self.set("type","LineChart")return self end local function bb(cb,db,_c,ac,bc,cc,dc,_d)local ad=ac-db;local bd=bc-_c local cd=math.max(math.abs(ad),math.abs(bd)) for i=0,cd do local dd=cd==0 and 0 or i/cd -local __a=math.floor(db+ad*dd)local a_a=math.floor(_c+bd*dd) -if - -__a>=1 and __a<=cb.get("width")and a_a>=1 and a_a<=cb.get("height")then cb:blit(__a,a_a,cc,_b[dc],_b[_d])end end end -function ab:render()ca.render(self)local cb=self.get("width") -local db=self.get("height")local _c=self.get("minValue")local ac=self.get("maxValue") -local bc=self.get("series") +local __a=math.floor(db+ad*dd)local a_a=math.floor(_c+bd*dd)if __a>=1 and +__a<=cb.getResolved("width")and a_a>=1 and +a_a<=cb.getResolved("height")then +cb:blit(__a,a_a,cc,_b[dc],_b[_d])end end end +function ab:render()ca.render(self)local cb=self.getResolved("width") +local db=self.getResolved("height")local _c=self.getResolved("minValue") +local ac=self.getResolved("maxValue")local bc=self.getResolved("series") for cc,dc in pairs(bc)do -if(dc.visible)then local _d,ad;local bd=#dc.data -local cd=(cb-1)/math.max((bd-1),1) -for dd,__a in ipairs(dc.data)do local a_a=math.floor(( (dd-1)*cd)+1)local b_a= -(__a-_c)/ (ac-_c) -local c_a=math.floor(db- (b_a* (db-1)))c_a=math.max(1,math.min(c_a,db))if _d then +if(dc.visible)then local _d,ad +local bd=#dc.data;local cd=(cb-1)/math.max((bd-1),1) +for dd,__a in ipairs(dc.data)do local a_a=math.floor(( ( +dd-1)*cd)+1) +local b_a=(__a-_c)/ (ac-_c)local c_a=math.floor(db- (b_a* (db-1))) +c_a=math.max(1,math.min(c_a,db))if _d then bb(self,_d,ad,a_a,c_a,dc.symbol,dc.bgColor,dc.fgColor)end;_d,ad=a_a,c_a end end end end;return ab end project["elements/Graph.lua"] = function(...) local _a=require("elementManager") local aa=_a.getElement("VisualElement")local ba=require("libraries/colorHex") @@ -2257,39 +2317,42 @@ da.class=ca;return da end;function ca:init(da,_b) aa.init(self,da,_b)self.set("type","Graph")self.set("width",20) self.set("height",10)return self end function ca:addSeries(da,_b,ab,bb,cb) -local db=self.get("series") -table.insert(db,{name=da,symbol=_b or" ",bgColor=ab or colors.white,fgColor=bb or colors.black,pointCount=cb or self.get("width"),data={},visible=true})self:updateRender()return self end -function ca:removeSeries(da)local _b=self.get("series")for ab,bb in ipairs(_b)do if bb.name==da then +local db=self.getResolved("series") +table.insert(db,{name=da,symbol=_b or" ",bgColor=ab or colors.white,fgColor=bb or colors.black,pointCount=cb or +self.getResolved("width"),data={},visible=true})self:updateRender()return self end +function ca:removeSeries(da)local _b=self.getResolved("series")for ab,bb in ipairs(_b)do if bb.name==da then table.remove(_b,ab)break end end self:updateRender()return self end -function ca:getSeries(da)local _b=self.get("series")for ab,bb in ipairs(_b)do -if bb.name==da then return bb end end;return nil end -function ca:changeSeriesVisibility(da,_b)local ab=self.get("series")for bb,cb in ipairs(ab)do if cb.name==da then -cb.visible=_b;break end end +function ca:getSeries(da)local _b=self.getResolved("series")for ab,bb in ipairs(_b)do if bb.name==da then +return bb end end;return nil end +function ca:changeSeriesVisibility(da,_b)local ab=self.getResolved("series")for bb,cb in ipairs(ab)do if +cb.name==da then cb.visible=_b;break end end self:updateRender()return self end -function ca:addPoint(da,_b)local ab=self.get("series") +function ca:addPoint(da,_b)local ab=self.getResolved("series") for bb,cb in ipairs(ab)do if cb.name==da then table.insert(cb.data,_b) while#cb.data>cb.pointCount do table.remove(cb.data,1)end;break end end;self:updateRender()return self end -function ca:focusSeries(da)local _b=self.get("series") +function ca:focusSeries(da)local _b=self.getResolved("series") for ab,bb in ipairs(_b)do if bb.name==da then table.remove(_b,ab)table.insert(_b,bb)break end end;self:updateRender()return self end -function ca:setSeriesPointCount(da,_b)local ab=self.get("series") -for bb,cb in ipairs(ab)do if cb.name==da then -cb.pointCount=_b;while#cb.data>_b do table.remove(cb.data,1)end -break end end;self:updateRender()return self end -function ca:clear(da)local _b=self.get("series") -if da then for ab,bb in ipairs(_b)do -if bb.name==da then bb.data={}break end end else for ab,bb in ipairs(_b)do bb.data={}end end;return self end -function ca:render()aa.render(self)local da=self.get("width") -local _b=self.get("height")local ab=self.get("minValue")local bb=self.get("maxValue") -local cb=self.get("series") +function ca:setSeriesPointCount(da,_b)local ab=self.getResolved("series") +for bb,cb in ipairs(ab)do if +cb.name==da then cb.pointCount=_b +while#cb.data>_b do table.remove(cb.data,1)end;break end end;self:updateRender()return self end +function ca:clear(da)local _b=self.getResolved("series") +if da then for ab,bb in ipairs(_b)do if bb.name==da then +bb.data={}break end end else for ab,bb in ipairs(_b)do +bb.data={}end end;return self end +function ca:render()aa.render(self)local da=self.getResolved("width") +local _b=self.getResolved("height")local ab=self.getResolved("minValue") +local bb=self.getResolved("maxValue")local cb=self.getResolved("series") for db,_c in pairs(cb)do -if(_c.visible)then local ac=#_c.data -local bc=(da-1)/math.max((ac-1),1) -for cc,dc in ipairs(_c.data)do local _d=math.floor(( (cc-1)*bc)+1)local ad= -(dc-ab)/ (bb-ab) -local bd=math.floor(_b- (ad* (_b-1)))bd=math.max(1,math.min(bd,_b)) +if(_c.visible)then +local ac=#_c.data;local bc=(da-1)/math.max((ac-1),1) +for cc,dc in ipairs(_c.data)do local _d=math.floor(( ( +cc-1)*bc)+1) +local ad=(dc-ab)/ (bb-ab)local bd=math.floor(_b- (ad* (_b-1))) +bd=math.max(1,math.min(bd,_b)) self:blit(_d,bd,_c.symbol,ba[_c.bgColor],ba[_c.fgColor])end end end end;return ca end project["elements/Table.lua"] = function(...) local _a=require("elements/Collection") local aa=require("libraries/colorHex")local ba=setmetatable({},_a)ba.__index=ba @@ -2304,9 +2367,9 @@ ba.defineProperty(ba,"gridColor",{default=colors.gray,type="color"}) ba.defineProperty(ba,"sortColumn",{default=nil,type="number",canTriggerRender=true}) ba.defineProperty(ba,"sortDirection",{default="asc",type="string",canTriggerRender=true}) ba.defineProperty(ba,"customSortFunction",{default={},type="table"}) -ba.defineProperty(ba,"offset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b)local ab=math.max(0,#da.get("items")- -(da.get("height")-1))return -math.min(ab,math.max(0,_b))end}) +ba.defineProperty(ba,"offset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b) +local ab=math.max(0,#da.getResolved("items")- ( +da.getResolved("height")-1))return math.min(ab,math.max(0,_b))end}) ba.defineProperty(ba,"showScrollBar",{default=true,type="boolean",canTriggerRender=true}) ba.defineProperty(ba,"scrollBarSymbol",{default=" ",type="string",canTriggerRender=true}) ba.defineProperty(ba,"scrollBarBackground",{default="\127",type="string",canTriggerRender=true}) @@ -2319,30 +2382,31 @@ da.class=ba;da.set("width",30)da.set("height",10)da.set("z",5) return da end function ba:init(da,_b) _a.init(self,da,_b)self._entrySchema=ca;self.set("type","Table") -self:observe("sortColumn",function() -if -self.get("sortColumn")then self:sortByColumn(self.get("sortColumn"))end end)return self end;function ba:addRow(...)local da={...} +self:observe("sortColumn",function()if +self.getResolved("sortColumn")then +self:sortByColumn(self.getResolved("sortColumn"))end end)return self end;function ba:addRow(...)local da={...} _a.addItem(self,{cells=da,_sortValues=da,text=table.concat(da," ")})return self end;function ba:removeRow(da) -local _b=self.get("items") +local _b=self.getResolved("items") if _b[da]then table.remove(_b,da)self.set("items",_b)end;return self end;function ba:getRow(da) -local _b=self.get("items")return _b[da]end +local _b=self.getResolved("items")return _b[da]end function ba:updateCell(da,_b,ab) -local bb=self.get("items")if bb[da]and bb[da].cells then bb[da].cells[_b]=ab +local bb=self.getResolved("items")if bb[da]and bb[da].cells then bb[da].cells[_b]=ab self.set("items",bb)end;return self end -function ba:getSelectedRow()local da=self.get("items")for _b,ab in ipairs(da)do local bb= -ab._data and ab._data.selected or ab.selected -if bb then return ab end end;return nil end;function ba:clearData()self.set("items",{})return self end;function ba:addColumn(da,_b) -local ab=self.get("columns")table.insert(ab,{name=da,width=_b}) +function ba:getSelectedRow()local da=self.getResolved("items")for _b,ab in ipairs(da)do local bb=ab._data and +ab._data.selected or ab.selected;if bb then +return ab end end;return nil end;function ba:clearData()self.set("items",{})return self end +function ba:addColumn(da,_b) +local ab=self.getResolved("columns")table.insert(ab,{name=da,width=_b}) self.set("columns",ab)return self end function ba:setColumnSortFunction(da,_b) -local ab=self.get("customSortFunction")ab[da]=_b;self.set("customSortFunction",ab)return self end +local ab=self.getResolved("customSortFunction")ab[da]=_b;self.set("customSortFunction",ab)return self end function ba:setData(da,_b)self:clearData() for ab,bb in ipairs(da)do local cb={}local db={} for _c,ac in ipairs(bb)do db[_c]=ac;if _b and _b[_c]then cb[_c]=_b[_c](ac)else cb[_c]=ac end end _a.addItem(self,{cells=cb,_sortValues=db,text=table.concat(cb," ")})end;return self end -function ba:getData()local da=self.get("items")local _b={}for ab,bb in ipairs(da)do local cb= -bb._data and bb._data.cells or bb.cells;if cb then +function ba:getData()local da=self.getResolved("items")local _b={}for ab,bb in ipairs(da)do local cb=bb._data and +bb._data.cells or bb.cells;if cb then table.insert(_b,cb)end end return _b end function ba:calculateColumnWidths(da,_b)local ab={}local bb=_b;local cb={}local db=0 @@ -2366,11 +2430,11 @@ for ac,bc in ipairs(ab)do _c=_c+ (bc.visibleWidth or 0)end;if _c>_b then local a for bc,cc in ipairs(ab)do if cc.visibleWidth then cc.visibleWidth=math.max(1,math.floor(cc.visibleWidth*ac))end end end return ab end -function ba:sortByColumn(da,_b)local ab=self.get("items") -local bb=self.get("sortDirection")local cb=self.get("customSortFunction")local db=_b or cb[da] +function ba:sortByColumn(da,_b)local ab=self.getResolved("items") +local bb=self.getResolved("sortDirection")local cb=self.getResolved("customSortFunction") +local db=_b or cb[da] if db then -table.sort(ab,function(_c,ac)return -db(_c,ac,bb)end)else +table.sort(ab,function(_c,ac)return db(_c,ac,bb)end)else table.sort(ab,function(_c,ac) local bc=_c._data and _c._data.cells or _c.cells local cc=ac._data and ac._data.cells or ac.cells @@ -2385,39 +2449,42 @@ if bb=="asc"then return cd
dd end end end)end;self.set("items" function ba:onRowSelect(da)self:registerCallback("rowSelect",da)return self end function ba: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("height")local ac=self.get("items") -local bc=self.get("showScrollBar")local cc=_c-1 -if bc and#ac>cc and bb==db and cb>1 then local dc=_c-1 -local _d=#ac-cc -local ad=math.max(1,math.floor((cc/#ac)*dc)) -local bd=_d>0 and(self.get("offset")/_d*100)or 0 +local db=self.getResolved("width")local _c=self.getResolved("height") +local ac=self.getResolved("items")local bc=self.getResolved("showScrollBar")local cc=_c-1 +if +bc and#ac>cc and bb==db and cb>1 then local dc=_c-1;local _d=#ac-cc;local ad=math.max(1,math.floor(( +cc/#ac)*dc)) +local bd=_d>0 and( +self.getResolved("offset")/_d*100)or 0 local cd=math.floor((bd/100)* (dc-ad))+1;local dd=cb-1 if dd>=cd and dd=ad and bb1 then local dc=cb-2 +self.get("offset") -if dc>=0 and dc<#ac then -local _d=dc+1;for ad,bd in ipairs(ac)do -if bd._data then bd._data.selected=false else bd.selected=false end end -if ac[_d]then if ac[_d]._data then -ac[_d]._data.selected=true else ac[_d].selected=true end +if cb>1 then local dc=cb-2 +self.getResolved("offset") +if dc>=0 and +dc<#ac then local _d=dc+1 +for ad,bd in ipairs(ac)do if bd._data then bd._data.selected=false else +bd.selected=false end end +if ac[_d]then if ac[_d]._data then ac[_d]._data.selected=true else +ac[_d].selected=true end self:fireEvent("rowSelect",_d,ac[_d])self:updateRender()end end;return true end;return true end function ba:mouse_drag(da,_b,ab) if self._scrollBarDragging then local bb,cb=self:getRelativePosition(_b,ab) -local db=self.get("items")local _c=self.get("height")local ac=_c-1;local bc=_c-1 -local cc=math.max(1,math.floor((ac/#db)*bc))local dc=#db-ac;local _d=cb-1 -_d=math.max(1,math.min(bc,_d))local ad=_d- (self._scrollBarDragOffset or 0)local bd=( -(ad-1)/ (bc-cc))*100 +local db=self.getResolved("items")local _c=self.getResolved("height")local ac=_c-1;local bc=_c-1;local cc=math.max(1,math.floor(( +ac/#db)*bc)) +local dc=#db-ac;local _d=cb-1;_d=math.max(1,math.min(bc,_d))local ad=_d- ( +self._scrollBarDragOffset or 0)local bd= +( (ad-1)/ (bc-cc))*100 local cd=math.floor((bd/100)*dc+0.5) self.set("offset",math.max(0,math.min(dc,cd)))return true end;return _a.mouse_drag and _a.mouse_drag(self,da,_b,ab)or false end @@ -2426,70 +2493,72 @@ self._scrollBarDragOffset=nil;return true end return _a.mouse_up and _a.mouse_up(self,da,_b,ab)or false end function ba:mouse_scroll(da,_b,ab) -if _a.mouse_scroll(self,da,_b,ab)then local bb=self.get("items") -local cb=self.get("height")local db=cb-1;local _c=math.max(0,#bb-db) -local ac=math.min(_c,math.max(0, -self.get("offset")+da))self.set("offset",ac)self:updateRender()return true end;return false end +if _a.mouse_scroll(self,da,_b,ab)then +local bb=self.getResolved("items")local cb=self.getResolved("height")local db=cb-1 +local _c=math.max(0,#bb-db) +local ac=math.min(_c,math.max(0,self.getResolved("offset")+da))self.set("offset",ac)self:updateRender()return true end;return false end function ba:render()_a.render(self)local da=self.getResolved("columns") local _b=self.getResolved("items")local ab=self.getResolved("sortColumn") -local bb=self.getResolved("offset")local cb=self.get("height")local db=self.get("width") -local _c=self.getResolved("showScrollBar")local ac=cb-1;local bc=_c and#_b>ac;local cc=bc and db-1 or db -local dc=self:calculateColumnWidths(da,cc)local _d=0;local ad=#dc -for cd,dd in ipairs(dc)do -if _d+dd.visibleWidth>cc then ad=cd-1;break end;_d=_d+dd.visibleWidth end;local bd=1 -for cd,dd in ipairs(dc)do if cd>ad then break end;local __a=dd.name;if cd==ab then -__a=__a.. ( -self.get("sortDirection")=="asc"and"\30"or"\31")end -self:textFg(bd,1,__a:sub(1,dd.visibleWidth),self.get("headerColor"))bd=bd+dd.visibleWidth end;if bd<=cc then -self:textBg(bd,1,string.rep(" ",cc-bd+1),self.get("background"))end -for y=2,cb do local cd=y-2 +bb;local dd=_b[cd+1] -if -dd then -local __a=dd._data and dd._data.cells or dd.cells -local a_a=dd._data and dd._data.selected or dd.selected -if __a then bd=1;local b_a=a_a and self.get("selectedBackground")or -self.get("background") -for c_a,d_a in -ipairs(dc)do if c_a>ad then break end;local _aa=tostring(__a[c_a]or"") -local aaa=_aa..string.rep(" ", -d_a.visibleWidth-#_aa)if c_a0 and(bb/__a*100)or 0 -local b_a=math.floor(( -a_a/100)* (cd-dd))+1;local c_a=self.getResolved("scrollBarSymbol") -local d_a=self.getResolved("scrollBarBackground")local _aa=self.getResolved("scrollBarColor") -local aaa=self.getResolved("scrollBarBackgroundColor")local baa=self.getResolved("foreground")for i=2,cb do -self:blit(db,i,d_a,aa[baa],aa[aaa])end;for i=b_a,math.min(cd,b_a+dd-1)do -self:blit(db,i+1,c_a,aa[_aa],aa[aaa])end end end;return ba end +local bb=self.getResolved("offset")local cb=self.getResolved("height") +local db=self.getResolved("width")local _c=self.getResolved("showScrollBar") +local ac=self.getResolved("background")local bc=self.getResolved("foreground")local cc=cb-1 +local dc=_c and#_b>cc;local _d=dc and db-1 or db +local ad=self:calculateColumnWidths(da,_d)local bd=0;local cd=#ad +for __a,a_a in ipairs(ad)do +if bd+a_a.visibleWidth>_d then cd=__a-1;break end;bd=bd+a_a.visibleWidth end;local dd=1 +for __a,a_a in ipairs(ad)do if __a>cd then break end;local b_a=a_a.name +if __a==ab then b_a=b_a.. +( +self.getResolved("sortDirection")=="asc"and"\30"or"\31")end +self:textFg(dd,1,b_a:sub(1,a_a.visibleWidth),self.getResolved("headerColor"))dd=dd+a_a.visibleWidth end;if dd<=_d then +self:textBg(dd,1,string.rep(" ",_d-dd+1),ac)end +for y=2,cb do local __a=y-2 +bb;local a_a=_b[__a+1] +if a_a then local b_a=a_a._data and +a_a._data.cells or a_a.cells +local c_a=a_a._data and +a_a._data.selected or a_a.selected +if b_a then dd=1 +local d_a=c_a and self.getResolved("selectedBackground")or ac +for _aa,aaa in ipairs(ad)do if _aa>cd then break end;local baa=tostring(b_a[_aa]or"") +local caa= +baa..string.rep(" ",aaa.visibleWidth-#baa)if _aa0 and(bb/b_a*100)or 0 +local d_a=math.floor(( +c_a/100)* (__a-a_a))+1;local _aa=self.getResolved("scrollBarSymbol") +local aaa=self.getResolved("scrollBarBackground")local baa=self.getResolved("scrollBarColor") +local caa=self.getResolved("scrollBarBackgroundColor") +for i=2,cb do self:blit(db,i,aaa,aa[bc],aa[caa])end;for i=d_a,math.min(__a,d_a+a_a-1)do +self:blit(db,i+1,_aa,aa[baa],aa[caa])end end end;return ba end project["elements/Menu.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,"separatorColor",{default=colors.gray,type="color"}) ca.defineProperty(ca,"spacing",{default=1,type="number",canTriggerRender=true}) ca.defineProperty(ca,"horizontalOffset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b) -local ab=math.max(0,da:getTotalWidth()-da.get("width"))return math.min(ab,math.max(0,_b))end}) +local ab=math.max(0,da:getTotalWidth()-da.getResolved("width"))return math.min(ab,math.max(0,_b))end}) ca.defineProperty(ca,"maxWidth",{default=nil,type="number",canTriggerRender=true}) function ca.new()local da=setmetatable({},ca):__init() da.class=ca;da.set("width",30)da.set("height",1) da.set("background",colors.gray)return da end function ca:init(da,_b)aa.init(self,da,_b)self.set("type","Menu") self:observe("items",function() -local ab=self.get("maxWidth")if ab then +local ab=self.getResolved("maxWidth")if ab then self.set("width",math.min(ab,self:getTotalWidth()),true)else self.set("width",self:getTotalWidth(),true)end end)return self end -function ca:getTotalWidth()local da=self.get("items")local _b=self.get("spacing") -local ab=0;for bb,cb in ipairs(da)do if type(cb)=="table"then ab=ab+#cb.text else ab= -ab+#tostring(cb)+2 end -if bb<#da then ab=ab+_b end end;return ab end -function ca:render()_a.render(self)local da=self.get("width") -local _b=self.get("spacing")local ab=self.get("horizontalOffset") -local bb=self.get("items")local cb={}local db=1 +function ca:getTotalWidth()local da=self.getResolved("items") +local _b=self.getResolved("spacing")local ab=0 +for bb,cb in ipairs(da)do if type(cb)=="table"then ab=ab+#cb.text else ab=ab+ +#tostring(cb)+2 end;if bb<#da then +ab=ab+_b end end;return ab end +function ca:render()_a.render(self)local da=self.getResolved("width") +local _b=self.getResolved("spacing")local ab=self.getResolved("horizontalOffset") +local bb=self.getResolved("items")local cb={}local db=1 for _c,ac in ipairs(bb)do if type(ac)=="string"then ac={text=" "..ac.." "}bb[_c]=ac end cb[_c]={startX=db,endX=db+#ac.text-1,text=ac.text,item=ac}db=db+#ac.text;if _c<#bb and _b>0 then db=db+_b end end @@ -2500,36 +2569,38 @@ local bd=math.max(1,1 -cc+1) local cd=math.min(#ac.text,#ac.text- (dc-da))local dd=ac.text:sub(bd,cd) if#dd>0 then local __a=bc.selected local a_a= -bc.selectable==false and self.get("separatorColor")or(__a and(bc.selectedForeground or -self.get("selectedForeground"))or(bc.foreground or -self.get("foreground"))) -local b_a= -__a and(bc.selectedBackground or self.get("selectedBackground"))or(bc.background or self.get("background")) +bc.selectable==false and self.getResolved("separatorColor")or +( +__a and( +bc.selectedForeground or self.getResolved("selectedForeground"))or(bc.foreground or self.getResolved("foreground"))) +local b_a=__a and +(bc.selectedBackground or self.getResolved("selectedBackground"))or +(bc.background or self.getResolved("background")) self:blit(_d,1,dd,string.rep(ba[a_a],#dd),string.rep(ba[b_a],#dd))end if _c<#bb and _b>0 then local __a=ac.endX+1 -ab;local a_a=__a+_b-1 if a_a>=1 and __a<=da then local b_a=math.max(1,__a)local c_a=math.min(da,a_a) local d_a=c_a-b_a+1 if d_a>0 then local _aa=string.rep(" ",d_a) -self:blit(b_a,1,_aa,string.rep(ba[self.get("foreground")],d_a),string.rep(ba[self.get("background")],d_a))end end end end end end +self:blit(b_a,1,_aa,string.rep(ba[self.getResolved("foreground")],d_a),string.rep(ba[self.getResolved("background")],d_a))end end end end end end function ca:mouse_click(da,_b,ab) if not _a.mouse_click(self,da,_b,ab)then return false end -if(self.get("selectable")==false)then return false end -local bb=select(1,self:getRelativePosition(_b,ab))local cb=self.get("horizontalOffset") -local db=self.get("spacing")local _c=self.get("items")local ac=bb+cb;local bc=1 -for cc,dc in ipairs(_c)do local _d=#dc.text -if ac>= -bc and ac=bc and ac0 then bc=bc+db end end;return false end function ca:mouse_scroll(da,_b,ab) if _a.mouse_scroll(self,da,_b,ab)then -local bb=self.get("horizontalOffset") -local cb=math.max(0,self:getTotalWidth()-self.get("width"))bb=math.min(cb,math.max(0,bb+ (da*3))) +local bb=self.getResolved("horizontalOffset") +local cb=math.max(0,self:getTotalWidth()-self.getResolved("width"))bb=math.min(cb,math.max(0,bb+ (da*3))) self.set("horizontalOffset",bb)return true end;return false end;return ca end project["elements/Slider.lua"] = function(...) local c=require("elements/VisualElement") local d=setmetatable({},c)d.__index=d @@ -2545,29 +2616,32 @@ function d.new()local _a=setmetatable({},d):__init()_a.class=d _a.set("width",8)_a.set("height",1) _a.set("backgroundEnabled",false)return _a end function d:init(_a,aa)c.init(self,_a,aa)self.set("type","Slider")end -function d:getValue()local _a=self.get("step")local aa=self.get("max") +function d:getValue()local _a=self.getResolved("step") +local aa=self.getResolved("max") local ba= -self.get("horizontal")and self.get("width")or self.get("height")return math.floor((_a-1)* (aa/ (ba-1)))end +self.getResolved("horizontal")and self.getResolved("width")or self.getResolved("height")return math.floor((_a-1)* (aa/ (ba-1)))end function d:mouse_click(_a,aa,ba) if self:isInBounds(aa,ba)then local ca,da=self:getRelativePosition(aa,ba) -local _b=self.get("horizontal")and ca or da;local ab=self.get("horizontal")and self.get("width")or -self.get("height") +local _b=self.getResolved("horizontal")and ca or da +local ab= +self.getResolved("horizontal")and self.getResolved("width")or self.getResolved("height") self.set("step",math.min(ab,math.max(1,_b)))self:updateRender()return true end;return false end;d.mouse_drag=d.mouse_click function d:mouse_scroll(_a,aa,ba) if self:isInBounds(aa,ba)then -local ca=self.get("step")local da=self.get("horizontal")and self.get("width")or -self.get("height") -self.set("step",math.min(da,math.max(1, -ca+_a)))self:updateRender()return true end;return false end -function d:render()c.render(self)local _a=self.get("width") -local aa=self.get("height")local ba=self.get("horizontal")local ca=self.get("step")local da= -ba and"\140"or" " +local ca=self.getResolved("step") +local da= +self.getResolved("horizontal")and self.getResolved("width")or self.getResolved("height") +self.set("step",math.min(da,math.max(1,ca+_a)))self:updateRender()return true end;return false end +function d:render()c.render(self)local _a=self.getResolved("width") +local aa=self.getResolved("height")local ba=self.getResolved("horizontal") +local ca=self.getResolved("step")local da=ba and"\140"or" " local _b=string.rep(da,ba and _a or aa) -if ba then self:textFg(1,1,_b,self.get("barColor")) -self:textBg(ca,1," ",self.get("sliderColor"))else local ab=self.get("background") -for y=1,aa do self:textBg(1,y," ",ab)end -self:textBg(1,ca," ",self.get("sliderColor"))end end;return d end +if ba then +self:textFg(1,1,_b,self.getResolved("barColor")) +self:textBg(ca,1," ",self.getResolved("sliderColor"))else local ab=self.getResolved("background")for y=1,aa do +self:textBg(1,y," ",ab)end +self:textBg(1,ca," ",self.getResolved("sliderColor"))end end;return d end project["elements/ScrollBar.lua"] = function(...) local aa=require("elements/VisualElement") local ba=require("libraries/colorHex")local ca=setmetatable({},aa)ca.__index=ca ca.defineProperty(ca,"value",{default=0,type="number",canTriggerRender=true}) @@ -2595,48 +2669,50 @@ self.set("attachedElement",ab)self.set("attachedProperty",bb.property)self.set(" bb.min or 0) self.set("maxValue",bb.max or 100) ab:observe(bb.property,function(cb,db) -if db then local _c=self.get("minValue") -local ac=self.get("maxValue")if _c==ac then return end +if db then local _c=self.getResolved("minValue") +local ac=self.getResolved("maxValue")if _c==ac then return end self.set("value",math.floor((db-_c)/ (ac-_c)*100 +0.5))end end)return self end -function ca:updateAttachedElement()local ab=self.get("attachedElement") -if not ab then return end;local bb=self.get("value")local cb=self.get("minValue") -local db=self.get("maxValue")if type(cb)=="function"then cb=cb()end;if type(db)=="function"then -db=db()end;local _c=cb+ (bb/100)* (db-cb)ab.set(self.get("attachedProperty"),math.floor( -_c+0.5)) -return self end;local function da(ab) -return -ab.get("orientation")=="vertical"and ab.get("height")or ab.get("width")end -local function _b(ab,bb,cb) -local db,_c=ab:getRelativePosition(bb,cb)return -ab.get("orientation")=="vertical"and _c or db end +function ca:updateAttachedElement()local ab=self.getResolved("attachedElement")if not ab then +return end;local bb=self.getResolved("value") +local cb=self.getResolved("minValue")local db=self.getResolved("maxValue")if type(cb)=="function"then +cb=cb()end;if type(db)=="function"then db=db()end;local _c=cb+ (bb/100)* ( +db-cb) +ab.set(self.getResolved("attachedProperty"),math.floor( +_c+0.5))return self end +local function da(ab)return +ab.getResolved("orientation")=="vertical"and +ab.getResolved("height")or ab.getResolved("width")end +local function _b(ab,bb,cb)local db,_c=ab:getRelativePosition(bb,cb)return + +ab.getResolved("orientation")=="vertical"and _c or db end function ca:mouse_click(ab,bb,cb) if aa.mouse_click(self,ab,bb,cb)then local db=da(self) -local _c=self.get("value")local ac=self.get("handleSize")local bc= +local _c=self.getResolved("value")local ac=self.getResolved("handleSize")local bc= math.floor((_c/100)* (db-ac))+1;local cc=_b(self,bb,cb) if cc>=bc and cc0 and-1 or 1;local db=self.get("step") -local _c=self.get("value")local ac=_c-ab*db +if not self:isInBounds(bb,cb)then return false end;ab=ab>0 and-1 or 1;local db=self.getResolved("step") +local _c=self.getResolved("value")local ac=_c-ab*db self.set("value",math.min(100,math.max(0,ac)))self:updateAttachedElement()return true end -function ca:render()aa.render(self)local ab=da(self)local bb=self.get("value") -local cb=self.get("handleSize")local db=self.get("symbol")local _c=self.get("symbolColor") -local ac=self.get("symbolBackgroundColor")local bc=self.get("backgroundSymbol")local cc=self.get("orientation")== -"vertical"local dc= -math.floor((bb/100)* (ab-cb))+1 -for i=1,ab do +function ca:render()aa.render(self)local ab=da(self) +local bb=self.getResolved("value")local cb=self.getResolved("handleSize") +local db=self.getResolved("symbol")local _c=self.getResolved("symbolColor") +local ac=self.getResolved("symbolBackgroundColor")local bc=self.getResolved("backgroundSymbol")local cc= +self.getResolved("orientation")=="vertical" +local dc=self.getResolved("foreground")local _d=self.getResolved("background")local ad= +math.floor((bb/100)* (ab-cb))+1;for i=1,ab do if cc then -self:blit(1,i,bc,ba[self.get("foreground")],ba[self.get("background")])else -self:blit(i,1,bc,ba[self.get("foreground")],ba[self.get("background")])end end -for i=dc,dc+cb-1 do if cc then self:blit(1,i,db,ba[_c],ba[ac])else -self:blit(i,1,db,ba[_c],ba[ac])end end end;return ca end +self:blit(1,i,bc,ba[dc],ba[_d])else self:blit(i,1,bc,ba[dc],ba[_d])end end;for i=ad,ad+cb-1 do +if cc then +self:blit(1,i,db,ba[_c],ba[ac])else self:blit(i,1,db,ba[_c],ba[ac])end end end;return ca end project["elements/VisualElement.lua"] = function(...) local ba=require("elementManager") local ca=ba.getElement("BaseElement")local da=require("libraries/colorHex") local _b=setmetatable({},ca)_b.__index=_b @@ -2688,15 +2764,16 @@ 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 +function _b:setConstraint(cb,db,_c,ac)local bc=self.getResolved("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:setLayoutConfigProperty(cb,db)local _c=self.get("layoutConfig")_c[cb]=db -self.set("layoutConfig",_c)return self end;function _b:getLayoutConfigProperty(cb) -local db=self.get("layoutConfig")return db[cb]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 +self:_addConstraintObservers(cb,bc[cb])self._constraintsDirty=true;self:updateRender()return self end +function _b:setLayoutConfigProperty(cb,db)local _c=self.getResolved("layoutConfig") +_c[cb]=db;self.set("layoutConfig",_c)return self end;function _b:getLayoutConfigProperty(cb)local db=self.getResolved("layoutConfig") +return db[cb]end +function _b:resolveAllConstraints()if +not self._constraintsDirty then return self end +local cb=self.getResolved("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,cb)end end;self._constraintsDirty=false;return self end @@ -2705,13 +2782,13 @@ 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 if _c.left then local ac=self:_resolveConstraint("left",_c.left)local bc=db-ac+1;self.set("width",bc)self.set("x",ac)else -local ac=self.get("width")self.set("x",db-ac+1)end elseif cb=="bottom"then +local ac=self.getResolved("width")self.set("x",db-ac+1)end elseif cb=="bottom"then if _c.top then local ac=self:_resolveConstraint("top",_c.top)local bc=db-ac+1;self.set("height",bc)self.set("y",ac)else -local ac=self.get("height")self.set("y",db-ac+1)end elseif cb=="centerX"then local ac=self.get("width") -self.set("x",db-math.floor(ac/2))elseif cb=="centerY"then local ac=self.get("height") -self.set("y",db-math.floor(ac/2))elseif cb=="width"then self.set("width",db)elseif cb=="height"then -self.set("height",db)end end +local ac=self.getResolved("height")self.set("y",db-ac+1)end elseif cb=="centerX"then local ac=self.getResolved("width")self.set("x",db- +math.floor(ac/2))elseif cb=="centerY"then +local ac=self.getResolved("height")self.set("y",db-math.floor(ac/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 @@ -2732,21 +2809,21 @@ 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 +function _b:removeConstraint(cb)local db=self.getResolved("constraints")db[cb]=nil self.set("constraints",db)self:updateConstraints()return self end -function _b:updateConstraints()local cb=self.get("constraints") +function _b:updateConstraints()local cb=self.getResolved("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 +self.set("y",ac)elseif db=="right"then local bc=self.getResolved("width") +self.set("x",ac-bc+1)elseif db=="bottom"then local bc=self.getResolved("height") +self.set("y",ac-bc+1)elseif db=="centerX"then local bc=self.getResolved("width")self.set("x",ac- +math.floor(bc/2))elseif db=="centerY"then +local bc=self.getResolved("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 not _c then return self.getResolved(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 @@ -2805,12 +2882,13 @@ function _b:drawBg(cb,db,_c)local ac,bc=self:calculatePosition()cb=cb+ac-1 db=db+bc-1;self.parent:drawBg(cb,db,_c)end function _b:blit(cb,db,_c,ac,bc)local cc,dc=self:calculatePosition()cb=cb+cc-1 db=db+dc-1;self.parent:blit(cb,db,_c,ac,bc)end -function _b:isInBounds(cb,db)local _c,ac=self.get("x"),self.get("y") -local bc,cc=self.get("width"),self.get("height")if(self.get("ignoreOffset"))then -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:isInBounds(cb,db) +local _c,ac=self.getResolved("x"),self.getResolved("y") +local bc,cc=self.getResolved("width"),self.getResolved("height") +if(self.getResolved("ignoreOffset"))then 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:setState("clicked") self:fireEvent("mouse_click",cb,self:getRelativePosition(db,_c))return true end;return false end @@ -2822,7 +2900,7 @@ function _b:mouse_release(cb,db,_c) 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") +local ac=self.getResolved("hover") if(self:isInBounds(db,_c))then if(not ac)then self.set("hover",true) self:fireEvent("mouse_enter",self:getRelativePosition(db,_c))end;return true else if(ac)then self.set("hover",false) @@ -2862,18 +2940,18 @@ 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 +self:resolveAllConstraints()local cb,db=self.getResolved("x"),self.getResolved("y") +if not +self.getResolved("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 -while bc do -local cc,dc=bc.get("x"),bc.get("y")_c=_c+cc-1;ac=ac+dc-1;bc=bc.parent end;return _c,ac end +function _b:getAbsolutePosition(cb,db) +local _c,ac=self.getResolved("x"),self.getResolved("y")if(cb~=nil)then _c=_c+cb-1 end;if(db~=nil)then ac=ac+db-1 end +local bc=self.parent;while bc do local cc,dc=bc.get("x"),bc.get("y")_c=_c+cc-1;ac=ac+dc-1 +bc=bc.parent end;return _c,ac end function _b:getRelativePosition(cb,db)if(cb==nil)or(db==nil)then -cb,db=self.get("x"),self.get("y")end;local _c,ac=1,1;if self.parent then +cb,db=self.getResolved("x"),self.getResolved("y")end;local _c,ac=1,1;if self.parent then _c,ac=self.parent:getRelativePosition()end -local bc,cc=self.get("x"),self.get("y")return cb- (bc-1)- (_c-1),db- (cc-1)- (ac-1)end +local bc,cc=self.getResolved("x"),self.getResolved("y")return cb- (bc-1)- (_c-1),db- (cc-1)- (ac-1)end function _b:setCursor(cb,db,_c,ac) if self.parent then local bc,cc=self:calculatePosition() if @@ -2886,8 +2964,9 @@ 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.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")] +if(not self.getResolved("backgroundEnabled"))then return end +local cb,db=self.getResolved("width"),self.getResolved("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 (bc or cc or dc or _d)then @@ -2911,36 +2990,37 @@ function aa.new()local ba=setmetatable({},aa):__init() ba.class=aa;ba.set("width",25)ba.set("height",3)return ba end;function aa:init(ba,ca)d.init(self,ba,ca) self.set("type","ProgressBar")end function aa:render()d.render(self) -local ba=self.get("width")local ca=self.get("height") -local da=math.min(100,math.max(0,self.get("progress")))local _b=math.floor((ba*da)/100) -local ab=math.floor((ca*da)/100)local bb=self.get("direction") -local cb=self.get("progressColor") +local ba=self.getResolved("width")local ca=self.getResolved("height") +local da=math.min(100,math.max(0,self.getResolved("progress")))local _b=math.floor((ba*da)/100) +local ab=math.floor((ca*da)/100)local bb=self.getResolved("direction") +local cb=self.getResolved("progressColor")local db=self.getResolved("foreground") if bb=="right"then -self:multiBlit(1,1,_b,ca," ",_a[self.get("foreground")],_a[cb])elseif bb=="left"then -self:multiBlit(ba-_b+1,1,_b,ca," ",_a[self.get("foreground")],_a[cb])elseif bb=="up"then -self:multiBlit(1,ca-ab+1,ba,ab," ",_a[self.get("foreground")],_a[cb])elseif bb=="down"then -self:multiBlit(1,1,ba,ab," ",_a[self.get("foreground")],_a[cb])end -if self.get("showPercentage")then local db=tostring(da).."%"local _c=math.floor( -(ba-#db)/2)+1 -local ac=math.floor((ca-1)/2)+1 -self:textFg(_c,ac,db,self.get("foreground"))end end;return aa end +self:multiBlit(1,1,_b,ca," ",_a[db],_a[cb])elseif bb=="left"then +self:multiBlit(ba-_b+1,1,_b,ca," ",_a[db],_a[cb])elseif bb=="up"then +self:multiBlit(1,ca-ab+1,ba,ab," ",_a[db],_a[cb])elseif bb=="down"then +self:multiBlit(1,1,ba,ab," ",_a[db],_a[cb])end +if self.getResolved("showPercentage")then local _c=tostring(da).."%"local ac=math.floor(( +ba-#_c)/2)+1;local bc= +math.floor((ca-1)/2)+1;self:textFg(ac,bc,_c,db)end end;return aa end project["elements/CheckBox.lua"] = function(...) local c=require("elements/VisualElement") local d=setmetatable({},c)d.__index=d d.defineProperty(d,"checked",{default=false,type="boolean",canTriggerRender=true}) -d.defineProperty(d,"text",{default=" ",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.get("checkedText") -local ca=math.max(#aa,#ba)if(_a.get("autoSize"))then _a.set("width",ca)end;return aa end}) -d.defineProperty(d,"checkedText",{default="x",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.get("text") -local ca=math.max(#aa,#ba)if(_a.get("autoSize"))then _a.set("width",ca)end;return aa end}) +d.defineProperty(d,"text",{default=" ",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.getResolved("checkedText")local ca=math.max(#aa, +#ba)if(_a.getResolved("autoSize"))then +_a.set("width",ca)end;return aa end}) +d.defineProperty(d,"checkedText",{default="x",type="string",canTriggerRender=true,setter=function(_a,aa)local ba=_a.getResolved("text") +local ca=math.max(#aa,#ba) +if(_a.getResolved("autoSize"))then _a.set("width",ca)end;return aa end}) d.defineProperty(d,"autoSize",{default=true,type="boolean"})d.defineEvent(d,"mouse_click") d.defineEvent(d,"mouse_up")function d.new()local _a=setmetatable({},d):__init()_a.class=d _a.set("backgroundEnabled",false)return _a end 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 +self.set("checked",not self.getResolved("checked"))return true end;return false 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")) +local ca=string.sub(_a and ba or aa,1,self.getResolved("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) @@ -2993,7 +3073,7 @@ not self._values.eventCallbacks[da]then self._values.eventCallbacks[da]={}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 +local ab=self.getResolved("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 @@ -3008,14 +3088,47 @@ 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:setState(da,_b.priority)else self:unsetState(da)end end end;return self end +function ca:registerResponsiveState(da,_b,ab)local bb=100;local cb={} +if type(ab)=="number"then bb=ab elseif type(ab)=="table"then bb= +ab.priority or 100;cb=ab.observe or{}end;local db;local _c=type(_b)=="string" +if _c then +db=self:_parseResponsiveExpression(_b)local ac=self:_detectDependencies(_b)for bc,cc in ipairs(ac)do +table.insert(cb,cc)end else db=_b end;self:registerState(da,db,bb) +for ac,bc in ipairs(cb)do +local cc=bc.element or bc[1]local dc=bc.property or bc[2]if cc and dc then +cc:observe(dc,function() +self:updateConditionalStates()end)end end;self:updateConditionalStates()return self end +function ca:_parseResponsiveExpression(da)local _b={colors=true,math=true,clamp=true,round=true} +local ab={clamp=function(ac,bc,cc)return +math.min(math.max(ac,bc),cc)end,round=function(ac) +return math.floor(ac+0.5)end,floor=math.floor,ceil=math.ceil,abs=math.abs} +da=da:gsub("([%w_]+)%.([%w_]+)",function(ac,bc) +if _b[ac]or tonumber(ac)then return ac.."."..bc end +return string.format('__getProperty("%s", "%s")',ac,bc)end)local bb=self +local cb=setmetatable({colors=colors,math=math,tostring=tostring,tonumber=tonumber,__getProperty=function(ac,bc) +if ac=="self"then +if bb._properties[bc]then return bb.get(bc)end elseif ac=="parent"then if bb.parent and bb.parent._properties[bc]then return +bb.parent.get(bc)end else +local cc=bb:getBaseFrame():getChild(ac) +if cc and cc._properties[bc]then return cc.get(bc)end end;return nil end},{__index=ab})local db,_c=load("return "..da,"responsive","t",cb) +if not db then error( +"Invalid responsive expression: ".._c)end;return +function(ac)local bc,cc=pcall(db)return bc and cc or false end end +function ca:_detectDependencies(da)local _b={} +local ab={colors=true,math=true,clamp=true,round=true} +for bb,cb in da:gmatch("([%w_]+)%.([%w_]+)")do +if not ab[bb]and not tonumber(bb)then +local db;if bb=="self"then db=self elseif bb=="parent"then db=self.parent else +db=self:getBaseFrame():getChild(bb)end;if db then +table.insert(_b,{element=db,property=cb})end end end;return _b 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 local _b;for ab,bb in ipairs(self.get("eventCallbacks")[da])do -_b=bb(self,...)end;return _b end;return self end +self.getResolved("eventCallbacks")[da]then local _b;for ab,bb in +ipairs(self.getResolved("eventCallbacks")[da])do _b=bb(self,...)end;return _b 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 +if self.getResolved("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) self:observe(da,_b)return self end function ca:getBaseFrame()if self.parent then return @@ -3037,8 +3150,8 @@ ab.set("visible",false)return ab end;function _b:init(ab,bb)ca.init(self,ab,bb) self.set("type","ContextMenu")end function _b:setItems(ab) self.set("items",ab or{})self:calculateSize()return self end -function _b:calculateSize()local ab=self.get("items") -local bb=self.get("itemHeight") +function _b:calculateSize()local ab=self.getResolved("items") +local bb=self.getResolved("itemHeight") if#ab==0 then self.set("width",10)self.set("height",2)return end;local cb=8 for _c,ac in ipairs(ab)do if ac.label then local bc=#ac.label;local cc=bc+3 if ac.submenu then cc=cc+1 end;if cc>cb then cb=cc end end end;local db=#ab*bb;self.set("width",cb) @@ -3047,51 +3160,55 @@ self.set("visible",true)self:updateRender()self:dispatchEvent("opened") return self end function _b:close() self.set("isOpen",false)self.set("visible",false) -local ab=self.get("openSubmenu")if ab and ab.menu then ab.menu:close()end +local ab=self.getResolved("openSubmenu")if ab and ab.menu then ab.menu:close()end self.set("openSubmenu",nil)self:updateRender()self:dispatchEvent("closed") return self end;function _b:closeAll()local ab=self;while ab.parentMenu do ab=ab.parentMenu end ab:close()return self end function _b:getItemAt(ab) -local bb=self.get("items")local cb=self.get("itemHeight") -local db=math.floor((ab-1)/cb)+1;if db>=1 and db<=#bb then return db,bb[db]end;return nil,nil end +local bb=self.getResolved("items")local cb=self.getResolved("itemHeight")local db= +math.floor((ab-1)/cb)+1 +if db>=1 and db<=#bb then return db,bb[db]end;return nil,nil end function _b:createSubmenu(ab,bb)local cb=self.parent:addContextMenu() cb:setItems(ab) -cb.set("background",self.get("background")) -cb.set("foreground",self.get("foreground"))cb.parentMenu=self;local db=self.get("x")local _c=self.get("y") -local ac=self.get("width")local bc=self.get("itemHeight")local cc=bb._index or 1 -cb.set("x",db+ac)cb.set("y",_c+ (cc-1)*bc) -cb.set("z",self.get("z")+1)return cb end +cb.set("background",self.getResolved("background")) +cb.set("foreground",self.getResolved("foreground"))cb.parentMenu=self;local db=self.getResolved("x") +local _c=self.getResolved("y")local ac=self.getResolved("width") +local bc=self.getResolved("itemHeight")local cc=bb._index or 1;cb.set("x",db+ac) +cb.set("y",_c+ (cc-1)*bc)cb.set("z",self.getResolved("z")+1)return +cb end function _b:mouse_click(ab,bb,cb)if not ba.mouse_click(self,ab,bb,cb)then self:close() return false end local db,_c=ba.getRelativePosition(self,bb,cb)local ac,bc=self:getItemAt(_c) if bc then if bc.disabled then return true end if bc.submenu then -local cc=self.get("openSubmenu") +local cc=self.getResolved("openSubmenu") if cc and cc.index==ac then cc.menu:close() self.set("openSubmenu",nil)else if cc and cc.menu then cc.menu:close()end;bc._index=ac local dc=self:createSubmenu(bc.submenu,bc)dc:open() self.set("openSubmenu",{index=ac,menu=dc})end;return true end;if bc.onClick then bc.onClick(bc)end;self:closeAll() return true end;return true end -function _b:render()local ab=self.get("items")local bb=self.get("width") -local cb=self.get("height")local db=self.get("itemHeight") -local _c=self.get("background")local ac=self.get("foreground") -for bc,cc in ipairs(ab)do local dc=(bc-1)*db+1;local _d= -cc.background or _c;local ad=cc.foreground or ac;local bd=da[_d] -local cd=da[ad]local dd=string.rep(" ",bb)local __a=string.rep(bd,bb) -local a_a=string.rep(cd,bb)self:blit(1,dc,dd,a_a,__a)local b_a=cc.label or""if#b_a>bb-3 then b_a=b_a:sub(1, -bb-3)end -self:textFg(2,dc,b_a,ad)if cc.submenu then self:textFg(bb-1,dc,">",ad)end end -if not self.get("childrenSorted")then self:sortChildren()end -if not self.get("childrenEventsSorted")then for bc in pairs(self._values.childrenEvents or -{})do +function _b:render()local ab=self.getResolved("items") +local bb=self.getResolved("width")local cb=self.getResolved("height") +local db=self.getResolved("itemHeight")local _c=self.getResolved("background") +local ac=self.getResolved("foreground") +for bc,cc in ipairs(ab)do local dc=(bc-1)*db+1;local _d=cc.background or _c;local ad=cc.foreground or +ac;local bd=da[_d]local cd=da[ad] +local dd=string.rep(" ",bb)local __a=string.rep(bd,bb)local a_a=string.rep(cd,bb) +self:blit(1,dc,dd,a_a,__a)local b_a=cc.label or"" +if#b_a>bb-3 then b_a=b_a:sub(1,bb-3)end;self:textFg(2,dc,b_a,ad)if cc.submenu then +self:textFg(bb-1,dc,">",ad)end end;if not self.getResolved("childrenSorted")then +self:sortChildren()end +if +not self.getResolved("childrenEventsSorted")then for bc in pairs(self._values.childrenEvents or{})do self:sortChildrenEvents(bc)end end -for bc,cc in ipairs(self.get("visibleChildren")or{})do if cc==self then -error("CIRCULAR REFERENCE DETECTED!")return end;cc:render()cc:postRender()end end;return _b end +for bc,cc in +ipairs(self.getResolved("visibleChildren")or{})do +if cc==self then error("CIRCULAR REFERENCE DETECTED!")return end;cc:render()cc:postRender()end end;return _b end project["elements/List.lua"] = function(...) local _a=require("elements/Collection") local aa=require("libraries/colorHex")local ba=setmetatable({},_a)ba.__index=ba ba.defineProperty(ba,"offset",{default=0,type="number",canTriggerRender=true,setter=function(da,_b) local ab=math.max(0,# -da.get("items")-da.get("height"))return math.min(ab,math.max(0,_b))end}) +da.getResolved("items")-da.getResolved("height"))return math.min(ab,math.max(0,_b))end}) ba.defineProperty(ba,"emptyText",{default="No items",type="string",canTriggerRender=true}) ba.defineProperty(ba,"showScrollBar",{default=true,type="boolean",canTriggerRender=true}) ba.defineProperty(ba,"scrollBarSymbol",{default=" ",type="string",canTriggerRender=true}) @@ -3108,34 +3225,36 @@ da.set("background",colors.gray)return da end function ba:init(da,_b)_a.init(self,da,_b)self._entrySchema=ca self.set("type","List") self:observe("items",function() -local ab=math.max(0,#self.get("items")-self.get("height")) -if self.get("offset")>ab then self.set("offset",ab)end end) +local ab=math.max(0,#self.getResolved("items")- +self.getResolved("height")) +if self.getResolved("offset")>ab then self.set("offset",ab)end end) self:observe("height",function() -local ab=math.max(0,#self.get("items")-self.get("height")) -if self.get("offset")>ab then self.set("offset",ab)end end)return self end +local ab=math.max(0,#self.getResolved("items")- +self.getResolved("height")) +if self.getResolved("offset")>ab then self.set("offset",ab)end end)return self end function ba:mouse_click(da,_b,ab) if _a.mouse_click(self,da,_b,ab)then -local bb,cb=self:getRelativePosition(_b,ab)local db=self.get("width")local _c=self.get("items") -local ac=self.get("height")local bc=self.get("showScrollBar") -if bc and#_c>ac and bb==db then local cc= -#_c-ac -local dc=math.max(1,math.floor((ac/#_c)*ac)) -local _d=cc>0 and(self.get("offset")/cc*100)or 0 -local ad=math.floor((_d/100)* (ac-dc))+1 -if cb>=ad and cbac and bb==db then local cc=#_c-ac +local dc=math.max(1,math.floor((ac/#_c)*ac))local _d= +cc>0 and(self.getResolved("offset")/cc*100)or 0;local ad= +math.floor((_d/100)* (ac-dc))+1 +if cb>=ad and cb +function ba:scrollToItem(da)local _b=self.getResolved("height") +local ab=self.getResolved("offset") +if da ab+_b then self.set("offset",da-_b)end;return self end function ba:key(da) -if _a.key(self,da)and self.get("selectable")then -local _b=self.get("items")local ab=self:getSelectedIndex() +if _a.key(self,da)and self.getResolved("selectable")then +local _b=self.getResolved("items")local ab=self:getSelectedIndex() if da==keys.up then self:selectPrevious()if ab and ab>1 then self:scrollToItem(ab-1)end return true elseif da==keys.down then self:selectNext()if ab and ab<#_b then self:scrollToItem(ab+1)end;return true elseif da==keys.home then self:clearItemSelection()self:selectItem(1)self:scrollToTop()return true elseif da==keys["end"]then self:clearItemSelection()self:selectItem(#_b) -self:scrollToBottom()return true elseif da==keys.pageUp then local bb=self.get("height") -local cb=math.max(1,(ab or 1)-bb)self:clearItemSelection()self:selectItem(cb) -self:scrollToItem(cb)return true elseif da==keys.pageDown then local bb=self.get("height") +self:scrollToBottom()return true elseif da==keys.pageUp then local bb=self.getResolved("height")local cb=math.max(1,( +ab or 1)-bb) +self:clearItemSelection()self:selectItem(cb)self:scrollToItem(cb)return true elseif da== +keys.pageDown then local bb=self.getResolved("height") local cb=math.min(#_b,(ab or 1)+bb)self:clearItemSelection()self:selectItem(cb) self:scrollToItem(cb)return true end end;return false end -function ba:render(da)da=da or 0;_a.render(self)local _b=self.get("items") -local ab=self.get("height")local bb=self.get("offset")local cb=self.get("width") +function ba:render(da)da=da or 0;_a.render(self) +local _b=self.getResolved("items")local ab=self.getResolved("height") +local bb=self.getResolved("offset")local cb=self.getResolved("width") local db=self.getResolved("background")local _c=self.getResolved("foreground") -local ac=self.get("showScrollBar")local bc=ac and#_b>ab;local cc=bc and cb-1 or cb +local ac=self.getResolved("showScrollBar")local bc=ac and#_b>ab;local cc=bc and cb-1 or cb if#_b==0 then -local dc=self.get("emptyText")local _d=math.floor(ab/2)+da;local ad=math.max(1, +local dc=self.getResolved("emptyText")local _d=math.floor(ab/2)+da;local ad=math.max(1, math.floor((cb-#dc)/2)+1)for i=1,ab do self:textBg(1,i,string.rep(" ",cb),db)end;if _d>=1 and _d<=ab then self:textFg(ad,_d+da,dc,colors.gray)end;return end @@ -3217,45 +3339,46 @@ 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 +local ca=_a.new(self,ba,self._entrySchema) +table.insert(self.getResolved("items"),ca)self:updateRender()return ca end +function aa:removeItem(ba)local ca=self.getResolved("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 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") +function aa:getSelectedItems()local ba={}for ca,da in ipairs(self.getResolved("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.getResolved("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.getResolved("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 +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") +function aa:unselectItem(ba)local ca=self.getResolved("items") if type(ba)=="number"then -if ca[ba]and -type(ca[ba])=="table"then ca[ba].selected=false end else +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;self:updateRender()return self end -function aa:getSelectedIndex()local ba=self.get("items") -for ca,da in ipairs(ba)do if type(da)=="table"and -da.selected then return ca end end;return nil end -function aa:selectNext()local ba=self.get("items") +function aa:clearItemSelection()local ba=self.getResolved("items")for ca,da in ipairs(ba)do +da.selected=false end;self:updateRender()return self end +function aa:getSelectedIndex()local ba=self.getResolved("items") +for ca,da in ipairs(ba)do if +type(da)=="table"and da.selected then return ca end end;return nil end +function aa:selectNext()local ba=self.getResolved("items") local ca=self:getSelectedIndex() if not ca then if#ba>0 then self:selectItem(1)end elseif ca<#ba then if not -self.get("multiSelection")then self:clearItemSelection()end;self:selectItem(ca+1)end;self:updateRender()return self end -function aa:selectPrevious()local ba=self.get("items") +self.getResolved("multiSelection")then self:clearItemSelection()end;self:selectItem(ca+1)end;self:updateRender()return self end +function aa:selectPrevious()local ba=self.getResolved("items") local ca=self:getSelectedIndex() if not ca then if#ba>0 then self:selectItem(#ba)end elseif ca>1 then if not -self.get("multiSelection")then self:clearItemSelection()end;self:selectItem(ca-1)end;self:updateRender()return self end +self.getResolved("multiSelection")then self:clearItemSelection()end;self:selectItem(ca-1)end;self:updateRender()return self end function aa:onSelect(ba)self:registerCallback("select",ba)return self end;return aa end project["elements/Accordion.lua"] = function(...) local aa=require("elementManager") local ba=require("elements/VisualElement")local ca=aa.getElement("Container") @@ -3272,84 +3395,87 @@ ab.class=_b;ab.set("width",20)ab.set("height",10)ab.set("z",10)return ab end function _b:init(ab,bb) ca.init(self,ab,bb)self.set("type","Accordion")end -function _b:newPanel(ab,bb)local cb=self.get("panels")or{}local db=#cb+1 -local _c=self:addContainer()_c.set("x",1)_c.set("y",1) -_c.set("width",self.get("width"))_c.set("height",self.get("height")) -_c.set("visible",bb or false)_c.set("ignoreOffset",true) -table.insert(cb,{id=db,title=tostring(ab or("Panel "..db)),expanded= -bb or false,container=_c})self.set("panels",cb)self:updatePanelLayout()return _c end;_b.addPanel=_b.newPanel +function _b:newPanel(ab,bb)local cb=self.getResolved("panels")or{} +local db=#cb+1;local _c=self:addContainer()_c.set("x",1)_c.set("y",1) +_c.set("width",self.getResolved("width")) +_c.set("height",self.getResolved("height"))_c.set("visible",bb or false) +_c.set("ignoreOffset",true) +table.insert(cb,{id=db,title=tostring(ab or("Panel "..db)),expanded=bb or false,container=_c})self.set("panels",cb)self:updatePanelLayout()return _c end;_b.addPanel=_b.newPanel function _b:updatePanelLayout() -local ab=self.get("panels")or{}local bb=self.get("panelHeaderHeight")or 1;local cb=1 -local db=self.get("width")local _c=self.get("height") -for dc,_d in ipairs(ab)do local ad=cb+bb -_d.container.set("x",1)_d.container.set("y",ad) -_d.container.set("width",db)_d.container.set("visible",_d.expanded) -_d.container.set("ignoreOffset",false)cb=cb+bb -if _d.expanded then local bd=0 +local ab=self.getResolved("panels")or{} +local bb=self.getResolved("panelHeaderHeight")or 1;local cb=1;local db=self.getResolved("width") +local _c=self.getResolved("height") +for dc,_d in ipairs(ab)do local ad=cb+bb;_d.container.set("x",1) +_d.container.set("y",ad)_d.container.set("width",db) +_d.container.set("visible",_d.expanded)_d.container.set("ignoreOffset",false)cb=cb+bb +if +_d.expanded then local bd=0 for dd,__a in ipairs(_d.container._values.children or{})do if not __a._destroyed then local a_a=__a.get("y")local b_a=__a.get("height")local c_a= a_a+b_a-1;if c_a>bd then bd=c_a end end end;local cd=math.max(1,bd)_d.container.set("height",cd)cb= cb+cd end end;local ac=cb-1;local bc=math.max(0,ac-_c) -local cc=self.get("offsetY")if cc>bc then self.set("offsetY",bc)end +local cc=self.getResolved("offsetY")if cc>bc then self.set("offsetY",bc)end self:updateRender()end -function _b:togglePanel(ab)local bb=self.get("panels")or{} -local cb=self.get("allowMultiple") +function _b:togglePanel(ab)local bb=self.getResolved("panels")or{} +local cb=self.getResolved("allowMultiple") for db,_c in ipairs(bb)do if _c.id==ab then _c.expanded=not _c.expanded if not cb and _c.expanded then for ac,bc in ipairs(bb)do if ac~=db then bc.expanded=false end end end;self:updatePanelLayout() self:dispatchEvent("panelToggled",ab,_c.expanded)break end end;return self end -function _b:expandPanel(ab)local bb=self.get("panels")or{} -local cb=self.get("allowMultiple") +function _b:expandPanel(ab)local bb=self.getResolved("panels")or{} +local cb=self.getResolved("allowMultiple") for db,_c in ipairs(bb)do if _c.id==ab then if not _c.expanded then _c.expanded=true if not cb then for ac,bc in ipairs(bb)do if ac~=db then bc.expanded=false end end end;self:updatePanelLayout() self:dispatchEvent("panelToggled",ab,true)end;break end end;return self end -function _b:collapsePanel(ab)local bb=self.get("panels")or{} -for cb,db in ipairs(bb)do -if db.id==ab then if -db.expanded then db.expanded=false;self:updatePanelLayout() +function _b:collapsePanel(ab)local bb=self.getResolved("panels")or{} +for cb,db in +ipairs(bb)do +if db.id==ab then if db.expanded then db.expanded=false;self:updatePanelLayout() self:dispatchEvent("panelToggled",ab,false)end;break end end;return self end -function _b:getPanel(ab)local bb=self.get("panels")or{}for cb,db in ipairs(bb)do if db.id==ab then return -db.container end end;return nil end -function _b:_getPanelMetrics()local ab=self.get("panels")or{}local bb= -self.get("panelHeaderHeight")or 1;local cb={}local db=1 +function _b:getPanel(ab)local bb=self.getResolved("panels")or{} +for cb,db in +ipairs(bb)do if db.id==ab then return db.container end end;return nil end +function _b:_getPanelMetrics()local ab=self.getResolved("panels")or{}local bb= +self.getResolved("panelHeaderHeight")or 1;local cb={}local db=1 for _c,ac in ipairs(ab)do table.insert(cb,{id=ac.id,title=ac.title,expanded=ac.expanded,headerY=db,headerHeight=bb})db=db+bb;if ac.expanded then db=db+ac.container.get("height")end end;return{positions=cb,totalHeight=db-1}end function _b:mouse_click(ab,bb,cb) if not ba.mouse_click(self,ab,bb,cb)then return false end;local db,_c=ba.getRelativePosition(self,bb,cb) -local ac=self.get("offsetY")local bc=_c+ac;local cc=self:_getPanelMetrics() +local ac=self.getResolved("offsetY")local bc=_c+ac;local cc=self:_getPanelMetrics() for dc,_d in ipairs(cc.positions)do local ad= _d.headerY+_d.headerHeight-1;if bc>=_d.headerY and bc<=ad then self:togglePanel(_d.id) self.set("focusedChild",nil)return true end end;return ca.mouse_click(self,ab,bb,cb)end function _b:mouse_scroll(ab,bb,cb) if ba.mouse_scroll(self,ab,bb,cb)then -local db=self:_getPanelMetrics()local _c=self.get("height")local ac=db.totalHeight +local db=self:_getPanelMetrics()local _c=self.getResolved("height")local ac=db.totalHeight local bc=math.max(0,ac-_c) -if bc>0 then local cc=self.get("offsetY")local dc=cc+ab +if bc>0 then local cc=self.getResolved("offsetY")local dc=cc+ab dc=math.max(0,math.min(bc,dc))self.set("offsetY",dc)return true end;return ca.mouse_scroll(self,ab,bb,cb)end;return false end -function _b:render()ba.render(self)local ab=self.get("width") -local bb=self.get("offsetY")local cb=self:_getPanelMetrics() +function _b:render()ba.render(self)local ab=self.getResolved("width") +local bb=self.getResolved("offsetY")local cb=self:_getPanelMetrics() for db,_c in ipairs(cb.positions)do local ac=_c.expanded and -self.get("expandedHeaderBackground")or self.get("headerBackground") -local bc=_c.expanded and self.get("expandedHeaderTextColor")or -self.get("headerTextColor")local cc=_c.headerY-bb +self.getResolved("expandedHeaderBackground")or self.getResolved("headerBackground") +local bc= +_c.expanded and self.getResolved("expandedHeaderTextColor")or self.getResolved("headerTextColor")local cc=_c.headerY-bb if -cc>=1 and cc<=self.get("height")then +cc>=1 and cc<=self.getResolved("height")then ba.multiBlit(self,1,cc,ab,_c.headerHeight," ",da[bc],da[ac])local dc=_c.expanded and"v"or">" -local _d=dc.." ".._c.title;ba.textFg(self,1,cc,_d,bc)end end -if not self.get("childrenSorted")then self:sortChildren()end -if not self.get("childrenEventsSorted")then for db in pairs(self._values.childrenEvents or -{})do +local _d=dc.." ".._c.title;ba.textFg(self,1,cc,_d,bc)end end;if not self.getResolved("childrenSorted")then +self:sortChildren()end +if +not self.getResolved("childrenEventsSorted")then for db in pairs(self._values.childrenEvents or{})do self:sortChildrenEvents(db)end end -for db,_c in ipairs(self.get("visibleChildren")or{})do if _c==self then -error("CIRCULAR REFERENCE DETECTED!")return end;_c:render()_c:postRender()end end;return _b end +for db,_c in +ipairs(self.getResolved("visibleChildren")or{})do +if _c==self then error("CIRCULAR REFERENCE DETECTED!")return end;_c:render()_c:postRender()end end;return _b 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) @@ -3991,6 +4117,44 @@ 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["plugins/responsive.lua"] = function(...) local c=require("errorManager")local d={} +function d:responsive() +local _a={_element=self,_rules={},_currentStateName=nil,_currentCondition=nil,_stateCounter=0} +function _a:when(aa) +if self._currentCondition then c.header="Responsive Builder Error" +c.error("Previous when() must be followed by apply() before starting a new when()")end;self._stateCounter=self._stateCounter+1;self._currentStateName="__responsive_".. +self._stateCounter;self._currentCondition=aa;return +self end +function _a:apply(aa)if not self._currentCondition then c.header="Responsive Builder Error" +c.error("apply() must follow a when() call")end;if +type(aa)~="table"then c.header="Responsive Builder Error" +c.error("apply() requires a table of properties")end +self._element:registerResponsiveState(self._currentStateName,self._currentCondition,100) +for ba,ca in pairs(aa)do +local da=ba:sub(1,1):upper()..ba:sub(2)local _b="set"..da.."State" +if self._element[_b]then +self._element[_b](self._element,self._currentStateName,ca)else c.header="Responsive Builder Error" +c.error("Unknown property: "..ba)end end +table.insert(self._rules,{stateName=self._currentStateName,condition=self._currentCondition,properties=aa})self._currentCondition=nil;self._currentStateName=nil;return self end +function _a:otherwise(aa)if self._currentCondition then c.header="Responsive Builder Error" +c.error("otherwise() cannot be used after when() without apply()")end;if type(aa)~= +"table"then c.header="Responsive Builder Error" +c.error("otherwise() requires a table of properties")end;self._stateCounter= +self._stateCounter+1 +local ba="__responsive_otherwise_"..self._stateCounter;local ca={} +for _b,ab in ipairs(self._rules)do table.insert(ca,ab.condition)end;local da +if type(ca[1])=="string"then local _b={}for ab,bb in ipairs(ca)do +table.insert(_b,"not ("..bb..")")end;da=table.concat(_b," and ")else +da=function(_b)for ab,bb in +ipairs(ca)do if bb(_b)then return false end end;return true end end +self._element:registerResponsiveState(ba,da,50) +for _b,ab in pairs(aa)do +local bb=_b:sub(1,1):upper().._b:sub(2)local cb="set"..bb.."State"if self._element[cb]then +self._element[cb](self._element,ba,ab)else c.header="Responsive Builder Error" +c.error("Unknown property: ".._b)end end;return self end +function _a:done()if self._currentCondition then c.header="Responsive Builder Error" +c.error("Unfinished when() without apply()")end +return self._element end;return _a end;return{BaseElement=d} end 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 "..