@bettergi/types 0.1.6 → 0.1.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bread Grocery
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/index.d.ts

@@ -19,6 +19,9 @@
 // 消息通知
 /// <reference path="./objects/notification.d.ts" />
 
+// 键鼠回调
+/// <reference path="./objects/keyMouseHook.d.ts" />
+
 // 任务调用
 /// <reference path="./objects/dispatcher.d.ts" />
 

package/objects/keyMouseHook.d.ts

@@ -0,0 +1,70 @@
+import { type KeyCodeString, type KeyDataString } from "../types/System/Windows/Forms/Keys";
+
+type MouseButton = "Left" | "Right" | "Middle" | "XButton1" | "XButton2";
+
+declare global {
+  /** @since 0.55.0 */
+  namespace keyMouseHook {
+    /**
+     * 注册键盘按下事件回调
+     * @param callback 回调函数
+     * @param useCodeOnly 是否仅返回 KeyCode，否则返回 KeyData（默认为 true）
+     * @since 0.55.0
+     */
+    function onKeyDown(callback: (keyCode: KeyCodeString) => void, useCodeOnly?: true): void;
+    // overload
+    function onKeyDown(callback: (keyData: KeyDataString) => void, useCodeOnly: false): void;
+
+    /**
+     * 注册键盘释放事件回调
+     * @param callback 回调函数
+     * @param useCodeOnly 是否仅返回 KeyCode，否则返回 KeyData（默认为 true）
+     * @since 0.55.0
+     */
+    function onKeyUp(callback: (keyCode: KeyCodeString) => void, useCodeOnly?: true): void;
+    // overload
+    function onKeyUp(callback: (keyData: KeyDataString) => void, useCodeOnly: false): void;
+
+    /**
+     * 注册鼠标移动事件回调
+     * @param callback 回调函数
+     * @since 0.55.0
+     */
+    function onMouseDown(callback: (button: MouseButton) => void): void;
+
+    /**
+     * 注册鼠标释放事件回调
+     * @param callback 回调函数
+     * @since 0.55.0
+     */
+    function onMouseUp(callback: (keyCode: MouseButton) => void): void;
+
+    /**
+     * 注册鼠标移动事件回调
+     * @param callback 回调函数
+     * @param interval 回调节流间隔（单位：毫秒，默认值：200）
+     */
+    function onMouseMove(callback: (x: number, y: number) => void, interval: number = 200): void;
+
+    /**
+     * 注册鼠标滚轮事件回调
+     * @param callback 回调函数
+     * @since 0.55.0
+     */
+    function onMouseWheel(callback: (delta: number, x: number, y: number) => void): void;
+
+    /**
+     * 清空回调列表
+     * @since 0.55.0
+     */
+    function removeAllListeners(): void;
+
+    /**
+     * 取消所有注册键鼠事件回调
+     * @since 0.55.0
+     */
+    function dispose(): void;
+  }
+}
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/types",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "BetterGI TypeScript 类型定义",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",
@@ -21,5 +21,8 @@
   ],
   "dependencies": {
     "mirada": "^0.0.15"
+  },
+  "scripts": {
+    "release": "pnpm publish --access public"
   }
-}
+}

package/types/BetterGenshinImpact/GameTask/AutoDomain/AutoDomainTask.d.ts

@@ -1,5 +1,6 @@
 import "../../../System/Collections/Generic/List";
 import "../../../System/Threading/CancellationToken";
+import "../../../System/Tuple";
 import "../../GameTask/Model/Area/ImageRegion";
 import "../../GameTask/Model/Area/Region";
 import "../ISoloTask";
@@ -20,7 +21,7 @@ declare global {
       static pressUseResin(
         ra: BetterGenshinImpact.GameTask.Model.Area.ImageRegion,
         resinName: string
-      ): [boolean, number];
+      ): System.Tuple2<boolean, number>;
 
       /**
        * 点击使用树脂
@@ -30,7 +31,7 @@ declare global {
       static pressUseResin(
         regionList: System.Collections.Generic.List<BetterGenshinImpact.GameTask.Model.Area.Region>,
         resinName: string
-      ): [boolean, number];
+      ): System.Tuple2<boolean, number>;
 
       constructor(taskParam: BetterGenshinImpact.GameTask.AutoDomain.AutoDomainParam);
     }

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightTask.d.ts

@@ -1,5 +1,6 @@
 import "../../../System/Collections/Generic/List";
 import "../../../System/Threading/CancellationToken";
+import "../../../System/Tuple";
 import "../../GameTask/Model/Area/ImageRegion";
 import "../../GameTask/Model/Area/Region";
 import "../ISoloTask";
@@ -20,7 +21,7 @@ declare global {
       static pressUseResin(
         ra: BetterGenshinImpact.GameTask.Model.Area.ImageRegion,
         resinName: string
-      ): [boolean, number];
+      ): System.Tuple2<boolean, number>;
 
       /**
        * 点击使用树脂
@@ -30,7 +31,7 @@ declare global {
       static pressUseResin(
         regionList: System.Collections.Generic.List<BetterGenshinImpact.GameTask.Model.Area.Region>,
         resinName: string
-      ): [boolean, number];
+      ): System.Tuple2<boolean, number>;
 
       constructor(taskParam: BetterGenshinImpact.GameTask.AutoFight.AutoFightParam);
     }

package/types/BetterGenshinImpact/GameTask/Model/Area/Converter/INodeConverter.d.ts

@@ -1,7 +1,14 @@
+import "../../../../../System/Tuple";
+
 declare global {
   namespace BetterGenshinImpact.GameTask.Model.Area.Converter {
     interface INodeConverter {
-      toPrev(x: number, y: number, w: number, h: number): [number, number, number, number];
+      toPrev(
+        x: number,
+        y: number,
+        w: number,
+        h: number
+      ): System.Tuple4<number, number, number, number>;
     }
   }
 }

package/types/BetterGenshinImpact/GameTask/Model/Area/Region.d.ts

@@ -1,6 +1,7 @@
 import { Rect } from "mirada/dist/src/types/opencv";
 import "../../../../System/Drawing/Pen";
 import "../../../../System/IDisposable";
+import "../../../../System/Tuple";
 import "../../../GameTask/Model/Area/Converter/INodeConverter";
 import "../../../GameTask/Model/Area/ImageRegion";
 import "../../../View/Drawable/LineDrawable";
@@ -165,10 +166,10 @@ declare global {
       convertPositionToGameCaptureRegion(x: number, y: number, w: number, h: number): Rect;
 
       /** 将指定区域的截图转换成位置元组 */
