Add public jumpToDefinitionDelegate API

Author: thecoolwinter

Sources/CodeEditSourceEditor/Controller/TextViewController.swift

@@ -24,8 +24,6 @@ public class TextViewController: NSViewController {
 
     // MARK: - Views and Child VCs
 
-    // MARK: - Views and Child VCs
-
     weak var findViewController: FindViewController?
 
     internal(set) public var scrollView: NSScrollView!
@@ -89,6 +87,18 @@ public class TextViewController: NSViewController {
 
     public weak var completionDelegate: CodeSuggestionDelegate?
 
+    /// A delegate object that responds to requests for jump to definition actions. see ``JumpToDefinitionDelegate``.
+    /// - Note: The ``TextViewController`` keeps only a `weak` reference to this object. To function properly, ensure a
+    ///         strong reference to the delegate is kept *outside* of this variable.
+    public var jumpToDefinitionDelegate: JumpToDefinitionDelegate? {
+        get {
+            jumpToDefinitionModel.delegate
+        }
+        set {
+            jumpToDefinitionModel.delegate = newValue
+        }
+    }
+
     // MARK: - Config Helpers
 
     /// The font to use in the `textView`
@@ -177,7 +187,7 @@ public class TextViewController: NSViewController {
     /// This will be `nil` if another highlighter provider is passed to the source editor.
     internal(set) public var treeSitterClient: TreeSitterClient? {
         didSet {
-            jumpToDefinitionModel?.treeSitterClient = treeSitterClient
+            jumpToDefinitionModel.treeSitterClient = treeSitterClient
         }
     }
 
@@ -186,7 +196,7 @@ public class TextViewController: NSViewController {
     /// Filters used when applying edits..
     var textFilters: [TextFormation.Filter] = []
 
-    var jumpToDefinitionModel: JumpToDefinitionModel?
+    var jumpToDefinitionModel: JumpToDefinitionModel
 
     var cancellables = Set<AnyCancellable>()
 
@@ -214,7 +224,8 @@ public class TextViewController: NSViewController {
         highlightProviders: [HighlightProviding] = [TreeSitterClient()],
         foldProvider: LineFoldProvider? = nil,
         undoManager: CEUndoManager? = nil,
-        coordinators: [TextViewCoordinator] = []
+        coordinators: [TextViewCoordinator] = [],
+        jumpToDefinitionDelegate: JumpToDefinitionDelegate? = nil
     ) {
         self.language = language
         self.configuration = configuration
@@ -223,9 +234,15 @@ public class TextViewController: NSViewController {
         self.foldProvider = foldProvider ?? LineIndentationFoldProvider()
         self._undoManager = undoManager
         self.invisibleCharactersCoordinator = InvisibleCharactersCoordinator(configuration: configuration)
+        self.jumpToDefinitionModel = JumpToDefinitionModel(
+            controller: nil,
+            treeSitterClient: treeSitterClient,
+            delegate: jumpToDefinitionDelegate
+        )
 
         super.init(nibName: nil, bundle: nil)
 
+        jumpToDefinitionModel.controller = self
         suggestionTriggerModel.controller = self
 
         if let idx = highlightProviders.firstIndex(where: { $0 is TreeSitterClient }),
@@ -253,11 +270,6 @@ public class TextViewController: NSViewController {
         }
         self.textCoordinators = coordinators.map { WeakCoordinator($0) }
 
-        jumpToDefinitionModel = JumpToDefinitionModel(
-            controller: self,
-            treeSitterClient: treeSitterClient,
-            delegate: nil
-        )
     }
 
     required init?(coder: NSCoder) {

Sources/CodeEditSourceEditor/Documentation.docc/SourceEditorView.md

@@ -86,10 +86,28 @@ let editorController = TextViewController(
     cursorPositions: [CursorPosition(line: 0, column: 0)],
     highlightProviders: [], // Use the tree-sitter syntax highlighting provider by default
     undoManager: nil,
-    coordinators: [] // Optionally inject editing behavior or other plugins.
+    coordinators: [], // Optionally inject editing behavior or other plugins.
+    jumpToDefinitionDelegate // Allow users to perform the 'jump to definition' using a delegate object.
 )
 ```
 
+To add the controller to your view, add it as a child view controller and add the editor's view to your view hierarchy.
+
+```swift
+final class MyController: NSViewController {
+    override func loadView() {
+        super.loadView()
+        let editorController: TextViewController = /**/
+
+        addChild(editorController)
+        view.addSubview(editorController.view)
+        editorController.view.viewDidMoveToSuperview()
+    }
+}
+```
+
+For more AppKit API options, see the documentation on ``TextViewController``.
+
 ## Topics
 
 - ``SourceEditor``

Sources/CodeEditSourceEditor/JumpToDefinition/JumpToDefinitionModel.swift

@@ -20,7 +20,7 @@ final class JumpToDefinitionModel {
     weak var delegate: JumpToDefinitionDelegate?
     weak var treeSitterClient: TreeSitterClient?
 
-    private weak var controller: TextViewController?
+    weak var controller: TextViewController?
 
     private(set) public var hoveredRange: NSRange?
 
@@ -33,7 +33,7 @@ final class JumpToDefinitionModel {
         controller?.textView
     }
 
-    init(controller: TextViewController, treeSitterClient: TreeSitterClient?, delegate: JumpToDefinitionDelegate?) {
+    init(controller: TextViewController?, treeSitterClient: TreeSitterClient?, delegate: JumpToDefinitionDelegate?) {
         self.controller = controller
         self.treeSitterClient = treeSitterClient
         self.delegate = delegate