6cfcd7d41f
* Correctly handle the re-opening of the main window. Add an additional safe-guard to ensure only one main window exists. Make sure all secondary windows use the correct tint colour. * Fix a bug where the settings screen isn't shown on macOS when the AppLock feature is enabled.
86 lines
3.3 KiB
Swift
86 lines
3.3 KiB
Swift
//
|
|
// Copyright 2025 Element Creations Ltd.
|
|
// Copyright 2024-2025 New Vector Ltd.
|
|
//
|
|
// SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial.
|
|
// Please see LICENSE files in the repository root for full details.
|
|
//
|
|
|
|
import SwiftUI
|
|
|
|
enum SecondaryWindowType: Hashable, Codable {
|
|
case room(roomID: String)
|
|
case settings
|
|
}
|
|
|
|
protocol SecureWindowManagerDelegate: AnyObject {
|
|
/// The window manager has configured its windows.
|
|
func windowManagerDidConfigureWindows(_ windowManager: SecureWindowManagerProtocol)
|
|
}
|
|
|
|
@MainActor
|
|
protocol SecureWindowManagerProtocol: WindowManagerProtocol {
|
|
var delegate: SecureWindowManagerDelegate? { get set }
|
|
|
|
/// Configures the window manager to operate on the supplied scene.
|
|
func configure(withScene scene: UIWindowScene, session: UISceneSession)
|
|
|
|
func configure(withOpenWindowAction openWindowAction: OpenWindowAction, dismissWindowAction: DismissWindowAction)
|
|
|
|
func handleSceneDisconnection(_ scene: UIWindowScene)
|
|
|
|
func handleRoute(_ appRoute: AppRoute, windowType: SecondaryWindowType)
|
|
|
|
/// Shows the main and overlay window combo, hiding the alternate window.
|
|
func switchToMain()
|
|
|
|
/// Shows the alternate window, hiding the main and overlay combo.
|
|
func switchToAlternate()
|
|
|
|
// MARK: - Secondary window support
|
|
|
|
/// Used by the Application to retrieve the root view for an secondary window
|
|
func windowForType(_ type: SecondaryWindowType) -> AnyView
|
|
}
|
|
|
|
/// A window manager that supports switching between a main app window with an overlay and
|
|
/// an alternate window to switch contexts whilst also preserving the main view hierarchy.
|
|
/// Heavily inspired by https://www.fivestars.blog/articles/swiftui-windows/
|
|
protocol WindowManagerProtocol: AnyObject, OrientationManagerProtocol {
|
|
/// The app's main window (we only support a single scene).
|
|
var mainWindow: UIWindow! { get }
|
|
/// Presented on top of the main window, to display e.g. user indicators.
|
|
var overlayWindow: UIWindow! { get }
|
|
/// A window layered on top of the main one. Used by the global search function
|
|
var globalSearchWindow: UIWindow! { get }
|
|
/// A secondary window that can be presented instead of the main/overlay window combo.
|
|
var alternateWindow: UIWindow! { get }
|
|
|
|
/// All the windows being managed
|
|
var windows: [UIWindow] { get }
|
|
|
|
/// Makes the global search window key. Used to get automatic text field focus.
|
|
func showGlobalSearch()
|
|
|
|
func hideGlobalSearch()
|
|
|
|
// MARK: - Secondary window support
|
|
|
|
var secondaryWindowsEnabled: Bool { get set }
|
|
|
|
/// Register a coordinator and it's respective flow (if any) within the WindowManager which in turn
|
|
/// invokes the Application's `OpenWindowAction`
|
|
func registerCoordinator(_ coordinator: CoordinatorProtocol,
|
|
flowCoordinator: FlowCoordinatorProtocol?,
|
|
forWindowType type: SecondaryWindowType)
|
|
|
|
/// Closes any window previously opened by registering a coordinator
|
|
func closeAllSecondaryWindows()
|
|
|
|
/// Closes a previously opened window for the given type.
|
|
func closeSecondaryWindow(forType type: SecondaryWindowType)
|
|
}
|
|
|
|
// sourcery: AutoMockable
|
|
extension WindowManagerProtocol { }
|