quickwin 2.0.0 → 2.1.0

package/lib/windows/ntdll.js

@@ -2,7 +2,8 @@
 import { bind } from '../ffi/bind.js';
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = (name, sig) => bind('ntdll.dll', name, sig);
-/** 取真实 OS 版本（成功 → 0）；缓冲必须用 OSVERSIONINFO_148（148B 特制布局，
+/** 取真实 OS 版本；缓冲必须用 OSVERSIONINFO_148（148B 特制布局，
  *  标准 OSVERSIONINFOW 会越界写坏调用方堆，见 structs.ts）
+ *  @returns 0 = 成功
  *  @param args_0 lpVersionInformation OSVERSIONINFO_148.encode(...).ptr 出参缓冲 */
-export const RtlGetVersion = /*@__PURE__*/ b('RtlGetVersion', '<BYTE>ptr -> i32');
+export const RtlGetVersion = /*@__PURE__*/ b('RtlGetVersion', '<OSVERSIONINFO_148>ptr -> i32');

package/lib/windows/ntdll.ts

@@ -4,7 +4,8 @@ import { bind } from '../ffi/bind.js'
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = <const S extends string>(name: string, sig: S) => bind('ntdll.dll', name, sig)
 
-/** 取真实 OS 版本（成功 → 0）；缓冲必须用 OSVERSIONINFO_148（148B 特制布局，
+/** 取真实 OS 版本；缓冲必须用 OSVERSIONINFO_148（148B 特制布局，
  *  标准 OSVERSIONINFOW 会越界写坏调用方堆，见 structs.ts）
+ *  @returns 0 = 成功
  *  @param args_0 lpVersionInformation OSVERSIONINFO_148.encode(...).ptr 出参缓冲 */
-export const RtlGetVersion = /*@__PURE__*/ b('RtlGetVersion', '<BYTE>ptr -> i32')
+export const RtlGetVersion = /*@__PURE__*/ b('RtlGetVersion', '<OSVERSIONINFO_148>ptr -> i32')

package/lib/windows/ole32.js

@@ -2,6 +2,6 @@
 import { bind } from '../ffi/bind.js';
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = (name, sig) => bind('ole32.dll', name, sig);
-/** 释放 CoTaskMemAlloc 分配的内存（SHBrowseForFolder 返回的 PIDL 等）；无返回值
+/** 释放 CoTaskMemAlloc 分配的内存（SHBrowseForFolder 返回的 PIDL 等）
  *  @param args_0 pv CoTaskMem 分配的指针（0/NULL 安全） */
 export const CoTaskMemFree = /*@__PURE__*/ b('CoTaskMemFree', '<>ptr -> void');

package/lib/windows/ole32.ts

@@ -4,6 +4,6 @@ import { bind } from '../ffi/bind.js'
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = <const S extends string>(name: string, sig: S) => bind('ole32.dll', name, sig)
 
-/** 释放 CoTaskMemAlloc 分配的内存（SHBrowseForFolder 返回的 PIDL 等）；无返回值
+/** 释放 CoTaskMemAlloc 分配的内存（SHBrowseForFolder 返回的 PIDL 等）
  *  @param args_0 pv CoTaskMem 分配的指针（0/NULL 安全） */
 export const CoTaskMemFree = /*@__PURE__*/ b('CoTaskMemFree', '<>ptr -> void')

package/lib/windows/psapi.js

