jonmsterling.com
A collection of user interface components and drawing routines for building tasteful apps using AppKit.
appkit
swift
aqua
ui
mac
swift-format
+77
.swift-format
+77
.swift-format
···
···
1
+
// SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers
2
+
//
3
+
// SPDX-License-Identifier: MPL-2.0
4
+
{
5
+
"fileScopedDeclarationPrivacy" : {
6
+
"accessLevel" : "private"
7
+
},
8
+
"indentConditionalCompilationBlocks" : true,
9
+
"indentSwitchCaseLabels" : false,
10
+
"indentation" : {
11
+
"tabs" : 1
12
+
},
13
+
"lineBreakAroundMultilineExpressionChainComponents" : false,
14
+
"lineBreakBeforeControlFlowKeywords" : false,
15
+
"lineBreakBeforeEachArgument" : false,
16
+
"lineBreakBeforeEachGenericRequirement" : false,
17
+
"lineBreakBetweenDeclarationAttributes" : false,
18
+
"lineLength" : 200,
19
+
"maximumBlankLines" : 10,
20
+
"multiElementCollectionTrailingCommas" : false,
21
+
"noAssignmentInExpressions" : {
22
+
"allowedFunctions" : [
23
+
"XCTAssertNoThrow"
24
+
]
25
+
},
26
+
"prioritizeKeepingFunctionOutputTogether" : false,
27
+
"reflowMultilineStringLiterals" : "never",
28
+
"respectsExistingLineBreaks" : true,
29
+
"rules" : {
30
+
"AllPublicDeclarationsHaveDocumentation" : false,
31
+
"AlwaysUseLiteralForEmptyCollectionInit" : false,
32
+
"AlwaysUseLowerCamelCase" : true,
33
+
"AmbiguousTrailingClosureOverload" : true,
34
+
"AvoidRetroactiveConformances" : true,
35
+
"BeginDocumentationCommentWithOneLineSummary" : false,
36
+
"DoNotUseSemicolons" : true,
37
+
"DontRepeatTypeInStaticProperties" : true,
38
+
"FileScopedDeclarationPrivacy" : true,
39
+
"FullyIndirectEnum" : true,
40
+
"GroupNumericLiterals" : true,
41
+
"IdentifiersMustBeASCII" : false,
42
+
"NeverForceUnwrap" : false,
43
+
"NeverUseForceTry" : false,
44
+
"NeverUseImplicitlyUnwrappedOptionals" : false,
45
+
"NoAccessLevelOnExtensionDeclaration" : true,
46
+
"NoAssignmentInExpressions" : true,
47
+
"NoBlockComments" : false,
48
+
"NoCasesWithOnlyFallthrough" : true,
49
+
"NoEmptyLinesOpeningClosingBraces" : false,
50
+
"NoEmptyTrailingClosureParentheses" : true,
51
+
"NoLabelsInCasePatterns" : true,
52
+
"NoLeadingUnderscores" : false,
53
+
"NoParensAroundConditions" : true,
54
+
"NoPlaygroundLiterals" : true,
55
+
"NoVoidReturnOnFunctionSignature" : true,
56
+
"OmitExplicitReturns" : false,
57
+
"OneCasePerLine" : true,
58
+
"OneVariableDeclarationPerLine" : true,
59
+
"OnlyOneTrailingClosureArgument" : true,
60
+
"OrderedImports" : true,
61
+
"ReplaceForEachWithForLoop" : true,
62
+
"ReturnVoidInsteadOfEmptyTuple" : true,
63
+
"TypeNamesShouldBeCapitalized" : true,
64
+
"UseEarlyExits" : false,
65
+
"UseExplicitNilCheckInConditions" : true,
66
+
"UseLetInEveryBoundCaseVariable" : false,
67
+
"UseShorthandTypeNames" : true,
68
+
"UseSingleLinePropertyGetter" : true,
69
+
"UseSynthesizedInitializer" : true,
70
+
"UseTripleSlashForDocumentationComments" : true,
71
+
"UseWhereClausesInForLoops" : false,
72
+
"ValidateDocumentationComments" : false
73
+
},
74
+
"spacesAroundRangeFormationOperators" : false,
75
+
"spacesBeforeEndOfLineComments" : 2,
76
+
"version" : 1
77
+
}
+2
-3
Sources/AquaKit/Controls and Views/AquaDragHandle.swift
+2
-3
Sources/AquaKit/Controls and Views/AquaDragHandle.swift
···
1
import AppKit
2
3
-
/// This is an abstract superclass that draws nothing but handles drag functionality.
4
open class AquaDragHandle: NSControl {
5
public struct Drag {
6
public var initialLocation: NSPoint = .zero
···
21
.mouseMoved,
22
.cursorUpdate,
23
.activeInKeyWindow,
24
-
.inVisibleRect,
25
],
26
owner: self,
27
userInfo: nil
···
48
true
49
}
50
}
51
-
···
1
import AppKit
2
3
+
/// This is an abstract superclass that draws nothing but handles drag functionality.
4
open class AquaDragHandle: NSControl {
5
public struct Drag {
6
public var initialLocation: NSPoint = .zero
···
21
.mouseMoved,
22
.cursorUpdate,
23
.activeInKeyWindow,
24
+
.inVisibleRect
25
],
26
owner: self,
27
userInfo: nil
···
48
true
49
}
50
}
+3
-3
Sources/AquaKit/Controls and Views/AquaSplitView.swift
+3
-3
Sources/AquaKit/Controls and Views/AquaSplitView.swift
···
4
override open var dividerColor: NSColor {
5
.aquaSeparatorColor
6
}
7
-
8
public override init(frame frameRect: NSRect) {
9
super.init(frame: frameRect)
10
dividerStyle = .thin
11
}
12
-
13
override open func viewDidChangeEffectiveAppearance() {
14
setNeedsDisplay(bounds)
15
}
16
-
17
public required init?(coder: NSCoder) {
18
fatalError("init(coder:) has not been implemented")
19
}
···
4
override open var dividerColor: NSColor {
5
.aquaSeparatorColor
6
}
7
+
8
public override init(frame frameRect: NSRect) {
9
super.init(frame: frameRect)
10
dividerStyle = .thin
11
}
12
+
13
override open func viewDidChangeEffectiveAppearance() {
14
setNeedsDisplay(bounds)
15
}
16
+
17
public required init?(coder: NSCoder) {
18
fatalError("init(coder:) has not been implemented")
19
}
+4
-4
Sources/AquaKit/Controls and Views/AquaSplitViewResizeHandle.swift
+4
-4
Sources/AquaKit/Controls and Views/AquaSplitViewResizeHandle.swift
···
2
3
open class AquaSplitViewResizeHandle: AquaDragHandle {
4
public override init(frame frameRect: NSRect) {
5
-
super.init(frame: frameRect )
6
-
7
translatesAutoresizingMaskIntoConstraints = false
8
NSLayoutConstraint.activate([
9
widthAnchor.constraint(equalToConstant: 16)
10
])
11
}
12
-
13
public required init?(coder: NSCoder) {
14
fatalError("init(coder:) has not been implemented")
15
}
16
-
17
override open func cursorUpdate(with event: NSEvent) {
18
NSCursor.columnResize(directions: [.all]).set()
19
}
···
2
3
open class AquaSplitViewResizeHandle: AquaDragHandle {
4
public override init(frame frameRect: NSRect) {
5
+
super.init(frame: frameRect)
6
+
7
translatesAutoresizingMaskIntoConstraints = false
8
NSLayoutConstraint.activate([
9
widthAnchor.constraint(equalToConstant: 16)
10
])
11
}
12
+
13
public required init?(coder: NSCoder) {
14
fatalError("init(coder:) has not been implemented")
15
}
16
+
17
override open func cursorUpdate(with event: NSEvent) {
18
NSCursor.columnResize(directions: [.all]).set()
19
}
+1
-1
Sources/AquaKit/Controls and Views/AquaWindowResizeHandle.swift
+1
-1
Sources/AquaKit/Controls and Views/AquaWindowResizeHandle.swift
+1
-1
Sources/AquaKit/General Purpose/NSColor+Aqua.swift
+1
-1
Sources/AquaKit/General Purpose/NSColor+Aqua.swift
+1
-1
Sources/AquaKit/General Purpose/NSGradient+Aqua.swift
+1
-1
Sources/AquaKit/General Purpose/NSGradient+Aqua.swift
+1
-1
Sources/AquaKit/General Purpose/NSView+Anchoring.swift
+1
-1
Sources/AquaKit/General Purpose/NSView+Anchoring.swift
+1
-1
Sources/AquaKit/General Purpose/Split View Layout/NSSplitViewController+PreferredDividerPosition.swift
+1
-1
Sources/AquaKit/General Purpose/Split View Layout/NSSplitViewController+PreferredDividerPosition.swift
+1
-1
Sources/AquaKit/General Purpose/WindowStateSentinelView.swift
+1
-1
Sources/AquaKit/General Purpose/WindowStateSentinelView.swift
+1
-1
Sources/AquaKit/Source Lists/SourceListBottomBarViewController.swift
+1
-1
Sources/AquaKit/Source Lists/SourceListBottomBarViewController.swift
···
74
NSLayoutConstraint.activate([
75
resizeHandle.centerYAnchor.constraint(equalTo: view.centerYAnchor),
76
resizeHandle.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor),
77
-
resizeHandle.heightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.heightAnchor, constant: -16),
78
])
79
80
automaticallyAppliesContentInsets = false
···
74
NSLayoutConstraint.activate([
75
resizeHandle.centerYAnchor.constraint(equalTo: view.centerYAnchor),
76
resizeHandle.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor),
77
+
resizeHandle.heightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.heightAnchor, constant: -16)
78
])
79
80
automaticallyAppliesContentInsets = false
-1
Sources/AquaKit/Table Headers/AquaTableHeaderCell.swift
-1
Sources/AquaKit/Table Headers/AquaTableHeaderCell.swift
+2
-2
Sources/AquaKit/Web Views/AquaWebViewController.swift
+2
-2
Sources/AquaKit/Web Views/AquaWebViewController.swift
···
40
verticalScroller.rightAnchor.constraint(equalTo: view.rightAnchor),
41
verticalScroller.topAnchor.constraint(equalTo: view.topAnchor),
42
verticalScroller.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
43
-
verticalScroller.widthAnchor.constraint(equalToConstant: verticalScrollerWidth),
44
])
45
46
NSLayoutConstraint.activate([
47
horizontalScroller.leftAnchor.constraint(equalTo: view.leftAnchor),
48
horizontalScroller.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor),
49
horizontalScroller.bottomAnchor.constraint(equalTo: view.bottomAnchor),
50
-
horizontalScroller.heightAnchor.constraint(equalToConstant: horizontalScrollerWidth),
51
])
52
53
view.addSubview(webView)
···
40
verticalScroller.rightAnchor.constraint(equalTo: view.rightAnchor),
41
verticalScroller.topAnchor.constraint(equalTo: view.topAnchor),
42
verticalScroller.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
43
+
verticalScroller.widthAnchor.constraint(equalToConstant: verticalScrollerWidth)
44
])
45
46
NSLayoutConstraint.activate([
47
horizontalScroller.leftAnchor.constraint(equalTo: view.leftAnchor),
48
horizontalScroller.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor),
49
horizontalScroller.bottomAnchor.constraint(equalTo: view.bottomAnchor),
50
+
horizontalScroller.heightAnchor.constraint(equalToConstant: horizontalScrollerWidth)
51
])
52
53
view.addSubview(webView)
+5
-4
Sources/AquaKit/Windows/AquaTitlebarBackgroundView.swift
+5
-4
Sources/AquaKit/Windows/AquaTitlebarBackgroundView.swift
···
5
super.init(frame: frameRect)
6
addSubview(WindowStateSentinelView())
7
}
8
-
9
public required init?(coder: NSCoder) {
10
fatalError("init(coder:) has not been implemented")
11
}
12
-
13
static var gradient: NSGradient! {
14
-
let color1 = NSColor(light: #colorLiteral(red: 0.9262896776, green: 0.9262896776, blue: 0.9262896776, alpha: 1), dark: .underPageBackgroundColor.highlight(withLevel: 0.3)!.withAlphaComponent(0.2))
15
let color2 = NSColor(light: #colorLiteral(red: 0.8432617784, green: 0.8432616591, blue: 0.8432617784, alpha: 1), dark: .underPageBackgroundColor.withAlphaComponent(0.2))
16
return NSGradient(colors: [color1, color2])!
17
}
···
29
30
NSColor.aquaSeparatorColor.setStroke()
31
dividerPath.stroke()
32
-
33
if let window, !window.isKeyWindow {
34
NSColor.pinstripes.setFill()
35
bounds.fill()
···
5
super.init(frame: frameRect)
6
addSubview(WindowStateSentinelView())
7
}
8
+
9
public required init?(coder: NSCoder) {
10
fatalError("init(coder:) has not been implemented")
11
}
12
+
13
static var gradient: NSGradient! {
14
+
let color1 = NSColor(
15
+
light: #colorLiteral(red: 0.9262896776, green: 0.9262896776, blue: 0.9262896776, alpha: 1), dark: .underPageBackgroundColor.highlight(withLevel: 0.3)!.withAlphaComponent(0.2))
16
let color2 = NSColor(light: #colorLiteral(red: 0.8432617784, green: 0.8432616591, blue: 0.8432617784, alpha: 1), dark: .underPageBackgroundColor.withAlphaComponent(0.2))
17
return NSGradient(colors: [color1, color2])!
18
}
···
30
31
NSColor.aquaSeparatorColor.setStroke()
32
dividerPath.stroke()
33
+
34
if let window, !window.isKeyWindow {
35
NSColor.pinstripes.setFill()
36
bounds.fill()
+1
-1
Sources/AquaKit/Windows/AquaToolbarToggleButton.swift
+1
-1
Sources/AquaKit/Windows/AquaToolbarToggleButton.swift
+3
-3
Sources/AquaKit/Windows/AquaTrafficLightButton.swift
+3
-3
Sources/AquaKit/Windows/AquaTrafficLightButton.swift
···
29
30
NSLayoutConstraint.activate([
31
widthAnchor.constraint(equalToConstant: Self.windowControlButtonHeight),
32
-
heightAnchor.constraint(equalToConstant: Self.windowControlButtonHeight),
33
])
34
35
imageView.imageScaling = .scaleProportionallyUpOrDown
···
45
additionalSafeAreaInsets = NSEdgeInsets(top: 4, left: 4, bottom: 4, right: 4)
46
NSLayoutConstraint.activate([
47
imageView.centerXAnchor.constraint(equalTo: centerXAnchor),
48
-
imageView.centerYAnchor.constraint(equalTo: centerYAnchor),
49
])
50
51
let trackingAreaOptions: NSTrackingArea.Options = [
52
.activeAlways,
53
.mouseEnteredAndExited,
54
.assumeInside,
55
-
.inVisibleRect,
56
]
57
58
let trackingArea = NSTrackingArea(rect: .zero, options: trackingAreaOptions, owner: self)
···
29
30
NSLayoutConstraint.activate([
31
widthAnchor.constraint(equalToConstant: Self.windowControlButtonHeight),
32
+
heightAnchor.constraint(equalToConstant: Self.windowControlButtonHeight)
33
])
34
35
imageView.imageScaling = .scaleProportionallyUpOrDown
···
45
additionalSafeAreaInsets = NSEdgeInsets(top: 4, left: 4, bottom: 4, right: 4)
46
NSLayoutConstraint.activate([
47
imageView.centerXAnchor.constraint(equalTo: centerXAnchor),
48
+
imageView.centerYAnchor.constraint(equalTo: centerYAnchor)
49
])
50
51
let trackingAreaOptions: NSTrackingArea.Options = [
52
.activeAlways,
53
.mouseEnteredAndExited,
54
.assumeInside,
55
+
.inVisibleRect
56
]
57
58
let trackingArea = NSTrackingArea(rect: .zero, options: trackingAreaOptions, owner: self)
+1
-1
Sources/AquaKit/Windows/AquaWindow.swift
+1
-1
Sources/AquaKit/Windows/AquaWindow.swift
+14
-10
Sources/AquaKit/Windows/AquaWindowBottomBarViewController.swift
+14
-10
Sources/AquaKit/Windows/AquaWindowBottomBarViewController.swift
···
18
dividerPath.lineWidth = 1
19
return dividerPath
20
}
21
-
22
static var gradient: NSGradient! {
23
-
let color1 = NSColor(light: #colorLiteral(red: 0.9262896776, green: 0.9262896776, blue: 0.9262896776, alpha: 1), dark: .underPageBackgroundColor.highlight(withLevel: 0.5)!.withAlphaComponent(0.2))
24
-
let color2 = NSColor(light: #colorLiteral(red: 0.8432617784, green: 0.8432616591, blue: 0.8432617784, alpha: 1), dark: .underPageBackgroundColor.shadow(withLevel: 0.6)!.withAlphaComponent(0.2))
25
return NSGradient(colors: [color1, color2])!
26
}
27
···
41
open override func loadView() {
42
view = View()
43
}
44
-
45
open override func viewDidLoad() {
46
super.viewDidLoad()
47
-
48
let resizeHandle = AquaWindowResizeHandle()
49
resizeHandle.target = self
50
resizeHandle.action = #selector(resize(_:))
51
resizeHandle.translatesAutoresizingMaskIntoConstraints = false
52
-
53
view.addSubview(resizeHandle)
54
-
55
NSLayoutConstraint.activate([
56
resizeHandle.rightAnchor.constraint(equalTo: view.rightAnchor),
57
-
resizeHandle.bottomAnchor.constraint(equalTo: view.bottomAnchor),
58
])
59
}
60
-
61
@objc private func resize(_ sender: AquaWindowResizeHandle) {
62
guard let drag = sender.activeDrag, let window = view.window else { return }
63
let deltaX = drag.finalLocation.x - drag.initialLocation.x
64
let deltaY = drag.initialLocation.y - drag.finalLocation.y
65
-
66
var frame = window.frame
67
frame.size.width += deltaX
68
frame.size.height += deltaY
···
18
dividerPath.lineWidth = 1
19
return dividerPath
20
}
21
+
22
static var gradient: NSGradient! {
23
+
let color1 = NSColor(
24
+
light: #colorLiteral(red: 0.9262896776, green: 0.9262896776, blue: 0.9262896776, alpha: 1),
25
+
dark: .underPageBackgroundColor.highlight(withLevel: 0.5)!.withAlphaComponent(0.2))
26
+
let color2 = NSColor(
27
+
light: #colorLiteral(red: 0.8432617784, green: 0.8432616591, blue: 0.8432617784, alpha: 1),
28
+
dark: .underPageBackgroundColor.shadow(withLevel: 0.6)!.withAlphaComponent(0.2))
29
return NSGradient(colors: [color1, color2])!
30
}
31
···
45
open override func loadView() {
46
view = View()
47
}
48
+
49
open override func viewDidLoad() {
50
super.viewDidLoad()
51
+
52
let resizeHandle = AquaWindowResizeHandle()
53
resizeHandle.target = self
54
resizeHandle.action = #selector(resize(_:))
55
resizeHandle.translatesAutoresizingMaskIntoConstraints = false
56
+
57
view.addSubview(resizeHandle)
58
+
59
NSLayoutConstraint.activate([
60
resizeHandle.rightAnchor.constraint(equalTo: view.rightAnchor),
61
+
resizeHandle.bottomAnchor.constraint(equalTo: view.bottomAnchor)
62
])
63
}
64
+
65
@objc private func resize(_ sender: AquaWindowResizeHandle) {
66
guard let drag = sender.activeDrag, let window = view.window else { return }
67
let deltaX = drag.finalLocation.x - drag.initialLocation.x
68
let deltaY = drag.initialLocation.y - drag.finalLocation.y
69
+
70
var frame = window.frame
71
frame.size.width += deltaX
72
frame.size.height += deltaY
+2
-2
Sources/AquaKit/Windows/AquaWindowContainerViewController.swift
+2
-2
Sources/AquaKit/Windows/AquaWindowContainerViewController.swift
···
11
12
override open func viewDidLoad() {
13
super.viewDidLoad()
14
-
15
let titlebarBackgroundView = AquaTitlebarBackgroundView()
16
titlebarBackgroundView.translatesAutoresizingMaskIntoConstraints = false
17
···
21
titlebarBackgroundView.leftAnchor.constraint(equalTo: view.leftAnchor),
22
titlebarBackgroundView.rightAnchor.constraint(equalTo: view.rightAnchor),
23
titlebarBackgroundView.topAnchor.constraint(equalTo: view.topAnchor),
24
-
titlebarBackgroundView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor),
25
])
26
}
27
}
···
11
12
override open func viewDidLoad() {
13
super.viewDidLoad()
14
+
15
let titlebarBackgroundView = AquaTitlebarBackgroundView()
16
titlebarBackgroundView.translatesAutoresizingMaskIntoConstraints = false
17
···
21
titlebarBackgroundView.leftAnchor.constraint(equalTo: view.leftAnchor),
22
titlebarBackgroundView.rightAnchor.constraint(equalTo: view.rightAnchor),
23
titlebarBackgroundView.topAnchor.constraint(equalTo: view.topAnchor),
24
+
titlebarBackgroundView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.topAnchor)
25
])
26
}
27
}
+1
-1
Sources/AquaKit/Windows/AquaWindowControlButton.swift
+1
-1
Sources/AquaKit/Windows/AquaWindowControlButton.swift