quickwin 1.3.0 → 2.1.0

package/test/test_registry.js

@@ -0,0 +1,74 @@
+import * as os from 'os';
+import { NULL, PtrArrayBuffer } from '../lib/ffi/ctype.js';
+import { RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKeyEx, RegQueryValueEx, RegSetValueEx, } from '../lib/windows/advapi32.js';
+// 跨架构读指针宽句柄（ia32 4B / x64 8B）—— 照 test_ffi.ts 的 readPtr 先例
+function readPtr(dv, offset) {
+    if (os.arch === 'ia32') {
+        return dv.getUint32(offset, true);
+    }
+    const low = dv.getUint32(offset, true);
+    const high = dv.getUint32(offset + 4, true);
+    return low + high * 4294967296;
+}
+// REG_SZ 数据 = UTF-16LE 含结尾 NUL；读回按字节数截到 NUL
+function wbuf(s) {
+    const p = new PtrArrayBuffer((s.length + 1) * 2);
+    const dv = new DataView(p);
+    for (let i = 0; i <= s.length; i++)
+        dv.setUint16(i * 2, s.charCodeAt(i), true);
+    return p;
+}
+function wstr(dv, bytes) {
+    let out = '';
+    for (let i = 0; i + 1 < bytes; i += 2) {
+        const ch = dv.getUint16(i, true);
+        if (!ch)
+            break;
+        out += String.fromCharCode(ch);
+    }
+    return out;
+}
+// 测试键：HKCU\Software\QuickWinTest（suite 结束时删除；中途 FAIL 会在下次 run 时复用）
+const KEY = 'Software\\QuickWinTest';
+const MSG = 'hello registry';
+export const suite = {
+    name: 'registry',
+    run: (t) => {
+        t.section('RegCreateKeyEx: create test key under HKCU');
+        const phk = new PtrArrayBuffer(8);
+        // hKey 位双来源：预定义键常量（HKEY_CURRENT_USER = 0x80000001 的 i32 形）
+        // 或真实句柄——裸 <>ptr 位收两者；符号/零扩展语义由本调用实测检验
+        const rcCreate = RegCreateKeyEx(-2147483647 /* gui.HKey.CURRENT_USER */, KEY, 0, NULL, 0, 983103 /* gui.RegAccess.ALL_ACCESS */, NULL, phk, NULL);
+        t.check('create key = ERROR_SUCCESS', 0, rcCreate);
+        if (rcCreate !== 0)
+            return; // 基座失败，后续无意义
+        const hkey = readPtr(new DataView(phk), 0);
+        t.checkTrue(`key handle non-null (${hkey})`, hkey !== 0);
+        t.section('RegSetValueEx + RegQueryValueEx: REG_SZ roundtrip');
+        const data = wbuf(MSG);
+        t.check('set REG_SZ = ERROR_SUCCESS', 0, RegSetValueEx(hkey, 'greeting', 0, 1 /* gui.RegType.SZ */, data, (MSG.length + 1) * 2));
+        const pType = new PtrArrayBuffer(4);
+        const pCb = new PtrArrayBuffer(4);
+        const pData = new PtrArrayBuffer(64);
+        new DataView(pCb).setUint32(0, 64, true); // 双向 lpcbData：入 = 缓冲大小须预写
+        t.check('query = ERROR_SUCCESS', 0, RegQueryValueEx(hkey, 'greeting', NULL, pType, pData, pCb));
+        t.check('type = REG_SZ', 1, new DataView(pType).getUint32(0, true));
+        t.check('size = (len+1)*2', (MSG.length + 1) * 2, new DataView(pCb).getUint32(0, true));
+        t.check('data roundtrip', MSG, wstr(new DataView(pData), (MSG.length + 1) * 2));
+        t.section('RegQueryValueEx: size probe (lpData = NULL)');
+        new DataView(pCb).setUint32(0, 0, true); // 预写 0：只查类型/尺寸
+        t.check('probe = ERROR_SUCCESS', 0, RegQueryValueEx(hkey, 'greeting', NULL, NULL, NULL, pCb));
+        t.check('probe size', (MSG.length + 1) * 2, new DataView(pCb).getUint32(0, true));
+        t.section('RegOpenKeyEx: reopen + missings');
+        const phk2 = new PtrArrayBuffer(8);
+        t.check('reopen = ERROR_SUCCESS', 0, RegOpenKeyEx(-2147483647 /* gui.HKey.CURRENT_USER */, KEY, 0, 131097 /* gui.RegAccess.READ */, phk2));
+        const hkey2 = readPtr(new DataView(phk2), 0);
+        t.check('missing value → ERROR_FILE_NOT_FOUND', 2, RegQueryValueEx(hkey2, 'no-such-value', NULL, NULL, NULL, NULL));
+        t.check('missing key → ERROR_FILE_NOT_FOUND', 2, RegOpenKeyEx(-2147483647 /* gui.HKey.CURRENT_USER */, KEY + 'X', 0, 131097 /* gui.RegAccess.READ */, new PtrArrayBuffer(8)));
+        RegCloseKey(hkey2);
+        t.section('RegDeleteKey + RegCloseKey: cleanup');
+        t.check('delete key = ERROR_SUCCESS', 0, RegDeleteKey(-2147483647 /* gui.HKey.CURRENT_USER */, KEY));
+        t.check('close = ERROR_SUCCESS', 0, RegCloseKey(hkey));
+        t.check('open deleted → ERROR_FILE_NOT_FOUND', 2, RegOpenKeyEx(-2147483647 /* gui.HKey.CURRENT_USER */, KEY, 0, 131097 /* gui.RegAccess.READ */, new PtrArrayBuffer(8)));
+    },
+};

