quickwin 1.2.1 → 2.0.0

package/test/test_ffi_user32.ts

@@ -0,0 +1,113 @@
+import { Tester } from './test_helper.js'
+import { closure, WCHAR } from '../lib/ffi/bind.js'
+import { NULL, PtrArrayBuffer } from '../lib/ffi/ctype.js'
+import {
+    GetDesktopWindow, IsWindow, IsWindowVisible, GetSystemMetrics, GetClientRect,
+    GetWindowTextLength, GetClassName, FindWindow, SetTimer, KillTimer,
+    GetKeyState, LoadCursor, SetCursor, GetMenu, DestroyMenu, GetForegroundWindow,
+    GetDC, ReleaseDC, EnumWindows, FindWindowEx,
+} from '../lib/windows/user32.js'
+import { RECT } from '../lib/windows/structs.js'
+
+export const suite = {
+    run(t: Tester) {
+        t.section('user32: 窗口 / 度量')
+        const desk = GetDesktopWindow()
+        t.checkTrue('GetDesktopWindow 非 0', desk !== 0)
+        if (desk === 0) return
+        t.check('IsWindow(desktop)', 1, IsWindow(desk))
+        t.check('IsWindowVisible(desktop)', 1, IsWindowVisible(desk))
+        t.checkTrue('GetSystemMetrics(SM_CXSCREEN) > 0', GetSystemMetrics(0) > 0)
+        t.checkTrue('GetForegroundWindow 形态 number',
+            typeof GetForegroundWindow() === 'number')
+
+        t.section('user32: RECT 出参（encode → call → decode 字段直读）')
+        const rectOut = RECT.alloc()
+        t.check('GetClientRect(desktop)', 1, GetClientRect(desk, rectOut.ptr))
+        const rect = RECT.decode(rectOut)
+        t.check('客户区宽 = SM_CXSCREEN', GetSystemMetrics(0), rect.right - rect.left)
+        t.check('客户区高 = SM_CYSCREEN', GetSystemMetrics(1), rect.bottom - rect.top)
+
+        t.section('user32: 字符串出参（宽字符 buffer 读回）')
+        t.checkTrue('GetWindowTextLength ≥ 0', GetWindowTextLength(desk) >= 0)
+        const cls = new PtrArrayBuffer(64)
+        const n = GetClassName(desk, cls, 32)
+        t.checkTrue('GetClassName 写入长度 > 0', n > 0)
+        const cdv = new DataView(cls)
+        let clsName = ''
+        for (let i = 0; i < n; i++) clsName += String.fromCharCode(cdv.getUint16(i * 2, true))
+        t.checkTrue('类名非空', clsName.length > 0)
+        // JSDoc 文档化流（L4）：WCHAR.alloc(n) 当 out buffer、WCHAR.decode(buf) 读回
+        const clsH = WCHAR.alloc(32)
+        t.checkTrue('WCHAR.alloc out 写入长度 > 0', GetClassName(desk, clsH, 32) > 0)
+        t.check('WCHAR.decode(buf) 读回类名', clsName, WCHAR.decode(clsH))
+
+        t.section('user32: FindWindow（<WCHAR>ptr 的 NULL 与 string 双形态）')
+        const fw = FindWindow(NULL, NULL)
+        t.checkTrue('FindWindow(NULL, NULL) 形态 number（NULL 实参不 throw）',
+            typeof fw === 'number')
+        t.check('FindWindow(不存在类名, NULL)', 0, FindWindow('qw_no_such_class_xyz', NULL))
+
+        t.section('user32: 计时器')
+        const tid = SetTimer(NULL, 0, 50, NULL)
+        t.checkTrue('SetTimer 返回非 0 id', tid !== 0)
+        if (tid !== 0) t.checkTrue('KillTimer 成功', KillTimer(NULL, tid) !== 0)
+
+        t.section('user32: 输入 / 光标 / 菜单')
+        t.checkTrue('GetKeyState 返回整数', Number.isInteger(GetKeyState(0x1b)))
+        t.checkTrue('LoadCursor(NULL, IDC_ARROW=32512) 非 0', LoadCursor(NULL, 32512) !== 0)
+        // 品牌流动（正例）：LoadCursor 返回 MaybePtr<'HCURSOR'> 直接喂 SetCursor 形参（先收窄空位）
+        const arrow = LoadCursor(NULL, 32512)
+        const prevCur = arrow !== 0 ? SetCursor(arrow) : null
+        t.checkTrue('SetCursor(LoadCursor(...)) 返回句柄形态',
+            arrow !== 0 && (prevCur === null || typeof prevCur === 'number'))
+        t.check('GetMenu(desktop) 无菜单 → 0', 0, GetMenu(desk))
+
+        t.section('user32: GetDC / ReleaseDC 配对')
+        const hdc = GetDC(NULL)
+        t.checkTrue('GetDC(NULL) 非 0', hdc !== 0)
+        t.checkTrue('ReleaseDC(NULL, hdc) 成功', hdc !== 0 && ReleaseDC(NULL, hdc) !== 0)
+
+        // 仅类型层反例（不执行）：异种句柄互传、<>ptr 误传品牌位都应编译不过
+        const _typeOnly = () => {
+            // @ts-expect-error Ptr<>（number）不是 Ptr<'HDC'>，误传桌面句柄应编译不过
+            ReleaseDC(NULL, GetDesktopWindow())
+            // @ts-expect-error Ptr<'HWND'> 不是 Ptr<'HCURSOR'>，窗口句柄喂 SetCursor 应编译不过
+            SetCursor(GetDesktopWindow())
+            // @ts-expect-error Ptr<'HWND'> 不是 Ptr<'HMENU'>，窗口句柄喂 DestroyMenu 应编译不过
+            DestroyMenu(GetDesktopWindow())
+            // @ts-expect-error Ptr<'HMENU'> 不是 Ptr<'HWND'>，菜单句柄喂 IsWindow 应编译不过
+            IsWindow(GetMenu(desk))
+            // @ts-expect-error 出参位未注册 encoder：<RECT>ptr 只收 MaybePtr<'RECT'>（NULL|Ptr），裸 ArrayBuffer 编译不过
+            GetClientRect(desk, new ArrayBuffer(16))
+            // @ts-expect-error 裸 number 缺 Ptr<'RECT'> 品牌
+            GetClientRect(desk, 123)
+            // 正例：同种品牌流动（GetMenu → DestroyMenu）通过——上面反例的成立依赖这层区分
+            const m = GetMenu(desk)
+            if (m !== 0) DestroyMenu(m)
+        }
+        void _typeOnly
+
+        t.section('user32: EnumWindows（<>ptr 回调端到端）')
+        let count = 0
+        const enumClos = closure('<>ptr <>ptr -> i32', () => { count++; return 1 })
+        t.check('EnumWindows 返回 1（枚举完成）', 1, EnumWindows(enumClos.ptr, NULL))
+        t.checkTrue('回调计数 ≥ 1', count >= 1)
+        enumClos.dispose()
+
+        // EnumWindows（快照）与 FindWindowEx(NULL, prev) 链式遍历应得到同一组顶层窗口（实测两者顺序不同，
+        // 所以只比集合，不比顺序）。
+        // 回调只收集：回调内抛异常会被吞成返回 0（枚举静默提前结束），所以不在回调里做别的。
+        t.section('user32: EnumWindows ≡ FindWindowEx 链遍历（顶层窗口集合）')
+        const viaEnum: number[] = []
+        const collect = closure('<HWND>ptr <>ptr -> i32', (h) => { viaEnum.push(h); return 1 })
+        try { EnumWindows(collect.ptr, NULL) } finally { collect.dispose() }
+        const viaChain: number[] = []
+        for (let h = FindWindowEx(NULL, NULL, NULL, NULL); h && viaChain.length < 100000;
+            h = FindWindowEx(NULL, h, NULL, NULL)) viaChain.push(h)
+        t.checkTrue('两种遍历都非空', viaEnum.length > 0 && viaChain.length > 0)
+        t.check('窗口数量一致', viaEnum.length, viaChain.length)
+        const sorted = (a: number[]): string => a.slice().sort((x, y) => x - y).join(',')
+        t.check('窗口集合一致（忽略顺序）', sorted(viaEnum), sorted(viaChain))
+    },
+}

