language_server-protocol 3.17.0.5 → 3.17.0.6

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Registration options for a {@link DocumentHighlightRequest}.
+      #
       class DocumentHighlightRegistrationOptions
         def initialize(document_selector:, work_done_progress: nil)
           @attributes = {}
@@ -12,10 +15,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/document_link.rb

@@ -2,8 +2,8 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # 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.
+      # 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.
       #
       class DocumentLink
         def initialize(range:, target: nil, tooltip: nil, data: nil)
@@ -36,10 +36,11 @@ module LanguageServer
         #
         # The tooltip text when you hover over this link.
         #
-        # If a tooltip is provided, is will be displayed in a string that includes
-        # instructions on how to trigger the link, such as `{0} (ctrl + click)`.
-        # The specific instructions vary depending on OS, user settings, and
-        # localization.
+        # If a tooltip is provided, is will be displayed in a string that includes instructions on how to
+        # trigger the link, such as `{0} (ctrl + click)`. The specific instructions vary depending on OS,
+        # user settings, and localization.
+        #
+        # @since 3.15.0
         #
         # @return [string]
         def tooltip

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The client capabilities of a {@link DocumentLinkRequest}.
+      #
       class DocumentLinkClientCapabilities
         def initialize(dynamic_registration: nil, tooltip_support: nil)
           @attributes = {}
@@ -22,6 +25,8 @@ module LanguageServer
         #
         # Whether the client supports the `tooltip` property on `DocumentLink`.
         #
+        # @since 3.15.0
+        #
         # @return [boolean]
         def tooltip_support
           attributes.fetch(:tooltipSupport)

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

@@ -1,21 +1,19 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Provider options for a {@link DocumentLinkRequest}.
+      #
       class DocumentLinkOptions
-        def initialize(work_done_progress: nil, resolve_provider: nil)
+        def initialize(resolve_provider: nil, work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:resolveProvider] = resolve_provider if resolve_provider
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @attributes.freeze
         end
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # Document links have a resolve provider as well.
         #
@@ -24,6 +22,11 @@ module LanguageServer
           attributes.fetch(:resolveProvider)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -1,17 +1,28 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The parameters of a {@link DocumentLinkRequest}.
+      #
       class DocumentLinkParams
-        def initialize(work_done_token: nil, partial_result_token: nil, text_document:)
+        def initialize(text_document:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
 
+          @attributes[:textDocument] = text_document
           @attributes[:workDoneToken] = work_done_token if work_done_token
           @attributes[:partialResultToken] = partial_result_token if partial_result_token
-          @attributes[:textDocument] = text_document
 
           @attributes.freeze
         end
 
+        #
+        # The document to provide document links for.
+        #
+        # @return [TextDocumentIdentifier]
+        def text_document
+          attributes.fetch(:textDocument)
+        end
+
         #
         # An optional token that a server can use to report work done progress.
         #
@@ -21,22 +32,14 @@ module LanguageServer
         end
 
         #
-        # An optional token that a server can use to report partial results (e.g.
-        # streaming) to the client.
+        # 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 document to provide document links for.
-        #
-        # @return [TextDocumentIdentifier]
-        def text_document
-          attributes.fetch(:textDocument)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -1,31 +1,29 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Registration options for a {@link DocumentLinkRequest}.
+      #
       class DocumentLinkRegistrationOptions
-        def initialize(document_selector:, work_done_progress: nil, resolve_provider: nil)
+        def initialize(document_selector:, resolve_provider: nil, work_done_progress: nil)
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:resolveProvider] = resolve_provider if resolve_provider
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @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
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # Document links have a resolve provider as well.
         #
@@ -34,6 +32,11 @@ module LanguageServer
           attributes.fetch(:resolveProvider)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client capabilities of a {@link DocumentOnTypeFormattingRequest}.
+      #
       class DocumentOnTypeFormattingClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Provider options for a {@link DocumentOnTypeFormattingRequest}.
+      #
       class DocumentOnTypeFormattingOptions
         def initialize(first_trigger_character:, more_trigger_character: nil)
           @attributes = {}

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The parameters of a {@link DocumentOnTypeFormattingRequest}.
+      #
       class DocumentOnTypeFormattingParams
         def initialize(text_document:, position:, ch:, options:)
           @attributes = {}

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Registration options for a {@link DocumentOnTypeFormattingRequest}.
+      #
       class DocumentOnTypeFormattingRegistrationOptions
         def initialize(document_selector:, first_trigger_character:, more_trigger_character: nil)
           @attributes = {}
@@ -13,10 +16,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/document_range_formatting_client_capabilities.rb

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client capabilities of a {@link DocumentRangeFormattingRequest}.
+      #
       class DocumentRangeFormattingClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}
@@ -11,7 +14,7 @@ module LanguageServer
         end
 
         #
-        # Whether formatting supports dynamic registration.
+        # Whether range formatting supports dynamic registration.
         #
         # @return [boolean]
         def dynamic_registration

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Provider options for a {@link DocumentRangeFormattingRequest}.
+      #
       class DocumentRangeFormattingOptions
         def initialize(work_done_progress: nil)
           @attributes = {}

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

@@ -1,26 +1,21 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The parameters of a {@link DocumentRangeFormattingRequest}.
+      #
       class DocumentRangeFormattingParams
-        def initialize(work_done_token: nil, text_document:, range:, options:)
+        def initialize(text_document:, range:, options:, work_done_token: nil)
           @attributes = {}
 
-          @attributes[:workDoneToken] = work_done_token if work_done_token
           @attributes[:textDocument] = text_document
           @attributes[:range] = range
           @attributes[:options] = options
