quickwin 2.1.1 → 2.3.0

package/lib/windows/user32.js

@@ -1,4 +1,4 @@
-// user32.dll 精选高频 API（85 个），逐函数独立导出：
+// user32.dll 精选高频 API（99 个），逐函数独立导出：
 //   - 签名对照 mingw winuser.h 原型手写；未被 import 的绑定经 esbuild 摇树不进产物
 //   - WPARAM / LPARAM / LRESULT / UINT_PTR / LONG_PTR 及句柄混合值一律 <>ptr（指针宽度跨
 //     架构正确；返回值 0 保真（C→JS 不做 0→null）、有符号读对齐 C 版 JS_NewInt64——-1 哨兵等负值保真）
@@ -24,8 +24,9 @@
 //     <HGLOBAL>ptr 自产自收）
 import * as os from 'os';
 import { bind } from '../ffi/bind.js';
+import { structArray } from '../ffi/struct.js';
 // 只 import 注册了 encoder 的结构（纯入参位）；POINT 等出/就地位不注册，运行时无需引用
-import { MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js';
+import { INPUT, MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js';
 // dll 名部分应用：85 个绑定共用，签名字符串不再重复 'user32.dll'。
 // 不能用 bind.bind(null, dll)——泛型在部分应用点坍缩（返回 never）；工厂转调让
 // S/LE/LD 在调用点正常 infer。第三参透传 encoders（结构入参位注册，见头注释方向约定）。
@@ -43,7 +44,7 @@ const LONG_PTR_SYM = os.arch === 'x64' ? 'PtrW' : 'W';
  *  @param args_0 dwExStyle WS_EX_*
  *  @param args_1 lpClassName 窗口类名 string 或 NULL
  *  @param args_2 lpWindowName 窗口标题 string 或 NULL
- *  @param args_3 dwStyle WS_*（gui.WindowStyle 类常量）
+ *  @param args_3 dwStyle WS_*（WindowStyle 类常量）
  *  @param args_4 x 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_5 y 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_6 nWidth
@@ -57,7 +58,7 @@ export const CreateWindowEx = /*@__PURE__*/ b('CreateWindowExW', 'u32 <WCHAR>ptr
  *  @returns 成功 → 非 0
  *  @param args_0 hWnd */
 export const DestroyWindow = /*@__PURE__*/ b('DestroyWindow', '<HWND>ptr -> i32');
-/** 显示/隐藏窗口（nCmdShow = gui.WindowStyle 类常量）
+/** 显示/隐藏窗口（nCmdShow = WindowStyle 类常量）
  *  @returns 先前可见性
  *  @param args_0 hWnd
  *  @param args_1 nCmdShow 显示命令（SW_SHOW/SW_HIDE 等） */
@@ -300,7 +301,7 @@ export const EndPaint = /*@__PURE__*/ b('EndPaint', '<HWND>ptr <PAINTSTRUCT>ptr
  *  @param args_1 lpchText 文本 string（自动 UTF-16 编码）
  *  @param args_2 cchText 字符数（-1 = 自动算到 NUL）
  *  @param args_3 lpRect 矩形（双向不注册 encoder；CALCRECT 就地写回：RECT.encode(初值) 传 .ptr、decode 读回）
- *  @param args_4 uFormat DT_* 排版标志（gui.DrawTextFlag） */
+ *  @param args_4 uFormat DT_* 排版标志（DrawTextFlag） */
 export const DrawText = /*@__PURE__*/ b('DrawTextW', '<HDC>ptr! <WCHAR>ptr i32 <RECT>ptr i32 -> i32');
 /** 用画刷填充矩形
  *  @returns 填充高度
@@ -394,6 +395,17 @@ export const GetKeyboardState = /*@__PURE__*/ b('GetKeyboardState', '<BYTE>ptr -
  *  @returns SHORT（低字节 VK、高位 shift/ctrl/alt 掩码），无 → -1
  *  @param args_0 ch 字符码（如 65 = 'A'） */
 export const VkKeyScan = /*@__PURE__*/ b('VkKeyScanW', 'u32 -> i32');
+// INPUT 数组 encoder（SendInput 的 <INPUT>ptr 位注册后值域即元素数组——与 gdi32
+// POINTArr 同机制，token/引擎层零数组概念）
+const INPUTArr = /*@__PURE__*/ structArray(INPUT);
+/** 批量注入输入事件（一次调用 = cInputs 个 INPUT 紧密数组 = 一个原子输入块）
+ *  @returns 成功注入的事件数；0 = 全部失败（UIPI：目标进程完整性更高），< cInputs = 部分成功
+ *  @param args_0 events INPUT 元素数组（structArray(INPUT) encoder 直传
+ *   [{type:0|1, data:{mi|ki:{...}}}]；绝对坐标 dx/dy 是 0-65535 归一化物理像素——本引擎
+ *   SetProcessDPIAware，GetSystemMetrics/GetWindowRect 同空间，换算 x*65535/(SM_CXSCREEN-1)）
+ *  @param args_1 cbSize 传 INPUT.size（MSDN 要求 = sizeof(INPUT)，x86 28 / x64 40，
+ *   传错整体静默失败） */
+export const SendInput = /*@__PURE__*/ b('SendInput', 'u32 <INPUT>ptr i32 -> u32', { INPUT: INPUTArr });
 // ============ 计时器 ============
 /** 设定时器（hWnd/id 传 NULL/0 = 自动分配 id；lpTimerFunc 传 NULL 用 WM_TIMER）
  *  @returns 定时器 ID（自动分配时从返回值读回）；失败 → 0
@@ -520,7 +532,7 @@ export const ShowScrollBar = /*@__PURE__*/ b('ShowScrollBar', '<HWND>ptr u32 i32
  *  @param args_3 uType MB_* 样式（MB_OK/MB_YESNO 等） */
 export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <WCHAR>ptr u32 -> i32');
 // ============ 图像 ============
-/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 gui.ImageType 枚举当前值
+/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
  *  @returns 图像句柄；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件

package/lib/windows/user32.ts

@@ -1,4 +1,4 @@
-// user32.dll 精选高频 API（85 个），逐函数独立导出：
+// user32.dll 精选高频 API（99 个），逐函数独立导出：
 //   - 签名对照 mingw winuser.h 原型手写；未被 import 的绑定经 esbuild 摇树不进产物
 //   - WPARAM / LPARAM / LRESULT / UINT_PTR / LONG_PTR 及句柄混合值一律 <>ptr（指针宽度跨
 //     架构正确；返回值 0 保真（C→JS 不做 0→null）、有符号读对齐 C 版 JS_NewInt64——-1 哨兵等负值保真）
@@ -24,8 +24,9 @@
 //     <HGLOBAL>ptr 自产自收）
 import * as os from 'os'
 import { bind, type CodecMap } from '../ffi/bind.js'
+import { structArray } from '../ffi/struct.js'
 // 只 import 注册了 encoder 的结构（纯入参位）；POINT 等出/就地位不注册，运行时无需引用
-import { MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js'
+import { INPUT, MSG, RECT, SCROLLINFO, WNDCLASSEXW } from './structs.js'
 
 // dll 名部分应用：85 个绑定共用，签名字符串不再重复 'user32.dll'。
 // 不能用 bind.bind(null, dll)——泛型在部分应用点坍缩（返回 never）；工厂转调让
@@ -48,7 +49,7 @@ const LONG_PTR_SYM = os.arch === 'x64' ? 'PtrW' : 'W'
  *  @param args_0 dwExStyle WS_EX_*
  *  @param args_1 lpClassName 窗口类名 string 或 NULL
  *  @param args_2 lpWindowName 窗口标题 string 或 NULL
- *  @param args_3 dwStyle WS_*（gui.WindowStyle 类常量）
+ *  @param args_3 dwStyle WS_*（WindowStyle 类常量）
  *  @param args_4 x 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_5 y 初始左上角（CW_USEDEFAULT = -1）
  *  @param args_6 nWidth
@@ -63,7 +64,7 @@ export const CreateWindowEx = /*@__PURE__*/ b('CreateWindowExW',
  *  @returns 成功 → 非 0
  *  @param args_0 hWnd */
 export const DestroyWindow = /*@__PURE__*/ b('DestroyWindow', '<HWND>ptr -> i32')
-/** 显示/隐藏窗口（nCmdShow = gui.WindowStyle 类常量）
+/** 显示/隐藏窗口（nCmdShow = WindowStyle 类常量）
  *  @returns 先前可见性
  *  @param args_0 hWnd
  *  @param args_1 nCmdShow 显示命令（SW_SHOW/SW_HIDE 等） */
@@ -313,7 +314,7 @@ export const EndPaint = /*@__PURE__*/ b('EndPaint', '<HWND>ptr <PAINTSTRUCT>ptr
  *  @param args_1 lpchText 文本 string（自动 UTF-16 编码）
  *  @param args_2 cchText 字符数（-1 = 自动算到 NUL）
  *  @param args_3 lpRect 矩形（双向不注册 encoder；CALCRECT 就地写回：RECT.encode(初值) 传 .ptr、decode 读回）
- *  @param args_4 uFormat DT_* 排版标志（gui.DrawTextFlag） */
+ *  @param args_4 uFormat DT_* 排版标志（DrawTextFlag） */
 export const DrawText = /*@__PURE__*/ b('DrawTextW', '<HDC>ptr! <WCHAR>ptr i32 <RECT>ptr i32 -> i32')
 /** 用画刷填充矩形
  *  @returns 填充高度
@@ -413,6 +414,17 @@ export const GetKeyboardState = /*@__PURE__*/ b('GetKeyboardState', '<BYTE>ptr -
  *  @returns SHORT（低字节 VK、高位 shift/ctrl/alt 掩码），无 → -1
  *  @param args_0 ch 字符码（如 65 = 'A'） */
 export const VkKeyScan = /*@__PURE__*/ b('VkKeyScanW', 'u32 -> i32')
+// INPUT 数组 encoder（SendInput 的 <INPUT>ptr 位注册后值域即元素数组——与 gdi32
+// POINTArr 同机制，token/引擎层零数组概念）
+const INPUTArr = /*@__PURE__*/ structArray(INPUT)
+/** 批量注入输入事件（一次调用 = cInputs 个 INPUT 紧密数组 = 一个原子输入块）
+ *  @returns 成功注入的事件数；0 = 全部失败（UIPI：目标进程完整性更高），< cInputs = 部分成功
+ *  @param args_0 events INPUT 元素数组（structArray(INPUT) encoder 直传
+ *   [{type:0|1, data:{mi|ki:{...}}}]；绝对坐标 dx/dy 是 0-65535 归一化物理像素——本引擎
+ *   SetProcessDPIAware，GetSystemMetrics/GetWindowRect 同空间，换算 x*65535/(SM_CXSCREEN-1)）
+ *  @param args_1 cbSize 传 INPUT.size（MSDN 要求 = sizeof(INPUT)，x86 28 / x64 40，
+ *   传错整体静默失败） */
+export const SendInput = /*@__PURE__*/ b('SendInput', 'u32 <INPUT>ptr i32 -> u32', { INPUT: INPUTArr })
 
 // ============ 计时器 ============
 
@@ -551,7 +563,7 @@ export const MessageBox = /*@__PURE__*/ b('MessageBoxW', '<HWND>ptr <WCHAR>ptr <
 
 // ============ 图像 ============
 
-/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 gui.ImageType 枚举当前值
+/** 按名加载图像（string 自动编码；uType/fuLoad 用 Win32 真值——与 ImageType 枚举当前值
  *  不同）
  *  @returns 图像句柄；失败 → 0
  *  @param args_0 hinst 模块句柄，NULL = 系统资源或 .ico 文件

package/lib/windows/winspool.js

@@ -14,7 +14,7 @@ const b = (name, sig, encoders) => bind('winspool.drv', name, sig, encoders);
 /** 枚举打印队列（Level=2 → PRINTER_INFO_2W 数组）；两段式：先
  *  NULL+cbBuf 0 拿 pcbNeeded，再按需分配缓冲重调
  *  @returns 成功 → 非 0
- *  @param args_0 dwFlags 枚举范围：gui.PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
+ *  @param args_0 dwFlags 枚举范围：PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
  *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
  *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
  *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
@@ -28,12 +28,12 @@ export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW', 'u32 <WCHAR>ptr u32
  *  @param args_0 pszBuffer 出参缓冲，WCHAR.alloc(n)、WCHAR.decode 读回
  *  @param args_1 pcchBuffer 出入长度槽（入 = 缓冲 WCHAR 容量，出 = 实际长度），PtrArrayBuffer(4) */
 export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>ptr <BYTE>ptr -> i32');
-/** 查设备能力；nCapability 单选 gui.DeviceCap.*
+/** 查设备能力；nCapability 单选 DeviceCap.*
  *  @returns 返回值随能力（数值能力 = 数值，
  *  -1 = 失败）
  *  @param args_0 pDevice 打印机名（禁空）
  *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
- *  @param args_2 nCapability 能力码（gui.DeviceCap.HORZRES 等单选）
+ *  @param args_2 nCapability 能力码（DeviceCap.HORZRES 等单选）
  *  @param args_3 pOutput 字符串列表型能力的缓冲；数值型查询传 NULL
  *  @param args_4 pDevmode DEVMODE，传 NULL */
 export const DeviceCapabilities = /*@__PURE__*/ b('DeviceCapabilitiesW', '<WCHAR>ptr! <WCHAR>ptr u32@DeviceCap <BYTE>ptr <>ptr -> i32');

package/lib/windows/winspool.ts

@@ -17,7 +17,7 @@ const b = <const S extends string, const LE extends CodecMap = {}>(name: string,
 /** 枚举打印队列（Level=2 → PRINTER_INFO_2W 数组）；两段式：先
  *  NULL+cbBuf 0 拿 pcbNeeded，再按需分配缓冲重调
  *  @returns 成功 → 非 0
- *  @param args_0 dwFlags 枚举范围：gui.PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
+ *  @param args_0 dwFlags 枚举范围：PrinterEnum.LOCAL(0x2) 本地 | CONNECTIONS(0x4)
  *                已连接，组合 OR 传裸数（可组合 flags 不标枚举）
  *  @param args_1 pName 服务器名（仅 Level=4/5/6 用），本地枚举传 NULL
  *  @param args_2 dwLevel 信息级别，取 2（PRINTER_INFO_2W）
@@ -34,12 +34,12 @@ export const EnumPrinters = /*@__PURE__*/ b('EnumPrintersW',
  *  @param args_1 pcchBuffer 出入长度槽（入 = 缓冲 WCHAR 容量，出 = 实际长度），PtrArrayBuffer(4) */
 export const GetDefaultPrinter = /*@__PURE__*/ b('GetDefaultPrinterW', '<BYTE>ptr <BYTE>ptr -> i32')
 
-/** 查设备能力；nCapability 单选 gui.DeviceCap.*
+/** 查设备能力；nCapability 单选 DeviceCap.*
  *  @returns 返回值随能力（数值能力 = 数值，
  *  -1 = 失败）
  *  @param args_0 pDevice 打印机名（禁空）
  *  @param args_1 pPort 端口名，传 NULL 用打印机配置端口
- *  @param args_2 nCapability 能力码（gui.DeviceCap.HORZRES 等单选）
+ *  @param args_2 nCapability 能力码（DeviceCap.HORZRES 等单选）
  *  @param args_3 pOutput 字符串列表型能力的缓冲；数值型查询传 NULL
  *  @param args_4 pDevmode DEVMODE，传 NULL */
 export const DeviceCapabilities = /*@__PURE__*/ b('DeviceCapabilitiesW',

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "quickwin",
-  "version": "2.1.1",
+  "version": "2.3.0",
   "description": "QuickJS Win32 runtime — GUI, networking, WASM, FFI, and more",
   "bin": {
     "quickwin": "qwin.exe",
@@ -24,7 +24,8 @@
     "examples/",
     "vendor/",
     "quickwin.d.ts",
-    "quickwin_const.d.ts",
+    "constants.ts",
+    "enum_map.d.ts",
     "tsconfig.json",
     "README.md",
     "README.en.md"
@@ -32,7 +33,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/xna00/quickwin.git"
+    "url": "git+https://github.com/quickwinlabs/quickwin.git"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",

package/quickwin.d.ts

@@ -1,5 +1,4 @@
-/// <reference path="quickwin_const.d.ts" />
-/// <reference path="quickwin_enum_map.d.ts" />
+/// <reference path="enum_map.d.ts" />
 interface ImportMeta {
     url: string
 }
@@ -348,6 +347,12 @@ declare module "os" {
 declare module "sock" {
     type SockHandle = number & { readonly __brand: unique symbol };
     type SockFd = number & { readonly __brand: unique symbol };
+    // 枚举唯一定义在 constants.ts（真实 .ts，tsc/esbuild 均内联）；此处别名仅供签名引用，
+    // 使用方请直接 import { AddrFamily } from 'quickwin/constants'。
+    type AddrFamily = import('./constants').AddrFamily;
+    type SockType = import('./constants').SockType;
+    type Protocol = import('./constants').Protocol;
+    type Shutdown = import('./constants').Shutdown;
 
     function socket(domain?: AddrFamily, type?: SockType, protocol?: Protocol): SockHandle;
     function connect(sock: SockHandle, addr: string, port: number): number;
@@ -374,6 +379,10 @@ declare module "wolfssl" {
     type WOLFSSL = number & { readonly __brand: unique symbol };
     type WOLFSSL_CTX = number & { readonly __brand: unique symbol };
     type WOLFSSL_METHOD = number & { readonly __brand: unique symbol };
+    // 枚举唯一定义在 constants.ts（见 sock 块注释）。
+    type VerifyMode = import('./constants').VerifyMode;
+    type SniType = import('./constants').SniType;
+    type FileType = import('./constants').FileType;
 
     function wolfSSL_library_init(): number;
     function wolfSSL_CTX_new(method: WOLFSSL_METHOD): WOLFSSL_CTX | null;
@@ -433,6 +442,18 @@ declare module "gui" {
     type HFONT = number & { readonly ptrBrand: "HFONT" };
     type HICON = number & { readonly ptrBrand: "HICON" };
     type WNDPROC = number & { readonly ptrBrand: "WNDPROC" };
+    // 枚举唯一定义在 constants.ts（真实 .ts，tsc/esbuild 均内联）；此处别名仅供签名引用，
+    // 使用方请直接 import { WindowStyle } from 'quickwin/constants'。
+    // Gwlp/ImageType 的成员访问（如 Gwlp.WNDPROC）需写 import('./constants').Gwlp.WNDPROC
+    // ——类型别名不建命名空间，无法穿透取成员。
+    type GetWindowCmd = import('./constants').GetWindowCmd;
+    type ShowWindowCmd = import('./constants').ShowWindowCmd;
+    type SetWindowPosHwnd = import('./constants').SetWindowPosHwnd;
+    type Gwlp = import('./constants').Gwlp;
+    type NotifyIconCmd = import('./constants').NotifyIconCmd;
+    type ImageType = import('./constants').ImageType;
+    type IDI = import('./constants').IDI;
+    type ScrollBar = import('./constants').ScrollBar;
 
     function RegisterClass(className: string, wndProc?: (hwnd: HWND, msg: number, wParam: number, lParam: number) => number): number;
     function CreateWindow(className: string, title: string, style: number, x: number, y: number, width: number, height: number, parent: HWND | null, menu: HMENU | null): HWND | null;
@@ -450,7 +471,7 @@ declare module "gui" {
     function GetWindowText(hwnd: HWND): string;
     function GetScaleFactor(): number;
     function CreateSystemDpiFont(): HFONT | null;
-    type GwlpReturnType<T extends Gwlp> = T extends Gwlp.WNDPROC ? WNDPROC : number;
+    type GwlpReturnType<T extends Gwlp> = T extends import('./constants').Gwlp.WNDPROC ? WNDPROC : number;
     function GetWindowLongPtr<T extends Gwlp>(hwnd: HWND, nIndex: T): GwlpReturnType<T>;
     function SetWindowLongPtr(hwnd: HWND, nIndex: Gwlp, newLong: number): number;
     function UnsetWindowProc(hwnd: HWND): boolean;
@@ -475,20 +496,21 @@ declare module "gui" {
      * Thin wrapper around LoadImageW. Parameter order matches Win32 LoadImageW: (hinst, name, uType?, cx?, cy?, fuLoad?).
      * hinst: null for system resources/file path, number for module handle;
      * name: when hinst=null, a system icon IDI or .ico file path; when hinst=module handle, a resource ID (number) or resource name (string);
-     * uType: gui.ImageType constant, default IMAGE_ICON (returns HICON), pass BITMAP/CURSOR for number return;
-     * cx/cy: target size (0 for default, use gui.LoadImageFlag.DEFAULTSIZE for system default size);
-     * fuLoad: gui.LoadImageFlag constants. Note: loading system icons (IDI_*, hinst=null) requires gui.LoadImageFlag.SHARED.
-     * Example: gui.LoadImage(null, "app.ico", gui.ImageType.ICON, 32, 32, gui.LoadImageFlag.LOADFROMFILE)
-     *          gui.LoadImage(null, gui.IDI.APPLICATION, gui.ImageType.ICON, 0, 0, gui.LoadImageFlag.SHARED)
+     * uType: ImageType constant, default IMAGE_ICON (returns HICON), pass BITMAP/CURSOR for number return;
+     * cx/cy: target size (0 for default, use LoadImageFlag.DEFAULTSIZE for system default size);
+     * fuLoad: LoadImageFlag constants. Note: loading system icons (IDI_*, hinst=null) requires LoadImageFlag.SHARED.
+     * Example: import { IDI, ImageType, LoadImageFlag } from 'quickwin/constants'
+     *          gui.LoadImage(null, "app.ico", ImageType.ICON, 32, 32, LoadImageFlag.LOADFROMFILE)
+     *          gui.LoadImage(null, IDI.APPLICATION, ImageType.ICON, 0, 0, LoadImageFlag.SHARED)
      */
-    function LoadImage<H extends (import("win").HMODULE) | null, T extends ImageType = ImageType.ICON>(
+    function LoadImage<H extends (import("win").HMODULE) | null, T extends ImageType = import('./constants').ImageType.ICON>(
         hinst: H,
         name: H extends null ? string | IDI : string | number,
         uType?: T,
         cx?: number,
         cy?: number,
         fuLoad?: number
-    ): T extends ImageType.ICON ? HICON | null : number | null;
+    ): T extends import('./constants').ImageType.ICON ? HICON | null : number | null;
     /**
      * Loads the first icon group (RT_GROUP_ICON) from this exe, i.e. the custom icon
      * embedded by rcedit. Works with any resource ID including 0. Returns null if the

package/test/test_ffi_bind.js

@@ -88,7 +88,7 @@ export const suite = {
         const rect = new PtrArrayBuffer(16);
         const dv = new DataView(rect);
         dv.setInt32(8, 500, true);
-        const lines = user32.DrawTextW(dc, 'hello ffi-bind', -1, rect, 1024 /* gui.DrawTextFlag.CALCRECT */);
+        const lines = user32.DrawTextW(dc, 'hello ffi-bind', -1, rect, 1024 /* DrawTextFlag.CALCRECT */);
         t.checkTrue('DrawTextW returns line count > 0', lines > 0);
         t.checkTrue('measured width > 0', dv.getInt32(8, true) > 0);
         t.checkTrue('measured height > 0', dv.getInt32(12, true) > 0);
@@ -238,13 +238,15 @@ export const suite = {
         if (brushL)
             t.checkTrue('bindLib DeleteObject succeeds', gdi32Lib.DeleteObject(brushL) !== 0);
         // 嵌套 struct（LOGPEN 内含 POINT）验证 ShapeOf 递归 + 子结构写入
-        const POINT = struct('POINT', {
+        const POINT_DECL = {
+            '#': 'struct',
             x: 'i32',
             y: 'i32',
-        });
+        };
+        const POINT = /* @__PURE__ */ struct('POINT', POINT_DECL);
         const LOGPEN = struct('LOGPEN', {
             lopnStyle: 'u32',
-            lopnWidth: POINT.__struct,
+            lopnWidth: POINT_DECL,
             lopnColor: 'u32',
         });
         const createPenIndirect = bind('gdi32.dll', 'CreatePenIndirect', '<LOGPEN>ptr -> <>ptr', { LOGPEN });
@@ -527,7 +529,7 @@ export const suite = {
             t.check('closure 返回 ! 非零：正常写槽', 0x3000, readScalar(new DataView(rr3), 0, 'ptr'));
             nnRet.dispose();
             // 返回位负例：fn 返回 0 → printf 诊断 + 不写槽；C 侧 retbuf 初值恒零
-            // （quickjs-ffi-closure.c zero8 拷贝），终值 0 与「写了 0」不可分——
+            // （src/quickjs-ffi-closure.c zero8 拷贝），终值 0 与「写了 0」不可分——
             // 值层面只验分发不炸、槽保持 0（诊断走 stdout，见上方 printf）。
             const nnRet0 = closure('i32 -> <>ptr!', (_n) => 0);
             const rr4 = new ArrayBuffer(8);
@@ -585,9 +587,9 @@ export const suite = {
         const drawText = bind('user32.dll', 'DrawTextW', '<>ptr! <WCHAR>ptr i32 <BYTE>ptr i32 -> i32');
         const dtRect = new PtrArrayBuffer(16);
         if (dcScreen) {
-            t.checkTrue('DrawTextW 非空 DC 通过 ! 参数位', drawText(dcScreen, 'hi !', -1, dtRect, 1024 /* gui.DrawTextFlag.CALCRECT */) > 0);
+            t.checkTrue('DrawTextW 非空 DC 通过 ! 参数位', drawText(dcScreen, 'hi !', -1, dtRect, 1024 /* DrawTextFlag.CALCRECT */) > 0);
             try {
-                drawText(0, 'hi !', -1, dtRect, 1024 /* gui.DrawTextFlag.CALCRECT */);
+                drawText(0, 'hi !', -1, dtRect, 1024 /* DrawTextFlag.CALCRECT */);
                 t.checkTrue('DrawTextW NULL DC 标 ! 后应 throw', false);
             }
             catch (e) {
@@ -642,13 +644,13 @@ export const suite = {
         if (false) {
             const sw = bind('user32.dll', 'ShowWindow', '<X>ptr i32@ShowWindowCmd -> i32');
             const sp = bind('user32.dll', 'SetWindowPos', '<X>ptr <>ptr@SetWindowPosHwnd i32 i32 i32 i32 u32 -> i32');
-            sw(NULL, 5 /* gui.ShowWindowCmd.SHOW */); // 枚举成员
+            sw(NULL, 5 /* ShowWindowCmd.SHOW */); // 枚举成员
             sw(NULL, 5); // 域内字面量（5 = SW_SHOW）
-            sp(NULL, 0 /* gui.SetWindowPosHwnd.TOP */, 0, 0, 0, 0, 1 /* gui.SetWindowPosFlag.SWP_NOSIZE */);
+            sp(NULL, 0 /* SetWindowPosHwnd.TOP */, 0, 0, 0, 0, 1 /* SetWindowPosFlag.SWP_NOSIZE */);
             // @ts-expect-error 域外字面量被拦（11152 不是任何 ShowWindow 命令）
             sw(NULL, 0x2B90);
             // @ts-expect-error 跨枚举误用：HWND_TOP/TOPMOST 不是 ShowWindow 命令
-            sw(NULL, 0 /* gui.SetWindowPosHwnd.TOP */);
+            sw(NULL, 0 /* SetWindowPosHwnd.TOP */);
         }
     },
 };

package/test/test_ffi_bind.ts

@@ -1,11 +1,11 @@
 import * as std from 'std'
-import * as gui from 'gui'
 import * as ffi from 'ffi'
 import * as os from 'os'
 import { Tester } from './test_helper.js'
 import { bind, bindLib, closure, WCHAR, BYTE, type CodecMap } from '../lib/ffi/bind.js'
 import { struct } from '../lib/ffi/struct.js'
-import { NULL, type MaybePtr, Ptr, PtrArrayBuffer, readScalar, writeScalar, PTR_SIZE, normToken } from '../lib/ffi/ctype.js'
+import { NULL, type C_Struct, type MaybePtr, Ptr, PtrArrayBuffer, readScalar, writeScalar, PTR_SIZE, normToken } from '../lib/ffi/ctype.js'
+import { DrawTextFlag, SetWindowPosFlag, SetWindowPosHwnd, ShowWindowCmd } from '../constants'
 
 // 编译期断言工具（仅类型层，运行时无开销）
 type Equal<A, B> = (<G>() => G extends A ? 1 : 2) extends (<G>() => G extends B ? 1 : 2) ? true : false
@@ -86,7 +86,7 @@ export const suite = {
         const rect = new PtrArrayBuffer(16)
         const dv = new DataView(rect)
         dv.setInt32(8, 500, true)
-        const lines = user32.DrawTextW(dc, 'hello ffi-bind', -1, rect, gui.DrawTextFlag.CALCRECT)
+        const lines = user32.DrawTextW(dc, 'hello ffi-bind', -1, rect, DrawTextFlag.CALCRECT)
         t.checkTrue('DrawTextW returns line count > 0', lines > 0)
         t.checkTrue('measured width > 0', dv.getInt32(8, true) > 0)
         t.checkTrue('measured height > 0', dv.getInt32(12, true) > 0)
@@ -238,13 +238,15 @@ export const suite = {
         if (brushL) t.checkTrue('bindLib DeleteObject succeeds', gdi32Lib.DeleteObject(brushL) !== 0)
 
         // 嵌套 struct（LOGPEN 内含 POINT）验证 ShapeOf 递归 + 子结构写入
-        const POINT = struct('POINT', {
+        const POINT_DECL = {
+            '#': 'struct',
             x: 'i32',
             y: 'i32',
-        })
+        } satisfies C_Struct
+        const POINT = /* @__PURE__ */ struct('POINT', POINT_DECL)
         const LOGPEN = struct('LOGPEN', {
             lopnStyle: 'u32',
-            lopnWidth: POINT.__struct,
+            lopnWidth: POINT_DECL,
             lopnColor: 'u32',
         })
         const createPenIndirect = bind('gdi32.dll', 'CreatePenIndirect', '<LOGPEN>ptr -> <>ptr', { LOGPEN })
@@ -539,7 +541,7 @@ export const suite = {
             t.check('closure 返回 ! 非零：正常写槽', 0x3000, readScalar(new DataView(rr3), 0, 'ptr'))
             nnRet.dispose()
             // 返回位负例：fn 返回 0 → printf 诊断 + 不写槽；C 侧 retbuf 初值恒零
-            // （quickjs-ffi-closure.c zero8 拷贝），终值 0 与「写了 0」不可分——
+            // （src/quickjs-ffi-closure.c zero8 拷贝），终值 0 与「写了 0」不可分——
             // 值层面只验分发不炸、槽保持 0（诊断走 stdout，见上方 printf）。
             const nnRet0 = closure('i32 -> <>ptr!', (_n) => 0)
             const rr4 = new ArrayBuffer(8)
@@ -600,9 +602,9 @@ export const suite = {
         const dtRect = new PtrArrayBuffer(16)
         if (dcScreen) {
             t.checkTrue('DrawTextW 非空 DC 通过 ! 参数位',
-                drawText(dcScreen, 'hi !', -1, dtRect, gui.DrawTextFlag.CALCRECT) > 0)
+                drawText(dcScreen, 'hi !', -1, dtRect, DrawTextFlag.CALCRECT) > 0)
             try {
-                drawText(0, 'hi !', -1, dtRect, gui.DrawTextFlag.CALCRECT)
+                drawText(0, 'hi !', -1, dtRect, DrawTextFlag.CALCRECT)
                 t.checkTrue('DrawTextW NULL DC 标 ! 后应 throw', false)
             } catch (e) { t.checkTrue('! 参数位（第 1 位）throw 指明 arg#1', String(e).includes('arg#1')) }
         }
@@ -656,13 +658,13 @@ export const suite = {
         if (false) {
             const sw = bind('user32.dll', 'ShowWindow', '<X>ptr i32@ShowWindowCmd -> i32')
             const sp = bind('user32.dll', 'SetWindowPos', '<X>ptr <>ptr@SetWindowPosHwnd i32 i32 i32 i32 u32 -> i32')
-            sw(NULL, gui.ShowWindowCmd.SHOW)  // 枚举成员
+            sw(NULL, ShowWindowCmd.SHOW)  // 枚举成员
             sw(NULL, 5)                       // 域内字面量（5 = SW_SHOW）
-            sp(NULL, gui.SetWindowPosHwnd.TOP, 0, 0, 0, 0, gui.SetWindowPosFlag.SWP_NOSIZE)
+            sp(NULL, SetWindowPosHwnd.TOP, 0, 0, 0, 0, SetWindowPosFlag.SWP_NOSIZE)
             // @ts-expect-error 域外字面量被拦（11152 不是任何 ShowWindow 命令）
             sw(NULL, 0x2B90)
             // @ts-expect-error 跨枚举误用：HWND_TOP/TOPMOST 不是 ShowWindow 命令
-            sw(NULL, gui.SetWindowPosHwnd.TOP)
+            sw(NULL, SetWindowPosHwnd.TOP)
         }
     },
 }