Update code docs

Author: jellyrock-bot

docs/components_data_SceneManager.bs.html

@@ -299,7 +299,13 @@
   dialog.observeField("buttonSelected", "optionSelected")
   dialog.observeField("wasClosed", "optionClosed")
   dialog.title = title
-  dialog.message = message
+  if message = invalid
+    dialog.message = invalid
+  else if type(message) = "roArray"
+    dialog.message = message
+  else
+    dialog.message = [message]
+  end if
   dialog.buttons = buttons
 
   m.scene.dialog = dialog

docs/components_keyboards_HexKeyboard.bs.html

@@ -33,6 +33,7 @@
 
   m.hexSetting.observeField("submit", "onHexKeyGridSubmit")
   m.hexSetting.observeField("escape", "onHexKeyGridEscape")
+  m.hexSetting.observeField("reset", "onHexResetRequested")
 
   m.settingsMenu.setFocus(true)
   m.settingsMenu.observeField("itemFocused", "settingFocused")
@@ -91,6 +92,51 @@
   end if
 end sub
 
+' Called when reset button is selected in HexKeyboard
+sub onHexResetRequested()
+  m.global.sceneManager.callFunc("optionDialog", tr("Reset Setting"), tr("Are you sure? This will reset the setting to its default value."), [tr("Yes"), tr("No")])
+  m.global.sceneManager.observeFieldScoped("dataReturned", "onResetDialogResponse")
+end sub
+
+' Handle user response from reset confirmation dialog
+sub onResetDialogResponse()
+  m.global.sceneManager.unobserveFieldScoped("dataReturned")
+
+  returnData = m.global.sceneManager.returnData
+  if not isValid(returnData) then return
+
+  ' User selected "No" or closed dialog
+  if returnData.indexSelected <> 0
+    m.hexSetting.findNode("resetButton").setFocus(true)
+    return
+  end if
+
+  ' User confirmed reset - get default value from config tree
+  selectedSetting = m.userLocation.peek().children[m.settingsMenu.itemFocused]
+  configEntry = findConfigTreeKey(selectedSetting.settingName, m.configTree)
+
+  if not isValid(configEntry) or not isValid(configEntry.default)
+    m.log.warn("Could not find default value for setting", selectedSetting.settingName)
+    m.hexSetting.findNode("resetButton").setFocus(true)
+    return
+  end if
+
+  defaultValue = configEntry.default
+
+  ' Track if theme color changed (requires UI refresh on exit)
+  if selectedSetting.settingName.left(12) = "uiThemeColor"
+    m.themeColorsChanged = true
+  end if
+
+  ' Update node field - observer handles registry persistence
+  user.settings.Save(selectedSetting.settingName, defaultValue)
+
+  ' Update the UI
+  m.hexSetting.text = defaultValue
+
+  m.hexSetting.findNode("resetButton").setFocus(true)
+end sub
+
 sub LoadMenu(configSection)
   if not isValid(configSection.children)
     ' Load parent menu

docs/components_settings_settings.bs.html

@@ -9,6 +9,7 @@
 
   m.top.observeField("enabled", "onEnabledChanged")
   m.top.observeField("background", "onBackgroundChanged")
+  m.top.observeField("border", "onBorderChanged")
   m.top.observeField("textColor", "onTextColorChanged")
   m.top.observeField("text", "onTextChanged")
   m.top.observeField("padding", "onPaddingChanged")
@@ -28,6 +29,7 @@
 
   ' Set default colors
   m.top.background = constants.colorBackgroundSecondary
+  m.top.border = constants.colorBackgroundSecondary
   m.top.textColor = constants.colorTextPrimary
   m.top.focusBorder = constants.colorPrimary
   m.top.focusBackground = constants.colorBackgroundSecondary
@@ -36,32 +38,38 @@
 
 sub onFocusChanged()
   if m.top.hasFocus()
-    ' Button border - change to focus color
     if m.top.enableBorder
       m.buttonBorder.blendColor = m.top.focusBorder
     else
-      ' Border disabled - ensure it stays invisible
       m.buttonBorder.blendColor = m.top.background
     end if
-    ' Button background
     m.buttonBackground.blendColor = m.top.focusBackground
-    ' Button text
     m.buttonText.color = m.top.textFocusColor
   else
-    ' Button border - match background color
-    m.buttonBorder.blendColor = m.top.background
-    ' Button background
+    if m.top.enableBorder
+      m.buttonBorder.blendColor = m.top.border
+    else
+      m.buttonBorder.blendColor = m.top.background
+    end if
     m.buttonBackground.blendColor = m.top.background
-    ' Button text
     m.buttonText.color = m.top.textColor
   end if
 end sub
 
 sub onBackgroundChanged()
   m.buttonBackground.blendColor = m.top.background
-  ' Border matches background when not focused OR when borders are disabled
-  if not m.top.hasFocus() or not m.top.enableBorder
-    m.buttonBorder.blendColor = m.top.background
+  if not m.top.hasFocus()
+    if m.top.enableBorder
+      m.buttonBorder.blendColor = m.top.border
+    else
+      m.buttonBorder.blendColor = m.top.background
+    end if
+  end if
+end sub
+
+sub onBorderChanged()
+  if not m.top.hasFocus() and m.top.enableBorder
+    m.buttonBorder.blendColor = m.top.border
   end if
 end sub
 
@@ -126,7 +134,15 @@
 
   setFocusBorderSize()
 
-  ' Show the button now that it's properly sized
+  ' Apply initial colors before showing
+  m.buttonBackground.blendColor = m.top.background
+  m.buttonText.color = m.top.textColor
+  if m.top.enableBorder
+    m.buttonBorder.blendColor = m.top.border
+  else
+    m.buttonBorder.blendColor = m.top.background
+  end if
+
   m.buttonBackground.visible = true
   m.buttonBorder.visible = true
   m.buttonText.visible = true
@@ -156,9 +172,11 @@
 
   if m.top.enabled
     m.top.background = constants.colorBackgroundSecondary
+    m.top.border = constants.colorBackgroundSecondary
     m.top.textColor = constants.colorTextPrimary
   else
     m.top.background = constants.colorBackgroundPrimary
+    m.top.border = constants.colorBackgroundPrimary
     m.top.textColor = constants.colorTextDisabled
   end if
 end sub