package/test/test_registry.ts

@@ -0,0 +1,95 @@
+import * as os from 'os'
+import * as gui from 'gui'
+import { NULL, PtrArrayBuffer } from '../lib/ffi/ctype.js'
+import {
+    RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKeyEx,
+    RegQueryValueEx, RegSetValueEx,
+} from '../lib/windows/advapi32.js'
+import { Tester } from './test_helper.js'
+
+// 跨架构读指针宽句柄（ia32 4B / x64 8B）—— 照 test_ffi.ts 的 readPtr 先例
+function readPtr(dv: DataView, offset: number): number {
+    if (os.arch === 'ia32') {
+        return dv.getUint32(offset, true)
+    }
+    const low = dv.getUint32(offset, true)
+    const high = dv.getUint32(offset + 4, true)
+    return low + high * 4294967296
+}
+
+// REG_SZ 数据 = UTF-16LE 含结尾 NUL；读回按字节数截到 NUL
+function wbuf(s: string) {
+    const p = new PtrArrayBuffer((s.length + 1) * 2)
+    const dv = new DataView(p)
+    for (let i = 0; i <= s.length; i++) dv.setUint16(i * 2, s.charCodeAt(i), true)
+    return p
+}
+function wstr(dv: DataView, bytes: number): string {
+    let out = ''
+    for (let i = 0; i + 1 < bytes; i += 2) {
+        const ch = dv.getUint16(i, true)
+        if (!ch) break
+        out += String.fromCharCode(ch)
+    }
+    return out
+}
+
+// 测试键：HKCU\Software\QuickWinTest（suite 结束时删除；中途 FAIL 会在下次 run 时复用）
+const KEY = 'Software\\QuickWinTest'
+const MSG = 'hello registry'
+
+export const suite = {
+    name: 'registry',
+    run: (t: Tester) => {
+        t.section('RegCreateKeyEx: create test key under HKCU')
+        const phk = new PtrArrayBuffer(8)
+        // hKey 位双来源：预定义键常量（HKEY_CURRENT_USER = 0x80000001 的 i32 形）
+        // 或真实句柄——裸 <>ptr 位收两者；符号/零扩展语义由本调用实测检验
+        const rcCreate = RegCreateKeyEx(gui.HKey.CURRENT_USER, KEY, 0, NULL, 0,
+            gui.RegAccess.ALL_ACCESS, NULL, phk, NULL)
+        t.check('create key = ERROR_SUCCESS', 0, rcCreate)
+        if (rcCreate !== 0) return                          // 基座失败，后续无意义
+        const hkey = readPtr(new DataView(phk), 0)
+        t.checkTrue(`key handle non-null (${hkey})`, hkey !== 0)
+
+        t.section('RegSetValueEx + RegQueryValueEx: REG_SZ roundtrip')
+        const data = wbuf(MSG)
+        t.check('set REG_SZ = ERROR_SUCCESS', 0,
+            RegSetValueEx(hkey, 'greeting', 0, gui.RegType.SZ, data, (MSG.length + 1) * 2))
+        const pType = new PtrArrayBuffer(4)
+        const pCb = new PtrArrayBuffer(4)
+        const pData = new PtrArrayBuffer(64)
+        new DataView(pCb).setUint32(0, 64, true)            // 双向 lpcbData：入 = 缓冲大小须预写
+        t.check('query = ERROR_SUCCESS', 0,
+            RegQueryValueEx(hkey, 'greeting', NULL, pType, pData, pCb))
+        t.check('type = REG_SZ', 1, new DataView(pType).getUint32(0, true))
+        t.check('size = (len+1)*2', (MSG.length + 1) * 2, new DataView(pCb).getUint32(0, true))
+        t.check('data roundtrip', MSG, wstr(new DataView(pData), (MSG.length + 1) * 2))
+
+        t.section('RegQueryValueEx: size probe (lpData = NULL)')
+        new DataView(pCb).setUint32(0, 0, true)             // 预写 0：只查类型/尺寸
+        t.check('probe = ERROR_SUCCESS', 0,
+            RegQueryValueEx(hkey, 'greeting', NULL, NULL, NULL, pCb))
+        t.check('probe size', (MSG.length + 1) * 2, new DataView(pCb).getUint32(0, true))
+
+        t.section('RegOpenKeyEx: reopen + missings')
+        const phk2 = new PtrArrayBuffer(8)
+        t.check('reopen = ERROR_SUCCESS', 0,
+            RegOpenKeyEx(gui.HKey.CURRENT_USER, KEY, 0, gui.RegAccess.READ, phk2))
+        const hkey2 = readPtr(new DataView(phk2), 0)
+        t.check('missing value → ERROR_FILE_NOT_FOUND', 2,
+            RegQueryValueEx(hkey2, 'no-such-value', NULL, NULL, NULL, NULL))
+        t.check('missing key → ERROR_FILE_NOT_FOUND', 2,
+            RegOpenKeyEx(gui.HKey.CURRENT_USER, KEY + 'X', 0, gui.RegAccess.READ,
+                new PtrArrayBuffer(8)))
+        RegCloseKey(hkey2)
+
+        t.section('RegDeleteKey + RegCloseKey: cleanup')
+        t.check('delete key = ERROR_SUCCESS', 0,
+            RegDeleteKey(gui.HKey.CURRENT_USER, KEY))
+        t.check('close = ERROR_SUCCESS', 0, RegCloseKey(hkey))
+        t.check('open deleted → ERROR_FILE_NOT_FOUND', 2,
+            RegOpenKeyEx(gui.HKey.CURRENT_USER, KEY, 0, gui.RegAccess.READ,
+                new PtrArrayBuffer(8)))
+    },
+}

