Repository Public
1import Foundation23/// One cell of a calendar grid.4public struct CalendarDay: Identifiable, Hashable, Sendable {5 public var date: Date // start of the day in the calendar's time zone6 public var inDisplayedMonth: Bool7 public var isToday: Bool8 public var id: Date { date }9}1011/// Date arithmetic for the maintenance calendar (month grid, week, overlap, agenda). Pure and testable.12public enum CalendarMath {13 public static func calendar(language: AppLanguage = Localization.shared.language, timeZone: TimeZone = .current) -> Calendar {14 var c = Calendar(identifier: .gregorian)15 c.locale = language.locale16 c.timeZone = timeZone17 c.firstWeekday = language == .fr ? 2 : 1 // Monday in French Canada's work calendars, Sunday in English18 return c19 }2021 public static func startOfMonth(_ date: Date, calendar: Calendar) -> Date {22 calendar.date(from: calendar.dateComponents([.year, .month], from: date)) ?? date23 }2425 public static func startOfWeek(_ date: Date, calendar: Calendar) -> Date {26 let day = calendar.startOfDay(for: date)27 let weekday = calendar.component(.weekday, from: day)28 let offset = (weekday - calendar.firstWeekday + 7) % 729 return calendar.date(byAdding: .day, value: -offset, to: day) ?? day30 }3132 /// Six full weeks covering the month of `date`.33 public static func monthGrid(containing date: Date, calendar: Calendar, today: Date = Date()) -> [CalendarDay] {34 let first = startOfMonth(date, calendar: calendar)35 let gridStart = startOfWeek(first, calendar: calendar)36 let month = calendar.component(.month, from: first)37 return (0..<42).compactMap { i in38 guard let d = calendar.date(byAdding: .day, value: i, to: gridStart) else { return nil }39 return CalendarDay(date: d, inDisplayedMonth: calendar.component(.month, from: d) == month, isToday: calendar.isDate(d, inSameDayAs: today))40 }41 }4243 public static func week(containing date: Date, calendar: Calendar, today: Date = Date()) -> [CalendarDay] {44 let start = startOfWeek(date, calendar: calendar)45 return (0..<7).compactMap { i in46 guard let d = calendar.date(byAdding: .day, value: i, to: start) else { return nil }47 return CalendarDay(date: d, inDisplayedMonth: true, isToday: calendar.isDate(d, inSameDayAs: today))48 }49 }5051 /// The interval to request from the server for a list of days.52 public static func window(for days: [CalendarDay], calendar: Calendar, nodeID: String? = nil) -> DateWindow? {53 guard let first = days.first?.date, let last = days.last?.date, let end = calendar.date(byAdding: .day, value: 1, to: last) else { return nil }54 return DateWindow(from: first, to: end, nodeID: nodeID)55 }5657 /// Weekday symbols starting at the calendar's first weekday.58 public static func weekdaySymbols(calendar: Calendar, short: Bool = true) -> [String] {59 let symbols = short ? calendar.shortStandaloneWeekdaySymbols : calendar.standaloneWeekdaySymbols60 return (0..<7).map { symbols[(calendar.firstWeekday - 1 + $0) % 7] }61 }6263 /// Occurrences that overlap `day` (an occurrence spanning midnight appears on both days).64 public static func occurrences(on day: Date, in list: [API.MaintenanceOccurrence], calendar: Calendar) -> [API.MaintenanceOccurrence] {65 let start = calendar.startOfDay(for: day)66 guard let end = calendar.date(byAdding: .day, value: 1, to: start) else { return [] }67 return list.filter { $0.occurrenceStart < end && $0.occurrenceEnd > start }.sorted { $0.occurrenceStart < $1.occurrenceStart }68 }6970 /// Agenda: occurrences grouped by their starting day, in chronological order.71 public static func agenda(_ list: [API.MaintenanceOccurrence], calendar: Calendar) -> [(day: Date, items: [API.MaintenanceOccurrence])] {72 Dictionary(grouping: list) { calendar.startOfDay(for: $0.occurrenceStart) }73 .map { (day: $0.key, items: $0.value.sorted { $0.occurrenceStart < $1.occurrenceStart }) }74 .sorted { $0.day < $1.day }75 }7677 /// Fraction of the day (0...1) at which `date` falls, clamped to `day` — for week timelines.78 public static func dayFraction(of date: Date, in day: Date, calendar: Calendar) -> Double {79 let start = calendar.startOfDay(for: day)80 guard let end = calendar.date(byAdding: .day, value: 1, to: start) else { return 0 }81 let total = end.timeIntervalSince(start)82 return min(1, max(0, date.timeIntervalSince(start) / total))83 }84}8586public extension API.MaintenanceOccurrence {87 /// Stable identity of an occurrence: a recurring window has many.88 var occurrenceID: String { "\(window.id)@\(Int(occurrenceStart.timeIntervalSince1970))" }89}90