language_server-protocol 3.17.0.5 → 3.18.0.0.pre.1

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

@@ -4,26 +4,20 @@ module LanguageServer
       #
       # A parameter literal used in inline value requests.
       #
+      # @since 3.17.0
+      #
       class InlineValueParams
-        def initialize(work_done_token: nil, text_document:, range:, context:)
+        def initialize(text_document:, range:, context:, work_done_token: nil)
           @attributes = {}
 
-          @attributes[:workDoneToken] = work_done_token if work_done_token
           @attributes[:textDocument] = text_document
           @attributes[:range] = range
           @attributes[:context] = context
+          @attributes[:workDoneToken] = work_done_token unless work_done_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
-
         #
         # The text document.
         #
@@ -33,7 +27,7 @@ module LanguageServer
         end
 
         #
-        # The document range for which inline values should be computed.
+        # The document range for which inline values information will be returned.
         #
         # @return [Range]
         def range
@@ -41,7 +35,7 @@ module LanguageServer
         end
 
         #
-        # Additional information about the context in which inline values were
+        # Additional information about the context in which inline values information was
         # requested.
         #
         # @return [InlineValueContext]
@@ -49,6 +43,14 @@ module LanguageServer
           attributes.fetch(:context)
         end
 
+        #
+        # An optional token that a server can use to report work done progress.
+        #
+        # @return [ProgressToken]
+        def work_done_token
+          attributes.fetch(:workDoneToken)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -4,13 +4,15 @@ module LanguageServer
       #
       # Inline value options used during static or dynamic registration.
       #
+      # @since 3.17.0
+      #
       class InlineValueRegistrationOptions
         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
@@ -21,10 +23,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/inline_value_text.rb

@@ -2,7 +2,9 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Provide inline value as text.
+      # Returns inline value information as the complete text to be shown.
+      #
+      # @since 3.17.0
       #
       class InlineValueText
         def initialize(range:, text:)

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

@@ -2,19 +2,22 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Provide inline value through a variable lookup.
+      # To compute inline value through a variable lookup.
       #
-      # If only a range is specified, the variable name will be extracted from
-      # the underlying document.
+      # If only a range is specified, the variable name should
+      # be extracted from the underlying document.
       #
-      # An optional variable name can be used to override the extracted name.
+      # An optional variable name could be used to lookup instead
+      # of the extracted name.
+      #
+      # @since 3.17.0
       #
       class InlineValueVariableLookup
         def initialize(range:, variable_name: nil, case_sensitive_lookup:)
           @attributes = {}
 
           @attributes[:range] = range
-          @attributes[:variableName] = variable_name if variable_name
+          @attributes[:variableName] = variable_name unless variable_name.nil?
           @attributes[:caseSensitiveLookup] = case_sensitive_lookup
 
           @attributes.freeze
@@ -22,8 +25,9 @@ module LanguageServer
 
         #
         # The document range for which the inline value applies.
-        # The range is used to extract the variable name from the underlying
-        # document.
+        #
+        # The range could be used to extract the variable name
+        # from the underlying document.
         #
         # @return [Range]
         def range

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

@@ -4,22 +4,24 @@ module LanguageServer
       #
       # Client workspace capabilities specific to inline values.
       #
+      # @since 3.17.0
+      #
       class InlineValueWorkspaceClientCapabilities
         def initialize(refresh_support: nil)
           @attributes = {}
 
-          @attributes[:refreshSupport] = refresh_support if refresh_support
+          @attributes[:refreshSupport] = refresh_support unless refresh_support.nil?
 
           @attributes.freeze
         end
 
         #
-        # Whether the client implementation supports a refresh request sent from
-        # the server to the client.
+        # Whether the client implementation supports a refresh request sent from the
+        # server to the client.
         #
         # Note that this event is global and will force the client to refresh all
-        # inline values currently shown. It should be used with absolute care and
-        # is useful for situation where a server for example detect a project wide
+        # inline values currently shown. It should be used with absolute care and is
+        # useful for situation where a server for example detects a project wide
         # change that requires such a calculation.
         #
         # @return [boolean]

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

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # A special text edit to provide an insert and a replace operation.
       #
+      # @since 3.16.0
+      #
       class InsertReplaceEdit
         def initialize(new_text:, insert:, replace:)
           @attributes = {}

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

