Coverage Summary for Class: SurferRecentTransactionsWidgetKt (com.georgeci.moneysurfer.uikit.widgets)

 package com.georgeci.moneysurfer.uikit.widgets
 
 import androidx.compose.foundation.clickable
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.Row
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
 import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.compositeOver
 import androidx.compose.ui.graphics.vector.ImageVector
 import androidx.compose.ui.platform.testTag
 import androidx.compose.ui.tooling.preview.Preview
 import androidx.compose.ui.unit.dp
 import com.georgeci.moneysurfer.uikit.components.transaction.SurferTransactionLine
 import com.georgeci.moneysurfer.uikit.icons.SurferIcons
 import com.georgeci.moneysurfer.uikit.preview.SurferComponentPreview
 import com.georgeci.moneysurfer.uikit.theme.AppTheme
 
 /** Opacity of the income amount pill's tint wash. */
 private const val INCOME_PILL_WASH_ALPHA = 0.14f
 
 /**
  * Rows a compact card shows. The widget is handed the same list either way — the dashboard has no
  * idea which size the user picked for it — so the trimming has to happen here.
  */
 private const val COMPACT_ROWS = 3
 
 data class SurferRecentTransactionItem(
     val id: String,
     val title: String,
     val subtitle: String,
     val amount: String,
     val isExpense: Boolean,
     val iconBgColor: Color,
     val iconFgColor: Color,
     val iconInitial: String,
     val icon: ImageVector? = null,
     val categoryHueSeed: String? = null,
     val categoryDotColor: Color? = null,
 )
 
 /**
  * Recent-transactions widget for the dashboard column.
  *
  * [seeAllTestTag] and [emptyTestTag] tag the "see all" link and the empty-state block so a UI
  * test can drive them without matching localized copy; the host screen owns the tag values.
  */
 @Composable
 fun SurferRecentTransactionsWidget(
     items: List<SurferRecentTransactionItem>,
     title: String,
     seeAllLabel: String,
     onSeeAllClick: () -> Unit,
     modifier: Modifier = Modifier,
     size: SurferWidgetSize = LocalSurferWidgetSize.current,
     onItemClick: ((SurferRecentTransactionItem) -> Unit)? = null,
     emptyIcon: ImageVector = SurferIcons.Receipt,
     emptyTitle: String? = null,
     emptySubtitle: String? = null,
     seeAllTestTag: String? = null,
     emptyTestTag: String? = null,
 ) {
     val hero = size == SurferWidgetSize.Expanded
     val visibleItems = if (hero) items else items.take(COMPACT_ROWS)
     val incomeColor = AppTheme.semanticColors.income
 
     // The income amount is `incomeColor` text on a wash of the same colour, so leaving the
     // wash translucent would make its contrast depend on whatever the widget is dropped onto.
     // Compositing over `surface` fixes the pair at a known ≥4.5:1 in both themes.
     val incomePillBackground = incomeColor
         .copy(alpha = INCOME_PILL_WASH_ALPHA)
         .compositeOver(AppTheme.materialColors.surface)
 
     Column(
         modifier = modifier,
     ) {
         Row(
             modifier = Modifier
                 .fillMaxWidth()
                 .padding(top = 4.dp, bottom = 8.dp),
             verticalAlignment = Alignment.CenterVertically,
         ) {
             Text(
                 text = title,
                 style = AppTheme.typography.titleMedium,
                 color = AppTheme.materialColors.onSurface,
                 modifier = Modifier.weight(1f),
             )
             Text(
                 text = seeAllLabel,
                 style = AppTheme.typography.labelMedium,
                 color = AppTheme.materialColors.primary,
                 modifier = Modifier
                     .clickable(onClick = onSeeAllClick)
                     .then(seeAllTestTag?.let { Modifier.testTag(it) } ?: Modifier),
             )
         }
         if (items.isEmpty()) {
             SurferWidgetEmptyState(
                 icon = emptyIcon,
                 title = emptyTitle,
                 subtitle = emptySubtitle,
                 modifier = emptyTestTag?.let { Modifier.testTag(it) } ?: Modifier,
                 contentPadding = 0.dp,
             )
         } else {
             Column(
                 verticalArrangement = Arrangement.spacedBy(if (hero) 12.dp else 8.dp),
             ) {
                 visibleItems.forEach { transaction ->
                     SurferTransactionLine(
                         icon = transaction.icon ?: SurferIcons.Receipt,
                         title = transaction.title,
                         formattedAmount = transaction.amount,
                         categoryHueSeed = transaction.categoryHueSeed,
                         meta = transaction.subtitle.takeIf { it.isNotEmpty() },
                         metaDotColor = if (transaction.categoryHueSeed.isNullOrBlank()) {
                             transaction.categoryDotColor
                         } else {
                             null
                         },
                         iconTint = transaction.iconFgColor,
                         iconBackground = transaction.iconBgColor,
                         amountColor = if (transaction.isExpense) {
                             AppTheme.materialColors.onSurface
                         } else {
                             incomeColor
                         },
                         amountPillBackground = if (transaction.isExpense) {
                             null
                         } else {
                             incomePillBackground
                         },
                         onClick = onItemClick?.let { handler -> { handler(transaction) } },
                     )
                 }
             }
         }
     }
 }
 
 @Preview
 @Composable
 private fun SurferRecentTransactionsHeroPreview() {
     SurferComponentPreview {
         Box(modifier = Modifier.padding(16.dp)) {
             SurferRecentTransactionsWidget(
                 items = listOf(
                     SurferRecentTransactionItem(
                         id = "1",
                         title = "Lidl — weekly shop",
                         subtitle = "Groceries · Everyday · Today, 18:42",
                         amount = "−€48.20",
                         isExpense = true,
                         iconBgColor = Color(0xFFE4F4EB),
                         iconFgColor = Color(0xFF1F6A47),
                         iconInitial = "G",
                         categoryDotColor = Color(0xFF2F9970),
                     ),
                     SurferRecentTransactionItem(
                         id = "3",
                         title = "March payroll",
                         subtitle = "Salary · Emergency Fund · Yesterday",
                         amount = "+€3,200.00",
                         isExpense = false,
                         iconBgColor = Color(0xFFE4F4EB),
                         iconFgColor = Color(0xFF1F6A47),
                         iconInitial = "S",
                         categoryDotColor = Color(0xFF2F9970),
                     ),
                 ),
                 title = "Recent",
                 seeAllLabel = "See all",
                 onSeeAllClick = {},
                 modifier = Modifier
                     .fillMaxWidth()
                     .height(260.dp),
             )
         }
     }
 }
 
 @Preview
 @Composable
 private fun SurferRecentTransactionsEmptyPreview() {
     SurferComponentPreview {
         Box(modifier = Modifier.padding(16.dp)) {
             SurferRecentTransactionsWidget(
                 items = emptyList(),
                 title = "Recent",
                 seeAllLabel = "See all",
                 onSeeAllClick = {},
                 emptyTitle = "No activity yet",
                 emptySubtitle = "Transactions you log will show up here.",
                 modifier = Modifier
                     .fillMaxWidth()
                     .height(220.dp),
             )
         }
     }
 }