-      convertPositionToGameCaptureRegion(x: number, y: number): [number, number];
+      convertPositionToGameCaptureRegion(x: number, y: number): System.Tuple2<number, number>;
 
       /** 将指定桌面区域的截图转换成位置元组 */
-      convertPositionToDesktopRegion(x: number, y: number): [number, number];
+      convertPositionToDesktopRegion(x: number, y: number): System.Tuple2<number, number>;
 
       /** 生成一个新的矩形类型的区域 */
       toRect(): Rect;

package/types/BetterGenshinImpact/Helpers/User32Helper.d.ts

@@ -1,137 +1,137 @@
 export type Key =
   | "LBUTTON" // 鼠标左键
   | "RBUTTON" // 鼠标右键
-  | "CANCEL" // 取消键（通常用于中断操作）
-  | "MBUTTON" // 鼠标中键（三键鼠标）
-  | "XBUTTON1" // 鼠标 X1 键（侧键）
-  | "XBUTTON2" // 鼠标 X2 键（侧键）
-  | "BACK" // 退格键（Backspace）
-  | "TAB" // 制表键（Tab）
-  | "CLEAR" // 清除键（例如小键盘的“5”）
-  | "RETURN" // 回车键（Enter）
-  | "SHIFT" // Shift 键（不区分左右）
-  | "LSHIFT" // 左 Shift 键
-  | "RSHIFT" // 右 Shift 键
-  | "CONTROL" // Ctrl 键（不区分左右）
-  | "LCONTROL" // 左 Ctrl 键
-  | "RCONTROL" // 右 Ctrl 键
-  | "MENU" // Alt 键（不区分左右）
-  | "LMENU" // 左 Alt 键
-  | "RMENU" // 右 Alt 键
-  | "PAUSE" // 暂停键（Pause）
-  | "CAPITAL" // 大写锁定键（Caps Lock）
-  | "KANA" // 日文输入法假名模式
-  | "HANGUL" // 韩文输入法 Hangul 模式
-  | "HANGUEL" // 韩文输入法 Hanguel 模式（同 Hangul）
+  | "CANCEL" // 取消/中断键
+  | "MBUTTON" // 鼠标中键
+  | "XBUTTON1" // 鼠标侧键1（前进键）
+  | "XBUTTON2" // 鼠标侧键2（后退键）
+  | "BACK" // 退格键
+  | "TAB" // 制表键
+  | "CLEAR" // 清除键
+  | "RETURN" // 回车键
+  | "SHIFT" // Shift键（不区分左右）
+  | "LSHIFT" // 左侧Shift键
+  | "RSHIFT" // 右侧Shift键
+  | "CONTROL" // Ctrl键（不区分左右）
+  | "LCONTROL" // 左侧Ctrl键
+  | "RCONTROL" // 右侧Ctrl键
+  | "MENU" // Alt键（不区分左右）
+  | "LMENU" // 左侧Alt键
+  | "RMENU" // 右侧Alt键
+  | "PAUSE" // 暂停键
+  | "CAPITAL" // 大写锁定键
+  | "KANA" // 日文假名输入模式
+  | "HANGUL" // 韩文Hangul输入模式
+  | "HANGUEL" // 韩文Hanguel输入模式（同Hangul）
   | "IME_ON" // 输入法开启状态
-  | "JUNJA" // 韩文输入法 Junja 模式
-  | "FINAL" // 输入法最终模式（韩文）
-  | "HANJA" // 韩文输入法 Hanja 模式
-  | "KANJI" // 日文输入法汉字模式
+  | "JUNJA" // 韩文Junja输入模式
+  | "FINAL" // 输入法最终模式
+  | "HANJA" // 韩文汉字输入模式
+  | "KANJI" // 日文汉字输入模式
   | "IME_OFF" // 输入法关闭状态
-  | "ESCAPE" // Esc 键
-  | "CONVERT" // 输入法转换键（日文/中文）
-  | "NONCONVERT" // 输入法不转换键（日文/中文）
-  | "ACCEPT" // 输入法接受操作
-  | "MODECHANGE" // 输入法模式切换
+  | "ESCAPE" // Esc键
+  | "CONVERT" // 输入法转换键
+  | "NONCONVERT" // 输入法非转换键
+  | "ACCEPT" // 输入法接受键
+  | "MODECHANGE" // 输入法模式切换键
   | "SPACE" // 空格键
-  | "PRIOR" // Page Up 键
-  | "NEXT" // Page Down 键
-  | "END" // End 键
-  | "HOME" // Home 键
-  | "UP" // 上方向键
-  | "DOWN" // 下方向键
-  | "LEFT" // 左方向键
-  | "RIGHT" // 右方向键
-  | "SELECT" // Select 键（旧键盘）
-  | "PRINT" // 打印屏幕键（Print Screen）
-  | "EXECUTE" // 执行键（旧键盘）
-  | "SNAPSHOT" // 截屏键（同 Print Screen）
-  | "INSERT" // Insert 键
-  | "DELETE" // Delete 键
-  | "HELP" // 帮助键（旧键盘）
-  | "0" // 数字 0 键
-  | "1" // 数字 1 键
-  | "2" // 数字 2 键
-  | "3" // 数字 3 键
-  | "4" // 数字 4 键
-  | "5" // 数字 5 键
-  | "6" // 数字 6 键
-  | "7" // 数字 7 键
-  | "8" // 数字 8 键
-  | "9" // 数字 9 键
-  | "A" // 字母 A 键
-  | "B" // 字母 B 键
-  | "C" // 字母 C 键
-  | "D" // 字母 D 键
-  | "E" // 字母 E 键
-  | "F" // 字母 F 键
-  | "G" // 字母 G 键
-  | "H" // 字母 H 键
-  | "I" // 字母 I 键
-  | "J" // 字母 J 键
-  | "K" // 字母 K 键
-  | "L" // 字母 L 键
-  | "M" // 字母 M 键
-  | "N" // 字母 N 键
-  | "O" // 字母 O 键
-  | "P" // 字母 P 键
-  | "Q" // 字母 Q 键
-  | "R" // 字母 R 键
-  | "S" // 字母 S 键
-  | "T" // 字母 T 键
-  | "U" // 字母 U 键
-  | "V" // 字母 V 键
-  | "W" // 字母 W 键
-  | "X" // 字母 X 键
-  | "Y" // 字母 Y 键
-  | "Z" // 字母 Z 键
-  | "LWIN" // 左 Windows 键
-  | "RWIN" // 右 Windows 键
+  | "PRIOR" // Page Up键
+  | "NEXT" // Page Down键
+  | "END" // End键
+  | "HOME" // Home键
+  | "UP" // 向上方向键
+  | "DOWN" // 向下方向键
+  | "LEFT" // 向左方向键
+  | "RIGHT" // 向右方向键
+  | "SELECT" // 选择键
+  | "PRINT" // 打印键
+  | "EXECUTE" // 执行键
+  | "SNAPSHOT" // 截图键（同Print）
+  | "INSERT" // Insert键
+  | "DELETE" // Delete键
+  | "HELP" // 帮助键
+  | "0" // 主键盘数字0键
+  | "1" // 主键盘数字1键
+  | "2" // 主键盘数字2键
+  | "3" // 主键盘数字3键
+  | "4" // 主键盘数字4键
+  | "5" // 主键盘数字5键
+  | "6" // 主键盘数字6键
+  | "7" // 主键盘数字7键
+  | "8" // 主键盘数字8键
+  | "9" // 主键盘数字9键
+  | "A" // A键
+  | "B" // B键
+  | "C" // C键
+  | "D" // D键
+  | "E" // E键
+  | "F" // F键
+  | "G" // G键
+  | "H" // H键
+  | "I" // I键
+  | "J" // J键
+  | "K" // K键
+  | "L" // L键
+  | "M" // M键
+  | "N" // N键
+  | "O" // O键
+  | "P" // P键
+  | "Q" // Q键
+  | "R" // R键
+  | "S" // S键
+  | "T" // T键
+  | "U" // U键
+  | "V" // V键
+  | "W" // W键
+  | "X" // X键
+  | "Y" // Y键
+  | "Z" // Z键
+  | "LWIN" // 左侧Windows徽标键
+  | "RWIN" // 右侧Windows徽标键
   | "APPS" // 应用程序键（右键菜单键）
-  | "SLEEP" // 计算机睡眠键
-  | "NUMPAD0" // 小键盘 0 键
-  | "NUMPAD1" // 小键盘 1 键
-  | "NUMPAD2" // 小键盘 2 键
-  | "NUMPAD3" // 小键盘 3 键
-  | "NUMPAD4" // 小键盘 4 键
-  | "NUMPAD5" // 小键盘 5 键
-  | "NUMPAD6" // 小键盘 6 键
-  | "NUMPAD7" // 小键盘 7 键
-  | "NUMPAD8" // 小键盘 8 键
-  | "NUMPAD9" // 小键盘 9 键
+  | "SLEEP" // 休眠键
+  | "NUMPAD0" // 小键盘数字0键
+  | "NUMPAD1" // 小键盘数字1键
+  | "NUMPAD2" // 小键盘数字2键
+  | "NUMPAD3" // 小键盘数字3键
+  | "NUMPAD4" // 小键盘数字4键
+  | "NUMPAD5" // 小键盘数字5键
+  | "NUMPAD6" // 小键盘数字6键
+  | "NUMPAD7" // 小键盘数字7键
+  | "NUMPAD8" // 小键盘数字8键
+  | "NUMPAD9" // 小键盘数字9键
   | "MULTIPLY" // 小键盘乘号键（*）
   | "ADD" // 小键盘加号键（+）
