KiCad - the KiCad Bridge

@@ -266,6 +266,135 @@ except Exception:     pass  +# ── USER-INTENT HOOKS (0.9.182) ──────────────────────────────────────────────+# John's requirement, verbatim: "if you need NOACTIVATE then you HAVE to detect+# if the human is asking for the window to be foregrounded, meaning if they+# click the windows taskbar icon or alt_tab to the window, you MUST know that+# and allow them to see it or you have broken the entire user experience."+#+# The old detector POLLED GetAsyncKeyState every 120ms, so a click that began+# and ended between two polls was invisible - which is exactly how a taskbar+# click ended up treated as a self-raise and bounced. Polling cannot fix that;+# the gap is inherent.+#+# These are LOW-LEVEL HOOKS instead (WH_MOUSE_LL / WH_KEYBOARD_LL). Windows+# delivers every mouse button and every keystroke to them synchronously, before+# any application sees it. There is no sampling window and nothing to miss. On+# any of:+#     * a mouse button pressed anywhere on the shell (taskbar / Start / tray)+#     * a mouse button pressed on one of OUR KiCad windows+#     * Alt+Tab+# we IMMEDIATELY drop every activation block, so the user's click or alt-tab+# lands on a window that can take focus normally. Release is instant: there is+# no hold-off, because a user may want the window up the very next second.+_user_intent_until = 0.0      # monotonic deadline: "the user is driving"+_intent_hooks_started = False+_hook_refs = []               # keep callbacks alive for the process lifetime+++def user_wants_foreground() -> bool:+    """True if the user just asked for a window (click or alt-tab)."""+    try:+        import time as _t+        return _t.monotonic() < _user_intent_until+    except Exception:+        return False+++def _note_user_intent(source: str) -> None:+    """Release EVERY activation block, right now."""+    global _user_intent_until+    try:+        import time as _t+        _user_intent_until = _t.monotonic() + 5.0+        n = allow_activation_all()+        if n:+            print(f"[intent] {source}: released activation on {n} window(s)",+                  file=sys.stderr, flush=True)+        if _focus_events is not None:+            _focus_events.append({"t": _t.time(), "action": f"user intent ({source})",+                                  "title": "", "secondsSinceUserInput": 0.0})+    except Exception:+        pass+++def start_user_intent_hooks() -> None:+    """Low-level mouse + keyboard hooks on a dedicated pumped thread."""+    global _intent_hooks_started+    if not IS_WINDOWS or _intent_hooks_started:+        return+    _intent_hooks_started = True+    import threading++    WH_MOUSE_LL, WH_KEYBOARD_LL = 14, 13+    WM_LBUTTONDOWN, WM_RBUTTONDOWN, WM_MBUTTONDOWN = 0x0201, 0x0204, 0x0207+    WM_KEYDOWN, WM_SYSKEYDOWN = 0x0100, 0x0104+    VK_TAB, VK_MENU = 0x09, 0x12+    SHELL_CLASSES = {"Shell_TrayWnd", "Shell_SecondaryTrayWnd", "TaskListThumbnailWnd",+                     "Windows.UI.Core.CoreWindow", "XamlExplorerHostIslandWindow",+                     "MultitaskingViewFrame", "TaskSwitcherWnd", "TaskSwitcherOverlayWnd"}++    HOOKPROC = ctypes.WINFUNCTYPE(ctypes.c_long, ctypes.c_int,+                                  ctypes.wintypes.WPARAM, ctypes.wintypes.LPARAM)++    def _class_of(hwnd) -> str:+        try:+            buf = ctypes.create_unicode_buffer(96)+            _user32.GetClassNameW(hwnd, buf, 96)+            return buf.value or ""+        except Exception:+            return ""++    def _on_mouse(code, wparam, lparam):+        try:+            if code >= 0 and wparam in (WM_LBUTTONDOWN, WM_RBUTTONDOWN, WM_MBUTTONDOWN):+                pt = ctypes.wintypes.POINT()+                _user32.GetCursorPos(ctypes.byref(pt))+                under = _user32.WindowFromPoint(pt)+                root = _user32.GetAncestor(under, 2) if under else None   # GA_ROOT+                cls = _class_of(root) if root else ""+                if cls in SHELL_CLASSES:+                    _note_user_intent(f"click on the shell ({cls})")+                elif root and is_kicad_window(root):+                    _note_user_intent("click on a KiCad window")+        except Exception:+            pass+        return _user32.CallNextHookEx(None, code, wparam, lparam)++    def _on_key(code, wparam, lparam):+        try:+            if code >= 0 and wparam in (WM_KEYDOWN, WM_SYSKEYDOWN):+                vk = ctypes.cast(lparam, ctypes.POINTER(ctypes.wintypes.DWORD))[0]+                if vk == VK_TAB and (_user32.GetAsyncKeyState(VK_MENU) & 0x8000):+                    _note_user_intent("alt-tab")+        except Exception:+            pass+        return _user32.CallNextHookEx(None, code, wparam, lparam)++    def _pump():+        try:+            mp, kp = HOOKPROC(_on_mouse), HOOKPROC(_on_key)+            _hook_refs.extend([mp, kp])+            _user32.SetWindowsHookExW.restype = ctypes.wintypes.HANDLE+            hm = _user32.SetWindowsHookExW(WH_MOUSE_LL, mp, None, 0)+            hk = _user32.SetWindowsHookExW(WH_KEYBOARD_LL, kp, None, 0)+            print(f"[intent] hooks armed mouse={bool(hm)} keyboard={bool(hk)}",+                  file=sys.stderr, flush=True)+            if not (hm or hk):+                return+            msg = ctypes.wintypes.MSG()+            while _user32.GetMessageW(ctypes.byref(msg), None, 0, 0) != 0:+                _user32.TranslateMessage(ctypes.byref(msg))+                _user32.DispatchMessageW(ctypes.byref(msg))+        except Exception as e:+            print(f"[intent] hook thread died: {e}", file=sys.stderr, flush=True)++    try:+        threading.Thread(target=_pump, daemon=True, name="kicad-user-intent").start()+    except Exception:+        pass++ def _push_kicad_to_background(h) -> None:     """THE ENTIRE BACKGROUNDING ALGORITHM (0.9.181). John's rules, verbatim: @@ -301,6 +430,12 @@ def _push_kicad_to_background(h) -> None:         else:             _backgrounded_once.add(h) +        if user_wants_foreground():+            # The human just clicked or alt-tabbed. Their intent outranks any+            # background policy - do nothing at all.+            print(f"[bg] {h}: user is driving; leaving it exactly where it is",+                  file=sys.stderr, flush=True)+            return         HWND_BOTTOM = 1         SWP_NOACTIVATE, SWP_NOMOVE, SWP_NOSIZE = 0x0010, 0x0002, 0x0001         _user32.SetWindowPos(h, HWND_BOTTOM, 0, 0, 0, 0,