TerminalController.swift

import Foundation
import Cocoa
import SwiftUI
import Combine
import GhosttyKit

final class WorktrunkSidebarState: ObservableObject {
    @Published var columnVisibility: NavigationSplitViewVisibility
    @Published var expandedRepoIDs: Set<UUID> = []
    @Published var expandedWorktreePaths: Set<String> = []
    @Published var selection: SidebarSelection?
    @Published var isApplyingRemoteUpdate: Bool = false

    init(
        columnVisibility: NavigationSplitViewVisibility = .all,
        expandedRepoIDs: Set<UUID> = [],
        expandedWorktreePaths: Set<String> = [],
        selection: SidebarSelection? = nil
    ) {
        self.columnVisibility = columnVisibility
        self.expandedRepoIDs = expandedRepoIDs
        self.expandedWorktreePaths = expandedWorktreePaths
        self.selection = selection
    }

    func applyExpandedRepoIDs(_ next: Set<UUID>, listMode: WorktrunkSidebarListMode) {
        guard next != expandedRepoIDs else { return }
        expandedRepoIDs = next
        pruneSelectionForVisibility(
            listMode: listMode,
            expandedRepoIDs: next,
            expandedWorktreePaths: expandedWorktreePaths
        )
    }

    func applyExpandedWorktreePaths(_ next: Set<String>, listMode: WorktrunkSidebarListMode) {
        guard next != expandedWorktreePaths else { return }
        expandedWorktreePaths = next
        pruneSelectionForVisibility(
            listMode: listMode,
            expandedRepoIDs: expandedRepoIDs,
            expandedWorktreePaths: next
        )
    }

    func didCollapseRepo(id: UUID) {
        guard let selection else { return }
        switch selection {
        case .repo(let repoID):
            if repoID == id { return }
        case .worktree(let repoID, _):
            if repoID == id { self.selection = .repo(id: id) }
        case .session(_, let repoID, _):
            if repoID == id { self.selection = .repo(id: id) }
        }
    }

    func didCollapseWorktree(repoID: UUID, path: String) {
        guard let selection else { return }
        switch selection {
        case .session(_, let selectedRepoID, let worktreePath):
            if selectedRepoID == repoID, worktreePath == path {
                self.selection = .worktree(repoID: repoID, path: path)
            }
        default:
            return
        }
    }

    func reconcile(with store: any WorktrunkSidebarReconcilingStore, listMode: WorktrunkSidebarListMode) {
        let validRepoIDs = store.sidebarRepoIDs
        let validWorktreePaths = store.sidebarWorktreePaths

        let nextExpandedRepoIDs = expandedRepoIDs.intersection(validRepoIDs)
        if nextExpandedRepoIDs != expandedRepoIDs {
            expandedRepoIDs = nextExpandedRepoIDs
        }

        let nextExpandedWorktreePaths = expandedWorktreePaths.intersection(validWorktreePaths)
        if nextExpandedWorktreePaths != expandedWorktreePaths {
            expandedWorktreePaths = nextExpandedWorktreePaths
        }

        guard let selection else { return }

        let nextSelection: SidebarSelection?
        switch selection {
        case .repo(let id):
            nextSelection = validRepoIDs.contains(id) ? selection : nil
        case .worktree(let repoID, let path):
            if !validRepoIDs.contains(repoID) {
                nextSelection = nil
            } else if validWorktreePaths.contains(path) {
                nextSelection = selection
            } else {
                nextSelection = .repo(id: repoID)
            }
        case .session(let id, let repoID, let worktreePath):
            if !validRepoIDs.contains(repoID) {
                nextSelection = nil
            } else if !validWorktreePaths.contains(worktreePath) {
                nextSelection = .repo(id: repoID)
            } else if store.sessions(for: worktreePath).contains(where: { $0.id == id }) {
                nextSelection = selection
            } else {
                nextSelection = .worktree(repoID: repoID, path: worktreePath)
            }
        }

        if nextSelection != selection {
            self.selection = nextSelection
        }
    }

    private func pruneSelectionForVisibility(
        listMode: WorktrunkSidebarListMode,
        expandedRepoIDs: Set<UUID>,
        expandedWorktreePaths: Set<String>
    ) {
        guard let selection else { return }
        switch selection {
        case .repo:
            return
        case .worktree(let repoID, _):
            if listMode == .nestedByRepo, !expandedRepoIDs.contains(repoID) {
                self.selection = .repo(id: repoID)
            }
        case .session(_, let repoID, let worktreePath):
            if listMode == .nestedByRepo, !expandedRepoIDs.contains(repoID) {
                self.selection = .repo(id: repoID)
                return
            }
            if !expandedWorktreePaths.contains(worktreePath) {
                self.selection = .worktree(repoID: repoID, path: worktreePath)
            }
        }
    }
}

protocol WorktrunkSidebarReconcilingStore {
    var repositories: [WorktrunkStore.Repository] { get }
    var sidebarRepoIDs: Set<UUID> { get }
    var sidebarWorktreePaths: Set<String> { get }
    func worktrees(for repositoryID: UUID) -> [WorktrunkStore.Worktree]
    func sessions(for worktreePath: String) -> [AISession]
}

enum SidebarSelection: Hashable {
    case repo(id: UUID)
    case worktree(repoID: UUID, path: String)
    case session(id: String, repoID: UUID, worktreePath: String)
}
/// A classic, tabbed terminal experience.
class TerminalController: BaseTerminalController, TabGroupCloseCoordinator.Controller {
    private static let worktreeTabControllers = NSMapTable<NSString, TerminalController>(
        keyOptions: .copyIn,
        valueOptions: .weakMemory
    )

    override var windowNibName: NSNib.Name? {
        let defaultValue = "Terminal"

        guard let appDelegate = NSApp.delegate as? AppDelegate else { return defaultValue }
        let config = appDelegate.ghostty.config

        // If we have no window decorations, there's no reason to do anything but
        // the default titlebar (because there will be no titlebar).
        if !config.windowDecorations {
            return defaultValue
        }

        let nib = switch config.macosTitlebarStyle {
        case "native": "Terminal"
        case "hidden": "TerminalHiddenTitlebar"
        case "transparent": "TerminalTransparentTitlebar"
        case "tabs":
#if compiler(>=6.2)
            if #available(macOS 26.0, *) {
                "TerminalTabsTitlebarTahoe"
            } else {
                "TerminalTabsTitlebarVentura"
            }
#else
            "TerminalTabsTitlebarVentura"
#endif
        default: defaultValue
        }

