feat(plugin-manager): add-to-bar menu, auto-select, richer markdown, 16 locales

- Add cursor-positioned "Add to bar" context menu (Left/Center/Right) via
  fullscreen overlay using wl_pointer hover events for cross-compositor
  support (Hyprland, Niri, Sway).
- Auto-select the first plugin on panel open and tab switch so the README
  pane is never empty.
- Fuzzy-search bar in the Installed tab.
- Richer README rendering: inline italic/strikethrough, soft line breaks,
  expanded image domain whitelist.
- Ship 16 additional locale files (de, es, fr, it, pt, nl, ru, ja, zh-CN,
  zh-TW, ko-KR, tr, uk-UA, pl, sv, hu).

Author: blackbartblues

plugin-manager/AddToBarMenu.qml

@@ -0,0 +1,108 @@
+import QtQuick
+import Quickshell
+import Quickshell.Wayland
+import qs.Commons
+import qs.Services.UI
+import qs.Widgets
+
+// Fullscreen overlay that positions an NPopupContextMenu at the cursor.
+// Cross-compositor — relies on standard wl_pointer hover events delivered
+// by any Wayland compositor (Hyprland, Niri, Sway, ...). No hyprctl.
+PanelWindow {
+  id: root
+
+  required property ShellScreen screen
+  property var pluginApi: null
+  property var menuItems: []
+
+  signal actionSelected(string action)
+  signal cancelled
+
+  property bool _menuShown: false
+
+  anchors.top: true
+  anchors.left: true
+  anchors.right: true
+  anchors.bottom: true
+  visible: false
+  color: "transparent"
+
+  WlrLayershell.layer: WlrLayer.Overlay
+  WlrLayershell.keyboardFocus: WlrKeyboardFocus.None
+  WlrLayershell.namespace: "noctalia-plugin-manager-add-to-bar-" + (screen?.name || "unknown")
+  WlrLayershell.exclusionMode: ExclusionMode.Ignore
+
+  function show(items) {
+    menuItems = items || []
+    _menuShown = false
+    visible = true
+    // Fallback: show menu after 300 ms even if no pointer event arrives
+    // (e.g. cursor outside screen). Normally the first wl_pointer.enter or
+    // wl_pointer.motion reaching cursorArea fires _showMenuAtCursor sooner.
+    fallbackTimer.restart()
+  }
+
+  function close() {
+    fallbackTimer.stop()
+    _menuShown = false
+    visible = false
+    contextMenu.visible = false
+  }
+
+  function _showMenuAtCursor() {
+    if (_menuShown || !visible) return
+    _menuShown = true
+    fallbackTimer.stop()
+    anchorPoint.x = cursorArea.mouseX
+    anchorPoint.y = cursorArea.mouseY
+    contextMenu.model = root.menuItems
+    contextMenu.anchorItem = anchorPoint
+    contextMenu.visible = true
+  }
+
+  Timer {
+    id: fallbackTimer
+    interval: 300
+    repeat: false
+    onTriggered: root._showMenuAtCursor()
+  }
+
+  NPopupContextMenu {
+    id: contextMenu
+    visible: false
+    screen: root.screen
+    minWidth: 200
+
+    onTriggered: (action, item) => {
+      root.actionSelected(action)
+      root.close()
+    }
+  }
+
+  Item {
+    id: anchorPoint
+    width: 1
+    height: 1
+    x: 0
+    y: 0
+  }
+
+  MouseArea {
+    id: cursorArea
+    anchors.fill: parent
+    hoverEnabled: true
+    acceptedButtons: Qt.LeftButton | Qt.RightButton
+
+    onEntered: root._showMenuAtCursor()
+    onPositionChanged: mouse => root._showMenuAtCursor()
+
+    onClicked: mouse => {
+      root.cancelled()
+      root.close()
+    }
+  }
+
+  Component.onDestruction: {
+    close()
+  }
+}

plugin-manager/InstalledTabContent.qml