-  | "SEPARATOR" // 分隔符键（特定键盘）
+  | "SEPARATOR" // 分隔符键
   | "SUBTRACT" // 小键盘减号键（-）
   | "DECIMAL" // 小键盘小数点键（.）
   | "DIVIDE" // 小键盘除号键（/）
-  | "F1" // 功能键 F1
-  | "F2" // 功能键 F2
-  | "F3" // 功能键 F3
-  | "F4" // 功能键 F4
-  | "F5" // 功能键 F5
-  | "F6" // 功能键 F6
-  | "F7" // 功能键 F7
-  | "F8" // 功能键 F8
-  | "F9" // 功能键 F9
-  | "F10" // 功能键 F10
-  | "F11" // 功能键 F11
-  | "F12" // 功能键 F12
-  | "F13" // 功能键 F13（部分键盘）
-  | "F14" // 功能键 F14（部分键盘）
-  | "F15" // 功能键 F15（部分键盘）
-  | "F16" // 功能键 F16（部分键盘）
-  | "F17" // 功能键 F17（部分键盘）
-  | "F18" // 功能键 F18（部分键盘）
-  | "F19" // 功能键 F19（部分键盘）
-  | "F20" // 功能键 F20（部分键盘）
-  | "F21" // 功能键 F21（部分键盘）
-  | "F22" // 功能键 F22（部分键盘）
-  | "F23" // 功能键 F23（部分键盘）
-  | "F24" // 功能键 F24（部分键盘）
-  | "NUMLOCK" // 数字锁定键（Num Lock）
-  | "SCROLL" // 滚动锁定键（Scroll Lock）
+  | "F1" // F1功能键
+  | "F2" // F2功能键
+  | "F3" // F3功能键
+  | "F4" // F4功能键
+  | "F5" // F5功能键
+  | "F6" // F6功能键
+  | "F7" // F7功能键
+  | "F8" // F8功能键
+  | "F9" // F9功能键
+  | "F10" // F10功能键
+  | "F11" // F11功能键
+  | "F12" // F12功能键
+  | "F13" // F13功能键
+  | "F14" // F14功能键
+  | "F15" // F15功能键
+  | "F16" // F16功能键
+  | "F17" // F17功能键
+  | "F18" // F18功能键
+  | "F19" // F19功能键
+  | "F20" // F20功能键
+  | "F21" // F21功能键
+  | "F22" // F22功能键
+  | "F23" // F23功能键
+  | "F24" // F24功能键
+  | "NUMLOCK" // 数字锁定键
+  | "SCROLL" // 滚动锁定键
   | "BROWSER_BACK" // 浏览器后退键
   | "BROWSER_FORWARD" // 浏览器前进键
   | "BROWSER_REFRESH" // 浏览器刷新键
@@ -140,53 +140,53 @@ export type Key =
   | "BROWSER_FAVORITES" // 浏览器收藏夹键
   | "BROWSER_HOME" // 浏览器主页键
   | "VOLUME_MUTE" // 音量静音键
-  | "VOLUME_DOWN" // 音量减小键
-  | "VOLUME_UP" // 音量增大键
-  | "MEDIA_NEXT_TRACK" // 下一曲目键
-  | "MEDIA_PREV_TRACK" // 上一曲目键
+  | "VOLUME_DOWN" // 音量降低键
+  | "VOLUME_UP" // 音量提高键
+  | "MEDIA_NEXT_TRACK" // 媒体下一曲键
+  | "MEDIA_PREV_TRACK" // 媒体上一曲键
   | "MEDIA_STOP" // 媒体停止键
-  | "MEDIA_PLAY_PAUSE" // 播放/暂停键
-  | "LAUNCH_MAIL" // 启动邮件程序键
-  | "LAUNCH_MEDIA_SELECT" // 启动媒体选择器键
+  | "MEDIA_PLAY_PAUSE" // 媒体播放/暂停键
+  | "LAUNCH_MAIL" // 启动邮件客户端键
+  | "LAUNCH_MEDIA_SELECT" // 选择媒体键
   | "LAUNCH_APP1" // 启动应用程序1键
   | "LAUNCH_APP2" // 启动应用程序2键
