refactor(api)!: one namespace per feature, screen split out

Namespaces were shared across features: `settings` was written by core, the panel and touch, and `input` by touch and buttons. That made "does this firmware implement the whole feature?" a question no pointer could answer. Each namespace now belongs to exactly one feature or to core, so a feature is a provider pointer and the compiler validates completeness: gui, node -> screen, tree, under the screen feature settings -> screen (rotation, theme), sys (timezone), touch (calibration) input -> touch, buttons Runtime::open() no longer requires a GuiProvider; a firmware without one runs with no screen/tree globals and reports sys.hasFeature("screen") false. Rotation is one value again: GuiProvider::setRotation applies and persists, so an app rotating the panel transiently puts the old value back itself.
2026-08-05 10:26:38 -04:00
parent 445a9b2b8f
commit 75b3a2c490
26 changed files with 556 additions and 626 deletions
@@ -1,147 +0,0 @@
---@meta
-
-- Generated from native/src/bindings/core/gui.cpp. Do not edit.
-
---@alias GuiColor integer
---@alias GuiFont integer
---@alias GuiTextStyle integer
-
---@class GuiLib
---@field FONT_SMALL GuiFont Small auxiliary text.
---@field FONT_UI GuiFont Normal controls and labels.
---@field FONT_BODY GuiFont Normal reading text.
---@field FONT_LARGE GuiFont Headings and prominent values.
---@field STYLE_NORMAL GuiTextStyle
---@field STYLE_BOLD GuiTextStyle
-gui = {}
-gui.FONT_SMALL = 0
-gui.FONT_UI = 0
-gui.FONT_BODY = 0
-gui.FONT_LARGE = 0
-gui.STYLE_NORMAL = 0
-gui.STYLE_BOLD = 0
-
---Returns the live frame width.
---@return integer
-function gui.getWidth() end
-
---Returns the live frame height.
---@return integer
-function gui.getHeight() end
-
---Rotates the live frame without changing the saved preference.
---@param degrees integer 0, 90, 180, or 270 clockwise.
-function gui.setRotation(degrees) end
-
---Returns the rotation of the live frame.
---@return integer Degrees clockwise for the live frame.
-function gui.getRotation() end
-
---Returns an opaque native color. E-ink implementations quantize RGB to available grayscale.
---@param r integer 0 through 255.
---@param g integer 0 through 255.
---@param b integer 0 through 255.
---@return GuiColor
-function gui.color(r, g, b) end
-
---Clears the frame.
---@param color? GuiColor Defaults to white.
-function gui.clear(color) end
-
---Fills a rectangle.
---@param x integer
---@param y integer
---@param w integer
---@param h integer
---@param color GuiColor
-function gui.fillRect(x, y, w, h, color) end
-
---Outlines a rectangle.
---@param x integer
---@param y integer
---@param w integer
---@param h integer
---@param color GuiColor
-function gui.drawRect(x, y, w, h, color) end
-
---Draws a line.
---@param x1 integer
---@param y1 integer
---@param x2 integer
---@param y2 integer
---@param color GuiColor
---@param width? integer Defaults to one pixel.
-function gui.drawLine(x1, y1, x2, y2, color, width) end
-
---Draws a single pixel.
---@param x integer
---@param y integer
---@param color GuiColor
-function gui.drawPixel(x, y, color) end
-
---Outlines a circle.
---@param x integer Center.
---@param y integer Center.
---@param radius integer
---@param color GuiColor
---@param width? integer Defaults to one pixel.
-function gui.drawCircle(x, y, radius, color, width) end
-
---Fills a circle.
---@param x integer Center.
---@param y integer Center.
---@param radius integer
---@param color GuiColor
---@param background? GuiColor Surface behind an anti-aliased edge.
-function gui.fillCircle(x, y, radius, color, background) end
-
---Draws an anti-aliased rounded fill, optional gradient, and optional border in one pass.
---@param x integer
---@param y integer
---@param w integer
---@param h integer
---@param radius integer
---@param background GuiColor Surface behind the anti-aliased edge.
---@param top? GuiColor Fill, or gradient top; omitted for no fill.
---@param bottom? GuiColor Gradient bottom; defaults to top. Panels without a gradient use top.
---@param border? GuiColor Omitted for no border.
-function gui.roundRect(x, y, w, h, radius, background, top, bottom, border) end
-
---Fills a polygon.
---@param xs integer[]
---@param ys integer[]
---@param color GuiColor
-function gui.fillPolygon(xs, ys, color) end
-
---Draws a bitmap.
---@param path string Absolute BMP path.
---@param x? integer Left edge; defaults to centered.
---@param y? integer Top edge; defaults to centered.
---@param maxWidth? integer Defaults to panel width.
---@param maxHeight? integer Defaults to panel height.
---@return true? ok
---@return string? error
-function gui.drawBmp(path, x, y, maxWidth, maxHeight) end
-
---Measures a text run.
---@param font GuiFont Use a named gui.FONT_* role.
---@param text string
---@param style? GuiTextStyle Defaults to gui.STYLE_NORMAL.
---@return integer
-function gui.getTextWidth(font, text, style) end
-
---Returns the line height of a font role.
---@param font GuiFont Use a named gui.FONT_* role.
---@param style? GuiTextStyle Defaults to gui.STYLE_NORMAL.
---@return integer
-function gui.getFontHeight(font, style) end
-
---Draws a text run with its top-left corner at x, y.
---@param font GuiFont Use a named gui.FONT_* role.
---@param x integer Left edge.
---@param y integer Top edge.
---@param text string
---@param color? GuiColor Defaults to black.
---@param style? GuiTextStyle Defaults to gui.STYLE_NORMAL.
---@param background? GuiColor Omitted for transparent text.
-function gui.drawText(font, x, y, text, color, style, background) end
@@ -1,155 +0,0 @@
---@meta
-
-- Generated from native/src/bindings/core/node.cpp. Do not edit.
-
---@alias NodeId integer
---@alias NodeType "box"|"text"|"button"|"custom"
---@alias NodeDirection "up"|"down"|"left"|"right"
-
---@class NodeSpec
---@field type NodeType
---@field w? number|"fill"|"auto"
---@field h? number|"fill"|"auto"
---@field pad? number
---@field gap? number
---@field align? "start"|"center"|"end"|"stretch"
---@field justify? "start"|"center"|"end"|"between"
---@field row? boolean
---@field at? table Absolute-position fields.
---@field capture? boolean
---@field interactive? boolean
---@field label? string
---@field font? GuiFont
-
---@class NodeStyle
---@field color? GuiColor
---@field background? GuiColor Background offered to descendants.
---@field fill? GuiColor Surface painted by a box.
---@field border? GuiColor
---@field face? GuiColor Default button surface.
---@field pressedFace? GuiColor Pressed button surface.
---@field pressedColor? GuiColor Pressed button text.
---@field focusColor? GuiColor Distinct outline for directional focus.
---@field radius? integer
---@field font? GuiFont
---@field textStyle? GuiTextStyle
-
---@class NodeLib
-node = {}
-
---Drops the current tree; all existing IDs become invalid.
-function node.reset() end
-
---Creates a node, optionally as a child of an existing one.
---@param parent? NodeId Nil creates a root.
---@param spec NodeSpec
---@return NodeId
-function node.create(parent, spec) end
-
---Adopts an existing root as a child.
---@param parent NodeId
---@param child NodeId Existing root without a parent.
-function node.attach(parent, child) end
-
---Changes a node's requested size before layout.
---@param id NodeId
---@param w? number|"fill"|"auto"
---@param h? number|"fill"|"auto"
-function node.setSize(id, w, h) end
-
---Measures and places a subtree.
---@param root NodeId
---@param x integer
---@param y integer
---@param w integer
---@param h integer
---@return true? ok
---@return string? error
-function node.layout(root, x, y, w, h) end
-
---Releases temporary measurement and placement inputs after layout.
-function node.dropScratch() end
-
---Returns the deepest interactive node under a point.
---@param root NodeId
---@param x integer
---@param y integer
---@return NodeId?
-function node.hit(root, x, y) end
-
---Returns a node's placed rectangle.
---@param id NodeId
---@return integer x
---@return integer y
---@return integer w
---@return integer h
-function node.getRect(id) end
-
---Replaces a node's text and marks it for repaint.
---@param id NodeId
---@param text string
-function node.setLabel(id, text) end
-
---Returns a node's text.
---@param id NodeId
---@return string?
-function node.getLabel(id) end
-
---Returns a node's parent.
---@param id NodeId
---@return NodeId?
-function node.getParent(id) end
-
---Sets the style roles a subtree inherits.
---@param id NodeId
---@param style NodeStyle
-function node.setStyle(id, style) end
-
---Marks a node for repaint.
---@param id NodeId
-function node.invalidate(id) end
-
---Sets a node's pressed state.
---@param id NodeId
---@param pressed boolean
-function node.setPressed(id, pressed) end
-
---Whether a node is pressed.
---@param id NodeId
---@return boolean
-function node.isPressed(id) end
-
---Focuses the first interactive node in layout order.
---@param root NodeId
---@return NodeId? focused
-function node.focusFirst(root) end
-
---Changes focus and invalidates the previously and newly focused nodes.
---@param id? NodeId Nil clears focus.
-function node.setFocus(id) end
-
---Returns the focused node.
---@return NodeId?
-function node.getFocus() end
-
---Moves to the nearest interactive node in the requested direction without wrapping.
---@param root NodeId
---@param direction NodeDirection
---@return NodeId? focused Current focus when no candidate exists.
-function node.moveFocus(root, direction) end
-
---Registers the painter every custom node calls.
---@param painter fun(id: NodeId, x: integer, y: integer, w: integer, h: integer)
-function node.setPainter(painter) end
-
---Paints dirty nodes; the firmware owns publication to the physical display.
---@param root NodeId
-function node.draw(root) end
-
---Returns the number of nodes in the tree.
---@return integer
-function node.getCount() end
-
---Returns the tree's memory use.
---@return integer bytes
-function node.getFootprint() end
@@ -1,38 +0,0 @@
---@meta
-
-- Generated from native/src/bindings/core/settings.cpp. Do not edit.
-
---@class SettingsLib
-settings = {}
-
---Returns the saved rotation in degrees clockwise.
---@return integer
-function settings.getRotation() end
-
---Applies and persists the screen rotation.
---@param degrees integer 0, 90, 180, or 270 clockwise.
---@return true? ok
---@return string? error
-function settings.setRotation(degrees) end
-
---Returns the active POSIX timezone rule.
---@return string
-function settings.getTimezone() end
-
---Applies and persists a POSIX timezone rule.
---@param timezone string
---@return true? ok
---@return string? error
-function settings.setTimezone(timezone) end
-
---Returns the saved palette name. Apps read ui.getTheme() instead; this
---is the stored value, which only ui.setTheme() knows how to apply.
---@return string
-function settings.getTheme() end
-
---Persists a palette name without applying it. Call ui.setTheme(), which
---writes through here and then rebuilds the palette and repaints.
---@param theme string
---@return true? ok
---@return string? error
-function settings.setTheme(theme) end
@@ -2,7 +2,7 @@

 -- Generated from native/src/bindings/core/sys.cpp. Do not edit.

---@alias Feature "touch"|"buttons"
+---@alias Feature "screen"|"touch"|"buttons"

 ---@class SysLib
 sys = {}
@@ -62,3 +62,13 @@ function sys.getMemory() end
 ---Whether network time synchronization has completed.
 ---@return boolean
 function sys.isClockSynced() end
+
+---Returns the active POSIX timezone rule.
+---@return string
+function sys.getTimezone() end
+
+---Applies and persists a POSIX timezone rule.
+---@param timezone string
+---@return true? ok
+---@return string? error
+function sys.setTimezone(timezone) end