quickwin 2.3.0 → 3.0.0

package/lib/ffi/bind.ts

@@ -1,7 +1,6 @@
 import * as ffi from 'ffi'
 import * as os from 'os'
 import * as std from 'std'
-import * as win from 'win'
 import '../text-codec.js'
 import { type C_BasicType, C_BasicType_No_Void, C_BasicType_Token, C_BasicType_Token_No_Void, cTokenToType, isCPtrToken, isCValToken, valName, ArgJsTypeOfToken, RetJsTypeOfToken, normToken, PTR_SIZE, ptrName, type Ptr, readScalar, writeSlot, PtrArrayBuffer } from './ctype.js'
 
@@ -47,12 +46,12 @@ function valCodec(name: string, encoders: CodecMap): StructValCodec | undefined
     return encoders[name] as unknown as StructValCodec | undefined
 }
 
-const _dllCache: Map<string, win.HMODULE> = new Map()
+const _dllCache: Map<string, ffi.HMODULE> = new Map()
 
-function loadDll(dll: string): win.HMODULE {
+function loadDll(dll: string): ffi.HMODULE {
     const cached = _dllCache.get(dll)
     if (cached !== undefined) return cached
-    const loaded = win.LoadLibrary(dll)
+    const loaded = ffi.LoadLibrary(dll)
     if (!loaded) throw new Error(`ffi-bind: LoadLibrary("${dll}") failed`)
     _dllCache.set(dll, loaded)
     return loaded
@@ -105,7 +104,9 @@ function parseSig(sig: string): ParsedSig {
     }
 }
 
-function makeFn(proc: number, sig: string, encoders: CodecMap, decoders: CodecMap): (...a: unknown[]) => unknown {
+/** proc 是 GetProcAddress 拿到的函数地址（<FARPROC>ptr）：调用方已校验非空，故收窄后的
+ *  Ptr 而非 MaybePtr；品牌只在绑定层内部走，落到 ffiCall 的 uintptr 槽（number）时脱落。 */
+function makeFn(proc: Ptr<'FARPROC'>, sig: string, encoders: CodecMap, decoders: CodecMap): (...a: unknown[]) => unknown {
     const ps = parseSig(sig)
     // 按值位的能力校验前移到绑定期（模块加载即炸，不留到首个调用）：布局缺位 / 非结构
     // 布局（无 size）/ 退化 size 都是签名层面的错误，报错指向具体位与可用布局清单。
@@ -134,7 +135,7 @@ const IA32_ARG_SIZE: Record<C_BasicType_No_Void, number> = {
 // x64 桩无条件双读 slots[0..3]，故 argFrame 至少 4 个槽（32 字节）
 const X64_MIN_SLOTS = 4
 
-function callPacked(proc: number, { argTokens, retToken, sig }: ParsedSig, args: any[], encoders: CodecMap, decoders: CodecMap): unknown {
+function callPacked(proc: Ptr<'FARPROC'>, { argTokens, retToken, sig }: ParsedSig, args: any[], encoders: CodecMap, decoders: CodecMap): unknown {
     const is64 = os.arch === 'x64'
 
     const getWidth = (t: C_BasicType_Token_No_Void, is64: boolean): number => {
@@ -381,7 +382,7 @@ export function bind<const S extends string,
     const LE extends CodecMap = {},
     const LD extends CodecMap = LE>(
     dll: string, name: string, sig: S, encoders?: LE, decoders?: LD) {
-    const proc = win.GetProcAddress(loadDll(dll), name)
+    const proc = ffi.GetProcAddress(loadDll(dll), name)
     if (!proc) throw new Error(`ffi-bind: proc "${name}" not found in ${dll}`)
     const effDec = decoders ?? encoders
     return makeFn(proc, sig,
@@ -401,7 +402,7 @@ export function bindLib<const M extends Record<string, string>,
     const encTable = { ...builtinCodecs, ...encoders }
     const decTable = { ...builtinCodecs, ...(effDec ?? {}) }
     for (const [name, sig] of Object.entries(map)) {
-        const proc = win.GetProcAddress(h, name)
+        const proc = ffi.GetProcAddress(h, name)
         if (!proc) throw new Error(`ffi-bind: proc "${name}" not found in ${dll}`)
         out[name] = makeFn(proc, sig, encTable, decTable)
     }

package/lib/http-server.js

@@ -24,6 +24,11 @@ function concatU8(parts) {
     return out;
 }
 function toArrayBuffer(u8) {
+    // 已经是完整 buffer（byteOffset=0、无尾部余量）时零复制返回——发送大
+    // body 的主路径，避免每片 send 前白拷一份。视图场景仍 slice 出独立副本
+    //（FFI 持有的 buffer 生命周期不受 view 约束）。
+    if (u8.byteOffset === 0 && u8.byteLength === u8.buffer.byteLength)
+        return u8.buffer;
     return u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
 }
 function findCrLfCrLf(buf) {
@@ -190,6 +195,7 @@ export class HttpServer {
             const c = {
                 sock: ac.handle,
                 parts: [],
+                partsLen: 0,
                 pending: null,
                 current: null,
                 outQueue: null,
@@ -229,7 +235,9 @@ function onRead(c) {
         const d = sock.recv(c.sock, 8192);
         if (!d)
             break;
-        c.parts.push(new Uint8Array(d));
+        const u8 = new Uint8Array(d);
+        c.parts.push(u8);
+        c.partsLen += u8.length;
     }
     if (!c.closed)
         tryProcess(c);
@@ -334,9 +342,19 @@ async function writeStreamingBody(c, body, chunked, trailer) {
             if (done)
                 break;
             if (value && value.byteLength > 0) {
-                const frame = chunked ? encodeChunkFrame(value, enc) : value;
-                if (!queueSend(c, frame)) {
-                    await new Promise((resolve) => { c.resumeRead = resolve; });
+                // 切成 ≤64KB 再入 queueSend：单发 200MB 级大 chunk 时
+                // toArrayBuffer 会全量 slice 复制，partial drain 又每次复制
+                // 剩余（O(n²)），XP 32 位 1GB 上直接把进程水位顶穿导致断连；
+                // 小片让每次复制/发送恒为常数大小，backpressure 语义不变。
+                const MAX_SEND = 65536;
+                for (let off = 0; off < value.byteLength; off += MAX_SEND) {
+                    const piece = value.byteLength <= MAX_SEND ? value : value.subarray(off, Math.min(off + MAX_SEND, value.byteLength));
+                    const frame = chunked ? encodeChunkFrame(piece, enc) : piece;
+                    if (!queueSend(c, frame)) {
+                        await new Promise((resolve) => { c.resumeRead = resolve; });
+                    }
+                    if (c.closed)
+                        break;
                 }
             }
         }
@@ -383,38 +401,43 @@ function whole(c) {
 function trimParts(c, buf, consumed) {
     if (consumed >= buf.length) {
         c.parts = [];
+        c.partsLen = 0;
     }
     else {
         c.parts = [buf.subarray(consumed)];
+        c.partsLen = buf.length - consumed;
     }
 }
 function tryProcess(c) {
     if (c.closed || c.current)
         return;
-    const buf = whole(c);
     if (c.pending) {
         const bodyStart = c.pending.bodyStart;
         const parsed = c.pending.parsed;
-        let body;
-        let end;
-        if (parsed.chunked) {
-            const dec = decodeChunked(buf, bodyStart);
-            if (!dec)
-                return;
-            body = dec.data;
-            end = dec.end;
-        }
-        else {
-            const needed = parsed.contentLength;
-            if (bodyStart + needed > buf.length)
+        if (!parsed.chunked) {
+            // O(1) length check while the body is still arriving — only
+            // concatenate once, when the last byte is in.
+            const end = bodyStart + parsed.contentLength;
+            if (end > c.partsLen)
                 return;
-            body = buf.subarray(bodyStart, bodyStart + needed);
-            end = bodyStart + needed;
+            const buf = whole(c);
+            c.pending = null;
+            dispatchRequest(c, parsed, buf.subarray(bodyStart, end), end, buf);
+            return;
         }
+        // chunked: no total length up front, so a decode attempt still needs
+        // the concatenated view (re-tried per read event as before).
+        const buf = whole(c);
+        const dec = decodeChunked(buf, bodyStart);
+        if (!dec)
+            return;
         c.pending = null;
-        dispatchRequest(c, parsed, body, end);
+        dispatchRequest(c, parsed, dec.data, dec.end, buf);
         return;
     }
+    // Header phase: bodies are checked against `partsLen` above, so a full
+    // concatenation is only needed here — once per request, not per read.
+    const buf = whole(c);
     const headerEnd = findCrLfCrLf(buf);
     if (headerEnd < 0)
         return;
@@ -432,20 +455,20 @@ function tryProcess(c) {
             c.pending = { parsed, bodyStart };
             return;
         }
-        dispatchRequest(c, parsed, dec.data, dec.end);
+        dispatchRequest(c, parsed, dec.data, dec.end, buf);
     }
     else if (parsed.contentLength > 0) {
         if (bodyStart + parsed.contentLength > buf.length) {
             c.pending = { parsed, bodyStart };
             return;
         }
-        dispatchRequest(c, parsed, buf.subarray(bodyStart, bodyStart + parsed.contentLength), bodyStart + parsed.contentLength);
+        dispatchRequest(c, parsed, buf.subarray(bodyStart, bodyStart + parsed.contentLength), bodyStart + parsed.contentLength, buf);
     }
     else {
-        dispatchRequest(c, parsed, new Uint8Array(0), bodyStart);
+        dispatchRequest(c, parsed, new Uint8Array(0), bodyStart, buf);
     }
 }
-function dispatchRequest(c, parsed, body, end) {
+function dispatchRequest(c, parsed, body, end, wholeBuf) {
     const connHeader = (parsed.headers['connection'] || '').toLowerCase();
     if (parsed.version === 'HTTP/1.1')
         c.keepAlive = connHeader.indexOf('close') < 0;
@@ -468,7 +491,9 @@ function dispatchRequest(c, parsed, body, end) {
     });
     c.ac = ac;
     c.current = { req };
-    trimParts(c, whole(c), end);
+    // `wholeBuf` is the concatenation the caller already produced — reuse it
+    // instead of concatenating the very same parts a second time.
+    trimParts(c, wholeBuf ?? whole(c), end);
     void handleRequest(c);
 }
 async function handleRequest(c) {

package/lib/http-server.ts

@@ -35,6 +35,10 @@ interface ActiveReq {
 interface Conn {
     sock: SockHandle
     parts: Uint8Array[]
+    /** Cached total length of `parts` — lets the pending-body wait check
+     *  "have we received enough yet" in O(1) instead of re-concatenating
+     *  every received byte on each read event (O(n²) for large bodies). */
+    partsLen: number
     pending: PendingReq | null
     current: ActiveReq | null
     outQueue: Uint8Array | null
@@ -69,6 +73,10 @@ function concatU8(parts: Uint8Array[]): Uint8Array {
 }
 
 function toArrayBuffer(u8: Uint8Array): ArrayBuffer {
+    // 已经是完整 buffer（byteOffset=0、无尾部余量）时零复制返回——发送大
+    // body 的主路径，避免每片 send 前白拷一份。视图场景仍 slice 出独立副本
+    //（FFI 持有的 buffer 生命周期不受 view 约束）。
+    if (u8.byteOffset === 0 && u8.byteLength === u8.buffer.byteLength) return u8.buffer as ArrayBuffer
     return u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength) as ArrayBuffer
 }
 
@@ -213,6 +221,7 @@ export class HttpServer {
             const c: Conn = {
                 sock: ac.handle,
                 parts: [],
+                partsLen: 0,
                 pending: null,
                 current: null,
                 outQueue: null,
@@ -251,7 +260,9 @@ function onRead(c: Conn): void {
     while (true) {
         const d = sock.recv(c.sock, 8192)
         if (!d) break
-        c.parts.push(new Uint8Array(d))
+        const u8 = new Uint8Array(d)
+        c.parts.push(u8)
+        c.partsLen += u8.length
     }
     if (!c.closed) tryProcess(c)
 }
@@ -350,9 +361,18 @@ async function writeStreamingBody(c: Conn, body: ReadableStream<Uint8Array> | nu
             const { done, value } = await reader.read()
             if (done) break
             if (value && value.byteLength > 0) {
-                const frame = chunked ? encodeChunkFrame(value, enc) : value
-                if (!queueSend(c, frame)) {
-                    await new Promise<void>((resolve) => { c.resumeRead = resolve })
+                // 切成 ≤64KB 再入 queueSend：单发 200MB 级大 chunk 时
+                // toArrayBuffer 会全量 slice 复制，partial drain 又每次复制
+                // 剩余（O(n²)），XP 32 位 1GB 上直接把进程水位顶穿导致断连；
+                // 小片让每次复制/发送恒为常数大小，backpressure 语义不变。
+                const MAX_SEND = 65536
+                for (let off = 0; off < value.byteLength; off += MAX_SEND) {
+                    const piece = value.byteLength <= MAX_SEND ? value : value.subarray(off, Math.min(off + MAX_SEND, value.byteLength))
+                    const frame = chunked ? encodeChunkFrame(piece, enc) : piece
+                    if (!queueSend(c, frame)) {
+                        await new Promise<void>((resolve) => { c.resumeRead = resolve })
+                    }
+                    if (c.closed) break
                 }
             }
         }
@@ -396,36 +416,42 @@ function whole(c: Conn): Uint8Array {
 function trimParts(c: Conn, buf: Uint8Array, consumed: number): void {
     if (consumed >= buf.length) {
         c.parts = []
+        c.partsLen = 0
     } else {
         c.parts = [buf.subarray(consumed)]
+        c.partsLen = buf.length - consumed
     }
 }
 
 function tryProcess(c: Conn): void {
     if (c.closed || c.current) return
-    const buf = whole(c)
 
     if (c.pending) {
         const bodyStart = c.pending.bodyStart
         const parsed = c.pending.parsed
-        let body: Uint8Array
-        let end: number
-        if (parsed.chunked) {
-            const dec = decodeChunked(buf, bodyStart)
-            if (!dec) return
-            body = dec.data
-            end = dec.end
-        } else {
-            const needed = parsed.contentLength
-            if (bodyStart + needed > buf.length) return
-            body = buf.subarray(bodyStart, bodyStart + needed)
-            end = bodyStart + needed
+        if (!parsed.chunked) {
+            // O(1) length check while the body is still arriving — only
+            // concatenate once, when the last byte is in.
+            const end = bodyStart + parsed.contentLength
+            if (end > c.partsLen) return
+            const buf = whole(c)
+            c.pending = null
+            dispatchRequest(c, parsed, buf.subarray(bodyStart, end), end, buf)
+            return
         }
+        // chunked: no total length up front, so a decode attempt still needs
+        // the concatenated view (re-tried per read event as before).
+        const buf = whole(c)
+        const dec = decodeChunked(buf, bodyStart)
+        if (!dec) return
         c.pending = null
-        dispatchRequest(c, parsed, body, end)
+        dispatchRequest(c, parsed, dec.data, dec.end, buf)
         return
     }
 
+    // Header phase: bodies are checked against `partsLen` above, so a full
+    // concatenation is only needed here — once per request, not per read.
+    const buf = whole(c)
     const headerEnd = findCrLfCrLf(buf)
     if (headerEnd < 0) return
     const absEnd = headerEnd + 4
@@ -440,19 +466,19 @@ function tryProcess(c: Conn): void {
             c.pending = { parsed, bodyStart }
             return
         }
-        dispatchRequest(c, parsed, dec.data, dec.end)
+        dispatchRequest(c, parsed, dec.data, dec.end, buf)
     } else if (parsed.contentLength > 0) {
         if (bodyStart + parsed.contentLength > buf.length) {
             c.pending = { parsed, bodyStart }
             return
         }
-        dispatchRequest(c, parsed, buf.subarray(bodyStart, bodyStart + parsed.contentLength), bodyStart + parsed.contentLength)
+        dispatchRequest(c, parsed, buf.subarray(bodyStart, bodyStart + parsed.contentLength), bodyStart + parsed.contentLength, buf)
     } else {
-        dispatchRequest(c, parsed, new Uint8Array(0), bodyStart)
+        dispatchRequest(c, parsed, new Uint8Array(0), bodyStart, buf)
     }
 }
 
-function dispatchRequest(c: Conn, parsed: ParsedHeader, body: Uint8Array, end: number): void {
+function dispatchRequest(c: Conn, parsed: ParsedHeader, body: Uint8Array, end: number, wholeBuf?: Uint8Array): void {
     const connHeader = (parsed.headers['connection'] || '').toLowerCase()
     if (parsed.version === 'HTTP/1.1') c.keepAlive = connHeader.indexOf('close') < 0
     else c.keepAlive = connHeader.indexOf('keep-alive') >= 0
@@ -477,7 +503,9 @@ function dispatchRequest(c: Conn, parsed: ParsedHeader, body: Uint8Array, end: n
 
     c.ac = ac
     c.current = { req }
-    trimParts(c, whole(c), end)
+    // `wholeBuf` is the concatenation the caller already produced — reuse it
+    // instead of concatenating the very same parts a second time.
+    trimParts(c, wholeBuf ?? whole(c), end)
     void handleRequest(c)
 }
 

package/lib/react-qw/components/DateTimePicker.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef, useRef, useEffect, useState } from 'react';
 import * as gui from 'gui';
-import { InvalidateRect } from '../../windows/user32.js';
+import { GetClientRect, InvalidateRect } from '../../windows/user32.js';
 import { NULL } from '../../ffi/ctype.js';
-import { SYSTEMTIME, NMDATETIMECHANGE } from '../../windows/structs.js';
+import { RECT, SYSTEMTIME, NMDATETIMECHANGE } from '../../windows/structs.js';
 import { nmCode } from '../nmhdr.js';
 function dateToSysTimeBuf(d) {
     // wDayOfWeek 设置时被忽略，缺省跳过 = 0
@@ -52,11 +52,10 @@ const DateTimePicker = forwardRef(function DateTimePicker({ value, onChange, def
             return;
         InvalidateRect(h, NULL, 1);
         // 发送 WM_SIZE 让控件（尤其是 DTS_UPDOWN）重新布局内部子窗口
-        const cr = gui.GetClientRect(h);
-        if (cr) {
-            const w = cr.right - cr.left;
-            const hh = cr.bottom - cr.top;
-            gui.SendMessage(h, 5 /* WmMsg.SIZE */, 0, (hh << 16) | w);
+        const cr = RECT.alloc();
+        if (GetClientRect(h, cr.ptr)) {
+            const { left, top, right, bottom } = RECT.decode(cr);
+            gui.SendMessage(h, 5 /* WmMsg.SIZE */, 0, ((bottom - top) << 16) | (right - left));
         }
     }, []);
     return (_jsx("w", { type: "STATIC", ws: 268435456 /* WindowStyle.VISIBLE */ | 33554432 /* WindowStyle.CLIPCHILDREN */, style: { ...style, flexDirection: 'column', alignItems: 'stretch' }, ref: ref, onEvent: (e) => {

package/lib/react-qw/components/Input.js

@@ -2,6 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef, useState, useRef, useEffect } from 'react';
 import * as gui from 'gui';
 import { WCHAR } from '../../ffi/bind.js';
+import { GetWindowText, GetWindowTextLength } from '../../windows/user32.js';
 export const Input = forwardRef(({ value: controlledValue, defaultValue = '', onChange, placeholder, password, multiline, readonly, number, disabled, style }, ref) => {
     const [internalValue, setInternalValue] = useState(defaultValue);
     const isControlled = controlledValue !== undefined;
@@ -34,7 +35,10 @@ export const Input = forwardRef(({ value: controlledValue, defaultValue = '', on
                 const h = inputRef.current;
                 if (!h)
                     return;
-                const newText = gui.GetWindowText(h);
+                const cap = GetWindowTextLength(h) + 1;
+                const buf = WCHAR.alloc(cap);
+                GetWindowText(h, buf, cap);
+                const newText = WCHAR.decode(buf);
                 if (!isControlled)
                     setInternalValue(newText);
                 onChange?.(newText);

package/lib/react-qw/components/ListView.js

@@ -7,6 +7,8 @@ import { WCHAR } from '../../ffi/bind.js';
 import { nmCode } from '../nmhdr.js';
 import { LoadCursor, SetCursor, ScreenToClient, GetCursorPos } from '../../windows/user32.js';
 import { CreateFontIndirect, DeleteObject, GetObject, SelectObject } from '../../windows/gdi32.js';
+import { createBitmapFromPixels } from '../../bitmap.js';
+import { ImageListCreate, ImageListAdd, ImageListDestroy } from '../../windows/comctl32.js';
 import { LOGFONTW, POINT, NMCUSTOMDRAW, NMLVCUSTOMDRAW, NMLISTVIEW, LVHITTESTINFO, LVITEMW, LVCOLUMNW, } from '../../windows/structs.js';
 export function makeColorBlock(size, bgra) {
     const n = size * size;
@@ -134,27 +136,27 @@ function makeLVItem(i, sub, text, image) {
 }
 const ListView = forwardRef(function ListViewInner({ columns, data, style, icons, iconSize, getIcon }, ref) {
     const lvRef = useRef(null);
-    const iconListRef = useRef(0);
+    const iconListRef = useRef(NULL);
     useEffect(() => {
         const h = lvRef.current;
         if (!h)
             return;
         const il = iconListRef.current;
-        iconListRef.current = 0;
+        iconListRef.current = NULL;
         if (il) {
             gui.SendMessage(h, 4099 /* LvMsg.SETIMAGELIST */, 1 /* LvImageList.SMALL */, 0);
-            gui.ImageListDestroy(il);
+            ImageListDestroy(il);
         }
         if (!icons || icons.length === 0)
             return;
         const size = iconSize ?? 32;
-        const img = gui.ImageListCreate(size, size, 32 /* ImageListFlag.COLOR32 */, icons.length, 1);
+        const img = ImageListCreate(size, size, 32 /* ImageListFlag.COLOR32 */, icons.length, 1);
         if (!img)
             return;
         for (const p of icons) {
-            const hbm = gui.CreateBitmapFromPixels(size, size, p);
+            const hbm = createBitmapFromPixels(size, size, p);
             if (hbm) {
-                gui.ImageListAdd(img, hbm);
+                ImageListAdd(img, hbm, NULL);
                 DeleteObject(hbm);
             }
         }

package/lib/react-qw/components/ScrollView.js

@@ -1,10 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef, useLayoutEffect, useRef } from 'react';
-import * as gui from 'gui';
-import { DefWindowProc, SetWindowPos, ShowScrollBar, GetDC, ReleaseDC } from '../../windows/user32.js';
-import { NULL } from '../../ffi/ctype.js';
-import { GetDeviceCaps } from '../../windows/gdi32.js';
+import { DefWindowProc, GetClientRect, GetScrollInfo, SetScrollInfo, SetWindowPos, ShowScrollBar } from '../../windows/user32.js';
+import { RECT, SCROLLINFO } from '../../windows/structs.js';
 import { forceFlexLayout } from '../reconciler.js';
+import { getScaleFactor } from '../../dpi.js';
 export const ScrollView = forwardRef(({ children, style, contentWidth, contentHeight }, ref) => {
     const svRef = useRef(null);
     const contentRef = useRef(null);
@@ -16,16 +15,13 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
     //   page  = viewportSize（可见行数）
     //   nPos  = 0 … max - page + 1（即 0 … contentSize - viewportSize）
     function updateScroll(sv, content) {
-        const svRect = gui.GetClientRect(sv);
-        if (!svRect)
+        const svBuf = RECT.alloc();
+        if (!GetClientRect(sv, svBuf.ptr))
             return;
-        const svW = svRect.right - svRect.left;
-        const svH = svRect.bottom - svRect.top;
-        // GetScaleFactor 等价内联：GetDC → GetDeviceCaps(LOGPIXELSX=88) → ReleaseDC 配对
-        const hdc = GetDC(NULL);
-        const scale = hdc ? GetDeviceCaps(hdc, 88) / 96 : 1;
-        if (hdc)
-            ReleaseDC(NULL, hdc);
+        const { left, top, right, bottom } = RECT.decode(svBuf);
+        const svW = right - left;
+        const svH = bottom - top;
+        const scale = getScaleFactor();
         const natW = Math.round((contentWidth ?? (svW / scale)) * scale);
         const natH = Math.round((contentHeight ?? (svH / scale)) * scale);
         scrollXRef.current = Math.max(0, Math.min(scrollXRef.current, natW - svW));
@@ -33,7 +29,10 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
         SetWindowPos(content, 0 /* SetWindowPosHwnd.TOP */, -scrollXRef.current, -scrollYRef.current, natW, natH, 4 /* SetWindowPosFlag.SWP_NOZORDER */);
         forceFlexLayout(content);
         if (natW > svW) {
-            gui.SetScrollInfo(sv, 0 /* ScrollBar.HORZ */, { min: 0, max: natW - 1, page: svW, pos: scrollXRef.current }, true);
+            SetScrollInfo(sv, 0 /* ScrollBar.HORZ */, {
+                cbSize: SCROLLINFO.size, fMask: 1 /* ScrollInfoFlag.RANGE */ | 2 /* ScrollInfoFlag.PAGE */ | 4 /* ScrollInfoFlag.POS */,
+                nMin: 0, nMax: natW - 1, nPage: svW, nPos: scrollXRef.current,
+            }, 1);
             ShowScrollBar(sv, 0 /* ScrollBar.HORZ */, 1);
         }
         else {
@@ -41,7 +40,10 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
             ShowScrollBar(sv, 0 /* ScrollBar.HORZ */, 0);
         }
         if (natH > svH) {
-            gui.SetScrollInfo(sv, 1 /* ScrollBar.VERT */, { min: 0, max: natH - 1, page: svH, pos: scrollYRef.current }, true);
+            SetScrollInfo(sv, 1 /* ScrollBar.VERT */, {
+                cbSize: SCROLLINFO.size, fMask: 1 /* ScrollInfoFlag.RANGE */ | 2 /* ScrollInfoFlag.PAGE */ | 4 /* ScrollInfoFlag.POS */,
+                nMin: 0, nMax: natH - 1, nPage: svH, nPos: scrollYRef.current,
+            }, 1);
             ShowScrollBar(sv, 1 /* ScrollBar.VERT */, 1);
         }
         else {
@@ -64,15 +66,17 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
             scrollXRef.current = newPos;
         }
         SetWindowPos(content, 0 /* SetWindowPosHwnd.TOP */, -scrollXRef.current, -scrollYRef.current, 0, 0, 1 /* SetWindowPosFlag.SWP_NOSIZE */ | 4 /* SetWindowPosFlag.SWP_NOZORDER */);
-        gui.SetScrollInfo(sv, bar, { pos: newPos }, true);
+        SetScrollInfo(sv, bar, { cbSize: SCROLLINFO.size, fMask: 4 /* ScrollInfoFlag.POS */, nPos: newPos }, 1);
     }
     function handleScroll(e, bar) {
         const sv = svRef.current;
         const content = contentRef.current;
         if (!sv || !content)
             return;
-        const info = gui.GetScrollInfo(sv, bar);
-        const maxPos = info.max - info.page + 1;
+        const si = SCROLLINFO.encode({ cbSize: SCROLLINFO.size, fMask: 23 /* ScrollInfoFlag.ALL */ });
+        GetScrollInfo(sv, bar, si.ptr);
+        const info = SCROLLINFO.decode(si);
+        const maxPos = info.nMax - info.nPage + 1;
         const code = e.wParam & 0xFFFF;
         const ref_ = bar === 1 /* ScrollBar.VERT */ ? scrollYRef : scrollXRef;
         let newPos = ref_.current;
@@ -84,9 +88,9 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
         else if (code === 1 /* ScrollCmd.LINEDOWN */)
             newPos += 20;
         else if (code === 2 /* ScrollCmd.PAGEUP */)
-            newPos -= info.page;
+            newPos -= info.nPage;
         else if (code === 3 /* ScrollCmd.PAGEDOWN */)
-            newPos += info.page;
+            newPos += info.nPage;
         else
             return;
         newPos = Math.max(0, Math.min(maxPos, newPos));
@@ -106,8 +110,10 @@ export const ScrollView = forwardRef(({ children, style, contentWidth, contentHe
         if (!isHorz && contentHeight === undefined)
             return;
         const bar = isHorz ? 0 /* ScrollBar.HORZ */ : 1 /* ScrollBar.VERT */;
-        const info = gui.GetScrollInfo(sv, bar);
-        const maxPos = info.max - info.page + 1;
+        const si = SCROLLINFO.encode({ cbSize: SCROLLINFO.size, fMask: 23 /* ScrollInfoFlag.ALL */ });
+        GetScrollInfo(sv, bar, si.ptr);
+        const info = SCROLLINFO.decode(si);
+        const maxPos = info.nMax - info.nPage + 1;
         const ref_ = isHorz ? scrollXRef : scrollYRef;
         let newPos = ref_.current + dy;
         newPos = Math.max(0, Math.min(maxPos, newPos));

package/lib/react-qw/index.js

@@ -1,5 +1,5 @@
 import * as gui from 'gui';
-import { DefWindowProc, GetSystemMetrics } from '../windows/user32.js';
+import { DefWindowProc, GetSystemMetrics, ShowWindow, UpdateWindow } from '../windows/user32.js';
 import reconciler, { scaleFactor, instancesByHwnd, forceFlexLayout } from './reconciler.js';
 const noop = () => { };
 let defaultClassRegistered = false;
@@ -34,8 +34,7 @@ export function createRoot(container) {
         const ws = (cfg.ws ?? 0) | 13565952 /* WindowStyle.OVERLAPPEDWINDOW */;
         const w = (cfg.width ?? 800) * scaleFactor;
         const h = (cfg.height ?? 600) * scaleFactor;
-        // GetScreenSize 等价内联：SM_CXSCREEN=0 / SM_CYSCREEN=1
-        const [sw, sh] = [GetSystemMetrics(0), GetSystemMetrics(1)];
+        const [sw, sh] = [GetSystemMetrics(0 /* SysMetrics.CXSCREEN */), GetSystemMetrics(1 /* SysMetrics.CYSCREEN */)];
         const x = cfg.x === undefined ? ((sw - w) / 2) | 0
             : cfg.x === -2147483648 /* CreatePos.USEDEFAULT */ ? -2147483648 /* CreatePos.USEDEFAULT */ : cfg.x * scaleFactor;
         const y = cfg.y === undefined ? ((sh - h) / 2) | 0
@@ -44,8 +43,11 @@ export function createRoot(container) {
         if (!hwin)
             throw new Error('CreateWindow failed');
         hwnd = hwin;
-        if (!cfg.noShowWindow)
-            gui.ShowWindow(hwnd);
+        // 启动首帧：ShowWindow 后立即 WM_PAINT，不留白（原 gui.ShowWindow 复合语义）
+        if (!cfg.noShowWindow) {
+            ShowWindow(hwnd, 1 /* ShowWindowCmd.SHOWNORMAL */);
+            UpdateWindow(hwnd);
+        }
     }
     else {
         hwnd = container;

package/lib/react-qw/index.ts

@@ -1,8 +1,8 @@
 import * as gui from 'gui'
 import React from 'react'
-import { DefWindowProc, GetSystemMetrics } from '../windows/user32.js'
+import { DefWindowProc, GetSystemMetrics, ShowWindow, UpdateWindow } from '../windows/user32.js'
 import reconciler, { scaleFactor, instancesByHwnd, forceFlexLayout, type Instance } from './reconciler.js'
-import { CreatePos, WindowStyle, WmMsg } from '../../constants'
+import { CreatePos, ShowWindowCmd, SysMetrics, WindowStyle, WmMsg } from '../../constants'
 
 const noop = () => { }
 
@@ -48,8 +48,7 @@ export function createRoot(container: gui.HWND | RootWindowConfig) {
     const ws = (cfg.ws ?? 0) | WindowStyle.OVERLAPPEDWINDOW
     const w = (cfg.width ?? 800) * scaleFactor
     const h = (cfg.height ?? 600) * scaleFactor
-    // GetScreenSize 等价内联：SM_CXSCREEN=0 / SM_CYSCREEN=1
-    const [sw, sh] = [GetSystemMetrics(0), GetSystemMetrics(1)]
+    const [sw, sh] = [GetSystemMetrics(SysMetrics.CXSCREEN), GetSystemMetrics(SysMetrics.CYSCREEN)]
     const x = cfg.x === undefined ? ((sw - w) / 2) | 0
       : cfg.x === CreatePos.USEDEFAULT ? CreatePos.USEDEFAULT
       : cfg.x * scaleFactor
@@ -59,7 +58,8 @@ export function createRoot(container: gui.HWND | RootWindowConfig) {
     const hwin = gui.CreateWindow(className, cfg.text || '', ws, x, y, w, h, null, null)
     if (!hwin) throw new Error('CreateWindow failed')
     hwnd = hwin
-    if (!cfg.noShowWindow) gui.ShowWindow(hwnd)
+    // 启动首帧：ShowWindow 后立即 WM_PAINT，不留白（原 gui.ShowWindow 复合语义）
+    if (!cfg.noShowWindow) { ShowWindow(hwnd, ShowWindowCmd.SHOWNORMAL); UpdateWindow(hwnd) }
   } else {
     hwnd = container
   }

package/lib/react-qw/props.js

@@ -1,5 +1,5 @@
 import * as gui from 'gui';
-import { SetWindowText, EnableWindow } from '../windows/user32.js';
+import { SetWindowText, EnableWindow, ShowWindow } from '../windows/user32.js';
 export function applyProps(instance, newProps, _oldProps) {
     const hwnd = instance.hwnd;
     instance.props = newProps;
@@ -24,9 +24,9 @@ export function applyProps(instance, newProps, _oldProps) {
         EnableWindow(hwnd, !newProps.disabled ? 1 : 0);
     }
     if ('hidden' in newProps) {
-        gui.ShowWindow(hwnd, newProps.hidden ? 0 /* ShowWindowCmd.HIDE */ : 5 /* ShowWindowCmd.SHOW */);
+        ShowWindow(hwnd, newProps.hidden ? 0 /* ShowWindowCmd.HIDE */ : 5 /* ShowWindowCmd.SHOW */);
     }
     if ('visible' in newProps) {
-        gui.ShowWindow(hwnd, newProps.visible ? 5 /* ShowWindowCmd.SHOW */ : 0 /* ShowWindowCmd.HIDE */);
+        ShowWindow(hwnd, newProps.visible ? 5 /* ShowWindowCmd.SHOW */ : 0 /* ShowWindowCmd.HIDE */);
     }
 }