feat: Integrate Navigation3 and setup application routing

This commit introduces the Navigation3 library and configures the initial routing structure for the application. It also defines placeholder screens for the weather, location, and settings features.

- **Dependencies**:
    - Added `navigation3-runtime` and `navigation3-ui` (v1.0.1) to `libs.versions.toml`.
    - Included `feature-weather`, `feature-location`, `feature-settings`, and `core` projects in `app/build.gradle.kts`.
- **Navigation**:
    - `app/src/main/java/com/warbler/navigation/Destinations.kt`: Defined a sealed interface `Destinations` using `@Serializable` for `Home`, `Forecast`, `Location`, and `Settings`.
    - `app/src/main/java/com/warbler/navigation/ApplicationNavigation.kt`: Implemented `ApplicationNavigation` using `NavDisplay` and `entryProvider` to manage app routing.
- **UI Placeholders**:
    - Created basic `Composable` screen placeholders: `WeatherScreen`, `ForecastScreen`, `LocationScreen`, and `SettingsScreen` across respective feature modules.

Author: JoshLudahl

app/build.gradle.kts

@@ -139,6 +139,10 @@ tasks.named("preBuild") {
 
 dependencies {
     implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))
+    implementation(project(":feature-weather"))
+    implementation(project(":feature-location"))
+    implementation(project(":feature-settings"))
+    implementation(project(":core"))
 
     //  Android specific
     implementation(libs.appcompat)
@@ -150,6 +154,8 @@ dependencies {
     implementation(libs.viewpager2)
     implementation(libs.material3Compose)
     implementation(libs.material3View)
+    implementation(libs.navigation3.runtime)
+    implementation(libs.navigation3.ui)
 
     // Compose
     val composeBom = platform("androidx.compose:compose-bom:2025.09.01")

app/src/main/java/com/warbler/navigation/ApplicationNavigation.kt

@@ -0,0 +1,31 @@
+package com.warbler.navigation
+
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.navigation3.runtime.NavBackStack
+import androidx.navigation3.runtime.NavKey
+import androidx.navigation3.runtime.entryProvider
+import androidx.navigation3.runtime.rememberNavBackStack
+import androidx.navigation3.ui.NavDisplay
+import com.warbler.feature.location.ui.LocationScreen
+import com.warbler.feature.settings.ui.SettingsScreen
+import com.warbler.feature.weather.ui.ForecastScreen
+import com.warbler.feature.weather.ui.WeatherScreen
+
+@Composable
+fun ApplicationNavigation(
+    modifier: Modifier = Modifier,
+    backStack: NavBackStack<NavKey> = rememberNavBackStack(Destinations.Home),
+) {
+    NavDisplay(
+        backStack = backStack,
+        onBack = { backStack.removeLastOrNull() },
+        entryProvider =
+            entryProvider {
+                entry<Destinations.Home> { WeatherScreen() }
+                entry<Destinations.Forecast> { ForecastScreen() }
+                entry<Destinations.Location> { LocationScreen() }
+                entry<Destinations.Settings> { SettingsScreen() }
+            },
+    )
+}

app/src/main/java/com/warbler/navigation/Destinations.kt

@@ -0,0 +1,19 @@
+package com.warbler.navigation
+
+import androidx.navigation3.runtime.NavKey
+import kotlinx.serialization.Serializable
+
+@Serializable
+sealed interface Destinations : NavKey {
+    @Serializable
+    data object Forecast : Destinations
+
+    @Serializable
+    data object Home : Destinations
+
+    @Serializable
+    data object Location : Destinations
+
+    @Serializable
+    data object Settings : Destinations
+}

core-build/build/kotlin/compileKotlin/cacheable/last-build.bin

@@ -25,4 +25,4 @@ object ConnectionHandler {
         }
         return false
     }
-}
+}

core/src/main/java/com/warbler/core/network/ConnectionHandler.kt

@@ -0,0 +1,6 @@
+package com.warbler.feature.location.ui
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun LocationScreen() {}

feature-location/src/main/java/com/warbler/feature/location/ui/LocationScreen.kt

@@ -0,0 +1,6 @@
+package com.warbler.feature.settings.ui
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun SettingsScreen() {}

feature-settings/src/main/java/com/warbler/feature/settings/ui/SettingsScreen.kt

@@ -0,0 +1,6 @@
+package com.warbler.feature.weather.ui
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun ForecastScreen() {}

feature-weather/src/main/java/com/warbler/feature/weather/ui/ForecastScreen.kt

@@ -0,0 +1,6 @@
+package com.warbler.feature.weather.ui
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun WeatherScreen() {}

feature-weather/src/main/java/com/warbler/feature/weather/ui/WeatherScreen.kt

@@ -51,6 +51,8 @@ rules = "1.7.0"
 runner = "1.7.0"
 vicoCore = "2.0.0-alpha.6" # Leave for now, resource linking issue with updated version, requires investigation.
 viewpager2 = "1.1.0"
+navigation3Runtime = "1.0.1"
+navigation3Ui = "1.0.1"
 
 [libraries]
 accessibility-test-framework = { module = "com.google.android.apps.common.testing.accessibility.framework:accessibility-test-framework", version.ref = "accessibilityTestFramework" }
@@ -98,6 +100,9 @@ material-icons-core = { module = "androidx.compose.material:material-icons-core"
 material-icons-extended = { module = "androidx.compose.material:material-icons-extended" }
 material3View = { module = "com.google.android.material:material", version.ref = "material3" }
 material3Compose = { module = "androidx.compose.material3:material3" }
+
+
+
 navigation-dynamic-features-fragment = { module = "androidx.navigation:navigation-dynamic-features-fragment", version.ref = "navigationDynamicFeaturesFragment" }
 navigation-fragment-ktx = { module = "androidx.navigation:navigation-fragment-ktx", version.ref = "navigationFragmentKtx" }
 navigation-safe-args-gradle-plugin = { module = "androidx.navigation:navigation-safe-args-gradle-plugin", version.ref = "navigationSafeArgsGradlePlugin" }
@@ -123,6 +128,8 @@ ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview" }
 viewpager2 = { module = "androidx.viewpager2:viewpager2", version.ref = "viewpager2" }
 vico-core = { module = "com.patrykandpatrick.vico:core", version.ref = "vicoCore" }
 vico-views = { module = "com.patrykandpatrick.vico:views", version.ref = "vicoCore" }
+navigation3-runtime = { group = "androidx.navigation3", name = "navigation3-runtime", version.ref = "navigation3Runtime" }
+navigation3-ui = { group = "androidx.navigation3", name = "navigation3-ui", version.ref = "navigation3Ui" }
 
 [plugins]
 compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }