Preview View, Tons Of Completion Window Stability Fixes

Author: thecoolwinter

Example/CodeEditSourceEditorExample/CodeEditSourceEditorExample/Views/MockCompletionDelegate.swift

@@ -48,15 +48,18 @@ class MockCompletionDelegate: CodeSuggestionDelegate, ObservableObject {
     class Suggestion: CodeSuggestionEntry {
         var label: String
         var detail: String?
-        var pathComponents: [String]? { nil }
+        var pathComponents: [String]?
         var targetPosition: CursorPosition? { nil }
-        var sourcePreview: String? { nil }
+        var sourcePreview: String?
         var image: Image = Image(systemName: "dot.square.fill")
         var imageColor: Color = .gray
         var deprecated: Bool = false
 
-        init(text: String) {
+        init(text: String, detail: String?, sourcePreview: String?, pathComponents: [String]?) {
             self.label = text
+            self.detail = detail
+            self.sourcePreview = sourcePreview
+            self.pathComponents = pathComponents
         }
     }
 
@@ -67,7 +70,14 @@ class MockCompletionDelegate: CodeSuggestionDelegate, ObservableObject {
             let randomString = (0..<Int.random(in: 1..<text.count)).map {
                 text[$0]
             }.shuffled().joined(separator: " ")
-            suggestions.append(Suggestion(text: randomString))
+            suggestions.append(
+                Suggestion(
+                    text: randomString,
+                    detail: text.randomElement()!,
+                    sourcePreview: randomString,
+                    pathComponents: (0..<Int.random(in: 1..<5)).map { text[$0] }
+                )
+            )
         }
         return suggestions
     }

Example/CodeEditSourceEditorExample/CodeEditSourceEditorExample/Views/MockJumpToDefinitionDelegate.swift

@@ -9,26 +9,26 @@ import AppKit
 import CodeEditSourceEditor
 
 final class MockJumpToDefinitionDelegate: JumpToDefinitionDelegate, ObservableObject {
-    func queryLinks(forRange range: NSRange) async -> [JumpToDefinitionLink]? {
-        Bool.random() ? [
+    func queryLinks(forRange range: NSRange, textView: TextViewController) async -> [JumpToDefinitionLink]? {
+        [
             JumpToDefinitionLink(
                 url: nil,
-                targetPosition: CursorPosition(line: 0, column: 0),
-                targetRange: NSRange(start: 0, end: 10),
+                targetRange: CursorPosition(line: 0, column: 10),
                 typeName: "Start of Document",
                 sourcePreview: "// Comment at start"
             ),
             JumpToDefinitionLink(
                 url: URL(string: "https://codeedit.app/"),
-                targetPosition: CursorPosition(line: 1024, column: 10),
-                targetRange: NSRange(location: 30, length: 100),
+                targetRange: CursorPosition(line: 1024, column: 10),
                 typeName: "CodeEdit Website",
                 sourcePreview: "https://codeedit.app/"
             )
-        ] : nil
+        ]
     }
 
-    func openLink(url: URL, targetRange: NSRange) {
-        NSWorkspace.shared.open(url)
+    func openLink(link: JumpToDefinitionLink) {
+        if let url = link.url {
+            NSWorkspace.shared.open(url)
+        }
     }
 }

Example/CodeEditSourceEditorExample/CodeEditSourceEditorExample/Views/StatusBar.swift

@@ -211,6 +211,6 @@ struct StatusBar: View {
         }
 
         // When there's a single cursor, display the line and column.
-        return "Line: \(cursorPositions[0].line)  Col: \(cursorPositions[0].column) Range: \(cursorPositions[0].range)"
+        return "Line: \(cursorPositions[0].start.line)  Col: \(cursorPositions[0].start.column) Range: \(cursorPositions[0].range)"
     }
 }

Sources/CodeEditSourceEditor/CodeSuggestion/TableView/CodeSuggestionPreviewView.swift

@@ -0,0 +1,119 @@
+//
+//  CodeSuggestionPreviewView.swift
+//  CodeEditSourceEditor
+//
+//  Created by Khan Winter on 7/28/25.
+//
+
+import SwiftUI
+
+final class CodeSuggestionPreviewView: NSVisualEffectView {
+    private let spacing: CGFloat = 5
+
+    var sourcePreview: String? {
+        didSet {
+            sourcePreviewLabel.stringValue = sourcePreview ?? ""
+            sourcePreviewLabel.isHidden = sourcePreview == nil
+        }
+    }
+
+    var documentation: String? {
+        didSet {
+            documentationLabel.stringValue = documentation ?? ""
+            documentationLabel.isHidden = documentation == nil
+        }
+    }
+
+    var pathComponents: [String] = [] {
+        didSet {
+            configurePathComponentsLabel()
+        }
+    }
+
+    var targetRange: CursorPosition? {
+        didSet {
+            configurePathComponentsLabel()
+        }
+    }
+
+    var font: NSFont = .systemFont(ofSize: 12) {
+        didSet {
+            sourcePreviewLabel.font = font
+            pathComponentsLabel.font = font
+        }
+    }
+    var documentationFont: NSFont = .systemFont(ofSize: 12) {
+        didSet {
+            documentationLabel.font = documentationFont
+        }
+    }
+
+    var stackView: NSStackView = NSStackView()
+    var dividerView: NSView = NSView()
+    var sourcePreviewLabel: NSTextField = NSTextField()
+    var documentationLabel: NSTextField = NSTextField()
+    var pathComponentsLabel: NSTextField = NSTextField()
+
+    init() {
+        super.init(frame: .zero)
+        stackView.translatesAutoresizingMaskIntoConstraints = false
+        stackView.spacing = spacing
+        stackView.orientation = .vertical
+        stackView.alignment = .leading
+        stackView.setContentCompressionResistancePriority(.required, for: .vertical)
+        stackView.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
+        addSubview(stackView)
+
+        dividerView.translatesAutoresizingMaskIntoConstraints = false
+        dividerView.wantsLayer = true
+        dividerView.layer?.backgroundColor = NSColor.separatorColor.cgColor
+        addSubview(dividerView)
+
+        self.material = .windowBackground
+        self.blendingMode = .behindWindow
+
+        styleStaticLabel(sourcePreviewLabel)
+        styleStaticLabel(documentationLabel)
+        styleStaticLabel(pathComponentsLabel)
+
+        stackView.addArrangedSubview(sourcePreviewLabel)
+        stackView.addArrangedSubview(documentationLabel)
+        stackView.addArrangedSubview(pathComponentsLabel)
+
+        NSLayoutConstraint.activate([
+            dividerView.topAnchor.constraint(equalTo: topAnchor),
+            dividerView.leadingAnchor.constraint(equalTo: leadingAnchor),
+            dividerView.trailingAnchor.constraint(equalTo: trailingAnchor),
+            dividerView.heightAnchor.constraint(equalToConstant: 1),
+
+            stackView.topAnchor.constraint(equalTo: dividerView.bottomAnchor, constant: spacing),
+            stackView.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -SuggestionController.WINDOW_PADDING),
+            stackView.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 13),
+            stackView.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -13)
+        ])
+    }
+    
+    required init?(coder: NSCoder) {
+        fatalError("init(coder:) has not been implemented")
+    }
+
+    func setPreferredMaxLayoutWidth(width: CGFloat) {
+        sourcePreviewLabel.preferredMaxLayoutWidth = width
+        documentationLabel.preferredMaxLayoutWidth = width
+        pathComponentsLabel.preferredMaxLayoutWidth = width
+    }
+
+    private func styleStaticLabel(_ label: NSTextField) {
+        label.isEditable = false
+        label.allowsDefaultTighteningForTruncation = false
+        label.isBezeled = false
+        label.isBordered = false
+        label.backgroundColor = .clear
+        label.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
+    }
+
+    private func configurePathComponentsLabel() {
+        // TODO: This
+        pathComponentsLabel.isHidden = true
+    }
+}