language_server-protocol 3.17.0.0 → 3.17.0.2

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

@@ -2,9 +2,8 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Additional information about the context in which a signature help request was triggered.
-      #
-      # @since 3.15.0
+      # Additional information about the context in which a signature help request
+      # was triggered.
       #
       class SignatureHelpContext
         def initialize(trigger_kind:, trigger_character: nil, is_retrigger:, active_signature_help: nil)
@@ -29,9 +28,10 @@ module LanguageServer
         #
         # Character that caused signature help to be triggered.
         #
-        # This is undefined when `triggerKind !== SignatureHelpTriggerKind.TriggerCharacter`
+        # This is undefined when triggerKind !==
+        # SignatureHelpTriggerKind.TriggerCharacter
         #
-        # @return [string | nil]
+        # @return [string]
         def trigger_character
           attributes.fetch(:triggerCharacter)
         end
@@ -39,8 +39,9 @@ module LanguageServer
         #
         # `true` if signature help was already showing when it was triggered.
         #
-        # Retriggers occurs when the signature help is already active and can be caused by actions such as
-        # typing a trigger character, a cursor move, or document content changes.
+        # Retriggers occur when the signature help is already active and can be
+        # caused by actions such as typing a trigger character, a cursor move, or
+        # document content changes.
         #
         # @return [boolean]
         def is_retrigger
@@ -50,10 +51,10 @@ module LanguageServer
         #
         # The currently active `SignatureHelp`.
         #
-        # The `activeSignatureHelp` has its `SignatureHelp.activeSignature` field updated based on
-        # the user navigating through available signatures.
+        # The `activeSignatureHelp` has its `SignatureHelp.activeSignature` field
+        # updated based on the user navigating through available signatures.
         #
-        # @return [SignatureHelp | nil]
+        # @return [SignatureHelp]
         def active_signature_help
           attributes.fetch(:activeSignatureHelp)
         end

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

@@ -1,24 +1,27 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Server Capabilities for a [SignatureHelpRequest](#SignatureHelpRequest).
-      #
       class SignatureHelpOptions
-        def initialize(trigger_characters: nil, retrigger_characters: nil, work_done_progress: nil)
+        def initialize(work_done_progress: nil, trigger_characters: nil, retrigger_characters: nil)
           @attributes = {}
 
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:triggerCharacters] = trigger_characters if trigger_characters
           @attributes[:retriggerCharacters] = retrigger_characters if retrigger_characters
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
 
           @attributes.freeze
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         #
-        # List of characters that trigger signature help automatically.
+        # The characters that trigger signature help
+        # automatically.
         #
-        # @return [string[] | nil]
+        # @return [string[]]
         def trigger_characters
           attributes.fetch(:triggerCharacters)
         end
@@ -26,21 +29,15 @@ module LanguageServer
         #
         # List of characters that re-trigger signature help.
         #
-        # These trigger characters are only active when signature help is already showing. All trigger characters
-        # are also counted as re-trigger characters.
+        # These trigger characters are only active when signature help is already
+        # showing. All trigger characters are also counted as re-trigger
+        # characters.
         #
-        # @since 3.15.0
-        #
-        # @return [string[] | nil]
+        # @return [string[]]
         def retrigger_characters
           attributes.fetch(:retriggerCharacters)
         end
 
-        # @return [boolean | nil]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -1,32 +1,18 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Parameters for a [SignatureHelpRequest](#SignatureHelpRequest).
-      #
       class SignatureHelpParams
-        def initialize(context: nil, text_document:, position:, work_done_token: nil)
+        def initialize(text_document:, position:, work_done_token: nil, context: nil)
           @attributes = {}
 
-          @attributes[:context] = context if context
           @attributes[:textDocument] = text_document
           @attributes[:position] = position
           @attributes[:workDoneToken] = work_done_token if work_done_token
+          @attributes[:context] = context if context
 
           @attributes.freeze
         end
 
-        #
-        # The signature help context. This is only available if the client specifies
-        # to send this using the client capability `textDocument.signatureHelp.contextSupport === true`
-        #
-        # @since 3.15.0
-        #
-        # @return [SignatureHelpContext | nil]
-        def context
-          attributes.fetch(:context)
-        end
-
         #
         # The text document.
         #
@@ -46,11 +32,21 @@ 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
 
+        #
+        # The signature help context. This is only available if the client
+        # specifies to send this using the client capability
+        # `textDocument.signatureHelp.contextSupport === true`
+        #
+        # @return [SignatureHelpContext]
+        def context
+          attributes.fetch(:context)
+        end
+
         attr_reader :attributes
 
         def to_hash

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

@@ -1,34 +1,37 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [SignatureHelpRequest](#SignatureHelpRequest).
-      #
       class SignatureHelpRegistrationOptions
-        def initialize(document_selector:, trigger_characters: nil, retrigger_characters: nil, work_done_progress: nil)
+        def initialize(document_selector:, work_done_progress: nil, trigger_characters: nil, retrigger_characters: nil)
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:triggerCharacters] = trigger_characters if trigger_characters
           @attributes[:retriggerCharacters] = retrigger_characters if retrigger_characters
-          @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 | null]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         #
-        # List of characters that trigger signature help automatically.
+        # The characters that trigger signature help
+        # automatically.
         #
-        # @return [string[] | nil]
+        # @return [string[]]
         def trigger_characters
           attributes.fetch(:triggerCharacters)
         end
@@ -36,21 +39,15 @@ module LanguageServer
         #
         # List of characters that re-trigger signature help.
         #
-        # These trigger characters are only active when signature help is already showing. All trigger characters
-        # are also counted as re-trigger characters.
+        # These trigger characters are only active when signature help is already
+        # showing. All trigger characters are also counted as re-trigger
+        # characters.
         #
