CMM-1289: Add Subscribers tab cards for new stats screen

WordPress/src/main/AndroidManifest.xml

@@ -127,6 +127,16 @@
             android:theme="@style/WordPress.NoActionBar"
             android:exported="false" />
 
+        <activity
+            android:name=".ui.newstats.subscribers.subscriberslist.SubscribersListDetailActivity"
+            android:theme="@style/WordPress.NoActionBar"
+            android:exported="false" />
+
+        <activity
+            android:name=".ui.newstats.subscribers.emails.EmailsDetailActivity"
+            android:theme="@style/WordPress.NoActionBar"
+            android:exported="false" />
+
         <!-- Account activities -->
         <activity
             android:name=".ui.main.MeActivity"

WordPress/src/main/java/org/wordpress/android/ui/newstats/NewStatsActivity.kt

@@ -95,6 +95,7 @@ import org.wordpress.android.ui.newstats.searchterms.SearchTermsViewModel
 import org.wordpress.android.ui.newstats.videoplays.VideoPlaysViewModel
 import org.wordpress.android.ui.newstats.viewsstats.ViewsStatsCard
 import org.wordpress.android.ui.newstats.viewsstats.ViewsStatsViewModel
+import org.wordpress.android.ui.newstats.subscribers.SubscribersTabContent
 import android.widget.Toast
 import org.wordpress.android.util.AppLog
 
