Give the desktop real themes, video wallpapers, and honest titlebars

Appearance now opens on Themes: light and dark side by side, each
remembering its own choice, over galleries of ten shipped themes —
Tokyo Moon and Day joined by Moon Rose, Catppuccin, Nord, Gruvbox and
Everforest in both modes. A theme is a complete palette: the catalog
lives in themes.json, Theme.qml reads every color token from the
active record, and one render pipeline carries it to kitty, tmux,
btop, GTK, Vicinae, Firefox's chrome, and the lock screen. The Theme
editor builds new ones from four wells — wheel, hex, or eyedropper —
with derived surfaces, a saturation slider, debounced fine-tune, and
effects that save with the theme. Custom edits finally keep GNOME's
accent, kitty's border, and hyprlock in sync.

Wallpapers can be video: mpvpaper per output, hardware-decoded, muted
and looped, supervised and respawned. Panama owns the pausing — games,
battery, and a bar pill for right now — because the compositor
rebuilds full-screen blur for every frame a video wallpaper draws.
The lock screen gets a still frame.

Titlebars stop lying. GNOME apps get close-only on your chosen side,
the maximize and double-click settings are gone, the Settings window
obeys the same rules, and its titlebar can be turned off entirely.
Typography becomes five labeled dropdowns instead of a wall of
samples.

Contracts updated and written throughout (165 now); per the redesign
workflow none were executed — the full sweep runs once at the end.

Claude-Session: https://claude.ai/code/session_01Ms2FbjQy31TVf3CEvQhGM8

config/dot/quickshell/modules/settings/SettingsShell.qml

@@ -40,18 +40,30 @@ Rectangle {
         onPageRequested: page => ShellState.openSettings(page)
     }
 
+    // The one titlebar Panama draws, so it follows Panama's own titlebar
+    // rules: the close button sits on the configured side, there is no
+    // minimize (Hyprland has no minimize — the button this bar used to show
+    // was a lie), and turning the titlebar off leaves the window pure
+    // Hyprland: Super+Q closes, Super+drag moves, Escape still works.
     Rectangle {
         id: titlebar
+
+        readonly property bool shown: DesktopPreferences.get("panamaTitlebar") !== false
+        readonly property bool buttonsLeft: DesktopPreferences.get("titlebarButtonSide") === "left"
+
         anchors.left: parent.left
         anchors.right: parent.right
         anchors.top: parent.top
-        height: 48
+        height: shown ? 48 : 0
+        visible: shown
         color: Theme.alpha(Theme.bgDark, 0.97)
         border.width: 0
 
         Text {
-            anchors.left: parent.left
+            anchors.left: titlebar.buttonsLeft ? undefined : parent.left
+            anchors.right: titlebar.buttonsLeft ? parent.right : undefined
             anchors.leftMargin: 18
+            anchors.rightMargin: 18
             anchors.verticalCenter: parent.verticalCenter
             text: "Settings"
             color: Theme.fg
@@ -60,24 +72,42 @@ Rectangle {
             font.weight: Font.DemiBold
         }
 
-        Row {
-            anchors.right: parent.right
+        Rectangle {
+            id: closeButton
+
+            anchors.left: titlebar.buttonsLeft ? parent.left : undefined
+            anchors.right: titlebar.buttonsLeft ? undefined : parent.right
+            anchors.leftMargin: 12
             anchors.rightMargin: 12
             anchors.verticalCenter: parent.verticalCenter
-            spacing: 7
+            width: 28
+            height: 28
+            radius: 9
+            color: closeMouse.containsMouse || activeFocus
+                ? Theme.alpha(Theme.danger, 0.17) : Theme.alpha(Theme.fg, 0)
+            border.width: activeFocus ? 2 : 0
+            border.color: Theme.alpha(Theme.danger, 0.6)
+            activeFocusOnTab: true
 
-            Rectangle {
-                width: 28; height: 28; radius: 9
-                color: minMouse.containsMouse ? Theme.alpha(Theme.fg, 0.12) : Theme.alpha(Theme.fg, 0)
-                Text { anchors.centerIn: parent; text: "—"; color: Theme.fgDim; font.family: Theme.fontFamily; font.pixelSize: Theme.fontSize }
-                MouseArea { id: minMouse; anchors.fill: parent; hoverEnabled: true; cursorShape: Qt.PointingHandCursor; onClicked: if (root.hostWindow) root.hostWindow.minimized = true }
+            Accessible.role: Accessible.Button
+            Accessible.name: "Close Settings"
+            Keys.onReturnPressed: ShellState.closeSettings()
+            Keys.onSpacePressed: ShellState.closeSettings()
+
+            Text {
+                anchors.centerIn: parent
+                text: "×"
+                color: closeMouse.containsMouse || closeButton.activeFocus ? Theme.danger : Theme.fgDim
+                font.family: Theme.fontFamily
+                font.pixelSize: 18
             }
 
-            Rectangle {
-                width: 28; height: 28; radius: 9
-                color: closeMouse.containsMouse ? Theme.alpha(Theme.danger, 0.17) : Theme.alpha(Theme.fg, 0)
-                Text { anchors.centerIn: parent; text: "×"; color: closeMouse.containsMouse ? Theme.danger : Theme.fgDim; font.family: Theme.fontFamily; font.pixelSize: 18 }
-                MouseArea { id: closeMouse; anchors.fill: parent; hoverEnabled: true; cursorShape: Qt.PointingHandCursor; onClicked: ShellState.closeSettings() }
+            MouseArea {
+                id: closeMouse
+                anchors.fill: parent
+                hoverEnabled: true
+                cursorShape: Qt.PointingHandCursor
+                onClicked: ShellState.closeSettings()
             }
         }