quickwin 2.3.1 → 3.0.0

package/lib/windows/gdi32.ts

@@ -89,8 +89,32 @@ export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>
  *  @param args_3 cLines 扫描行数
  *  @param args_4 lpvBits 像素接收缓冲（ArrayBuffer）
  *  @param args_5 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_6 uUsage DIB_RGB_COLORS(0) */
-export const GetDIBits = /*@__PURE__*/ b('GetDIBits', '<HDC>ptr! <HGDIOBJ>ptr u32 u32 <BYTE>ptr <>ptr u32 -> i32')
+ *  @param args_6 uUsage ColorUse.RGB_COLORS */
+export const GetDIBits = /*@__PURE__*/ b('GetDIBits', '<HDC>ptr! <HGDIOBJ>ptr u32 u32 <BYTE>ptr <>ptr u32@ColorUse -> i32')
+/** 建 32bpp DIB 段位图（biHeight 负 = 自顶向下，像素内存由系统分配）——像素内容靠
+ *  SetDIBits 从调用方缓冲装入，故 ppvBits 出参槽可传 NULL 不取位地址（要直写像素
+ *  才需要非空槽）
+ *  @returns 位图句柄；失败 → 0（用完 DeleteObject）
+ *  @param args_0 hdc 参考 DC（NULL 即可，只取 DIB 格式）
+ *  @param args_1 pbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr，同 GetDIBits）
+ *  @param args_2 iUsage ColorUse.RGB_COLORS
+ *  @param args_3 ppvBits 收位地址的出参槽（NULL = 不取）
+ *  @param args_4 hSection NULL（无文件映射区）
+ *  @param args_5 offset 位数据在映射区内的偏移（无映射区恒 0） */
+export const CreateDIBSection = /*@__PURE__*/ b('CreateDIBSection',
+    '<HDC>ptr <>ptr u32@ColorUse <>ptr <>ptr u32 -> <HGDIOBJ>ptr')
+/** 把 lpvBits 的像素装进位图（lpbmi 描述源的格式；ColorUse.RGB_COLORS 时 hdc 只定
+ *  目标格式，本仓传 NULL 实测可用——MSDN：仅 DIB_PAL_COLORS 才用 hdc）
+ *  @returns 成功复制的扫描行数；失败 → 0
+ *  @param args_0 hdc 参考 DC（NULL 即可，见上）
+ *  @param args_1 hbm 目标位图（DIB 段同可用）
+ *  @param args_2 uStartScan 起始扫描行
+ *  @param args_3 cLines 扫描行数
+ *  @param args_4 lpvBits 像素源缓冲（ArrayBuffer）
+ *  @param args_5 lpbmi BITMAPINFO 缓冲（同 GetDIBits）
+ *  @param args_6 iUsage ColorUse.RGB_COLORS */
+export const SetDIBits = /*@__PURE__*/ b('SetDIBits',
+    '<HDC>ptr <HGDIOBJ>ptr! u32 u32 <BYTE>ptr <>ptr u32@ColorUse -> i32')
 /** 取 GDI 对象信息到 lpv（hFont → LOGFONTW 等）
  *  @returns 写入的字节数；失败 → 0
  *  @param args_0 h GDI 对象句柄（字体/画笔/位图等）
@@ -184,9 +208,9 @@ export const MaskBlt = /*@__PURE__*/ b('MaskBlt',
  *  @param args_8 uNumScans 扫描行数
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲
- *  @param args_11 iUsage DIB_RGB_COLORS(0) */
+ *  @param args_11 iUsage ColorUse.RGB_COLORS */
 export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
-    '<HDC>ptr! i32 i32 u32 u32 i32 i32 u32 u32 <BYTE>ptr <BYTE>ptr u32 -> i32')
+    '<HDC>ptr! i32 i32 u32 u32 i32 i32 u32 u32 <BYTE>ptr <BYTE>ptr u32@ColorUse -> i32')
 
 /** 拉伸 DIB 传送（内存像素缓冲直接放/缩到目标，免创建 HBITMAP 中转）；
  *  DestWidth/DestHeight 传 0 = 源自然尺寸；SrcWidth/SrcHeight 负 = 翻转
@@ -201,10 +225,10 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
  *  @param args_8 SrcHeight 源区高
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
- *  @param args_11 iUsage DIB_RGB_COLORS(0)
+ *  @param args_11 iUsage ColorUse.RGB_COLORS
  *  @param args_12 rop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits',
-    '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32 u32@RasterOp -> i32')
+    '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32@ColorUse u32@RasterOp -> i32')
 
 // ============ 画图原语（笔 / 线 / 形状 / 文字） ============
 

package/lib/windows/kernel32.js

@@ -266,6 +266,15 @@ export const GetComputerName = /*@__PURE__*/ b('GetComputerNameW', '<BYTE>ptr <B
  *  @param args_1 lpFilename 接收缓冲，传 WCHAR.alloc(n)
  *  @param args_2 nSize 缓冲容量（WCHAR 个数） */
 export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE>ptr <BYTE>ptr u32 -> u32');
+/** 取**已加载**模块的句柄（不加载、不加引用计数；LoadLibrary 的反向查询）
+ *  @returns 模块句柄（HMODULE/HINSTANCE，与 win 模块同型）；失败 → NULL
+ *  @param args_0 lpModuleName 模块名（大小写不敏感，`.dll` 可省；只认模块名不认路径），
+ *    传 NULL = 当前进程主 exe —— `<WCHAR>ptr` 位收 string 或 NULL（JS null/undefined 会 fail-loud） */
+export const GetModuleHandle = /*@__PURE__*/ b('GetModuleHandleW', '<WCHAR>ptr -> <HMODULE>ptr');
+/** 卸载 LoadLibrary 加载的模块（引用计数减 1）；GetModuleHandle 拿到的句柄**不可**传此 API
+ *  @returns 成功 → 非 0
+ *  @param args_0 hModule LoadLibrary 返回的模块句柄 */
+export const FreeLibrary = /*@__PURE__*/ b('FreeLibrary', '<HMODULE>ptr -> i32');
 /** 进程命令行（含程序名；进程启动即有值，永不返回 NULL）
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */

package/lib/windows/kernel32.ts

@@ -297,6 +297,15 @@ export const GetComputerName = /*@__PURE__*/ b('GetComputerNameW', '<BYTE>ptr <B
  *  @param args_1 lpFilename 接收缓冲，传 WCHAR.alloc(n)
  *  @param args_2 nSize 缓冲容量（WCHAR 个数） */
 export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE>ptr <BYTE>ptr u32 -> u32')
+/** 取**已加载**模块的句柄（不加载、不加引用计数；LoadLibrary 的反向查询）
+ *  @returns 模块句柄（HMODULE/HINSTANCE，与 win 模块同型）；失败 → NULL
+ *  @param args_0 lpModuleName 模块名（大小写不敏感，`.dll` 可省；只认模块名不认路径），
+ *    传 NULL = 当前进程主 exe —— `<WCHAR>ptr` 位收 string 或 NULL（JS null/undefined 会 fail-loud） */
+export const GetModuleHandle = /*@__PURE__*/ b('GetModuleHandleW', '<WCHAR>ptr -> <HMODULE>ptr')
+/** 卸载 LoadLibrary 加载的模块（引用计数减 1）；GetModuleHandle 拿到的句柄**不可**传此 API
+ *  @returns 成功 → 非 0
+ *  @param args_0 hModule LoadLibrary 返回的模块句柄 */
+export const FreeLibrary = /*@__PURE__*/ b('FreeLibrary', '<HMODULE>ptr -> i32')
 /** 进程命令行（含程序名；进程启动即有值，永不返回 NULL）
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */

package/lib/windows/shell32.js

@@ -1,6 +1,6 @@
-// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标增删与定位）
 import { bind } from '../ffi/bind.js';
-import { NOTIFYICONIDENTIFIER } from './structs.js';
+import { NOTIFYICONIDENTIFIER, NOTIFYICONDATAW } 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);
@@ -32,3 +32,12 @@ export const Shell_NotifyIconGetRect = (() => {
         return null; // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
     }
 })();