@@ -0,0 +1,32 @@
+// psapi.dll 绑定（进程内存统计 / 模块路径；品牌约定见 lib/windows/user32.ts 头注释）：
+//   - 句柄位与 kernel32 同型互认：进程 <HPROCESS>ptr（OpenProcess 产物，CloseHandle 收宽
+//     直通）、模块 <HMODULE>ptr（NULL = 主执行模块）
+//   - PID 数组 / DWORD 出参槽用 <BYTE>ptr 直收 PtrArrayBuffer（TypedArray 原地读回）；
+//     结构出参位收 alloc().ptr、预写首字段后 decode 读回（PROCESSENTRY32W 同法，
+//     见 ./structs.ts JSDoc）
+//   - XP 起系统自带 psapi.dll（官方 min XP 桌面应用），XP/Win7 双机直连
+import { bind } from '../ffi/bind.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = (name, sig) => bind('psapi.dll', name, sig);
+/** 把系统进程 PID 填进数组缓冲
+ *  @returns 成功 → 非 0
+ *  @param args_0 lpidProcess PID 数组缓冲（PtrArrayBuffer(count * 4)，Uint32Array 读回）
+ *  @param args_1 cb 缓冲字节数（= count * 4）
+ *  @param args_2 lpcbNeeded 出参槽（实际写字节数 → PID 数 = /4），PtrArrayBuffer(4) */
+export const EnumProcesses = /*@__PURE__*/ b('EnumProcesses', '<BYTE>ptr u32 <BYTE>ptr -> i32');
+/** 取进程内存统计
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 进程句柄（须 PROCESS_QUERY_INFORMATION | PROCESS_VM_READ）
+ *  @param args_1 ppmc 出参缓冲：alloc() 后预写 offset0 cb = size（new Uint32Array(buf)[0]
+ *                = PROCESS_MEMORY_COUNTERS.size），decode(buf) 读回
+ *  @param args_2 cb 结构字节数（= PROCESS_MEMORY_COUNTERS.size） */
+export const GetProcessMemoryInfo = /*@__PURE__*/ b('GetProcessMemoryInfo', '<HPROCESS>ptr! <PROCESS_MEMORY_COUNTERS>ptr! u32 -> i32');
+/** 取进程模块完整路径（hModule = NULL → 主执行文件）
+ *  @returns 写入字符数（0 失败；
+ *  缓冲不足 = 截断返回 nSize 不含 NUL）
+ *  @param args_0 hProcess 进程句柄（PROCESS_QUERY_INFORMATION | PROCESS_VM_READ）
+ *  @param args_1 hModule 模块句柄（NULL = exe 主模块；toolhelp MODULEENTRY32W.hModule 是
+ *                目标进程上下文的值，跨进程须同权限下重开句柄才可用——本族先例：NULL 用法）
+ *  @param args_2 lpFilename 文本出参缓冲（WCHAR.alloc(n) + WCHAR.decode 读回）
+ *  @param args_3 nSize 缓冲字符数（含 NUL 空间） */
+export const GetModuleFileNameEx = /*@__PURE__*/ b('GetModuleFileNameExW', '<HPROCESS>ptr! <HMODULE>ptr <BYTE>ptr u32 -> u32');

package/lib/windows/psapi.ts

