GUI builder

• All element methods return self for chaining, and error() if no current category/tab is selected.
• Every keyed widget auto-registers its config default via volvox.Config:SetDefault(key, default) at declaration time, and auto-wires load (Config:Read) / save (Config:Write) at render time.
• All text / tooltip strings are localized via AceLocale when available.
• Non-header elements are packed two per row; headers break rows, span the full width, and act as section dividers with Theme.spacing.sectionGap extra room above them (except at the top of a page). Widgets that carry a TOP label (editbox, slider, doubleslider, dropdown) reserve Theme.spacing.labelGap headroom in their row. Tooltip attachment skips FontString labels because only frame widgets support SetScript.
• Each :Tab() becomes a sidebar sub-page in the settings window: the category’s createLayout() returns a { multiPage = true, name, pages = { { name, layout } } } descriptor, and Interface/Default.lua renders one indented sidebar entry per page under an uppercase group label. There is no nested tab strip. Deferred page-building callbacks capture their element definition per iteration, so each row renders and binds the widget declared for that row.

​

Structure

---@return table instance
GuiBuilder:New()

---@param name string
---@param order? number   -- default 100
---@return table self
GuiBuilder:Category(name, order)

---@param name string
---@return table self
GuiBuilder:Tab(name)

​

Example

local gui = volvox.GuiBuilder:New()

gui:Category("MyFeature", 50)
  :Tab("General")
  :Header({ text = "Behavior" })
  :Checkbox({
    text = "Enable widget",
    key = "myfeature.enabled",
    default = false,
    tooltip = "Turns the widget on.",
    onChange = function(self, checked)
      volvox:LogInfo("Widget: " .. tostring(checked))
    end,
  })
  :Slider({
    text = "Threshold",
    key = "myfeature.threshold",
    min = 0, max = 100, step = 5, default = 25,
  })
  :Dropdown({
    text = "Mode",
    key = "myfeature.mode",
    options = {
      { text = "Fast", value = "fast" },
      { text = "Safe", value = "safe" },
    },
    default = "safe",
  })

​

Widgets

​

Category restoration

GuiBuilder.RestoreInterfaceCategories()   -- dot call

​

Color helpers