SPB Git

Repository Public License

InsightsCharts.swift 16.0 KB 308 lines swift

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
Files main
Menu

Theme