package/test/test_sysinfo.js

@@ -0,0 +1,122 @@
+import * as ffi from 'ffi';
+import * as os from 'os';
+import { WCHAR } from '../lib/ffi/bind.js';
+import { NULL, PtrArrayBuffer } from '../lib/ffi/ctype.js';
+import { FormatMessage, GetCommandLineW, GetComputerName, GetEnvironmentVariable, GetLocalTime, GetModuleFileName, GetSystemDirectory, GetSystemTimeAsFileTime, GlobalAlloc, GlobalLock, GlobalUnlock, QueryPerformanceCounter, QueryPerformanceFrequency, RtlMoveMemory, Sleep, } from '../lib/windows/kernel32.js';
+import { CloseClipboard, EmptyClipboard, GetClipboardData, OpenClipboard, RegisterClipboardFormat, SetClipboardData, } from '../lib/windows/user32.js';
+import { GetFileVersionInfoSize, GetFileVersionInfo, VerQueryValue, } from '../lib/windows/version.js';
+import { SYSTEMTIME } from '../lib/windows/structs.js';
+// 进程内存跟进读：ffi 只有 readByte（无 DataView/写通道），u32 小端拼值 / 指针随位宽
+// （| 是有符号 32 位运算，>>> 0 归一无符号——0xFEEF04BD 类高位值否则读成负数）
+function readU32At(addr) {
+    return (ffi.readByte(addr) | (ffi.readByte(addr + 1) << 8) |
+        (ffi.readByte(addr + 2) << 16) | (ffi.readByte(addr + 3) << 24)) >>> 0;
+}
+function readPtr(dv, offset) {
+    if (os.arch === 'ia32')
+        return dv.getUint32(offset, true);
+    return dv.getUint32(offset, true) + dv.getUint32(offset + 4, true) * 4294967296;
+}
+export const suite = {
+    name: 'sysinfo',
+    run: (t) => {
+        t.section('QueryPerformanceCounter: frequency + monotonic');
+        const freqB = new PtrArrayBuffer(8);
+        t.checkTrue('QueryPerformanceFrequency ok', QueryPerformanceFrequency(freqB) !== 0);
+        const freq = new DataView(freqB).getBigInt64(0, true);
+        t.checkTrue(`frequency sane (${freq})`, freq > 0n);
+        const c1 = new PtrArrayBuffer(8);
+        const c2 = new PtrArrayBuffer(8);
+        QueryPerformanceCounter(c1);
+        QueryPerformanceCounter(c2);
+        const v1 = new DataView(c1).getBigInt64(0, true);
+        const v2 = new DataView(c2).getBigInt64(0, true);
+        t.checkTrue(`counter monotonic (${v1} <= ${v2})`, v1 <= v2);
+        t.section('Sleep: QPC-measured elapsed lands in interval');
+        QueryPerformanceCounter(c1);
+        Sleep(50);
+        QueryPerformanceCounter(c2);
+        const elapsedMs = Number((new DataView(c2).getBigInt64(0, true) -
+            new DataView(c1).getBigInt64(0, true)) * 1000n / freq);
+        t.checkTrue(`Sleep(50) -> ${elapsedMs}ms in [30, 3000)`, elapsedMs >= 30 && elapsedMs < 3000);
+        t.section('GetLocalTime / GetSystemTimeAsFileTime');
+        const st = SYSTEMTIME.alloc();
+        GetLocalTime(st.ptr);
+        const got = SYSTEMTIME.decode(st);
+        t.checkTrue(`year sane (${got.wYear})`, got.wYear >= 2024 && got.wYear <= 2100);
+        t.checkTrue(`month sane (${got.wMonth})`, got.wMonth >= 1 && got.wMonth <= 12);
+        const ftB = new PtrArrayBuffer(8);
+        GetSystemTimeAsFileTime(ftB);
+        const ft = new DataView(ftB).getBigUint64(0, true);
+        t.checkTrue(`FILETIME > 0 (${ft})`, ft > 0n);
+        t.section('env / computer name / module path');
+        const pathW = WCHAR.alloc(4096);
+        const pathLen = GetEnvironmentVariable('PATH', pathW, 4096);
+        t.checkTrue(`PATH non-empty (${pathLen} chars)`, pathLen > 0);
+        const nameW = WCHAR.alloc(260);
+        const nameLenB = new PtrArrayBuffer(4);
+        new Uint32Array(nameLenB)[0] = 260;
+        t.checkTrue('GetComputerName ok', GetComputerName(nameW, nameLenB) !== 0);
+        const compName = WCHAR.decode(nameW);
+        t.checkTrue(`computer name non-empty (${compName})`, compName.length > 0);
+        const modW = WCHAR.alloc(520);
+        const modLen = GetModuleFileName(NULL, modW, 520);
+        const modPath = WCHAR.decode(modW);
+        t.checkTrue(`exe path has qwin (${modLen > 0})`, /qwin/i.test(modPath));
+        // 生产绑定的返回位 `<WCHAR>ptr!`：内建 WCHAR 自动解码 + `!` 非空担保（直接 string）
+        const cmdLine = GetCommandLineW();
+        t.checkTrue(`GetCommandLineW decodes to non-empty string (${cmdLine.length} chars)`, typeof cmdLine === 'string' && cmdLine.length > 0);
+        t.section('FormatMessage: error 2 -> readable text');
+        const msgW = WCHAR.alloc(512);
+        const msgLen = FormatMessage(0x1200 /* FROM_SYSTEM | IGNORE_INSERTS */, NULL, 2 /* ERROR_FILE_NOT_FOUND */, 0, msgW, 512, NULL);
+        // 语言无关断言（VM 中/英文系统都可过）：错误 2 的系统文字必然 > 4 字符
+        t.checkTrue(`error 2 message non-empty (${msgLen} chars)`, msgLen > 4);
+        t.section('clipboard roundtrip: CF_UNICODETEXT (GlobalAlloc/RtlMoveMemory)');
+        t.checkTrue('OpenClipboard', OpenClipboard(NULL) !== 0);
+        t.checkTrue('EmptyClipboard', EmptyClipboard() !== 0);
+        const clipText = 'QuickWin clip roundtrip 你好';
+        const clipSrc = WCHAR.encode(clipText); // 自带 NUL 终止
+        const hMem = GlobalAlloc(0x2 /* GMEM_MOVEABLE */, clipSrc.byteLength);
+        t.checkTrue(`GlobalAlloc valid (${hMem})`, hMem !== 0);
+        const clipDst = GlobalLock(hMem);
+        t.checkTrue(`GlobalLock address (${clipDst})`, clipDst !== 0);
+        RtlMoveMemory(clipDst, clipSrc, clipSrc.byteLength);
+        GlobalUnlock(hMem);
+        const setR = SetClipboardData(13 /* CF_UNICODETEXT */, hMem);
+        t.checkTrue('SetClipboardData (ownership -> system)', setR !== 0);
+        CloseClipboard();
+        t.checkTrue('OpenClipboard (read back)', OpenClipboard(NULL) !== 0);
+        const hRead = GetClipboardData(13);
+        t.checkTrue('GetClipboardData handle', hRead !== 0);
+        const pRead = hRead ? GlobalLock(hRead) : 0;
+        const back = pRead ? WCHAR.decode(pRead) : '';
+        if (pRead)
+            GlobalUnlock(hRead);
+        CloseClipboard();
+        t.check('clip text roundtrip', clipText, back);
+        t.checkTrue('RegisterClipboardFormat', RegisterClipboardFormat('QuickWinClipFmt') !== 0);
+        t.section('version resource of kernel32.dll');
+        const sysW = WCHAR.alloc(300);
+        GetSystemDirectory(sysW, 300); // 尾不带反斜杠
+        const k32Path = `${WCHAR.decode(sysW)}\\kernel32.dll`;
+        const hB = new PtrArrayBuffer(4);
+        const vSize = GetFileVersionInfoSize(k32Path, hB);
+        t.checkTrue(`version size > 0 (${vSize})`, vSize > 0);
+        if (vSize > 0) {
+            const vHandle = new Uint32Array(hB)[0];
+            const vBuf = new PtrArrayBuffer(vSize);
+            t.checkTrue('GetFileVersionInfo', GetFileVersionInfo(k32Path, vHandle, vSize, vBuf) !== 0);
+            const pBuf = new PtrArrayBuffer(8);
+            const pLen = new PtrArrayBuffer(4);
+            t.checkTrue('VerQueryValue root block', VerQueryValue(vBuf, '\\', pBuf, pLen) !== 0);
+            const rootAddr = readPtr(new DataView(pBuf), 0);
+            const rootLen = new Uint32Array(pLen)[0];
+            t.checkTrue(`VS_FIXEDFILEINFO len >= 52 (${rootLen})`, rootLen >= 52);
+            t.check('VS_FIXEDFILEINFO signature', 0xfeef04bd, readU32At(rootAddr));
+            const fms = readU32At(rootAddr + 8);
+            const fls = readU32At(rootAddr + 12);
+            const ver = `${fms >>> 16}.${fms & 0xffff}.${fls >>> 16}.${fls & 0xffff}`;
+            t.checkTrue(`file version sane (${ver})`, fms !== 0 || fls !== 0);
+        }
+    },
+};

