quickwin 1.3.0 → 2.1.0

package/lib/text-measure.ts

@@ -1,39 +1,35 @@
-import * as ffi from 'ffi'
+import { NULL, type Ptr } from './ffi/ctype.js'
 import * as gui from 'gui'
-import { bindLib } from './ffi-bind.js'
+import { DrawText, GetDC, ReleaseDC } from './windows/user32.js'
+import { SelectObject } from './windows/gdi32.js'
+import { RECT, SIZE } from './windows/structs.js'
 
-const user32 = bindLib('user32.dll', {
-    DrawTextW: 'ptr wstr i32 ptr i32 -> i32',
-    GetDC: 'ptr -> ptr',
-    ReleaseDC: 'ptr ptr -> i32',
-})
-const gdi32 = bindLib('gdi32.dll', {
-    SelectObject: 'ptr ptr -> ptr',
-})
-
-export function measureText(hdc: number, text: string, maxWidth: number): { width: number; height: number } {
-    const rect = new ArrayBuffer(16)
-    const dv = new DataView(rect)
-    dv.setInt32(8, maxWidth, true)
-    user32.DrawTextW(hdc, text, -1, rect, gui.DrawTextFlag.CALCRECT)
-    return { width: dv.getInt32(8, true), height: dv.getInt32(12, true) }
+export function measureText(hdc: Ptr<'HDC'>, text: string, maxWidth: number): { width: number; height: number } {
+    // rect 双向位不注册 encoder（CALCRECT 就地写回）：encode(初值) 新建 + DeepPartial 初值一步到位
+    //（left/top/bottom 缺省跳过保持 0）→ 传 .ptr → decode 读回
+    const r = RECT.encode({ right: maxWidth })
+    DrawText(hdc, text, -1, r.ptr, gui.DrawTextFlag.CALCRECT)
+    const { right, bottom } = RECT.decode(r)
+    return { width: right, height: bottom }
 }
 
 export function getButtonIdealSize(hwnd: gui.HWND): { width: number; height: number } {
-    const size = new ArrayBuffer(8)
-    gui.SendMessage(hwnd, gui.ButtonExtMsg.GETIDEALSIZE, 0, ffi.bufferPtr(size))
-    const dv = new DataView(size)
-    return { width: dv.getInt32(0, true), height: dv.getInt32(4, true) }
+    // SIZE 纯出参位（GETIDEALSIZE 就地写回）：alloc → 传 .ptr → decode 读回
+    const size = SIZE.alloc()
+    gui.SendMessage(hwnd, gui.ButtonExtMsg.GETIDEALSIZE, 0, size.ptr)
+    const { cx, cy } = SIZE.decode(size)
+    return { width: cx, height: cy }
 }
 
 export function measureTextForHwnd(hwnd: gui.HWND, text: string): { width: number; height: number } {
-    const hdc = user32.GetDC(hwnd)
+    const hdc = GetDC(hwnd)
     if (!hdc) return { width: 0, height: 0 }
-    const hFont = gui.SendMessage(hwnd, gui.WmMsg.GETFONT, 0, 0)
-    const oldFont = hFont ? gdi32.SelectObject(hdc, hFont) : 0
+    // SendMessage 返回 LRESULT 裸数；GETFONT 语义为 HFONT——断言进 GDI 对象品牌链
+    const hFont = gui.SendMessage(hwnd, gui.WmMsg.GETFONT, 0, 0) as Ptr<'HGDIOBJ'>
+    const oldFont = hFont ? SelectObject(hdc, hFont) : NULL
     const result = measureText(hdc, text, 0)
-    if (hFont) gdi32.SelectObject(hdc, oldFont)
-    user32.ReleaseDC(hwnd, hdc)
+    if (hFont) SelectObject(hdc, oldFont)
+    ReleaseDC(hwnd, hdc)
     const wr = gui.GetWindowRect(hwnd)
     const cr = gui.GetClientRect(hwnd)
     if (wr && cr) {

package/lib/websocket.js

@@ -295,7 +295,13 @@ class WebSocketImpl {
                         doError(new Error('SSL_CTX_new failed'));
                         return;
                     }
-                    wolfssl.wolfSSL_CTX_set_verify(this._ctx, 0 /* wolfssl.VerifyMode.SSL_VERIFY_NONE */);
+                    if (this._options.rejectUnauthorized === false) {
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 0 /* wolfssl.VerifyMode.SSL_VERIFY_NONE */);
+                    }
+                    else {
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 1 /* wolfssl.VerifyMode.SSL_VERIFY_PEER */);
+                        wolfssl.loadTrustedCerts(this._ctx);
+                    }
                     this._ssl = wolfssl.wolfSSL_new(this._ctx);
                     if (!this._ssl) {
                         doError(new Error('SSL_new failed'));
@@ -303,8 +309,12 @@ class WebSocketImpl {
                     }
                     wolfssl.wolfSSL_set_fd(this._ssl, sock.get_fd(fd));
                     const sniHost = host;
-                    if (sniHost)
+                    if (sniHost) {
                         wolfssl.wolfSSL_UseSNI(this._ssl, 0 /* wolfssl.SniType.WOLFSSL_SNI_HOST_NAME */, sniHost);
+                        if (this._options.rejectUnauthorized !== false) {
+                            wolfssl.wolfSSL_check_domain_name(this._ssl, sniHost);
+                        }
+                    }
                     state = 'handshake';
                 }
                 else {
@@ -335,7 +345,21 @@ class WebSocketImpl {
                     while (true) {
                         let data;
                         if (isWSS && this._ssl) {
-                            data = wolfssl.wolfSSL_read(this._ssl, 8192);
+                            const buf = new ArrayBuffer(8192);
+                            const n = wolfssl.wolfSSL_read(this._ssl, buf);
+                            if (n > 0) {
+                                data = buf.slice(0, n);
+                            }
+                            else {
+                                const err = wolfssl.wolfSSL_get_error(this._ssl, n);
+                                if (err === 2 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ */ ||
+                                    err === 3 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE */)
+                                    break;
+                                if (n === 0 || err === 6 /* wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
+                                    break;
+                                doError(new Error('TLS read failed: ' + err));
+                                return;
+                            }
                         }
                         else if (this._sock !== null && this._sock >= 0) {
                             data = sock.recv(this._sock, 8192);
@@ -433,7 +457,23 @@ class WebSocketImpl {
         while (true) {
             let data;
             if (this._ssl) {
-                data = wolfssl.wolfSSL_read(this._ssl, 8192);
+                const buf = new ArrayBuffer(8192);
+                const n = wolfssl.wolfSSL_read(this._ssl, buf);
+                if (n > 0) {
+                    data = buf.slice(0, n);
+                }
+                else {
+                    const err = wolfssl.wolfSSL_get_error(this._ssl, n);
+                    if (err === 2 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ */ ||
+                        err === 3 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE */)
+                        break;
+                    if (n === 0 || err === 6 /* wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
+                        break;
+                    this._fireError(new Error('TLS read failed: ' + err));
+                    if (this._state !== State.CLOSED)
+                        this._setState(State.CLOSED);
+                    return;
+                }
             }
             else if (this._sock !== null && this._sock >= 0) {
                 data = sock.recv(this._sock, 8192);

package/lib/websocket.ts

@@ -151,6 +151,9 @@ function tryParseFrame(buffer: Uint8Array): ParsedFrame | null {
 
 interface WebSocketOptions {
     headers?: Record<string, string>
+    /** Non-standard: when false, TLS certificate verification is skipped
+     *  (mirrors Node's tls.connect rejectUnauthorized option). */
+    rejectUnauthorized?: boolean
 }
 
 
@@ -318,12 +321,22 @@ class WebSocketImpl {
                     const method = wolfssl.wolfTLSv1_2_client_method()
                     this._ctx = wolfssl.wolfSSL_CTX_new(method)
                     if (!this._ctx) { doError(new Error('SSL_CTX_new failed')); return }
-                    wolfssl.wolfSSL_CTX_set_verify(this._ctx, wolfssl.VerifyMode.SSL_VERIFY_NONE)
+                    if (this._options.rejectUnauthorized === false) {
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, wolfssl.VerifyMode.SSL_VERIFY_NONE)
+                    } else {
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, wolfssl.VerifyMode.SSL_VERIFY_PEER)
+                        wolfssl.loadTrustedCerts(this._ctx)
+                    }
                     this._ssl = wolfssl.wolfSSL_new(this._ctx)
                     if (!this._ssl) { doError(new Error('SSL_new failed')); return }
                     wolfssl.wolfSSL_set_fd(this._ssl, sock.get_fd(fd))
                     const sniHost = host
-                    if (sniHost) wolfssl.wolfSSL_UseSNI(this._ssl, wolfssl.SniType.WOLFSSL_SNI_HOST_NAME, sniHost)
+                    if (sniHost) {
+                        wolfssl.wolfSSL_UseSNI(this._ssl, wolfssl.SniType.WOLFSSL_SNI_HOST_NAME, sniHost)
+                        if (this._options.rejectUnauthorized !== false) {
+                            wolfssl.wolfSSL_check_domain_name(this._ssl, sniHost)
+                        }
+                    }
                     state = 'handshake'
                 } else {
                     this._sendRawStr(request)
@@ -350,7 +363,18 @@ class WebSocketImpl {
                     while (true) {
                         let data: ArrayBuffer | null
                         if (isWSS && this._ssl) {
-                            data = wolfssl.wolfSSL_read(this._ssl, 8192)
+                            const buf = new ArrayBuffer(8192)
+                            const n = wolfssl.wolfSSL_read(this._ssl, buf)
+                            if (n > 0) {
+                                data = buf.slice(0, n)
+                            } else {
+                                const err = wolfssl.wolfSSL_get_error(this._ssl, n)
+                                if (err === wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ ||
+                                    err === wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE) break
+                                if (n === 0 || err === wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN) break
+                                doError(new Error('TLS read failed: ' + err))
+                                return
+                            }
                         } else if (this._sock !== null && this._sock >= 0) {
                             data = sock.recv(this._sock, 8192)
                         } else { break }
@@ -447,7 +471,19 @@ class WebSocketImpl {
         while (true) {
             let data: ArrayBuffer | null
             if (this._ssl) {
-                data = wolfssl.wolfSSL_read(this._ssl, 8192)
+                const buf = new ArrayBuffer(8192)
+                const n = wolfssl.wolfSSL_read(this._ssl, buf)
+                if (n > 0) {
+                    data = buf.slice(0, n)
+                } else {
+                    const err = wolfssl.wolfSSL_get_error(this._ssl, n)
+                    if (err === wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ ||
+                        err === wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE) break
+                    if (n === 0 || err === wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN) break
+                    this._fireError(new Error('TLS read failed: ' + err))
+                    if (this._state !== State.CLOSED) this._setState(State.CLOSED)
+                    return
+                }
             } else if (this._sock !== null && this._sock >= 0) {
                 data = sock.recv(this._sock, 8192)
             } else { break }

package/lib/windows/advapi32.js

@@ -0,0 +1,53 @@
+// advapi32 绑定（注册表 API；键名/值名一律 W 版 UTF-16）
+import { bind } from '../ffi/bind.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = (name, sig) => bind('advapi32.dll', name, sig);
+/** 创建/打开子键（子键不存在则创建，含中间层级）
+ *  @returns 0 = ERROR_SUCCESS
+ *  @param args_0 hKey 父键：gui.HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
+ *                Open/Create 返回的真实句柄（此位双来源，不标 @HKey——裸位收两种）
+ *  @param args_1 lpSubKey 子键路径（'Software\\X\\Y'，可 NULL = 打开 hKey 自身副本）
+ *  @param args_2 Reserved 保留，恒 0
+ *  @param args_3 lpClass 键类名（一般 NULL）
+ *  @param args_4 dwOptions 保留属性（恒 0）
+ *  @param args_5 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
+ *  @param args_6 lpSecurityAttributes 安全描述符（一般 NULL）
+ *  @param args_7 phkResult 出参：键句柄（PtrArrayBuffer(8)，readPtr 按架构读回）
+ *  @param args_8 lpdwDisposition 出参：新建/已存在标记（可 NULL） */
+export const RegCreateKeyEx = /*@__PURE__*/ b('RegCreateKeyExW', '<>ptr <WCHAR>ptr u32 <WCHAR>ptr u32 u32@RegAccess <>ptr <BYTE>ptr <BYTE>ptr -> i32');
+/** 打开已有子键（不创建）
+ *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（子键不存在）
+ *  @param args_0 hKey 父键（同 RegCreateKeyEx 的双来源语义）
+ *  @param args_1 lpSubKey 子键路径（NULL = 打开 hKey 自身副本）
+ *  @param args_2 ulOptions 保留，恒 0
+ *  @param args_3 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE
+ *  @param args_4 phkResult 出参：键句柄 */
+export const RegOpenKeyEx = /*@__PURE__*/ b('RegOpenKeyExW', '<>ptr <WCHAR>ptr u32 u32@RegAccess <BYTE>ptr -> i32');
+/** 关闭键句柄；只关 Open/Create 返回的真实句柄——预定义键（HKEY_CURRENT_USER 等）
+ *  不要关
+ *  @returns 0 = ERROR_SUCCESS */
+export const RegCloseKey = /*@__PURE__*/ b('RegCloseKey', '<>ptr -> i32');
+/** 写键值
+ *  @returns 0 = ERROR_SUCCESS
+ *  @param args_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 gui.RegAccess.SET_VALUE）
+ *  @param args_1 lpValueName 值名（NULL = 键的默认值）
+ *  @param args_2 Reserved 保留，恒 0
+ *  @param args_3 dwType 值类型 gui.RegType.SZ（UTF-16 字符串）
+ *  @param args_4 lpData 数据缓冲（REG_SZ：UTF-16LE 含结尾 NUL）
+ *  @param args_5 cbData 数据字节数（REG_SZ = (字符数+1)*2） */
+export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW', '<>ptr <WCHAR>ptr u32 u32@RegType <BYTE>ptr u32 -> i32');
+/** 读键值（两跳模式：第一跳 lpData=NULL 取尺寸/类型，第二跳按尺寸带缓冲读数据）
+ *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（值不存在）
+ *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 gui.RegAccess.READ）
+ *  @param args_1 lpValueName 值名（NULL = 键的默认值）
+ *  @param args_2 lpReserved 保留，恒 NULL
+ *  @param args_3 lpType 出参：值类型（可 NULL）
+ *  @param args_4 lpData 数据缓冲（可 NULL = 只查尺寸）
+ *  @param args_5 lpcbData 双向：入 = lpData 缓冲字节数（须预写）、出 = 实际字节数 */
+export const RegQueryValueEx = /*@__PURE__*/ b('RegQueryValueExW', '<>ptr <WCHAR>ptr <>ptr <BYTE>ptr <BYTE>ptr <BYTE>ptr -> i32');
+/** 删除子键（连值一起删）；须父键 KEY_CREATE_SUB_KEY 权限——自己的 HKCU 直接传
+ *  gui.HKey.CURRENT_USER 即可
+ *  @returns 0 = ERROR_SUCCESS；2 = 子键不存在
+ *  @param args_0 hKey 父键
+ *  @param args_1 lpSubKey 要删的子键路径（不可 NULL） */
+export const RegDeleteKey = /*@__PURE__*/ b('RegDeleteKeyW', '<>ptr <WCHAR>ptr -> i32');

package/lib/windows/advapi32.ts

@@ -0,0 +1,64 @@
+// advapi32 绑定（注册表 API；键名/值名一律 W 版 UTF-16）
+import { bind } from '../ffi/bind.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string>(name: string, sig: S) => bind('advapi32.dll', name, sig)
+
+/** 创建/打开子键（子键不存在则创建，含中间层级）
+ *  @returns 0 = ERROR_SUCCESS
+ *  @param args_0 hKey 父键：gui.HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
+ *                Open/Create 返回的真实句柄（此位双来源，不标 @HKey——裸位收两种）
+ *  @param args_1 lpSubKey 子键路径（'Software\\X\\Y'，可 NULL = 打开 hKey 自身副本）
+ *  @param args_2 Reserved 保留，恒 0
+ *  @param args_3 lpClass 键类名（一般 NULL）
+ *  @param args_4 dwOptions 保留属性（恒 0）
+ *  @param args_5 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
+ *  @param args_6 lpSecurityAttributes 安全描述符（一般 NULL）
+ *  @param args_7 phkResult 出参：键句柄（PtrArrayBuffer(8)，readPtr 按架构读回）
+ *  @param args_8 lpdwDisposition 出参：新建/已存在标记（可 NULL） */
+export const RegCreateKeyEx = /*@__PURE__*/ b('RegCreateKeyExW',
+    '<>ptr <WCHAR>ptr u32 <WCHAR>ptr u32 u32@RegAccess <>ptr <BYTE>ptr <BYTE>ptr -> i32')
+
+/** 打开已有子键（不创建）
+ *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（子键不存在）
+ *  @param args_0 hKey 父键（同 RegCreateKeyEx 的双来源语义）
+ *  @param args_1 lpSubKey 子键路径（NULL = 打开 hKey 自身副本）
+ *  @param args_2 ulOptions 保留，恒 0
+ *  @param args_3 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE
+ *  @param args_4 phkResult 出参：键句柄 */
+export const RegOpenKeyEx = /*@__PURE__*/ b('RegOpenKeyExW',
+    '<>ptr <WCHAR>ptr u32 u32@RegAccess <BYTE>ptr -> i32')
+
+/** 关闭键句柄；只关 Open/Create 返回的真实句柄——预定义键（HKEY_CURRENT_USER 等）
+ *  不要关
+ *  @returns 0 = ERROR_SUCCESS */
+export const RegCloseKey = /*@__PURE__*/ b('RegCloseKey', '<>ptr -> i32')
+
+/** 写键值
+ *  @returns 0 = ERROR_SUCCESS
+ *  @param args_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 gui.RegAccess.SET_VALUE）
+ *  @param args_1 lpValueName 值名（NULL = 键的默认值）
+ *  @param args_2 Reserved 保留，恒 0
+ *  @param args_3 dwType 值类型 gui.RegType.SZ（UTF-16 字符串）
+ *  @param args_4 lpData 数据缓冲（REG_SZ：UTF-16LE 含结尾 NUL）
+ *  @param args_5 cbData 数据字节数（REG_SZ = (字符数+1)*2） */
+export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW',
+    '<>ptr <WCHAR>ptr u32 u32@RegType <BYTE>ptr u32 -> i32')
+
+/** 读键值（两跳模式：第一跳 lpData=NULL 取尺寸/类型，第二跳按尺寸带缓冲读数据）
+ *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（值不存在）
+ *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 gui.RegAccess.READ）
+ *  @param args_1 lpValueName 值名（NULL = 键的默认值）
+ *  @param args_2 lpReserved 保留，恒 NULL
+ *  @param args_3 lpType 出参：值类型（可 NULL）
+ *  @param args_4 lpData 数据缓冲（可 NULL = 只查尺寸）
+ *  @param args_5 lpcbData 双向：入 = lpData 缓冲字节数（须预写）、出 = 实际字节数 */
+export const RegQueryValueEx = /*@__PURE__*/ b('RegQueryValueExW',
+    '<>ptr <WCHAR>ptr <>ptr <BYTE>ptr <BYTE>ptr <BYTE>ptr -> i32')
+
+/** 删除子键（连值一起删）；须父键 KEY_CREATE_SUB_KEY 权限——自己的 HKCU 直接传
+ *  gui.HKey.CURRENT_USER 即可
+ *  @returns 0 = ERROR_SUCCESS；2 = 子键不存在
+ *  @param args_0 hKey 父键
+ *  @param args_1 lpSubKey 要删的子键路径（不可 NULL） */
+export const RegDeleteKey = /*@__PURE__*/ b('RegDeleteKeyW', '<>ptr <WCHAR>ptr -> i32')

package/lib/windows/comctl32.js

@@ -0,0 +1,18 @@
+// comctl32 绑定（ImageList 系列；HIMAGELIST 不透明句柄走 <HIMAGELIST>ptr 自产自收，
+// Add 的 hbm 位与 gdi32 的 <HGDIOBJ>ptr 同型互认——CreateBitmap 产物直传）
+import { bind } from '../ffi/bind.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = (name, sig) => bind('comctl32.dll', name, sig);
+/** 建图像列表；配对 ImageListDestroy
+ *  @returns 图像列表句柄；失败 → NULL
+ *  @param args_0 cx/cy 图像尺寸  @param args_2 flags ILC_* 组合
+ *  @param args_3 cInitial 初始容量  @param args_4 cGrow 增长步长 */
+export const ImageListCreate = /*@__PURE__*/ b('ImageList_Create', 'i32 i32 u32 i32 i32 -> <HIMAGELIST>ptr');
+/** 加位图进图像列表
+ *  @returns 新索引（-1 失败）
+ *  @param args_0 himl 图像列表句柄
+ *  @param args_1 hbm 位图句柄（gdi32 <HGDIOBJ>ptr 产物，如 CreateCompatibleBitmap） */
+export const ImageListAdd = /*@__PURE__*/ b('ImageList_Add', '<HIMAGELIST>ptr <HGDIOBJ>ptr -> i32');
+/** 销毁图像列表
+ *  @returns 成功 → 非 0 */
+export const ImageListDestroy = /*@__PURE__*/ b('ImageList_Destroy', '<HIMAGELIST>ptr -> i32');

package/lib/windows/comctl32.ts

@@ -0,0 +1,19 @@
+// comctl32 绑定（ImageList 系列；HIMAGELIST 不透明句柄走 <HIMAGELIST>ptr 自产自收，
+// Add 的 hbm 位与 gdi32 的 <HGDIOBJ>ptr 同型互认——CreateBitmap 产物直传）
+import { bind } from '../ffi/bind.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string>(name: string, sig: S) => bind('comctl32.dll', name, sig)
+/** 建图像列表；配对 ImageListDestroy
+ *  @returns 图像列表句柄；失败 → NULL
+ *  @param args_0 cx/cy 图像尺寸  @param args_2 flags ILC_* 组合
+ *  @param args_3 cInitial 初始容量  @param args_4 cGrow 增长步长 */
+export const ImageListCreate = /*@__PURE__*/ b('ImageList_Create', 'i32 i32 u32 i32 i32 -> <HIMAGELIST>ptr')
+/** 加位图进图像列表
+ *  @returns 新索引（-1 失败）
+ *  @param args_0 himl 图像列表句柄
+ *  @param args_1 hbm 位图句柄（gdi32 <HGDIOBJ>ptr 产物，如 CreateCompatibleBitmap） */
+export const ImageListAdd = /*@__PURE__*/ b('ImageList_Add', '<HIMAGELIST>ptr <HGDIOBJ>ptr -> i32')
+/** 销毁图像列表
+ *  @returns 成功 → 非 0 */
+export const ImageListDestroy = /*@__PURE__*/ b('ImageList_Destroy', '<HIMAGELIST>ptr -> i32')

package/lib/windows/comdlg32.js

@@ -0,0 +1,8 @@
+// comdlg32 绑定（通用文件对话框；GetOpenFileName 无 A/W 混用——一律 W 版）
+import { bind } from '../ffi/bind.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = (name, sig) => bind('comdlg32.dll', name, sig);
+/** 打开/保存文件对话框
+ *  @returns 用户确认 → 非 0（lpstrFile 缓冲即选中路径），取消/出错 → 0
+ *  @param args_0 pOpenfn OPENFILENAMEW.encode(...).ptr（lStructSize 必须 = OPENFILENAMEW.size，见 structs.ts） */
+export const GetOpenFileName = /*@__PURE__*/ b('GetOpenFileNameW', '<OPENFILENAMEW>ptr -> u32');

package/lib/windows/comdlg32.ts

@@ -0,0 +1,10 @@
+// comdlg32 绑定（通用文件对话框；GetOpenFileName 无 A/W 混用——一律 W 版）
+import { bind } from '../ffi/bind.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string>(name: string, sig: S) => bind('comdlg32.dll', name, sig)
+
+/** 打开/保存文件对话框
+ *  @returns 用户确认 → 非 0（lpstrFile 缓冲即选中路径），取消/出错 → 0
+ *  @param args_0 pOpenfn OPENFILENAMEW.encode(...).ptr（lStructSize 必须 = OPENFILENAMEW.size，见 structs.ts） */
+export const GetOpenFileName = /*@__PURE__*/ b('GetOpenFileNameW', '<OPENFILENAMEW>ptr -> u32')