punktfunk/clients/apple/Sources/PunktfunkClient/Settings/SettingsOptions.swift

// The option lists every settings surface renders from — one source of truth shared by the
// touch/desktop SettingsView (Pickers), the tvOS pushed selection rows, and the gamepad settings
// screen (GamepadSettingsView's left/right cycling). Pure data + small pure helpers; anything that
// reads live view state (e.g. the bitrate slider mapping) stays on SettingsView.

#if os(macOS)
import AppKit
#endif
import PunktfunkKit
import SwiftUI

enum SettingsOptions {
    /// Compositor choices — the `tag` is the wire value (`PunktfunkConnection.Compositor` raw).
    static let compositors: [(label: String, tag: Int)] = [
        ("Automatic", 0),
        ("KWin (KDE Plasma)", 1),
        ("wlroots (Sway / Hyprland)", 2),
        ("Mutter (GNOME)", 3),
        ("gamescope", 4),
    ]

    static let audioChannels: [(label: String, tag: Int)] = [
        ("Stereo", 2),
        ("5.1 Surround", 6),
        ("7.1 Surround", 8),
    ]

    /// Virtual-pad types — the `tag` is the wire value (`PunktfunkConnection.GamepadType` raw).
    static let padTypes: [(label: String, tag: Int)] = [
        ("Automatic", 0),
        ("Xbox 360", 1),
        ("Xbox One", 3),
        ("DualSense", 2),
        ("DualShock 4", 4),
    ]

    /// System-button routing (the cross-client `system_buttons` key): where the guide
    /// (Xbox/PS) and share presses land while streaming. Auto = forward on Apple.
    static let systemButtons: [(label: String, tag: String)] = [
        ("Automatic", "auto"),
        ("Send to host", "forward"),
        ("This device", "local"),
    ]

    /// The hold-Select guide gesture (the cross-client `guide_gesture` key). Auto = on
    /// everywhere but macOS.
    static let guideGestures: [(label: String, tag: String)] = [
        ("Automatic", "auto"),
        ("On", "on"),
        ("Off", "off"),
    ]

    static let hudPlacements: [(label: String, tag: String)] =
        HUDPlacement.allCases.map { ($0.label, $0.rawValue) }

    /// When the gamepad UI takes over (`DefaultsKey.gamepadUIMode`) — only meaningful while
    /// `gamepadUIEnabled` is on, so every surface that offers it hides the row when the switch
    /// is off rather than showing a picker that decides nothing.
    static let gamepadUIModes: [(label: String, tag: String)] = [
        ("With a controller", GamepadUIEnvironment.modeWhenConnected),
        ("Always", GamepadUIEnvironment.modeAlways),
    ]

    /// Presentation intent (`DefaultsKey.presentPriority` — the 2026-07 rebuild that replaced
    /// the visible stage picker with intent; see SessionPresenter's PresentPriority and
    /// design/apple-presentation-rebuild.md). The stage ladder survives only as the hidden
    /// PUNKTFUNK_PRESENTER debug env lever.
    static let presentPriorities: [(label: String, tag: String)] = [
        ("Lowest latency", "latency"),
        ("Smoothness", "smooth"),
    ]
    static let presentPriorityDefault = "latency"

    /// Smoothness's jitter-buffer sizes (`DefaultsKey.smoothBuffer`; 0 = Automatic, currently 2
    /// frames). The ms hints derive from the chosen refresh setting — each buffered frame costs
    /// about one refresh interval of display latency and absorbs about one interval of arrival
    /// jitter.
    static func smoothBuffers(refreshHz: Int) -> [(label: String, tag: Int)] {
        let periodMs = 1000.0 / Double(max(24, refreshHz))
        func hint(_ frames: Int) -> String {
            String(format: "+%.0f ms", Double(frames) * periodMs)
        }
        return [
            ("Automatic", 0),
            ("1 frame (\(hint(1)))", 1),
            ("2 frames (\(hint(2)))", 2),
            ("3 frames (\(hint(3)))", 3),
        ]
    }

    /// Stats-overlay tiers (`DefaultsKey.statsVerbosity`) — the `tag` is the raw value.
    static let statsVerbosities: [(label: String, tag: String)] =
        StatsVerbosity.allCases.map { ($0.label, $0.rawValue) }

    /// Video-codec preference (`DefaultsKey.codec`) — a soft preference the host falls back from.
    /// AV1 appears only on devices with an AV1 hardware decoder (the same
    /// `AV1.hardwareDecodeSupported` gate SessionModel advertises by) — elsewhere it would be a
    /// dead setting the host could never honor. Ordered by the host's resolve precedence
    /// (HEVC > AV1 > H.264).
    static let codecs: [(label: String, tag: String)] = {
        var options: [(label: String, tag: String)] = [
            ("Automatic", "auto"),
            ("HEVC (H.265)", "hevc"),
            ("H.264 (AVC)", "h264"),
        ]
        if AV1.hardwareDecodeSupported {
            options.insert(("AV1", "av1"), at: 2)
        }
        // PyroWave is the opt-in wired-LAN low-latency codec (100–400 Mbps all-intra wavelet,
        // 8-bit SDR): selecting it advertises + prefers it for the session. Offered only when
        // the Metal decode probe passes (same gate SessionModel advertises by) — elsewhere the
        // host could never emit it.
        if MetalWaveletDecoder.supported {
            options.append(("PyroWave (wired LAN)", "pyrowave"))
        }
        return options
    }()

    // MARK: - Bitrate

