From 0083fe7dc2cec7d144aea09066333d046e01bb04 Mon Sep 17 00:00:00 2001
From: vybe <vybe@jtmorris.net>
Date: Tue, 19 May 2026 04:40:49 +0000
Subject: [PATCH] docs: document intentional propagateComposedEvents: true on
 right-click MouseArea

---
 tailscalectl/TailscaleWidget.qml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/tailscalectl/TailscaleWidget.qml b/tailscalectl/TailscaleWidget.qml
index f1a91b1..235ffc0 100644
--- a/tailscalectl/TailscaleWidget.qml
+++ b/tailscalectl/TailscaleWidget.qml
@@ -311,6 +311,10 @@ PluginComponent {
         }
     }
 
+    // propagateComposedEvents: true so that right-clicks both trigger our context menu
+    // *and* bubble to any parent MouseArea (e.g. for shell-level drag handling).
+    // Documented because the default (false) is far more common and this choice
+    // frequently surprises future maintainers.
     MouseArea {
         anchors.fill: parent
         acceptedButtons: Qt.RightButton