#188: Add .automatic case, remove unused variables, and apply minor adjustments

Author: Vitor Silveira

Examples/Sources/NotesExample/ContentView.swift

@@ -142,7 +142,6 @@ struct ContentView: View {
                             .padding()
                             .background(textEditorBackground)
                             .cornerRadius(4)
-                            .scrollDismissesKeyboard(.interactively)
                     }
                 }
                 .padding()

Sources/AppKitBackend/AppKitBackend.swift

@@ -861,9 +861,7 @@ public final class AppKitBackend: AppBackend {
         return scrollView
     }
 
-    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
-        let scrollView = scrollView as! NSScrollView
-    }
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
 
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,

Sources/Gtk3Backend/Gtk3Backend.swift

@@ -539,9 +539,7 @@ public final class Gtk3Backend: AppBackend {
         return scrollView
     }
 
-    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
-        let scrollView = scrollView as! ScrolledWindow
-    }
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
 
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,

Sources/GtkBackend/GtkBackend.swift

@@ -503,9 +503,7 @@ public final class GtkBackend: AppBackend {
         return scrollView
     }
 
-    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
-        let scrollView = scrollView as! ScrolledWindow
-    }
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
 
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,

Sources/SwiftCrossUI/Backend/AppBackend.swift

@@ -268,8 +268,6 @@ public protocol AppBackend {
     ///
     /// This method is primarily used on iOS to apply environment changes
     /// that affect the scroll view’s behavior, such as keyboard dismissal mode.
-    /// It allows the backend to update UIKit-specific properties (e.g. `keyboardDismissMode`)
-    /// when the environment changes.
     ///
     /// - Parameters:
     ///   - scrollView: The scroll container widget previously created by `createScrollContainer(for:)`.

Sources/SwiftCrossUI/Environment/EnvironmentValues.swift

@@ -77,7 +77,8 @@ public struct EnvironmentValues {
 
     /// Whether user interaction is enabled. Set by ``View/disabled(_:)``.
     public var isEnabled: Bool
-    
+
+    /// The way that scrollable content interacts with the software keyboard.
     public var scrollDismissesKeyboardMode: ScrollDismissesKeyboardMode
 
     /// Called by view graph nodes when they resize due to an internal state
@@ -198,7 +199,7 @@ public struct EnvironmentValues {
         listStyle = .default
         toggleStyle = .button
         isEnabled = true
-        scrollDismissesKeyboardMode = .interactively
+        scrollDismissesKeyboardMode = .automatic
     }
 
     /// Returns a copy of the environment with the specified property set to the

Sources/SwiftCrossUI/Values/ScrollDismissesKeyboardMode.swift

@@ -3,6 +3,14 @@
 /// Use this type in a call to the ``View/scrollDismissesKeyboard(_:)``
 /// modifier to specify the dismissal behavior of scrollable views.
 public enum ScrollDismissesKeyboardMode: Sendable {
+    /// Determine the mode automatically based on the surrounding context.
+    ///
+    /// Currently, this behaves the same as ``ScrollDismissesKeyboardMode/interactively``.
+    /// In the future, it may adapt dynamically based on the context, similar to how
+    /// SwiftUI's `.automatic` works (e.g., using `.interactively` in some views and
+    /// `.immediately` in others). Using this value avoids source-breaking changes later on.
+    case automatic
+
     /// Dismiss the keyboard as soon as scrolling starts.
     case immediately
 

Sources/UIKitBackend/UIKitBackend+Container.swift

@@ -60,6 +60,8 @@ final class ScrollWidget: ContainerWidget {
     public func updateScrollContainer(environment: EnvironmentValues) {
         #if os(iOS)
             scrollView.keyboardDismissMode = switch environment.scrollDismissesKeyboardMode {
+                case .automatic:
+                    .interactive
                 case .immediately:
                     .onDrag
                 case .interactively:

Sources/UIKitBackend/UIKitBackend+Control.swift

@@ -320,6 +320,8 @@ extension UIKitBackend {
 
             textEditorWidget.child.alwaysBounceVertical = environment.scrollDismissesKeyboardMode != .never
             textEditorWidget.child.keyboardDismissMode = switch environment.scrollDismissesKeyboardMode {
+                case .automatic:
+                    textEditorWidget.child.inputAccessoryView == nil ? .interactive : .interactiveWithAccessory
                 case .immediately:
                     textEditorWidget.child.inputAccessoryView == nil ? .onDrag : .onDragWithAccessory
                 case .interactively:

Sources/WinUIBackend/WinUIBackend.swift

@@ -616,9 +616,7 @@ public final class WinUIBackend: AppBackend {
         return scrollViewer
     }
 
-    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {
-        let scrollView = scrollView as! WinUI.ScrollViewer
-    }
+    public func updateScrollContainer(_ scrollView: Widget, environment: EnvironmentValues) {}
 
     public func setScrollBarPresence(
         ofScrollContainer scrollView: Widget,