package/test/test_ffi_windows.js

@@ -0,0 +1,101 @@
+import { NULL } from '../lib/ffi/ctype.js';
+import { GetDesktopWindow, CreatePopupMenu, DestroyMenu, GetDC, ReleaseDC, LoadImage, LoadImageOrdinal, SetScrollInfo, GetScrollInfo, } from '../lib/windows/user32.js';
+import { GetDeviceCaps, CreateSolidBrush, DeleteObject, CreateFontIndirect, GetObject, SelectObject, CreateCompatibleDC, DeleteDC, } from '../lib/windows/gdi32.js';
+import { ImageListCreate, ImageListDestroy } from '../lib/windows/comctl32.js';
+import { LOGFONTW, SCROLLINFO } from '../lib/windows/structs.js';
+export const suite = {
+    run(t) {
+        // 本文件 import 三个 dll 模块即在加载时执行全部 bind：proc 名错误 → GetProcAddress 失败 →
+        // 模块加载 throw → run.ts 静默跳过本 suite → 总计数低于基线（判据链对比计数即暴露）
+        t.section('gdi32: 画刷 / 字体 创建-删除往返（LOGFONTW 对象直传）');
+        const brush = CreateSolidBrush(0x3366ff);
+        t.checkTrue('CreateSolidBrush 非 0', brush !== 0);
+        if (brush !== 0)
+            t.checkTrue('DeleteObject(brush) 成功', DeleteObject(brush) !== 0);
+        // DeepPartial 缺省字段跳过：lfHeight + lfFaceName 必给，其余标量保持 0（FW_DONTCARE 等合法零值）
+        const font = CreateFontIndirect({ lfHeight: -16, lfWeight: 400, lfCharSet: 1, lfFaceName: 'Arial' });
+        t.checkTrue('CreateFontIndirect(DeepPartial LOGFONTW) 非 0', font !== 0);
+        if (font !== 0)
+            t.checkTrue('DeleteObject(font) 成功', DeleteObject(font) !== 0);
+        // react-qw ListView.getCellFont 的流程：GetObject 读出现有字体 → decode → 叠加粗/斜/下划线 → 重建 → 回读
+        t.section('gdi32: 字体读出-改写-重建往返（GetObject → decode → CreateFontIndirect → GetObject）');
+        const base = CreateFontIndirect({ lfHeight: -18, lfWeight: 400, lfCharSet: 1, lfFaceName: 'Arial' });
+        if (base !== 0) {
+            const lf0 = LOGFONTW.alloc();
+            t.checkTrue('GetObject(font) 写入 LOGFONTW.size 字节', GetObject(base, LOGFONTW.size, lf0) === LOGFONTW.size);
+            const b0 = LOGFONTW.decode(lf0);
+            t.check('读出 lfHeight', -18, b0.lfHeight);
+            t.check('读出 lfWeight', 400, b0.lfWeight);
+            t.check('读出 lfItalic（未设）', 0, b0.lfItalic);
+            const styled = CreateFontIndirect({ ...b0, lfWeight: 700, lfItalic: 1, lfUnderline: 1 });
+            t.checkTrue('叠加样式后重建非 0', styled !== 0);
+            if (styled !== 0) {
+                const lf1 = LOGFONTW.alloc();
+                GetObject(styled, LOGFONTW.size, lf1);
+                const b1 = LOGFONTW.decode(lf1);
+                t.check('重建后 lfWeight', 700, b1.lfWeight);
+                t.check('重建后 lfItalic', 1, b1.lfItalic);
+                t.check('重建后 lfUnderline', 1, b1.lfUnderline);
+                t.check('底字体的 lfHeight 保留', -18, b1.lfHeight);
+                t.check('底字体的 lfCharSet 保留', 1, b1.lfCharSet);
+                t.check('底字体的字体名保留', b0.lfFaceName, b1.lfFaceName);
+                t.checkTrue('DeleteObject(styled) 成功', DeleteObject(styled) !== 0);
+            }
+            t.checkTrue('DeleteObject(base) 成功', DeleteObject(base) !== 0);
+        }
+        // 内存 DC 选入字体：SelectObject 返回被替换的旧对象，选回后可删除新对象（截屏与 ListView 自绘共用）
+        t.section('gdi32: CreateCompatibleDC / SelectObject 往返');
+        const memDc = CreateCompatibleDC(NULL);
+        t.checkTrue('CreateCompatibleDC(NULL) 非 0', memDc !== 0);
+        if (memDc !== 0) {
+            const f2 = CreateFontIndirect({ lfHeight: -12, lfFaceName: 'Arial' });
+            if (f2 !== 0) {
+                const old = SelectObject(memDc, f2);
+                t.checkTrue('SelectObject 返回旧对象非 0', old !== 0);
+                t.check('再选回旧对象，返回刚选入的字体', f2, SelectObject(memDc, old));
+                t.checkTrue('DeleteObject(f2) 成功', DeleteObject(f2) !== 0);
+            }
+            t.checkTrue('DeleteDC 成功', DeleteDC(memDc) !== 0);
+        }
+        t.section('gdi32: GetDeviceCaps（<HDC>ptr 跨 user32 品牌互认）');
+        const hdc = GetDC(NULL);
+        t.checkTrue('GetDC(NULL) 非 0', hdc !== 0);
+        if (hdc !== 0)
+            t.checkTrue('GetDeviceCaps(hdc, LOGPIXELSX) > 0', GetDeviceCaps(hdc, 88) > 0);
+        t.checkTrue('ReleaseDC(NULL, hdc) 成功', hdc !== 0 && ReleaseDC(NULL, hdc) !== 0);
+        t.section('user32: 弹出菜单往返');
+        const pm = CreatePopupMenu();
+        t.checkTrue('CreatePopupMenu 非 0', pm !== 0);
+        if (pm !== 0)
+            t.checkTrue('DestroyMenu(pm) 成功', DestroyMenu(pm) !== 0);
+        t.section('comctl32: ImageList 创建-销毁往返');
+        const himl = ImageListCreate(16, 16, 4, 0, 0); // ILC_COLOR32=4；initial/grow=0 默认
+        t.checkTrue('ImageListCreate(16, 16, ILC_COLOR32) 非 0', himl !== 0);
+        if (himl !== 0)
+            t.checkTrue('ImageListDestroy(himl) 成功', ImageListDestroy(himl) !== 0);
+        t.section('user32: LoadImage 双变体（string 自动编码 / ordinal MAKEINTRESOURCE）');
+        // Win32 IMAGE_* 真值：BITMAP=0 CURSOR=1 ICON=2；LR_SHARED=0x8000（注意 gui.ImageType d.ts 当前值与此不一致）
+        t.checkTrue('LoadImageOrdinal(NULL, IDI_APPLICATION, IMAGE_ICON, LR_SHARED) 非 0', LoadImageOrdinal(NULL, 32512, 2, 0, 0, 0x8000) !== 0);
+        t.check('LoadImage(LOADFROMFILE, 不存在文件) → 0', 0, LoadImage(NULL, 'qw_no_such_icon_xyz.ico', 2, 0, 0, 0x10));
+        t.section('user32: 滚动条（入参对象直传 / 出参 encode → call → decode）');
+        const desk = GetDesktopWindow();
+        t.checkTrue('GetDesktopWindow 非 0', desk !== 0);
+        if (desk === 0)
+            return;
+        // 入参位（注册 encoder）：DeepPartial 对象直传；cbSize 必须显式 = 结构自描述要求。
+        // 桌面窗口无 WS_VSCROLL 样式 → Set/GetScrollInfo 返回 0 是 Win32 合法行为（.NET 的
+        // WindowsScroll 包装同样先查样式再调用），故断言形态而非成功。
+        t.checkTrue('SetScrollInfo 对象直传 形态 number', typeof SetScrollInfo(desk, 1, { cbSize: SCROLLINFO.size, fMask: 0x0001, nMin: 0, nMax: 100 }, 0) === 'number');
+        // 出参位（不注册 encoder）：encode() 新建 + 初值一步 → 传 .ptr → decode 字段直读。
+        // GetScrollInfo 失败（无滚动条）不写 buffer → decode 回读 = encode 初值；成功时 Win32
+        // 覆写 cbSize/fMask 为同值 —— 两条路径下回环断言都稳定。
+        const si = SCROLLINFO.encode({ cbSize: SCROLLINFO.size, fMask: 0x0001 });
+        t.checkTrue('GetScrollInfo 调用形态 number', typeof GetScrollInfo(desk, 1, si.ptr) === 'number');
+        const info = SCROLLINFO.decode(si);
+        t.check('decode 回读 cbSize = encode 初值', SCROLLINFO.size, info.cbSize);
+        t.check('decode 回读 fMask = encode 初值', 0x0001, info.fMask);
+        t.checkTrue('读回字段为 number 形态', typeof info.nMin === 'number' && typeof info.nMax === 'number');
+        // CallWindowProc / ShowScrollBar / ImageListAdd 仅由 import 的模块加载覆盖 proc 名：
+        // CallWindowProc 跨线程窗口过程不安全、ShowScrollBar 有副作用、ImageListAdd 需位图源
+    },
+};

