refactor(all): Implement lazy bindings, providing lower memory usage as well as enhanced code readability

Author: Septh

source/demos/createwindow.ts

@@ -4,9 +4,10 @@ import {
     CreateWindowEx, ShowWindow, UpdateWindow, DefWindowProc,
     GetMessage, TranslateMessage, DispatchMessage, PostQuitMessage,
     MessageBox,
-    type HINSTANCE, type WPARAM, type LPARAM, type HWND, type MSG
+    type HINSTANCE, type WPARAM, type LPARAM, type HWND, type MSG,
+    FormatMessage
 } from 'libwin32'
-import { CS_, CW_, IDC_, IDI_, MB_, SW_, WM_, WS_, WS_EX_ } from 'libwin32/consts'
+import { CS_, CW_, FORMAT_MESSAGE_, IDC_, IDI_, MB_, SW_, WM_, WS_, WS_EX_ } from 'libwin32/consts'
 
 const windowClass = "NodeApp"
 const windowName  = "Window Demo!"
@@ -17,15 +18,16 @@ function wndProc(hWnd: HWND, uMmsg: WM_, wParam: WPARAM, lParam: LPARAM) {
     let ret: number
     switch (uMmsg) {
         case WM_.DESTROY:
+            console.log('WM_DESTROY')
             PostQuitMessage(0)
             ret = 0
             break
 
         default:
-            ret = DefWindowProc(hWnd, uMmsg, wParam, lParam)
+            // console.log(uMmsg)
+            ret = DefWindowProc(hWnd, uMmsg, wParam, lParam) as number
             break
     }
-    // console.log(hWnd, { uMmsg, wParam, lParam }, ret)
     return ret
 }
 
@@ -55,8 +57,9 @@ function WinMain(hInstance: HINSTANCE, nCmdShow: SW_): number {
     )
     if (!hWnd) {
         const err = GetLastError()
-        MessageBox(null, "Call to CreateWindow failed!\n" + err.toString(16), appTitle, MB_.OK | MB_.ICONERROR)
-        return -1
+        const msg = FormatMessage(FORMAT_MESSAGE_.FROM_SYSTEM, null, err, 0)
+        MessageBox(null, "Call to CreateWindow failed!\n" + msg, appTitle, MB_.OK | MB_.ICONERROR)
+        return err
     }
 
     ShowWindow(hWnd, nCmdShow)
@@ -72,4 +75,9 @@ function WinMain(hInstance: HINSTANCE, nCmdShow: SW_): number {
     return 0
 }
 
-process.exitCode = WinMain(GetModuleHandle(null), SW_.NORMAL)
+const hInstance = GetModuleHandle(null)
+if (!hInstance) {
+    throw new Error('GetModuleHandle() failed.')
+}
+
+process.exitCode = WinMain(hInstance, SW_.NORMAL)

source/win32/consts/BSF.ts

@@ -14,3 +14,6 @@ export enum BSF_ {
     RETURNHDESK        = 0x00000200,
     LUID               = 0x00000400
 }
+
+/** Return this value to deny a query. */
+export const BROADCAST_QUERY_DENY = 0x424D5144

source/win32/ctypes.ts

