language_server-protocol 3.15.0.2 → 3.16.0.0

data/lib/language_server/protocol/interface/signature_information.rb

@@ -7,12 +7,13 @@ module LanguageServer
       # a set of parameters.
       #
       class SignatureInformation
-        def initialize(label:, documentation: nil, parameters: nil)
+        def initialize(label:, documentation: nil, parameters: nil, active_parameter: nil)
           @attributes = {}
 
           @attributes[:label] = label
           @attributes[:documentation] = documentation if documentation
           @attributes[:parameters] = parameters if parameters
+          @attributes[:activeParameter] = active_parameter if active_parameter
 
           @attributes.freeze
         end
@@ -43,6 +44,16 @@ module LanguageServer
           attributes.fetch(:parameters)
         end
 
+        #
+        # The index of the active parameter.
+        #
+        # If provided, this is used in place of `SignatureHelp.activeParameter`.
+        #
+        # @return [number]
+        def active_parameter
+          attributes.fetch(:activeParameter)
+        end
+
         attr_reader :attributes
 
         def to_hash

data/lib/language_server/protocol/interface/symbol_information.rb

@@ -6,11 +6,12 @@ module LanguageServer
       # interfaces etc.
       #
       class SymbolInformation
-        def initialize(name:, kind:, deprecated: nil, location:, container_name: nil)
+        def initialize(name:, kind:, tags: nil, deprecated: nil, location:, container_name: nil)
           @attributes = {}
 
           @attributes[:name] = name
           @attributes[:kind] = kind
+          @attributes[:tags] = tags if tags
           @attributes[:deprecated] = deprecated if deprecated
           @attributes[:location] = location
           @attributes[:containerName] = container_name if container_name
@@ -34,6 +35,14 @@ module LanguageServer
           attributes.fetch(:kind)
         end
 
+        #
+        # Tags for this symbol.
+        #
+        # @return [1[]]
+        def tags
+          attributes.fetch(:tags)
+        end
+
         #
         # Indicates if this symbol is deprecated.
         #

data/lib/language_server/protocol/interface/text_document_change_registration_options.rb

@@ -18,7 +18,7 @@ module LanguageServer
         # How documents are synced to the server. See TextDocumentSyncKind.Full
         # and TextDocumentSyncKind.Incremental.
         #
-        # @return [any]
+        # @return [TextDocumentSyncKind]
         def sync_kind
           attributes.fetch(:syncKind)
         end

data/lib/language_server/protocol/interface/text_document_client_capabilities.rb

@@ -5,7 +5,7 @@ module LanguageServer
       # Text document specific client capabilities.
       #
       class TextDocumentClientCapabilities
-        def initialize(synchronization: nil, completion: nil, hover: nil, signature_help: nil, declaration: nil, definition: nil, type_definition: nil, implementation: nil, references: nil, document_highlight: nil, document_symbol: nil, code_action: nil, code_lens: nil, document_link: nil, color_provider: nil, formatting: nil, range_formatting: nil, on_type_formatting: nil, rename: nil, publish_diagnostics: nil, folding_range: nil, selection_range: nil)
+        def initialize(synchronization: nil, completion: nil, hover: nil, signature_help: nil, declaration: nil, definition: nil, type_definition: nil, implementation: nil, references: nil, document_highlight: nil, document_symbol: nil, code_action: nil, code_lens: nil, document_link: nil, color_provider: nil, formatting: nil, range_formatting: nil, on_type_formatting: nil, rename: nil, publish_diagnostics: nil, folding_range: nil, selection_range: nil, linked_editing_range: nil, call_hierarchy: nil, semantic_tokens: nil, moniker: nil)
           @attributes = {}
 
           @attributes[:synchronization] = synchronization if synchronization
@@ -30,6 +30,10 @@ module LanguageServer
           @attributes[:publishDiagnostics] = publish_diagnostics if publish_diagnostics
           @attributes[:foldingRange] = folding_range if folding_range
           @attributes[:selectionRange] = selection_range if selection_range
+          @attributes[:linkedEditingRange] = linked_editing_range if linked_editing_range
+          @attributes[:callHierarchy] = call_hierarchy if call_hierarchy
+          @attributes[:semanticTokens] = semantic_tokens if semantic_tokens
+          @attributes[:moniker] = moniker if moniker
 
           @attributes.freeze
         end
@@ -186,7 +190,8 @@ module LanguageServer
         end
 
         #
