Adds news highlights carousel

Introduces a carousel view for displaying featured news at the top of the news feed.

This enhances the user experience by prominently showcasing important stories, and supports landscape and iPad layouts. It also introduces the ability to handle horizontal swipes with a UIKit view representable.

Author: rfcbf

MacMagazine/Features/NewsLibrary/Sources/NewsLibrary/Extensions/DateExtensions.swift

@@ -0,0 +1,134 @@
+import Foundation
+
+// MARK: - Date Extensions for Feed
+
+public extension Date {
+
+    // MARK: - Custom Format
+
+    /// Format date with custom format string
+    func formatted(as format: String) -> String {
+        let formatter = DateFormatter()
+        formatter.dateFormat = format
+        formatter.locale = Locale(identifier: "pt_BR")
+        return formatter.string(from: self)
+    }
+
+    // MARK: - Relative Formatting
+
+    /// Returns a human-readable relative time string
+    var relativeTimeString: String {
+        let formatter = RelativeDateTimeFormatter()
+        formatter.unitsStyle = .abbreviated
+        formatter.locale = Locale(identifier: "pt_BR")
+        return formatter.localizedString(for: self, relativeTo: Date())
+    }
+
+    /// Returns a formatted date string for feed display
+    var feedDisplayString: String {
+        let calendar = Calendar.current
+        let now = Date()
+
+        if calendar.isDateInToday(self) {
+            return "Hoje, \(formatted(date: .omitted, time: .shortened))"
+        } else if calendar.isDateInYesterday(self) {
+            return "Ontem, \(formatted(date: .omitted, time: .shortened))"
+        } else if let daysAgo = calendar.dateComponents([.day], from: self, to: now).day, daysAgo < 7 {
+            return relativeTimeString
+        } else {
+            return formatted(date: .abbreviated, time: .omitted)
+        }
+    }
+
+    // MARK: - Time Ago String
+
+    /// Returns a detailed time ago string
+    var timeAgoString: String {
+        let calendar = Calendar.current
+        let now = Date()
+        let components = calendar.dateComponents([.minute, .hour, .day, .weekOfYear, .month, .year], from: self, to: now)
+
+        if let years = components.year, years > 0 {
+            return years == 1 ? "há 1 ano" : "há \(years) anos"
+        }
+        if let months = components.month, months > 0 {
+            return months == 1 ? "há 1 mês" : "há \(months) meses"
+        }
+        if let weeks = components.weekOfYear, weeks > 0 {
+            return weeks == 1 ? "há 1 semana" : "há \(weeks) semanas"
+        }
+        if let days = components.day, days > 0 {
+            return days == 1 ? "há 1 dia" : "há \(days) dias"
+        }
+        if let hours = components.hour, hours > 0 {
+            return hours == 1 ? "há 1 hora" : "há \(hours) horas"
+        }
+        if let minutes = components.minute, minutes > 0 {
+            return minutes == 1 ? "há 1 minuto" : "há \(minutes) minutos"
+        }
+
+        return "agora"
+    }
+
+    // MARK: - Accessibility String
+
+    /// Returns a detailed accessibility-friendly date string
+    var accessibilityDateString: String {
+        let formatter = DateFormatter()
+        formatter.dateStyle = .full
+        formatter.timeStyle = .short
+        formatter.locale = Locale(identifier: "pt_BR")
+        return formatter.string(from: self)
+    }
+
+    /// Hoje às HH:mm / Ontem às HH:mm / dd/MM/yyyy às HH:mm
+    var feedDateTimeDisplay: String {
+        let calendar = Calendar.current
+
+        if calendar.isDateInToday(self) {
+            return "Hoje às \(Self.feedTimeFormatter.string(from: self))"
+        }
+
+        if calendar.isDateInYesterday(self) {
+            return "Ontem às \(Self.feedTimeFormatter.string(from: self))"
+        }
+
+        return Self.feedDateTimeFormatter.string(from: self)
+    }
+
+    // MARK: - Private formatters (cache)
+
+    private static let feedTimeFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.locale = Locale(identifier: "pt_BR")
+        formatter.dateFormat = "HH:mm"
+        return formatter
+    }()
+
+    private static let feedDateTimeFormatter: DateFormatter = {
+        let formatter = DateFormatter()
+        formatter.locale = Locale(identifier: "pt_BR")
+        formatter.dateFormat = "dd/MM/yyyy 'às' HH:mm"
+        return formatter
+    }()
+}
+
+// MARK: - Preview Helper
+
+#if DEBUG
+extension Date {
+    static var mockDates: [Date] {
+        let now = Date()
+        return [
+            now,
+            now.addingTimeInterval(-60 * 5),           // 5 minutes ago
+            now.addingTimeInterval(-60 * 60),          // 1 hour ago
+            now.addingTimeInterval(-60 * 60 * 5),      // 5 hours ago
+            now.addingTimeInterval(-60 * 60 * 24),     // 1 day ago
+            now.addingTimeInterval(-60 * 60 * 24 * 3), // 3 days ago
+            now.addingTimeInterval(-60 * 60 * 24 * 7), // 1 week ago
+            now.addingTimeInterval(-60 * 60 * 24 * 30) // 1 month ago
+        ]
+    }
+}
+#endif

