quickwin 2.2.0 → 2.3.0

package/lib/windows/advapi32.ts

@@ -6,13 +6,13 @@ const b = <const S extends string>(name: string, sig: S) => bind('advapi32.dll',
 
 /** 创建/打开子键（子键不存在则创建，含中间层级）
  *  @returns 0 = ERROR_SUCCESS
- *  @param args_0 hKey 父键：gui.HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
+ *  @param args_0 hKey 父键：HKey.CURRENT_USER / LOCAL_MACHINE 预定义键，或本族
  *                Open/Create 返回的真实句柄（此位双来源，不标 @HKey——裸位收两种）
  *  @param args_1 lpSubKey 子键路径（'Software\\X\\Y'，可 NULL = 打开 hKey 自身副本）
  *  @param args_2 Reserved 保留，恒 0
  *  @param args_3 lpClass 键类名（一般 NULL）
  *  @param args_4 dwOptions 保留属性（恒 0）
- *  @param args_5 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
+ *  @param args_5 samDesired 访问掩码 RegAccess.READ / SET_VALUE（标准组合常量按成员收录）
  *  @param args_6 lpSecurityAttributes 安全描述符（一般 NULL）
  *  @param args_7 phkResult 出参：键句柄（PtrArrayBuffer(8)，readPtr 按架构读回）
  *  @param args_8 lpdwDisposition 出参：新建/已存在标记（可 NULL） */
@@ -24,7 +24,7 @@ export const RegCreateKeyEx = /*@__PURE__*/ b('RegCreateKeyExW',
  *  @param args_0 hKey 父键（同 RegCreateKeyEx 的双来源语义）
  *  @param args_1 lpSubKey 子键路径（NULL = 打开 hKey 自身副本）
  *  @param args_2 ulOptions 保留，恒 0
- *  @param args_3 samDesired 访问掩码 gui.RegAccess.READ / SET_VALUE
+ *  @param args_3 samDesired 访问掩码 RegAccess.READ / SET_VALUE
  *  @param args_4 phkResult 出参：键句柄 */
 export const RegOpenKeyEx = /*@__PURE__*/ b('RegOpenKeyExW',
     '<>ptr <WCHAR>ptr u32 u32@RegAccess <BYTE>ptr -> i32')
@@ -36,10 +36,10 @@ export const RegCloseKey = /*@__PURE__*/ b('RegCloseKey', '<>ptr -> i32')
 
 /** 写键值
  *  @returns 0 = ERROR_SUCCESS
- *  @param args_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 gui.RegAccess.SET_VALUE）
+ *  @param args_0 hKey 键句柄（须 KEY_SET_VALUE 权限，含于 RegAccess.SET_VALUE）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 Reserved 保留，恒 0
- *  @param args_3 dwType 值类型 gui.RegType.SZ（UTF-16 字符串）
+ *  @param args_3 dwType 值类型 RegType.SZ（UTF-16 字符串）
  *  @param args_4 lpData 数据缓冲（REG_SZ：UTF-16LE 含结尾 NUL）
  *  @param args_5 cbData 数据字节数（REG_SZ = (字符数+1)*2） */
 export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW',
@@ -47,7 +47,7 @@ export const RegSetValueEx = /*@__PURE__*/ b('RegSetValueExW',
 
 /** 读键值（两跳模式：第一跳 lpData=NULL 取尺寸/类型，第二跳按尺寸带缓冲读数据）
  *  @returns 0 = ERROR_SUCCESS；2 = ERROR_FILE_NOT_FOUND（值不存在）
- *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 gui.RegAccess.READ）
+ *  @param args_0 hKey 键句柄（须 KEY_QUERY_VALUE 权限，含于 RegAccess.READ）
  *  @param args_1 lpValueName 值名（NULL = 键的默认值）
  *  @param args_2 lpReserved 保留，恒 NULL
  *  @param args_3 lpType 出参：值类型（可 NULL）
@@ -57,7 +57,7 @@ export const RegQueryValueEx = /*@__PURE__*/ b('RegQueryValueExW',
     '<>ptr <WCHAR>ptr <>ptr <BYTE>ptr <BYTE>ptr <BYTE>ptr -> i32')
 
 /** 删除子键（连值一起删）；须父键 KEY_CREATE_SUB_KEY 权限——自己的 HKCU 直接传
- *  gui.HKey.CURRENT_USER 即可
+ *  HKey.CURRENT_USER 即可
  *  @returns 0 = ERROR_SUCCESS；2 = 子键不存在
  *  @param args_0 hKey 父键
  *  @param args_1 lpSubKey 要删的子键路径（不可 NULL） */

package/lib/windows/gdi32.js

@@ -68,7 +68,7 @@ export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>
  *  @param args_5 hdcSrc 源 DC
  *  @param args_6 x1 源起始 x
  *  @param args_7 y1 源起始 y
- *  @param args_8 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
+ *  @param args_8 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
 // hdcDest 非空（!）；hdcSrc 在 PATCOPY 等特定 rop 下 C 允许 NULL，保持可空档。
 export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 u32@RasterOp -> i32');
 /** 取位图像素到 lpvBits（lpbmi 为 BITMAPINFO，32bpp BI_RGB 无颜色表时头部即全部：
@@ -99,7 +99,7 @@ export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32');
  *  @param args_2 y 左上角 y
  *  @param args_3 w 宽度
  *  @param args_4 h 高度
- *  @param args_5 rop gui.RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
+ *  @param args_5 rop RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
 export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@RasterOp -> i32');
 /** 拉伸位图传送（源区 wSrc×hSrc 放/缩到目标 wDest×hDest）
  *  @returns 成功 → 非 0
@@ -113,15 +113,15 @@ export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@R
  *  @param args_7 ySrc 源区左上 y
  *  @param args_8 wSrc 源区宽
  *  @param args_9 hSrc 源区高
- *  @param args_10 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_10 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchBlt = /*@__PURE__*/ b('StretchBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 i32 i32 u32@RasterOp -> i32');
 /** 设置拉伸取色模式；放大时各模式像素同为源色，缩小时降采样策略不同
  *  （DELETESCANS 丢行 / HALFTONE 平均取色最保真）
  *  @returns 旧值
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
+ *  @param args_1 iMode StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
 export const SetStretchBltMode = /*@__PURE__*/ b('SetStretchBltMode', '<HDC>ptr! i32@StretchBltMode -> i32');
-/** 读拉伸取色模式（值域 = gui.StretchBltMode 成员）；回传
+/** 读拉伸取色模式（值域 = StretchBltMode 成员）；回传
  *  SetStretchBltMode 前需按成员值使用（裸 number 进不了枚举位）
  *  @returns number */
 export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr! -> i32');
@@ -187,18 +187,18 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice', '<HDC>ptr!
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
  *  @param args_11 iUsage DIB_RGB_COLORS(0)
- *  @param args_12 rop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_12 rop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32 u32@RasterOp -> i32');
 // ============ 画图原语（笔 / 线 / 形状 / 文字） ============
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）
  *  @returns 失败 → 0
- *  @param args_0 iObject gui.StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
+ *  @param args_0 iObject StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
 export const GetStockObject = /*@__PURE__*/ b('GetStockObject', 'i32@StockObject -> <HGDIOBJ>ptr');
 /** 创建网格纹理画刷（线色 = crColor，间隙 = 背景：SetBkMode=TRANSPARENT 透底、OPAQUE
  *  用 SetBkColor）；配对 DeleteObject
  *  @returns 失败 → 0
- *  @param args_0 iHatch gui.HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
+ *  @param args_0 iHatch HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
  *  BDIAGONAL / CROSS / DIAGCROSS
  *  @param args_1 crColor 纹理线颜色 0x00BBGGRR */
 export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchStyle u32 -> <HGDIOBJ>ptr');
@@ -209,14 +209,14 @@ export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchSt
 export const CreatePatternBrush = /*@__PURE__*/ b('CreatePatternBrush', '<HGDIOBJ>ptr -> <HGDIOBJ>ptr');
 /** 创建画笔（选入 hdc 生效，SelectObject 选回旧对象后 DeleteObject 配对）
  *  @returns 失败 → 0
- *  @param args_0 iStyle 笔型（gui.PenStyle.SOLID / DASH / NULL 等）
+ *  @param args_0 iStyle 笔型（PenStyle.SOLID / DASH / NULL 等）
  *  @param args_1 cWidth 笔宽（像素；>1 的几何宽设备相关，虚线样式可能被拉伸）
  *  @param args_2 crColor 笔色 0x00BBGGRR */
 export const CreatePen = /*@__PURE__*/ b('CreatePen', 'i32@PenStyle i32 u32 -> <HGDIOBJ>ptr');
 /** 设置文字/阴影背景填充模式
  *  @returns 旧模式（新建 DC 默认 OPAQUE）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iBkMode gui.BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
+ *  @param args_1 iBkMode BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
 export const SetBkMode = /*@__PURE__*/ b('SetBkMode', '<HDC>ptr! i32@BackgroundMode -> i32');
 /** 设置文字颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
@@ -241,19 +241,19 @@ export const RestoreDC = /*@__PURE__*/ b('RestoreDC', '<HDC>ptr! i32 -> i32');
 /** 设置多边形填充规则
  *  @returns 旧值（新建 DC 默认 ALTERNATE = 奇偶规则）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.PolyFillMode.ALTERNATE（自相交区域交替镂空）/
+ *  @param args_1 iMode PolyFillMode.ALTERNATE（自相交区域交替镂空）/
  *  WINDING（非零环绕，自相交区域整体实心） */
 export const SetPolyFillMode = /*@__PURE__*/ b('SetPolyFillMode', '<HDC>ptr! i32@PolyFillMode -> i32');
 /** 设置前景画笔与目的像素的混合方式（二元光栅模式）；
  *  R2_XORPEN 可逆（同路径画两次抵消原样），适合橡皮筋交互
  *  @returns 旧值（默认 R2_COPYPEN = 直接画）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
+ *  @param args_1 iMode RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
 export const SetROP2 = /*@__PURE__*/ b('SetROP2', '<HDC>ptr! i32@RasterMode -> i32');
 /** 设置弧/弦/扇形的扫过方向
  *  @returns 旧值（新 DC 默认逆时针）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iDir gui.ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
+ *  @param args_1 iDir ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
 export const SetArcDirection = /*@__PURE__*/ b('SetArcDirection', '<HDC>ptr! i32@ArcDirection -> i32');
 /** 读弧扫过方向
  *  @returns AD_COUNTERCLOCKWISE=1 / AD_CLOCKWISE=2；失败 → 0 */
@@ -358,10 +358,10 @@ export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_4 c 字符数（= str.length；C 要字符数不是字节数，不含 NUL） */
 export const TextOut = /*@__PURE__*/ b('TextOutW', '<HDC>ptr! i32 i32 <WCHAR>ptr i32 -> i32');
 /** 设置 TextOut/ExtTextOut 的对齐与当前位置更新方式；TA_* 按位组合
- *  （如 gui.TextAlign.TA_CENTER | gui.TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
+ *  （如 TextAlign.TA_CENTER | TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
  *  @returns 旧 flags（新 DC 默认 TA_LEFT|TA_TOP|TA_NOUPDATECP = 0）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 fMode gui.TextAlign 成员按位或 */
+ *  @param args_1 fMode TextAlign 成员按位或 */
 export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u32');
 /** 按当前字体量字符串宽高（不含衬底与额外间距）
  *  @returns 成功 → 非 0
@@ -382,7 +382,7 @@ export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW', '<HDC>ptr! <TEX
  *  @param args_0 hdc 目标 DC
  *  @param args_1 x 起点 x
  *  @param args_2 y 起点 y
- *  @param args_3 fOptions gui.TextOutOptions.ETO_OPAQUE（矩形填衬底）|
+ *  @param args_3 fOptions TextOutOptions.ETO_OPAQUE（矩形填衬底）|
  *  ETO_CLIPPED（矩形裁剪字形）按位或（可 0 = 都不用）
  *  @param args_4 lprc ETO_OPAQUE/ETO_CLIPPED 的作用矩形：DeepPartial 对象直传 /
  *  RECT.alloc().ptr / NULL = 整个当前可裁剪区（有 encoder 的纯入参位三形态）

package/lib/windows/gdi32.ts

@@ -77,7 +77,7 @@ export const SelectObject = /*@__PURE__*/ b('SelectObject', '<HDC>ptr! <HGDIOBJ>
  *  @param args_5 hdcSrc 源 DC
  *  @param args_6 x1 源起始 x
  *  @param args_7 y1 源起始 y
- *  @param args_8 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
+ *  @param args_8 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码（标 @ 枚举拦手误值） */
 // hdcDest 非空（!）；hdcSrc 在 PATCOPY 等特定 rop 下 C 允许 NULL，保持可空档。
 export const BitBlt = /*@__PURE__*/ b('BitBlt', '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 u32@RasterOp -> i32')
 /** 取位图像素到 lpvBits（lpbmi 为 BITMAPINFO，32bpp BI_RGB 无颜色表时头部即全部：
@@ -109,7 +109,7 @@ export const DeleteDC = /*@__PURE__*/ b('DeleteDC', '<HDC>ptr! -> i32')
  *  @param args_2 y 左上角 y
  *  @param args_3 w 宽度
  *  @param args_4 h 高度
- *  @param args_5 rop gui.RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
+ *  @param args_5 rop RasterOp.PATCOPY / WHITENESS 等互斥单选光栅操作码 */
 export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@RasterOp -> i32')
 /** 拉伸位图传送（源区 wSrc×hSrc 放/缩到目标 wDest×hDest）
  *  @returns 成功 → 非 0
@@ -123,16 +123,16 @@ export const PatBlt = /*@__PURE__*/ b('PatBlt', '<HDC>ptr! i32 i32 i32 i32 u32@R
  *  @param args_7 ySrc 源区左上 y
  *  @param args_8 wSrc 源区宽
  *  @param args_9 hSrc 源区高
- *  @param args_10 dwRop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_10 dwRop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchBlt = /*@__PURE__*/ b('StretchBlt',
     '<HDC>ptr! i32 i32 i32 i32 <HDC>ptr i32 i32 i32 i32 u32@RasterOp -> i32')
 /** 设置拉伸取色模式；放大时各模式像素同为源色，缩小时降采样策略不同
  *  （DELETESCANS 丢行 / HALFTONE 平均取色最保真）
  *  @returns 旧值
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
+ *  @param args_1 iMode StretchBltMode.ANDSCANS(1) / ORSCANS(2) / DELETESCANS(3) / HALFTONE(4) */
 export const SetStretchBltMode = /*@__PURE__*/ b('SetStretchBltMode', '<HDC>ptr! i32@StretchBltMode -> i32')
-/** 读拉伸取色模式（值域 = gui.StretchBltMode 成员）；回传
+/** 读拉伸取色模式（值域 = StretchBltMode 成员）；回传
  *  SetStretchBltMode 前需按成员值使用（裸 number 进不了枚举位）
  *  @returns number */
 export const GetStretchBltMode = /*@__PURE__*/ b('GetStretchBltMode', '<HDC>ptr! -> i32')
@@ -202,7 +202,7 @@ export const SetDIBitsToDevice = /*@__PURE__*/ b('SetDIBitsToDevice',
  *  @param args_9 lpvBits 像素缓冲（ArrayBuffer）
  *  @param args_10 lpbmi BITMAPINFO 缓冲（BITMAPINFOHEADER.encode({...}).ptr）
  *  @param args_11 iUsage DIB_RGB_COLORS(0)
- *  @param args_12 rop gui.RasterOp.SRCCOPY 等互斥单选光栅操作码 */
+ *  @param args_12 rop RasterOp.SRCCOPY 等互斥单选光栅操作码 */
 export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits',
     '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32 i32 <BYTE>ptr <BYTE>ptr u32 u32@RasterOp -> i32')
 
@@ -211,13 +211,13 @@ export const StretchDIBits = /*@__PURE__*/ b('StretchDIBits',
 /** 取系统共享对象（笔/刷/字体/调色板）；共享句柄不要 DeleteObject——
  *  SelectObject 选入 hdc 生效（如 NULL_BRUSH 让形状只描边不填充）
  *  @returns 失败 → 0
- *  @param args_0 iObject gui.StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
+ *  @param args_0 iObject StockObject.NULL_BRUSH / BLACK_PEN / DEFAULT_GUI_FONT 等 */
 export const GetStockObject = /*@__PURE__*/ b('GetStockObject', 'i32@StockObject -> <HGDIOBJ>ptr')
 
 /** 创建网格纹理画刷（线色 = crColor，间隙 = 背景：SetBkMode=TRANSPARENT 透底、OPAQUE
  *  用 SetBkColor）；配对 DeleteObject
  *  @returns 失败 → 0
- *  @param args_0 iHatch gui.HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
+ *  @param args_0 iHatch HatchStyle.HORIZONTAL（横线）/ VERTICAL / FDIAGONAL /
  *  BDIAGONAL / CROSS / DIAGCROSS
  *  @param args_1 crColor 纹理线颜色 0x00BBGGRR */
 export const CreateHatchBrush = /*@__PURE__*/ b('CreateHatchBrush', 'i32@HatchStyle u32 -> <HGDIOBJ>ptr')
@@ -230,14 +230,14 @@ export const CreatePatternBrush = /*@__PURE__*/ b('CreatePatternBrush', '<HGDIOB
 
 /** 创建画笔（选入 hdc 生效，SelectObject 选回旧对象后 DeleteObject 配对）
  *  @returns 失败 → 0
- *  @param args_0 iStyle 笔型（gui.PenStyle.SOLID / DASH / NULL 等）
+ *  @param args_0 iStyle 笔型（PenStyle.SOLID / DASH / NULL 等）
  *  @param args_1 cWidth 笔宽（像素；>1 的几何宽设备相关，虚线样式可能被拉伸）
  *  @param args_2 crColor 笔色 0x00BBGGRR */
 export const CreatePen = /*@__PURE__*/ b('CreatePen', 'i32@PenStyle i32 u32 -> <HGDIOBJ>ptr')
 /** 设置文字/阴影背景填充模式
  *  @returns 旧模式（新建 DC 默认 OPAQUE）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iBkMode gui.BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
+ *  @param args_1 iBkMode BackgroundMode.OPAQUE（衬底填充）/ TRANSPARENT（透明） */
 export const SetBkMode = /*@__PURE__*/ b('SetBkMode', '<HDC>ptr! i32@BackgroundMode -> i32')
 /** 设置文字颜色
  *  @returns 旧 COLORREF（0x00BBGGRR）
@@ -262,19 +262,19 @@ export const RestoreDC = /*@__PURE__*/ b('RestoreDC', '<HDC>ptr! i32 -> i32')
 /** 设置多边形填充规则
  *  @returns 旧值（新建 DC 默认 ALTERNATE = 奇偶规则）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.PolyFillMode.ALTERNATE（自相交区域交替镂空）/
+ *  @param args_1 iMode PolyFillMode.ALTERNATE（自相交区域交替镂空）/
  *  WINDING（非零环绕，自相交区域整体实心） */
 export const SetPolyFillMode = /*@__PURE__*/ b('SetPolyFillMode', '<HDC>ptr! i32@PolyFillMode -> i32')
 /** 设置前景画笔与目的像素的混合方式（二元光栅模式）；
  *  R2_XORPEN 可逆（同路径画两次抵消原样），适合橡皮筋交互
  *  @returns 旧值（默认 R2_COPYPEN = 直接画）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iMode gui.RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
+ *  @param args_1 iMode RasterMode.R2_COPYPEN / R2_XORPEN / R2_NOT 等（单选，标 @ 枚举） */
 export const SetROP2 = /*@__PURE__*/ b('SetROP2', '<HDC>ptr! i32@RasterMode -> i32')
 /** 设置弧/弦/扇形的扫过方向
  *  @returns 旧值（新 DC 默认逆时针）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 iDir gui.ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
+ *  @param args_1 iDir ArcDirection.COUNTERCLOCKWISE（默认）/ CLOCKWISE */
 export const SetArcDirection = /*@__PURE__*/ b('SetArcDirection', '<HDC>ptr! i32@ArcDirection -> i32')
 /** 读弧扫过方向
  *  @returns AD_COUNTERCLOCKWISE=1 / AD_CLOCKWISE=2；失败 → 0 */
@@ -383,10 +383,10 @@ export const Pie = /*@__PURE__*/ b('Pie', '<HDC>ptr! i32 i32 i32 i32 i32 i32 i32
  *  @param args_4 c 字符数（= str.length；C 要字符数不是字节数，不含 NUL） */
 export const TextOut = /*@__PURE__*/ b('TextOutW', '<HDC>ptr! i32 i32 <WCHAR>ptr i32 -> i32')
 /** 设置 TextOut/ExtTextOut 的对齐与当前位置更新方式；TA_* 按位组合
- *  （如 gui.TextAlign.TA_CENTER | gui.TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
+ *  （如 TextAlign.TA_CENTER | TextAlign.TA_UPDATECP），故签名保持 u32 不标枚举
  *  @returns 旧 flags（新 DC 默认 TA_LEFT|TA_TOP|TA_NOUPDATECP = 0）
  *  @param args_0 hdc 目标 DC
- *  @param args_1 fMode gui.TextAlign 成员按位或 */
+ *  @param args_1 fMode TextAlign 成员按位或 */
 export const SetTextAlign = /*@__PURE__*/ b('SetTextAlign', '<HDC>ptr! u32 -> u32')
 /** 按当前字体量字符串宽高（不含衬底与额外间距）
  *  @returns 成功 → 非 0
@@ -409,7 +409,7 @@ export const GetTextMetrics = /*@__PURE__*/ b('GetTextMetricsW',
  *  @param args_0 hdc 目标 DC
  *  @param args_1 x 起点 x
  *  @param args_2 y 起点 y
- *  @param args_3 fOptions gui.TextOutOptions.ETO_OPAQUE（矩形填衬底）|
+ *  @param args_3 fOptions TextOutOptions.ETO_OPAQUE（矩形填衬底）|
  *  ETO_CLIPPED（矩形裁剪字形）按位或（可 0 = 都不用）
  *  @param args_4 lprc ETO_OPAQUE/ETO_CLIPPED 的作用矩形：DeepPartial 对象直传 /
  *  RECT.alloc().ptr / NULL = 整个当前可裁剪区（有 encoder 的纯入参位三形态）

package/lib/windows/kernel32.js

@@ -101,6 +101,38 @@ export const TerminateProcess = /*@__PURE__*/ b('TerminateProcess', '<HPROCESS>p
 /** 取当前进程 PID（互证锚点）
  *  @returns 当前进程 PID */
 export const GetCurrentProcessId = /*@__PURE__*/ b('GetCurrentProcessId', ' -> u32');
+/** 当前进程伪句柄（-1，不需 CloseHandle——OpenProcess 真句柄的零成本替代，纯本进程
+ *  场景如 IsWow64Process 探位宽用） */
+export const GetCurrentProcess = /*@__PURE__*/ b('GetCurrentProcess', ' -> <HPROCESS>ptr');
+// ============ 远程内存（跨进程 SendMessage 的输出缓冲）============
+// 普通跨进程 SendMessage **不 marshal 指针**：出参 buffer 写在接收方线程执行，指针值
+// 原样透传——落在本进程地址空间会被 explorer 直接写穿。正解 = VirtualAllocEx 在目标
+// 进程分配 → 发消息 → ReadProcessMemory 读回（见 examples/execd/tray.ts /tray_list 用例）。
+/** 在目标进程地址空间分配内存；配对 VirtualFreeEx
+ *  @returns 成功 → 远程基址，失败 → 0（0 保真）
+ *  @param args_0 hProcess OpenProcess 句柄（本场景须 PROCESS_VM_OPERATION(0x8) |
+ *                PROCESS_VM_READ(0x10) | PROCESS_VM_WRITE(0x20) = 0x38）
+ *  @param args_1 lpAddress NULL = 系统选起点
+ *  @param args_2 dwSize 字节数（SIZE_T 随位宽 = <>ptr 的 ptr 宽，非指针语义）
+ *  @param args_3 flAllocationType MEM_COMMIT|MEM_RESERVE（0x1000|0x2000 = 0x3000）
+ *  @param args_4 flProtect PAGE_READWRITE（0x04） */
+export const VirtualAllocEx = /*@__PURE__*/ b('VirtualAllocEx', '<HPROCESS>ptr <>ptr <>ptr u32 u32 -> <>ptr');
+/** 释放 VirtualAllocEx 内存（须同一进程句柄）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 同 VirtualAllocEx
+ *  @param args_1 lpAddress VirtualAllocEx 返回的远程基址
+ *  @param args_2 dwSize 0（MEM_RELEASE 时必须 0）
+ *  @param args_3 dwFreeType MEM_RELEASE（0x8000） */
+export const VirtualFreeEx = /*@__PURE__*/ b('VirtualFreeEx', '<HPROCESS>ptr <>ptr <>ptr u32 -> i32');
+/** 读目标进程内存（远程 SendMessage 写完 → 本调用读回本地；远程指针字段如托盘
+ *  dwData 内容的二次解引用同样走这里）
+ *  @returns 成功 → 非 0（目标地址不可读/句柄无 PROCESS_VM_READ）
+ *  @param args_0 hProcess OpenProcess 句柄（须 PROCESS_VM_READ(0x10)）
+ *  @param args_1 lpBaseAddress 远程地址（VirtualAllocEx 返回值等）
+ *  @param args_2 lpBuffer 本地接收缓冲，传 BYTE.alloc(n)（DataView/TypedArray 原地读回）
+ *  @param args_3 nSize 字节数（SIZE_T → <>ptr ptr 宽）
+ *  @param args_4 lpNumberOfBytesRead 实读字节数出参槽 PtrArrayBuffer(8) 可选，或 NULL */
+export const ReadProcessMemory = /*@__PURE__*/ b('ReadProcessMemory', '<HPROCESS>ptr <>ptr <BYTE>ptr <>ptr <>ptr -> i32');
 // ============ 文件 I/O ============
 /** 同步读文件 / 管道
  *  @returns 成功 → 非 0，管道写端全部关闭后读返回 0（EOF）
@@ -118,7 +150,7 @@ export const ReadFile = /*@__PURE__*/ b('ReadFile', '<HFILE>ptr! <BYTE>ptr u32 <
  *                组合（flags 位不标枚举）
  *  @param args_2 dwShareMode 共享掩码：FILE_SHARE_READ(0x1)|FILE_SHARE_WRITE(0x2)，独占传 0
  *  @param args_3 lpSecurityAttributes 安全属性，传 NULL
- *  @param args_4 dwCreationDisposition 创建处置 gui.FileCreation.*（互斥单选）
+ *  @param args_4 dwCreationDisposition 创建处置 FileCreation.*（互斥单选）
  *  @param args_5 dwFlagsAndAttributes 属性：FILE_ATTRIBUTE_NORMAL(0x80) 等（可组合不标）
  *  @param args_6 hTemplateFile 模板文件句柄，传 NULL */
 export const CreateFile = /*@__PURE__*/ b('CreateFileW', '<WCHAR>ptr! u32 u32 <>ptr u32@FileCreation u32 <>ptr -> <HFILE>ptr!');
@@ -157,7 +189,7 @@ export const MoveFileEx = /*@__PURE__*/ b('MoveFileExW', '<WCHAR>ptr! <WCHAR>ptr
  *  与合法的 0xFFFFFFFF 偏移）
  *  @param args_1 lDistanceToMove 偏移（LONG，可负）
  *  @param args_2 lpDistanceToMoveHigh 64 位偏移高半（出参双向），32 位够用传 NULL
- *  @param args_3 dwMoveMethod 起点 gui.FileSeekFrom.BEGIN / CURRENT / END */
+ *  @param args_3 dwMoveMethod 起点 FileSeekFrom.BEGIN / CURRENT / END */
 export const SetFilePointer = /*@__PURE__*/ b('SetFilePointer', '<HFILE>ptr! i32 <BYTE>ptr u32@FileSeekFrom -> u32');
 /** 读文件大小
  *  @returns 文件大小（低 32 位）；0xFFFFFFFF = 失败（INVALID_FILE_SIZE，须 GetLastError 区分）
@@ -238,6 +270,13 @@ export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */
 export const GetCommandLineW = /*@__PURE__*/ b('GetCommandLineW', ' -> <WCHAR>ptr!');
+/** 本进程是否跑在 WOW64（32 位进程 on 64 位 OS）——判**远程进程/系统位宽**的廉价
+ *  探针：x64 进程恒 0（本就是 64 位 OS）；x86 进程 1 = OS 64 位（远程序构按 64 位解析，
+ *  如 x86 qwin 读 explorer 的 TBBUTTON）。32 位 OS 上恒写 0
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess GetCurrentProcess() 伪句柄或真句柄
+ *  @param args_1 lpWow64Process 出参 BOOL 槽，PtrArrayBuffer(4)，Uint32Array 读回 */
+export const IsWow64Process = /*@__PURE__*/ b('IsWow64Process', '<HPROCESS>ptr <BYTE>ptr -> i32');
 // ============ 全局内存（剪贴板数据载体）============
 /** 分配全局内存块
  *  @returns 成功 → 句柄（0 失败）

package/lib/windows/kernel32.ts

@@ -117,6 +117,42 @@ export const TerminateProcess = /*@__PURE__*/ b('TerminateProcess', '<HPROCESS>p
 /** 取当前进程 PID（互证锚点）
  *  @returns 当前进程 PID */
 export const GetCurrentProcessId = /*@__PURE__*/ b('GetCurrentProcessId', ' -> u32')
+/** 当前进程伪句柄（-1，不需 CloseHandle——OpenProcess 真句柄的零成本替代，纯本进程
+ *  场景如 IsWow64Process 探位宽用） */
+export const GetCurrentProcess = /*@__PURE__*/ b('GetCurrentProcess', ' -> <HPROCESS>ptr')
+
+// ============ 远程内存（跨进程 SendMessage 的输出缓冲）============
+// 普通跨进程 SendMessage **不 marshal 指针**：出参 buffer 写在接收方线程执行，指针值
+// 原样透传——落在本进程地址空间会被 explorer 直接写穿。正解 = VirtualAllocEx 在目标
+// 进程分配 → 发消息 → ReadProcessMemory 读回（见 examples/execd/tray.ts /tray_list 用例）。
+
+/** 在目标进程地址空间分配内存；配对 VirtualFreeEx
+ *  @returns 成功 → 远程基址，失败 → 0（0 保真）
+ *  @param args_0 hProcess OpenProcess 句柄（本场景须 PROCESS_VM_OPERATION(0x8) |
+ *                PROCESS_VM_READ(0x10) | PROCESS_VM_WRITE(0x20) = 0x38）
+ *  @param args_1 lpAddress NULL = 系统选起点
+ *  @param args_2 dwSize 字节数（SIZE_T 随位宽 = <>ptr 的 ptr 宽，非指针语义）
+ *  @param args_3 flAllocationType MEM_COMMIT|MEM_RESERVE（0x1000|0x2000 = 0x3000）
+ *  @param args_4 flProtect PAGE_READWRITE（0x04） */
+export const VirtualAllocEx = /*@__PURE__*/ b('VirtualAllocEx',
+    '<HPROCESS>ptr <>ptr <>ptr u32 u32 -> <>ptr')
+/** 释放 VirtualAllocEx 内存（须同一进程句柄）
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess 同 VirtualAllocEx
+ *  @param args_1 lpAddress VirtualAllocEx 返回的远程基址
+ *  @param args_2 dwSize 0（MEM_RELEASE 时必须 0）
+ *  @param args_3 dwFreeType MEM_RELEASE（0x8000） */
+export const VirtualFreeEx = /*@__PURE__*/ b('VirtualFreeEx', '<HPROCESS>ptr <>ptr <>ptr u32 -> i32')
+/** 读目标进程内存（远程 SendMessage 写完 → 本调用读回本地；远程指针字段如托盘
+ *  dwData 内容的二次解引用同样走这里）
+ *  @returns 成功 → 非 0（目标地址不可读/句柄无 PROCESS_VM_READ）
+ *  @param args_0 hProcess OpenProcess 句柄（须 PROCESS_VM_READ(0x10)）
+ *  @param args_1 lpBaseAddress 远程地址（VirtualAllocEx 返回值等）
+ *  @param args_2 lpBuffer 本地接收缓冲，传 BYTE.alloc(n)（DataView/TypedArray 原地读回）
+ *  @param args_3 nSize 字节数（SIZE_T → <>ptr ptr 宽）
+ *  @param args_4 lpNumberOfBytesRead 实读字节数出参槽 PtrArrayBuffer(8) 可选，或 NULL */
+export const ReadProcessMemory = /*@__PURE__*/ b('ReadProcessMemory',
+    '<HPROCESS>ptr <>ptr <BYTE>ptr <>ptr <>ptr -> i32')
 
 // ============ 文件 I/O ============
 
@@ -137,7 +173,7 @@ export const ReadFile = /*@__PURE__*/ b('ReadFile', '<HFILE>ptr! <BYTE>ptr u32 <
  *                组合（flags 位不标枚举）
  *  @param args_2 dwShareMode 共享掩码：FILE_SHARE_READ(0x1)|FILE_SHARE_WRITE(0x2)，独占传 0
  *  @param args_3 lpSecurityAttributes 安全属性，传 NULL
- *  @param args_4 dwCreationDisposition 创建处置 gui.FileCreation.*（互斥单选）
+ *  @param args_4 dwCreationDisposition 创建处置 FileCreation.*（互斥单选）
  *  @param args_5 dwFlagsAndAttributes 属性：FILE_ATTRIBUTE_NORMAL(0x80) 等（可组合不标）
  *  @param args_6 hTemplateFile 模板文件句柄，传 NULL */
 export const CreateFile = /*@__PURE__*/ b('CreateFileW',
@@ -177,7 +213,7 @@ export const MoveFileEx = /*@__PURE__*/ b('MoveFileExW', '<WCHAR>ptr! <WCHAR>ptr
  *  与合法的 0xFFFFFFFF 偏移）
  *  @param args_1 lDistanceToMove 偏移（LONG，可负）
  *  @param args_2 lpDistanceToMoveHigh 64 位偏移高半（出参双向），32 位够用传 NULL
- *  @param args_3 dwMoveMethod 起点 gui.FileSeekFrom.BEGIN / CURRENT / END */
+ *  @param args_3 dwMoveMethod 起点 FileSeekFrom.BEGIN / CURRENT / END */
 export const SetFilePointer = /*@__PURE__*/ b('SetFilePointer', '<HFILE>ptr! i32 <BYTE>ptr u32@FileSeekFrom -> u32')
 /** 读文件大小
  *  @returns 文件大小（低 32 位）；0xFFFFFFFF = 失败（INVALID_FILE_SIZE，须 GetLastError 区分）
@@ -265,6 +301,13 @@ export const GetModuleFileName = /*@__PURE__*/ b('GetModuleFileNameW', '<HMODULE
  *  @returns 命令行整串（返回位 `<WCHAR>ptr!`：内建 WCHAR codec 自动解码为 string，
  *    `!` 担保非 NULL 由返回位 0 检查兜底，无需接收缓冲） */
 export const GetCommandLineW = /*@__PURE__*/ b('GetCommandLineW', ' -> <WCHAR>ptr!')
+/** 本进程是否跑在 WOW64（32 位进程 on 64 位 OS）——判**远程进程/系统位宽**的廉价
+ *  探针：x64 进程恒 0（本就是 64 位 OS）；x86 进程 1 = OS 64 位（远程序构按 64 位解析，
+ *  如 x86 qwin 读 explorer 的 TBBUTTON）。32 位 OS 上恒写 0
+ *  @returns 成功 → 非 0
+ *  @param args_0 hProcess GetCurrentProcess() 伪句柄或真句柄
+ *  @param args_1 lpWow64Process 出参 BOOL 槽，PtrArrayBuffer(4)，Uint32Array 读回 */
+export const IsWow64Process = /*@__PURE__*/ b('IsWow64Process', '<HPROCESS>ptr <BYTE>ptr -> i32')
 
 // ============ 全局内存（剪贴板数据载体）============
 

package/lib/windows/shell32.js

@@ -1,7 +1,9 @@
-// shell32 绑定（shell 对话框 / PIDL→路径）
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
 import { bind } from '../ffi/bind.js';
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
-const b = (name, sig) => bind('shell32.dll', name, sig);
+import { NOTIFYICONIDENTIFIER } from './structs.js';
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）；第三参透传
+// encoders（结构入参位注册，方向约定见 lib/windows/user32.ts 头注释）
+const b = (name, sig, encoders) => bind('shell32.dll', name, sig, encoders);
 /** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
  *  @returns PIDL，取消 → 0
  *  @param args_0 pbi BROWSEINFOW.encode(...).ptr（见 structs.ts） */
@@ -11,3 +13,22 @@ export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEI
  *  @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');
+/** 取托盘通知图标的屏幕矩形（Shell_NotifyIconGetRect；**Win7+**——XP 无此导出，
+ *  故为**可选绑定**：老系统上本常量为 null（bind() 是模块顶层立即解析，缺符号 throw
+ *  会拖垮整个脚本启动），调用方必须判空）
+ *  @returns HRESULT，实测语义：0 = 图标在通知区内，iconLocation = 其容器（可见区 /
+ *    溢出面板）内位置——**溢出面板未展开时该 rect 不是屏幕可点位**；1 = 按文档为
+ *    不可见态（隐藏/溢出；本机未复现——实测 Win7 溢出图标亦返 0）；0x80004005 E_FAIL
+ *    = 图标不存在，或该图标未按 {hWnd,uID} 注册（系统 GUID 图标实测 not_found）
+ *  @param args_0 identifier NOTIFYICONIDENTIFIER 对象直传（encoder 已注册；cbSize 填
+ *    NOTIFYICONIDENTIFIER.size，guidItem 缺省 = GUID_NULL 走 hWnd+uID）
+ *  @param args_1 iconLocation 出参槽，RECT.alloc().ptr（出参位不注册，方向约定同
+ *    user32），RECT.decode 读回 */
+export const Shell_NotifyIconGetRect = (() => {
+    try {
+        return b('Shell_NotifyIconGetRect', '<NOTIFYICONIDENTIFIER>ptr <RECT>ptr -> i32', { NOTIFYICONIDENTIFIER });
+    }
+    catch {
+        return null; // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
+    }
+})();

package/lib/windows/shell32.ts

@@ -1,8 +1,11 @@
-// shell32 绑定（shell 对话框 / PIDL→路径）
-import { bind } from '../ffi/bind.js'
+// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标定位）
+import { bind, type CodecMap } from '../ffi/bind.js'
+import { NOTIFYICONIDENTIFIER } from './structs.js'
 
-// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）
-const b = <const S extends string>(name: string, sig: S) => bind('shell32.dll', name, sig)
+// dll 名部分应用（工厂转调保泛型 infer，见 lib/windows/user32.ts 头注释）；第三参透传
+// encoders（结构入参位注册，方向约定见 lib/windows/user32.ts 头注释）
+const b = <const S extends string, const LE extends CodecMap = {}>(name: string, sig: S, encoders?: LE) =>
+    bind('shell32.dll', name, sig, encoders)
 
 /** 文件夹浏览对话框；PIDL 用 ole32.CoTaskMemFree 释放
  *  @returns PIDL，取消 → 0
@@ -14,3 +17,23 @@ export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEI
  *  @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')
+
+/** 取托盘通知图标的屏幕矩形（Shell_NotifyIconGetRect；**Win7+**——XP 无此导出，
+ *  故为**可选绑定**：老系统上本常量为 null（bind() 是模块顶层立即解析，缺符号 throw
+ *  会拖垮整个脚本启动），调用方必须判空）
+ *  @returns HRESULT，实测语义：0 = 图标在通知区内，iconLocation = 其容器（可见区 /
+ *    溢出面板）内位置——**溢出面板未展开时该 rect 不是屏幕可点位**；1 = 按文档为
+ *    不可见态（隐藏/溢出；本机未复现——实测 Win7 溢出图标亦返 0）；0x80004005 E_FAIL
+ *    = 图标不存在，或该图标未按 {hWnd,uID} 注册（系统 GUID 图标实测 not_found）
+ *  @param args_0 identifier NOTIFYICONIDENTIFIER 对象直传（encoder 已注册；cbSize 填
+ *    NOTIFYICONIDENTIFIER.size，guidItem 缺省 = GUID_NULL 走 hWnd+uID）
+ *  @param args_1 iconLocation 出参槽，RECT.alloc().ptr（出参位不注册，方向约定同
+ *    user32），RECT.decode 读回 */
+export const Shell_NotifyIconGetRect = (() => {
+    try {
+        return b('Shell_NotifyIconGetRect',
+            '<NOTIFYICONIDENTIFIER>ptr <RECT>ptr -> i32', { NOTIFYICONIDENTIFIER })
+    } catch {
+        return null    // XP 等老系统无此导出（可选 API）；探测走 examples/execd/tray.ts
+    }
+})()

package/lib/windows/structs.js

@@ -601,3 +601,57 @@ export const PROCESS_MEMORY_COUNTERS_DECL = {
     PeakPagefileUsage: '<>ptr',
 };
 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',
+};
+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',
+};
+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,
+    },
+};
+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]',
+};
+export const NOTIFYICONIDENTIFIER = /* @__PURE__ */ struct('NOTIFYICONIDENTIFIER', NOTIFYICONIDENTIFIER_DECL);