-  | "OEM_1" // 分号/冒号键（; :，因键盘布局而异）
-  | "OEM_PLUS" // 加号键（+，因键盘布局而异）
-  | "OEM_COMMA" // 逗号键（,，因键盘布局而异）
-  | "OEM_MINUS" // 减号键（-，因键盘布局而异）
-  | "OEM_PERIOD" // 句号键（.，因键盘布局而异）
-  | "OEM_2" // 问号键（?，因键盘布局而异）
-  | "OEM_3" // 波浪号键（` ~，因键盘布局而异）
-  | "OEM_4" // 左方括号键（[ {，因键盘布局而异）
-  | "OEM_5" // 反斜杠键（\ |，因键盘布局而异）
-  | "OEM_6" // 右方括号键（] }，因键盘布局而异）
-  | "OEM_7" // 引号键（' "，因键盘布局而异）
-  | "OEM_8" // 杂项字符键（因键盘布局而异）
-  | "OEM_NEC_EQUAL" // NEC 小键盘等号键（=）
-  | "OEM_FJ_JISHO" // 富士通日语输入法“辞书”键
-  | "OEM_FJ_MASSHOU" // 富士通日语输入法“未登録”键
-  | "OEM_FJ_TOUROKU" // 富士通日语输入法“登録”键
-  | "OEM_FJ_LOYA" // 富士通日语输入法左 Oyayubi 键
-  | "OEM_FJ_ROYA" // 富士通日语输入法右 Oyayubi 键
-  | "OEM_AX" // AX 键（日语键盘）
-  | "OEM_102" // 反斜杠/尖括号键（\ > <，某些欧洲键盘）
-  | "OEM_RESET" // OEM 重置键（Nokia/Ericsson 定义）
-  | "OEM_JUMP" // OEM 跳转键（Nokia/Ericsson 定义）
-  | "OEM_PA1" // OEM PA1 键（Nokia/Ericsson 定义）
-  | "OEM_PA2" // OEM PA2 键（Nokia/Ericsson 定义）
-  | "OEM_PA3" // OEM PA3 键（Nokia/Ericsson 定义）
-  | "OEM_WSCTRL" // OEM WSCTRL 键（Nokia/Ericsson 定义）
-  | "OEM_CUSEL" // OEM CUSEL 键（Nokia/Ericsson 定义）
-  | "OEM_ATTN" // OEM ATTN 键（Nokia/Ericsson 定义）
-  | "OEM_FINISH" // OEM FINISH 键（Nokia/Ericsson 定义）
-  | "OEM_COPY" // OEM COPY 键（Nokia/Ericsson 定义）
-  | "OEM_AUTO" // OEM AUTO 键（Nokia/Ericsson 定义）
-  | "OEM_ENLW" // OEM ENLW 键（Nokia/Ericsson 定义）
-  | "OEM_BACKTAB" // OEM BackTab 键（Nokia/Ericsson 定义）
-  | "GAMEPAD_A" // 游戏手柄 A 键
-  | "GAMEPAD_B" // 游戏手柄 B 键
-  | "GAMEPAD_X" // 游戏手柄 X 键
-  | "GAMEPAD_Y" // 游戏手柄 Y 键
+  | "OEM_1" // OEM分号键（;）
+  | "OEM_PLUS" // OEM加号键（+）
+  | "OEM_COMMA" // OEM逗号键（,）
+  | "OEM_MINUS" // OEM减号键（-）
+  | "OEM_PERIOD" // OEM句号键（.）
+  | "OEM_2" // OEM问号键（?）
+  | "OEM_3" // OEM波浪线键（~）
+  | "OEM_4" // OEM左方括号键（[）
+  | "OEM_5" // OEM竖线键（|）
+  | "OEM_6" // OEM右方括号键（]）
+  | "OEM_7" // OEM引号键（'）
+  | "OEM_8" // OEM键8
+  | "OEM_NEC_EQUAL" // NEC等号键（小键盘）
+  | "OEM_FJ_JISHO" // 富士通"辞书"键
+  | "OEM_FJ_MASSHOU" // 富士通"未登録"键
+  | "OEM_FJ_TOUROKU" // 富士通"登録"键
+  | "OEM_FJ_LOYA" // 富士通左Oyayubi键
+  | "OEM_FJ_ROYA" // 富士通右Oyayubi键
+  | "OEM_AX" // AX键（日语键盘）
+  | "OEM_102" // OEM102键（通常为\或|，根据键盘布局）
+  | "OEM_RESET" // OEM重置键（Nokia/Ericsson定义）
+  | "OEM_JUMP" // OEM跳转键（Nokia/Ericsson定义）
+  | "OEM_PA1" // OEM PA1键（Nokia/Ericsson定义）
+  | "OEM_PA2" // OEM PA2键（Nokia/Ericsson定义）
+  | "OEM_PA3" // OEM PA3键（Nokia/Ericsson定义）
+  | "OEM_WSCTRL" // OEM WSCTRL键（Nokia/Ericsson定义）
+  | "OEM_CUSEL" // OEM CUSEL键（Nokia/Ericsson定义）
+  | "OEM_ATTN" // OEM ATTN键（Nokia/Ericsson定义）
+  | "OEM_FINISH" // OEM FINISH键（Nokia/Ericsson定义）
+  | "OEM_COPY" // OEM COPY键（Nokia/Ericsson定义）
+  | "OEM_AUTO" // OEM AUTO键（Nokia/Ericsson定义）
+  | "OEM_ENLW" // OEM ENLW键（Nokia/Ericsson定义）
+  | "OEM_BACKTAB" // OEM BackTab键（Nokia/Ericsson定义）
+  | "GAMEPAD_A" // 游戏手柄A键
+  | "GAMEPAD_B" // 游戏手柄B键
+  | "GAMEPAD_X" // 游戏手柄X键
+  | "GAMEPAD_Y" // 游戏手柄Y键
   | "GAMEPAD_LEFT_SHOULDER" // 游戏手柄左肩键
   | "GAMEPAD_RIGHT_SHOULDER" // 游戏手柄右肩键
   | "GAMEPAD_LEFT_TRIGGER" // 游戏手柄左扳机键
