build: Replace custom BackHandler with NavigationBackHandler

- Add `androidx-navigationevent-compose` version `1.0.1` to `libs.versions.toml`.
- Add `androidx.navigationevent:navigationevent-compose` dependency to `ui:shared`.
- Replace the platform-specific `BackHandler` expect/actual implementation with a common `NavBackHandler` using `NavigationBackHandler` from the `navigationevent` library.
- Remove redundant `BackHandler` implementations in `androidMain`, `iosMain`, `jvmMain`, and `wasmJsMain`.
- Update `AdaptiveMainScreen`, `SettingsDetailScreen`, `NoteDetail`, and `SettingsMasterScreen` to use the new `NavBackHandler`.

Author: softartdev

gradle/libs.versions.toml

@@ -26,6 +26,7 @@ composeMaterialAdaptive = "1.2.0"
 androidxAppcompat = "1.7.1"
 androidxViewModel = "2.9.6"
 androidxNavigation = "2.9.2"
+androidxNavigationEvent = "1.0.1"
 androidxActivityCompose = "1.12.4"
 androidxComposeTest = "1.10.4"
 androidxCoreSplashscreen = "1.2.0"
@@ -120,6 +121,7 @@ compose-adaptive-navigation = { module = "org.jetbrains.compose.material3.adapti
 
 androidx-appcompat = { module = "androidx.appcompat:appcompat", version.ref = "androidxAppcompat" }
 androidx-navigation-compose = { module = "org.jetbrains.androidx.navigation:navigation-compose", version.ref = "androidxNavigation" }
+androidx-navigationevent-compose = { module = "org.jetbrains.androidx.navigationevent:navigationevent-compose", version.ref = "androidxNavigationEvent" }
 androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "androidxActivityCompose" }
 androidx-compose-test-junit4 = { module = "androidx.compose.ui:ui-test-junit4-android", version.ref = "androidxComposeTest" }
 androidx-compose-test-manifest = { module = "androidx.compose.ui:ui-test-manifest", version.ref = "androidxComposeTest" }

ui/shared/build.gradle.kts

@@ -60,6 +60,7 @@ kotlin {
             implementation(libs.koin.core)
             implementation(libs.koin.compose.viewmodel.navigation)
             implementation(libs.androidx.navigation.compose)
+            implementation(libs.androidx.navigationevent.compose)
             implementation(libs.androidx.lifecycle.runtime.compose)
             implementation(libs.material.theme.prefs)
             implementation(libs.androidx.paging.compose)

ui/shared/src/androidMain/kotlin/com/softartdev/notedelight/ui/Composables.android.kt

@@ -26,7 +26,3 @@ actual fun EnableEdgeToEdge() {
     }
     activity.enableEdgeToEdge(statusBarStyle = sbStyle, navigationBarStyle = sbStyle)
 }
-
-@Composable
-actual fun BackHandler(enabled: Boolean, onBack: () -> Unit) =
-    androidx.activity.compose.BackHandler(enabled, onBack)

ui/shared/src/commonMain/kotlin/com/softartdev/notedelight/ui/Composables.kt

@@ -36,6 +36,9 @@ import androidx.compose.ui.text.TextStyle
 import androidx.compose.ui.text.font.FontWeight
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
+import androidx.navigationevent.NavigationEventInfo
+import androidx.navigationevent.compose.NavigationBackHandler
+import androidx.navigationevent.compose.rememberNavigationEventState
 import com.softartdev.notedelight.util.EMPTY_RESULT_LABEL_TAG
 import notedelight.ui.shared.generated.resources.Res
 import notedelight.ui.shared.generated.resources.detail_pane_placeholder
@@ -48,7 +51,11 @@ import org.jetbrains.compose.resources.stringResource
 expect fun EnableEdgeToEdge()
 
 @Composable
-expect fun BackHandler(enabled: Boolean = true, onBack: () -> Unit)
+fun NavBackHandler(enabled: Boolean = true, onBack: () -> Unit) = NavigationBackHandler(
+    state = rememberNavigationEventState(NavigationEventInfo.None),
+    isBackEnabled = enabled,
+    onBackCompleted = onBack,
+)
 
 @Composable
 fun MainDetailPanePlaceholder() = Card(shape = RoundedCornerShape(size = 0.dp)) {

ui/shared/src/commonMain/kotlin/com/softartdev/notedelight/ui/main/AdaptiveMainScreen.kt

@@ -21,7 +21,7 @@ import com.softartdev.notedelight.di.PreviewKoin
 import com.softartdev.notedelight.navigation.Router
 import com.softartdev.notedelight.presentation.main.MainViewModel
 import com.softartdev.notedelight.presentation.note.NoteViewModel
-import com.softartdev.notedelight.ui.BackHandler
+import com.softartdev.notedelight.ui.NavBackHandler
 import com.softartdev.notedelight.ui.VerticalPaneExpansionDragHandle
 import com.softartdev.theme.material3.PreferableMaterialTheme
 import kotlinx.coroutines.launch
@@ -53,7 +53,7 @@ fun AdaptiveMainScreen(
         },
         paneExpansionState = paneExpansionState
     )
