Repository Public License
1// ORIX Alarm2// File: App/Features/Insights/InsightsCharts.swift3// Description: Swift Charts of the insights dashboard: daily confirmations and snoozes, confirmation delay, time of day, mission performance.4//5// Author: Simon-Pierre Boucher6// Contact: contact@spboucher.ai7import AlarmCore8import Charts9import SwiftUI1011/// Card chrome shared by the insight charts: title, plain-language subtitle, content, optional footnote.12struct InsightChartCard<Content: View>: View {13 let title: LocalizedStringKey14 let subtitle: LocalizedStringKey15 var footnote: String? = nil16 @ViewBuilder var content: Content1718 var body: some View {19 VStack(alignment: .leading, spacing: 12) {20 VStack(alignment: .leading, spacing: 3) {21 Text(title).font(.orixHeadline).accessibilityAddTraits(.isHeader)22 Text(subtitle).font(.orixCaption).foregroundStyle(Theme.textSecondary)23 }24 content25 if let footnote { Text(footnote).font(.orixCaption).foregroundStyle(Theme.textSecondary) }26 }27 .frame(maxWidth: .infinity, alignment: .leading)28 .glassCard()29 }30}3132/// Placeholder shown inside a chart card when the period holds no value to plot.33struct InsightChartEmpty: View {34 let text: LocalizedStringKey35 var body: some View {36 Label(text, systemImage: "chart.line.flattrend.xyaxis")37 .font(.orixCaption).foregroundStyle(Theme.textTertiary)38 .frame(maxWidth: .infinity, minHeight: 72, alignment: .leading)39 .padding(.horizontal, 14)40 .background(Theme.surface, in: RoundedRectangle(cornerRadius: 16, style: .continuous))41 }42}4344private extension View {45 /// Day axis and quiet grid tuned for the dark aurora background.46 func insightDayAxes(days: [WakeStatistics.Day]) -> some View {47 let dayCount = days.count48 let stride = dayCount <= 8 ? 1 : (dayCount <= 16 ? 2 : (dayCount <= 45 ? 7 : 14))49 let first = days.first?.day ?? .now, last = days.last?.day ?? .now50 let domain = first...(Calendar.current.date(byAdding: .day, value: 1, to: last) ?? last)51 // Room at the end so the last date label is not cut on long ranges.52 return chartXScale(domain: domain, range: .plotDimension(endPadding: dayCount <= 8 ? 0 : 26)).chartXAxis {53 AxisMarks(values: .stride(by: .day, count: stride)) { _ in54 AxisGridLine().foregroundStyle(Theme.hairline)55 if dayCount <= 8 {56 AxisValueLabel(format: .dateTime.weekday(.abbreviated), centered: true).foregroundStyle(Theme.textSecondary)57 } else {58 AxisValueLabel(format: .dateTime.day().month(.abbreviated), centered: dayCount <= 16).foregroundStyle(Theme.textSecondary)59 }60 }61 }62 }63}6465// MARK: Confirmations and snoozes per day66struct ConfirmationsSnoozesChart: View {67 let days: [WakeStatistics.Day]6869 private struct Entry: Identifiable {70 let day: Date; let series: String; let count: Int71 var id: String { "\(day.timeIntervalSince1970)-\(series)" }72 }73 private static let confirmed = String(localized: "Wake confirmations")74 private static let snoozed = String(localized: "Snoozes")7576 var body: some View {77 let entries = days.flatMap { [Entry(day: $0.day, series: Self.confirmed, count: $0.confirmed), Entry(day: $0.day, series: Self.snoozed, count: $0.snoozes)] }78 let top = max(entries.map(\.count).max() ?? 0, 2)79 VStack(alignment: .leading, spacing: 10) {80 HStack(spacing: 16) {81 legendItem(Self.confirmed, symbol: "checkmark.circle.fill", fill: AnyShapeStyle(Theme.success))82 legendItem(Self.snoozed, symbol: "zzz", fill: AnyShapeStyle(Theme.gold.opacity(0.45)), outlined: true)83 }84 .accessibilityHidden(true)85 Chart(entries) { entry in86 BarMark(x: .value("Day", entry.day, unit: .day), y: .value("Count", entry.count), width: .ratio(0.78))87 .position(by: .value("Event", entry.series))88 .foregroundStyle(entry.series == Self.confirmed ? AnyShapeStyle(Theme.success) : AnyShapeStyle(Theme.gold.opacity(0.45)))89 .cornerRadius(3)90 .annotation(position: .top, spacing: 2) {91 // Values are printed on short ranges; snoozes also carry a "z" so the two series differ without colour.92 if days.count <= 8, entry.count > 0 {93 Text(entry.series == Self.confirmed ? "\(entry.count)" : "\(entry.count)z")94 .font(.system(size: 9, weight: .bold, design: .rounded)).foregroundStyle(Theme.textSecondary)95 }96 }97 }98 .chartYScale(domain: 0...Double(top) + 0.6)99 .chartYAxis {100 AxisMarks(position: .leading, values: Array(0...top)) { _ in101 AxisGridLine().foregroundStyle(Theme.hairline)102 AxisValueLabel().foregroundStyle(Theme.textSecondary)103 }104 }105 .insightDayAxes(days: days)106 .chartLegend(.hidden)107 .frame(height: 180)108 .accessibilityElement(children: .ignore)109 .accessibilityLabel("Chart: wake confirmations and snoozes per day")110 .accessibilityValue(spoken)111 .accessibilityIdentifier("insights.chart.daily")112 }113 }114115 private func legendItem(_ title: String, symbol: String, fill: AnyShapeStyle, outlined: Bool = false) -> some View {116 HStack(spacing: 6) {117 RoundedRectangle(cornerRadius: 3).fill(fill)118 .overlay { if outlined { RoundedRectangle(cornerRadius: 3).strokeBorder(Theme.gold, lineWidth: 1) } }119 .frame(width: 12, height: 12)120 Image(systemName: symbol).font(.caption2).foregroundStyle(Theme.textSecondary)121 Text(title).font(.orixCaption).foregroundStyle(Theme.textSecondary)122 }123 }124125 private var spoken: String {126 let confirmedDays = days.filter { $0.confirmed > 0 }.count127 let snoozes = days.map(\.snoozes).reduce(0, +)128 var text = String(localized: "\(days.count) days. A wake confirmation was recorded on \(confirmedDays) of them. \(snoozes) snoozes in total.")129 if let worst = days.max(by: { $0.snoozes < $1.snoozes }), worst.snoozes > 0 {130 text += " " + String(localized: "Most snoozes: \(worst.snoozes) on \(worst.day.formatted(.dateTime.weekday(.wide).day().month())).")131 }132 return text133 }134}135136// MARK: Confirmation delay per day137struct ConfirmationDelayChart: View {138 let days: [WakeStatistics.Day]139140 var body: some View {141 let points = days.compactMap { d in d.confirmationDelay.map { (day: d.day, minutes: max($0, 0) / 60) } }142 if points.isEmpty {143 InsightChartEmpty(text: "No day in this period has both a recorded ring and a wake confirmation.")144 } else {145 let top = max((points.map(\.minutes).max() ?? 1) * 1.2, 2)146 Chart {147 ForEach(points, id: \.day) { p in148 LineMark(x: .value("Day", p.day, unit: .day), y: .value("Minutes", p.minutes))149 .foregroundStyle(Theme.sunrise.opacity(0.7))150 .lineStyle(StrokeStyle(lineWidth: 2, lineCap: .round, lineJoin: .round))151 PointMark(x: .value("Day", p.day, unit: .day), y: .value("Minutes", p.minutes))152 .symbol { Circle().fill(Theme.sunrise).overlay(Circle().strokeBorder(.white.opacity(0.9), lineWidth: 1.5)).frame(width: 10, height: 10) }153 .annotation(position: .top, spacing: 3) {154 if days.count <= 8 {155 Text(String(format: "%.0f", p.minutes)).font(.system(size: 9, weight: .bold, design: .rounded)).foregroundStyle(Theme.textSecondary)156 }157 }158 }159 }160 .chartYScale(domain: 0...top)161 .chartYAxis {162 AxisMarks(position: .leading, values: .automatic(desiredCount: 4)) { value in163 AxisGridLine().foregroundStyle(Theme.hairline)164 AxisValueLabel { if let v = value.as(Double.self) { Text("\(Int(v.rounded())) min").foregroundStyle(Theme.textSecondary) } }165 }166 }167 .insightDayAxes(days: days)168 .frame(height: 170)169 .accessibilityElement(children: .ignore)170 .accessibilityLabel("Chart: minutes between the alarm ringing and your wake confirmation, per day")171 .accessibilityValue(spoken(points.map(\.minutes)))172 .accessibilityIdentifier("insights.chart.delay")173 }174 }175176177 private func spoken(_ minutes: [Double]) -> String {178 let mean = minutes.reduce(0, +) / Double(max(minutes.count, 1))179 return String(localized: "\(minutes.count) days with a value. Shortest \(Int((minutes.min() ?? 0).rounded())) minutes, longest \(Int((minutes.max() ?? 0).rounded())) minutes, average \(Int(mean.rounded())) minutes.")180 }181}182183// MARK: Time of day of the wake confirmation184struct ConfirmationTimeChart: View {185 let days: [WakeStatistics.Day]186 let use24h: Bool?187188 private func timeText(_ minute: Int) -> String { Fmt.timeString(ClockTime(minutesSinceMidnight: minute), use24h: use24h) }189190 var body: some View {191 let points = days.compactMap { d in d.confirmationMinute.map { (day: d.day, minute: $0) } }192 if points.isEmpty {193 InsightChartEmpty(text: "No wake confirmation recorded in this period.")194 } else {195 let minutes = points.map(\.minute)196 let mean = Double(minutes.reduce(0, +)) / Double(minutes.count)197 let low = Double((minutes.min() ?? 0) - 20), high = Double((minutes.max() ?? 0) + 20)198 VStack(alignment: .leading, spacing: 10) {199 HStack(spacing: 16) {200 HStack(spacing: 6) {201 InsightDiamond().fill(Theme.azure).overlay(InsightDiamond().stroke(.white.opacity(0.9), lineWidth: 1.2)).frame(width: 11, height: 11)202 Text("Confirmation").font(.orixCaption).foregroundStyle(Theme.textSecondary)203 }204 HStack(spacing: 6) {205 ChartLegendLine().stroke(Theme.textSecondary, style: StrokeStyle(lineWidth: 1.5, dash: [4, 3])).frame(width: 22, height: 2)206 Text("Average \(timeText(Int(mean.rounded())))").font(.orixCaption).foregroundStyle(Theme.textSecondary)207 }208 }209 .accessibilityHidden(true)210 Chart {211 RuleMark(y: .value("Average", mean))212 .foregroundStyle(Theme.textSecondary)213 .lineStyle(StrokeStyle(lineWidth: 1.5, dash: [4, 3]))214 ForEach(points, id: \.day) { p in215 PointMark(x: .value("Day", p.day, unit: .day), y: .value("Time", p.minute))216 .symbol { InsightDiamond().fill(Theme.azure).overlay(InsightDiamond().stroke(.white.opacity(0.9), lineWidth: 1.2)).frame(width: 12, height: 12) }217 }218 }219 .chartYScale(domain: low...high)220 .chartYAxis {221 AxisMarks(position: .leading, values: .automatic(desiredCount: 4)) { value in222 AxisGridLine().foregroundStyle(Theme.hairline)223 AxisValueLabel { if let v = value.as(Double.self) { Text(timeText(Int(v.rounded()))).foregroundStyle(Theme.textSecondary) } }224 }225 }226 .insightDayAxes(days: days)227 .frame(height: 170)228 .accessibilityElement(children: .ignore)229 .accessibilityLabel("Chart: time of day of your wake confirmation, per day")230 .accessibilityValue(String(localized: "\(points.count) days with a confirmation. Earliest \(timeText(minutes.min() ?? 0)), latest \(timeText(minutes.max() ?? 0)), average \(timeText(Int(mean.rounded())))."))231 .accessibilityIdentifier("insights.chart.timeOfDay")232 }233 }234 }235236}237238/// InsightDiamond marker, so confirmation times are not told apart from other series by colour only.239nonisolated struct InsightDiamond: Shape {240 func path(in rect: CGRect) -> Path {241 var p = Path()242 p.move(to: CGPoint(x: rect.midX, y: rect.minY)); p.addLine(to: CGPoint(x: rect.maxX, y: rect.midY))243 p.addLine(to: CGPoint(x: rect.midX, y: rect.maxY)); p.addLine(to: CGPoint(x: rect.minX, y: rect.midY))244 p.closeSubpath()245 return p246 }247}248249// MARK: Mission performance250struct MissionPerformanceChart: View {251 let missions: [WakeStatistics.MissionStat]252253 var body: some View {254 if missions.isEmpty {255 InsightChartEmpty(text: "No mission completed in this period.")256 } else {257 let top = max((missions.map(\.averageDuration).max() ?? 1) * 1.25, 10)258 VStack(alignment: .leading, spacing: 14) {259 Chart(missions) { m in260 BarMark(x: .value("Average duration", m.averageDuration), y: .value("Mission", m.kind.title), height: .fixed(18))261 .foregroundStyle(m.kind.tint.gradient)262 .cornerRadius(5)263 .annotation(position: .trailing, spacing: 6) {264 Text(Fmt.duration(m.averageDuration)).font(.system(size: 11, weight: .bold, design: .rounded).monospacedDigit())265 .foregroundStyle(Theme.textPrimary)266 }267 }268 .chartXScale(domain: 0...top, range: .plotDimension(endPadding: 30))269 .chartXAxis {270 AxisMarks(values: .automatic(desiredCount: 4)) { value in271 AxisGridLine().foregroundStyle(Theme.hairline)272 AxisValueLabel { if let v = value.as(Double.self) { Text("\(Int(v.rounded())) s").foregroundStyle(Theme.textSecondary) } }273 }274 }275 .chartYAxis {276 AxisMarks(position: .leading) { _ in277 AxisValueLabel().foregroundStyle(Theme.textPrimary).font(.system(size: 11, weight: .semibold, design: .rounded))278 }279 }280 .frame(height: CGFloat(missions.count) * 40 + 34)281 .accessibilityElement(children: .ignore)282 .accessibilityLabel("Chart: average duration per mission")283 .accessibilityValue(missions.map { String(localized: "\($0.kind.title): \(Fmt.duration($0.averageDuration)).") }.joined(separator: " "))284 .accessibilityIdentifier("insights.chart.missions")285286 VStack(spacing: 10) {287 ForEach(missions) { m in288 HStack(alignment: .top, spacing: 12) {289 Image(systemName: m.kind.symbol).font(.callout.weight(.semibold)).foregroundStyle(m.kind.tint)290 .frame(width: 34, height: 34).background(Theme.surfaceRaised, in: RoundedRectangle(cornerRadius: 10, style: .continuous))291 .accessibilityHidden(true)292 VStack(alignment: .leading, spacing: 3) {293 Text(m.kind.title).font(.orixHeadline)294 Text("\(m.completions) completed · \(Int((m.cleanRate * 100).rounded())) % without a mistake")295 .font(.orixCaption).foregroundStyle(Theme.textSecondary)296 Text("Average \(Fmt.duration(m.averageDuration)) · fastest \(Fmt.duration(m.bestDuration)) · \(String(format: "%.1f", m.averageMistakes)) mistakes on average")297 .font(.orixCaption).foregroundStyle(Theme.textSecondary)298 }299 Spacer(minLength: 0)300 }301 .accessibilityElement(children: .combine)302 }303 }304 }305 }306 }307}308