ms-types 0.7.8 → 0.8.1

package/package.json

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

package/types/action.d.ts

@@ -159,6 +159,17 @@ declare namespace action {
    * @example action.input("123456")
    */
   function input(text: string): boolean;
+  /**
+   * 输入基础文本。
+   *
+   * 不使用剪切板或 IME，而是把文本字符数组一次性传给 Action 模块的 sendKey。
+   * 仅支持可映射为 USB HID Keyboard/Keypad usage 的 ASCII 字符，不支持中文。
+   *
+   * @param text 文本内容
+   * @returns 输入是否成功
+   * @example action.inputSimple("hello_123")
+   */
+  function inputSimple(text: string): boolean;
   /**
    * 删除文本
    * @param count 删除数量 默认为1
@@ -186,6 +197,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/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

@@ -156,11 +156,22 @@ declare namespace $动作 {
   ): 布尔值;
   /**
    * 输入文本
-   * @param text 文本内容
+   * @param 文本 文本内容
    * @returns 输入文本是否成功
    * @example $动作.输入文本("123456")
    */
   function 输入文本(文本: 字符串): 布尔值;
+  /**
+   * 输入基础文本。
+   *
+   * 不使用剪切板或 IME，而是把文本字符数组一次性传给动作模块的 发送按键。
+   * 仅支持可映射为 USB HID Keyboard/Keypad usage 的 ASCII 字符，不支持中文。
+   *
+   * @param 文本 文本内容
+   * @returns 输入是否成功
+   * @example $动作.输入简易文本("hello_123")
+   */
+  function 输入简易文本(文本: 字符串): 布尔值;
   /**
    * 删除文本
    * @param 删除数量 默认为1
@@ -188,6 +199,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: [...] }