feat(home): Auto-scroll to top on category switch

This commit introduces an automatic scroll-to-top feature on the home screen. When the user switches between categories (e.g., from "Trending" to "Hot Release"), the repository list now automatically scrolls to the beginning.

- **feat(home)**: Implemented an event-based system (`HomeEvent`) to trigger UI actions from the `HomeViewModel`.
- **feat(home)**: The list now scrolls to the top (`animateScrollToItem(0)`) after a new category's data is loaded.
- **refactor(home)**: Modified the `loadRepos` function in `HomeViewModel` to return a `Job`, allowing the caller to wait for its completion before triggering subsequent actions like scrolling.
- **refactor(home)**: Added a `trendingScore` property to the `GithubRepoSummary` domain model and the `CachedGithubRepoSummary` DTO, and updated the corresponding mapper.

Author: rainxchzed

core/domain/src/commonMain/kotlin/zed/rainxch/core/domain/model/GithubRepoSummary.kt

@@ -16,5 +16,6 @@ data class GithubRepoSummary(
     val language: String?,
     val topics: List<String>?,
     val releasesUrl: String,
-    val updatedAt: String
+    val updatedAt: String,
+    val trendingScore: Double? = null
 )

feature/home/data/src/commonMain/kotlin/zed/rainxch/home/data/dto/CachedGithubRepoSummary.kt

@@ -16,5 +16,11 @@ data class CachedGithubRepoSummary(
     val language: String?,
     val topics: List<String>?,
     val releasesUrl: String,
-    val updatedAt: String
+    val updatedAt: String,
+    val createdAt: String? = null,
+    val latestReleaseDate: String? = null,
+    val releaseRecency: Int? = null,
+    val releaseRecencyText: String? = null,
+    val trendingScore: Double? = null,
+    val popularityScore: Int? = null
 )

feature/home/data/src/commonMain/kotlin/zed/rainxch/home/data/dto/CachedRepoResponse.kt

@@ -4,6 +4,7 @@ import kotlinx.serialization.Serializable
 
 @Serializable
 data class CachedRepoResponse(
+    val category: String? = null,
     val platform: String,
     val lastUpdated: String,
     val totalCount: Int,

feature/home/data/src/commonMain/kotlin/zed/rainxch/home/data/mappers/CachedGithubRepoSummaryMappers.kt

@@ -4,7 +4,6 @@ import zed.rainxch.core.domain.model.GithubRepoSummary
 import zed.rainxch.core.domain.model.GithubUser
 import zed.rainxch.home.data.dto.CachedGithubRepoSummary
 
-
 fun CachedGithubRepoSummary.toGithubRepoSummary(): GithubRepoSummary {
     return GithubRepoSummary(
         id = id,
@@ -24,6 +23,7 @@ fun CachedGithubRepoSummary.toGithubRepoSummary(): GithubRepoSummary {
         language = language,
         topics = topics,
         releasesUrl = releasesUrl,
-        updatedAt = updatedAt
+        updatedAt = latestReleaseDate ?: updatedAt,
+        trendingScore = trendingScore
     )
 }

feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeEvent.kt

@@ -0,0 +1,5 @@
+package zed.rainxch.home.presentation
+
+sealed interface HomeEvent {
+    data object OnScrollToListTop : HomeEvent
+}

feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeRoot.kt

@@ -34,6 +34,7 @@ import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.runtime.derivedStateOf
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.remember
+import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.runtime.rememberUpdatedState
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
@@ -48,6 +49,7 @@ import zed.rainxch.githubstore.core.presentation.res.*
 import io.github.fletchmckee.liquid.LiquidState
 import io.github.fletchmckee.liquid.liquefiable
 import io.github.fletchmckee.liquid.rememberLiquidState
+import kotlinx.coroutines.launch
 import org.jetbrains.compose.resources.painterResource
 import org.jetbrains.compose.resources.stringResource
 import org.jetbrains.compose.ui.tooling.preview.Preview
@@ -57,7 +59,7 @@ import zed.rainxch.core.presentation.components.GithubStoreButton
 import zed.rainxch.core.presentation.components.RepositoryCard
 import zed.rainxch.core.presentation.locals.LocalBottomNavigationLiquid
 import zed.rainxch.core.presentation.theme.GithubStoreTheme
-import zed.rainxch.githubstore.core.presentation.res.*
+import zed.rainxch.core.presentation.utils.ObserveAsEvents
 import zed.rainxch.home.presentation.components.HomeFilterChips
 import zed.rainxch.home.domain.model.HomeCategory
 
@@ -71,6 +73,18 @@ fun HomeRoot(
     viewModel: HomeViewModel = koinViewModel()
 ) {
     val state by viewModel.state.collectAsStateWithLifecycle()
+    val listState = rememberLazyStaggeredGridState()
+    val scope = rememberCoroutineScope()
+
+    ObserveAsEvents(viewModel.events) { event ->
+        when (event) {
+            HomeEvent.OnScrollToListTop -> {
+                scope.launch {
+                    listState.animateScrollToItem(0)
+                }
+            }
+        }
+    }
 
     HomeScreen(
         state = state,
@@ -100,7 +114,8 @@ fun HomeRoot(
                     viewModel.onAction(action)
                 }
             }
-        }
+        },
+        listState = listState
     )
 }
 