@@ -207,18 +207,18 @@ export type Key =
   | "GAMEPAD_RIGHT_THUMBSTICK_DOWN" // 游戏手柄右摇杆下推
   | "GAMEPAD_RIGHT_THUMBSTICK_LEFT" // 游戏手柄右摇杆左推
   | "GAMEPAD_RIGHT_THUMBSTICK_RIGHT" // 游戏手柄右摇杆右推
-  | "PROCESSKEY" // IME 处理键（用于输入法处理）
-  | "ICO_CLEAR" // ICO 清除键（旧键盘）
-  | "PACKET" // Unicode 字符输入键（用于发送 Unicode 字符）
-  | "ATTN" // Attn 键（旧系统）
-  | "CRSEL" // 光标选择键（旧系统）
-  | "EXSEL" // 扩展选择键（旧系统）
-  | "EREOF" // Erase EOF 键（旧系统）
-  | "PLAY" // 播放键（旧系统）
-  | "ZOOM" // 缩放键（旧系统）
-  | "NONAME" // 保留键（未命名）
-  | "PA1" // PA1 键（旧系统）
-  | "OEM_CLEAR"; // 清除键（旧键盘）
+  | "PROCESSKEY" // IME处理键
+  | "ICO_CLEAR" // ICO清除键
+  | "PACKET" // 数据包键（用于Unicode字符输入）
+  | "ATTN" // 注意键
+  | "CRSEL" // 光标选择键
+  | "EXSEL" // 扩展选择键
+  | "EREOF" // 删除至文件末尾键
+  | "PLAY" // 播放键
+  | "ZOOM" // 缩放键
+  | "NONAME" // 未命名键（保留供未来使用）
+  | "PA1" // PA1键
+  | "OEM_CLEAR"; // OEM清除键
 
 export type KeyCode =
   | Uppercase<Key>

package/types/System/Collections/IEqualityComparer.d.ts

@@ -0,0 +1,11 @@
+declare global {
+  namespace System.Collections {
+    interface IEqualityComparer {
+      equals(x: any, y: any): boolean;
+
+      getHashCode(obj: any): number;
+    }
+  }
+}
+
+export {};

package/types/System/Collections/IStructuralComparable.d.ts

@@ -0,0 +1,11 @@
+import "./IEqualityComparer";
+
+declare global {
+  namespace System.Collections {
+    interface IStructuralComparable {
+      compareTo(other: any, comparer: System.Collections.IEqualityComparer): number;
+    }
+  }
+}
+
+export {};

package/types/System/Collections/IStructuralEquatable.d.ts

@@ -0,0 +1,13 @@
+import "./IEqualityComparer";
+
+declare global {
+  namespace System.Collections {
+    interface IStructuralEquatable {
+      equals(other: any, comparer: System.Collections.IEqualityComparer): boolean;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+  }
+}
+
+export {};

package/types/System/DateTime.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/DateTimeOffset.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Exception.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/IAsyncDisposable.d.ts

@@ -7,4 +7,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/IComparable.d.ts

@@ -0,0 +1,9 @@
+declare global {
+  namespace System {
+    interface IComparable {
+      compareTo(other: any): number;
+    }
+  }
+}
+
+export {};

package/types/System/IEquatable.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Runtime/CompilerServices/ITuple.d.ts

@@ -0,0 +1,11 @@
+declare global {
+  namespace System.Runtime.CompilerServices {
+    interface ITuple {
+      length: number;
+
+      [index: number]: any;
+    }
+  }
+}
+
+export {};

package/types/System/Threading/CancellationToken.d.ts

@@ -55,4 +55,5 @@ declare global {
   }
   export import CancellationToken = System.Threading.CancellationToken;
 }
+
 export {};

package/types/System/Threading/CancellationTokenRegistration.d.ts

@@ -24,4 +24,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Threading/CancellationTokenSource.d.ts

@@ -48,4 +48,5 @@ declare global {
   }
   export import CancellationTokenSource = System.Threading.CancellationTokenSource;
 }
+
 export {};

package/types/System/Threading/ITimer.d.ts

@@ -9,4 +9,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Threading/Tasks/ValueTask.d.ts

@@ -9,4 +9,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Threading/WaitHandle.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/TimeProvider.d.ts

@@ -28,4 +28,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/TimeSpan.d.ts

@@ -5,4 +5,5 @@ declare global {
     }
   }
 }
+
 export {};

package/types/System/Tuple.d.ts

