feat: Added detent sheet

Author: WallabyStuff

Examples/SingleNavigator/01-SingleBasic/SingleBasic/Page/Home/HomeView.swift

@@ -42,6 +42,17 @@ struct HomeView: View {
         Text("open Page 2 as Sheet")
           .foregroundColor(.purple)
       }
+      
+      Button(action: {
+        if #available(iOS 15.0, *) {
+          navigator.detentSheet(linkItem: .init(pathList: ["page1", "page2"]), isAnimated: true, configuration: .default)
+        } else {
+          navigator.sheet(linkItem: .init(pathList: ["page1", "page2"]), isAnimated: true)
+        }
+      }) {
+        Text("open Page 2 as Detent Sheet")
+          .foregroundColor(.purple)
+      }
 
       Button(action: {
         navigator.fullSheet(linkItem: .init(pathList: ["page1", "page2"]), isAnimated: true, prefersLargeTitles: true)

Sources/LinkNavigator/Core/Core/DetentConfiguration.swift

@@ -0,0 +1,47 @@
+import UIKit
+
+@available(iOS 15.0, *)
+public struct DetentConfiguration {
+  
+  public static let `default` = DetentConfiguration(detents: [.medium(), .large()])
+  
+  public let detents: [UISheetPresentationController.Detent]
+  public let cornerRadius: CGFloat?
+  public let largestUndimmedDetentIdentifier: UISheetPresentationController.Detent.Identifier?
+  public let prefersScrollingExpandsWhenScrolledToEdge: Bool
+  public let prefersGrabberVisible: Bool
+  public let prefersEdgeAttachedInCompactHeight: Bool
+  public let widthFollowsPreferredContentSizeWhenEdgeAttached: Bool
+  public let selectedDetentIdentifier: UISheetPresentationController.Detent.Identifier?
+  
+  /// Initializes a new DetentConfiguration.
+  ///
+  /// - Parameters:
+  ///   - detents: An array of `UISheetPresentationController.Detent` defining the sizes of the sheet.
+  ///   - cornerRadius: An optional `CGFloat` specifying the corner radius of the sheet.
+  ///   - largestUndimmedDetentIdentifier: An optional detent identifier specifying the largest undimmed size.
+  ///   - prefersScrollingExpandsWhenScrolledToEdge: A Boolean value indicating if scrolling should expand the sheet.
+  ///   - prefersGrabberVisible: A Boolean value indicating if the grabber should be visible.
+  ///   - prefersEdgeAttachedInCompactHeight: A Boolean value indicating if the sheet should be edge-attached in compact height.
+  ///   - widthFollowsPreferredContentSizeWhenEdgeAttached: A Boolean value indicating if the sheet's width should follow the preferred content size when edge-attached.
+  ///   - selectedDetentIdentifier: An optional detent identifier specifying the currently selected detent.
+  public init(
+    detents: [UISheetPresentationController.Detent],
+    cornerRadius: CGFloat? = nil,
+    largestUndimmedDetentIdentifier: UISheetPresentationController.Detent.Identifier? = nil,
+    prefersScrollingExpandsWhenScrolledToEdge: Bool = true,
+    prefersGrabberVisible: Bool = false,
+    prefersEdgeAttachedInCompactHeight: Bool = false,
+    widthFollowsPreferredContentSizeWhenEdgeAttached: Bool = false,
+    selectedDetentIdentifier: UISheetPresentationController.Detent.Identifier? = nil
+  ) {
+    self.detents = detents
+    self.cornerRadius = cornerRadius
+    self.largestUndimmedDetentIdentifier = largestUndimmedDetentIdentifier
+    self.prefersScrollingExpandsWhenScrolledToEdge = prefersScrollingExpandsWhenScrolledToEdge
+    self.prefersGrabberVisible = prefersGrabberVisible
+    self.prefersEdgeAttachedInCompactHeight = prefersEdgeAttachedInCompactHeight
+    self.widthFollowsPreferredContentSizeWhenEdgeAttached = widthFollowsPreferredContentSizeWhenEdgeAttached
+    self.selectedDetentIdentifier = selectedDetentIdentifier
+  }
+}

Sources/LinkNavigator/Core/Core/SingleLinkNavigator.swift

@@ -140,7 +140,20 @@ extension SingleLinkNavigator {
   private func _sheet(linkItem: LinkItem, isAnimated: Bool) {
     sheetOpen(item: linkItem, isAnimated: isAnimated)
   }
-
+  
+  /// Opens a sheet with the specified link item and an option to animate the presentation.
+  ///
+  /// - Parameters:
+  ///   - linkItem: An object representing the item to be presented in the sheet, can be a `String` or a dictionary with `String` keys and values as `ItemValue`.
+  ///   - isAnimated: A boolean to indicate if the presentation should be animated.
+  ///   - configuration: A `DetentConfiguration` object that defines the appearance and behavior of the sheet.
+  ///
+  /// - Available from iOS 15.0 and later.
+  @available(iOS 15.0, *)
+  private func _detentSheet(linkItem: LinkItem, isAnimated: Bool, configuration: DetentConfiguration) {
+      detentSheetOpen(item: linkItem, isAnimated: isAnimated, configuration: configuration)
+    }
+  
   /// Opens a full-screen sheet with options for animation and large titles.
   ///
   /// - Parameters:
@@ -401,6 +414,40 @@ extension SingleLinkNavigator {
       subController = newController
     }
   }
+  
+  @available(iOS 15.0, *)
+  public func detentSheetOpen(
+    item: LinkItem,
+    isAnimated: Bool,
+    configuration: DetentConfiguration)
+  {
+    DispatchQueue.main.async { [weak self] in
+      guard let self else { return }
+      guard let rootController else { return }
+
+      rootController.dismiss(animated: true)
+      let newController = UINavigationController()
+      
+      if let sheetPresentationController = newController.sheetPresentationController {
+        sheetPresentationController.detents = configuration.detents
+        sheetPresentationController.preferredCornerRadius = configuration.cornerRadius
+        sheetPresentationController.largestUndimmedDetentIdentifier = configuration.largestUndimmedDetentIdentifier
+        sheetPresentationController.prefersScrollingExpandsWhenScrolledToEdge = configuration.prefersScrollingExpandsWhenScrolledToEdge
+        sheetPresentationController.prefersGrabberVisible = configuration.prefersGrabberVisible
+        sheetPresentationController.prefersEdgeAttachedInCompactHeight = configuration.prefersEdgeAttachedInCompactHeight
+        sheetPresentationController.widthFollowsPreferredContentSizeWhenEdgeAttached = configuration.widthFollowsPreferredContentSizeWhenEdgeAttached
+        sheetPresentationController.selectedDetentIdentifier = configuration.selectedDetentIdentifier
+      }
+
+      newController.setViewControllers(
+        navigationBuilder.build(item: item),
+        animated: false)
+
+      rootController.present(newController, animated: isAnimated)
+      
+      subController = newController
+    }
+  }
 
   // MARK: Private
 
@@ -435,6 +482,15 @@ extension SingleLinkNavigator: LinkNavigatorProtocol {
   public func sheet(linkItem: LinkItem, isAnimated: Bool) {
     _sheet(linkItem: linkItem, isAnimated: isAnimated)
   }
+  
+  @available(iOS 15.0, *)
+  public func detentSheet(
+    linkItem: LinkItem,
+    isAnimated: Bool,
+    configuration: DetentConfiguration
+  ) {
+    _detentSheet(linkItem: linkItem, isAnimated: isAnimated, configuration: configuration)
+  }
 
   public func fullSheet(linkItem: LinkItem, isAnimated: Bool, prefersLargeTitles: Bool?) {
     _fullSheet(linkItem: linkItem, isAnimated: isAnimated, prefersLargeTitles: prefersLargeTitles)

Sources/LinkNavigator/Core/Protocol/LinkNavigatorProtocol.swift

@@ -25,7 +25,22 @@ public protocol LinkNavigatorProtocol {
   ///   - linkItem: The link item to present.
   ///   - isAnimated: A Boolean value that determines whether the presentation is animated.
   func sheet(linkItem: LinkItem, isAnimated: Bool)
-
+  
+  /// Presents a sheet with the given link item.
+  ///
+  /// - Parameters:
+  ///   - linkItem: The link item to present.
+  ///   - isAnimated: A Boolean value that determines whether the presentation is animated.
+  ///   - configuration: A `DetentConfiguration` object that defines the appearance and behavior of the sheet.
+  ///
+  /// - Available from iOS 15.0 and later.
+  @available(iOS 15.0, *)
+  func detentSheet(
+      linkItem: LinkItem,
+      isAnimated: Bool,
+      configuration: DetentConfiguration
+  )
+  
   /// Presents a full sheet with the given link item.
   ///
   /// - Parameters:

Sources/LinkNavigator/Test/SingleLinkNavigatorMock.swift

@@ -118,6 +118,11 @@ extension SingleLinkNavigatorMock: LinkNavigatorProtocol {
   public func sheet(linkItem _: LinkItem, isAnimated _: Bool) {
     event.sheet += 1
   }
+  
+  @available(iOS 15.0, *)
+  public func detentSheet(linkItem: LinkItem, isAnimated: Bool, configuration: DetentConfiguration) {
+    event.sheet += 1
+  }
 
   public func fullSheet(linkItem _: LinkItem, isAnimated _: Bool, prefersLargeTitles _: Bool?) {
     event.fullSheet += 1