---@meta

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

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

---@class SysLib
sys = {}

---Returns the implemented API contract version.
---@return integer
function sys.getAPIVersion() end

---Whether the firmware implements a complete optional feature contract.
---@param feature Feature
---@return boolean
function sys.hasFeature(feature) end

---Returns monotonic milliseconds since boot.
---@return integer
function sys.getMillis() end

---Tears the runtime down and starts over from a Lua file, which is the only navigation there is: history, titles and where apps live are whatever that file makes of the arguments.
---@param path string Absolute path to the Lua file to load; traversal is rejected.
---@param args? table Plain data, carried across the teardown as JSON and handed to start(args). Raises on anything JSON cannot represent.
function sys.startApp(path, args) end

---Returns heap statistics.
---@return integer freeBytes
---@return integer totalBytes
---@return integer largestFreeBlock
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