ms-types 0.9.24 → 0.9.26

package/types/lua/image.lua

@@ -0,0 +1,205 @@
+---@meta image
+---@class Image
+local _Image = {}
+
+---@class Size
+---@field width integer 宽度
+---@field height integer 高度
+
+---@class Point
+---@field x integer x坐标
+---@field y integer y坐标
+
+---@class Rect
+---@field index integer 模版索引
+---@field x integer 左上角x坐标
+---@field y integer 左上角y坐标
+---@field width integer 宽度
+---@field height integer 高度
+---@field confidence number 置信度
+---@field centerX integer 中心x坐标
+---@field centerY integer 中心y坐标
+---@field ex integer 右下角x坐标
+---@field ey integer 右下角y坐标
+
+--- 截取屏幕；坐标缺省 0 表示全屏
+--- @param x integer|nil 左上角 x
+--- @param y integer|nil 左上角 y
+--- @param ex integer|nil 右下角 x
+--- @param ey integer|nil 右下角 y
+--- @return string|nil 图片ID
+function _Image.captureScreen(x, y, ex, ey) return '' end
+
+--- 全屏截屏
+--- @return string|nil 图片ID
+function _Image.captureFullScreen() return '' end
+
+--- 区域截屏
+--- @param x integer|nil
+--- @param y integer|nil
+--- @param ex integer|nil 右下角x
+--- @param ey integer|nil 右下角y
+--- @return string|nil 图片ID
+function _Image.captureRect(x, y, ex, ey) return '' end
+
+--- 读取图片
+--- @param path string 文件路径
+--- @return string 图片ID
+function _Image.readImage(path) return '' end
+
+--- 裁剪图片
+--- @param id string 图片ID
+--- @param x integer|nil
+--- @param y integer|nil
+--- @param ex integer|nil 右下角x
+--- @param ey integer|nil 右下角y
+--- @return string 新图片ID
+function _Image.clip(id, x, y, ex, ey) return '' end
+
+--- 获取尺寸
+--- @param id string 图片ID
+--- @return Size 尺寸对象
+function _Image.getSize(id)
+    ---@type Size
+    local ret
+    return ret
+end
+
+--- 转为Base64
+--- @param id string 图片ID
+--- @param format string 格式，如 'png'
+--- @param quality integer|nil 质量
+--- @return string Base64文本
+function _Image.toBase64Format(id, format, quality) return '' end
+
+--- Base64转图片
+--- @param s string Base64文本
+--- @return string 图片ID
+function _Image.base64ToImage(s) return '' end
+
+--- 旋转图片
+--- @param id string 图片ID
+--- @param degree integer 角度（90 | -90 | 180）
+--- @return string|nil 新图片ID
+function _Image.rotateImage(id, degree) return '' end
+
+--- 图片是否已释放
+--- @param id string 图片ID
+--- @return boolean 已释放
+function _Image.isRelease(id) return false end
+
+--- 释放图片
+--- @param id string 图片ID
+function _Image.release(id) end
+
+--- 保存图片到路径
+--- @param id string 图片ID
+--- @param path string 文件路径
+--- @return boolean 成功
+function _Image.saveTo(id, path) return true end
+
+--- 查找颜色
+--- @param id string 图片ID
+--- @param color string 颜色 "#RRGGBB"，可带偏色
+--- @param threshold number 相似度 0.0-1.0
+--- @param x integer|nil 左上x
+--- @param y integer|nil 左上y
+--- @param ex integer|nil 右下x
+--- @param ey integer|nil 右下y
+--- @param limit integer 限制个数
+--- @param orz integer 方向 1-8
+--- @return Point[] 结果点列表
+function _Image.findColor(id, color, threshold, x, y, ex, ey, limit, orz)
+    return {}
+end
+
+--- 多点比色
+--- @param id string 图片ID
+--- @param points string 点配置 "x|y|主色-偏色,..."
+--- @param threshold number 相似度 0.0-1.0
+--- @return boolean 是否相同
+function _Image.cmpColor(id, points, threshold) return true end
+
+--- 查找图片
+--- @param id string 图片ID
+--- @param templateImageId string 模板图片ID
+--- @param x integer|nil 左上x
+--- @param y integer|nil 左上y
+--- @param ex integer|nil 右下x
+--- @param ey integer|nil 右下y
+--- @param threshold number 相似度 0.0-1.0
+--- @param limit integer|nil 限制个数
+--- @param method integer|nil 匹配方法 1|3|5
+--- @param rgb boolean|nil 是否使用RGB
+--- @return Rect[] 结果矩形列表
+function _Image.findImage(id, templateImageId, x, y, ex, ey, threshold, limit,
+                          method, rgb) return {} end
+
+--- 多点找色
+--- @param id string 图片ID
+--- @param firstColor string 首色 "#RRGGBB" 或 "#RRGGBB"
+--- @param threshold number 相似度 0.0-1.0
+--- @param points string 点配置 "x|y|主色-偏色,..."
+--- @param x integer 左上x
+--- @param y integer 左上y
+--- @param ex integer 右下x
+--- @param ey integer 右下y
+--- @param limit integer 限制个数
+--- @param orz integer 方向 1-8
+--- @return Point[] 结果点列表
+function _Image.findMultiColor(id, firstColor, threshold, points, x, y, ex, ey,
+                               limit, orz) return {} end
+
+--- 统计颜色数量
+--- @param id string 图片ID
+--- @param colors string 颜色列表 "主色-偏色|主色-偏色|..."
+--- @param threshold number 相似度 0.0-1.0
+--- @param x integer 左上x
+--- @param y integer 左上y
+--- @param ex integer 右下x
+--- @param ey integer 右下y
+--- @return integer 命中像素数量
+function _Image.countColor(id, colors, threshold, x, y, ex, ey) return 0 end
+
+--- 像素值
+--- @param id string 图片ID
+--- @param x integer
+--- @param y integer
+--- @return integer ARGB值
+function _Image.pixel(id, x, y) return 0 end
+
+--- 颜色转16进制字符串
+--- @param color integer ARGB整数
+--- @return string #RRGGBB
+function _Image.argb(color) return '' end
+
+--- 二值化
+--- @param id string 图片ID
+--- @param threshold number 阈值
+--- @return string 新图片ID
+function _Image.binaryzation(id, threshold) return '' end
+
+--- 灰度化
+--- @param id string 图片ID
+--- @return string 新图片ID
+function _Image.gray(id) return '' end
+
+--- 扫描条码/二维码
+--- @param id string 图片ID
+--- @return string|nil 文本
+function _Image.scanCode(id) return '' end
+
+--- 绘制矩形
+--- @param id string 图片ID
+--- @param x integer|nil 左上x
+--- @param y integer|nil 左上y
+--- @param ex integer|nil 右下x
+--- @param ey integer|nil 右下y
+--- @param color string|nil 颜色 #RRGGBB
+--- @param thickness integer|nil 线宽 -1填充
+function _Image.drawRect(id, x, y, ex, ey, color, thickness) end
+
+--- 释放所有图片
+function _Image.releaseAll() end
+
+return _Image

