Enhance documentation for ScrollFrame and TabControl elements with usage examples

Author: NoryiE

src/elements/ScrollFrame.lua

@@ -4,14 +4,91 @@ local tHex = require("libraries/colorHex")
 ---@configDescription A scrollable container that automatically displays scrollbars when content overflows.
 
 --- A container that provides automatic scrolling capabilities with visual scrollbars. Displays vertical and/or horizontal scrollbars when child content exceeds the container's dimensions.
+--- @run [[
+--- local basalt = require("basalt")
+--- 
+--- local main = basalt.getMainFrame()
+--- 
+--- -- Create a ScrollFrame with content larger than the frame
+--- local scrollFrame = main:addScrollFrame({
+---     x = 2,
+---     y = 2,
+---     width = 30,
+---     height = 12,
+---     background = colors.lightGray
+--- })
+--- 
+--- -- Add a title
+--- scrollFrame:addLabel({
+---     x = 2,
+---     y = 1,
+---     text = "ScrollFrame Example",
+---     foreground = colors.yellow
+--- })
+--- 
+--- -- Add multiple labels that exceed the frame height
+--- for i = 1, 20 do
+---     scrollFrame:addLabel({
+---         x = 2,
+---         y = i + 2,
+---         text = "Line " .. i .. " - Scroll to see more",
+---         foreground = i % 2 == 0 and colors.white or colors.lightGray
+---     })
+--- end
+--- 
+--- -- Add some interactive buttons at different positions
+--- scrollFrame:addButton({
+---     x = 2,
+---     y = 24,
+---     width = 15,
+---     height = 3,
+---     text = "Button 1",
+---     background = colors.blue
+--- })
+--- :onClick(function()
+---     scrollFrame:addLabel({
+---         x = 18,
+---         y = 24,
+---         text = "Clicked!",
+---         foreground = colors.lime
+---     })
+--- end)
+--- 
+--- scrollFrame:addButton({
+---     x = 2,
+---     y = 28,
+---     width = 15,
+---     height = 3,
+---     text = "Button 2",
+---     background = colors.green
+--- })
+--- :onClick(function()
+---     scrollFrame:addLabel({
+---         x = 18,
+---         y = 28,
+---         text = "Nice!",
+---         foreground = colors.orange
+---     })
+--- end)
+--- 
+--- -- Info label outside the scroll frame
+--- main:addLabel({
+---     x = 2,
+---     y = 15,
+---     text = "Use mouse wheel to scroll!",
+---     foreground = colors.gray
+--- })
+--- 
+--- basalt.run()
+--- ]]
 ---@class ScrollFrame : Container
 local ScrollFrame = setmetatable({}, Container)
 ScrollFrame.__index = ScrollFrame
 
 ---@property showScrollBar boolean true Whether to show scrollbars
 ScrollFrame.defineProperty(ScrollFrame, "showScrollBar", {default = true, type = "boolean", canTriggerRender = true})
 
----@property scrollBarSymbol string " " The symbol used for the scrollbar handle
+---@property scrollBarSymbol string "_" The symbol used for the scrollbar handle
 ScrollFrame.defineProperty(ScrollFrame, "scrollBarSymbol", {default = " ", type = "string", canTriggerRender = true})
 
 ---@property scrollBarBackground string "\127" The symbol used for the scrollbar background

src/elements/TabControl.lua

@@ -8,7 +8,7 @@ local log = require("log")
 --- The TabControl is a container that provides tabbed interface functionality
 --- @run [[
 --- local basalt = require("basalt")
-
+---
 --- local main = basalt.getMainFrame()
 --- 
 --- -- Create a simple TabControl