ms-types 0.5.2 → 0.5.4

package/types/draw.d.ts

@@ -1,98 +1,98 @@
-/**
- * 绘图模块 包含绘制操作等功能
- */
-declare namespace draw {
-  /**
-   * 绘制矩形
-   * @param x 矩形左上角x坐标
-   * @param y 矩形左上角y坐标
-   * @param ex 矩形右下角x坐标
-   * @param ey 矩形右下角y坐标
-   * @param lineWidth 线宽 默认1
-   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
-   * @returns 绘制的矩形ID
-   * @example
-   * draw.drawRect(0, 0, 100, 100);
-   */
-  function drawRect(
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
-    lineWidth?: number,
-    color?: string,
-  ): string;
-
-  /**
-   * 绘制圆
-   * @param x 圆中心x坐标
-   * @param y 圆中心y坐标
-   * @param radius 圆半径
-   * @param lineWidth 线宽 默认1
-   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
-   * @returns 绘制的圆ID
-   * @example
-   * draw.drawCircle(50, 50, 25);
-   */
-  function drawCircle(
-    x: number,
-    y: number,
-    radius: number,
-    lineWidth?: number,
-    color?: string,
-  ): string;
-
-  /**
-   * 绘制文本
-   * @param text 文本内容
-   * @param x 文本左上角x坐标
-   * @param y 文本左上角y坐标
-   * @param ex 文本右下角x坐标
-   * @param ey 文本右下角y坐标
-   * @param fontSize 字体大小 默认12
-   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
-   * @param bgColor 背景颜色 默认透明 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
-   * @returns 绘制的文本ID
-   * @example
-   * draw.drawText("Hello, World!", 0, 0, 100, 100);
-   */
-  function drawText(
-    text: string,
-    x: number,
-    y: number,
-    ex: number,
-    ey: number,
-    fontSize?: number,
-    color?: string,
-    bgColor?: string,
-  ): string;
-
-  /**
-   * 清除绘制的内容
-   * @param id 绘制的内容ID , 不传清除所有绘制内容，传ID清除指定绘制内容
-   * @example
-   * draw.clear("rect1");
-   */
-  function clear(id?: string): void;
-
-  /**
-   * 关闭绘制层并清除绘图模块
-   * @example
-   * draw.close();
-   */
-  function close(): void;
-
-  /**
-   * 显示绘制层
-   * @example
-   * draw.show();
-   */
-  function show(): void;
-
-  /**
-   * 隐藏绘制层
-   * @example
-   * draw.hide();
-   */
-  function hide(): void;
-}
+/**
+ * 绘图模块 包含绘制操作等功能
+ */
+declare namespace draw {
+  /**
+   * 绘制矩形
+   * @param x 矩形左上角x坐标
+   * @param y 矩形左上角y坐标
+   * @param ex 矩形右下角x坐标
+   * @param ey 矩形右下角y坐标
+   * @param lineWidth 线宽 默认1
+   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
+   * @returns 绘制的矩形ID
+   * @example
+   * draw.drawRect(0, 0, 100, 100);
+   */
+  function drawRect(
+    x: number,
+    y: number,
+    ex: number,
+    ey: number,
+    lineWidth?: number,
+    color?: string,
+  ): string;
+
+  /**
+   * 绘制圆
+   * @param x 圆中心x坐标
+   * @param y 圆中心y坐标
+   * @param radius 圆半径
+   * @param lineWidth 线宽 默认1
+   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
+   * @returns 绘制的圆ID
+   * @example
+   * draw.drawCircle(50, 50, 25);
+   */
+  function drawCircle(
+    x: number,
+    y: number,
+    radius: number,
+    lineWidth?: number,
+    color?: string,
+  ): string;
+
+  /**
+   * 绘制文本
+   * @param text 文本内容
+   * @param x 文本左上角x坐标
+   * @param y 文本左上角y坐标
+   * @param ex 文本右下角x坐标
+   * @param ey 文本右下角y坐标
+   * @param fontSize 字体大小 默认12
+   * @param color 颜色 默认#000000 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
+   * @param bgColor 背景颜色 默认透明 支持#RRGGBB、#AARRGGBB、rgb(r,g,b)、rgba(r,g,b,a)格式
+   * @returns 绘制的文本ID
+   * @example
+   * draw.drawText("Hello, World!", 0, 0, 100, 100);
+   */
+  function drawText(
+    text: string,
+    x: number,
+    y: number,
+    ex: number,
+    ey: number,
+    fontSize?: number,
+    color?: string,
+    bgColor?: string,
+  ): string;
+
+  /**
+   * 清除绘制的内容
+   * @param id 绘制的内容ID , 不传清除所有绘制内容，传ID清除指定绘制内容
+   * @example
+   * draw.clear("rect1");
+   */
+  function clear(id?: string): void;
+
+  /**
+   * 关闭绘制层并清除绘图模块
+   * @example
+   * draw.close();
+   */
+  function close(): void;
+
+  /**
+   * 显示绘制层
+   * @example
+   * draw.show();
+   */
+  function show(): void;
+
+  /**
+   * 隐藏绘制层
+   * @example
+   * draw.hide();
+   */
+  function hide(): void;
+}

