Repository Public
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