ms-types 0.9.36 → 0.9.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.9.36",
+  "version": "0.9.37",
   "type": "module",
   "license": "MIT",
   "publishConfig": {

package/types/lua/file.lua

@@ -19,7 +19,7 @@ function _File.mkdirs(path) return true end
 
 --- 读取文件
 --- @param path string 路径
---- @return string 内容
+--- @return string 内容，失败为空串
 function _File.readFile(path) return '' end
 
 --- 写入文件
@@ -40,7 +40,7 @@ function _File.deleteAllFile(path) return true end
 
 --- 读取资源文件（res 目录）
 --- @param name string 文件名
---- @return string|nil 内容
+--- @return string 内容，失败为空串
 function _File.readResFile(name) return '' end
 
 --- 获取 res 资源的本地文件路径；用完后应调用 cleanupResFile
@@ -74,12 +74,12 @@ function _File.appendLine(path, data) return true end
 --- 读取指定行
 --- @param path string 路径
 --- @param lineNo integer 行号
---- @return string|nil 内容
+--- @return string 内容，失败为空串
 function _File.readLine(path, lineNo) return '' end
 
 --- 读取所有行
 --- @param path string 路径
---- @return string[] 行列表
+--- @return string[] 行列表，失败为空表
 function _File.readAllLines(path) return {} end
 
 --- 复制文件
@@ -90,7 +90,7 @@ function _File.copy(src, dest) return true end
 
 --- 计算文件MD5
 --- @param path string 路径
---- @return string|nil MD5值
+--- @return string MD5 值，失败为空串
 function _File.fileMD5(path) return '' end
 
 ---@type File

package/types/lua/global.lua

@@ -67,7 +67,7 @@ function Time() return 0 end
 ---@return string
 function ToJsonString(data) return '' end
 
---- 启动同 VM 协作协程（不是 OS 线程），返回协程名
+--- 启动协作协程，返回协程名
 ---@param func function
 ---@return string
 function StartThread(func) return '' end
@@ -76,7 +76,7 @@ function StartThread(func) return '' end
 ---@param threadName string
 function StopThread(threadName) end
 
---- 当前协作协程是否应退出。主脚本收到停止后由引擎 hook / Sleep 直接中断，不必轮询本函数。
+--- 当前协程是否应退出
 ---@return boolean
 function ShouldInterruptThread() return false end
 

package/types/lua/http.lua

@@ -4,7 +4,7 @@ local _Http = {}
 
 ---@class HttpRequestOptions
 ---@field url string         @请求地址
----@field timeout integer|nil @请求超时（毫秒）
+---@field timeout integer|nil @请求超时（毫秒），默认 30000
 ---@field method string|nil   @请求方法 GET/POST/...
 ---@field proxy {host:string, port:integer}|nil @代理服务器
 ---@field followRedirects boolean|nil @是否跟随重定向
@@ -47,7 +47,7 @@ end
 --- GET 请求（同名：httpGet）
 --- @param url string
 --- @param params table<string,string>|nil
---- @param timeout integer|nil
+--- @param timeout integer|nil 默认 30000
 --- @param headers table<string,string>|nil
 --- @return string|nil
 function _Http.httpGet(url, params, timeout, headers) return '' end
@@ -56,7 +56,7 @@ function _Http.httpGet(url, params, timeout, headers) return '' end
 --- @param url string
 --- @param params table<string,string>|nil
 --- @param files table<string,string>|nil
---- @param timeout integer|nil
+--- @param timeout integer|nil 默认 30000
 --- @param headers table<string,string>|nil
 --- @return string|nil
 function _Http.httpPost(url, params, files, timeout, headers) return '' end
@@ -64,7 +64,7 @@ function _Http.httpPost(url, params, files, timeout, headers) return '' end
 --- POST JSON 请求
 --- @param url string
 --- @param json table|nil
---- @param timeout integer|nil
+--- @param timeout integer|nil 默认 30000
 --- @param headers table<string,string>|nil
 --- @return string|nil
 function _Http.postJSON(url, json, timeout, headers) return '' end
@@ -72,7 +72,7 @@ function _Http.postJSON(url, json, timeout, headers) return '' end
 --- 下载文件（同名：downloadFile）
 --- @param url string
 --- @param file string
---- @param timeout integer|nil
+--- @param timeout integer|nil 默认 30000
 --- @param headers table<string,string>|nil
 --- @return boolean
 function _Http.downloadFile(url, file, timeout, headers) return true end

package/types/lua/image.lua

@@ -137,7 +137,7 @@ function _Image.cmpColor(id, points, threshold) return true end
 --- @param ey integer|nil 右下y
 --- @param threshold number 相似度 0.0-1.0
 --- @param limit integer|nil 限制个数
---- @param method integer|nil 匹配方法 0|1|3|5|99
+--- @param method integer|nil 匹配方法 0|1|3|5|99，默认 5
 --- @param rgb boolean|nil 是否使用RGB
 --- @param options FindImageOptions|nil 选项。scaleFactors 仅 method=99；orz 为查找方向 1-8
 --- @return Rect[] 结果矩形列表

package/types/lua/node.lua

@@ -40,7 +40,7 @@ local _Node = {}
 ---@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 child fun(self: NodeInfo, index: integer): NodeInfo|nil 子节点，index 从 0 开始
 ---@field allChildren fun(self: NodeInfo): NodeInfo[] 所有子节点
 ---@field siblings fun(self: NodeInfo): NodeInfo[] 所有兄弟节点
 ---@field previousSiblings fun(self: NodeInfo): NodeInfo[] 前兄弟节点

package/types/lua/system.lua

@@ -2,15 +2,10 @@
 ---@class System
 local _System = {}
 
----@class ProcessArguments
----@field env table<string, any> 环境变量映射（键为字符串，值为任意类型）
----@field args string[] 启动参数列表
-
 ---@class ActivateAppInfo
 ---@field name string 应用名称
 ---@field pid integer 进程 ID
 ---@field bundleId string 应用 Bundle ID
----@field processArguments ProcessArguments 启动参数信息
 
 ---@class MemoryInfo
 ---@field used integer 已使用内存（MB）
@@ -20,10 +15,8 @@ local _System = {}
 
 --- 启动应用
 --- @param bundleId string 应用 Bundle ID
---- @param args string[]|nil 启动参数
---- @param env table<string, any>|nil 环境变量
 --- @return boolean 成功
-function _System.startApp(bundleId, args, env) return true end
+function _System.startApp(bundleId) return true end
 
 --- 停止应用
 --- @param bundleId string 应用 Bundle ID