97 lines
3.1 KiB
Swift
97 lines
3.1 KiB
Swift
import Foundation
|
|
import SwiftUI
|
|
|
|
/// Categorizes todo tasks into groups based on their due dates and completion status.
|
|
///
|
|
/// This enumeration provides a semantic grouping mechanism for organizing and filtering todo tasks throughout the application.
|
|
/// Each case represents a distinct category that helps users manage their tasks based on temporal relevance and completion state.
|
|
enum TodoGroup {
|
|
/// Tasks that have been marked as done, regardless of due date.
|
|
case completed
|
|
/// Tasks with due dates in the past that remain incomplete.
|
|
case overdue
|
|
/// Tasks due on the current day that are not yet completed.
|
|
case today
|
|
/// Tasks due in the future that are not yet completed.
|
|
case upcoming
|
|
}
|
|
|
|
// MARK: - Computed
|
|
|
|
extension TodoGroup {
|
|
|
|
/// Indicates whether this group supports toggling the visibility of completed tasks.
|
|
///
|
|
/// This property determines if a show/hide completed tasks action should be available for the group.
|
|
var canShowCompleted: Bool {
|
|
self != .completed
|
|
}
|
|
|
|
/// Indicates whether tasks in this group can be reordered through drag and drop.
|
|
///
|
|
/// This property determines if the user should be able to manually reorder tasks within the group.
|
|
/// Reordering is useful for temporal groups where users may want to prioritize certain tasks,
|
|
/// but is disabled for completed tasks since they are typically sorted by completion date.
|
|
var canReorder: Bool {
|
|
self != .completed
|
|
}
|
|
|
|
/// The color associated with the task group.
|
|
var color: Color {
|
|
switch self {
|
|
case .completed: .gray
|
|
case .overdue: .red
|
|
case .today: .blue
|
|
case .upcoming: .green
|
|
}
|
|
}
|
|
|
|
/// The system icon name for the task group.
|
|
var iconName: String {
|
|
switch self {
|
|
case .completed: "checkmark.circle.fill"
|
|
case .overdue: "calendar.badge.exclamationmark"
|
|
case .today: "calendar.badge.clock"
|
|
case .upcoming: "calendar"
|
|
}
|
|
}
|
|
|
|
/// The localized display title for the task group.
|
|
var title: LocalizedStringKey {
|
|
switch self {
|
|
case .completed: "enumeration.todo-group.title.completed"
|
|
case .overdue: "enumeration.todo-group.title.overdue"
|
|
case .today: "enumeration.todo-group.title.today"
|
|
case .upcoming: "enumeration.todo-group.title.upcoming"
|
|
|
|
}
|
|
}
|
|
|
|
}
|
|
|
|
// MARK: - CaseIterable
|
|
|
|
extension TodoGroup: CaseIterable {
|
|
|
|
/// All todo group cases in their display order.
|
|
///
|
|
/// The cases are ordered by priority and temporal relevance:
|
|
/// 1. `.today` - Most immediate tasks
|
|
/// 2. `.upcoming` - Future tasks
|
|
/// 3. `.overdue` - Past due tasks requiring attention
|
|
/// 4. `.completed` - Finished tasks
|
|
static var allCases: [TodoGroup] { [.today, .upcoming, .overdue, .completed] }
|
|
|
|
}
|
|
|
|
// MARK: - Identifiable
|
|
|
|
extension TodoGroup: Identifiable {
|
|
|
|
/// The unique identifier for the group.
|
|
///
|
|
/// Uses the case itself as the identifier, enabling use in SwiftUI's `ForEach` and other collection views.
|
|
var id: Self { self }
|
|
|
|
}
|