ms-types 0.9.32 → 0.9.34

package/package.json

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

package/types/lua/README.md

@@ -10,4 +10,4 @@
 }
 ```
 
-不要把本目录复制进脚本项目根目录。每个模块文件用 `---@meta <require名>` 和 `package.loaded['<require名>']` 对齐运行时 `require`，例如 `require("cv")`、`require("dotocr")`、`require("yolocls")`。`Sleep`、`HidKey`、`logd` / `logi` / `logw` / `loge` 等裸全局会随 library 自动加载。
+不要把本目录复制进脚本项目根目录。每个模块文件声明对应的全局表（如 `device`、`cv`、`dotocr`），不要 `require` 宿主模块。`Sleep`、`HidKey`、`logd` / `logi` / `logw` / `loge` 等裸全局会随 library 自动加载。用户自己的 `scripts/foo.lua` 仍用 `require("foo")`。

package/types/lua/action.lua

@@ -1,4 +1,4 @@
----@meta action
+---@meta
 ---@class Action
 local _Action = {}
 
@@ -229,5 +229,5 @@ function _Action.createBuilder()
     return ret
 end
 
-package.loaded['action'] = _Action
-return _Action
+---@type Action
+action = _Action

package/types/lua/appleocr.lua

@@ -1,4 +1,4 @@
----@meta appleocr
+---@meta
 ---@class AppleOCR
 local _AppleOCR = {}
 
@@ -14,7 +14,8 @@ local _AppleOCR = {}
 ---@field centerX integer 文本区域中心点 x 坐标
 ---@field centerY integer 文本区域中心点 y 坐标
 
---- 识别文本
+--- 识别文本（兼容旧接口，请改用 recognizeAbs）
+--- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
 --- @param y integer|nil 区域Y，默认0
@@ -46,7 +47,8 @@ function _AppleOCR.recognizeAbs(input, x, y, ex, ey, langs)
     return ret
 end
 
---- 识别数字
+--- 识别数字（兼容旧接口，请改用 recognizeNumbersAbs）
+--- @deprecated 请改用 recognizeNumbersAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 区域X，默认0
 --- @param y integer|nil 区域Y，默认0
@@ -76,7 +78,8 @@ function _AppleOCR.recognizeNumbersAbs(input, x, y, ex, ey)
     return ret
 end
 
---- 查找文本
+--- 查找文本（兼容旧接口，请改用 findTextAbs）
+--- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串
 --- @param x integer|nil 区域X，默认0
@@ -112,5 +115,5 @@ function _AppleOCR.findTextAbs(input, targets, x, y, ex, ey, langs, exactMatch)
     return ret
 end
 
-package.loaded['appleocr'] = _AppleOCR
-return _AppleOCR
+---@type AppleOCR
+appleocr = _AppleOCR

package/types/lua/cloud.lua

@@ -1,4 +1,4 @@
----@meta cloud
+---@meta
 ---@class Cloud
 local _Cloud = {}
 
@@ -28,5 +28,5 @@ function _Cloud.report(event, data) return false end
 ---@param callback fun(event:string, data:table)|nil
 function _Cloud.onEvent(callback) end
 
-package.loaded['cloud'] = _Cloud
-return _Cloud
+---@type Cloud
+cloud = _Cloud

package/types/lua/config.lua

@@ -1,4 +1,4 @@
----@meta config
+---@meta
 ---@class Config
 local _Config = {}
 
@@ -31,5 +31,5 @@ function _Config.getKuiConfig() return {} end
 ---@return boolean
 function _Config.remove(key) return true end
 
-package.loaded['config'] = _Config
-return _Config
+---@type Config
+config = _Config

package/types/lua/cryptoUtils.lua

@@ -1,4 +1,4 @@
----@meta cryptoUtils
+---@meta
 ---@class CryptoUtils
 local _CryptoUtils = {}
 
@@ -43,5 +43,5 @@ function _CryptoUtils.sha1(data) return "" end
 ---@return string
 function _CryptoUtils.sha256(data) return "" end
 
-package.loaded['cryptoUtils'] = _CryptoUtils
-return _CryptoUtils
+---@type CryptoUtils
+cryptoUtils = _CryptoUtils

package/types/lua/cv.lua

@@ -1,8 +1,8 @@
----@meta cv
+---@meta
 ---@class OpenCV
 local _OpenCV = {}
 
---- OpenCV Mat 句柄模块；require("cv")。方法与常量对齐 JS `cv` 运行时导出。
+--- OpenCV Mat 句柄模块；全局 `cv`。方法与常量对齐 JS `cv` 运行时导出。
 
 --- absdiff
 ---@param ... any
@@ -724,5 +724,5 @@ function _OpenCV.warpPerspective(...) return nil end
 ---@return any
 function _OpenCV.zeros(...) return nil end
 
-package.loaded['cv'] = _OpenCV
-return _OpenCV
+---@type OpenCV
+cv = _OpenCV

package/types/lua/device.lua

@@ -1,4 +1,4 @@
----@meta device
+---@meta
 ---@class Device
 local _Device = {}
 
@@ -102,5 +102,5 @@ function _Device.getLanIp() return '' end
 ---@param intensity number 0.0-1.0
 function _Device.vibrate(duration, intensity) end
 
-package.loaded['device'] = _Device
-return _Device
+---@type Device
+device = _Device

package/types/lua/dotocr.lua

@@ -1,8 +1,8 @@
----@meta dotocr
+---@meta
 ---@class DotOCR
 local _DotOCR = {}
 
---- 点阵 OCR；require("dotocr")
+--- 点阵 OCR；全局 `dotocr`
 
 --- loadFont
 ---@param fontPath string
@@ -41,5 +41,5 @@ function _DotOCR.recognizeAbs(fontId, input, x, y, ex, ey, confidenceThreshold)
 ---@return table[]
 function _DotOCR.findTextAbs(fontId, input, targetTexts, x, y, ex, ey, confidenceThreshold, exactMatch) return {} end
 
-package.loaded['dotocr'] = _DotOCR
-return _DotOCR
+---@type DotOCR
+dotocr = _DotOCR

package/types/lua/file.lua

@@ -1,4 +1,4 @@
----@meta file
+---@meta
 ---@class File
 local _File = {}
 
@@ -93,5 +93,5 @@ function _File.copy(src, dest) return true end
 --- @return string|nil MD5值
 function _File.fileMD5(path) return '' end
 
-package.loaded['file'] = _File
-return _File
+---@type File
+file = _File

package/types/lua/hid.lua

@@ -1,4 +1,4 @@
----@meta hid
+---@meta
 ---@type table<string, integer>
 HidKey = {
     COMMAND = 0x83,
@@ -271,5 +271,5 @@ function _HID.currentAppInfo()
     return ret
 end
 
-package.loaded['hid'] = _HID
-return _HID
+---@type HID
+hid = _HID

package/types/lua/hotupdate.lua

@@ -1,4 +1,4 @@
----@meta hotupdate
+---@meta
 ---@class HotUpdate
 local _HotUpdate = {}
 
@@ -20,5 +20,5 @@ function _HotUpdate.downloadAndInstall() return {updated = true, error = nil} en
 --- @return integer 版本号
 function _HotUpdate.getCurrentVersion() return 0 end
 
-package.loaded['hotupdate'] = _HotUpdate
-return _HotUpdate
+---@type HotUpdate
+hotupdate = _HotUpdate

package/types/lua/http.lua

@@ -1,4 +1,4 @@
----@meta http
+---@meta
 ---@class Http
 local _Http = {}
 
@@ -141,5 +141,5 @@ function _WebSocket.onBinary(fn) end
 --- @param fn fun(error:string)
 function _WebSocket.onError(fn) end
 
-package.loaded['http'] = _Http
-return _Http
+---@type Http
+http = _Http

package/types/lua/image.lua

@@ -1,4 +1,4 @@
----@meta image
+---@meta
 ---@class Image
 local _Image = {}
 
@@ -30,11 +30,13 @@ local _Image = {}
 --- @return string|nil 图片ID
 function _Image.captureScreen(x, y, ex, ey) return '' end
 
---- 全屏截屏
+--- 全屏截屏（兼容旧接口，请改用 captureScreen）
+--- @deprecated 请改用 captureScreen()。
 --- @return string|nil 图片ID
 function _Image.captureFullScreen() return '' end
 
---- 区域截屏
+--- 区域截屏（兼容旧接口，请改用 captureScreen）
+--- @deprecated 请改用 captureScreen(x, y, ex, ey)。
 --- @param x integer|nil
 --- @param y integer|nil
 --- @param ex integer|nil 右下角x
@@ -203,5 +205,5 @@ function _Image.drawRect(id, x, y, ex, ey, color, thickness) end
 --- 释放所有图片
 function _Image.releaseAll() end
 
-package.loaded['image'] = _Image
-return _Image
+---@type Image
+image = _Image

package/types/lua/ime.lua

@@ -1,4 +1,4 @@
----@meta ime
+---@meta
 ---@class Ime
 local _Ime = {}
 
@@ -45,5 +45,5 @@ function _Ime.getClipboard() return '' end
 --- @return boolean 成功
 function _Ime.setClipboard(text) return true end
 
-package.loaded['ime'] = _Ime
-return _Ime
+---@type Ime
+ime = _Ime

package/types/lua/logger.lua

@@ -1,4 +1,4 @@
----@meta logger
+---@meta
 ---@class Logger
 local _Logger = {}
 
@@ -45,5 +45,5 @@ function _Logger.warn(...) end
 --- @return nil
 function _Logger.error(...) end
 
-package.loaded['logger'] = _Logger
-return _Logger
+---@type Logger
+logger = _Logger

package/types/lua/media.lua

@@ -1,4 +1,4 @@
----@meta media
+---@meta
 ---@class Media
 local _Media = {}
 
@@ -43,5 +43,5 @@ function _Media.deleteAllVideos() return true end
 --- @return boolean 成功
 function _Media.deleteAllScreenshots() return true end
 
-package.loaded['media'] = _Media
-return _Media
+---@type Media
+media = _Media

package/types/lua/mysql.lua

@@ -1,4 +1,4 @@
----@meta mysql
+---@meta
 ---@class MySQL
 local _MySQL = {}
 
@@ -61,5 +61,5 @@ function _MySQL.commit() return true end
 --- @return boolean 成功
 function _MySQL.rollback() return true end
 
-package.loaded['mysql'] = _MySQL
-return _MySQL
+---@type MySQL
+mysql = _MySQL

package/types/lua/netcard.lua

@@ -1,4 +1,4 @@
----@meta netcard
+---@meta
 ---@class NetCard
 local _NetCard = {}
 
@@ -42,5 +42,5 @@ function _NetCard.setValue(key, value) return '' end
 --- @return string 值
 function _NetCard.getValue(key) return '' end
 
-package.loaded['netcard'] = _NetCard
-return _NetCard
+---@type NetCard
+netcard = _NetCard

package/types/lua/node.lua

@@ -1,4 +1,4 @@
----@meta node
+---@meta
 ---@class Node
 local _Node = {}
 
@@ -82,5 +82,5 @@ function _Node.createNodeSelector(params)
     return ret
 end
 
-package.loaded['node'] = _Node
-return _Node
+---@type Node
+node = _Node

package/types/lua/paddleocr.lua

@@ -1,4 +1,4 @@
----@meta paddleocr
+---@meta
 ---@class PaddleOCR
 local _PaddleOCR = {}
 
@@ -16,7 +16,8 @@ local _PaddleOCR = {}
 ---@field angle number 文本旋转角度 (度)
 ---@field orientation integer 文本方向 (0=水平,1=垂直 等)
 
---- 加载 V5 模型
+--- 加载 V5 模型（兼容旧接口，请改用 loadModel）
+--- @deprecated 请改用 loadModel("ppocr-v5", useGpu)；检测长边请使用 setMaxSideLen 单独设置。
 --- @param maxSideLen integer|nil 目标边长，默认 640
 --- @param useGpu boolean|nil 是否启用 GPU，默认 false
 --- @return boolean 成功
@@ -33,7 +34,8 @@ function _PaddleOCR.loadModel(modelId, useGpu) return true end
 --- @return boolean 成功
 function _PaddleOCR.setMaxSideLen(maxSideLen) return true end
 
---- 识别文本
+--- 识别文本（兼容旧接口，请改用 recognizeAbs）
+--- @deprecated 请改用 recognizeAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param x integer|nil 默认0
 --- @param y integer|nil 默认0
@@ -61,7 +63,8 @@ function _PaddleOCR.recognizeAbs(input, x, y, ex, ey, confidenceThreshold)
     return ret
 end
 
---- 查找目标文本
+--- 查找目标文本（兼容旧接口，请改用 findTextAbs）
+--- @deprecated 请改用 findTextAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param input string 图像ID或路径
 --- @param targets string[]|string 目标文本数组或逗号分隔字符串
 --- @param x integer|nil 默认0
@@ -96,5 +99,5 @@ end
 --- 释放资源
 function _PaddleOCR.free() end
 
-package.loaded['paddleocr'] = _PaddleOCR
-return _PaddleOCR
+---@type PaddleOCR
+paddleocr = _PaddleOCR

package/types/lua/pip.lua

@@ -1,4 +1,4 @@
----@meta pip
+---@meta
 ---@class Pip
 local _Pip = {}
 
@@ -53,5 +53,5 @@ function _Pip.setCustomTextSize(fontSize) return true end
 ---@return boolean
 function _Pip.setCustomBackgroundColor(color) return true end
 
-package.loaded['pip'] = _Pip
-return _Pip
+---@type Pip
+pip = _Pip

package/types/lua/system.lua

@@ -1,4 +1,4 @@
----@meta system
+---@meta
 ---@class System
 local _System = {}
 
@@ -136,5 +136,5 @@ function _System.getAgentStatus() return false end
 --- @return boolean 成功
 function _System.stopAgent() return true end
 
-package.loaded['system'] = _System
-return _System
+---@type System
+system = _System

package/types/lua/tomatoocr.lua

@@ -1,4 +1,4 @@
----@meta tomatoocr
+---@meta
 ---@class TomatoOCR
 local _TomatoOCR = {}
 
@@ -80,5 +80,5 @@ function _TomatoOCR.findTapPoints(js) return '' end
 --- 释放已加载的 OCR 模型和内部资源
 function _TomatoOCR.release() end
 
-package.loaded['tomatoocr'] = _TomatoOCR
-return _TomatoOCR
+---@type TomatoOCR
+tomatoocr = _TomatoOCR

package/types/lua/tts.lua

@@ -1,4 +1,4 @@
----@meta tts
+---@meta
 ---@class TTS
 local _TTS = {}
 
@@ -39,5 +39,5 @@ function _TTS.getAvailableVoices() return {} end
 --- 释放 TTS 资源
 function _TTS.free() end
 
-package.loaded['tts'] = _TTS
-return _TTS
+---@type TTS
+tts = _TTS

package/types/lua/ui.lua

@@ -1,4 +1,4 @@
----@meta ui
+---@meta
 ---@class UI
 local _UI = {}
 
@@ -43,5 +43,5 @@ function _UI.call(key, data) end
 --- @param code string 代码
 function _UI.eval(code) end
 
-package.loaded['ui'] = _UI
-return _UI
+---@type UI
+ui = _UI

package/types/lua/utils.lua

@@ -1,4 +1,4 @@
----@meta utils
+---@meta
 ---@class Utils
 local _Utils = {}
 
@@ -46,5 +46,5 @@ function _Utils.hexStringBase64Encoded(hexString) return '' end
 --- @return string hex
 function _Utils.hexStringBase64Decoded(base64HexString) return '' end
 
-package.loaded['utils'] = _Utils
-return _Utils
+---@type Utils
+utils = _Utils

package/types/lua/yolo.lua

@@ -1,4 +1,4 @@
----@meta yolo
+---@meta
 ---@class Yolo
 local _Yolo = {}
 
@@ -23,7 +23,8 @@ local _Yolo = {}
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
 
---- 加载 YOLOv11 模型
+--- 加载 YOLOv11 模型（兼容旧接口，请改用 load）
+--- @deprecated 请改用 load(paramPath, binPath, nc, 11, useGpu)。
 --- @param paramPath string ncnn param 路径
 --- @param binPath string ncnn bin 路径
 --- @param nc integer|nil 标签数量；传 0 或省略时按模型输出推断
@@ -31,7 +32,8 @@ function _Yolo.load(paramPath, binPath, nc, version, useGpu) return nil end
 --- @return string|nil 模型ID（失败返回 nil）
 function _Yolo.loadV11(paramPath, binPath, nc, useGpu) return nil end
 
---- 检测
+--- 检测（兼容旧接口，请改用 detectAbs）
+--- @deprecated 请改用 detectAbs，避免裁剪区域坐标和全屏坐标混用。
 --- @param id string 模型ID
 --- @param input string 图像ID或路径
 --- @param target integer 目标边长（默认 640）
@@ -60,5 +62,5 @@ function _Yolo.free(id) end
 --- 释放全部模型
 function _Yolo.freeAll() end
 
-package.loaded['yolo'] = _Yolo
-return _Yolo
+---@type Yolo
+yolo = _Yolo

package/types/lua/yolocls.lua

@@ -1,4 +1,4 @@
----@meta yolocls
+---@meta
 ---@class YoloCls
 local _YoloCls = {}
 
@@ -36,5 +36,5 @@ function _YoloCls.free(modelId) end
 
 function _YoloCls.freeAll() end
 
-package.loaded['yolocls'] = _YoloCls
-return _YoloCls
+---@type YoloCls
+yolocls = _YoloCls

package/types/system.d.ts

@@ -58,6 +58,11 @@ declare namespace system {
    * }
    */
   function activateAppInfo(): AppInfo;
+  /**
+   * 获取前台运行的应用列表
+   * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称
+   */
+  function foregroundAppInfos(): AppInfo[];
   /**
    * 获取后台运行的应用列表
    * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称

package/types/ui.d.ts

@@ -116,6 +116,11 @@ declare namespace ui {
    */
   function show(): void;
 
+  /**
+   * 隐藏WebView
+   */
+  function hide(): void;
+
   /**
    * 设置事件回调函数（仅主线程调用，不能在线程脚本中调用）
    * @param onEvent 事件回调函数，传入 null 会取消监听

package/types/zh//347/263/273/347/273/237/346/250/241/345/235/227.d.ts

@@ -58,6 +58,11 @@ declare namespace $系统 {
    * }
    */
   function 获取当前运行的应用(): APP信息;
+  /**
+   * 获取前台运行的应用列表
+   * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称
+   */
+  function 获取前台运行的应用列表(): APP信息[];
   /**
    * 获取后台运行的应用列表
    * @returns 包含应用信息的字典数组，每个字典包含应用的Bundle ID和显示名称

package/types/zh//350/247/206/345/233/276/346/250/241/345/235/227.d.ts

@@ -9,6 +9,11 @@ declare namespace $视图 {
    */
   function 显示(): 无返回值;
 
+  /**
+   * 隐藏WebView
+   */
+  function 隐藏(): 无返回值;
+
   /**
    * 设置事件回调函数（仅主线程调用，不能在线程脚本中调用）
    * @param onEvent 事件回调函数，传入 null 会取消监听