-        # @since 3.15.0
-        #
-        # @return [string[] | nil]
+        # @return [string[]]
         def retrigger_characters
           attributes.fetch(:retriggerCharacters)
         end
 
-        # @return [boolean | nil]
-        def work_done_progress
-          attributes.fetch(:workDoneProgress)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -31,7 +31,7 @@ module LanguageServer
         # The human-readable doc-comment of this signature. Will be shown
         # in the UI but can be omitted.
         #
-        # @return [string | MarkupContent | nil]
+        # @return [string | MarkupContent]
         def documentation
           attributes.fetch(:documentation)
         end
@@ -39,7 +39,7 @@ module LanguageServer
         #
         # The parameters of this signature.
         #
-        # @return [ParameterInformation[] | nil]
+        # @return [ParameterInformation[]]
         def parameters
           attributes.fetch(:parameters)
         end
@@ -49,9 +49,7 @@ module LanguageServer
         #
         # If provided, this is used in place of `SignatureHelp.activeParameter`.
         #
-        # @since 3.16.0
-        #
-        # @return [uinteger | nil]
+        # @return [number]
         def active_parameter
           attributes.fetch(:activeParameter)
         end

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

@@ -2,8 +2,7 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Static registration options to be returned in the initialize
-      # request.
+      # Static registration options to be returned in the initialize request.
       #
       class StaticRegistrationOptions
         def initialize(id: nil)
@@ -18,7 +17,7 @@ module LanguageServer
         # The id used to register the request. The id can be used to deregister
         # the request again. See also Registration#id.
         #
-        # @return [string | nil]
+        # @return [string]
         def id
           attributes.fetch(:id)
         end

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

@@ -6,45 +6,19 @@ module LanguageServer
       # interfaces etc.
       #
       class SymbolInformation
-        def initialize(deprecated: nil, location:, name:, kind:, tags: nil, container_name: nil)
+        def initialize(name:, kind:, tags: nil, deprecated: nil, location:, container_name: nil)
           @attributes = {}
 
-          @attributes[:deprecated] = deprecated if deprecated
-          @attributes[:location] = location
           @attributes[:name] = name
           @attributes[:kind] = kind
           @attributes[:tags] = tags if tags
+          @attributes[:deprecated] = deprecated if deprecated
+          @attributes[:location] = location
           @attributes[:containerName] = container_name if container_name
 
           @attributes.freeze
         end
 
-        #
-        # Indicates if this symbol is deprecated.
-        #
-        # @deprecated Use tags instead
-        #
-        # @return [boolean | nil]
-        def deprecated
-          attributes.fetch(:deprecated)
-        end
-
-        #
-        # The location of this symbol. The location's range is used by a tool
-        # to reveal the location in the editor. If the symbol is selected in the
-        # tool the range's start information is used to position the cursor. So
-        # the range usually spans more than the actual symbol's name and does
-        # normally include things like visibility modifiers.
-        #
-        # The range doesn't have to denote a node range in the sense of an abstract
-        # syntax tree. It can therefore not be used to re-construct a hierarchy of
-        # the symbols.
-        #
-        # @return [Location]
-        def location
-          attributes.fetch(:location)
-        end
-
         #
         # The name of this symbol.
         #
@@ -64,20 +38,42 @@ module LanguageServer
         #
         # Tags for this symbol.
         #
-        # @since 3.16.0
-        #
-        # @return [SymbolTag[] | nil]
+        # @return [1[]]
         def tags
           attributes.fetch(:tags)
         end
 
+        #
+        # Indicates if this symbol is deprecated.
+        #
+        # @return [boolean]
+        def deprecated
+          attributes.fetch(:deprecated)
+        end
+
+        #
+        # The location of this symbol. The location's range is used by a tool
+        # to reveal the location in the editor. If the symbol is selected in the
+        # tool the range's start information is used to position the cursor. So
+        # the range usually spans more then the actual symbol's name and does
+        # normally include things like visibility modifiers.
+        #
+        # The range doesn't have to denote a node range in the sense of a abstract
+        # syntax tree. It can therefore not be used to re-construct a hierarchy of
+        # the symbols.
+        #
+        # @return [Location]
+        def location
+          attributes.fetch(:location)
+        end
+
         #
         # The name of the symbol containing this symbol. This information is for
         # user interface purposes (e.g. to render a qualifier in the user interface
         # if necessary). It can't be used to re-infer a hierarchy for the document
         # symbols.
         #
-        # @return [string | nil]
+        # @return [string]
         def container_name
           attributes.fetch(:containerName)
         end

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

@@ -2,33 +2,34 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Describe options to be used when registered for text document change events.
+      # Describe options to be used when registering for text document change events.
       #
       class TextDocumentChangeRegistrationOptions
-        def initialize(sync_kind:, document_selector:)
+        def initialize(document_selector:, sync_kind:)
           @attributes = {}
 
-          @attributes[:syncKind] = sync_kind
           @attributes[:documentSelector] = document_selector
+          @attributes[:syncKind] = sync_kind
 
           @attributes.freeze
         end
 
         #
-        # How documents are synced to the server.
+        # 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 [TextDocumentSyncKind]
-        def sync_kind
-          attributes.fetch(:syncKind)
+        # @return [DocumentSelector]
+        def document_selector
+          attributes.fetch(:documentSelector)
         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.
+        # How documents are synced to the server. See TextDocumentSyncKind.Full
+        # and TextDocumentSyncKind.Incremental.
         #
-        # @return [DocumentSelector | null]
-        def document_selector
-          attributes.fetch(:documentSelector)
+        # @return [TextDocumentSyncKind]
+        def sync_kind
+          attributes.fetch(:syncKind)
         end
 
         attr_reader :attributes