updated type hints and comments

graphics/elements/controls/App.lua

@@ -20,7 +20,7 @@ local MOUSE_CLICK = core.events.MOUSE_CLICK
 ---@field fg_bg? cpair foreground/background colors
 ---@field hidden? boolean true to hide on initial draw
 
--- Create a new 'app' style button control element, like on a phone.
+-- Create a new app icon style button control element, like on a mobile device.
 ---@param args app_button_args
 ---@return App element, element_id id
 return function (args)

graphics/elements/controls/Radio2D.lua

@@ -23,7 +23,7 @@ local element = require("graphics.element")
 ---@field fg_bg? cpair foreground/background colors
 ---@field hidden? boolean true to hide on initial draw
 
--- Create a new 2D radio button list control element (latch selection, exclusively one color at a time).
+-- Create a new 2-dimensional (rows and columns of options) radio button list control element (latch selection, exclusively one color at a time).
 ---@param args radio_2d_args
 ---@return Radio2D element, element_id id
 return function (args)

graphics/elements/indicators/CoreMap.lua

@@ -13,7 +13,7 @@ local element = require("graphics.element")
 ---@field x? integer 1 if omitted
 ---@field y? integer auto incremented if omitted
 
--- Create a new core map box element.
+-- Create a new core map diagram indicator element.
 ---@nodiscard
 ---@param args core_map_args
 ---@return CoreMap element, element_id id