companion: shown or hidden survives a restart, with a settings switch

SUPER+\ only flipped a property, so every restart of the desktop shell
brought her back. Whether she is shown is now `companion` in Prefs.qml,
set by the IPC and by a switch on a new Settings > Desktop > Companion
page. Prefs gains `ready`, so she waits for the file rather than showing
at the default and then vanishing; the greeting now plays on every
appearance, the one at login included.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

1 files changed, 56 insertions, 0 deletions

diff --git a/desktop/modules/companion/CompanionModule.qml b/desktop/modules/companion/CompanionModule.qml
new file mode 100644
index 0000000..ea6b13d
--- /dev/null
+++ b/desktop/modules/companion/CompanionModule.qml
@@ -0,0 +1,56 @@
+// Copyright (C) 2026 Danilo M. <danix@danix.xyz>
+//
+// This program is free software; you can redistribute it and/or modify
+// it under the terms of the GNU General Public License version 2 as
+// published by the Free Software Foundation.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU General Public License for more details.
+
+import QtQuick
+import "../.."
+
+// The desktop companion's one setting: whether she is shown. The same
+// preference SUPER+\ toggles, so the switch follows the key.
+Module {
+    name: "companion"
+    label: "Companion"
+    // nf-md-account_heart, present in Inconsolata Nerd Font.
+    icon: "\u{F0899}"
+    settings: true
+    group: "Desktop"
+    keywords: ["companion", "2b", "mascot", "character", "show", "hide"]
+
+    page: Component {
+        Page {
+            title: "Companion"
+            Item {
+                width: parent.width
+                height: 34
+                Text {
+                    id: lbl
+                    anchors { left: parent.left; verticalCenter: parent.verticalCenter }
+                    width: 160
+                    text: "Shown"
+                    color: Theme.subtext
+                    font { family: Theme.fontFamily; pixelSize: Theme.fontSize - 3 }
+                }
+                Switch {
+                    id: sw
+                    anchors { left: lbl.right; leftMargin: 8; verticalCenter: parent.verticalCenter }
+                    checked: Prefs.companion
+                    onToggled: on => Prefs.setCompanion(on)
+                }
+                Text {
+                    anchors { left: sw.right; leftMargin: 10; right: parent.right; verticalCenter: parent.verticalCenter }
+                    elide: Text.ElideRight
+                    text: "Also SUPER+\\. Kept across restarts."
+                    color: Theme.overlay
+                    font { family: Theme.fontFamily; pixelSize: Theme.fontSize - 5 }
+                }
+            }
+        }
+    }
+}