#84 improved element creation process for adding children

graphics/elements/controls/push_button.lua

@@ -10,6 +10,7 @@ local element = require("graphics.element")
 ---@field min_width? integer text length + 2 if omitted
 ---@field active_fg_bg? cpair foreground/background colors when pressed
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field height? integer parent height if omitted
@@ -17,6 +18,7 @@ local element = require("graphics.element")
 
 -- new push button
 ---@param args push_button_args
+---@return graphics_element element, element_id id
 local function push_button(args)
     assert(type(args.text) == "string", "graphics.elements.controls.push_button: text is a required field")
     assert(type(args.callback) == "function", "graphics.elements.controls.push_button: callback is a required field")
@@ -61,7 +63,7 @@ local function push_button(args)
         args.callback()
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return push_button

graphics/elements/controls/scram_button.lua

@@ -9,12 +9,14 @@ local element = require("graphics.element")
 ---@class scram_button_args
 ---@field callback function function to call on touch
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field fg_bg? cpair foreground/background colors
 
 -- new scram button
 ---@param args scram_button_args
+---@return graphics_element element, element_id id
 local function scram_button(args)
     assert(type(args.callback) == "function", "graphics.elements.controls.scram_button: callback is a required field")
 
@@ -63,7 +65,7 @@ local function scram_button(args)
         args.callback()
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return scram_button

graphics/elements/controls/spinbox_numeric.lua

@@ -9,12 +9,14 @@ local util    = require("scada-common.util")
 ---@field fractional_precision integer number of fractional digits
 ---@field arrow_fg_bg cpair arrow foreground/background colors
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field fg_bg? cpair foreground/background colors
 
 -- new spinbox control (minimum value is 0)
 ---@param args spinbox_args
+---@return graphics_element element, element_id id
 local function spinbox(args)
     -- properties
     local value = args.default or 0.0
@@ -110,7 +112,7 @@ local function spinbox(args)
     ---@return number|integer
     function e.get_value() return value end
 
-    return e.get()
+    return e.complete()
 end
 
 return spinbox

graphics/elements/controls/switch_button.lua

@@ -9,6 +9,7 @@ local element = require("graphics.element")
 ---@field min_width? integer text length + 2 if omitted
 ---@field active_fg_bg cpair foreground/background colors when pressed
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field height? integer parent height if omitted
@@ -16,6 +17,7 @@ local element = require("graphics.element")
 
 -- new switch button (latch high/low)
 ---@param args switch_button_args
+---@return graphics_element element, element_id id
 local function switch_button(args)
     assert(type(args.text) == "string", "graphics.elements.controls.switch_button: text is a required field")
     assert(type(args.callback) == "function", "graphics.elements.controls.switch_button: callback is a required field")
@@ -71,7 +73,7 @@ local function switch_button(args)
         args.callback(state)
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return switch_button

graphics/elements/displaybox.lua

@@ -15,7 +15,7 @@ local element = require("graphics.element")
 ---@param args displaybox_args
 local function displaybox(args)
     -- create new graphics element base object
-    return element.new(args).get()
+    return element.new(args).complete()
 end
 
 return displaybox

graphics/elements/div.lua

@@ -4,6 +4,7 @@ local element = require("graphics.element")
 
 ---@class div_args
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -13,9 +14,10 @@ local element = require("graphics.element")
 
 -- new div element
 ---@param args div_args
+---@return graphics_element element, element_id id
 local function div(args)
     -- create new graphics element base object
-    return element.new(args).get()
+    return element.new(args).complete()
 end
 
 return div

graphics/elements/indicators/data.lua

@@ -35,6 +35,7 @@ end
 ---@field lu_colors? cpair label foreground color (a), unit foreground color (b)
 ---@field value any default value
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width integer length
@@ -42,6 +43,7 @@ end
 
 -- new data indicator
 ---@param args data_indicator_args
+---@return graphics_element element, element_id id
 local function data(args)
     assert(type(args.label) == "string", "graphics.elements.indicators.data: label is a required field")
     assert(type(args.format) == "string", "graphics.elements.indicators.data: format is a required field")
@@ -91,7 +93,7 @@ local function data(args)
     -- initial value draw
     e.on_update(args.value)
 
-    return e.get()
+    return e.complete()
 end
 
 return data

graphics/elements/indicators/hbar.lua

@@ -8,6 +8,7 @@ local element = require("graphics.element")
 ---@field show_percent? boolean whether or not to show the percent
 ---@field bar_fg_bg? cpair bar foreground/background colors if showing percent
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -17,6 +18,8 @@ local element = require("graphics.element")
 
 -- new horizontal bar
 ---@param args hbar_args
+---@return graphics_element element, element_id id
+---@return graphics_element element, element_id id
 local function hbar(args)
     -- properties/state
     local last_num_bars = -1
@@ -96,7 +99,7 @@ local function hbar(args)
     -- initialize to 0
     e.on_update(0)
 
-    return e.get()
+    return e.complete()
 end
 
 return hbar

graphics/elements/indicators/icon.lua

@@ -14,12 +14,14 @@ local element = require("graphics.element")
 ---@field value? integer default state, defaults to 1
 ---@field min_label_width? integer label length if omitted
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field fg_bg? cpair foreground/background colors
 
 -- new icon indicator
 ---@param args icon_indicator_args
