Add kiosk mode core infrastructure (PR 1/5)

Sources/App/Frontend/Extensions/WebViewController+Kiosk.swift

@@ -0,0 +1,229 @@
+import Combine
+import Shared
+import SwiftUI
+import UIKit
+
+// MARK: - Kiosk Mode Extension
+
+extension WebViewController {
+    /// Setup kiosk mode integration with KioskModeManager
+    /// Call this from viewDidLoad
+    func setupKioskMode() {
+        let manager = KioskModeManager.shared
+
+        // Wire up callbacks from KioskModeManager
+        manager.onNavigate = { [weak self] path in
+            self?.navigateToKioskPath(path)
+        }
+
+        manager.onRefresh = { [weak self] in
+            self?.refresh()
+        }
+
+        manager.onKioskModeChange = { [weak self] enabled in
+            self?.updateKioskModeLockdown(enabled: enabled)
+        }
+
+        manager.onShowScreensaver = { [weak self] mode in
+            self?.showScreensaver(mode: mode)
+        }
+
+        manager.onHideScreensaver = { [weak self] in
+            self?.hideScreensaver()
+        }
+
+        // Observe kiosk mode and settings changes using Combine (auto-cleanup on dealloc)
+        var cancellables = Set<AnyCancellable>()
+
+        manager.$isKioskModeActive
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] _ in
+                self?.kioskModeDidChange()
+            }
+            .store(in: &cancellables)
+
+        manager.$settings
+            .receive(on: DispatchQueue.main)
+            .sink { [weak self] _ in
+                self?.kioskSettingsDidChange()
+            }
+            .store(in: &cancellables)
+
+        kioskCancellables = cancellables
+
+        // Setup the screensaver
+        setupScreensaver()
+
+        // Setup secret exit gesture (only when not showing screensaver)
+        setupSecretExitGesture()
+
+        // Apply initial state if already in kiosk mode
+        if manager.isKioskModeActive {
+            updateKioskModeLockdown(enabled: true)
+        }
+    }
+
+    // MARK: - Screensaver
+
+    private func setupScreensaver() {
+        let controller = KioskScreensaverViewController()
+        screensaverController = controller
+
+        // Forward the callback for showing settings
+        controller.onShowSettings = { [weak self] in
+            self?.showKioskSettings()
+        }
+
+        addChild(controller)
+        view.addSubview(controller.view)
+        controller.view.translatesAutoresizingMaskIntoConstraints = false
+
+        NSLayoutConstraint.activate([
+            controller.view.topAnchor.constraint(equalTo: view.topAnchor),
+            controller.view.bottomAnchor.constraint(equalTo: view.bottomAnchor),
+            controller.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
+            controller.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
+        ])
+
+        controller.didMove(toParent: self)
+        controller.view.isHidden = true
+    }
+
+    private func setupSecretExitGesture() {
+        let controller = KioskSecretExitGestureViewController()
+        secretExitGestureController = controller
+
+        controller.onShowSettings = { [weak self] in
+            self?.showKioskSettings()
+        }
+
+        addChild(controller)
+        view.addSubview(controller.view)
+        controller.view.translatesAutoresizingMaskIntoConstraints = false
+
+        NSLayoutConstraint.activate([
+            controller.view.topAnchor.constraint(equalTo: view.topAnchor),
+            controller.view.bottomAnchor.constraint(equalTo: view.bottomAnchor),
+            controller.view.leadingAnchor.constraint(equalTo: view.leadingAnchor),
+            controller.view.trailingAnchor.constraint(equalTo: view.trailingAnchor),
+        ])
+
+        controller.didMove(toParent: self)
+    }
+
+    private func showScreensaver(mode: ScreensaverMode) {
+        guard let controller = screensaverController else { return }
+
+        Current.Log.info("Showing screensaver: \(mode.rawValue)")
+
+        controller.view.isHidden = false
+        view.bringSubviewToFront(controller.view)
+        controller.show(mode: mode)
+    }
+
+    private func hideScreensaver() {
+        guard let controller = screensaverController else { return }
+
+        Current.Log.info("Hiding screensaver")
+        controller.hide()
+
+        // Delay hiding the view until the animation completes
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
+            controller.view.isHidden = true
+        }
+    }
+
+    // MARK: - Navigation
+
+    private func navigateToKioskPath(_ path: String) {
+        Current.Log.info("Kiosk navigating to: \(path)")
+
+        // Use the existing navigateToPath method
+        navigateToPath(path: path)
+    }
+
+    // MARK: - UI Lockdown
+
+    private func updateKioskModeLockdown(enabled: Bool) {
+        let settings = KioskModeManager.shared.settings
+
+        // Update iOS system status bar and home indicator visibility
+        // The navigation controller must be updated first so it re-queries its child
+        if let navController = navigationController {
+            navController.setNeedsStatusBarAppearanceUpdate()
+            navController.setNeedsUpdateOfHomeIndicatorAutoHidden()
+        }
+        setNeedsStatusBarAppearanceUpdate()
+        setNeedsUpdateOfHomeIndicatorAutoHidden()
+
+        // Hide/show the custom status bar background view
+        if let statusBarView {
+            let shouldHide = enabled && settings.hideStatusBar
+            statusBarView.isHidden = shouldHide
+        }
+    }
+
+    // MARK: - Status Bar & Home Indicator
+
+    /// Override in WebViewController to check kiosk mode
+    var kioskPrefersStatusBarHidden: Bool {
+        let manager = KioskModeManager.shared
+        return manager.isKioskModeActive && manager.settings.hideStatusBar
+    }
+
+    /// Override in WebViewController to check kiosk mode
+    var kioskPrefersHomeIndicatorAutoHidden: Bool {
+        KioskModeManager.shared.isKioskModeActive
+    }
+
+    // MARK: - Settings
+
+    private func showKioskSettings() {
+        Current.Log.info("Showing kiosk settings")
+
+        // Use UINavigationController to avoid SwiftUI NavigationView dismissal bugs on iOS 15
+        // Pass an explicit dismiss closure since SwiftUI's @Environment(\.dismiss) doesn't work
+        // reliably when UIHostingController is embedded in UINavigationController presented via UIKit
+        let settingsView = KioskSettingsView(onDismiss: { [weak self] in
+            self?.dismiss(animated: true) { [weak self] in
+                self?.refreshStatusBarAppearance()
+            }
+        })
+        let hostingController = UIHostingController(rootView: settingsView)
+        let navController = UINavigationController(rootViewController: hostingController)
+        navController.modalPresentationStyle = .pageSheet
+        present(navController, animated: true)
+    }
+
+    /// Force a complete status bar appearance refresh after modal dismissal
+    private func refreshStatusBarAppearance() {
+        navigationController?.setNeedsStatusBarAppearanceUpdate()
+        setNeedsStatusBarAppearanceUpdate()
+        navigationController?.setNeedsUpdateOfHomeIndicatorAutoHidden()
+        setNeedsUpdateOfHomeIndicatorAutoHidden()
+    }
+
+    // MARK: - Observers
+
+    private func kioskModeDidChange() {
+        let manager = KioskModeManager.shared
+        Current.Log.info("Kiosk mode changed: \(manager.isKioskModeActive)")
+
+        updateKioskModeLockdown(enabled: manager.isKioskModeActive)
+    }
+
+    private func kioskSettingsDidChange() {
+        // Re-apply lockdown settings in case they changed
+        let manager = KioskModeManager.shared
+        if manager.isKioskModeActive {
+            updateKioskModeLockdown(enabled: true)
+        }
+    }
+
+    // MARK: - Touch Handling
+
+    /// Call this when user touches the screen to record activity
+    func recordKioskActivity() {
+        KioskModeManager.shared.recordActivity(source: "touch")
+    }
+}