@@ -0,0 +1,184 @@
+import "./Collections/IStructuralComparable";
+import "./Collections/IStructuralEquatable";
+import "./IComparable";
+import "./Runtime/CompilerServices/ITuple";
+
+declare global {
+  // TODO: 未实现ITupleInternal接口，待补充（如果有必要）
+  namespace System {
+    class Tuple1<T1>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+
+      constructor(item1: T1);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple2<T1, T2>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+
+      constructor(item1: T1, item2: T2);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple3<T1, T2, T3>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+
+      constructor(item1: T1, item2: T2, item3: T3);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple4<T1, T2, T3, T4>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+      item4: T4;
+
+      constructor(item1: T1, item2: T2, item3: T3, item4: T4);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple5<T1, T2, T3, T4, T5>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+      item4: T4;
+      item5: T5;
+
+      constructor(item1: T1, item2: T2, item3: T3, item4: T4, item5: T5);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple6<T1, T2, T3, T4, T5, T6>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+      item4: T4;
+      item5: T5;
+      item6: T6;
+
+      constructor(item1: T1, item2: T2, item3: T3, item4: T4, item5: T5, item6: T6);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple7<T1, T2, T3, T4, T5, T6, T7>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+      item4: T4;
+      item5: T5;
+      item6: T6;
+      item7: T7;
+
+      constructor(item1: T1, item2: T2, item3: T3, item4: T4, item5: T5, item6: T6, item7: T7);
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+
+    class Tuple8<T1, T2, T3, T4, T5, T6, T7, T8>
+      implements
+        System.Collections.IStructuralEquatable,
+        System.Collections.IStructuralComparable,
+        System.IComparable
+    {
+      item1: T1;
+      item2: T2;
+      item3: T3;
+      item4: T4;
+      item5: T5;
+      item6: T6;
+      item7: T7;
+      item8: T8;
+
+      constructor(
+        item1: T1,
+        item2: T2,
+        item3: T3,
+        item4: T4,
+        item5: T5,
+        item6: T6,
+        item7: T7,
+        item8: T8
+      );
+
+      equals(other: any): boolean;
+
+      compareTo(other: any): number;
+
+      getHashCode(comparer: System.Collections.IEqualityComparer): number;
+    }
+  }
+}
+
+export {};

package/types/System/Windows/Forms/Keys.d.ts

