---@meta

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

---@alias Feature "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

---Returns the immutable first path component of the running app.
---@return string
function sys.getAppID() end

---Returns the running app title, initially the app ID.
---@return string
function sys.getAppTitle() end

---Returns the current app's guaranteed-existing persistent data directory.
---@return string Absolute path under /.lua/data, preserved across app updates.
function sys.getAppDataPath() end

---Changes the running app's display title.
---@param title string
function sys.setAppTitle(title) end

---Launches /.lua/apps/<path>/main.lua and pushes the current route.
---@param path string App-relative directory path; traversal is rejected.
---@param arg? string Passed to init(arg).
function sys.launch(path, arg) end

---Launches an app path without retaining the current route.
---@param path string App-relative directory path; traversal is rejected.
---@param arg? string Passed to init(arg).
function sys.replace(path, arg) end

---Returns to the previous app, or the launcher when history is empty.
function sys.back() 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