@@ -109,8 +124,8 @@ fun HomeRoot(
 fun HomeScreen(
     state: HomeState,
     onAction: (HomeAction) -> Unit,
+    listState: LazyStaggeredGridState,
 ) {
-    val listState = rememberLazyStaggeredGridState()
     val liquidState = LocalBottomNavigationLiquid.current
 
     val shouldLoadMore by remember {
@@ -371,7 +386,8 @@ private fun Preview() {
         ) {
             HomeScreen(
                 state = HomeState(),
-                onAction = {}
+                onAction = {},
+                listState = rememberLazyStaggeredGridState()
             )
         }
     }

feature/home/presentation/src/commonMain/kotlin/zed/rainxch/home/presentation/HomeViewModel.kt

@@ -4,10 +4,12 @@ import androidx.lifecycle.ViewModel
 import androidx.lifecycle.viewModelScope
 import kotlinx.coroutines.CancellationException
 import kotlinx.coroutines.Job
+import kotlinx.coroutines.channels.Channel
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.SharingStarted
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.onStart
+import kotlinx.coroutines.flow.receiveAsFlow
 import kotlinx.coroutines.flow.stateIn
 import kotlinx.coroutines.flow.update
 import kotlinx.coroutines.launch
@@ -58,6 +60,9 @@ class HomeViewModel(
             initialValue = HomeState()
         )
 
+    private val _events = Channel<HomeEvent>()
+    val events = _events.receiveAsFlow()
+
     private fun syncSystemState() {
         viewModelScope.launch {
             try {
@@ -97,10 +102,10 @@ class HomeViewModel(
         }
     }
 
-    private fun loadRepos(isInitial: Boolean = false, category: HomeCategory? = null) {
+    private fun loadRepos(isInitial: Boolean = false, category: HomeCategory? = null): Job? {
         if (_state.value.isLoading || _state.value.isLoadingMore) {
             logger.debug("Already loading, skipping...")
-            return
+            return null
         }
 
         currentJob?.cancel()
@@ -113,8 +118,7 @@ class HomeViewModel(
 
         logger.debug("Loading repos: category=$targetCategory, page=$nextPageIndex, isInitial=$isInitial")
 
-        currentJob = viewModelScope.launch {
-
+        return viewModelScope.launch {
             _state.update {
                 it.copy(
                     isLoading = isInitial,
@@ -128,7 +132,10 @@ class HomeViewModel(
             try {
                 val flow = when (targetCategory) {
                     HomeCategory.TRENDING -> homeRepository.getTrendingRepositories(nextPageIndex)
-                    HomeCategory.HOT_RELEASE -> homeRepository.getHotReleaseRepositories(nextPageIndex)
+                    HomeCategory.HOT_RELEASE -> homeRepository.getHotReleaseRepositories(
+                        nextPageIndex
+                    )
+
                     HomeCategory.MOST_POPULAR -> homeRepository.getMostPopular(nextPageIndex)
                 }
 
@@ -201,6 +208,8 @@ class HomeViewModel(
                     )
                 }
             }
+        }.also {
+            currentJob = it
         }
     }
 
@@ -230,7 +239,11 @@ class HomeViewModel(
             is HomeAction.SwitchCategory -> {
                 if (_state.value.currentCategory != action.category) {
                     nextPageIndex = 1
-                    loadRepos(isInitial = true, category = action.category)
+                    viewModelScope.launch {
+                        loadRepos(isInitial = true, category = action.category)?.join()
+
+                        _events.send(HomeEvent.OnScrollToListTop)
+                    }
                 }
             }