package/types/lua/ime.lua

@@ -0,0 +1,48 @@
+---@meta ime
+---@class Ime
+local _Ime = {}
+
+--- 输入法是否可用（键盘是否已弹出）
+--- @return boolean 可用
+function _Ime.isOk() return false end
+
+--- 获取当前输入框文本
+--- @return string 文本
+function _Ime.getText() return '' end
+
+--- 清空输入框文本
+--- @return boolean 成功
+function _Ime.clearText() return true end
+
+--- 输入文本（content 为空时使用剪贴板）
+--- @param text string 文本
+--- @return string 实际输入的文本（失败为空字符串）
+function _Ime.input(text) return '' end
+
+--- 粘贴文本（content 为空时使用剪贴板）
+--- @param text string|nil 文本
+--- @return string 实际粘贴的文本（失败为空字符串）
+function _Ime.paste(text) return '' end
+
+--- 删除一个字符（返回剩余文本；空表示无数据）
+--- @return string 剩余文本
+function _Ime.pressDel() return '' end
+
+--- 回车键
+--- @return boolean 成功
+function _Ime.pressEnter() return true end
+
+--- 隐藏键盘
+--- @return boolean 成功
+function _Ime.dismiss() return true end
+
+--- 获取剪贴板
+--- @return string 文本
+function _Ime.getClipboard() return '' end
+
+--- 设置剪贴板（键盘显示时）
+--- @param text string 文本
+--- @return boolean 成功
+function _Ime.setClipboard(text) return true end
+
+return _Ime

package/types/lua/logger.lua

@@ -0,0 +1,48 @@
+---@meta logger
+---@class Logger
+local _Logger = {}
+
+--- 设置日志级别（error|warn|info|debug|off）
+--- @param level string 级别
+function _Logger.setLoggerLevel(level) end
+
+--- 设置是否输出到日志文件
+--- @param enabled boolean 是否启用文件输出
+function _Logger.setLogToFile(enabled) end
+
+--- 设置最大日志文件数量（默认 10）
+--- @param count integer 数量
+function _Logger.setMaxLogFileCount(count) end
+
+--- 设置最大日志文件大小（MB，默认 10）
+--- @param size integer 大小
+function _Logger.setMaxLogFileSize(size) end
+
+--- 重置日志文件（创建新文件写入）
+function _Logger.resetLogFile() end
+
+--- 输出调试日志（级别：debug）
+--- 可变参数会按空格拼接为一行文本
+--- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @return nil
+function _Logger.debug(...) end
+
+--- 输出信息日志（级别：info）
+--- 可变参数会按空格拼接为一行文本
+--- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @return nil
+function _Logger.info(...) end
+
+--- 输出警告日志（级别：warn）
+--- 可变参数会按空格拼接为一行文本
+--- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @return nil
+function _Logger.warn(...) end
+
+--- 输出错误日志（级别：error）
+--- 可变参数会按空格拼接为一行文本
+--- @param ... any 日志内容（任意类型，自动调用 tostring）
+--- @return nil
+function _Logger.error(...) end
+
+return _Logger