+/** 托盘通知图标增删改（Shell_NotifyIconW；XP 起即有）
+ *  @returns 成功 → 非 0，失败 → 0
+ *  @param args_0 dwMessage NotifyIconCmd（ADD / MODIFY / DELETE / SETVERSION…；DELETE 只需
+ *    hWnd+uID）
+ *  @param args_1 lpData NOTIFYICONDATAW 对象直传（encoder 已注册，缺省字段跳过）；cbSize 填
+ *    NOTIFYICONDATAW.size、uFlags 取 NotifyIconFlag.*（ICON/MESSAGE/TIP…，决定下面哪些字段
+ *    生效）、uCallbackMessage 常填自定义消息号、hIcon 接 LoadImage/LoadAppIcon 的结果、
+ *    szTip 直接给 string（宽字符串糖，最长 127 字符） */
+export const ShellNotifyIcon = /*@__PURE__*/ b('Shell_NotifyIconW', 'u32 <NOTIFYICONDATAW>ptr -> i32', { NOTIFYICONDATAW });

package/lib/windows/shell32.ts

@@ -1,6 +1,6 @@
-// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标增删与定位）
 import { bind, type CodecMap } from '../ffi/bind.js'
-import { NOTIFYICONIDENTIFIER } from './structs.js'
+import { NOTIFYICONIDENTIFIER, NOTIFYICONDATAW } from './structs.js'
 
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）；第三参透传
 // encoders（结构入参位注册，方向约定见 lib/windows/user32.ts 头注释）
@@ -37,3 +37,14 @@ export const Shell_NotifyIconGetRect = (() => {
         return null    // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
     }
 })()