-        # Capabilities specific to the `textDocument/publishDiagnostics` notification.
+        # Capabilities specific to the `textDocument/publishDiagnostics`
+        # notification.
         #
         # @return [PublishDiagnosticsClientCapabilities]
         def publish_diagnostics
@@ -209,6 +214,38 @@ module LanguageServer
           attributes.fetch(:selectionRange)
         end
 
+        #
+        # Capabilities specific to the `textDocument/linkedEditingRange` request.
+        #
+        # @return [LinkedEditingRangeClientCapabilities]
+        def linked_editing_range
+          attributes.fetch(:linkedEditingRange)
+        end
+
+        #
+        # Capabilities specific to the various call hierarchy requests.
+        #
+        # @return [CallHierarchyClientCapabilities]
+        def call_hierarchy
+          attributes.fetch(:callHierarchy)
+        end
+
+        #
+        # Capabilities specific to the various semantic token requests.
+        #
+        # @return [SemanticTokensClientCapabilities]
+        def semantic_tokens
+          attributes.fetch(:semanticTokens)
+        end
+
+        #
+        # Capabilities specific to the `textDocument/moniker` request.
+        #
+        # @return [MonikerClientCapabilities]
+        def moniker
+          attributes.fetch(:moniker)
+        end
+
         attr_reader :attributes
 
         def to_hash

data/lib/language_server/protocol/interface/text_document_content_change_event.rb

@@ -2,8 +2,8 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # 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.
+      # 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.
       #
       class TextDocumentContentChangeEvent
         def initialize(range: nil, range_length: nil, text:)

data/lib/language_server/protocol/interface/text_document_edit.rb

@@ -14,7 +14,7 @@ module LanguageServer
         #
         # The text document to change.
         #
-        # @return [VersionedTextDocumentIdentifier]
+        # @return [OptionalVersionedTextDocumentIdentifier]
         def text_document
           attributes.fetch(:textDocument)
         end
@@ -22,7 +22,7 @@ module LanguageServer
         #
         # The edits to be applied.
         #
-        # @return [TextEdit[]]
+        # @return [(TextEdit | AnnotatedTextEdit)[]]
         def edits
           attributes.fetch(:edits)
         end

data/lib/language_server/protocol/interface/text_document_registration_options.rb

@@ -14,10 +14,10 @@ module LanguageServer
         end
 
         #
-        # A document selector to identify the scope of the registration. If set to null
-        # the document selector provided on the client side will be used.
+        # A document selector to identify the scope of the registration. If set to
+        # null the document selector provided on the client side will be used.
         #
-        # @return [DocumentFilter[]]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end

data/lib/language_server/protocol/interface/text_document_sync_options.rb

@@ -15,10 +15,8 @@ module LanguageServer
         end
 
         #
-        # Open and close notifications are sent to the server. If omitted open close notification should not
-        # be sent.
-        # Open and close notifications are sent to the server. If omitted open close notification should not
-        # be sent.
+        # Open and close notifications are sent to the server. If omitted open
+        # close notification should not be sent.
         #
         # @return [boolean]
         def open_close
@@ -26,19 +24,19 @@ module LanguageServer
         end
 
         #
-        # Change notifications are sent to the server. See TextDocumentSyncKind.None, TextDocumentSyncKind.Full
-        # and TextDocumentSyncKind.Incremental. If omitted it defaults to TextDocumentSyncKind.None.
-        # Change notifications are sent to the server. See TextDocumentSyncKind.None, TextDocumentSyncKind.Full
-        # and TextDocumentSyncKind.Incremental. If omitted it defaults to TextDocumentSyncKind.None.
+        # Change notifications are sent to the server. See
+        # TextDocumentSyncKind.None, TextDocumentSyncKind.Full and
+        # TextDocumentSyncKind.Incremental. If omitted it defaults to
+        # TextDocumentSyncKind.None.
         #
-        # @return [any]
+        # @return [TextDocumentSyncKind]
         def change
           attributes.fetch(:change)
         end
 
         #
-        # If present will save notifications are sent to the server. If omitted the notification should not be
-        # sent.
+        # If present will save notifications are sent to the server. If omitted
+        # the notification should not be sent.
         #
         # @return [boolean]
         def will_save
@@ -46,8 +44,8 @@ module LanguageServer
         end
 
         #
-        # If present will save wait until requests are sent to the server. If omitted the request should not be
-        # sent.
+        # If present will save wait until requests are sent to the server. If
+        # omitted the request should not be sent.
         #
         # @return [boolean]
         def will_save_wait_until
