quickwin 2.0.0 → 2.1.1

package/test/test_react_render.js

@@ -15600,10 +15600,18 @@ var C_BASIC_TYPE = [
   "f64",
   "ptr"
 ];
-var PTR_TOKEN_RE = /^<([^<>\s]*)>ptr(!|@[A-Za-z_]\w*)?$/;
+var PTR_TOKEN_RE = /^<([A-Za-z_]\w*|)>ptr(!|@[A-Za-z_]\w*)?$/;
 function isCPtrToken(t) {
   return PTR_TOKEN_RE.test(t);
 }
+var VAL_TOKEN_RE = /^<([A-Za-z_]\w*)>$/;
+function isCValToken(t) {
+  return VAL_TOKEN_RE.test(t);
+}
+function valName(t) {
+  const m = VAL_TOKEN_RE.exec(t);
+  return m?.[1] || "";
+}
 function ptrName(t) {
   const m = PTR_TOKEN_RE.exec(t);
   return m?.[1] || "";
@@ -15611,8 +15619,9 @@ function ptrName(t) {
 var cTokenToType = (t) => {
   if (isCPtrToken(t))
     return "ptr";
-  else
-    return t;
+  if (isCValToken(t))
+    throw new Error(`ffi: cTokenToType: by-value token "${t}" has no scalar slot type`);
+  return t;
 };
 var PTR_SIZE = os.arch === "x64" ? 8 : 4;
 var SizeAlign = {
@@ -15631,8 +15640,12 @@ var NULL = 0;
 function normToken(t) {
   if (isCPtrToken(t)) {
     const m = PTR_TOKEN_RE.exec(t);
-    return m?.[2]?.startsWith("@") ? `<${m[1]}>ptr` : t;
+    const name = m?.[1] || "";
+    const mod = m?.[2];
+    return mod?.startsWith("@") ? `<${name}>ptr` : t;
   }
+  if (isCValToken(t))
+    return t;
   const at = t.indexOf("@");
   const base = at >= 0 ? t.slice(0, at) : t;
   const suffixOk = at < 0 || /^[A-Za-z_]\w*$/.test(t.slice(at + 1));
@@ -15728,6 +15741,9 @@ var PtrArrayBuffer = class extends ArrayBuffer {
 };
 
 // _build/lib/ffi/bind.js
+function valCodec(name, encoders) {
+  return encoders[name];
+}
 var _dllCache = /* @__PURE__ */ new Map();
 function loadDll(dll) {
   const cached = _dllCache.get(dll);
@@ -15753,14 +15769,27 @@ function parseSig(sig) {
     }
     argTokens.push(tok);
   }
+  const retToken = normToken(parts[1]);
+  if (isCValToken(retToken))
+    throw new Error(`ffi-bind: "${sig}": by-value struct at the return position (<${valName(retToken)}>) is not supported \u2014 argument positions only; pass a struct out through an out-param slot instead (<N>ptr + caller buffer)`);
   return {
     argTokens,
-    retToken: normToken(parts[1]),
+    retToken,
     sig
   };
 }
 function makeFn(proc, sig, encoders, decoders) {
   const ps = parseSig(sig);
+  for (const t of ps.argTokens) {
+    if (!isCValToken(t))
+      continue;
+    const name = valName(t);
+    const codec = valCodec(name, encoders);
+    if (!codec || typeof codec.encode !== "function")
+      throw new Error(`ffi-bind: ${sig}: by-value position <${name}> has no registered layout (available: ${Object.keys(encoders).join(", ") || "none"})`);
+    if (typeof codec.size !== "number" || codec.size < 1)
+      throw new Error(`ffi-bind: ${sig}: by-value position <${name}> requires a struct layout with size >= 1 (got ${codec.size}; non-struct codecs expose no size)`);
+  }
   return (...a) => callPacked(proc, ps, a, encoders, decoders);
 }
 var IA32_ARG_SIZE = {
@@ -15780,15 +15809,29 @@ var X64_MIN_SLOTS = 4;
 function callPacked(proc, { argTokens, retToken, sig }, args, encoders, decoders) {
   const is64 = os2.arch === "x64";
   const getWidth = (t, is642) => {
+    if (isCValToken(t))
+      throw new Error(`ffi-bind: getWidth: by-value token "${t}" (dispatched by widthOf)`);
     if (is642)
       return 8;
     if (isCPtrToken(t))
       return PTR_SIZE;
     return IA32_ARG_SIZE[t];
   };
+  const widthOf = (t) => {
+    if (isCValToken(t)) {
+      if (is64)
+        return 8;
+      const layout = valCodec(valName(t), encoders);
+      if (!layout)
+        throw new Error(`ffi-bind: <${valName(t)}> by-value position has no registered layout`);
+      const size = layout.size;
+      return size % 4 === 0 ? size : size + 4 - size % 4;
+    }
+    return getWidth(t, is64);
+  };
   let total = 0;
   for (const t of argTokens)
-    total += getWidth(t, is64);
+    total += widthOf(t);
   if (is64 && argTokens.length < X64_MIN_SLOTS)
     total = X64_MIN_SLOTS * 8;
   const argFrame = new ArrayBuffer(total);
@@ -15825,10 +15868,28 @@ function callPacked(proc, { argTokens, retToken, sig }, args, encoders, decoders
           throw new Error(`ffi-bind: ${sig}: arg#${i + 1} <${name}>ptr! encode produced 0 (null pointer forbidden here)`);
         writeSlot(dv, off, { k: "ptr", v: p });
       }
+    } else if (isCValToken(argToken)) {
+      const name = valName(argToken);
+      const codec = valCodec(name, encoders);
+      if (!codec)
+        throw new Error(`ffi-bind: ${sig}: arg#${i + 1} <${name}> by-value position has no registered layout`);
+      if (arg === null || arg === void 0)
+        throw new Error(`ffi-bind: <${name}> value position got ${String(arg)}; pass a struct object (use <${name}>ptr to pass a pointer)`);
+      const size = codec.size;
+      if (!is64 || size <= 8 && (size & size - 1) === 0) {
+        codec.encode(arg, argFrame, off);
+      } else {
+        const buf = new ArrayBuffer(size + 15);
+        const base = ffi.bufferPtr(buf);
+        const pad = (16 - base % 16) % 16;
+        codec.encode(arg, buf, pad);
+        held.push(buf);
+        writeSlot(dv, off, { k: "ptr", v: base + pad });
+      }
     } else {
       writeSlot(dv, off, { k: argToken, v: arg });
     }
-    off += getWidth(argToken, is64);
+    off += widthOf(argToken);
   }
   const retBuf = new ArrayBuffer(8);
   const retIsFp = retToken === "f32" || retToken === "f64";
@@ -16219,21 +16280,20 @@ function createStruct(t) {
     size,
     structAlign: maxEffectiveAlign,
     decode: (p) => {
-      if (typeof p === "number") {
-        const buf = new ArrayBuffer(size);
-        const u8 = new Uint8Array(buf);
-        for (let i = 0; i < size; i++)
-          u8[i] = ffi2.readByte(p + i);
-        return doDecode(new DataView(buf), 0, fields);
-      }
+      if (typeof p === "number")
+        return doDecode(new DataView(ffi2.readBytes(p, size)), 0, fields);
       return doDecode(new DataView(p), 0, fields);
     },
-    alloc: (() => new PtrArrayBuffer(size)),
-    encode: ((v, buf) => {
+    alloc: ((n) => {
+      if (n !== void 0 && (!Number.isInteger(n) || n < 1))
+        throw new Error(`ffi-struct: alloc(n) requires an integer n >= 1 (PAB(0) never escapes \u2014 pass NULL for an empty pointer position)`);
+      return new PtrArrayBuffer(size * (n ?? 1));
+    }),
+    encode: ((v, buf, offset) => {
       if (v === void 0 || v === null)
         throw new Error(`ffi-struct: encode(v) requires an argument; use alloc() for a zeroed out-param slot`);
       const out = buf ?? new PtrArrayBuffer(size);
-      doEncode(new DataView(out), 0, fields, v);
+      doEncode(new DataView(out), offset ?? 0, fields, v);
       return out;
     }),
     offsetOf: (name) => {
@@ -16253,6 +16313,49 @@ function buildDecl(kind, member, pack) {
       decl[k] = v;
   return decl;
 }
+function structArray(def) {
+  const { fields, size } = computeStructLayout(def.__struct);
+  const readN = (dv, n) => {
+    const out = [];
+    for (let i = 0; i < n; i++)
+      out.push(doDecode(dv, i * size, fields));
+    return out;
+  };
+  return {
+    encode: (els) => {
+      if (!Array.isArray(els) || els.length === 0)
+        throw new Error(`ffi-struct: structArray(def).encode(els) requires a non-empty element array (pass NULL for an empty pointer position)`);
+      const out = def.alloc(els.length);
+      for (let i = 0; i < els.length; i++)
+        def.encode(els[i], out, i * def.size);
+      return out;
+    },
+    decode: ((p, count) => {
+      if (count !== void 0 && (!Number.isInteger(count) || count < 0))
+        throw new Error(`ffi-struct: structArray.decode(p, count) requires a non-negative integer count, got ${count}`);
+      if (typeof p === "number") {
+        if (count === void 0)
+          throw new Error(`ffi-struct: structArray.decode(address, count) requires an explicit count (a bare address carries no length)`);
+        if (count === 0)
+          return [];
+        return readN(new DataView(ffi2.readBytes(p, count * size)), count);
+      }
+      let n;
+      if (count !== void 0) {
+        n = count;
+        if (n * size > p.byteLength)
+          throw new Error(`ffi-struct: structArray.decode: count ${n} \xD7 size ${size} = ${n * size} exceeds buffer byteLength ${p.byteLength}`);
+      } else {
+        if (p.byteLength % size !== 0)
+          throw new Error(`ffi-struct: structArray.decode: byteLength ${p.byteLength} is not a multiple of size ${size} (mixed buffer? pass count explicitly)`);
+        n = p.byteLength / size;
+      }
+      if (n === 0)
+        return [];
+      return readN(new DataView(p), n);
+    })
+  };
+}
 function struct(a, b6, c) {
   const isNamed = typeof a === "string";
   const raw = isNamed ? b6 : a;
@@ -16502,11 +16605,12 @@ import * as os4 from "os";
 
 // _build/lib/windows/gdi32.js
 var b2 = (name, sig, encoders) => bind("gdi32.dll", name, sig, encoders);
-var DeleteObject = /* @__PURE__ */ b2("DeleteObject", "<>ptr -> i32");
+var POINTArr = structArray(POINT);
+var DeleteObject = /* @__PURE__ */ b2("DeleteObject", "<HGDIOBJ>ptr -> i32");
 var GetDeviceCaps = /* @__PURE__ */ b2("GetDeviceCaps", "<HDC>ptr! i32@DeviceCap -> i32");
-var CreateFontIndirect = /* @__PURE__ */ b2("CreateFontIndirectW", "<LOGFONTW>ptr -> <>ptr", { LOGFONTW });
-var SelectObject = /* @__PURE__ */ b2("SelectObject", "<HDC>ptr! <>ptr -> <>ptr");
-var GetObject = /* @__PURE__ */ b2("GetObjectW", "<>ptr i32 <BYTE>ptr -> i32");
+var CreateFontIndirect = /* @__PURE__ */ b2("CreateFontIndirectW", "<LOGFONTW>ptr -> <HGDIOBJ>ptr", { LOGFONTW });
+var SelectObject = /* @__PURE__ */ b2("SelectObject", "<HDC>ptr! <HGDIOBJ>ptr -> <HGDIOBJ>ptr");
+var GetObject = /* @__PURE__ */ b2("GetObjectW", "<HGDIOBJ>ptr i32 <BYTE>ptr -> i32");
 
 // _build/lib/react-qw/props.js
 import * as gui from "gui";
@@ -16653,7 +16757,7 @@ function measureTextForHwnd(hwnd2, text) {
   if (!hdc)
     return { width: 0, height: 0 };
   const hFont = gui2.SendMessage(hwnd2, 49, 0, 0);
-  const oldFont = hFont ? SelectObject(hdc, hFont) : 0;
+  const oldFont = hFont ? SelectObject(hdc, hFont) : NULL;
   const result = measureText(hdc, text, 0);
   if (hFont)
     SelectObject(hdc, oldFont);
@@ -18038,11 +18142,11 @@ var import_react17 = __toESM(require_react(), 1);
 
 // _build/lib/windows/comdlg32.js
 var b3 = (name, sig) => bind("comdlg32.dll", name, sig);
-var GetOpenFileName = /* @__PURE__ */ b3("GetOpenFileNameW", "<BYTE>ptr -> u32");
+var GetOpenFileName = /* @__PURE__ */ b3("GetOpenFileNameW", "<OPENFILENAMEW>ptr -> u32");
 
 // _build/lib/windows/shell32.js
 var b4 = (name, sig) => bind("shell32.dll", name, sig);
-var SHBrowseForFolder = /* @__PURE__ */ b4("SHBrowseForFolderW", "<BYTE>ptr -> <>ptr");
+var SHBrowseForFolder = /* @__PURE__ */ b4("SHBrowseForFolderW", "<BROWSEINFOW>ptr -> <>ptr");
 var SHGetPathFromIDList = /* @__PURE__ */ b4("SHGetPathFromIDListW", "<>ptr <BYTE>ptr -> u32");
 
 // _build/lib/windows/ole32.js
@@ -18067,7 +18171,7 @@ function openFileDialog(owner, filter, title, multiple) {
     lpstrTitle: titleWide?.ptr ?? 0,
     Flags: flags
   });
-  const ret = GetOpenFileName(ofn);
+  const ret = GetOpenFileName(ofn.ptr);
   if (!ret)
     return null;
   if (!multiple) {
@@ -18085,7 +18189,7 @@ function openFolderDialog(owner, title) {
     lpszTitle: titleWide?.ptr ?? 0,
     ulFlags: 65
   });
-  const pidl = SHBrowseForFolder(bi);
+  const pidl = SHBrowseForFolder(bi.ptr);
   if (!pidl)
     return null;
   const pathBuf = WCHAR.alloc(260);
@@ -18180,7 +18284,7 @@ function createRoot(container) {
   } else {
     hwnd2 = container;
   }
-  const root = reconciler_default.createContainer(hwnd2, 0, null, false, null, "", noop, noop, noop, noop);
+  const root = reconciler_default.createContainer(hwnd2, 0, null, false, null, "", (error, info) => console.log("[React uncaught]", error, error.stack, info.componentStack), (error, info) => console.log("[React caught]", error, error.stack, info.componentStack), (error, info) => console.log("[React recoverable]", error, error.stack, info.componentStack), noop);
   const rootInst = { hwnd: hwnd2, type: "_root", props: { type: "_root", style: { flexDirection: "column", alignItems: "stretch" } }, children: [] };
   instancesByHwnd.set(hwnd2, rootInst);
   if (typeof container === "object")

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);
+        }
+    },
+};