Watch: snapshot tests render the complication and multi-select screenshots

ImageRenderer draws the real views with demo data, since the watch simulator
is not drivable here. README covers the widget target and how to add it.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

watch/WristCodeWidget/WaitingView.swift

@@ -1,12 +1,43 @@
 // One view per complication family, in mock B's colors: amber when something needs you, teal for
 // work in progress, and nothing that animates. Tinted faces use the accented parts only.
+//
+// The app target compiles this file too, so the snapshot tests can render the complication.
 
 import SwiftUI
 import WidgetKit
 
+struct WaitingEntry: TimelineEntry {
+    enum Content: Equatable {
+        /// Counts from the gateway. `stale` when they are the last ones seen because the gateway
+        /// could not be reached.
+        case counts(Summary, stale: Bool)
+        case notPaired
+        /// The gateway could not be reached and there is nothing saved to show.
+        case unavailable
+    }
+
+    var date: Date
+    var content: Content
+
+    /// Ranks the complication higher in the Smart Stack while something waits.
+    var relevance: TimelineEntryRelevance? {
+        guard case let .counts(summary, _) = content, summary.needsYou > 0 else { return nil }
+        return TimelineEntryRelevance(score: Float(summary.needsYou))
+    }
+
+    static let sample = WaitingEntry(date: .now, content: .counts(Summary(
+        needsYou: 2, working: 3,
+        next: .init(hostId: "mac-mini", threadId: "t-ocr", title: "Receipt OCR", hostLabel: "Mac mini"),
+        hostsOffline: 0), stale: false))
+}
+
 struct WaitingView: View {
-    @Environment(\.widgetFamily) private var family
+    @Environment(\.widgetFamily) private var widgetFamily
     var entry: WaitingEntry
+    /// Overrides the environment's family, for rendering outside a widget.
+    var familyOverride: WidgetFamily?
+
+    private var family: WidgetFamily { familyOverride ?? widgetFamily }
 
     var body: some View {
         content
@@ -179,39 +210,3 @@ struct WaitingView: View {
         }
     }
 }
-
-private func entry(_ needsYou: Int, _ working: Int, next: Bool = true) -> WaitingEntry {
-    let thread = Summary.Next(hostId: "mac-mini", threadId: "t-ocr", title: "Receipt OCR", hostLabel: "Mac mini")
-    return WaitingEntry(date: .now, content: .counts(
-        Summary(needsYou: needsYou, working: working, next: needsYou > 0 && next ? thread : nil, hostsOffline: 1),
-        stale: false))
-}
-
-#Preview("Circular", as: .accessoryCircular) {
-    WaitingWidget()
-} timeline: {
-    entry(2, 3)
-    entry(0, 3)
-    WaitingEntry(date: .now, content: .notPaired)
-}
-
-#Preview("Rectangular", as: .accessoryRectangular) {
-    WaitingWidget()
-} timeline: {
-    entry(2, 3)
-    entry(0, 3)
-    WaitingEntry(date: .now, content: .notPaired)
-}
-
-#Preview("Inline", as: .accessoryInline) {
-    WaitingWidget()
-} timeline: {
-    entry(2, 3)
-}
-
-#Preview("Corner", as: .accessoryCorner) {
-    WaitingWidget()
-} timeline: {
-    entry(2, 3)
-    entry(0, 3)
-}

watch/WristCodeWidget/WaitingWidget.swift

@@ -23,31 +23,6 @@ struct WaitingWidget: Widget {
     }
 }
 
-struct WaitingEntry: TimelineEntry {
-    enum Content: Equatable {
-        /// Counts from the gateway. `stale` when they are the last ones seen because the gateway
-        /// could not be reached.
-        case counts(Summary, stale: Bool)
-        case notPaired
-        /// The gateway could not be reached and there is nothing saved to show.
-        case unavailable
-    }
-
-    var date: Date
-    var content: Content
-
-    /// Ranks the complication higher in the Smart Stack while something waits.
-    var relevance: TimelineEntryRelevance? {
-        guard case let .counts(summary, _) = content, summary.needsYou > 0 else { return nil }
-        return TimelineEntryRelevance(score: Float(summary.needsYou))
-    }
-
-    static let sample = WaitingEntry(date: .now, content: .counts(Summary(
-        needsYou: 2, working: 3,
-        next: .init(hostId: "mac-mini", threadId: "t-ocr", title: "Receipt OCR", hostLabel: "Mac mini"),
-        hostsOffline: 0), stale: false))
-}
-
 struct WaitingProvider: TimelineProvider {
     /// How long until WidgetKit asks again. The app reloads sooner when it learns something.
     static let refreshInterval: TimeInterval = 15 * 60
@@ -92,3 +67,39 @@ struct WaitingProvider: TimelineProvider {
         }
     }
 }
+
+private func entry(_ needsYou: Int, _ working: Int, next: Bool = true) -> WaitingEntry {
+    let thread = Summary.Next(hostId: "mac-mini", threadId: "t-ocr", title: "Receipt OCR", hostLabel: "Mac mini")
+    return WaitingEntry(date: .now, content: .counts(
+        Summary(needsYou: needsYou, working: working, next: needsYou > 0 && next ? thread : nil, hostsOffline: 1),
+        stale: false))
+}
+
+#Preview("Circular", as: .accessoryCircular) {
+    WaitingWidget()
+} timeline: {
+    entry(2, 3)
+    entry(0, 3)
+    WaitingEntry(date: .now, content: .notPaired)
+}
+
+#Preview("Rectangular", as: .accessoryRectangular) {
+    WaitingWidget()
+} timeline: {
+    entry(2, 3)
+    entry(0, 3)
+    WaitingEntry(date: .now, content: .notPaired)
+}
+
+#Preview("Inline", as: .accessoryInline) {
+    WaitingWidget()
+} timeline: {
+    entry(2, 3)
+}
+
+#Preview("Corner", as: .accessoryCorner) {
+    WaitingWidget()
+} timeline: {
+    entry(2, 3)
+    entry(0, 3)
+}