@@ -65,7 +65,7 @@ export type DLGPROC     = (hWnd: HWND, msg: number, wParam: WPARAM, lParam: LPAR
 export const cPOINT = koffi.struct({
     x: cLONG,
     y: cLONG
-}), cPPOINT = koffi.pointer(cPOINT), cLPPOINT = koffi.pointer(cPOINT)
+})
 
 export interface POINT {
     x: number
@@ -75,7 +75,7 @@ export interface POINT {
 export const cPOINTS = koffi.struct({
     x: cSHORT,
     y: cSHORT
-}), cPPOINTS = koffi.pointer(cPOINTS), cLPPOINTS = koffi.pointer(cPOINTS)
+})
 
 export interface POINTS {
     x: number
@@ -87,7 +87,7 @@ export const cRECT = koffi.struct({
     top:    cLONG,
     right:  cLONG,
     bottom: cLONG
-}), cPRECT = koffi.pointer(cRECT), cLPRECT = koffi.pointer(cRECT)
+})
 
 export interface RECT {
     left:   number
@@ -99,7 +99,7 @@ export interface RECT {
 export const cSIZE = koffi.struct({
     cx: cLONG,
     yy: cLONG
-}), cPSIZE = koffi.pointer(cSIZE), cLPSIZE = koffi.pointer(cSIZE)
+})
 
 export interface SIZE {
     x: number
@@ -112,7 +112,7 @@ export const cMINMAXINFO = koffi.struct({
     ptMaxPosition:  cPOINT,
     ptMinTrackSize: cPOINT,
     ptMaxTrackSize: cPOINT
-}), cPMINMAXINFO = koffi.pointer(cMINMAXINFO), cLPMINMAXINFO = koffi.pointer(cMINMAXINFO)
+})
 
 export interface MINMAXINFO {
     ptReserved:     POINT
@@ -139,7 +139,7 @@ export interface GUID {
 export const cLUID = koffi.struct({
     LowPart: cDWORD,
     HighPart: cLONG,
-}), cPLUID = koffi.pointer(cLUID)
+})
 
 export interface LUID {
     LowPart: number

source/win32/kernel32/console.ts

@@ -1,9 +1,18 @@
-import { kernel32 } from './_lib.js'
+import type { koffi } from '../private.js'
 import { cHANDLE, type HWND } from '../ctypes.js'
+import { kernel32 } from './_lib.js'
 
 /**
  * Retrieves the window handle used by the console associated with the calling process.
  *
  * https://learn.microsoft.com/en-us/windows/console/getconsolewindow
  */
-export const GetConsoleWindow: () => HWND | null = /*#__PURE__*/kernel32.func('GetConsoleWindow', cHANDLE, [])
+export function GetConsoleWindow(): HWND | null {
+    GetConsoleWindow.fn ??= kernel32.func('GetConsoleWindow', cHANDLE, [])
+    return GetConsoleWindow.fn()
+}
+
+/** @internal */
+export declare namespace GetConsoleWindow {
+    export var fn: koffi.KoffiFunc<() => HWND | null>
+}

source/win32/kernel32/error.ts

@@ -1,8 +1,5 @@
-import { textDecoder } from '../private.js'
-import {
-    cDWORD, cLPCVOID, cLPWSTR, cVOID,
-    type HMODULE
-} from '../ctypes.js'
+import { textDecoder, type koffi } from '../private.js'
+import { cDWORD, cLPCVOID, cLPWSTR, cVOID, type HMODULE } from '../ctypes.js'
 import type { FORMAT_MESSAGE_ } from '../consts.js'
 import { kernel32 } from './_lib.js'
 
@@ -11,14 +8,30 @@ import { kernel32 } from './_lib.js'
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror
  */
-export const GetLastError: () => number = /*#__PURE__*/kernel32.func('GetLastError', cDWORD, [])
+export function GetLastError(): number {
+    GetLastError.fn ??= kernel32.func('GetLastError', cDWORD, [])
+    return GetLastError.fn()
+}
+
+/** @internal */
+export declare namespace GetLastError {
+    export var fn: koffi.KoffiFunc<() => number>
+}
 
 /**
  * Sets the last-error code for the calling thread.
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/errhandlingapi/nf-errhandlingapi-setlasterror
  */
-export const SetLastError: (dwErrcode: number) => void = /*#__PURE__*/kernel32.func('SetLastError', cVOID, [ cDWORD ])
+export function SetLastError(dwErrcode: number): void {
+    SetLastError.fn ??= kernel32.func('SetLastError', cVOID, [ cDWORD ])
+    return SetLastError.fn(dwErrcode)
+}
+
+/** @internal */
+export declare namespace SetLastError {
+    export var fn: koffi.KoffiFunc<(dwErrcode: number) => void>
+}
 
 /**
  * Formats a message string.
@@ -28,23 +41,19 @@ export const SetLastError: (dwErrcode: number) => void = /*#__PURE__*/kernel32.f
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-formatmessagew
  */
-export function FormatMessage(
-    dwFlags: FORMAT_MESSAGE_ | number,
-    lpSource: HMODULE | string | null,
-    dwMessageId: number,
-    dwLanguageId: number
-): string {
+export function FormatMessage(dwFlags: FORMAT_MESSAGE_ | number, lpSource: HMODULE | string | null, dwMessageId: number, dwLanguageId: number): string {
+    FormatMessage.fn ??= kernel32.func('FormatMessageW', cDWORD, [ cDWORD, cLPCVOID, cDWORD, cDWORD, cLPWSTR, cDWORD, '...' as any ])
+
     const out = new Uint16Array(2048)
-    const len = _FormatMessageW(dwFlags, lpSource, dwMessageId, dwLanguageId, out, out.length, 'int', 0)
+    const len = FormatMessage.fn(
+        dwFlags, lpSource, dwMessageId, dwLanguageId,
+        out, out.length,
+        'int', 0    // Fake va_list
+    )
     return textDecoder.decode(out.slice(0, len))
 }
 
-const _FormatMessageW: (
-    dwFlags: number,
-    lpSource: HMODULE | string | null,
-    dwMessageId: number,
-    dwLanguageId: number,
-    lpBuffer: Uint16Array,
-    nSize: number,
-    ...args: any[]
-) => number = /*#__PURE__*/kernel32.func('FormatMessageW', cDWORD, [ cDWORD, cLPCVOID, cDWORD, cDWORD, cLPWSTR, cDWORD, '...' as any ])
+/** @internal */
+export declare namespace FormatMessage {
+    export var fn: koffi.KoffiFunc<(dwFlags: number, lpSource: HMODULE | string | null, dwMessageId: number, dwLanguageId: number, lpBuffer: Uint16Array, nSize: number, ...args: any[]) => number>
+}

source/win32/kernel32/module.ts

@@ -1,8 +1,5 @@
-import { koffi } from '../private.js'
-import {
-    cBOOL, cDWORD, cLPCWSTR,
-    cHANDLE, type HMODULE
-} from '../ctypes.js'
+import { koffi, type POINTER } from '../private.js'
+import { cBOOL, cDWORD, cLPCWSTR, cHANDLE, type HMODULE } from '../ctypes.js'
 import type { GET_MODULE_HANDLE_EX_FLAG_ } from '../consts.js'
 import { kernel32 } from './_lib.js'
 
@@ -11,30 +8,34 @@ import { kernel32 } from './_lib.js'
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulehandlew
  */
-export const GetModuleHandle: (
-    lpModuleName: string | null
-) => HMODULE = /*#__PURE__*/kernel32.func('GetModuleHandleW', cHANDLE, [ cLPCWSTR ])
+export function GetModuleHandle(lpModuleName: string | null): HMODULE | null {
+    GetModuleHandle.fn ??= kernel32.func('GetModuleHandleW', cHANDLE, [ cLPCWSTR ])
+    return GetModuleHandle.fn(lpModuleName)
+}
+
+/** @internal */
+export declare namespace GetModuleHandle {
+    export var fn: koffi.KoffiFunc<(lpModuleName: string | null) => HMODULE | null>
+}
 
 /**
  * Retrieves a module handle for the specified module and increments the module's reference count
  * unless GET_MODULE_HANDLE_EX_FLAG_UNCHANGED_REFCOUNT is specified.
+ *
  * The module must have been loaded by the calling process.
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulehandleexw
  */
-/*#__NO_SIDE_EFFECTS__*/
-export function GetModuleHandleEx(
-    dwFlags: GET_MODULE_HANDLE_EX_FLAG_,
-    lpModuleName: string | null
-): HMODULE | null {
-    const hModule: [ HMODULE | null ] = [ null ]
-    return _GetModuleHandleExW(dwFlags, lpModuleName, hModule) === 0
+export function GetModuleHandleEx(dwFlags: GET_MODULE_HANDLE_EX_FLAG_, lpModuleName: string | null): HMODULE | null {
+    GetModuleHandleEx.fn ??= kernel32.func('GetModuleHandleExW', cBOOL, [ cDWORD, cLPCWSTR, koffi.out(koffi.pointer(cHANDLE)) ])
+
+    const hModule: POINTER<HMODULE | null> = [ null ]
+    return GetModuleHandleEx.fn(dwFlags, lpModuleName, hModule) === 0
         ? null
         : hModule[0]
 }
 
-const _GetModuleHandleExW:(
-    dwFlags: GET_MODULE_HANDLE_EX_FLAG_,
-    lpModuleName: string | null,
-    phModule: [ HMODULE | null ]
-) => number = /*#__PURE__*/kernel32.func('GetModuleHandleExW', cBOOL, [ cDWORD, cLPCWSTR, koffi.out(koffi.pointer(cHANDLE)) ])
+/** @internal */
+export declare namespace GetModuleHandleEx {
+    export var fn: koffi.KoffiFunc<(dwFlags: GET_MODULE_HANDLE_EX_FLAG_, lpModuleName: string | null, phModule: POINTER<HMODULE | null>) => number>
+}

source/win32/kernel32/process.ts

@@ -1,4 +1,4 @@
-import { koffi, textDecoder } from '../private.js'
+import { koffi, textDecoder, type INT_PTR } from '../private.js'
 import { cBOOL, cDWORD, cHANDLE, cLPDWORD, cLPWSTR, type HANDLE } from '../ctypes.js'
 import type { PSAR_ } from '../consts.js'
 import { kernel32 } from './_lib.js'
@@ -10,57 +10,62 @@ import { kernel32 } from './_lib.js'
  * https://learn.microsoft.com/en-us/windows/win32/api/handleapi/nf-handleapi-closehandle
  *
  */
-export const CloseHandle: (
-    hObject: HANDLE
-) => number = /*#__PURE__*/kernel32.func('CloseHandle', cBOOL, [ cHANDLE ])
+export function CloseHandle(hObject: HANDLE): number {
+    CloseHandle.fn ??= kernel32.func('CloseHandle', cBOOL, [ cHANDLE ])
+    return CloseHandle.fn(hObject)
+}
+
+/** @internal */
+export declare namespace CloseHandle {
+    export var fn: koffi.KoffiFunc<(hObject: HANDLE) => number>
+}
 
 /**
  * Opens an existing local process object.
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-openprocess
  */
-/*@__NO_SIDE_EFFECTS__*/
-export function OpenProcess(
-    dwDesiredAccess: PSAR_ | number,
-    bInheritHandle: boolean,
-    dwProcessId: number
-): HANDLE | null {
-    return _OpenProcess(dwDesiredAccess, Number(bInheritHandle), dwProcessId)
+export function OpenProcess(dwDesiredAccess: PSAR_ | number, bInheritHandle: boolean, dwProcessId: number): HANDLE | null {
+    OpenProcess.fn ??= kernel32.func('OpenProcess', cHANDLE, [ cDWORD, cBOOL, cDWORD ])
+    return OpenProcess.fn(dwDesiredAccess, Number(bInheritHandle), dwProcessId)
 }
 
-const _OpenProcess: (
-    dwDesiredAccess: PSAR_ | number,
-    bInheritHandle: number,
-    dwProcessId: number
-) => HANDLE = /*#__PURE__*/kernel32.func('OpenProcess', cHANDLE, [ cDWORD, cBOOL, cDWORD ])
+/** @internal */
+export declare namespace OpenProcess {
+    export var fn: koffi.KoffiFunc<(dwDesiredAccess: PSAR_ | number, bInheritHandle: number, dwProcessId: number) => HANDLE>
+}
 
 /**
  * Retrieves a pseudo handle for the current process.
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-getcurrentprocess
  */
-export const GetCurrentProcess: () => HANDLE = /*#__PURE__*/kernel32.func('GetCurrentProcess', cHANDLE, [])
+export function GetCurrentProcess(): HANDLE {
+    GetCurrentProcess.fn ??= kernel32.func('GetCurrentProcess', cHANDLE, [])
+    return GetCurrentProcess.fn()
+}
+
+/** @internal */
+export declare namespace GetCurrentProcess {
+    export var fn: koffi.KoffiFunc<() => HANDLE>
+}
 
 /**
  * Retrieves the full name of the executable image for the specified process.
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-queryfullprocessimagenamew
  */
-/*#__NO_SIDE_EFFECTS__*/
-export function QueryFullProcessImageName(
-    hProcess: HANDLE,
-    dwFlags: number
-): string | null {
+export function QueryFullProcessImageName(hProcess: HANDLE, dwFlags: number): string | null {
+    QueryFullProcessImageName.fn ??= kernel32.func('QueryFullProcessImageNameW', cBOOL, [ cHANDLE, cDWORD, koffi.out(cLPWSTR), koffi.inout(cLPDWORD) ])
+
     const exeName = new Uint16Array(256)
-    const dwSize: [ number ]  = [ exeName.length ]
-    return _QueryFullProcessImageNameW(hProcess, dwFlags, exeName, dwSize) === 0
+    const dwSize: INT_PTR = [ exeName.length ]
+    return QueryFullProcessImageName.fn(hProcess, dwFlags, exeName, dwSize) === 0
         ? null
         : textDecoder.decode(exeName.slice(0, dwSize[0]))
 }
 
-const _QueryFullProcessImageNameW: (
-    hProcess: HANDLE,
-    dwFlags: number,
-    lpExeName: Uint16Array,
-    lpdwSize: [ number ]
-) => number = /*#__PURE__*/kernel32.func('QueryFullProcessImageNameW', cBOOL, [ cHANDLE, cDWORD, koffi.out(cLPWSTR), koffi.inout(cLPDWORD) ])
+/** @internal */
+export declare namespace QueryFullProcessImageName {
+    export var fn: koffi.KoffiFunc<(hProcess: HANDLE, dwFlags: number, lpExeName: Uint16Array, lpdwSize: INT_PTR) => number>
+}

source/win32/private.ts

@@ -28,3 +28,6 @@ export class Win32Dll implements Disposable {
         return /*#__PURE__*/this.#lib.func(name, result, parameters)
     }
 }
+
+export type POINTER<T> = [ T ]
+export type INT_PTR = POINTER<number>

source/win32/shell32/notifyicon.ts

@@ -53,7 +53,12 @@ export const cNOTIFYICONDATA = koffi.struct({
  *
  * https://learn.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shell_notifyiconw
  */
-export const Shell_NotifyIcon: (
-    dwMessage: NIM_ | number,
-    data: NOTIFYICONDATA
-) => number = /*#__PURE__*/shell32.func('Shell_NotifyIconW', cBOOL, [ cDWORD, cNOTIFYICONDATA ])
+export function Shell_NotifyIcon(dwMessage: NIM_ | number, data: NOTIFYICONDATA): number {
+    Shell_NotifyIcon.fn ??= shell32.func('Shell_NotifyIconW', cBOOL, [ cDWORD, cNOTIFYICONDATA ])
+    return Shell_NotifyIcon.fn(dwMessage, data)
+}
+
+/** @internal */
+export declare namespace Shell_NotifyIcon {
+    export var fn: koffi.KoffiFunc<(dwMessage: NIM_ | number, data: NOTIFYICONDATA) => number>
+}