    /// Discrete bitrate steps for the surfaces with no Slider (tvOS pushed pickers, the gamepad
    /// settings' left/right cycling), up to the same 3 Gbps ceiling the slider has.
    static let bitratePresets: [(label: String, tag: Int)] = [
        ("Automatic", 0),
        ("10 Mbps", 10_000),
        ("20 Mbps", 20_000),
        ("40 Mbps", 40_000),
        ("80 Mbps", 80_000),
        ("150 Mbps", 150_000),
        ("300 Mbps", 300_000),
        ("500 Mbps", 500_000),
        ("1 Gbps", 1_000_000),
        ("1.5 Gbps", 1_500_000),
        ("2 Gbps", 2_000_000),
        ("3 Gbps", 3_000_000),
    ]

    /// The presets plus the currently stored value when it isn't one of them (set via the touch
    /// slider or a synced device) — so the current choice stays visible/selectable.
    static func bitrateOptions(current: Int) -> [(label: String, tag: Int)] {
        var options = bitratePresets
        if !options.contains(where: { $0.tag == current }) {
            options.insert(
                (SpeedTestSheet.mbpsLabel(kbps: current) + " (custom)", current), at: 1)
        }
        return options
    }

    // MARK: - Controllers

    /// "Use controller" choices: Automatic, every forwardable controller, and — so a stale pin
    /// stays visible instead of leaving the selection tag-less — any pinned id that is NOT among
    /// the selectable (extended) entries, present-but-unusable included.
    @MainActor
    static func controllerOptions(_ gamepads: GamepadManager) -> [(label: String, tag: String)] {
        let selectable = gamepads.controllers.filter(\.isExtended)
        var options: [(label: String, tag: String)] = [("Automatic", "")]
        options += selectable.map { ($0.name, $0.id) }
        if !gamepads.preferredID.isEmpty,
           !selectable.contains(where: { $0.id == gamepads.preferredID }) {
            options.append(("Unavailable controller", gamepads.preferredID))
        }
        return options
    }

    // MARK: - Stream mode (iOS/macOS pickers + the gamepad settings rows on all three; the
    // touch/remote tvOS SettingsView builds its own preset list)

    /// 16:9 then ultrawide presets; the device's native mode is prepended by `resolutionModes`.
    static let resolutionPresets: [(name: String, w: Int, h: Int)] = [
        ("720p", 1280, 720),
        ("1080p", 1920, 1080),
        ("1440p", 2560, 1440),
        ("4K", 3840, 2160),
        ("Ultrawide 1080p", 2560, 1080),
        ("Ultrawide 1440p", 3440, 1440),
        ("Super ultrawide", 5120, 1440),
    ]

    /// This device's native mode first, then the presets, deduped by dimensions (native wins a
    /// tie).
    ///
    /// On iOS the native row is followed by its **safe-area** variant, which is the same mode
    /// narrowed so the picture clears the sensor housing and the rounded corners — see
    /// [`SafeDisplay`] for why a narrower mode is the whole fix. It is emitted unconditionally and
    /// left to the dedup below: on a device with no housing the two modes are identical, the
    /// duplicate is dropped, and no pointless row appears.
    @MainActor
    static func resolutionModes() -> [(name: String, w: Int, h: Int)] {
        var native: [(name: String, w: Int, h: Int)] = []
        #if os(iOS) || os(tvOS)
        let bounds = UIScreen.main.nativeBounds // portrait-oriented pixels (tvOS: the TV mode)
        let nativeW = Int(max(bounds.width, bounds.height))
        let nativeH = Int(min(bounds.width, bounds.height))
        native = [("This device", nativeW, nativeH)]
        #if os(iOS)
        let safe = SafeDisplay.mode(
            nativeWidth: nativeW, nativeHeight: nativeH,
            sideInsetPoints: mainWindowSideInset(), scale: UIScreen.main.nativeScale)
        native.append(("This device (safe area)", safe.width, safe.height))
        #endif
        #else
        if let screen = NSScreen.main {
            let scale = screen.backingScaleFactor
            native = [("This display",
                       Int(screen.frame.width * scale),
                       Int(screen.frame.height * scale))]
        }
        #endif
        var seen = Set<String>()
        return (native + resolutionPresets).filter { seen.insert("\($0.w)x\($0.h)").inserted }
    }

    #if os(iOS)
    /// The key window's per-side safe-area inset in points, resolved for the LANDSCAPE stream even
    /// when this settings screen is currently portrait (see `SafeDisplay.sideInsetPoints`).
    ///
    /// Zero when no window is up yet — the safe mode then equals the native one and `resolutionModes`
    /// dedups the row away, which is the right answer for a device we can't measure.
    @MainActor
    private static func mainWindowSideInset() -> Double {
        let insets = UIApplication.shared.connectedScenes
            .compactMap { $0 as? UIWindowScene }
            .flatMap(\.windows)
            .first { $0.isKeyWindow }?
            .safeAreaInsets
        guard let insets else { return 0 }
        return SafeDisplay.sideInsetPoints(
            left: Double(insets.left), right: Double(insets.right), top: Double(insets.top),
            isPhone: UIDevice.current.userInterfaceIdiom == .phone)
    }
    #endif

    /// Refresh rates the device can actually display (no point asking the host to render frames
    /// the screen can't show), plus any stored custom value so it stays selectable.
    @MainActor
    static func refreshRates(including current: Int) -> [Int] {
        #if os(iOS) || os(tvOS)
        let maxHz = UIScreen.main.maximumFramesPerSecond
        #else
        let maxHz = NSScreen.main?.maximumFramesPerSecond ?? 60
        #endif
        var rates = [60, 120, 240].filter { $0 <= maxHz }
        if rates.isEmpty { rates = [maxHz] }
        if !rates.contains(current) { rates.append(current) }
        return rates.sorted()
    }
}