package/types/lua/media.lua

@@ -0,0 +1,46 @@
+---@meta media
+---@class Media
+local _Media = {}
+
+--- 播放MP3
+--- @param file string 文件路径
+--- @param loop boolean|nil 循环播放
+--- @return boolean 成功
+function _Media.playMp3(file, loop) return true end
+
+--- 停止播放
+--- @return boolean 成功
+function _Media.stopMp3() return true end
+
+--- 播放一次并等待结束
+--- @param file string 文件路径
+--- @return boolean 是否正常播放到结尾
+function _Media.playMp3WaitEnd(file) return true end
+
+--- 是否正在播放
+--- @return boolean 正在播放
+function _Media.isMp3Playing() return true end
+
+--- 保存图片到相册
+--- @param imageId string 图片ID
+--- @return boolean 成功
+function _Media.saveImageToAlbum(imageId) return true end
+
+--- 保存视频到相册（路径）
+--- @param path string 文件路径
+--- @return boolean 成功
+function _Media.saveVideoToAlbumPath(path) return true end
+
+--- 清空相册中的图片
+--- @return boolean 成功
+function _Media.deleteAllPhotos() return true end
+
+--- 清空相册中的视频
+--- @return boolean 成功
+function _Media.deleteAllVideos() return true end
+
+--- 清空相册中的截图
+--- @return boolean 成功
+function _Media.deleteAllScreenshots() return true end
+
+return _Media

package/types/lua/mysql.lua

@@ -0,0 +1,64 @@
+---@meta mysql
+---@class MySQL
+local _MySQL = {}
+
+---@class MySQLConfig
+---@field host string 主机名
+---@field port integer|nil 端口号
+---@field username string 用户名
+---@field password string 密码
+---@field database string 数据库名
+---@field charset string|nil 字符集
+
+---@class MySQLResult
+---@field rows table[] 结果集
+---@field affectedRows integer 受影响的行数
+---@field success boolean 是否成功
+---@field insertId integer|nil 插入ID
+---@field error string|nil 错误信息
+
+--- 连接数据库
+--- @param config MySQLConfig 配置
+--- @return boolean 成功
+function _MySQL.connect(config) return true end
+
+--- 断开连接
+function _MySQL.disconnect() end
+
+--- 是否连接
+--- @return boolean 连接中
+function _MySQL.isConnected() return false end
+
+--- 查询
+--- @param sql string
+--- @param params any[]|nil 参数数组
+--- @return MySQLResult 结果
+function _MySQL.query(sql, params)
+    ---@type MySQLResult
+    local ret
+    return ret
+end
+
+--- 执行
+--- @param sql string
+--- @param params any[]|nil 参数数组
+--- @return MySQLResult 结果
+function _MySQL.execute(sql, params)
+    ---@type MySQLResult
+    local ret
+    return ret
+end
+
+--- 开始事务
+--- @return boolean 成功
+function _MySQL.beginTransaction() return true end
+
+--- 提交
+--- @return boolean 成功
+function _MySQL.commit() return true end
+
+--- 回滚
+--- @return boolean 成功
+function _MySQL.rollback() return true end
+
+return _MySQL

package/types/lua/netcard.lua

@@ -0,0 +1,45 @@
+---@meta netcard
+---@class NetCard
+local _NetCard = {}
+
+---@class CardInfo 卡密信息
+---@field cardNo string 卡密
+---@field batchCard string 批量卡密
+---@field remark string 备注
+---@field activeTime string 激活时间
+---@field expireTime string 过期时间
+
+--- 当前是否为授权卡密模式
+--- @return boolean 授权卡密模式
+function _NetCard.isAuthCardMode() return false end
+
+--- 验证
+--- @param cardNo string 卡密
+--- @return boolean 成功
+function _NetCard.verify(cardNo) return true end
+
+--- 卡信息
+--- @return CardInfo|nil 信息
+function _NetCard.getCardInfo()
+    ---@type CardInfo
+    local ret
+    return ret
+end
+
+--- 设置备注
+--- @param remark string 备注
+--- @return boolean 成功
+function _NetCard.setCardRemark(remark) return true end
+
+--- 设置值
+--- @param key string 键
+--- @param value string 值
+--- @return string 返回值
+function _NetCard.setValue(key, value) return '' end
+
+--- 获取值
+--- @param key string 键
+--- @return string 值
+function _NetCard.getValue(key) return '' end
+
+return _NetCard

