feat(ui): implement repository sharing functionality

This commit introduces a sharing feature to repository cards, allowing users to share repository links directly from the home and search screens. It also integrates snackbar notifications to provide feedback on sharing actions.

- **feat(ui)**: Added a share button to `RepositoryCard` with a new `onShareClick` callback.
- **feat(home)**: Integrated `ShareManager` into `HomeViewModel` and added `OnShareClick` action to handle repository link generation and sharing.
- **feat(search)**: Integrated `ShareManager` into `SearchViewModel` and added `OnShareClick` action to handle repository link generation and sharing.
- **feat(presentation)**: Added `SnackbarHost` to `HomeScreen` and `SearchScreen` to display success/error messages during sharing.
- **feat(presentation)**: Introduced `SearchEvent` and updated `HomeEvent` to include `OnMessage` for triggering snackbar notifications from ViewModels.
- **refactor(ui)**: Adjusted `SnackbarHost` positioning in `Scaffold` to account for bottom navigation height.
- **fix(presentation)**: Improved sharing logic to provide a "link copied" message on non-Android platforms when a link is shared.

Author: rainxchzed

core/presentation/src/commonMain/kotlin/zed/rainxch/core/presentation/components/RepositoryCard.kt

@@ -20,10 +20,9 @@ import androidx.compose.material.icons.automirrored.outlined.CallSplit
 import androidx.compose.material.icons.filled.CheckCircle
 import androidx.compose.material.icons.filled.Favorite
 import androidx.compose.material.icons.filled.OpenInBrowser
+import androidx.compose.material.icons.filled.Share
 import androidx.compose.material.icons.filled.Star
 import androidx.compose.material.icons.filled.Update
-import androidx.compose.material3.Card
-import androidx.compose.material3.CardDefaults
 import androidx.compose.material3.ExperimentalMaterial3ExpressiveApi
 import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
@@ -48,22 +47,19 @@ import zed.rainxch.core.presentation.model.DiscoveryRepository
 import zed.rainxch.core.presentation.theme.GithubStoreTheme
 import zed.rainxch.core.presentation.utils.formatReleasedAt
 import zed.rainxch.core.presentation.utils.hasWeekNotPassed
-import zed.rainxch.githubstore.core.presentation.res.Res
-import zed.rainxch.githubstore.core.presentation.res.forked_repository
-import zed.rainxch.githubstore.core.presentation.res.home_view_details
-import zed.rainxch.githubstore.core.presentation.res.installed
-import zed.rainxch.githubstore.core.presentation.res.open_in_browser
-import zed.rainxch.githubstore.core.presentation.res.update_available
+import zed.rainxch.githubstore.core.presentation.res.*
 
 @OptIn(ExperimentalMaterial3ExpressiveApi::class, ExperimentalLayoutApi::class)
 @Composable
 fun RepositoryCard(
     discoveryRepository: DiscoveryRepository,
     onClick: () -> Unit,
+    onShareClick: () -> Unit,
     onDeveloperClick: (String) -> Unit,
     modifier: Modifier = Modifier
 ) {
     val uriHandler = LocalUriHandler.current
+
     ExpressiveCard(
         onClick = onClick,
         modifier = modifier
@@ -263,6 +259,20 @@ fun RepositoryCard(
                         modifier = Modifier.weight(1f)
                     )
 
+                    IconButton(
+                        onClick = onShareClick,
+                        colors = IconButtonDefaults.iconButtonColors(
+                            containerColor = MaterialTheme.colorScheme.primaryContainer,
+                            contentColor = MaterialTheme.colorScheme.onPrimaryContainer
+                        ),
+                        shapes = IconButtonDefaults.shapes(),
+                    ) {
+                        Icon(
+                            imageVector = Icons.Default.Share,
+                            contentDescription = stringResource(Res.string.share_repository),
+                        )
+                    }
+
                     IconButton(
                         onClick = {
                             uriHandler.openUri(discoveryRepository.repository.htmlUrl)
@@ -421,6 +431,7 @@ fun RepositoryCardPreview() {
                 isStarred = false
             ),
             onClick = { },
+            onShareClick = { },
             onDeveloperClick = { }
         )
     }

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

@@ -10,6 +10,7 @@ sealed interface HomeAction {
     data object OnSearchClick : HomeAction
     data object OnSettingsClick : HomeAction
     data object OnAppsClick : HomeAction
+    data class OnShareClick (val repo: GithubRepoSummary) : HomeAction
     data class SwitchCategory(val category: HomeCategory) : HomeAction
     data class OnRepositoryClick(val repo: GithubRepoSummary) : HomeAction
     data class OnRepositoryDeveloperClick(val username: String) : HomeAction

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

@@ -2,4 +2,5 @@ package zed.rainxch.home.presentation
 
 sealed interface HomeEvent {
     data object OnScrollToListTop : HomeEvent
+    data class OnMessage(val message: String) : HomeEvent
 }

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

@@ -26,6 +26,8 @@ import androidx.compose.material3.ExperimentalMaterial3Api
 import androidx.compose.material3.ExperimentalMaterial3ExpressiveApi
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.Scaffold
+import androidx.compose.material3.SnackbarHost
+import androidx.compose.material3.SnackbarHostState
 import androidx.compose.material3.Text
 import androidx.compose.material3.TopAppBar
 import androidx.compose.runtime.Composable
@@ -58,6 +60,7 @@ import org.koin.compose.viewmodel.koinViewModel
 import zed.rainxch.core.domain.model.GithubRepoSummary
 import zed.rainxch.core.presentation.components.GithubStoreButton
 import zed.rainxch.core.presentation.components.RepositoryCard
+import zed.rainxch.core.presentation.locals.LocalBottomNavigationHeight
 import zed.rainxch.core.presentation.locals.LocalBottomNavigationLiquid
 import zed.rainxch.core.presentation.theme.GithubStoreTheme
 import zed.rainxch.core.presentation.utils.ObserveAsEvents
@@ -77,6 +80,7 @@ fun HomeRoot(
     val state by viewModel.state.collectAsStateWithLifecycle()
     val listState = rememberLazyStaggeredGridState()
     val scope = rememberCoroutineScope()
+    val snackbarHost = remember { SnackbarHostState() }
 
     ObserveAsEvents(viewModel.events) { event ->
         when (event) {
@@ -85,11 +89,18 @@ fun HomeRoot(
                     listState.animateScrollToItem(0)
                 }
             }
+
+            is HomeEvent.OnMessage -> {
+                scope.launch {
+                    snackbarHost.showSnackbar(event.message)
+                }
+            }
         }
     }
 
     HomeScreen(
         state = state,
+        snackbarHost = snackbarHost,
         onAction = { action ->
             when (action) {
                 HomeAction.OnSearchClick -> {
@@ -125,10 +136,12 @@ fun HomeRoot(
 @Composable
 fun HomeScreen(
     state: HomeState,
+    snackbarHost: SnackbarHostState,
     onAction: (HomeAction) -> Unit,
     listState: LazyStaggeredGridState,
 ) {
     val liquidState = LocalBottomNavigationLiquid.current
+    val bottomNavHeight = LocalBottomNavigationHeight.current
 
     val shouldLoadMore by remember {
         derivedStateOf {
@@ -162,6 +175,12 @@ fun HomeScreen(
             topBar = {
                 TopAppBar()
             },
+            snackbarHost = {
+                SnackbarHost(
+                    hostState = snackbarHost,
+                    modifier = Modifier.padding(bottom = bottomNavHeight + 16.dp)
+                )
+            },
             containerColor = MaterialTheme.colorScheme.background
         ) { innerPadding ->
             Column(
@@ -213,15 +232,18 @@ private fun MainState(
                 items = state.repos,
                 key = { it.repository.id },
                 contentType = { "repo" }
-            ) { homeRepo ->
+            ) { discoveryRepository ->
                 RepositoryCard(
-                    discoveryRepository = homeRepo,
+                    discoveryRepository = discoveryRepository,
                     onClick = {
-                        onAction(HomeAction.OnRepositoryClick(homeRepo.repository))
+                        onAction(HomeAction.OnRepositoryClick(discoveryRepository.repository))
                     },
                     onDeveloperClick = { username ->
                         onAction(HomeAction.OnRepositoryDeveloperClick(username))
                     },
+                    onShareClick = {
+                        onAction(HomeAction.OnShareClick(discoveryRepository.repository))
+                    },
                     modifier = Modifier
                         .animateItem()
                         .liquefiable(bottomNavLiquidState)
@@ -389,7 +411,8 @@ private fun Preview() {
             HomeScreen(
                 state = HomeState(),
                 onAction = {},
-                listState = rememberLazyStaggeredGridState()
+                snackbarHost = SnackbarHostState(),
+                listState = rememberLazyStaggeredGridState(),
             )
         }
     }

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

@@ -20,6 +20,7 @@ import zed.rainxch.core.domain.repository.FavouritesRepository
 import zed.rainxch.core.domain.repository.InstalledAppsRepository
 import zed.rainxch.core.domain.repository.StarredRepository
 import zed.rainxch.core.domain.use_cases.SyncInstalledAppsUseCase
+import zed.rainxch.core.domain.utils.ShareManager
 import zed.rainxch.core.presentation.model.DiscoveryRepository
 import zed.rainxch.githubstore.core.presentation.res.*
 import zed.rainxch.home.domain.repository.HomeRepository
@@ -32,7 +33,8 @@ class HomeViewModel(
     private val syncInstalledAppsUseCase: SyncInstalledAppsUseCase,
     private val favouritesRepository: FavouritesRepository,
     private val starredRepository: StarredRepository,
-    private val logger: GitHubStoreLogger
+    private val logger: GitHubStoreLogger,
+    private val shareManager: ShareManager
 ) : ViewModel() {
 
     private var hasLoadedInitialData = false
@@ -251,6 +253,24 @@ class HomeViewModel(
                 }
             }
 
+            is HomeAction.OnShareClick -> {
+                viewModelScope.launch {
+                    runCatching {
+                        shareManager.shareText("https://github-store.org/app?repo=${action.repo.fullName}")
+                    }.onFailure { t ->
+                        logger.error("Failed to share link: ${t.message}")
+                        _events.send(
+                            HomeEvent.OnMessage(getString(Res.string.failed_to_share_link))
+                        )
+                        return@launch
+                    }
+
+                    if (platform != Platform.ANDROID) {
+                        _events.send(HomeEvent.OnMessage(getString(Res.string.link_copied_to_clipboard)))
+                    }
+                }
+            }
+
             is HomeAction.OnRepositoryClick -> {
                 /* Handled in composable */
             }

feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchAction.kt

@@ -12,6 +12,7 @@ sealed interface SearchAction {
     data class OnSortBySelected(val sortBy: SortBy) : SearchAction
     data class OnRepositoryClick(val repository: GithubRepoSummary) : SearchAction
     data class OnRepositoryDeveloperClick(val username: String) : SearchAction
+    data class OnShareClick (val repo: GithubRepoSummary) : SearchAction
     data object OnSearchImeClick : SearchAction
     data object OnNavigateBackClick : SearchAction
     data object LoadMore : SearchAction

feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchEvent.kt

@@ -0,0 +1,5 @@
+package zed.rainxch.search.presentation
+
+sealed interface SearchEvent {
+    data class OnMessage(val message: String) : SearchEvent
+}

feature/search/presentation/src/commonMain/kotlin/zed/rainxch/search/presentation/SearchRoot.kt

@@ -36,6 +36,8 @@ import androidx.compose.material3.Icon
 import androidx.compose.material3.IconButton
 import androidx.compose.material3.MaterialTheme
 import androidx.compose.material3.Scaffold
+import androidx.compose.material3.SnackbarHost
+import androidx.compose.material3.SnackbarHostState
 import androidx.compose.material3.Text
 import androidx.compose.material3.TextField
 import androidx.compose.material3.TextFieldDefaults
@@ -44,6 +46,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
@@ -61,12 +64,15 @@ import io.github.fletchmckee.liquid.liquefiable
 import kotlinx.coroutines.delay
 import org.jetbrains.compose.resources.stringResource
 import androidx.compose.ui.tooling.preview.Preview
+import kotlinx.coroutines.launch
 import org.koin.compose.viewmodel.koinViewModel
 import zed.rainxch.core.domain.model.GithubRepoSummary
 import zed.rainxch.core.presentation.components.GithubStoreButton
 import zed.rainxch.core.presentation.components.RepositoryCard
+import zed.rainxch.core.presentation.locals.LocalBottomNavigationHeight
 import zed.rainxch.core.presentation.locals.LocalBottomNavigationLiquid
 import zed.rainxch.core.presentation.theme.GithubStoreTheme
+import zed.rainxch.core.presentation.utils.ObserveAsEvents
 import zed.rainxch.domain.model.ProgrammingLanguage
 import zed.rainxch.domain.model.SearchPlatform
 import zed.rainxch.githubstore.core.presentation.res.Res
@@ -86,6 +92,18 @@ fun SearchRoot(
     viewModel: SearchViewModel = koinViewModel()
 ) {
     val state by viewModel.state.collectAsStateWithLifecycle()
+    val scope = rememberCoroutineScope()
+    val snackbarHost = remember { SnackbarHostState() }
+
+    ObserveAsEvents(viewModel.events) { event ->
+        when (event) {
+            is SearchEvent.OnMessage -> {
+                scope.launch {
+                    snackbarHost.showSnackbar(event.message)
+                }
+            }
+        }
+    }
 
     if (state.isLanguageSheetVisible) {
         LanguageFilterBottomSheet(
@@ -101,6 +119,7 @@ fun SearchRoot(
 
     SearchScreen(
         state = state,
+        snackbarHost = snackbarHost,
         onAction = { action ->
             when (action) {
                 is SearchAction.OnRepositoryClick -> {
@@ -127,11 +146,13 @@ fun SearchRoot(
 @Composable
 fun SearchScreen(
     state: SearchState,
+    snackbarHost: SnackbarHostState,
     onAction: (SearchAction) -> Unit,
 ) {
     val focusRequester = remember { FocusRequester() }
     val listState = rememberLazyStaggeredGridState()
     val liquidState = LocalBottomNavigationLiquid.current
+    val bottomNavHeight = LocalBottomNavigationHeight.current
 
     val shouldLoadMore by remember {
         derivedStateOf {
@@ -142,7 +163,8 @@ fun SearchScreen(
             if (totalItems == 0 ||
                 state.isLoadingMore ||
                 state.isLoading ||
-                !state.hasMorePages) {
+                !state.hasMorePages
+            ) {
                 return@derivedStateOf false
             }
 
@@ -176,7 +198,8 @@ fun SearchScreen(
             layoutInfo.totalItemsCount > 0 &&
             !state.isLoadingMore &&
             !state.isLoading &&
-            state.hasMorePages) {
+            state.hasMorePages
+        ) {
 
             val hasEmptySpace = lastVisible.index == layoutInfo.totalItemsCount - 1 &&
                     lastVisible.offset.y + lastVisible.size.height < layoutInfo.viewportEndOffset
@@ -202,6 +225,12 @@ fun SearchScreen(
                 focusRequester = focusRequester
             )
         },
+        snackbarHost = {
+            SnackbarHost(
+                hostState = snackbarHost,
+                modifier = Modifier.padding(bottom = bottomNavHeight + 16.dp)
+            )
+        },
         containerColor = MaterialTheme.colorScheme.background,
         modifier = Modifier.liquefiable(liquidState)
     ) { innerPadding ->
@@ -358,6 +387,9 @@ fun SearchScreen(
                                 onDeveloperClick = { username ->
                                     onAction(SearchAction.OnRepositoryDeveloperClick(username))
                                 },
+                                onShareClick = {
+                                    onAction(SearchAction.OnShareClick(discoveryRepository.repository))
+                                },
                                 modifier = Modifier
                                     .animateItem()
                                     .liquefiable(liquidState)
@@ -467,7 +499,8 @@ private fun Preview() {
     GithubStoreTheme {
         SearchScreen(
             state = SearchState(),
-            onAction = {}
+            snackbarHost = SnackbarHostState(),
+            onAction = {},
         )
     }
 }