language_server-protocol 3.17.0.5 → 3.18.0.0.pre.1

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

@@ -0,0 +1,47 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # A generic resource operation.
+      #
+      class ResourceOperation
+        def initialize(kind:, annotation_id: nil)
+          @attributes = {}
+
+          @attributes[:kind] = kind
+          @attributes[:annotationId] = annotation_id unless annotation_id.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # The resource operation kind.
+        #
+        # @return [string]
+        def kind
+          attributes.fetch(:kind)
+        end
+
+        #
+        # An optional annotation identifier describing the operation.
+        #
+        # @since 3.16.0
+        #
+        # @return [ChangeAnnotationIdentifier]
+        def annotation_id
+          attributes.fetch(:annotationId)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -7,7 +7,7 @@ module LanguageServer
 
           @attributes[:code] = code
           @attributes[:message] = message
-          @attributes[:data] = data if data
+          @attributes[:data] = data unless data.nil?
 
           @attributes.freeze
         end

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

@@ -7,8 +7,8 @@ module LanguageServer
 
           @attributes[:jsonrpc] = jsonrpc
           @attributes[:id] = id
-          @attributes[:result] = result if result
-          @attributes[:error] = error if error
+          @attributes[:result] = result unless result.nil?
+          @attributes[:error] = error unless error.nil?
 
           @attributes.freeze
         end
@@ -30,7 +30,7 @@ module LanguageServer
         # The result of a request. This member is REQUIRED on success.
         # This member MUST NOT exist if there was an error invoking the method.
         #
-        # @return [string | number | boolean | object]
+        # @return [any]
         def result
           attributes.fetch(:result)
         end

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

@@ -1,11 +1,14 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Save options.
+      #
       class SaveOptions
         def initialize(include_text: nil)
           @attributes = {}
 
-          @attributes[:includeText] = include_text if include_text
+          @attributes[:includeText] = include_text unless include_text.nil?
 
           @attributes.freeze
         end

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

@@ -0,0 +1,47 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Describes the currently selected completion item.
+      #
+      # @since 3.18.0
+      #
+      class SelectedCompletionInfo
+        def initialize(range:, text:)
+          @attributes = {}
+
+          @attributes[:range] = range
+          @attributes[:text] = text
+
+          @attributes.freeze
+        end
+
+        #
+        # The range that will be replaced if this completion item is accepted.
+        #
+        # @return [Range]
+        def range
+          attributes.fetch(:range)
+        end
+
+        #
+        # The text the range will be replaced with if this completion is accepted.
+        #
+        # @return [string]
+        def text
+          attributes.fetch(:text)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -1,18 +1,22 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # A selection range represents a part of a selection hierarchy. A selection range
+      # may have a parent selection range that contains it.
+      #
       class SelectionRange
         def initialize(range:, parent: nil)
           @attributes = {}
 
           @attributes[:range] = range
-          @attributes[:parent] = parent if parent
+          @attributes[:parent] = parent unless parent.nil?
 
           @attributes.freeze
         end
 
         #
-        # The [range](#Range) of this selection range.
+        # The {@link Range range} of this selection range.
         #
         # @return [Range]
         def range
@@ -20,8 +24,7 @@ module LanguageServer
         end
 
         #
-        # The parent selection range containing this range. Therefore
-        # `parent.range` must contain `this.range`.
+        # The parent selection range containing this range. Therefore `parent.range` must contain `this.range`.
         #
         # @return [SelectionRange]
         def parent

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

@@ -5,16 +5,15 @@ module LanguageServer
         def initialize(dynamic_registration: nil)
           @attributes = {}
 
-          @attributes[:dynamicRegistration] = dynamic_registration if dynamic_registration
+          @attributes[:dynamicRegistration] = dynamic_registration unless dynamic_registration.nil?
 
           @attributes.freeze
         end
 
         #