+
+/** 托盘通知图标增删改（Shell_NotifyIconW；XP 起即有）
+ *  @returns 成功 → 非 0，失败 → 0
+ *  @param args_0 dwMessage NotifyIconCmd（ADD / MODIFY / DELETE / SETVERSION…；DELETE 只需
+ *    hWnd+uID）
+ *  @param args_1 lpData NOTIFYICONDATAW 对象直传（encoder 已注册，缺省字段跳过）；cbSize 填
+ *    NOTIFYICONDATAW.size、uFlags 取 NotifyIconFlag.*（ICON/MESSAGE/TIP…，决定下面哪些字段
+ *    生效）、uCallbackMessage 常填自定义消息号、hIcon 接 LoadImage/LoadAppIcon 的结果、
+ *    szTip 直接给 string（宽字符串糖，最长 127 字符） */
+export const ShellNotifyIcon = /*@__PURE__*/ b('Shell_NotifyIconW',
+    'u32 <NOTIFYICONDATAW>ptr -> i32', { NOTIFYICONDATAW })

package/lib/windows/structs.js

@@ -78,6 +78,29 @@ export const LOGFONTW_DECL = {
     lfFaceName: 'u16[32]@utf-16le',
 };
 export const LOGFONTW = /* @__PURE__ */ struct('LOGFONTW', LOGFONTW_DECL);
+/** 非客户区度量（504B，x64/ia32 同布局）：内嵌 4 个 LOGFONTW + iPaddedBorderWidth（Vista+）；
+ *  SystemParametersInfo(SPI_GETNONCLIENTMETRICS) 纯出参位（不注册 encoder：
+ *  encode({cbSize}) 建缓冲带初值 → 传 .ptr → decode 读回 lfMessageFont 等） */
+export const NONCLIENTMETRICSW_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    iBorderWidth: 'i32',
+    iScrollWidth: 'i32',
+    iScrollHeight: 'i32',
+    iCaptionWidth: 'i32',
+    iCaptionHeight: 'i32',
+    lfCaptionFont: LOGFONTW_DECL,
+    iSmCaptionWidth: 'i32',
+    iSmCaptionHeight: 'i32',
+    lfSmCaptionFont: LOGFONTW_DECL,
+    iMenuWidth: 'i32',
+    iMenuHeight: 'i32',
+    lfMenuFont: LOGFONTW_DECL,
+    lfStatusFont: LOGFONTW_DECL,
+    lfMessageFont: LOGFONTW_DECL,
+    iPaddedBorderWidth: 'i32',
+};
+export const NONCLIENTMETRICSW = /* @__PURE__ */ struct('NONCLIENTMETRICSW', NONCLIENTMETRICSW_DECL);
 /** TEXTMETRICW（60B = 11 LONG + 4 WCHAR + 5 BYTE 尾部补齐，双架构同布局）：
  *  GetTextMetrics 纯出参位（不注册 encoder：TEXTMETRICW.alloc().ptr 进、decode 读回） */
 export const TEXTMETRICW_DECL = {
@@ -655,3 +678,31 @@ export const NOTIFYICONIDENTIFIER_DECL = {
     guidItem: 'u32[4]',
 };
 export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL);
+/** NOTIFYICONDATAW（Shell_NotifyIconW；x86 956B / x64 976B——hWnd/hIcon/hBalloonIcon 随
+ *  位宽，GUID 固定 16B；偏移经 mingw 头文件实测对齐）。cbSize 调用前填
+ *  NOTIFYICONDATAW.size（cb 结构惯例，同 NOTIFYICONIDENTIFIER / SCROLLINFO）——
+ *  本声明取 Vista+ 布局（与 mingw sizeof 一致），XP 上同样可注册（实测）。
+ *  szTip/szInfo/szInfoTitle 走宽字符串糖（u16[N]@utf-16le，同 LOGFONTW.lfFaceName）；
+ *  图标句柄用裸 <>ptr：LoadImageW 的返回类型由 uType 决定（HICON/HCURSOR/HBITMAP），
+ *  绑定给不出品牌——裸地址收品牌指针（子型）无障碍；
+ *  uTimeout 与 uVersion 是同址 union，本仓只用前者（恒 0，不走版本协商），
+ *  故按单字段 u32 声明而非 union 布局。 */
+export const NOTIFYICONDATAW_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    hWnd: '<HWND>ptr',
+    uID: 'u32',
+    uFlags: 'u32',
+    uCallbackMessage: 'u32',
+    hIcon: '<>ptr',
+    szTip: 'u16[128]@utf-16le',
+    dwState: 'u32',
+    dwStateMask: 'u32',
+    szInfo: 'u16[256]@utf-16le',
+    uTimeout: 'u32',
+    szInfoTitle: 'u16[64]@utf-16le',
+    dwInfoFlags: 'u32',
+    guidItem: 'u32[4]',
+    hBalloonIcon: '<>ptr',
+};
+export const NOTIFYICONDATAW = /* @__PURE__ */ struct('NOTIFYICONDATAW', NOTIFYICONDATAW_DECL);

package/lib/windows/structs.ts

