quickwin 3.0.0 → 3.0.1

package/lib/windows/{shell32.ts → shell32.d.ts}

@@ -1,23 +1,12 @@
-// shell32 绑定（shell 对话框 / PIDL→路径 / 托盘图标增删与定位）
-import { bind, type CodecMap } from '../ffi/bind.js'
-import { NOTIFYICONIDENTIFIER, NOTIFYICONDATAW } from './structs.js'
-
-// 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
  *  @param args_0 pbi BROWSEINFOW.encode(...).ptr（见 structs.ts） */
-export const SHBrowseForFolder = /*@__PURE__*/ b('SHBrowseForFolderW', '<BROWSEINFOW>ptr -> <>ptr')
-
+export declare const SHBrowseForFolder: (args_0: import("../ffi/ctype.js").MaybePtr<"BROWSEINFOW">) => import("../ffi/ctype.js").MaybePtr<"">;
 /** 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')
-
+export declare const SHGetPathFromIDList: (args_0: import("../ffi/ctype.js").MaybePtr<"">, args_1: import("../ffi/ctype.js").PtrArrayBuffer<any> | import("../ffi/ctype.js").MaybePtr<"BYTE">) => number;
 /** 取托盘通知图标的屏幕矩形（Shell_NotifyIconGetRect；**Win7+**——XP 无此导出，
  *  故为**可选绑定**：老系统上本常量为 null（bind() 是模块顶层立即解析，缺符号 throw
  *  会拖垮整个脚本启动），调用方必须判空）
@@ -29,15 +18,12 @@ export const SHGetPathFromIDList = /*@__PURE__*/ b('SHGetPathFromIDListW', '<>pt
  *    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
-    }
-})()
-
+export declare const Shell_NotifyIconGetRect: ((args_0: {
+    cbSize?: number | undefined;
+    guidItem?: [number, number, number, number] | undefined;
+    hWnd?: import("../ffi/ctype.js").MaybePtr<"HWND"> | undefined;
+    uID?: number | undefined;
+} | import("../ffi/ctype.js").MaybePtr<"NOTIFYICONIDENTIFIER">, args_1: import("../ffi/ctype.js").MaybePtr<"RECT">) => number) | null;
 /** 托盘通知图标增删改（Shell_NotifyIconW；XP 起即有）
  *  @returns 成功 → 非 0，失败 → 0
  *  @param args_0 dwMessage NotifyIconCmd（ADD / MODIFY / DELETE / SETVERSION…；DELETE 只需
@@ -46,5 +32,20 @@ export const Shell_NotifyIconGetRect = (() => {
  *    NOTIFYICONDATAW.size、uFlags 取 NotifyIconFlag.*（ICON/MESSAGE/TIP…，决定下面哪些字段
  *    生效）、uCallbackMessage 常填自定义消息号、hIcon 接 LoadImage/LoadAppIcon 的结果、
  *    szTip 直接给 string（宽字符串糖，最长 127 字符） */
-export const ShellNotifyIcon = /*@__PURE__*/ b('Shell_NotifyIconW',
-    'u32 <NOTIFYICONDATAW>ptr -> i32', { NOTIFYICONDATAW })
+export declare const ShellNotifyIcon: (args_0: number, args_1: {
+    cbSize?: number | undefined;
+    dwInfoFlags?: number | undefined;
+    dwState?: number | undefined;
+    dwStateMask?: number | undefined;
+    guidItem?: [number, number, number, number] | undefined;
+    hBalloonIcon?: import("../ffi/ctype.js").MaybePtr<""> | undefined;
+    hIcon?: import("../ffi/ctype.js").MaybePtr<""> | undefined;
+    hWnd?: import("../ffi/ctype.js").MaybePtr<"HWND"> | undefined;
+    szInfo?: string | undefined;
+    szInfoTitle?: string | undefined;
+    szTip?: string | undefined;
+    uCallbackMessage?: number | undefined;
+    uFlags?: number | undefined;
+    uID?: number | undefined;
+    uTimeout?: number | undefined;
+} | import("../ffi/ctype.js").MaybePtr<"NOTIFYICONDATAW">) => number;