@@ -55,8 +53,8 @@ module LanguageServer
         end
 
         #
-        # If present save notifications are sent to the server. If omitted the notification should not be
-        # sent.
+        # If present save notifications are sent to the server. If omitted the
+        # notification should not be sent.
         #
         # @return [boolean | SaveOptions]
         def save

data/lib/language_server/protocol/interface/type_definition_client_capabilities.rb

@@ -12,9 +12,9 @@ module LanguageServer
         end
 
         #
-        # Whether implementation supports dynamic registration. If this is set to `true`
-        # the client supports the new `TypeDefinitionRegistrationOptions` return value
-        # for the corresponding server capability as well.
+        # Whether implementation supports dynamic registration. If this is set to
+        # `true` the client supports the new `TypeDefinitionRegistrationOptions`
+        # return value for the corresponding server capability as well.
         #
         # @return [boolean]
         def dynamic_registration

data/lib/language_server/protocol/interface/versioned_text_document_identifier.rb

@@ -12,14 +12,10 @@ module LanguageServer
         end
 
         #
-        # The version number of this document. If a versioned text document identifier
-        # is sent from the server to the client and the file is not open in the editor
-        # (the server has not received an open notification before) the server can send
-        # `null` to indicate that the version is known and the content on disk is the
-        # master (as speced with document content ownership).
+        # The version number of this document.
         #
-        # The version number of a document will increase after each change, including
-        # undo/redo. The number doesn't need to be consecutive.
+        # The version number of a document will increase after each change,
+        # including undo/redo. The number doesn't need to be consecutive.
         #
         # @return [number]
         def version

data/lib/language_server/protocol/interface/will_save_text_document_params.rb

@@ -25,7 +25,7 @@ module LanguageServer
         #
         # The 'TextDocumentSaveReason'.
         #
-        # @return [number]
+        # @return [TextDocumentSaveReason]
         def reason
           attributes.fetch(:reason)
         end

data/lib/language_server/protocol/interface/work_done_progress_begin.rb

@@ -32,8 +32,8 @@ module LanguageServer
 
         #
         # Controls if a cancel button should show to allow the user to cancel the
-        # long running operation. Clients that don't support cancellation are allowed
-        # to ignore the setting.
+        # long running operation. Clients that don't support cancellation are
+        # allowed to ignore the setting.
         #
         # @return [boolean]
         def cancellable
@@ -58,7 +58,7 @@ module LanguageServer
         # to ignore the `percentage` value in subsequent in report notifications.
         #
         # The value should be steadily rising. Clients are free to ignore values
-        # that are not following this rule.
+        # that are not following this rule. The value range is [0, 100]
         #
         # @return [number]
         def percentage

data/lib/language_server/protocol/interface/work_done_progress_cancel_params.rb

@@ -13,7 +13,7 @@ module LanguageServer
         #
         # The token to be used to report progress.
         #
-        # @return [string | number]
+        # @return [ProgressToken]
         def token
           attributes.fetch(:token)
         end

data/lib/language_server/protocol/interface/work_done_progress_create_params.rb

@@ -13,7 +13,7 @@ module LanguageServer
         #
         # The token to be used to report progress.
         #
-        # @return [string | number]
+        # @return [ProgressToken]
         def token
           attributes.fetch(:token)
         end

data/lib/language_server/protocol/interface/work_done_progress_params.rb

@@ -13,7 +13,7 @@ module LanguageServer
         #
         # An optional token that a server can use to report work done progress.
         #
-        # @return [string | number]
+        # @return [ProgressToken]
         def work_done_token
           attributes.fetch(:workDoneToken)
         end

data/lib/language_server/protocol/interface/work_done_progress_report.rb

@@ -19,11 +19,11 @@ module LanguageServer
         end
 
         #
-        # Controls enablement state of a cancel button. This property is only valid if a cancel
-        # button got requested in the `WorkDoneProgressStart` payload.
+        # Controls enablement state of a cancel button. This property is only valid
+        # if a cancel button got requested in the `WorkDoneProgressStart` payload.
         #
-        # Clients that don't support cancellation or don't support control the button's
-        # enablement state are allowed to ignore the setting.
+        # Clients that don't support cancellation or don't support control the
+        # button's enablement state are allowed to ignore the setting.
         #
         # @return [boolean]
         def cancellable