@@ -93,6 +93,31 @@ export const LOGFONTW_DECL = {
 
 export const LOGFONTW = /* @__PURE__ */ struct('LOGFONTW', LOGFONTW_DECL)
 
+/** 非客户区度量（504B，x64/ia32 同布局）：内嵌 4 个 LOGFONTW + iPaddedBorderWidth（Vista+）；
+ *  SystemParametersInfo(SPI_GETNONCLIENTMETRICS) 纯出参位（不注册 encoder：
+ *  encode({cbSize}) 建缓冲带初值 → 传 .ptr → decode 读回 lfMessageFont 等） */
+export const NONCLIENTMETRICSW_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    iBorderWidth: 'i32',
+    iScrollWidth: 'i32',
+    iScrollHeight: 'i32',
+    iCaptionWidth: 'i32',
+    iCaptionHeight: 'i32',
+    lfCaptionFont: LOGFONTW_DECL,
+    iSmCaptionWidth: 'i32',
+    iSmCaptionHeight: 'i32',
+    lfSmCaptionFont: LOGFONTW_DECL,
+    iMenuWidth: 'i32',
+    iMenuHeight: 'i32',
+    lfMenuFont: LOGFONTW_DECL,
+    lfStatusFont: LOGFONTW_DECL,
+    lfMessageFont: LOGFONTW_DECL,
+    iPaddedBorderWidth: 'i32',
+} satisfies C_Struct
+
+export const NONCLIENTMETRICSW = /* @__PURE__ */ struct('NONCLIENTMETRICSW', NONCLIENTMETRICSW_DECL)
+
 /** TEXTMETRICW（60B = 11 LONG + 4 WCHAR + 5 BYTE 尾部补齐，双架构同布局）：
  *  GetTextMetrics 纯出参位（不注册 encoder：TEXTMETRICW.alloc().ptr 进、decode 读回） */
 export const TEXTMETRICW_DECL = {
@@ -750,3 +775,33 @@ export const NOTIFYICONIDENTIFIER_DECL = {
 } satisfies C_Struct
 
 export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL)
+
+/** NOTIFYICONDATAW（Shell_NotifyIconW；x86 956B / x64 976B——hWnd/hIcon/hBalloonIcon 随
+ *  位宽，GUID 固定 16B；偏移经 mingw 头文件实测对齐）。cbSize 调用前填
+ *  NOTIFYICONDATAW.size（cb 结构惯例，同 NOTIFYICONIDENTIFIER / SCROLLINFO）——
+ *  本声明取 Vista+ 布局（与 mingw sizeof 一致），XP 上同样可注册（实测）。
+ *  szTip/szInfo/szInfoTitle 走宽字符串糖（u16[N]@utf-16le，同 LOGFONTW.lfFaceName）；
+ *  图标句柄用裸 <>ptr：LoadImageW 的返回类型由 uType 决定（HICON/HCURSOR/HBITMAP），
+ *  绑定给不出品牌——裸地址收品牌指针（子型）无障碍；
+ *  uTimeout 与 uVersion 是同址 union，本仓只用前者（恒 0，不走版本协商），
+ *  故按单字段 u32 声明而非 union 布局。 */
+export const NOTIFYICONDATAW_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    hWnd: '<HWND>ptr',
+    uID: 'u32',
+    uFlags: 'u32',
+    uCallbackMessage: 'u32',
+    hIcon: '<>ptr',
+    szTip: 'u16[128]@utf-16le',
+    dwState: 'u32',
+    dwStateMask: 'u32',
+    szInfo: 'u16[256]@utf-16le',
+    uTimeout: 'u32',
+    szInfoTitle: 'u16[64]@utf-16le',
+    dwInfoFlags: 'u32',
+    guidItem: 'u32[4]',
+    hBalloonIcon: '<>ptr',
+} satisfies C_Struct
+
+export const NOTIFYICONDATAW = /* @__PURE__ */ struct('NOTIFYICONDATAW', NOTIFYICONDATAW_DECL)

package/lib/windows/user32.js

@@ -495,10 +495,10 @@ export const GetSubMenu = /*@__PURE__*/ b('GetSubMenu', '<HMENU>ptr i32 -> <HMEN
  *  @param args_1 uFlags TPM_* 标志
  *  @param args_2 x 屏幕 x
  *  @param args_3 y 屏幕 y
- *  @param args_4 nReserved 保留，传 0
- *  @param args_5 prcRect 点击区矩形（DeepPartial RECT / .ptr / NULL）
- *  @param args_6 hdc 参考 DC，可 NULL */
-export const TrackPopupMenu = /*@__PURE__*/ b('TrackPopupMenu', '<HMENU>ptr u32 i32 i32 i32 <RECT>ptr <HDC>ptr -> i32', { RECT });
+ *  @param args_4 nReserved 保留，传 0（TrackPopupMenuEx 才用）
+ *  @param args_5 hWnd 拥有者窗口（TPM_RETURNCMD 时命令 ID 回到该窗口所属线程队列）
+ *  @param args_6 prcRect 保留位，传 NULL（Win32 文档标注本 API 忽略此参数） */
+export const TrackPopupMenu = /*@__PURE__*/ b('TrackPopupMenu', '<HMENU>ptr u32 i32 i32 i32 <HWND>ptr <RECT>ptr -> i32', { RECT });
 /** 创建弹出菜单；配对 DestroyMenu
  *  @returns 菜单句柄；失败 → NULL */
 export const CreatePopupMenu = /*@__PURE__*/ b('CreatePopupMenu', ' -> <HMENU>ptr');
@@ -534,7 +534,8 @@ export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <
 // ============ 图像 ============
 /** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
- *  @returns 图像句柄；失败 → 0
+ *  @returns 图像句柄——类型随 uType（IMAGE_ICON→HICON / CURSOR→HCURSOR / BITMAP→HBITMAP），
+ *    绑定侧给不出品牌故为裸地址档；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件
  *  @param args_1 name 图像名 string（资源名或文件路径）
  *  @param args_2 uType IMAGE_* 真值（BITMAP=0/CURSOR=1/ICON=2）

package/lib/windows/user32.ts

@@ -520,10 +520,10 @@ export const GetSubMenu = /*@__PURE__*/ b('GetSubMenu', '<HMENU>ptr i32 -> <HMEN
  *  @param args_1 uFlags TPM_* 标志
  *  @param args_2 x 屏幕 x
  *  @param args_3 y 屏幕 y
- *  @param args_4 nReserved 保留，传 0
- *  @param args_5 prcRect 点击区矩形（DeepPartial RECT / .ptr / NULL）
- *  @param args_6 hdc 参考 DC，可 NULL */
-export const TrackPopupMenu = /*@__PURE__*/ b('TrackPopupMenu', '<HMENU>ptr u32 i32 i32 i32 <RECT>ptr <HDC>ptr -> i32', { RECT })
+ *  @param args_4 nReserved 保留，传 0（TrackPopupMenuEx 才用）
+ *  @param args_5 hWnd 拥有者窗口（TPM_RETURNCMD 时命令 ID 回到该窗口所属线程队列）
+ *  @param args_6 prcRect 保留位，传 NULL（Win32 文档标注本 API 忽略此参数） */
+export const TrackPopupMenu = /*@__PURE__*/ b('TrackPopupMenu', '<HMENU>ptr u32 i32 i32 i32 <HWND>ptr <RECT>ptr -> i32', { RECT })
 /** 创建弹出菜单；配对 DestroyMenu
  *  @returns 菜单句柄；失败 → NULL */
 export const CreatePopupMenu = /*@__PURE__*/ b('CreatePopupMenu', ' -> <HMENU>ptr')
@@ -565,7 +565,8 @@ export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <
 
 /** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
- *  @returns 图像句柄；失败 → 0
+ *  @returns 图像句柄——类型随 uType（IMAGE_ICON→HICON / CURSOR→HCURSOR / BITMAP→HBITMAP），
+ *    绑定侧给不出品牌故为裸地址档；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件
  *  @param args_1 name 图像名 string（资源名或文件路径）
  *  @param args_2 uType IMAGE_* 真值（BITMAP=0/CURSOR=1/ICON=2）

package/main.js

@@ -1,6 +1,11 @@
-import { CallWindowProc, CreateSystemDpiFont, CreateWindow as CreateWindowWithoutScale, DefWindowProc, GetScaleFactor, GetWindowLongPtr, GetWindowText, RegisterClass, SendMessage, SetWindowProc, ShowWindow, } from "gui";
-const scaleFactor = GetScaleFactor();
-const dpiFont = CreateSystemDpiFont();
+import { CreateWindow as CreateWindowWithoutScale, DefWindowProc, RegisterClass, SendMessage, SetWindowProc, } from "gui";
+// Win32 直通：CallWindowProc / GetWindowLongPtr / GetWindowText 无引擎状态，
+// 已从 gui 模块摘除，走 lib/windows 的 FFI 绑定
+import { CallWindowProc, GetWindowLongPtr, GetWindowText, GetWindowTextLength, ShowWindow } from "./lib/windows/user32.js";
+import { WCHAR } from "./lib/ffi/bind.js";
+import { createSystemDpiFont, getScaleFactor } from "./lib/dpi.js";
+const scaleFactor = getScaleFactor();
+const dpiFont = createSystemDpiFont();
 if (!dpiFont)
     throw new Error('Failed to create DPI font');
 const CreateWindow = (className, title, style, x, y, cx, cy, parent, id) => {
@@ -26,7 +31,10 @@ function wndProc(hwnd, msg, wParam, lParam) {
                     return 0;
                 if (!list)
                     return 0;
-                const text = GetWindowText(edit);
+                const cap = GetWindowTextLength(edit) + 1;
+                const buf = WCHAR.alloc(cap);
+                GetWindowText(edit, buf, cap);
+                const text = WCHAR.decode(buf);
                 if (text.trim())
                     SendMessage(list, 384 /* LbMsg.ADDSTRING */, 0, text);
                 return 0;
@@ -43,4 +51,4 @@ function wndProc(hwnd, msg, wParam, lParam) {
 RegisterClass("MainWindow", wndProc);
 var hwnd = CreateWindow("MainWindow", "Todo List", 13565952 /* WindowStyle.OVERLAPPEDWINDOW */, 0, 0, 600, 400, null, null);
 if (hwnd)
-    ShowWindow(hwnd);
+    ShowWindow(hwnd, 1 /* ShowWindowCmd.SHOWNORMAL */);

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "2.3.1",
+  "version": "3.0.0",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",
@@ -22,7 +22,6 @@
     "lib/",
     "test/",
     "examples/",
-    "vendor/",
     "quickwin.d.ts",
     "constants.ts",
     "enum_map.d.ts",
@@ -36,6 +35,7 @@
     "url": "git+https://github.com/quickwinlabs/quickwin.git"
   },
   "devDependencies": {
+    "@quickwinlabs/mupdf-wasm": "^1.28.0",
     "@types/node": "^24.13.2",
     "@types/react": "^19.2.17",
     "@types/react-reconciler": "^0.33.0",

package/quickwin.d.ts

@@ -421,96 +421,23 @@ declare module "wolfssl" {
 
 }
 
-declare module "win" {
-    /** 与 ffi 的 Ptr<"HMODULE"> 同型（ptrBrand string 键）——FFI 侧 <HMODULE>ptr 位（HINSTANCE 语义）直收 */
-    type HMODULE = number & { readonly ptrBrand: "HMODULE" };
-
-    function LoadLibrary(libName: string): HMODULE | null;
-    function GetProcAddress(hModule: HMODULE, procName: string): number | null;
-    function FreeLibrary(hModule: HMODULE): boolean;
-    /** GetModuleFileName(hModule?) — 传 HMODULE 或不传（当前进程），返回模块完整路径；失败返回 undefined */
-    function GetModuleFileName(hModule?: HMODULE): string | undefined;
-    /** GetModuleHandle(moduleName?) — 不传返回当前 exe 的模块句柄；失败返回 null */
-    function GetModuleHandle(moduleName?: string): HMODULE | null;
-}
-
 declare module "gui" {
     /** 与 ffi 的 Ptr<"N"> 结构同型（ptrBrand string 键，见 lib/ffi/ctype.ts）——各句柄可在
      *  gui 模块与 FFI 绑定两体系间互认直传（原 unique symbol 键只有 HWND 打通） */
     type HWND = number & { readonly ptrBrand: "HWND" };
     type HMENU = number & { readonly ptrBrand: "HMENU" };
-    type HFONT = number & { readonly ptrBrand: "HFONT" };
     type HICON = number & { readonly ptrBrand: "HICON" };
-    type WNDPROC = number & { readonly ptrBrand: "WNDPROC" };
-    // 枚举唯一定义在 constants.ts（真实 .ts，tsc/esbuild 均内联）；此处别名仅供签名引用，
-    // 使用方请直接 import { WindowStyle } from 'quickwin/constants'。
-    // Gwlp/ImageType 的成员访问（如 Gwlp.WNDPROC）需写 import('./constants').Gwlp.WNDPROC
-    // ——类型别名不建命名空间，无法穿透取成员。
-    type GetWindowCmd = import('./constants').GetWindowCmd;
-    type ShowWindowCmd = import('./constants').ShowWindowCmd;
-    type SetWindowPosHwnd = import('./constants').SetWindowPosHwnd;
-    type Gwlp = import('./constants').Gwlp;
-    type NotifyIconCmd = import('./constants').NotifyIconCmd;
-    type ImageType = import('./constants').ImageType;
-    type IDI = import('./constants').IDI;
-    type ScrollBar = import('./constants').ScrollBar;
+    // 枚举唯一定义在 constants.ts（真实 .ts，tsc/esbuild 均内联）；本模块不再转出枚举
+    // 别名与 RECT 等结构类型——Win32 直通请走 lib/windows（含常量与结构定义）
 
     function RegisterClass(className: string, wndProc?: (hwnd: HWND, msg: number, wParam: number, lParam: number) => number): number;
     function CreateWindow(className: string, title: string, style: number, x: number, y: number, width: number, height: number, parent: HWND | null, menu: HMENU | null): HWND | null;
     // 销毁窗口及其所有子窗口，自动清理 WNDPROC 和 JS 引用
     function DestroyWindow(hwnd: HWND): boolean;
-    function GetWindow(hwnd: HWND, cmd: GetWindowCmd): HWND;
-
-    function ShowWindow(hwnd: HWND, nCmdShow?: ShowWindowCmd): void;
     function SetWindowProc(hwnd: HWND, wndProc: (hwnd: HWND, msg: number, wParam: number, lParam: number) => number): void;
     function DefWindowProc(hwnd: HWND, msg: number, wParam: number, lParam: number): number;
-    function PostQuitMessage(exitCode: number): void;
     function SendMessage(hwnd: HWND, msg: number, wParam: number, lParam: number | string): number;
-    function MessageBox(message: string): void;
-    function SetWindowText(hwnd: HWND, text: string): void;
-    function GetWindowText(hwnd: HWND): string;
-    function GetScaleFactor(): number;
-    function CreateSystemDpiFont(): HFONT | null;
-    type GwlpReturnType<T extends Gwlp> = T extends import('./constants').Gwlp.WNDPROC ? WNDPROC : number;
-    function GetWindowLongPtr<T extends Gwlp>(hwnd: HWND, nIndex: T): GwlpReturnType<T>;
-    function SetWindowLongPtr(hwnd: HWND, nIndex: Gwlp, newLong: number): number;
     function UnsetWindowProc(hwnd: HWND): boolean;
-    function CallWindowProc(wndProc: WNDPROC, hwnd: HWND, msg: number, wParam: number, lParam: number): number;
-    function SetParent(hwnd: HWND, parent: HWND | null): void;
-    function EnableWindow(hwnd: HWND, enable: boolean): void;
-    function SetWindowPos(hwnd: HWND, insertAfter: SetWindowPosHwnd, x: number, y: number, width: number, height: number, flags: number): void;
-
-
-
-    interface NotifyIconData {
-        hwnd: HWND
-        uID?: number
-        flags?: number
-        callbackMessage?: number
-        hIcon?: HICON
-        tip?: string
-    }
-
-    function ShellNotifyIcon(cmd: NotifyIconCmd, nid: NotifyIconData): boolean;
-    /**
-     * Thin wrapper around LoadImageW. Parameter order matches Win32 LoadImageW: (hinst, name, uType?, cx?, cy?, fuLoad?).
-     * hinst: null for system resources/file path, number for module handle;
-     * name: when hinst=null, a system icon IDI or .ico file path; when hinst=module handle, a resource ID (number) or resource name (string);
-     * uType: ImageType constant, default IMAGE_ICON (returns HICON), pass BITMAP/CURSOR for number return;
-     * cx/cy: target size (0 for default, use LoadImageFlag.DEFAULTSIZE for system default size);
-     * fuLoad: LoadImageFlag constants. Note: loading system icons (IDI_*, hinst=null) requires LoadImageFlag.SHARED.
-     * Example: import { IDI, ImageType, LoadImageFlag } from 'quickwin/constants'
-     *          gui.LoadImage(null, "app.ico", ImageType.ICON, 32, 32, LoadImageFlag.LOADFROMFILE)
-     *          gui.LoadImage(null, IDI.APPLICATION, ImageType.ICON, 0, 0, LoadImageFlag.SHARED)
-     */
-    function LoadImage<H extends (import("win").HMODULE) | null, T extends ImageType = import('./constants').ImageType.ICON>(
-        hinst: H,
-        name: H extends null ? string | IDI : string | number,
-        uType?: T,
-        cx?: number,
-        cy?: number,
-        fuLoad?: number
-    ): T extends import('./constants').ImageType.ICON ? HICON | null : number | null;
     /**
      * Loads the first icon group (RT_GROUP_ICON) from this exe, i.e. the custom icon
      * embedded by rcedit. Works with any resource ID including 0. Returns null if the
@@ -519,46 +446,6 @@ declare module "gui" {
      * Example: gui.LoadAppIcon() → HICON of the exe's icon.
      */
     function LoadAppIcon(cx?: number, cy?: number): HICON | null;
-    /** 从 BGRA 像素数据创建 32bpp top-down DIB，data 为 length >= width*height*4 的 ArrayBuffer，返回 HBITMAP */
-    function CreateBitmapFromPixels(width: number, height: number, data: ArrayBuffer): number | null;
-    function DeleteObject(hObject: number): boolean;
-    function ImageListCreate(cx: number, cy: number, flags?: number, initial?: number, grow?: number): number | null;
-    function ImageListAdd(himl: number, hBitmap: number): number;
-    function ImageListDestroy(himl: number): boolean;
-
-
-    function CreatePopupMenu(): HMENU | null;
-    function AppendMenu(menu: HMENU, flags: number, id: number, text: string): boolean;
-    function TrackPopupMenu(menu: HMENU, x: number, y: number, flags?: number, hwnd?: HWND): number;
-    function DestroyMenu(menu: HMENU): boolean;
-    function SetForegroundWindow(hwnd: HWND): boolean;
-    /** Returns [x, y] or null */
-    function GetCursorPos(): [number, number] | null;
-    /** Returns [width, height] of the primary monitor */
-    function GetScreenSize(): [number, number];
-    /** Client-area/mouse rect: { left, top, right, bottom } */
-    type RECT = { left: number; top: number; right: number; bottom: number };
-    /** Returns { left, top, right, bottom } of client area, or null if invalid */
-    function GetClientRect(hwnd: HWND): RECT | null;
-    
-    function GetWindowRect(hwnd: HWND): RECT | null;
-    /** Invalidates client area (rect can be null/undefined for full window) */
-    function InvalidateRect(hwnd: HWND, rect?: RECT | null, erase?: boolean): void;
-    /** Forces immediate repaint of invalidated area */
-    function UpdateWindow(hwnd: HWND): void;
-    /** Checks if the window handle is valid */
-    function IsWindow(hwnd: HWND): boolean;
-    /** Sets scroll info; returns current scroll box position. Signature matches Win32 SetScrollInfo. */
-    function SetScrollInfo(hwnd: HWND, bar: ScrollBar, info: { pos?: number; page?: number; min?: number; max?: number }, redraw?: boolean): number;
-
-    /** Gets scroll info. Signature matches Win32 GetScrollInfo. */
-    function GetScrollInfo(hwnd: HWND, bar: ScrollBar): { pos: number; page: number; min: number; max: number; trackPos: number };
-
-    /** Shows or hides a scroll bar. Signature matches Win32 ShowScrollBar. */
-    function ShowScrollBar(hwnd: HWND, bar: ScrollBar, show: boolean): boolean;
-
-
-
 
 
 
@@ -585,6 +472,12 @@ declare module "gui" {
 }
 
 declare module "ffi" {
+    /** 指针品牌唯一定义在 lib/ffi/ctype.ts（此处只转发，不手抄结构）——本模块返回的
+     *  句柄 / 地址即对应 C 侧指针位，空值形态同 FFI 层：NULL（0），不是 JS null。 */
+    type Ptr<N extends string> = import('./lib/ffi/ctype').Ptr<N>;
+    type MaybePtr<N extends string> = import('./lib/ffi/ctype').MaybePtr<N>;
+    type HMODULE = Ptr<"HMODULE">;
+
     function ffiCall(func: number, argFrame: ArrayBuffer, retBuf: ArrayBuffer, retIsFp: 0 | 1): void;
     function bufferPtr(buf: ArrayBuffer): number;
     function readByte(ptr: number): number;
@@ -592,6 +485,11 @@ declare module "ffi" {
     function writeByte(ptr: number, value: number): void;
     function closureNew(argBytes: number, retKind: number, wrapper: (frame: ArrayBuffer, retBuf: ArrayBuffer) => void): number;
     function closureFree(ptr: number): void;
+    /** LoadLibraryW 直映：FFI 自举入口（ffi 自身没有 dlopen，取符号必先装载），
+     *  成功为模块句柄 <HMODULE>ptr（HINSTANCE 语义），失败为空指针（0）；按真值收窄。 */
+    function LoadLibrary(libName: string): MaybePtr<"HMODULE">;
+    /** GetProcAddress 直映：成功为函数地址 <FARPROC>ptr，失败为空指针（0）。 */
+    function GetProcAddress(hModule: HMODULE, procName: string): MaybePtr<"FARPROC">;
 }
 
 

package/test/bench_ffi_callraw.js

@@ -13,7 +13,6 @@
 // 结束必须 DestroyWindow + std.exit。
 import * as std from 'std';
 import * as gui from 'gui';
-import * as win from 'win';
 import * as ffi from 'ffi';
 import { bind } from '../lib/ffi/bind.js';
 const WM_NULL = 0x0000;
@@ -37,11 +36,11 @@ function step(msg) {
 step('stage: imports ok');
 // ---- proc 地址（B/C 臂绕过 bind 直驱 ffiCall）----
 function procOf(dll, name) {
-    const h = win.LoadLibrary(dll);
+    const h = ffi.LoadLibrary(dll);
     if (!h)
         throw new Error('LoadLibrary(' + dll + ') failed');
-    const p = win.GetProcAddress(h, name);
-    if (p === null)
+    const p = ffi.GetProcAddress(h, name);
+    if (!p)
         throw new Error('GetProcAddress(' + dll + '!' + name + ') failed');
     return p;
 }

package/test/bench_ffi_callraw.ts

@@ -13,7 +13,6 @@
 // 结束必须 DestroyWindow + std.exit。
 import * as std from 'std'
 import * as gui from 'gui'
-import * as win from 'win'
 import * as ffi from 'ffi'
 import { bind } from '../lib/ffi/bind.js'
 
@@ -39,10 +38,10 @@ step('stage: imports ok')
 
 // ---- proc 地址（B/C 臂绕过 bind 直驱 ffiCall）----
 function procOf(dll: string, name: string): number {
-    const h = win.LoadLibrary(dll)
+    const h = ffi.LoadLibrary(dll)
     if (!h) throw new Error('LoadLibrary(' + dll + ') failed')
-    const p = win.GetProcAddress(h, name)
-    if (p === null) throw new Error('GetProcAddress(' + dll + '!' + name + ') failed')
+    const p = ffi.GetProcAddress(h, name)
+    if (!p) throw new Error('GetProcAddress(' + dll + '!' + name + ') failed')
     return p
 }
 const pNop0 = procOf('test/nop.dll', 'nop0')