Router

Publication: medium.com/@vyacheslavansimov/swiftui-and-mvi-3acac8d4416a

How to use Router?

Implementation Router

Below is the most complete version, if you don't need something, you don't have to write it.

Step 1: Create a enum for the list of screens the View will open to. It should implement the RouterScreenProtocol protocol.

 enum SomeRouterScreenType: RouterScreenProtocol {

     case productScreen(id: UUID)
 }

Step 2: Create a enum for the list of alerts that the View will display. It should implement the RouterAlertScreenProtocol protocol.

enum SomeRouterAlertType: RouterAlertScreenProtocol {

    case error(title: String, message: String)
}

Step 3: We need to implement RouterModifierProtocol is ViewModifier in your router.

struct SomeRouter: RouterModifierProtocol {

    // If you don't need Alerts, you can use `RouterDefaultAlert`. Example: RouterEvents<SomeRouterScreenType, RouterDefaultAlert>
    // If you do not need to go to other screens, then use `RouterEmptyScreen`. Example: RouterEvents<RouterEmptyScreen, SomeRouterAlertType>
    let routerEvents: RouterEvents<SomeRouteScreenType, SomeRouterAlertType>
}

Step 4: Implement the functions getScreenPresentationType(for:), getScreen(for:), onScreenDismiss(type:) in your router

extension SomeRouter {

    // Optional
    func getScreenPresentationType(for type: SomeRouterScreenType) -> RouterScreenPresentationType {
        .fullScreenCover
    }

    // Optional
    @ViewBuilder
    func getScreen(for type: SomeRouterScreenType) -> some View {
        switch type {
        case let .productScreen(id):
            Text("Product Screen View: \(id.uuidString)")
        }
    }

   // Optional
    func onScreenDismiss(type: SomeRouterScreenType) {}
}

Step 5: Implement the functions getAlertTitle(for:), getAlertMessage(for:), getAlertActions(for:) in your router

extension SomeRouter {

    // Optional
    func getAlertTitle(for type: SomeRouterAlertType) -> Text? {
        switch type {
        case let .error(title, _):
            Text(title)
        }
    }

    // Optional
    @ViewBuilder
    func geteAlertMessage(for type: SomeRouterAlertType) -> some View {
        switch type {
        case let .error(_, message):
            Text(message)
        }
    }

    // Optional
    @ViewBuilder
    func getAlertActions(for type: SomeRouterAlertType) -> some View {
        Button("Yes", role: .none, action: {
            ...
        })
        Button("Cancel", role: .cancel, action: {})
    }
}

Use Router

How do I use the router? You can see this in the following example:

struct SomeView: View {

    let routerEvents = RouterEvents<SomeRouterScreenType, SomeRouterAlertType>()

    var body: some View {
        Text("Hello, World!")
            .modifier(SomeRouter(routerEvents: routerEvents))
            .onAppear {
                routerEvents.routeTo(.group(id: UUID()))
            }
    }
}