SPB Git

Repository Public

QuickTerminalController.swift 7.2 KB 157 lines swift

1import AppKit2import Carbon.HIToolbox3import DesignSystem4import SettingsModel5import SwiftUI6import TerminalCore7import WindowManager8import WorkspaceKit910/// A terminal that drops down from the top of the active display on a global hotkey.11/// The hotkey uses the Carbon hot-key API, which needs no Accessibility or Input Monitoring12/// permission; it is registered only while the feature is enabled in Settings.13@MainActor14final class QuickTerminalController: NSObject, NSWindowDelegate {15    unowned let model: AppModel16    private(set) var state: WindowState?17    private var window: SPWindow?18    private var hotKey: EventHotKeyRef?19    private var handler: EventHandlerRef?20    nonisolated(unsafe) private static weak var current: QuickTerminalController?2122    init(model: AppModel) {23        self.model = model24        super.init()25        QuickTerminalController.current = self26    }2728    var isVisible: Bool { window?.isVisible ?? false }29    var isHotKeyRegistered: Bool { hotKey != nil }3031    func updateHotKey() {32        unregister()33        guard model.settings.quickTerminalEnabled, let code = KeyCodes.code(for: model.settings.quickTerminalShortcut.key) else { return }34        if handler == nil {35            var spec = EventTypeSpec(eventClass: OSType(kEventClassKeyboard), eventKind: UInt32(kEventHotKeyPressed))36            InstallEventHandler(GetApplicationEventTarget(), { _, _, _ in37                DispatchQueue.main.async { MainActor.assumeIsolated { QuickTerminalController.current?.toggle() } }38                return noErr39            }, 1, &spec, nil, &handler)40        }41        var modifiers: UInt32 = 042        let chord = model.settings.quickTerminalShortcut.modifiers43        if chord.contains(.command) { modifiers |= UInt32(cmdKey) }44        if chord.contains(.shift) { modifiers |= UInt32(shiftKey) }45        if chord.contains(.option) { modifiers |= UInt32(optionKey) }46        if chord.contains(.control) { modifiers |= UInt32(controlKey) }47        let id = EventHotKeyID(signature: OSType(0x5350_544D), id: 1)   // 'SPTM'48        RegisterEventHotKey(UInt32(code), modifiers, id, GetApplicationEventTarget(), 0, &hotKey)49    }5051    private func unregister() {52        if let hotKey { UnregisterEventHotKey(hotKey) }53        hotKey = nil54    }5556    func toggle() {57        if isVisible { hide() } else { show() }58    }5960    func frame(on screen: ScreenDescriptor) -> CGRect {61        let visible = screen.visibleFrame62        let height = max(220, visible.height * CGFloat(model.settings.quickTerminalHeightFraction))63        return CGRect(x: visible.minX, y: visible.maxY - height, width: visible.width, height: min(height, visible.height))64    }6566    func show() {67        let all = model.screens()68        let point = NSEvent.mouseLocation69        guard let screen = all.first(where: { $0.frame.contains(point) }) ?? PlacementEngine.fallbackScreen(in: all) else { return }70        if state == nil {71            let descriptor = model.newPaneDescriptor()72            model.ensureSession(for: descriptor)73            let state = WindowState(tabs: [TabModel(single: descriptor)])74            state.isQuickTerminal = true75            self.state = state76            let window = SPWindow(contentRect: frame(on: screen), styleMask: [.borderless, .resizable, .fullSizeContentView], backing: .buffered, defer: false)77            window.isReleasedWhenClosed = false78            window.level = .floating79            window.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .transient]80            window.hidesOnDeactivate = false81            window.isMovableByWindowBackground = false82            window.delegate = self83            window.onFirstResponderChange = { [weak self] responder in84                guard let self, let state = self.state, let view = responder as? NSView else { return }85                self.model.viewDidBecomeFirstResponder(view, in: state)86            }87            let hosting = NSHostingView(rootView: WindowRootView(state: state, model: model))88            hosting.sizingOptions = []89            window.contentView = hosting90            self.window = window91            applyAppearance()92        }93        guard let window, let state else { return }94        window.setFrame(frame(on: screen), display: true)95        NSApp.activate(ignoringOtherApps: true)96        window.makeKeyAndOrderFront(nil)97        model.focusCurrentPane(in: state)98    }99100    func hide() { window?.orderOut(nil) }101102    func applyAppearance() {103        guard let window else { return }104        let theme = model.theme105        window.appearance = NSAppearance(named: theme.isDark ? .darkAqua : .aqua)106        window.isOpaque = false107        window.backgroundColor = theme.chromeBackground.nsColor.withAlphaComponent(min(0.97, CGFloat(model.settings.backgroundOpacity)))108        window.hasShadow = true109    }110111    /// The last pane exited: forget the window so the next toggle starts a fresh shell.112    func tabsDidEmpty() {113        window?.orderOut(nil)114        window = nil115        state = nil116    }117118    func screensChanged() {119        guard isVisible, let window else { return }120        let all = model.screens()121        if let screen = PlacementEngine.screen(containing: window.frame, in: all) ?? PlacementEngine.fallbackScreen(in: all) {122            window.setFrame(frame(on: screen), display: true)123        }124    }125126    func windowDidResignKey(_ notification: Notification) {127        // Stays visible when another app is activated only if the user pinned it; default hides.128        if NSApp.isActive == false { hide() }129    }130131    func shutdown() {132        unregister()133        if let handler { RemoveEventHandler(handler) }134        handler = nil135    }136}137138/// ANSI virtual key codes for the keys a shortcut can use.139enum KeyCodes {140    static let table: [String: Int] = [141        "a": kVK_ANSI_A, "b": kVK_ANSI_B, "c": kVK_ANSI_C, "d": kVK_ANSI_D, "e": kVK_ANSI_E, "f": kVK_ANSI_F, "g": kVK_ANSI_G,142        "h": kVK_ANSI_H, "i": kVK_ANSI_I, "j": kVK_ANSI_J, "k": kVK_ANSI_K, "l": kVK_ANSI_L, "m": kVK_ANSI_M, "n": kVK_ANSI_N,143        "o": kVK_ANSI_O, "p": kVK_ANSI_P, "q": kVK_ANSI_Q, "r": kVK_ANSI_R, "s": kVK_ANSI_S, "t": kVK_ANSI_T, "u": kVK_ANSI_U,144        "v": kVK_ANSI_V, "w": kVK_ANSI_W, "x": kVK_ANSI_X, "y": kVK_ANSI_Y, "z": kVK_ANSI_Z,145        "0": kVK_ANSI_0, "1": kVK_ANSI_1, "2": kVK_ANSI_2, "3": kVK_ANSI_3, "4": kVK_ANSI_4, "5": kVK_ANSI_5, "6": kVK_ANSI_6,146        "7": kVK_ANSI_7, "8": kVK_ANSI_8, "9": kVK_ANSI_9,147        "`": kVK_ANSI_Grave, "-": kVK_ANSI_Minus, "=": kVK_ANSI_Equal, "[": kVK_ANSI_LeftBracket, "]": kVK_ANSI_RightBracket,148        "\\": kVK_ANSI_Backslash, ";": kVK_ANSI_Semicolon, "'": kVK_ANSI_Quote, ",": kVK_ANSI_Comma, ".": kVK_ANSI_Period, "/": kVK_ANSI_Slash,149        "space": kVK_Space, "return": kVK_Return, "tab": kVK_Tab, "escape": kVK_Escape, "delete": kVK_Delete,150        "left": kVK_LeftArrow, "right": kVK_RightArrow, "up": kVK_UpArrow, "down": kVK_DownArrow,151        "home": kVK_Home, "end": kVK_End, "pageup": kVK_PageUp, "pagedown": kVK_PageDown,152        "f1": kVK_F1, "f2": kVK_F2, "f3": kVK_F3, "f4": kVK_F4, "f5": kVK_F5, "f6": kVK_F6, "f7": kVK_F7, "f8": kVK_F8,153        "f9": kVK_F9, "f10": kVK_F10, "f11": kVK_F11, "f12": kVK_F12,154    ]155    static func code(for key: String) -> Int? { table[key.lowercased()] }156}157
Files main
Menu

Theme