        return nib
    }

    /// This is set to true when we care about frame changes. This is a small optimization since
    /// this controller registers a listener for ALL frame change notifications and this lets us bail
    /// early if we don't care.
    private var tabListenForFrame: Bool = false

    /// This is the hash value of the last tabGroup.windows array. We use this to detect order
    /// changes in the list.
    private var tabWindowsHash: Int = 0

    /// This is set to false by init if the window managed by this controller should not be restorable.
    /// For example, terminals executing custom scripts are not restorable.
    private var restorable: Bool = true

    /// The configuration derived from the Ghostty config so we don't need to rely on references.
    private(set) var derivedConfig: DerivedConfig
    private var lastTitlebarFont: NSFont?

    private let worktrunkSidebarState: WorktrunkSidebarState
    private let openTabsModel = WorktrunkOpenTabsModel()
    private var worktrunkSidebarSyncCancellables: Set<AnyCancellable> = []
    private var worktrunkSidebarSyncApplyingRemoteUpdate: Bool = false
    private let gitDiffSidebarState = GitDiffSidebarState()
    private var lastTabSwitchRefreshAt: Date?
    private let tabSwitchRefreshThrottle: TimeInterval = 0.15
    private var pendingTabSwitchRefresh: DispatchWorkItem?
    private var lastTabSwitchSurfaceID: UUID?

    private(set) var worktreeTabRootPath: String? {
        didSet { syncWorktreeTabTitle() }
    }

    /// The notification cancellable for focused surface property changes.
    private var surfaceAppearanceCancellables: Set<AnyCancellable> = []

    /// This will be set to the initial frame of the window from the xib on load.
    private var initialFrame: NSRect?

    init(_ ghostty: Ghostty.App,
         withBaseConfig base: Ghostty.SurfaceConfiguration? = nil,
         withSurfaceTree tree: SplitTree<Ghostty.SurfaceView>? = nil,
         parent: NSWindow? = nil
    ) {
        // The window we manage is not restorable if we've specified a command
        // to execute. We do this because the restored window is meaningless at the
        // time of writing this: it'd just restore to a shell in the same directory
        // as the script. We may want to revisit this behavior when we have scrollback
        // restoration.
        self.restorable = (base?.command ?? "") == ""

        if let parent,
           let parentController = parent.windowController as? TerminalController {
            self.worktrunkSidebarState = WorktrunkSidebarState(
                columnVisibility: parentController.worktrunkSidebarState.columnVisibility,
                expandedRepoIDs: parentController.worktrunkSidebarState.expandedRepoIDs,
                expandedWorktreePaths: parentController.worktrunkSidebarState.expandedWorktreePaths,
                selection: parentController.worktrunkSidebarState.selection
            )
        } else {
            self.worktrunkSidebarState = WorktrunkSidebarState(columnVisibility: .all)
        }

        // Setup our initial derived config based on the current app config
        self.derivedConfig = DerivedConfig(ghostty.config)

        var baseWithHooks = base ?? Ghostty.SurfaceConfiguration()
        TerminalAgentHooks.apply(to: &baseWithHooks)
        super.init(ghostty, baseConfig: baseWithHooks, surfaceTree: tree)
        // Setup our notifications for behaviors
        let center = NotificationCenter.default
        center.addObserver(
            self,
            selector: #selector(onToggleFullscreen),
            name: Ghostty.Notification.ghosttyToggleFullscreen,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onMoveTab),
            name: .ghosttyMoveTab,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onGotoTab),
            name: Ghostty.Notification.ghosttyGotoTab,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onCloseTab),
            name: .ghosttyCloseTab,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onCloseOtherTabs),
            name: .ghosttyCloseOtherTabs,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onCloseTabsOnTheRight),
            name: .ghosttyCloseTabsOnTheRight,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onResetWindowSize),
            name: .ghosttyResetWindowSize,
            object: nil
        )
        center.addObserver(
            self,
            selector: #selector(ghosttyConfigDidChange(_:)),
            name: .ghosttyConfigDidChange,
            object: nil
        )
        center.addObserver(
            self,
            selector: #selector(onFrameDidChange),
            name: NSView.frameDidChangeNotification,
            object: nil)
        center.addObserver(
            self,
            selector: #selector(onCloseWindow),
            name: .ghosttyCloseWindow,
            object: nil
        )
    }

    required init?(coder: NSCoder) {
        fatalError("init(coder:) is not supported for this view")
    }

    deinit {
        if let root = worktreeTabRootPath {
            Self.worktreeTabControllers.removeObject(forKey: root as NSString)
        }

        // Remove all of our notificationcenter subscriptions
        let center = NotificationCenter.default
        center.removeObserver(self)
    }

    private static func standardizedPath(_ path: String) -> String {
        URL(fileURLWithPath: path).standardizedFileURL.path
    }

    private func setWorktreeTabRootPath(_ path: String?) {
        let standardized = path.map(Self.standardizedPath)

        if let old = worktreeTabRootPath {
            Self.worktreeTabControllers.removeObject(forKey: old as NSString)
        }

        worktreeTabRootPath = standardized

        if let standardized {
            Self.worktreeTabControllers.setObject(self, forKey: standardized as NSString)
        }

        openTabsModel.refresh(for: window)
    }

    private func syncWorktreeTabTitle() {
        guard WorktrunkPreferences.worktreeTabsEnabled, let root = worktreeTabRootPath else {
            managedTitleOverride = nil
            return
        }

        managedTitleOverride = (root as NSString).abbreviatingWithTildeInPath
    }

    func applyWorktreeTabPreferences() {
        syncWorktreeTabTitle()
    }

    func restoreWorktreeTabRootPath(_ path: String?) {
        let sanitized = RestorablePath.normalizedExistingDirectoryPath(path)
        setWorktreeTabRootPath(sanitized)
    }

    private static func existingWorktreeTabController(forWorktreePath path: String) -> TerminalController? {
        let root = standardizedPath(path)
        if let existing = worktreeTabControllers.object(forKey: root as NSString) {
            return existing
        }

        if let controller = TerminalController.all.first(where: { $0.worktreeTabRootPath == root }) {
            worktreeTabControllers.setObject(controller, forKey: root as NSString)
            return controller
        }

        for controller in TerminalController.all {
            for surfaceView in controller.surfaceTree {
                guard let pwd = surfaceView.pwd else { continue }
                let pwdPath = standardizedPath(pwd)
                let rootPrefix = root.hasSuffix("/") ? root : (root + "/")
                if pwdPath == root || pwdPath.hasPrefix(rootPrefix) {
                    controller.setWorktreeTabRootPath(root)
                    worktreeTabControllers.setObject(controller, forKey: root as NSString)
                    return controller
                }
            }
        }

        return nil
    }

    private static func ensureWorktreeTabController(
        ghostty: Ghostty.App,
        parentWindow: NSWindow?,
        worktreePath: String,
        initialBaseConfig: Ghostty.SurfaceConfiguration
    ) -> (controller: TerminalController, isNew: Bool) {
        if let existing = existingWorktreeTabController(forWorktreePath: worktreePath) {
            return (existing, false)
        }

        let parent = parentWindow ?? preferredParent?.window
        let controller: TerminalController = {
            if let created = TerminalController.newTab(ghostty, from: parent, withBaseConfig: initialBaseConfig) {
                return created
            }
            return TerminalController.newWindow(ghostty, withBaseConfig: initialBaseConfig, withParent: parent)
        }()

        controller.setWorktreeTabRootPath(worktreePath)
        controller.syncWorktreeTabTitle()
        return (controller, true)
    }

    private func worktreeTabNextSplitPlacement() -> (anchor: Ghostty.SurfaceView, direction: SplitTree<Ghostty.SurfaceView>.NewDirection)? {
        guard let root = surfaceTree.root else { return nil }
        let allLeaves = root.leaves()
        guard let first = allLeaves.first else { return nil }

        // Start with two columns.
        if allLeaves.count == 1 {
            return (first, .right)
        }

        // After two columns exist, we fill rows in a 2-column grid:
        // 3rd -> split left column down
        // 4th -> split right column down
        // 5th+ -> keep adding rows to the shorter column, bottom-first (ties -> left).
        if case .split(let split) = root, split.direction == .horizontal {
            let leftLeaves = split.left.leaves()
            let rightLeaves = split.right.leaves()

            if leftLeaves.count <= rightLeaves.count {
                return (leftLeaves.last ?? first, .down)
            } else {
                return (rightLeaves.last ?? first, .down)
            }
        }

        // If the tree doesn't match the expected layout (e.g. user-made splits),
        // fall back to adding a row at the end.
        return (allLeaves.last ?? first, .down)
    }

    func openWorktreeTabNewSession(baseConfig: Ghostty.SurfaceConfiguration) {
        guard WorktrunkPreferences.worktreeTabsEnabled, worktreeTabRootPath != nil else { return }
        guard let (anchor, direction) = worktreeTabNextSplitPlacement() else { return }
        _ = newSplit(at: anchor, direction: direction, baseConfig: baseConfig)
    }

    private func openWorktreeTabSession(worktreePath: String, baseConfig: Ghostty.SurfaceConfiguration) {
        var initialConfig = baseConfig
        initialConfig.workingDirectory = initialConfig.workingDirectory ?? worktreePath
        TerminalAgentHooks.apply(to: &initialConfig)

        let (controller, isNew) = Self.ensureWorktreeTabController(
            ghostty: ghostty,
            parentWindow: window,
            worktreePath: worktreePath,
            initialBaseConfig: initialConfig
        )

        controller.window?.makeKeyAndOrderFront(nil)
        if !NSApp.isActive {
            NSApp.activate(ignoringOtherApps: true)
        }

        if controller.worktreeTabRootPath == nil {
            controller.setWorktreeTabRootPath(worktreePath)
        }

        // If this is the first terminal in the tab, the tab creation already created the surface.
        // Otherwise, open a new split in the worktree tab.
        guard !isNew else { return }
        controller.openWorktreeTabNewSession(baseConfig: initialConfig)
    }

    // MARK: Base Controller Overrides

    override func surfaceTreeDidChange(from: SplitTree<Ghostty.SurfaceView>, to: SplitTree<Ghostty.SurfaceView>) {
        super.surfaceTreeDidChange(from: from, to: to)

        // Whenever our surface tree changes in any way (new split, close split, etc.)
        // we want to invalidate our state.
        invalidateRestorableState()

        // Update our zoom state
        if let window = window as? TerminalWindow {
            window.surfaceIsZoomed = to.zoomed != nil
        }

        // If our surface tree is now nil then we close our window.
        if to.isEmpty {
            self.window?.close()
        }
    }

    override func replaceSurfaceTree(
        _ newTree: SplitTree<Ghostty.SurfaceView>,
        moveFocusTo newView: Ghostty.SurfaceView? = nil,
        moveFocusFrom oldView: Ghostty.SurfaceView? = nil,
        undoAction: String? = nil
    ) {
        // We have a special case if our tree is empty to close our tab immediately.
        // This makes it so that undo is handled properly.
        if newTree.isEmpty {
            closeTabImmediately()
            return
        }

        super.replaceSurfaceTree(
            newTree,
            moveFocusTo: newView,
            moveFocusFrom: oldView,
            undoAction: undoAction)
    }

    // MARK: Terminal Creation

    /// Returns all the available terminal controllers present in the app currently.
    static var all: [TerminalController] {
        return NSApplication.shared.windows.compactMap {
            $0.windowController as? TerminalController
        }
    }

    // Keep track of the last point that our window was launched at so that new
    // windows "cascade" over each other and don't just launch directly on top
    // of each other.
    private static var lastCascadePoint = NSPoint(x: 0, y: 0)

    // The preferred parent terminal controller.
    static var preferredParent: TerminalController? {
        all.first {
            $0.window?.isMainWindow ?? false
        } ?? lastMain ?? all.last
    }

    // The last controller to be main. We use this when paired with "preferredParent"
    // to find the preferred window to attach new tabs, perform actions, etc. We
    // always prefer the main window but if there isn't any (because we're triggered
    // by something like an App Intent) then we prefer the most previous main.
    static private(set) weak var lastMain: TerminalController?

    /// The "new window" action.
    static func newWindow(
        _ ghostty: Ghostty.App,
        withBaseConfig baseConfig: Ghostty.SurfaceConfiguration? = nil,
        withParent explicitParent: NSWindow? = nil
    ) -> TerminalController {
        // Get our parent. Our parent is the one explicitly given to us,
        // otherwise the focused terminal, otherwise an arbitrary one.
        let parent: NSWindow? = explicitParent ?? preferredParent?.window
        let c = TerminalController.init(ghostty, withBaseConfig: baseConfig, parent: parent)

        if let parent, parent.styleMask.contains(.fullScreen) {
            // If our previous window was fullscreen then we want our new window to
            // be fullscreen. This behavior actually doesn't match the native tabbing
            // behavior of macOS apps where new windows create tabs when in native
            // fullscreen but this is how we've always done it. This matches iTerm2
            // behavior.
            c.toggleFullscreen(mode: .native)
        } else if let fullscreenMode = ghostty.config.windowFullscreen {
            switch fullscreenMode {
            case .native:
                // Native has to be done immediately so that our stylemask contains
                // fullscreen for the logic later in this method.
                c.toggleFullscreen(mode: .native)

            case .nonNative, .nonNativeVisibleMenu, .nonNativePaddedNotch:
                // If we're non-native then we have to do it on a later loop
                // so that the content view is setup.
                DispatchQueue.main.async {
                    c.toggleFullscreen(mode: fullscreenMode)
                }
            }
        }

        // We're dispatching this async because otherwise the lastCascadePoint doesn't
        // take effect. Our best theory is there is some next-event-loop-tick logic
        // that Cocoa is doing that we need to be after.
        DispatchQueue.main.async {
            // Only cascade if we aren't fullscreen.
            if let window = c.window {
                if !window.styleMask.contains(.fullScreen) {
                    Self.lastCascadePoint = window.cascadeTopLeft(from: Self.lastCascadePoint)
                }
            }

            c.showWindow(self)

            // All new_window actions force our app to be active, so that the new
            // window is focused and visible.
            NSApp.activate(ignoringOtherApps: true)
        }

        // Setup our undo
        if let undoManager = c.undoManager {
            undoManager.setActionName("New Window")
            undoManager.registerUndo(
                withTarget: c,
                expiresAfter: c.undoExpiration
            ) { target in
                // Close the window when undoing
                undoManager.disableUndoRegistration {
                    target.closeWindow(nil)
                }

                // Register redo action
                undoManager.registerUndo(
                    withTarget: ghostty,
                    expiresAfter: target.undoExpiration
                ) { ghostty in
                    _ = TerminalController.newWindow(
                        ghostty,
                        withBaseConfig: baseConfig,
                        withParent: explicitParent)
                }
            }
        }

        return c
    }

    /// Create a new window with an existing split tree.
    /// The window will be sized to match the tree's current view bounds if available.
    /// - Parameters:
    ///   - ghostty: The Ghostty app instance.
    ///   - tree: The split tree to use for the new window.
    ///   - position: Optional screen position (top-left corner) for the new window.
    ///               If nil, the window will cascade from the last cascade point.
    static func newWindow(
        _ ghostty: Ghostty.App,
        tree: SplitTree<Ghostty.SurfaceView>,
        position: NSPoint? = nil,
        confirmUndo: Bool = true,
    ) -> TerminalController {
        let c = TerminalController.init(ghostty, withSurfaceTree: tree)

        // Calculate the target frame based on the tree's view bounds
        let treeSize: CGSize? = tree.root?.viewBounds()

        DispatchQueue.main.async {
            if let window = c.window {
                // If we have a tree size, resize the window's content to match
                if let treeSize, treeSize.width > 0, treeSize.height > 0 {
                    window.setContentSize(treeSize)
                    window.constrainToScreen()
                }

                if !window.styleMask.contains(.fullScreen) {
                    if let position {
                        window.setFrameTopLeftPoint(position)
                        window.constrainToScreen()
                    } else {
                        Self.lastCascadePoint = window.cascadeTopLeft(from: Self.lastCascadePoint)
                    }
                }
            }

            c.showWindow(self)
        }

        // Setup our undo
        if let undoManager = c.undoManager {
            undoManager.setActionName("New Window")
            undoManager.registerUndo(
                withTarget: c,
                expiresAfter: c.undoExpiration
            ) { target in
                undoManager.disableUndoRegistration {
                    if confirmUndo {
                        target.closeWindow(nil)
                    } else {
                        target.closeWindowImmediately()
                    }
                }

                undoManager.registerUndo(
                    withTarget: ghostty,
                    expiresAfter: target.undoExpiration
                ) { ghostty in
                    _ = TerminalController.newWindow(ghostty, tree: tree)
                }
            }
        }

        return c
    }

    static func newTab(
        _ ghostty: Ghostty.App,
        from parent: NSWindow? = nil,
        withBaseConfig baseConfig: Ghostty.SurfaceConfiguration? = nil
    ) -> TerminalController? {
        // Making sure that we're dealing with a TerminalController. If not,
        // then we just create a new window.
        guard let parent,
              let parentController = parent.windowController as? TerminalController else {
            return newWindow(ghostty, withBaseConfig: baseConfig, withParent: parent)
        }

        // If our parent is in non-native fullscreen, then new tabs do not work.
        // See: https://github.com/mitchellh/ghostty/issues/392
        if let fullscreenStyle = parentController.fullscreenStyle,
           fullscreenStyle.isFullscreen && !fullscreenStyle.supportsTabs {
            let alert = NSAlert()
            alert.messageText = "Cannot Create New Tab"
            alert.informativeText = "New tabs are unsupported while in non-native fullscreen. Exit fullscreen and try again."
            alert.addButton(withTitle: "OK")
            alert.alertStyle = .warning
            alert.beginSheetModal(for: parent)
            return nil
        }

        // Create a new window and add it to the parent
        let controller = TerminalController.init(ghostty, withBaseConfig: baseConfig, parent: parent)
        guard let window = controller.window else { return controller }

        // If the parent is miniaturized, then macOS exhibits really strange behaviors
        // so we have to bring it back out.
        if parent.isMiniaturized { parent.deminiaturize(self) }

        // If our parent tab group already has this window, macOS added it and
        // we need to remove it so we can set the correct order in the next line.
        // If we don't do this, macOS gets really confused and the tabbedWindows
        // state becomes incorrect.
        //
        // At the time of writing this code, the only known case this happens
        // is when the "+" button is clicked in the tab bar.
        if let tg = parent.tabGroup,
           tg.windows.firstIndex(of: window) != nil {
            tg.removeWindow(window)
        }

        // If we don't allow tabs then we create a new window instead.
        if window.tabbingMode != .disallowed {
            // Add the window to the tab group and show it.
            switch ghostty.config.windowNewTabPosition {
            case "end":
                // If we already have a tab group and we want the new tab to open at the end,
                // then we use the last window in the tab group as the parent.
                if let last = parent.tabGroup?.windows.last {
                    last.addTabbedWindow(window, ordered: .above)
                } else {
                    fallthrough
                }

            case "current": fallthrough
            default:
                parent.addTabbedWindow(window, ordered: .above)
            }
        }

        // We're dispatching this async because otherwise the lastCascadePoint doesn't
        // take effect. Our best theory is there is some next-event-loop-tick logic
        // that Cocoa is doing that we need to be after.
        DispatchQueue.main.async {
            // Only cascade if we aren't fullscreen and are alone in the tab group.
            if !window.styleMask.contains(.fullScreen) &&
                window.tabGroup?.windows.count ?? 1 == 1 {
                Self.lastCascadePoint = window.cascadeTopLeft(from: Self.lastCascadePoint)
            }

            controller.showWindow(self)
            window.makeKeyAndOrderFront(self)

            // We also activate our app so that it becomes front. This may be
            // necessary for the dock menu.
            NSApp.activate(ignoringOtherApps: true)
        }

        // It takes an event loop cycle until the macOS tabGroup state becomes
        // consistent which causes our tab labeling to be off when the "+" button
        // is used in the tab bar. This fixes that. If we can find a more robust
        // solution we should do that.
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
            controller.relabelTabs()
        }

        // Setup our undo
        if let undoManager = parentController.undoManager {
            undoManager.setActionName("New Tab")
            undoManager.registerUndo(
                withTarget: controller,
                expiresAfter: controller.undoExpiration
            ) { target in
                // Close the tab when undoing. We do this in a DispatchQueue because
                // for some people on macOS Tahoe this caused a crash and the queue
                // fixes it.
                // https://github.com/ghostty-org/ghostty/pull/9512
                DispatchQueue.main.async {
                    undoManager.disableUndoRegistration {
                        target.closeTab(nil)
                    }
                }

                // Register redo action
                undoManager.registerUndo(
                    withTarget: ghostty,
                    expiresAfter: target.undoExpiration
                ) { ghostty in
                    _ = TerminalController.newTab(
                        ghostty,
                        from: parent,
                        withBaseConfig: baseConfig)
                }
            }
        }

        return controller
    }

    // MARK: - Methods

    @objc private func ghosttyConfigDidChange(_ notification: Notification) {
        // Get our managed configuration object out
        guard let config = notification.userInfo?[
            Notification.Name.GhosttyConfigChangeKey
        ] as? Ghostty.Config else { return }

        // If this is an app-level config update then we update some things.
        if notification.object == nil {
            // Update our derived config
            self.derivedConfig = DerivedConfig(config)

            // If we have no surfaces in our window (is that possible?) then we update
            // our window appearance based on the root config. If we have surfaces, we
            // don't call this because focused surface changes will trigger appearance updates.
            if surfaceTree.isEmpty {
                syncAppearance(.init(config))
            }

            return
        }
        /// Surface-level config will be updated in
        /// ``Ghostty/Ghostty/SurfaceView/derivedConfig`` then
        /// ``TerminalController/focusedSurfaceDidChange(to:)``
    }

    /// Update the accessory view of each tab according to the keyboard
    /// shortcut that activates it (if any). This is called when the key window
    /// changes, when a window is closed, and when tabs are reordered
    /// with the mouse.
    func relabelTabs() {
        // We only listen for frame changes if we have more than 1 window,
        // otherwise the accessory view doesn't matter.
        tabListenForFrame = window?.tabbedWindows?.count ?? 0 > 1

        if let windows = window?.tabbedWindows as? [TerminalWindow] {
            for (tab, window) in zip(1..., windows) {
                // We need to clear any windows beyond this because they have had
                // a keyEquivalent set previously.
                guard tab <= 9 else {
                    window.keyEquivalent = ""
                    continue
                }

                if let equiv = ghostty.config.keyboardShortcut(for: "goto_tab:\(tab)") {
                    window.keyEquivalent = "\(equiv)"
                } else {
                    window.keyEquivalent = ""
                }
            }
        }

        openTabsModel.refresh(for: window)
    }

    private func focusNativeTab(windowNumber: Int) {
        guard let window else { return }
        guard let tabGroup = window.tabGroup else { return }
        guard let target = tabGroup.windows.first(where: { $0.windowNumber == windowNumber }) else { return }
        target.makeKeyAndOrderFront(nil)
        if !NSApp.isActive {
            NSApp.activate(ignoringOtherApps: true)
        }
    }

    private func moveNativeTabBefore(movingWindowNumber: Int, targetWindowNumber: Int) {
        guard movingWindowNumber != targetWindowNumber else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }
        guard let movingWindow = tabGroup.windows.first(where: { $0.windowNumber == movingWindowNumber }) else { return }
        guard let targetWindow = tabGroup.windows.first(where: { $0.windowNumber == targetWindowNumber }) else { return }

        if #available(macOS 26, *) {
            if window is TitlebarTabsTahoeTerminalWindow {
                tabGroup.removeWindow(movingWindow)
                targetWindow.addTabbedWindow(movingWindow, ordered: .below)
                relabelTabs()
                return
            }
        }

        NSAnimationContext.beginGrouping()
        NSAnimationContext.current.duration = 0
        tabGroup.removeWindow(movingWindow)
        targetWindow.addTabbedWindow(movingWindow, ordered: .below)
        NSAnimationContext.endGrouping()

        relabelTabs()
    }

    private func moveNativeTabAfter(movingWindowNumber: Int, targetWindowNumber: Int) {
        guard movingWindowNumber != targetWindowNumber else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }
        guard let movingWindow = tabGroup.windows.first(where: { $0.windowNumber == movingWindowNumber }) else { return }
        guard let targetWindow = tabGroup.windows.first(where: { $0.windowNumber == targetWindowNumber }) else { return }

        if #available(macOS 26, *) {
            if window is TitlebarTabsTahoeTerminalWindow {
                tabGroup.removeWindow(movingWindow)
                targetWindow.addTabbedWindow(movingWindow, ordered: .above)
                relabelTabs()
                return
            }
        }

        NSAnimationContext.beginGrouping()
        NSAnimationContext.current.duration = 0
        tabGroup.removeWindow(movingWindow)
        targetWindow.addTabbedWindow(movingWindow, ordered: .above)
        NSAnimationContext.endGrouping()

        relabelTabs()
    }

    private func fixTabBar() {
        // We do this to make sure that the tab bar will always re-composite. If we don't,
        // then the it will "drag" pieces of the background with it when a transparent
        // window is moved around.
        //
        // There might be a better way to make the tab bar "un-lazy", but I can't find it.
        if let window = window, !window.isOpaque {
            window.isOpaque = true
            window.isOpaque = false
        }
    }

    @objc private func onFrameDidChange(_ notification: NSNotification) {
        // This is a huge hack to set the proper shortcut for tab selection
        // on tab reordering using the mouse. There is no event, delegate, etc.
        // as far as I can tell for when a tab is manually reordered with the
        // mouse in a macOS-native tab group, so the way we detect it is setting
        // the accessoryView "postsFrameChangedNotification" to true, listening
        // for the view frame to change, comparing the windows list, and
        // relabeling the tabs.
        guard tabListenForFrame else { return }
        guard let v = self.window?.tabbedWindows?.hashValue else { return }
        guard tabWindowsHash != v else { return }
        tabWindowsHash = v
        self.relabelTabs()
    }

    override func syncAppearance() {
        // When our focus changes, we update our window appearance based on the
        // currently focused surface.
        guard let focusedSurface else { return }
        syncAppearance(focusedSurface.derivedConfig)
    }

    private func syncAppearance(_ surfaceConfig: Ghostty.SurfaceView.DerivedConfig) {
        // Let our window handle its own appearance
        guard let window = window as? TerminalWindow else { return }

        // Sync our zoom state for splits
        window.surfaceIsZoomed = surfaceTree.zoomed != nil

        // Set the font for the window and tab titles.
        if let titleFontName = surfaceConfig.windowTitleFontFamily {
            let font = NSFont(name: titleFontName, size: NSFont.systemFontSize)
            window.titlebarFont = font
            lastTitlebarFont = font
        } else {
            window.titlebarFont = nil
            lastTitlebarFont = nil
        }

        // Call this last in case it uses any of the properties above.
        window.syncAppearance(surfaceConfig)
    }

    /// Adjusts the given frame for the configured window position.
    func adjustForWindowPosition(frame: NSRect, on screen: NSScreen) -> NSRect {
        guard let x = derivedConfig.windowPositionX else { return frame }
        guard let y = derivedConfig.windowPositionY else { return frame }

        // Convert top-left coordinates to bottom-left origin using our utility extension
        let origin = screen.origin(
            fromTopLeftOffsetX: CGFloat(x),
            offsetY: CGFloat(y),
            windowSize: frame.size)

        // Clamp the origin to ensure the window stays fully visible on screen
        var safeOrigin = origin
        let vf = screen.visibleFrame
        safeOrigin.x = min(max(safeOrigin.x, vf.minX), vf.maxX - frame.width)
        safeOrigin.y = min(max(safeOrigin.y, vf.minY), vf.maxY - frame.height)

        // Return our new origin
        var result = frame
        result.origin = safeOrigin
        return result
    }

    /// This is called anytime a node in the surface tree is being removed.
    override func closeSurface(
        _ node: SplitTree<Ghostty.SurfaceView>.Node,
        withConfirmation: Bool = true
    ) {
        // If this isn't the root then we're dealing with a split closure.
        if surfaceTree.root != node {
            super.closeSurface(node, withConfirmation: withConfirmation)
            return
        }

        // More than 1 window means we have tabs and we're closing a tab
        if window?.tabGroup?.windows.count ?? 0 > 1 {
            closeTab(nil)
            return
        }

        // 1 window, closing the window
        closeWindow(nil)
    }

    func closeTabImmediately(registerRedo: Bool = true) {
        guard let window = window else { return }
        guard let tabGroup = window.tabGroup,
                tabGroup.windows.count > 1 else {
            closeWindowImmediately()
            return
        }

        // Undo
        if let undoManager, let undoState {
            // Register undo action to restore the tab
            undoManager.setActionName("Close Tab")
            undoManager.registerUndo(
                withTarget: ghostty,
                expiresAfter: undoExpiration
            ) { ghostty in
                let newController = TerminalController(ghostty, with: undoState)

                if registerRedo {
                    undoManager.registerUndo(
                        withTarget: newController,
                        expiresAfter: newController.undoExpiration
                    ) { target in
                        target.closeTabImmediately()
                    }
                }
            }
        }

        window.close()
    }

    private func closeOtherTabsImmediately() {
        guard let window = window else { return }
        guard let tabGroup = window.tabGroup else { return }
        guard tabGroup.windows.count > 1 else { return }

        // Start an undo grouping
        if let undoManager {
            undoManager.beginUndoGrouping()
        }
        defer {
            undoManager?.endUndoGrouping()
        }

        // Iterate through all tabs except the current one.
        for window in tabGroup.windows where window != self.window {
            // We ignore any non-terminal tabs. They don't currently exist and we can't
            // properly undo them anyways so I'd rather ignore them and get a bug report
            // later if and when we introduce non-terminal tabs.
            if let controller = window.windowController as? TerminalController {
                // We must not register a redo, because it messes with our own redo
                // that we register later.
                controller.closeTabImmediately(registerRedo: false)
            }
        }

        if let undoManager {
            undoManager.setActionName("Close Other Tabs")

            // We need to register an undo that refocuses this window. Otherwise, the
            // undo operation above for each tab will steal focus.
            undoManager.registerUndo(
                withTarget: self,
                expiresAfter: undoExpiration
            ) { target in
                DispatchQueue.main.async {
                    target.window?.makeKeyAndOrderFront(nil)
                }

                // Register redo action
                undoManager.registerUndo(
                    withTarget: target,
                    expiresAfter: target.undoExpiration
                ) { target in
                    target.closeOtherTabsImmediately()
                }
            }
        }
    }

    private func closeTabsOnTheRightImmediately() {
        guard let window = window else { return }
        guard let tabGroup = window.tabGroup else { return }
        guard let currentIndex = tabGroup.windows.firstIndex(of: window) else { return }

        let tabsToClose = tabGroup.windows.enumerated().filter { $0.offset > currentIndex }
        guard !tabsToClose.isEmpty else { return }

        undoManager?.beginUndoGrouping()
        defer {
            undoManager?.endUndoGrouping()
        }

        for (_, candidate) in tabsToClose {
            if let controller = candidate.windowController as? TerminalController {
                controller.closeTabImmediately(registerRedo: false)
            }
        }

        if let undoManager {
            undoManager.setActionName("Close Tabs to the Right")

            undoManager.registerUndo(
                withTarget: self,
                expiresAfter: undoExpiration
            ) { target in
                DispatchQueue.main.async {
                    target.window?.makeKeyAndOrderFront(nil)
                }

                undoManager.registerUndo(
                    withTarget: target,
                    expiresAfter: target.undoExpiration
                ) { target in
                    target.closeTabsOnTheRightImmediately()
                }
            }
        }
    }

    /// Closes the current window (including any other tabs) immediately and without
    /// confirmation. This will setup proper undo state so the action can be undone.
    func closeWindowImmediately() {
        guard let window = window else { return }

        registerUndoForCloseWindow()

        if let tabGroup = window.tabGroup, tabGroup.windows.count > 1 {
            tabGroup.windows.forEach { window in
                // Clear out the surfacetree to ensure there is no undo state.
                // This prevents unnecessary undos registered since AppKit may
                // process them on later ticks so we can't just disable undo registration.
                if let controller = window.windowController as? TerminalController {
                    controller.surfaceTree = .init()
                }

                window.close()
            }
        } else {
            window.close()
        }
    }

    /// Registers undo for closing window(s), handling both single windows and tab groups.
    private func registerUndoForCloseWindow() {
        guard let undoManager, undoManager.isUndoRegistrationEnabled else { return }
        guard let window else { return }

        // If we don't have a tab group or we don't have multiple tabs, then
        // do a normal single window close.
        guard let tabGroup = window.tabGroup,
              tabGroup.windows.count > 1 else {
            // No tabs, just save this window's state
            if let undoState {
                // Register undo action to restore the window
                undoManager.setActionName("Close Window")
                undoManager.registerUndo(
                    withTarget: ghostty,
                    expiresAfter: undoExpiration) { ghostty in
                        // Restore the undo state
                        let newController = TerminalController(ghostty, with: undoState)

                        // Register redo action
                        undoManager.registerUndo(
                            withTarget: newController,
                            expiresAfter: newController.undoExpiration) { target in
                                target.closeWindowImmediately()
                            }
                    }
            }

            return
        }

        // Multiple windows in tab group - collect all undo states in sorted order
        // by tab ordering. Also track which window was key.
        let undoStates = tabGroup.windows
            .compactMap { tabWindow -> UndoState? in
                guard let controller = tabWindow.windowController as? TerminalController,
                      var undoState = controller.undoState else { return nil }
                // Clear the tab group reference since it is unneeded. It should be
                // garbage collected but we want to be extra sure we don't try to
                // restore into it because we're going to recreate it.
                undoState.tabGroup = nil
                return undoState
            }
            .sorted { (lhs, rhs) in
                switch (lhs.tabIndex, rhs.tabIndex) {
                case let (l?, r?): return l < r
                case (_?, nil): return true
                case (nil, _?): return false
                case (nil, nil): return true
                }
            }

        // Find the index of the key window in our sorted states. This is a bit verbose
        // but we only need this for this style of undo so we don't want to add it to
        // UndoState.
        let keyWindowIndex: Int?
        if let keyWindow = tabGroup.windows.first(where: { $0.isKeyWindow }),
            let keyController = keyWindow.windowController as? TerminalController,
            let keyUndoState = keyController.undoState {
            keyWindowIndex = undoStates.firstIndex {
                $0.tabIndex == keyUndoState.tabIndex }
        } else {
            keyWindowIndex = nil
        }

        // Register undo action to restore all windows
        guard !undoStates.isEmpty else { return }

        undoManager.setActionName("Close Window")
        undoManager.registerUndo(
            withTarget: ghostty,
            expiresAfter: undoExpiration
        ) { ghostty in
            // Restore all windows in the tab group
            let controllers = undoStates.map { undoState in
                TerminalController(ghostty, with: undoState)
            }

            // The first controller becomes the parent window for all tabs.
            // If we don't have a first controller (shouldn't be possible?)
            // then we can't restore tabs.
            guard let firstController = controllers.first else { return }

            // Add all subsequent controllers as tabs to the first window
            for controller in controllers.dropFirst() {
                controller.showWindow(nil)
                if let firstWindow = firstController.window,
                   let newWindow = controller.window {
                    firstWindow.addTabbedWindow(newWindow, ordered: .above)
                }
            }

            // Make the appropriate window key. If we had a key window, restore it.
            // Otherwise, make the last window key.
            if let keyWindowIndex, keyWindowIndex < controllers.count {
                controllers[keyWindowIndex].window?.makeKeyAndOrderFront(nil)
            } else {
                controllers.last?.window?.makeKeyAndOrderFront(nil)
            }

            // Register redo action on the first controller
            undoManager.registerUndo(
                withTarget: firstController,
                expiresAfter: firstController.undoExpiration
            ) { target in
                target.closeWindowImmediately()
            }
        }
    }

    /// Close all windows, asking for confirmation if necessary.
    static func closeAllWindows() {
        // The window we use for confirmations. Try to find the first window that
        // needs quit confirmation. This lets us attach the confirmation to something
        // that is running.
        guard let confirmWindow = all
            .first(where: { $0.surfaceTree.contains(where: { $0.needsConfirmQuit }) })?
            .surfaceTree.first(where: { $0.needsConfirmQuit })?
            .window
        else {
            closeAllWindowsImmediately()
            return
        }

        let alert = NSAlert()
        alert.messageText = "Close All Windows?"
        alert.informativeText = "All terminal sessions will be terminated."
        alert.addButton(withTitle: "Close All Windows")
        alert.addButton(withTitle: "Cancel")
        alert.alertStyle = .warning
        alert.beginSheetModal(for: confirmWindow, completionHandler: { response in
            if response == .alertFirstButtonReturn {
                // This is important so that we avoid losing focus when Stage
                // Manager is used (#8336)
                alert.window.orderOut(nil)
                closeAllWindowsImmediately()
            }
        })
    }

    static private func closeAllWindowsImmediately() {
        let undoManager = (NSApp.delegate as? AppDelegate)?.undoManager
        undoManager?.beginUndoGrouping()
        all.forEach { $0.closeWindowImmediately() }
        undoManager?.setActionName("Close All Windows")
        undoManager?.endUndoGrouping()
    }

    // MARK: Undo/Redo

    /// The state that we require to recreate a TerminalController from an undo.
    struct UndoState {
        let frame: NSRect
        let surfaceTree: SplitTree<Ghostty.SurfaceView>
        let focusedSurface: UUID?
        let tabIndex: Int?
        weak var tabGroup: NSWindowTabGroup?
        let tabColor: TerminalTabColor
    }

    convenience init(_ ghostty: Ghostty.App, with undoState: UndoState) {
        self.init(ghostty, withSurfaceTree: undoState.surfaceTree)

        // Show the window and restore its frame
        showWindow(nil)
        if let window {
            window.setFrame(undoState.frame, display: true)
            if let terminalWindow = window as? TerminalWindow {
                terminalWindow.tabColor = undoState.tabColor
            }

            // If we have a tab group and index, restore the tab to its original position
            if let tabGroup = undoState.tabGroup,
               let tabIndex = undoState.tabIndex {
                if tabIndex < tabGroup.windows.count {
                    // Find the window that is currently at that index
                    let currentWindow = tabGroup.windows[tabIndex]
                    currentWindow.addTabbedWindow(window, ordered: .below)
                } else {
                    tabGroup.windows.last?.addTabbedWindow(window, ordered: .above)
                }

                // Make it the key window
                window.makeKeyAndOrderFront(nil)
            }

            // Restore focus to the previously focused surface
            if let focusedUUID = undoState.focusedSurface,
               let focusTarget = surfaceTree.first(where: { $0.id == focusedUUID }) {
                DispatchQueue.main.async {
                    Ghostty.moveFocus(to: focusTarget, from: nil)
                }
            } else if let focusedSurface = surfaceTree.first {
                // No prior focused surface or we can't find it, let's focus
                // the first.
                self.focusedSurface = focusedSurface
                DispatchQueue.main.async {
                    Ghostty.moveFocus(to: focusedSurface, from: nil)
                }
            }
        }
    }

    /// The current undo state for this controller
    var undoState: UndoState? {
        guard let window else { return nil }
        guard !surfaceTree.isEmpty else { return nil }
        return .init(
            frame: window.frame,
            surfaceTree: surfaceTree,
            focusedSurface: focusedSurface?.id,
            tabIndex: window.tabGroup?.windows.firstIndex(of: window),
            tabGroup: window.tabGroup,
            tabColor: (window as? TerminalWindow)?.tabColor ?? .none)
    }

    // MARK: - NSWindowController

    override func windowWillLoad() {
        // We do NOT want to cascade because we handle this manually from the manager.
        shouldCascadeWindows = false
    }

    override func windowDidLoad() {
        super.windowDidLoad()
        guard let window else { return }

        // I copy this because we may change the source in the future but also because
        // I regularly audit our codebase for "ghostty.config" access because generally
        // you shouldn't use it. Its safe in this case because for a new window we should
        // use whatever the latest app-level config is.
        let config = ghostty.config

        // Setting all three of these is required for restoration to work.
        window.isRestorable = restorable
        if restorable {
            window.restorationClass = TerminalWindowRestoration.self
            window.identifier = .init(String(describing: TerminalWindowRestoration.self))
        }

        // If we have only a single surface (no splits) and there is a default size then
        // we should resize to that default size.
        if case let .leaf(view) = surfaceTree.root {
            // If this is our first surface then our focused surface will be nil
            // so we force the focused surface to the leaf.
            focusedSurface = view
        }

        // Initialize our content view to the SwiftUI root
        let worktrunkStore = (NSApp.delegate as? AppDelegate)?.worktrunkStore ?? WorktrunkStore()
        window.contentView = TerminalWorkspaceViewContainer(
            ghostty: self.ghostty,
            viewModel: self,
            delegate: self,
            worktrunkStore: worktrunkStore,
            worktrunkSidebarState: worktrunkSidebarState,
            openTabsModel: openTabsModel,
            gitDiffSidebarState: gitDiffSidebarState,
            openWorktree: { [weak self] path in
                self?.openWorktree(atPath: path)
            },
            openWorktreeAgent: { [weak self] path, agent in
                self?.openWorktreeAgentSession(atPath: path, agent: agent)
            },
            resumeSession: { [weak self] session in
                self?.resumeAISession(session)
            },
            focusNativeTab: { [weak self] windowNumber in
                self?.focusNativeTab(windowNumber: windowNumber)
            },
            moveNativeTabBefore: { [weak self] moving, target in
                self?.moveNativeTabBefore(movingWindowNumber: moving, targetWindowNumber: target)
            },
            moveNativeTabAfter: { [weak self] moving, target in
                self?.moveNativeTabAfter(movingWindowNumber: moving, targetWindowNumber: target)
            },
            onSidebarWidthChange: { [weak self] width in
                self?.updateWorktrunkTitlebarWidth(width)
            },
            onGitDiffWorktreeSelect: { [weak self] path in
                self?.onWorktrunkSelectionChange(path)
            }
        )
        installWorktrunkTitlebar()
        installWorktrunkSidebarSync()

        // If we have a default size, we want to apply it.
        if let defaultSize {
            switch defaultSize {
            case .frame:
                // Frames can be applied immediately
                defaultSize.apply(to: window)

            case .contentIntrinsicSize:
                // Content intrinsic size requires a short delay so that AppKit
                // can layout our SwiftUI views.
                DispatchQueue.main.asyncAfter(deadline: .now() + .microseconds(10_000)) { [weak self, weak window] in
                    guard let self, let window else { return }
                    defaultSize.apply(to: window)
                    if let screen = window.screen ?? NSScreen.main {
                        let frame = self.adjustForWindowPosition(frame: window.frame, on: screen)
                        window.setFrameOrigin(frame.origin)
                    }
                }
            }
        }

        // Store our initial frame so we can know our default later. This MUST
        // be after the defaultSize call above so that we don't re-apply our frame.
        // Note: we probably want to set this on the first frame change or something
        // so it respects cascade.
        initialFrame = window.frame

        // In various situations, macOS automatically tabs new windows. Ghostty handles
        // its own tabbing so we DONT want this behavior. This detects this scenario and undoes
        // it.
        //
        // Example scenarios where this happens:
        //   - When the system user tabbing preference is "always"
        //   - When the "+" button in the tab bar is clicked
        //
        // We don't run this logic in fullscreen because in fullscreen this will end up
        // removing the window and putting it into its own dedicated fullscreen, which is not
        // the expected or desired behavior of anyone I've found.
        if !window.styleMask.contains(.fullScreen) {
            // If we have more than 1 window in our tab group we know we're a new window.
            // Since Ghostty manages tabbing manually this will never be more than one
            // at this point in the AppKit lifecycle (we add to the group after this).
            if let tabGroup = window.tabGroup, tabGroup.windows.count > 1 {
                window.tabGroup?.removeWindow(window)
            }
        }

        // Apply any additional appearance-related properties to the new window. We
        // apply this based on the root config but change it later based on surface
        // config (see focused surface change callback).
        syncAppearance(.init(config))

        openTabsModel.refresh(for: window)
    }

    private func installWorktrunkSidebarSync() {
        guard worktrunkSidebarSyncCancellables.isEmpty else { return }

        worktrunkSidebarState.$columnVisibility
            .removeDuplicates()
            .sink { [weak self] visibility in
                if visibility == .detailOnly {
                    self?.updateWorktrunkTitlebarWidth(0)
                }
                self?.syncWorktrunkSidebarVisibilityToTabGroup(visibility)
            }
            .store(in: &worktrunkSidebarSyncCancellables)

        worktrunkSidebarState.$expandedRepoIDs
            .removeDuplicates()
            .debounce(for: .milliseconds(75), scheduler: RunLoop.main)
            .sink { [weak self] expandedRepoIDs in
                self?.syncWorktrunkSidebarExpandedRepoIDsToTabGroup(expandedRepoIDs)
            }
            .store(in: &worktrunkSidebarSyncCancellables)

        worktrunkSidebarState.$expandedWorktreePaths
            .removeDuplicates()
            .debounce(for: .milliseconds(75), scheduler: RunLoop.main)
            .sink { [weak self] expandedWorktreePaths in
                self?.syncWorktrunkSidebarExpandedWorktreePathsToTabGroup(expandedWorktreePaths)
            }
            .store(in: &worktrunkSidebarSyncCancellables)

        worktrunkSidebarState.$selection
            .removeDuplicates()
            .sink { [weak self] selection in
                self?.syncWorktrunkSidebarSelectionToTabGroup(selection)
            }
            .store(in: &worktrunkSidebarSyncCancellables)
    }

    private func syncWorktrunkSidebarVisibilityToTabGroup(_ visibility: NavigationSplitViewVisibility) {
        guard !worktrunkSidebarSyncApplyingRemoteUpdate else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }

        for sibling in tabGroup.windows where sibling != window {
            guard let controller = sibling.windowController as? TerminalController else { continue }
            controller.applySyncedWorktrunkSidebarVisibility(visibility)
        }
    }

    private func syncWorktrunkSidebarExpandedRepoIDsToTabGroup(_ expandedRepoIDs: Set<UUID>) {
        guard !worktrunkSidebarSyncApplyingRemoteUpdate else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }

        for sibling in tabGroup.windows where sibling != window {
            guard let controller = sibling.windowController as? TerminalController else { continue }
            controller.applySyncedWorktrunkSidebarExpandedRepoIDs(expandedRepoIDs)
        }
    }

    private func syncWorktrunkSidebarExpandedWorktreePathsToTabGroup(_ expandedWorktreePaths: Set<String>) {
        guard !worktrunkSidebarSyncApplyingRemoteUpdate else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }

        for sibling in tabGroup.windows where sibling != window {
            guard let controller = sibling.windowController as? TerminalController else { continue }
            controller.applySyncedWorktrunkSidebarExpandedWorktreePaths(expandedWorktreePaths)
        }
    }

    private func syncWorktrunkSidebarSelectionToTabGroup(_ selection: SidebarSelection?) {
        guard !worktrunkSidebarSyncApplyingRemoteUpdate else { return }
        guard let window else { return }
        guard let tabGroup = window.tabGroup, tabGroup.windows.count > 1 else { return }

        for sibling in tabGroup.windows where sibling != window {
            guard let controller = sibling.windowController as? TerminalController else { continue }
            controller.applySyncedWorktrunkSidebarSelection(selection)
        }
    }

    private func currentWorktrunkSidebarListMode() -> WorktrunkSidebarListMode {
        (NSApp.delegate as? AppDelegate)?.worktrunkStore.sidebarListMode ?? .flatWorktrees
    }

    private func applySyncedWorktrunkSidebarVisibility(_ visibility: NavigationSplitViewVisibility) {
        guard worktrunkSidebarState.columnVisibility != visibility else { return }
        worktrunkSidebarState.isApplyingRemoteUpdate = true
        worktrunkSidebarSyncApplyingRemoteUpdate = true
        defer {
            worktrunkSidebarSyncApplyingRemoteUpdate = false
            worktrunkSidebarState.isApplyingRemoteUpdate = false
        }
        worktrunkSidebarState.columnVisibility = visibility
    }

    private func applySyncedWorktrunkSidebarExpandedRepoIDs(_ expandedRepoIDs: Set<UUID>) {
        guard worktrunkSidebarState.expandedRepoIDs != expandedRepoIDs else { return }
        worktrunkSidebarState.isApplyingRemoteUpdate = true
        worktrunkSidebarSyncApplyingRemoteUpdate = true
        defer {
            worktrunkSidebarSyncApplyingRemoteUpdate = false
            worktrunkSidebarState.isApplyingRemoteUpdate = false
        }
        worktrunkSidebarState.applyExpandedRepoIDs(expandedRepoIDs, listMode: currentWorktrunkSidebarListMode())
    }

    private func applySyncedWorktrunkSidebarExpandedWorktreePaths(_ expandedWorktreePaths: Set<String>) {
        guard worktrunkSidebarState.expandedWorktreePaths != expandedWorktreePaths else { return }
        worktrunkSidebarState.isApplyingRemoteUpdate = true
        worktrunkSidebarSyncApplyingRemoteUpdate = true
        defer {
            worktrunkSidebarSyncApplyingRemoteUpdate = false
            worktrunkSidebarState.isApplyingRemoteUpdate = false
        }
        worktrunkSidebarState.applyExpandedWorktreePaths(
            expandedWorktreePaths,
            listMode: currentWorktrunkSidebarListMode()
        )
    }

    private func applySyncedWorktrunkSidebarSelection(_ selection: SidebarSelection?) {
        guard worktrunkSidebarState.selection != selection else { return }
        worktrunkSidebarState.isApplyingRemoteUpdate = true
        worktrunkSidebarSyncApplyingRemoteUpdate = true
        defer {
            worktrunkSidebarSyncApplyingRemoteUpdate = false
            worktrunkSidebarState.isApplyingRemoteUpdate = false
        }
        worktrunkSidebarState.selection = selection
    }

    private func syncWorktrunkSidebarStateToTabGroup() {
        syncWorktrunkSidebarVisibilityToTabGroup(worktrunkSidebarState.columnVisibility)
        syncWorktrunkSidebarExpandedRepoIDsToTabGroup(worktrunkSidebarState.expandedRepoIDs)
        syncWorktrunkSidebarExpandedWorktreePathsToTabGroup(worktrunkSidebarState.expandedWorktreePaths)
        syncWorktrunkSidebarSelectionToTabGroup(worktrunkSidebarState.selection)
    }

    private func syncSidebarSelectionToActiveTab() {
        guard WorktrunkPreferences.worktreeTabsEnabled,
              let rootPath = worktreeTabRootPath,
              let appDelegate = NSApp.delegate as? AppDelegate else { return }

        let store = appDelegate.worktrunkStore
        for repo in store.repositories {
            if store.worktrees(for: repo.id).contains(where: { $0.path == rootPath }) {
                let newSelection = SidebarSelection.worktree(repoID: repo.id, path: rootPath)
                guard worktrunkSidebarState.selection != newSelection else { return }
                applySyncedWorktrunkSidebarSelection(newSelection)
                syncWorktrunkSidebarSelectionToTabGroup(newSelection)
                return
            }
        }
    }

    private func installWorktrunkTitlebar() {
        guard let window else { return }
        guard window.styleMask.contains(.titled) else { return }

        // TitlebarTabs windows have their own toolbar - don't override
        if window is TitlebarTabsTahoeTerminalWindow || window is TitlebarTabsVenturaTerminalWindow {
            return
        }

        // Create a WorktrunkToolbar with sidebar toggle button
        if window.toolbar == nil {
            // Add fullSizeContentView for sidebarTrackingSeparator to work
            window.styleMask.insert(.fullSizeContentView)
            let toolbar = WorktrunkToolbar(target: self)
            window.toolbar = toolbar
        }

        window.titleVisibility = .hidden
        if let terminalWindow = window as? TerminalWindow {
            terminalWindow.toolbarStyle = .unified
            if let toolbar = window.toolbar as? WorktrunkToolbar {
                toolbar.titleText = window.title
                toolbar.titleTextFont = terminalWindow.titlebarFont ?? NSFont.titleBarFont(ofSize: NSFont.systemFontSize)
                toolbar.titleTextColor = window.isKeyWindow ? .labelColor : .secondaryLabelColor
            }
        }
    }

    @objc func toggleWorktrunkSidebar(_ sender: Any?) {
        switch worktrunkSidebarState.columnVisibility {
        case .detailOnly:
            worktrunkSidebarState.columnVisibility = .all
        default:
            worktrunkSidebarState.columnVisibility = .detailOnly
        }
    }

    @objc func toggleSidebar(_ sender: Any?) {
        toggleWorktrunkSidebar(sender)
    }

    private func updateWorktrunkTitlebarWidth(_ newValue: CGFloat) {
        if let window = window as? TitlebarTabsTahoeTerminalWindow {
            window.updateWorktrunkSidebarWidth(max(0, newValue))
            return
        }
        if let window = window as? TitlebarTabsVenturaTerminalWindow {
            window.updateWorktrunkSidebarWidth(max(0, newValue))
            return
        }
    }

    private func openWorktree(atPath path: String) {
        if WorktrunkPreferences.worktreeTabsEnabled {
            openWorktreeTabSession(worktreePath: path, baseConfig: Ghostty.SurfaceConfiguration())
            return
        }

        if focusOpenWorktree(atPath: path) {
            return
        }

        let behavior: WorktrunkOpenBehavior = {
            let raw = UserDefaults.standard.string(forKey: WorktrunkPreferences.openBehaviorKey) ?? ""
            return WorktrunkOpenBehavior(rawValue: raw) ?? .newTab
        }()

        var base = Ghostty.SurfaceConfiguration()
        base.workingDirectory = path

        switch behavior {
        case .newTab:
            _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)

        case .splitRight:
            if let focusedSurface {
                if newSplit(at: focusedSurface, direction: .right, baseConfig: base) == nil {
                    _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
                }
            } else {
                _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
            }

        case .splitDown:
            if let focusedSurface {
                if newSplit(at: focusedSurface, direction: .down, baseConfig: base) == nil {
                    _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
                }
            } else {
                _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
            }
        }
    }

    private func openWorktreeAgentSession(atPath path: String, agent: WorktrunkAgent) {
        guard agent.isAvailable else { return }

        var base = Ghostty.SurfaceConfiguration()
        base.workingDirectory = path
        base.command = agent.command
        TerminalAgentHooks.apply(to: &base)

        if WorktrunkPreferences.worktreeTabsEnabled {
            openWorktreeTabSession(worktreePath: path, baseConfig: base)
            return
        }

        let behavior: WorktrunkOpenBehavior = {
            let raw = UserDefaults.standard.string(forKey: WorktrunkPreferences.openBehaviorKey) ?? ""
            return WorktrunkOpenBehavior(rawValue: raw) ?? .newTab
        }()

        switch behavior {
        case .newTab:
            _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)

        case .splitRight:
            if let focusedSurface {
                if newSplit(at: focusedSurface, direction: .right, baseConfig: base) == nil {
                    _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
                }
            } else {
                _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
            }

        case .splitDown:
            if let focusedSurface {
                if newSplit(at: focusedSurface, direction: .down, baseConfig: base) == nil {
                    _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
                }
            } else {
                _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
            }
        }
    }

    private func onWorktrunkSelectionChange(_ path: String?) {
        if #available(macOS 26.0, *) {
            Task { await gitDiffSidebarState.setSelectedWorktreePath(path) }
        }

        guard let path else { return }

        if WorktrunkPreferences.worktreeTabsEnabled {
            // Worktree-tabs mode: use the controller registry for direct lookup
            if let controller = Self.existingWorktreeTabController(forWorktreePath: path) {
                controller.window?.makeKeyAndOrderFront(nil)
                return
            }
        }

        // Fallback / non-worktree-tabs mode: scan surfaces by pwd
        focusOpenWorktree(atPath: path)
    }

    @objc func toggleGitDiffSidebar(_ sender: Any?) {
        guard #available(macOS 26.0, *) else { return }
        let willShow = !gitDiffSidebarState.isVisible
        Task {
            let selectedWorktreePath: String? = {
                switch worktrunkSidebarState.selection {
                case .worktree(_, let path):
                    return path
                case .session(_, _, let worktreePath):
                    return worktreePath
                default:
                    return nil
                }
            }()

            if willShow {
                gitDiffSidebarState.selectedWorktreePath = selectedWorktreePath
            }

            await gitDiffSidebarState.setVisible(
                willShow,
                cwd: selectedWorktreePath ?? focusedSurface?.pwd
            )
            if let window = window as? TerminalWindow {
                window.titlebarFont = lastTitlebarFont
            }
        }
    }

    @objc func closeGitDiff(_ sender: Any?) {
        guard #available(macOS 26.0, *) else { return }
        Task { await gitDiffSidebarState.setVisible(false, cwd: nil) }
    }

    private func resumeAISession(_ session: AISession) {
        var base = Ghostty.SurfaceConfiguration()
        base.workingDirectory = session.cwd

        switch session.source {
        case .claude:
            // Claude needs to run from the cwd (set via workingDirectory)
            base.command = "claude --resume \(session.id)"
        case .codex:
            // Codex handles cwd internally
            base.command = "codex resume \(session.id)"
        case .opencode:
            base.command = "opencode --session \(session.id)"
        }

        if WorktrunkPreferences.worktreeTabsEnabled {
            openWorktreeTabSession(worktreePath: session.worktreePath, baseConfig: base)
            return
        }

        _ = TerminalController.newTab(ghostty, from: window, withBaseConfig: base)
    }

    private func focusOpenWorktree(atPath path: String) -> Bool {
        let target = URL(fileURLWithPath: path).standardizedFileURL.path
        let targetPrefix = target.hasSuffix("/") ? target : (target + "/")

        for window in NSApp.windows {
            guard let controller = window.windowController as? TerminalController else { continue }

            for surfaceView in controller.surfaceTree {
                guard let pwd = surfaceView.pwd else { continue }
                let pwdPath = URL(fileURLWithPath: pwd).standardizedFileURL.path
                if pwdPath == target || pwdPath.hasPrefix(targetPrefix) {
                    controller.focusSurface(surfaceView)
                    return true
                }
            }
        }

        return false
    }

    // Shows the "+" button in the tab bar, responds to that click.
    override func newWindowForTab(_ sender: Any?) {
        // Trigger the ghostty core event logic for a new tab.
        guard let surface = self.focusedSurface?.surface else { return }
        ghostty.newTab(surface: surface)
    }

    // MARK: NSWindowDelegate

    // TabGroupCloseCoordinator.Controller
    lazy private(set) var tabGroupCloseCoordinator = TabGroupCloseCoordinator()

    override func windowShouldClose(_ sender: NSWindow) -> Bool {
        tabGroupCloseCoordinator.windowShouldClose(sender) { [weak self] scope in
            guard let self else { return }
            switch scope {
            case .tab: closeTab(nil)
            case .window:
                guard self.window?.isFirstWindowInTabGroup ?? false else { return }
                closeWindow(nil)
            }
        }

        // We will always explicitly close the window using the above
        return false
    }

    override func windowWillClose(_ notification: Notification) {
        super.windowWillClose(notification)
        self.relabelTabs()

        // If we remove a window, we reset the cascade point to the key window so that
        // the next window cascade's from that one.
        if let focusedWindow = NSApplication.shared.keyWindow {
            // If we are NOT the focused window, then we are a tabbed window. If we
            // are closing a tabbed window, we want to set the cascade point to be
            // the next cascade point from this window.
            if focusedWindow != window {
                // The cascadeTopLeft call below should NOT move the window. Starting with
                // macOS 15, we found that specifically when used with the new window snapping
                // features of macOS 15, this WOULD move the frame. So we keep track of the
                // old frame and restore it if necessary. Issue:
                // https://github.com/ghostty-org/ghostty/issues/2565
                let oldFrame = focusedWindow.frame

                Self.lastCascadePoint = focusedWindow.cascadeTopLeft(from: .zero)

                if focusedWindow.frame != oldFrame {
                    focusedWindow.setFrame(oldFrame, display: true)
                }

                return
            }

            // If we are the focused window, then we set the last cascade point to
            // our own frame so that it shows up in the same spot.
            let frame = focusedWindow.frame
            Self.lastCascadePoint = NSPoint(x: frame.minX, y: frame.maxY)
        }
    }

    override func windowDidBecomeKey(_ notification: Notification) {
        super.windowDidBecomeKey(notification)
        self.relabelTabs()
        self.fixTabBar()
        requestTabSwitchRefresh()
    }

    override func windowDidMove(_ notification: Notification) {
        super.windowDidMove(notification)
        self.fixTabBar()

        // Whenever we move save our last position for the next start.
        if let window {
            LastWindowPosition.shared.save(window)
        }
    }

    func windowDidBecomeMain(_ notification: Notification) {
        // Whenever we get focused, use that as our last window position for
        // restart. This differs from Terminal.app but matches iTerm2 behavior
        // and I think its sensible.
        if let window {
            LastWindowPosition.shared.save(window)
        }

        // Remember our last main
        Self.lastMain = self
    }

    // Called when the window will be encoded. We handle the data encoding here in the
    // window controller.
    func window(_ window: NSWindow, willEncodeRestorableState state: NSCoder) {
        if RestorablePath.existingDirectoryURL(window.representedURL) == nil {
            window.representedURL = nil
        }

        let data = TerminalRestorableState(from: self)
        data.encode(with: state)
    }

    // MARK: First Responder

    @IBAction func newWindow(_ sender: Any?) {
        guard let surface = focusedSurface?.surface else { return }
        ghostty.newWindow(surface: surface)
    }

    @IBAction func newTab(_ sender: Any?) {
        guard let surface = focusedSurface?.surface else { return }
        if WorktrunkPreferences.sidebarTabsEnabled {
            // Sidebar tabs mode owns tab creation. Do not allow native titlebar tabs.
            if WorktrunkPreferences.worktreeTabsEnabled, worktreeTabRootPath != nil {
                openWorktreeTabNewSession(baseConfig: Ghostty.SurfaceConfiguration())
            } else {
                ghostty.newWindow(surface: surface)
            }
            return
        }

        ghostty.newTab(surface: surface)
    }

    @IBAction func closeTab(_ sender: Any?) {
        guard let window = window else { return }
        guard window.tabGroup?.windows.count ?? 0 > 1 else {
            closeWindow(sender)
            return
        }

        guard surfaceTree.contains(where: { $0.needsConfirmQuit }) else {
            closeTabImmediately()
            return
        }

        confirmClose(
            messageText: "Close Tab?",
            informativeText: "The terminal still has a running process. If you close the tab the process will be killed."
        ) {
            self.closeTabImmediately()
        }
    }

    @IBAction func closeOtherTabs(_ sender: Any?) {
        guard let window = window else { return }
        guard let tabGroup = window.tabGroup else { return }

        // If we only have one window then we have no other tabs to close
        guard tabGroup.windows.count > 1 else { return }

        // Check if we have to confirm close.
        guard tabGroup.windows.contains(where: { window in
            // Ignore ourself
            if window == self.window { return false }

            // Ignore non-terminals
            guard let controller = window.windowController as? TerminalController else {
                return false
            }

            // Check if any surfaces require confirmation
            return controller.surfaceTree.contains(where: { $0.needsConfirmQuit })
        }) else {
            self.closeOtherTabsImmediately()
            return
        }

        confirmClose(
            messageText: "Close Other Tabs?",
            informativeText: "At least one other tab still has a running process. If you close the tab the process will be killed."
        ) {
            self.closeOtherTabsImmediately()
        }
    }

    @IBAction func closeTabsOnTheRight(_ sender: Any?) {
        guard let window = window else { return }
        guard let tabGroup = window.tabGroup else { return }
        guard let currentIndex = tabGroup.windows.firstIndex(of: window) else { return }

        let tabsToClose = tabGroup.windows.enumerated().filter { $0.offset > currentIndex }
        guard !tabsToClose.isEmpty else { return }

        let needsConfirm = tabsToClose.contains { (_, candidate) in
            guard let controller = candidate.windowController as? TerminalController else {
                return false
            }

            return controller.surfaceTree.contains(where: { $0.needsConfirmQuit })
        }

        if !needsConfirm {
            self.closeTabsOnTheRightImmediately()
            return
        }

        confirmClose(
            messageText: "Close Tabs on the Right?",
            informativeText: "At least one tab to the right still has a running process. If you close the tab the process will be killed."
        ) {
            self.closeTabsOnTheRightImmediately()
        }
    }

    @IBAction func returnToDefaultSize(_ sender: Any?) {
        guard let window, let defaultSize else { return }
        defaultSize.apply(to: window)
    }

    @IBAction override func closeWindow(_ sender: Any?) {
        guard let window = window else { return }

        // We need to check all the windows in our tab group for confirmation
        // if we're closing the window. If we don't have a tabgroup for any
        // reason we check ourselves.
        let windows: [NSWindow] = window.tabGroup?.windows ?? [window]
        guard let confirmController = windows
            .compactMap({ $0.windowController as? TerminalController })
            .first(where: { $0.surfaceTree.contains(where: { $0.needsConfirmQuit }) })
        else {
            closeWindowImmediately()
            return
        }

        // We call confirmClose on the proper controller so the alert is
        // attached to the window that needs confirmation.
        confirmController.confirmClose(
            messageText: "Close Window?",
            informativeText: "All terminal sessions in this window will be terminated.",
        ) {
            self.closeWindowImmediately()
        }
    }

    @IBAction func toggleGhosttyFullScreen(_ sender: Any?) {
        guard let surface = focusedSurface?.surface else { return }
        ghostty.toggleFullscreen(surface: surface)
    }

    @IBAction func toggleTerminalInspector(_ sender: Any?) {
        guard let surface = focusedSurface?.surface else { return }
        ghostty.toggleTerminalInspector(surface: surface)
    }

    // MARK: - TerminalViewDelegate

    override func focusedSurfaceDidChange(to: Ghostty.SurfaceView?) {
        super.focusedSurfaceDidChange(to: to)

        // We always cancel our event listener
        surfaceAppearanceCancellables.removeAll()

        // When our focus changes, we update our window appearance based on the
        // currently focused surface.
        guard let focusedSurface else { return }
        syncAppearance(focusedSurface.derivedConfig)

        requestTabSwitchRefresh()

        // We also want to get notified of certain changes to update our appearance.
        focusedSurface.$derivedConfig
            .sink { [weak self, weak focusedSurface] _ in self?.syncAppearanceOnPropertyChange(focusedSurface) }
            .store(in: &surfaceAppearanceCancellables)
        focusedSurface.$backgroundColor
            .sink { [weak self, weak focusedSurface] _ in self?.syncAppearanceOnPropertyChange(focusedSurface) }
            .store(in: &surfaceAppearanceCancellables)

    }

    override func pwdDidChange(to: URL?) {
        super.pwdDidChange(to: to)
        if #available(macOS 26.0, *) {
            guard let to else { return }
            Task { @MainActor in
                gitDiffSidebarState.requestRefresh(cwd: to, force: false)
            }
        }
    }

    private func syncAppearanceOnPropertyChange(_ surface: Ghostty.SurfaceView?) {
        guard let surface else { return }
        DispatchQueue.main.async { [weak self, weak surface] in
            guard let surface else { return }
            guard let self else { return }
            guard self.focusedSurface == surface else { return }
            self.syncAppearance(surface.derivedConfig)
        }
    }

    private func requestTabSwitchRefresh() {
        let now = Date()
        let currentSurfaceID = focusedSurface?.id
        if let lastTabSwitchRefreshAt,
           now.timeIntervalSince(lastTabSwitchRefreshAt) < tabSwitchRefreshThrottle {
            if currentSurfaceID == lastTabSwitchSurfaceID {
                return
            }
            scheduleTabSwitchRefresh()
            return
        }

        lastTabSwitchRefreshAt = now
        pendingTabSwitchRefresh?.cancel()
        pendingTabSwitchRefresh = nil
        performTabSwitchRefresh()
    }

    private func scheduleTabSwitchRefresh() {
        pendingTabSwitchRefresh?.cancel()
        let item = DispatchWorkItem { [weak self] in
            guard let self else { return }
            self.lastTabSwitchRefreshAt = Date()
            self.performTabSwitchRefresh()
        }
        pendingTabSwitchRefresh = item
        DispatchQueue.main.asyncAfter(deadline: .now() + tabSwitchRefreshThrottle, execute: item)
    }

    private func performTabSwitchRefresh() {
        lastTabSwitchSurfaceID = focusedSurface?.id
        syncSidebarSelectionToActiveTab()
        syncWorktrunkSidebarStateToTabGroup()
        if let appDelegate = NSApp.delegate as? AppDelegate,
           let pwd = focusedSurface?.pwd {
            appDelegate.worktrunkStore.clearAgentReviewIfViewing(cwd: pwd)
        }

        if #available(macOS 26.0, *) {
            // Git diff should be ready for the active tab without requiring any Worktrunk interaction.
            if gitDiffSidebarState.isVisible,
               let pwd = focusedSurface?.pwd {
                Task { @MainActor in
                    gitDiffSidebarState.requestRefresh(cwd: URL(fileURLWithPath: pwd), force: false)
                }
            }
        }
    }

    // MARK: - Notifications

    @objc private func onMoveTab(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard target == self.focusedSurface else { return }
        guard let window = self.window else { return }

        // Get the move action
        guard let action = notification.userInfo?[Notification.Name.GhosttyMoveTabKey] as? Ghostty.Action.MoveTab else { return }
        guard action.amount != 0 else { return }

        // Determine our current selected index
        guard let windowController = window.windowController else { return }
        guard let tabGroup = windowController.window?.tabGroup else { return }
        guard let selectedWindow = tabGroup.selectedWindow else { return }
        let tabbedWindows = tabGroup.windows
        guard tabbedWindows.count > 0 else { return }
        guard let selectedIndex = tabbedWindows.firstIndex(where: { $0 == selectedWindow }) else { return }

        // Determine the final index we want to insert our tab
        let finalIndex: Int
        if action.amount < 0 {
            finalIndex = selectedIndex - min(selectedIndex, -action.amount)
        } else {
            let remaining: Int = tabbedWindows.count - 1 - selectedIndex
            finalIndex = selectedIndex + min(remaining, action.amount)
        }

        // If our index is the same we do nothing
        guard finalIndex != selectedIndex else { return }

        // Get our target window
        let targetWindow = tabbedWindows[finalIndex]

        // Moving tabs on macOS 26 RC causes very nasty visual glitches in the titlebar tabs.
        // I believe this is due to messed up constraints for our hacky tab bar. I'd like to
        // find a better workaround. For now, this improves things dramatically.
        //
        // Reproduction: titlebar tabs, create two tabs, "move tab left"
        if #available(macOS 26, *) {
            if window is TitlebarTabsTahoeTerminalWindow {
                tabGroup.removeWindow(selectedWindow)
                targetWindow.addTabbedWindow(selectedWindow, ordered: action.amount < 0 ? .below : .above)
                DispatchQueue.main.async {
                    selectedWindow.makeKey()
                }

                return
            }
        }

        // Begin a group of window operations to minimize visual updates
        NSAnimationContext.beginGrouping()
        NSAnimationContext.current.duration = 0

        // Remove and re-add the window in the correct position
        tabGroup.removeWindow(selectedWindow)
        targetWindow.addTabbedWindow(selectedWindow, ordered: action.amount < 0 ? .below : .above)

        // Ensure our window remains selected
        selectedWindow.makeKey()

        NSAnimationContext.endGrouping()
    }

    @objc private func onGotoTab(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard target == self.focusedSurface else { return }
        guard let window = self.window else { return }

        // Get the tab index from the notification
        guard let tabEnumAny = notification.userInfo?[Ghostty.Notification.GotoTabKey] else { return }
        guard let tabEnum = tabEnumAny as? ghostty_action_goto_tab_e else { return }
        let tabIndex: Int32 = tabEnum.rawValue

        guard let windowController = window.windowController else { return }
        guard let tabGroup = windowController.window?.tabGroup else { return }
        let tabbedWindows = tabGroup.windows

        // This will be the index we want to actual go to
        let finalIndex: Int

        // An index that is invalid is used to signal some special values.
        if tabIndex <= 0 {
            guard let selectedWindow = tabGroup.selectedWindow else { return }
            guard let selectedIndex = tabbedWindows.firstIndex(where: { $0 == selectedWindow }) else { return }

            if tabIndex == GHOSTTY_GOTO_TAB_PREVIOUS.rawValue {
                if selectedIndex == 0 {
                    finalIndex = tabbedWindows.count - 1
                } else {
                    finalIndex = selectedIndex - 1
                }
            } else if tabIndex == GHOSTTY_GOTO_TAB_NEXT.rawValue {
                if selectedIndex == tabbedWindows.count - 1 {
                    finalIndex = 0
                } else {
                    finalIndex = selectedIndex + 1
                }
            } else if tabIndex == GHOSTTY_GOTO_TAB_LAST.rawValue {
                finalIndex = tabbedWindows.count - 1
            } else {
                return
            }
        } else {
            // The configured value is 1-indexed.
            guard tabIndex >= 1 else { return }

            // If our index is outside our boundary then we use the max
            finalIndex = min(Int(tabIndex - 1), tabbedWindows.count - 1)
        }

        guard finalIndex >= 0 else { return }
        let targetWindow = tabbedWindows[finalIndex]
        targetWindow.makeKeyAndOrderFront(nil)
    }

    @objc private func onCloseTab(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard surfaceTree.contains(target) else { return }
        closeTab(self)
    }

    @objc private func onCloseOtherTabs(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard surfaceTree.contains(target) else { return }
        closeOtherTabs(self)
    }

    @objc private func onCloseTabsOnTheRight(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard surfaceTree.contains(target) else { return }
        closeTabsOnTheRight(self)
    }

    @objc private func onCloseWindow(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard surfaceTree.contains(target) else { return }
        closeWindow(self)
    }

    @objc private func onResetWindowSize(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard surfaceTree.contains(target) else { return }
        returnToDefaultSize(nil)
    }

    @objc private func onToggleFullscreen(notification: SwiftUI.Notification) {
        guard let target = notification.object as? Ghostty.SurfaceView else { return }
        guard target == self.focusedSurface else { return }

        // Get the fullscreen mode we want to toggle
        let fullscreenMode: FullscreenMode
        if let any = notification.userInfo?[Ghostty.Notification.FullscreenModeKey],
           let mode = any as? FullscreenMode {
            fullscreenMode = mode
        } else {
            Ghostty.logger.warning("no fullscreen mode specified or invalid mode, doing nothing")
            return
        }

        toggleFullscreen(mode: fullscreenMode)
    }

    struct DerivedConfig {
        let backgroundColor: Color
        let macosWindowButtons: Ghostty.MacOSWindowButtons
        let macosTitlebarStyle: String
        let maximize: Bool
        let windowPositionX: Int16?
        let windowPositionY: Int16?

        init() {
            self.backgroundColor = Color(NSColor.windowBackgroundColor)
            self.macosWindowButtons = .visible
            self.macosTitlebarStyle = "system"
            self.maximize = false
            self.windowPositionX = nil
            self.windowPositionY = nil
        }

        init(_ config: Ghostty.Config) {
            self.backgroundColor = config.backgroundColor
            self.macosWindowButtons = config.macosWindowButtons
            self.macosTitlebarStyle = config.macosTitlebarStyle
            self.maximize = config.maximize
            self.windowPositionX = config.windowPositionX
            self.windowPositionY = config.windowPositionY
        }
    }
}

