Files
carbon-lang/toolchain/language_server/handle_initialize.cpp
T
Richard Smith 9a33fc1673 language-server: attempt to negotiate UTF-8 positions. (#7636)
We currently provide UTF-8 positions, since our source representation is
UTF-8 and we use byte offsets as column numbers, but the LSP protocol
default is UTF-16 column positions. Negotiate UTF-8 positions where
possible; this is supported by essentially every LSP client other than
VS Code.

In the case where we select a UTF-16 position, we continue to not do any
actual conversions, so our column offsets in such cases will continue to
be wrong on non-ASCII source files in VS Code.

Assisted by: Claude Code
2026-08-17 20:56:37 +00:00

51 lines
2.0 KiB
C++

// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
#include <utility>
#include "llvm/ADT/STLExtras.h"
#include "toolchain/language_server/handle.h"
namespace Carbon::LanguageServer {
// Picks the encoding used to measure `Position::character` on the wire.
// Use UTF-8 if offered, since Carbon source is natively UTF-8. Otherwise fall
// back to UTF-16, to support VS Code and old LSP clients.
static auto NegotiatePositionEncoding(
const clang::clangd::ClientCapabilities& capabilities)
-> clang::clangd::OffsetEncoding {
if (capabilities.PositionEncodings &&
llvm::is_contained(*capabilities.PositionEncodings,
clang::clangd::OffsetEncoding::UTF8)) {
return clang::clangd::OffsetEncoding::UTF8;
}
return clang::clangd::OffsetEncoding::UTF16;
}
auto HandleInitialize(
Context& context, const clang::clangd::InitializeParams& params,
llvm::function_ref<auto(llvm::Expected<llvm::json::Object>)->void> on_done)
-> void {
auto encoding = NegotiatePositionEncoding(params.capabilities);
context.SetPositionEncoding(encoding);
llvm::json::Object capabilities{{"documentSymbolProvider", true},
{"textDocumentSync", /*Incremental=*/2},
{"positionEncoding", encoding}};
llvm::json::Object reply{{"capabilities", std::move(capabilities)}};
on_done(reply);
}
// Implements `initialized`:
// https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#initialized
auto HandleInitialized(Context& /*context*/,
const clang::clangd::NoParams& /*params*/) -> void {
// Nothing to do, but every client sends this, so we handle it rather than
// warning about an unsupported notification.
// TODO: This is when we would use `client/registerCapability` for any
// capabilities we want to register dynamically.
}
} // namespace Carbon::LanguageServer