Added .onHover for AppKit Backend

Added:
- onHover(_ action: (Bool) -> Void) View Extension
- OnHoverModifier TypeSafeView
- createHoverTarget(wrapping: Widget) -> Widget to AppBackend Protocol
- updateHoverTarget(_: Widget, environment: EnvironmentValues, action: (Bool) -> Void) to AppBackend Protocol
- corresponding default implementations
- AppKitBackend hover implementation
   - createHoverTarget implementation
   - updateHoverTarget implementation
   - NSCustomHoverTarget (NSView notifying about hovers)
- HoverExample

Fixed:
- AppKitBackend
   - fixed reference removing for NSClickGestureRecognizer in NSCustomTapGestureTarget

Author: MiaKoring

Examples/Bundler.toml

@@ -59,3 +59,8 @@ version = '0.1.0'
 identifier = 'dev.swiftcrossui.WebViewExample'
 product = 'WebViewExample'
 version = '0.1.0'
+
+[apps.HoverExample]
+identifier = 'dev.swiftcrossui.HoverExample'
+product = 'HoverExample'
+version = '0.1.0'

Examples/Package.swift

@@ -72,6 +72,10 @@ let package = Package(
         .executableTarget(
             name: "WebViewExample",
             dependencies: exampleDependencies
+        ),
+        .executableTarget(
+            name: "HoverExample",
+            dependencies: exampleDependencies
         )
     ]
 )

Examples/Sources/HoverExample/HoverApp.swift

@@ -0,0 +1,52 @@
+import DefaultBackend
+import SwiftCrossUI
+import Foundation
+
+#if canImport(SwiftBundlerRuntime)
+    import SwiftBundlerRuntime
+#endif
+
+@main
+struct HoverExample: App {
+    var body: some Scene {
+        WindowGroup("Hover Example") {
+            VStack(spacing: 0) {
+                ForEach([Bool](repeating: false, count: 18)) { _ in
+                    HStack(spacing: 0) {
+                        ForEach([Bool](repeating: false, count: 30)) { _ in
+                            CellView()
+                        }
+                    }
+                }
+            }
+            .background(Color.black)
+        }
+        .defaultSize(width: 900, height: 540)
+    }
+}
+
+struct CellView: View {
+    @State var timer: Timer?
+    @Environment(\.colorScheme) var colorScheme
+    @State var opacity: Float = 0.0
+    
+    var body: some View {
+        Rectangle()
+            .foregroundColor(Color.blue.opacity(opacity))
+            .onHover { hovering in
+                if !hovering {
+                    timer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { timer in
+                        if opacity >= 0.05 {
+                            opacity -= 0.05
+                        } else {
+                            opacity = 0.0
+                            timer.invalidate()
+                        }
+                    }
+                } else {
+                    opacity = 1.0
+                    timer = nil
+                }
+            }
+    }
+}

Sources/AppKitBackend/AppKitBackend.swift

@@ -1424,6 +1424,40 @@ public final class AppKitBackend: AppBackend {
                 tapGestureTarget.longPressHandler = action
         }
     }
+    
+    public func createHoverTarget(wrapping child: Widget) -> Widget {
+        let container = NSView()
+
+        container.addSubview(child)
+        child.leadingAnchor.constraint(equalTo: container.leadingAnchor)
+            .isActive = true
+        child.topAnchor.constraint(equalTo: container.topAnchor)
+            .isActive = true
+        child.translatesAutoresizingMaskIntoConstraints = false
+
+        let tapGestureTarget = NSCustomHoverTarget()
+        container.addSubview(tapGestureTarget)
+        tapGestureTarget.leadingAnchor.constraint(equalTo: container.leadingAnchor)
+            .isActive = true
+        tapGestureTarget.topAnchor.constraint(equalTo: container.topAnchor)
+            .isActive = true
+        tapGestureTarget.trailingAnchor.constraint(equalTo: container.trailingAnchor)
+            .isActive = true
+        tapGestureTarget.bottomAnchor.constraint(equalTo: container.bottomAnchor)
+            .isActive = true
+        tapGestureTarget.translatesAutoresizingMaskIntoConstraints = false
+
+        return container
+    }
+    
+    public func updateHoverTarget(
+        _ container: Widget,
+        environment: EnvironmentValues,
+        action: @escaping (Bool) -> Void
+    ) {
+        let tapGestureTarget = container.subviews[1] as! NSCustomHoverTarget
+        tapGestureTarget.hoverChangesHandler = action
+    }
 
     final class NSBezierPathView: NSView {
         var path: NSBezierPath!
@@ -1663,7 +1697,7 @@ final class NSCustomTapGestureTarget: NSView {
                 leftClickRecognizer = gestureRecognizer
             } else if leftClickHandler == nil, let leftClickRecognizer {
                 removeGestureRecognizer(leftClickRecognizer)
-                self.leftClickHandler = nil
+                self.leftClickRecognizer = nil
             }
         }
     }
@@ -1678,7 +1712,7 @@ final class NSCustomTapGestureTarget: NSView {
                 rightClickRecognizer = gestureRecognizer
             } else if rightClickHandler == nil, let rightClickRecognizer {
                 removeGestureRecognizer(rightClickRecognizer)
-                self.rightClickHandler = nil
+                self.rightClickRecognizer = nil
             }
         }
     }
@@ -1724,6 +1758,56 @@ final class NSCustomTapGestureTarget: NSView {
     }
 }
 
+final class NSCustomHoverTarget: NSView {
+    var hoverChangesHandler: ((Bool) -> Void)? {
+        didSet {
+            if hoverChangesHandler != nil && trackingArea == nil {
+                let options: NSTrackingArea.Options = [
+                    .mouseEnteredAndExited,
+                    .activeInKeyWindow
+                ]
+                let area = NSTrackingArea(rect: self.bounds,
+                                              options: options,
+                                              owner: self,
+                                              userInfo: nil)
+                addTrackingArea(area)
+                trackingArea = area
+            } else if hoverChangesHandler == nil, let trackingArea {
+                removeTrackingArea(trackingArea)
+                self.trackingArea = nil
+            }
+        }
+    }
+
+    private var trackingArea: NSTrackingArea?
+
+    override func updateTrackingAreas() {
+        super.updateTrackingAreas()
+        if let trackingArea = trackingArea {
+            self.removeTrackingArea(trackingArea)
+        }
+        let options: NSTrackingArea.Options = [
+            .mouseEnteredAndExited,
+            .activeInKeyWindow
+        ]
+        
+        trackingArea = NSTrackingArea(rect: self.bounds,
+                                      options: options,
+                                      owner: self,
+                                      userInfo: nil)
+        self.addTrackingArea(trackingArea!)
+    }
+    
+    override func mouseEntered(with event: NSEvent) {
+        hoverChangesHandler?(true)
+    }
+    
+    override func mouseExited(with event: NSEvent) {
+        // Mouse exited the view's bounds
+        hoverChangesHandler?(false)
+    }
+}
+
 final class NSCustomMenuItem: NSMenuItem {
     /// This property's only purpose is to keep a strong reference to the wrapped
     /// action so that it sticks around for long enough to be useful.