Add kiosk mode core infrastructure (PR 1/5)

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

@@ -0,0 +1,30 @@
+import Shared
+import UIKit
+
+// MARK: - Kiosk Mode Extension
+
+extension WebViewController {
+    /// Setup kiosk mode integration with KioskModeManager
+    /// Call this from viewDidLoad
+    func setupKioskMode() {
+        KioskModeManager.shared.setup(using: self)
+    }
+
+    // MARK: - Status Bar & Home Indicator
+
+    var kioskPrefersStatusBarHidden: Bool {
+        KioskModeManager.shared.prefersStatusBarHidden
+    }
+
+    var kioskPrefersHomeIndicatorAutoHidden: Bool {
+        KioskModeManager.shared.prefersHomeIndicatorAutoHidden
+    }
+
+    // MARK: - Touch Handling
+
+    /// Record user touch activity to reset the screensaver idle timer
+    /// Required because WKWebView consumes touch events before UIKit idle detection
+    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
@@ -69,11 +70,11 @@ final class WebViewController: UIViewController, WKNavigationDelegate, WKUIDeleg
     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 +264,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 +284,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 {

Sources/App/Kiosk/KioskConstants.swift

@@ -0,0 +1,38 @@
+import CoreGraphics
+import Foundation
+import Shared
+
+// MARK: - Kiosk Constants
+
+/// Centralized constants for the kiosk mode
+public enum KioskConstants {
+    // MARK: - Animation Durations
+
+    public enum Animation {
+        /// Standard transition animation duration
+        public static let standard: TimeInterval = 0.3
+        /// Quick animation for subtle transitions
+        public static let quick: TimeInterval = 0.2
+        /// Slow animation for screensaver transitions
+        public static let slow: TimeInterval = 0.5
+        /// Pixel shift animation duration
+        public static let pixelShift: TimeInterval = 1.0
+    }
+
+    // MARK: - UI Dimensions
+
+    public enum UI {
+        /// Standard corner radius (uses DesignSystem)
+        public static let cornerRadius: CGFloat = DesignSystem.CornerRadius.oneAndHalf
+        /// Small corner radius (uses DesignSystem)
+        public static let smallCornerRadius: CGFloat = DesignSystem.CornerRadius.one
+        /// Large clock font size
+        public static let largeClockFontSize: CGFloat = 120
+        /// Minimal clock font size
+        public static let minimalClockFontSize: CGFloat = 80
+        /// Digital clock font size
+        public static let digitalClockFontSize: CGFloat = 100
+        /// Analog clock size
+        public static let analogClockSize: CGFloat = 300
+    }
+}