-        # Whether implementation supports dynamic registration for selection range
-        # providers. If this is set to `true` the client supports the new
-        # `SelectionRangeRegistrationOptions` return value for the corresponding
-        # server capability as well.
+        # Whether implementation supports dynamic registration for selection range providers. If this is set to `true`
+        # the client supports the new `SelectionRangeRegistrationOptions` return value for the corresponding server
+        # capability as well.
         #
         # @return [boolean]
         def dynamic_registration

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

@@ -5,7 +5,7 @@ module LanguageServer
         def initialize(work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
 
           @attributes.freeze
         end

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

@@ -1,35 +1,21 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # A parameter literal used in selection range requests.
+      #
       class SelectionRangeParams
-        def initialize(work_done_token: nil, partial_result_token: nil, text_document:, positions:)
+        def initialize(text_document:, positions:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
 
-          @attributes[:workDoneToken] = work_done_token if work_done_token
-          @attributes[:partialResultToken] = partial_result_token if partial_result_token
           @attributes[:textDocument] = text_document
           @attributes[:positions] = positions
+          @attributes[:workDoneToken] = work_done_token unless work_done_token.nil?
+          @attributes[:partialResultToken] = partial_result_token unless partial_result_token.nil?
 
           @attributes.freeze
         end
 
-        #
-        # An optional token that a server can use to report work done progress.
-        #
-        # @return [ProgressToken]
-        def work_done_token
-          attributes.fetch(:workDoneToken)
-        end
-
-        #
-        # An optional token that a server can use to report partial results (e.g.
-        # streaming) to the client.
-        #
-        # @return [ProgressToken]
-        def partial_result_token
-          attributes.fetch(:partialResultToken)
-        end
-
         #
         # The text document.
         #
@@ -46,6 +32,23 @@ module LanguageServer
           attributes.fetch(:positions)
         end
 
+        #
+        # An optional token that a server can use to report work done progress.
+        #
+        # @return [ProgressToken]
+        def work_done_token
+          attributes.fetch(:workDoneToken)
+        end
+
+        #
+        # An optional token that a server can use to report partial results (e.g. streaming) to
+        # the client.
+        #
+        # @return [ProgressToken]
+        def partial_result_token
+          attributes.fetch(:partialResultToken)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -5,9 +5,9 @@ module LanguageServer
         def initialize(work_done_progress: nil, document_selector:, id: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
           @attributes[:documentSelector] = document_selector
-          @attributes[:id] = id if id
+          @attributes[:id] = id unless id.nil?
 
           @attributes.freeze
         end
@@ -18,10 +18,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 [DocumentSelector]
+        # @return [DocumentSelector | nil]
         def document_selector
           attributes.fetch(:documentSelector)
         end

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

@@ -1,11 +1,14 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokens
         def initialize(result_id: nil, data:)
           @attributes = {}
 
-          @attributes[:resultId] = result_id if result_id
+          @attributes[:resultId] = result_id unless result_id.nil?
           @attributes[:data] = data
 
           @attributes.freeze
@@ -25,7 +28,7 @@ module LanguageServer
         #
         # The actual tokens.
         #
-        # @return [number[]]
+        # @return [uinteger[]]
         def data
           attributes.fetch(:data)
         end

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

@@ -1,28 +1,30 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensClientCapabilities
         def initialize(dynamic_registration: nil, requests:, token_types:, token_modifiers:, formats:, overlapping_token_support: nil, multiline_token_support: nil, server_cancel_support: nil, augments_syntax_tokens: nil)
           @attributes = {}
 
-          @attributes[:dynamicRegistration] = dynamic_registration if dynamic_registration
+          @attributes[:dynamicRegistration] = dynamic_registration unless dynamic_registration.nil?
           @attributes[:requests] = requests
           @attributes[:tokenTypes] = token_types
           @attributes[:tokenModifiers] = token_modifiers
           @attributes[:formats] = formats
-          @attributes[:overlappingTokenSupport] = overlapping_token_support if overlapping_token_support
-          @attributes[:multilineTokenSupport] = multiline_token_support if multiline_token_support
-          @attributes[:serverCancelSupport] = server_cancel_support if server_cancel_support
-          @attributes[:augmentsSyntaxTokens] = augments_syntax_tokens if augments_syntax_tokens
+          @attributes[:overlappingTokenSupport] = overlapping_token_support unless overlapping_token_support.nil?
+          @attributes[:multilineTokenSupport] = multiline_token_support unless multiline_token_support.nil?
+          @attributes[:serverCancelSupport] = server_cancel_support unless server_cancel_support.nil?
+          @attributes[:augmentsSyntaxTokens] = augments_syntax_tokens unless augments_syntax_tokens.nil?
 
           @attributes.freeze
         end
 
         #
-        # Whether implementation supports dynamic registration. If this is set to
-        # `true` the client supports the new `(TextDocumentRegistrationOptions &
-        # StaticRegistrationOptions)` 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 `(TextDocumentRegistrationOptions & StaticRegistrationOptions)`
+        # return value for the corresponding server capability as well.
         #
         # @return [boolean]
         def dynamic_registration
@@ -39,7 +41,7 @@ module LanguageServer
         # range provider the client might not render a minimap correctly or might
         # even decide to not show any semantic tokens at all.
         #
-        # @return [{ range?: boolean | {}; full?: boolean | { delta?: boolean; }; }]
+        # @return [ClientSemanticTokensRequestOptions]
         def requests
           attributes.fetch(:requests)
         end
@@ -61,9 +63,9 @@ module LanguageServer
         end
 
         #
-        # The formats the clients supports.
+        # The token formats the clients supports.
         #
-        # @return ["relative"[]]
+        # @return [TokenFormat[]]
         def formats
           attributes.fetch(:formats)
         end
@@ -87,9 +89,11 @@ module LanguageServer
         #
         # Whether the client allows the server to actively cancel a
         # semantic token request, e.g. supports returning
-        # ErrorCodes.ServerCancelled. If a server does the client
+        # LSPErrorCodes.ServerCancelled. If a server does the client
         # needs to retrigger the request.
         #
+        # @since 3.17.0
+        #
         # @return [boolean]
         def server_cancel_support
           attributes.fetch(:serverCancelSupport)
@@ -105,6 +109,8 @@ module LanguageServer
         # If the value is `undefined` then the client behavior is not
         # specified.
         #
+        # @since 3.17.0
+        #
         # @return [boolean]
         def augments_syntax_tokens
           attributes.fetch(:augmentsSyntaxTokens)

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

@@ -1,11 +1,14 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensDelta
         def initialize(result_id: nil, edits:)
           @attributes = {}
 
-          @attributes[:resultId] = result_id if result_id
+          @attributes[:resultId] = result_id unless result_id.nil?
           @attributes[:edits] = edits
 
           @attributes.freeze
@@ -17,8 +20,7 @@ module LanguageServer
         end
 
         #
-        # The semantic token edits to transform a previous result into a new
-        # result.
+        # The semantic token edits to transform a previous result into a new result.
         #
         # @return [SemanticTokensEdit[]]
         def edits

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

@@ -1,50 +1,53 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensDeltaParams
-        def initialize(work_done_token: nil, partial_result_token: nil, text_document:, previous_result_id:)
+        def initialize(text_document:, previous_result_id:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
 
-          @attributes[:workDoneToken] = work_done_token if work_done_token
-          @attributes[:partialResultToken] = partial_result_token if partial_result_token
           @attributes[:textDocument] = text_document
           @attributes[:previousResultId] = previous_result_id
+          @attributes[:workDoneToken] = work_done_token unless work_done_token.nil?
+          @attributes[:partialResultToken] = partial_result_token unless partial_result_token.nil?
 
           @attributes.freeze
         end
 
         #
-        # An optional token that a server can use to report work done progress.
+        # The text document.
         #
-        # @return [ProgressToken]
-        def work_done_token
-          attributes.fetch(:workDoneToken)
+        # @return [TextDocumentIdentifier]
+        def text_document
+          attributes.fetch(:textDocument)
         end
 
         #
-        # An optional token that a server can use to report partial results (e.g.
-        # streaming) to the client.
+        # The result id of a previous response. The result Id can either point to a full response
+        # or a delta response depending on what was received last.
         #
-        # @return [ProgressToken]
-        def partial_result_token
-          attributes.fetch(:partialResultToken)
+        # @return [string]
+        def previous_result_id
+          attributes.fetch(:previousResultId)
         end
 
         #
-        # The text document.
+        # An optional token that a server can use to report work done progress.
         #
-        # @return [TextDocumentIdentifier]
-        def text_document
-          attributes.fetch(:textDocument)
+        # @return [ProgressToken]
+        def work_done_token
+          attributes.fetch(:workDoneToken)
         end
 
         #
-        # The result id of a previous response. The result Id can either point to
-        # a full response or a delta response depending on what was received last.
+        # An optional token that a server can use to report partial results (e.g. streaming) to
+        # the client.
         #
-        # @return [string]
-        def previous_result_id
-          attributes.fetch(:previousResultId)
+        # @return [ProgressToken]
+        def partial_result_token
+          attributes.fetch(:partialResultToken)
         end
 
         attr_reader :attributes

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensDeltaPartialResult
         def initialize(edits:)
           @attributes = {}

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

@@ -1,13 +1,16 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensEdit
         def initialize(start:, delete_count:, data: nil)
           @attributes = {}
 
           @attributes[:start] = start
           @attributes[:deleteCount] = delete_count
-          @attributes[:data] = data if data
+          @attributes[:data] = data unless data.nil?
 
           @attributes.freeze
         end
@@ -15,7 +18,7 @@ module LanguageServer
         #
         # The start offset of the edit.
         #
-        # @return [number]
+        # @return [uinteger]
         def start
           attributes.fetch(:start)
         end
@@ -23,7 +26,7 @@ module LanguageServer
         #
         # The count of elements to remove.
         #
-        # @return [number]
+        # @return [uinteger]
         def delete_count
           attributes.fetch(:deleteCount)
         end
@@ -31,7 +34,7 @@ module LanguageServer
         #
         # The elements to insert.
         #
-        # @return [number[]]
+        # @return [uinteger[]]
         def data
           attributes.fetch(:data)
         end

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

@@ -0,0 +1,38 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Semantic tokens options to support deltas for full documents
+      #
+      # @since 3.18.0
+      #
+      class SemanticTokensFullDelta
+        def initialize(delta: nil)
+          @attributes = {}
+
+          @attributes[:delta] = delta unless delta.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # The server supports deltas for full documents.
+        #
+        # @return [boolean]
+        def delta
+          attributes.fetch(:delta)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensLegend
         def initialize(token_types:, token_modifiers:)
           @attributes = {}

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

@@ -1,23 +1,21 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # @since 3.16.0
+      #
       class SemanticTokensOptions
-        def initialize(work_done_progress: nil, legend:, range: nil, full: nil)
+        def initialize(legend:, range: nil, full: nil, work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:legend] = legend
-          @attributes[:range] = range if range
-          @attributes[:full] = full if full
+          @attributes[:range] = range unless range.nil?
+          @attributes[:full] = full unless full.nil?
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
 
           @attributes.freeze
         end
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # The legend used by the server
         #
@@ -30,7 +28,7 @@ module LanguageServer
         # Server supports providing semantic tokens for a specific range
         # of a document.
         #
-        # @return [boolean | {}]
+        # @return [boolean | { ; }]
         def range
           attributes.fetch(:range)
         end
@@ -38,11 +36,16 @@ module LanguageServer
         #
         # Server supports providing semantic tokens for a full document.
         #
-        # @return [boolean | { delta?: boolean; }]
+        # @return [boolean | SemanticTokensFullDelta]
         def full
           attributes.fetch(:full)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash