ms-types 0.3.18 → 0.3.20

package/package.json

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

package/types/global.d.ts

@@ -58,10 +58,29 @@ declare const __package__: {
   [key: string]: any;
 };
 
-/**
- * 垃圾回收 手动触发垃圾回收 不要频繁调用
- */
-declare function gc(): void;
+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;
+};
 
 /**
  * 设置停止回调（仅主线程调用）

package/types/thread.d.ts

@@ -1,96 +1,39 @@
 /**
- * 线程模块 包含线程操作、线程回调等功能
+ * 线程模块
  */
 declare namespace thread {
-  /**
-   * 异步执行线程代码
-   * @param threadJsFile 线程js文件路径
-   * @param callbackName 回调函数名称
-   * @param callbackFunc 回调函数
-   * @returns 线程名称
-   * @example
-   * thread.execCodeAsync("thread.js", "callback", (data) => {
-   *   logi(data)
-   *   return "1111"
-   * })
-   *
-   * thread.js
-   * while (true) {
-   *   // 通知主线程并传递数据
-   *   const data = thread.invokeCallback("callback", "hello world")
-   *   // 主线程返回数据
-   *   logi(data)
-   *   sleep(1000)
-   * }
-   */
-  function execCodeAsync(
-    threadJsFile: string,
-    callbackName: string,
-    callbackFunc: (data?: any) => any
-  ): string | null;
-  /**
-   * 调用线程回调函数
-   * @param name 回调函数名称
-   * @param data 回调数据
-   * @returns 回调返回值
-   * @example
-   * const data = thread.invokeCallback("callback", "hello world")
-   * logi(data)
-   */
-  function invokeCallback(name: string, data?: any): any;
-  /**
-   * 创建新线程
-   * @param threadJsFile 线程js文件路径
-   * @returns 线程对象
-   * @example
-   * const newThread = thread.newThread("thread.js")
-   * newThread.addCallback("callback", (data) => {
-   *   logi(data)
-   *   return "1111"
-   * })
-   */
-  function newThread(threadJsFile: string): {
+  class Thread {
     /**
      * 线程名称
      */
     name: string;
     /**
-     * 添加回调函数
-     * @param callbackName 回调函数名称
-     * @param callbackFunc 回调函数
-     * @returns 是否添加成功
+     * 取消线程
+     * @returns 是否取消成功
      */
-    addCallback: (
-      callbackName: string,
-      callbackFunc: (data?: any) => any
-    ) => boolean;
-  } | null;
-  /**
-   * 取消线程
-   * @param name 线程名称
-   * @returns 是否取消成功
-   * @example
-   * const newThread = thread.newThread("thread.js")
-   * newThread.addCallback("callback", (data) => {
-   *   logi(data)
-   *   return "1111"
-   * })
-   * thread.cancelThread(newThread.name)
-   */
-  function cancelThread(name: string): boolean;
+    cancel: () => boolean;
+    /**
+     * 检查线程是否已取消
+     * @returns 是否已取消
+     */
+    isCancelled: () => boolean;
+    /**
+     * 检查线程是否正在执行
+     * @returns 是否正在执行
+     */
+    isExecuting: () => boolean;
+  }
+
   /**
-   * 检查线程是否已取消
-   * @param name 线程名称
-   * @returns 是否已取消
+   * 异步执行线程代码
+   * @param threadFunc 线程函数
+   * @returns 线程对象
    * @example
-   * const newThread = thread.newThread("thread.js")
-   * newThread.addCallback("callback", (data) => {
-   *   logi(data)
-   *   return "1111"
+   * thread.run(() => {
+   *   logi("hello world")
    * })
-   * thread.isCancelled(newThread.name)
    */
-  function isCancelled(name: string): boolean;
+  function run(threadFunc: () => void): Thread;
   /**
    * 停止所有线程
    * @returns 是否停止成功

package/types/zh//345/205/250/345/261/200/346/250/241/345/235/227.d.ts

@@ -46,10 +46,29 @@ declare const $脚本配置: {
   [key: 字符串]: 任意类型;
 };
 
-/**
- * 垃圾回收 手动触发垃圾回收 不要频繁调用
- */
-declare const $垃圾回收: () => 无返回值;
+declare const $共享状态: {
+  /**
+   * 设置共享状态
+   * @param key 状态键
+   * @param value 状态值
+   */
+  设置: (key: 字符串, value: 任意类型) => 无返回值;
+  /**
+   * 获取共享状态
+   * @param key 状态键
+   * @returns 状态值
+   */
+  获取: (key: 字符串) => 任意类型;
+  /**
+   * 批量操作共享状态
+   * @param block 批量操作代码块
+   */
+  批量操作: (block: () => 无返回值) => 无返回值;
+  /**
+   * 清除所有共享状态
+   */
+  清除所有共享状态: () => 无返回值;
+};
 
 /**
  * 设置停止回调（仅主线程调用）

package/types/zh//347/272/277/347/250/213/346/250/241/345/235/227.d.ts

@@ -3,97 +3,42 @@
  * 线程模块 包含线程操作、线程回调等功能
  */
 declare namespace $线程 {
-  /**
-   * 异步执行线程代码
-   * @param 线程js文件路径
-   * @param 回调函数名称
-   * @param 回调函数
-   * @returns 线程名称
-   * @example
-   * const 线程名称 = $线程.执行异步代码("xxx_thread.js", "回调函数名称", (数据) => {
-   *   $打印信息日志(数据)
-   *   return "1111"
-   * })
-   *
-   * thread.js
-   * while (true) {
-   *   // 通知主线程并传递数据
-   *   const 回调返回值 = $线程.调用回调函数("回调函数名称", "hello world")
-   *   // 主线程返回数据
-   *   $打印信息日志(回调返回值)
-   *   $延时(1000)
-   * }
-   */
-  function 执行异步代码(
-    线程js文件路径: 字符串,
-    回调函数名称: 字符串,
-    回调函数: (数据?: 任意类型) => 任意类型
-  ): 字符串 | null;
-  /**
-   * 调用线程回调函数
-   * @param name 回调函数名称
-   * @param data 回调数据
-   * @returns 回调返回值
-   * @example
-   * const 回调返回值 = $线程.调用回调函数("回调函数名称", "hello world")
-   * $打印信息日志(回调返回值)
-   */
-  function 调用回调函数(回调函数名称: 字符串, 数据?: 任意类型): 任意类型;
-  /**
-   * 创建新线程
-   * @param 线程js文件路径
-   * @returns 线程对象
-   * @example
-   * const 新线程 = $线程.创建新线程("xxx_thread.js")
-   * 新线程.添加回调函数("callback", (数据) => {
-   *   $打印信息日志(数据)
-   *   return "1111"
-   * })
-   */
-  function 创建新线程(线程js文件路径: 字符串): {
+  class 线程 {
     /**
      * 线程名称
      */
-    name: 字符串;
+    线程名称: 字符串;
     /**
-     * 添加回调函数
-     * @param 回调函数名称
-     * @param 回调函数
-     * @returns 是否添加成功
+     * 取消线程
+     * @returns 是否取消成功
      */
-    添加回调函数: (
-      回调函数名称: 字符串,
-      回调函数: (数据?: 任意类型) => 任意类型
-    ) => 布尔值;
-  } | null;
-  /**
-   * 取消线程
-   * @param 线程名称
-   * @returns 是否取消成功
-   * @example
-   * const 新线程 = $线程.创建新线程("xxx_thread.js")
-   * 新线程.添加回调函数("回调函数名称", (数据) => {
-   *   $打印信息日志(数据)
-   *   return "1111"
-   * })
-   * $线程.取消线程(新线程.name)
-   */
-  function 取消线程(线程名称: 字符串): 布尔值;
+    取消: () => 布尔值;
+    /**
+     * 检查线程是否已取消
+     * @returns 是否已取消
+     */
+    是否已取消: () => 布尔值;
+    /**
+     * 检查线程是否正在执行
+     * @returns 是否正在执行
+     */
+    是否正在执行: () => 布尔值;
+  }
+
   /**
-   * 检查线程是否已取消
-   * @param 线程名称
-   * @returns 是否已取消
+   * 异步执行线程代码
+   * @param 线程js文件路径
+   * @param 回调函数名称
+   * @param 回调函数
+   * @returns 线程名称
    * @example
-   * const 新线程 = $线程.创建新线程("xxx_thread.js")
-   * 新线程.添加回调函数("回调函数名称", (数据) => {
-   *   $打印信息日志(数据)
-   *   return "1111"
+   * const 线程名称 = $线程.运行(() => {
+   *   $打印信息日志("hello world")
    * })
-   * $线程.是否已被取消(新线程.name)
    */
-  function 是否已被取消(线程名称: 字符串): 布尔值;
+  function 运行(线程函数: () => 无返回值): 线程;
   /**
-   * 停止所有
+   * 停止所有线程
    * @returns 是否停止成功
    * @example
    * $线程.停止所有()