Module win_event 

Structs

HookHandle 🔒

Functions

app_state 🔒

Phase B.9.1 — handle to host AppState for the static SetWinEventHook callback (the OS API takes a fixed-shape extern "system" fn, so AppState has to be reachable through a static). Set once by install_hooks(state). The callback reads pending_window_creations to supply label_hint on EVENT_OBJECT_CREATE, eliminating the launcher-side “pending HWND with no matching mirror” race.

enumerate_monitors 🔒

Phase B.9.1 — initial monitor enumeration. Called once from install_hooks. Mid-session topology changes (a follow-up concern for B.9.2) would re-enumerate via WM_DISPLAYCHANGE.

hook_handles 🔒

Phase B.9.1 — handles to the installed hooks. Held in a OnceLock<Mutex<Option<...>>> so install_hooks is idempotent (no-op on second call) and uninstall can drop them on shutdown.

install_hooks

Phase B.9.1 — install the WRR hooks. Idempotent (logs and returns if hooks are already installed). Must be called from a thread that owns a Win32 message pump — the host’s CEF UI thread does, so we install from there at startup.

install_one 🔒

read_class_name 🔒 ^⚠

Read the Win32 class name into an owned String.

read_window_rect 🔒 ^⚠

Read the window’s screen-coordinate rectangle. None if the API call fails (window torn down between our event and the read — common during destroy).

read_window_text 🔒 ^⚠

Read the window’s text (title) into an owned String. Empty string if no title.

uninstall_hooks

Phase B.9.1 — uninstall the hooks. Called from host shutdown.

win_event_callback 🔒 ^⚠

Phase B.9.1 — hook callback. Runs OUT-OF-CONTEXT (on the hooking thread, posted via the message pump). Must not block for long: we only do quick HWND-property reads and dispatch non-blocking sync IPC reports.