PluginComponent: support for right click not defaulted to poput toggle (#677)

* PluginComponent: support for right click not defaulted to poput toggle

* PluginComponent: right click docs

Modules/Plugins/PluginComponent.qml

@@ -20,6 +20,7 @@ Item {
     property real popoutWidth: 400
     property real popoutHeight: 0
     property var pillClickAction: null
+    property var pillRightClickAction: null
 
     property Component controlCenterWidget: null
     property string ccWidgetIcon: ""
@@ -120,6 +121,18 @@ Item {
                 pluginPopout.toggle()
             }
         }
+        onRightClicked: {
+            if (pillRightClickAction) {
+                if (pillRightClickAction.length === 0) {
+                    pillRightClickAction()
+                } else {
+                    const globalPos = mapToGlobal(0, 0)
+                    const currentScreen = parentScreen || Screen
+                    const pos = SettingsData.getPopupTriggerPosition(globalPos, currentScreen, barThickness, width)
+                    pillRightClickAction(pos.x, pos.y, pos.width, section, currentScreen)
+                }
+            }
+        }
     }
 
     BasePill {
@@ -147,6 +160,18 @@ Item {
                 pluginPopout.toggle()
             }
         }
+        onRightClicked: {
+            if (pillRightClickAction) {
+                if (pillRightClickAction.length === 0) {
+                    pillRightClickAction()
+                } else {
+                    const globalPos = mapToGlobal(0, 0)
+                    const currentScreen = parentScreen || Screen
+                    const pos = SettingsData.getPopupTriggerPosition(globalPos, currentScreen, barThickness, width)
+                    pillRightClickAction(pos.x, pos.y, pos.width, section, currentScreen)
+                }
+            }
+        }
     }
 
     function closePopout() {

PLUGINS/README.md

@@ -177,6 +177,7 @@ PluginComponent {
 - `popoutWidth`: Popout window width
 - `popoutHeight`: Popout window height
 - `pillClickAction`: Custom click handler function (overrides popout)
+- `pillRightClickAction`: Custom right click handler function
 
 ### Control Center Integration
 
@@ -227,7 +228,7 @@ PluginComponent {
 
 **Custom Click Actions:**
 
-Override default popout with `pillClickAction`:
+Override default popout with `pillClickAction` and `pillRightClickAction`:
 
 ```qml
 pillClickAction: () => {
@@ -238,6 +239,14 @@ pillClickAction: () => {
 pillClickAction: (x, y, width, section, screen) => {
     popoutService?.toggleControlCenter(x, y, width, section, screen)
 }
+
+pillRightClickAction: () => {
+    Process.exec("bash", ["-c", "notify-send 'Right clicked!'"])
+}
+
+pillRightClickAction: (x, y, width, section, screen) => {
+    popoutService?.toggleControlCenter(x, y, width, section, screen)
+}
 ```
 
 The PluginComponent automatically handles: