CLAUDE.md

1# Search Feature
2 
3Repo search with platform / language / sort filters. Paginated results.
4 
5## Structure
6 
7```
8feature/search/
9├── domain/   # SearchRepository; SearchPlatform (All/Android/Macos/Windows/Linux), ProgrammingLanguage, SortBy
10├── data/     # SearchRepositoryImpl + dto + mappers + di
11└── presentation/
12    ├── SearchViewModel / State / Action / Event / Root
13    └── components/  filter chips, ClipboardLinkBanner, etc.
14```
15 
16## Key interface
17 
18```kotlin
19interface SearchRepository {
20    fun searchRepositories(
21        query: String,
22        platform: DiscoveryPlatform,
23        language: ProgrammingLanguage,
24        sortBy: SortBy,
25        sortOrder: SortOrder,
26        page: Int,
27        source: SearchSource = SearchSource.GitHub,
28    ): Flow<PaginatedDiscoveryRepositories>
29 
30    suspend fun exploreFromGithub(query, platform, page): ExploreResult
31}
32 
33sealed interface SearchSource { object GitHub; data class Forgejo(host); /* Codeberg = Forgejo("codeberg.org") */ }
34```
35 
36## Navigation
37 
38`GithubStoreGraph.SearchScreen`.
39 
40## Notes
41 
42- Platform filter → GitHub topic search (e.g. `android` topic). Language filter → `language:` qualifier. Debounce/throttle on queries.
43- **Source toggle (`SearchSourceUi`):** UI surfaces `GitHub`, `Codeberg`, and per-user-added `Custom(host)` chips (from `TweaksRepository.customForgeHosts`). `state.selectedSource` → repository's `source: SearchSource` param. Forgejo branch in `SearchRepositoryImpl` hits `ForgejoClientRegistry.clientFor(host)` (`/repos/search`) — no backend mediator.
44- Injects: `SearchRepository`, `InstalledAppsRepository`, `SyncInstalledAppsUseCase`, `FavouritesRepository`, `StarredRepository`, `SeenReposRepository`, `HiddenReposRepository`, `TweaksRepository`, `ProfileRepository`, `TelemetryRepository`, `SearchHistoryRepository`, `ShareManager`, `ClipboardHelper`, `Platform`, `GitHubStoreLogger`. Data layer additionally injects `ForgejoClientRegistry`.
45- `computeVisibleRepos` filters `state.repositories` at render time by `hiddenRepoIds` AND (when `isHideSeenEnabled`) `seenRepoIds`. Unhide restores without re-fetch.
46- Empty-grid-after-Hide-seen banner offers one-tap reset (issue #574) → `OnDisableHideSeenForResults`.
47- Long-press card → shared `RepositoryActionsBottomSheet`.
48- `DiscoveryRepositoryUi.isCurrentUserOwner` flipped by `observeCurrentUser` (E20).
49- Clipboard auto-detect surfaces GitHub URLs from clipboard as a dismissible banner.
50