quickwin 2.2.0 → 2.3.0

package/lib/windows/structs.ts

@@ -1,5 +1,5 @@
 import { struct } from '../ffi/struct.js'
-import type { C_Struct } from '../ffi/ctype.js'
+import type { C_Struct, C_Union } from '../ffi/ctype.js'
 
 // 全仓库 Win32 结构的集中定义点（CType IR，按本机架构 MSVC 对齐；这批全为定长标量/字符串，
 // ia32/x64 同布局）。形参位方向约定见 lib/windows/user32.ts 头注释：
@@ -688,3 +688,65 @@ export const PROCESS_MEMORY_COUNTERS_DECL = {
 } satisfies C_Struct
 
 export const PROCESS_MEMORY_COUNTERS = /* @__PURE__ */ struct('PROCESS_MEMORY_COUNTERS', PROCESS_MEMORY_COUNTERS_DECL)
+
+/** MOUSEINPUT（SendInput 鼠标事件体；x86 24B / x64 32B——dwExtraInfo 是 ULONG_PTR，
+ *  随位宽）。dx/dy 相对位移，或 dwFlags 带 MOUSEEVENTF_ABSOLUTE 时为 0-65535 归一化
+ *  物理像素（本引擎 SetProcessDPIAware，见 src/main.c，全坐标 API 同空间）；
+ *  mouseData 滚轮增量（±120）或 X 系按钮编号（XBUTTON1/2） */
+export const MOUSEINPUT_DECL = {
+    '#': 'struct',
+    dx: 'i32',
+    dy: 'i32',
+    mouseData: 'u32',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+} satisfies C_Struct
+
+export const MOUSEINPUT = /* @__PURE__ */ struct('MOUSEINPUT', MOUSEINPUT_DECL)
+
+/** KEYBDINPUT（SendInput 键盘事件体；x86 16B / x64 24B）：wVk 虚拟键码，
+ *  dwFlags 带 KEYEVENTF_UNICODE 时 wScan = 字符码 */
+export const KEYBDINPUT_DECL = {
+    '#': 'struct',
+    wVk: 'u16',
+    wScan: 'u16',
+    dwFlags: 'u32',
+    time: 'u32',
+    dwExtraInfo: '<>ptr',
+} satisfies C_Struct
+
+export const KEYBDINPUT = /* @__PURE__ */ struct('KEYBDINPUT', KEYBDINPUT_DECL)
+
+/** INPUT（SendInput 元素；x86 28B / x64 40B）：type（INPUT_MOUSE=0 / INPUT_KEYBOARD=1）
+ *  + 三选一 union——C 的 DUMMYUNIONNAME 匿名成员在此命名嵌套（encode 形
+ *  {type, data:{mi|ki:{...}}}）。union 随 MOUSEINPUT 的 ULONG_PTR 位宽，x64 下 type 后
+ *  自动补 4B padding 使 union 8 对齐（MSVC 布局）。HARDWAREINPUT 不注入，省略不改
+ *  尺寸（union 尺寸 = max 成员 = MOUSEINPUT）。dwExtraInfo 是 ULONG_PTR 信息位（非句柄）
+ *  → <>ptr 裸档（uintptr 双态先例：WPARAM/LPARAM/void*），恒传 0 */
+export const INPUT_DECL = {
+    '#': 'struct',
+    type: 'u32',
+    data: {
+        '#': 'union',
+        mi: MOUSEINPUT_DECL,
+        ki: KEYBDINPUT_DECL,
+    } satisfies C_Union,
+} satisfies C_Struct
+
+export const INPUT = /* @__PURE__ */ struct('INPUT', INPUT_DECL)
+
+/** NOTIFYICONIDENTIFIER（Shell_NotifyIconGetRect 定位托盘通知图标；x86 28B / x64 40B——
+ *  hWnd 是 HWND 随位宽，guidItem = GUID 固定 16B 不随）。定位二法取一：guidItem 非全 0
+ *  时忽略 hWnd/uID，否则走 hWnd+uID（deskmon 等自注册图标即此形，与 Shell_NotifyIcon
+ *  的 {hwnd,uID} 同源）；guidItem 缺省 = GUID_NULL 走 hWnd+uID。cbSize 调用前填
+ *  NOTIFYICONIDENTIFIER.size（cb 结构惯例，见 PROCESS_MEMORY_COUNTERS 同） */
+export const NOTIFYICONIDENTIFIER_DECL = {
+    '#': 'struct',
+    cbSize: 'u32',
+    hWnd: '<HWND>ptr',
+    uID: 'u32',
+    guidItem: 'u32[4]',
+} satisfies C_Struct
+
+export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL)

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.2.0",
+  "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);
@@ -529,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);
@@ -587,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) {
@@ -644,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 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)
@@ -541,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)
@@ -602,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')) }
         }