@@ -48,7 +48,7 @@ module LanguageServer
         # to ignore the `percentage` value in subsequent in report notifications.
         #
         # The value should be steadily rising. Clients are free to ignore values
-        # that are not following this rule.
+        # that are not following this rule. The value range is [0, 100]
         #
         # @return [number]
         def percentage

data/lib/language_server/protocol/interface/workspace_edit.rb

@@ -2,11 +2,12 @@ module LanguageServer
   module Protocol
     module Interface
       class WorkspaceEdit
-        def initialize(changes: nil, document_changes: nil)
+        def initialize(changes: nil, document_changes: nil, change_annotations: nil)
           @attributes = {}
 
           @attributes[:changes] = changes if changes
           @attributes[:documentChanges] = document_changes if document_changes
+          @attributes[:changeAnnotations] = change_annotations if change_annotations
 
           @attributes.freeze
         end
@@ -20,22 +21,38 @@ module LanguageServer
         end
 
         #
-        # Depending on the client capability `workspace.workspaceEdit.resourceOperations` document changes
-        # are either an array of `TextDocumentEdit`s to express changes to n different text documents
-        # where each text document edit addresses a specific version of a text document. Or it can contain
-        # above `TextDocumentEdit`s mixed with create, rename and delete file / folder operations.
+        # Depending on the client capability
+        # `workspace.workspaceEdit.resourceOperations` document changes are either
+        # an array of `TextDocumentEdit`s to express changes to n different text
+        # documents where each text document edit addresses a specific version of
+        # a text document. Or it can contain above `TextDocumentEdit`s mixed with
+        # create, rename and delete file / folder operations.
         #
         # Whether a client supports versioned document edits is expressed via
         # `workspace.workspaceEdit.documentChanges` client capability.
         #
-        # If a client neither supports `documentChanges` nor `workspace.workspaceEdit.resourceOperations` then
-        # only plain `TextEdit`s using the `changes` property are supported.
+        # If a client neither supports `documentChanges` nor
+        # `workspace.workspaceEdit.resourceOperations` then only plain `TextEdit`s
+        # using the `changes` property are supported.
         #
         # @return [TextDocumentEdit[] | (TextDocumentEdit | CreateFile | RenameFile | DeleteFile)[]]
         def document_changes
           attributes.fetch(:documentChanges)
         end
 
+        #
+        # A map of change annotations that can be referenced in
+        # `AnnotatedTextEdit`s or create, rename and delete file / folder
+        # operations.
+        #
+        # Whether clients honor this property depends on the client capability
+        # `workspace.changeAnnotationSupport`.
+        #
+        # @return [{ [id: string]: ChangeAnnotation; }]
+        def change_annotations
+          attributes.fetch(:changeAnnotations)
+        end
+
         attr_reader :attributes
 
         def to_hash

data/lib/language_server/protocol/interface/workspace_edit_client_capabilities.rb

@@ -2,12 +2,14 @@ module LanguageServer
   module Protocol
     module Interface
       class WorkspaceEditClientCapabilities
-        def initialize(document_changes: nil, resource_operations: nil, failure_handling: nil)
+        def initialize(document_changes: nil, resource_operations: nil, failure_handling: nil, normalizes_line_endings: nil, change_annotation_support: nil)
           @attributes = {}
 
           @attributes[:documentChanges] = document_changes if document_changes
           @attributes[:resourceOperations] = resource_operations if resource_operations
           @attributes[:failureHandling] = failure_handling if failure_handling
+          @attributes[:normalizesLineEndings] = normalizes_line_endings if normalizes_line_endings
+          @attributes[:changeAnnotationSupport] = change_annotation_support if change_annotation_support
 
           @attributes.freeze
         end
@@ -38,6 +40,26 @@ module LanguageServer
           attributes.fetch(:failureHandling)
         end
 
+        #
+        # Whether the client normalizes line endings to the client specific
+        # setting.
+        # If set to `true` the client will normalize line ending characters
+        # in a workspace edit to the client specific new line character(s).
+        #
+        # @return [boolean]
+        def normalizes_line_endings
+          attributes.fetch(:normalizesLineEndings)
+        end
+
+        #
+        # Whether the client in general supports change annotations on text edits,
+        # create file, rename file and delete file changes.
+        #
+        # @return [{ groupsOnLabel?: boolean; }]
+        def change_annotation_support
+          attributes.fetch(:changeAnnotationSupport)
+        end
+
         attr_reader :attributes
 
         def to_hash