quickwin 1.3.0 → 2.1.0

package/lib/windows/version.ts

@@ -0,0 +1,35 @@
+// version.dll 绑定（文件版本资源——exe/dll「属性 → 详细信息」的数据；品牌约定见
+// lib/windows/user32.ts 头注释）：
+//   - 读取三段式：Size 拿缓冲大小与句柄 → Info 读进缓冲 → VerQueryValue 在缓冲内
+//     查询子块（lplpBuffer 回写的指针指向缓冲内部，跟进读用 ffi.readByte 拼值）
+//   - 位宽无关：句柄/指针出参槽一律 <BYTE>ptr 收 PAB(4/8) + DataView / os.arch 分支读回
+import { bind, type CodecMap } from '../ffi/bind.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
+    bind('version.dll', name, sig, encoders)
+
+/** 取文件版本资源大小
+ *  @returns 字节数（0 = 文件无版本资源）
+ *  @param args_0 lptstrFilename 文件路径（禁空）
+ *  @param args_1 lpdwHandle 出参槽（Info 步的入参句柄，MSDN 恒 0 但仍须传），
+ *                PtrArrayBuffer(4) + Uint32Array 读回 */
+export const GetFileVersionInfoSize = /*@__PURE__*/ b('GetFileVersionInfoSizeW',
+    '<WCHAR>ptr! <BYTE>ptr -> u32')
+/** 读版本资源进缓冲
+ *  @returns 成功 → 非 0
+ *  @param args_0 lptstrFilename 文件路径（禁空）
+ *  @param args_1 dwHandle Size 步读回的句柄（恒 0）
+ *  @param args_2 dwLen 缓冲字节数（= Size 返回值）
+ *  @param args_3 lpData 接收缓冲（PtrArrayBuffer(dwLen)） */
+export const GetFileVersionInfo = /*@__PURE__*/ b('GetFileVersionInfoW',
+    '<WCHAR>ptr! u32 u32 <BYTE>ptr -> i32')
+/** 在版本资源缓冲内查询子块
+ *  @returns 成功 → 非 0
+ *  @param args_0 pBlock Info 步的资源缓冲（PtrArrayBuffer 直传）
+ *  @param args_1 lpszSubBlock 子块路径（禁空）：'\\' = 根块 VS_FIXEDFILEINFO、
+ *                '\\StringFileInfo\\040904B0\\FileVersion' 等字符串表项
+ *  @param args_2 lplpBuffer 出参槽（块内偏移指针写回），PtrArrayBuffer(8)
+ *  @param args_3 puLen 出参槽（块字节数，VS_FIXEDFILEINFO = 52），PtrArrayBuffer(4) */
+export const VerQueryValue = /*@__PURE__*/ b('VerQueryValueW',
+    '<BYTE>ptr <WCHAR>ptr! <BYTE>ptr <BYTE>ptr -> i32')

package/lib/windows/winspool.js

