Tweak the RouteDecisionHandler API to return the Router.Decision after matching and handling

[jayohms]

This coincides with work in the iOS library in hotwired/hotwire-native-ios#105. To handle more complex scenarios, we need more flexibility to return the route decision after running logic in the handle() method.

An implemented RouteDecisionHandler will now look like:

class BrowserRouteDecisionHandler : Router.RouteDecisionHandler {
    override val name = "browser"

    override fun matches(
        location: String,
        configuration: NavigatorConfiguration
    ): Boolean {
        return configuration.startLocation.toUri().host != location.toUri().host
    }

    override fun handle(
        location: String,
        configuration: NavigatorConfiguration,
        activity: HotwireActivity
    ): Router.Decision {
        val intent = Intent(Intent.ACTION_VIEW, location.toUri())

        try {
            activity.startActivity(intent)
        } catch (e: ActivityNotFoundException) {
            logError("BrowserRouteDecisionHandler", e)
        }

        // New: Decision return value
        return Router.Decision.CANCEL
    }
}

[svara]

Looks great!