quickwin 2.2.0 → 2.3.1

package/lib/windows/kernel32.js

@@ -101,6 +101,38 @@ export const TerminateProcess = /*@__PURE__*/ b('TerminateProcess', '<HPROCESS>p
 /** 取当前进程 PID（互证锚点）
  *  @returns 当前进程 PID */
 export const GetCurrentProcessId = /*@__PURE__*/ b('GetCurrentProcessId', ' -> u32');
+/** 当前进程伪句柄（-1，不需 CloseHandle——OpenProcess 真句柄的零成本替代，纯本进程
+ *  场景如 IsWow64Process 探位宽用） */
+export const GetCurrentProcess = /*@__PURE__*/ b('GetCurrentProcess', ' -> <HPROCESS>ptr');
+// ============ 远程内存（跨进程 SendMessage 的输出缓冲）============
+// 普通跨进程 SendMessage **不 marshal 指针**：出参 buffer 写在接收方线程执行，指针值
+// 原样透传——落在本进程地址空间会被 explorer 直接写穿。正解 = VirtualAllocEx 在目标
+// 进程分配 → 发消息 → ReadProcessMemory 读回（见 examples/execd/tray.ts /tray_list 用例）。
+/** 在目标进程地址空间分配内存；配对 VirtualFreeEx
+ *  @returns 成功 → 远程基址，失败 → 0（0 保真）
+ *  @param args_0 hProcess OpenProcess 句柄（本场景须 PROCESS_VM_OPERATION(0x8) |
+ *                PROCESS_VM_READ(0x10) | PROCESS_VM_WRITE(0x20) = 0x38）
+ *  @param args_1 lpAddress NULL = 系统选起点
+ *  @param args_2 dwSize 字节数（SIZE_T 随位宽 = <>ptr 的 ptr 宽，非指针语义）
+ *  @param args_3 flAllocationType MEM_COMMIT|MEM_RESERVE（0x1000|0x2000 = 0x3000）
+ *  @param args_4 flProtect PAGE_READWRITE（0x04） */
+export const VirtualAllocEx = /*@__PURE__*/ b('VirtualAllocEx', '<HPROCESS>ptr <>ptr <>ptr u32 u32 -> <>ptr');
+/** 释放 VirtualAllocEx 内存（须同一进程句柄）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 同 VirtualAllocEx
+ *  @param args_1 lpAddress VirtualAllocEx 返回的远程基址
+ *  @param args_2 dwSize 0（MEM_RELEASE 时必须 0）
+ *  @param args_3 dwFreeType MEM_RELEASE（0x8000） */
+export const VirtualFreeEx = /*@__PURE__*/ b('VirtualFreeEx', '<HPROCESS>ptr <>ptr <>ptr u32 -> i32');
+/** 读目标进程内存（远程 SendMessage 写完 → 本调用读回本地；远程指针字段如托盘
+ *  dwData 内容的二次解引用同样走这里）
+ *  @returns 成功 → 非 0（目标地址不可读/句柄无 PROCESS_VM_READ）
+ *  @param args_0 hProcess OpenProcess 句柄（须 PROCESS_VM_READ(0x10)）
+ *  @param args_1 lpBaseAddress 远程地址（VirtualAllocEx 返回值等）
+ *  @param args_2 lpBuffer 本地接收缓冲，传 BYTE.alloc(n)（DataView/TypedArray 原地读回）
+ *  @param args_3 nSize 字节数（SIZE_T → <>ptr ptr 宽）
+ *  @param args_4 lpNumberOfBytesRead 实读字节数出参槽 PtrArrayBuffer(8) 可选，或 NULL */
+export const ReadProcessMemory = /*@__PURE__*/ b('ReadProcessMemory', '<HPROCESS>ptr <>ptr <BYTE>ptr <>ptr <>ptr -> i32');
 // ============ 文件 I/O ============
 /** 同步读文件 / 管道
  *  @returns 成功 → 非 0，管道写端全部关闭后读返回 0（EOF）
@@ -118,7 +150,7 @@ export const ReadFile = /*@__PURE__*/ b('ReadFile', '<HFILE>ptr! <BYTE>ptr u32 <
  *                组合（flags 位不标枚举）
  *  @param args_2 dwShareMode 共享掩码：FILE_SHARE_READ(0x1)|FILE_SHARE_WRITE(0x2)，独占传 0
  *  @param args_3 lpSecurityAttributes 安全属性，传 NULL
- *  @param args_4 dwCreationDisposition 创建处置 gui.FileCreation.*（互斥单选）
+ *  @param args_4 dwCreationDisposition 创建处置 FileCreation.*（互斥单选）
  *  @param args_5 dwFlagsAndAttributes 属性：FILE_ATTRIBUTE_NORMAL(0x80) 等（可组合不标）
  *  @param args_6 hTemplateFile 模板文件句柄，传 NULL */
 export const CreateFile = /*@__PURE__*/ b('CreateFileW', '<WCHAR>ptr! u32 u32 <>ptr u32@FileCreation u32 <>ptr -> <HFILE>ptr!');
@@ -157,7 +189,7 @@ export const MoveFileEx = /*@__PURE__*/ b('MoveFileExW', '<WCHAR>ptr! <WCHAR>ptr
  *  与合法的 0xFFFFFFFF 偏移）
  *  @param args_1 lDistanceToMove 偏移（LONG，可负）
  *  @param args_2 lpDistanceToMoveHigh 64 位偏移高半（出参双向），32 位够用传 NULL
- *  @param args_3 dwMoveMethod 起点 gui.FileSeekFrom.BEGIN / CURRENT / END */
+ *  @param args_3 dwMoveMethod 起点 FileSeekFrom.BEGIN / CURRENT / END */
 export const SetFilePointer = /*@__PURE__*/ b('SetFilePointer', '<HFILE>ptr! i32 <BYTE>ptr u32@FileSeekFrom -> u32');
 /** 读文件大小
  *  @returns 文件大小（低 32 位）；0xFFFFFFFF = 失败（INVALID_FILE_SIZE，须 GetLastError 区分）
@@ -238,6 +270,13 @@ export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */
 export const GetCommandLineW = /*@__PURE__*/ b('GetCommandLineW', ' -> <WCHAR>ptr!');
+/** 本进程是否跑在 WOW64（32 位进程 on 64 位 OS）——判**远程进程/系统位宽**的廉价
+ *  探针：x64 进程恒 0（本就是 64 位 OS）；x86 进程 1 = OS 64 位（远程序构按 64 位解析，
+ *  如 x86 qwin 读 explorer 的 TBBUTTON）。32 位 OS 上恒写 0
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess GetCurrentProcess() 伪句柄或真句柄
+ *  @param args_1 lpWow64Process 出参 BOOL 槽，PtrArrayBuffer(4)，Uint32Array 读回 */
+export const IsWow64Process = /*@__PURE__*/ b('IsWow64Process', '<HPROCESS>ptr <BYTE>ptr -> i32');
 // ============ 全局内存（剪贴板数据载体）============
 /** 分配全局内存块
  *  @returns 成功 → 句柄（0 失败）

package/lib/windows/kernel32.ts

@@ -117,6 +117,42 @@ export const TerminateProcess = /*@__PURE__*/ b('TerminateProcess', '<HPROCESS>p
 /** 取当前进程 PID（互证锚点）
  *  @returns 当前进程 PID */
 export const GetCurrentProcessId = /*@__PURE__*/ b('GetCurrentProcessId', ' -> u32')
+/** 当前进程伪句柄（-1，不需 CloseHandle——OpenProcess 真句柄的零成本替代，纯本进程
+ *  场景如 IsWow64Process 探位宽用） */
+export const GetCurrentProcess = /*@__PURE__*/ b('GetCurrentProcess', ' -> <HPROCESS>ptr')
+
+// ============ 远程内存（跨进程 SendMessage 的输出缓冲）============
+// 普通跨进程 SendMessage **不 marshal 指针**：出参 buffer 写在接收方线程执行，指针值
+// 原样透传——落在本进程地址空间会被 explorer 直接写穿。正解 = VirtualAllocEx 在目标
+// 进程分配 → 发消息 → ReadProcessMemory 读回（见 examples/execd/tray.ts /tray_list 用例）。
+
+/** 在目标进程地址空间分配内存；配对 VirtualFreeEx
+ *  @returns 成功 → 远程基址，失败 → 0（0 保真）
+ *  @param args_0 hProcess OpenProcess 句柄（本场景须 PROCESS_VM_OPERATION(0x8) |
+ *                PROCESS_VM_READ(0x10) | PROCESS_VM_WRITE(0x20) = 0x38）
+ *  @param args_1 lpAddress NULL = 系统选起点
+ *  @param args_2 dwSize 字节数（SIZE_T 随位宽 = <>ptr 的 ptr 宽，非指针语义）
+ *  @param args_3 flAllocationType MEM_COMMIT|MEM_RESERVE（0x1000|0x2000 = 0x3000）
+ *  @param args_4 flProtect PAGE_READWRITE（0x04） */
+export const VirtualAllocEx = /*@__PURE__*/ b('VirtualAllocEx',
+    '<HPROCESS>ptr <>ptr <>ptr u32 u32 -> <>ptr')
+/** 释放 VirtualAllocEx 内存（须同一进程句柄）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 同 VirtualAllocEx
+ *  @param args_1 lpAddress VirtualAllocEx 返回的远程基址
+ *  @param args_2 dwSize 0（MEM_RELEASE 时必须 0）
+ *  @param args_3 dwFreeType MEM_RELEASE（0x8000） */
+export const VirtualFreeEx = /*@__PURE__*/ b('VirtualFreeEx', '<HPROCESS>ptr <>ptr <>ptr u32 -> i32')
+/** 读目标进程内存（远程 SendMessage 写完 → 本调用读回本地；远程指针字段如托盘
+ *  dwData 内容的二次解引用同样走这里）
+ *  @returns 成功 → 非 0（目标地址不可读/句柄无 PROCESS_VM_READ）
+ *  @param args_0 hProcess OpenProcess 句柄（须 PROCESS_VM_READ(0x10)）
+ *  @param args_1 lpBaseAddress 远程地址（VirtualAllocEx 返回值等）
+ *  @param args_2 lpBuffer 本地接收缓冲，传 BYTE.alloc(n)（DataView/TypedArray 原地读回）
+ *  @param args_3 nSize 字节数（SIZE_T → <>ptr ptr 宽）
+ *  @param args_4 lpNumberOfBytesRead 实读字节数出参槽 PtrArrayBuffer(8) 可选，或 NULL */
+export const ReadProcessMemory = /*@__PURE__*/ b('ReadProcessMemory',
+    '<HPROCESS>ptr <>ptr <BYTE>ptr <>ptr <>ptr -> i32')
 
 // ============ 文件 I/O ============
 
@@ -137,7 +173,7 @@ export const ReadFile = /*@__PURE__*/ b('ReadFile', '<HFILE>ptr! <BYTE>ptr u32 <
  *                组合（flags 位不标枚举）
  *  @param args_2 dwShareMode 共享掩码：FILE_SHARE_READ(0x1)|FILE_SHARE_WRITE(0x2)，独占传 0
  *  @param args_3 lpSecurityAttributes 安全属性，传 NULL
- *  @param args_4 dwCreationDisposition 创建处置 gui.FileCreation.*（互斥单选）
+ *  @param args_4 dwCreationDisposition 创建处置 FileCreation.*（互斥单选）
  *  @param args_5 dwFlagsAndAttributes 属性：FILE_ATTRIBUTE_NORMAL(0x80) 等（可组合不标）
  *  @param args_6 hTemplateFile 模板文件句柄，传 NULL */
 export const CreateFile = /*@__PURE__*/ b('CreateFileW',
@@ -177,7 +213,7 @@ export const MoveFileEx = /*@__PURE__*/ b('MoveFileExW', '<WCHAR>ptr! <WCHAR>ptr
  *  与合法的 0xFFFFFFFF 偏移）
  *  @param args_1 lDistanceToMove 偏移（LONG，可负）
  *  @param args_2 lpDistanceToMoveHigh 64 位偏移高半（出参双向），32 位够用传 NULL
- *  @param args_3 dwMoveMethod 起点 gui.FileSeekFrom.BEGIN / CURRENT / END */
+ *  @param args_3 dwMoveMethod 起点 FileSeekFrom.BEGIN / CURRENT / END */
 export const SetFilePointer = /*@__PURE__*/ b('SetFilePointer', '<HFILE>ptr! i32 <BYTE>ptr u32@FileSeekFrom -> u32')
 /** 读文件大小
  *  @returns 文件大小（低 32 位）；0xFFFFFFFF = 失败（INVALID_FILE_SIZE，须 GetLastError 区分）
@@ -265,6 +301,13 @@ export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */
 export const GetCommandLineW = /*@__PURE__*/ b('GetCommandLineW', ' -> <WCHAR>ptr!')
+/** 本进程是否跑在 WOW64（32 位进程 on 64 位 OS）——判**远程进程/系统位宽**的廉价
+ *  探针：x64 进程恒 0（本就是 64 位 OS）；x86 进程 1 = OS 64 位（远程序构按 64 位解析，
+ *  如 x86 qwin 读 explorer 的 TBBUTTON）。32 位 OS 上恒写 0
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess GetCurrentProcess() 伪句柄或真句柄
+ *  @param args_1 lpWow64Process 出参 BOOL 槽，PtrArrayBuffer(4)，Uint32Array 读回 */
+export const IsWow64Process = /*@__PURE__*/ b('IsWow64Process', '<HPROCESS>ptr <BYTE>ptr -> i32')
 
 // ============ 全局内存（剪贴板数据载体）============
 

package/lib/windows/shell32.js

@@ -1,7 +1,9 @@
-// shell32 绑定（shell 对话框 / PIDL→路径）
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
 import { bind } from '../ffi/bind.js';
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
-const b = (name, sig) => bind('shell32.dll', name, sig);
+import { NOTIFYICONIDENTIFIER } from './structs.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）；第三参透传
+// encoders（结构入参位注册，方向约定见 lib/windows/user32.ts 头注释）
+const b = (name, sig, encoders) => bind('shell32.dll', name, sig, encoders);
 /** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
  *  @returns PIDL，取消 → 0
  *  @param args_0 pbi BROWSEINFOW.encode(...).ptr（见 structs.ts） */
@@ -11,3 +13,22 @@ export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEI
  *  @param args_0 pidl SHBrowseForFolder 等返回的 PIDL
  *  @param args_1 pszPath 出参缓冲，WCHAR.alloc(260)（MAX_PATH=260）、WCHAR.decode 读回 */
 export const SHGetPathFromIDList = /*@__PURE__*/ b('SHGetPathFromIDListW', '<>ptr <BYTE>ptr -> u32');
+/** 取托盘通知图标的屏幕矩形（Shell_NotifyIconGetRect；**Win7+**——XP 无此导出，
+ *  故为**可选绑定**：老系统上本常量为 null（bind() 是模块顶层立即解析，缺符号 throw
+ *  会拖垮整个脚本启动），调用方必须判空）
+ *  @returns HRESULT，实测语义：0 = 图标在通知区内，iconLocation = 其容器（可见区 /
+ *    溢出面板）内位置——**溢出面板未展开时该 rect 不是屏幕可点位**；1 = 按文档为
+ *    不可见态（隐藏/溢出；本机未复现——实测 Win7 溢出图标亦返 0）；0x80004005 E_FAIL
+ *    = 图标不存在，或该图标未按 {hWnd,uID} 注册（系统 GUID 图标实测 not_found）
+ *  @param args_0 identifier NOTIFYICONIDENTIFIER 对象直传（encoder 已注册；cbSize 填
+ *    NOTIFYICONIDENTIFIER.size，guidItem 缺省 = GUID_NULL 走 hWnd+uID）
+ *  @param args_1 iconLocation 出参槽，RECT.alloc().ptr（出参位不注册，方向约定同
+ *    user32），RECT.decode 读回 */
+export const Shell_NotifyIconGetRect = (() => {
+    try {
+        return b('Shell_NotifyIconGetRect', '<NOTIFYICONIDENTIFIER>ptr <RECT>ptr -> i32', { NOTIFYICONIDENTIFIER });
+    }
+    catch {
+        return null; // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
+    }
+})();

package/lib/windows/shell32.ts

@@ -1,8 +1,11 @@
-// shell32 绑定（shell 对话框 / PIDL→路径）
-import { bind } from '../ffi/bind.js'
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
+import { bind, type CodecMap } from '../ffi/bind.js'
+import { NOTIFYICONIDENTIFIER } from './structs.js'
 
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
-const b = <const S extends string>(name: string, sig: S) => bind('shell32.dll', name, sig)
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）；第三参透传
+// encoders（结构入参位注册，方向约定见 lib/windows/user32.ts 头注释）
+const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
+    bind('shell32.dll', name, sig, encoders)
 
 /** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
  *  @returns PIDL，取消 → 0
@@ -14,3 +17,23 @@ export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEI
  *  @param args_0 pidl SHBrowseForFolder 等返回的 PIDL
  *  @param args_1 pszPath 出参缓冲，WCHAR.alloc(260)（MAX_PATH=260）、WCHAR.decode 读回 */
 export const SHGetPathFromIDList = /*@__PURE__*/ b('SHGetPathFromIDListW', '<>ptr <BYTE>ptr -> u32')
+
+/** 取托盘通知图标的屏幕矩形（Shell_NotifyIconGetRect；**Win7+**——XP 无此导出，
+ *  故为**可选绑定**：老系统上本常量为 null（bind() 是模块顶层立即解析，缺符号 throw
+ *  会拖垮整个脚本启动），调用方必须判空）
+ *  @returns HRESULT，实测语义：0 = 图标在通知区内，iconLocation = 其容器（可见区 /
+ *    溢出面板）内位置——**溢出面板未展开时该 rect 不是屏幕可点位**；1 = 按文档为
+ *    不可见态（隐藏/溢出；本机未复现——实测 Win7 溢出图标亦返 0）；0x80004005 E_FAIL
+ *    = 图标不存在，或该图标未按 {hWnd,uID} 注册（系统 GUID 图标实测 not_found）
+ *  @param args_0 identifier NOTIFYICONIDENTIFIER 对象直传（encoder 已注册；cbSize 填
+ *    NOTIFYICONIDENTIFIER.size，guidItem 缺省 = GUID_NULL 走 hWnd+uID）
+ *  @param args_1 iconLocation 出参槽，RECT.alloc().ptr（出参位不注册，方向约定同
+ *    user32），RECT.decode 读回 */
+export const Shell_NotifyIconGetRect = (() => {
+    try {
+        return b('Shell_NotifyIconGetRect',
+            '<NOTIFYICONIDENTIFIER>ptr <RECT>ptr -> i32', { NOTIFYICONIDENTIFIER })
+    } catch {
+        return null    // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
+    }
+})()

package/lib/windows/structs.js

@@ -601,3 +601,57 @@ export const PROCESS_MEMORY_COUNTERS_DECL = {
     PeakPagefileUsage: '<>ptr',
 };
 export const PROCESS_MEMORY_COUNTERS = /* @__PURE__ */ struct('PROCESS_MEMORY_COUNTERS', PROCESS_MEMORY_COUNTERS_DECL);
+/** MOUSEINPUT（SendInput 鼠标事件体；x86 24B / x64 32B——dwExtraInfo 是 ULONG_PTR，
+ *  随位宽）。dx/dy 相对位移，或 dwFlags 带 MOUSEEVENTF_ABSOLUTE 时为 0-65535 归一化
+ *  物理像素（本引擎 SetProcessDPIAware，见 src/main.c，全坐标 API 同空间）；
+ *  mouseData 滚轮增量（±120）或 X 系按钮编号（XBUTTON1/2） */
+export const MOUSEINPUT_DECL = {
+    '#': 'struct',
+    dx: 'i32',
+    dy: 'i32',
+    mouseData: 'u32',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+};
+export const MOUSEINPUT = /* @__PURE__ */ struct('MOUSEINPUT', MOUSEINPUT_DECL);
+/** KEYBDINPUT（SendInput 键盘事件体；x86 16B / x64 24B）：wVk 虚拟键码，
+ *  dwFlags 带 KEYEVENTF_UNICODE 时 wScan = 字符码 */
+export const KEYBDINPUT_DECL = {
+    '#': 'struct',
+    wVk: 'u16',
+    wScan: 'u16',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+};
+export const KEYBDINPUT = /* @__PURE__ */ struct('KEYBDINPUT', KEYBDINPUT_DECL);
+/** INPUT（SendInput 元素；x86 28B / x64 40B）：type（INPUT_MOUSE=0 / INPUT_KEYBOARD=1）
+ *  + 三选一 union——C 的 DUMMYUNIONNAME 匿名成员在此命名嵌套（encode 形
+ *  {type, data:{mi|ki:{...}}}）。union 随 MOUSEINPUT 的 ULONG_PTR 位宽，x64 下 type 后
+ *  自动补 4B padding 使 union 8 对齐（MSVC 布局）。HARDWAREINPUT 不注入，省略不改
+ *  尺寸（union 尺寸 = max 成员 = MOUSEINPUT）。dwExtraInfo 是 ULONG_PTR 信息位（非句柄）
+ *  → <>ptr 裸档（uintptr 双态先例：WPARAM/LPARAM/void*），恒传 0 */
+export const INPUT_DECL = {
+    '#': 'struct',
+    type: 'u32',
+    data: {
+        '#': 'union',
+        mi: MOUSEINPUT_DECL,
+        ki: KEYBDINPUT_DECL,
+    },
+};
+export const INPUT = /* @__PURE__ */ struct('INPUT', INPUT_DECL);
+/** NOTIFYICONIDENTIFIER（Shell_NotifyIconGetRect 定位托盘通知图标；x86 28B / x64 40B——
+ *  hWnd 是 HWND 随位宽，guidItem = GUID 固定 16B 不随）。定位二法取一：guidItem 非全 0
+ *  时忽略 hWnd/uID，否则走 hWnd+uID（deskmon 等自注册图标即此形，与 Shell_NotifyIcon
+ *  的 {hwnd,uID} 同源）；guidItem 缺省 = GUID_NULL 走 hWnd+uID。cbSize 调用前填
+ *  NOTIFYICONIDENTIFIER.size（cb 结构惯例，见 PROCESS_MEMORY_COUNTERS 同） */
+export const NOTIFYICONIDENTIFIER_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    hWnd: '<HWND>ptr',
+    uID: 'u32',
+    guidItem: 'u32[4]',
+};
+export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL);

package/lib/windows/structs.ts

@@ -1,5 +1,5 @@
 import { struct } from '../ffi/struct.js'
-import type { C_Struct } from '../ffi/ctype.js'
+import type { C_Struct, C_Union } from '../ffi/ctype.js'
 
 // 全仓库 Win32 结构的集中定义点（CType IR，按本机架构 MSVC 对齐；这批全为定长标量/字符串，
 // ia32/x64 同布局）。形参位方向约定见 lib/windows/user32.ts 头注释：
@@ -688,3 +688,65 @@ export const PROCESS_MEMORY_COUNTERS_DECL = {
 } satisfies C_Struct
 
 export const PROCESS_MEMORY_COUNTERS = /* @__PURE__ */ struct('PROCESS_MEMORY_COUNTERS', PROCESS_MEMORY_COUNTERS_DECL)
+
+/** MOUSEINPUT（SendInput 鼠标事件体；x86 24B / x64 32B——dwExtraInfo 是 ULONG_PTR，
+ *  随位宽）。dx/dy 相对位移，或 dwFlags 带 MOUSEEVENTF_ABSOLUTE 时为 0-65535 归一化
+ *  物理像素（本引擎 SetProcessDPIAware，见 src/main.c，全坐标 API 同空间）；
+ *  mouseData 滚轮增量（±120）或 X 系按钮编号（XBUTTON1/2） */
+export const MOUSEINPUT_DECL = {
+    '#': 'struct',
+    dx: 'i32',
+    dy: 'i32',
+    mouseData: 'u32',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+} satisfies C_Struct
+
+export const MOUSEINPUT = /* @__PURE__ */ struct('MOUSEINPUT', MOUSEINPUT_DECL)
+
+/** KEYBDINPUT（SendInput 键盘事件体；x86 16B / x64 24B）：wVk 虚拟键码，
+ *  dwFlags 带 KEYEVENTF_UNICODE 时 wScan = 字符码 */
+export const KEYBDINPUT_DECL = {
+    '#': 'struct',
+    wVk: 'u16',
+    wScan: 'u16',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+} satisfies C_Struct
+
+export const KEYBDINPUT = /* @__PURE__ */ struct('KEYBDINPUT', KEYBDINPUT_DECL)
+
+/** INPUT（SendInput 元素；x86 28B / x64 40B）：type（INPUT_MOUSE=0 / INPUT_KEYBOARD=1）
+ *  + 三选一 union——C 的 DUMMYUNIONNAME 匿名成员在此命名嵌套（encode 形
+ *  {type, data:{mi|ki:{...}}}）。union 随 MOUSEINPUT 的 ULONG_PTR 位宽，x64 下 type 后
+ *  自动补 4B padding 使 union 8 对齐（MSVC 布局）。HARDWAREINPUT 不注入，省略不改
+ *  尺寸（union 尺寸 = max 成员 = MOUSEINPUT）。dwExtraInfo 是 ULONG_PTR 信息位（非句柄）
+ *  → <>ptr 裸档（uintptr 双态先例：WPARAM/LPARAM/void*），恒传 0 */
+export const INPUT_DECL = {
+    '#': 'struct',
+    type: 'u32',
+    data: {
+        '#': 'union',
+        mi: MOUSEINPUT_DECL,
+        ki: KEYBDINPUT_DECL,
+    } satisfies C_Union,
+} satisfies C_Struct
+
+export const INPUT = /* @__PURE__ */ struct('INPUT', INPUT_DECL)
+
+/** NOTIFYICONIDENTIFIER（Shell_NotifyIconGetRect 定位托盘通知图标；x86 28B / x64 40B——
+ *  hWnd 是 HWND 随位宽，guidItem = GUID 固定 16B 不随）。定位二法取一：guidItem 非全 0
+ *  时忽略 hWnd/uID，否则走 hWnd+uID（deskmon 等自注册图标即此形，与 Shell_NotifyIcon
+ *  的 {hwnd,uID} 同源）；guidItem 缺省 = GUID_NULL 走 hWnd+uID。cbSize 调用前填
+ *  NOTIFYICONIDENTIFIER.size（cb 结构惯例，见 PROCESS_MEMORY_COUNTERS 同） */
+export const NOTIFYICONIDENTIFIER_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    hWnd: '<HWND>ptr',
+    uID: 'u32',
+    guidItem: 'u32[4]',
+} satisfies C_Struct
+
+export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL)

package/lib/windows/user32.js

@@ -1,4 +1,4 @@
-// user32.dll 精选高频 API（85 个），逐函数独立导出：
+// user32.dll 精选高频 API（99 个），逐函数独立导出：
 //   - 签名对照 mingw winuser.h 原型手写；未被 import 的绑定经 esbuild 摇树不进产物
 //   - WPARAM / LPARAM / LRESULT / UINT_PTR / LONG_PTR 及句柄混合值一律 <>ptr（指针宽度跨
 //     架构正确；返回值 0 保真（C→JS 不做 0→null）、有符号读对齐 C 版 JS_NewInt64——-1 哨兵等负值保真）
@@ -24,8 +24,9 @@
 //     <HGLOBAL>ptr 自产自收）
 import * as os from 'os';
 import { bind } from '../ffi/bind.js';
+import { structArray } from '../ffi/struct.js';
 // 只 import 注册了 encoder 的结构（纯入参位）；POINT 等出/就地位不注册，运行时无需引用
-import { MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js';
+import { INPUT, MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js';
 // dll 名部分应用：85 个绑定共用，签名字符串不再重复 'user32.dll'。
 // 不能用 bind.bind(null, dll)——泛型在部分应用点坍缩（返回 never）；工厂转调让
 // S/LE/LD 在调用点正常 infer。第三参透传 encoders（结构入参位注册，见头注释方向约定）。
@@ -43,7 +44,7 @@ const LONG_PTR_SYM = os.arch === 'x64' ? 'PtrW' : 'W';
  *  @param args_0 dwExStyle WS_EX_*
  *  @param args_1 lpClassName 窗口类名 string 或 NULL
  *  @param args_2 lpWindowName 窗口标题 string 或 NULL
- *  @param args_3 dwStyle WS_*（gui.WindowStyle 类常量）
+ *  @param args_3 dwStyle WS_*（WindowStyle 类常量）
  *  @param args_4 x 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_5 y 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_6 nWidth
@@ -57,7 +58,7 @@ export const CreateWindowEx = /*@__PURE__*/ b('CreateWindowExW', 'u32 <WCHAR>ptr
  *  @returns 成功 → 非 0
  *  @param args_0 hWnd */
 export const DestroyWindow = /*@__PURE__*/ b('DestroyWindow', '<HWND>ptr -> i32');
-/** 显示/隐藏窗口（nCmdShow = gui.WindowStyle 类常量）
+/** 显示/隐藏窗口（nCmdShow = WindowStyle 类常量）
  *  @returns 先前可见性
  *  @param args_0 hWnd
  *  @param args_1 nCmdShow 显示命令（SW_SHOW/SW_HIDE 等） */
@@ -300,7 +301,7 @@ export const EndPaint = /*@__PURE__*/ b('EndPaint', '<HWND>ptr <PAINTSTRUCT>ptr
  *  @param args_1 lpchText 文本 string（自动 UTF-16 编码）
  *  @param args_2 cchText 字符数（-1 = 自动算到 NUL）
  *  @param args_3 lpRect 矩形（双向不注册 encoder；CALCRECT 就地写回：RECT.encode(初值) 传 .ptr、decode 读回）
- *  @param args_4 uFormat DT_* 排版标志（gui.DrawTextFlag） */
+ *  @param args_4 uFormat DT_* 排版标志（DrawTextFlag） */
 export const DrawText = /*@__PURE__*/ b('DrawTextW', '<HDC>ptr! <WCHAR>ptr i32 <RECT>ptr i32 -> i32');
 /** 用画刷填充矩形
  *  @returns 填充高度
@@ -394,6 +395,17 @@ export const GetKeyboardState = /*@__PURE__*/ b('GetKeyboardState', '<BYTE>ptr -
  *  @returns SHORT（低字节 VK、高位 shift/ctrl/alt 掩码），无 → -1
  *  @param args_0 ch 字符码（如 65 = 'A'） */
 export const VkKeyScan = /*@__PURE__*/ b('VkKeyScanW', 'u32 -> i32');
+// INPUT 数组 encoder（SendInput 的 <INPUT>ptr 位注册后值域即元素数组——与 gdi32
+// POINTArr 同机制，token/引擎层零数组概念）
+const INPUTArr = /*@__PURE__*/ structArray(INPUT);
+/** 批量注入输入事件（一次调用 = cInputs 个 INPUT 紧密数组 = 一个原子输入块）
+ *  @returns 成功注入的事件数；0 = 全部失败（UIPI：目标进程完整性更高），< cInputs = 部分成功
+ *  @param args_0 events INPUT 元素数组（structArray(INPUT) encoder 直传
+ *   [{type:0|1, data:{mi|ki:{...}}}]；绝对坐标 dx/dy 是 0-65535 归一化物理像素——本引擎
+ *   SetProcessDPIAware，GetSystemMetrics/GetWindowRect 同空间，换算 x*65535/(SM_CXSCREEN-1)）
+ *  @param args_1 cbSize 传 INPUT.size（MSDN 要求 = sizeof(INPUT)，x86 28 / x64 40，
+ *   传错整体静默失败） */
+export const SendInput = /*@__PURE__*/ b('SendInput', 'u32 <INPUT>ptr i32 -> u32', { INPUT: INPUTArr });
 // ============ 计时器 ============
 /** 设定时器（hWnd/id 传 NULL/0 = 自动分配 id；lpTimerFunc 传 NULL 用 WM_TIMER）
  *  @returns 定时器 ID（自动分配时从返回值读回）；失败 → 0
@@ -520,7 +532,7 @@ export const ShowScrollBar = /*@__PURE__*/ b('ShowScrollBar', '<HWND>ptr u32 i32
  *  @param args_3 uType MB_* 样式（MB_OK/MB_YESNO 等） */
 export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <WCHAR>ptr u32 -> i32');
 // ============ 图像 ============
-/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 gui.ImageType 枚举当前值
+/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
  *  @returns 图像句柄；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件

package/lib/windows/user32.ts

@@ -1,4 +1,4 @@
-// user32.dll 精选高频 API（85 个），逐函数独立导出：
+// user32.dll 精选高频 API（99 个），逐函数独立导出：
 //   - 签名对照 mingw winuser.h 原型手写；未被 import 的绑定经 esbuild 摇树不进产物
 //   - WPARAM / LPARAM / LRESULT / UINT_PTR / LONG_PTR 及句柄混合值一律 <>ptr（指针宽度跨
 //     架构正确；返回值 0 保真（C→JS 不做 0→null）、有符号读对齐 C 版 JS_NewInt64——-1 哨兵等负值保真）
@@ -24,8 +24,9 @@
 //     <HGLOBAL>ptr 自产自收）
 import * as os from 'os'
 import { bind, type CodecMap } from '../ffi/bind.js'
+import { structArray } from '../ffi/struct.js'
 // 只 import 注册了 encoder 的结构（纯入参位）；POINT 等出/就地位不注册，运行时无需引用
-import { MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js'
+import { INPUT, MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js'
 
 // dll 名部分应用：85 个绑定共用，签名字符串不再重复 'user32.dll'。
 // 不能用 bind.bind(null, dll)——泛型在部分应用点坍缩（返回 never）；工厂转调让
@@ -48,7 +49,7 @@ const LONG_PTR_SYM = os.arch === 'x64' ? 'PtrW' : 'W'
  *  @param args_0 dwExStyle WS_EX_*
  *  @param args_1 lpClassName 窗口类名 string 或 NULL
  *  @param args_2 lpWindowName 窗口标题 string 或 NULL
- *  @param args_3 dwStyle WS_*（gui.WindowStyle 类常量）
+ *  @param args_3 dwStyle WS_*（WindowStyle 类常量）
  *  @param args_4 x 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_5 y 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_6 nWidth
@@ -63,7 +64,7 @@ export const CreateWindowEx = /*@__PURE__*/ b('CreateWindowExW',
  *  @returns 成功 → 非 0
  *  @param args_0 hWnd */
 export const DestroyWindow = /*@__PURE__*/ b('DestroyWindow', '<HWND>ptr -> i32')
-/** 显示/隐藏窗口（nCmdShow = gui.WindowStyle 类常量）
+/** 显示/隐藏窗口（nCmdShow = WindowStyle 类常量）
  *  @returns 先前可见性
  *  @param args_0 hWnd
  *  @param args_1 nCmdShow 显示命令（SW_SHOW/SW_HIDE 等） */
@@ -313,7 +314,7 @@ export const EndPaint = /*@__PURE__*/ b('EndPaint', '<HWND>ptr <PAINTSTRUCT>ptr
  *  @param args_1 lpchText 文本 string（自动 UTF-16 编码）
  *  @param args_2 cchText 字符数（-1 = 自动算到 NUL）
  *  @param args_3 lpRect 矩形（双向不注册 encoder；CALCRECT 就地写回：RECT.encode(初值) 传 .ptr、decode 读回）
- *  @param args_4 uFormat DT_* 排版标志（gui.DrawTextFlag） */
+ *  @param args_4 uFormat DT_* 排版标志（DrawTextFlag） */
 export const DrawText = /*@__PURE__*/ b('DrawTextW', '<HDC>ptr! <WCHAR>ptr i32 <RECT>ptr i32 -> i32')
 /** 用画刷填充矩形
  *  @returns 填充高度
@@ -413,6 +414,17 @@ export const GetKeyboardState = /*@__PURE__*/ b('GetKeyboardState', '<BYTE>ptr -
  *  @returns SHORT（低字节 VK、高位 shift/ctrl/alt 掩码），无 → -1
  *  @param args_0 ch 字符码（如 65 = 'A'） */
 export const VkKeyScan = /*@__PURE__*/ b('VkKeyScanW', 'u32 -> i32')
+// INPUT 数组 encoder（SendInput 的 <INPUT>ptr 位注册后值域即元素数组——与 gdi32
+// POINTArr 同机制，token/引擎层零数组概念）
+const INPUTArr = /*@__PURE__*/ structArray(INPUT)
+/** 批量注入输入事件（一次调用 = cInputs 个 INPUT 紧密数组 = 一个原子输入块）
+ *  @returns 成功注入的事件数；0 = 全部失败（UIPI：目标进程完整性更高），< cInputs = 部分成功
+ *  @param args_0 events INPUT 元素数组（structArray(INPUT) encoder 直传
+ *   [{type:0|1, data:{mi|ki:{...}}}]；绝对坐标 dx/dy 是 0-65535 归一化物理像素——本引擎
+ *   SetProcessDPIAware，GetSystemMetrics/GetWindowRect 同空间，换算 x*65535/(SM_CXSCREEN-1)）
+ *  @param args_1 cbSize 传 INPUT.size（MSDN 要求 = sizeof(INPUT)，x86 28 / x64 40，
+ *   传错整体静默失败） */
+export const SendInput = /*@__PURE__*/ b('SendInput', 'u32 <INPUT>ptr i32 -> u32', { INPUT: INPUTArr })
 
 // ============ 计时器 ============
 
@@ -551,7 +563,7 @@ export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <
 
 // ============ 图像 ============
 
-/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 gui.ImageType 枚举当前值
+/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
  *  @returns 图像句柄；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件

package/lib/windows/winspool.js

@@ -14,7 +14,7 @@ const b = (name, sig, encoders) => bind('winspool.drv', name, sig, encoders);
 /** 枚举打印队列（Level=2 → PRINTER_INFO_2W 数组）；两段式：先
  *  NULL+cbBuf 0 拿 pcbNeeded，再按需分配缓冲重调
  *  @returns 成功 → 非 0
- *  @param args_0 dwFlags 枚举范围：gui.PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
+ *  @param args_0 dwFlags 枚举范围：PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
  *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
  *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
  *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
@@ -28,12 +28,12 @@ export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW', 'u32 <WCHAR>ptr u32
  *  @param args_0 pszBuffer 出参缓冲，WCHAR.alloc(n)、WCHAR.decode 读回
  *  @param args_1 pcchBuffer 出入长度槽（入 = 缓冲 WCHAR 容量，出 = 实际长度），PtrArrayBuffer(4) */
 export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>ptr <BYTE>ptr -> i32');
-/** 查设备能力；nCapability 单选 gui.DeviceCap.*
+/** 查设备能力；nCapability 单选 DeviceCap.*
  *  @returns 返回值随能力（数值能力 = 数值，
  *  -1 = 失败）
  *  @param args_0 pDevice 打印机名（禁空）
  *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
- *  @param args_2 nCapability 能力码（gui.DeviceCap.HORZRES 等单选）
+ *  @param args_2 nCapability 能力码（DeviceCap.HORZRES 等单选）
  *  @param args_3 pOutput 字符串列表型能力的缓冲；数值型查询传 NULL
  *  @param args_4 pDevmode DEVMODE，传 NULL */
 export const DeviceCapabilities = /*@__PURE__*/ b('DeviceCapabilitiesW', '<WCHAR>ptr! <WCHAR>ptr u32@DeviceCap <BYTE>ptr <>ptr -> i32');

package/lib/windows/winspool.ts

@@ -17,7 +17,7 @@ const b = <const S extends string, const LE extends CodecMap = {}>(name: string,
 /** 枚举打印队列（Level=2 → PRINTER_INFO_2W 数组）；两段式：先
  *  NULL+cbBuf 0 拿 pcbNeeded，再按需分配缓冲重调
  *  @returns 成功 → 非 0
- *  @param args_0 dwFlags 枚举范围：gui.PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
+ *  @param args_0 dwFlags 枚举范围：PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
  *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
  *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
  *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
@@ -34,12 +34,12 @@ export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW',
  *  @param args_1 pcchBuffer 出入长度槽（入 = 缓冲 WCHAR 容量，出 = 实际长度），PtrArrayBuffer(4) */
 export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>ptr <BYTE>ptr -> i32')
 
-/** 查设备能力；nCapability 单选 gui.DeviceCap.*
+/** 查设备能力；nCapability 单选 DeviceCap.*
  *  @returns 返回值随能力（数值能力 = 数值，
  *  -1 = 失败）
  *  @param args_0 pDevice 打印机名（禁空）
  *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
- *  @param args_2 nCapability 能力码（gui.DeviceCap.HORZRES 等单选）
+ *  @param args_2 nCapability 能力码（DeviceCap.HORZRES 等单选）
  *  @param args_3 pOutput 字符串列表型能力的缓冲；数值型查询传 NULL
  *  @param args_4 pDevmode DEVMODE，传 NULL */
 export const DeviceCapabilities = /*@__PURE__*/ b('DeviceCapabilitiesW',

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",
@@ -24,7 +24,8 @@
     "examples/",
     "vendor/",
     "quickwin.d.ts",
-    "quickwin_const.d.ts",
+    "constants.ts",
+    "enum_map.d.ts",
     "tsconfig.json",
     "README.md",
     "README.en.md"
@@ -32,7 +33,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/xna00/quickwin.git"
+    "url": "git+https://github.com/quickwinlabs/quickwin.git"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",