@@ -658,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)
         }
     },
 }

package/test/test_ffi_struct.js

@@ -724,14 +724,14 @@ export const suite = {
             t.check('数字位 @ 字段归一往返', 4, dev.key);
             // encode 必填判定：0 ∉ 值域的 @ 字段必填（省略 = 新槽写 0 = 静默违约）；
             // 0 ∈ 值域可省。下面 { key } 行能编译即 msg/hp 可省的断言。
-            EV.encode({ key: 4 /* gui.MouseKeyFlag.MK_SHIFT */ });
+            EV.encode({ key: 4 /* MouseKeyFlag.MK_SHIFT */ });
             // @ts-expect-error key 必填：省略即编译错（0 ∉ MouseKeyFlag）
             EV.encode({ msg: 0 });
             if (false) {
                 // @ts-expect-error 域外字面量（3 不是任何 MK_ 标志）
                 EV.encode({ key: 3 });
                 // @ts-expect-error 跨枚举误用（WmMsg 成员不是 MouseKeyFlag）
-                EV.encode({ key: 1 /* gui.WmMsg.CREATE */ });
+                EV.encode({ key: 1 /* WmMsg.CREATE */ });
             }
             // 数组糖元素带 @：lower 递归归一（normToken 剥 @）+ 元素值域
             const EA = struct('EA', { msgs: 'u32@WmMsg[4]' });

package/test/test_ffi_struct.ts

@@ -1,10 +1,10 @@
 import * as os from 'os'
-import * as gui from 'gui'
 import { Tester } from './test_helper.js'
 import { struct, union } from '../lib/ffi/struct.js'
 import { bind, } from '../lib/ffi/bind.js'
 import { type MaybePtr, Ptr, PtrArrayBuffer } from '../lib/ffi/ctype.js'
 import type { C_Struct, C_Union } from '../lib/ffi/ctype.js'
+import { MouseKeyFlag, WmMsg } from '../constants'
 
 // 编译期断言工具（仅类型层，运行时无开销）
 type Equal<A, B> = (<G>() => G extends A ? 1 : 2) extends (<G>() => G extends B ? 1 : 2) ? true : false
@@ -769,14 +769,14 @@ export const suite = {
 
             // encode 必填判定：0 ∉ 值域的 @ 字段必填（省略 = 新槽写 0 = 静默违约）；
             // 0 ∈ 值域可省。下面 { key } 行能编译即 msg/hp 可省的断言。
-            EV.encode({ key: gui.MouseKeyFlag.MK_SHIFT })
+            EV.encode({ key: MouseKeyFlag.MK_SHIFT })
             // @ts-expect-error key 必填：省略即编译错（0 ∉ MouseKeyFlag）
             EV.encode({ msg: 0 })
             if (false) {
                 // @ts-expect-error 域外字面量（3 不是任何 MK_ 标志）
                 EV.encode({ key: 3 })
                 // @ts-expect-error 跨枚举误用（WmMsg 成员不是 MouseKeyFlag）
-                EV.encode({ key: gui.WmMsg.CREATE })
+                EV.encode({ key: WmMsg.CREATE })
             }
 
             // 数组糖元素带 @：lower 递归归一（normToken 剥 @）+ 元素值域

package/test/test_ffi_windows.js

@@ -74,7 +74,7 @@ export const suite = {
         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 当前值与此不一致）
+        // Win32 IMAGE_* 真值：BITMAP=0 CURSOR=1 ICON=2；LR_SHARED=0x8000（注意 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）');

package/test/test_ffi_windows.ts

@@ -83,7 +83,7 @@ export const suite = {
         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 当前值与此不一致）
+        // Win32 IMAGE_* 真值：BITMAP=0 CURSOR=1 ICON=2；LR_SHARED=0x8000（注意 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,

package/test/test_files.js

@@ -40,7 +40,7 @@ export const suite = {
         const pathC = `${dir}\\c.txt`;
         const pathCn = `${dir}\\中文文件.txt`;
         t.section('CreateFile + WriteFile: write payload');
-        const hW = CreateFile(pathA, GENERIC_WRITE, 0, NULL, 2 /* gui.FileCreation.CREATE_ALWAYS */, 0x80 /* FILE_ATTRIBUTE_NORMAL */, NULL);
+        const hW = CreateFile(pathA, GENERIC_WRITE, 0, NULL, 2 /* FileCreation.CREATE_ALWAYS */, 0x80 /* FILE_ATTRIBUTE_NORMAL */, NULL);
         t.checkTrue(`write handle valid (${hW})`, hW !== -1); // 失败 = INVALID_HANDLE_VALUE(-1)
         const payload = 'hello files';
         const wData = toWide(payload);
@@ -49,34 +49,34 @@ export const suite = {
         t.check('bytes written', payload.length * 2, new DataView(pWr).getUint32(0, true));
         t.checkTrue('CloseHandle (writer)', CloseHandle(hW) !== 0);
         t.section('CreateFile(READ) + GetFileSize + SetFilePointer + ReadFile');
-        const hR = CreateFile(pathA, GENERIC_READ, 0, NULL, 3 /* gui.FileCreation.OPEN_EXISTING */, 0x80, NULL);
+        const hR = CreateFile(pathA, GENERIC_READ, 0, NULL, 3 /* FileCreation.OPEN_EXISTING */, 0x80, NULL);
         t.checkTrue(`read handle valid (${hR})`, hR !== -1);
         t.check('GetFileSize', payload.length * 2, GetFileSize(hR, NULL));
-        t.check('SetFilePointer BEGIN → 0', 0, SetFilePointer(hR, 0, NULL, 0 /* gui.FileSeekFrom.BEGIN */));
+        t.check('SetFilePointer BEGIN → 0', 0, SetFilePointer(hR, 0, NULL, 0 /* FileSeekFrom.BEGIN */));
         const rData = new PtrArrayBuffer(payload.length * 2);
         const pRd = new PtrArrayBuffer(4);
         t.checkTrue('ReadFile ok', ReadFile(hR, rData, payload.length * 2, pRd, NULL) !== 0);
         t.check('read roundtrip', payload, fromWide(rData, payload.length));
         // seek 到 END-4 验证负偏移 + 读尾 4 字节
-        t.check('SetFilePointer END-4', payload.length * 2 - 4, SetFilePointer(hR, -4, NULL, 2 /* gui.FileSeekFrom.END */));
+        t.check('SetFilePointer END-4', payload.length * 2 - 4, SetFilePointer(hR, -4, NULL, 2 /* FileSeekFrom.END */));
         const rTail = new PtrArrayBuffer(8);
         ReadFile(hR, rTail, 4, pRd, NULL);
         t.check('seeked tail', payload.slice(-2), fromWide(rTail, 2));
         CloseHandle(hR);
         t.section('CopyFile + MoveFileEx + GetFileAttributes');
-        const hB = CreateFile(pathB, GENERIC_WRITE, 0, NULL, 2 /* gui.FileCreation.CREATE_ALWAYS */, 0x80, NULL);
+        const hB = CreateFile(pathB, GENERIC_WRITE, 0, NULL, 2 /* FileCreation.CREATE_ALWAYS */, 0x80, NULL);
         const bData = toWide('bb');
         WriteFile(hB, bData, 4, pWr, NULL);
         CloseHandle(hB);
         t.checkTrue('CopyFile ok', CopyFile(pathB, pathC, 0) !== 0);
-        const hC = CreateFile(pathC, GENERIC_READ, 0, NULL, 3 /* gui.FileCreation.OPEN_EXISTING */, 0x80, NULL);
+        const hC = CreateFile(pathC, GENERIC_READ, 0, NULL, 3 /* FileCreation.OPEN_EXISTING */, 0x80, NULL);
         t.check('copied size', 4, GetFileSize(hC, NULL));
         t.checkTrue('CloseHandle (copy reader)', CloseHandle(hC) !== 0);
         t.checkTrue('MoveFileEx replace ok', MoveFileEx(pathB, pathC, 0x1 /* MOVEFILE_REPLACE_EXISTING */) !== 0);
         t.check('moved: source gone', INVALID32, GetFileAttributes(pathB));
         t.checkTrue('dest is file (not dir)', (GetFileAttributes(pathC) & FILE_ATTRIBUTE_DIRECTORY) === 0);
         t.section('FindFirstFile/FindNextFile: enumerate *.txt incl. CJK name');
-        const hCn = CreateFile(pathCn, GENERIC_WRITE, 0, NULL, 2 /* gui.FileCreation.CREATE_ALWAYS */, 0x80, NULL);
+        const hCn = CreateFile(pathCn, GENERIC_WRITE, 0, NULL, 2 /* FileCreation.CREATE_ALWAYS */, 0x80, NULL);
         CloseHandle(hCn); // 0 字节中文名文件
         const fd = WIN32_FIND_DATAW.alloc();
         const hFind = FindFirstFile(`${dir}\\a.txt`, fd.ptr);