@@ -0,0 +1,37 @@
+// psapi.dll 绑定（进程内存统计 / 模块路径；品牌约定见 lib/windows/user32.ts 头注释）：
+//   - 句柄位与 kernel32 同型互认：进程 <HPROCESS>ptr（OpenProcess 产物，CloseHandle 收宽
+//     直通）、模块 <HMODULE>ptr（NULL = 主执行模块）
+//   - PID 数组 / DWORD 出参槽用 <BYTE>ptr 直收 PtrArrayBuffer（TypedArray 原地读回）；
+//     结构出参位收 alloc().ptr、预写首字段后 decode 读回（PROCESSENTRY32W 同法，
+//     见 ./structs.ts JSDoc）
+//   - XP 起系统自带 psapi.dll（官方 min XP 桌面应用），XP/Win7 双机直连
+import { bind } from '../ffi/bind.js'
+
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
+const b = <const S extends string>(name: string, sig: S) => bind('psapi.dll', name, sig)
+
+/** 把系统进程 PID 填进数组缓冲
+ *  @returns 成功 → 非 0
+ *  @param args_0 lpidProcess PID 数组缓冲（PtrArrayBuffer(count * 4)，Uint32Array 读回）
+ *  @param args_1 cb 缓冲字节数（= count * 4）
+ *  @param args_2 lpcbNeeded 出参槽（实际写字节数 → PID 数 = /4），PtrArrayBuffer(4) */
+export const EnumProcesses = /*@__PURE__*/ b('EnumProcesses',
+    '<BYTE>ptr u32 <BYTE>ptr -> i32')
+/** 取进程内存统计
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 进程句柄（须 PROCESS_QUERY_INFORMATION | PROCESS_VM_READ）
+ *  @param args_1 ppmc 出参缓冲：alloc() 后预写 offset0 cb = size（new Uint32Array(buf)[0]
+ *                = PROCESS_MEMORY_COUNTERS.size），decode(buf) 读回
+ *  @param args_2 cb 结构字节数（= PROCESS_MEMORY_COUNTERS.size） */
+export const GetProcessMemoryInfo = /*@__PURE__*/ b('GetProcessMemoryInfo',
+    '<HPROCESS>ptr! <PROCESS_MEMORY_COUNTERS>ptr! u32 -> i32')
+/** 取进程模块完整路径（hModule = NULL → 主执行文件）
+ *  @returns 写入字符数（0 失败；
+ *  缓冲不足 = 截断返回 nSize 不含 NUL）
+ *  @param args_0 hProcess 进程句柄（PROCESS_QUERY_INFORMATION | PROCESS_VM_READ）
+ *  @param args_1 hModule 模块句柄（NULL = exe 主模块；toolhelp MODULEENTRY32W.hModule 是
+ *                目标进程上下文的值，跨进程须同权限下重开句柄才可用——本族先例：NULL 用法）
+ *  @param args_2 lpFilename 文本出参缓冲（WCHAR.alloc(n) + WCHAR.decode 读回）
+ *  @param args_3 nSize 缓冲字符数（含 NUL 空间） */
+export const GetModuleFileNameEx = /*@__PURE__*/ b('GetModuleFileNameExW',
+    '<HPROCESS>ptr! <HMODULE>ptr <BYTE>ptr u32 -> u32')

package/lib/windows/shell32.js

@@ -2,10 +2,12 @@
 import { bind } from '../ffi/bind.js';
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = (name, sig) => bind('shell32.dll', name, sig);
-/** 文件夹浏览对话框；返回 PIDL，取消 → 0；PIDL 用 ole32.CoTaskMemFree 释放
+/** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
+ *  @returns PIDL，取消 → 0
  *  @param args_0 pbi BROWSEINFOW.encode(...).ptr（见 structs.ts） */
-export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BYTE>ptr -> <>ptr');
-/** PIDL → 文件系统全路径；PIDL 在文件系统中 → 非 0，否则 0（缓冲内容未定义）
+export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEINFOW>ptr -> <>ptr');
+/** PIDL → 文件系统全路径
+ *  @returns PIDL 在文件系统中 → 非 0，否则 0（缓冲内容未定义）
  *  @param args_0 pidl SHBrowseForFolder 等返回的 PIDL
  *  @param args_1 pszPath 出参缓冲，WCHAR.alloc(260)（MAX_PATH=260）、WCHAR.decode 读回 */
 export const SHGetPathFromIDList = /*@__PURE__*/ b('SHGetPathFromIDListW', '<>ptr <BYTE>ptr -> u32');

package/lib/windows/shell32.ts

@@ -4,11 +4,13 @@ import { bind } from '../ffi/bind.js'
 // dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
 const b = <const S extends string>(name: string, sig: S) => bind('shell32.dll', name, sig)
 
-/** 文件夹浏览对话框；返回 PIDL，取消 → 0；PIDL 用 ole32.CoTaskMemFree 释放
+/** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
+ *  @returns PIDL，取消 → 0
  *  @param args_0 pbi BROWSEINFOW.encode(...).ptr（见 structs.ts） */
-export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BYTE>ptr -> <>ptr')
+export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEINFOW>ptr -> <>ptr')
 
-/** PIDL → 文件系统全路径；PIDL 在文件系统中 → 非 0，否则 0（缓冲内容未定义）
+/** PIDL → 文件系统全路径
+ *  @returns PIDL 在文件系统中 → 非 0，否则 0（缓冲内容未定义）
  *  @param args_0 pidl SHBrowseForFolder 等返回的 PIDL
  *  @param args_1 pszPath 出参缓冲，WCHAR.alloc(260)（MAX_PATH=260）、WCHAR.decode 读回 */
 export const SHGetPathFromIDList = /*@__PURE__*/ b('SHGetPathFromIDListW', '<>ptr <BYTE>ptr -> u32')