@@ -0,0 +1,71 @@
+// winspool.drv 绑定（打印后台处理：枚举 / 能力查询 / 原始作业链；品牌约定见
+// lib/windows/user32.ts 头注释）：
+//   - 打印机句柄（OpenPrinter 的 HPRINTER* 出参槽写回）位宽无关：出参槽 = <BYTE>ptr
+//     收 PtrArrayBuffer(8) + readPtr 读回 number，作业链句柄位 <>ptr 收宽（批 5 HKey 同型）
+//   - 结构位按方向分流（结构定义见 ./structs.ts）：DOC_INFO_1W 纯入参位注册 encoder →
+//     对象直传；PRINTER_INFO_2W 出参数组不注册 → structArray(PRINTER_INFO_2W).decode
+//     (buf, count) 读回（缓冲尾部含字符串，须显式 count），指针字段跟进读字符串
+//   - 枚举标注：DeviceCap 是单选查询位标枚举；PrinterEnum 是 LOCAL|CONNECTIONS 可组合
+//     flags → 裸 u32 + JSDoc（组合 OR 结果不是枚举成员，位标枚举反而传不进）
+import { bind } from '../ffi/bind.js';
+import { DOC_INFO_1W } from './structs.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+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)
+ *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
+ *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
+ *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
+ *  @param args_3 pPrinterInfo 出参缓冲（PtrArrayBuffer(pcbNeeded)）
+ *  @param args_4 cbBuf 缓冲字节数
+ *  @param args_5 pcbNeeded 出参槽（需求字节数）PtrArrayBuffer(4)
+ *  @param args_6 pcReturned 出参槽（返回条数）PtrArrayBuffer(4) */
+export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW', 'u32 <WCHAR>ptr u32 <BYTE>ptr u32 <BYTE>ptr <BYTE>ptr -> i32');
+/** 取默认打印机名
+ *  @returns 成功 → 非 0，0 = 失败（缓冲不足时 pcchBuffer 带回所需长度）
+ *  @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.*
+ *  @returns 返回值随能力（数值能力 = 数值，
+ *  -1 = 失败）
+ *  @param args_0 pDevice 打印机名（禁空）
+ *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
+ *  @param args_2 nCapability 能力码（gui.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');
+/** 打开打印机对象（不产生打印作业）
+ *  @returns 成功 → 非 0，hPrinter 写回
+ *  @param args_0 pPrinterName 打印机名（禁空）
+ *  @param args_1 phPrinter 出参槽（句柄写回），PtrArrayBuffer(8) + readPtr 读回
+ *  @param args_2 pDefault 默认值（Datatype/DevMode/DesiredAccess），传 NULL 全默认 */
+export const OpenPrinter = /*@__PURE__*/ b('OpenPrinterW', '<WCHAR>ptr! <BYTE>ptr <>ptr -> i32');
+/** 关闭打印机句柄
+ *  @returns 成功 → 非 0 */
+export const ClosePrinter = /*@__PURE__*/ b('ClosePrinter', '<>ptr -> i32');
+/** 起打印作业
+ *  @returns 作业 id（0 = 失败）
+ *  @param args_0 hPrinter 打印机句柄
+ *  @param args_1 dwLevel 固定 1（DOC_INFO_1W）
+ *  @param args_2 pDocInfo DOC_INFO_1W 对象（指针字段收裸地址 number：WCHAR.encode(s).ptr，
+ *                PAB 须在调用返回前保持引用） */
+export const StartDocPrinter = /*@__PURE__*/ b('StartDocPrinterW', '<>ptr u32 <DOC_INFO_1W>ptr -> u32', { DOC_INFO_1W });
+/** 结束打印作业（提交）
+ *  @returns 成功 → 非 0 */
+export const EndDocPrinter = /*@__PURE__*/ b('EndDocPrinter', '<>ptr -> i32');
+/** 起页
+ *  @returns 成功 → 非 0 */
+export const StartPagePrinter = /*@__PURE__*/ b('StartPagePrinter', '<>ptr -> i32');
+/** 结束页
+ *  @returns 成功 → 非 0 */
+export const EndPagePrinter = /*@__PURE__*/ b('EndPagePrinter', '<>ptr -> i32');
+/** 写作业数据（RAW 直写 spooler）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hPrinter 打印机句柄
+ *  @param args_1 lpBuffer 数据缓冲（<BYTE>ptr，PtrArrayBuffer）
+ *  @param args_2 nNumberOfBytesToWrite 写入字节数
+ *  @param args_3 lpNumberOfBytesWritten 出参槽，PtrArrayBuffer(4) 读实际写入字节数 */
+export const WritePrinter = /*@__PURE__*/ b('WritePrinter', '<>ptr <BYTE>ptr u32 <BYTE>ptr -> i32');

package/lib/windows/winspool.ts