@@ -1,19 +1,23 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client capabilities for the linked editing range request.
+      #
+      # @since 3.16.0
+      #
       class LinkedEditingRangeClientCapabilities
         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 the implementation supports dynamic registration.
-        # If this is set to `true` the client supports the new
-        # `(TextDocumentRegistrationOptions & StaticRegistrationOptions)`
+        # 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]

data/lib/language_server/protocol/interface/linked_editing_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/linked_editing_range_params.rb

@@ -7,7 +7,7 @@ module LanguageServer
 
           @attributes[:textDocument] = text_document
           @attributes[:position] = position
-          @attributes[:workDoneToken] = work_done_token if work_done_token
+          @attributes[:workDoneToken] = work_done_token unless work_done_token.nil?
 
           @attributes.freeze
         end

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

@@ -6,17 +6,17 @@ module LanguageServer
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
-          @attributes[:id] = id if id
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
+          @attributes[:id] = id unless id.nil?
 
           @attributes.freeze
         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/linked_editing_ranges.rb

@@ -1,20 +1,24 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The result of a linked editing range request.
+      #
+      # @since 3.16.0
+      #
       class LinkedEditingRanges
         def initialize(ranges:, word_pattern: nil)
           @attributes = {}
 
           @attributes[:ranges] = ranges
-          @attributes[:wordPattern] = word_pattern if word_pattern
+          @attributes[:wordPattern] = word_pattern unless word_pattern.nil?
 
           @attributes.freeze
         end
 
         #
-        # A list of ranges that can be renamed together. The ranges must have
-        # identical length and contain identical text content. The ranges cannot
-        # overlap.
+        # A list of ranges that can be edited together. The ranges must have
+        # identical length and contain identical text content. The ranges cannot overlap.
         #
         # @return [Range[]]
         def ranges
@@ -22,9 +26,9 @@ module LanguageServer
         end
 
         #
-        # An optional word pattern (regular expression) that describes valid
-        # contents for the given ranges. If no pattern is provided, the client
-        # configuration's word pattern will be used.
+        # An optional word pattern (regular expression) that describes valid contents for
+        # the given ranges. If no pattern is provided, the client configuration's word
+        # pattern will be used.
         #
         # @return [string]
         def word_pattern

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

@@ -1,6 +1,10 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Represents a location inside a resource, such as a line
+      # inside a text file.
+      #
       class Location
         def initialize(uri:, range:)
           @attributes = {}
@@ -11,7 +15,7 @@ module LanguageServer
           @attributes.freeze
         end
 
-        # @return [string]
+        # @return [DocumentUri]
         def uri
           attributes.fetch(:uri)
         end

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

@@ -1,11 +1,15 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Represents the connection of two locations. Provides additional metadata over normal {@link Location locations},
+      # including an origin range.
+      #
       class LocationLink
         def initialize(origin_selection_range: nil, target_uri:, target_range:, target_selection_range:)
           @attributes = {}
 
-          @attributes[:originSelectionRange] = origin_selection_range if origin_selection_range
+          @attributes[:originSelectionRange] = origin_selection_range unless origin_selection_range.nil?
           @attributes[:targetUri] = target_uri
           @attributes[:targetRange] = target_range
           @attributes[:targetSelectionRange] = target_selection_range
@@ -16,8 +20,8 @@ module LanguageServer
         #
         # Span of the origin of this link.
         #
-        # Used as the underlined span for mouse interaction. Defaults to the word
-        # range at the mouse position.
+        # Used as the underlined span for mouse interaction. Defaults to the word range at
+        # the definition position.
         #
         # @return [Range]
         def origin_selection_range
@@ -27,16 +31,15 @@ module LanguageServer
         #
         # The target resource identifier of this link.
         #
-        # @return [string]
+        # @return [DocumentUri]
         def target_uri
           attributes.fetch(:targetUri)
         end
 
         #
-        # 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.
+        # 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.
         #
         # @return [Range]
         def target_range
@@ -44,9 +47,8 @@ module LanguageServer
         end
 
         #
-        # 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
-        # `targetRange`. See also `DocumentSymbol#range`
+        # 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 `targetRange`. See also `DocumentSymbol#range`
         #
         # @return [Range]
         def target_selection_range

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

