From 45c97074b738af7ac5f09b03e0ce43f6df057615 Mon Sep 17 00:00:00 2001
From: 2 * r + 2 * t <61896496+soramanew@users.noreply.github.com>
Date: Fri, 5 Jun 2026 16:54:40 +1000
Subject: [PATCH] refactor: fade flickable -> own component

---
 .../containers/VerticalFadeFlickable.qml      | 72 +++++++++++++++++++
 modules/nexus/navpane/NavLocations.qml        | 63 +---------------
 2 files changed, 73 insertions(+), 62 deletions(-)
 create mode 100644 components/containers/VerticalFadeFlickable.qml

diff --git a/components/containers/VerticalFadeFlickable.qml b/components/containers/VerticalFadeFlickable.qml
new file mode 100644
index 00000000..2d658541
--- /dev/null
+++ b/components/containers/VerticalFadeFlickable.qml
@@ -0,0 +1,72 @@
+pragma ComponentBehavior: Bound
+
+import QtQuick
+import qs.components
+import qs.components.effects
+
+StyledFlickable {
+    id: root
+
+    property real fadeAmount: 0.3
+
+    property real topFadeOpacity: fadeShouldBeActive(true) ? 0 : 1
+    property real bottomFadeOpacity: fadeShouldBeActive(false) ? 0 : 1
+
+    function fadeShouldBeActive(isStart: bool): bool {
+        // When content is smaller than flickable size, hide fade when rebound starts
+        if (contentHeight + topMargin + bottomMargin < height && rebound.running && ((isStart ? verticalOvershoot > 0 : verticalOvershoot < 0)))
+            return false;
+
+        if (isStart)
+            return visibleArea.yPosition > 0;
+        return visibleArea.yPosition + visibleArea.heightRatio < 1;
+    }
+
+    flickableDirection: Flickable.VerticalFlick
+
+    layer.enabled: true
+    layer.effect: Mask {
+        maskSource: mask
+
+        Rectangle {
+            id: mask
+
+            anchors.fill: parent
+            visible: false
+            layer.enabled: true
+
+            gradient: Gradient {
+                orientation: Gradient.Vertical
+
+                GradientStop {
+                    position: 0
+                    color: Qt.rgba(0, 0, 0, root.topFadeOpacity)
+                }
+                GradientStop {
+                    position: root.fadeAmount
+                    color: Qt.rgba(0, 0, 0, 1)
+                }
+                GradientStop {
+                    position: 1 - root.fadeAmount
+                    color: Qt.rgba(0, 0, 0, 1)
+                }
+                GradientStop {
+                    position: 1
+                    color: Qt.rgba(0, 0, 0, root.bottomFadeOpacity)
+                }
+            }
+        }
+    }
+
+    Behavior on topFadeOpacity {
+        Anim {
+            type: Anim.SlowEffects
+        }
+    }
+
+    Behavior on bottomFadeOpacity {
+        Anim {
+            type: Anim.SlowEffects
+        }
+    }
+}
diff --git a/modules/nexus/navpane/NavLocations.qml b/modules/nexus/navpane/NavLocations.qml
index 9ef8a330..484474e6 100644
--- a/modules/nexus/navpane/NavLocations.qml
+++ b/modules/nexus/navpane/NavLocations.qml
@@ -5,78 +5,17 @@ import QtQuick.Layouts
 import Caelestia.Config
 import qs.components
 import qs.components.containers
-import qs.components.effects
 import qs.services
 import qs.modules.nexus
 
-StyledFlickable {
+VerticalFadeFlickable {
     id: root
 
     required property NexusState nState
 
-    property real topFadeOpacity: fadeShouldBeActive(true) ? 0 : 1
-    property real bottomFadeOpacity: fadeShouldBeActive(false) ? 0 : 1
-
-    function fadeShouldBeActive(isStart: bool): bool {
-        // When content is smaller than flickable size, hide fade when rebound starts
-        if (contentHeight + topMargin + bottomMargin < height && rebound.running && ((isStart ? verticalOvershoot > 0 : verticalOvershoot < 0)))
-            return false;
-
-        if (isStart)
-            return visibleArea.yPosition > 0;
-        return visibleArea.yPosition + visibleArea.heightRatio < 1;
-    }
-
     topMargin: Tokens.padding.large
     bottomMargin: Tokens.padding.large
     contentHeight: content.implicitHeight
-    flickableDirection: Flickable.VerticalFlick
-
-    layer.enabled: true
-    layer.effect: Mask {
-        maskSource: mask
-
-        Rectangle {
-            id: mask
-
-            anchors.fill: parent
-            visible: false
-            layer.enabled: true
-
-            gradient: Gradient {
-                orientation: Gradient.Vertical
-
-                GradientStop {
-                    position: 0
-                    color: Qt.rgba(0, 0, 0, root.topFadeOpacity)
-                }
-                GradientStop {
-                    position: 0.3
-                    color: Qt.rgba(0, 0, 0, 1)
-                }
-                GradientStop {
-                    position: 0.7
-                    color: Qt.rgba(0, 0, 0, 1)
-                }
-                GradientStop {
-                    position: 1
-                    color: Qt.rgba(0, 0, 0, root.bottomFadeOpacity)
-                }
-            }
-        }
-    }
-
-    Behavior on topFadeOpacity {
-        Anim {
-            type: Anim.SlowEffects
-        }
-    }
-
-    Behavior on bottomFadeOpacity {
-        Anim {
-            type: Anim.SlowEffects
-        }
-    }
 
     ColumnLayout {
         id: content