handle *.md and *.tutorial files for Swift DocC

Author: matthewbastien

Sources/BuildSystemIntegration/BuildSystemManager.swift

@@ -632,7 +632,7 @@ package actor BuildSystemManager: QueueBasedMessageHandler {
     }
 
     switch language {
-    case .swift:
+    case .swift, .markdown, .tutorial:
       return await toolchainRegistry.preferredToolchain(containing: [\.sourcekitd, \.swift, \.swiftc])
     case .c, .cpp, .objective_c, .objective_cpp:
       return await toolchainRegistry.preferredToolchain(containing: [\.clang, \.clangd])

Sources/LanguageServerProtocol/SupportTypes/Language.swift

@@ -92,6 +92,7 @@ extension Language: CustomStringConvertible, CustomDebugStringConvertible {
     case .shellScript: return "Shell Script (Bash)"
     case .sql: return "SQL"
     case .swift: return "Swift"
+    case .tutorial: return "Tutorial"
     case .typeScript: return "TypeScript"
     case .typeScriptReact: return "TypeScript React"
     case .tex: return "TeX"
@@ -153,6 +154,7 @@ public extension Language {
   static let shellScript = Language(rawValue: "shellscript")  // Shell Script (Bash)
   static let sql = Language(rawValue: "sql")
   static let swift = Language(rawValue: "swift")
+  static let tutorial = Language(rawValue: "tutorial")
   static let typeScript = Language(rawValue: "typescript")
   static let typeScriptReact = Language(rawValue: "typescriptreact")  // TypeScript React
   static let tex = Language(rawValue: "tex")

Sources/SKTestSupport/Utils.swift

@@ -26,6 +26,8 @@ extension Language {
   var fileExtension: String {
     switch self {
     case .objective_c: return "m"
+    case .markdown: return "md"
+    case .tutorial: return "tutorial"
     default: return self.rawValue
     }
   }
@@ -37,6 +39,8 @@ extension Language {
     case "m": self = .objective_c
     case "mm": self = .objective_cpp
     case "swift": self = .swift
+    case "md": self = .markdown
+    case "tutorial": self = .tutorial
     default: return nil
     }
   }

Sources/SourceKitLSP/CMakeLists.txt

@@ -24,6 +24,9 @@ target_sources(SourceKitLSP PRIVATE
   Clang/ClangLanguageService.swift
   Clang/SemanticTokenTranslator.swift
 )
+target_sources(SourceKitLSP PRIVATE
+  Documentation/DocumentationLanguageService.swift
+)
 target_sources(SourceKitLSP PRIVATE
   Swift/AdjustPositionToStartOfIdentifier.swift
   Swift/CodeActions/AddDocumentation.swift

Sources/SourceKitLSP/Documentation/DocumentationLanguageService.swift

@@ -0,0 +1,296 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) 2024 Apple Inc. and the Swift project authors
+// Licensed under Apache License v2.0 with Runtime Library Exception
+//
+// See https://swift.org/LICENSE.txt for license information
+// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
+//
+//===----------------------------------------------------------------------===//
+
+import BuildSystemIntegration
+import Csourcekitd
+import Dispatch
+import Foundation
+import IndexStoreDB
+import SKLogging
+import SemanticIndex
+import SwiftExtensions
+import SwiftParser
+import SwiftParserDiagnostics
+
+#if compiler(>=6)
+package import LanguageServerProtocol
+package import SKOptions
+package import SwiftSyntax
+package import ToolchainRegistry
+#else
+import LanguageServerProtocol
+import SKOptions
+import SwiftSyntax
+import ToolchainRegistry
+#endif
+
+package actor DocumentationLanguageService: LanguageService, Sendable {
+  package init?(
+    sourceKitLSPServer: SourceKitLSPServer,
+    toolchain: Toolchain,
+    options: SourceKitLSPOptions,
+    testHooks: TestHooks,
+    workspace: Workspace
+  ) async throws {}
+
+  package nonisolated func canHandle(workspace: Workspace) -> Bool {
+    return true
+  }
+
+  package func initialize(
+    _ initialize: InitializeRequest
+  ) async throws -> InitializeResult {
+    return InitializeResult(
+      capabilities: ServerCapabilities()
+    )
+  }
+
+  package func clientInitialized(_ initialized: InitializedNotification) async {
+    // Nothing to set up
+  }
+
+  package func shutdown() async {
+    // Nothing to tear down
+  }
+
+  package func addStateChangeHandler(
+    handler: @escaping @Sendable (LanguageServerState, LanguageServerState) -> Void
+  ) async {
+    // There is no underlying language server with which to report state
+  }
+
+  package func openDocument(
+    _ notification: DidOpenTextDocumentNotification,
+    snapshot: DocumentSnapshot
+  ) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func closeDocument(_ notification: DidCloseTextDocumentNotification) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func reopenDocument(_ notification: ReopenTextDocumentNotification) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func changeDocument(
+    _ notification: DidChangeTextDocumentNotification,
+    preEditSnapshot: DocumentSnapshot,
+    postEditSnapshot: DocumentSnapshot,
+    edits: [SwiftSyntax.SourceEdit]
+  ) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func willSaveDocument(_ notification: WillSaveTextDocumentNotification) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func didSaveDocument(_ notification: DidSaveTextDocumentNotification) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func documentUpdatedBuildSettings(_ uri: DocumentURI) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func documentDependenciesUpdated(_ uris: Set<DocumentURI>) async {
+    // The DocumentationLanguageService does not do anything with document events
+  }
+
+  package func completion(_ req: CompletionRequest) async throws -> CompletionList {
+    .init(isIncomplete: false, items: [])
+  }
+
+  package func hover(_ req: HoverRequest) async throws -> HoverResponse? {
+    .none
+  }
+
+  package func symbolInfo(
+    _ request: SymbolInfoRequest
+  ) async throws -> [SymbolDetails] {
+    []
+  }
+
+  package func openGeneratedInterface(
+    document: DocumentURI,
+    moduleName: String,
+    groupName: String?,
+    symbolUSR symbol: String?
+  ) async throws -> GeneratedInterfaceDetails? {
+    nil
+  }
+
+  package func definition(
+    _ request: DefinitionRequest
+  ) async throws -> LocationsOrLocationLinksResponse? {
+    nil
+  }
+
+  package func declaration(
+    _ request: DeclarationRequest
+  ) async throws -> LocationsOrLocationLinksResponse? {
+    nil
+  }
+
+  package func documentSymbolHighlight(
+    _ req: DocumentHighlightRequest
+  ) async throws -> [DocumentHighlight]? {
+    nil
+  }
+
+  package func foldingRange(
+    _ req: FoldingRangeRequest
+  ) async throws -> [FoldingRange]? {
+    nil
+  }
+
+  package func documentSymbol(
+    _ req: DocumentSymbolRequest
+  ) async throws -> DocumentSymbolResponse? {
+    nil
+  }
+
+  package func documentColor(
+    _ req: DocumentColorRequest
+  ) async throws -> [ColorInformation] {
+    []
+  }
+
+  package func documentSemanticTokens(
+    _ req: DocumentSemanticTokensRequest
+  ) async throws -> DocumentSemanticTokensResponse? {
+    nil
+  }
+
+  package func documentSemanticTokensDelta(
+    _ req: DocumentSemanticTokensDeltaRequest
+  ) async throws -> DocumentSemanticTokensDeltaResponse? {
+    nil
+  }
+
+  package func documentSemanticTokensRange(
+    _ req: DocumentSemanticTokensRangeRequest
+  ) async throws -> DocumentSemanticTokensResponse? {
+    nil
+  }
+
+  package func colorPresentation(
+    _ req: ColorPresentationRequest
+  ) async throws -> [ColorPresentation] {
+    []
+  }
+
+  package func codeAction(
+    _ req: CodeActionRequest
+  ) async throws -> CodeActionRequestResponse? {
+    nil
+  }
+
+  package func inlayHint(
+    _ req: InlayHintRequest
+  ) async throws -> [InlayHint] {
+    []
+  }
+
+  package func codeLens(_ req: CodeLensRequest) async throws -> [CodeLens] {
+    []
+  }
+
+  package func documentDiagnostic(
+    _ req: DocumentDiagnosticsRequest
+  ) async throws -> DocumentDiagnosticReport {
+    .full(.init(items: []))
+  }
+
+  package func documentFormatting(
+    _ req: DocumentFormattingRequest
+  ) async throws -> [TextEdit]? {
+    nil
+  }
+
+  package func documentRangeFormatting(
+    _ req: LanguageServerProtocol.DocumentRangeFormattingRequest
+  ) async throws -> [LanguageServerProtocol.TextEdit]? {
+    return nil
+  }
+
+  package func documentOnTypeFormatting(_ req: DocumentOnTypeFormattingRequest) async throws -> [TextEdit]? {
+    return nil
+  }
+
+  package func rename(
+    _ request: RenameRequest
+  ) async throws -> (edits: WorkspaceEdit, usr: String?) {
+    (edits: .init(), usr: nil)
+  }
+
+  package func editsToRename(
+    locations renameLocations: [RenameLocation],
+    in snapshot: DocumentSnapshot,
+    oldName: CrossLanguageName,
+    newName: CrossLanguageName
+  ) async throws -> [TextEdit] {
+    []
+  }
+
+  package func prepareRename(
+    _ request: PrepareRenameRequest
+  ) async throws -> (prepareRename: PrepareRenameResponse, usr: String?)? {
+    nil
+  }
+
+  package func indexedRename(
+    _ request: IndexedRenameRequest
+  ) async throws -> WorkspaceEdit? {
+    nil
+  }
+
+  package func editsToRenameParametersInFunctionBody(
+    snapshot: DocumentSnapshot,
+    renameLocation: RenameLocation,
+    newName: CrossLanguageName
+  ) async -> [TextEdit] {
+    []
+  }
+
+  package func executeCommand(
+    _ req: ExecuteCommandRequest
+  ) async throws -> LSPAny? {
+    nil
+  }
+
+  package func getReferenceDocument(
+    _ req: GetReferenceDocumentRequest
+  ) async throws -> GetReferenceDocumentResponse {
+    .init(content: "")
+  }
+
+  package func syntacticDocumentTests(
+    for uri: DocumentURI,
+    in workspace: Workspace
+  ) async throws -> [AnnotatedTestItem]? {
+    nil
+  }
+
+  package func canonicalDeclarationPosition(
+    of position: Position,
+    in uri: DocumentURI
+  ) async -> Position? {
+    nil
+  }
+
+  package func crash() async {
+    // There's no way to crash the DocumentationLanguageService
+  }
+}

Sources/SourceKitLSP/LanguageServerType.swift

@@ -17,13 +17,16 @@ import LanguageServerProtocol
 enum LanguageServerType: Hashable {
   case clangd
   case swift
+  case documentation
 
   init?(language: Language) {
     switch language {
     case .c, .cpp, .objective_c, .objective_cpp:
       self = .clangd
     case .swift:
       self = .swift
+    case .markdown, .tutorial:
+      self = .documentation
     default:
       return nil
     }
@@ -44,6 +47,8 @@ enum LanguageServerType: Hashable {
       return ClangLanguageService.self
     case .swift:
       return SwiftLanguageService.self
+    case .documentation:
+      return DocumentationLanguageService.self
     }
   }
 }