// MARK: NSMenuItemValidation

extension TerminalController {
    override func validateMenuItem(_ item: NSMenuItem) -> Bool {
        switch item.action {
        case #selector(closeTabsOnTheRight):
            guard let window, let tabGroup = window.tabGroup else { return false }
            guard let currentIndex = tabGroup.windows.firstIndex(of: window) else { return false }
            return tabGroup.windows.enumerated().contains { $0.offset > currentIndex }

        case #selector(returnToDefaultSize):
            guard let window else { return false }

            // Native fullscreen windows can't revert to default size.
            if window.styleMask.contains(.fullScreen) {
                return false
            }

            // If we're fullscreen at all then we can't change size
            if fullscreenStyle?.isFullscreen ?? false {
                return false
            }

            // If our window is already the default size or we don't have a
            // default size, then disable.
            return defaultSize?.isChanged(for: window) ?? false

        default:
            return super.validateMenuItem(item)
        }
    }
}

// MARK: Default Size

extension TerminalController {
    /// The possible default sizes for a terminal. The size can't purely be known as a
    /// window frame because if we set `window-width/height` then it is based
    /// on content size.
    enum DefaultSize {
        /// A frame, set with `window.setFrame`
        case frame(NSRect)

        /// A content size, set with `window.setContentSize`
        case contentIntrinsicSize

