SPB Git

Repository Public License

Presentation.swift 16.6 KB 368 lines swift

1// ORIX Secure2// File: App/Sources/Core/Presentation.swift3// Description: How assessment states, severities and readings look. Every state has its own symbol and label, so meaning never4//              depends on colour. Red is reserved for high-severity findings.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import ORIXDesign9import ORIXSecureModel10import SwiftUI1112extension AssessmentState {13    var symbol: String {14        switch self {15        case .verified: "checkmark.circle.fill"16        case .attention: "exclamationmark.triangle.fill"17        case .userConfirmed: "person.crop.circle.badge.checkmark"18        case .userConfirmationRequired: "questionmark.circle"19        case .notAvailable: "minus.circle"20        case .notAssessed: "circle.dashed"21        }22    }2324    var tint: Color {25        switch self {26        case .verified: ORIX.Palette.success27        case .attention: ORIX.Palette.warning28        case .userConfirmed: ORIX.Palette.info29        case .userConfirmationRequired: Color(light: 0x8A93AE, dark: 0x7A84A3)30        case .notAvailable, .notAssessed: ORIX.Palette.textTertiary31        }32    }33}3435extension Finding {36    /// High-severity attention findings are the only ones shown in red.37    var tint: Color { state == .attention && severity == .high ? ORIX.Palette.danger : state.tint }38    var symbol: String { state == .attention && severity == .high ? "exclamationmark.octagon.fill" : state.symbol }39}4041/// State as symbol + words.42struct StateBadge: View {43    let state: AssessmentState44    var tint: Color?45    var body: some View {46        ORIXChip(Text(verbatim: state.title), systemName: state.symbol, tint: tint ?? state.tint)47    }48}4950/// One finding in a list.51struct FindingRow: View {52    let finding: Finding53    var body: some View {54        HStack(alignment: .top, spacing: ORIX.Space.sm) {55            Image(systemName: finding.symbol)56                .font(.title3)57                .foregroundStyle(finding.tint)58                .frame(width: 28)59                .accessibilityHidden(true)60            VStack(alignment: .leading, spacing: 4) {61                Text(verbatim: finding.title).font(.orixHeadline).foregroundStyle(ORIX.Palette.textPrimary).multilineTextAlignment(.leading)62                HStack(spacing: 6) {63                    Text(verbatim: finding.state.title)64                    if finding.state == .attention {65                        Text(verbatim: "·")66                        Text("\(finding.severity.title) severity")67                    }68                }69                .font(.orixCaption)70                .foregroundStyle(ORIX.Palette.textSecondary)71                if let first = finding.evidence.first {72                    Text(verbatim: "\(first.label): \(first.value)").font(.orixCaption).foregroundStyle(ORIX.Palette.textTertiary).lineLimit(2)73                }74            }75            Spacer(minLength: 0)76            Image(systemName: "chevron.right").font(.footnote.weight(.semibold)).foregroundStyle(ORIX.Palette.textTertiary).accessibilityHidden(true)77        }78        .padding(.vertical, 6)79        .contentShape(Rectangle())80        .accessibilityElement(children: .combine)81        .accessibilityAddTraits(.isButton)82    }83}8485/// A list of findings on a card; each opens its detail sheet.86struct FindingList: View {87    let findings: [Finding]88    @State private var selected: Finding?89    var body: some View {90        VStack(spacing: 0) {91            ForEach(Array(findings.enumerated()), id: \.element.id) { index, finding in92                Button { selected = finding } label: { FindingRow(finding: finding) }93                    .buttonStyle(.plain)94                    .accessibilityIdentifier("finding." + finding.id)95                if index < findings.count - 1 { Divider().padding(.leading, 40) }96            }97        }98        .orixCard(padding: ORIX.Space.sm)99        .sheet(item: $selected) { FindingDetailView(finding: $0) }100    }101}102103/// Everything a finding carries: state, severity, confidence, evidence, explanation, action, method, limits, date.104struct FindingDetailView: View {105    let finding: Finding106    @Environment(\.dismiss) private var dismiss107108    var body: some View {109        NavigationStack {110            ScrollView {111                VStack(alignment: .leading, spacing: ORIX.Space.lg) {112                    VStack(alignment: .leading, spacing: ORIX.Space.sm) {113                        Image(systemName: finding.symbol).font(.system(size: 34)).foregroundStyle(finding.tint).accessibilityHidden(true)114                        Text(verbatim: finding.title).font(.orixTitle).foregroundStyle(ORIX.Palette.textPrimary)115                        FlowChips {116                            StateBadge(state: finding.state, tint: finding.tint)117                            if finding.state == .attention {118                                ORIXChip(Text("\(finding.severity.title) severity"), systemName: "gauge.with.dots.needle.33percent")119                            }120                            ORIXChip(Text("Confidence: \(finding.confidence.title)"), systemName: "scope")121                        }122                    }123                    block("What it means") { Text(verbatim: finding.explanation).font(.orixBody).foregroundStyle(ORIX.Palette.textPrimary) }124                    if let recommendation = finding.recommendation {125                        block("Recommended action") { Text(verbatim: recommendation).font(.orixBody).foregroundStyle(ORIX.Palette.textPrimary) }126                    }127                    if !finding.evidence.isEmpty {128                        block("Evidence") {129                            VStack(alignment: .leading, spacing: ORIX.Space.sm) {130                                ForEach(finding.evidence) { evidence in131                                    VStack(alignment: .leading, spacing: 2) {132                                        Text(verbatim: evidence.label).font(.orixCaption).foregroundStyle(ORIX.Palette.textSecondary)133                                        Text(verbatim: evidence.value).font(.orixMono).foregroundStyle(ORIX.Palette.textPrimary).textSelection(.enabled)134                                        if let source = evidence.source {135                                            Text("Source: \(source)").font(.caption2).foregroundStyle(ORIX.Palette.textTertiary)136                                        }137                                    }138                                    .accessibilityElement(children: .combine)139                                }140                            }141                        }142                    }143                    block("How it was established") {144                        Label { Text(verbatim: finding.verification.title) } icon: { Image(systemName: "checkmark.seal") }145                            .font(.orixCallout).foregroundStyle(ORIX.Palette.textPrimary)146                    }147                    if !finding.notInspected.isEmpty {148                        block("What was not inspected") {149                            VStack(alignment: .leading, spacing: ORIX.Space.xs) {150                                ForEach(finding.notInspected, id: \.self) { item in151                                    Label { Text(verbatim: item) } icon: { Image(systemName: "eye.slash") }152                                        .font(.orixCallout).foregroundStyle(ORIX.Palette.textSecondary)153                                }154                            }155                        }156                    }157                    Text("Assessed \(finding.assessedAt.formatted(date: .abbreviated, time: .shortened))")158                        .font(.orixCaption).foregroundStyle(ORIX.Palette.textTertiary)159                }160                .padding(ORIX.Space.lg)161                .frame(maxWidth: 720, alignment: .leading)162                .frame(maxWidth: .infinity)163            }164            .background(ORIX.Palette.canvas)165            .navigationTitle("Finding")166            .navigationBarTitleDisplayMode(.inline)167            .toolbar { ToolbarItem(placement: .confirmationAction) { Button("Done") { dismiss() }.accessibilityIdentifier("finding.done") } }168        }169        .accessibilityIdentifier("finding.detail")170    }171172    private func block(_ title: LocalizedStringKey, @ViewBuilder content: () -> some View) -> some View {173        VStack(alignment: .leading, spacing: ORIX.Space.xs) {174            Text(title).font(.orixOverline).textCase(.uppercase).foregroundStyle(ORIX.Palette.textSecondary).accessibilityAddTraits(.isHeader)175            content()176        }177        .frame(maxWidth: .infinity, alignment: .leading)178        .orixCard()179    }180}181182/// Chips that wrap onto several lines.183struct FlowChips: Layout {184    var spacing: CGFloat = 6185186    init(spacing: CGFloat = 6) { self.spacing = spacing }187188    func sizeThatFits(proposal: ProposedViewSize, subviews: Subviews, cache: inout ()) -> CGSize {189        let width = proposal.width ?? .infinity190        var x: CGFloat = 0, y: CGFloat = 0, row: CGFloat = 0, widest: CGFloat = 0191        for subview in subviews {192            let size = subview.sizeThatFits(.unspecified)193            if x > 0, x + size.width > width {194                x = 0195                y += row + spacing196                row = 0197            }198            x += size.width + spacing199            row = max(row, size.height)200            widest = max(widest, x - spacing)201        }202        return CGSize(width: min(widest, width), height: y + row)203    }204205    func placeSubviews(in bounds: CGRect, proposal: ProposedViewSize, subviews: Subviews, cache: inout ()) {206        var x = bounds.minX, y = bounds.minY, row: CGFloat = 0207        for subview in subviews {208            let size = subview.sizeThatFits(.unspecified)209            if x > bounds.minX, x + size.width > bounds.maxX {210                x = bounds.minX211                y += row + spacing212                row = 0213            }214            subview.place(at: CGPoint(x: x, y: y), proposal: ProposedViewSize(size))215            x += size.width + spacing216            row = max(row, size.height)217        }218    }219}220221/// A label and a reading that may be unavailable. An unavailable reading shows its reason, never a placeholder number.222struct ReadingRow: View {223    let label: String224    let value: Reading<String>225    var note: String?226    var source: String?227228    var body: some View {229        VStack(alignment: .leading, spacing: 3) {230            HStack(alignment: .firstTextBaseline) {231                Text(verbatim: label).font(.orixCallout).foregroundStyle(ORIX.Palette.textSecondary)232                Spacer(minLength: ORIX.Space.sm)233                switch value {234                case .measured(let text):235                    Text(verbatim: text).font(.orixHeadline).foregroundStyle(ORIX.Palette.textPrimary).multilineTextAlignment(.trailing).textSelection(.enabled)236                case .unavailable:237                    Label("Not available", systemImage: "minus.circle").font(.orixCallout).foregroundStyle(ORIX.Palette.textTertiary)238                }239            }240            if let reason = value.unavailability {241                Text(verbatim: reason.detail).font(.orixCaption).foregroundStyle(ORIX.Palette.textTertiary)242            } else if let note {243                Text(verbatim: note).font(.orixCaption).foregroundStyle(ORIX.Palette.textTertiary)244            }245        }246        .padding(.vertical, 6)247        .accessibilityElement(children: .combine)248    }249}250251/// The list of things no app can see, shown wherever a result could be over-read.252struct LimitsCard: View {253    let title: LocalizedStringKey254    let items: [String]255    @State private var expanded = false256257    var body: some View {258        VStack(alignment: .leading, spacing: 0) {259            // The whole row is the control, so it is as easy to hit on a wide iPad card as on an iPhone.260            Button { withAnimation(ORIX.Motion.quick) { expanded.toggle() } } label: {261                HStack(spacing: ORIX.Space.sm) {262                    Image(systemName: "eye.slash").foregroundStyle(ORIX.Palette.textSecondary).accessibilityHidden(true)263                    Text(title).font(.orixHeadline).foregroundStyle(ORIX.Palette.textPrimary).multilineTextAlignment(.leading)264                    Spacer(minLength: ORIX.Space.sm)265                    Image(systemName: "chevron.right").font(.footnote.weight(.semibold)).foregroundStyle(ORIX.Palette.textSecondary)266                        .rotationEffect(.degrees(expanded ? 90 : 0)).accessibilityHidden(true)267                }268                .frame(maxWidth: .infinity, minHeight: ORIX.minimumTarget, alignment: .leading)269                .contentShape(Rectangle())270            }271            .buttonStyle(.plain)272            .accessibilityValue(Text(expanded ? "Expanded" : "Collapsed"))273            .accessibilityIdentifier("limits.card")274            if expanded {275                VStack(alignment: .leading, spacing: ORIX.Space.sm) {276                    ForEach(items, id: \.self) { item in277                        Label { Text(verbatim: item) } icon: { Image(systemName: "minus") }278                            .font(.orixCallout).foregroundStyle(ORIX.Palette.textSecondary)279                            .frame(maxWidth: .infinity, alignment: .leading)280                    }281                }282                .padding(.top, ORIX.Space.xs)283            }284        }285        .orixCard()286    }287}288289/// Segmented ring of finding states. It shows how much was assessed and with what result — not a security level.290struct SummaryRing: View {291    let segments: [(state: AssessmentState, count: Int)]292    var lineWidth: CGFloat = 14293    @Environment(\.accessibilityReduceMotion) private var reduceMotion294    @State private var progress: CGFloat = 0295296    private var total: Int { segments.reduce(0) { $0 + $1.count } }297298    var body: some View {299        Canvas { context, size in300            let side = min(size.width, size.height)301            let radius = (side - lineWidth) / 2302            let center = CGPoint(x: size.width / 2, y: size.height / 2)303            var track = Path()304            track.addArc(center: center, radius: radius, startAngle: .zero, endAngle: .degrees(360), clockwise: false)305            context.stroke(track, with: .color(ORIX.Palette.surfaceRaised), lineWidth: lineWidth)306            guard total > 0 else { return }307            let gap = segments.filter { $0.count > 0 }.count > 1 ? 3.0 : 0308            var start = -90.0309            for segment in segments where segment.count > 0 {310                let sweep = 360 * Double(segment.count) / Double(total) * Double(progress)311                var path = Path()312                path.addArc(center: center, radius: radius, startAngle: .degrees(start + gap / 2), endAngle: .degrees(start + max(gap / 2 + 0.5, sweep - gap / 2)), clockwise: false)313                context.stroke(path, with: .color(segment.state.tint), style: StrokeStyle(lineWidth: lineWidth, lineCap: .butt))314                start += sweep315            }316        }317        .aspectRatio(1, contentMode: .fit)318        .onAppear {319            if reduceMotion { progress = 1 } else { withAnimation(ORIX.Motion.expressive.delay(0.1)) { progress = 1 } }320        }321        .accessibilityHidden(true)322    }323}324325/// A screen scaffold: scrolling column with a readable maximum width on iPad.326struct ScreenScroll<Content: View>: View {327    @ViewBuilder var content: Content328    var body: some View {329        ScrollView {330            VStack(alignment: .leading, spacing: ORIX.Space.lg) { content }331                .padding(.horizontal, ORIX.Space.md)332                .padding(.vertical, ORIX.Space.md)333                .frame(maxWidth: 860, alignment: .leading)334                .frame(maxWidth: .infinity)335        }336        .background(ORIX.Palette.canvas.ignoresSafeArea())337    }338}339340/// Navigation tile used by hubs.341struct NavigationTile: View {342    let destination: Destination343    var detail: String?344    @Environment(Router.self) private var router345346    var body: some View {347        Button { router.push(.destination(destination)) } label: {348            HStack(spacing: ORIX.Space.sm) {349                ORIXGlyph(destination.systemImage)350                VStack(alignment: .leading, spacing: 2) {351                    Text(destination.title).font(.orixHeadline).foregroundStyle(ORIX.Palette.textPrimary)352                    if let detail { Text(verbatim: detail).font(.orixCaption).foregroundStyle(ORIX.Palette.textSecondary).multilineTextAlignment(.leading) }353                }354                Spacer(minLength: 0)355                Image(systemName: "chevron.right").font(.footnote.weight(.semibold)).foregroundStyle(ORIX.Palette.textTertiary).accessibilityHidden(true)356            }357            .frame(maxWidth: .infinity, alignment: .leading)358            .orixCard(padding: ORIX.Space.sm)359        }360        .buttonStyle(.plain)361        .accessibilityIdentifier("tile." + destination.rawValue)362    }363}364365extension Date {366    var orixRelative: String { formatted(.relative(presentation: .named)) }367}368
Files main
Menu

Theme