+---@return graphics_element element, element_id id
 local function icon(args)
     assert(type(args.label) == "string", "graphics.elements.indicators.icon: label is a required field")
     assert(type(args.states) == "table", "graphics.elements.indicators.icon: states is a required field")
@@ -60,7 +62,7 @@ local function icon(args)
     -- initial icon draw
     e.on_update(args.value or 1)
 
-    return e.get()
+    return e.complete()
 end
 
 return icon

graphics/elements/indicators/light.lua

@@ -9,12 +9,14 @@ local element = require("graphics.element")
 ---@field colors cpair on/off colors (a/b respectively)
 ---@field min_label_width? integer label length if omitted
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field fg_bg? cpair foreground/background colors
 
 -- new indicator light
 ---@param args indicator_light_args
+---@return graphics_element element, element_id id
 local function indicator_light(args)
     assert(type(args.label) == "string", "graphics.elements.indicators.light: label is a required field")
     assert(type(args.colors) == "table", "graphics.elements.indicators.light: colors is a required field")
@@ -43,7 +45,7 @@ local function indicator_light(args)
     e.on_update(false)
     e.window.write(args.label)
 
-    return e.get()
+    return e.complete()
 end
 
 return indicator_light

graphics/elements/indicators/state.lua

@@ -13,6 +13,7 @@ local element = require("graphics.element")
 ---@field value? integer default state, defaults to 1
 ---@field min_width? integer max state text length if omitted
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field height? integer 1 if omitted, must be an odd number
@@ -20,6 +21,7 @@ local element = require("graphics.element")
 
 -- new state indicator
 ---@param args state_indicator_args
+---@return graphics_element element, element_id id
 local function state_indicator(args)
     assert(type(args.states) == "table", "graphics.elements.indicators.state: states is a required field")
 
@@ -70,7 +72,7 @@ local function state_indicator(args)
     -- initial draw
     e.on_update(args.value or 1)
 
-    return e.get()
+    return e.complete()
 end
 
 return state_indicator

graphics/elements/indicators/vbar.lua

@@ -6,6 +6,7 @@ local element = require("graphics.element")
 
 ---@class vbar_args
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -15,6 +16,7 @@ local element = require("graphics.element")
 
 -- new vertical bar
 ---@param args vbar_args
+---@return graphics_element element, element_id id
 local function vbar(args)
     -- properties/state
     local last_num_bars = -1
@@ -76,7 +78,7 @@ local function vbar(args)
         end
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return vbar

graphics/elements/pipenet.lua

@@ -6,14 +6,16 @@ local core    = require("graphics.core")
 local element = require("graphics.element")
 
 ---@class pipenet_args
----@field parent graphics_element
----@field x? integer 1 if omitted
----@field y? integer 1 if omitted
 ---@field pipes table pipe list
 ---@field bg? color background color
+---@field parent graphics_element
+---@field id? string element id
+---@field x? integer 1 if omitted
+---@field y? integer 1 if omitted
 
 -- new pipe network
 ---@param args pipenet_args
+---@return graphics_element element, element_id id
 local function pipenet(args)
     assert(type(args.pipes) == "table", "graphics.elements.indicators.pipenet: pipes is a required field")
 
@@ -139,7 +141,7 @@ local function pipenet(args)
 
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return pipenet

graphics/elements/rectangle.lua

@@ -7,6 +7,7 @@ local element = require("graphics.element")
 ---@class rectangle_args
 ---@field border? graphics_border
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -16,6 +17,7 @@ local element = require("graphics.element")
 
 -- new rectangle
 ---@param args rectangle_args
+---@return graphics_element element, element_id id
 local function rectangle(args)
     -- offset children
     if args.border ~= nil then
@@ -108,7 +110,7 @@ local function rectangle(args)
         end
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return rectangle

graphics/elements/textbox.lua

@@ -9,8 +9,9 @@ local TEXT_ALIGN = core.graphics.TEXT_ALIGN
 
 ---@class textbox_args
 ---@field text string text to show
----@field parent graphics_element
 ---@field alignment? TEXT_ALIGN text alignment, left by default
+---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -20,6 +21,7 @@ local TEXT_ALIGN = core.graphics.TEXT_ALIGN
 
 -- new text box
 ---@param args textbox_args
+---@return graphics_element element, element_id id
 local function textbox(args)
     assert(type(args.text) == "string", "graphics.elements.textbox: text is a required field")
 
@@ -50,7 +52,7 @@ local function textbox(args)
         e.window.write(lines[i])
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return textbox

graphics/elements/tiling.lua

@@ -9,6 +9,7 @@ local element = require("graphics.element")
 ---@field even? boolean whether to account for rectangular pixels
 ---@field border_c? color optional frame color
 ---@field parent graphics_element
+---@field id? string element id
 ---@field x? integer 1 if omitted
 ---@field y? integer 1 if omitted
 ---@field width? integer parent width if omitted
@@ -18,6 +19,7 @@ local element = require("graphics.element")
 
 -- new tiling box
 ---@param args tiling_args
+---@return graphics_element element, element_id id
 local function tiling(args)
     assert(type(args.fill_c) == "table", "graphics.elements.tiling: fill_c is a required field")
 
@@ -77,7 +79,7 @@ local function tiling(args)
         end
     end
 
-    return e.get()
+    return e.complete()
 end
 
 return tiling