Commit `c220e26bb4`

c220e26bb496e455a5bdb6a8dc22abf09ecfed5f

parent: dc479a3ba0

Unsigned

cmc <hello@cleberg.net> · 2026-07-22 01:47 UTC

feat(a11y): color independence, reduce motion, reduce transparency (#21 phase 5)

Audit unchanged at 11 dark / 14 light — expected, as none of these
settings are exercised by performAccessibilityAudit, and simctl can
toggle only Increase Contrast, not Differentiate Without Color, Reduce
Motion, or Reduce Transparency. Correct by construction and build-clean;
runtime behaviour is verified in the Phase 6 manual pass.

Color independence:

- Widget status is now an SF Symbol (checkmark.circle.fill /
  exclamationmark.triangle.fill / exclamationmark.octagon.fill), the same
  vocabulary as the in-app badges, replacing a silent colour-only dot on
  both the domain rows and the small-view count pills. Status now survives
  greyscale and reads consistently across surfaces.
- Under accessibilityDifferentiateWithoutColor: the Dashboard
  summary-card dot becomes a per-filter symbol, the selected quick-filter
  chip gains a checkmark and a border (selection was fill-colour only, and
  also gains the .isSelected trait), and LabeledValueRow prefixes a
  warning/failure symbol. All gated on the setting so the default UI stays
  uncluttered.

Reduce motion: all five withAnimation/.animation sites now pass nil under
accessibilityReduceMotion — AppCopyButton's check cross-fade,
CollapsibleSectionView's expand/collapse, TimelineDiffView's scroll, and
WatchlistView's list reorder.

Reduce transparency: the single .thinMaterial capsule falls back to an
opaque AppSurfaceElevated fill under accessibilityReduceTransparency.

The SweepActivityController item from the plan is dropped: it is pure
ActivityKit lifecycle with no animation, confirmed back in the issue
triage.

Layout: unified · split

Docs/ACCESSIBILITY.md +25

	@@ -238,6 +238,31 @@ pre-commit that blocks every commit. A hook routinely bypassed with
238	and cipher suites; extend it wherever the view model emits a fingerprint,	238	and cipher suites; extend it wherever the view model emits a fingerprint,
239	serial, or record string.	239	serial, or record string.
240		240
		241	## Color independence, motion, transparency
		242
		243	- Status is never colour-only. In-app badges already pair a symbol with the
		244	colour. The widget status dot is now an SF Symbol
		245	(`checkmark.circle.fill` / `exclamationmark.triangle.fill` /
		246	`exclamationmark.octagon.fill`) — the same vocabulary as the badges, so a
		247	status reads consistently across surfaces and survives greyscale.
		248	- `accessibilityDifferentiateWithoutColor` adds redundant shape only when the
		249	user asks for it, avoiding clutter otherwise: the Dashboard summary-card dot
		250	becomes a per-filter symbol, the selected quick-filter chip gains a checkmark
		251	and border (selection was fill-colour only), and `LabeledValueRow` prefixes a
		252	warning/failure symbol.
		253	- `accessibilityReduceMotion` guards all five animation sites via
		254	`withAnimation(reduceMotion ? nil : …)` / `.animation(reduceMotion ? nil : …)`:
		255	`AppCopyButton`'s check cross-fade, `CollapsibleSectionView`'s expand/collapse,
		256	`TimelineDiffView`'s scroll, and `WatchlistView`'s list reorder.
		257	- `accessibilityReduceTransparency` swaps the single `.thinMaterial` for an
		258	opaque `AppSurfaceElevated` capsule.
		259
		260	These cannot be verified by `simctl`, which toggles only Increase Contrast — the
		261	other three settings live in the simulator's Settings app. They are correct by
		262	construction and build-clean; their runtime behaviour is part of the Phase 6
		263	manual pass. `SweepActivityController` was dropped from the motion list: it is
		264	pure ActivityKit lifecycle with no animation to guard.
		265
241	### What the automated audit cannot check	266	### What the automated audit cannot check
242		267
243	`performAccessibilityAudit()` validates descriptions, traits, contrast, hit	268	`performAccessibilityAudit()` validates descriptions, traits, contrast, hit

DomainDig/ContentView.swift +28 −2

 struct LabeledValueRow: View {
     @Environment(\.appDensity) private var appDensity
+    @Environment(\.accessibilityDifferentiateWithoutColor) private var differentiateWithoutColor
     let row: InfoRowViewData
     var body: some View {
                     Text(row.label)
                         .font(appDensity.font(.caption2))
                         .foregroundStyle(Color(.appTextSecondary))
-                    valueText
+                    HStack(alignment: .firstTextBaseline, spacing: 4) {
+                        if differentiateWithoutColor, let symbol = toneSymbol {
+                            Image(systemName: symbol)
+                                .font(appDensity.font(.caption2))
+                                .foregroundStyle(ResultColors.color(for: row.tone))
+                                .accessibilityHidden(true)
+                        }
+                        valueText
+                    }
                 }
                 .frame(maxWidth: .infinity, alignment: .leading)
                 .layoutPriority(1)
         .frame(minHeight: appDensity.metrics.rowMinHeight, alignment: .topLeading)
     }
+    /// A leading symbol for warning/failure tones, shown only under Differentiate
+    /// Without Color so tone is not conveyed by text colour alone. Hidden from
+    /// VoiceOver — the value text already carries the meaning.
+    private var toneSymbol: String? {
+        switch row.tone {
+        case .warning: return "exclamationmark.triangle.fill"
+        case .failure: return "xmark.octagon.fill"
+        default: return nil
+        }
+    }
     @ViewBuilder
     private var valueText: some View {
         let base = Text(row.value)
 private struct DataManagementSettingsView: View {
     @Bindable var viewModel: DomainViewModel
+    @Environment(\.accessibilityReduceTransparency) private var reduceTransparency
     @State private var showClearHistoryConfirmation = false
     @State private var showClearCacheConfirmation = false
                     .foregroundStyle(Color(.appTextSecondary))
                     .padding(.horizontal, 14)
                     .padding(.vertical, 10)
-                    .background(.thinMaterial, in: Capsule())
+                    // Reduce Transparency swaps the blur for an opaque surface.
+                    // On iOS 26+ the system also composites its own translucency
+                    // that the app cannot declare — verify there too (Phase 6).
+                    .background(
+                        Capsule().fill(reduceTransparency ? AnyShapeStyle(Color(.appSurfaceElevated)) : AnyShapeStyle(.thinMaterial))
+                    )
                     .padding(.bottom, 8)
                     .transition(.move(edge: .bottom).combined(with: .opacity))
             }

DomainDig/DashboardView.swift +50 −11

	@@ -2,6 +2,7 @@ import SwiftUI
2		2
3	struct DashboardView: View {	3	struct DashboardView: View {
4	@Environment(\.appDensity) private var appDensity	4	@Environment(\.appDensity) private var appDensity
		5	@Environment(\.accessibilityDifferentiateWithoutColor) private var differentiateWithoutColor
5	@Bindable var viewModel: DomainViewModel	6	@Bindable var viewModel: DomainViewModel
6	@State private var collapsedGroups = Set<String>()	7	@State private var collapsedGroups = Set<String>()
7		8
	@@ -44,15 +45,33 @@ struct DashboardView: View {
44	Button {	45	Button {
45	viewModel.dashboardFilter = filter	46	viewModel.dashboardFilter = filter
46	} label: {	47	} label: {
47	Text(filter.title)	48	let isSelected = viewModel.dashboardFilter == filter
48	.font(appDensity.font(.caption, weight: .semibold))	49	HStack(spacing: 4) {
49	.foregroundStyle(viewModel.dashboardFilter == filter ? Color(.appOnAccent) : Color.primary)	50	// Selection is a fill-colour change; under
50	.padding(.horizontal, 12)	51	// Differentiate Without Color add a
51	.padding(.vertical, 8)	52	// checkmark + border so it does not depend
52	.background(viewModel.dashboardFilter == filter ? Color(.statusInfo) : Color(.appSurfaceElevated))	53	// on hue alone.
53	.clipShape(Capsule())	54	if isSelected, differentiateWithoutColor {
		55	Image(systemName: "checkmark")
		56	.font(.caption2.weight(.bold))
		57	}
		58	Text(filter.title)
		59	.font(appDensity.font(.caption, weight: .semibold))
		60	}
		61	.foregroundStyle(isSelected ? Color(.appOnAccent) : Color.primary)
		62	.padding(.horizontal, 12)
		63	.padding(.vertical, 8)
		64	.background(isSelected ? Color(.statusInfo) : Color(.appSurfaceElevated))
		65	.overlay(
		66	Capsule().strokeBorder(
		67	Color.primary,
		68	lineWidth: isSelected && differentiateWithoutColor ? 1.5 : 0
		69	)
		70	)
		71	.clipShape(Capsule())
54	}	72	}
55	.buttonStyle(.plain)	73	.buttonStyle(.plain)
		74	.accessibilityAddTraits(viewModel.dashboardFilter == filter ? .isSelected : [])
56	}	75	}
57	}	76	}
58	.padding(.vertical, 4)	77	.padding(.vertical, 4)
	@@ -198,10 +217,18 @@ struct DashboardView: View {
198	// Was a fixed 28pt, which ignored Dynamic Type entirely.	217	// Was a fixed 28pt, which ignored Dynamic Type entirely.
199	.font(.system(.title, design: .rounded, weight: .bold))	218	.font(.system(.title, design: .rounded, weight: .bold))
200	.foregroundStyle(.primary)	219	.foregroundStyle(.primary)
201	HStack {	220	HStack(spacing: 5) {
202	Circle()	221	// A symbol under Differentiate Without Color (where a bare
203	.fill(tint)	222	// colour dot conveys nothing), a plain dot otherwise.
204	.frame(width: 8, height: 8)	223	if differentiateWithoutColor {
		224	Image(systemName: symbol(for: filter))
		225	.font(.caption2)
		226	.foregroundStyle(tint)
		227	} else {
		228	Circle()
		229	.fill(tint)
		230	.frame(width: 8, height: 8)
		231	}
205	Text(filter.title)	232	Text(filter.title)
206	.font(appDensity.font(.caption2, design: .default, weight: .semibold))	233	.font(appDensity.font(.caption2, design: .default, weight: .semibold))
207	.foregroundStyle(tint)	234	.foregroundStyle(tint)
	@@ -215,6 +242,18 @@ struct DashboardView: View {
215	.buttonStyle(.plain)	242	.buttonStyle(.plain)
216	}	243	}
217		244
		245	private func symbol(for filter: PortfolioFilterOption) -> String {
		246	switch filter {
		247	case .all: return "square.grid.2x2.fill"
		248	case .healthy: return "checkmark.circle.fill"
		249	case .warning: return "exclamationmark.triangle.fill"
		250	case .critical: return "exclamationmark.octagon.fill"
		251	case .changed: return "arrow.triangle.2.circlepath"
		252	case .expiring: return "clock.badge.exclamationmark.fill"
		253	case .unreachable: return "wifi.slash"
		254	}
		255	}
		256
218	private func cardBackground(for filter: PortfolioFilterOption) -> some ShapeStyle {	257	private func cardBackground(for filter: PortfolioFilterOption) -> some ShapeStyle {
219	if viewModel.dashboardFilter == filter {	258	if viewModel.dashboardFilter == filter {
220	// Uses the authored info surface rather than a translucent wash of	259	// Uses the authored info surface rather than a translucent wash of

DomainDig/DomainDigUI.swift +5 −3

 struct AppCopyButton: View {
     @Environment(\.appDensity) private var appDensity
+    @Environment(\.accessibilityReduceMotion) private var reduceMotion
     @State private var didCopy = false
     /// Grows with Dynamic Type. The `max(_, minimumTapTarget)` floor matters
         Button {
             AppClipboard.copy(value)
             AppHaptics.copy()
-            withAnimation(.easeInOut(duration: 0.18)) {
+            withAnimation(reduceMotion ? nil : .easeInOut(duration: 0.18)) {
                 didCopy = true
             }
             Task {
                 try? await Task.sleep(nanoseconds: 900_000_000)
                 await MainActor.run {
-                    withAnimation(.easeInOut(duration: 0.18)) {
+                    withAnimation(reduceMotion ? nil : .easeInOut(duration: 0.18)) {
                         didCopy = false
                     }
                 }
 struct CollapsibleSectionView<HeaderTrailing: View, Content: View>: View {
     @Environment(\.appDensity) private var appDensity
+    @Environment(\.accessibilityReduceMotion) private var reduceMotion
     let title: String
     @Binding var isCollapsed: Bool
     var body: some View {
         VStack(alignment: .leading, spacing: appDensity.metrics.cardSpacing) {
             Button {
-                withAnimation(.easeInOut(duration: 0.2)) {
+                withAnimation(reduceMotion ? nil : .easeInOut(duration: 0.2)) {
                     isCollapsed.toggle()
                 }
             } label: {

DomainDig/TimelineView.swift +2 −1

 }
 struct TimelineDiffView: View {
+    @Environment(\.accessibilityReduceMotion) private var reduceMotion
     @Bindable var viewModel: DomainViewModel
     let diff: DomainDiff
     @Binding var focusedSectionID: String?
     private func scroll(proxy: ScrollViewProxy) {
         guard let focusedSectionID else { return }
-        withAnimation {
+        withAnimation(reduceMotion ? nil : .default) {
             proxy.scrollTo(focusedSectionID, anchor: .top)
         }
     }

DomainDig/WatchlistView.swift +2 −1

 struct WatchlistView: View {
     @Environment(\.appDensity) private var appDensity
+    @Environment(\.accessibilityReduceMotion) private var reduceMotion
     @Bindable var viewModel: DomainViewModel
     @Environment(\.dismiss) private var dismiss
     @State private var purchaseService = PurchaseService.shared
                 }
             }
         }
-        .animation(.easeInOut(duration: 0.2), value: viewModel.filteredTrackedDomains.map(\.id))
+        .animation(reduceMotion ? nil : .easeInOut(duration: 0.2), value: viewModel.filteredTrackedDomains.map(\.id))
         .scrollContentBackground(.hidden)
         .background(Color(.appBackground))
         .navigationTitle("Watchlist")

DomainDigWidget/DomainDigPortfolioWidget.swift +21 −8

             Spacer(minLength: 0)
             HStack(spacing: 10) {
-                countPill(data.healthyCount, Color(.statusPositive), "healthy")
+                countPill(data.healthyCount, .healthy, "healthy")
-                countPill(data.warningCount, Color(.statusWarning), "warning")
+                countPill(data.warningCount, .warning, "warning")
-                countPill(data.criticalCount, Color(.statusCritical), "critical")
+                countPill(data.criticalCount, .critical, "critical")
             }
         }
     }
-    private func countPill(_ value: Int, _ color: Color, _ label: String) -> some View {
+    private func countPill(_ value: Int, _ status: DomainDigWidgetStatus, _ label: String) -> some View {
         HStack(spacing: 3) {
-            Circle().fill(color).frame(width: 7, height: 7)
+            Image(systemName: symbol(for: status))
+                .font(.caption2)
+                .foregroundStyle(color(for: status))
             Text("\(value)").font(.caption).fontWeight(.medium)
         }
         // A coloured dot and a number say nothing on their own.
     private func domainRow(_ domain: DomainDigWidgetDomain) -> some View {
         HStack(spacing: 6) {
-            Circle()
+            Image(systemName: symbol(for: domain.status))
-                .fill(color(for: domain.status))
+                .font(.caption2)
-                .frame(width: 8, height: 8)
+                .foregroundStyle(color(for: domain.status))
             if domain.isPinned {
                 Image(systemName: "pin.fill")
                     .font(.caption2)
         case .critical: return Color(.statusCritical)
         }
     }
+    /// Same symbol vocabulary as the in-app badges, so status survives without
+    /// colour (Differentiate Without Color, greyscale, colour-blind viewers) and
+    /// reads consistently across surfaces.
+    private func symbol(for status: DomainDigWidgetStatus) -> String {
+        switch status {
+        case .healthy: return "checkmark.circle.fill"
+        case .warning: return "exclamationmark.triangle.fill"
+        case .critical: return "exclamationmark.octagon.fill"
+        }
+    }
 }

Commit c220e26bb4

Commit `c220e26bb4`