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