SPB Git

Repository Public

AppSettings.swift 10.2 KB 181 lines swift

1import DesignSystem2import Foundation34public enum AppearanceMode: String, Codable, Sendable, CaseIterable { case system, dark, light }5public enum CursorShape: String, Codable, Sendable, CaseIterable { case block, underline, bar }6/// When pasted text needs a confirmation sheet.7public enum PasteConfirmation: String, Codable, Sendable, CaseIterable { case never, multiline, always }8/// What a program may do with the system clipboard through OSC 52.9public enum ClipboardAccess: String, Codable, Sendable, CaseIterable { case deny, ask, allow }10public enum BellMode: String, Codable, Sendable, CaseIterable { case off, sound, visual, both }11/// Chrome surface: `solid` paints the theme colour, `translucent` uses a system material behind it.12public enum ChromeMaterial: String, Codable, Sendable, CaseIterable { case solid, translucent }13/// `system` follows "Reduce motion" of macOS; `reduced` always replaces movement with short fades.14public enum MotionPreference: String, Codable, Sendable, CaseIterable { case system, reduced }15public enum NewWindowScreen: String, Codable, Sendable, CaseIterable { case active, main, pointer }1617/// All user preferences. Decoding is tolerant: unknown keys are ignored and missing keys take18/// their default, so a settings file written by an older or newer build never fails to load.19public struct AppSettings: Codable, Sendable, Equatable {20    // Appearance21    public var appearance: AppearanceMode = .system22    public var darkThemeID: String = ThemeCatalog.defaultDarkID23    public var lightThemeID: String = ThemeCatalog.defaultLightID24    /// Chrome accent override (`#RRGGBB`); `nil` uses the theme's accent.25    public var accentOverride: RGBColor?26    public var fontName: String = "SF Mono"27    public var fontSize: Double = 1328    public var cursorShape: CursorShape = .block29    public var cursorBlink: Bool = true30    /// Window background opacity, 0.3…1.31    public var backgroundOpacity: Double = 132    public var backgroundBlur: Bool = false33    public var showStatusBar: Bool = true34    public var showSidebar: Bool = false35    public var showPaneHeaders: Bool = true36    // SP Term Next chrome37    public var chromeMaterial: ChromeMaterial = .translucent38    /// Liquid Glass for floating surfaces (palette, tooltips, toolbar) on systems that have it.39    public var useLiquidGlass: Bool = true40    public var density: ChromeDensity = .compact41    public var motion: MotionPreference = .system42    /// Accent follows the focused session: one stable colour per SSH host.43    public var dynamicAccent: Bool = true44    public var ambientGradient: Bool = true45    /// Brief feedback in the tab and status bar when a foreground command ends.46    public var completionFeedback: Bool = true47    /// Action identifiers shown as buttons at the right of the title bar, in order.48    public var toolbarItems: [String] = AppSettings.defaultToolbarItems49    public static let defaultToolbarItems = ["splitRight", "splitDown", "commandPalette", "toggleAssistant"]50    // Terminal behaviour51    public var scrollbackLines: Int = 20_00052    public var optionAsMeta: Bool = true53    public var mouseReporting: Bool = true54    public var bell: BellMode = .visual55    public var useMetalRenderer: Bool = false56    // Shell57    /// Absolute path of the shell for new sessions; `nil` uses the account's default shell.58    public var shellPath: String?59    public var loginShell: Bool = true60    /// Directory for new sessions; `nil` means the home directory.61    public var startupDirectory: String?62    public var newPaneInheritsDirectory: Bool = true63    /// Command sent to every new local shell after start (empty = none).64    public var startupCommand: String = ""65    // Safety66    public var pasteConfirmation: PasteConfirmation = .multiline67    public var clipboardWrite: ClipboardAccess = .ask68    public var clipboardRead: ClipboardAccess = .deny69    public var confirmCloseRunning: Bool = true70    public var confirmQuitRunning: Bool = true71    // Privacy72    /// Record commands sent from snippets/assistant in the local history file (off by default).73    public var recordHistory: Bool = false74    /// Private mode: nothing about sessions is written to disk while it is on.75    public var privateMode: Bool = false76    public var restoreWorkspaceOnLaunch: Bool = true77    public var notifyOnLongCommand: Bool = false78    public var longCommandSeconds: Int = 2079    // Windows80    public var newWindowScreen: NewWindowScreen = .active81    // Quick terminal82    public var quickTerminalEnabled: Bool = false83    public var quickTerminalShortcut: KeyChord = KeyChord("`", [.control, .option])84    public var quickTerminalHeightFraction: Double = 0.4285    // Assistant86    public var assistantEnabled: Bool = false87    public var assistantLocalOnly: Bool = false88    public var assistantRedactSecrets: Bool = true89    public var assistantActiveProviderID: String?90    // Shortcuts: action id → chord. Only overrides are stored.91    public var keyBindings: [String: KeyChord] = [:]9293    public init() {}9495    public init(from decoder: Decoder) throws {96        let c = try decoder.container(keyedBy: CodingKeys.self)97        func value<T: Decodable>(_ key: CodingKeys, _ fallback: T) -> T {98            (try? c.decodeIfPresent(T.self, forKey: key)) ?? fallback99        }100        let d = AppSettings()101        appearance = value(.appearance, d.appearance)102        darkThemeID = value(.darkThemeID, d.darkThemeID)103        lightThemeID = value(.lightThemeID, d.lightThemeID)104        accentOverride = try? c.decodeIfPresent(RGBColor.self, forKey: .accentOverride)105        fontName = value(.fontName, d.fontName)106        fontSize = value(.fontSize, d.fontSize)107        cursorShape = value(.cursorShape, d.cursorShape)108        cursorBlink = value(.cursorBlink, d.cursorBlink)109        backgroundOpacity = value(.backgroundOpacity, d.backgroundOpacity)110        backgroundBlur = value(.backgroundBlur, d.backgroundBlur)111        showStatusBar = value(.showStatusBar, d.showStatusBar)112        showSidebar = value(.showSidebar, d.showSidebar)113        showPaneHeaders = value(.showPaneHeaders, d.showPaneHeaders)114        chromeMaterial = value(.chromeMaterial, d.chromeMaterial)115        useLiquidGlass = value(.useLiquidGlass, d.useLiquidGlass)116        density = value(.density, d.density)117        motion = value(.motion, d.motion)118        dynamicAccent = value(.dynamicAccent, d.dynamicAccent)119        ambientGradient = value(.ambientGradient, d.ambientGradient)120        completionFeedback = value(.completionFeedback, d.completionFeedback)121        toolbarItems = value(.toolbarItems, d.toolbarItems)122        scrollbackLines = value(.scrollbackLines, d.scrollbackLines)123        optionAsMeta = value(.optionAsMeta, d.optionAsMeta)124        mouseReporting = value(.mouseReporting, d.mouseReporting)125        bell = value(.bell, d.bell)126        useMetalRenderer = value(.useMetalRenderer, d.useMetalRenderer)127        shellPath = try? c.decodeIfPresent(String.self, forKey: .shellPath)128        loginShell = value(.loginShell, d.loginShell)129        startupDirectory = try? c.decodeIfPresent(String.self, forKey: .startupDirectory)130        newPaneInheritsDirectory = value(.newPaneInheritsDirectory, d.newPaneInheritsDirectory)131        startupCommand = value(.startupCommand, d.startupCommand)132        pasteConfirmation = value(.pasteConfirmation, d.pasteConfirmation)133        clipboardWrite = value(.clipboardWrite, d.clipboardWrite)134        clipboardRead = value(.clipboardRead, d.clipboardRead)135        confirmCloseRunning = value(.confirmCloseRunning, d.confirmCloseRunning)136        confirmQuitRunning = value(.confirmQuitRunning, d.confirmQuitRunning)137        recordHistory = value(.recordHistory, d.recordHistory)138        privateMode = value(.privateMode, d.privateMode)139        restoreWorkspaceOnLaunch = value(.restoreWorkspaceOnLaunch, d.restoreWorkspaceOnLaunch)140        notifyOnLongCommand = value(.notifyOnLongCommand, d.notifyOnLongCommand)141        longCommandSeconds = value(.longCommandSeconds, d.longCommandSeconds)142        newWindowScreen = value(.newWindowScreen, d.newWindowScreen)143        quickTerminalEnabled = value(.quickTerminalEnabled, d.quickTerminalEnabled)144        quickTerminalShortcut = value(.quickTerminalShortcut, d.quickTerminalShortcut)145        quickTerminalHeightFraction = value(.quickTerminalHeightFraction, d.quickTerminalHeightFraction)146        assistantEnabled = value(.assistantEnabled, d.assistantEnabled)147        assistantLocalOnly = value(.assistantLocalOnly, d.assistantLocalOnly)148        assistantRedactSecrets = value(.assistantRedactSecrets, d.assistantRedactSecrets)149        assistantActiveProviderID = try? c.decodeIfPresent(String.self, forKey: .assistantActiveProviderID)150        keyBindings = value(.keyBindings, d.keyBindings)151        sanitize()152    }153154    /// Brings every value back into its supported range.155    public mutating func sanitize() {156        fontSize = min(max(fontSize, Metrics.minimumFontSize), Metrics.maximumFontSize)157        backgroundOpacity = min(max(backgroundOpacity, 0.3), 1)158        scrollbackLines = min(max(scrollbackLines, 0), 1_000_000)159        quickTerminalHeightFraction = min(max(quickTerminalHeightFraction, 0.2), 1)160        longCommandSeconds = min(max(longCommandSeconds, 1), 86_400)161        if ThemeCatalog.theme(id: darkThemeID) == nil { darkThemeID = ThemeCatalog.defaultDarkID }162        if ThemeCatalog.theme(id: lightThemeID) == nil { lightThemeID = ThemeCatalog.defaultLightID }163        var seen = Set<String>()164        toolbarItems = toolbarItems.filter { seen.insert($0).inserted }165        if toolbarItems.count > 12 { toolbarItems = Array(toolbarItems.prefix(12)) }166        if fontName.trimmingCharacters(in: .whitespaces).isEmpty { fontName = "SF Mono" }167    }168169    /// Theme to use given the system appearance and the "increase contrast" accessibility setting.170    public func resolvedTheme(systemIsDark: Bool, increaseContrast: Bool = false) -> TerminalTheme {171        let dark: Bool172        switch appearance {173        case .system: dark = systemIsDark174        case .dark: dark = true175        case .light: dark = false176        }177        if increaseContrast { return dark ? ThemeCatalog.highContrastDark : ThemeCatalog.highContrastLight }178        return ThemeCatalog.theme(id: dark ? darkThemeID : lightThemeID) ?? (dark ? ThemeCatalog.graphite : ThemeCatalog.daylight)179    }180}181
Files main
Menu

Theme