appium-novawindows2-driver 1.1.21 → 1.1.22

package/build/lib/powershell/win32.js

@@ -7,812 +7,812 @@ exports.WIN32_HELPER_SCRIPT = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const dllPath = node_path_1.default.resolve(__dirname, '..', 'dll', 'Win32Helper.dll').replace(/\\/g, '\\\\');
 const dllDir = node_path_1.default.resolve(__dirname, '..', 'dll').replace(/\\/g, '\\\\');
-exports.WIN32_HELPER_SCRIPT = `
-# Win32Helper - Native Win32 helpers compiled as C# DLL
-# Provides: window management, MSAA property retrieval, process validation
-
-$dllPath = '${dllPath}'
-$dllDir = '${dllDir}'
-
-# Check if Win32Helper is already loaded
-if (-not ([System.Management.Automation.PSTypeName]'Win32Helper').Type) {
-
-    # Check if DLL exists
-    if (Test-Path $dllPath) {
-        Write-Output "Loading Win32Helper from existing DLL: $dllPath"
-        Add-Type -Path $dllPath -ErrorAction Stop
-    } else {
-        Write-Output "Compiling Win32Helper.dll..."
-
-        # Create DLL directory if it doesn't exist
-        if (-not (Test-Path $dllDir)) {
-            New-Item -ItemType Directory -Path $dllDir -Force | Out-Null
-        }
-
-        # C# source code
-        $code = @'
-using System;
-using System.Runtime.InteropServices;
-using System.Collections;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Reflection;
-using System.Runtime.ExceptionServices;
-using System.Security;
-using System.Threading;
-
-/// <summary>
-/// Native Win32 helper for Appium Windows driver.
-///
-/// Window management:
-///   BringToForeground, SetTopMost, ClearTopMost, MinimizeWindow, RestoreWindow,
-///   IsMinimized, IsVisible, GetWindowText, GetWindowRect, GetWindowProcessId
-///
-/// MSAA property retrieval (with built-in safety):
-///   SetExpectedPid           - set expected PID + optional BringToForeground
-///   GetLegacyProperty    - single property via hwnd (AccessibleObjectFromWindow)
-///   GetLegacyPropertyWithFallback - hwnd -> PID check -> point fallback
-///   GetLegacyPropsWithFallback    - batch: all 9 MSAA properties
-/// </summary>
-public static class Win32Helper {
-
-    // ==================================================================
-    // P/Invoke - MSAA (oleacc.dll)
-    // ==================================================================
-
-    [DllImport("oleacc.dll")]
-    private static extern int AccessibleObjectFromWindow(
-        IntPtr hwnd, uint dwId, ref Guid riid,
-        [MarshalAs(UnmanagedType.Interface)] out object ppvObject);
-
-    [DllImport("oleacc.dll")]
-    private static extern int AccessibleObjectFromPoint(
-        POINT pt,
-        [MarshalAs(UnmanagedType.Interface)] out object ppacc,
-        [MarshalAs(UnmanagedType.Struct)] out object pvarChild);
-
-    // ==================================================================
-    // P/Invoke - Window management (user32.dll)
-    // ==================================================================
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetForegroundWindow();
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool SetForegroundWindow(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool BringWindowToTop(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool IsIconic(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool IsWindowVisible(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool IsWindow(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool AttachThreadInput(uint idAttach, uint idAttachTo, bool fAttach);
-
-    [DllImport("user32.dll")]
-    private static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr WindowFromPoint(POINT pt);
-
-    [DllImport("user32.dll")]
-    private static extern uint SendInput(uint nInputs, INPUT[] pInputs, int cbSize);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter,
-        int X, int Y, int cx, int cy, uint uFlags);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool SystemParametersInfo(uint uiAction, uint uiParam, ref uint pvParam, uint fWinIni);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder lpString, int nMaxCount);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
-
-    [DllImport("kernel32.dll")]
-    private static extern uint GetCurrentThreadId();
-
-    // ==================================================================
-    // Structs and constants
-    // ==================================================================
-
-    [StructLayout(LayoutKind.Sequential)]
-    public struct POINT { public int x; public int y; }
-
-    [StructLayout(LayoutKind.Sequential)]
-    public struct RECT { public int Left; public int Top; public int Right; public int Bottom; }
-
-    [StructLayout(LayoutKind.Sequential)]
-    private struct INPUT {
-        public uint type;
-        public INPUTUNION u;
-    }
-
-    [StructLayout(LayoutKind.Explicit)]
-    private struct INPUTUNION {
-        [FieldOffset(0)] public KEYBDINPUT ki;
-    }
-
-    [StructLayout(LayoutKind.Sequential)]
-    private struct KEYBDINPUT {
-        public ushort wVk;
-        public ushort wScan;
-        public uint dwFlags;
-        public uint time;
-        public IntPtr dwExtraInfo;
-    }
-
-    private const int SW_MINIMIZE = 6;
-    private const int SW_RESTORE = 9;
-    private const int SW_SHOW = 5;
-    private const ushort VK_MENU = 0xA4;
-    private const uint INPUT_KEYBOARD = 1;
-    private const uint KEYEVENTF_KEYUP = 0x0002;
-    private const uint SWP_NOMOVE = 0x0002;
-    private const uint SWP_NOSIZE = 0x0001;
-    private const uint SWP_SHOWWINDOW = 0x0040;
-    private const uint SPI_GETFOREGROUNDLOCKTIMEOUT = 0x2000;
-    private const uint SPI_SETFOREGROUNDLOCKTIMEOUT = 0x2001;
-    private const uint SPIF_SENDWININICHANGE = 0x02;
-    private static readonly IntPtr HWND_TOPMOST = new IntPtr(-1);
-    private static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-2);
-
-    // Context for MSAA queries - set via SetExpectedPid() before calling GetLegacy* methods
-    private static uint _expectedPid = 0;
-
-    // ==================================================================
-    // Context setup - call before MSAA queries
-    // ==================================================================
-
-    /// <summary>
-    /// Set expected process ID for MSAA point-based queries.
-    /// AccessibleObjectFromPoint will be skipped if the window at the target
-    /// coordinates belongs to a different process.
-    /// </summary>
-    public static void SetExpectedPid(uint expectedPid) {
-        _expectedPid = expectedPid;
-    }
-
-    /// <summary>
-    /// Set expected PID and bring the ancestor window to foreground.
-    /// Call before GetLegacyPropsWithFallback for getProperty("all").
-    /// </summary>
-    public static void SetExpectedPidAndForeground(uint expectedPid, IntPtr ancestorHwnd) {
-        _expectedPid = expectedPid;
-        if (ancestorHwnd != IntPtr.Zero) {
-            BringToForeground(ancestorHwnd);
-        }
-    }
-
-    // ==================================================================
-    // Window management
-    // ==================================================================
-
-    /// <summary>
-    /// Force a window to foreground even from a background process.
-    /// Uses escalating strategies modeled after AutoHotkey WinActivate:
-    ///   1. Restore if minimized
-    ///   2. AttachThreadInput to foreground + target threads
-    ///   3. Retry loop: SetForegroundWindow + BringWindowToTop
-    ///   4. SendInput ALT key (satisfies "last input" requirement)
-    ///   5. SPI_SETFOREGROUNDLOCKTIMEOUT = 0 (temporarily disable lock)
-    ///   6. HWND_TOPMOST toggle (last resort Z-order force)
-    /// </summary>
-    public static bool BringToForeground(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero || !IsWindow(hwnd)) return false;
-        if (GetForegroundWindow() == hwnd) return true;
-        if (IsIconic(hwnd)) ShowWindow(hwnd, SW_RESTORE);
-
-        uint unusedPid = 0;
-        uint curThread = GetCurrentThreadId();
-        IntPtr foreWnd = GetForegroundWindow();
-        uint foreThread = GetWindowThreadProcessId(foreWnd, out unusedPid);
-        uint targetThread = GetWindowThreadProcessId(hwnd, out unusedPid);
-
-        bool attachedCurFore = false;
-        bool attachedForeTarget = false;
-
-        try {
-            if (curThread != foreThread)
-                attachedCurFore = AttachThreadInput(curThread, foreThread, true);
-            if (foreThread != targetThread)
-                attachedForeTarget = AttachThreadInput(foreThread, targetThread, true);
-
-            // Retry with escalation
-            for (int attempt = 0; attempt < 5; attempt++) {
-                BringWindowToTop(hwnd);
-                ShowWindow(hwnd, SW_SHOW);
-                SetForegroundWindow(hwnd);
-                Thread.Sleep(10);
-                if (GetForegroundWindow() == hwnd) return true;
-
-                // ALT key trick via SendInput
-                SendAltKey(false);
-                SendAltKey(true);
-                SetForegroundWindow(hwnd);
-                Thread.Sleep(10);
-                if (GetForegroundWindow() == hwnd) return true;
-            }
-
-            // Temporarily disable foreground lock timeout
-            uint lockTimeout = 0;
-            SystemParametersInfo(SPI_GETFOREGROUNDLOCKTIMEOUT, 0, ref lockTimeout, 0);
-            if (lockTimeout > 0) {
-                uint zero = 0;
-                SystemParametersInfo(SPI_SETFOREGROUNDLOCKTIMEOUT, 0, ref zero, SPIF_SENDWININICHANGE);
-                SetForegroundWindow(hwnd);
-                BringWindowToTop(hwnd);
-                ShowWindow(hwnd, SW_SHOW);
-                SystemParametersInfo(SPI_SETFOREGROUNDLOCKTIMEOUT, 0, ref lockTimeout, SPIF_SENDWININICHANGE);
-                Thread.Sleep(10);
-                if (GetForegroundWindow() == hwnd) return true;
-            }
-
-            // Last resort: TOPMOST toggle
-            SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
-            SetWindowPos(hwnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
-            return GetForegroundWindow() == hwnd;
-        } catch {
-            return false;
-        } finally {
-            if (attachedCurFore) AttachThreadInput(curThread, foreThread, false);
-            if (attachedForeTarget) AttachThreadInput(foreThread, targetThread, false);
-        }
-    }
-
-    /// <summary>Set window as always-on-top.</summary>
-    public static bool SetTopMost(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
-    }
-
-    /// <summary>Remove always-on-top from window.</summary>
-    public static bool ClearTopMost(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return SetWindowPos(hwnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
-    }
-
-    public static bool MinimizeWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return ShowWindow(hwnd, SW_MINIMIZE);
-    }
-
-    public static bool RestoreWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return ShowWindow(hwnd, SW_RESTORE);
-    }
-
-    public static bool IsMinimized(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return IsIconic(hwnd);
-    }
-
-    public static bool IsVisible(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return IsWindowVisible(hwnd);
-    }
-
-    public static string GetText(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return null;
-        System.Text.StringBuilder sb = new System.Text.StringBuilder(512);
-        GetWindowText(hwnd, sb, sb.Capacity);
-        string text = sb.ToString();
-        return text.Length > 0 ? text : null;
-    }
-
-    public static RECT GetRect(IntPtr hwnd) {
-        RECT rect;
-        rect.Left = 0; rect.Top = 0; rect.Right = 0; rect.Bottom = 0;
-        if (hwnd != IntPtr.Zero) GetWindowRect(hwnd, out rect);
-        return rect;
-    }
-
-    public static uint GetProcessId(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return 0;
-        uint pid = 0;
-        GetWindowThreadProcessId(hwnd, out pid);
-        return pid;
-    }
-
-    // ==================================================================
-    // Window enumeration (for scope-session)
-    // ==================================================================
-
-    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
-
-    [DllImport("user32.dll")]
-    private static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder lpClassName, int nMaxCount);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, IntPtr wParam, System.Text.StringBuilder lParam, uint fuFlags, uint uTimeout, out IntPtr lpdwResult);
-
-    private const uint WM_GETTEXT = 0x000D;
-    private const uint SMTO_ABORTIFHUNG = 0x0002;
-    private const uint SMTO_BLOCK = 0x0001;
-
-    /// <summary>
-    /// Find a top-level window by exact Name and Win32 ClassName.
-    /// Uses EnumWindows + SendMessageTimeout(WM_GETTEXT) — avoids UIA FindFirst
-    /// which blocks for 20+ s against SecureAge's slow UIA provider.
-    /// Polls for up to timeoutMs milliseconds (pollMs interval). Returns IntPtr.Zero on timeout.
-    /// </summary>
-    public static IntPtr FindWindowByName(string targetName, string targetClass, int timeoutMs, int pollMs) {
-        var sw = Stopwatch.StartNew();
-        do {
-            var candidates = new List<IntPtr>();
-            EnumWindowsProc cb = (h, l) => {
-                if (!IsWindowVisible(h)) return true;
-                if (!string.IsNullOrEmpty(targetClass)) {
-                    var cls = new System.Text.StringBuilder(256);
-                    GetClassName(h, cls, 256);
-                    if (cls.ToString() != targetClass) return true;
-                }
-                candidates.Add(h);
-                return true;
-            };
-            EnumWindows(cb, IntPtr.Zero);
-            foreach (var h in candidates) {
-                var tb = new System.Text.StringBuilder(512);
-                IntPtr res = IntPtr.Zero;
-                IntPtr rc = SendMessageTimeout(h, WM_GETTEXT, (IntPtr)512, tb,
-                    SMTO_ABORTIFHUNG | SMTO_BLOCK, 500, out res);
-                if (rc != IntPtr.Zero && tb.ToString() == targetName) return h;
-            }
-            long elapsed = sw.ElapsedMilliseconds;
-            if (elapsed >= timeoutMs) break;
-            if (pollMs > 0) Thread.Sleep(Math.Min(pollMs, (int)(timeoutMs - elapsed)));
-        } while (true);
-        return IntPtr.Zero;
-    }
-
-    private static void SendAltKey(bool keyUp) {
-        INPUT input = new INPUT();
-        input.type = INPUT_KEYBOARD;
-        input.u.ki.wVk = VK_MENU;
-        input.u.ki.dwFlags = keyUp ? KEYEVENTF_KEYUP : (uint)0;
-        input.u.ki.dwExtraInfo = IntPtr.Zero;
-        SendInput(1, new INPUT[] { input }, Marshal.SizeOf(typeof(INPUT)));
-    }
-
-    // ==================================================================
-    // User32 extended API
-    //   Direct wrappers for common user32.dll functions, exposed to PS scripts
-    //   so test code can drive Win32 without writing Add-Type boilerplate.
-    //   All methods are null-safe (return IntPtr.Zero / false / empty on hwnd=0)
-    //   and read-only by default (control methods are named explicitly).
-    // ==================================================================
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern IntPtr FindWindowEx(IntPtr hwndParent, IntPtr hwndChildAfter, string lpszClass, string lpszWindow);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetDesktopWindow();
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetParent(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetWindow(IntPtr hWnd, uint uCmd);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetTopWindow(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr GetActiveWindow();
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool IsWindowEnabled(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool MoveWindow(IntPtr hWnd, int X, int Y, int nWidth, int nHeight, bool bRepaint);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool CloseWindow(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr PostMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
-
-    [DllImport("user32.dll")]
-    private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
-
-    [DllImport("user32.dll", CharSet = CharSet.Auto)]
-    private static extern int GetWindowTextLength(IntPtr hWnd);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool SetCursorPos(int X, int Y);
-
-    [DllImport("user32.dll")]
-    [return: MarshalAs(UnmanagedType.Bool)]
-    private static extern bool GetCursorPos(out POINT lpPoint);
-
-    [DllImport("user32.dll")]
-    private static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);
-
-    // ---- Window lookup ----
-
-    /// <summary>FindWindow(class, name) — instant lookup, no polling. Either arg may be null.</summary>
-    public static IntPtr FindWindowHandle(string className, string windowName) {
-        return FindWindow(className, windowName);
-    }
-
-    /// <summary>
-    /// FindWindow by class name only. Use this from PowerShell because passing
-    /// $null to the two-arg overload's windowName parameter gets marshaled as
-    /// an empty string, not a null pointer, causing FindWindow to return 0.
-    /// This overload calls FindWindow(className, null) in C#, where null is
-    /// real null and matches any window of the class.
-    /// </summary>
-    public static IntPtr FindWindowHandle(string className) {
-        return FindWindow(className, null);
-    }
-
-    /// <summary>FindWindowEx — find a child window. hwndParent and hwndChildAfter may be IntPtr.Zero.</summary>
-    public static IntPtr FindChildWindow(IntPtr hwndParent, IntPtr hwndChildAfter, string className, string windowName) {
-        return FindWindowEx(hwndParent, hwndChildAfter, className, windowName);
-    }
-
-    /// <summary>Desktop window handle (root of the window tree).</summary>
-    public static IntPtr GetDesktop() {
-        return GetDesktopWindow();
-    }
-
-    /// <summary>Window currently in the foreground (with focus).</summary>
-    public static IntPtr GetForeground() {
-        return GetForegroundWindow();
-    }
-
-    /// <summary>Active window of the calling thread.</summary>
-    public static IntPtr GetActive() {
-        return GetActiveWindow();
-    }
-
-    /// <summary>Top-level window at screen coordinates (x, y).</summary>
-    public static IntPtr WindowAtPoint(int x, int y) {
-        POINT p; p.x = x; p.y = y;
-        return WindowFromPoint(p);
-    }
-
-    // ---- Window traversal ----
-
-    /// <summary>Parent of hwnd, or IntPtr.Zero if it has none / hwnd is invalid.</summary>
-    public static IntPtr GetParentWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
-        return GetParent(hwnd);
-    }
-
-    /// <summary>
-    /// GetWindow relation — cmd values:
-    ///   0 GW_HWNDFIRST, 1 GW_HWNDLAST, 2 GW_HWNDNEXT, 3 GW_HWNDPREV,
-    ///   4 GW_OWNER, 5 GW_CHILD, 6 GW_ENABLEDPOPUP
-    /// </summary>
-    public static IntPtr GetRelatedWindow(IntPtr hwnd, uint cmd) {
-        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
-        return GetWindow(hwnd, cmd);
-    }
-
-    /// <summary>Top-most child of parent in Z-order (parent=IntPtr.Zero for desktop).</summary>
-    public static IntPtr GetTopChild(IntPtr parent) {
-        return GetTopWindow(parent);
-    }
-
-    /// <summary>All visible+invisible top-level windows in Z-order (front first).</summary>
-    public static IntPtr[] EnumTopLevelWindows() {
-        var list = new List<IntPtr>();
-        EnumWindowsProc cb = (h, l) => { list.Add(h); return true; };
-        EnumWindows(cb, IntPtr.Zero);
-        return list.ToArray();
-    }
-
-    /// <summary>All direct + descendant children of parent.</summary>
-    public static IntPtr[] EnumChildren(IntPtr parent) {
-        if (parent == IntPtr.Zero) return new IntPtr[0];
-        var list = new List<IntPtr>();
-        EnumWindowsProc cb = (h, l) => { list.Add(h); return true; };
-        EnumChildWindows(parent, cb, IntPtr.Zero);
-        return list.ToArray();
-    }
-
-    // ---- Window state ----
-
-    /// <summary>True if hwnd identifies an existing window.</summary>
-    public static bool IsValidWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return IsWindow(hwnd);
-    }
-
-    /// <summary>True if the window accepts mouse and keyboard input.</summary>
-    public static bool IsEnabled(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return IsWindowEnabled(hwnd);
-    }
-
-    /// <summary>Win32 class name of a window (the ClassName property in UIA).</summary>
-    public static string GetClassNameOf(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return null;
-        var sb = new System.Text.StringBuilder(256);
-        GetClassName(hwnd, sb, 256);
-        return sb.ToString();
-    }
-
-    /// <summary>Length of the window title in characters (does not block).</summary>
-    public static int GetTextLength(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return 0;
-        return GetWindowTextLength(hwnd);
-    }
-
-    // ---- Window control ----
-
-    /// <summary>
-    /// ShowWindow — cmd values:
-    ///   0 SW_HIDE, 1 SW_SHOWNORMAL, 2 SW_SHOWMINIMIZED, 3 SW_MAXIMIZE,
-    ///   4 SW_SHOWNOACTIVATE, 5 SW_SHOW, 6 SW_MINIMIZE, 7 SW_SHOWMINNOACTIVE,
-    ///   8 SW_SHOWNA, 9 SW_RESTORE, 10 SW_SHOWDEFAULT, 11 SW_FORCEMINIMIZE
-    /// </summary>
-    public static bool Show(IntPtr hwnd, int cmd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return ShowWindow(hwnd, cmd);
-    }
-
-    /// <summary>Maximize a window (SW_MAXIMIZE).</summary>
-    public static bool MaximizeWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return ShowWindow(hwnd, 3);
-    }
-
-    /// <summary>Hide a window (SW_HIDE — process keeps running, window disappears).</summary>
-    public static bool HideWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return ShowWindow(hwnd, 0);
-    }
-
-    /// <summary>Move + resize a window in screen coordinates.</summary>
-    public static bool Move(IntPtr hwnd, int x, int y, int width, int height, bool repaint) {
-        if (hwnd == IntPtr.Zero) return false;
-        return MoveWindow(hwnd, x, y, width, height, repaint);
-    }
-
-    /// <summary>SetWindowPos — flexible reposition / Z-order change. See MSDN for hwndInsertAfter and flags.</summary>
-    public static bool SetPos(IntPtr hwnd, IntPtr hwndInsertAfter, int x, int y, int cx, int cy, uint flags) {
-        if (hwnd == IntPtr.Zero) return false;
-        return SetWindowPos(hwnd, hwndInsertAfter, x, y, cx, cy, flags);
-    }
-
-    /// <summary>Win32 CloseWindow — confusingly, this MINIMIZES the window (it does not destroy it).</summary>
-    public static bool MinimizeViaCloseWindow(IntPtr hwnd) {
-        if (hwnd == IntPtr.Zero) return false;
-        return CloseWindow(hwnd);
-    }
-
-    // ---- Messages ----
-
-    /// <summary>PostMessage — fire-and-forget. Returns true if posted (non-zero return).</summary>
-    public static bool Post(IntPtr hwnd, uint msg, IntPtr wParam, IntPtr lParam) {
-        if (hwnd == IntPtr.Zero) return false;
-        return PostMessage(hwnd, msg, wParam, lParam) != IntPtr.Zero;
-    }
-
-    /// <summary>SendMessage — blocks until the receiving window's message procedure returns.</summary>
-    public static IntPtr Send(IntPtr hwnd, uint msg, IntPtr wParam, IntPtr lParam) {
-        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
-        return SendMessage(hwnd, msg, wParam, lParam);
-    }
-
-    // ---- Cursor ----
-
-    /// <summary>Move OS cursor to screen coordinates.</summary>
-    public static bool MoveCursor(int x, int y) {
-        return SetCursorPos(x, y);
-    }
-
-    /// <summary>Current OS cursor position in screen coordinates.</summary>
-    public static POINT GetCursor() {
-        POINT p; p.x = 0; p.y = 0;
-        GetCursorPos(out p);
-        return p;
-    }
-
-    // ==================================================================
-    // MSAA property retrieval
-    // ==================================================================
-
-    private static bool PointBelongsToExpectedProcess(int x, int y) {
-        if (_expectedPid == 0 || (x == 0 && y == 0)) return true;
-        try {
-            POINT pt; pt.x = x; pt.y = y;
-            IntPtr hWnd = WindowFromPoint(pt);
-            if (hWnd == IntPtr.Zero) return true;
-            uint pidAtPoint = 0;
-            GetWindowThreadProcessId(hWnd, out pidAtPoint);
-            return pidAtPoint == 0 || pidAtPoint == _expectedPid;
-        } catch { return true; }
-    }
-
-    private static string ResolveMemberName(string propertyName, out object[] args) {
-        args = new object[] { (int)0 };
-        switch(propertyName.ToLower()) {
-            case "name": return "accName";
-            case "value": return "accValue";
-            case "description": return "accDescription";
-            case "role": return "accRole";
-            case "state": return "accState";
-            case "help": return "accHelp";
-            case "keyboardshortcut": return "accKeyboardShortcut";
-            case "defaultaction": return "accDefaultAction";
-            case "focus": args = null; return "accFocus";
-            case "selection": args = null; return "accSelection";
-            default: return null;
-        }
-    }
-
-    /// <summary>
-    /// Get MSAA property via AccessibleObjectFromWindow (hwnd-based, no screen coords).
-    /// </summary>
-    [HandleProcessCorruptedStateExceptions]
-    [SecurityCritical]
-    public static object GetLegacyProperty(IntPtr hwnd, string propertyName) {
-        if (hwnd == IntPtr.Zero) return null;
-        Guid IID_IAccessible = new Guid("618736E0-3C3D-11CF-810C-00AA00389B71");
-        object accObj = null;
-        try {
-            int res = AccessibleObjectFromWindow(hwnd, 0xFFFFFFFC, ref IID_IAccessible, out accObj);
-            if (res == 0 && accObj != null) {
-                object[] args;
-                string memberName = ResolveMemberName(propertyName, out args);
-                if (memberName == null) return null;
-                return accObj.GetType().InvokeMember(memberName,
-                    BindingFlags.GetProperty, null, accObj, args);
-            }
-        } catch { }
-        finally {
-            if (accObj != null) try { Marshal.ReleaseComObject(accObj); } catch { }
-        }
-        return null;
-    }
-
-    /// <summary>
-    /// Get MSAA property with cascading fallback:
-    ///   1. hwnd-based (AccessibleObjectFromWindow)
-    ///   2. PID validation (WindowFromPoint check)
-    ///   3. Point-based (AccessibleObjectFromPoint)
-    /// Call SetExpectedPid() first to set expected PID.
-    /// </summary>
-    [HandleProcessCorruptedStateExceptions]
-    [SecurityCritical]
-    public static object GetLegacyPropertyWithFallback(IntPtr hwnd, int x, int y, string propertyName) {
-        if (hwnd != IntPtr.Zero) {
-            object val = GetLegacyProperty(hwnd, propertyName);
-            if (val != null) return val;
-        }
-        if (!PointBelongsToExpectedProcess(x, y)) return null;
-        if (propertyName.ToLower() == "childid") { /* handled below */ }
-
-        POINT pt; pt.x = x; pt.y = y;
-        object accObj = null;
-        object childIdObj = null;
-        try {
-            int res = AccessibleObjectFromPoint(pt, out accObj, out childIdObj);
-            if (res == 0 && accObj != null) {
-                if (propertyName.ToLower() == "childid") return childIdObj;
-                object[] args;
-                string memberName = ResolveMemberName(propertyName, out args);
-                if (memberName == null) return null;
-                if (args != null) args = new object[] { childIdObj };
-                return accObj.GetType().InvokeMember(memberName,
-                    BindingFlags.GetProperty, null, accObj, args);
-            }
-        } catch { }
-        finally {
-            if (accObj != null) try { Marshal.ReleaseComObject(accObj); } catch { }
-        }
-        return null;
-    }
-
-    /// <summary>
-    /// Get all MSAA properties at once.
-    /// Call SetExpectedPid() first to set expected PID.
-    /// </summary>
-    [HandleProcessCorruptedStateExceptions]
-    [SecurityCritical]
-    public static Hashtable GetLegacyPropsWithFallback(IntPtr hwnd, int x, int y) {
-        Hashtable props = new Hashtable();
-        try {
-            string[] names = { "Name", "Value", "Description", "Role", "State",
-                               "Help", "KeyboardShortcut", "DefaultAction", "ChildId" };
-            foreach (string name in names) {
-                object val = GetLegacyPropertyWithFallback(hwnd, x, y, name);
-                if (val != null) props.Add(name, val);
-            }
-        } catch { }
-        return props;
-    }
-}
-
-public static class ConsoleHelper {
-    [DllImport("kernel32.dll", SetLastError = true)]
-    public static extern IntPtr GetStdHandle(int nStdHandle);
-    [DllImport("kernel32.dll", SetLastError = true)]
-    public static extern bool GetConsoleMode(IntPtr hConsoleHandle, out uint lpMode);
-    [DllImport("kernel32.dll", SetLastError = true)]
-    public static extern bool SetConsoleMode(IntPtr hConsoleHandle, uint dwMode);
-
-    public const int STD_INPUT_HANDLE = -10;
-    public const uint ENABLE_MOUSE_INPUT = 0x0010;
-    public const uint ENABLE_INSERT_MODE = 0x0020;
-    public const uint ENABLE_QUICK_EDIT_MODE = 0x0040;
-    public const uint ENABLE_EXTENDED_FLAGS = 0x0080;
-
-    public static void DisableConsoleInteractions() {
-        IntPtr consoleHandle = GetStdHandle(STD_INPUT_HANDLE);
-        uint mode;
-        if (GetConsoleMode(consoleHandle, out mode)) {
-            mode &= ~ENABLE_QUICK_EDIT_MODE;
-            mode &= ~ENABLE_INSERT_MODE;
-            mode &= ~ENABLE_MOUSE_INPUT;
-            mode |= ENABLE_EXTENDED_FLAGS;
-            SetConsoleMode(consoleHandle, mode);
-        }
-    }
-}
-'@
-
-        # Set TEMP and TMP to DLL directory to avoid permission issues
-        $originalTemp = $env:TEMP
-        $originalTmp = $env:TMP
-        $env:TEMP = $dllDir
-        $env:TMP = $dllDir
-
-        try {
-            # Compile the C# code to DLL
-            Add-Type -TypeDefinition $code -Language CSharp -ReferencedAssemblies @('System') -OutputAssembly $dllPath -ErrorAction Stop
-            Write-Output "Win32Helper.dll compiled successfully"
-
-            # Load the newly compiled DLL
-            Add-Type -Path $dllPath -ErrorAction Stop
-            Write-Output "Win32Helper.dll loaded successfully"
-        } catch {
-            Write-Output "Compilation failed, falling back to in-memory loading"
-            # Fallback: load in-memory if compilation fails
-            Add-Type -TypeDefinition $code -Language CSharp -ReferencedAssemblies @('System') -ErrorAction Stop
-        } finally {
-            # Restore original TEMP/TMP
-            $env:TEMP = $originalTemp
-            $env:TMP = $originalTmp
-        }
-    }
-}
-
-Write-Output "Win32Helper ready"
+exports.WIN32_HELPER_SCRIPT = `
+# Win32Helper - Native Win32 helpers compiled as C# DLL
+# Provides: window management, MSAA property retrieval, process validation
+
+$dllPath = '${dllPath}'
+$dllDir = '${dllDir}'
+
+# Check if Win32Helper is already loaded
+if (-not ([System.Management.Automation.PSTypeName]'Win32Helper').Type) {
+
+    # Check if DLL exists
+    if (Test-Path $dllPath) {
+        Write-Output "Loading Win32Helper from existing DLL: $dllPath"
+        Add-Type -Path $dllPath -ErrorAction Stop
+    } else {
+        Write-Output "Compiling Win32Helper.dll..."
+
+        # Create DLL directory if it doesn't exist
+        if (-not (Test-Path $dllDir)) {
+            New-Item -ItemType Directory -Path $dllDir -Force | Out-Null
+        }
+
+        # C# source code
+        $code = @'
+using System;
+using System.Runtime.InteropServices;
+using System.Collections;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Reflection;
+using System.Runtime.ExceptionServices;
+using System.Security;
+using System.Threading;
+
+/// <summary>
+/// Native Win32 helper for Appium Windows driver.
+///
+/// Window management:
+///   BringToForeground, SetTopMost, ClearTopMost, MinimizeWindow, RestoreWindow,
+///   IsMinimized, IsVisible, GetWindowText, GetWindowRect, GetWindowProcessId
+///
+/// MSAA property retrieval (with built-in safety):
+///   SetExpectedPid           - set expected PID + optional BringToForeground
+///   GetLegacyProperty    - single property via hwnd (AccessibleObjectFromWindow)
+///   GetLegacyPropertyWithFallback - hwnd -> PID check -> point fallback
+///   GetLegacyPropsWithFallback    - batch: all 9 MSAA properties
+/// </summary>
+public static class Win32Helper {
+
+    // ==================================================================
+    // P/Invoke - MSAA (oleacc.dll)
+    // ==================================================================
+
+    [DllImport("oleacc.dll")]
+    private static extern int AccessibleObjectFromWindow(
+        IntPtr hwnd, uint dwId, ref Guid riid,
+        [MarshalAs(UnmanagedType.Interface)] out object ppvObject);
+
+    [DllImport("oleacc.dll")]
+    private static extern int AccessibleObjectFromPoint(
+        POINT pt,
+        [MarshalAs(UnmanagedType.Interface)] out object ppacc,
+        [MarshalAs(UnmanagedType.Struct)] out object pvarChild);
+
+    // ==================================================================
+    // P/Invoke - Window management (user32.dll)
+    // ==================================================================
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetForegroundWindow();
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool SetForegroundWindow(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool BringWindowToTop(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool IsIconic(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool IsWindowVisible(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool IsWindow(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool AttachThreadInput(uint idAttach, uint idAttachTo, bool fAttach);
+
+    [DllImport("user32.dll")]
+    private static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr WindowFromPoint(POINT pt);
+
+    [DllImport("user32.dll")]
+    private static extern uint SendInput(uint nInputs, INPUT[] pInputs, int cbSize);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter,
+        int X, int Y, int cx, int cy, uint uFlags);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool SystemParametersInfo(uint uiAction, uint uiParam, ref uint pvParam, uint fWinIni);
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern int GetWindowText(IntPtr hWnd, System.Text.StringBuilder lpString, int nMaxCount);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool GetWindowRect(IntPtr hWnd, out RECT lpRect);
+
+    [DllImport("kernel32.dll")]
+    private static extern uint GetCurrentThreadId();
+
+    // ==================================================================
+    // Structs and constants
+    // ==================================================================
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct POINT { public int x; public int y; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct RECT { public int Left; public int Top; public int Right; public int Bottom; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct INPUT {
+        public uint type;
+        public INPUTUNION u;
+    }
+
+    [StructLayout(LayoutKind.Explicit)]
+    private struct INPUTUNION {
+        [FieldOffset(0)] public KEYBDINPUT ki;
+    }
+
+    [StructLayout(LayoutKind.Sequential)]
+    private struct KEYBDINPUT {
+        public ushort wVk;
+        public ushort wScan;
+        public uint dwFlags;
+        public uint time;
+        public IntPtr dwExtraInfo;
+    }
+
+    private const int SW_MINIMIZE = 6;
+    private const int SW_RESTORE = 9;
+    private const int SW_SHOW = 5;
+    private const ushort VK_MENU = 0xA4;
+    private const uint INPUT_KEYBOARD = 1;
+    private const uint KEYEVENTF_KEYUP = 0x0002;
+    private const uint SWP_NOMOVE = 0x0002;
+    private const uint SWP_NOSIZE = 0x0001;
+    private const uint SWP_SHOWWINDOW = 0x0040;
+    private const uint SPI_GETFOREGROUNDLOCKTIMEOUT = 0x2000;
+    private const uint SPI_SETFOREGROUNDLOCKTIMEOUT = 0x2001;
+    private const uint SPIF_SENDWININICHANGE = 0x02;
+    private static readonly IntPtr HWND_TOPMOST = new IntPtr(-1);
+    private static readonly IntPtr HWND_NOTOPMOST = new IntPtr(-2);
+
+    // Context for MSAA queries - set via SetExpectedPid() before calling GetLegacy* methods
+    private static uint _expectedPid = 0;
+
+    // ==================================================================
+    // Context setup - call before MSAA queries
+    // ==================================================================
+
+    /// <summary>
+    /// Set expected process ID for MSAA point-based queries.
+    /// AccessibleObjectFromPoint will be skipped if the window at the target
+    /// coordinates belongs to a different process.
+    /// </summary>
+    public static void SetExpectedPid(uint expectedPid) {
+        _expectedPid = expectedPid;
+    }
+
+    /// <summary>
+    /// Set expected PID and bring the ancestor window to foreground.
+    /// Call before GetLegacyPropsWithFallback for getProperty("all").
+    /// </summary>
+    public static void SetExpectedPidAndForeground(uint expectedPid, IntPtr ancestorHwnd) {
+        _expectedPid = expectedPid;
+        if (ancestorHwnd != IntPtr.Zero) {
+            BringToForeground(ancestorHwnd);
+        }
+    }
+
+    // ==================================================================
+    // Window management
+    // ==================================================================
+
+    /// <summary>
+    /// Force a window to foreground even from a background process.
+    /// Uses escalating strategies modeled after AutoHotkey WinActivate:
+    ///   1. Restore if minimized
+    ///   2. AttachThreadInput to foreground + target threads
+    ///   3. Retry loop: SetForegroundWindow + BringWindowToTop
+    ///   4. SendInput ALT key (satisfies "last input" requirement)
+    ///   5. SPI_SETFOREGROUNDLOCKTIMEOUT = 0 (temporarily disable lock)
+    ///   6. HWND_TOPMOST toggle (last resort Z-order force)
+    /// </summary>
+    public static bool BringToForeground(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero || !IsWindow(hwnd)) return false;
+        if (GetForegroundWindow() == hwnd) return true;
+        if (IsIconic(hwnd)) ShowWindow(hwnd, SW_RESTORE);
+
+        uint unusedPid = 0;
+        uint curThread = GetCurrentThreadId();
+        IntPtr foreWnd = GetForegroundWindow();
+        uint foreThread = GetWindowThreadProcessId(foreWnd, out unusedPid);
+        uint targetThread = GetWindowThreadProcessId(hwnd, out unusedPid);
+
+        bool attachedCurFore = false;
+        bool attachedForeTarget = false;
+
+        try {
+            if (curThread != foreThread)
+                attachedCurFore = AttachThreadInput(curThread, foreThread, true);
+            if (foreThread != targetThread)
+                attachedForeTarget = AttachThreadInput(foreThread, targetThread, true);
+
+            // Retry with escalation
+            for (int attempt = 0; attempt < 5; attempt++) {
+                BringWindowToTop(hwnd);
+                ShowWindow(hwnd, SW_SHOW);
+                SetForegroundWindow(hwnd);
+                Thread.Sleep(10);
+                if (GetForegroundWindow() == hwnd) return true;
+
+                // ALT key trick via SendInput
+                SendAltKey(false);
+                SendAltKey(true);
+                SetForegroundWindow(hwnd);
+                Thread.Sleep(10);
+                if (GetForegroundWindow() == hwnd) return true;
+            }
+
+            // Temporarily disable foreground lock timeout
+            uint lockTimeout = 0;
+            SystemParametersInfo(SPI_GETFOREGROUNDLOCKTIMEOUT, 0, ref lockTimeout, 0);
+            if (lockTimeout > 0) {
+                uint zero = 0;
+                SystemParametersInfo(SPI_SETFOREGROUNDLOCKTIMEOUT, 0, ref zero, SPIF_SENDWININICHANGE);
+                SetForegroundWindow(hwnd);
+                BringWindowToTop(hwnd);
+                ShowWindow(hwnd, SW_SHOW);
+                SystemParametersInfo(SPI_SETFOREGROUNDLOCKTIMEOUT, 0, ref lockTimeout, SPIF_SENDWININICHANGE);
+                Thread.Sleep(10);
+                if (GetForegroundWindow() == hwnd) return true;
+            }
+
+            // Last resort: TOPMOST toggle
+            SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
+            SetWindowPos(hwnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
+            return GetForegroundWindow() == hwnd;
+        } catch {
+            return false;
+        } finally {
+            if (attachedCurFore) AttachThreadInput(curThread, foreThread, false);
+            if (attachedForeTarget) AttachThreadInput(foreThread, targetThread, false);
+        }
+    }
+
+    /// <summary>Set window as always-on-top.</summary>
+    public static bool SetTopMost(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return SetWindowPos(hwnd, HWND_TOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
+    }
+
+    /// <summary>Remove always-on-top from window.</summary>
+    public static bool ClearTopMost(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return SetWindowPos(hwnd, HWND_NOTOPMOST, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_SHOWWINDOW);
+    }
+
+    public static bool MinimizeWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return ShowWindow(hwnd, SW_MINIMIZE);
+    }
+
+    public static bool RestoreWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return ShowWindow(hwnd, SW_RESTORE);
+    }
+
+    public static bool IsMinimized(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return IsIconic(hwnd);
+    }
+
+    public static bool IsVisible(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return IsWindowVisible(hwnd);
+    }
+
+    public static string GetText(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return null;
+        System.Text.StringBuilder sb = new System.Text.StringBuilder(512);
+        GetWindowText(hwnd, sb, sb.Capacity);
+        string text = sb.ToString();
+        return text.Length > 0 ? text : null;
+    }
+
+    public static RECT GetRect(IntPtr hwnd) {
+        RECT rect;
+        rect.Left = 0; rect.Top = 0; rect.Right = 0; rect.Bottom = 0;
+        if (hwnd != IntPtr.Zero) GetWindowRect(hwnd, out rect);
+        return rect;
+    }
+
+    public static uint GetProcessId(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return 0;
+        uint pid = 0;
+        GetWindowThreadProcessId(hwnd, out pid);
+        return pid;
+    }
+
+    // ==================================================================
+    // Window enumeration (for scope-session)
+    // ==================================================================
+
+    public delegate bool EnumWindowsProc(IntPtr hWnd, IntPtr lParam);
+
+    [DllImport("user32.dll")]
+    private static extern bool EnumWindows(EnumWindowsProc lpEnumFunc, IntPtr lParam);
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern int GetClassName(IntPtr hWnd, System.Text.StringBuilder lpClassName, int nMaxCount);
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, IntPtr wParam, System.Text.StringBuilder lParam, uint fuFlags, uint uTimeout, out IntPtr lpdwResult);
+
+    private const uint WM_GETTEXT = 0x000D;
+    private const uint SMTO_ABORTIFHUNG = 0x0002;
+    private const uint SMTO_BLOCK = 0x0001;
+
+    /// <summary>
+    /// Find a top-level window by exact Name and Win32 ClassName.
+    /// Uses EnumWindows + SendMessageTimeout(WM_GETTEXT) — avoids UIA FindFirst
+    /// which blocks for 20+ s against SecureAge's slow UIA provider.
+    /// Polls for up to timeoutMs milliseconds (pollMs interval). Returns IntPtr.Zero on timeout.
+    /// </summary>
+    public static IntPtr FindWindowByName(string targetName, string targetClass, int timeoutMs, int pollMs) {
+        var sw = Stopwatch.StartNew();
+        do {
+            var candidates = new List<IntPtr>();
+            EnumWindowsProc cb = (h, l) => {
+                if (!IsWindowVisible(h)) return true;
+                if (!string.IsNullOrEmpty(targetClass)) {
+                    var cls = new System.Text.StringBuilder(256);
+                    GetClassName(h, cls, 256);
+                    if (cls.ToString() != targetClass) return true;
+                }
+                candidates.Add(h);
+                return true;
+            };
+            EnumWindows(cb, IntPtr.Zero);
+            foreach (var h in candidates) {
+                var tb = new System.Text.StringBuilder(512);
+                IntPtr res = IntPtr.Zero;
+                IntPtr rc = SendMessageTimeout(h, WM_GETTEXT, (IntPtr)512, tb,
+                    SMTO_ABORTIFHUNG | SMTO_BLOCK, 500, out res);
+                if (rc != IntPtr.Zero && tb.ToString() == targetName) return h;
+            }
+            long elapsed = sw.ElapsedMilliseconds;
+            if (elapsed >= timeoutMs) break;
+            if (pollMs > 0) Thread.Sleep(Math.Min(pollMs, (int)(timeoutMs - elapsed)));
+        } while (true);
+        return IntPtr.Zero;
+    }
+
+    private static void SendAltKey(bool keyUp) {
+        INPUT input = new INPUT();
+        input.type = INPUT_KEYBOARD;
+        input.u.ki.wVk = VK_MENU;
+        input.u.ki.dwFlags = keyUp ? KEYEVENTF_KEYUP : (uint)0;
+        input.u.ki.dwExtraInfo = IntPtr.Zero;
+        SendInput(1, new INPUT[] { input }, Marshal.SizeOf(typeof(INPUT)));
+    }
+
+    // ==================================================================
+    // User32 extended API
+    //   Direct wrappers for common user32.dll functions, exposed to PS scripts
+    //   so test code can drive Win32 without writing Add-Type boilerplate.
+    //   All methods are null-safe (return IntPtr.Zero / false / empty on hwnd=0)
+    //   and read-only by default (control methods are named explicitly).
+    // ==================================================================
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern IntPtr FindWindowEx(IntPtr hwndParent, IntPtr hwndChildAfter, string lpszClass, string lpszWindow);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetDesktopWindow();
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetParent(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetWindow(IntPtr hWnd, uint uCmd);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetTopWindow(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr GetActiveWindow();
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool IsWindowEnabled(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool MoveWindow(IntPtr hWnd, int X, int Y, int nWidth, int nHeight, bool bRepaint);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool CloseWindow(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr PostMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
+
+    [DllImport("user32.dll")]
+    private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
+
+    [DllImport("user32.dll", CharSet = CharSet.Auto)]
+    private static extern int GetWindowTextLength(IntPtr hWnd);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool SetCursorPos(int X, int Y);
+
+    [DllImport("user32.dll")]
+    [return: MarshalAs(UnmanagedType.Bool)]
+    private static extern bool GetCursorPos(out POINT lpPoint);
+
+    [DllImport("user32.dll")]
+    private static extern bool EnumChildWindows(IntPtr hWndParent, EnumWindowsProc lpEnumFunc, IntPtr lParam);
+
+    // ---- Window lookup ----
+
+    /// <summary>FindWindow(class, name) — instant lookup, no polling. Either arg may be null.</summary>
+    public static IntPtr FindWindowHandle(string className, string windowName) {
+        return FindWindow(className, windowName);
+    }
+
+    /// <summary>
+    /// FindWindow by class name only. Use this from PowerShell because passing
+    /// $null to the two-arg overload's windowName parameter gets marshaled as
+    /// an empty string, not a null pointer, causing FindWindow to return 0.
+    /// This overload calls FindWindow(className, null) in C#, where null is
+    /// real null and matches any window of the class.
+    /// </summary>
+    public static IntPtr FindWindowHandle(string className) {
+        return FindWindow(className, null);
+    }
+
+    /// <summary>FindWindowEx — find a child window. hwndParent and hwndChildAfter may be IntPtr.Zero.</summary>
+    public static IntPtr FindChildWindow(IntPtr hwndParent, IntPtr hwndChildAfter, string className, string windowName) {
+        return FindWindowEx(hwndParent, hwndChildAfter, className, windowName);
+    }
+
+    /// <summary>Desktop window handle (root of the window tree).</summary>
+    public static IntPtr GetDesktop() {
+        return GetDesktopWindow();
+    }
+
+    /// <summary>Window currently in the foreground (with focus).</summary>
+    public static IntPtr GetForeground() {
+        return GetForegroundWindow();
+    }
+
+    /// <summary>Active window of the calling thread.</summary>
+    public static IntPtr GetActive() {
+        return GetActiveWindow();
+    }
+
+    /// <summary>Top-level window at screen coordinates (x, y).</summary>
+    public static IntPtr WindowAtPoint(int x, int y) {
+        POINT p; p.x = x; p.y = y;
+        return WindowFromPoint(p);
+    }
+
+    // ---- Window traversal ----
+
+    /// <summary>Parent of hwnd, or IntPtr.Zero if it has none / hwnd is invalid.</summary>
+    public static IntPtr GetParentWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
+        return GetParent(hwnd);
+    }
+
+    /// <summary>
+    /// GetWindow relation — cmd values:
+    ///   0 GW_HWNDFIRST, 1 GW_HWNDLAST, 2 GW_HWNDNEXT, 3 GW_HWNDPREV,
+    ///   4 GW_OWNER, 5 GW_CHILD, 6 GW_ENABLEDPOPUP
+    /// </summary>
+    public static IntPtr GetRelatedWindow(IntPtr hwnd, uint cmd) {
+        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
+        return GetWindow(hwnd, cmd);
+    }
+
+    /// <summary>Top-most child of parent in Z-order (parent=IntPtr.Zero for desktop).</summary>
+    public static IntPtr GetTopChild(IntPtr parent) {
+        return GetTopWindow(parent);
+    }
+
+    /// <summary>All visible+invisible top-level windows in Z-order (front first).</summary>
+    public static IntPtr[] EnumTopLevelWindows() {
+        var list = new List<IntPtr>();
+        EnumWindowsProc cb = (h, l) => { list.Add(h); return true; };
+        EnumWindows(cb, IntPtr.Zero);
+        return list.ToArray();
+    }
+
+    /// <summary>All direct + descendant children of parent.</summary>
+    public static IntPtr[] EnumChildren(IntPtr parent) {
+        if (parent == IntPtr.Zero) return new IntPtr[0];
+        var list = new List<IntPtr>();
+        EnumWindowsProc cb = (h, l) => { list.Add(h); return true; };
+        EnumChildWindows(parent, cb, IntPtr.Zero);
+        return list.ToArray();
+    }
+
+    // ---- Window state ----
+
+    /// <summary>True if hwnd identifies an existing window.</summary>
+    public static bool IsValidWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return IsWindow(hwnd);
+    }
+
+    /// <summary>True if the window accepts mouse and keyboard input.</summary>
+    public static bool IsEnabled(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return IsWindowEnabled(hwnd);
+    }
+
+    /// <summary>Win32 class name of a window (the ClassName property in UIA).</summary>
+    public static string GetClassNameOf(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return null;
+        var sb = new System.Text.StringBuilder(256);
+        GetClassName(hwnd, sb, 256);
+        return sb.ToString();
+    }
+
+    /// <summary>Length of the window title in characters (does not block).</summary>
+    public static int GetTextLength(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return 0;
+        return GetWindowTextLength(hwnd);
+    }
+
+    // ---- Window control ----
+
+    /// <summary>
+    /// ShowWindow — cmd values:
+    ///   0 SW_HIDE, 1 SW_SHOWNORMAL, 2 SW_SHOWMINIMIZED, 3 SW_MAXIMIZE,
+    ///   4 SW_SHOWNOACTIVATE, 5 SW_SHOW, 6 SW_MINIMIZE, 7 SW_SHOWMINNOACTIVE,
+    ///   8 SW_SHOWNA, 9 SW_RESTORE, 10 SW_SHOWDEFAULT, 11 SW_FORCEMINIMIZE
+    /// </summary>
+    public static bool Show(IntPtr hwnd, int cmd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return ShowWindow(hwnd, cmd);
+    }
+
+    /// <summary>Maximize a window (SW_MAXIMIZE).</summary>
+    public static bool MaximizeWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return ShowWindow(hwnd, 3);
+    }
+
+    /// <summary>Hide a window (SW_HIDE — process keeps running, window disappears).</summary>
+    public static bool HideWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return ShowWindow(hwnd, 0);
+    }
+
+    /// <summary>Move + resize a window in screen coordinates.</summary>
+    public static bool Move(IntPtr hwnd, int x, int y, int width, int height, bool repaint) {
+        if (hwnd == IntPtr.Zero) return false;
+        return MoveWindow(hwnd, x, y, width, height, repaint);
+    }
+
+    /// <summary>SetWindowPos — flexible reposition / Z-order change. See MSDN for hwndInsertAfter and flags.</summary>
+    public static bool SetPos(IntPtr hwnd, IntPtr hwndInsertAfter, int x, int y, int cx, int cy, uint flags) {
+        if (hwnd == IntPtr.Zero) return false;
+        return SetWindowPos(hwnd, hwndInsertAfter, x, y, cx, cy, flags);
+    }
+
+    /// <summary>Win32 CloseWindow — confusingly, this MINIMIZES the window (it does not destroy it).</summary>
+    public static bool MinimizeViaCloseWindow(IntPtr hwnd) {
+        if (hwnd == IntPtr.Zero) return false;
+        return CloseWindow(hwnd);
+    }
+
+    // ---- Messages ----
+
+    /// <summary>PostMessage — fire-and-forget. Returns true if posted (non-zero return).</summary>
+    public static bool Post(IntPtr hwnd, uint msg, IntPtr wParam, IntPtr lParam) {
+        if (hwnd == IntPtr.Zero) return false;
+        return PostMessage(hwnd, msg, wParam, lParam) != IntPtr.Zero;
+    }
+
+    /// <summary>SendMessage — blocks until the receiving window's message procedure returns.</summary>
+    public static IntPtr Send(IntPtr hwnd, uint msg, IntPtr wParam, IntPtr lParam) {
+        if (hwnd == IntPtr.Zero) return IntPtr.Zero;
+        return SendMessage(hwnd, msg, wParam, lParam);
+    }
+
+    // ---- Cursor ----
+
+    /// <summary>Move OS cursor to screen coordinates.</summary>
+    public static bool MoveCursor(int x, int y) {
+        return SetCursorPos(x, y);
+    }
+
+    /// <summary>Current OS cursor position in screen coordinates.</summary>
+    public static POINT GetCursor() {
+        POINT p; p.x = 0; p.y = 0;
+        GetCursorPos(out p);
+        return p;
+    }
+
+    // ==================================================================
+    // MSAA property retrieval
+    // ==================================================================
+
+    private static bool PointBelongsToExpectedProcess(int x, int y) {
+        if (_expectedPid == 0 || (x == 0 && y == 0)) return true;
+        try {
+            POINT pt; pt.x = x; pt.y = y;
+            IntPtr hWnd = WindowFromPoint(pt);
+            if (hWnd == IntPtr.Zero) return true;
+            uint pidAtPoint = 0;
+            GetWindowThreadProcessId(hWnd, out pidAtPoint);
+            return pidAtPoint == 0 || pidAtPoint == _expectedPid;
+        } catch { return true; }
+    }
+
+    private static string ResolveMemberName(string propertyName, out object[] args) {
+        args = new object[] { (int)0 };
+        switch(propertyName.ToLower()) {
+            case "name": return "accName";
+            case "value": return "accValue";
+            case "description": return "accDescription";
+            case "role": return "accRole";
+            case "state": return "accState";
+            case "help": return "accHelp";
+            case "keyboardshortcut": return "accKeyboardShortcut";
+            case "defaultaction": return "accDefaultAction";
+            case "focus": args = null; return "accFocus";
+            case "selection": args = null; return "accSelection";
+            default: return null;
+        }
+    }
+
+    /// <summary>
+    /// Get MSAA property via AccessibleObjectFromWindow (hwnd-based, no screen coords).
+    /// </summary>
+    [HandleProcessCorruptedStateExceptions]
+    [SecurityCritical]
+    public static object GetLegacyProperty(IntPtr hwnd, string propertyName) {
+        if (hwnd == IntPtr.Zero) return null;
+        Guid IID_IAccessible = new Guid("618736E0-3C3D-11CF-810C-00AA00389B71");
+        object accObj = null;
+        try {
+            int res = AccessibleObjectFromWindow(hwnd, 0xFFFFFFFC, ref IID_IAccessible, out accObj);
+            if (res == 0 && accObj != null) {
+                object[] args;
+                string memberName = ResolveMemberName(propertyName, out args);
+                if (memberName == null) return null;
+                return accObj.GetType().InvokeMember(memberName,
+                    BindingFlags.GetProperty, null, accObj, args);
+            }
+        } catch { }
+        finally {
+            if (accObj != null) try { Marshal.ReleaseComObject(accObj); } catch { }
+        }
+        return null;
+    }
+
+    /// <summary>
+    /// Get MSAA property with cascading fallback:
+    ///   1. hwnd-based (AccessibleObjectFromWindow)
+    ///   2. PID validation (WindowFromPoint check)
+    ///   3. Point-based (AccessibleObjectFromPoint)
+    /// Call SetExpectedPid() first to set expected PID.
+    /// </summary>
+    [HandleProcessCorruptedStateExceptions]
+    [SecurityCritical]
+    public static object GetLegacyPropertyWithFallback(IntPtr hwnd, int x, int y, string propertyName) {
+        if (hwnd != IntPtr.Zero) {
+            object val = GetLegacyProperty(hwnd, propertyName);
+            if (val != null) return val;
+        }
+        if (!PointBelongsToExpectedProcess(x, y)) return null;
+        if (propertyName.ToLower() == "childid") { /* handled below */ }
+
+        POINT pt; pt.x = x; pt.y = y;
+        object accObj = null;
+        object childIdObj = null;
+        try {
+            int res = AccessibleObjectFromPoint(pt, out accObj, out childIdObj);
+            if (res == 0 && accObj != null) {
+                if (propertyName.ToLower() == "childid") return childIdObj;
+                object[] args;
+                string memberName = ResolveMemberName(propertyName, out args);
+                if (memberName == null) return null;
+                if (args != null) args = new object[] { childIdObj };
+                return accObj.GetType().InvokeMember(memberName,
+                    BindingFlags.GetProperty, null, accObj, args);
+            }
+        } catch { }
+        finally {
+            if (accObj != null) try { Marshal.ReleaseComObject(accObj); } catch { }
+        }
+        return null;
+    }
+
+    /// <summary>
+    /// Get all MSAA properties at once.
+    /// Call SetExpectedPid() first to set expected PID.
+    /// </summary>
+    [HandleProcessCorruptedStateExceptions]
+    [SecurityCritical]
+    public static Hashtable GetLegacyPropsWithFallback(IntPtr hwnd, int x, int y) {
+        Hashtable props = new Hashtable();
+        try {
+            string[] names = { "Name", "Value", "Description", "Role", "State",
+                               "Help", "KeyboardShortcut", "DefaultAction", "ChildId" };
+            foreach (string name in names) {
+                object val = GetLegacyPropertyWithFallback(hwnd, x, y, name);
+                if (val != null) props.Add(name, val);
+            }
+        } catch { }
+        return props;
+    }
+}
+
+public static class ConsoleHelper {
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern IntPtr GetStdHandle(int nStdHandle);
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern bool GetConsoleMode(IntPtr hConsoleHandle, out uint lpMode);
+    [DllImport("kernel32.dll", SetLastError = true)]
+    public static extern bool SetConsoleMode(IntPtr hConsoleHandle, uint dwMode);
+
+    public const int STD_INPUT_HANDLE = -10;
+    public const uint ENABLE_MOUSE_INPUT = 0x0010;
+    public const uint ENABLE_INSERT_MODE = 0x0020;
+    public const uint ENABLE_QUICK_EDIT_MODE = 0x0040;
+    public const uint ENABLE_EXTENDED_FLAGS = 0x0080;
+
+    public static void DisableConsoleInteractions() {
+        IntPtr consoleHandle = GetStdHandle(STD_INPUT_HANDLE);
+        uint mode;
+        if (GetConsoleMode(consoleHandle, out mode)) {
+            mode &= ~ENABLE_QUICK_EDIT_MODE;
+            mode &= ~ENABLE_INSERT_MODE;
+            mode &= ~ENABLE_MOUSE_INPUT;
+            mode |= ENABLE_EXTENDED_FLAGS;
+            SetConsoleMode(consoleHandle, mode);
+        }
+    }
+}
+'@
+
+        # Set TEMP and TMP to DLL directory to avoid permission issues
+        $originalTemp = $env:TEMP
+        $originalTmp = $env:TMP
+        $env:TEMP = $dllDir
+        $env:TMP = $dllDir
+
+        try {
+            # Compile the C# code to DLL
+            Add-Type -TypeDefinition $code -Language CSharp -ReferencedAssemblies @('System') -OutputAssembly $dllPath -ErrorAction Stop
+            Write-Output "Win32Helper.dll compiled successfully"
+
+            # Load the newly compiled DLL
+            Add-Type -Path $dllPath -ErrorAction Stop
+            Write-Output "Win32Helper.dll loaded successfully"
+        } catch {
+            Write-Output "Compilation failed, falling back to in-memory loading"
+            # Fallback: load in-memory if compilation fails
+            Add-Type -TypeDefinition $code -Language CSharp -ReferencedAssemblies @('System') -ErrorAction Stop
+        } finally {
+            # Restore original TEMP/TMP
+            $env:TEMP = $originalTemp
+            $env:TMP = $originalTmp
+        }
+    }
+}
+
+Write-Output "Win32Helper ready"
 `;
 //# sourceMappingURL=win32.js.map