refactor: Create multiplatform ui:test module and move UI tests

- Introduce a new `ui:test` Gradle module for multiplatform Compose UI testing, supporting Android, iOS, JVM, and WasmJs.
- Move UI test cases, screen objects, and test utilities from `ui:test-jvm` to `ui:test/src/commonMain` to enable shared testing across all platforms.
- Make `ui:test-jvm` a JVM-specific utility module that depends on `ui:test` and provides a compatibility bridge (`AbstractJvmUiTests`) between JVM test rules (`ComposeContentTestRule`) and the multiplatform `ComposeUiTest` API.
- Replace the now-deleted `TestLifecycleOwner` and `runOnUiThread` utilities from `ui:test-jvm` with official `androidx.lifecycle:lifecycle-runtime-testing` dependency and new `expect/actual` implementations for `runOnUiThread` in `ui:test`.
- Update Android and Desktop test app modules to depend on the new `ui:test` module.
- Refactor test case classes and screen objects to use the multiplatform `ComposeUiTest` API instead of the JVM-specific `ComposeContentTestRule`.
- Update documentation and build scripts to reflect the new `ui:test` module structure and testing strategy.

Author: softartdev

AGENTS.md

@@ -9,7 +9,7 @@
 
 ### Project Structure & Module Organization
 - Core: `core/domain`, `core/presentation`, `core/data/db-sqldelight` (default), `core/data/db-room` (optional), `core/test`.
-- UI: `ui/shared` (common Compose code and resources), `ui/test-jvm` (JVM Compose UI test utilities).
+- UI: `ui/shared` (common Compose code and resources), `ui/test` (multiplatform Compose UI tests), `ui/test-jvm` (JVM-specific UI test utilities).
 - Apps: `app/android`, `app/desktop`, `app/web`, `app/ios-kit` (CocoaPods framework), `app/iosApp` (Xcode project).
 - Tooling: `build-logic` (Gradle conventions), `thirdparty` (vendored modules), `gradle/libs.versions.toml` (versions).
 - Switch DB module via `gradle.properties` key `CORE_DATA_DB_MODULE`.

app/android/build.gradle.kts