package/test/test_ffi_windows.ts

@@ -0,0 +1,113 @@
+import { Tester } from './test_helper.js'
+import { NULL } from '../lib/ffi/ctype.js'
+import {
+    GetDesktopWindow, CreatePopupMenu, DestroyMenu, GetDC, ReleaseDC,
+    LoadImage, LoadImageOrdinal, SetScrollInfo, GetScrollInfo,
+} from '../lib/windows/user32.js'
+import {
+    GetDeviceCaps, CreateSolidBrush, DeleteObject, CreateFontIndirect, GetObject, SelectObject, CreateCompatibleDC, DeleteDC,
+} from '../lib/windows/gdi32.js'
+import { ImageListCreate, ImageListDestroy } from '../lib/windows/comctl32.js'
+import { LOGFONTW, SCROLLINFO } from '../lib/windows/structs.js'
+
+export const suite = {
+    run(t: Tester) {
+        // 本文件 import 三个 dll 模块即在加载时执行全部 bind：proc 名错误 → GetProcAddress 失败 →
+        // 模块加载 throw → run.ts 静默跳过本 suite → 总计数低于基线（判据链对比计数即暴露）
+        t.section('gdi32: 画刷 / 字体 创建-删除往返（LOGFONTW 对象直传）')
+        const brush = CreateSolidBrush(0x3366ff)
+        t.checkTrue('CreateSolidBrush 非 0', brush !== 0)
+        if (brush !== 0) t.checkTrue('DeleteObject(brush) 成功', DeleteObject(brush) !== 0)
+
+        // DeepPartial 缺省字段跳过：lfHeight + lfFaceName 必给，其余标量保持 0（FW_DONTCARE 等合法零值）
+        const font = CreateFontIndirect({ lfHeight: -16, lfWeight: 400, lfCharSet: 1, lfFaceName: 'Arial' })
+        t.checkTrue('CreateFontIndirect(DeepPartial LOGFONTW) 非 0', font !== 0)
+        if (font !== 0) t.checkTrue('DeleteObject(font) 成功', DeleteObject(font) !== 0)
+
+        // react-qw ListView.getCellFont 的流程：GetObject 读出现有字体 → decode → 叠加粗/斜/下划线 → 重建 → 回读
+        t.section('gdi32: 字体读出-改写-重建往返（GetObject → decode → CreateFontIndirect → GetObject）')
+        const base = CreateFontIndirect({ lfHeight: -18, lfWeight: 400, lfCharSet: 1, lfFaceName: 'Arial' })
+        if (base !== 0) {
+            const lf0 = LOGFONTW.alloc()
+            t.checkTrue('GetObject(font) 写入 LOGFONTW.size 字节', GetObject(base, LOGFONTW.size, lf0) === LOGFONTW.size)
+            const b0 = LOGFONTW.decode(lf0)
+            t.check('读出 lfHeight', -18, b0.lfHeight)
+            t.check('读出 lfWeight', 400, b0.lfWeight)
+            t.check('读出 lfItalic（未设）', 0, b0.lfItalic)
+            const styled = CreateFontIndirect({ ...b0, lfWeight: 700, lfItalic: 1, lfUnderline: 1 })
+            t.checkTrue('叠加样式后重建非 0', styled !== 0)
+            if (styled !== 0) {
+                const lf1 = LOGFONTW.alloc()
+                GetObject(styled, LOGFONTW.size, lf1)
+                const b1 = LOGFONTW.decode(lf1)
+                t.check('重建后 lfWeight', 700, b1.lfWeight)
+                t.check('重建后 lfItalic', 1, b1.lfItalic)
+                t.check('重建后 lfUnderline', 1, b1.lfUnderline)
+                t.check('底字体的 lfHeight 保留', -18, b1.lfHeight)
+                t.check('底字体的 lfCharSet 保留', 1, b1.lfCharSet)
+                t.check('底字体的字体名保留', b0.lfFaceName, b1.lfFaceName)
+                t.checkTrue('DeleteObject(styled) 成功', DeleteObject(styled) !== 0)
+            }
+            t.checkTrue('DeleteObject(base) 成功', DeleteObject(base) !== 0)
+        }
+
+        // 内存 DC 选入字体：SelectObject 返回被替换的旧对象，选回后可删除新对象（截屏与 ListView 自绘共用）
+        t.section('gdi32: CreateCompatibleDC / SelectObject 往返')
+        const memDc = CreateCompatibleDC(NULL)
+        t.checkTrue('CreateCompatibleDC(NULL) 非 0', memDc !== 0)
+        if (memDc !== 0) {
+            const f2 = CreateFontIndirect({ lfHeight: -12, lfFaceName: 'Arial' })
+            if (f2 !== 0) {
+                const old = SelectObject(memDc, f2)
+                t.checkTrue('SelectObject 返回旧对象非 0', old !== 0)
+                t.check('再选回旧对象，返回刚选入的字体', f2, SelectObject(memDc, old))
+                t.checkTrue('DeleteObject(f2) 成功', DeleteObject(f2) !== 0)
+            }
+            t.checkTrue('DeleteDC 成功', DeleteDC(memDc) !== 0)
+        }
+
+        t.section('gdi32: GetDeviceCaps（<HDC>ptr 跨 user32 品牌互认）')
+        const hdc = GetDC(NULL)
+        t.checkTrue('GetDC(NULL) 非 0', hdc !== 0)
+        if (hdc !== 0) t.checkTrue('GetDeviceCaps(hdc, LOGPIXELSX) > 0', GetDeviceCaps(hdc, 88) > 0)
+        t.checkTrue('ReleaseDC(NULL, hdc) 成功', hdc !== 0 && ReleaseDC(NULL, hdc) !== 0)
+
+        t.section('user32: 弹出菜单往返')
+        const pm = CreatePopupMenu()
+        t.checkTrue('CreatePopupMenu 非 0', pm !== 0)
+        if (pm !== 0) t.checkTrue('DestroyMenu(pm) 成功', DestroyMenu(pm) !== 0)
+
+        t.section('comctl32: ImageList 创建-销毁往返')
+        const himl = ImageListCreate(16, 16, 4, 0, 0)   // ILC_COLOR32=4；initial/grow=0 默认
+        t.checkTrue('ImageListCreate(16, 16, ILC_COLOR32) 非 0', himl !== 0)
+        if (himl !== 0) t.checkTrue('ImageListDestroy(himl) 成功', ImageListDestroy(himl) !== 0)
+
+        t.section('user32: LoadImage 双变体（string 自动编码 / ordinal MAKEINTRESOURCE）')
+        // Win32 IMAGE_* 真值：BITMAP=0 CURSOR=1 ICON=2；LR_SHARED=0x8000（注意 gui.ImageType d.ts 当前值与此不一致）
+        t.checkTrue('LoadImageOrdinal(NULL, IDI_APPLICATION, IMAGE_ICON, LR_SHARED) 非 0',
+            LoadImageOrdinal(NULL, 32512, 2, 0, 0, 0x8000) !== 0)
+        t.check('LoadImage(LOADFROMFILE, 不存在文件) → 0', 0,
+            LoadImage(NULL, 'qw_no_such_icon_xyz.ico', 2, 0, 0, 0x10))
+
+        t.section('user32: 滚动条（入参对象直传 / 出参 encode → call → decode）')
+        const desk = GetDesktopWindow()
+        t.checkTrue('GetDesktopWindow 非 0', desk !== 0)
+        if (desk === 0) return
+        // 入参位（注册 encoder）：DeepPartial 对象直传；cbSize 必须显式 = 结构自描述要求。
+        // 桌面窗口无 WS_VSCROLL 样式 → Set/GetScrollInfo 返回 0 是 Win32 合法行为（.NET 的
+        // WindowsScroll 包装同样先查样式再调用），故断言形态而非成功。
+        t.checkTrue('SetScrollInfo 对象直传 形态 number',
+            typeof SetScrollInfo(desk, 1, { cbSize: SCROLLINFO.size, fMask: 0x0001, nMin: 0, nMax: 100 }, 0) === 'number')
+        // 出参位（不注册 encoder）：encode() 新建 + 初值一步 → 传 .ptr → decode 字段直读。
+        // GetScrollInfo 失败（无滚动条）不写 buffer → decode 回读 = encode 初值；成功时 Win32
+        // 覆写 cbSize/fMask 为同值 —— 两条路径下回环断言都稳定。
+        const si = SCROLLINFO.encode({ cbSize: SCROLLINFO.size, fMask: 0x0001 })
+        t.checkTrue('GetScrollInfo 调用形态 number', typeof GetScrollInfo(desk, 1, si.ptr) === 'number')
+        const info = SCROLLINFO.decode(si)
+        t.check('decode 回读 cbSize = encode 初值', SCROLLINFO.size, info.cbSize)
+        t.check('decode 回读 fMask = encode 初值', 0x0001, info.fMask)
+        t.checkTrue('读回字段为 number 形态', typeof info.nMin === 'number' && typeof info.nMax === 'number')
+        // CallWindowProc / ShowScrollBar / ImageListAdd 仅由 import 的模块加载覆盖 proc 名：
+        // CallWindowProc 跨线程窗口过程不安全、ShowScrollBar 有副作用、ImageListAdd 需位图源
+    },
+}