@@ -18,6 +18,63 @@ ColumnLayout {
   // Track which plugins are currently updating
   property var updatingPlugins: ({})
   property int installedPluginsRefreshCounter: 0
+  property string pluginSearchText: ""
+
+  // Plugin id targeted by the add-to-bar context menu (set on click, read on action)
+  property string _addToBarPluginId: ""
+
+  // Add a plugin's bar widget to the given section on the current panel screen.
+  // Mirrors the core Settings.Bar → MonitorWidgetsConfig._addWidgetToSection flow.
+  function _addPluginToBar(pluginId, section, pluginName) {
+    if (!pluginApi) return
+    var screen = pluginApi.panelOpenScreen
+    if (!screen || !screen.name) return
+    var screenName = screen.name
+    var widgetId = "plugin:" + pluginId
+
+    var currentWidgets = Settings.getBarWidgetsForScreen(screenName)
+    var widgets = {
+      "left": [],
+      "center": [],
+      "right": []
+    }
+    try {
+      widgets.left = JSON.parse(JSON.stringify(currentWidgets.left || []))
+      widgets.center = JSON.parse(JSON.stringify(currentWidgets.center || []))
+      widgets.right = JSON.parse(JSON.stringify(currentWidgets.right || []))
+    } catch (e) {
+      Logger.w("PluginManager", "Failed to clone bar widgets:", e)
+    }
+
+    var sections = ["left", "center", "right"]
+    for (var s = 0; s < sections.length; s++) {
+      var arr = widgets[sections[s]]
+      for (var i = 0; i < arr.length; i++) {
+        if (arr[i] && arr[i].id === widgetId) {
+          var alreadyMsg = pluginApi.tr("panel.already-on-bar").replace("{plugin}", pluginName || pluginId)
+          ToastService.showNotice(pluginApi.tr("panel.title"), alreadyMsg)
+          return
+        }
+      }
+    }
+
+    var newWidget = { "id": widgetId }
+    var meta = BarWidgetRegistry.pluginWidgetMetadata ? BarWidgetRegistry.pluginWidgetMetadata[widgetId] : null
+    if (meta) {
+      Object.keys(meta).forEach(function (key) {
+        if (key !== "id") newWidget[key] = meta[key]
+      })
+    }
+
+    if (!widgets[section]) widgets[section] = []
+    widgets[section].push(newWidget)
+
+    Settings.setScreenOverride(screenName, "widgets", widgets)
+    BarService.widgetsRevision++
+
+    var successMsg = pluginApi.tr("panel.add-to-bar-success").replace("{plugin}", pluginName || pluginId)
+    ToastService.showNotice(pluginApi.tr("panel.title"), successMsg)
+  }
 
   function stripAuthorEmail(author) {
     if (!author) return "";
@@ -102,6 +159,9 @@ ColumnLayout {
     showToastOnSave: true
   }
 
+  // Plugin name paired with _addToBarPluginId (kept for external call-backs)
+  property var _addToBarPluginName: ""
+
   function uninstallPlugin(pluginId) {
     var manifest = PluginRegistry.getPluginManifest(pluginId);
     var pluginName = manifest?.name || pluginId;
@@ -195,6 +255,15 @@ ColumnLayout {
     }
   }
 
+  // Search input
+  NTextInput {
+    placeholderText: I18n.tr("placeholders.search")
+    inputIconName: "search"
+    text: root.pluginSearchText
+    onTextChanged: root.pluginSearchText = text
+    Layout.fillWidth: true
+  }
+
   // Installed plugins list
   ColumnLayout {
     spacing: Style.marginM
@@ -238,6 +307,21 @@ ColumnLayout {
             plugins.push(pluginData);
           }
         }
+
+        // Apply fuzzy search
+        var query = root.pluginSearchText.trim();
+        if (query !== "") {
+          var results = FuzzySort.go(query, plugins, {
+            "keys": ["name", "description"],
+            "limit": 50
+          });
+          var out = [];
+          for (var k = 0; k < results.length; k++) {
+            out.push(results[k].obj);
+          }
+          return out;
+        }
+
         return plugins;
       }
 
@@ -325,6 +409,25 @@ ColumnLayout {
               visible: Settings.isDebug
             }
 
+            NIconButton {
+              id: addToBarBtn
+              icon: "plus"
+              tooltipText: pluginApi?.tr("panel.add-to-bar")
+              baseSize: Style.baseWidgetSize * 0.7
+              visible: (modelData.entryPoints?.barWidget !== undefined)
+              enabled: modelData.enabled
+              onClicked: {
+                var rootRef = root
+                var pid = modelData.id
+                var pname = modelData.name
+                var main = pluginApi?.mainInstance
+                if (!main) return
+                main.showAddToBarMenu(pid, pname, function (chosenId, chosenAction, chosenName) {
+                  rootRef._addPluginToBar(chosenId, chosenAction, chosenName)
+                })
+              }
+            }
+
             NIconButton {
               icon: "settings"
               tooltipText: pluginApi?.tr("panel.open-settings")
@@ -383,16 +486,17 @@ ColumnLayout {
                   updates2[pid] = false;
                   rootRef.updatingPlugins = updates2;
 
-                  if (!pluginApi) return;
+                  var api = rootRef.pluginApi;
+                  if (!api) return;
                   if (success) {
-                    var title = pluginApi.tr("panel.title")
-                    var msg = pluginApi.tr("panel.install-success")
+                    var title = api.tr("panel.title")
+                    var msg = api.tr("panel.install-success")
                     msg = msg.replace("{plugin}", pname)
                     ToastService.showNotice(title, msg);
                   } else {
-                    var title2 = pluginApi.tr("panel.title")
-                    var errMsg = pluginApi.tr("panel.install-error")
-                    errMsg = errMsg.replace("{error}", error || pluginApi.tr("panel.unknown-error"))
+                    var title2 = api.tr("panel.title")
+                    var errMsg = api.tr("panel.install-error")
+                    errMsg = errMsg.replace("{error}", error || api.tr("panel.unknown-error"))
                     ToastService.showError(title2, errMsg);
                   }
                 });

plugin-manager/Main.qml

@@ -1,11 +1,34 @@
 import QtQuick
+import Quickshell
 import Quickshell.Io
 import qs.Commons
 
 Item {
   id: root
   property var pluginApi: null
 
+  // First AddToBarMenu instance, captured from the per-screen Variants delegate.
+  property var addToBarMenu: null
+
+  // State for the pending add-to-bar request
+  property string _pendingPluginId: ""
+  property string _pendingPluginName: ""
+  property var _onAddToBarAction: null
+
+  // Called by InstalledTabContent when the user clicks the "+" button on a plugin.
+  // onAction(pluginId, section, pluginName) runs when user picks left/center/right.
+  function showAddToBarMenu(pluginId, pluginName, onAction) {
+    if (!pluginApi || !addToBarMenu) return
+    _pendingPluginId = pluginId
+    _pendingPluginName = pluginName
+    _onAddToBarAction = onAction
+    addToBarMenu.show([
+      { "label": pluginApi.tr("panel.add-to-bar-left"),   "action": "left",   "icon": "align-left" },
+      { "label": pluginApi.tr("panel.add-to-bar-center"), "action": "center", "icon": "align-center" },
+      { "label": pluginApi.tr("panel.add-to-bar-right"),  "action": "right",  "icon": "align-right" }
+    ])
+  }
+
   IpcHandler {
     target: "plugin:plugin-manager"
 
@@ -17,4 +40,42 @@ Item {
       }
     }
   }
+
+  Variants {
+    model: Quickshell.screens
+
+    delegate: AddToBarMenu {
+      required property var modelData
+
+      screen: modelData
+      pluginApi: root.pluginApi
+
+      Component.onCompleted: {
+        if (!root.addToBarMenu) {
+          root.addToBarMenu = this
+        }
+      }
+
+      onActionSelected: action => {
+        if (root._onAddToBarAction) {
+          root._onAddToBarAction(root._pendingPluginId, action, root._pendingPluginName)
+        }
+        root._pendingPluginId = ""
+        root._pendingPluginName = ""
+        root._onAddToBarAction = null
+      }
+
+      onCancelled: {
+        root._pendingPluginId = ""
+        root._pendingPluginName = ""
+        root._onAddToBarAction = null
+      }
+    }
+  }
+
+  Component.onDestruction: {
+    _pendingPluginId = ""
+    _pendingPluginName = ""
+    _onAddToBarAction = null
+  }
 }