-    BackHandler(navigator.canNavigateBack()) { coroutineScope.launch { navigator.navigateBack() } }
+    NavBackHandler(navigator.canNavigateBack()) { coroutineScope.launch { navigator.navigateBack() } }
 }
 
 @Preview

ui/shared/src/commonMain/kotlin/com/softartdev/notedelight/ui/main/NoteDetail.kt

@@ -38,7 +38,7 @@ import androidx.compose.ui.unit.dp
 import com.softartdev.notedelight.presentation.note.NoteAction
 import com.softartdev.notedelight.presentation.note.NoteResult
 import com.softartdev.notedelight.presentation.note.NoteViewModel
-import com.softartdev.notedelight.ui.BackHandler
+import com.softartdev.notedelight.ui.NavBackHandler
 import com.softartdev.notedelight.ui.MainDetailPanePlaceholder
 import com.softartdev.notedelight.util.DELETE_NOTE_BUTTON_TAG
 import com.softartdev.notedelight.util.EDIT_TITLE_BUTTON_TAG
@@ -96,7 +96,7 @@ fun NoteDetail(
         textState = textState,
         onAction = onAction
     )
-    BackHandler { onAction(NoteAction.CheckSaveChange(textState.text)) }
+    NavBackHandler { onAction(NoteAction.CheckSaveChange(textState.text)) }
 }
 
 @Composable

ui/shared/src/commonMain/kotlin/com/softartdev/notedelight/ui/settings/detail/SettingsDetailScreen.kt

@@ -60,7 +60,7 @@ import com.softartdev.notedelight.presentation.settings.SettingsAction
 import com.softartdev.notedelight.presentation.settings.SettingsResult
 import com.softartdev.notedelight.presentation.settings.SettingsViewModel
 import com.softartdev.notedelight.repository.SafeRepo
-import com.softartdev.notedelight.ui.BackHandler
+import com.softartdev.notedelight.ui.NavBackHandler
 import com.softartdev.notedelight.ui.SettingsDetailPanePlaceholder
 import com.softartdev.notedelight.ui.icon.FileLock
 import com.softartdev.notedelight.util.ENABLE_ENCRYPTION_SWITCH_TAG
@@ -111,7 +111,7 @@ fun SettingsDetailScreen(settingsViewModel: SettingsViewModel) {
                 onRefresh = { settingsViewModel.onAction(SettingsAction.Refresh) },
                 refreshState = refreshState,
             )
-            BackHandler { settingsViewModel.onAction(SettingsAction.NavBack) }
+            NavBackHandler { settingsViewModel.onAction(SettingsAction.NavBack) }
         }
     }
 }

ui/shared/src/commonMain/kotlin/com/softartdev/notedelight/ui/settings/master/SettingsMasterScreen.kt

@@ -34,7 +34,7 @@ import com.softartdev.notedelight.presentation.settings.SettingsCategoriesAction
 import com.softartdev.notedelight.presentation.settings.SettingsCategoriesResult
 import com.softartdev.notedelight.presentation.settings.SettingsCategoriesViewModel
 import com.softartdev.notedelight.model.SettingsCategory
-import com.softartdev.notedelight.ui.BackHandler
+import com.softartdev.notedelight.ui.NavBackHandler
 import com.softartdev.notedelight.ui.selectedListItemColor
 import com.softartdev.notedelight.util.icon
 import com.softartdev.notedelight.util.tag
@@ -63,7 +63,7 @@ fun SettingsMasterScreen(categoriesViewModel: SettingsCategoriesViewModel) {
         refreshState = refreshState,
         onNavigateBack = { categoriesViewModel.onAction(SettingsCategoriesAction.NavBack) }
     )
-    BackHandler(enabled = result.selectedCategoryId == null) {
+    NavBackHandler(enabled = result.selectedCategoryId == null) {
         categoriesViewModel.onAction(SettingsCategoriesAction.NavBack)
     }
 }

ui/shared/src/iosMain/kotlin/com/softartdev/notedelight/ui/Composables.ios.kt

@@ -4,6 +4,3 @@ import androidx.compose.runtime.Composable
 
 @Composable
 actual fun EnableEdgeToEdge() {}
-
-@Composable
-actual fun BackHandler(enabled: Boolean, onBack: () -> Unit) {}

ui/shared/src/jvmMain/kotlin/com/softartdev/notedelight/ui/Composables.jvm.kt

@@ -4,6 +4,3 @@ import androidx.compose.runtime.Composable
 
 @Composable
 actual fun EnableEdgeToEdge() {}
-
-@Composable
-actual fun BackHandler(enabled: Boolean, onBack: () -> Unit) {}