Allow customizing soft break mode

Resolved #341

Sources/MarkdownUI/DSL/Inlines/SoftBreak.swift

@@ -11,3 +11,13 @@ public struct SoftBreak: InlineContentProtocol {
     .init(inlines: [.softBreak])
   }
 }
+
+extension SoftBreak {
+  public enum Mode {
+    /// Treat a soft break as a space
+    case space
+
+    /// Treat a soft break as a line break
+    case lineBreak
+  }
+}

Sources/MarkdownUI/Renderer/TextInlineRenderer.swift

@@ -5,12 +5,14 @@ extension Sequence where Element == InlineNode {
     baseURL: URL?,
     textStyles: InlineTextStyles,
     images: [String: Image],
+    softBreakMode: SoftBreak.Mode,
     attributes: AttributeContainer
   ) -> Text {
     var renderer = TextInlineRenderer(
       baseURL: baseURL,
       textStyles: textStyles,
       images: images,
+      softBreakMode: softBreakMode,
       attributes: attributes
     )
     renderer.render(self)
@@ -24,18 +26,21 @@ private struct TextInlineRenderer {
   private let baseURL: URL?
   private let textStyles: InlineTextStyles
   private let images: [String: Image]
+  private let softBreakMode: SoftBreak.Mode
   private let attributes: AttributeContainer
   private var shouldSkipNextWhitespace = false
 
   init(
     baseURL: URL?,
     textStyles: InlineTextStyles,
     images: [String: Image],
+    softBreakMode: SoftBreak.Mode,
     attributes: AttributeContainer
   ) {
     self.baseURL = baseURL
     self.textStyles = textStyles
     self.images = images
+    self.softBreakMode = softBreakMode
     self.attributes = attributes
   }
 
@@ -72,10 +77,16 @@ private struct TextInlineRenderer {
   }
 
   private mutating func renderSoftBreak() {
-    if self.shouldSkipNextWhitespace {
-      self.shouldSkipNextWhitespace = false
-    } else {
-      self.defaultRender(.softBreak)
+    switch self.softBreakMode {
+    case .space:
+      if self.shouldSkipNextWhitespace {
+        self.shouldSkipNextWhitespace = false
+      } else {
+        self.defaultRender(.softBreak)
+      }
+    case .lineBreak:
+      self.shouldSkipNextWhitespace = true
+      self.defaultRender(.lineBreak)
     }
   }
 

Sources/MarkdownUI/Views/Environment/Environment+SoftBreakMode.swift

@@ -0,0 +1,23 @@
+import SwiftUI
+
+extension View {
+  /// Sets the soft break mode for inline texts in a view hierarchy.
+  ///
+  /// - parameter softBreakMode: If set to `space`, treats all soft breaks as spaces, keeping sentences whole. If set to `lineBreak`, treats soft breaks as full line breaks
+  ///
+  /// - Returns: A view that uses the specified soft break mode for itself and its child views.
+  public func markdownSoftBreakMode(_ softBreakMode: SoftBreak.Mode) -> some View {
+    self.environment(\.softBreakMode, softBreakMode)
+  }
+}
+
+extension EnvironmentValues {
+  var softBreakMode: SoftBreak.Mode {
+    get { self[SoftBreakModeKey.self] }
+    set { self[SoftBreakModeKey.self] = newValue }
+  }
+}
+
+private struct SoftBreakModeKey: EnvironmentKey {
+  static let defaultValue: SoftBreak.Mode = .space
+}

Sources/MarkdownUI/Views/Inlines/InlineText.swift

@@ -4,6 +4,7 @@ struct InlineText: View {
   @Environment(\.inlineImageProvider) private var inlineImageProvider
   @Environment(\.baseURL) private var baseURL
   @Environment(\.imageBaseURL) private var imageBaseURL
+  @Environment(\.softBreakMode) private var softBreakMode
   @Environment(\.theme) private var theme
 
   @State private var inlineImages: [String: Image] = [:]
@@ -26,6 +27,7 @@ struct InlineText: View {
           link: self.theme.link
         ),
         images: self.inlineImages,
+        softBreakMode: self.softBreakMode,
         attributes: attributes
       )
     }