@@ -164,39 +165,55 @@ private fun NewStatsScreen(
                     }
                 },
                 actions = {
-                    Box {
-                        Row(
-                            verticalAlignment = Alignment.CenterVertically,
-                            modifier = Modifier
-                                .clickable { showPeriodMenu = true }
-                                .padding(horizontal = 8.dp)
-                        ) {
-                            Text(
-                                text = selectedPeriod.getDisplayLabel(),
-                                style = MaterialTheme.typography.labelLarge,
-                                color = MaterialTheme.colorScheme.onSurface
-                            )
-                            Icon(
-                                imageVector = Icons.Default.DateRange,
-                                contentDescription = stringResource(
-                                    R.string.stats_period_selector_content_description
-                                ),
-                                modifier = Modifier.padding(start = 4.dp)
+                    val currentTab = tabs[pagerState.currentPage]
+                    if (currentTab != StatsTab.SUBSCRIBERS) {
+                        Box {
+                            Row(
+                                verticalAlignment =
+                                    Alignment.CenterVertically,
+                                modifier = Modifier
+                                    .clickable {
+                                        showPeriodMenu = true
+                                    }
+                                    .padding(horizontal = 8.dp)
+                            ) {
+                                Text(
+                                    text = selectedPeriod
+                                        .getDisplayLabel(),
+                                    style = MaterialTheme
+                                        .typography.labelLarge,
+                                    color = MaterialTheme
+                                        .colorScheme.onSurface
+                                )
+                                Icon(
+                                    imageVector =
+                                        Icons.Default.DateRange,
+                                    contentDescription =
+                                        stringResource(
+                                            R.string
+                                                .stats_period_selector_content_description
+                                        ),
+                                    modifier = Modifier
+                                        .padding(start = 4.dp)
+                                )
+                            }
+                            StatsPeriodMenu(
+                                expanded = showPeriodMenu,
+                                selectedPeriod = selectedPeriod,
+                                onDismiss = {
+                                    showPeriodMenu = false
+                                },
+                                onPresetSelected = { period ->
+                                    viewsStatsViewModel
+                                        .onPeriodChanged(period)
+                                    showPeriodMenu = false
+                                },
+                                onCustomSelected = {
+                                    showPeriodMenu = false
+                                    showDateRangePicker = true
+                                }
                             )
                         }
-                        StatsPeriodMenu(
-                            expanded = showPeriodMenu,
-                            selectedPeriod = selectedPeriod,
-                            onDismiss = { showPeriodMenu = false },
-                            onPresetSelected = { period ->
-                                viewsStatsViewModel.onPeriodChanged(period)
-                                showPeriodMenu = false
-                            },
-                            onCustomSelected = {
-                                showPeriodMenu = false
-                                showDateRangePicker = true
-                            }
-                        )
                     }
                 }
             )
@@ -245,6 +262,7 @@ private fun NewStatsScreen(
 private fun StatsTabContent(tab: StatsTab, viewsStatsViewModel: ViewsStatsViewModel) {
     when (tab) {
         StatsTab.TRAFFIC -> TrafficTabContent(viewsStatsViewModel = viewsStatsViewModel)
+        StatsTab.SUBSCRIBERS -> SubscribersTabContent()
         else -> PlaceholderTabContent(tab)
     }
 }

WordPress/src/main/java/org/wordpress/android/ui/newstats/datasource/StatsDataSource.kt

@@ -207,6 +207,48 @@ interface StatsDataSource {
         dateRange: StatsDateRange,
         max: Int = 10
     ): DevicesDataResult
+
+    /**
+     * Fetches subscriber count stats for a specific site.
+     *
+     * @param siteId The WordPress.com site ID
+     * @param quantity Number of data points to return
+     * @param unit Time unit: "day", "week", "month", "year"
+     * @param date Optional date in YYYY-MM-DD format
+     * @return Result containing subscriber count data
+     */
+    suspend fun fetchStatsSubscribers(
+        siteId: Long,
+        quantity: Int = 1,
+        unit: String? = null,
+        date: String? = null
+    ): StatsSubscribersDataResult
+
+    /**
+     * Fetches a list of subscribers by user type.
+     *
+     * @param siteId The WordPress.com site ID
+     * @param perPage Number of subscribers per page
+     * @param page Page number (1-based)
+     * @return Result containing subscriber items or an error
+     */
+    suspend fun fetchSubscribersByUserType(
+        siteId: Long,
+        perPage: Int = 10,
+        page: Int = 1
+    ): SubscribersByUserTypeDataResult
+
+    /**
+     * Fetches email stats summary for a specific site.
+     *
+     * @param siteId The WordPress.com site ID
+     * @param quantity Number of email items to return
+     * @return Result containing email summary items or an error
+     */
+    suspend fun fetchStatsEmailsSummary(
+        siteId: Long,
+        quantity: Int = 10
+    ): StatsEmailsSummaryDataResult
 }
 
 /**
@@ -529,3 +571,71 @@ sealed class DevicesDataResult {
  * (percentage for screen size, view count for browser/platform).
  */
 data class DevicesData(val items: Map<String, Double>)
+
+/**
+ * Result wrapper for stats subscribers fetch operation.
+ */
+sealed class StatsSubscribersDataResult {
+    data class Success(
+        val data: StatsSubscribersData
+    ) : StatsSubscribersDataResult()
+    data class Error(
+        val errorType: StatsErrorType
+    ) : StatsSubscribersDataResult()
+}
+
+/**
+ * Stats subscribers data from the API.
+ */
+data class StatsSubscribersData(
+    val subscribersData: List<SubscribersDataPoint>
+)
+
+/**
+ * A single data point for subscriber count at a date.
+ */
+data class SubscribersDataPoint(
+    val date: String,
+    val count: Long
+)
+
+/**
+ * Result wrapper for subscribers by user type fetch operation.
+ */
+sealed class SubscribersByUserTypeDataResult {
+    data class Success(
+        val items: List<SubscriberItem>
+    ) : SubscribersByUserTypeDataResult()
+    data class Error(
+        val errorType: StatsErrorType
+    ) : SubscribersByUserTypeDataResult()
+}
+
+/**
+ * A single subscriber item.
+ */
+data class SubscriberItem(
+    val displayName: String,
+    val subscribedSince: String
+)
+
+/**
+ * Result wrapper for stats emails summary fetch operation.
+ */
+sealed class StatsEmailsSummaryDataResult {
+    data class Success(
+        val items: List<EmailSummaryItem>
+    ) : StatsEmailsSummaryDataResult()
+    data class Error(
+        val errorType: StatsErrorType
+    ) : StatsEmailsSummaryDataResult()
+}
+
+/**
+ * A single email summary item.
+ */
+data class EmailSummaryItem(
+    val title: String,
+    val opens: Long,
+    val clicks: Long
+)