ARK-OS/arkos/arkrt/ark.ui.basic/Sources/Backend/BackendFeatures/Gestures/HoverGestures.swift

extension BackendFeatures {
    /// Backend methods for hover gesture handling.
    ///
    /// These are used by ``View/onHover(perform:)``.
    @MainActor
    public protocol HoverGestures: Core {
        /// Wraps a view in a container that can receive mouse hover events.
        ///
        /// Some backends may not have to wrap the child, in which case they may
        /// just return the child as-is.
        ///
        /// - Parameter child: The child to wrap.
        /// - Returns: A widget that can receive mouse hover events.
        func createHoverTarget(wrapping child: Widget) -> Widget

        /// Update the hover target with a new action.
        ///
        /// The new action replaces the old action.
        ///
        /// - Parameters:
        ///   - hoverTarget: The hover target to update.
        ///   - environment: The current environment.
        ///   - action: The action to perform when the hover state changes. Receives
        ///     a `Bool` indicating whether the hover has started or stopped.
        func updateHoverTarget(
            _ hoverTarget: Widget,
            environment: EnvironmentValues,
            action: @escaping (Bool) -> Void
        )
    }
}