@@ -0,0 +1,80 @@
+// winspool.drv 绑定（打印后台处理：枚举 / 能力查询 / 原始作业链；品牌约定见
+// lib/windows/user32.ts 头注释）：
+//   - 打印机句柄（OpenPrinter 的 HPRINTER* 出参槽写回）位宽无关：出参槽 = <BYTE>ptr
+//     收 PtrArrayBuffer(8) + readPtr 读回 number，作业链句柄位 <>ptr 收宽（批 5 HKey 同型）
+//   - 结构位按方向分流（结构定义见 ./structs.ts）：DOC_INFO_1W 纯入参位注册 encoder →
+//     对象直传；PRINTER_INFO_2W 出参数组不注册 → structArray(PRINTER_INFO_2W).decode
+//     (buf, count) 读回（缓冲尾部含字符串，须显式 count），指针字段跟进读字符串
+//   - 枚举标注：DeviceCap 是单选查询位标枚举；PrinterEnum 是 LOCAL|CONNECTIONS 可组合
+//     flags → 裸 u32 + JSDoc（组合 OR 结果不是枚举成员，位标枚举反而传不进）
+import { bind, type CodecMap } from '../ffi/bind.js'
+import { DOC_INFO_1W } from './structs.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
+    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)
+ *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
+ *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
+ *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
+ *  @param args_3 pPrinterInfo 出参缓冲（PtrArrayBuffer(pcbNeeded)）
+ *  @param args_4 cbBuf 缓冲字节数
+ *  @param args_5 pcbNeeded 出参槽（需求字节数）PtrArrayBuffer(4)
+ *  @param args_6 pcReturned 出参槽（返回条数）PtrArrayBuffer(4) */
+export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW',
+    'u32 <WCHAR>ptr u32 <BYTE>ptr u32 <BYTE>ptr <BYTE>ptr -> i32')
+
+/** 取默认打印机名
+ *  @returns 成功 → 非 0，0 = 失败（缓冲不足时 pcchBuffer 带回所需长度）
+ *  @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.*
+ *  @returns 返回值随能力（数值能力 = 数值，
+ *  -1 = 失败）
+ *  @param args_0 pDevice 打印机名（禁空）
+ *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
+ *  @param args_2 nCapability 能力码（gui.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')
+
+/** 打开打印机对象（不产生打印作业）
+ *  @returns 成功 → 非 0，hPrinter 写回
+ *  @param args_0 pPrinterName 打印机名（禁空）
+ *  @param args_1 phPrinter 出参槽（句柄写回），PtrArrayBuffer(8) + readPtr 读回
+ *  @param args_2 pDefault 默认值（Datatype/DevMode/DesiredAccess），传 NULL 全默认 */
+export const OpenPrinter = /*@__PURE__*/ b('OpenPrinterW', '<WCHAR>ptr! <BYTE>ptr <>ptr -> i32')
+/** 关闭打印机句柄
+ *  @returns 成功 → 非 0 */
+export const ClosePrinter = /*@__PURE__*/ b('ClosePrinter', '<>ptr -> i32')
+/** 起打印作业
+ *  @returns 作业 id（0 = 失败）
+ *  @param args_0 hPrinter 打印机句柄
+ *  @param args_1 dwLevel 固定 1（DOC_INFO_1W）
+ *  @param args_2 pDocInfo DOC_INFO_1W 对象（指针字段收裸地址 number：WCHAR.encode(s).ptr，
+ *                PAB 须在调用返回前保持引用） */
+export const StartDocPrinter = /*@__PURE__*/ b('StartDocPrinterW', '<>ptr u32 <DOC_INFO_1W>ptr -> u32',
+    { DOC_INFO_1W })
+/** 结束打印作业（提交）
+ *  @returns 成功 → 非 0 */
+export const EndDocPrinter = /*@__PURE__*/ b('EndDocPrinter', '<>ptr -> i32')
+/** 起页
+ *  @returns 成功 → 非 0 */
+export const StartPagePrinter = /*@__PURE__*/ b('StartPagePrinter', '<>ptr -> i32')
+/** 结束页
+ *  @returns 成功 → 非 0 */
+export const EndPagePrinter = /*@__PURE__*/ b('EndPagePrinter', '<>ptr -> i32')
+/** 写作业数据（RAW 直写 spooler）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hPrinter 打印机句柄
+ *  @param args_1 lpBuffer 数据缓冲（<BYTE>ptr，PtrArrayBuffer）
+ *  @param args_2 nNumberOfBytesToWrite 写入字节数
+ *  @param args_3 lpNumberOfBytesWritten 出参槽，PtrArrayBuffer(4) 读实际写入字节数 */
+export const WritePrinter = /*@__PURE__*/ b('WritePrinter', '<>ptr <BYTE>ptr u32 <BYTE>ptr -> i32')

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "1.3.0",
+  "version": "2.1.0",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",

