feat: added Extra parameter to set large title for navigation.

Author: interactord

Examples/MVI-Example/MVI-Example/AppMain.swift

@@ -21,7 +21,7 @@ extension AppMain: App {
   var body: some Scene {
     WindowGroup {
       navigator
-        .launch(paths: ["home"], items: [:])
+        .launch(paths: ["home"], items: [:], prefersLargeTitles: true)
         .onOpenURL { url in
           print(url.absoluteString)
           // !!!: mvi-ex://host/home/page1/page2/page3/page4?page3-message=hello&page4-message=%ED%95%9C%EA%B8%80

Examples/MVI-Example/MVI-Example/Feature/Home/HomeIntent.swift

@@ -59,7 +59,7 @@ extension HomeIntent: IntentType, HomeIntentType {
       navigator.sheet(paths: ["page1", "page2"], items: [:], isAnimated: true)
 
     case .onTapFullSheet:
-      navigator.fullSheet(paths: ["page1", "page2"], items: [:], isAnimated: true)
+      navigator.fullSheet(paths: ["page1", "page2"], items: [:], isAnimated: true, prefersLargeTitles: true)
     }
   }
 }

Examples/MVI-Example/MVI-Example/Feature/Home/HomeView.swift

@@ -14,9 +14,6 @@ extension HomeView: View {
   var body: some View {
     ScrollView {
       VStack(spacing: 40) {
-        Text("Home")
-          .font(.system(size: 60, weight: .thin))
-
         NavigationStackViewer(paths: state.paths)
 
         Button(action: { intent.send(action: .onTapNext) }) {
@@ -65,6 +62,7 @@ extension HomeView: View {
         Spacer()
       }
       .padding(.horizontal)
+      .navigationBarTitleDisplayMode(.large)
       .navigationTitle("Home")
       .onAppear {
         intent.send(action: .getPaths)

Examples/TCA-Example/TCA-Example/AppMain.swift

@@ -23,7 +23,7 @@ extension AppMain: App {
   var body: some Scene {
     WindowGroup {
       navigator
-        .launch(paths: ["home"], items: [:])
+        .launch(paths: ["home"], items: [:], prefersLargeTitles: false)
         .onOpenURL { url in
           print(url.absoluteString)
           // !!!: tca-ex://host/home/page1/page2/page3/page4?page3-message=hello&page4-message=%ED%95%9C%EA%B8%80

Examples/TCA-Example/TCA-Example/Feature/Home/HomeSideEffect.swift

@@ -57,7 +57,7 @@ extension HomeSideEffectLive: HomeSideEffect {
 
   public var routeToFullSheet: () -> Void {
     {
-      navigator.fullSheet(paths: ["page1", "page2"], items: [:], isAnimated: true)
+      navigator.fullSheet(paths: ["page1", "page2"], items: [:], isAnimated: true, prefersLargeTitles: true)
     }
   }
 }

Sources/LinkNavigator/Core/LinkNavigator.swift

@@ -100,7 +100,12 @@ public protocol LinkNavigatorType {
   ///   - paths: An array of ``RouteBuilder/matchPath`` for some specific pages.
   ///   - items: A dictionary of `String` type key-value pairs.
   ///   - isAnimated: makes the transition to be animated.
-  func fullSheet(paths: [String], items: [String: String], isAnimated: Bool)
+  ///   - prefersLargeTitles:
+  ///         The SubNavigationViewController has a Boolean value that determines whether to display the title in a large format.
+  ///         ``If the value is null or .none, the previously set value will be maintained.``
+  ///         You can set it to true to use a large title in the modal or control it dynamically.
+  ///
+  func fullSheet(paths: [String], items: [String: String], isAnimated: Bool, prefersLargeTitles: Bool?)
 
   /// Presents a custom sheet that has its own navigation stack.
   ///
@@ -112,7 +117,8 @@ public protocol LinkNavigatorType {
   ///   items: [:],
   ///   isAnimated: true,
   ///   iPhonePresentationStyle: .fullScreen,
-  ///   iPadPresentationStyle: .automatic)
+  ///   iPadPresentationStyle: .automatic,
+  ///   prefersLargeTitles: .none)
   /// ```
   ///
   /// - Note: If there's an active modal in `rootNavigationController`, then
@@ -123,12 +129,17 @@ public protocol LinkNavigatorType {
   ///   - paths: An array of ``RouteBuilder/matchPath`` for some specific pages.
   ///   - items: A dictionary of `String` type key-value pairs.
   ///   - isAnimated: makes the transition to be animated.
+  ///   - prefersLargeTitles:
+  ///         The SubNavigationViewController has a Boolean value that determines whether to display the title in a large format.
+  ///         ``If the value is null or .none, the previously set value will be maintained.``
+  ///         You can set it to true to use a large title in the modal or control it dynamically.
   func customSheet(
     paths: [String],
     items: [String: String],
     isAnimated: Bool,
     iPhonePresentationStyle: UIModalPresentationStyle,
-    iPadPresentationStyle: UIModalPresentationStyle)
+    iPadPresentationStyle: UIModalPresentationStyle,
+    prefersLargeTitles: Bool?)
 
   /// Replaces current navigation stack managed by `rootNavigationController` with the new one.
   ///
@@ -390,11 +401,13 @@ public enum NavigationTarget {
 }
 
 extension LinkNavigator {
-  public func launch(paths: [String], items: [String: String]) -> RootNavigator {
+
+  public func launch(paths: [String], items: [String: String], prefersLargeTitles: Bool = false) -> RootNavigator {
     let viewControllers = paths.compactMap { path in
       builders.first(where: { $0.matchPath == path })?.build(self, items, dependency)
     }
     rootNavigationController.setViewControllers(viewControllers, animated: false)
+    rootNavigationController.navigationBar.prefersLargeTitles = prefersLargeTitles
 
     return RootNavigator(viewController: rootNavigationController)
   }
@@ -443,13 +456,18 @@ extension LinkNavigator: LinkNavigatorType {
     rootNavigationController.present(subNavigationController, animated: isAnimated)
   }
 
-  public func fullSheet(paths: [String], items: [String: String], isAnimated: Bool) {
+  public func fullSheet(paths: [String], items: [String: String], isAnimated: Bool, prefersLargeTitles: Bool?) {
     rootNavigationController.dismiss(animated: true)
 
     subNavigationController.modalPresentationStyle = .fullScreen
     let new = paths.compactMap { path in
       builders.first(where: { $0.matchPath == path })?.build(self, items, dependency)
     }
+
+    if let prefersLargeTitles {
+      subNavigationController.navigationBar.prefersLargeTitles = prefersLargeTitles
+    }
+
     subNavigationController.setViewControllers(new, animated: false)
     rootNavigationController.present(subNavigationController, animated: isAnimated)
   }
@@ -459,7 +477,8 @@ extension LinkNavigator: LinkNavigatorType {
     items: [String: String],
     isAnimated: Bool,
     iPhonePresentationStyle: UIModalPresentationStyle,
-    iPadPresentationStyle: UIModalPresentationStyle)
+    iPadPresentationStyle: UIModalPresentationStyle,
+    prefersLargeTitles: Bool?)
   {
     rootNavigationController.dismiss(animated: true)
 
@@ -470,6 +489,11 @@ extension LinkNavigator: LinkNavigatorType {
     let new = paths.compactMap { path in
       builders.first(where: { $0.matchPath == path })?.build(self, items, dependency)
     }
+
+    if let prefersLargeTitles {
+      subNavigationController.navigationBar.prefersLargeTitles = prefersLargeTitles
+    }
+    
     subNavigationController.setViewControllers(new, animated: false)
     rootNavigationController.present(subNavigationController, animated: isAnimated)
   }