package/test/test_helper.js

@@ -1,6 +1,7 @@
 import * as std from 'std';
 const GREEN = '\x1b[32m';
 const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
 const BOLD = '\x1b[1m';
 const RESET = '\x1b[0m';
 function formatDuration(ms) {
@@ -35,6 +36,7 @@ export function readWasmFile(path) {
 export class Tester {
     ok = 0;
     fail = 0;
+    skip = 0;
     startTime = Date.now();
     sectionStart = this.startTime;
     lastSection = '';
@@ -71,6 +73,10 @@ export class Tester {
     checkTrue(name, actual) {
         this.check(name, true, actual);
     }
+    skipCase(name) {
+        this.skip++;
+        std.printf('  %sSKIP:%s %s\n', YELLOW, RESET, name);
+    }
     summary() {
         const now = Date.now();
         if (this.lastSection) {
@@ -79,6 +85,7 @@ export class Tester {
         }
         const total = now - this.startTime;
         const color = this.fail > 0 ? RED : GREEN;
-        std.printf('\n%s%d/%d passed (%s)%s\n', color, this.ok, this.ok + this.fail, formatDuration(total), RESET);
+        const skipped = this.skip > 0 ? ` (${this.skip} skipped)` : '';
+        std.printf('\n%s%d/%d passed%s (%s)%s\n', color, this.ok, this.ok + this.fail, skipped, formatDuration(total), RESET);
     }
 }

package/test/test_helper.ts

@@ -2,6 +2,7 @@ import * as std from 'std'
 
 const GREEN = '\x1b[32m'
 const RED   = '\x1b[31m'
+const YELLOW = '\x1b[33m'
 const BOLD  = '\x1b[1m'
 const RESET = '\x1b[0m'
 
@@ -34,6 +35,7 @@ export function readWasmFile(path: string): ArrayBuffer | null {
 export class Tester {
     ok = 0
     fail = 0
+    skip = 0
     private startTime = Date.now()
     private sectionStart = this.startTime
     private lastSection = ''
@@ -67,6 +69,11 @@ export class Tester {
         this.check(name, true, actual)
     }
 
+    skipCase(name: string): void {
+        this.skip++
+        std.printf('  %sSKIP:%s %s\n', YELLOW, RESET, name)
+    }
+
     summary(): void {
         const now = Date.now()
         if (this.lastSection) {
@@ -75,6 +82,7 @@ export class Tester {
         }
         const total = now - this.startTime
         const color = this.fail > 0 ? RED : GREEN
-        std.printf('\n%s%d/%d passed (%s)%s\n', color, this.ok, this.ok + this.fail, formatDuration(total), RESET)
+        const skipped = this.skip > 0 ? ` (${this.skip} skipped)` : ''
+        std.printf('\n%s%d/%d passed%s (%s)%s\n', color, this.ok, this.ok + this.fail, skipped, formatDuration(total), RESET)
     }
 }

package/test/test_http_import.js

@@ -60,6 +60,24 @@ export const suite = {
             return;
         assert('cache has body files', after.some(function (f) { return f.endsWith('.body'); }));
         assert('cache has meta files', after.some(function (f) { return f.endsWith('.meta'); }));
+        t.section('repeat https import (fresh url, forces TLS)');
+        // http_get_sync() short-circuits on a warm disk cache, so a second
+        // import of the same URL would never build a TLS connection. Use a
+        // distinct query string to force a real handshake into the
+        // process-wide CA store, then import once more to confirm repeated
+        // loadTrustedCerts() calls keep verifying.
+        const url2 = 'https://esm.sh/left-pad@1.3.0?twice=1';
+        let mod2;
+        try {
+            mod2 = await import(url2);
+            assert('repeat import succeeds', true);
+            assert('repeat default is function', typeof mod2.default === 'function');
+            assert('repeat left-pad works', mod2.default('hello', 8) === '   hello');
+        }
+        catch (e) {
+            assert('repeat import succeeds', false);
+            std.printf('  ERROR: %s\n', String(e));
+        }
         for (const f of after) {
             if (f.endsWith('.meta') && (err !== 0 || before.indexOf(f) < 0)) {
                 std.printf('  meta: %s\n', f);

package/test/test_http_import.ts

@@ -56,6 +56,25 @@ export const suite = {
         if (err2 !== 0) return
         assert('cache has body files', after.some(function(f: string) { return f.endsWith('.body') }))
         assert('cache has meta files', after.some(function(f: string) { return f.endsWith('.meta') }))
+
+        t.section('repeat https import (fresh url, forces TLS)')
+        // http_get_sync() short-circuits on a warm disk cache, so a second
+        // import of the same URL would never build a TLS connection. Use a
+        // distinct query string to force a real handshake into the
+        // process-wide CA store, then import once more to confirm repeated
+        // loadTrustedCerts() calls keep verifying.
+        const url2 = 'https://esm.sh/left-pad@1.3.0?twice=1'
+        let mod2: any
+        try {
+            mod2 = await import(url2)
+            assert('repeat import succeeds', true)
+            assert('repeat default is function', typeof mod2.default === 'function')
+            assert('repeat left-pad works', mod2.default('hello', 8) === '   hello')
+        } catch (e) {
+            assert('repeat import succeeds', false)
+            std.printf('  ERROR: %s\n', String(e))
+        }
+
         for (const f of after) {
             if (f.endsWith('.meta') && (err !== 0 || before.indexOf(f) < 0)) {
                 std.printf('  meta: %s\n', f)

package/test/test_http_server.js

@@ -3,6 +3,7 @@ import * as std from 'std';
 import * as os from 'os';
 import * as sock from 'sock';
 import { createServer } from '../lib/http-server.js';
+import '../lib/fetch.js';
 // ── Minimal raw HTTP client for testing ──
 function httpSend(host, port, raw, nResponses = 1) {
     return new Promise((resolve, reject) => {
@@ -82,6 +83,40 @@ export const suite = {
             else if (path === '/json') {
                 return new Response(JSON.stringify({ method: req.method, q: Object.fromEntries(url.searchParams) }), { headers: { 'Content-Type': 'application/json' } });
             }
+            else if (path === '/stream') {
+                // length unknown: server must send chunked frames
+                return new Response(new ReadableStream({
+                    start(control) {
+                        control.enqueue(new TextEncoder().encode('chunkA/'));
+                        control.enqueue(new TextEncoder().encode('chunkB'));
+                        control.close();
+                    }
+                }), { headers: { 'Content-Type': 'text/plain' } });
+            }
+            else if (path === '/file') {
+                // length known: server streams raw bytes with Content-Length
+                return new Response(new ReadableStream({
+                    start(control) {
+                        control.enqueue(new TextEncoder().encode('chunkA/'));
+                        control.enqueue(new TextEncoder().encode('chunkB'));
+                        control.close();
+                    }
+                }), { headers: { 'Content-Type': 'text/plain', 'Content-Length': '13' } });
+            }
+            else if (path === '/stream-trailer') {
+                // chunked stream with trailing headers (Node addTrailers
+                // semantics: `Trailer` declaration + frames, then the footer)
+                return new Response(new ReadableStream({
+                    start(control) {
+                        control.enqueue(new TextEncoder().encode('chunkA/'));
+                        control.enqueue(new TextEncoder().encode('chunkB'));
+                        control.close();
+                    }
+                }), {
+                    headers: { 'Content-Type': 'text/plain', 'Trailer': 'X-Exit-Code' },
+                    trailers: Promise.resolve({ 'X-Exit-Code': '3' })
+                });
+            }
             else {
                 return new Response('not found', { status: 404 });
             }
@@ -101,6 +136,43 @@ export const suite = {
         t.checkTrue('200 status', r.indexOf('HTTP/1.1 200') === 0);
         t.checkTrue('body = hello world', r.endsWith('hello world'));
         t.checkTrue('content-type text', r.toLowerCase().indexOf('content-type: text/plain') >= 0);
+        t.checkTrue('static body gets content-length', r.toLowerCase().indexOf('content-length: 11') >= 0);
+        // ── streaming chunked response (length unknown) ──
+        t.section('streaming chunked response');
+        r = await httpSend('127.0.0.1', port, 'GET /stream HTTP/1.1\r\nHost: x\r\nConnection: close\r\n\r\n');
+        t.checkTrue('200 status', r.indexOf('HTTP/1.1 200') === 0);
+        t.checkTrue('transfer-encoding chunked', r.toLowerCase().indexOf('transfer-encoding: chunked') >= 0);
+        t.checkTrue('no content-length', r.toLowerCase().indexOf('content-length:') < 0);
+        t.checkTrue('chunk frames + terminator', r.indexOf('7\r\nchunkA/\r\n6\r\nchunkB\r\n0\r\n\r\n') >= 0);
+        // ── streaming raw response with known length ──
+        t.section('streaming known-length response');
+        r = await httpSend('127.0.0.1', port, 'GET /file HTTP/1.1\r\nHost: x\r\nConnection: close\r\n\r\n');
+        t.checkTrue('200 status', r.indexOf('HTTP/1.1 200') === 0);
+        t.checkTrue('content-length 13', r.toLowerCase().indexOf('content-length: 13') >= 0);
+        t.checkTrue('no chunked encoding', r.toLowerCase().indexOf('transfer-encoding: chunked') < 0);
+        t.checkTrue('streamed raw body', r.includes('chunkA/chunkB'));
+        t.checkTrue('no chunk frame headers', r.indexOf('7\r\nchunkA/') < 0);
+        // ── HEAD of a streamed body: headers only, empty body ──
+        t.section('HEAD streaming response');
+        r = await httpSend('127.0.0.1', port, 'HEAD /stream HTTP/1.1\r\nHost: x\r\nConnection: close\r\n\r\n');
+        t.checkTrue('HEAD 200', r.indexOf('HTTP/1.1 200') === 0);
+        t.checkTrue('HEAD content-length 13', r.toLowerCase().indexOf('content-length: 13') >= 0);
+        const headBodyIdx = r.indexOf('\r\n\r\n');
+        t.checkTrue('HEAD empty body', r.slice(headBodyIdx + 4).length === 0);
+        // ── streaming chunked response with trailing headers ──
+        t.section('streaming trailer response');
+        r = await httpSend('127.0.0.1', port, 'GET /stream-trailer HTTP/1.1\r\nHost: x\r\nConnection: close\r\n\r\n');
+        t.checkTrue('200 status', r.indexOf('HTTP/1.1 200') === 0);
+        t.checkTrue('trailer declared in head', r.toLowerCase().indexOf('trailer: x-exit-code') >= 0);
+        t.checkTrue('terminator carries trailer', r.indexOf('0\r\nX-Exit-Code: 3\r\n\r\n') >= 0);
+        t.checkTrue('trailer footer after body', r.indexOf('7\r\nchunkA/\r\n6\r\nchunkB\r\n0\r\nX-Exit-Code: 3\r\n\r\n') >= 0);
+        // ── fetch client consumes chunked response with trailer footer ──
+        t.section('fetch consumes trailer response');
+        {
+            const rr = await fetch(`http://127.0.0.1:${port}/stream-trailer`);
+            t.checkTrue('status 200', rr.status === 200);
+            t.checkTrue('body decoded without trailer', await rr.text() === 'chunkA/chunkB');
+        }
         // ── POST with body ──
         t.section('POST with body');
         r = await httpSend('127.0.0.1', port, 'POST /echo HTTP/1.1\r\nHost: x\r\nContent-Length: 7\r\nConnection: close\r\n\r\npayload');
@@ -132,7 +204,7 @@ export const suite = {
         t.checkTrue('connection close on last', r.toLowerCase().indexOf('connection: close') >= 0);
         // ── server received expected requests ──
         t.section('request log');
-        t.check('total requests', 7, requests.length);
+        t.check('total requests', 12, requests.length);
         t.checkTrue('saw GET /', requests.indexOf('GET /') >= 0);
         t.checkTrue('saw POST /echo', requests.indexOf('POST /echo') >= 0);
         server.close();