fuelboard/FuelBoardWidgets/FuelBoardLiveActivityView.swift

// FuelBoardLiveActivityView.swift — renders the FuelBoard Live Activity.
//
// Lives in the widget extension (the standard host for ActivityConfiguration).
// Shows the cheapest station for the pinned fuel within the app's chosen
// radius. Tapping anywhere opens Apple Maps directions to that station.
//
// ADAPTIVE LAYOUT: the Lock Screen body provides two layouts and lets
// ViewThatFits pick by available width, but the narrow `.small` family is NOT
// declared (see note on the config), so iPhone/iPad always render the full
// three-column card (`richBody`) with proper text sizes. `compactBody` is kept
// as a safety fallback should any surface ever hand this view a narrow width.
//
// IMPORTANT: `.supplementalActivityFamilies([.small])` is deliberately absent —
// it made iOS render the squeezed `.small` card on the iPhone Lock Screen.
// CarPlay's small form comes from the Dynamic Island compact closures.

import ActivityKit
import SwiftUI
import WidgetKit

/// The Live Activity itself — registered in the widget bundle alongside the
/// regular price widget. No CarPlay entitlement involved: renders on the
/// Lock Screen (full-width card on iPhone/iPad) and the Dynamic Island
/// (incl. the island's compact form used in the car, display-only — FuelBoard
/// is not a CarPlay-enabled app, so car-side taps can't launch anything).
struct FuelBoardLiveActivity: Widget {
    var body: some WidgetConfiguration {
        ActivityConfiguration(for: FuelBoardLiveActivityAttributes.self) { context in
            // Lock Screen / banner / CarPlay small slot presentation
            FuelBoardLiveActivityView(context: context)
        } dynamicIsland: { context in
            DynamicIsland {
                DynamicIslandExpandedRegion(.leading) {
                    FuelBoardLiveActivityCompactView(context: context)
                }
                DynamicIslandExpandedRegion(.trailing) {
                    FuelBoardLiveActivityPriceView(context: context)
                }
                DynamicIslandExpandedRegion(.bottom) {
                    FuelBoardLiveActivityStationView(context: context)
                }
            } compactLeading: {
                Image(systemName: "fuelpump.fill")
                    .foregroundStyle(.green)
            } compactTrailing: {
                FuelBoardLiveActivityPriceView(context: context)
            } minimal: {
                Text(context.state.priceText)
                    .font(.caption2.bold().monospacedDigit())
            }
        }
        // NOTE: deliberately NO `.supplementalActivityFamilies([.small])`.
        // That modifier makes iOS eligible to render this activity in the
        // narrow `.small` form on the iPhone/iPad Lock Screen, which is what
        // produced the squeezed, small-text card. Dropping it keeps the
        // full-width Lock Screen card on iPhone/iPad; CarPlay still shows a
        // small form via the Dynamic Island compact closures below.
    }
}

/// Lock Screen / banner / CarPlay body — adaptive.
private struct FuelBoardLiveActivityView: View {
    let context: ActivityViewContext<FuelBoardLiveActivityAttributes>

    var body: some View {
        Link(destination: context.state.mapsURL) {
            // Always the full three-column card. The station caption is
            // line-limited + scale-down + tail-truncated, so a LONG station
            // name truncates in place instead of inflating this view's ideal
            // width and tricking ViewThatFits into falling back to the compact
            // strip (that is exactly what made 5-mi / long-named activities
            // render small while 10-15-mi / short names stayed full).
            //
            // No ViewThatFits / compactBody: with `.supplementalActivityFamilies`
            // removed, this body is only ever handed Lock-Screen width, so the
            // compact fallback was both dead weight and the cause of the bug.
            richBody
        }
    }

    /// Full three-column design (unchanged): brand glyph · fuel+station · price.
    private var richBody: some View {
        HStack(spacing: 12) {
            // LEFT — station brand glyph
            Image(systemName: "fuelpump.circle.fill")
                .font(.system(size: 32))
                .foregroundStyle(.green, .white)
                .frame(width: 40, height: 40)

            // MIDDLE — fuel + station
            VStack(alignment: .leading, spacing: 2) {
                Text("Cheapest \(context.state.fuel.displayName)")
                    .font(.headline)
                Text("\(context.state.stationName) · \(context.state.distanceText)")
                    .font(.subheadline)
                    .foregroundStyle(.secondary)
                    .lineLimit(1)
                    .minimumScaleFactor(0.75)
                    .truncationMode(.tail)
            }
            .frame(maxWidth: .infinity, alignment: .leading)

            // RIGHT — price
            VStack(alignment: .trailing, spacing: 2) {
                FuelStore.priceTextAttributed(context.state.pricePence,
                                               style: context.state.priceDisplayStyle,
                                               size: 22, weight: .bold)
                Text("Tap for directions")
                    .font(.caption2)
                    .foregroundStyle(.secondary)
            }
        }
        .padding()
    }

    // NOTE: `compactBody` was removed — always render `richBody` (see body).
}

/// Dynamic Island expanded regions + compact trailing — price only.
private struct FuelBoardLiveActivityPriceView: View {
    let context: ActivityViewContext<FuelBoardLiveActivityAttributes>

    var body: some View {
        FuelStore.priceTextAttributed(context.state.pricePence,
                                      style: context.state.priceDisplayStyle,
                                      size: 17, weight: .bold)
    }
}

/// Dynamic Island expanded — fuel + station name.
private struct FuelBoardLiveActivityCompactView: View {
    let context: ActivityViewContext<FuelBoardLiveActivityAttributes>

    var body: some View {
        VStack(alignment: .leading, spacing: 2) {
            Text("Cheapest \(context.state.fuel.displayName)")
                .font(.caption2)
                .foregroundStyle(.secondary)
            Text(context.state.stationName)
                .font(.caption.bold())
                .lineLimit(1)
        }
    }
}

/// Dynamic Island expanded bottom — station + distance.
private struct FuelBoardLiveActivityStationView: View {
    let context: ActivityViewContext<FuelBoardLiveActivityAttributes>

    var body: some View {
        Text("\(context.state.stationName) · \(context.state.distanceText)")
            .font(.caption)
            .lineLimit(1)
    }
}

// MARK: - ContentState display helpers

extension FuelBoardLiveActivityAttributes.ContentState {
    /// Display distance using the user's chosen unit (miles default).
    var distanceText: String {
        FuelStore.loadDistanceUnit().format(distanceKM)
    }

    /// Price string from pence, in the user's chosen display style
    /// (station sign "129.9" or pounds "£1.29⁹/L"). Uses the style captured
    /// in the state at push time.
    var priceText: String {
        FuelStore.priceText(pricePence, style: priceDisplayStyle)
    }

    /// Apple Maps directions URL to the pinned station.
    var mapsURL: URL {
        URL(string: "maps://?daddr=\(lat),\(lng)&t=d")!
    }
}