Docs Update

src/elements/ProgressBar.lua

@@ -1,16 +1,22 @@
 local VisualElement = require("elements/VisualElement")
 
+--- This is the progress bar class. It provides a visual representation of progress
+--- with optional percentage display and customizable colors.
 ---@class ProgressBar : VisualElement
 local ProgressBar = setmetatable({}, VisualElement)
 ProgressBar.__index = ProgressBar
 
----@property progress number Current progress (0-100)
+---@property progress number 0 Current progress value (0-100)
 ProgressBar.defineProperty(ProgressBar, "progress", {default = 0, type = "number", canTriggerRender = true})
----@property showPercentage boolean Show percentage text
+---@property showPercentage boolean false Whether to show the percentage text in the center
 ProgressBar.defineProperty(ProgressBar, "showPercentage", {default = false, type = "boolean"})
----@property progressColor color Progress bar color
+---@property progressColor color lime The color used for the filled portion of the progress bar
 ProgressBar.defineProperty(ProgressBar, "progressColor", {default = colors.lime, type = "number"})
 
+--- Creates a new ProgressBar instance
+--- @shortDescription Creates a new ProgressBar instance
+--- @return ProgressBar self The newly created ProgressBar instance
+--- @usage local progressBar = ProgressBar.new()
 function ProgressBar.new()
     local self = setmetatable({}, ProgressBar):__init()
     self.set("width", 10)
@@ -18,11 +24,18 @@ function ProgressBar.new()
     return self
 end
 
+--- Initializes the ProgressBar instance
+--- @shortDescription Initializes the ProgressBar instance
+--- @param props table The properties to initialize the element with
+--- @param basalt table The basalt instance
+--- @return ProgressBar self The initialized instance
 function ProgressBar:init(props, basalt)
     VisualElement.init(self, props, basalt)
     self.set("type", "ProgressBar")
 end
 
+--- Renders the ProgressBar
+--- @shortDescription Renders the progress bar with filled portion and optional percentage text
 function ProgressBar:render()
     VisualElement.render(self)
     local width = self.get("width")