comparing 59b5fbbda8c4d8cf17cd8e7769184851b9d083eb and main on jonmsterling.com/swift-pterodactyl

.gitignore

···

       2
       2
        
       #

     

       3
       3
        
       # SPDX-License-Identifier: MPL-2.0

     

       4
       4
        
       

     

       5
       5
       +
       .jj/*

     

       5
       6
        
       .DS_Store

     

       6
       7
        
       /.build

     

       7
       8
        
       /Packages

+26 -2

Package.swift

···

       23
       23
        
       		.library(

     

       24
       24
        
       			name: "PterodactylBuild",

     

       25
       25
        
       			targets: ["PterodactylBuild"]

     

       26
       26
       +
       		),

     

       27
       27
       +
       		.executable(

     

       28
       28
       +
       			name: "PterodactylLanguageServer",

     

       29
       29
       +
       			targets: ["PterodactylLanguageServer"]

     

       26
       30
        
       		)

     

       27
       31
        
       	],

     

       28
       32
        
       	dependencies: [

     

       29
       29
       -
       		//		.package(url: "https://github.com/ChimeHQ/LanguageServer", branch: "main"),

     

       33
       33
       +
       		.package(url: "https://github.com/ChimeHQ/LanguageServer", branch: "main"),

     

       30
       34
        
       		.package(url: "https://github.com/ChimeHQ/LanguageServerProtocol", branch: "main"),

     

       31
       35
        
       		.package(url: "https://github.com/apple/swift-llbuild2.git", branch: "main"),

     

       32
       32
       -
       		.package(url: "https://github.com/apple/swift-algorithms", from: "1.2.0")

     

       36
       36
       +
       		.package(url: "https://github.com/apple/swift-algorithms", from: "1.2.0"),

     

       37
       37
       +
       		.package(url: "https://github.com/apple/swift-log", from: "1.6.0")

     

       33
       38
        
       	],

     

       34
       39
        
       	targets: [

     

       35
       40
        
       		// Targets are the basic building blocks of a package, defining a module or a test suite.

     
···

       51
       56
        
       				.product(name: "llbuild2fx", package: "swift-llbuild2")

     

       52
       57
        
       			]

     

       53
       58
        
       		),

     

       59
       59
       +
       		.executableTarget(

     

       60
       60
       +
       			name: "PterodactylLanguageServer",

     

       61
       61
       +
       			dependencies: [

     

       62
       62
       +
       				"LanguageServer",

     

       63
       63
       +
       				.product(name: "llbuild2fx", package: "swift-llbuild2"),

     

       64
       64
       +
       				.product(name: "Logging", package: "swift-log"),

     

       65
       65
       +
       				"PterodactylBuild",

     

       66
       66
       +
       				"PterodactylSyntax"

     

       67
       67
       +
       			]

     

       68
       68
       +
       		),

     

       54
       69
        
       		.testTarget(

     

       55
       70
        
       			name: "PterodactylBuildTests",

     

       56
       71
        
       			dependencies: [

     

       57
       72
        
       				"PterodactylBuild",

     

       58
       73
        
       				"PterodactylSyntax",

     

       74
       74
       +
       				.product(name: "llbuild2fx", package: "swift-llbuild2")

     

       75
       75
       +
       			]

     

       76
       76
       +
       		),

     

       77
       77
       +
       		.testTarget(

     

       78
       78
       +
       			name: "PterodactylLanguageServerTests",

     

       79
       79
       +
       			dependencies: [

     

       80
       80
       +
       				"PterodactylBuild",

     

       81
       81
       +
       				"PterodactylSyntax",

     

       82
       82
       +
       				"PterodactylLanguageServer",

     

       59
       83
        
       				.product(name: "llbuild2fx", package: "swift-llbuild2")

     

       60
       84
        
       			]

     

       61
       85
        
       		),

+9 -9

Sources/PterodactylBuild/BuildContext.swift

···

       31
       31
        
       }

     

       32
       32
        
       

     

       33
       33
        
       extension BuildKey {

     

       34
       34
       -
       	func computeValue(_ fi: FXFunctionInterface<Self>, _ ctx: Context) async throws -> ValueType {

     

       34
       34
       +
       	public func computeValue(_ fi: FXFunctionInterface<Self>, _ ctx: Context) async throws -> ValueType {

     

       35
       35
        
       		try await computeValue(BuildContext(functionInterface: fi, context: ctx))

     

       36
       36
        
       	}

     

       37
       37
        
       }

     

       38
       38
        
       

     

       39
       39
        
       extension LLBCASFileTree {

     

       40
       40
       -
       	static func load<X: FXKey>(id: LLBDataID, in ctx: BuildContext<X>) async throws -> LLBCASFileTree {

     

       41
       41
       -
           try await load(id: id, from: ctx.db, ctx.context).get()

     

       40
       40
       +
       	public static func load<X: FXKey>(id: LLBDataID, in ctx: BuildContext<X>) async throws -> LLBCASFileTree {

     

       41
       41
       +
       		try await load(id: id, from: ctx.db, ctx.context).get()

     

       42
       42
        
       	}

     

       43
       43
        
       

     

       44
       44
       -
         func remove<X: FXKey>(path: AbsolutePath, in ctx: BuildContext<X>) async throws -> LLBCASFileTree {

     

       45
       45
       -
           try await remove(path: path, in: ctx.db, ctx.context).get()

     

       46
       46
       -
         }

     

       44
       44
       +
       	public func remove<X: FXKey>(path: AbsolutePath, in ctx: BuildContext<X>) async throws -> LLBCASFileTree {

     

       45
       45
       +
       		try await remove(path: path, in: ctx.db, ctx.context).get()

     

       46
       46
       +
       	}

     

       47
       47
        
       

     

       48
       48
       -
         func traverse<X: FXKey>(root: AbsolutePath, in ctx: BuildContext<X>, _ callback: (AbsolutePath, LLBDataID, LLBDirectoryEntry) async throws -> Void) async throws {

     

       49
       49
       -
           try await traverse(root: root, in: ctx.db, ctx.context, callback)

     

       50
       50
       -
         }

     

       48
       48
       +
       	public func traverse<X: FXKey>(root: AbsolutePath, in ctx: BuildContext<X>, _ callback: (AbsolutePath, LLBDataID, LLBDirectoryEntry) async throws -> Void) async throws {

     

       49
       49
       +
       		try await traverse(root: root, in: ctx.db, ctx.context, callback)

     

       50
       50
       +
       	}

     

       51
       51
        
       }

+8 -5

Sources/PterodactylBuild/Keys/Blob/GetLineMap.swift

···

       7
       7
        
       import llbuild2fx

     

       8
       8
        
       

     

       9
       9
        
       extension Keys.Blob {

     

       10
       10
       -
       	struct GetLineMap: BuildKey {

     

       11
       11
       -
       		let blobId: LLBDataID

     

       10
       10
       +
       	public struct GetLineMap: BuildKey {

     

       11
       11
       +
       		public let blobId: LLBDataID

     

       12
       12
       +
       		public init(blobId: LLBDataID) {

     

       13
       13
       +
       			self.blobId = blobId

     

       14
       14
       +
       		}

     

       12
       15
        
       		

     

       13
       13
       -
       		typealias ValueType = PterodactylSyntax.LineMap

     

       16
       16
       +
       		public typealias ValueType = PterodactylSyntax.LineMap

     

       14
       17
        
       

     

       15
       15
       -
       		static let versionDependencies: [any FXVersioning.Type] = [ReadContents.self]

     

       18
       18
       +
       		public static let versionDependencies: [any FXVersioning.Type] = [ReadContents.self]

     

       16
       19
        
       

     

       17
       17
       -
       		func computeValue(_ ctx: BuildContext<Self>) async throws -> ValueType {

     

       20
       20
       +
       		public func computeValue(_ ctx: BuildContext<Self>) async throws -> ValueType {

     

       18
       21
        
       			let code = try await ctx.request(ReadContents(blobId: blobId))

     

       19
       22
        
       			return PterodactylSyntax.LineMap(source: code)

     

       20
       23
        
       		}

+15 -8

Sources/PterodactylBuild/Keys/Blob/ParseDocument.swift

···

       5
       5
        
       import Foundation

     

       6
       6
        
       import PterodactylSyntax

     

       7
       7
        
       import llbuild2fx

     

       8
       8
       +
       import Logging

     

       8
       9
        
       

     

       9
       10
        
       extension Keys.Blob {

     

       10
       10
       -
       	struct ParseDocument: BuildKey {

     

       11
       11
       -
       		let blobId: LLBDataID

     

       12
       12
       -
       		

     

       13
       13
       -
       		typealias ValueType = PterodactylSyntax.SyntaxTree

     

       11
       11
       +
       	public struct ParseDocument: BuildKey {

     

       12
       12
       +
       		public let blobId: LLBDataID

     

       13
       13
       +
       		public init(blobId: LLBDataID) {

     

       14
       14
       +
       			self.blobId = blobId

     

       15
       15
       +
       		}

     

       16
       16
       +
       

     

       17
       17
       +
       		public struct ValueType: Codable, FXValue {

     

       18
       18
       +
       			public let tree: PterodactylSyntax.SyntaxTree

     

       19
       19
       +
       			public let diagnostics: [Diagnostic]

     

       20
       20
       +
       		}

     

       14
       21
        
       

     

       15
       15
       -
       		static let versionDependencies: [any FXVersioning.Type] = [ReadContents.self, Tokenise.self]

     

       22
       22
       +
       		public static let versionDependencies: [any FXVersioning.Type] = [ReadContents.self, Tokenise.self]

     

       16
       23
        
       

     

       17
       17
       -
       		func computeValue(_ ctx: BuildContext<Self>) async throws -> ValueType {

     

       24
       24
       +
       		public func computeValue(_ ctx: BuildContext<Self>) async throws -> ValueType {

     

       18
       25
        
       			let code = try await ctx.request(ReadContents(blobId: blobId))

     

       19
       26
        
       			let tokens = try await ctx.request(Tokenise(blobId: blobId))

     

       20
       27
        
       			var parser = Parser(source: code, tokens: tokens)

     

       21
       21
       -
       			PterodactylSyntax.Document.parse(&parser)

     

       22
       22
       -
       			return parser.tree

     

       28
       28
       +
       			PterodactylSyntax.Document.parse(&parser, recovery: [])

     

       29
       29
       +
       			return ValueType(tree: parser.builder.tree, diagnostics: parser.diagnostics)

     

       23
       30
        
       		}

     

       24
       31
        
       	}

     

       25
       32
        
       }

-35

Sources/PterodactylBuild/Keys/Blob/ParseImports.swift

···

       27
       27
        
       }

     

       28
       28
        
       

     

       29
       29
        
       

     

       30
       30
       -
       private struct ImportParser {

     

       31
       31
       -
       	private var lexer: PterodactylSyntax.Lexer

     

       32
       32
       -
       	public private(set) var imports: [String] = []

     

       33
       30
        
       

     

       34
       34
       -
       	public init(input: String) {

     

       35
       35
       -
       		self.lexer = PterodactylSyntax.Lexer(input: input)

     

       36
       36
       -
       	}

     

       37
       37
       -
       

     

       38
       38
       -
       	public mutating func parseHeader() {

     

       39
       39
       -
       		while true {

     

       40
       40
       -
       			guard let token = nextSignificantToken() else { return }

     

       41
       41
       -
       			switch token.kind {

     

       42
       42
       -
       			case .keyword(.import): parseImportStatement()

     

       43
       43
       -
       			default: return

     

       44
       44
       -
       			}

     

       45
       45
       -
       		}

     

       46
       46
       -
       	}

     

       47
       47
       -
       

     

       48
       48
       -
       	/// Returns the next non-whitespace token.

     

       49
       49
       -
       	private mutating func nextSignificantToken() -> Token? {

     

       50
       50
       -
       		var token = lexer.nextToken()

     

       51
       51
       -
       		while token?.kind.isTrivia == true {

     

       52
       52
       -
       			token = lexer.nextToken()

     

       53
       53
       -
       		}

     

       54
       54
       -
       		

     

       55
       55
       -
       		guard let token else { return nil}

     

       56
       56
       -
       		return Token(kind: token.kind, text: token.text)

     

       57
       57
       -
       	}

     

       58
       58
       -
       

     

       59
       59
       -
       	/// Parses a single `import xyz` line.

     

       60
       60
       -
       	private mutating func parseImportStatement() {

     

       61
       61
       -
       		guard let next = nextSignificantToken() else { return }

     

       62
       62
       -
       		guard next.kind == .identifier else { return }

     

       63
       63
       -
       		imports.append(next.text)

     

       64
       64
       -
       	}

     

       65
       65
       -
       }

     

       66
       31

Sources/PterodactylBuild/Keys/Blob/README.md

···

       1
       1
       +
       <!--

     

       2
       2
       +
       SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       3
       3
       +
       

     

       4
       4
       +
       SPDX-License-Identifier: MPL-2.0

     

       5
       5
       +
       -->

     

       6
       6
       +
       

     

       1
       7
        
       Certain operations do not require knowledge of the entire source tree, only a specific blob inside the source tree. These include import analysis, tokenisation, line maps, parsing, etc.

+8 -4

Sources/PterodactylBuild/Keys/Blob/ReadContents.swift

···

       6
       6
        
       import llbuild2fx

     

       7
       7
        
       

     

       8
       8
        
       extension Keys.Blob {

     

       9
       9
       -
       	struct ReadContents: BuildKey {

     

       9
       9
       +
       	public struct ReadContents: BuildKey {

     

       10
       10
        
       		let blobId: LLBDataID

     

       11
       11
        
       		

     

       12
       12
       -
       		typealias ValueType = String

     

       12
       12
       +
       		public init(blobId: LLBDataID) {

     

       13
       13
       +
       			self.blobId = blobId

     

       14
       14
       +
       		}

     

       13
       15
        
       

     

       14
       14
       -
       		static let versionDependencies: [any FXVersioning.Type] = []

     

       16
       16
       +
       		public typealias ValueType = String

     

       15
       17
        
       

     

       16
       16
       -
       		func computeValue(_ ctx: BuildContext<Self>) async throws -> String {

     

       18
       18
       +
       		public static let versionDependencies: [any FXVersioning.Type] = []

     

       19
       19
       +
       

     

       20
       20
       +
       		public func computeValue(_ ctx: BuildContext<Self>) async throws -> String {

     

       17
       21
        
       			let contents = try await ctx.load(blobId)

     

       18
       22
        
       			return try await String(decoding: Data(ctx.read(blob: contents.blob!)), as: UTF8.self)

     

       19
       23
        
       		}

+2 -2

Sources/PterodactylBuild/Keys/SourceTree/GetUnitMap.swift

···

       10
       10
        
       		let sourceTreeId: LLBDataID

     

       11
       11
        
       

     

       12
       12
        
       		typealias ValueType = UnitMap

     

       13
       13
       -
       		

     

       13
       13
       +
       

     

       14
       14
        
       		func computeValue(_ ctx: BuildContext<Self>) async throws -> UnitMap {

     

       15
       15
        
       			let sourceTree = try await LLBCASFileTree.load(id: sourceTreeId, in: ctx)

     

       16
       16
        
       			var units: [UnitName: UnitInfo] = [:]

     

       17
       17
        
       			try await sourceTree.traverse(root: .root, in: ctx) { path, blobID, directoryEntry in

     

       18
       18
       -
               let unitName = UnitName.fromPath(path)

     

       18
       18
       +
       				let unitName = UnitName.fromPath(path)

     

       19
       19
        
       				units[unitName] = UnitInfo(path: path, blobId: blobID)

     

       20
       20
        
       			}

     

       21
       21

+3 -3

Sources/PterodactylBuild/Keys.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       -
       enum Keys {

     

       8
       8
       -
       	enum Blob {}

     

       9
       9
       -
       	enum SourceTree {}

     

       7
       7
       +
       public enum Keys {

     

       8
       8
       +
       	public enum Blob {}

     

       9
       9
       +
       	public enum SourceTree {}

     

       10
       10
        
       }

+19

Sources/PterodactylLanguageServer/AbsolutePath+URI.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import TSCBasic

     

       7
       7
       +
       import LanguageServerProtocol

     

       8
       8
       +
       

     

       9
       9
       +
       extension AbsolutePath {

     

       10
       10
       +
       	public static func fromDocumentUri(_ uri: DocumentUri) throws -> Self {

     

       11
       11
       +
       		guard let url = URL(string: uri) else {

     

       12
       12
       +
       			throw URLError(.badURL)

     

       13
       13
       +
       		}

     

       14
       14
       +
       		guard url.isFileURL else {

     

       15
       15
       +
       			throw URLError(.unsupportedURL)

     

       16
       16
       +
       		}

     

       17
       17
       +
       		return try Self(validating: url.path)

     

       18
       18
       +
       	}

     

       19
       19
       +
       }

+17

Sources/PterodactylLanguageServer/Archive/LLBDeclFileTree+Singleton.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import TSCBasic

     

       7
       7
       +
       import llbuild2fx

     

       8
       8
       +
       

     

       9
       9
       +
       extension LLBDeclFileTree {

     

       10
       10
       +
       	public static func file(absolutePath: AbsolutePath, contents: String) -> Self {

     

       11
       11
       +
       		let components = absolutePath.components

     

       12
       12
       +
       		let leaf = LLBDeclFileTree.file(contents)

     

       13
       13
       +
       		return components.dropFirst().reversed().reduce(leaf) { tail, name in

     

       14
       14
       +
       			.directory(files: [name: tail])

     

       15
       15
       +
       		}

     

       16
       16
       +
       	}

     

       17
       17
       +
       }

+40

Sources/PterodactylLanguageServer/Archive/SourceTreeManager.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       //import LanguageServerProtocol

     

       6
       6
       +
       //import PterodactylBuild

     

       7
       7
       +
       //import TSCBasic

     

       8
       8
       +
       //import llbuild2fx

     

       9
       9
       +
       //

     

       10
       10
       +
       //actor SourceTreeManager {

     

       11
       11
       +
       //	private let buildEngine: FXEngine

     

       12
       12
       +
       //	private let casClient: LLBCASFSClient

     

       13
       13
       +
       //	private let casContext: TSCUtility.Context

     

       14
       14
       +
       //	private(set) var sourceTree: LLBCASFileTree

     

       15
       15
       +
       //

     

       16
       16
       +
       //	init(buildEngine: FXEngine, casClient: LLBCASFSClient, casContext: TSCUtility.Context, sourceTree: LLBCASFileTree? = nil) async throws {

     

       17
       17
       +
       //		self.buildEngine = buildEngine

     

       18
       18
       +
       //		self.casClient = casClient

     

       19
       19
       +
       //		self.casContext = casContext

     

       20
       20
       +
       //		if let sourceTree {

     

       21
       21
       +
       //			self.sourceTree = sourceTree

     

       22
       22
       +
       //		} else {

     

       23
       23
       +
       //			self.sourceTree = try await casClient.storeDir(.dir([:]), casContext).get()

     

       24
       24
       +
       //		}

     

       25
       25
       +
       //	}

     

       26
       26
       +
       //

     

       27
       27
       +
       //	func setBufferText(uri: DocumentUri, text: String) async throws -> LLBCASFileTree {

     

       28
       28
       +
       //		let path = try AbsolutePath.fromDocumentUri(uri)

     

       29
       29
       +
       //		let singletonDeclTree = LLBDeclFileTree.file(absolutePath: path, contents: text)

     

       30
       30
       +
       //		let singletonTree: LLBCASFileTree = try await casClient.storeDir(singletonDeclTree, casContext).get()

     

       31
       31
       +
       //		self.sourceTree = try await sourceTree.merge(with: singletonTree, in: casClient.db, casContext).get()

     

       32
       32
       +
       //		return sourceTree

     

       33
       33
       +
       //	}

     

       34
       34
       +
       //

     

       35
       35
       +
       //	func getBufferText(uri: DocumentUri) async throws -> String? {

     

       36
       36
       +
       //		let path = try AbsolutePath.fromDocumentUri(uri)

     

       37
       37
       +
       //		guard let (id, _) = try await sourceTree.lookup(path: path, in: casClient.db, casContext).get() else { return nil }

     

       38
       38
       +
       //		return try await buildEngine.build(key: Keys.Blob.ReadContents(blobId: id), casContext).get()

     

       39
       39
       +
       //	}

     

       40
       40
       +
       //}

+269

Sources/PterodactylLanguageServer/EventHandler.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import JSONRPC

     

       7
       7
       +
       import LanguageServer

     

       8
       8
       +
       import LanguageServerProtocol

     

       9
       9
       +
       import Logging

     

       10
       10
       +
       import PterodactylBuild

     

       11
       11
       +
       import PterodactylSyntax

     

       12
       12
       +
       import TSCBasic

     

       13
       13
       +
       import llbuild2fx

     

       14
       14
       +
       

     

       15
       15
       +
       final class EventHandler {

     

       16
       16
       +
       	private let connection: JSONRPCClientConnection

     

       17
       17
       +
       	private let buildEngine: FXEngine

     

       18
       18
       +
       	private let casContext: TSCUtility.Context

     

       19
       19
       +
       	private let casClient: LLBCASFSClient

     

       20
       20
       +
       

     

       21
       21
       +
       	var storedBlobs: [DocumentUri: (blobId: LLBDataID, version: Int?)] = [:]

     

       22
       22
       +
       

     

       23
       23
       +
       	init(connection: JSONRPCClientConnection) {

     

       24
       24
       +
       		self.connection = connection

     

       25
       25
       +
       

     

       26
       26
       +
       		let group = LLBMakeDefaultDispatchGroup()

     

       27
       27
       +
       		let db = LLBInMemoryCASDatabase(group: group)

     

       28
       28
       +
       		let functionCache = FXInMemoryFunctionCache(group: group)

     

       29
       29
       +
       		let executor = FXLocalExecutor()

     

       30
       30
       +
       		self.buildEngine = FXEngine(group: group, db: db, functionCache: functionCache, executor: executor)

     

       31
       31
       +
       		self.casClient = LLBCASFSClient(db)

     

       32
       32
       +
       		self.casContext = Context()

     

       33
       33
       +
       	}

     

       34
       34
       +
       

     

       35
       35
       +
       	func storeBlob(text: String, uri: DocumentUri, version: Int?) async throws -> LLBDataID {

     

       36
       36
       +
       		if let stored = storedBlobs[uri], let version, let storedVersion = stored.version, storedVersion >= version {

     

       37
       37
       +
       			return stored.blobId

     

       38
       38
       +
       		}

     

       39
       39
       +
       

     

       40
       40
       +
       		let blobId: LLBDataID = try await casClient.store(LLBByteBuffer(string: text), casContext).get()

     

       41
       41
       +
       		storedBlobs[uri] = (blobId: blobId, version: version)

     

       42
       42
       +
       		return blobId

     

       43
       43
       +
       	}

     

       44
       44
       +
       

     

       45
       45
       +
       	func publishLiveDiagnostics(blobId: LLBDataID, uri: DocumentUri, version: Int?) async throws {

     

       46
       46
       +
       		let lineMap = try await buildEngine.build(key: Keys.Blob.GetLineMap(blobId: blobId), casContext).get()

     

       47
       47
       +
       		let parseResult = try await buildEngine.build(key: Keys.Blob.ParseDocument(blobId: blobId), casContext).get()

     

       48
       48
       +
       		let diagnostics = parseResult.diagnostics.map { $0.lspDiagnostic(lineMap: lineMap) }

     

       49
       49
       +
       		let publishParams = PublishDiagnosticsParams(uri: uri, version: version, diagnostics: diagnostics)

     

       50
       50
       +
       		try await connection.sendNotification(.textDocumentPublishDiagnostics(publishParams))

     

       51
       51
       +
       	}

     

       52
       52
       +
       }

     

       53
       53
       +
       

     

       54
       54
       +
       

     

       55
       55
       +
       extension EventHandler: LanguageServer.EventHandler {

     

       56
       56
       +
       	var textDocumentSinkOptions: TextDocumentSyncOptions {

     

       57
       57
       +
       		TextDocumentSyncOptions(

     

       58
       58
       +
       			openClose: true,

     

       59
       59
       +
       			change: .full,

     

       60
       60
       +
       

     

       61
       61
       +
       			save: .optionA(false)

     

       62
       62
       +
       		)

     

       63
       63
       +
       	}

     

       64
       64
       +
       

     

       65
       65
       +
       	var completionOptions: CompletionOptions {

     

       66
       66
       +
       		CompletionOptions(

     

       67
       67
       +
       			workDoneProgress: false,

     

       68
       68
       +
       			triggerCharacters: [],  // TODO

     

       69
       69
       +
       			allCommitCharacters: nil,

     

       70
       70
       +
       			resolveProvider: false,

     

       71
       71
       +
       			completionItem: nil

     

       72
       72
       +
       		)

     

       73
       73
       +
       	}

     

       74
       74
       +
       

     

       75
       75
       +
       	var semanticTokensLegend: SemanticTokensLegend {

     

       76
       76
       +
       		SemanticTokensLegend(tokenTypes: SemanticTokenTypes.allStrings, tokenModifiers: SemanticTokenModifiers.allStrings)

     

       77
       77
       +
       	}

     

       78
       78
       +
       

     

       79
       79
       +
       	var semanticTokensOptions: SemanticTokensOptions {

     

       80
       80
       +
       		SemanticTokensOptions(legend: semanticTokensLegend, full: .optionB(SemanticTokensClientCapabilities.Requests.Full(delta: false)))

     

       81
       81
       +
       	}

     

       82
       82
       +
       

     

       83
       83
       +
       	func initialize(id: JSONId, params: InitializeParams) async -> Response<InitializationResponse> {

     

       84
       84
       +
       		Logger.shared.debug("Received initialize request")

     

       85
       85
       +
       		var serverCapabilities = ServerCapabilities()

     

       86
       86
       +
       		serverCapabilities.textDocumentSync = .optionA(textDocumentSinkOptions)

     

       87
       87
       +
       		serverCapabilities.completionProvider = completionOptions

     

       88
       88
       +
       		serverCapabilities.hoverProvider = .optionA(false)

     

       89
       89
       +
       		serverCapabilities.semanticTokensProvider = .optionA(semanticTokensOptions)

     

       90
       90
       +
       		serverCapabilities.foldingRangeProvider = .optionA(true)

     

       91
       91
       +
       		let response = InitializationResponse(

     

       92
       92
       +
       			capabilities: serverCapabilities,

     

       93
       93
       +
       			serverInfo: nil

     

       94
       94
       +
       		)

     

       95
       95
       +
       		return .success(response)

     

       96
       96
       +
       	}

     

       97
       97
       +
       

     

       98
       98
       +
       	func textDocumentDidChange(_ params: DidChangeTextDocumentParams) async {

     

       99
       99
       +
       		guard let text = params.contentChanges.first?.text else { return }

     

       100
       100
       +
       		do {

     

       101
       101
       +
       			let blobId: LLBDataID = try await storeBlob(text: text, uri: params.textDocument.uri, version: params.textDocument.version)

     

       102
       102
       +
       			try await publishLiveDiagnostics(blobId: blobId, uri: params.textDocument.uri, version: params.textDocument.version)

     

       103
       103
       +
       		} catch {}

     

       104
       104
       +
       	}

     

       105
       105
       +
       

     

       106
       106
       +
       	func textDocumentDidOpen(_ params: DidOpenTextDocumentParams) async {

     

       107
       107
       +
       		let text = params.textDocument.text

     

       108
       108
       +
       		do {

     

       109
       109
       +
       			let blobId: LLBDataID = try await storeBlob(text: text, uri: params.textDocument.uri, version: params.textDocument.version)

     

       110
       110
       +
       			try await publishLiveDiagnostics(blobId: blobId, uri: params.textDocument.uri, version: params.textDocument.version)

     

       111
       111
       +
       		} catch {}

     

       112
       112
       +
       	}

     

       113
       113
       +
       

     

       114
       114
       +
       	func semanticTokensFull(id: JSONId, params: SemanticTokensParams) async -> Response<SemanticTokensResponse> {

     

       115
       115
       +
       		guard let storedBlob = storedBlobs[params.textDocument.uri] else { return .success(nil) }

     

       116
       116
       +
       

     

       117
       117
       +
       		do {

     

       118
       118
       +
       			let lineMap = try await buildEngine.build(key: Keys.Blob.GetLineMap(blobId: storedBlob.blobId), casContext).get()

     

       119
       119
       +
       			let parseResult = try await buildEngine.build(key: Keys.Blob.ParseDocument(blobId: storedBlob.blobId), casContext).get()

     

       120
       120
       +
       			let cursor = SyntaxCursor(lineMap: lineMap, node: .tree(parseResult.tree), utf16Offset: 0)

     

       121
       121
       +
       			return .success(SemanticTokensResponse(SemanticTokens(resultId: nil, tokens: cursor.semanticTokens)))

     

       122
       122
       +
       		} catch {

     

       123
       123
       +
       			return .success(nil)

     

       124
       124
       +
       		}

     

       125
       125
       +
       	}

     

       126
       126
       +
       

     

       127
       127
       +
       	func foldingRange(id: JSONId, params: FoldingRangeParams) async -> Response<FoldingRangeResponse> {

     

       128
       128
       +
       		guard let storedBlob = storedBlobs[params.textDocument.uri] else { return .success(nil) }

     

       129
       129
       +
       

     

       130
       130
       +
       		do {

     

       131
       131
       +
       			let lineMap = try await buildEngine.build(key: Keys.Blob.GetLineMap(blobId: storedBlob.blobId), casContext).get()

     

       132
       132
       +
       			let parseResult = try await buildEngine.build(key: Keys.Blob.ParseDocument(blobId: storedBlob.blobId), casContext).get()

     

       133
       133
       +
       			let cursor = SyntaxCursor(lineMap: lineMap, node: .tree(parseResult.tree), utf16Offset: 0)

     

       134
       134
       +
       			return .success(FoldingRangeResponse(cursor.foldingRanges))

     

       135
       135
       +
       		} catch {

     

       136
       136
       +
       			return .success(nil)

     

       137
       137
       +
       		}

     

       138
       138
       +
       	}

     

       139
       139
       +
       

     

       140
       140
       +
       

     

       141
       141
       +
       	func typeHierarchySupertypes(

     

       142
       142
       +
       		id: JSONRPC.JSONId,

     

       143
       143
       +
       		params: TypeHierarchySupertypesParams

     

       144
       144
       +
       	) async -> Response<TypeHierarchySupertypesResponse> {

     

       145
       145
       +
       		.success(nil)

     

       146
       146
       +
       	}

     

       147
       147
       +
       

     

       148
       148
       +
       	func typeHierarchySubtypes(

     

       149
       149
       +
       		id: JSONId,

     

       150
       150
       +
       		params: TypeHierarchySubtypesParams

     

       151
       151
       +
       	) async -> Response<TypeHierarchySubtypesResponse> {

     

       152
       152
       +
       		.success(nil)

     

       153
       153
       +
       	}

     

       154
       154
       +
       

     

       155
       155
       +
       	func internalError(_ error: any Error) async {

     

       156
       156
       +
       		Logger.shared.error("Received error: \(error)")

     

       157
       157
       +
       	}

     

       158
       158
       +
       

     

       159
       159
       +
       	func initialized(_ params: InitializedParams) async {

     

       160
       160
       +
       

     

       161
       161
       +
       	}

     

       162
       162
       +
       

     

       163
       163
       +
       	func exit() async {

     

       164
       164
       +
       		Logger.shared.info("Received exit notification")

     

       165
       165
       +
       		Foundation.exit(0)

     

       166
       166
       +
       	}

     

       167
       167
       +
       

     

       168
       168
       +
       	func diagnostics(id: JSONId, params: DocumentDiagnosticParams) async -> Response<DocumentDiagnosticReport> {

     

       169
       169
       +
       		return .success(.init(kind: .unchanged))

     

       170
       170
       +
       	}

     

       171
       171
       +
       

     

       172
       172
       +
       

     

       173
       173
       +
       

     

       174
       174
       +
       	func textDocumentDidClose(_ params: DidCloseTextDocumentParams) async {

     

       175
       175
       +
       

     

       176
       176
       +
       	}

     

       177
       177
       +
       

     

       178
       178
       +
       	func textDocumentWillSave(_ params: WillSaveTextDocumentParams) async {

     

       179
       179
       +
       

     

       180
       180
       +
       	}

     

       181
       181
       +
       

     

       182
       182
       +
       	func textDocumentDidSave(_ params: DidSaveTextDocumentParams) async {

     

       183
       183
       +
       

     

       184
       184
       +
       	}

     

       185
       185
       +
       

     

       186
       186
       +
       	func protocolCancelRequest(_ params: CancelParams) async {

     

       187
       187
       +
       

     

       188
       188
       +
       	}

     

       189
       189
       +
       

     

       190
       190
       +
       	func protocolSetTrace(_ params: SetTraceParams) async {

     

       191
       191
       +
       

     

       192
       192
       +
       	}

     

       193
       193
       +
       

     

       194
       194
       +
       	func workspaceDidChangeWatchedFiles(_ params: DidChangeWatchedFilesParams) async {

     

       195
       195
       +
       

     

       196
       196
       +
       	}

     

       197
       197
       +
       

     

       198
       198
       +
       	func windowWorkDoneProgressCancel(_ params: WorkDoneProgressCancelParams) async {

     

       199
       199
       +
       

     

       200
       200
       +
       	}

     

       201
       201
       +
       

     

       202
       202
       +
       	func workspaceDidChangeWorkspaceFolders(_ params: DidChangeWorkspaceFoldersParams) async {

     

       203
       203
       +
       

     

       204
       204
       +
       	}

     

       205
       205
       +
       

     

       206
       206
       +
       	func workspaceDidChangeConfiguration(_ params: DidChangeConfigurationParams) async {

     

       207
       207
       +
       

     

       208
       208
       +
       	}

     

       209
       209
       +
       

     

       210
       210
       +
       	func workspaceDidCreateFiles(_ params: CreateFilesParams) async {

     

       211
       211
       +
       

     

       212
       212
       +
       	}

     

       213
       213
       +
       

     

       214
       214
       +
       	func workspaceDidRenameFiles(_ params: RenameFilesParams) async {

     

       215
       215
       +
       

     

       216
       216
       +
       	}

     

       217
       217
       +
       

     

       218
       218
       +
       	func workspaceDidDeleteFiles(_ params: DeleteFilesParams) async {

     

       219
       219
       +
       

     

       220
       220
       +
       	}

     

       221
       221
       +
       

     

       222
       222
       +
       	func shutdown(id: JSONId) async {}

     

       223
       223
       +
       	func workspaceInlayHintRefresh(id: JSONId) async {}

     

       224
       224
       +
       	func workspaceExecuteCommand(id: JSONId, params: ExecuteCommandParams) async -> Response<LSPAny?> { .success(nil) }

     

       225
       225
       +
       	func workspaceWillCreateFiles(id: JSONId, params: CreateFilesParams) async -> Response<WorkspaceEdit?> { .success(nil) }

     

       226
       226
       +
       	func workspaceWillRenameFiles(id: JSONId, params: RenameFilesParams) async -> Response<WorkspaceEdit?> { .success(nil) }

     

       227
       227
       +
       	func workspaceWillDeleteFiles(id: JSONId, params: DeleteFilesParams) async -> Response<WorkspaceEdit?> { .success(nil) }

     

       228
       228
       +
       	func workspaceSymbol(id: JSONId, params: WorkspaceSymbolParams) async -> Response<WorkspaceSymbolResponse> { .success(nil) }

     

       229
       229
       +
       	//	func workspaceSymbolResolve(id: JSONId, params: WorkspaceSymbol) async -> Response<WorkspaceSymbol> { .success(nil) }

     

       230
       230
       +
       	func textDocumentWillSaveWaitUntil(id: JSONId, params: WillSaveTextDocumentParams) async -> Response<[TextEdit]?> { .success(nil) }

     

       231
       231
       +
       	func completion(id: JSONId, params: CompletionParams) async -> Response<CompletionResponse> {

     

       232
       232
       +
       		.success(CompletionResponse(.optionB(.init(isIncomplete: false, items: []))))

     

       233
       233
       +
       	}

     

       234
       234
       +
       	//	func completionItemResolve(id: JSONId, params: CompletionItem) async -> Response<CompletionItem> { .success(nil) }

     

       235
       235
       +
       	func hover(id: JSONId, params: TextDocumentPositionParams) async -> Response<HoverResponse> { .success(nil) }

     

       236
       236
       +
       	func signatureHelp(id: JSONId, params: TextDocumentPositionParams) async -> Response<SignatureHelpResponse> { .success(nil) }

     

       237
       237
       +
       	func declaration(id: JSONId, params: TextDocumentPositionParams) async -> Response<DeclarationResponse> { .success(nil) }

     

       238
       238
       +
       	func definition(id: JSONId, params: TextDocumentPositionParams) async -> Response<DefinitionResponse> { .success(nil) }

     

       239
       239
       +
       	func typeDefinition(id: JSONId, params: TextDocumentPositionParams) async -> Response<TypeDefinitionResponse> { .success(nil) }

     

       240
       240
       +
       	func implementation(id: JSONId, params: TextDocumentPositionParams) async -> Response<ImplementationResponse> { .success(nil) }

     

       241
       241
       +
       	func documentHighlight(id: JSONId, params: DocumentHighlightParams) async -> Response<DocumentHighlightResponse> { .success(nil) }

     

       242
       242
       +
       	func documentSymbol(id: JSONId, params: DocumentSymbolParams) async -> Response<DocumentSymbolResponse> { .success(nil) }

     

       243
       243
       +
       	func codeAction(id: JSONId, params: CodeActionParams) async -> Response<CodeActionResponse> { .success(nil) }

     

       244
       244
       +
       	//	func codeActionResolve(id: JSONId, params: CodeAction) async -> Response<CodeAction> { .success(nil) }

     

       245
       245
       +
       	func codeLens(id: JSONId, params: CodeLensParams) async -> Response<CodeLensResponse> { .success(nil) }

     

       246
       246
       +
       	//	func codeLensResolve(id: JSONId, params: CodeLens) async -> Response<CodeLens> { .success(nil) }

     

       247
       247
       +
       	func selectionRange(id: JSONId, params: SelectionRangeParams) async -> Response<SelectionRangeResponse> { .success(nil) }

     

       248
       248
       +
       	func linkedEditingRange(id: JSONId, params: LinkedEditingRangeParams) async -> Response<LinkedEditingRangeResponse> { .success(nil) }

     

       249
       249
       +
       	func prepareCallHierarchy(id: JSONId, params: CallHierarchyPrepareParams) async -> Response<CallHierarchyPrepareResponse> { .success(nil) }

     

       250
       250
       +
       	func prepareRename(id: JSONId, params: PrepareRenameParams) async -> Response<PrepareRenameResponse> { .success(nil) }

     

       251
       251
       +
       	func prepareTypeHeirarchy(id: JSONId, params: TypeHierarchyPrepareParams) async -> Response<PrepareTypeHeirarchyResponse> { .success(nil) }

     

       252
       252
       +
       	func rename(id: JSONId, params: RenameParams) async -> Response<RenameResponse> { .success(nil) }

     

       253
       253
       +
       	func inlayHint(id: JSONId, params: InlayHintParams) async -> Response<InlayHintResponse> { .success(nil) }

     

       254
       254
       +
       	func inlayHintResolve(id: JSONId, params: InlayHint) async -> Response<InlayHintResponse> { .success(nil) }

     

       255
       255
       +
       	func documentLink(id: JSONId, params: DocumentLinkParams) async -> Response<DocumentLinkResponse> { .success(nil) }

     

       256
       256
       +
       	//	func documentLinkResolve(id: JSONId, params: DocumentLink) async -> Response<DocumentLink> { .success(nil) }

     

       257
       257
       +
       	//	func documentColor(id: JSONId, params: DocumentColorParams) async -> Response<DocumentColorResponse> { .success(nil) }

     

       258
       258
       +
       	//	func colorPresentation(id: JSONId, params: ColorPresentationParams) async -> Response<ColorPresentationResponse> { .success(nil) }

     

       259
       259
       +
       	func formatting(id: JSONId, params: DocumentFormattingParams) async -> Response<FormattingResult> { .success(nil) }

     

       260
       260
       +
       	func rangeFormatting(id: JSONId, params: DocumentRangeFormattingParams) async -> Response<FormattingResult> { .success(nil) }

     

       261
       261
       +
       	func onTypeFormatting(id: JSONId, params: DocumentOnTypeFormattingParams) async -> Response<FormattingResult> { .success(nil) }

     

       262
       262
       +
       	func references(id: JSONId, params: ReferenceParams) async -> Response<ReferenceResponse> { .success(nil) }

     

       263
       263
       +
       	func moniker(id: JSONId, params: MonikerParams) async -> Response<MonikerResponse> { .success(nil) }

     

       264
       264
       +
       	func semanticTokensFullDelta(id: JSONId, params: SemanticTokensDeltaParams) async -> Response<SemanticTokensDeltaResponse> { .success(nil) }

     

       265
       265
       +
       	func semanticTokensRange(id: JSONId, params: SemanticTokensRangeParams) async -> Response<SemanticTokensResponse> { .success(nil) }

     

       266
       266
       +
       	func callHierarchyIncomingCalls(id: JSONId, params: CallHierarchyIncomingCallsParams) async -> Response<CallHierarchyIncomingCallsResponse> { .success(nil) }

     

       267
       267
       +
       	func callHierarchyOutgoingCalls(id: JSONId, params: CallHierarchyOutgoingCallsParams) async -> Response<CallHierarchyOutgoingCallsResponse> { .success(nil) }

     

       268
       268
       +
       	func custom(id: JSONId, method: String, params: LSPAny) async -> Response<LSPAny> { .success(nil) }

     

       269
       269
       +
       }

+63

Sources/PterodactylLanguageServer/Logger.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import Logging

     

       7
       7
       +
       

     

       8
       8
       +
       struct FileLogHandler: LogHandler {

     

       9
       9
       +
       	private let label: String

     

       10
       10
       +
       	private let fileHandle: FileHandle

     

       11
       11
       +
       	var logLevel: Logger.Level = .info

     

       12
       12
       +
       	var metadata: Logger.Metadata = [:]

     

       13
       13
       +
       

     

       14
       14
       +
       	init(label: String, fileURL: URL) {

     

       15
       15
       +
       		self.label = label

     

       16
       16
       +
       

     

       17
       17
       +
       		// Ensure file exists

     

       18
       18
       +
       		if !FileManager.default.fileExists(atPath: fileURL.path) {

     

       19
       19
       +
       			FileManager.default.createFile(atPath: fileURL.path, contents: nil)

     

       20
       20
       +
       		}

     

       21
       21
       +
       

     

       22
       22
       +
       		// Open file for updating (read/write)

     

       23
       23
       +
       		self.fileHandle = try! FileHandle(forUpdating: fileURL)

     

       24
       24
       +
       		self.fileHandle.seekToEndOfFile()

     

       25
       25
       +
       	}

     

       26
       26
       +
       

     

       27
       27
       +
       	subscript(metadataKey key: String) -> Logger.Metadata.Value? {

     

       28
       28
       +
       		get { metadata[key] }

     

       29
       29
       +
       		set { metadata[key] = newValue }

     

       30
       30
       +
       	}

     

       31
       31
       +
       

     

       32
       32
       +
       	func log(

     

       33
       33
       +
       		level: Logger.Level,

     

       34
       34
       +
       		message: Logger.Message,

     

       35
       35
       +
       		metadata: Logger.Metadata?,

     

       36
       36
       +
       		source: String,

     

       37
       37
       +
       		file: String,

     

       38
       38
       +
       		function: String,

     

       39
       39
       +
       		line: UInt

     

       40
       40
       +
       	) {

     

       41
       41
       +
       		var fullMetadata = self.metadata

     

       42
       42
       +
       		metadata?.forEach { fullMetadata[$0] = $1 }

     

       43
       43
       +
       

     

       44
       44
       +
       		let line = "[\(level)] \(message)\n"

     

       45
       45
       +
       		if let data = line.data(using: .utf8) {

     

       46
       46
       +
       			fileHandle.write(data)

     

       47
       47
       +
       		}

     

       48
       48
       +
       	}

     

       49
       49
       +
       }

     

       50
       50
       +
       

     

       51
       51
       +
       extension Logger {

     

       52
       52
       +
       	static let shared: Self = {

     

       53
       53
       +
       		let logFile = URL(fileURLWithPath: "/tmp/pterodactyl-language-server.log")

     

       54
       54
       +
       

     

       55
       55
       +
       		LoggingSystem.bootstrap { label in

     

       56
       56
       +
       			FileLogHandler(label: label, fileURL: logFile)

     

       57
       57
       +
       		}

     

       58
       58
       +
       

     

       59
       59
       +
       		var logger = Logger(label: "org.pterodactyl.language-server")

     

       60
       60
       +
       		logger.logLevel = .debug

     

       61
       61
       +
       		return logger

     

       62
       62
       +
       	}()

     

       63
       63
       +
       }

+54

Sources/PterodactylLanguageServer/PterodactylLanguageServer.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import JSONRPC

     

       7
       7
       +
       import LanguageServer

     

       8
       8
       +
       import LanguageServerProtocol

     

       9
       9
       +
       import Logging

     

       10
       10
       +
       

     

       11
       11
       +
       final class Server {

     

       12
       12
       +
       	private let connection: JSONRPCClientConnection

     

       13
       13
       +
       	private let eventHandler: EventHandler

     

       14
       14
       +
       

     

       15
       15
       +
       	init() {

     

       16
       16
       +
       		let channel = DataChannel.stdio()

     

       17
       17
       +
       		connection = JSONRPCClientConnection(channel)

     

       18
       18
       +
       		eventHandler = EventHandler(connection: connection)

     

       19
       19
       +
       	}

     

       20
       20
       +
       

     

       21
       21
       +
       	func start() async throws {

     

       22
       22
       +
       		do {

     

       23
       23
       +
       			Logger.shared.debug("Starting")

     

       24
       24
       +
       			try await startEventLoop()

     

       25
       25
       +
       		} catch {

     

       26
       26
       +
       			Logger.shared.error("Server error: \(error)")

     

       27
       27
       +
       			throw error

     

       28
       28
       +
       		}

     

       29
       29
       +
       	}

     

       30
       30
       +
       

     

       31
       31
       +
       	func startEventLoop() async throws {

     

       32
       32
       +
       		for await event in await connection.eventSequence {

     

       33
       33
       +
       			try await handle(event: event)

     

       34
       34
       +
       		}

     

       35
       35
       +
       	}

     

       36
       36
       +
       

     

       37
       37
       +
       	func handle(event: ClientEvent) async throws {

     

       38
       38
       +
       		switch event {

     

       39
       39
       +
       		case .request(let id, let request):

     

       40
       40
       +
       			await eventHandler.handleRequest(id: id, request: request)

     

       41
       41
       +
       		case .notification(let notification):

     

       42
       42
       +
       			await eventHandler.handleNotification(notification)

     

       43
       43
       +
       		case .error(_): ()

     

       44
       44
       +
       		}

     

       45
       45
       +
       	}

     

       46
       46
       +
       }

     

       47
       47
       +
       

     

       48
       48
       +
       @main

     

       49
       49
       +
       struct PterodactylLanguageServer {

     

       50
       50
       +
       	static func main() async throws {

     

       51
       51
       +
       		let server = Server()

     

       52
       52
       +
       		try await server.start()

     

       53
       53
       +
       	}

     

       54
       54
       +
       }

+1 -1

Sources/PterodactylSyntax/BlockLayoutProcessor.swift

···

       62
       62
        
       					result.append(Token(kind: .blockEnd, text: ""))

     

       63
       63
        
       				}

     

       64
       64
        
       

     

       65
       65
       -
       				if !firstTokenInBlock && indentStack.count > 1 && locatedToken.location.startColumn == indentStack.last! {

     

       65
       65
       +
       				if !firstTokenInBlock && indentStack.count > 1 && locatedToken.token.kind.isVisible && locatedToken.location.startColumn == indentStack.last! {

     

       66
       66
        
       					result.append(Token(kind: .blockSep, text: ""))

     

       67
       67
        
       				}

     

       68
       68
        
       			}

-53

Sources/PterodactylSyntax/Cursor.swift

···

       1
       1
       -
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       -
       //

     

       3
       3
       -
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       -
       

     

       5
       5
       -
       import Foundation

     

       6
       6
       -
       import LanguageServerProtocol

     

       7
       7
       -
       

     

       8
       8
       -
       extension SyntaxTree {

     

       9
       9
       -
       	public final class Cursor {

     

       10
       10
       -
       		public let lineMap: LineMap

     

       11
       11
       -
       		public let node: SyntaxTree.Child

     

       12
       12
       -
       		public let utf16Offset: Int

     

       13
       13
       -
       

     

       14
       14
       -
       		public private(set) lazy var children: [Cursor] = {

     

       15
       15
       -
       			var children: [Cursor] = []

     

       16
       16
       -
       			var utf16Offset = utf16Offset

     

       17
       17
       -
       			for childNode in node.children {

     

       18
       18
       -
       				children.append(Self(lineMap: lineMap, node: childNode, utf16Offset: utf16Offset))

     

       19
       19
       -
       				utf16Offset += childNode.utf16Length

     

       20
       20
       -
       			}

     

       21
       21
       -
       

     

       22
       22
       -
       			return children

     

       23
       23
       -
       		}()

     

       24
       24
       -
       

     

       25
       25
       -
       		public var utf16Range: Range<Int> {

     

       26
       26
       -
       			utf16Offset..<utf16Offset + node.utf16Length

     

       27
       27
       -
       		}

     

       28
       28
       -
       

     

       29
       29
       -
       		init(lineMap: LineMap, node: SyntaxTree.Child, utf16Offset: Int) {

     

       30
       30
       -
       			self.lineMap = lineMap

     

       31
       31
       -
       			self.node = node

     

       32
       32
       -
       			self.utf16Offset = utf16Offset

     

       33
       33
       -
       		}

     

       34
       34
       -
       	}

     

       35
       35
       -
       }

     

       36
       36
       -
       

     

       37
       37
       -
       extension SyntaxTree.Cursor {

     

       38
       38
       -
       	public func firstChild<T>(mapping: (SyntaxTree.Cursor) -> T?) -> T? {

     

       39
       39
       -
       		for child in children {

     

       40
       40
       -
       			if let result = mapping(child) {

     

       41
       41
       -
       				return result

     

       42
       42
       -
       			} else {

     

       43
       43
       -
       				continue

     

       44
       44
       -
       			}

     

       45
       45
       -
       		}

     

       46
       46
       -
       		return nil

     

       47
       47
       -
       	}

     

       48
       48
       -
       	

     

       49
       49
       -
       	public func children<T>(mapping: (SyntaxTree.Cursor) -> T?) -> [T] {

     

       50
       50
       -
       		children.compactMap(mapping)

     

       51
       51
       -
       	}

     

       52
       52
       -
       }

     

       53
       53
       -

+26 -11

Sources/PterodactylSyntax/Diagnostic.swift

···

       2
       2
        
       //

     

       3
       3
        
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
        
       

     

       5
       5
       -
       public struct Diagnostic: Equatable {

     

       6
       6
       -
       	enum Severity: Equatable {

     

       7
       7
       -
       		case error

     

       8
       8
       -
       		case warning

     

       9
       9
       -
       		case note

     

       10
       10
       -
       	}

     

       11
       11
       -
       	let message: String

     

       12
       12
       -
       	let severity: Severity

     

       13
       13
       -
       	/// Absolute UTF-16 code unit offsets from start of source

     

       14
       14
       -
       	let absoluteRange: Range<Int>

     

       5
       5
       +
       import LanguageServerProtocol

     

       6
       6
       +
       

     

       7
       7
       +
       public struct Diagnostic: Equatable, Codable, Sendable {

     

       8
       8
       +
       	public typealias Severity = LanguageServerProtocol.DiagnosticSeverity

     

       9
       9
       +
       

     

       10
       10
       +
       	public let message: String

     

       11
       11
       +
       	public let severity: Severity

     

       12
       12
       +
       	public let absoluteUtf16Range: Range<Int>

     

       15
       13
        
       

     

       16
       14
        
       	init(message: String, severity: Severity, absoluteRange: Range<Int>) {

     

       17
       15
        
       		self.message = message

     

       18
       16
        
       		self.severity = severity

     

       19
       19
       -
       		self.absoluteRange = absoluteRange

     

       17
       17
       +
       		self.absoluteUtf16Range = absoluteRange

     

       20
       18
        
       	}

     

       21
       19
        
       

     

       22
       20
        
       	init(message: String, absoluteRange: Range<Int>) {

     

       23
       21
        
       		self.init(message: message, severity: Severity.error, absoluteRange: absoluteRange)

     

       22
       22
       +
       	}

     

       23
       23
       +
       

     

       24
       24
       +
       	func lspRange(lineMap: LineMap) -> LanguageServerProtocol.LSPRange {

     

       25
       25
       +
       		let start = lineMap.location(at: absoluteUtf16Range.lowerBound)

     

       26
       26
       +
       		let end = lineMap.location(at: absoluteUtf16Range.upperBound)

     

       27
       27
       +
       		return LSPRange(

     

       28
       28
       +
       			start: Position(line: start.line, character: start.column),

     

       29
       29
       +
       			end: Position(line: end.line, character: end.column)

     

       30
       30
       +
       		)

     

       31
       31
       +
       	}

     

       32
       32
       +
       

     

       33
       33
       +
       	public func lspDiagnostic(lineMap: LineMap) -> LanguageServerProtocol.Diagnostic {

     

       34
       34
       +
       		LanguageServerProtocol.Diagnostic(

     

       35
       35
       +
       			range: lspRange(lineMap: lineMap),

     

       36
       36
       +
       			severity: severity,

     

       37
       37
       +
       			message: message

     

       38
       38
       +
       		)

     

       24
       39
        
       	}

     

       25
       40
        
       }

+4 -5

Sources/PterodactylSyntax/FoldingRanges.swift

···

       10
       10
        
       	case reverse

     

       11
       11
        
       }

     

       12
       12
        
       

     

       13
       13
       -
       extension Array {

     

       14
       14
       -
       	fileprivate func apply(symmetry: ArraySymmetry) -> any Collection<Element> {

     

       13
       13
       +
       fileprivate extension Array {

     

       14
       14
       +
       	func apply(symmetry: ArraySymmetry) -> any Collection<Element> {

     

       15
       15
        
       		switch symmetry {

     

       16
       16
        
       		case .identity: self

     

       17
       17
        
       		case .reverse: reversed()

     
···

       19
       19
        
       	}

     

       20
       20
        
       }

     

       21
       21
        
       

     

       22
       22
       -
       extension SyntaxTree.Cursor {

     

       23
       23
       -
       	private func firstVisibleNode(under symmetry: ArraySymmetry) -> SyntaxTree.Cursor? {

     

       22
       22
       +
       extension SyntaxCursor {

     

       23
       23
       +
       	private func firstVisibleNode(under symmetry: ArraySymmetry) -> SyntaxCursor? {

     

       24
       24
        
       		switch node {

     

       25
       25
        
       		case .token(let token, _):

     

       26
       26
        
       			return token.kind.isVisible ? self : nil

     

       27
       27
        
       		case .tree:

     

       28
       28
        
       			for child in children.apply(symmetry: symmetry) {

     

       29
       29
        
       				if let visibleChild = child.firstVisibleNode(under: symmetry) { return visibleChild }

     

       30
       30
       -
       				continue

     

       31
       30
        
       			}

     

       32
       31
        
       

     

       33
       32
        
       			return nil

+7 -7

Sources/PterodactylSyntax/Grammar/Document/Import.swift

···

       8
       8
        
       	static let kind = SyntaxTreeKind(name: "import.name")

     

       9
       9
        
       	static let kinds = [kind]

     

       10
       10
        
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       11
       11
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       12
       12
        
       		parser.isAt(kind: .identifier)

     

       13
       13
        
       	}

     

       14
       14
        
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       16
       16
       -
       		parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .namespace))

     

       15
       15
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       16
       16
       +
       		parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .namespace), recovery: recovery)

     

       17
       17
        
       		return ParseResult(kind: Self.kind)

     

       18
       18
        
       	}

     

       19
       19
        
       }

     
···

       22
       22
        
       	static let kind = SyntaxTreeKind(name: "import")

     

       23
       23
        
       	static let kinds = [kind]

     

       24
       24
        
       	

     

       25
       25
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       25
       25
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       26
       26
        
       		parser.isAt(kind: .keyword(.import))

     

       27
       27
        
       	}

     

       28
       28
        
       

     

       29
       29
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       30
       30
       -
       		parser.expect(kind: .keyword(.import), metadata: TokenMetadata(semanticTokenType: .keyword))

     

       29
       29
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       30
       30
       +
       		parser.expect(kind: .keyword(.import), metadata: TokenMetadata(semanticTokenType: .keyword), recovery: recovery)

     

       31
       31
        
       		parser.eatTrivia()

     

       32
       32
       -
       		ImportName.parse(&parser)

     

       32
       32
       +
       		ImportName.parse(&parser, recovery: recovery)

     

       33
       33
        
       		return ParseResult(kind: Self.kind)

     

       34
       34
        
       	}

     

       35
       35
        
       }

+13 -11

Sources/PterodactylSyntax/Grammar/Document/Theory/Declaration/Lhs.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       -
       enum Lhs: Grammar {

     

       8
       8
       -
       	static let kind = SyntaxTreeKind(name: "declaration.lhs")

     

       9
       9
       -
       	static let kinds = [kind]

     

       10
       10
       -
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       12
       12
       -
       		parser.isAt(kind: .identifier)

     

       13
       13
       -
       	}

     

       14
       14
       -
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       16
       16
       -
       		parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .method))

     

       17
       17
       -
       		return ParseResult(kind: Self.kind)

     

       7
       7
       +
       extension Declaration {

     

       8
       8
       +
       	enum Lhs: Grammar {

     

       9
       9
       +
       		static let kind = SyntaxTreeKind(name: "declaration.lhs")

     

       10
       10
       +
       		static let kinds = [kind]

     

       11
       11
       +
       		

     

       12
       12
       +
       		static func precondition(_ parser: inout Parser) -> Bool {

     

       13
       13
       +
       			parser.isAt(kind: .identifier)

     

       14
       14
       +
       		}

     

       15
       15
       +
       		

     

       16
       16
       +
       		static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       17
       17
       +
       			parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .method), recovery: recovery)

     

       18
       18
       +
       			return ParseResult(kind: Self.kind)

     

       19
       19
       +
       		}

     

       18
       20
        
       	}

     

       19
       21
        
       }

+13 -11

Sources/PterodactylSyntax/Grammar/Document/Theory/Declaration/Rhs.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       -
       enum Rhs: Grammar {

     

       8
       8
       -
       	static let kind = SyntaxTreeKind(name: "declaration.lhs")

     

       9
       9
       -
       	static let kinds = [kind]

     

       10
       10
       -
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       12
       12
       -
       		parser.isAt(kind: .identifier)

     

       13
       13
       -
       	}

     

       14
       14
       -
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       16
       16
       -
       		parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .method))

     

       17
       17
       -
       		return ParseResult(kind: Self.kind)

     

       7
       7
       +
       extension Declaration {

     

       8
       8
       +
       	enum Rhs: Grammar {

     

       9
       9
       +
       		static let kind = SyntaxTreeKind(name: "declaration.lhs")

     

       10
       10
       +
       		static let kinds = [kind]

     

       11
       11
       +
       		

     

       12
       12
       +
       		static func precondition(_ parser: inout Parser) -> Bool {

     

       13
       13
       +
       			parser.isAt(kind: .identifier)

     

       14
       14
       +
       		}

     

       15
       15
       +
       		

     

       16
       16
       +
       		static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       17
       17
       +
       			parser.expect(kind: .identifier, metadata: TokenMetadata(semanticTokenType: .method), recovery: recovery)

     

       18
       18
       +
       			return ParseResult(kind: Self.kind)

     

       19
       19
       +
       		}

     

       18
       20
        
       	}

     

       19
       21
        
       }

+8 -7

Sources/PterodactylSyntax/Grammar/Document/Theory/Declaration.swift

···

       13
       13
        
       

     

       14
       14
        
       	static let kinds = [Kinds.claim, Kinds.refine, Kinds.define]

     

       15
       15
        
       	

     

       16
       16
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       17
       17
       -
       		Lhs.before(&parser)

     

       16
       16
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       17
       17
       +
       		Lhs.precondition(&parser)

     

       18
       18
        
       	}

     

       19
       19
        
       

     

       20
       20
        
       	static let punctuationMap: [Punctuation: SyntaxTreeKind] = [

     
···

       23
       23
        
       		.doubleRightArrow: Kinds.define

     

       24
       24
        
       	]

     

       25
       25
        
       

     

       26
       26
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       27
       27
       -
       		Lhs.parse(&parser)

     

       26
       26
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       27
       27
       +
       		let punctuations = punctuationMap.keys.map { TokenKind.punctuation($0) }

     

       28
       28
       +
       		Lhs.parse(&parser, recovery: recovery.union(punctuations))

     

       28
       29
        
       		parser.eatTrivia()

     

       29
       30
        
       

     

       30
       31
        
       		var kind: SyntaxTreeKind = .error

     
···

       40
       41
        
       		}

     

       41
       42
        
       

     

       42
       43
        
       		parser.eatTrivia()

     

       43
       43
       -
       		Rhs.parse(&parser)

     

       44
       44
       +
       		Rhs.parse(&parser, recovery: recovery)

     

       44
       45
        
       

     

       45
       46
        
       		return ParseResult(kind: kind)

     

       46
       47
        
       	}

     

       47
       48
        
       }

     

       48
       49
        
       

     

       49
       50
        
       extension SyntaxView<Declaration> {

     

       50
       50
       -
       	var lhs: SyntaxView<Lhs>? { matchingSubview() }

     

       51
       51
       -
       	var rhs: SyntaxView<Rhs>? { matchingSubview() }

     

       51
       51
       +
       	var lhs: SyntaxView<Declaration.Lhs>? { matchingSubview() }

     

       52
       52
       +
       	var rhs: SyntaxView<Declaration.Rhs>? { matchingSubview() }

     

       52
       53
        
       }

+5 -13

Sources/PterodactylSyntax/Grammar/Document/Theory/TheoryBlock.swift

···

       8
       8
        
       	static let kind = SyntaxTreeKind(name: "theory.block")

     

       9
       9
        
       	static let kinds = [kind]

     

       10
       10
        
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       11
       11
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       12
       12
        
       		parser.isAt(kind: .keyword(.where))

     

       13
       13
        
       	}

     

       14
       14
        
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       16
       16
       -
       		parser.expect(kind: .keyword(.where), metadata: TokenMetadata(semanticTokenType: .keyword))

     

       15
       15
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       16
       16
       +
       		parser.expect(kind: .keyword(.where), metadata: TokenMetadata(semanticTokenType: .keyword), recovery: recovery.union([.keyword(.theory), .blockComment(terminated: true), .lineComment]))

     

       17
       17
        
       

     

       18
       18
       -
       		parser.eatTrivia()

     

       19
       18
        
       		if parser.eat(kind: .blockBegin, metadata: nil) {

     

       20
       19
        
       			parser.eatTrivia()

     

       21
       21
       -
       

     

       22
       22
       -
       			while Declaration.tryParse(&parser) {

     

       20
       20
       +
       			while parser.eat(kind: .blockSep, metadata: nil) {

     

       21
       21
       +
       				Declaration.parse(&parser, recovery: recovery.union([.blockSep, .blockEnd]))

     

       23
       22
        
       				parser.eatTrivia()

     

       24
       24
       -
       				if parser.eat(kind: .blockSep, metadata: nil) {

     

       25
       25
       -
       					parser.eatTrivia()

     

       26
       26
       -
       					continue

     

       27
       27
       -
       				} else {

     

       28
       28
       -
       					break

     

       29
       29
       -
       				}

     

       30
       23
        
       			}

     

       31
       31
       -
       

     

       32
       24
        
       			_ = parser.eat(kind: .blockEnd, metadata: nil)

     

       33
       25
        
       		}

     

       34
       26

+2 -2

Sources/PterodactylSyntax/Grammar/Document/Theory/TheoryName.swift

···

       8
       8
        
       	static let kind = SyntaxTreeKind(name: "theory.name")

     

       9
       9
        
       	static let kinds = [kind]

     

       10
       10
        
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       11
       11
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       12
       12
        
       		parser.isAt(kind: .identifier)

     

       13
       13
        
       	}

     

       14
       14
        
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       15
       15
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       16
       16
        
       		parser.advance(metadata: TokenMetadata(semanticTokenType: .interface))

     

       17
       17
        
       		return ParseResult(kind: Self.kind)

     

       18
       18
        
       	}

+6 -6

Sources/PterodactylSyntax/Grammar/Document/Theory.swift

···

       7
       7
        
       enum Theory: Grammar {

     

       8
       8
        
       	static let kind = SyntaxTreeKind(name: "theory")

     

       9
       9
        
       	static let kinds = [kind]

     

       10
       10
       -
       	

     

       11
       11
       -
       	static func before(_ parser: inout Parser) -> Bool {

     

       10
       10
       +
       

     

       11
       11
       +
       	static func precondition(_ parser: inout Parser) -> Bool {

     

       12
       12
        
       		parser.isAt(kind: .keyword(.theory))

     

       13
       13
        
       	}

     

       14
       14
        
       

     

       15
       15
       -
       	static func inside(_ parser: inout Parser) -> ParseResult {

     

       16
       16
       -
       		parser.expect(kind: .keyword(.theory), metadata: TokenMetadata(semanticTokenType: .keyword))

     

       15
       15
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       16
       16
       +
       		parser.expect(kind: .keyword(.theory), metadata: TokenMetadata(semanticTokenType: .keyword), recovery: recovery)

     

       17
       17
        
       		parser.eatTrivia()

     

       18
       18
       -
       		if !TheoryName.tryParse(&parser) {

     

       18
       18
       +
       		if !TheoryName.tryParse(&parser, recovery: recovery) {

     

       19
       19
        
       			parser.advance(error: "Expected theory name")

     

       20
       20
        
       		}

     

       21
       21
        
       

     

       22
       22
        
       		parser.eatTrivia()

     

       23
       23
        
       

     

       24
       24
       -
       		TheoryBlock.parse(&parser)

     

       24
       24
       +
       		TheoryBlock.parse(&parser, recovery: recovery)

     

       25
       25
        
       

     

       26
       26
        
       		return ParseResult(kind: Self.kind)

     

       27
       27
        
       	}

+5 -5

Sources/PterodactylSyntax/Grammar/Document.swift

···

       8
       8
        
       	public static let kind = SyntaxTreeKind(name: "document")

     

       9
       9
        
       	public static let kinds = [kind]

     

       10
       10
        
       

     

       11
       11
       -
       	public static func before(_ parser: inout Parser) -> Bool {

     

       11
       11
       +
       	public static func precondition(_ parser: inout Parser) -> Bool {

     

       12
       12
        
       		true

     

       13
       13
        
       	}

     

       14
       14
        
       

     

       15
       15
       -
       	public static func inside(_ parser: inout Parser) -> ParseResult {

     

       15
       15
       +
       	public static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult {

     

       16
       16
        
       		parser.eatTrivia()

     

       17
       17
        
       

     

       18
       18
        
       		// Parse imports

     

       19
       19
        
       		while !parser.isAt(kind: .eof) {

     

       20
       20
        
       			parser.eatTrivia()

     

       21
       21
       -
       			if Theory.before(&parser) { break }

     

       21
       21
       +
       			if Theory.precondition(&parser) { break }

     

       22
       22
        
       

     

       23
       23
       -
       			if !Import.tryParse(&parser) {

     

       23
       23
       +
       			if !Import.tryParse(&parser, recovery: recovery) {

     

       24
       24
        
       				parser.advance(error: "Expected to see either an import or a theory declaration, but instead got \(parser.currentToken.kind): \(parser.currentToken.text)")

     

       25
       25
        
       			}

     

       26
       26
        
       		}

     

       27
       27
        
       

     

       28
       28
        
       		// Theories section

     

       29
       29
        
       		while !parser.isAt(kind: .eof) {

     

       30
       30
       -
       			if !Theory.tryParse(&parser) {

     

       30
       30
       +
       			if !Theory.tryParse(&parser, recovery: recovery) {

     

       31
       31
        
       				if parser.isAt(kindSatisfying: \.isVisible) {

     

       32
       32
        
       					let token = parser.currentToken

     

       33
       33
        
       					parser.advance(error: "Unexpected token: \(token.kind)")

+23 -17

Sources/PterodactylSyntax/Grammar.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       +
       /// This is an abstraction of grammatical productions.

     

       7
       8
        
       public protocol Grammar: Sendable {

     

       9
       9
       +
       	/// The kinds of tree that the production produces.

     

       8
       10
        
       	static var kinds: [SyntaxTreeKind] { get }

     

       9
       9
       -
       	static func before(_ parser: inout Parser) -> Bool

     

       10
       10
       -
       	static func inside(_ parser: inout Parser) -> ParseResult

     

       11
       11
       +
       

     

       12
       12
       +
       	/// Indicates whether the current parser state is consistent with the grammatical production starting here. When a given grammatical element is optional, this can be used to avoid backtracking. This is a *precondition* for parsing.

     

       13
       13
       +
       	static func precondition(_ parser: inout Parser) -> Bool

     

       14
       14
       +
       

     

       15
       15
       +
       	/// Parse the grammatical production, assuming the precondition indicated by ``precondition(_:)``. This function should not be called outside this module (instead, use ``parse(_:recovery:)`` and ``tryParse(_:recovery:)``.

     

       16
       16
       +
       	static func inside(_ parser: inout Parser, recovery: Set<TokenKind>) -> ParseResult

     

       17
       17
       +
       }

     

       18
       18
       +
       

     

       19
       19
       +
       extension Grammar {

     

       20
       20
       +
       	public static func tryParse(_ parser: inout Parser, recovery: Set<TokenKind>) -> Bool {

     

       21
       21
       +
       		guard !parser.isEndOfFile && precondition(&parser) else { return false }

     

       22
       22
       +
       		parse(&parser, recovery: recovery)

     

       23
       23
       +
       		return true

     

       24
       24
       +
       	}

     

       25
       25
       +
       

     

       26
       26
       +
       	public static func parse(_ parser: inout Parser, recovery: Set<TokenKind>) {

     

       27
       27
       +
       		let mark = parser.builder.open()

     

       28
       28
       +
       		let result = inside(&parser, recovery: recovery)

     

       29
       29
       +
       		parser.builder.close(mark: mark, kind: result.kind, metadata: result.metadata)

     

       30
       30
       +
       	}

     

       11
       31
        
       }

     

       12
       32
        
       

     

       13
       33
        
       public struct ParseResult {

     

       14
       34
        
       	public var kind: SyntaxTreeKind

     

       15
       35
        
       	public var metadata: SyntaxTreeMetadata? = nil

     

       16
       16
       -
       	

     

       36
       36
       +
       

     

       17
       37
        
       	public init(kind: SyntaxTreeKind, metadata: SyntaxTreeMetadata? = nil) {

     

       18
       38
        
       		self.kind = kind

     

       19
       39
        
       		self.metadata = metadata

     

       20
       40
        
       	}

     

       21
       41
        
       }

     

       22
       42
        
       

     

       23
       23
       -
       

     

       24
       24
       -
       public extension Grammar {

     

       25
       25
       -
       	static func tryParse(_ parser: inout Parser) -> Bool {

     

       26
       26
       -
       		guard !parser.isEndOfFile && before(&parser) else { return false }

     

       27
       27
       -
       		parse(&parser)

     

       28
       28
       -
       		return true

     

       29
       29
       -
       	}

     

       30
       30
       -
       	

     

       31
       31
       -
       	static func parse(_ parser: inout Parser) {

     

       32
       32
       -
       		let mark = parser.open()

     

       33
       33
       -
       		let result = inside(&parser)

     

       34
       34
       -
       		parser.close(mark: mark, kind: result.kind, metadata: result.metadata)

     

       35
       35
       -
       	}

     

       36
       36
       -
       }

+42

Sources/PterodactylSyntax/ImportParser.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       

     

       7
       7
       +
       public struct ImportParser {

     

       8
       8
       +
       	private var lexer: PterodactylSyntax.Lexer

     

       9
       9
       +
       	public private(set) var imports: [String] = []

     

       10
       10
       +
       

     

       11
       11
       +
       	public init(input: String) {

     

       12
       12
       +
       		self.lexer = PterodactylSyntax.Lexer(input: input)

     

       13
       13
       +
       	}

     

       14
       14
       +
       

     

       15
       15
       +
       	public mutating func parseHeader() {

     

       16
       16
       +
       		while true {

     

       17
       17
       +
       			guard let token = nextSignificantToken() else { return }

     

       18
       18
       +
       			switch token.kind {

     

       19
       19
       +
       			case .keyword(.import): parseImportStatement()

     

       20
       20
       +
       			default: return

     

       21
       21
       +
       			}

     

       22
       22
       +
       		}

     

       23
       23
       +
       	}

     

       24
       24
       +
       

     

       25
       25
       +
       	/// Returns the next non-whitespace token.

     

       26
       26
       +
       	private mutating func nextSignificantToken() -> Token? {

     

       27
       27
       +
       		var token = lexer.nextToken()

     

       28
       28
       +
       		while token?.kind.isTrivia == true {

     

       29
       29
       +
       			token = lexer.nextToken()

     

       30
       30
       +
       		}

     

       31
       31
       +
       

     

       32
       32
       +
       		guard let token else { return nil }

     

       33
       33
       +
       		return Token(kind: token.kind, text: token.text)

     

       34
       34
       +
       	}

     

       35
       35
       +
       

     

       36
       36
       +
       	/// Parses a single `import xyz` line.

     

       37
       37
       +
       	private mutating func parseImportStatement() {

     

       38
       38
       +
       		guard let next = nextSignificantToken() else { return }

     

       39
       39
       +
       		guard next.kind == .identifier else { return }

     

       40
       40
       +
       		imports.append(next.text)

     

       41
       41
       +
       	}

     

       42
       42
       +
       }

Sources/PterodactylSyntax/Lexer.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       +
       /// This tokenises a string, without handling block layout at all. The tokens produced here should be fed into the ``BlockLayoutProcessor``.

     

       7
       8
        
       public struct Lexer {

     

       8
       9
        
       	private let input: String

     

       9
       10
        
       	private var index: String.Index

+1 -1

Sources/PterodactylSyntax/LineMap.swift

···

       9
       9
        
       	private let utf16LineOffsets: [Int]

     

       10
       10
        
       

     

       11
       11
        
       	public init(source: String) {

     

       12
       12
       -
       		var offsets: [Int] = []

     

       12
       12
       +
       		var offsets: [Int] = [0]

     

       13
       13
        
       		for idx in source.indices {

     

       14
       14
        
       			let c = source[idx]

     

       15
       15
        
       			if c == "\n" || c == "\r\n" || c == "\r" {

+61 -83

Sources/PterodactylSyntax/Parser.swift

···

       3
       3
        
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
        
       

     

       5
       5
        
       public struct Parser {

     

       6
       6
       -
       	enum Event: Equatable {

     

       7
       7
       -
       		case open(kind: SyntaxTreeKind, metadata: SyntaxTreeMetadata?)

     

       8
       8
       -
       		case close

     

       9
       9
       -
       		case advance(metadata: TokenMetadata?)

     

       10
       10
       -
       	}

     

       11
       11
       -
       

     

       12
       6
        
       	public struct MarkOpened {

     

       13
       7
        
       		internal let index: Int

     

       14
       8
        
       	}

     
···

       22
       16
        
       	}

     

       23
       17
        
       

     

       24
       18
        
       	public private(set) var diagnostics: [Diagnostic] = []

     

       19
       19
       +
       	public var builder: SyntaxTreeBuilder = SyntaxTreeBuilder()

     

       25
       20
        
       

     

       26
       26
       -
       	private var fuel: Int = 0

     

       21
       21
       +
       	private var inError: Bool = false

     

       27
       22
        
       	private var position: Int = 0

     

       28
       28
       -
       	private var events: [Event] = []

     

       29
       23
        
       	private var absoluteUtf16Offset: Int = 0

     

       30
       24
        
       	public var absoluteRangeAtCursor: Range<Int> {

     

       31
       25
        
       		return absoluteUtf16Offset..<absoluteUtf16Offset

     
···

       59
       53
        
       	}

     

       60
       54
        
       

     

       61
       55
        
       

     

       62
       62
       -
       	public mutating func open() -> MarkOpened {

     

       63
       63
       -
       		let mark = MarkOpened(index: events.count)

     

       64
       64
       -
       		events.append(.open(kind: .error, metadata: nil))

     

       65
       65
       -
       		return mark

     

       66
       66
       -
       	}

     

       67
       67
       -
       

     

       68
       68
       -
       	public mutating func close(mark: MarkOpened, kind: SyntaxTreeKind, metadata: SyntaxTreeMetadata?) {

     

       69
       69
       -
       		events[mark.index] = .open(kind: kind, metadata: metadata)

     

       70
       70
       -
       		events.append(.close)

     

       71
       71
       -
       	}

     

       72
       72
       -
       

     

       73
       56
        
       	public mutating func advance(metadata: TokenMetadata?) {

     

       74
       57
        
       		precondition(!isEndOfFile)

     

       75
       75
       -
       		events.append(.advance(metadata: metadata))

     

       58
       58
       +
       		builder.advance(token: currentToken, metadata: metadata)

     

       76
       59
        
       		absoluteUtf16Offset += currentToken.utf16Length

     

       77
       60
        
       		position += 1

     

       78
       78
       -
       		fuel = 256

     

       79
       61
        
       	}

     

       80
       62
        
       

     

       81
       81
       -
       	public mutating func advance(error: String?, metadata: TokenMetadata? = nil) {

     

       82
       82
       -
       		let mark = open()

     

       83
       83
       -
       		if let error {

     

       84
       84
       -
       			let diagnostic = Diagnostic(

     

       85
       85
       -
       				message: error,

     

       86
       86
       -
       				absoluteRange: absoluteRangeOfCurrentToken

     

       87
       87
       -
       			)

     

       63
       63
       +
       	public mutating func advance(error: String, metadata: TokenMetadata? = nil) {

     

       64
       64
       +
       		let mark = builder.open()

     

       65
       65
       +
       		let diagnostic = Diagnostic(

     

       66
       66
       +
       			message: error,

     

       67
       67
       +
       			absoluteRange: absoluteRangeOfCurrentToken

     

       68
       68
       +
       		)

     

       88
       69
        
       

     

       89
       89
       -
       			diagnostics.append(diagnostic)

     

       90
       90
       -
       		}

     

       70
       70
       +
       		diagnostics.append(diagnostic)

     

       91
       71
        
       		advance(metadata: metadata)

     

       92
       92
       -
       		close(mark: mark, kind: .error, metadata: nil)

     

       93
       93
       -
       	}

     

       94
       94
       -
       

     

       95
       95
       -
       	public mutating func lookahead(_ k: Int) -> TokenKind? {

     

       96
       96
       -
       		precondition(fuel > 0, "Parser is stuck!")

     

       97
       97
       -
       		fuel -= 1

     

       98
       98
       -
       		let index = position + k

     

       99
       99
       -
       		guard tokens.indices.contains(index) else { return nil }

     

       100
       100
       -
       		return tokens[index].kind

     

       72
       72
       +
       		builder.close(mark: mark, kind: .error, metadata: nil)

     

       101
       73
        
       	}

     

       102
       74
        
       

     

       103
       103
       -
       	public mutating func eat(kindSatisfying predicate: (TokenKind) -> Bool, metadata: TokenMetadata?) -> Bool {

     

       104
       104
       -
       		guard !isEndOfFile && isAt(kindSatisfying: predicate) else { return false }

     

       75
       75
       +
       	public mutating func eat(kind: TokenKind, metadata: TokenMetadata?) -> Bool {

     

       76
       76
       +
       		guard !isEndOfFile && isAt(kindSatisfying: { $0 == kind }) else { return false }

     

       105
       77
        
       		advance(metadata: metadata)

     

       106
       78
        
       		return true

     

       107
       79
        
       	}

     

       108
       80
        
       

     

       109
       109
       -
       	public mutating func eat(kind: TokenKind, metadata: TokenMetadata?) -> Bool {

     

       110
       110
       -
       		eat(kindSatisfying: { $0 == kind }, metadata: metadata)

     

       81
       81
       +
       	enum ControlFlow {

     

       82
       82
       +
       		case `continue`

     

       83
       83
       +
       		case `break`

     

       111
       84
        
       	}

     

       112
       85
        
       

     

       113
       113
       -
       	public mutating func expect(kind: TokenKind, metadata: TokenMetadata?, error: String? = nil) {

     

       114
       114
       -
       		if eat(kind: kind, metadata: metadata) { return }

     

       115
       115
       -
       		let diagnostic = Diagnostic(

     

       116
       116
       -
       			message: error ?? "Expected \(kind) but got \(currentToken.kind): `\(currentToken.text)`",

     

       117
       117
       -
       			absoluteRange: absoluteRangeAtCursor

     

       118
       118
       -
       		)

     

       119
       119
       -
       		diagnostics.append(diagnostic)

     

       86
       86
       +
       	mutating func ate(kind: TokenKind, metadata: TokenMetadata?) -> ControlFlow {

     

       87
       87
       +
       		guard eat(kind: kind, metadata: metadata) else { return .continue }

     

       88
       88
       +
       		inError = false

     

       89
       89
       +
       		eatTrivia()

     

       90
       90
       +
       		return .break

     

       120
       91
        
       	}

     

       121
       92
        
       

     

       122
       122
       -
       	public var tree: SyntaxTree {

     

       123
       123
       -
       		var events = events

     

       124
       124
       -
       		var stack: [SyntaxTree.Builder] = []

     

       125
       125
       -
       		var cursor: Int = 0

     

       93
       93
       +
       	mutating func recoverUntil(_ anchors: Set<TokenKind>, expected: TokenKind, error: String? = nil) {

     

       94
       94
       +
       		var discardTokens: [Token] = []

     

       95
       95
       +
       		let startOffset = absoluteUtf16Offset

     

       126
       96
        
       

     

       127
       127
       -
       		precondition(events.popLast() == .close)

     

       97
       97
       +
       		while !self.isAt(kindSatisfying: { anchors.contains($0) }) {

     

       98
       98
       +
       			if isEndOfFile { break }

     

       99
       99
       +
       			let token = currentToken

     

       100
       100
       +
       			advance(metadata: nil)

     

       101
       101
       +
       			discardTokens.append(token)

     

       102
       102
       +
       		}

     

       128
       103
        
       

     

       129
       129
       -
       		for event in events {

     

       130
       130
       -
       			switch event {

     

       131
       131
       -
       			case .open(let kind, let metadata):

     

       132
       132
       -
       				stack.append(SyntaxTree.Builder(kind: kind, metadata: metadata, children: []))

     

       133
       133
       -
       			case .close:

     

       134
       134
       -
       				let tree = stack.popLast()!

     

       135
       135
       -
       				stack.modifyLast { last in

     

       136
       136
       -
       					last.children.append(.tree(tree.tree))

     

       137
       137
       -
       				}

     

       138
       138
       -
       			case .advance(let metadata):

     

       139
       139
       -
       				let token = tokens[cursor]

     

       140
       140
       -
       				cursor += 1

     

       141
       141
       -
       				stack.modifyLast { last in

     

       142
       142
       -
       					last.children.append(.token(token, metadata: metadata))

     

       143
       143
       -
       				}

     

       104
       104
       +
       		var endOffset = startOffset

     

       105
       105
       +
       		

     

       106
       106
       +
       		let error = error ?? "Expected \(expected) but got \(discardTokens)"

     

       107
       107
       +
       

     

       108
       108
       +
       		if discardTokens.isEmpty {

     

       109
       109
       +
       			if !inError {

     

       110
       110
       +
       				inError = true

     

       111
       111
       +
       				diagnostics.append(Diagnostic(message: error, absoluteRange: absoluteRangeAtCursor))

     

       112
       112
       +
       			}

     

       113
       113
       +
       			return

     

       114
       114
       +
       		} else {

     

       115
       115
       +
       			let mark = builder.open()

     

       116
       116
       +
       			for discardToken in discardTokens {

     

       117
       117
       +
       				endOffset += discardToken.utf16Length

     

       118
       118
       +
       			}

     

       119
       119
       +
       

     

       120
       120
       +
       			builder.close(mark: mark, kind: .error, metadata: nil)

     

       121
       121
       +
       

     

       122
       122
       +
       			if !inError {

     

       123
       123
       +
       				inError = true

     

       124
       124
       +
       				diagnostics.append(Diagnostic(message: error, absoluteRange: startOffset..<endOffset))

     

       144
       125
        
       			}

     

       145
       126
        
       		}

     

       127
       127
       +
       	}

     

       146
       128
        
       

     

       147
       147
       -
       		assert(stack.count == 1)

     

       148
       148
       -
       		return stack.popLast()!.tree

     

       129
       129
       +
       	public mutating func expect(kind: TokenKind, metadata: TokenMetadata?, recovery: Set<TokenKind>, error: String? = nil) {

     

       130
       130
       +
       		var anchors = recovery

     

       131
       131
       +
       		if ate(kind: kind, metadata: metadata) == .break { return }

     

       132
       132
       +
       		anchors.insert(kind)

     

       133
       133
       +
       		recoverUntil(anchors, expected: kind, error: error)

     

       134
       134
       +
       		let _ = ate(kind: kind, metadata: metadata)

     

       149
       135
        
       	}

     

       136
       136
       +
       }

     

       150
       137
        
       

     

       138
       138
       +
       extension Parser {

     

       151
       139
        
       	mutating func eatTrivium() -> Bool {

     

       152
       140
        
       		switch currentToken.kind {

     

       153
       153
       -
       		case .whitespace:

     

       141
       141
       +
       		case .whitespace, .newline:

     

       154
       142
        
       			advance(metadata: nil)

     

       155
       143
        
       			return true

     

       156
       144
        
       		case .blockComment(let terminated):

     
···

       174
       162
        
       

     

       175
       163
        
       	mutating func eatTrivia() {

     

       176
       164
        
       		while !isEndOfFile && eatTrivium() {}

     

       177
       177
       -
       	}

     

       178
       178
       -
       

     

       179
       179
       -
       }

     

       180
       180
       -
       

     

       181
       181
       -
       extension Array {

     

       182
       182
       -
       	fileprivate mutating func modifyLast(_ modifier: (inout Element) -> Void) {

     

       183
       183
       -
       		if var last = popLast() {

     

       184
       184
       -
       			modifier(&last)

     

       185
       185
       -
       			append(last)

     

       186
       186
       -
       		}

     

       187
       165
        
       	}

     

       188
       166
        
       }

+23 -1

Sources/PterodactylSyntax/SemanticToken.swift

···

       52
       52
        
       	}

     

       53
       53
        
       }

     

       54
       54
        
       

     

       55
       55
       -
       extension SyntaxTree.Cursor {

     

       55
       55
       +
       extension SyntaxCursor {

     

       56
       56
        
       	var singleLineRanges: [SingleLineRange] {

     

       57
       57
        
       		var result: [SingleLineRange] = []

     

       58
       58
        
       		var location = lineMap.location(at: utf16Offset)

     
···

       67
       67
        
       		return result

     

       68
       68
        
       	}

     

       69
       69
        
       }

     

       70
       70
       +
       

     

       71
       71
       +
       extension SyntaxCursor {

     

       72
       72
       +
       	public func collectSemanticTokens(_ sink: inout [SemanticToken]) {

     

       73
       73
       +
       		if let (_, metadata) = node.token, let metadata {

     

       74
       74
       +
       			for lineRange in singleLineRanges {

     

       75
       75
       +
       				if let semanticToken = metadata.semanticToken(range: lineRange) {

     

       76
       76
       +
       					sink.append(semanticToken)

     

       77
       77
       +
       				}

     

       78
       78
       +
       			}

     

       79
       79
       +
       		}

     

       80
       80
       +
       		

     

       81
       81
       +
       		for child in children {

     

       82
       82
       +
       			child.collectSemanticTokens(&sink)

     

       83
       83
       +
       		}

     

       84
       84
       +
       	}

     

       85
       85
       +
       	

     

       86
       86
       +
       	public var semanticTokens: [SemanticToken] {

     

       87
       87
       +
       		var tokens: [SemanticToken] = []

     

       88
       88
       +
       		collectSemanticTokens(&tokens)

     

       89
       89
       +
       		return tokens

     

       90
       90
       +
       	}

     

       91
       91
       +
       }

+51

Sources/PterodactylSyntax/SyntaxCursor.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       import LanguageServerProtocol

     

       7
       7
       +
       

     

       8
       8
       +
       /// This is a “red tree” in the sense of Roslyn. In essence it instruments syntax trees with non-relative location information.

     

       9
       9
       +
       public final class SyntaxCursor {

     

       10
       10
       +
       	public let lineMap: LineMap

     

       11
       11
       +
       	public let node: SyntaxTree.Child

     

       12
       12
       +
       	public let utf16Offset: Int

     

       13
       13
       +
       

     

       14
       14
       +
       	public private(set) lazy var children: [SyntaxCursor] = {

     

       15
       15
       +
       		var children: [SyntaxCursor] = []

     

       16
       16
       +
       		var utf16Offset = utf16Offset

     

       17
       17
       +
       		for childNode in node.children {

     

       18
       18
       +
       			children.append(Self(lineMap: lineMap, node: childNode, utf16Offset: utf16Offset))

     

       19
       19
       +
       			utf16Offset += childNode.utf16Length

     

       20
       20
       +
       		}

     

       21
       21
       +
       

     

       22
       22
       +
       		return children

     

       23
       23
       +
       	}()

     

       24
       24
       +
       

     

       25
       25
       +
       	public var utf16Range: Range<Int> {

     

       26
       26
       +
       		utf16Offset..<utf16Offset + node.utf16Length

     

       27
       27
       +
       	}

     

       28
       28
       +
       

     

       29
       29
       +
       	public init(lineMap: LineMap, node: SyntaxTree.Child, utf16Offset: Int) {

     

       30
       30
       +
       		self.lineMap = lineMap

     

       31
       31
       +
       		self.node = node

     

       32
       32
       +
       		self.utf16Offset = utf16Offset

     

       33
       33
       +
       	}

     

       34
       34
       +
       }

     

       35
       35
       +
       

     

       36
       36
       +
       extension SyntaxCursor {

     

       37
       37
       +
       	public func firstChild<T>(mapping: (SyntaxCursor) -> T?) -> T? {

     

       38
       38
       +
       		for child in children {

     

       39
       39
       +
       			if let result = mapping(child) {

     

       40
       40
       +
       				return result

     

       41
       41
       +
       			} else {

     

       42
       42
       +
       				continue

     

       43
       43
       +
       			}

     

       44
       44
       +
       		}

     

       45
       45
       +
       		return nil

     

       46
       46
       +
       	}

     

       47
       47
       +
       

     

       48
       48
       +
       	public func children<T>(mapping: (SyntaxCursor) -> T?) -> [T] {

     

       49
       49
       +
       		children.compactMap(mapping)

     

       50
       50
       +
       	}

     

       51
       51
       +
       }

+2 -1

Sources/PterodactylSyntax/SyntaxTree.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       +
       /// This is a “green tree” in the sense of Roslyn.

     

       7
       8
        
       public struct SyntaxTree: Codable, Sendable {

     

       8
       9
        
       	public let kind: SyntaxTreeKind

     

       9
       10
        
       	public let metadata: SyntaxTreeMetadata?

     
···

       27
       28
        
       

     

       28
       29
        
       extension SyntaxTree {

     

       29
       30
        
       	/// A mutable version of ``SyntaxTree`` that does not keep track of textual length, for use when constructing trees.

     

       30
       30
       -
       	public struct Builder {

     

       31
       31
       +
       	public struct MutableTree {

     

       31
       32
        
       		public var kind: SyntaxTreeKind

     

       32
       33
        
       		public var metadata: SyntaxTreeMetadata?

     

       33
       34
        
       		public var children: [Child]

+70

Sources/PterodactylSyntax/SyntaxTreeBuilder.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       import Foundation

     

       6
       6
       +
       

     

       7
       7
       +
       public struct SyntaxTreeBuilder {

     

       8
       8
       +
       	private enum Event: Equatable {

     

       9
       9
       +
       		case open(kind: SyntaxTreeKind, metadata: SyntaxTreeMetadata?)

     

       10
       10
       +
       		case close

     

       11
       11
       +
       		case advance(token: Token, metadata: TokenMetadata?)

     

       12
       12
       +
       	}

     

       13
       13
       +
       	

     

       14
       14
       +
       	public struct MarkOpened {

     

       15
       15
       +
       		internal let index: Int

     

       16
       16
       +
       	}

     

       17
       17
       +
       	

     

       18
       18
       +
       	private var events: [Event] = []

     

       19
       19
       +
       	

     

       20
       20
       +
       	public mutating func advance(token: Token, metadata: TokenMetadata?) {

     

       21
       21
       +
       		events.append(.advance(token: token, metadata: metadata))

     

       22
       22
       +
       	}

     

       23
       23
       +
       	

     

       24
       24
       +
       	public mutating func open() -> MarkOpened {

     

       25
       25
       +
       		let mark = MarkOpened(index: events.count)

     

       26
       26
       +
       		events.append(.open(kind: .error, metadata: nil))

     

       27
       27
       +
       		return mark

     

       28
       28
       +
       	}

     

       29
       29
       +
       

     

       30
       30
       +
       	public mutating func close(mark: MarkOpened, kind: SyntaxTreeKind, metadata: SyntaxTreeMetadata?) {

     

       31
       31
       +
       		events[mark.index] = .open(kind: kind, metadata: metadata)

     

       32
       32
       +
       		events.append(.close)

     

       33
       33
       +
       	}

     

       34
       34
       +
       	

     

       35
       35
       +
       	public var tree: SyntaxTree {

     

       36
       36
       +
       		var events = events

     

       37
       37
       +
       		var stack: [SyntaxTree.MutableTree] = []

     

       38
       38
       +
       

     

       39
       39
       +
       		precondition(events.popLast() == .close)

     

       40
       40
       +
       

     

       41
       41
       +
       		for event in events {

     

       42
       42
       +
       			switch event {

     

       43
       43
       +
       			case .open(let kind, let metadata):

     

       44
       44
       +
       				stack.append(SyntaxTree.MutableTree(kind: kind, metadata: metadata, children: []))

     

       45
       45
       +
       			case .close:

     

       46
       46
       +
       				let tree = stack.popLast()!

     

       47
       47
       +
       				stack.modifyLast { last in

     

       48
       48
       +
       					last.children.append(.tree(tree.tree))

     

       49
       49
       +
       				}

     

       50
       50
       +
       			case .advance(let token, let metadata):

     

       51
       51
       +
       				stack.modifyLast { last in

     

       52
       52
       +
       					last.children.append(.token(token, metadata: metadata))

     

       53
       53
       +
       				}

     

       54
       54
       +
       			}

     

       55
       55
       +
       		}

     

       56
       56
       +
       

     

       57
       57
       +
       		assert(stack.count == 1)

     

       58
       58
       +
       		return stack.popLast()!.tree

     

       59
       59
       +
       	}

     

       60
       60
       +
       }

     

       61
       61
       +
       

     

       62
       62
       +
       

     

       63
       63
       +
       extension Array {

     

       64
       64
       +
       	fileprivate mutating func modifyLast(_ modifier: (inout Element) -> Void) {

     

       65
       65
       +
       		if var last = popLast() {

     

       66
       66
       +
       			modifier(&last)

     

       67
       67
       +
       			append(last)

     

       68
       68
       +
       		}

     

       69
       69
       +
       	}

     

       70
       70
       +
       }

+3 -2

Sources/PterodactylSyntax/SyntaxView.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       +
       /// An abstract syntax view around a ``SyntaxCursor``. This is to be populated by extensions targetting specific `G`.

     

       7
       8
        
       struct SyntaxView<G: Grammar> {

     

       8
       8
       -
       	let cursor: SyntaxTree.Cursor

     

       9
       9
       -
       	init?(_ cursor: SyntaxTree.Cursor) {

     

       9
       9
       +
       	let cursor: SyntaxCursor

     

       10
       10
       +
       	init?(_ cursor: SyntaxCursor) {

     

       10
       11
        
       		guard let kind = cursor.node.tree?.kind, G.kinds.contains(kind) else { return nil }

     

       11
       12
        
       		self.cursor = cursor

     

       12
       13
        
       	}

+1 -1

Sources/PterodactylSyntax/Token.swift

···

       4
       4
        
       

     

       5
       5
        
       import Foundation

     

       6
       6
        
       

     

       7
       7
       -
       public struct Token: Codable {

     

       7
       7
       +
       public struct Token: Codable, Equatable {

     

       8
       8
        
       	public let kind: TokenKind

     

       9
       9
        
       	public let text: String

     

       10
       10
        
       	public let utf16Length: Int

+2 -1

Sources/PterodactylSyntax/Types.swift

···

       24
       24
        
       	case equal = "="

     

       25
       25
        
       }

     

       26
       26
        
       

     

       27
       27
       -
       public enum TokenKind: Codable, Equatable, Sendable {

     

       27
       27
       +
       public enum TokenKind: Codable, Equatable, Sendable, Hashable {

     

       28
       28
        
       	case eof

     

       29
       29
        
       	case keyword(Keyword)

     

       30
       30
        
       	case punctuation(Punctuation)

     
···

       53
       53
        
       		default: true

     

       54
       54
        
       		}

     

       55
       55
        
       	}

     

       56
       56
       +
       	

     

       56
       57
        
       	public var canDetermineLayoutColumn: Bool {

     

       57
       58
        
       		switch self {

     

       58
       59
        
       		case .whitespace, .eof: false

+37

Tests/PterodactylBuildTests/Test.swift

···

       5
       5
        
       import Testing

     

       6
       6
        
       

     

       7
       7
        
       @testable import PterodactylBuild

     

       8
       8
       +
       @testable import PterodactylSyntax

     

       8
       9
        
       @testable import llbuild2fx

     

       9
       10
        
       

     

       10
       11
        
       struct BuildTests {

     

       12
       12
       +
       	@Test

     

       13
       13
       +
       	func testBlockLayout() async throws {

     

       14
       14
       +
       		let code = """

     

       15
       15
       +
       			theory Foo where

     

       16
       16
       +
       				 foo : bar

     

       17
       17
       +
       				 baz : sdf

     

       18
       18
       +
       			"""

     

       19
       19
       +
       

     

       20
       20
       +
       		var lexer = PterodactylSyntax.Lexer(input: code)

     

       21
       21
       +
       		let flatTokens = lexer.tokenize()

     

       22
       22
       +
       		let blockTokens = BlockLayoutProcessor(tokens: flatTokens).layout()

     

       23
       23
       +
       

     

       24
       24
       +
       		#expect(

     

       25
       25
       +
       			blockTokens.map(\.kind) == [

     

       26
       26
       +
       				.keyword(.theory), .whitespace, .identifier, .whitespace, .keyword(.where), .blockBegin, .newline, .whitespace, .blockSep, .identifier, .whitespace,

     

       27
       27
       +
       				.punctuation(.colon),

     

       28
       28
       +
       				.whitespace, .identifier, .newline, .whitespace, .blockSep, .identifier, .whitespace, .punctuation(.colon), .whitespace, .identifier, .blockEnd, .eof

     

       29
       29
       +
       			])

     

       30
       30
       +
       	}

     

       31
       31
       +
       

     

       32
       32
       +
       	@Test

     

       33
       33
       +
       	func testParse() async throws {

     

       34
       34
       +
       		let code = """

     

       35
       35
       +
       			theory Foo where

     

       36
       36
       +
       				asdf : asdf

     

       37
       37
       +
       			"""

     

       38
       38
       +
       

     

       39
       39
       +
       		var lexer = PterodactylSyntax.Lexer(input: code)

     

       40
       40
       +
       		let flatTokens = lexer.tokenize()

     

       41
       41
       +
       		let blockTokens = BlockLayoutProcessor(tokens: flatTokens).layout()

     

       42
       42
       +
       		var parser = Parser(source: code, tokens: blockTokens)

     

       43
       43
       +
       		Document.parse(&parser, recovery: [])

     

       44
       44
       +
       

     

       45
       45
       +
       		#expect(parser.diagnostics.isEmpty)

     

       46
       46
       +
       	}

     

       47
       47
       +
       

     

       11
       48
        
       	@Test

     

       12
       49
        
       	func testImports() async throws {

     

       13
       50
        
       		let group = LLBMakeDefaultDispatchGroup()

+36

Tests/PterodactylLanguageServerTests/Test.swift

···

       1
       1
       +
       // SPDX-FileCopyrightText: 2025 The Project Pterodactyl Developers

     

       2
       2
       +
       //

     

       3
       3
       +
       // SPDX-License-Identifier: MPL-2.0

     

       4
       4
       +
       

     

       5
       5
       +
       //

     

       6
       6
       +
       //  File.swift

     

       7
       7
       +
       //  Pterodactyl

     

       8
       8
       +
       //

     

       9
       9
       +
       //  Created by Jon Sterling on 30/11/2025.

     

       10
       10
       +
       //

     

       11
       11
       +
       

     

       12
       12
       +
       import Foundation

     

       13
       13
       +
       import Testing

     

       14
       14
       +
       

     

       15
       15
       +
       @testable import PterodactylBuild

     

       16
       16
       +
       @testable import PterodactylLanguageServer

     

       17
       17
       +
       @testable import TSCBasic

     

       18
       18
       +
       @testable import llbuild2fx

     

       19
       19
       +
       

     

       20
       20
       +
       struct LanguageServerTests {

     

       21
       21
       +
       	@Test

     

       22
       22
       +
       	func testSingletonFileTree() throws {

     

       23
       23
       +
       		let path = try AbsolutePath(validating: "/foo/bar/file.txt")

     

       24
       24
       +
       		let foo = LLBDeclFileTree.file(absolutePath: path, contents: "foobar")

     

       25
       25
       +
       		let expected: LLBDeclFileTree =

     

       26
       26
       +
       			.dir([

     

       27
       27
       +
       				"foo": .dir([

     

       28
       28
       +
       					"bar": .dir([

     

       29
       29
       +
       						"file.txt": .file("foobar")

     

       30
       30
       +
       					])

     

       31
       31
       +
       				])

     

       32
       32
       +
       			])

     

       33
       33
       +
       

     

       34
       34
       +
       		#expect(foo.debugDescription == expected.debugDescription)

     

       35
       35
       +
       	}

     

       36
       36
       +
       }

test.ptero

···

       1
       1
       +
       theory asdf where

     

       2
       2
       +
           foo : asdfs

     

       3
       3
       +
           foo : sdf

     

       4
       4
       +
       

     

       5
       5
       +
       /* asdfasdf */

     

       6
       6
       +
       // asdf;lkj asdf;klj asdfkjh asdfjlkha sdfljk

Compare changes