        func isChanged(for window: NSWindow) -> Bool {
            switch self {
            case .frame(let rect):
                return window.frame != rect
            case .contentIntrinsicSize:
                guard let view = window.contentView else {
                    return false
                }

                return view.frame.size != view.intrinsicContentSize
            }
        }

        func apply(to window: NSWindow) {
            switch self {
            case .frame(let rect):
                window.setFrame(rect, display: true)
            case .contentIntrinsicSize:
                guard let size = window.contentView?.intrinsicContentSize else {
                    return
                }

                window.setContentSize(size)
                window.constrainToScreen()
            }
        }
    }

    private var defaultSize: DefaultSize? {
        if derivedConfig.maximize, let screen = window?.screen ?? NSScreen.main {
            // Maximize takes priority, we take up the full screen we're on.
            return .frame(screen.visibleFrame)
        } else if focusedSurface?.initialSize != nil {
            // Initial size as requested by the configuration (e.g. `window-width`)
            // takes next priority.
            return .contentIntrinsicSize
        } else if let initialFrame {
            // The initial frame we had when we started otherwise.
            return .frame(initialFrame)
        } else {
            return nil
        }
    }
}

extension TerminalController {
    func openWorktreeFromPalette(atPath path: String) {
        openWorktree(atPath: path)
    }
}