feat(apple): gamepad ui

clients/apple/Sources/PunktfunkKit/GamepadUIEnvironment.swift

@@ -0,0 +1,20 @@
+// Whether the iOS/iPadOS UI should be in its controller-friendly mode (larger focus targets on
+// the host grid, the coverflow library browser instead of the plain grid). A pure function, not a
+// singleton: the reactivity comes from callers already observing `GamepadManager.shared` and the
+// `DefaultsKey.gamepadUIEnabled` @AppStorage themselves (the same local-read pattern SettingsView
+// already uses for GamepadManager), so this stays the single place the two combine without adding
+// a second ObservableObject or an environment key nobody else needs.
+
+import Foundation
+
+public enum GamepadUIEnvironment {
+    /// `enabledSetting` is the user's Settings toggle (`DefaultsKey.gamepadUIEnabled`);
+    /// `gamepadConnected` is `GamepadManager.shared.active != nil` — active only once a usable
+    /// controller is actually attached (a non-extended-profile device leaves `active` nil, which
+    /// keeps the touch UI). A `Bool` rather than the `DiscoveredController` itself: this function's
+    /// whole job is the AND, so there's nothing else to inspect, and it keeps the helper testable
+    /// without a real `GCController` (which XCTest can't construct).
+    public static func isActive(gamepadConnected: Bool, enabledSetting: Bool) -> Bool {
+        enabledSetting && gamepadConnected
+    }
+}