add docs for new modifiers

Author: calimarkus

JDStatusBarNotification/Public/NotificationViewExtension.swift

@@ -16,6 +16,20 @@ private struct SwiftUINotficationState {
 extension View {
   public typealias NotificationPrepareStyleClosure = (StatusBarNotificationStyle) -> Void
 
+  /// Presents a notification when a given condition is true.
+  ///
+  /// - Parameters:
+  ///   - isPresented: A binding to a Boolean value that determines whether to
+  ///     present the notification. When the notification gets dismissed for any reason,
+  ///     this value will be set to `false` again.
+  ///   - style:  A ``NotificationPrepareStyleClosure`` to customize a ``StatusBarNotificationStyle`` freely.
+  ///   - viewBuilder: A ViewBuilder closure to build your custom SwiftUI view.
+  ///
+  /// The `View` created by the `viewBuilder` will be layouted according to the selected style & the current device
+  /// state (rotation, status bar visibility, etc.). The background will be styled & layouted
+  /// according to the provided style. If your custom view requires custom touch handling,
+  /// make sure to set `style.canTapToHold` to `false`. Otherwise the `customView` won't receive any touches.
+  ///
   nonisolated public func notification(isPresented: Binding<Bool>, style: NotificationPrepareStyleClosure? = nil, @ViewBuilder viewBuilder: () -> some View) -> some View {
     let np = NotificationPresenter.shared
     var styleName: String? = nil
@@ -28,6 +42,21 @@ extension View {
     return notification(isPresented: isPresented, styleName: styleName, viewBuilder: viewBuilder)
   }
 
+
+  /// Presents a notification when a given condition is true.
+  ///
+  /// - Parameters:
+  ///   - isPresented: A binding to a Boolean value that determines whether to
+  ///     present the notification. When the notification gets dismissed for any reason,
+  ///     this value will be set to `false` again.
+  ///   - includedStyle:  A predefined ``IncludedStatusBarNotificationStyle`` to style this notification.
+  ///   - viewBuilder: A ViewBuilder closure to build your custom SwiftUI view.
+  ///
+  /// The `View` created by the `viewBuilder` will be layouted according to the selected style & the current device
+  /// state (rotation, status bar visibility, etc.). The background will be styled & layouted
+  /// according to the provided style. If your custom view requires custom touch handling,
+  /// make sure to set `style.canTapToHold` to `false`. Otherwise the `customView` won't receive any touches.
+  ///
   nonisolated public func notification(isPresented: Binding<Bool>, includedStyle: IncludedStatusBarNotificationStyle? = nil, @ViewBuilder viewBuilder: () -> some View) -> some View {
     let np = NotificationPresenter.shared
     var styleName: String? = nil
@@ -37,6 +66,22 @@ extension View {
     return notification(isPresented: isPresented, styleName: styleName, viewBuilder: viewBuilder)
   }
 
+
+  /// Presents a notification when a given condition is true.
+  ///
+  /// - Parameters:
+  ///   - isPresented: A binding to a Boolean value that determines whether to
+  ///     present the notification. When the notification gets dismissed for any reason,
+  ///     this value will be set to `false` again.
+  ///   - styleName: The name of the style. You can use styles previously added using e.g. ``addStyle(named:usingStyle:prepare:)``.
+  ///            If no style can be found for the given `styleName` or it is `nil`, the default style will be used.
+  ///   - viewBuilder: A ViewBuilder closure to build your custom SwiftUI view.
+  ///
+  /// The `View` created by the `viewBuilder` will be layouted according to the selected style & the current device
+  /// state (rotation, status bar visibility, etc.). The background will be styled & layouted
+  /// according to the provided style. If your custom view requires custom touch handling,
+  /// make sure to set `style.canTapToHold` to `false`. Otherwise the `customView` won't receive any touches.
+  ///
   nonisolated public func notification(isPresented: Binding<Bool>, styleName: String? = nil, @ViewBuilder viewBuilder: () -> some View) -> some View {
     let np = NotificationPresenter.shared