package/types/lua/node.lua

@@ -0,0 +1,74 @@
+---@meta node
+---@class Node
+local _Node = {}
+
+---@class SelectorParams 选择器参数
+---@field maxDepth integer|nil 最大深度 默认 50
+---@field mode integer|nil 抓取模式 1/2/3，默认 1
+
+---@class NodeBounds 节点边界
+---@field x integer 节点左边界
+---@field y integer 节点上边界
+---@field width integer 节点宽度
+---@field height integer 节点高度
+---@field centerX integer 节点中心X坐标
+---@field centerY integer 节点中心Y坐标
+
+---@class NodeInfo 节点信息
+---@field id string 节点ID
+---@field identifier string 节点标识符
+---@field label string 节点标签
+---@field type string 节点类型
+---@field value string 节点值
+---@field title string 节点名称
+---@field visible boolean 是否可见
+---@field enabled boolean 是否启用
+---@field accessible boolean 是否可访问
+---@field selected boolean 是否选中
+---@field bounds NodeBounds 节点边界
+---@field depth integer 节点深度
+---@field index integer 节点索引
+---@field parentId string 父节点ID
+---@field childCount integer 子节点数量
+---@field clickCenter fun(self: NodeInfo, duration: integer|nil): boolean 点击中心
+---@field clickRandom fun(self: NodeInfo, duration: integer|nil): boolean 点击随机位置
+---@field parent fun(self: NodeInfo): NodeInfo|nil 父节点
+---@field child fun(self: NodeInfo, index: integer): NodeInfo|nil 子节点
+---@field allChildren fun(self: NodeInfo): NodeInfo[] 所有子节点
+---@field siblings fun(self: NodeInfo): NodeInfo[] 所有兄弟节点
+---@field previousSiblings fun(self: NodeInfo): NodeInfo[] 前兄弟节点
+---@field nextSiblings fun(self: NodeInfo): NodeInfo[] 后兄弟节点
+---@class NodeSelector 节点选择器
+---@field clearSelector fun(self: NodeSelector): NodeSelector 清除选择器
+---@field loadNode fun(self: NodeSelector, timeout: integer|nil): NodeSelector 加载节点
+---@field xml fun(self: NodeSelector, timeout: integer|nil): string|nil 获取XML字符串
+---@field getNodeInfo fun(self: NodeSelector, timeout: integer|nil): NodeInfo[] 获取所有节点信息
+---@field getOneNodeInfo fun(self: NodeSelector, timeout: integer|nil): NodeInfo|nil 获取第一个节点信息
+---@field xpath fun(self: NodeSelector, path: string): NodeSelector 设置XPath路径
+---@field label fun(self: NodeSelector, label: string): NodeSelector 设置标签
+---@field labelMatch fun(self: NodeSelector, match: string): NodeSelector 设置标签匹配
+---@field title fun(self: NodeSelector, title: string): NodeSelector 设置名称
+---@field titleMatch fun(self: NodeSelector, match: string): NodeSelector 设置名称匹配
+---@field identifier fun(self: NodeSelector, identifier: string): NodeSelector 设置标识符
+---@field identifierMatch fun(self: NodeSelector, match: string): NodeSelector 设置标识符匹配
+---@field type fun(self: NodeSelector, typetitle: string): NodeSelector 设置类型
+---@field typeMatch fun(self: NodeSelector, match: string): NodeSelector 设置类型匹配
+---@field value fun(self: NodeSelector, value: string): NodeSelector 设置值
+---@field valueMatch fun(self: NodeSelector, match: string): NodeSelector 设置值匹配
+---@field enabled fun(self: NodeSelector, flag: boolean): NodeSelector 设置启用状态
+---@field visible fun(self: NodeSelector, flag: boolean): NodeSelector 设置可见状态
+---@field index fun(self: NodeSelector, idx: integer): NodeSelector 设置索引
+---@field depth fun(self: NodeSelector, d: integer): NodeSelector 设置深度
+---@field childCount fun(self: NodeSelector, childCount: integer|string): NodeSelector 设置子节点数量
+---@field bounds fun(self: NodeSelector, x: integer, y: integer, width: integer, height: integer): NodeSelector 设置边界
+
+--- 创建选择器（可自动释放）
+--- @param params SelectorParams|nil
+--- @return NodeSelector 选择器
+function _Node.createNodeSelector(params)
+    ---@type NodeSelector
+    local ret
+    return ret
+end
+
+return _Node