SportMode - Loop Glance complications

Common/FeatureFlags.swift

@@ -40,6 +40,7 @@ struct FeatureFlagConfiguration: Decodable {
     let allowAlgorithmExperiments: Bool
     let isInvestigationalDevice: Bool
     let devBranchWarningEnabled: Bool
+    let sportModeEnabled: Bool
 
     fileprivate init() {
         // Swift compiler config is inverse, since the default state is enabled.
@@ -239,6 +240,12 @@ struct FeatureFlagConfiguration: Decodable {
         #else
         self.devBranchWarningEnabled = true
         #endif
+
+        #if SPORT_MODE_ENABLED
+        self.sportModeEnabled = true
+        #else
+        self.sportModeEnabled = false
+        #endif
     }
 }
 
@@ -260,6 +267,7 @@ extension FeatureFlagConfiguration : CustomDebugStringConvertible {
             "* observeHealthKitGlucoseSamplesFromOtherApps: \(observeHealthKitGlucoseSamplesFromOtherApps)",
             "* predictedGlucoseChartClampEnabled: \(predictedGlucoseChartClampEnabled)",
             "* remoteCommandsEnabled: \(remoteCommandsEnabled)",
+            "* sportModeEnabled: \(sportModeEnabled)",
             "* scenariosEnabled: \(scenariosEnabled)",
             "* showEventualBloodGlucoseOnWatchEnabled: \(showEventualBloodGlucoseOnWatchEnabled)",
             "* simulatedCoreDataEnabled: \(simulatedCoreDataEnabled)",

Common/Models/BuildDetails+SportMode.swift

@@ -0,0 +1,26 @@
+//
+//  BuildDetails+SportMode.swift
+//  Loop
+//
+//  Copyright © 2026 LoopKit Authors. All rights reserved.
+//
+//  Sport Mode's build identity, shown on both devices and sent with a loan request.
+//
+
+import Foundation
+
+extension BuildDetails {
+    /// The workspace commit plus build date and time: the same on phone and watch when built
+    /// together. CFBundleVersion is pinned, so it cannot tell builds apart.
+    var codeIdentity: String {
+        let sha = (dict["com-loopkit-Loop-commit-sha"] as? String)
+            ?? (dict["com-loopkit-LoopWorkspace-git-revision"] as? String)
+            ?? gitRevision
+        guard let sha else { return "sha?" }
+        // "Wed Aug 19 15:59:38 EDT 2026" -> "Aug19 15:59".
+        let parts = (dict["com-loopkit-Loop-build-date"] as? String)?
+            .split(separator: " ").map(String.init) ?? []
+        let stamp = parts.count >= 4 ? " \(parts[1])\(parts[2]) \(parts[3].prefix(5))" : ""
+        return sha + stamp
+    }
+}

Loop Complications/ComplicationSnapshot.swift

@@ -0,0 +1,133 @@
+//
+//  ComplicationSnapshot.swift
+//  Loop Complications
+//
+//  What the watch's complications show, published by the watch app into the shared app group and
+//  read by the Loop Complications widget extension. Compiled into both (and into LoopTests). Strings
+//  arrive already formatted and localized by the app — the extension links nothing of Loop's — so
+//  the widget only decides, per moment, which of them to show.
+//
+
+import Foundation
+
+struct ComplicationSnapshot: Codable, Equatable {
+    /// The reading, formatted for the display unit, or the sensor's condition ("LOW", "HIGH").
+    var glucoseText: String?
+    var trendSymbol: String?
+    /// Shown in place of the reading once it is stale (stock's localized "---").
+    var staleGlucoseText: String = "---"
+    /// After this, the reading is stale (stock: reading date + LoopAlgorithm.inputDataRecencyInterval).
+    var glucoseStaleAt: Date?
+    var eventualText: String?
+    /// The wide inline line in stock's localized "UtilitarianLargeFlat" format
+    /// ("106↗ 108 8:47 PM"), and the same line with the reading stale.
+    var inlineText: String?
+    var inlineStaleText: String?
+    /// When the loop last completed, and where its colour changes (LoopCompletionFreshness: fresh ≤ 6 min,
+    /// aging ≤ 16 min, then stale) — computed by the app so the constants live in one place.
+    var loopDate: Date?
+    var freshUntil: Date?
+    var agingUntil: Date?
+    /// When the glucose graph image beside this snapshot was rendered (nil: no graph).
+    var graphRenderedAt: Date?
+
+    enum Freshness { case fresh, aging, stale }
+
+    func freshness(at date: Date) -> Freshness {
+        guard loopDate != nil else { return .stale }
+        if let fresh = freshUntil, date <= fresh { return .fresh }
+        if let aging = agingUntil, date <= aging { return .aging }
+        return .stale
+    }
+
+    func glucoseIsStale(at date: Date) -> Bool {
+        glucoseStaleAt.map { date > $0 } ?? true
+    }
+
+    /// The reading as shown at `date`: the value, or the stale marker.
+    func glucose(at date: Date) -> String {
+        glucoseIsStale(at: date) ? staleGlucoseText : (glucoseText ?? staleGlucoseText)
+    }
+
+    /// The trend symbol, blank once the reading is stale (as stock).
+    func trend(at date: Date) -> String {
+        glucoseIsStale(at: date) ? "" : (trendSymbol ?? "")
+    }
+
+    func inline(at date: Date) -> String {
+        (glucoseIsStale(at: date) ? inlineStaleText : inlineText) ?? glucose(at: date)
+    }
+
+    /// The moments after `date` at which something visible changes: the reading goes stale, the loop
+    /// colour turns. The widget's timeline carries one entry for each, so no reload is needed for them.
+    func changeMoments(after date: Date) -> [Date] {
+        [glucoseStaleAt.map { $0.addingTimeInterval(1) }, freshUntil.map { $0.addingTimeInterval(1) },
+         agingUntil.map { $0.addingTimeInterval(1) }]
+            .compactMap { $0 }.filter { $0 > date }.sorted()
+    }
+
+    // MARK: - Shared storage
+
+    static let defaultsKey = "ComplicationSnapshot"
+    static let graphFileName = "ComplicationGlucoseGraph.png"
+
+    /// The app group both targets share, from each one's own Info.plist.
+    static var appGroupIdentifier: String? {
+        Bundle.main.object(forInfoDictionaryKey: "AppGroupIdentifier") as? String
+    }
+
+    static var sharedDefaults: UserDefaults? { appGroupIdentifier.flatMap { UserDefaults(suiteName: $0) } }
+
+    static var graphURL: URL? {
+        appGroupIdentifier
+            .flatMap { FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: $0) }?
+            .appendingPathComponent(graphFileName)
+    }
+
+    static func load(from defaults: UserDefaults? = sharedDefaults) -> ComplicationSnapshot? {
+        defaults?.data(forKey: defaultsKey).flatMap { try? JSONDecoder().decode(Self.self, from: $0) }
+    }
+
+    func save(to defaults: UserDefaults? = Self.sharedDefaults) {
+        if let data = try? JSONEncoder().encode(self) { defaults?.set(data, forKey: Self.defaultsKey) }
+    }
+
+    static var sample: ComplicationSnapshot {
+        let now = Date()
+        return ComplicationSnapshot(glucoseText: "106", trendSymbol: "↗", glucoseStaleAt: now.addingTimeInterval(15 * 60),
+                                    eventualText: "108", inlineText: "106↗ 108", inlineStaleText: "--- 108",
+                                    loopDate: now, freshUntil: now.addingTimeInterval(6 * 60),
+                                    agingUntil: now.addingTimeInterval(16 * 60), graphRenderedAt: nil)
+    }
+}
+
+/// The widget kinds, shared with the watch app (its ClockKit migrator maps old complications to them).
+enum LoopComplicationKind {
+    static let loopStatus = "LoopStatus"
+    static let glucoseGraph = "GlucoseGraph"
+
+    static let all = [loopStatus, glucoseGraph]
+}
+
+/// When the watch app should ask WidgetKit for a reload. Reloads are budgeted by the system, so one is
+/// requested only when the snapshot changed and at most every `minimumInterval`; a change inside the
+/// window is not lost — the owed reload is paid on the next offer once the window has passed.
+struct ComplicationReloadThrottle<Snapshot: Equatable> {
+    var minimumInterval: TimeInterval = 5 * 60
+    private(set) var lastPublished: Snapshot?
+    private(set) var lastReloadAt = Date.distantPast
+    private(set) var reloadOwed = false
+
+    /// `save`: the snapshot changed and should be written. `reload`: ask WidgetKit now.
+    mutating func offer(_ snapshot: Snapshot, now: Date) -> (save: Bool, reload: Bool) {
+        let changed = snapshot != lastPublished
+        if changed {
+            lastPublished = snapshot
+            reloadOwed = true
+        }
+        guard reloadOwed, now.timeIntervalSince(lastReloadAt) >= minimumInterval else { return (changed, false) }
+        reloadOwed = false
+        lastReloadAt = now
+        return (changed, true)
+    }
+}