@bun-win32/shell32 1.0.0

package/types/Shell32.ts

@@ -0,0 +1,500 @@
+import type { Pointer } from 'bun:ffi';
+
+// ---------------------------------------------------------------------------
+// Win32 type aliases
+//
+// These map Win32 C types to their Bun FFI equivalents:
+//   - Handles (HANDLE, HWND, HICON, HDROP, etc.) → bigint (FFIType.u64)
+//   - Booleans (BOOL) → number (FFIType.i32)
+//   - Unsigned 32-bit (DWORD, UINT) → number (FFIType.u32)
+//   - Signed 32-bit (HRESULT, INT, LONG) → number (FFIType.i32)
+//   - 64-bit integers (SIZE_T, DWORD_PTR, UINT_PTR) → bigint (FFIType.u64)
+//   - Signed 64-bit (INT_PTR, LPARAM, LRESULT) → bigint (FFIType.i64)
+//   - Pointers (LP*, P*, PCIDLIST_*, PIDLIST_*) → Pointer (FFIType.ptr)
+//
+// Add types here in alphabetical order as needed by structs/Shell32.ts.
+// Export enums for flag/constant groups used by callers.
+// ---------------------------------------------------------------------------
+
+export enum AppBarEdge {
+  ABE_BOTTOM = 3,
+  ABE_LEFT = 0,
+  ABE_RIGHT = 2,
+  ABE_TOP = 1,
+}
+
+export enum AppBarMessage {
+  ABM_ACTIVATE = 0x0000_0006,
+  ABM_GETAUTOHIDEBAR = 0x0000_0007,
+  ABM_GETAUTOHIDEBAREX = 0x0000_000B,
+  ABM_GETSTATE = 0x0000_0004,
+  ABM_GETTASKBARPOS = 0x0000_0005,
+  ABM_NEW = 0x0000_0000,
+  ABM_QUERYPOS = 0x0000_0002,
+  ABM_REMOVE = 0x0000_0001,
+  ABM_SETAUTOHIDEBAR = 0x0000_0008,
+  ABM_SETAUTOHIDEBAREX = 0x0000_000C,
+  ABM_SETPOS = 0x0000_0003,
+  ABM_WINDOWPOSCHANGED = 0x0000_0009,
+}
+
+export enum ChangeNotifyEvents {
+  SHCNE_ALLEVENTS = 0x7FFF_FFFF,
+  SHCNE_ASSOCCHANGED = 0x0800_0000,
+  SHCNE_ATTRIBUTES = 0x0000_0800,
+  SHCNE_CREATE = 0x0000_0002,
+  SHCNE_DELETE = 0x0000_0004,
+  SHCNE_DRIVEADD = 0x0000_0100,
+  SHCNE_DRIVEADDGUI = 0x0001_0000,
+  SHCNE_DRIVEREMOVED = 0x0000_0080,
+  SHCNE_EXTENDED_EVENT = 0x0400_0000,
+  SHCNE_FREESPACE = 0x0004_0000,
+  SHCNE_MEDIAINSERTED = 0x0000_0020,
+  SHCNE_MEDIAREMOVED = 0x0000_0040,
+  SHCNE_MKDIR = 0x0000_0008,
+  SHCNE_NETSHARE = 0x0000_0200,
+  SHCNE_NETUNSHARE = 0x0000_0400,
+  SHCNE_RENAMEFOLDER = 0x0002_0000,
+  SHCNE_RENAMEITEM = 0x0000_0001,
+  SHCNE_RMDIR = 0x0000_0010,
+  SHCNE_SERVERDISCONNECT = 0x0000_4000,
+  SHCNE_UPDATEDIR = 0x0000_1000,
+  SHCNE_UPDATEIMAGE = 0x0000_8000,
+  SHCNE_UPDATEITEM = 0x0000_2000,
+}
+
+export enum ChangeNotifyFlags {
+  SHCNF_DWORD = 0x0000_0003,
+  SHCNF_FLUSH = 0x0000_1000,
+  SHCNF_FLUSHNOWAIT = 0x0000_3000,
+  SHCNF_IDLIST = 0x0000_0000,
+  SHCNF_PATHA = 0x0000_0001,
+  SHCNF_PATHW = 0x0000_0005,
+  SHCNF_PRINTERA = 0x0000_0002,
+  SHCNF_PRINTERW = 0x0000_0006,
+}
+
+export enum ChangeNotifyRegisterFlags {
+  SHCNRF_INTERRUPTLEVEL = 0x0001,
+  SHCNRF_NEWDELIVERY = 0x8000,
+  SHCNRF_RECURSIVEINTERRUPT = 0x1000,
+  SHCNRF_SHELLLEVEL = 0x0002,
+}
+
+export enum CSIDL {
+  CSIDL_ADMINTOOLS = 0x0030,
+  CSIDL_APPDATA = 0x001A,
+  CSIDL_BITBUCKET = 0x000A,
+  CSIDL_CDBURN_AREA = 0x003B,
+  CSIDL_COMMON_ADMINTOOLS = 0x002F,
+  CSIDL_COMMON_APPDATA = 0x0023,
+  CSIDL_COMMON_DESKTOPDIRECTORY = 0x0019,
+  CSIDL_COMMON_DOCUMENTS = 0x002E,
+  CSIDL_COMMON_FAVORITES = 0x001F,
+  CSIDL_COMMON_MUSIC = 0x0035,
+  CSIDL_COMMON_OEM_LINKS = 0x003A,
+  CSIDL_COMMON_PICTURES = 0x0036,
+  CSIDL_COMMON_PROGRAMS = 0x0017,
+  CSIDL_COMMON_STARTMENU = 0x0016,
+  CSIDL_COMMON_STARTUP = 0x0018,
+  CSIDL_COMMON_TEMPLATES = 0x002D,
+  CSIDL_COMMON_VIDEO = 0x0037,
+  CSIDL_COMPUTERSNEARME = 0x003D,
+  CSIDL_CONNECTIONS = 0x0031,
+  CSIDL_CONTROLS = 0x0003,
+  CSIDL_COOKIES = 0x0021,
+  CSIDL_DESKTOP = 0x0000,
+  CSIDL_DESKTOPDIRECTORY = 0x0010,
+  CSIDL_DRIVES = 0x0011,
+  CSIDL_FAVORITES = 0x0006,
+  CSIDL_FLAG_CREATE = 0x8000,
+  CSIDL_FLAG_DONT_UNEXPAND = 0x2000,
+  CSIDL_FLAG_DONT_VERIFY = 0x4000,
+  CSIDL_FLAG_NO_ALIAS = 0x1000,
+  CSIDL_FLAG_PER_USER_INIT = 0x0800,
+  CSIDL_FONTS = 0x0014,
+  CSIDL_HISTORY = 0x0022,
+  CSIDL_INTERNET = 0x0001,
+  CSIDL_INTERNET_CACHE = 0x0020,
+  CSIDL_LOCAL_APPDATA = 0x001C,
+  CSIDL_MYDOCUMENTS = 0x000C,
+  CSIDL_MYMUSIC = 0x000D,
+  CSIDL_MYPICTURES = 0x0027,
+  CSIDL_MYVIDEO = 0x000E,
+  CSIDL_NETHOOD = 0x0013,
+  CSIDL_NETWORK = 0x0012,
+  CSIDL_PERSONAL = 0x0005,
+  CSIDL_PRINTERS = 0x0004,
+  CSIDL_PRINTHOOD = 0x001B,
+  CSIDL_PROFILE = 0x0028,
+  CSIDL_PROGRAMS = 0x0002,
+  CSIDL_PROGRAM_FILES = 0x0026,
+  CSIDL_PROGRAM_FILES_COMMON = 0x002B,
+  CSIDL_PROGRAM_FILESX86 = 0x002A,
+  CSIDL_PROGRAM_FILES_COMMONX86 = 0x002C,
+  CSIDL_RECENT = 0x0008,
+  CSIDL_RESOURCES = 0x0038,
+  CSIDL_RESOURCES_LOCALIZED = 0x0039,
+  CSIDL_SENDTO = 0x0009,
+  CSIDL_STARTMENU = 0x000B,
+  CSIDL_STARTUP = 0x0007,
+  CSIDL_SYSTEM = 0x0025,
+  CSIDL_SYSTEMX86 = 0x0029,
+  CSIDL_TEMPLATES = 0x0015,
+  CSIDL_WINDOWS = 0x0024,
+}
+
+export enum FileOperationFlags {
+  FOF_ALLOWUNDO = 0x0040,
+  FOF_CONFIRMMOUSE = 0x0002,
+  FOF_FILESONLY = 0x0080,
+  FOF_MULTIDESTFILES = 0x0001,
+  FOF_NOCONFIRMATION = 0x0010,
+  FOF_NOCONFIRMMKDIR = 0x0200,
+  FOF_NOCOPYSECURITYATTRIBS = 0x0800,
+  FOF_NOERRORUI = 0x0400,
+  FOF_NORECURSEREPARSE = 0x8000,
+  FOF_NORECURSION = 0x1000,
+  FOF_NO_CONNECTED_ELEMENTS = 0x2000,
+  FOF_NO_UI = 0x0614,
+  FOF_RENAMEONCOLLISION = 0x0008,
+  FOF_SILENT = 0x0004,
+  FOF_SIMPLEPROGRESS = 0x0100,
+  FOF_WANTMAPPINGHANDLE = 0x0020,
+  FOF_WANTNUKEWARNING = 0x4000,
+}
+
+export enum FileOperationType {
+  FO_COPY = 0x0002,
+  FO_DELETE = 0x0003,
+  FO_MOVE = 0x0001,
+  FO_RENAME = 0x0004,
+}
+
+export enum KnownFolderFlag {
+  KF_FLAG_ALIAS_ONLY = 0x8000_0000,
+  KF_FLAG_CREATE = 0x0000_8000,
+  KF_FLAG_DEFAULT = 0x0000_0000,
+  KF_FLAG_DEFAULT_PATH = 0x0000_0400,
+  KF_FLAG_DONT_UNEXPAND = 0x0000_2000,
+  KF_FLAG_DONT_VERIFY = 0x0000_4000,
+  KF_FLAG_FORCE_APPCONTAINER_REDIRECTION = 0x0002_0000,
+  KF_FLAG_FORCE_APP_DATA_REDIRECTION = 0x0008_0000,
+  KF_FLAG_FORCE_PACKAGE_REDIRECTION = 0x0004_0000,
+  KF_FLAG_INIT = 0x0000_0800,
+  KF_FLAG_NOT_PARENT_RELATIVE = 0x0000_0200,
+  KF_FLAG_NO_ALIAS = 0x0000_1000,
+  KF_FLAG_NO_APPCONTAINER_REDIRECTION = 0x0001_0000,
+  KF_FLAG_NO_PACKAGE_REDIRECTION = 0x0001_0000,
+  KF_FLAG_RETURN_FILTER_REDIRECTION_TARGET = 0x0004_0000,
+  KF_FLAG_SIMPLE_IDLIST = 0x0000_0100,
+}
+
+export enum NotifyIconFlags {
+  NIF_GUID = 0x0000_0020,
+  NIF_ICON = 0x0000_0002,
+  NIF_INFO = 0x0000_0010,
+  NIF_MESSAGE = 0x0000_0001,
+  NIF_REALTIME = 0x0000_0040,
+  NIF_SHOWTIP = 0x0000_0080,
+  NIF_STATE = 0x0000_0008,
+  NIF_TIP = 0x0000_0004,
+}
+
+export enum NotifyIconMessage {
+  NIM_ADD = 0x0000_0000,
+  NIM_DELETE = 0x0000_0002,
+  NIM_MODIFY = 0x0000_0001,
+  NIM_SETFOCUS = 0x0000_0003,
+  NIM_SETVERSION = 0x0000_0004,
+}
+
+export enum QueryUserNotificationState {
+  QUNS_ACCEPTS_NOTIFICATIONS = 5,
+  QUNS_APP = 7,
+  QUNS_BUSY = 2,
+  QUNS_NOT_PRESENT = 1,
+  QUNS_PRESENTATION_MODE = 4,
+  QUNS_QUIET_TIME = 6,
+  QUNS_RUNNING_D3D_FULL_SCREEN = 3,
+}
+
+export enum SEE_MASK {
+  SEE_MASK_ASYNCOK = 0x0010_0000,
+  SEE_MASK_CLASSKEY = 0x0000_0003,
+  SEE_MASK_CLASSNAME = 0x0000_0001,
+  SEE_MASK_CONNECTNETDRV = 0x0000_0080,
+  SEE_MASK_DEFAULT = 0x0000_0000,
+  SEE_MASK_DOENVSUBST = 0x0000_0200,
+  SEE_MASK_FLAG_DDEWAIT = 0x0000_0100,
+  SEE_MASK_FLAG_HINST_IS_SITE = 0x0800_0000,
+  SEE_MASK_FLAG_LOG_USAGE = 0x0400_0000,
+  SEE_MASK_FLAG_NO_UI = 0x0000_0400,
+  SEE_MASK_HMONITOR = 0x0020_0000,
+  SEE_MASK_HOTKEY = 0x0000_0020,
+  SEE_MASK_ICON = 0x0000_0010,
+  SEE_MASK_IDLIST = 0x0000_0004,
+  SEE_MASK_INVOKEIDLIST = 0x0000_000C,
+  SEE_MASK_NOASYNC = 0x0000_0100,
+  SEE_MASK_NOCLOSEPROCESS = 0x0000_0040,
+  SEE_MASK_NOQUERYCLASSSTORE = 0x0100_0000,
+  SEE_MASK_NOZONECHECKS = 0x0080_0000,
+  SEE_MASK_NO_CONSOLE = 0x0000_8000,
+  SEE_MASK_UNICODE = 0x0000_4000,
+  SEE_MASK_WAITFORINPUTIDLE = 0x0200_0000,
+}
+
+export enum SHAddToRecentDocsFlags {
+  SHARD_APPIDINFO = 0x0000_0004,
+  SHARD_APPIDINFOIDLIST = 0x0000_0005,
+  SHARD_APPIDINFOLINK = 0x0000_0007,
+  SHARD_LINK = 0x0000_0006,
+  SHARD_PATHA = 0x0000_0002,
+  SHARD_PATHW = 0x0000_0003,
+  SHARD_PIDL = 0x0000_0001,
+  SHARD_SHELLITEM = 0x0000_0008,
+}
+
+export enum SHGetFileInfoFlags {
+  SHGFI_ADDOVERLAYS = 0x0000_0020,
+  SHGFI_ATTR_SPECIFIED = 0x0002_0000,
+  SHGFI_ATTRIBUTES = 0x0000_0800,
+  SHGFI_DISPLAYNAME = 0x0000_0200,
+  SHGFI_EXETYPE = 0x0000_2000,
+  SHGFI_ICON = 0x0000_0100,
+  SHGFI_ICONLOCATION = 0x0000_1000,
+  SHGFI_LARGEICON = 0x0000_0000,
+  SHGFI_LINKOVERLAY = 0x0000_8000,
+  SHGFI_OPENICON = 0x0000_0002,
+  SHGFI_OVERLAYINDEX = 0x0000_0040,
+  SHGFI_PIDL = 0x0000_0008,
+  SHGFI_SELECTED = 0x0001_0000,
+  SHGFI_SHELLICONSIZE = 0x0000_0004,
+  SHGFI_SMALLICON = 0x0000_0001,
+  SHGFI_SYSICONINDEX = 0x0000_4000,
+  SHGFI_TYPENAME = 0x0000_0400,
+  SHGFI_USEFILEATTRIBUTES = 0x0000_0010,
+}
+
+export enum ShowWindowCommand {
+  SW_FORCEMINIMIZE = 11,
+  SW_HIDE = 0,
+  SW_MAXIMIZE = 3,
+  SW_MINIMIZE = 6,
+  SW_NORMAL = 1,
+  SW_RESTORE = 9,
+  SW_SHOW = 5,
+  SW_SHOWDEFAULT = 10,
+  SW_SHOWMAXIMIZED = 3,
+  SW_SHOWMINIMIZED = 2,
+  SW_SHOWMINNOACTIVE = 7,
+  SW_SHOWNA = 8,
+  SW_SHOWNOACTIVATE = 4,
+  SW_SHOWNORMAL = 1,
+}
+
+export enum StockIconFlags {
+  SHGSI_ICON = 0x0000_0100,
+  SHGSI_ICONLOCATION = 0x0000_0000,
+  SHGSI_LARGEICON = 0x0000_0000,
+  SHGSI_LINKOVERLAY = 0x0000_8000,
+  SHGSI_SELECTED = 0x0001_0000,
+  SHGSI_SHELLICONSIZE = 0x0000_0004,
+  SHGSI_SMALLICON = 0x0000_0001,
+  SHGSI_SYSICONINDEX = 0x0000_4000,
+}
+
+export enum StockIconId {
+  SIID_APPLICATION = 2,
+  SIID_AUDIOFILES = 116,
+  SIID_AUTOLIST = 49,
+  SIID_CLUSTEREDDRIVE = 140,
+  SIID_COMPRESSED = 56,
+  SIID_DELETE = 84,
+  SIID_DESKTOPPC = 94,
+  SIID_DEVICEAUDIOPLAYER = 102,
+  SIID_DEVICECAMERA = 100,
+  SIID_DEVICECELLPHONE = 99,
+  SIID_DEVICEVIDEOCAMERA = 101,
+  SIID_DOCASSOC = 1,
+  SIID_DOCNOASSOC = 0,
+  SIID_DRIVE35 = 6,
+  SIID_DRIVE525 = 5,
+  SIID_DRIVECDROM = 11,
+  SIID_DRIVEDVD = 59,
+  SIID_DRIVEFIXED = 8,
+  SIID_DRIVENET = 9,
+  SIID_DRIVENETDISABLED = 10,
+  SIID_DRIVERAM = 12,
+  SIID_DRIVEREMOVE = 7,
+  SIID_DRIVEUNKNOWN = 58,
+  SIID_ENCRYPTED = 57,
+  SIID_ERROR = 80,
+  SIID_FIND = 22,
+  SIID_FOLDER = 3,
+  SIID_FOLDERBACK = 75,
+  SIID_FOLDERFRONT = 76,
+  SIID_FOLDEROPEN = 4,
+  SIID_HELP = 23,
+  SIID_IMAGEFILES = 117,
+  SIID_INFO = 79,
+  SIID_INTERNET = 13,
+  SIID_KEY = 77,
+  SIID_LINK = 29,
+  SIID_LOCK = 47,
+  SIID_MAX_ICONS = 181,
+  SIID_MEDIAAUDIODVD = 61,
+  SIID_MEDIABDR = 66,
+  SIID_MEDIABDRE = 68,
+  SIID_MEDIABDROM = 67,
+  SIID_MEDIABLANKCD = 65,
+  SIID_MEDIACDAUDIO = 40,
+  SIID_MEDIACDAUDIOPLUS = 62,
+  SIID_MEDIACDBURN = 42,
+  SIID_MEDIACDR = 64,
+  SIID_MEDIACDROM = 41,
+  SIID_MEDIACDRW = 43,
+  SIID_MEDIACOMPACTFLASH = 103,
+  SIID_MEDIADVD = 51,
+  SIID_MEDIADVDPLUSR = 55,
+  SIID_MEDIADVDPLUSRW = 54,
+  SIID_MEDIADVDR = 53,
+  SIID_MEDIADVDRAM = 52,
+  SIID_MEDIADVDROM = 60,
+  SIID_MEDIADVDRW = 44,
+  SIID_MEDIAENHANCEDCD = 63,
+  SIID_MEDIAENHANCEDDVD = 50,
+  SIID_MEDIAHDDVD = 69,
+  SIID_MEDIAHDDVDR = 71,
+  SIID_MEDIAHDDVDRAM = 72,
+  SIID_MEDIAHDDVDROM = 70,
+  SIID_MEDIAMOVIEDVD = 48,
+  SIID_MEDIASMARTMEDIA = 105,
+  SIID_MEDIAVCD = 73,
+  SIID_MOBILEPC = 95,
+  SIID_MYNETWORK = 17,
+  SIID_NETWORKCONNECT = 106,
+  SIID_PRINTER = 16,
+  SIID_PRINTERFAX = 20,
+  SIID_PRINTERFAXNET = 21,
+  SIID_PRINTERNET = 18,
+  SIID_RECYCLER = 31,
+  SIID_RECYCLERFULL = 32,
+  SIID_RENAME = 83,
+  SIID_SERVER = 15,
+  SIID_SERVERSHARE = 51,
+  SIID_SETTINGS = 106,
+  SIID_SHARE = 28,
+  SIID_SHIELD = 78,
+  SIID_SLOWFILE = 48,
+  SIID_SOFTWARE = 74,
+  SIID_STACK = 114,
+  SIID_STUFFEDFOLDER = 115,
+  SIID_USERS = 96,
+  SIID_VIDEOFILES = 118,
+  SIID_WARNING = 81,
+  SIID_WORLD = 13,
+  SIID_ZIPFILE = 105,
+}
+
+export type ASSOC_FILTER = number;
+export type BOOL = number;
+export type DWORD = number;
+export type DWORD_PTR = bigint;
+export type GETPROPERTYSTOREFLAGS = number;
+export type HANDLE = bigint;
+export type HDROP = bigint;
+export type HICON = bigint;
+export type HIMAGELIST = bigint;
+export type HINSTANCE = bigint;
+export type HKEY = bigint;
+export type HMENU = bigint;
+export type HPSXA = bigint;
+export type HRESULT = number;
+export type HWND = bigint;
+export type INT = number;
+export type INT_PTR = bigint;
+export type LONG = number;
+export type LPARAM = bigint;
+export type LPAUTO_SCROLL_DATA = Pointer;
+export type LPBROWSEINFOA = Pointer;
+export type LPBROWSEINFOW = Pointer;
+export type LPCITEMIDLIST = Pointer;
+export type LPCSFV = Pointer;
+export type LPCSHITEMID = Pointer;
+export type LPCSTR = Pointer;
+export type LPCVOID = Pointer;
+export type LPCWSTR = Pointer;
+export type LPDWORD = Pointer;
+export type LPFNADDPROPSHEETPAGE = Pointer;
+export type LPFNDFMCALLBACK = Pointer;
+export type LPITEMIDLIST = Pointer;
+export type LPPOINT = Pointer;
+export type LPRECT = Pointer;
+export type LPSECURITY_ATTRIBUTES = Pointer;
+export type LPSHCREATEPROCESSINFOW = Pointer;
+export type LPSHELLEXECUTEINFOA = Pointer;
+export type LPSHELLEXECUTEINFOW = Pointer;
+export type LPSHELLSTATE = Pointer;
+export type LPSHFOLDERCUSTOMSETTINGS = Pointer;
+export type LPSHFILEINFOA = Pointer;
+export type LPSHFILEINFOW = Pointer;
+export type LPSHFILEOPSTRUCTA = Pointer;
+export type LPSHFILEOPSTRUCTW = Pointer;
+export type LPSHELLFLAGSTATE = Pointer;
+export type LPSHSTOCKICONINFO = Pointer;
+export type LPSTR = Pointer;
+export type LPVOID = Pointer;
+export type LPWORD = Pointer;
+export type LPWSTR = Pointer;
+export type LRESULT = bigint;
+export type PAPPBARDATA = Pointer;
+export type PCABINETSTATE = Pointer;
+export type PCDEFCONTEXTMENU = Pointer;
+export type PCIDLIST_ABSOLUTE = Pointer;
+export type PCIDLIST_RELATIVE = Pointer;
+export type PCUITEMID_CHILD = Pointer;
+export type PCUITEMID_CHILD_ARRAY = Pointer;
+export type PCUIDLIST_RELATIVE = Pointer;
+export type PCUIDLIST_RELATIVE_ARRAY = Pointer;
+export type PDLLVERSIONINFO = Pointer;
+export type PIDLIST_ABSOLUTE = Pointer;
+export type PIDLIST_RELATIVE = Pointer;
+export type PNOTIFYICONIDENTIFIER = Pointer;
+export type PNOTIFYICONDATAA = Pointer;
+export type PNOTIFYICONDATAW = Pointer;
+export type POPENASINFO = Pointer;
+export type PSFV_CREATE = Pointer;
+export type PSHCHANGENOTIFYENTRY = Pointer;
+export type PSHQUERYRBINFO = Pointer;
+export type PUIDLIST_RELATIVE = Pointer;
+export type PUITEMID_CHILD = Pointer;
+export type PWSTR = Pointer;
+export type SFGAOF = number;
+export type SIGDN = number;
+export type SIZE_T = bigint;
+export type UINT = number;
+export type UINT_PTR = bigint;
+export type ULONG = number;
+export type VOID = void;
+export type WCHAR = number;
+export type WORD = number;
+
+export type NULL = null;
+
+/**
+ * A POINT struct packed into a 64-bit integer for by-value passing in the x64 ABI.
+ *
+ * On x64, `POINT` (8 bytes: two `LONG`s) is passed in a single register.
+ * Use `packPOINT(x, y)` to create one.
+ */
+export type PACKED_POINT = bigint;
+
+const _packBuf = Buffer.alloc(8);
+
+/** Pack two `LONG` values into a `PACKED_POINT` for Win32 functions that take `POINT` by value. */
+export function packPOINT(x: number, y: number): PACKED_POINT {
+  _packBuf.writeInt32LE(x, 0);
+  _packBuf.writeInt32LE(y, 4);
+  return _packBuf.readBigUInt64LE(0);
+}