+          @attributes[:workDoneToken] = work_done_token if work_done_token
 
           @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 document to format.
         #
@@ -45,6 +40,14 @@ module LanguageServer
           attributes.fetch(:options)
         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/document_range_formatting_registration_options.rb

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Registration options for a {@link DocumentRangeFormattingRequest}.
+      #
       class DocumentRangeFormattingRegistrationOptions
         def initialize(document_selector:, work_done_progress: nil)
           @attributes = {}
@@ -12,10 +15,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/document_symbol.rb

@@ -4,8 +4,8 @@ module LanguageServer
       #
       # 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.
+      # have two ranges: one that encloses its definition and one that points to
+      # its most interesting range, e.g. the range of an identifier.
       #
       class DocumentSymbol
         def initialize(name:, detail: nil, kind:, tags: nil, deprecated: nil, range:, selection_range:, children: nil)
@@ -24,9 +24,8 @@ module LanguageServer
         end
 
         #
-        # 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.
+        # 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.
         #
         # @return [string]
         def name
@@ -52,7 +51,9 @@ module LanguageServer
         #
         # Tags for this document symbol.
         #
-        # @return [1[]]
+        # @since 3.16.0
+        #
+        # @return [SymbolTag[]]
         def tags
           attributes.fetch(:tags)
         end
@@ -60,16 +61,17 @@ module LanguageServer
         #
         # Indicates if this symbol is deprecated.
         #
+        # @deprecated Use tags instead
+        #
         # @return [boolean]
         def deprecated
           attributes.fetch(:deprecated)
         end
 
         #
-        # 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.
+        # 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.
         #
         # @return [Range]
         def range
@@ -77,8 +79,8 @@ module LanguageServer
         end
 
         #
-        # 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`.
+        # 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`.
         #
         # @return [Range]
         def selection_range

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client Capabilities for a {@link DocumentSymbolRequest}.
+      #
       class DocumentSymbolClientCapabilities
         def initialize(dynamic_registration: nil, symbol_kind: nil, hierarchical_document_symbol_support: nil, tag_support: nil, label_support: nil)
           @attributes = {}
@@ -44,7 +47,9 @@ module LanguageServer
         # `DocumentSymbol` if `hierarchicalDocumentSymbolSupport` is set to true.
         # Clients supporting tags have to handle unknown tags gracefully.
         #
-        # @return [{ valueSet: 1[]; }]
+        # @since 3.16.0
+        #
+        # @return [{ valueSet: SymbolTag[]; }]
         def tag_support
           attributes.fetch(:tagSupport)
         end
@@ -53,6 +58,8 @@ module LanguageServer
         # The client supports an additional label presented in the UI when
         # registering a document symbol provider.
         #
+        # @since 3.16.0
+        #
         # @return [boolean]
         def label_support
           attributes.fetch(:labelSupport)

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

@@ -1,30 +1,35 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Provider options for a {@link DocumentSymbolRequest}.
+      #
       class DocumentSymbolOptions
-        def initialize(work_done_progress: nil, label: nil)
+        def initialize(label: nil, work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:label] = label if label
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @attributes.freeze
         end
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # A human-readable string that is shown when multiple outlines trees
         # are shown for the same document.
         #
+        # @since 3.16.0
+        #
         # @return [string]
         def label
           attributes.fetch(:label)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -1,17 +1,28 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Parameters for a {@link DocumentSymbolRequest}.
+      #
       class DocumentSymbolParams
-        def initialize(work_done_token: nil, partial_result_token: nil, text_document:)
+        def initialize(text_document:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
 
+          @attributes[:textDocument] = text_document
           @attributes[:workDoneToken] = work_done_token if work_done_token
           @attributes[:partialResultToken] = partial_result_token if partial_result_token
-          @attributes[:textDocument] = text_document
 
           @attributes.freeze
         end
 
+        #
+        # The text document.
+        #
+        # @return [TextDocumentIdentifier]
+        def text_document
+          attributes.fetch(:textDocument)
+        end
+
         #
         # An optional token that a server can use to report work done progress.
         #
@@ -21,22 +32,14 @@ module LanguageServer
         end
 
         #
-        # An optional token that a server can use to report partial results (e.g.
-        # streaming) to the client.
+        # 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.
-        #
-        # @return [TextDocumentIdentifier]
-        def text_document
-          attributes.fetch(:textDocument)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -1,40 +1,45 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Registration options for a {@link DocumentSymbolRequest}.
+      #
       class DocumentSymbolRegistrationOptions
-        def initialize(document_selector:, work_done_progress: nil, label: nil)
+        def initialize(document_selector:, label: nil, work_done_progress: nil)
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:label] = label if label
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @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
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # A human-readable string that is shown when multiple outlines trees
         # are shown for the same document.
         #
+        # @since 3.16.0
+        #
         # @return [string]
         def label
           attributes.fetch(:label)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The client capabilities of a {@link ExecuteCommandRequest}.
+      #
       class ExecuteCommandClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}

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

@@ -1,21 +1,19 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The server capabilities of a {@link ExecuteCommandRequest}.
+      #
       class ExecuteCommandOptions
-        def initialize(work_done_progress: nil, commands:)
+        def initialize(commands:, work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:commands] = commands
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @attributes.freeze
         end
 
-        # @return [boolean]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         #
         # The commands to be executed on the server
         #
@@ -24,6 +22,11 @@ module LanguageServer
           attributes.fetch(:commands)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         attr_reader :attributes
 
         def to_hash