ms-types 0.0.65 → 0.0.67

package/package.json

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

package/types/appleOcr.d.ts

@@ -40,15 +40,15 @@ declare namespace appleOcr {
    * @example
    * const results = appleOcr.recognize("screen", 0, 0, 100, 100, ["zh-Hans", "en-US"])
    * results.forEach(result => {
-   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   *   logi(`文本: ${result.text}, 置信度: ${result.confidence}`)
    * })
    */
   function recognize(
     input: string,
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
+    x?: number,
+    y?: number,
+    ex?: number,
+    ey?: number,
     languages?: string[]
   ): OCRResult[];
 
@@ -63,15 +63,15 @@ declare namespace appleOcr {
    * @example
    * const results = appleOcr.recognizeNumbers("screen", 0, 0, 100, 100)
    * results.forEach(result => {
-   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   *   logi(`文本: ${result.text}, 置信度: ${result.confidence}`)
    * })
    */
   function recognizeNumbers(
     input: string,
-    x: number,
-    y: number,
-    ex: number,
-    ey: number
+    x?: number,
+    y?: number,
+    ex?: number,
+    ey?: number
   ): OCRResult[];
 
   /**
@@ -87,16 +87,16 @@ declare namespace appleOcr {
    * @example
    * const results = appleOcr.findText("screen", ["123", "456"], 0, 0, 100, 100, ["zh-Hans", "en-US"])
    * results.forEach(result => {
-   *   logger.info(`文本: ${result.text}, 置信度: ${result.confidence}`)
+   *   logi(`文本: ${result.text}, 置信度: ${result.confidence}`)
    * })
    */
   function findText(
     input: string,
     texts: string[],
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
+    x?: number,
+    y?: number,
+    ex?: number,
+    ey?: number,
     languages?: string[]
   ): OCRResult[];
 }

package/types/file.d.ts

@@ -68,11 +68,7 @@ declare namespace file {
    * @returns 是否删除成功
    * @example file.deleteLine("config.json", 1, null)
    */
-  function deleteLine(
-    path: string,
-    line: number,
-    contains: string | null
-  ): boolean;
+  function deleteLine(path: string, line: number, contains?: string): boolean;
   /**
    * 列出目录下所有文件
    * @param path 目录路径

package/types/hotUpdate.d.ts

@@ -2,52 +2,50 @@
  * 热更新模块类型定义
  * 提供应用热更新功能，包括检查更新、下载更新包、MD5校验等
  */
+declare namespace hotUpdate {
+  /**
+   * 热更新检查结果
+   */
+  interface HotUpdateResult {
+    /** 是否需要更新 */
+    needUpdate: boolean;
+    /** 错误信息（当检查失败时） */
+    error?: string;
+    /** 服务器返回的更新数据（当 needUpdate 为 true 时） */
+    data?: HotUpdateResponse;
+  }
 
-/**
- * 热更新检查结果
- */
-interface HotUpdateResult {
-  /** 是否需要更新 */
-  needUpdate: boolean;
-  /** 错误信息（当检查失败时） */
-  error?: string;
-  /** 服务器返回的更新数据（当 needUpdate 为 true 时） */
-  data?: HotUpdateResponse;
-}
-
-/**
- * 热更新服务器响应数据结构
- */
-interface HotUpdateResponse {
-  /** 新包的下载地址 */
-  download_url: string;
-  /** 新包的版本号 */
-  version: number;
-  /** 下载msbundle文件超时时间（秒） */
-  download_timeout: number;
-  /** 是否用对话框的形式展示 */
-  dialog: boolean;
-  /** 对话框中要显示的消息 */
-  msg: string;
-  /** 对话框模式下是否强制更新 */
-  force: boolean;
-  /** 更新包文件的MD5值，用于校验文件完整性 */
-  md5?: string;
-}
-
-/**
- * 热更新配置选项
- */
-interface HotUpdateOptions {
-  /** 检查更新的服务器URL，未提供时从 package.json 的 update.url 读取 */
-  url?: string;
-  /** 当前版本号，未提供时从 package.json 的 appVersion 读取 */
-  version?: number;
-  /** 超时时间（毫秒），未提供时从 package.json 的 update.timeout 读取，默认10000毫秒 */
-  timeout?: number;
-}
+  /**
+   * 热更新服务器响应数据结构
+   */
+  interface HotUpdateResponse {
+    /** 新包的下载地址 */
+    download_url: string;
+    /** 新包的版本号 */
+    version: number;
+    /** 下载msbundle文件超时时间（秒） */
+    download_timeout: number;
+    /** 是否用对话框的形式展示 */
+    dialog: boolean;
+    /** 对话框中要显示的消息 */
+    msg: string;
+    /** 对话框模式下是否强制更新 */
+    force: boolean;
+    /** 更新包文件的MD5值，用于校验文件完整性 */
+    md5?: string;
+  }
 
-declare namespace hotUpdate {
+  /**
+   * 热更新配置选项
+   */
+  interface HotUpdateOptions {
+    /** 检查更新的服务器URL，未提供时从 package.json 的 update.url 读取 */
+    url?: string;
+    /** 当前版本号，未提供时从 package.json 的 appVersion 读取 */
+    version?: number;
+    /** 超时时间（毫秒），未提供时从 package.json 的 update.timeout 读取，默认10000毫秒 */
+    timeout?: number;
+  }
   /**
    * 检查更新（同步调用）
    * @param options 更新配置选项（可选，不传则从package.json读取配置）
@@ -63,12 +61,12 @@ declare namespace hotUpdate {
    * });
    *
    * if (result.needUpdate) {
-   *   logger.info('发现新版本');
+   *   logi('发现新版本');
    *   // 手动决定是否更新
    *   const installResult = hotUpdate.downloadAndInstall();
-   *   logger.info('安装结果:', installResult);
+   *   logi('安装结果:', installResult);
    * } else {
-   *   logger.error('检查更新失败:', result.error);
+   *   loge('检查更新失败:', result.error);
    * }
    */
   function checkUpdate(options?: HotUpdateOptions): HotUpdateResult;
@@ -82,9 +80,9 @@ declare namespace hotUpdate {
    * if (checkResult.needUpdate) {
    *   const installResult = hotUpdate.downloadAndInstall();
    *   if (installResult.updated) {
-   *     logger.info('更新安装成功');
+   *     logi('更新安装成功');
    *   } else {
-   *     logger.error('更新安装失败:', installResult.error);
+   *     loge('更新安装失败:', installResult.error);
    *   }
    * }
    * ```
@@ -100,7 +98,7 @@ declare namespace hotUpdate {
    * @returns {number} 当前版本号，如果获取失败则返回 0
    * @example
    * const version = hotUpdate.getCurrentVersion();
-   * logger.info('当前版本:', version); // 输出: 当前版本: 123
+   * logi('当前版本:', version); // 输出: 当前版本: 123
    */
   function getCurrentVersion(): number;
 }

package/types/http.d.ts

@@ -288,7 +288,7 @@ declare namespace http {
    * const ws = http.newWebsocket("ws://www.baidu.com")
    * ws.connect()
    * ws.onText((data) => {
-   *   logger.info(data)
+   *   logi(data)
    * })
    * ws.sendText("hello")
    * ws.close()

package/types/image.d.ts

@@ -54,7 +54,7 @@ declare namespace image {
    * @example
    * const size = image.getSize(imageId)
    * if (size) {
-   *   logger.info(size.width, size.height)
+   *   logi(size.width, size.height)
    * }
    */
   function getSize(imageId: string): { width: number; height: number } | null;
@@ -109,7 +109,7 @@ declare namespace image {
    * if (imageId) {
    *   const isSame = image.cmpColor(imageId, "1|2|#6DD1E6-#101010", 10, 0, 0, 100, 100)
    *   if (isSame) {
-   *     logger.info("颜色相同")
+   *     logi("颜色相同")
    *   }
    * }
    */
@@ -139,7 +139,7 @@ declare namespace image {
    * if (imageId) {
    *   const points = image.findColor(imageId, "0x6DD1E6-0x101010", 10, 0, 0, 100, 100, 1, 1)
    *   if (points.length > 0) {
-   *     logger.info("找到颜色")
+   *     logi("找到颜色")
    *   }
    * }
    * image.release(imageId)
@@ -173,7 +173,7 @@ declare namespace image {
    * if (imageId) {
    *   const points = image.findMultiColor(imageId, "0x6DD1E6-0x101010", 10, "1|2|#6DD1E6-#101010", 0, 0, 100, 100, 1, 1)
    *   if (points.length > 0) {
-   *     logger.info("找到颜色")
+   *     logi("找到颜色")
    *   }
    * }
    * image.release(imageId)
@@ -205,7 +205,7 @@ declare namespace image {
    * @example
    * const points = image.findImage("screen", "template.jpg", 0, 0, 100, 100, 0.8, 1, 5)
    * if (points.length > 0) {
-   *   logger.info("找到图片")
+   *   logi("找到图片")
    * }
    */
   function findImage(
@@ -242,7 +242,7 @@ declare namespace image {
    * if (imageId) {
    *   const clipImageId = image.clip(imageId, 0, 0, 100, 100)
    *   if (clipImageId) {
-   *     logger.info("裁剪成功")
+   *     logi("裁剪成功")
    *   }
    * }
    * image.release(imageId)
@@ -264,7 +264,7 @@ declare namespace image {
    * const imageId = image.readImage("screen.jpg")
    * if (imageId) {
    *   const color = image.pixel(imageId, 0, 0)
-   *   logger.info(color)
+   *   logi(color)
    * }
    * image.release(imageId)
    */
@@ -278,7 +278,7 @@ declare namespace image {
    * const imageId = image.readImage("screen.jpg")
    * if (imageId) {
    *   const color = image.pixel(imageId, 0, 0)
-   *   logger.info(image.argb(imageId, color))
+   *   logi(image.argb(imageId, color))
    * }
    * image.release(imageId)
    */
@@ -293,7 +293,7 @@ declare namespace image {
    * if (imageId) {
    *   const binaryzationImageId = image.binaryzation(imageId, 128)
    *   if (binaryzationImageId) {
-   *     logger.info("二值化成功")
+   *     logi("二值化成功")
    *   }
    * }
    * image.release(imageId)
@@ -308,7 +308,7 @@ declare namespace image {
    * if (imageId) {
    *   const grayImageId = image.gray(imageId)
    *   if (grayImageId) {
-   *     logger.info("灰度化成功")
+   *     logi("灰度化成功")
    *   }
    * }
    * image.release(imageId)
@@ -321,7 +321,7 @@ declare namespace image {
    * @example
    * const imageId = image.base64ToImage("data:image/jpg;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+P+/HgAFhAJ/wlseKgAAAABJRU5ErkJggg==")
    * if (imageId) {
-   *   logger.info("base64转图片成功")
+   *   logi("base64转图片成功")
    * }
    * image.release(imageId)
    */
@@ -336,12 +336,25 @@ declare namespace image {
    * const imageId = image.readImage("screen.jpg")
    * if (imageId) {
    *   const base64 = image.toBase64Format(imageId, "jpg", 100)
-   *   logger.info(base64)
+   *   logi(base64)
    * }
    * image.release(imageId)
    */
   function toBase64Format(imageId: string, format: string, q: number): string;
-
+  /**
+   * 扫描条码 支持一维码和二维码
+   * @param imageId 图片id
+   * @returns 条码内容
+   * @example
+   * const imageId = image.readImage("screen.jpg")
+   * if (imageId) {
+   *   const code = image.scanCode(imageId)
+   *   if (code) {
+   *     logi(code)
+   *   }
+   * }
+   */
+  function scanCode(imageId: string): string | null;
   /**
    * 绘制矩形
    * @param imageId 图片id

package/types/ime.d.ts

@@ -7,7 +7,7 @@ declare namespace ime {
    * @returns {boolean} 如果输入法键盘是否已弹出返回 true，否则返回 false
    * @example
    * if (ime.isOk()) {
-   *   logger.info("输入法已启动")
+   *   logi("输入法已启动")
    * }
    */
   function isOk(): boolean;
@@ -16,7 +16,7 @@ declare namespace ime {
    * @returns {string} 当前输入框的完整文本
    * @example
    * const text = ime.getText()
-   * logger.info(text)
+   * logi(text)
    */
   function getText(): string;
   /**
@@ -31,7 +31,7 @@ declare namespace ime {
    * @returns {string} 输入后的文本内容 失败返回空字符串
    * @example
    * const text = ime.input("hello")
-   * logger.info(text)
+   * logi(text)
    */
   function input(text: string): string;
   /**
@@ -40,7 +40,7 @@ declare namespace ime {
    * @returns {string} 粘贴后的文本内容 失败返回空字符串
    * @example
    * const text = ime.paste("hello")
-   * logger.info(text)
+   * logi(text)
    */
   function paste(text?: string): string;
   /**
@@ -48,7 +48,7 @@ declare namespace ime {
    * @returns {string} 如果为空，代表输入框无数据，如果不为空，代表输入框剩余数据
    * @example
    * const text = ime.pressDel()
-   * logger.info(text)
+   * logi(text)
    */
   function pressDel(): string;
   /**
@@ -56,7 +56,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.pressEnter()) {
-   *   logger.info("回车键按下")
+   *   logi("回车键按下")
    * }
    */
   function pressEnter(): boolean;
@@ -65,7 +65,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.dismiss()) {
-   *   logger.info("键盘已隐藏")
+   *   logi("键盘已隐藏")
    * }
    */
   function dismiss(): boolean;
@@ -74,7 +74,7 @@ declare namespace ime {
    * @returns {string} 剪贴板内容
    * @example
    * const text = ime.getClipboard()
-   * logger.info(text)
+   * logi(text)
    */
   function getClipboard(): string;
   /**
@@ -83,7 +83,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.setClipboard("hello")) {
-   *   logger.info("剪贴板内容已设置")
+   *   logi("剪贴板内容已设置")
    * }
    */
   function setClipboard(text: string): boolean;
@@ -92,7 +92,7 @@ declare namespace ime {
    * @returns {boolean} 如果成功返回 true，否则返回 false
    * @example
    * if (ime.switchKeyboard()) {
-   *   logger.info("键盘已切换")
+   *   logi("键盘已切换")
    * }
    */
   function switchKeyboard(): boolean;

package/types/media.d.ts

@@ -11,7 +11,7 @@ declare namespace media {
    * if (imageId) {
    *   const saved = media.saveImageToAlbum(imageId)
    *   if (saved) {
-   *     logger.info("保存成功")
+   *     logi("保存成功")
    *   }
    * }
    */
@@ -24,7 +24,7 @@ declare namespace media {
    * @example
    * const saved = media.saveVideoToAlbumPath("video.mp4")
    * if (saved) {
-   *   logger.info("保存成功")
+   *   logi("保存成功")
    * }
    */
   function saveVideoToAlbumPath(path: string): boolean;
@@ -35,7 +35,7 @@ declare namespace media {
    * @example
    * const deleted = media.deleteAllPhotos()
    * if (deleted) {
-   *   logger.info("删除成功")
+   *   logi("删除成功")
    * }
    */
   function deleteAllPhotos(): boolean;
@@ -46,7 +46,7 @@ declare namespace media {
    * @example
    * const deleted = media.deleteAllVideos()
    * if (deleted) {
-   *   logger.info("删除成功")
+   *   logi("删除成功")
    * }
    */
   function deleteAllVideos(): boolean;
@@ -59,7 +59,7 @@ declare namespace media {
    * @example
    * const played = media.playMp3("music.mp3", true)
    * if (played) {
-   *   logger.info("播放成功")
+   *   logi("播放成功")
    * }
    */
   function playMp3(path: string, loop: boolean): boolean;
@@ -70,7 +70,7 @@ declare namespace media {
    * @example
    * const stopped = media.stopMp3()
    * if (stopped) {
-   *   logger.info("停止成功")
+   *   logi("停止成功")
    * }
    */
   function stopMp3(): boolean;
@@ -83,7 +83,7 @@ declare namespace media {
    * @example
    * const played = media.playMp3WaitEnd("music.mp3", true)
    * if (played) {
-   *   logger.info("播放成功")
+   *   logi("播放成功")
    * }
    */
   function playMp3WaitEnd(path: string, loop: boolean): boolean;

package/types/mysql.d.ts

@@ -51,7 +51,7 @@ declare namespace mysql {
    * })
    *
    * if (connected) {
-   *   logger.info("数据库连接成功")
+   *   logi("数据库连接成功")
    * }
    */
   function connect(config: MySQLConfig): boolean;
@@ -68,7 +68,7 @@ declare namespace mysql {
    * @returns 是否已连接
    * @example
    * if (mysql.isConnected()) {
-   *   logger.info("数据库已连接")
+   *   logi("数据库已连接")
    * }
    */
   function isConnected(): boolean;
@@ -87,9 +87,9 @@ declare namespace mysql {
    *
    * // 处理结果
    * if (result.success) {
-   *   logger.info("查询到 " + result.rows.length + " 条记录")
+   *   logi("查询到 " + result.rows.length + " 条记录")
    *   result.rows.forEach(row => {
-   *     logger.info(row)
+   *     logi(row)
    *   })
    * } else {
    *   console.error("查询失败: " + result.error)
@@ -120,9 +120,9 @@ declare namespace mysql {
    *
    * // 处理结果
    * if (result.success) {
-   *   logger.info("影响了 " + result.affectedRows + " 行")
+   *   logi("影响了 " + result.affectedRows + " 行")
    *   if (result.insertId) {
-   *     logger.info("新插入记录的ID: " + result.insertId)
+   *     logi("新插入记录的ID: " + result.insertId)
    *   }
    * } else {
    *   console.error("执行失败: " + result.error)
@@ -139,7 +139,7 @@ declare namespace mysql {
    *     mysql.execute("INSERT INTO users (name) VALUES (?)", ["用户1"])
    *     mysql.execute("INSERT INTO users (name) VALUES (?)", ["用户2"])
    *     mysql.commit()
-   *     logger.info("事务提交成功")
+   *     logi("事务提交成功")
    *   } catch (error) {
    *     mysql.rollback()
    *     console.error("事务回滚")
@@ -155,7 +155,7 @@ declare namespace mysql {
    * mysql.beginTransaction()
    * mysql.execute("INSERT INTO users (name) VALUES (?)", ["测试用户"])
    * if (mysql.commit()) {
-   *   logger.info("事务提交成功")
+   *   logi("事务提交成功")
    * }
    */
   function commit(): boolean;
@@ -167,7 +167,7 @@ declare namespace mysql {
    * mysql.beginTransaction()
    * mysql.execute("INSERT INTO users (name) VALUES (?)", ["测试用户"])
    * if (mysql.rollback()) {
-   *   logger.info("事务回滚成功")
+   *   logi("事务回滚成功")
    * }
    */
   function rollback(): boolean;

package/types/netCard.d.ts

@@ -3,6 +3,9 @@ declare namespace netCard {
    * 验证卡密
    * @param cardNo 卡密
    * @returns 是否验证成功
+   * @example
+   * const isVerified = netCard.verify("1234567890")
+   * logi(isVerified)
    */
   function verify(cardNo: string): boolean;
 
@@ -10,6 +13,9 @@ declare namespace netCard {
    * 设置卡密备注
    * @param remark 备注
    * @returns 是否设置成功
+   * @example
+   * const isSet = netCard.setCardRemark("我的卡密")
+   * logi(isSet)
    */
   function setCardRemark(remark: string): boolean;
 
@@ -18,6 +24,9 @@ declare namespace netCard {
    * @param key 键
    * @param value 值
    * @returns 成功返回设置的value，失败返回空字符串
+   * @example
+   * const value = netCard.setValue("cardNo", "1234567890")
+   * logi(value)
    */
   function setValue(key: string, value: string): string;
 
@@ -25,6 +34,9 @@ declare namespace netCard {
    * 获取值
    * @param key 键
    * @returns 成功返回值，失败返回空字符串
+   * @example
+   * const value = netCard.getValue("cardNo")
+   * logi(value)
    */
   function getValue(key: string): string;
 }

package/types/node.d.ts

@@ -5,15 +5,15 @@ declare function createNodeSelector(params?: {
   /**
    *  1 代表不管visible是true还是false都获取，2 代表只获取 visible=true的节点
    */
-  visibleFilter: number;
+  visibleFilter: 1 | 2;
   /**
    *  1 代表不管label是否有值都获取，2 代表只获取label有值的节点
    */
-  labelFilter: number;
+  labelFilter: 1 | 2;
   /**
    *  1 代表不过滤 2 bounds 区域属性x,y,w,h都小于0就被过滤
    */
-  boundsFilter: number;
+  boundsFilter: 1 | 2;
   /**
    * 代表要获取节点的层级，越少速度越快，建议 1 - 50
    */

package/types/paddleOcr.d.ts

@@ -39,7 +39,7 @@ declare namespace paddleOcr {
    * @example
    * const loaded = paddleOcr.loadV5(640)
    * if (loaded) {
-   *   logger.info("加载成功")
+   *   logi("加载成功")
    * }
    */
   function loadV5(maxSideLen?: number): boolean;
@@ -55,15 +55,15 @@ declare namespace paddleOcr {
    * @example
    * const results = paddleOcr.recognize("screen", 0, 0, 100, 100)
    * if (results.length > 0) {
-   *   logger.info("识别到文本")
+   *   logi("识别到文本")
    * }
    */
   function recognize(
     input: string,
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
+    x?: number,
+    y?: number,
+    ex?: number,
+    ey?: number,
     confidenceThreshold?: number
   ): OCRResult[];
   /**