package/types/global.d.ts

@@ -1,239 +1,243 @@
-/**
- * 是否是调试模式
- */
-declare const __debug__: boolean;
-/**
- * 平台标识
- */
-declare const __platform__: "ios" | "android";
-/**
-/**
- * 应用版本
- */
-declare const __appVersion__: string;
-/**
- * 应用构建号
- */
-declare const __appBuildNumber__: number;
-/**
- * 应用名称
- */
-declare const __appName__: string;
-/**
- * 应用 bundleId
- */
-declare const __bundleId__: string;
-/**
- * 当前线程名称
- */
-declare const __threadName__: string;
-/**
- * 脚本信息
- */
-declare const __package__: {
-  /**
-   * 应用名称
-   */
-  name: string;
-  /**
-   * 应用包名
-   */
-  package: string;
-  /**
-   * 应用版本
-   */
-  appVersion: string;
-  /**
-   * 应用 Id
-   */
-  appId: string;
-  /**
-   * 应用更新参数
-   */
-  update: {
-    /**
-     * 应用更新地址
-     */
-    url: string;
-    /**
-     * 应用更新超时时间
-     */
-    timeout: number;
-  };
-  [key: string]: any;
-};
-
-declare const sharedState: {
-  /**
-   * 设置共享状态
-   * @param key 状态键
-   * @param value 状态值
-   */
-  set: (key: string, value: any) => void;
-  /**
-   * 获取共享状态
-   * @param key 状态键
-   * @returns 状态值
-   */
-  get: (key: string) => any;
-  /**
-   * 批量操作共享状态
-   * @param block 批量操作代码块
-   */
-  withBatch: (block: () => void) => void;
-  /**
-   * 清除所有共享状态
-   */
-  clear: () => void;
-};
-
-/**
- * 设置停止回调（仅主线程调用）
- * @param callback 停止回调
- * @description 脚本执行完成或异常停止时调用，exit 退出不会触发
- * @example
- * setStopCallback(() => {
- *   logi("脚本执行完成");
- * });
- */
-declare function setStopCallback(callback: () => void): void;
-
-/**
- * 设置异常停止回调（仅主线程调用）
- * @param callback 异常停止回调
- * @description 脚本执行异常停止时调用
- * @example
- * setExceptionCallback(() => {
- *   loge("脚本执行异常");
- * });
- */
-declare function setExceptionCallback(callback: () => void): void;
-
-/**
- * 重启脚本（仅主线程调用）
- * @param delay 延迟时间 毫秒
- * @description 重启脚本会延迟指定时间后再重启，不要低于 2000 毫秒
- * @example
- * setExceptionCallback(() => {
- *   restartScript(2000);
- * });
- */
-declare function restartScript(delay: number): void;
-
-/**
- * 线程睡眠
- * @param ms 毫秒
- * @description 线程睡眠会阻塞当前线程，等待指定时间后继续执行
- * @example
- * sleep(1000);
- */
-declare function sleep(ms: number): void | Promise<void>;
-
-/**
- * 退出脚本
- * @param exitAll 是否退出所有线程 true 退出所有 false 退出当前线程，不传默认 false
- * @description 退出脚本会终止所有线程的执行
- * @example
- * exit();
- */
-declare function exit(exitAll?: boolean): void;
-
-/**
- * 获取当前时间戳
- * @returns 时间戳
- * @example
- * const timestamp = time();
- */
-declare function time(): number;
-
-/**
- * 把 app 切换到前台 utils.takeMeToFront 的别名
- * @returns 是否成功切换到前台
- * @see utils.takeMeToFront
- * @description 把 app 切换到前台
- * @example
- * takeMeToFront();
- */
-declare function takeMeToFront(): boolean;
-
-/**
- * 设置是否预加载节点（仅支持内置Agent）
- * @param enable 是否预加载节点
- * @description 设置是否预加载节点，默认 false
- * @example
- * setPreloadNode(true);
- */
-declare function setPreloadNode(enable: boolean): void;
-
-/**
- * 打印调试日志 - 输出调试级别的日志
- * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪
- * @param args 日志消息内容
- * @see logger.debug
- * @example
- * logd("程序开始执行");
- * logd(`当前用户: ${username}`);
- */
-declare function logd(...args: any[]): void;
-
-/**
- * 打印信息日志 - 输出信息级别的日志
- * 用于程序正常运行信息、重要操作的确认、状态变更通知
- * @param args 日志消息内容
- * @see logger.info
- * @example
- * logi("应用程序启动成功");
- * logi("用户登录成功");
- */
-declare function logi(...args: any[]): void;
-declare function println(...args: any[]): void;
-
-/**
- * 打印警告日志 - 输出警告级别的日志
- * 用于潜在的问题、不推荐的操作、性能警告、兼容性问题
- * @param args 日志消息内容
- * @see logger.warn
- * @example
- * logw("电池电量低于 20%");
- * logw("网络连接不稳定");
- */
-declare function logw(...args: any[]): void;
-
-/**
- * 打印错误日志 - 输出错误级别的日志
- * 用于程序错误和异常、操作失败、系统错误、致命问题
- * @param args 日志消息内容
- * @see logger.error
- * @example
- * loge("网络请求失败");
- * loge("文件读取错误");
- */
-declare function loge(...args: any[]): void;
-
-/**
- * 导入类 (仅安卓可用)
- * @param className 类名
- * @returns 类对象
- * @description 导入类对象
- * @example
- * const clazz = importClass("com.example.TestClass");
- */
-declare function importClass(className: string): any;
-
-/**
- * 加载 dex 文件 (仅安卓可用)
- * @param path dex 文件路径 支持apk文件
- * @description 加载 dex 文件到内存中
- * @example
- * loadDex("test.dex");
- */
-declare function loadDex(path: string): void;
-
-/**
- * 获取当前上下文 (仅安卓可用)
- * @returns 当前上下文
- * @description 获取当前上下文
- * @example
- * const context = getContext();
- */
-declare function getContext(): any;
+/**
+ * 是否内置内置Agent
+ */
+declare const __isSupportBuiltAgent__: boolean;
+/**
+ * 是否是调试模式
+ */
+declare const __debug__: boolean;
+/**
+ * 平台标识
+ */
+declare const __platform__: "ios" | "android";
+/**
+/**
+ * 应用版本
+ */
+declare const __appVersion__: string;
+/**
+ * 应用构建号
+ */
+declare const __appBuildNumber__: number;
+/**
+ * 应用名称
+ */
+declare const __appName__: string;
+/**
+ * 应用 bundleId
+ */
+declare const __bundleId__: string;
+/**
+ * 当前线程名称
+ */
+declare const __threadName__: string;
+/**
+ * 脚本信息
+ */
+declare const __package__: {
+  /**
+   * 应用名称
+   */
+  name: string;
+  /**
+   * 应用包名
+   */
+  package: string;
+  /**
+   * 应用版本
+   */
+  appVersion: string;
+  /**
+   * 应用 Id
+   */
+  appId: string;
+  /**
+   * 应用更新参数
+   */
+  update: {
+    /**
+     * 应用更新地址
+     */
+    url: string;
+    /**
+     * 应用更新超时时间
+     */
+    timeout: number;
+  };
+  [key: string]: any;
+};
+
+declare const sharedState: {
+  /**
+   * 设置共享状态
+   * @param key 状态键
+   * @param value 状态值
+   */
+  set: (key: string, value: any) => void;
+  /**
+   * 获取共享状态
+   * @param key 状态键
+   * @returns 状态值
+   */
+  get: (key: string) => any;
+  /**
+   * 批量操作共享状态
+   * @param block 批量操作代码块
+   */
+  withBatch: (block: () => void) => void;
+  /**
+   * 清除所有共享状态
+   */
+  clear: () => void;
+};
+
+/**
+ * 设置停止回调（仅主线程调用）
+ * @param callback 停止回调
+ * @description 脚本执行完成或异常停止时调用，exit 退出不会触发
+ * @example
+ * setStopCallback(() => {
+ *   logi("脚本执行完成");
+ * });
+ */
+declare function setStopCallback(callback: () => void): void;
+
+/**
+ * 设置异常停止回调（仅主线程调用）
+ * @param callback 异常停止回调
+ * @description 脚本执行异常停止时调用
+ * @example
+ * setExceptionCallback(() => {
+ *   loge("脚本执行异常");
+ * });
+ */
+declare function setExceptionCallback(callback: () => void): void;
+
+/**
+ * 重启脚本（仅主线程调用）
+ * @param delay 延迟时间 毫秒
+ * @description 重启脚本会延迟指定时间后再重启，不要低于 2000 毫秒
+ * @example
+ * setExceptionCallback(() => {
+ *   restartScript(2000);
+ * });
+ */
+declare function restartScript(delay: number): void;
+
+/**
+ * 线程睡眠
+ * @param ms 毫秒
+ * @description 线程睡眠会阻塞当前线程，等待指定时间后继续执行
+ * @example
+ * sleep(1000);
+ */
+declare function sleep(ms: number): void | Promise<void>;
+
+/**
+ * 退出脚本
+ * @param exitAll 是否退出所有线程 true 退出所有 false 退出当前线程，不传默认 false
+ * @description 退出脚本会终止所有线程的执行
+ * @example
+ * exit();
+ */
+declare function exit(exitAll?: boolean): void;
+
+/**
+ * 获取当前时间戳
+ * @returns 时间戳
+ * @example
+ * const timestamp = time();
+ */
+declare function time(): number;
+
+/**
+ * 把 app 切换到前台 utils.takeMeToFront 的别名
+ * @returns 是否成功切换到前台
+ * @see utils.takeMeToFront
+ * @description 把 app 切换到前台
+ * @example
+ * takeMeToFront();
+ */
+declare function takeMeToFront(): boolean;
+
+/**
+ * 设置是否预加载节点（仅支持内置Agent）
+ * @param enable 是否预加载节点
+ * @description 设置是否预加载节点，默认 false
+ * @example
+ * setPreloadNode(true);
+ */
+declare function setPreloadNode(enable: boolean): void;
+
+/**
+ * 打印调试日志 - 输出调试级别的日志
+ * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪
+ * @param args 日志消息内容
+ * @see logger.debug
+ * @example
+ * logd("程序开始执行");
+ * logd(`当前用户: ${username}`);
+ */
+declare function logd(...args: any[]): void;
+
+/**
+ * 打印信息日志 - 输出信息级别的日志
+ * 用于程序正常运行信息、重要操作的确认、状态变更通知
+ * @param args 日志消息内容
+ * @see logger.info
+ * @example
+ * logi("应用程序启动成功");
+ * logi("用户登录成功");
+ */
+declare function logi(...args: any[]): void;
+declare function println(...args: any[]): void;
+
+/**
+ * 打印警告日志 - 输出警告级别的日志
+ * 用于潜在的问题、不推荐的操作、性能警告、兼容性问题
+ * @param args 日志消息内容
+ * @see logger.warn
+ * @example
+ * logw("电池电量低于 20%");
+ * logw("网络连接不稳定");
+ */
+declare function logw(...args: any[]): void;
+
+/**
+ * 打印错误日志 - 输出错误级别的日志
+ * 用于程序错误和异常、操作失败、系统错误、致命问题
+ * @param args 日志消息内容
+ * @see logger.error
+ * @example
+ * loge("网络请求失败");
+ * loge("文件读取错误");
+ */
+declare function loge(...args: any[]): void;
+
+/**
+ * 导入类 (仅安卓可用)
+ * @param className 类名
+ * @returns 类对象
+ * @description 导入类对象
+ * @example
+ * const clazz = importClass("com.example.TestClass");
+ */
+declare function importClass(className: string): any;
+
+/**
+ * 加载 dex 文件 (仅安卓可用)
+ * @param path dex 文件路径 支持apk文件
+ * @description 加载 dex 文件到内存中
+ * @example
+ * loadDex("test.dex");
+ */
+declare function loadDex(path: string): void;
+
+/**
+ * 获取当前上下文 (仅安卓可用)
+ * @returns 当前上下文
+ * @description 获取当前上下文
+ * @example
+ * const context = getContext();
+ */
+declare function getContext(): any;