MacMagazine/Features/NewsLibrary/Sources/NewsLibrary/Views/Components/CollectionViewWithHeader.swift

@@ -0,0 +1,151 @@
+// TODO: Migrate to the CollectionView component located in Libraries
+import SwiftUI
+import UIComponentsLibrary
+
+// MARK: - Collection View With Header
+
+/// CollectionView with optional header support
+/// Header appears above the grid and scrolls with the content
+public struct CollectionViewWithHeader<Header: View, Content: View>: View {
+
+    // MARK: - Properties
+
+    @State private var cardWidth = CGFloat.zero
+    @Binding var scrollPosition: ScrollPosition
+
+    private let title: String
+    private let status: APIStatus
+    private let usesDensity: Bool
+    private var favorite: Bool
+    private var isSearching: Bool
+    private var quantity: Int
+    private var density: CardDensity { .density(using: cardWidth) }
+
+    private let header: (() -> Header)?
+    private let retryAction: (() -> Void)?
+    private let content: () -> Content
+
+    private let grid = GridItem(
+        .adaptive(minimum: 280),
+        spacing: 20,
+        alignment: .top
+    )
+
+    // MARK: - Initialization
+
+    public init(
+        title: String,
+        status: APIStatus,
+        usesDensity: Bool = true,
+        scrollPosition: Binding<ScrollPosition>,
+        favorite: Bool = false,
+        isSearching: Bool = false,
+        quantity: Int = 0,
+        @ViewBuilder header: @escaping () -> Header,
+        @ViewBuilder content: @escaping () -> Content,
+        retryAction: (() -> Void)? = nil
+    ) {
+        self.title = title
+        self.status = status
+        self.usesDensity = usesDensity
+        self.favorite = favorite
+        self.isSearching = isSearching
+        self.quantity = quantity
+        self.header = header
+        self.content = content
+        self.retryAction = retryAction
+
+        _scrollPosition = scrollPosition
+    }
+
+    // MARK: - Body
+
+    public var body: some View {
+        VStack {
+            LoadingAndErrorView(
+                title: title,
+                status: status,
+                favorite: favorite,
+                isSearching: isSearching,
+                quantity: quantity,
+                retryAction: retryAction
+            )
+
+            ScrollView {
+                VStack(spacing: 20) {
+                    // Header (full width, outside grid)
+                    if let header {
+                        header()
+                    }
+
+                    // Grid content
+                    LazyVGrid(
+                        columns: Array(repeating: grid, count: usesDensity ? density.columns : 1),
+                        spacing: 20
+                    ) {
+                        content()
+                    }
+                    .padding(.horizontal)
+                }
+            }
+            .scrollPosition($scrollPosition)
+        }
+        .cardSize { value in
+            cardWidth = value
+        }
+    }
+}
+
+// MARK: - Convenience Init (No Header)
+
+extension CollectionViewWithHeader where Header == EmptyView {
+    public init(
+        title: String,
+        status: APIStatus,
+        usesDensity: Bool = true,
+        scrollPosition: Binding<ScrollPosition>,
+        favorite: Bool = false,
+        isSearching: Bool = false,
+        quantity: Int = 0,
+        @ViewBuilder content: @escaping () -> Content,
+        retryAction: (() -> Void)? = nil
+    ) {
+        self.title = title
+        self.status = status
+        self.usesDensity = usesDensity
+        self.favorite = favorite
+        self.isSearching = isSearching
+        self.quantity = quantity
+        self.header = nil
+        self.content = content
+        self.retryAction = retryAction
+
+        _scrollPosition = scrollPosition
+    }
+}
+
+// MARK: - Preview
+
+#if DEBUG
+#Preview {
+    CollectionViewWithHeader(
+        title: "Notícias",
+        status: .done,
+        scrollPosition: .constant(ScrollPosition()),
+        header: {
+            RoundedRectangle(cornerRadius: 16)
+                .fill(Color.blue.opacity(0.3))
+                .frame(height: 200)
+                .overlay(Text("Header"))
+        },
+        content: {
+            ForEach(0..<10, id: \.self) { index in
+                RoundedRectangle(cornerRadius: 12)
+                    .fill(Color.gray.opacity(0.3))
+                    .frame(height: 150)
+                    .overlay(Text("Card \(index)"))
+            }
+        }
+    )
+}
+#endif