@@ -0,0 +1,35 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Location with only uri and does not include range.
+      #
+      # @since 3.18.0
+      #
+      class LocationUriOnly
+        def initialize(uri:)
+          @attributes = {}
+
+          @attributes[:uri] = uri
+
+          @attributes.freeze
+        end
+
+        # @return [DocumentUri]
+        def uri
+          attributes.fetch(:uri)
+        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/log_message_params.rb

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The log message parameters.
+      #
       class LogMessageParams
         def initialize(type:, message:)
           @attributes = {}
@@ -20,7 +23,7 @@ module LanguageServer
         end
 
         #
-        # The actual message
+        # The actual message.
         #
         # @return [string]
         def message

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

@@ -6,23 +6,16 @@ module LanguageServer
           @attributes = {}
 
           @attributes[:message] = message
-          @attributes[:verbose] = verbose if verbose
+          @attributes[:verbose] = verbose unless verbose.nil?
 
           @attributes.freeze
         end
 
-        #
-        # The message to be logged.
-        #
         # @return [string]
         def message
           attributes.fetch(:message)
         end
 
-        #
-        # Additional information that can be computed if the `trace` configuration
-        # is set to `'verbose'`
-        #
         # @return [string]
         def verbose
           attributes.fetch(:verbose)

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

@@ -0,0 +1,59 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Client capabilities specific to the used markdown parser.
+      #
+      # @since 3.16.0
+      #
+      class MarkdownClientCapabilities
+        def initialize(parser:, version: nil, allowed_tags: nil)
+          @attributes = {}
+
+          @attributes[:parser] = parser
+          @attributes[:version] = version unless version.nil?
+          @attributes[:allowedTags] = allowed_tags unless allowed_tags.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # The name of the parser.
+        #
+        # @return [string]
+        def parser
+          attributes.fetch(:parser)
+        end
+
+        #
+        # The version of the parser.
+        #
+        # @return [string]
+        def version
+          attributes.fetch(:version)
+        end
+
+        #
+        # A list of HTML tags that the client allows / supports in
+        # Markdown.
+        #
+        # @since 3.17.0
+        #
+        # @return [string[]]
+        def allowed_tags
+          attributes.fetch(:allowedTags)
+        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/marked_string_with_language.rb

@@ -0,0 +1,40 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # @since 3.18.0
+      # @deprecated use MarkupContent instead.
+      #
+      class MarkedStringWithLanguage
+        def initialize(language:, value:)
+          @attributes = {}
+
+          @attributes[:language] = language
+          @attributes[:value] = value
+
+          @attributes.freeze
+        end
+
+        # @return [string]
+        def language
+          attributes.fetch(:language)
+        end
+
+        # @return [string]
+        def value
+          attributes.fetch(:value)
+        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/markup_content.rb

@@ -2,30 +2,28 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # 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.
+      # 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.
+      # 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
+      # Here is an example how such a string can be constructed using JavaScript / TypeScript:
+      # ```ts
       # let markdown: MarkdownContent = {
-      # kind: MarkupKind.Markdown,
-      # value: [
-      # '# Header',
-      # 'Some text',
-      # '```typescript',
-      # 'someCode();',
-      # '```'
-      # ].join('\n')
+      #  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.
+      # *Please Note* that clients might sanitize the return markdown. A client could decide to
+      # remove HTML from the markdown to avoid script execution.
       #
       class MarkupContent
         def initialize(kind:, value:)

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

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # Moniker definition to match LSIF 0.5 moniker definition.
       #
+      # @since 3.16.0
+      #
       class Moniker
         def initialize(scheme:, identifier:, unique:, kind: nil)
           @attributes = {}
@@ -11,7 +13,7 @@ module LanguageServer
           @attributes[:scheme] = scheme
           @attributes[:identifier] = identifier
           @attributes[:unique] = unique
-          @attributes[:kind] = kind if kind
+          @attributes[:kind] = kind unless kind.nil?
 
           @attributes.freeze
         end

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

@@ -1,20 +1,24 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client capabilities specific to the moniker request.
+      #
+      # @since 3.16.0
+      #
       class MonikerClientCapabilities
         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. If this is set to
-        # `true` the client supports the new `(TextDocumentRegistrationOptions &
-        # StaticRegistrationOptions)` return value for the corresponding server
-        # capability as well.
+        # Whether moniker supports dynamic registration. If this is set to `true`
+        # the client supports the new `MonikerRegistrationOptions` return value
+        # for the corresponding server capability as well.
         #
         # @return [boolean]
         def dynamic_registration

data/lib/language_server/protocol/interface/moniker_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