quickwin 2.1.1 → 2.3.0

package/lib/websocket.js

@@ -273,16 +273,16 @@ class WebSocketImpl {
             if (this._processingHandshake)
                 return;
             if (resolved && state === 'open') {
-                if (event.lNetworkEvents & 1 /* sock.FdEvent.FD_READ */) {
+                if (event.lNetworkEvents & 1 /* FdEvent.FD_READ */) {
                     this._onData();
                 }
-                if (event.lNetworkEvents & 32 /* sock.FdEvent.FD_CLOSE */) {
+                if (event.lNetworkEvents & 32 /* FdEvent.FD_CLOSE */) {
                     this._cleanup();
                     this._setState(State.CLOSED);
                 }
                 return;
             }
-            if (event.lNetworkEvents & 16 /* sock.FdEvent.FD_CONNECT */) {
+            if (event.lNetworkEvents & 16 /* FdEvent.FD_CONNECT */) {
                 const errCode = event.iErrorCode[0];
                 if (errCode !== 0) {
                     doError(new Error('Connection failed: ' + errCode));
@@ -296,10 +296,10 @@ class WebSocketImpl {
                         return;
                     }
                     if (this._options.rejectUnauthorized === false) {
-                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 0 /* wolfssl.VerifyMode.SSL_VERIFY_NONE */);
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 0 /* VerifyMode.SSL_VERIFY_NONE */);
                     }
                     else {
-                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 1 /* wolfssl.VerifyMode.SSL_VERIFY_PEER */);
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, 1 /* VerifyMode.SSL_VERIFY_PEER */);
                         wolfssl.loadTrustedCerts(this._ctx);
                     }
                     this._ssl = wolfssl.wolfSSL_new(this._ctx);
@@ -310,7 +310,7 @@ class WebSocketImpl {
                     wolfssl.wolfSSL_set_fd(this._ssl, sock.get_fd(fd));
                     const sniHost = host;
                     if (sniHost) {
-                        wolfssl.wolfSSL_UseSNI(this._ssl, 0 /* wolfssl.SniType.WOLFSSL_SNI_HOST_NAME */, sniHost);
+                        wolfssl.wolfSSL_UseSNI(this._ssl, 0 /* SniType.WOLFSSL_SNI_HOST_NAME */, sniHost);
                         if (this._options.rejectUnauthorized !== false) {
                             wolfssl.wolfSSL_check_domain_name(this._ssl, sniHost);
                         }
@@ -322,21 +322,21 @@ class WebSocketImpl {
                     state = 'request';
                 }
             }
-            if ((event.lNetworkEvents & 1 /* sock.FdEvent.FD_READ */) || (event.lNetworkEvents & 2 /* sock.FdEvent.FD_WRITE */)) {
+            if ((event.lNetworkEvents & 1 /* FdEvent.FD_READ */) || (event.lNetworkEvents & 2 /* FdEvent.FD_WRITE */)) {
                 if (state === 'handshake') {
                     if (!this._ssl) {
                         doError(new Error('TLS not initialized'));
                         return;
                     }
                     const ret = wolfssl.wolfSSL_connect(this._ssl);
-                    if (ret === 1 /* wolfssl.ReturnCode.SSL_SUCCESS */) {
+                    if (ret === 1 /* ReturnCode.SSL_SUCCESS */) {
                         this._sendRawStr(request);
                         state = 'request';
                     }
                     else {
                         const err = wolfssl.wolfSSL_get_error(this._ssl, ret);
-                        if (err !== 2 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ */ &&
-                            err !== 3 /* wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE */) {
+                        if (err !== 2 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ */ &&
+                            err !== 3 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE */) {
                             doError(new Error('TLS handshake failed: ' + err));
                         }
                     }
@@ -352,10 +352,10 @@ class WebSocketImpl {
                             }
                             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 */)
+                                if (err === 2 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ */ ||
+                                    err === 3 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE */)
                                     break;
-                                if (n === 0 || err === 6 /* wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
+                                if (n === 0 || err === 6 /* WolfsslErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
                                     break;
                                 doError(new Error('TLS read failed: ' + err));
                                 return;
@@ -417,7 +417,7 @@ class WebSocketImpl {
                     }
                 }
             }
-            if (event.lNetworkEvents & 32 /* sock.FdEvent.FD_CLOSE */) {
+            if (event.lNetworkEvents & 32 /* FdEvent.FD_CLOSE */) {
                 if (state !== 'open') {
                     doError(new Error('Connection closed'));
                 }
@@ -464,10 +464,10 @@ class WebSocketImpl {
                 }
                 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 */)
+                    if (err === 2 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ */ ||
+                        err === 3 /* WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE */)
                         break;
-                    if (n === 0 || err === 6 /* wolfssl.ErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
+                    if (n === 0 || err === 6 /* WolfsslErrorCode.WOLFSSL_ERROR_ZERO_RETURN */)
                         break;
                     this._fireError(new Error('TLS read failed: ' + err));
                     if (this._state !== State.CLOSED)

package/lib/websocket.ts

@@ -2,6 +2,7 @@ import '../lib/polyfill.js'
 import * as sock from 'sock'
 import * as wolfssl from 'wolfssl'
 import * as os from 'os'
+import { FdEvent, ReturnCode, SniType, VerifyMode, WolfsslErrorCode } from '../constants'
 
 // ── Constants ──
 
@@ -301,17 +302,17 @@ class WebSocketImpl {
         sock.set_on_event(fd, async (event: { lNetworkEvents: number; iErrorCode: number[] }) => {
             if (this._processingHandshake) return
             if (resolved && state === 'open') {
-                if (event.lNetworkEvents & sock.FdEvent.FD_READ) {
+                if (event.lNetworkEvents & FdEvent.FD_READ) {
                     this._onData()
                 }
-                if (event.lNetworkEvents & sock.FdEvent.FD_CLOSE) {
+                if (event.lNetworkEvents & FdEvent.FD_CLOSE) {
                     this._cleanup()
                     this._setState(State.CLOSED)
                 }
                 return
             }
 
-            if (event.lNetworkEvents & sock.FdEvent.FD_CONNECT) {
+            if (event.lNetworkEvents & FdEvent.FD_CONNECT) {
                 const errCode = event.iErrorCode[0]
                 if (errCode !== 0) {
                     doError(new Error('Connection failed: ' + errCode))
@@ -322,9 +323,9 @@ class WebSocketImpl {
                     this._ctx = wolfssl.wolfSSL_CTX_new(method)
                     if (!this._ctx) { doError(new Error('SSL_CTX_new failed')); return }
                     if (this._options.rejectUnauthorized === false) {
-                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, wolfssl.VerifyMode.SSL_VERIFY_NONE)
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, VerifyMode.SSL_VERIFY_NONE)
                     } else {
-                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, wolfssl.VerifyMode.SSL_VERIFY_PEER)
+                        wolfssl.wolfSSL_CTX_set_verify(this._ctx, VerifyMode.SSL_VERIFY_PEER)
                         wolfssl.loadTrustedCerts(this._ctx)
                     }
                     this._ssl = wolfssl.wolfSSL_new(this._ctx)
@@ -332,7 +333,7 @@ class WebSocketImpl {
                     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)
+                        wolfssl.wolfSSL_UseSNI(this._ssl, SniType.WOLFSSL_SNI_HOST_NAME, sniHost)
                         if (this._options.rejectUnauthorized !== false) {
                             wolfssl.wolfSSL_check_domain_name(this._ssl, sniHost)
                         }
@@ -344,17 +345,17 @@ class WebSocketImpl {
                 }
             }
 
-            if ((event.lNetworkEvents & sock.FdEvent.FD_READ) || (event.lNetworkEvents & sock.FdEvent.FD_WRITE)) {
+            if ((event.lNetworkEvents & FdEvent.FD_READ) || (event.lNetworkEvents & FdEvent.FD_WRITE)) {
                 if (state === 'handshake') {
                     if (!this._ssl) { doError(new Error('TLS not initialized')); return }
                     const ret = wolfssl.wolfSSL_connect(this._ssl)
-                    if (ret === wolfssl.ReturnCode.SSL_SUCCESS) {
+                    if (ret === ReturnCode.SSL_SUCCESS) {
                         this._sendRawStr(request)
                         state = 'request'
                     } else {
                         const err = wolfssl.wolfSSL_get_error(this._ssl, ret)
-                        if (err !== wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_READ &&
-                            err !== wolfssl.ErrorCode.WOLFSSL_ERROR_WANT_WRITE) {
+                        if (err !== WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ &&
+                            err !== WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE) {
                             doError(new Error('TLS handshake failed: ' + err))
                         }
                     }
@@ -369,9 +370,9 @@ class WebSocketImpl {
                                 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
+                                if (err === WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ ||
+                                    err === WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE) break
+                                if (n === 0 || err === WolfsslErrorCode.WOLFSSL_ERROR_ZERO_RETURN) break
                                 doError(new Error('TLS read failed: ' + err))
                                 return
                             }
@@ -431,7 +432,7 @@ class WebSocketImpl {
                 }
             }
 
-            if (event.lNetworkEvents & sock.FdEvent.FD_CLOSE) {
+            if (event.lNetworkEvents & FdEvent.FD_CLOSE) {
                 if (state !== 'open') {
                     doError(new Error('Connection closed'))
                 }
@@ -477,9 +478,9 @@ class WebSocketImpl {
                     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
+                    if (err === WolfsslErrorCode.WOLFSSL_ERROR_WANT_READ ||
+                        err === WolfsslErrorCode.WOLFSSL_ERROR_WANT_WRITE) break
+                    if (n === 0 || err === WolfsslErrorCode.WOLFSSL_ERROR_ZERO_RETURN) break
                     this._fireError(new Error('TLS read failed: ' + err))
                     if (this._state !== State.CLOSED) this._setState(State.CLOSED)
                     return

package/lib/windows/advapi32.js

@@ -4,13 +4,13 @@ import { bind } from '../ffi/bind.js';
 const b = (name, sig) => bind('advapi32.dll', name, sig);
 /** 创建/打开子键（子键不存在则创建，含中间层级）
  *  @returns 0 = ERROR_SUCCESS
- *  @param args_0 hKey 父键：gui.HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
+ *  @param args_0 hKey 父键：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_5 samDesired 访问掩码 RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
  *  @param args_6 lpSecurityAttributes 安全描述符（一般 NULL）
  *  @param args_7 phkResult 出参：键句柄（PtrArrayBuffer(8)，readPtr 按架构读回）
  *  @param args_8 lpdwDisposition 出参：新建/已存在标记（可 NULL） */
@@ -20,7 +20,7 @@ export const RegCreateKeyEx = /*@__PURE__*/ b('RegCreateKeyExW', '<>ptr <WCHAR>p
  *  @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_3 samDesired 访问掩码 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 等）
@@ -29,16 +29,16 @@ export const RegOpenKeyEx = /*@__PURE__*/ b('RegOpenKeyExW', '<>ptr <WCHAR>ptr u
 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_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 RegAccess.SET_VALUE）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 Reserved 保留，恒 0
- *  @param args_3 dwType 值类型 gui.RegType.SZ（UTF-16 字符串）
+ *  @param args_3 dwType 值类型 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_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 RegAccess.READ）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 lpReserved 保留，恒 NULL
  *  @param args_3 lpType 出参：值类型（可 NULL）
@@ -46,7 +46,7 @@ export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW', '<>ptr <WCHAR>ptr
  *  @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 即可
+ *  HKey.CURRENT_USER 即可
  *  @returns 0 = ERROR_SUCCESS；2 = 子键不存在
  *  @param args_0 hKey 父键
  *  @param args_1 lpSubKey 要删的子键路径（不可 NULL） */

package/lib/windows/advapi32.ts

@@ -6,13 +6,13 @@ const b = <const S extends string>(name: string, sig: S) => bind('advapi32.dll',
 
 /** 创建/打开子键（子键不存在则创建，含中间层级）
  *  @returns 0 = ERROR_SUCCESS
- *  @param args_0 hKey 父键：gui.HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
+ *  @param args_0 hKey 父键：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_5 samDesired 访问掩码 RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
  *  @param args_6 lpSecurityAttributes 安全描述符（一般 NULL）
  *  @param args_7 phkResult 出参：键句柄（PtrArrayBuffer(8)，readPtr 按架构读回）
  *  @param args_8 lpdwDisposition 出参：新建/已存在标记（可 NULL） */
@@ -24,7 +24,7 @@ export const RegCreateKeyEx = /*@__PURE__*/ b('RegCreateKeyExW',
  *  @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_3 samDesired 访问掩码 RegAccess.READ / SET_VALUE
  *  @param args_4 phkResult 出参：键句柄 */
 export const RegOpenKeyEx = /*@__PURE__*/ b('RegOpenKeyExW',
     '<>ptr <WCHAR>ptr u32 u32@RegAccess <BYTE>ptr -> i32')
@@ -36,10 +36,10 @@ 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_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 RegAccess.SET_VALUE）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 Reserved 保留，恒 0
- *  @param args_3 dwType 值类型 gui.RegType.SZ（UTF-16 字符串）
+ *  @param args_3 dwType 值类型 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',
@@ -47,7 +47,7 @@ export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW',
 
 /** 读键值（两跳模式：第一跳 lpData=NULL 取尺寸/类型，第二跳按尺寸带缓冲读数据）
  *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（值不存在）
- *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 gui.RegAccess.READ）
+ *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 RegAccess.READ）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 lpReserved 保留，恒 NULL
  *  @param args_3 lpType 出参：值类型（可 NULL）
@@ -57,7 +57,7 @@ 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 即可
+ *  HKey.CURRENT_USER 即可
  *  @returns 0 = ERROR_SUCCESS；2 = 子键不存在
  *  @param args_0 hKey 父键
  *  @param args_1 lpSubKey 要删的子键路径（不可 NULL） */

package/lib/windows/gdi32.js

@@ -12,7 +12,7 @@ import { LOGFONTW, POINT, RECT } from './structs.js';
 const b = (name, sig, encoders) => bind('gdi32.dll', name, sig, encoders);
 // 点数组编解码对（Polyline/Polygon/PlgBlt 共享）：注册后 <POINT>ptr 位收元素数组
 // （值域由 encoder 推导），C 侧 NULL 位传 NULL（number 直通），[]/单对象 fail-loud
-const POINTArr = structArray(POINT);
+const POINTArr = /*@__PURE__*/ structArray(POINT);
 /** 创建实心画刷；配对 DeleteObject
  *  @returns 失败 → 0
  *  @param args_0 crColor 画刷颜色 0x00BBGGRR */
@@ -68,7 +68,7 @@ export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>
  *  @param args_5 hdcSrc 源 DC
  *  @param args_6 x1 源起始 x
  *  @param args_7 y1 源起始 y
- *  @param args_8 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
+ *  @param args_8 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
 // hdcDest 非空（!）；hdcSrc 在 PATCOPY 等特定 rop 下 C 允许 NULL，保持可空档。
 export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 u32@RasterOp -> i32');
 /** 取位图像素到 lpvBits（lpbmi 为 BITMAPINFO，32bpp BI_RGB 无颜色表时头部即全部：
@@ -99,7 +99,7 @@ export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32');
  *  @param args_2 y 左上角 y
  *  @param args_3 w 宽度
  *  @param args_4 h 高度
- *  @param args_5 rop gui.RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
+ *  @param args_5 rop RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
 export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@RasterOp -> i32');
 /** 拉伸位图传送（源区 wSrc×hSrc 放/缩到目标 wDest×hDest）
  *  @returns 成功 → 非 0
@@ -113,15 +113,15 @@ export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@R
  *  @param args_7 ySrc 源区左上 y
  *  @param args_8 wSrc 源区宽
  *  @param args_9 hSrc 源区高
- *  @param args_10 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_10 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchBlt = /*@__PURE__*/ b('StretchBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 i32 i32 u32@RasterOp -> i32');
 /** 设置拉伸取色模式；放大时各模式像素同为源色，缩小时降采样策略不同
  *  （DELETESCANS 丢行 / HALFTONE 平均取色最保真）
  *  @returns 旧值
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
+ *  @param args_1 iMode StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
 export const SetStretchBltMode = /*@__PURE__*/ b('SetStretchBltMode', '<HDC>ptr! i32@StretchBltMode -> i32');
-/** 读拉伸取色模式（值域 = gui.StretchBltMode 成员）；回传
+/** 读拉伸取色模式（值域 = StretchBltMode 成员）；回传
  *  SetStretchBltMode 前需按成员值使用（裸 number 进不了枚举位）
  *  @returns number */
 export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr! -> i32');
@@ -187,18 +187,18 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice', '<HDC>ptr!
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
  *  @param args_11 iUsage DIB_RGB_COLORS(0)
- *  @param args_12 rop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @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');
 // ============ 画图原语（笔 / 线 / 形状 / 文字） ============
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）
  *  @returns 失败 → 0
- *  @param args_0 iObject gui.StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
+ *  @param args_0 iObject StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
 export const GetStockObject = /*@__PURE__*/ b('GetStockObject', 'i32@StockObject -> <HGDIOBJ>ptr');
 /** 创建网格纹理画刷（线色 = crColor，间隙 = 背景：SetBkMode=TRANSPARENT 透底、OPAQUE
  *  用 SetBkColor）；配对 DeleteObject
  *  @returns 失败 → 0
- *  @param args_0 iHatch gui.HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
+ *  @param args_0 iHatch HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
  *  BDIAGONAL / CROSS / DIAGCROSS
  *  @param args_1 crColor 纹理线颜色 0x00BBGGRR */
 export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchStyle u32 -> <HGDIOBJ>ptr');
@@ -209,14 +209,14 @@ export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchSt
 export const CreatePatternBrush = /*@__PURE__*/ b('CreatePatternBrush', '<HGDIOBJ>ptr -> <HGDIOBJ>ptr');
 /** 创建画笔（选入 hdc 生效，SelectObject 选回旧对象后 DeleteObject 配对）
  *  @returns 失败 → 0
- *  @param args_0 iStyle 笔型（gui.PenStyle.SOLID / DASH / NULL 等）
+ *  @param args_0 iStyle 笔型（PenStyle.SOLID / DASH / NULL 等）
  *  @param args_1 cWidth 笔宽（像素；>1 的几何宽设备相关，虚线样式可能被拉伸）
  *  @param args_2 crColor 笔色 0x00BBGGRR */
 export const CreatePen = /*@__PURE__*/ b('CreatePen', 'i32@PenStyle i32 u32 -> <HGDIOBJ>ptr');
 /** 设置文字/阴影背景填充模式
  *  @returns 旧模式（新建 DC 默认 OPAQUE）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iBkMode gui.BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
+ *  @param args_1 iBkMode BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
 export const SetBkMode = /*@__PURE__*/ b('SetBkMode', '<HDC>ptr! i32@BackgroundMode -> i32');
 /** 设置文字颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
@@ -241,19 +241,19 @@ export const RestoreDC = /*@__PURE__*/ b('RestoreDC', '<HDC>ptr! i32 -> i32');
 /** 设置多边形填充规则
  *  @returns 旧值（新建 DC 默认 ALTERNATE = 奇偶规则）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.PolyFillMode.ALTERNATE（自相交区域交替镂空）/
+ *  @param args_1 iMode PolyFillMode.ALTERNATE（自相交区域交替镂空）/
  *  WINDING（非零环绕，自相交区域整体实心） */
 export const SetPolyFillMode = /*@__PURE__*/ b('SetPolyFillMode', '<HDC>ptr! i32@PolyFillMode -> i32');
 /** 设置前景画笔与目的像素的混合方式（二元光栅模式）；
  *  R2_XORPEN 可逆（同路径画两次抵消原样），适合橡皮筋交互
  *  @returns 旧值（默认 R2_COPYPEN = 直接画）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
+ *  @param args_1 iMode RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
 export const SetROP2 = /*@__PURE__*/ b('SetROP2', '<HDC>ptr! i32@RasterMode -> i32');
 /** 设置弧/弦/扇形的扫过方向
  *  @returns 旧值（新 DC 默认逆时针）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iDir gui.ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
+ *  @param args_1 iDir ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
 export const SetArcDirection = /*@__PURE__*/ b('SetArcDirection', '<HDC>ptr! i32@ArcDirection -> i32');
 /** 读弧扫过方向
  *  @returns AD_COUNTERCLOCKWISE=1 / AD_CLOCKWISE=2；失败 → 0 */
@@ -358,10 +358,10 @@ export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_4 c 字符数（= str.length；C 要字符数不是字节数，不含 NUL） */
 export const TextOut = /*@__PURE__*/ b('TextOutW', '<HDC>ptr! i32 i32 <WCHAR>ptr i32 -> i32');
 /** 设置 TextOut/ExtTextOut 的对齐与当前位置更新方式；TA_* 按位组合
- *  （如 gui.TextAlign.TA_CENTER | gui.TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
+ *  （如 TextAlign.TA_CENTER | TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
  *  @returns 旧 flags（新 DC 默认 TA_LEFT|TA_TOP|TA_NOUPDATECP = 0）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 fMode gui.TextAlign 成员按位或 */
+ *  @param args_1 fMode TextAlign 成员按位或 */
 export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u32');
 /** 按当前字体量字符串宽高（不含衬底与额外间距）
  *  @returns 成功 → 非 0
@@ -382,7 +382,7 @@ export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW', '<HDC>ptr! <TEX
  *  @param args_0 hdc 目标 DC
  *  @param args_1 x 起点 x
  *  @param args_2 y 起点 y
- *  @param args_3 fOptions gui.TextOutOptions.ETO_OPAQUE（矩形填衬底）|
+ *  @param args_3 fOptions TextOutOptions.ETO_OPAQUE（矩形填衬底）|
  *  ETO_CLIPPED（矩形裁剪字形）按位或（可 0 = 都不用）
  *  @param args_4 lprc ETO_OPAQUE/ETO_CLIPPED 的作用矩形：DeepPartial 对象直传 /
  *  RECT.alloc().ptr / NULL = 整个当前可裁剪区（有 encoder 的纯入参位三形态）

package/lib/windows/gdi32.ts

@@ -15,7 +15,7 @@ const b = <const S extends string, const LE extends CodecMap = {}>(name: string,
 
 // 点数组编解码对（Polyline/Polygon/PlgBlt 共享）：注册后 <POINT>ptr 位收元素数组
 // （值域由 encoder 推导），C 侧 NULL 位传 NULL（number 直通），[]/单对象 fail-loud
-const POINTArr = structArray(POINT)
+const POINTArr = /*@__PURE__*/ structArray(POINT)
 
 /** 创建实心画刷；配对 DeleteObject
  *  @returns 失败 → 0
@@ -77,7 +77,7 @@ export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>
  *  @param args_5 hdcSrc 源 DC
  *  @param args_6 x1 源起始 x
  *  @param args_7 y1 源起始 y
- *  @param args_8 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
+ *  @param args_8 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
 // hdcDest 非空（!）；hdcSrc 在 PATCOPY 等特定 rop 下 C 允许 NULL，保持可空档。
 export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 u32@RasterOp -> i32')
 /** 取位图像素到 lpvBits（lpbmi 为 BITMAPINFO，32bpp BI_RGB 无颜色表时头部即全部：
@@ -109,7 +109,7 @@ export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32')
  *  @param args_2 y 左上角 y
  *  @param args_3 w 宽度
  *  @param args_4 h 高度
- *  @param args_5 rop gui.RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
+ *  @param args_5 rop RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
 export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@RasterOp -> i32')
 /** 拉伸位图传送（源区 wSrc×hSrc 放/缩到目标 wDest×hDest）
  *  @returns 成功 → 非 0
@@ -123,16 +123,16 @@ export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@R
  *  @param args_7 ySrc 源区左上 y
  *  @param args_8 wSrc 源区宽
  *  @param args_9 hSrc 源区高
- *  @param args_10 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_10 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchBlt = /*@__PURE__*/ b('StretchBlt',
     '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 i32 i32 u32@RasterOp -> i32')
 /** 设置拉伸取色模式；放大时各模式像素同为源色，缩小时降采样策略不同
  *  （DELETESCANS 丢行 / HALFTONE 平均取色最保真）
  *  @returns 旧值
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
+ *  @param args_1 iMode StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
 export const SetStretchBltMode = /*@__PURE__*/ b('SetStretchBltMode', '<HDC>ptr! i32@StretchBltMode -> i32')
-/** 读拉伸取色模式（值域 = gui.StretchBltMode 成员）；回传
+/** 读拉伸取色模式（值域 = StretchBltMode 成员）；回传
  *  SetStretchBltMode 前需按成员值使用（裸 number 进不了枚举位）
  *  @returns number */
 export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr! -> i32')
@@ -202,7 +202,7 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
  *  @param args_11 iUsage DIB_RGB_COLORS(0)
- *  @param args_12 rop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @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')
 
@@ -211,13 +211,13 @@ export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits',
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）
  *  @returns 失败 → 0
- *  @param args_0 iObject gui.StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
+ *  @param args_0 iObject StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
 export const GetStockObject = /*@__PURE__*/ b('GetStockObject', 'i32@StockObject -> <HGDIOBJ>ptr')
 
 /** 创建网格纹理画刷（线色 = crColor，间隙 = 背景：SetBkMode=TRANSPARENT 透底、OPAQUE
  *  用 SetBkColor）；配对 DeleteObject
  *  @returns 失败 → 0
- *  @param args_0 iHatch gui.HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
+ *  @param args_0 iHatch HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
  *  BDIAGONAL / CROSS / DIAGCROSS
  *  @param args_1 crColor 纹理线颜色 0x00BBGGRR */
 export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchStyle u32 -> <HGDIOBJ>ptr')
@@ -230,14 +230,14 @@ export const CreatePatternBrush = /*@__PURE__*/ b('CreatePatternBrush', '<HGDIOB
 
 /** 创建画笔（选入 hdc 生效，SelectObject 选回旧对象后 DeleteObject 配对）
  *  @returns 失败 → 0
- *  @param args_0 iStyle 笔型（gui.PenStyle.SOLID / DASH / NULL 等）
+ *  @param args_0 iStyle 笔型（PenStyle.SOLID / DASH / NULL 等）
  *  @param args_1 cWidth 笔宽（像素；>1 的几何宽设备相关，虚线样式可能被拉伸）
  *  @param args_2 crColor 笔色 0x00BBGGRR */
 export const CreatePen = /*@__PURE__*/ b('CreatePen', 'i32@PenStyle i32 u32 -> <HGDIOBJ>ptr')
 /** 设置文字/阴影背景填充模式
  *  @returns 旧模式（新建 DC 默认 OPAQUE）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iBkMode gui.BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
+ *  @param args_1 iBkMode BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
 export const SetBkMode = /*@__PURE__*/ b('SetBkMode', '<HDC>ptr! i32@BackgroundMode -> i32')
 /** 设置文字颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
@@ -262,19 +262,19 @@ export const RestoreDC = /*@__PURE__*/ b('RestoreDC', '<HDC>ptr! i32 -> i32')
 /** 设置多边形填充规则
  *  @returns 旧值（新建 DC 默认 ALTERNATE = 奇偶规则）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.PolyFillMode.ALTERNATE（自相交区域交替镂空）/
+ *  @param args_1 iMode PolyFillMode.ALTERNATE（自相交区域交替镂空）/
  *  WINDING（非零环绕，自相交区域整体实心） */
 export const SetPolyFillMode = /*@__PURE__*/ b('SetPolyFillMode', '<HDC>ptr! i32@PolyFillMode -> i32')
 /** 设置前景画笔与目的像素的混合方式（二元光栅模式）；
  *  R2_XORPEN 可逆（同路径画两次抵消原样），适合橡皮筋交互
  *  @returns 旧值（默认 R2_COPYPEN = 直接画）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
+ *  @param args_1 iMode RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
 export const SetROP2 = /*@__PURE__*/ b('SetROP2', '<HDC>ptr! i32@RasterMode -> i32')
 /** 设置弧/弦/扇形的扫过方向
  *  @returns 旧值（新 DC 默认逆时针）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iDir gui.ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
+ *  @param args_1 iDir ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
 export const SetArcDirection = /*@__PURE__*/ b('SetArcDirection', '<HDC>ptr! i32@ArcDirection -> i32')
 /** 读弧扫过方向
  *  @returns AD_COUNTERCLOCKWISE=1 / AD_CLOCKWISE=2；失败 → 0 */
@@ -383,10 +383,10 @@ export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_4 c 字符数（= str.length；C 要字符数不是字节数，不含 NUL） */
 export const TextOut = /*@__PURE__*/ b('TextOutW', '<HDC>ptr! i32 i32 <WCHAR>ptr i32 -> i32')
 /** 设置 TextOut/ExtTextOut 的对齐与当前位置更新方式；TA_* 按位组合
- *  （如 gui.TextAlign.TA_CENTER | gui.TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
+ *  （如 TextAlign.TA_CENTER | TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
  *  @returns 旧 flags（新 DC 默认 TA_LEFT|TA_TOP|TA_NOUPDATECP = 0）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 fMode gui.TextAlign 成员按位或 */
+ *  @param args_1 fMode TextAlign 成员按位或 */
 export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u32')
 /** 按当前字体量字符串宽高（不含衬底与额外间距）
  *  @returns 成功 → 非 0
@@ -409,7 +409,7 @@ export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW',
  *  @param args_0 hdc 目标 DC
  *  @param args_1 x 起点 x
  *  @param args_2 y 起点 y
- *  @param args_3 fOptions gui.TextOutOptions.ETO_OPAQUE（矩形填衬底）|
+ *  @param args_3 fOptions TextOutOptions.ETO_OPAQUE（矩形填衬底）|
  *  ETO_CLIPPED（矩形裁剪字形）按位或（可 0 = 都不用）
  *  @param args_4 lprc ETO_OPAQUE/ETO_CLIPPED 的作用矩形：DeepPartial 对象直传 /
  *  RECT.alloc().ptr / NULL = 整个当前可裁剪区（有 encoder 的纯入参位三形态）