language_server-protocol 3.17.0.0 → 3.17.0.1

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Parameters for a [DocumentHighlightRequest](#DocumentHighlightRequest).
-      #
       class DocumentHighlightParams
         def initialize(text_document:, position:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
@@ -35,16 +32,16 @@ module LanguageServer
         #
         # An optional token that a server can use to report work done progress.
         #
-        # @return [ProgressToken | nil]
+        # @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.
+        # An optional token that a server can use to report partial results (e.g.
+        # streaming) to the client.
         #
-        # @return [ProgressToken | nil]
+        # @return [ProgressToken]
         def partial_result_token
           attributes.fetch(:partialResultToken)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [DocumentHighlightRequest](#DocumentHighlightRequest).
-      #
       class DocumentHighlightRegistrationOptions
         def initialize(document_selector:, work_done_progress: nil)
           @attributes = {}
@@ -15,15 +12,15 @@ 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 | null]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end
 
-        # @return [boolean | nil]
+        # @return [boolean]
         def work_done_progress
           attributes.fetch(:workDoneProgress)
         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)
@@ -28,7 +28,7 @@ module LanguageServer
         #
         # The uri this link points to. If missing a resolve request is sent later.
         #
-        # @return [string | nil]
+        # @return [string]
         def target
           attributes.fetch(:target)
         end
@@ -36,13 +36,12 @@ 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 | nil]
+        # @return [string]
         def tooltip
           attributes.fetch(:tooltip)
         end
@@ -51,7 +50,7 @@ module LanguageServer
         # A data entry field that is preserved on a document link between a
         # DocumentLinkRequest and a DocumentLinkResolveRequest.
         #
-        # @return [LSPAny | nil]
+        # @return [LSPAny]
         def data
           attributes.fetch(:data)
         end

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

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

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

