Repository Public License
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