@@ -96,6 +96,7 @@ dependencies {
     coreLibraryDesugaring(libs.desugar)
     testImplementation(libs.junit)
     testImplementation(libs.bundles.mockito)
+    androidTestImplementation(projects.ui.test)
     androidTestImplementation(projects.ui.testJvm) {
         exclude(group = "org.jetbrains.runtime", module = "jbr-api")
     }

app/android/src/androidTest/java/com/softartdev/notedelight/ui/AndroidUiTests.kt

@@ -14,7 +14,7 @@ import org.junit.runner.RunWith
 
 @LargeTest
 @RunWith(AndroidJUnit4::class)
-class AndroidUiTests : AbstractUiTests() {
+class AndroidUiTests : AbstractJvmUiTests() {
 
     override val composeTestRule = createAndroidComposeRule<MainActivity>()
 

app/android/src/androidTest/java/com/softartdev/notedelight/ui/SignInTest.kt

@@ -1,10 +1,15 @@
+@file:OptIn(ExperimentalTestApi::class)
+
 package com.softartdev.notedelight.ui
 
+import androidx.compose.ui.test.ComposeUiTest
+import androidx.compose.ui.test.ExperimentalTestApi
 import androidx.test.espresso.Espresso
 import androidx.test.ext.junit.runners.AndroidJUnit4
 import androidx.test.filters.FlakyTest
 import com.softartdev.notedelight.DbTestEncryptor
 import com.softartdev.notedelight.MainActivity
+import com.softartdev.notedelight.reflect
 import com.softartdev.notedelight.ui.cases.SignInTestCase
 import leakcanary.DetectLeaksAfterTestSuccess
 import leakcanary.TestDescriptionHolder
@@ -26,6 +31,8 @@ class SignInTest {
         .around(DetectLeaksAfterTestSuccess())
         .around(composeTestRule)
 
+    private val composeUiTest: ComposeUiTest = reflect(composeTestRule)
+
     @Test
-    fun signInTest() = SignInTestCase(composeTestRule, Espresso::closeSoftKeyboard).invoke()
+    fun signInTest() = SignInTestCase(composeUiTest, Espresso::closeSoftKeyboard).invoke()
 }

app/android/src/androidTest/java/com/softartdev/notedelight/ui/SignInToSettingsTest.kt

@@ -1,10 +1,15 @@
+@file:OptIn(ExperimentalTestApi::class)
+
 package com.softartdev.notedelight.ui
 
+import androidx.compose.ui.test.ComposeUiTest
+import androidx.compose.ui.test.ExperimentalTestApi
 import androidx.test.espresso.Espresso
 import androidx.test.ext.junit.runners.AndroidJUnit4
 import androidx.test.filters.FlakyTest
 import com.softartdev.notedelight.DbTestEncryptor
 import com.softartdev.notedelight.MainActivity
+import com.softartdev.notedelight.reflect
 import com.softartdev.notedelight.ui.cases.SignInToSettingsTestCase
 import leakcanary.DetectLeaksAfterTestSuccess
 import leakcanary.TestDescriptionHolder
@@ -26,7 +31,9 @@ class SignInToSettingsTest {
         .around(DetectLeaksAfterTestSuccess())
         .around(composeTestRule)
 
+    private val composeUiTest: ComposeUiTest = reflect(composeTestRule)
+
     @Test
-    fun signInToSettingsTest() = SignInToSettingsTestCase(composeTestRule, Espresso::closeSoftKeyboard).invoke()
+    fun signInToSettingsTest() = SignInToSettingsTestCase(composeUiTest, Espresso::closeSoftKeyboard).invoke()
 }
 

app/desktop/build.gradle.kts

@@ -35,12 +35,14 @@ kotlin {
             implementation(libs.kermit)
         }
         jvmTest.dependencies {
+            implementation(projects.ui.test)
             implementation(projects.ui.testJvm)
             implementation(kotlin("test"))
             implementation(compose.desktop.uiTestJUnit4)
             implementation(compose.desktop.currentOs)
             implementation(libs.koin.compose)
             implementation(libs.kotlinx.datetime)
+            implementation(libs.androidx.lifecycle.runtime.testing)
         }
     }
 }

app/desktop/src/jvmTest/kotlin/com/softartdev/notedelight/ui/DesktopUiTests.kt

@@ -13,10 +13,10 @@ import androidx.compose.ui.test.onNodeWithContentDescription
 import androidx.compose.ui.test.performClick
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.compose.LocalLifecycleOwner
+import androidx.lifecycle.testing.TestLifecycleOwner
 import co.touchlab.kermit.Logger
 import co.touchlab.kermit.platformLogWriter
 import com.softartdev.notedelight.App
-import com.softartdev.notedelight.TestLifecycleOwner
 import com.softartdev.notedelight.db.NoteDAO
 import com.softartdev.notedelight.di.sharedModules
 import com.softartdev.notedelight.di.uiTestModules
@@ -36,7 +36,7 @@ import org.koin.core.context.unloadKoinModules
 import org.koin.java.KoinJavaComponent.get
 import java.io.File
 
-class DesktopUiTests : AbstractUiTests() {
+class DesktopUiTests : AbstractJvmUiTests() {
 
     @get:Rule
     override val composeTestRule: ComposeContentTestRule = createComposeRule()

app/desktop/src/jvmTest/kotlin/com/softartdev/notedelight/ui/ScreenshootPreviewTest.kt

@@ -9,10 +9,10 @@ import androidx.compose.ui.test.junit4.createComposeRule
 import androidx.compose.ui.test.onRoot
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.compose.LocalLifecycleOwner
+import androidx.lifecycle.testing.TestLifecycleOwner
 import co.touchlab.kermit.Logger
 import co.touchlab.kermit.platformLogWriter
 import com.softartdev.notedelight.App
-import com.softartdev.notedelight.TestLifecycleOwner
 import com.softartdev.notedelight.db.NoteDAO
 import com.softartdev.notedelight.di.sharedModules
 import com.softartdev.notedelight.di.uiTestModules

docs/AI_AGENT_GUIDE.md

@@ -52,6 +52,7 @@ Level 3 (Depends on presentation/data):
 └── core:test
 
 Level 4 (Integration):
+├── ui:test
 ├── ui:test-jvm
 └── app:ios-kit
 
@@ -509,7 +510,8 @@ Let Kotlin's type system guide you:
 ### Read Tests
 Tests often show how to use code correctly. Look at:
 - `core/presentation/src/androidUnitTest/` for ViewModel examples
-- `ui/test-jvm/src/main/kotlin/ui/cases/` for UI test examples
+- `ui/test/src/commonMain/kotlin/ui/cases/` for multiplatform UI test examples
+- `ui/test-jvm/src/main/kotlin/` for JVM-specific test utilities
 
 ## Getting Unstuck
 

docs/README.md

@@ -25,7 +25,8 @@ Each module has its own detailed README.md:
 
 #### UI Modules
 - **[ui/shared/README.md](../ui/shared/README.md)** - Shared Compose UI
-- **[ui/test-jvm/README.md](../ui/test-jvm/README.md)** - UI testing framework (Kaspresso-inspired)
+- **[ui/test/README.md](../ui/test/README.md)** - Multiplatform Compose UI tests
+- **[ui/test-jvm/README.md](../ui/test-jvm/README.md)** - JVM-specific UI test utilities (Kaspresso-inspired)
 
 #### App Modules
 - **[app/android/README.md](../app/android/README.md)** - Android application
@@ -68,7 +69,8 @@ NoteDelight/
 │   └── test/           # Shared test utilities
 ├── ui/                 # User interface
 │   ├── shared/         # 100% shared Compose UI
-│   └── test-jvm/       # UI testing framework
+│   ├── test/           # Multiplatform Compose UI tests
+│   └── test-jvm/       # JVM-specific UI test utilities
 ├── app/                # Platform-specific applications
 │   ├── android/        # Android app
 │   ├── desktop/        # Desktop app