@@ -1,32 +1,29 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Provider options for a [DocumentLinkRequest](#DocumentLinkRequest).
-      #
       class DocumentLinkOptions
-        def initialize(resolve_provider: nil, work_done_progress: nil)
+        def initialize(work_done_progress: nil, resolve_provider: nil)
           @attributes = {}
 
-          @attributes[:resolveProvider] = resolve_provider if resolve_provider
           @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+          @attributes[:resolveProvider] = resolve_provider if resolve_provider
 
           @attributes.freeze
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         #
         # Document links have a resolve provider as well.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def resolve_provider
           attributes.fetch(:resolveProvider)
         end
 
-        # @return [boolean | nil]
-        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,45 +1,42 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The parameters of a [DocumentLinkRequest](#DocumentLinkRequest).
-      #
       class DocumentLinkParams
-        def initialize(text_document:, work_done_token: nil, partial_result_token: nil)
+        def initialize(work_done_token: nil, partial_result_token: nil, text_document:)
           @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.
         #
-        # @return [ProgressToken | nil]
+        # @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.
+        # An optional token that a server can use to report partial results (e.g.
+        # streaming) to the client.
         #
-        # @return [ProgressToken | nil]
+        # @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,42 +1,39 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [DocumentLinkRequest](#DocumentLinkRequest).
-      #
       class DocumentLinkRegistrationOptions
-        def initialize(document_selector:, resolve_provider: nil, work_done_progress: nil)
+        def initialize(document_selector:, work_done_progress: nil, resolve_provider: nil)
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
-          @attributes[:resolveProvider] = resolve_provider if resolve_provider
           @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+          @attributes[:resolveProvider] = resolve_provider if resolve_provider
 
           @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 | null]
+        # @return [DocumentSelector]
         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.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def resolve_provider
           attributes.fetch(:resolveProvider)
         end
 
-        # @return [boolean | nil]
-        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,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Client capabilities of a [DocumentOnTypeFormattingRequest](#DocumentOnTypeFormattingRequest).
-      #
       class DocumentOnTypeFormattingClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}
@@ -16,7 +13,7 @@ module LanguageServer
         #
         # Whether on type formatting supports dynamic registration.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Provider options for a [DocumentOnTypeFormattingRequest](#DocumentOnTypeFormattingRequest).
-      #
       class DocumentOnTypeFormattingOptions
         def initialize(first_trigger_character:, more_trigger_character: nil)
           @attributes = {}
@@ -25,7 +22,7 @@ module LanguageServer
         #
         # More trigger characters.
         #
-        # @return [string[] | nil]
+        # @return [string[]]
         def more_trigger_character
           attributes.fetch(:moreTriggerCharacter)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The parameters of a [DocumentOnTypeFormattingRequest](#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,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [DocumentOnTypeFormattingRequest](#DocumentOnTypeFormattingRequest).
-      #
       class DocumentOnTypeFormattingRegistrationOptions
         def initialize(document_selector:, first_trigger_character:, more_trigger_character: nil)
           @attributes = {}
@@ -16,10 +13,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 | null]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end
@@ -35,7 +32,7 @@ module LanguageServer
         #
         # More trigger characters.
         #
-        # @return [string[] | nil]
+        # @return [string[]]
         def more_trigger_character
           attributes.fetch(:moreTriggerCharacter)
         end

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

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

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Provider options for a [DocumentRangeFormattingRequest](#DocumentRangeFormattingRequest).
-      #
       class DocumentRangeFormattingOptions
         def initialize(work_done_progress: nil)
           @attributes = {}
@@ -13,7 +10,7 @@ module LanguageServer
           @attributes.freeze
         end
 
-        # @return [boolean | nil]
+        # @return [boolean]
         def work_done_progress
           attributes.fetch(:workDoneProgress)
         end

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

@@ -1,21 +1,26 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The parameters of a [DocumentRangeFormattingRequest](#DocumentRangeFormattingRequest).
-      #
       class DocumentRangeFormattingParams
-        def initialize(text_document:, range:, options:, work_done_token: nil)
+        def initialize(work_done_token: nil, text_document:, range:, options:)
           @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.
         #
@@ -40,14 +45,6 @@ module LanguageServer
           attributes.fetch(:options)
         end
 
-        #
-        # An optional token that a server can use to report work done progress.
-        #
-        # @return [ProgressToken | nil]
-        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,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [DocumentRangeFormattingRequest](#DocumentRangeFormattingRequest).
-      #
       class DocumentRangeFormattingRegistrationOptions
         def initialize(document_selector:, work_done_progress: nil)
           @attributes = {}
@@ -15,15 +12,15 @@ 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 | null]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end
 
-        # @return [boolean | nil]
+        # @return [boolean]
         def work_done_progress
           attributes.fetch(:workDoneProgress)
         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,8 +24,9 @@ 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
@@ -35,7 +36,7 @@ module LanguageServer
         #
         # More detail for this symbol, e.g the signature of a function.
         #
-        # @return [string | nil]
+        # @return [string]
         def detail
           attributes.fetch(:detail)
         end
@@ -51,9 +52,7 @@ module LanguageServer
         #
         # Tags for this document symbol.
         #
-        # @since 3.16.0
-        #
-        # @return [SymbolTag[] | nil]
+        # @return [1[]]
         def tags
           attributes.fetch(:tags)
         end
@@ -61,17 +60,16 @@ module LanguageServer
         #
         # Indicates if this symbol is deprecated.
         #
-        # @deprecated Use tags instead
-        #
-        # @return [boolean | nil]
+        # @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
@@ -79,8 +77,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
@@ -90,7 +88,7 @@ module LanguageServer
         #
         # Children of this symbol, e.g. properties of a class.
         #
-        # @return [DocumentSymbol[] | nil]
+        # @return [DocumentSymbol[]]
         def children
           attributes.fetch(:children)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Client Capabilities for a [DocumentSymbolRequest](#DocumentSymbolRequest).
-      #
       class DocumentSymbolClientCapabilities
         def initialize(dynamic_registration: nil, symbol_kind: nil, hierarchical_document_symbol_support: nil, tag_support: nil, label_support: nil)
           @attributes = {}
@@ -20,7 +17,7 @@ module LanguageServer
         #
         # Whether document symbol supports dynamic registration.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end
@@ -29,7 +26,7 @@ module LanguageServer
         # Specific capabilities for the `SymbolKind` in the
         # `textDocument/documentSymbol` request.
         #
-        # @return [{ valueSet:SymbolKind[] } | nil]
+        # @return [{ valueSet?: SymbolKind[]; }]
         def symbol_kind
           attributes.fetch(:symbolKind)
         end
@@ -37,7 +34,7 @@ module LanguageServer
         #
         # The client supports hierarchical document symbols.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def hierarchical_document_symbol_support
           attributes.fetch(:hierarchicalDocumentSymbolSupport)
         end
@@ -47,9 +44,7 @@ module LanguageServer
         # `DocumentSymbol` if `hierarchicalDocumentSymbolSupport` is set to true.
         # Clients supporting tags have to handle unknown tags gracefully.
         #
-        # @since 3.16.0
-        #
-        # @return [{ valueSet:SymbolTag[] } | nil]
+        # @return [{ valueSet: 1[]; }]
         def tag_support
           attributes.fetch(:tagSupport)
         end
@@ -58,9 +53,7 @@ module LanguageServer
         # The client supports an additional label presented in the UI when
         # registering a document symbol provider.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def label_support
           attributes.fetch(:labelSupport)
         end