godot/modules/gdscript/language_server/lsp.hpp

1901 lines
48 KiB
C++
Raw Normal View History

2019-06-14 14:38:54 +00:00
/*************************************************************************/
/* lsp.hpp */
/*************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/*************************************************************************/
/* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
/* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
2019-06-14 14:38:54 +00:00
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/*************************************************************************/
#ifndef GODOT_LSP_H
#define GODOT_LSP_H
#include "core/doc_data.h"
#include "core/object/class_db.h"
#include "core/templates/list.h"
2019-06-14 14:38:54 +00:00
namespace lsp {
typedef String DocumentUri;
/** Format BBCode documentation from DocData to markdown */
static String marked_documentation(const String &p_bbcode);
2019-06-14 14:38:54 +00:00
/**
* Text documents are identified using a URI. On the protocol level, URIs are passed as strings.
*/
struct TextDocumentIdentifier {
/**
* The text document's URI.
*/
DocumentUri uri;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
2019-06-14 14:38:54 +00:00
uri = p_params["uri"];
}
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["uri"] = uri;
return dict;
}
};
/**
* Position in a text document expressed as zero-based line and zero-based character offset.
* A position is between two characters like an insert cursor in a editor.
* Special values like for example -1 to denote the end of a line are not supported.
*/
struct Position {
/**
* Line position in a document (zero-based).
*/
int line = 0;
/**
* Character offset on a line in a document (zero-based). Assuming that the line is
* represented as a string, the `character` value represents the gap between the
* `character` and `character + 1`.
*
* If the character value is greater than the line length it defaults back to the
* line length.
*/
int character = 0;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
2019-06-14 14:38:54 +00:00
line = p_params["line"];
character = p_params["character"];
}
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["line"] = line;
dict["character"] = character;
return dict;
}
};
/**
* A range in a text document expressed as (zero-based) start and end positions.
* A range is comparable to a selection in an editor. Therefore the end position is exclusive.
* If you want to specify a range that contains a line including the line ending character(s) then use an end position denoting the start of the next line.
*/
struct Range {
/**
* The range's start position.
*/
Position start;
/**
* The range's end position.
*/
Position end;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
2019-06-14 14:38:54 +00:00
start.load(p_params["start"]);
end.load(p_params["end"]);
}
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["start"] = start.to_json();
dict["end"] = end.to_json();
return dict;
}
};
/**
* Represents a location inside a resource, such as a line inside a text file.
*/
struct Location {
DocumentUri uri;
Range range;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
2019-06-14 14:38:54 +00:00
uri = p_params["uri"];
range.load(p_params["range"]);
}
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["uri"] = uri;
dict["range"] = range.to_json();
return dict;
}
};
/**
* Represents a link between a source and a target location.
*/
struct LocationLink {
/**
* Span of the origin of this link.
*
* Used as the underlined span for mouse interaction. Defaults to the word range at
* the mouse position.
*/
Range *originSelectionRange = nullptr;
2019-06-14 14:38:54 +00:00
/**
* The target resource identifier of this link.
*/
String targetUri;
/**
* The full target range of this link. If the target for example is a symbol then target range is the
* range enclosing this symbol not including leading/trailing whitespace but everything else
* like comments. This information is typically used to highlight the range in the editor.
*/
Range targetRange;
/**
* The range that should be selected and revealed when this link is being followed, e.g the name of a function.
* Must be contained by the the `targetRange`. See also `DocumentSymbol#range`
*/
Range targetSelectionRange;
};
/**
* A parameter literal used in requests to pass a text document and a position inside that document.
*/
struct TextDocumentPositionParams {
/**
* The text document.
*/
TextDocumentIdentifier textDocument;
/**
* The position inside the text document.
*/
Position position;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
2019-06-14 14:38:54 +00:00
textDocument.load(p_params["textDocument"]);
position.load(p_params["position"]);
}
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["textDocument"] = textDocument.to_json();
dict["position"] = position.to_json();
return dict;
}
};
struct DocumentLinkParams {
/**
* The document to provide document links for.
*/
TextDocumentIdentifier textDocument;
_FORCE_INLINE_ void load(const Dictionary &p_params) {
textDocument.load(p_params["textDocument"]);
}
};
/**
* A document link is a range in a text document that links to an internal or external resource, like another
* text document or a web site.
*/
struct DocumentLink {
/**
* The range this link applies to.
*/
Range range;
/**
* The uri this link points to. If missing a resolve request is sent later.
*/
DocumentUri target;
Dictionary to_json() const {
Dictionary dict;
dict["range"] = range.to_json();
dict["target"] = target;
return dict;
}
};
/**
* A textual edit applicable to a text document.
*/
struct TextEdit {
/**
* The range of the text document to be manipulated. To insert
* text into a document create a range where start === end.
*/
Range range;
/**
* The string to be inserted. For delete operations use an
* empty string.
*/
String newText;
};
/**
* Represents a reference to a command.
* Provides a title which will be used to represent a command in the UI.
* Commands are identified by a string identifier.
* The recommended way to handle commands is to implement their execution on the server side if the client and server provides the corresponding capabilities.
* Alternatively the tool extension code could handle the command. The protocol currently doesnt specify a set of well-known commands.
*/
struct Command {
/**
* Title of the command, like `save`.
*/
String title;
/**
* The identifier of the actual command handler.
*/
String command;
/**
* Arguments that the command handler should be
* invoked with.
*/
Array arguments;
Dictionary to_json() const {
Dictionary dict;
dict["title"] = title;
dict["command"] = command;
if (arguments.size()) {
dict["arguments"] = arguments;
}
return dict;
}
};
// Use namespace instead of enumeration to follow the LSP specifications
// lsp::EnumName::EnumValue is OK but lsp::EnumValue is not
2019-06-14 14:38:54 +00:00
namespace TextDocumentSyncKind {
/**
* Documents should not be synced at all.
*/
static const int None = 0;
/**
* Documents are synced by always sending the full content
* of the document.
*/
static const int Full = 1;
/**
* Documents are synced by sending the full content on open.
* After that only incremental updates to the document are
* send.
*/
static const int Incremental = 2;
}; // namespace TextDocumentSyncKind
/**
* Completion options.
*/
struct CompletionOptions {
/**
* The server provides support to resolve additional
* information for a completion item.
*/
bool resolveProvider = true;
/**
* The characters that trigger completion automatically.
*/
Vector<String> triggerCharacters;
CompletionOptions() {
triggerCharacters.push_back(".");
triggerCharacters.push_back("$");
triggerCharacters.push_back("'");
triggerCharacters.push_back("\"");
}
Dictionary to_json() const {
Dictionary dict;
dict["resolveProvider"] = resolveProvider;
dict["triggerCharacters"] = triggerCharacters;
return dict;
}
};
/**
* Signature help options.
*/
struct SignatureHelpOptions {
/**
* The characters that trigger signature help
* automatically.
*/
Vector<String> triggerCharacters;
Dictionary to_json() {
Dictionary dict;
dict["triggerCharacters"] = triggerCharacters;
return dict;
}
};
/**
* Code Lens options.
*/
struct CodeLensOptions {
/**
* Code lens has a resolve provider as well.
*/
bool resolveProvider = false;
Dictionary to_json() {
Dictionary dict;
dict["resolveProvider"] = resolveProvider;
return dict;
}
};
/**
* Rename options
*/
struct RenameOptions {
/**
* Renames should be checked and tested before being executed.
*/
bool prepareProvider = false;
Dictionary to_json() {
Dictionary dict;
dict["prepareProvider"] = prepareProvider;
return dict;
}
};
/**
* Document link options.
*/
struct DocumentLinkOptions {
/**
* Document links have a resolve provider as well.
*/
bool resolveProvider = false;
Dictionary to_json() {
Dictionary dict;
dict["resolveProvider"] = resolveProvider;
return dict;
}
};
/**
* Execute command options.
*/
struct ExecuteCommandOptions {
/**
* The commands to be executed on the server
*/
Vector<String> commands;
Dictionary to_json() {
Dictionary dict;
dict["commands"] = commands;
return dict;
}
};
/**
* Save options.
*/
struct SaveOptions {
/**
* The client is supposed to include the content on save.
*/
bool includeText = true;
Dictionary to_json() {
Dictionary dict;
dict["includeText"] = includeText;
return dict;
}
};
/**
* Color provider options.
*/
struct ColorProviderOptions {
Dictionary to_json() {
Dictionary dict;
return dict;
}
};
/**
* Folding range provider options.
*/
struct FoldingRangeProviderOptions {
Dictionary to_json() {
Dictionary dict;
return dict;
}
};
struct TextDocumentSyncOptions {
/**
* Open and close notifications are sent to the server. If omitted open close notification should not
* be sent.
*/
bool openClose = true;
/**
* Change notifications are sent to the server. See TextDocumentSyncKind.None, TextDocumentSyncKind.Full
* and TextDocumentSyncKind.Incremental. If omitted it defaults to TextDocumentSyncKind.None.
*/
int change = TextDocumentSyncKind::Full;
/**
* If present will save notifications are sent to the server. If omitted the notification should not be
* sent.
*/
bool willSave = false;
/**
* If present will save wait until requests are sent to the server. If omitted the request should not be
* sent.
*/
bool willSaveWaitUntil = false;
/**
* If present save notifications are sent to the server. If omitted the notification should not be
* sent.
*/
bool save = false;
2019-06-14 14:38:54 +00:00
Dictionary to_json() {
Dictionary dict;
dict["willSaveWaitUntil"] = willSaveWaitUntil;
dict["willSave"] = willSave;
dict["openClose"] = openClose;
dict["change"] = change;
dict["save"] = save;
2019-06-14 14:38:54 +00:00
return dict;
}
};
/**
* Static registration options to be returned in the initialize request.
*/
struct StaticRegistrationOptions {
/**
* The id used to register the request. The id can be used to deregister
* the request again. See also Registration#id.
*/
String id;
};
/**
* Format document on type options.
*/
struct DocumentOnTypeFormattingOptions {
/**
* A character on which formatting should be triggered, like `}`.
*/
String firstTriggerCharacter;
/**
* More trigger characters.
*/
Vector<String> moreTriggerCharacter;
Dictionary to_json() {
Dictionary dict;
dict["firstTriggerCharacter"] = firstTriggerCharacter;
dict["moreTriggerCharacter"] = moreTriggerCharacter;
return dict;
}
};
struct TextDocumentItem {
/**
* The text document's URI.
*/
DocumentUri uri;
/**
* The text document's language identifier.
*/
String languageId;
/**
* The version number of this document (it will increase after each
* change, including undo/redo).
*/
int version = 0;
2019-06-14 14:38:54 +00:00
/**
* The content of the opened text document.
*/
String text;
void load(const Dictionary &p_dict) {
uri = p_dict["uri"];
languageId = p_dict["languageId"];
version = p_dict["version"];
text = p_dict["text"];
}
Dictionary to_json() const {
Dictionary dict;
dict["uri"] = uri;
dict["languageId"] = languageId;
dict["version"] = version;
dict["text"] = text;
return dict;
}
};
/**
* An event describing a change to a text document. If range and rangeLength are omitted
* the new text is considered to be the full content of the document.
*/
struct TextDocumentContentChangeEvent {
/**
* The range of the document that changed.
*/
Range range;
/**
* The length of the range that got replaced.
*/
int rangeLength = 0;
2019-06-14 14:38:54 +00:00
/**
* The new text of the range/document.
*/
String text;
void load(const Dictionary &p_params) {
text = p_params["text"];
rangeLength = p_params["rangeLength"];
range.load(p_params["range"]);
}
};
// Use namespace instead of enumeration to follow the LSP specifications
2019-06-14 14:38:54 +00:00
namespace DiagnosticSeverity {
/**
* Reports an error.
*/
static const int Error = 1;
/**
* Reports a warning.
*/
static const int Warning = 2;
/**
* Reports an information.
*/
static const int Information = 3;
/**
* Reports a hint.
*/
static const int Hint = 4;
}; // namespace DiagnosticSeverity
/**
* Represents a related message and source code location for a diagnostic. This should be
* used to point to code locations that cause or related to a diagnostics, e.g when duplicating
* a symbol in a scope.
*/
struct DiagnosticRelatedInformation {
/**
* The location of this related diagnostic information.
*/
Location location;
/**
* The message of this related diagnostic information.
*/
String message;
Dictionary to_json() const {
Dictionary dict;
dict["location"] = location.to_json(),
dict["message"] = message;
return dict;
}
};
/**
* Represents a diagnostic, such as a compiler error or warning.
* Diagnostic objects are only valid in the scope of a resource.
*/
struct Diagnostic {
/**
* The range at which the message applies.
*/
Range range;
/**
* The diagnostic's severity. Can be omitted. If omitted it is up to the
* client to interpret diagnostics as error, warning, info or hint.
*/
int severity = 0;
2019-06-14 14:38:54 +00:00
/**
* The diagnostic's code, which might appear in the user interface.
*/
int code = 0;
2019-06-14 14:38:54 +00:00
/**
* A human-readable string describing the source of this
* diagnostic, e.g. 'typescript' or 'super lint'.
*/
String source;
/**
* The diagnostic's message.
*/
String message;
/**
* An array of related diagnostic information, e.g. when symbol-names within
* a scope collide all definitions can be marked via this property.
*/
Vector<DiagnosticRelatedInformation> relatedInformation;
Dictionary to_json() const {
Dictionary dict;
dict["range"] = range.to_json();
dict["code"] = code;
dict["severity"] = severity;
dict["message"] = message;
dict["source"] = source;
2020-12-15 12:04:21 +00:00
if (!relatedInformation.is_empty()) {
2019-06-14 14:38:54 +00:00
Array arr;
arr.resize(relatedInformation.size());
for (int i = 0; i < relatedInformation.size(); i++) {
arr[i] = relatedInformation[i].to_json();
}
dict["relatedInformation"] = arr;
}
return dict;
}
};
// Use namespace instead of enumeration to follow the LSP specifications
/**
* Describes the content type that a client supports in various
* result literals like `Hover`, `ParameterInfo` or `CompletionItem`.
*
* Please note that `MarkupKinds` must not start with a `$`. This kinds
* are reserved for internal usage.
*/
namespace MarkupKind {
static const String PlainText = "plaintext";
static const String Markdown = "markdown";
}; // namespace MarkupKind
/**
* A `MarkupContent` literal represents a string value which content is interpreted base on its
* kind flag. Currently the protocol supports `plaintext` and `markdown` as markup kinds.
*
* If the kind is `markdown` then the value can contain fenced code blocks like in GitHub issues.
* See https://help.github.com/articles/creating-and-highlighting-code-blocks/#syntax-highlighting
*
* Here is an example how such a string can be constructed using JavaScript / TypeScript:
* ```typescript
* let markdown: MarkdownContent = {
* kind: MarkupKind.Markdown,
* value: [
* '# Header',
* 'Some text',
* '```typescript',
* 'someCode();',
* '```'
* ].join('\n')
* };
* ```
*
* *Please Note* that clients might sanitize the return markdown. A client could decide to
* remove HTML from the markdown to avoid script execution.
*/
struct MarkupContent {
/**
* The type of the Markup
*/
String kind;
/**
* The content itself
*/
String value;
MarkupContent() {
kind = MarkupKind::Markdown;
}
MarkupContent(const String &p_value) {
value = p_value;
kind = MarkupKind::Markdown;
}
Dictionary to_json() const {
Dictionary dict;
dict["kind"] = kind;
dict["value"] = value;
return dict;
}
};
// Use namespace instead of enumeration to follow the LSP specifications
// lsp::EnumName::EnumValue is OK but lsp::EnumValue is not
2021-06-04 16:03:15 +00:00
// And here C++ compilers are unhappy with our enumeration name like Color, File, RefCounted etc.
2019-06-14 14:38:54 +00:00
/**
* The kind of a completion entry.
2019-06-14 14:38:54 +00:00
*/
namespace CompletionItemKind {
static const int Text = 1;
static const int Method = 2;
static const int Function = 3;
static const int Constructor = 4;
static const int Field = 5;
static const int Variable = 6;
static const int Class = 7;
static const int Interface = 8;
static const int Module = 9;
static const int Property = 10;
static const int Unit = 11;
static const int Value = 12;
static const int Enum = 13;
static const int Keyword = 14;
static const int Snippet = 15;
static const int Color = 16;
static const int File = 17;
2021-06-04 16:03:15 +00:00
static const int RefCounted = 18;
static const int Folder = 19;
static const int EnumMember = 20;
static const int Constant = 21;
static const int Struct = 22;
static const int Event = 23;
static const int Operator = 24;
static const int TypeParameter = 25;
}; // namespace CompletionItemKind
2019-06-14 14:38:54 +00:00
// Use namespace instead of enumeration to follow the LSP specifications
2019-06-14 14:38:54 +00:00
/**
* Defines whether the insert text in a completion item should be interpreted as
* plain text or a snippet.
2019-06-14 14:38:54 +00:00
*/
namespace InsertTextFormat {
/**
* The primary text to be inserted is treated as a plain string.
2019-06-14 14:38:54 +00:00
*/
static const int PlainText = 1;
2019-06-14 14:38:54 +00:00
/**
* The primary text to be inserted is treated as a snippet.
*
* A snippet can define tab stops and placeholders with `$1`, `$2`
* and `${3:foo}`. `$0` defines the final tab stop, it defaults to
* the end of the snippet. Placeholders with equal identifiers are linked,
* that is typing in one will update others too.
2019-06-14 14:38:54 +00:00
*/
static const int Snippet = 2;
}; // namespace InsertTextFormat
2019-06-14 14:38:54 +00:00
struct CompletionItem {
2019-06-14 14:38:54 +00:00
/**
* The label of this completion item. By default
* also the text that is inserted when selecting
* this completion.
2019-06-14 14:38:54 +00:00
*/
String label;
2019-06-14 14:38:54 +00:00
/**
* The kind of this completion item. Based of the kind
* an icon is chosen by the editor. The standardized set
* of available values is defined in `CompletionItemKind`.
2019-06-14 14:38:54 +00:00
*/
int kind = 0;
2019-06-14 14:38:54 +00:00
/**
* A human-readable string with additional information
* about this item, like type or symbol information.
*/
String detail;
/**
* A human-readable string that represents a doc-comment.
*/
MarkupContent documentation;
2019-06-14 14:38:54 +00:00
/**
* Indicates if this item is deprecated.
2019-06-14 14:38:54 +00:00
*/
bool deprecated = false;
2019-06-14 14:38:54 +00:00
/**
* Select this item when showing.
*
* *Note* that only one completion item can be selected and that the
* tool / client decides which item that is. The rule is that the *first*
* item of those that match best is selected.
2019-06-14 14:38:54 +00:00
*/
bool preselect = false;
2019-06-14 14:38:54 +00:00
/**
* A string that should be used when comparing this item
* with other items. When `falsy` the label is used.
*/
String sortText;
2019-06-14 14:38:54 +00:00
/**
* A string that should be used when filtering a set of
* completion items. When `falsy` the label is used.
2019-06-14 14:38:54 +00:00
*/
String filterText;
2019-06-14 14:38:54 +00:00
/**
* A string that should be inserted into a document when selecting
* this completion. When `falsy` the label is used.
*
* The `insertText` is subject to interpretation by the client side.
* Some tools might not take the string literally. For example
* VS Code when code complete is requested in this example `con<cursor position>`
* and a completion item with an `insertText` of `console` is provided it
* will only insert `sole`. Therefore it is recommended to use `textEdit` instead
* since it avoids additional client side interpretation.
*
* @deprecated Use textEdit instead.
2019-06-14 14:38:54 +00:00
*/
String insertText;
2019-06-14 14:38:54 +00:00
/**
* The format of the insert text. The format applies to both the `insertText` property
* and the `newText` property of a provided `textEdit`.
2019-06-14 14:38:54 +00:00
*/
int insertTextFormat = 0;
2019-06-14 14:38:54 +00:00
/**
* An edit which is applied to a document when selecting this completion. When an edit is provided the value of
* `insertText` is ignored.
*
* *Note:* The range of the edit must be a single line range and it must contain the position at which completion
* has been requested.
2019-06-14 14:38:54 +00:00
*/
TextEdit textEdit;
2019-06-14 14:38:54 +00:00
/**
* An optional array of additional text edits that are applied when
* selecting this completion. Edits must not overlap (including the same insert position)
* with the main edit nor with themselves.
*
* Additional text edits should be used to change text unrelated to the current cursor position
* (for example adding an import statement at the top of the file if the completion item will
* insert an unqualified type).
2019-06-14 14:38:54 +00:00
*/
Vector<TextEdit> additionalTextEdits;
2019-06-14 14:38:54 +00:00
/**
* An optional set of characters that when pressed while this completion is active will accept it first and
* then type that character. *Note* that all commit characters should have `length=1` and that superfluous
* characters will be ignored.
*/
Vector<String> commitCharacters;
/**
* An optional command that is executed *after* inserting this completion. *Note* that
* additional modifications to the current document should be described with the
* additionalTextEdits-property.
*/
Command command;
/**
* A data entry field that is preserved on a completion item between
* a completion and a completion resolve request.
*/
Variant data;
_FORCE_INLINE_ Dictionary to_json(bool resolved = false) const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["label"] = label;
2019-06-14 14:38:54 +00:00
dict["kind"] = kind;
dict["data"] = data;
if (resolved) {
dict["insertText"] = insertText;
dict["detail"] = detail;
dict["documentation"] = documentation.to_json();
dict["deprecated"] = deprecated;
dict["preselect"] = preselect;
dict["sortText"] = sortText;
dict["filterText"] = filterText;
if (commitCharacters.size()) {
dict["commitCharacters"] = commitCharacters;
}
dict["command"] = command.to_json();
2019-06-14 14:38:54 +00:00
}
return dict;
}
void load(const Dictionary &p_dict) {
if (p_dict.has("label")) {
label = p_dict["label"];
}
if (p_dict.has("kind")) {
kind = p_dict["kind"];
}
if (p_dict.has("detail")) {
detail = p_dict["detail"];
}
if (p_dict.has("documentation")) {
Variant doc = p_dict["documentation"];
if (doc.get_type() == Variant::STRING) {
documentation.value = doc;
} else if (doc.get_type() == Variant::DICTIONARY) {
Dictionary v = doc;
documentation.value = v["value"];
}
}
if (p_dict.has("deprecated")) {
deprecated = p_dict["deprecated"];
}
if (p_dict.has("preselect")) {
preselect = p_dict["preselect"];
}
if (p_dict.has("sortText")) {
sortText = p_dict["sortText"];
}
if (p_dict.has("filterText")) {
filterText = p_dict["filterText"];
}
if (p_dict.has("insertText")) {
insertText = p_dict["insertText"];
}
if (p_dict.has("data")) {
data = p_dict["data"];
}
}
2019-06-14 14:38:54 +00:00
};
/**
* Represents a collection of [completion items](#CompletionItem) to be presented
* in the editor.
2019-06-14 14:38:54 +00:00
*/
struct CompletionList {
2019-06-14 14:38:54 +00:00
/**
* This list it not complete. Further typing should result in recomputing
* this list.
2019-06-14 14:38:54 +00:00
*/
bool isIncomplete = false;
2019-06-14 14:38:54 +00:00
/**
* The completion items.
2019-06-14 14:38:54 +00:00
*/
Vector<CompletionItem> items;
2019-06-14 14:38:54 +00:00
};
// Use namespace instead of enumeration to follow the LSP specifications
// lsp::EnumName::EnumValue is OK but lsp::EnumValue is not
// And here C++ compilers are unhappy with our enumeration name like String, Array, Object etc
2019-06-14 14:38:54 +00:00
/**
* A symbol kind.
2019-06-14 14:38:54 +00:00
*/
namespace SymbolKind {
static const int File = 0;
static const int Module = 1;
static const int Namespace = 2;
static const int Package = 3;
static const int Class = 4;
static const int Method = 5;
static const int Property = 6;
static const int Field = 7;
static const int Constructor = 8;
static const int Enum = 9;
static const int Interface = 10;
static const int Function = 11;
static const int Variable = 12;
static const int Constant = 13;
static const int String = 14;
static const int Number = 15;
static const int Boolean = 16;
static const int Array = 17;
static const int Object = 18;
static const int Key = 19;
static const int Null = 20;
static const int EnumMember = 21;
static const int Struct = 22;
static const int Event = 23;
static const int Operator = 24;
static const int TypeParameter = 25;
}; // namespace SymbolKind
2019-06-14 14:38:54 +00:00
/**
* Represents information about programming constructs like variables, classes,
* interfaces etc.
2019-06-14 14:38:54 +00:00
*/
struct SymbolInformation {
/**
* The name of this symbol.
*/
String name;
2019-06-14 14:38:54 +00:00
/**
* The kind of this symbol.
2019-06-14 14:38:54 +00:00
*/
int kind = SymbolKind::File;
2019-06-14 14:38:54 +00:00
/**
* Indicates if this symbol is deprecated.
2019-06-14 14:38:54 +00:00
*/
bool deprecated = false;
2019-06-14 14:38:54 +00:00
/**
* The location of this symbol. The location's range is used by a tool
* to reveal the location in the editor. If the symbol is selected in the
* tool the range's start information is used to position the cursor. So
* the range usually spans more then the actual symbol's name and does
* normally include things like visibility modifiers.
*
* The range doesn't have to denote a node range in the sense of a abstract
* syntax tree. It can therefore not be used to re-construct a hierarchy of
* the symbols.
2019-06-14 14:38:54 +00:00
*/
Location location;
2019-06-14 14:38:54 +00:00
/**
* The name of the symbol containing this symbol. This information is for
* user interface purposes (e.g. to render a qualifier in the user interface
* if necessary). It can't be used to re-infer a hierarchy for the document
* symbols.
2019-06-14 14:38:54 +00:00
*/
String containerName;
_FORCE_INLINE_ Dictionary to_json() const {
Dictionary dict;
dict["name"] = name;
dict["kind"] = kind;
dict["deprecated"] = deprecated;
dict["location"] = location.to_json();
dict["containerName"] = containerName;
return dict;
}
};
2019-06-14 14:38:54 +00:00
struct DocumentedSymbolInformation : public SymbolInformation {
2019-06-14 14:38:54 +00:00
/**
* A human-readable string with additional information
*/
String detail;
/**
* A human-readable string that represents a doc-comment.
*/
String documentation;
};
2019-06-14 14:38:54 +00:00
/**
* Represents programming constructs like variables, classes, interfaces etc. that appear in a document. Document symbols can be
* hierarchical and they have two ranges: one that encloses its definition and one that points to its most interesting range,
* e.g. the range of an identifier.
*/
struct DocumentSymbol {
2019-06-14 14:38:54 +00:00
/**
* The name of this symbol. Will be displayed in the user interface and therefore must not be
* an empty string or a string only consisting of white spaces.
2019-06-14 14:38:54 +00:00
*/
String name;
2019-06-14 14:38:54 +00:00
/**
* More detail for this symbol, e.g the signature of a function.
2019-06-14 14:38:54 +00:00
*/
String detail;
2019-06-14 14:38:54 +00:00
/**
* Documentation for this symbol
2019-06-14 14:38:54 +00:00
*/
String documentation;
2019-06-14 14:38:54 +00:00
/**
* Class name for the native symbols
*/
String native_class;
2019-06-14 14:38:54 +00:00
/**
* The kind of this symbol.
2019-06-14 14:38:54 +00:00
*/
int kind = SymbolKind::File;
2019-06-14 14:38:54 +00:00
/**
* Indicates if this symbol is deprecated.
2019-06-14 14:38:54 +00:00
*/
bool deprecated = false;
2019-06-14 14:38:54 +00:00
/**
* The range enclosing this symbol not including leading/trailing whitespace but everything else
* like comments. This information is typically used to determine if the clients cursor is
* inside the symbol to reveal in the symbol in the UI.
2019-06-14 14:38:54 +00:00
*/
Range range;
2019-06-14 14:38:54 +00:00
/**
* The range that should be selected and revealed when this symbol is being picked, e.g the name of a function.
* Must be contained by the `range`.
2019-06-14 14:38:54 +00:00
*/
Range selectionRange;
2019-06-14 14:38:54 +00:00
DocumentUri uri;
String script_path;
2019-06-14 14:38:54 +00:00
/**
* Children of this symbol, e.g. properties of a class.
2019-06-14 14:38:54 +00:00
*/
Vector<DocumentSymbol> children;
2019-06-14 14:38:54 +00:00
Dictionary to_json(bool with_doc = false) const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["name"] = name;
2019-06-14 14:38:54 +00:00
dict["detail"] = detail;
dict["kind"] = kind;
2019-06-14 14:38:54 +00:00
dict["deprecated"] = deprecated;
dict["range"] = range.to_json();
dict["selectionRange"] = selectionRange.to_json();
if (with_doc) {
dict["documentation"] = documentation;
dict["native_class"] = native_class;
}
Array arr;
arr.resize(children.size());
for (int i = 0; i < children.size(); i++) {
arr[i] = children[i].to_json(with_doc);
}
dict["children"] = arr;
2019-06-14 14:38:54 +00:00
return dict;
}
void symbol_tree_as_list(const String &p_uri, Vector<DocumentedSymbolInformation> &r_list, const String &p_container = "", bool p_join_name = false) const {
DocumentedSymbolInformation si;
2020-12-15 12:04:21 +00:00
if (p_join_name && !p_container.is_empty()) {
si.name = p_container + ">" + name;
} else {
si.name = name;
}
si.kind = kind;
si.containerName = p_container;
si.deprecated = deprecated;
si.location.uri = p_uri;
si.location.range = range;
si.detail = detail;
si.documentation = documentation;
r_list.push_back(si);
for (int i = 0; i < children.size(); i++) {
children[i].symbol_tree_as_list(p_uri, r_list, si.name, p_join_name);
}
}
2019-06-14 14:38:54 +00:00
_FORCE_INLINE_ MarkupContent render() const {
MarkupContent markdown;
if (detail.length()) {
markdown.value = "\t" + detail + "\n\n";
}
if (documentation.length()) {
markdown.value += marked_documentation(documentation) + "\n\n";
}
if (script_path.length()) {
markdown.value += "Defined in [" + script_path + "](" + uri + ")";
}
return markdown;
}
2019-06-14 14:38:54 +00:00
_FORCE_INLINE_ CompletionItem make_completion_item(bool resolved = false) const {
lsp::CompletionItem item;
item.label = name;
if (resolved) {
item.documentation = render();
}
switch (kind) {
case lsp::SymbolKind::Enum:
item.kind = lsp::CompletionItemKind::Enum;
break;
case lsp::SymbolKind::Class:
item.kind = lsp::CompletionItemKind::Class;
break;
case lsp::SymbolKind::Property:
item.kind = lsp::CompletionItemKind::Property;
break;
case lsp::SymbolKind::Method:
case lsp::SymbolKind::Function:
item.kind = lsp::CompletionItemKind::Method;
break;
case lsp::SymbolKind::Event:
item.kind = lsp::CompletionItemKind::Event;
break;
case lsp::SymbolKind::Constant:
item.kind = lsp::CompletionItemKind::Constant;
break;
case lsp::SymbolKind::Variable:
item.kind = lsp::CompletionItemKind::Variable;
break;
case lsp::SymbolKind::File:
item.kind = lsp::CompletionItemKind::File;
break;
default:
item.kind = lsp::CompletionItemKind::Text;
break;
}
return item;
}
2019-06-14 14:38:54 +00:00
};
struct NativeSymbolInspectParams {
String native_class;
String symbol_name;
void load(const Dictionary &p_params) {
native_class = p_params["native_class"];
symbol_name = p_params["symbol_name"];
}
};
2019-06-14 14:38:54 +00:00
/**
* Enum of known range kinds
*/
namespace FoldingRangeKind {
/**
* Folding range for a comment
*/
static const String Comment = "comment";
/**
* Folding range for a imports or includes
*/
static const String Imports = "imports";
/**
* Folding range for a region (e.g. `#region`)
*/
static const String Region = "region";
} // namespace FoldingRangeKind
/**
* Represents a folding range.
*/
struct FoldingRange {
/**
* The zero-based line number from where the folded range starts.
*/
int startLine = 0;
/**
* The zero-based character offset from where the folded range starts. If not defined, defaults to the length of the start line.
*/
int startCharacter = 0;
/**
* The zero-based line number where the folded range ends.
*/
int endLine = 0;
/**
* The zero-based character offset before the folded range ends. If not defined, defaults to the length of the end line.
*/
int endCharacter = 0;
/**
* Describes the kind of the folding range such as `comment' or 'region'. The kind
* is used to categorize folding ranges and used by commands like 'Fold all comments'. See
* [FoldingRangeKind](#FoldingRangeKind) for an enumeration of standardized kinds.
*/
String kind = FoldingRangeKind::Region;
_FORCE_INLINE_ Dictionary to_json() const {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["startLine"] = startLine;
dict["startCharacter"] = startCharacter;
dict["endLine"] = endLine;
dict["endCharacter"] = endCharacter;
return dict;
}
};
// Use namespace instead of enumeration to follow the LSP specifications
2019-06-14 14:38:54 +00:00
/**
* How a completion was triggered
*/
namespace CompletionTriggerKind {
/**
* Completion was triggered by typing an identifier (24x7 code
* complete), manual invocation (e.g Ctrl+Space) or via API.
*/
static const int Invoked = 1;
/**
* Completion was triggered by a trigger character specified by
* the `triggerCharacters` properties of the `CompletionRegistrationOptions`.
*/
static const int TriggerCharacter = 2;
/**
* Completion was re-triggered as the current completion list is incomplete.
*/
static const int TriggerForIncompleteCompletions = 3;
} // namespace CompletionTriggerKind
/**
* Contains additional information about the context in which a completion request is triggered.
*/
struct CompletionContext {
/**
* How the completion was triggered.
*/
int triggerKind = CompletionTriggerKind::TriggerCharacter;
/**
* The trigger character (a single character) that has trigger code complete.
* Is undefined if `triggerKind !== CompletionTriggerKind.TriggerCharacter`
*/
String triggerCharacter;
void load(const Dictionary &p_params) {
triggerKind = int(p_params["triggerKind"]);
triggerCharacter = p_params["triggerCharacter"];
}
};
struct CompletionParams : public TextDocumentPositionParams {
/**
* The completion context. This is only available if the client specifies
* to send this using `ClientCapabilities.textDocument.completion.contextSupport === true`
*/
CompletionContext context;
void load(const Dictionary &p_params) {
TextDocumentPositionParams::load(p_params);
context.load(p_params["context"]);
}
};
/**
* The result of a hover request.
*/
struct Hover {
/**
* The hover's content
*/
MarkupContent contents;
/**
* An optional range is a range inside a text document
* that is used to visualize a hover, e.g. by changing the background color.
*/
Range range;
_FORCE_INLINE_ Dictionary to_json() const {
Dictionary dict;
dict["range"] = range.to_json();
dict["contents"] = contents.to_json();
return dict;
}
};
/**
* Represents a parameter of a callable-signature. A parameter can
* have a label and a doc-comment.
*/
struct ParameterInformation {
/**
* The label of this parameter information.
*
* Either a string or an inclusive start and exclusive end offsets within its containing
* signature label. (see SignatureInformation.label). The offsets are based on a UTF-16
* string representation as `Position` and `Range` does.
*
* *Note*: a label of type string should be a substring of its containing signature label.
* Its intended use case is to highlight the parameter label part in the `SignatureInformation.label`.
*/
String label;
/**
* The human-readable doc-comment of this parameter. Will be shown
* in the UI but can be omitted.
*/
MarkupContent documentation;
Dictionary to_json() const {
Dictionary dict;
dict["label"] = label;
dict["documentation"] = documentation.to_json();
return dict;
}
};
/**
* Represents the signature of something callable. A signature
* can have a label, like a function-name, a doc-comment, and
* a set of parameters.
*/
struct SignatureInformation {
/**
* The label of this signature. Will be shown in
* the UI.
*/
String label;
/**
* The human-readable doc-comment of this signature. Will be shown
* in the UI but can be omitted.
*/
MarkupContent documentation;
/**
* The parameters of this signature.
*/
Vector<ParameterInformation> parameters;
Dictionary to_json() const {
Dictionary dict;
dict["label"] = label;
dict["documentation"] = documentation.to_json();
Array args;
for (int i = 0; i < parameters.size(); i++) {
args.push_back(parameters[i].to_json());
}
dict["parameters"] = args;
return dict;
}
};
/**
* Signature help represents the signature of something
* callable. There can be multiple signature but only one
* active and only one active parameter.
*/
struct SignatureHelp {
/**
* One or more signatures.
*/
Vector<SignatureInformation> signatures;
/**
* The active signature. If omitted or the value lies outside the
* range of `signatures` the value defaults to zero or is ignored if
* `signatures.length === 0`. Whenever possible implementors should
* make an active decision about the active signature and shouldn't
* rely on a default value.
* In future version of the protocol this property might become
* mandatory to better express this.
*/
int activeSignature = 0;
/**
* The active parameter of the active signature. If omitted or the value
* lies outside the range of `signatures[activeSignature].parameters`
* defaults to 0 if the active signature has parameters. If
* the active signature has no parameters it is ignored.
* In future version of the protocol this property might become
* mandatory to better express the active parameter if the
* active signature does have any.
*/
int activeParameter = 0;
Dictionary to_json() const {
Dictionary dict;
Array sigs;
for (int i = 0; i < signatures.size(); i++) {
sigs.push_back(signatures[i].to_json());
}
dict["signatures"] = sigs;
dict["activeSignature"] = activeSignature;
dict["activeParameter"] = activeParameter;
return dict;
}
};
/**
* A pattern to describe in which file operation requests or notifications
* the server is interested in.
*/
struct FileOperationPattern {
/**
* The glob pattern to match.
*/
String glob = "**/*.gd";
/**
* Whether to match `file`s or `folder`s with this pattern.
*
* Matches both if undefined.
*/
String matches = "file";
Dictionary to_json() const {
Dictionary dict;
dict["glob"] = glob;
dict["matches"] = matches;
return dict;
}
};
/**
* A filter to describe in which file operation requests or notifications
* the server is interested in.
*/
struct FileOperationFilter {
/**
* The actual file operation pattern.
*/
FileOperationPattern pattern;
Dictionary to_json() const {
Dictionary dict;
dict["pattern"] = pattern.to_json();
return dict;
}
};
/**
* The options to register for file operations.
*/
struct FileOperationRegistrationOptions {
/**
* The actual filters.
*/
Vector<FileOperationFilter> filters;
FileOperationRegistrationOptions() {
filters.push_back(FileOperationFilter());
}
Dictionary to_json() const {
Dictionary dict;
Array filts;
for (int i = 0; i < filters.size(); i++) {
filts.push_back(filters[i].to_json());
}
dict["filters"] = filts;
return dict;
}
};
/**
* The server is interested in file notifications/requests.
*/
struct FileOperations {
/**
* The server is interested in receiving didDeleteFiles file notifications.
*/
FileOperationRegistrationOptions didDelete;
Dictionary to_json() const {
Dictionary dict;
dict["didDelete"] = didDelete.to_json();
return dict;
}
};
/**
* Workspace specific server capabilities
*/
struct Workspace {
/**
* The server is interested in file notifications/requests.
*/
FileOperations fileOperations;
Dictionary to_json() const {
Dictionary dict;
dict["fileOperations"] = fileOperations.to_json();
return dict;
}
};
2019-06-14 14:38:54 +00:00
struct ServerCapabilities {
/**
* Defines how text documents are synced. Is either a detailed structure defining each notification or
* for backwards compatibility the TextDocumentSyncKind number. If omitted it defaults to `TextDocumentSyncKind.None`.
*/
TextDocumentSyncOptions textDocumentSync;
/**
* The server provides hover support.
*/
bool hoverProvider = true;
/**
* The server provides completion support.
*/
CompletionOptions completionProvider;
/**
* The server provides signature help support.
*/
SignatureHelpOptions signatureHelpProvider;
/**
* The server provides goto definition support.
*/
bool definitionProvider = true;
2019-06-14 14:38:54 +00:00
/**
* The server provides Goto Type Definition support.
*
* Since 3.6.0
*/
bool typeDefinitionProvider = false;
/**
* The server provides Goto Implementation support.
*
* Since 3.6.0
*/
bool implementationProvider = false;
/**
* The server provides find references support.
*/
bool referencesProvider = false;
/**
* The server provides document highlight support.
*/
bool documentHighlightProvider = false;
/**
* The server provides document symbol support.
*/
bool documentSymbolProvider = true;
/**
* The server provides workspace symbol support.
*/
bool workspaceSymbolProvider = true;
/**
* The server supports workspace folder.
*/
Workspace workspace;
2019-06-14 14:38:54 +00:00
/**
* The server provides code actions. The `CodeActionOptions` return type is only
* valid if the client signals code action literal support via the property
* `textDocument.codeAction.codeActionLiteralSupport`.
*/
bool codeActionProvider = false;
/**
* The server provides code lens.
*/
CodeLensOptions codeLensProvider;
/**
* The server provides document formatting.
*/
bool documentFormattingProvider = false;
/**
* The server provides document range formatting.
*/
bool documentRangeFormattingProvider = false;
/**
* The server provides document formatting on typing.
*/
DocumentOnTypeFormattingOptions documentOnTypeFormattingProvider;
/**
* The server provides rename support. RenameOptions may only be
* specified if the client states that it supports
* `prepareSupport` in its initial `initialize` request.
*/
RenameOptions renameProvider;
/**
* The server provides document link support.
*/
DocumentLinkOptions documentLinkProvider;
/**
* The server provides color provider support.
*
* Since 3.6.0
*/
ColorProviderOptions colorProvider;
/**
* The server provides folding provider support.
*
* Since 3.10.0
*/
FoldingRangeProviderOptions foldingRangeProvider;
/**
* The server provides go to declaration support.
*
* Since 3.14.0
*/
bool declarationProvider = true;
/**
* The server provides execute command support.
*/
ExecuteCommandOptions executeCommandProvider;
_FORCE_INLINE_ Dictionary to_json() {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["textDocumentSync"] = textDocumentSync.to_json();
2019-06-14 14:38:54 +00:00
dict["completionProvider"] = completionProvider.to_json();
signatureHelpProvider.triggerCharacters.push_back(",");
signatureHelpProvider.triggerCharacters.push_back("(");
2019-06-14 14:38:54 +00:00
dict["signatureHelpProvider"] = signatureHelpProvider.to_json();
//dict["codeLensProvider"] = codeLensProvider.to_json();
2019-06-14 14:38:54 +00:00
dict["documentOnTypeFormattingProvider"] = documentOnTypeFormattingProvider.to_json();
dict["renameProvider"] = renameProvider.to_json();
dict["documentLinkProvider"] = documentLinkProvider.to_json();
dict["colorProvider"] = false; // colorProvider.to_json();
dict["foldingRangeProvider"] = false; //foldingRangeProvider.to_json();
dict["executeCommandProvider"] = executeCommandProvider.to_json();
dict["hoverProvider"] = hoverProvider;
dict["definitionProvider"] = definitionProvider;
dict["typeDefinitionProvider"] = typeDefinitionProvider;
dict["implementationProvider"] = implementationProvider;
dict["referencesProvider"] = referencesProvider;
dict["documentHighlightProvider"] = documentHighlightProvider;
dict["documentSymbolProvider"] = documentSymbolProvider;
dict["workspaceSymbolProvider"] = workspaceSymbolProvider;
dict["workspace"] = workspace.to_json();
2019-06-14 14:38:54 +00:00
dict["codeActionProvider"] = codeActionProvider;
dict["documentFormattingProvider"] = documentFormattingProvider;
dict["documentRangeFormattingProvider"] = documentRangeFormattingProvider;
dict["declarationProvider"] = declarationProvider;
return dict;
}
};
struct InitializeResult {
/**
* The capabilities the language server provides.
*/
ServerCapabilities capabilities;
_FORCE_INLINE_ Dictionary to_json() {
2019-06-14 14:38:54 +00:00
Dictionary dict;
dict["capabilities"] = capabilities.to_json();
return dict;
}
};
2019-10-09 05:29:29 +00:00
struct GodotNativeClassInfo {
String name;
const DocData::ClassDoc *class_doc = nullptr;
const ClassDB::ClassInfo *class_info = nullptr;
2019-10-09 05:29:29 +00:00
Dictionary to_json() {
Dictionary dict;
dict["name"] = name;
dict["inherits"] = class_doc->inherits;
return dict;
}
};
/** Features not included in the standard lsp specifications */
2019-10-09 05:29:29 +00:00
struct GodotCapabilities {
/**
* Native class list
*/
List<GodotNativeClassInfo> native_classes;
Dictionary to_json() {
Dictionary dict;
Array classes;
for (List<GodotNativeClassInfo>::Element *E = native_classes.front(); E; E = E->next()) {
classes.push_back(E->get().to_json());
}
dict["native_classes"] = classes;
return dict;
}
};
/** Format BBCode documentation from DocData to markdown */
static String marked_documentation(const String &p_bbcode) {
String markdown = p_bbcode.strip_edges();
Vector<String> lines = markdown.split("\n");
bool in_code_block = false;
int code_block_indent = -1;
markdown = "";
for (int i = 0; i < lines.size(); i++) {
String line = lines[i];
int block_start = line.find("[codeblock]");
if (block_start != -1) {
code_block_indent = block_start;
in_code_block = true;
line = "\n";
} else if (in_code_block) {
line = "\t" + line.substr(code_block_indent, line.length());
}
if (in_code_block && line.find("[/codeblock]") != -1) {
line = "\n";
in_code_block = false;
}
if (!in_code_block) {
line = line.strip_edges();
line = line.replace("[code]", "`");
line = line.replace("[/code]", "`");
line = line.replace("[i]", "*");
line = line.replace("[/i]", "*");
line = line.replace("[b]", "**");
line = line.replace("[/b]", "**");
line = line.replace("[u]", "__");
line = line.replace("[/u]", "__");
line = line.replace("[method ", "`");
line = line.replace("[member ", "`");
line = line.replace("[signal ", "`");
line = line.replace("[enum ", "`");
line = line.replace("[constant ", "`");
line = line.replace("[", "`");
line = line.replace("]", "`");
}
if (!in_code_block && i < lines.size() - 1) {
line += "\n\n";
} else if (i < lines.size() - 1) {
line += "\n";
}
markdown += line;
}
return markdown;
}
2019-06-14 14:38:54 +00:00
} // namespace lsp
#endif