package/quickwin.d.ts

@@ -1,4 +1,5 @@
 /// <reference path="quickwin_const.d.ts" />
+/// <reference path="quickwin_enum_map.d.ts" />
 interface ImportMeta {
     url: string
 }
@@ -358,6 +359,7 @@ declare module "sock" {
     function accept(sock: SockHandle): { handle: SockHandle; addr: string; port: number } | null;
     /** getsockname(sock) — 返回本地绑定地址 { addr, port }（port=0 自动分配后可用它查询实际端口） */
     function getsockname(sock: SockHandle): { addr: string; port: number } | null;
+    /** send(sock, buf, flags?) — 返回实际送出字节数；非阻塞缓冲满返回 0（入队等 FD_WRITE 重发）；真错误返回 -1 */
     function send(sock: SockHandle, buf: ArrayBuffer, flags?: number): number;
     function recv(sock: SockHandle, size?: number, flags?: number): ArrayBuffer | null;
     function closesocket(sock: SockHandle): void;
@@ -377,6 +379,16 @@ declare module "wolfssl" {
     function wolfSSL_CTX_new(method: WOLFSSL_METHOD): WOLFSSL_CTX | null;
     function wolfSSL_CTX_free(ctx: WOLFSSL_CTX): void;
     function wolfSSL_CTX_set_verify(ctx: WOLFSSL_CTX, mode: VerifyMode): number;
+    function wolfSSL_CTX_load_verify_locations(ctx: WOLFSSL_CTX, file: string, path?: string): number;
+    function wolfSSL_check_domain_name(ssl: WOLFSSL, name: string): number;
+    /** Add a PEM to the process-wide trusted CA store (fixed capacity).
+     *  Returns the new entry count (1..8), or -1 on empty PEM / full store;
+     *  the caller decides whether -1 is fatal. Entries are applied by
+     *  loadTrustedCerts() at handshake setup time, not retroactively. */
+    function addTrustedCA(pem: string): number;
+    /** Load the OS CA store plus every entry of the trusted CA store into ctx.
+     *  Returns how many store entries were loaded. */
+    function loadTrustedCerts(ctx: WOLFSSL_CTX): number;
     function wolfSSL_CTX_use_certificate_file(ctx: WOLFSSL_CTX, file: string, format?: FileType): number;
     function wolfSSL_CTX_use_PrivateKey_file(ctx: WOLFSSL_CTX, file: string, format?: FileType): number;
 
@@ -386,19 +398,23 @@ declare module "wolfssl" {
     function wolfSSL_connect(ssl: WOLFSSL): number;
     function wolfSSL_shutdown(ssl: WOLFSSL): number;
     function wolfSSL_write(ssl: WOLFSSL, buf: ArrayBuffer): number;
-    /** 成功返回 ArrayBuffer；EOF/暂无数据/错误返回 null（区分用 wolfSSL_get_error：6=ZERO_RETURN 关闭，2=WANT_READ） */
-    function wolfSSL_read(ssl: WOLFSSL, sz: number): ArrayBuffer | null;
+    /** 读入 buf（大小取 buf.byteLength），返回 wolfSSL 原始返回值：
+     *  >0=字节数（数据在 buf[0..ret)），0=对端正常关闭，<0=错误；
+     *  语义用 wolfSSL_get_error(ssl, ret) 区分（2=WANT_READ 暂无数据，6=ZERO_RETURN 关闭） */
+    function wolfSSL_read(ssl: WOLFSSL, buf: ArrayBuffer): number;
     function wolfSSL_get_error(ssl: WOLFSSL, ret: number): number;
     function wolfSSL_UseSNI(ssl: WOLFSSL, type: SniType, name: string, len?: number): number;
 
     function wolfSSLv23_client_method(): WOLFSSL_METHOD;
     function wolfTLSv1_2_client_method(): WOLFSSL_METHOD;
-    function wolfTLSv1_3_client_method(): WOLFSSL_METHOD;
+    /** 此 wolfSSL 构建禁用 TLSv1.3：返回 0（无 method 指针），调用方自行判定 */
+    function wolfTLSv1_3_client_method(): WOLFSSL_METHOD | 0;
 
 }
 
 declare module "win" {
-    type HMODULE = number & { readonly __label: unique symbol };
+    /** 与 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;
@@ -410,11 +426,13 @@ declare module "win" {
 }
 
 declare module "gui" {
-    type HWND = number & { readonly __label: unique symbol };
-    type HMENU = number & { readonly __label: unique symbol };
-    type HFONT = number & { readonly __label: unique symbol };
-    type HICON = number & { readonly __label: unique symbol };
-    type WNDPROC = number & { readonly __label: unique symbol };
+    /** 与 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" };
 
     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;
@@ -545,40 +563,13 @@ declare module "gui" {
 }
 
 declare module "ffi" {
-    type TYPE_OF_FFI_TYPE_VOID = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_UINT8 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_SINT8 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_UINT16 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_SINT16 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_UINT32 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_SINT32 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_UINT64 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_SINT64 = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_FLOAT = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_DOUBLE = number & { readonly __label: unique symbol }
-    type TYPE_OF_FFI_TYPE_POINTER = number & { readonly __label: unique symbol }
-    
-    const FFI_TYPE_VOID: TYPE_OF_FFI_TYPE_VOID;
-    const FFI_TYPE_UINT8: TYPE_OF_FFI_TYPE_UINT8;
-    const FFI_TYPE_SINT8: TYPE_OF_FFI_TYPE_SINT8;
-    const FFI_TYPE_UINT16: TYPE_OF_FFI_TYPE_UINT16;
-    const FFI_TYPE_SINT16: TYPE_OF_FFI_TYPE_SINT16;
-    const FFI_TYPE_UINT32: TYPE_OF_FFI_TYPE_UINT32;
-    const FFI_TYPE_SINT32: TYPE_OF_FFI_TYPE_SINT32;
-    const FFI_TYPE_UINT64: TYPE_OF_FFI_TYPE_UINT64;
-    const FFI_TYPE_SINT64: TYPE_OF_FFI_TYPE_SINT64;
-    const FFI_TYPE_FLOAT: TYPE_OF_FFI_TYPE_FLOAT;
-    const FFI_TYPE_DOUBLE: TYPE_OF_FFI_TYPE_DOUBLE;
-    const FFI_TYPE_POINTER: TYPE_OF_FFI_TYPE_POINTER;
-
-    type FfiType = TYPE_OF_FFI_TYPE_VOID | TYPE_OF_FFI_TYPE_UINT8 | TYPE_OF_FFI_TYPE_SINT8 | TYPE_OF_FFI_TYPE_UINT16 | TYPE_OF_FFI_TYPE_SINT16 | TYPE_OF_FFI_TYPE_UINT32 | TYPE_OF_FFI_TYPE_SINT32 | TYPE_OF_FFI_TYPE_UINT64 | TYPE_OF_FFI_TYPE_SINT64 | TYPE_OF_FFI_TYPE_FLOAT | TYPE_OF_FFI_TYPE_DOUBLE | TYPE_OF_FFI_TYPE_POINTER;
-    type TypeArg<T extends FfiType> = T extends Exclude<FfiType, TYPE_OF_FFI_TYPE_VOID | TYPE_OF_FFI_TYPE_POINTER> ? number : T extends TYPE_OF_FFI_TYPE_POINTER ? (ArrayBuffer | number | null) : never;
-    type TypeArgs<T extends FfiType[], Args extends(number | null | ArrayBuffer)[] = []> = T extends [infer T1 extends FfiType, ...infer RES extends FfiType[]] ? TypeArgs<RES, [...Args, TypeArg<T1>]> : Args;
-
-    function ffiCall<const T extends Exclude<FfiType, TYPE_OF_FFI_TYPE_VOID>[], const R extends FfiType>(func: number, argTypes: T, args: TypeArgs<T>, retType: R): R extends TYPE_OF_FFI_TYPE_VOID ? undefined : R extends TYPE_OF_FFI_TYPE_POINTER ? number | null : TypeArg<R>;
+    function ffiCall(func: number, argFrame: ArrayBuffer, retBuf: ArrayBuffer, retIsFp: 0 | 1): void;
     function bufferPtr(buf: ArrayBuffer): number;
     function readByte(ptr: number): number;
+    function readBytes(ptr: number, len: number): ArrayBuffer;
     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;
 }
 
 

package/quickwin_const.d.ts

@@ -676,6 +676,125 @@ declare module "gui" {
         SRCCOPY = 13369376, // 0xCC0020
         WHITENESS = 16711778, // 0xFF0062
         BLACKNESS = 66, // 0x42
+        NOTSRCCOPY = 3342344, // 0x330008
+        NOTSRCERASE = 1114278, // 0x1100A6
+        SRCERASE = 4457256, // 0x440328
+        SRCAND = 8913094, // 0x8800C6
+        SRCINVERT = 6684742, // 0x660046
+        SRCPAINT = 15597702, // 0xEE0086
+        MERGECOPY = 12583114, // 0xC000CA
+        MERGEPAINT = 12255782, // 0xBB0226
+        PATCOPY = 15728673, // 0xF00021
+        PATINVERT = 5898313, // 0x5A0049
+        PATPAINT = 16452105, // 0xFB0A09
+        DSTINVERT = 5570569, // 0x550009
+        NOP = 255, // 0xFF
+    }
+
+    // GDI pen styles (CreatePen iStyle)
+    export const enum PenStyle {
+        SOLID = 0, // 0x0
+        DASH = 1, // 0x1
+        DOT = 2, // 0x2
+        DASHDOT = 3, // 0x3
+        DASHDOTDOT = 4, // 0x4
+        NULL = 5, // 0x5
+        INSIDEFRAME = 6, // 0x6
+    }
+
+    // SetBkMode: text/bkgrnd fill mode
+    export const enum BackgroundMode {
+        OPAQUE = 2, // 0x2
+        TRANSPARENT = 1, // 0x1
+    }
+
+    // GetStockObject: shared system objects (HBRUSH/HPEN/HFONT/HPAL) — never delete
+    export const enum StockObject {
+        WHITE_BRUSH = 0, // 0x0
+        LTGRAY_BRUSH = 1, // 0x1
+        GRAY_BRUSH = 2, // 0x2
+        DKGRAY_BRUSH = 3, // 0x3
+        BLACK_BRUSH = 4, // 0x4
+        NULL_BRUSH = 5, // 0x5
+        WHITE_PEN = 6, // 0x6
+        BLACK_PEN = 7, // 0x7
+        NULL_PEN = 8, // 0x8
+        OEM_FIXED_FONT = 10, // 0xA
+        ANSI_FIXED_FONT = 11, // 0xB
+        ANSI_VAR_FONT = 12, // 0xC
+        SYSTEM_FONT = 13, // 0xD
+        DEVICE_DEFAULT_FONT = 14, // 0xE
+        DEFAULT_PALETTE = 15, // 0xF
+        SYSTEM_FIXED_FONT = 16, // 0x10
+        DEFAULT_GUI_FONT = 17, // 0x11
+    }
+
+    // CreateHatchBrush: hatch pattern styles
+    export const enum HatchStyle {
+        HORIZONTAL = 0, // 0x0
+        VERTICAL = 1, // 0x1
+        FDIAGONAL = 2, // 0x2
+        BDIAGONAL = 3, // 0x3
+        CROSS = 4, // 0x4
+        DIAGCROSS = 5, // 0x5
+    }
+
+    // SetPolyFillMode: polygon fill rule (nonzero winding vs even-odd)
+    export const enum PolyFillMode {
+        ALTERNATE = 1, // 0x1
+        WINDING = 2, // 0x2
+    }
+
+    // SetROP2: binary raster mode (foreground pen vs dest mix)
+    export const enum RasterMode {
+        R2_BLACK = 1, // 0x1
+        R2_NOTMERGEPEN = 2, // 0x2
+        R2_MASKNOTPEN = 3, // 0x3
+        R2_NOTCOPYPEN = 4, // 0x4
+        R2_MASKPENNOT = 5, // 0x5
+        R2_NOT = 6, // 0x6
+        R2_XORPEN = 7, // 0x7
+        R2_MASKPEN = 9, // 0x9
+        R2_NOTXORPEN = 10, // 0xA
+        R2_MERGENOTPEN = 12, // 0xC
+        R2_NOP = 11, // 0xB
+        R2_MERGEPENNOT = 14, // 0xE
+        R2_COPYPEN = 13, // 0xD
+        R2_MERGEPEN = 15, // 0xF
+        R2_WHITE = 16, // 0x10
+    }
+
+    // SetTextAlign: text alignment flags (combinable, pass as u32)
+    export const enum TextAlign {
+        TA_LEFT = 0, // 0x0
+        TA_CENTER = 6, // 0x6
+        TA_RIGHT = 2, // 0x2
+        TA_TOP = 0, // 0x0
+        TA_BOTTOM = 8, // 0x8
+        TA_BASELINE = 24, // 0x18
+        TA_NOUPDATECP = 0, // 0x0
+        TA_UPDATECP = 1, // 0x1
+    }
+
+    // ExtTextOut: ETO_* options (combinable, pass as u32)
+    export const enum TextOutOptions {
+        ETO_CLIPPED = 4, // 0x4
+        ETO_OPAQUE = 2, // 0x2
+        ETO_GLYPH_INDEX = 16, // 0x10
+    }
+
+    // SetArcDirection: arc/chord/pie sweep direction (default counterclockwise)
+    export const enum ArcDirection {
+        COUNTERCLOCKWISE = 1, // 0x1
+        CLOCKWISE = 2, // 0x2
+    }
+
+    // SetStretchBltMode: color filtering when StretchBlt scales a bitmap
+    export const enum StretchBltMode {
+        ANDSCANS = 1, // 0x1
+        ORSCANS = 2, // 0x2
+        DELETESCANS = 3, // 0x3
+        HALFTONE = 4, // 0x4
     }
 
     export const enum OpenFileNameFlag {
@@ -698,12 +817,28 @@ declare module "gui" {
     export const enum RegAccess {
         SET_VALUE = 2, // 0x2
         READ = 131097, // 0x20019
+        ALL_ACCESS = 983103, // 0xF003F
     }
 
     export const enum RegType {
         SZ = 1, // 0x1
     }
 
+    // File
+    export const enum FileCreation {
+        CREATE_NEW = 1, // 0x1
+        CREATE_ALWAYS = 2, // 0x2
+        OPEN_EXISTING = 3, // 0x3
+        OPEN_ALWAYS = 4, // 0x4
+        TRUNCATE_EXISTING = 5, // 0x5
+    }
+
+    export const enum FileSeekFrom {
+        BEGIN = 0, // 0x0
+        CURRENT = 1, // 0x1
+        END = 2, // 0x2
+    }
+
     // Printer
     export const enum PrinterEnum {
         LOCAL = 2, // 0x2
@@ -716,6 +851,7 @@ declare module "gui" {
         VERTRES = 10, // 0xA
         LOGPIXELSX = 88, // 0x58
         LOGPIXELSY = 90, // 0x5A
+        BITSPIXEL = 12, // 0xC
     }
 
     // Static controls
@@ -895,6 +1031,7 @@ declare module "wolfssl" {
     export const enum ErrorCode {
         WOLFSSL_ERROR_WANT_READ = 2, // 0x2
         WOLFSSL_ERROR_WANT_WRITE = 3, // 0x3
+        WOLFSSL_ERROR_ZERO_RETURN = 6, // 0x6
     }
 
 }