@@ -0,0 +1,200 @@
+export type Keys =
+  | "LButton" // 鼠标左键
+  | "RButton" // 鼠标右键
+  | "Cancel" // 取消/中断键
+  | "MButton" // 鼠标中键
+  | "XButton1" // 鼠标侧键1（前进键）
+  | "XButton2" // 鼠标侧键2（后退键）
+  | "Back" // 退格键
+  | "Tab" // 制表键
+  | "LineFeed" // 换行键
+  | "Clear" // 清除键
+  | "Return" // 回车键
+  | "Enter" // 回车键（与Return同义）
+  | "ShiftKey" // Shift键
+  | "ControlKey" // Ctrl键
+  | "Menu" // Alt键（也称为菜单键）
+  | "Pause" // 暂停键
+  | "Capital" // 大写锁定键
+  | "CapsLock" // 大写锁定键（同Capital）
+  | "KanaMode" // 日文假名输入模式
+  | "HanguelMode" // 韩文Hanguel输入模式（已过时，建议使用HangulMode）
+  | "HangulMode" // 韩文Hangul输入模式
+  | "JunjaMode" // 韩文Junja输入模式
+  | "FinalMode" // 输入法最终模式
+  | "HanjaMode" // 韩文汉字输入模式
+  | "KanjiMode" // 日文汉字输入模式
+  | "Escape" // Esc键
+  | "IMEConvert" // IME转换键
+  | "IMENonconvert" // IME非转换键
+  | "IMEAccept" // IME接受键
+  | "IMEAceept" // IME接受键（过时拼写，建议使用IMEAccept）
+  | "IMEModeChange" // IME模式切换键
+  | "Space" // 空格键
+  | "Prior" // Page Up键
+  | "PageUp" // Page Up键（同Prior）
+  | "Next" // Page Down键
+  | "PageDown" // Page Down键（同Next）
+  | "End" // End键
+  | "Home" // Home键
+  | "Left" // 向左箭头键
+  | "Up" // 向上箭头键
+  | "Right" // 向右箭头键
+  | "Down" // 向下箭头键
+  | "Select" // 选择键
+  | "Print" // 打印键
+  | "Execute" // 执行键
+  | "Snapshot" // 截图键
+  | "PrintScreen" // 打印屏幕键（同Snapshot）
+  | "Insert" // Insert键
+  | "Delete" // Delete键
+  | "Help" // 帮助键
+  | "D0" // 主键盘数字0键
+  | "D1" // 主键盘数字1键
+  | "D2" // 主键盘数字2键
+  | "D3" // 主键盘数字3键
+  | "D4" // 主键盘数字4键
+  | "D5" // 主键盘数字5键
+  | "D6" // 主键盘数字6键
+  | "D7" // 主键盘数字7键
+  | "D8" // 主键盘数字8键
+  | "D9" // 主键盘数字9键
+  | "A" // A键
+  | "B" // B键
+  | "C" // C键
+  | "D" // D键
+  | "E" // E键
+  | "F" // F键
+  | "G" // G键
+  | "H" // H键
+  | "I" // I键
+  | "J" // J键
+  | "K" // K键
+  | "L" // L键
+  | "M" // M键
+  | "N" // N键
+  | "O" // O键
+  | "P" // P键
+  | "Q" // Q键
+  | "R" // R键
+  | "S" // S键
+  | "T" // T键
+  | "U" // U键
+  | "V" // V键
+  | "W" // W键
+  | "X" // X键
+  | "Y" // Y键
+  | "Z" // Z键
+  | "LWin" // 左侧Windows徽标键
+  | "RWin" // 右侧Windows徽标键
+  | "Apps" // 应用程序键（右键菜单键）
+  | "Sleep" // 休眠键
+  | "NumPad0" // 小键盘数字0键
+  | "NumPad1" // 小键盘数字1键
+  | "NumPad2" // 小键盘数字2键
+  | "NumPad3" // 小键盘数字3键
+  | "NumPad4" // 小键盘数字4键
+  | "NumPad5" // 小键盘数字5键
+  | "NumPad6" // 小键盘数字6键
+  | "NumPad7" // 小键盘数字7键
+  | "NumPad8" // 小键盘数字8键
+  | "NumPad9" // 小键盘数字9键
+  | "Multiply" // 小键盘乘号键（*）
+  | "Add" // 小键盘加号键（+）
+  | "Separator" // 分隔符键
+  | "Subtract" // 小键盘减号键（-）
+  | "Decimal" // 小键盘小数点键（.）
+  | "Divide" // 小键盘除号键（/）
+  | "F1" // F1功能键
+  | "F2" // F2功能键
+  | "F3" // F3功能键
+  | "F4" // F4功能键
+  | "F5" // F5功能键
+  | "F6" // F6功能键
+  | "F7" // F7功能键
+  | "F8" // F8功能键
+  | "F9" // F9功能键
+  | "F10" // F10功能键
+  | "F11" // F11功能键
+  | "F12" // F12功能键
+  | "F13" // F13功能键
+  | "F14" // F14功能键
+  | "F15" // F15功能键
+  | "F16" // F16功能键
+  | "F17" // F17功能键
+  | "F18" // F18功能键
+  | "F19" // F19功能键
+  | "F20" // F20功能键
+  | "F21" // F21功能键
+  | "F22" // F22功能键
+  | "F23" // F23功能键
+  | "F24" // F24功能键
+  | "NumLock" // 数字锁定键
+  | "Scroll" // 滚动锁定键
+  | "LShiftKey" // 左侧Shift键
+  | "RShiftKey" // 右侧Shift键
+  | "LControlKey" // 左侧Ctrl键
+  | "RControlKey" // 右侧Ctrl键
+  | "LMenu" // 左侧Alt键
+  | "RMenu" // 右侧Alt键
+  | "BrowserBack" // 浏览器后退键
+  | "BrowserForward" // 浏览器前进键
+  | "BrowserRefresh" // 浏览器刷新键
+  | "BrowserStop" // 浏览器停止键
+  | "BrowserSearch" // 浏览器搜索键
+  | "BrowserFavorites" // 浏览器收藏夹键
+  | "BrowserHome" // 浏览器主页键
+  | "VolumeMute" // 音量静音键
+  | "VolumeDown" // 音量降低键
+  | "VolumeUp" // 音量提高键
+  | "MediaNextTrack" // 媒体下一曲键
+  | "MediaPreviousTrack" // 媒体上一曲键
+  | "MediaStop" // 媒体停止键
+  | "MediaPlayPause" // 媒体播放/暂停键
+  | "LaunchMail" // 启动邮件客户端键
+  | "SelectMedia" // 选择媒体键
+  | "LaunchApplication1" // 启动应用程序1键
+  | "LaunchApplication2" // 启动应用程序2键
+  | "OemSemicolon" // OEM分号键（;）
+  | "Oem1" // OEM键1（同OemSemicolon）
+  | "Oemplus" // OEM加号键（+）
+  | "Oemcomma" // OEM逗号键（,）
+  | "OemMinus" // OEM减号键（-）
+  | "OemPeriod" // OEM句号键（.）
+  | "OemQuestion" // OEM问号键（?）
+  | "Oem2" // OEM键2（同OemQuestion）
+  | "Oemtilde" // OEM波浪线键（~）
+  | "Oem3" // OEM键3（同Oemtilde）
+  | "OemOpenBrackets" // OEM左方括号键（[）
+  | "Oem4" // OEM键4（同OemOpenBrackets）
+  | "OemPipe" // OEM竖线键（|）
+  | "Oem5" // OEM键5（同OemPipe）
+  | "OemCloseBrackets" // OEM右方括号键（]）
+  | "Oem6" // OEM键6（同OemCloseBrackets）
+  | "OemQuotes" // OEM引号键（'）
+  | "Oem7" // OEM键7（同OemQuotes）
+  | "Oem8" // OEM键8
+  | "OemBackslash" // OEM反斜杠键（\）
+  | "Oem102" // OEM102键（通常为\或|，根据键盘布局）
+  | "ProcessKey" // 处理键
+  | "Packet" // 数据包键（用于Unicode字符输入）
+  | "Attn" // 注意键
+  | "Crsel" // 光标选择键
+  | "Exsel" // 扩展选择键
+  | "EraseEof" // 删除至文件末尾键
+  | "Play" // 播放键
+  | "Zoom" // 缩放键
+  | "NoName" // 未命名键（保留供未来使用）
+  | "Pa1" // PA1键
+  | "OemClear" // OEM清除键
+  | "Shift" // Shift修饰键
+  | "Control" // Ctrl修饰键
+  | "Alt"; // Alt修饰键
+
+export type KeyCodeString = Keys;
+
+/**
+ * 组合键的字符串表示是逆序的，即 "A, Control" 表示 "Control + A"。
+ * 为了在类型安全性和性能之间取得平衡，这里仅支持最多两个按键的组合，超过两个按键的组合将回退到通用的字符串类型。
+ */
+export type KeyDataString = Keys | `${Keys}, ${Keys}` | (string & {});