Sources/App/Frontend/WebView/WebViewController.swift

@@ -1,5 +1,6 @@
 import AVFoundation
 import AVKit
+import Combine
 import CoreLocation
 import HAKit
 import Improv_iOS
@@ -66,14 +67,20 @@ final class WebViewController: UIViewController, WKNavigationDelegate, WKUIDeleg
     /// Each navigation resets this to false so we can show the empty state
     var isConnected = false
 
+    // MARK: - Kiosk Mode Properties
+
+    var screensaverController: KioskScreensaverViewController?
+    var secretExitGestureController: KioskSecretExitGestureViewController?
+    var kioskCancellables = Set<AnyCancellable>()
+
     var underlyingPreferredStatusBarStyle: UIStatusBarStyle = .lightContent
 
     override var prefersStatusBarHidden: Bool {
-        Current.settingsStore.fullScreen
+        Current.settingsStore.fullScreen || kioskPrefersStatusBarHidden
     }
 
     override var prefersHomeIndicatorAutoHidden: Bool {
-        Current.settingsStore.fullScreen
+        Current.settingsStore.fullScreen || kioskPrefersHomeIndicatorAutoHidden
     }
 
     override var preferredStatusBarStyle: UIStatusBarStyle {
@@ -263,6 +270,7 @@ final class WebViewController: UIViewController, WKNavigationDelegate, WKUIDeleg
         postOnboardingNotificationPermission()
         emptyStateObservations()
         checkForLocalSecurityLevelDecisionNeeded()
+        setupKioskMode()
     }
 
     // Workaround for webview rotation issues: https://github.com/Telerik-Verified-Plugins/WKWebView/pull/263
@@ -282,6 +290,12 @@ final class WebViewController: UIViewController, WKNavigationDelegate, WKUIDeleg
     override func viewDidAppear(_ animated: Bool) {
         super.viewDidAppear(animated)
         updateDatabaseAndPanels()
+
+        // Refresh kiosk status bar state when view appears (e.g., after settings modal dismisses)
+        if KioskModeManager.shared.isKioskModeActive {
+            setNeedsStatusBarAppearanceUpdate()
+            navigationController?.setNeedsStatusBarAppearanceUpdate()
+        }
     }
 
     override func viewWillDisappear(_ animated: Bool) {

Sources/App/Frontend/WebView/WebViewWindowController.swift

@@ -5,6 +5,22 @@ import Shared
 import SwiftUI
 import UIKit
 
+/// Navigation controller that forwards status bar and home indicator preferences to its top view controller.
+/// This is needed for kiosk mode to properly hide the status bar when WebViewController is embedded.
+final class StatusBarForwardingNavigationController: UINavigationController {
+    override var childForStatusBarHidden: UIViewController? {
+        topViewController
+    }
+
+    override var childForStatusBarStyle: UIViewController? {
+        topViewController
+    }
+
+    override var childForHomeIndicatorAutoHidden: UIViewController? {
+        topViewController
+    }
+}
+
 final class WebViewWindowController {
     enum RootViewControllerType {
         case onboarding
@@ -55,7 +71,7 @@ final class WebViewWindowController {
     }
 
     private func webViewNavigationController(rootViewController: UIViewController? = nil) -> UINavigationController {
-        let navigationController = UINavigationController()
+        let navigationController = StatusBarForwardingNavigationController()
         navigationController.setNavigationBarHidden(true, animated: false)
 
         if let rootViewController {