package/test/test_sysinfo.ts

@@ -0,0 +1,141 @@
+import * as ffi from 'ffi'
+import * as os from 'os'
+import { WCHAR } from '../lib/ffi/bind.js'
+import { NULL, PtrArrayBuffer, type Ptr } from '../lib/ffi/ctype.js'
+import {
+    FormatMessage, GetCommandLineW, GetComputerName, GetEnvironmentVariable,
+    GetLocalTime, GetModuleFileName, GetSystemDirectory, GetSystemTimeAsFileTime,
+    GlobalAlloc, GlobalLock, GlobalUnlock, QueryPerformanceCounter,
+    QueryPerformanceFrequency, RtlMoveMemory, Sleep,
+} from '../lib/windows/kernel32.js'
+import {
+    CloseClipboard, EmptyClipboard, GetClipboardData, OpenClipboard,
+    RegisterClipboardFormat, SetClipboardData,
+} from '../lib/windows/user32.js'
+import {
+    GetFileVersionInfoSize, GetFileVersionInfo, VerQueryValue,
+} from '../lib/windows/version.js'
+import { SYSTEMTIME } from '../lib/windows/structs.js'
+import { Tester } from './test_helper.js'
+
+// 进程内存跟进读：ffi 只有 readByte（无 DataView/写通道），u32 小端拼值 / 指针随位宽
+// （| 是有符号 32 位运算，>>> 0 归一无符号——0xFEEF04BD 类高位值否则读成负数）
+function readU32At(addr: number): number {
+    return (ffi.readByte(addr) | (ffi.readByte(addr + 1) << 8) |
+        (ffi.readByte(addr + 2) << 16) | (ffi.readByte(addr + 3) << 24)) >>> 0
+}
+function readPtr(dv: DataView, offset: number): number {
+    if (os.arch === 'ia32') return dv.getUint32(offset, true)
+    return dv.getUint32(offset, true) + dv.getUint32(offset + 4, true) * 4294967296
+}
+
+export const suite = {
+    name: 'sysinfo',
+    run: (t: Tester) => {
+        t.section('QueryPerformanceCounter: frequency + monotonic')
+        const freqB = new PtrArrayBuffer(8)
+        t.checkTrue('QueryPerformanceFrequency ok', QueryPerformanceFrequency(freqB) !== 0)
+        const freq = new DataView(freqB).getBigInt64(0, true)
+        t.checkTrue(`frequency sane (${freq})`, freq > 0n)
+        const c1 = new PtrArrayBuffer(8)
+        const c2 = new PtrArrayBuffer(8)
+        QueryPerformanceCounter(c1)
+        QueryPerformanceCounter(c2)
+        const v1 = new DataView(c1).getBigInt64(0, true)
+        const v2 = new DataView(c2).getBigInt64(0, true)
+        t.checkTrue(`counter monotonic (${v1} <= ${v2})`, v1 <= v2)
+
+        t.section('Sleep: QPC-measured elapsed lands in interval')
+        QueryPerformanceCounter(c1)
+        Sleep(50)
+        QueryPerformanceCounter(c2)
+        const elapsedMs = Number((new DataView(c2).getBigInt64(0, true) -
+            new DataView(c1).getBigInt64(0, true)) * 1000n / freq)
+        t.checkTrue(`Sleep(50) -> ${elapsedMs}ms in [30, 3000)`, elapsedMs >= 30 && elapsedMs < 3000)
+
+        t.section('GetLocalTime / GetSystemTimeAsFileTime')
+        const st = SYSTEMTIME.alloc()
+        GetLocalTime(st.ptr)
+        const got = SYSTEMTIME.decode(st)
+        t.checkTrue(`year sane (${got.wYear})`, got.wYear >= 2024 && got.wYear <= 2100)
+        t.checkTrue(`month sane (${got.wMonth})`, got.wMonth >= 1 && got.wMonth <= 12)
+        const ftB = new PtrArrayBuffer(8)
+        GetSystemTimeAsFileTime(ftB)
+        const ft = new DataView(ftB).getBigUint64(0, true)
+        t.checkTrue(`FILETIME > 0 (${ft})`, ft > 0n)
+
+        t.section('env / computer name / module path')
+        const pathW = WCHAR.alloc(4096)
+        const pathLen = GetEnvironmentVariable('PATH', pathW, 4096)
+        t.checkTrue(`PATH non-empty (${pathLen} chars)`, pathLen > 0)
+        const nameW = WCHAR.alloc(260)
+        const nameLenB = new PtrArrayBuffer(4)
+        new Uint32Array(nameLenB)[0] = 260
+        t.checkTrue('GetComputerName ok', GetComputerName(nameW, nameLenB) !== 0)
+        const compName = WCHAR.decode(nameW)
+        t.checkTrue(`computer name non-empty (${compName})`, compName.length > 0)
+        const modW = WCHAR.alloc(520)
+        const modLen = GetModuleFileName(NULL, modW, 520)
+        const modPath = WCHAR.decode(modW)
+        t.checkTrue(`exe path has qwin (${modLen > 0})`, /qwin/i.test(modPath))
+        // 生产绑定的返回位 `<WCHAR>ptr!`：内建 WCHAR 自动解码 + `!` 非空担保（直接 string）
+        const cmdLine = GetCommandLineW()
+        t.checkTrue(`GetCommandLineW decodes to non-empty string (${cmdLine.length} chars)`,
+            typeof cmdLine === 'string' && cmdLine.length > 0)
+
+        t.section('FormatMessage: error 2 -> readable text')
+        const msgW = WCHAR.alloc(512)
+        const msgLen = FormatMessage(0x1200 /* FROM_SYSTEM | IGNORE_INSERTS */,
+            NULL, 2 /* ERROR_FILE_NOT_FOUND */, 0, msgW, 512, NULL)
+        // 语言无关断言（VM 中/英文系统都可过）：错误 2 的系统文字必然 > 4 字符
+        t.checkTrue(`error 2 message non-empty (${msgLen} chars)`, msgLen > 4)
+
+        t.section('clipboard roundtrip: CF_UNICODETEXT (GlobalAlloc/RtlMoveMemory)')
+        t.checkTrue('OpenClipboard', OpenClipboard(NULL) !== 0)
+        t.checkTrue('EmptyClipboard', EmptyClipboard() !== 0)
+        const clipText = 'QuickWin clip roundtrip 你好'
+        const clipSrc = WCHAR.encode(clipText)             // 自带 NUL 终止
+        const hMem = GlobalAlloc(0x2 /* GMEM_MOVEABLE */, clipSrc.byteLength)
+        t.checkTrue(`GlobalAlloc valid (${hMem})`, hMem !== 0)
+        const clipDst = GlobalLock(hMem)
+        t.checkTrue(`GlobalLock address (${clipDst})`, clipDst !== 0)
+        RtlMoveMemory(clipDst, clipSrc, clipSrc.byteLength)
+        GlobalUnlock(hMem)
+        const setR = SetClipboardData(13 /* CF_UNICODETEXT */, hMem)
+        t.checkTrue('SetClipboardData (ownership -> system)', setR !== 0)
+        CloseClipboard()
+        t.checkTrue('OpenClipboard (read back)', OpenClipboard(NULL) !== 0)
+        const hRead = GetClipboardData(13)
+        t.checkTrue('GetClipboardData handle', hRead !== 0)
+        const pRead = hRead ? GlobalLock(hRead) : 0
+        const back = pRead ? WCHAR.decode(pRead as Ptr<'WCHAR'>) : ''
+        if (pRead) GlobalUnlock(hRead)
+        CloseClipboard()
+        t.check('clip text roundtrip', clipText, back)
+        t.checkTrue('RegisterClipboardFormat', RegisterClipboardFormat('QuickWinClipFmt') !== 0)
+
+        t.section('version resource of kernel32.dll')
+        const sysW = WCHAR.alloc(300)
+        GetSystemDirectory(sysW, 300)                       // 尾不带反斜杠
+        const k32Path = `${WCHAR.decode(sysW)}\\kernel32.dll`
+        const hB = new PtrArrayBuffer(4)
+        const vSize = GetFileVersionInfoSize(k32Path, hB)
+        t.checkTrue(`version size > 0 (${vSize})`, vSize > 0)
+        if (vSize > 0) {
+            const vHandle = new Uint32Array(hB)[0]!
+            const vBuf = new PtrArrayBuffer(vSize)
+            t.checkTrue('GetFileVersionInfo', GetFileVersionInfo(k32Path, vHandle, vSize, vBuf) !== 0)
+            const pBuf = new PtrArrayBuffer(8)
+            const pLen = new PtrArrayBuffer(4)
+            t.checkTrue('VerQueryValue root block', VerQueryValue(vBuf, '\\', pBuf, pLen) !== 0)
+            const rootAddr = readPtr(new DataView(pBuf), 0)
+            const rootLen = new Uint32Array(pLen)[0]
+            t.checkTrue(`VS_FIXEDFILEINFO len >= 52 (${rootLen})`, rootLen! >= 52)
+            t.check('VS_FIXEDFILEINFO signature', 0xfeef04bd, readU32At(rootAddr))
+            const fms = readU32At(rootAddr + 8)
+            const fls = readU32At(rootAddr + 12)
+            const ver = `${fms >>> 16}.${fms & 0xffff}.${fls >>> 16}.${fls & 0xffff}`
+            t.checkTrue(`file version sane (${ver})`, fms !== 0 || fls !== 0)
+        }
+    },
+}

package/test/test_wolfssl_read.js

@@ -19,7 +19,8 @@ export const suite = {
                 std.printf('  FAIL: %s\n', name);
             }
         }
-        // ── wolfSSL_read return contract: ArrayBuffer | null, never number ──
+        // ── wolfSSL_read return contract: raw int, data lands in the
+        //    caller-owned buffer (thin wrapper — errors stay numbers) ──
         t.section('wolfSSL_read contract (HTTPS /large/65536)');
         await new Promise((resolve) => {
             const s = sock.socket();
@@ -35,10 +36,9 @@ export const suite = {
             let sentRequest = false;
             let total = 0;
             const EXPECTED = 65536;
-            let sawNumber = false;
-            let sawArray = false;
-            let sawNull = false;
-            let nullErrOk = true;
+            let sawNonNumber = false;
+            let sawEof = false;
+            let errOk = true;
             let done = false;
             const finish = () => {
                 if (done)
@@ -48,10 +48,10 @@ export const suite = {
                 assert('connected', connected);
                 assert('handshake ok', handshakeDone);
                 assert('request sent', sentRequest);
-                assert('received some data', sawArray && total > 0);
-                assert('wolfSSL_read never returned number', !sawNumber);
-                assert('wolfSSL_read returned null on no-data/EOF', sawNull);
-                assert('null path get_error in {WANT_READ,WANT_WRITE,ZERO_RETURN}', nullErrOk);
+                assert('received full body', total >= EXPECTED);
+                assert('wolfSSL_read always returned number', !sawNonNumber);
+                assert('no-data/EOF observed via int (0 or ZERO_RETURN)', sawEof);
+                assert('n<=0 get_error in {WANT_READ,WANT_WRITE,ZERO_RETURN}', errOk);
                 if (ssl) {
                     wolfssl.wolfSSL_free(ssl);
                     ssl = null;
@@ -77,38 +77,39 @@ export const suite = {
                 sentRequest = true;
             };
             const onReadable = () => {
-                // Drain until content complete or null
+                // Drain until EOF (n===0 / ZERO_RETURN) or WANT_* hands back
+                // to the event loop.
                 for (let guard = 0; guard < 10000; guard++) {
-                    const d = wolfssl.wolfSSL_read(ssl, 8192);
-                    if (d === null) {
-                        sawNull = true;
-                        const err = wolfssl.wolfSSL_get_error(ssl, -1);
-                        if (err !== WANT_READ && err !== WANT_WRITE && err !== ZERO_RETURN) {
-                            nullErrOk = false;
-                            std.printf('    null get_error=%d\n', err);
-                        }
-                        if (err === ZERO_RETURN || err === 1 || err === 5) {
-                            // EOF / fatal — done draining
-                            break;
-                        }
-                        // WANT_*: wait for next FD_READ/WRITE
+                    const buf = new ArrayBuffer(8192);
+                    const n = wolfssl.wolfSSL_read(ssl, buf);
+                    if (typeof n !== 'number') {
+                        sawNonNumber = true;
+                        std.printf('    FAIL got non-number %s (want int)\n', String(n));
+                        finish();
                         return;
                     }
-                    if (typeof d === 'number') {
-                        // Pre-fix C API returns number 0/-1 — record and stop
-                        sawNumber = true;
-                        std.printf('    FAIL got number %d (want ArrayBuffer|null)\n', d);
+                    if (n > 0) {
+                        total += n;
+                        // Keep draining after the body is complete: the point of
+                        // this suite is the no-data/EOF contract, so a full body
+                        // must not short-circuit the read that would observe it.
+                        continue;
+                    }
+                    const err = wolfssl.wolfSSL_get_error(ssl, n);
+                    if (err !== WANT_READ && err !== WANT_WRITE && err !== ZERO_RETURN) {
+                        errOk = false;
+                        std.printf('    n=%d get_error=%d outside {WANT_READ,WANT_WRITE,ZERO_RETURN}\n', n, err);
                         finish();
                         return;
                     }
-                    if (d instanceof ArrayBuffer) {
-                        sawArray = true;
-                        total += d.byteLength;
-                        if (total >= EXPECTED)
-                            break;
+                    if (n === 0 || err === ZERO_RETURN) {
+                        sawEof = true;
+                        break;
                     }
+                    // WANT_*: wait for next FD_READ/WRITE
+                    return;
                 }
-                if (total >= EXPECTED)
+                if (sawEof)
                     finish();
             };
             sock.set_on_event(s, (event) => {
@@ -177,21 +178,22 @@ export const suite = {
                 }
                 if (event.lNetworkEvents & 32 /* sock.FdEvent.FD_CLOSE */) {
                     // drain remaining then finish
-                    if (ssl && sentRequest && !sawNumber) {
+                    if (ssl && sentRequest && !sawNonNumber) {
                         onReadable();
                     }
-                    if (!sawNumber) {
-                        // Even if short, require null contract seen OR full body
-                        if (!sawNull && total < EXPECTED && total > 0) {
-                            // got data but no null — still OK if full body; if short, null expected
-                            sawNull = true; // server close without extra null read is edge; don't fail
+                    if (!sawNonNumber) {
+                        // Server close without an observed EOF read is an edge —
+                        // don't fail if the body already completed.
+                        if (!sawEof && total < EXPECTED && total > 0) {
+                            sawEof = true;
                         }
-                        if (total >= EXPECTED || sawNull)
+                        if (total >= EXPECTED || sawEof)
                             finish();
-                        else
+                        else {
                             assert('data before close', false);
-                        if (!done)
-                            finish();
+                            if (!done)
+                                finish();
+                        }
                     }
                 }
             });