package/lib/windows/structs.js

@@ -22,6 +22,17 @@ export const SIZE = /* @__PURE__ */ struct('SIZE', {
     cx: 'i32',
     cy: 'i32',
 });
+/** 混合函数（4B，双架构同布局）：AlphaBlend 末参**按值**传（bind 的按值位
+ *  `<BLENDFUNCTION>`，非 `<BLENDFUNCTION>ptr`）——4B POD 聚合体在 x64 走位置寄存器、
+ *  ia32 压 4 字节，字段序须与 windows.h 逐字节一致。BlendOp 仅 AC_SRC_OVER(0)、
+ *  BlendFlags 恒 0（MSDN）；AC_SRC_ALPHA(1) 是 AlphaFormat 的值（源带 premultiplied
+ *  alpha 通道时置位）。纯入参位注册 encoder（对象直传，缺省字段跳过的零值合法）。 */
+export const BLENDFUNCTION = /* @__PURE__ */ struct('BLENDFUNCTION', {
+    BlendOp: 'u8',
+    BlendFlags: 'u8',
+    SourceConstantAlpha: 'u8',
+    AlphaFormat: 'u8',
+});
 /** 滚动参数（28B）：cbSize 必须 = SCROLLINFO.size（结构自描述是 Win32 要求，缺省跳过帮不了）；
  *  fMask = SIF_* 决定 Set 写哪些项 / Get 读哪些项 */
 export const SCROLLINFO = /* @__PURE__ */ struct('SCROLLINFO', {
@@ -51,6 +62,82 @@ export const LOGFONTW = /* @__PURE__ */ struct('LOGFONTW', {
     lfPitchAndFamily: 'u8',
     lfFaceName: 'u16[32]@utf-16le',
 });
+/** TEXTMETRICW（60B = 11 LONG + 4 WCHAR + 5 BYTE 尾部补齐，双架构同布局）：
+ *  GetTextMetrics 纯出参位（不注册 encoder：TEXTMETRICW.alloc().ptr 进、decode 读回） */
+export const TEXTMETRICW = /* @__PURE__ */ struct('TEXTMETRICW', {
+    tmHeight: 'i32',
+    tmAscent: 'i32',
+    tmDescent: 'i32',
+    tmInternalLeading: 'i32',
+    tmExternalLeading: 'i32',
+    tmAveCharWidth: 'i32',
+    tmMaxCharWidth: 'i32',
+    tmWeight: 'i32',
+    tmOverhang: 'i32',
+    tmDigitizedAspectX: 'i32',
+    tmDigitizedAspectY: 'i32',
+    tmFirstChar: 'u16',
+    tmLastChar: 'u16',
+    tmDefaultChar: 'u16',
+    tmBreakChar: 'u16',
+    tmItalic: 'u8',
+    tmUnderlined: 'u8',
+    tmStruckOut: 'u8',
+    tmPitchAndFamily: 'u8',
+    tmCharSet: 'u8',
+});
+/** WIN32_FIND_DATAW（592B 双架构同布局 = 8 头字段 44B + WCHAR[260] + WCHAR[14]，
+ *  mingw wingdi.h 的 cAlternateFileName 为 WCHAR[14] 非 MSDN 的 CHAR[14]）：
+ *  FindFirstFile/FindNextFile 纯出参位（不注册 encoder：WIN32_FIND_DATAW.alloc().ptr
+ *  进、decode 读回）。FILETIME 是 align 4 的 8B 时间，以 u64 + pack 4 忠实布局
+ *  （u64 自然 align 8 须 pack 压到 4）；时间值为 1601 起的 100ns 单元（bigint） */
+export const WIN32_FIND_DATAW = /* @__PURE__ */ struct('WIN32_FIND_DATAW', {
+    dwFileAttributes: 'u32',
+    ftCreationTime: 'u64',
+    ftLastAccessTime: 'u64',
+    ftLastWriteTime: 'u64',
+    nFileSizeHigh: 'u32',
+    nFileSizeLow: 'u32',
+    dwReserved0: 'u32',
+    dwReserved1: 'u32',
+    cFileName: 'u16[260]@utf-16le',
+    cAlternateFileName: 'u16[14]@utf-16le',
+}, { pack: 4 });
+/** DOC_INFO_1W（3 指针随位宽：x64 24B / ia32 12B）：StartDocPrinter 纯入参位
+ *  （注册 encoder：{ pDocName: WCHAR.encode(s).ptr, ... } 对象直传——指针字段收裸
+ *  地址 number，字符串缓冲自行 WCHAR.encode 分配并保持引用） */
+export const DOC_INFO_1W = /* @__PURE__ */ struct('DOC_INFO_1W', {
+    pDocName: '<>ptr',
+    pOutputFile: '<>ptr',
+    pDatatype: '<>ptr',
+});
+/** PRINTER_INFO_2W（13 指针 + 8 DWORD：x64 136B / ia32 84B，双架构已由 test_ffi raw 实测）：
+ *  EnumPrinters(Level=2) 出参数组元素。指针字段 decode 出地址 number，字符串须
+ *  逐字宽读跟进；数组 = 单缓冲读回（structArray().decode(buf, count)：元素间无空洞，
+ *  但缓冲尾部含字符串区 → byteLength 非整数倍，须显式 count）。纯出参不注册 encoder */
+export const PRINTER_INFO_2W = /* @__PURE__ */ struct('PRINTER_INFO_2W', {
+    pServerName: '<>ptr',
+    pPrinterName: '<>ptr',
+    pShareName: '<>ptr',
+    pPortName: '<>ptr',
+    pDriverName: '<>ptr',
+    pComment: '<>ptr',
+    pLocation: '<>ptr',
+    pDevMode: '<>ptr',
+    pSepFile: '<>ptr',
+    pPrintProcessor: '<>ptr',
+    pDatatype: '<>ptr',
+    pParameters: '<>ptr',
+    pSecurityDescriptor: '<>ptr',
+    Attributes: 'u32',
+    Priority: 'u32',
+    DefaultPriority: 'u32',
+    StartTime: 'u32',
+    UntilTime: 'u32',
+    Status: 'u32',
+    cJobs: 'u32',
+    AveragePPM: 'u32',
+});
 /** 进程启动信息（CreateProcessW 纯入参位）：指针字段随进程位宽（x86 68B / x64 104B，struct 按 os.arch 推，
  *  os.arch 是编译期进程指针宽度，WOW64 下 32 位进程得 ia32 布局）。cb 必须 = STARTUPINFOW.size
  *  （结构自描述是 Win32 要求）；dwFlags 含 STARTF_USESTDHANDLES(0x100) 时才读 hStd* */
@@ -382,3 +469,51 @@ export const OSVERSIONINFO_148 = /* @__PURE__ */ struct('OSVERSIONINFO_148', {
     dwPlatformId: 'u32',
     szCSDVersion: 'u8[128]',
 });
+// ── 进程快照 / 内存统计（toolhelp + psapi，布局来源官方 tlhelp32.h / psapi.h）────────
+/** PROCESSENTRY32W（Process32First/Next 就地迭代位；x86 556B / x64 564B——ULONG_PTR
+ *  th32DefaultHeapID 随位宽，struct 按 os.arch 推）：调用前须把 offset 0 的 dwSize 预写
+ *  成 size（MSDN：不初始化 dwSize 则 Process32First 失败）——alloc() 后
+ *  new Uint32Array(buf)[0] = PROCESSENTRY32W.size 一次；First/Next 迭代间复用同一 buf
+ *  （API 只改内容不改 dwSize），每轮 N.decode(buf) 读回 */
+export const PROCESSENTRY32W = /* @__PURE__ */ struct('PROCESSENTRY32W', {
+    dwSize: 'u32',
+    cntUsage: 'u32',
+    th32ProcessID: 'u32',
+    th32DefaultHeapID: '<>ptr',
+    th32ModuleID: 'u32',
+    cntThreads: 'u32',
+    th32ParentProcessID: 'u32',
+    pcPriClassBase: 'i32',
+    dwFlags: 'u32',
+    szExeFile: 'u16[260]@utf-16le',
+});
+/** MODULEENTRY32W（Module32First/Next 就地迭代位；x86 1072B / x64 1088B——BYTE* +
+ *  HMODULE 随位宽）。dwSize 预写同 PROCESSENTRY32W；modBaseAddr/hModule 仅在
+ *  th32ProcessID 的进程上下文有效；szModule 定长 256 = MAX_MODULE_NAME32+1 */
+export const MODULEENTRY32W = /* @__PURE__ */ struct('MODULEENTRY32W', {
+    dwSize: 'u32',
+    th32ModuleID: 'u32',
+    th32ProcessID: 'u32',
+    GlblcntUsage: 'u32',
+    ProccntUsage: 'u32',
+    modBaseAddr: '<>ptr',
+    modBaseSize: 'u32',
+    hModule: '<HMODULE>ptr',
+    szModule: 'u16[256]@utf-16le',
+    szExePath: 'u16[260]@utf-16le',
+});
+/** PROCESS_MEMORY_COUNTERS（GetProcessMemoryInfo 出参位；x86 40B / x64 72B）：官方 psapi.h
+ *  为 cb + PageFaultCount 后接 8×SIZE_T——SIZE_T 随位宽（非全 DWORD），struct 按 os.arch 推。
+ *  调用前 offset 0 的 cb 预写成 size（new Uint32Array(buf)[0] = N.size），实参 u32 cb 同传 size */
+export const PROCESS_MEMORY_COUNTERS = /* @__PURE__ */ struct('PROCESS_MEMORY_COUNTERS', {
+    cb: 'u32',
+    PageFaultCount: 'u32',
+    PeakWorkingSetSize: '<>ptr',
+    WorkingSetSize: '<>ptr',
+    QuotaPeakPagedPoolUsage: '<>ptr',
+    QuotaPagedPoolUsage: '<>ptr',
+    QuotaPeakNonPagedPoolUsage: '<>ptr',
+    QuotaNonPagedPoolUsage: '<>ptr',
+    PagefileUsage: '<>ptr',
+    PeakPagefileUsage: '<>ptr',
+});

package/lib/windows/structs.ts

@@ -27,6 +27,18 @@ export const SIZE = /* @__PURE__ */ struct('SIZE', {
     cy: 'i32',
 })
 
+/** 混合函数（4B，双架构同布局）：AlphaBlend 末参**按值**传（bind 的按值位
+ *  `<BLENDFUNCTION>`，非 `<BLENDFUNCTION>ptr`）——4B POD 聚合体在 x64 走位置寄存器、
+ *  ia32 压 4 字节，字段序须与 windows.h 逐字节一致。BlendOp 仅 AC_SRC_OVER(0)、
+ *  BlendFlags 恒 0（MSDN）；AC_SRC_ALPHA(1) 是 AlphaFormat 的值（源带 premultiplied
+ *  alpha 通道时置位）。纯入参位注册 encoder（对象直传，缺省字段跳过的零值合法）。 */
+export const BLENDFUNCTION = /* @__PURE__ */ struct('BLENDFUNCTION', {
+    BlendOp: 'u8',
+    BlendFlags: 'u8',
+    SourceConstantAlpha: 'u8',
+    AlphaFormat: 'u8',
+})
+
 /** 滚动参数（28B）：cbSize 必须 = SCROLLINFO.size（结构自描述是 Win32 要求，缺省跳过帮不了）；
  *  fMask = SIF_* 决定 Set 写哪些项 / Get 读哪些项 */
 export const SCROLLINFO = /* @__PURE__ */ struct('SCROLLINFO', {
@@ -58,6 +70,86 @@ export const LOGFONTW = /* @__PURE__ */ struct('LOGFONTW', {
     lfFaceName: 'u16[32]@utf-16le',
 })
 
+/** TEXTMETRICW（60B = 11 LONG + 4 WCHAR + 5 BYTE 尾部补齐，双架构同布局）：
+ *  GetTextMetrics 纯出参位（不注册 encoder：TEXTMETRICW.alloc().ptr 进、decode 读回） */
+export const TEXTMETRICW = /* @__PURE__ */ struct('TEXTMETRICW', {
+    tmHeight: 'i32',
+    tmAscent: 'i32',
+    tmDescent: 'i32',
+    tmInternalLeading: 'i32',
+    tmExternalLeading: 'i32',
+    tmAveCharWidth: 'i32',
+    tmMaxCharWidth: 'i32',
+    tmWeight: 'i32',
+    tmOverhang: 'i32',
+    tmDigitizedAspectX: 'i32',
+    tmDigitizedAspectY: 'i32',
+    tmFirstChar: 'u16',
+    tmLastChar: 'u16',
+    tmDefaultChar: 'u16',
+    tmBreakChar: 'u16',
+    tmItalic: 'u8',
+    tmUnderlined: 'u8',
+    tmStruckOut: 'u8',
+    tmPitchAndFamily: 'u8',
+    tmCharSet: 'u8',
+})
+
+/** WIN32_FIND_DATAW（592B 双架构同布局 = 8 头字段 44B + WCHAR[260] + WCHAR[14]，
+ *  mingw wingdi.h 的 cAlternateFileName 为 WCHAR[14] 非 MSDN 的 CHAR[14]）：
+ *  FindFirstFile/FindNextFile 纯出参位（不注册 encoder：WIN32_FIND_DATAW.alloc().ptr
+ *  进、decode 读回）。FILETIME 是 align 4 的 8B 时间，以 u64 + pack 4 忠实布局
+ *  （u64 自然 align 8 须 pack 压到 4）；时间值为 1601 起的 100ns 单元（bigint） */
+export const WIN32_FIND_DATAW = /* @__PURE__ */ struct('WIN32_FIND_DATAW', {
+    dwFileAttributes: 'u32',
+    ftCreationTime: 'u64',
+    ftLastAccessTime: 'u64',
+    ftLastWriteTime: 'u64',
+    nFileSizeHigh: 'u32',
+    nFileSizeLow: 'u32',
+    dwReserved0: 'u32',
+    dwReserved1: 'u32',
+    cFileName: 'u16[260]@utf-16le',
+    cAlternateFileName: 'u16[14]@utf-16le',
+}, { pack: 4 })
+
+/** DOC_INFO_1W（3 指针随位宽：x64 24B / ia32 12B）：StartDocPrinter 纯入参位
+ *  （注册 encoder：{ pDocName: WCHAR.encode(s).ptr, ... } 对象直传——指针字段收裸
+ *  地址 number，字符串缓冲自行 WCHAR.encode 分配并保持引用） */
+export const DOC_INFO_1W = /* @__PURE__ */ struct('DOC_INFO_1W', {
+    pDocName: '<>ptr',
+    pOutputFile: '<>ptr',
+    pDatatype: '<>ptr',
+})
+
+/** PRINTER_INFO_2W（13 指针 + 8 DWORD：x64 136B / ia32 84B，双架构已由 test_ffi raw 实测）：
+ *  EnumPrinters(Level=2) 出参数组元素。指针字段 decode 出地址 number，字符串须
+ *  逐字宽读跟进；数组 = 单缓冲读回（structArray().decode(buf, count)：元素间无空洞，
+ *  但缓冲尾部含字符串区 → byteLength 非整数倍，须显式 count）。纯出参不注册 encoder */
+export const PRINTER_INFO_2W = /* @__PURE__ */ struct('PRINTER_INFO_2W', {
+    pServerName: '<>ptr',
+    pPrinterName: '<>ptr',
+    pShareName: '<>ptr',
+    pPortName: '<>ptr',
+    pDriverName: '<>ptr',
+    pComment: '<>ptr',
+    pLocation: '<>ptr',
+    pDevMode: '<>ptr',
+    pSepFile: '<>ptr',
+    pPrintProcessor: '<>ptr',
+    pDatatype: '<>ptr',
+    pParameters: '<>ptr',
+    pSecurityDescriptor: '<>ptr',
+    Attributes: 'u32',
+    Priority: 'u32',
+    DefaultPriority: 'u32',
+    StartTime: 'u32',
+    UntilTime: 'u32',
+    Status: 'u32',
+    cJobs: 'u32',
+    AveragePPM: 'u32',
+})
+
 /** 进程启动信息（CreateProcessW 纯入参位）：指针字段随进程位宽（x86 68B / x64 104B，struct 按 os.arch 推，
  *  os.arch 是编译期进程指针宽度，WOW64 下 32 位进程得 ia32 布局）。cb 必须 = STARTUPINFOW.size
  *  （结构自描述是 Win32 要求）；dwFlags 含 STARTF_USESTDHANDLES(0x100) 时才读 hStd* */
@@ -420,3 +512,55 @@ export const OSVERSIONINFO_148 = /* @__PURE__ */ struct('OSVERSIONINFO_148', {
     dwPlatformId: 'u32',
     szCSDVersion: 'u8[128]',
 })
+
+// ── 进程快照 / 内存统计（toolhelp + psapi，布局来源官方 tlhelp32.h / psapi.h）────────
+
+/** PROCESSENTRY32W（Process32First/Next 就地迭代位；x86 556B / x64 564B——ULONG_PTR
+ *  th32DefaultHeapID 随位宽，struct 按 os.arch 推）：调用前须把 offset 0 的 dwSize 预写
+ *  成 size（MSDN：不初始化 dwSize 则 Process32First 失败）——alloc() 后
+ *  new Uint32Array(buf)[0] = PROCESSENTRY32W.size 一次；First/Next 迭代间复用同一 buf
+ *  （API 只改内容不改 dwSize），每轮 N.decode(buf) 读回 */
+export const PROCESSENTRY32W = /* @__PURE__ */ struct('PROCESSENTRY32W', {
+    dwSize: 'u32',
+    cntUsage: 'u32',
+    th32ProcessID: 'u32',
+    th32DefaultHeapID: '<>ptr',
+    th32ModuleID: 'u32',
+    cntThreads: 'u32',
+    th32ParentProcessID: 'u32',
+    pcPriClassBase: 'i32',
+    dwFlags: 'u32',
+    szExeFile: 'u16[260]@utf-16le',
+})
+
+/** MODULEENTRY32W（Module32First/Next 就地迭代位；x86 1072B / x64 1088B——BYTE* +
+ *  HMODULE 随位宽）。dwSize 预写同 PROCESSENTRY32W；modBaseAddr/hModule 仅在
+ *  th32ProcessID 的进程上下文有效；szModule 定长 256 = MAX_MODULE_NAME32+1 */
+export const MODULEENTRY32W = /* @__PURE__ */ struct('MODULEENTRY32W', {
+    dwSize: 'u32',
+    th32ModuleID: 'u32',
+    th32ProcessID: 'u32',
+    GlblcntUsage: 'u32',
+    ProccntUsage: 'u32',
+    modBaseAddr: '<>ptr',
+    modBaseSize: 'u32',
+    hModule: '<HMODULE>ptr',
+    szModule: 'u16[256]@utf-16le',
+    szExePath: 'u16[260]@utf-16le',
+})
+
+/** PROCESS_MEMORY_COUNTERS（GetProcessMemoryInfo 出参位；x86 40B / x64 72B）：官方 psapi.h
+ *  为 cb + PageFaultCount 后接 8×SIZE_T——SIZE_T 随位宽（非全 DWORD），struct 按 os.arch 推。
+ *  调用前 offset 0 的 cb 预写成 size（new Uint32Array(buf)[0] = N.size），实参 u32 cb 同传 size */
+export const PROCESS_MEMORY_COUNTERS = /* @__PURE__ */ struct('PROCESS_MEMORY_COUNTERS', {
+    cb: 'u32',
+    PageFaultCount: 'u32',
+    PeakWorkingSetSize: '<>ptr',
+    WorkingSetSize: '<>ptr',
+    QuotaPeakPagedPoolUsage: '<>ptr',
+    QuotaPagedPoolUsage: '<>ptr',
+    QuotaPeakNonPagedPoolUsage: '<>ptr',
+    QuotaNonPagedPoolUsage: '<>ptr',
+    PagefileUsage: '<>ptr',
+    PeakPagefileUsage: '<>ptr',
+})