ms-types 0.7.7 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ms-types",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "vitepress": "^1.6.4",
-    "vitepress-theme-teek": "^1.5.7",
-    "wrangler": "^4.85.0"
+    "vitepress-theme-teek": "^1.6.0",
+    "wrangler": "^4.92.0"
   }
 }

package/types/action.d.ts

@@ -186,6 +186,21 @@ declare namespace action {
    */
   function pressButton(button: "home" | "volumeup" | "volumedown"): boolean;
 
+  /**
+   * 发送键盘组合键。
+   *
+   * Action 模块最终发送标准 USB HID Keyboard/Keypad usage。
+   * 参数可以直接传标准 usage 数字，也可以传单个 ASCII 字符、按键名称字符串，
+   * 或现有 hidKey 常量；hidKey 常量会按兼容规则转换为标准 usage。
+   *
+   * @param key 要发送的按键数组
+   * @returns 发送是否成功
+   * @example action.sendKey(["COMMAND", "c"])
+   * @example action.sendKey([0xe3, 0x06])
+   * @example action.sendKey([hidKey.COMMAND, "v"])
+   */
+  function sendKey(key: Array<number | string>): boolean;
+
   /**
    * 执行 W3C Actions JSON
    * @param json W3C Actions 请求体，例如 { actions: [...] }

package/types/global.d.ts

@@ -147,15 +147,6 @@ declare function time(): number;
  */
 declare function takeMeToFront(): boolean;
 
-/**
- * 设置是否预加载节点（仅支持内置Agent）
- * @param enable 是否预加载节点
- * @description 设置是否预加载节点，默认 false
- * @example
- * setPreloadNode(true);
- */
-declare function setPreloadNode(enable: boolean): void;
-
 /**
  * 打印调试日志 - 输出调试级别的日志
  * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪

package/types/hid.d.ts

@@ -122,7 +122,7 @@ declare namespace hid {
    * 点击指定坐标
    * @param x 点击坐标的X轴
    * @param y 点击坐标的Y轴
-   * @param duration 点击持续时间（可选，默认值为10毫秒）
+   * @param duration 点击持续时间（可选，默认值为20毫秒）
    * @param jitter 是否添加随机抖动（可选，默认值为false）
    * @returns 操作是否成功
    */

package/types/node.d.ts

@@ -64,10 +64,6 @@ declare interface NodeInfo {
    * 节点名称
    */
   title: string;
-  /**
-   * 节点是否可见
-   */
-  visible: boolean;
   /**
    * 节点是否启用
    */
@@ -256,12 +252,6 @@ declare class NodeSelector {
    * @returns 节点选择器
    */
   enabled(enabled: boolean): NodeSelector;
-  /**
-   * 获取节点是否可见
-   * @param visible 是否可见
-   * @returns 节点选择器
-   */
-  visible(visible: boolean): NodeSelector;
   /**
    * 获取节点索引
    * @param index 节点索引

package/types/zh/HID/346/250/241/345/235/227.d.ts

@@ -124,7 +124,7 @@ declare namespace $HID {
    * 点击指定坐标
    * @param 坐标x 点击坐标的X轴
    * @param 坐标y 点击坐标的Y轴
-   * @param 按下持续时间 点击持续时间（可选，默认值为10毫秒）
+   * @param 按下持续时间 点击持续时间（可选，默认值为20毫秒）
    * @param 抖动 是否添加随机抖动（可选，默认值为false）
    * @returns 操作是否成功
    */

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

@@ -143,15 +143,6 @@ declare function $获取当前时间戳(): 数字;
  */
 declare function $APP切入前台(): 无返回值;
 
-/**
- * 设置是否预加载节点（仅支持内置Agent）
- * @param enable 是否预加载节点
- * @description 设置是否预加载节点，默认 false
- * @example
- * $设置预加载节点(true);
- */
-declare function $设置预加载节点(enable: 布尔值): 无返回值;
-
 /**
  * 打印调试日志 - 输出调试级别的日志
  * 用于详细的程序执行信息、变量值和状态信息、函数调用跟踪

package/types/zh//345/212/250/344/275/234/346/250/241/345/235/227.d.ts

@@ -188,6 +188,20 @@ declare namespace $动作 {
    */
   function 按键(按键: "home" | "volumeup" | "volumedown"): 布尔值;
 
+  /**
+   * 发送键盘组合键。
+   *
+   * 动作模块最终发送标准 USB HID Keyboard/Keypad usage。
+   * 参数可以直接传标准 usage 数字，也可以传单个 ASCII 字符、按键名称字符串，
+   * 或现有 hidKey 常量；hidKey 常量会按兼容规则转换为标准 usage。
+   *
+   * @param 按键 要发送的按键数组
+   * @returns 发送是否成功
+   * @example $动作.发送按键(["COMMAND", "c"])
+   * @example $动作.发送按键([0xe3, 0x06])
+   */
+  function 发送按键(按键: 数组<数字 | 字符串>): 布尔值;
+
   /**
    * 执行 W3C Actions JSON
    * @param json W3C Actions 请求体，例如 { actions: [...] }

package/types/zh//350/212/202/347/202/271/346/250/241/345/235/227.d.ts

@@ -62,10 +62,6 @@ declare interface $节点信息 {
    * 节点名称
    */
   title: 字符串;
-  /**
-   * 节点是否可见
-   */
-  visible: 布尔值;
   /**
    * 节点是否启用
    */
@@ -254,12 +250,6 @@ declare class $节点选择器 {
    * @returns 节点选择器
    */
   enabled(enabled: 布尔值): $节点选择器;
-  /**
-   * 获取节点是否可见
-   * @param visible 是否可见
-   * @returns 节点选择器
-   */
-  visible(visible: 布尔值): $节点选择器;
   /**
    * 获取节点索引
    * @param index 节点索引