feat: Add shell32 and notifyicon support with new constants

Author: shrirajh

source/index.ts

@@ -2,3 +2,4 @@ export { koffi } from './private.js'
 export * from './ctypes.js'
 export * from './win32/kernel32.js'
 export * from './win32/user32.js'
+export * from './win32/shell32.js'

source/win32/consts.ts

@@ -10,6 +10,8 @@ export * from './consts/IDI.js'
 export * from './consts/IMAGE.js'
 export * from './consts/LR.js'
 export * from './consts/MB.js'
+export * from './consts/NIF.js'
+export * from './consts/NIM.js'
 export * from './consts/OBM.js'
 export * from './consts/OCR.js'
 export * from './consts/OIC.js'

source/win32/consts/NIF.ts

@@ -0,0 +1,11 @@
+
+export const enum NIF_ {
+    MESSAGE  = 0x0001,
+    ICON     = 0x0002,
+    TIP      = 0x0004,
+    STATE    = 0x0008,
+    INFO     = 0x0010,
+    GUID     = 0x0020,
+    REALTIME = 0x0040,
+    SHOWTIP  = 0x0080,
+}

source/win32/consts/NIM.ts

@@ -0,0 +1,8 @@
+
+export const enum NIM_ {
+    ADD        = 0x00000000,
+    MODIFY     = 0x00000001,
+    DELETE     = 0x00000002,
+    SETFOCUS   = 0x00000003,
+    SETVERSION = 0x00000004,
+}

source/win32/shell32.ts

@@ -0,0 +1,2 @@
+export { shell32 } from './shell32/_lib.js'
+export * from './shell32/notifyicon.js'

source/win32/shell32/_lib.ts

@@ -0,0 +1,8 @@
+import { load, type koffi } from '../../private.js'
+
+const shell32lib = load('shell32.dll')
+
+/*@__NO_SIDE_EFFECTS__*/
+export function shell32(name: string, result: koffi.IKoffiCType, parameters: koffi.IKoffiCType[]) {
+    return shell32lib.lib.func(name, result, parameters)
+}

source/win32/shell32/notifyicon.ts

@@ -0,0 +1,68 @@
+import {
+    pointer, out, textDecoder,
+    struct, sizeof,
+    register, unregister,
+    type koffi
+} from '../../private.js'
+import {
+    cBOOL, cDWORD, cUINT, cLPWSTR, cLPCWSTR,
+} from '../../ctypes.js'
+import { shell32 } from './_lib.js'
+import { cHWND, type HWND } from '../user32/window.js'
+import { cHICON, type HICON } from '../user32/icon.js'
+import { NIF_, NIM_ } from '../consts.js'
+
+// #region Types
+
+/**
+ * Contains information that the system needs to display notifications in the notification area.
+ *
+ * @link https://learn.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-notifyicondataw
+ */
+export class NOTIFYICONDATA {
+    readonly cbSize = sizeof(cNOTIFYICONDATA)
+    declare hWnd:             HWND
+    declare uID:              number
+    declare uFlags:           NIF_
+    declare uCallbackMessage: number
+    declare hIcon:            HICON
+    declare szTip?:          string
+    declare dwState?:        number
+    declare dwStateMask?:    number
+    declare szInfo?:         string
+    declare uVersion?:       number
+    declare szInfoTitle?:    string
+    declare dwInfoFlags?:    number
+    declare guidItem?:       number
+    declare hBalloonIcon?:   HICON
+}
+
+export const cNOTIFYICONDATA = struct('NOTIFYICONDATA', {
+    cbSize:           cDWORD,
+    hWnd:            cHWND,
+    uID:             cUINT,
+    uFlags:          cUINT,
+    uCallbackMessage: cUINT,
+    hIcon:           cHICON,
+    szTip:           cLPWSTR,
+    dwState:         cDWORD,
+    dwStateMask:     cDWORD,
+    szInfo:          cLPWSTR,
+    uVersion:        cUINT,
+    szInfoTitle:     cLPWSTR,
+    dwInfoFlags:     cDWORD,
+    guidItem:        cDWORD,
+    hBalloonIcon:    cHICON
+})
+
+// #region Functions
+
+/**
+ * Adds, modifies, or deletes an icon from the taskbar status area.
+ *
+ * @link https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shell_notifyiconw
+ */
+export const Shell_NotifyIcon: koffi.KoffiFunc<(
+    dwMessage: NIM_,
+    lpData: NOTIFYICONDATA
+) => boolean> = shell32('Shell_NotifyIconW', cBOOL, [ cDWORD, cNOTIFYICONDATA ])