Added: diffableTextViews_toolbarDoneButton(_:)

Author: oscbyspro

README.md

@@ -79,6 +79,7 @@ diffableTextViews_textContentType(_:)
 diffableTextViews_textFieldStyle(_:)
 diffableTextViews_textInputAutocapitalization(_:)
 diffableTextViews_tint(_:)
+diffableTextViews_toolbarDoneButton(_:)
 ```
 
 # Styles

Sources/DiffableTextKit/Utilities/Brrr.swift

@@ -17,11 +17,10 @@
 ///
 public struct Brrr: Equatable {
 
-    public static let dismiss          = Self("dismiss")
     public static let cancellation     = Self("cancellation")
     public static let autocorrection   = Self("autocorrection")
     public static let unsynchronizable = Self("unsynchronizable")
-
+    
     //=------------------------------------------------------------------------=
 
     #if DEBUG

Sources/DiffableTextKitXUIKit/DiffableTextField.swift

@@ -32,6 +32,7 @@ import SwiftUI
 /// - diffableTextViews_textFieldStyle(\_:)
 /// - diffableTextViews_textInputAutocapitalization(\_:)
 /// - diffableTextViews_tint(\_:)
+/// - diffableTextViews_toolbarDoneButton(\_:)
 ///
 public struct DiffableTextField<Style: DiffableTextStyle>: UIViewRepresentable {
 
@@ -116,7 +117,8 @@ public struct DiffableTextField<Style: DiffableTextStyle>: UIViewRepresentable {
             // Downstream
             //=----------------------------------=
             self.downstream.delegate = self
-            self.downstream.textFieldStyle(environment)
+            self.downstream.setupTextFieldStyle(environment)
+            self.downstream.setupToolbarDoneButton(environment)
             //=----------------------------------=
             // Synchronize
             //=----------------------------------=

Sources/DiffableTextKitXUIKit/Environment+TextFieldStyle.swift

@@ -27,7 +27,8 @@ extension EnvironmentValues {
 }
 
 public extension View {
-    @inlinable func diffableTextViews_textFieldStyle(_  style: UITextField.BorderStyle) -> some View {
+    @inlinable func diffableTextViews_textFieldStyle(
+    _ style: UITextField.BorderStyle) -> some View  {
         environment(\.diffableTextViews_textFieldStyle, style)
     }
 }

Sources/DiffableTextKitXUIKit/Environment+ToolbarDoneButton.swift

@@ -0,0 +1,37 @@
+//=----------------------------------------------------------------------------=
+// This source file is part of the DiffableTextViews open source project.
+//
+// Copyright (c) 2022 Oscar Byström Ericsson
+// Licensed under Apache License, Version 2.0
+//
+// See http://www.apache.org/licenses/LICENSE-2.0 for license information.
+//=----------------------------------------------------------------------------=
+
+#if canImport(UIKit)
+
+import SwiftUI
+import UIKit
+
+//*============================================================================*
+// MARK: * Environment x Toolbar Done Button [...]
+//*============================================================================*
+
+@usableFromInline enum DiffableTextViews_ToolbarDoneButton: EnvironmentKey {
+    @usableFromInline static let defaultValue: UIBarButtonItem.Style? = nil
+}
+
+extension EnvironmentValues {
+    @inlinable var diffableTextViews_toolbarDoneButton: UIBarButtonItem.Style? {
+        get { self[DiffableTextViews_ToolbarDoneButton.self] }
+        set { self[DiffableTextViews_ToolbarDoneButton.self] = newValue }
+    }
+}
+
+public extension View {
+    @inlinable func diffableTextViews_toolbarDoneButton(
+    _ style: UIBarButtonItem.Style = .plain) -> some View  {
+        environment(\.diffableTextViews_toolbarDoneButton, style)
+    }
+}
+
+#endif

Sources/DiffableTextKitXUIKit/Models/Field.swift

@@ -45,6 +45,27 @@ import UIKit
         fatalError("init(coder:) has not been implemented")
     }
 
+    //=------------------------------------------------------------------------=
+    // MARK: Transformations
+    //=------------------------------------------------------------------------=
+    
+    @usableFromInline func setupToolbarDoneButton(_ style: UIBarButtonItem.Style) {
+        let toolbar = UIToolbar()
+        let button  = UIBarButtonItem(systemItem: .done)
+        let spacer  = UIBarButtonItem(systemItem: .flexibleSpace)
+        let insets  = UIBarButtonItem(systemItem: .fixedSpace)
+        let dismiss = UIAction{[weak self] _ in self?.resignFirstResponder()}
+        
+        insets.width = 8
+        button.style = style
+        button.primaryAction = dismiss
+        
+        toolbar.items = [insets, spacer, button, insets]
+        toolbar.sizeToFit()
+        
+        self.inputAccessoryView = toolbar
+    }
+    
     //=------------------------------------------------------------------------=
     // MARK: Events
     //=------------------------------------------------------------------------=

Sources/DiffableTextKitXUIKit/Streams/Downstream.swift

@@ -59,7 +59,20 @@ import UIKit
     }
 
     //=------------------------------------------------------------------------=
-    // MARK: Transformations
+    // MARK: Transformations x Setup
+    //=------------------------------------------------------------------------=
+    
+    @inlinable func setupTextFieldStyle(_ environment: EnvironmentValues) {
+        self.view.borderStyle = environment.diffableTextViews_textFieldStyle
+    }
+    
+    @inlinable func setupToolbarDoneButton(_ environment: EnvironmentValues) {
+        guard let style = environment.diffableTextViews_toolbarDoneButton else { return }
+        self.view.setupToolbarDoneButton(style)
+    }
+    
+    //=------------------------------------------------------------------------=
+    // MARK: Transformations x Update
     //=------------------------------------------------------------------------=
 
     @inlinable func placeholder(_ placeholder: String) {
@@ -97,10 +110,6 @@ import UIKit
         self.view.textContentType = environment.diffableTextViews_textContentType
     }
 
-    @inlinable func textFieldStyle(_ environment: EnvironmentValues) {
-        self.view.borderStyle = environment.diffableTextViews_textFieldStyle
-    }
-    
     @inlinable func textInputAutocapitalization(_ environment: EnvironmentValues) {
         let autocapitalization = environment.diffableTextViews_textInputAutocapitalization
         self.view.autocapitalizationType = autocapitalization ?? .sentences