language_server-protocol 3.17.0.0 → 3.17.0.2

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

@@ -13,7 +13,7 @@ module LanguageServer
         #
         # The request id to cancel.
         #
-        # @return [integer | string]
+        # @return [string | number]
         def id
           attributes.fetch(:id)
         end

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

@@ -4,8 +4,6 @@ module LanguageServer
       #
       # Additional information that describes document changes.
       #
-      # @since 3.16.0
-      #
       class ChangeAnnotation
         def initialize(label:, needs_confirmation: nil, description: nil)
           @attributes = {}
@@ -30,7 +28,7 @@ module LanguageServer
         # A flag which indicates that user confirmation is needed
         # before applying the change.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def needs_confirmation
           attributes.fetch(:needsConfirmation)
         end
@@ -39,7 +37,7 @@ module LanguageServer
         # A human-readable string which is rendered less prominent in
         # the user interface.
         #
-        # @return [string | nil]
+        # @return [string]
         def description
           attributes.fetch(:description)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Defines the capabilities provided by the client.
-      #
       class ClientCapabilities
         def initialize(workspace: nil, text_document: nil, notebook_document: nil, window: nil, general: nil, experimental: nil)
           @attributes = {}
@@ -21,7 +18,7 @@ module LanguageServer
         #
         # Workspace specific client capabilities.
         #
-        # @return [WorkspaceClientCapabilities | nil]
+        # @return [{ applyEdit?: boolean; workspaceEdit?: WorkspaceEditClientCapabilities; didChangeConfiguration?: DidChangeConfigurationClientCapabilities; ... 10 more ...; diagnostics?: DiagnosticWorkspaceClientCapabilities; }]
         def workspace
           attributes.fetch(:workspace)
         end
@@ -29,7 +26,7 @@ module LanguageServer
         #
         # Text document specific client capabilities.
         #
-        # @return [TextDocumentClientCapabilities | nil]
+        # @return [TextDocumentClientCapabilities]
         def text_document
           attributes.fetch(:textDocument)
         end
@@ -37,9 +34,7 @@ module LanguageServer
         #
         # Capabilities specific to the notebook document support.
         #
-        # @since 3.17.0
-        #
-        # @return [NotebookDocumentClientCapabilities | nil]
+        # @return [NotebookDocumentClientCapabilities]
         def notebook_document
           attributes.fetch(:notebookDocument)
         end
@@ -47,7 +42,7 @@ module LanguageServer
         #
         # Window specific client capabilities.
         #
-        # @return [WindowClientCapabilities | nil]
+        # @return [{ workDoneProgress?: boolean; showMessage?: ShowMessageRequestClientCapabilities; showDocument?: ShowDocumentClientCapabilities; }]
         def window
           attributes.fetch(:window)
         end
@@ -55,9 +50,7 @@ module LanguageServer
         #
         # General client capabilities.
         #
-        # @since 3.16.0
-        #
-        # @return [GeneralClientCapabilities | nil]
+        # @return [{ staleRequestSupport?: { cancel: boolean; retryOnContentModified: string[]; }; regularExpressions?: RegularExpressionsClientCapabilities; markdown?: any; positionEncodings?: string[]; }]
         def general
           attributes.fetch(:general)
         end
@@ -65,7 +58,7 @@ module LanguageServer
         #
         # Experimental client capabilities.
         #
-        # @return [LSPAny | nil]
+        # @return [LSPAny]
         def experimental
           attributes.fetch(:experimental)
         end

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

@@ -2,10 +2,11 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # A code action represents a change that can be performed in code, e.g. to fix a problem or
-      # to refactor code.
+      # A code action represents a change that can be performed in code, e.g. to fix
+      # a problem or to refactor code.
       #
-      # A CodeAction must set either `edit` and/or a `command`. If both are supplied, the `edit` is applied first, then the `command` is executed.
+      # A CodeAction must set either `edit` and/or a `command`. If both are supplied,
+      # the `edit` is applied first, then the `command` is executed.
       #
       class CodeAction
         def initialize(title:, kind: nil, diagnostics: nil, is_preferred: nil, disabled: nil, edit: nil, command: nil, data: nil)
@@ -36,7 +37,7 @@ module LanguageServer
         #
         # Used to filter code actions.
         #
-        # @return [CodeActionKind | nil]
+        # @return [string]
         def kind
           attributes.fetch(:kind)
         end
@@ -44,21 +45,20 @@ module LanguageServer
         #
         # The diagnostics that this code action resolves.
         #
-        # @return [Diagnostic[] | nil]
+        # @return [Diagnostic[]]
         def diagnostics
           attributes.fetch(:diagnostics)
         end
 
         #
-        # Marks this as a preferred action. Preferred actions are used by the `auto fix` command and can be targeted
-        # by keybindings.
-        #
-        # A quick fix should be marked preferred if it properly addresses the underlying error.
-        # A refactoring should be marked preferred if it is the most reasonable choice of actions to take.
+        # Marks this as a preferred action. Preferred actions are used by the
+        # `auto fix` command and can be targeted by keybindings.
         #
-        # @since 3.15.0
+        # A quick fix should be marked preferred if it properly addresses the
+        # underlying error. A refactoring should be marked preferred if it is the
+        # most reasonable choice of actions to take.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def is_preferred
           attributes.fetch(:isPreferred)
         end
@@ -66,21 +66,21 @@ module LanguageServer
         #
         # Marks that the code action cannot currently be applied.
         #
-        # Clients should follow the following guidelines regarding disabled code actions:
+        # Clients should follow the following guidelines regarding disabled code
+        # actions:
         #
-        #   - Disabled code actions are not shown in automatic [lightbulbs](https://code.visualstudio.com/docs/editor/editingevolved#_code-action)
-        #     code action menus.
+        # - Disabled code actions are not shown in automatic lightbulbs code
+        # action menus.
         #
-        #   - Disabled actions are shown as faded out in the code action menu when the user requests a more specific type
-        #     of code action, such as refactorings.
+        # - Disabled actions are shown as faded out in the code action menu when
+        # the user request a more specific type of code action, such as
+        # refactorings.
         #
-        #   - If the user has a [keybinding](https://code.visualstudio.com/docs/editor/refactoring#_keybindings-for-code-actions)
-        #     that auto applies a code action and only disabled code actions are returned, the client should show the user an
-        #     error message with `reason` in the editor.
+        # - If the user has a keybinding that auto applies a code action and only
+        # a disabled code actions are returned, the client should show the user
+        # an error message with `reason` in the editor.
         #
-        # @since 3.16.0
-        #
-        # @return [{ reason:string } | nil]
+        # @return [{ reason: string; }]
         def disabled
           attributes.fetch(:disabled)
         end
@@ -88,7 +88,7 @@ module LanguageServer
         #
         # The workspace edit this code action performs.
         #
-        # @return [WorkspaceEdit | nil]
+        # @return [WorkspaceEdit]
         def edit
           attributes.fetch(:edit)
         end
@@ -98,7 +98,7 @@ module LanguageServer
         # provides an edit and a command, first the edit is
         # executed and then the command.
         #
-        # @return [Command | nil]
+        # @return [Command]
         def command
           attributes.fetch(:command)
         end
@@ -107,9 +107,7 @@ module LanguageServer
         # A data entry field that is preserved on a code action between
         # a `textDocument/codeAction` and a `codeAction/resolve` request.
         #
-        # @since 3.16.0
-        #
-        # @return [LSPAny | nil]
+        # @return [LSPAny]
         def data
           attributes.fetch(:data)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The Client Capabilities of a [CodeActionRequest](#CodeActionRequest).
-      #
       class CodeActionClientCapabilities
         def initialize(dynamic_registration: nil, code_action_literal_support: nil, is_preferred_support: nil, disabled_support: nil, data_support: nil, resolve_support: nil, honors_change_annotations: nil)
           @attributes = {}
@@ -22,19 +19,16 @@ module LanguageServer
         #
         # Whether code action supports dynamic registration.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end
 
         #
-        # The client support code action literals of type `CodeAction` as a valid
-        # response of the `textDocument/codeAction` request. If the property is not
-        # set the request can only return `Command` literals.
+        # The client supports code action literals as a valid
+        # response of the `textDocument/codeAction` request.
         #
-        # @since 3.8.0
-        #
-        # @return [{ codeActionKind:{ valueSet:CodeActionKind[] } } | nil]
+        # @return [{ codeActionKind: { valueSet: string[]; }; }]
         def code_action_literal_support
           attributes.fetch(:codeActionLiteralSupport)
         end
@@ -42,9 +36,7 @@ module LanguageServer
         #
         # Whether code action supports the `isPreferred` property.
         #
-        # @since 3.15.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def is_preferred_support
           attributes.fetch(:isPreferredSupport)
         end
@@ -52,9 +44,7 @@ module LanguageServer
         #
         # Whether code action supports the `disabled` property.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def disabled_support
           attributes.fetch(:disabledSupport)
         end
@@ -64,9 +54,7 @@ module LanguageServer
         # preserved between a `textDocument/codeAction` and a
         # `codeAction/resolve` request.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def data_support
           attributes.fetch(:dataSupport)
         end
@@ -75,9 +63,7 @@ module LanguageServer
         # Whether the client supports resolving additional code action
         # properties via a separate `codeAction/resolve` request.
         #
-        # @since 3.16.0
-        #
-        # @return [{ properties:string[] } | nil]
+        # @return [{ properties: string[]; }]
         def resolve_support
           attributes.fetch(:resolveSupport)
         end
@@ -89,9 +75,7 @@ module LanguageServer
         # the workspace edit in the user interface and asking
         # for confirmation.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def honors_change_annotations
           attributes.fetch(:honorsChangeAnnotations)
         end

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

@@ -3,7 +3,7 @@ module LanguageServer
     module Interface
       #
       # Contains additional diagnostic information about the context in which
-      # a [code action](#CodeActionProvider.provideCodeActions) is run.
+      # a code action is run.
       #
       class CodeActionContext
         def initialize(diagnostics:, only: nil, trigger_kind: nil)
@@ -17,10 +17,11 @@ module LanguageServer
         end
 
         #
-        # An array of diagnostics known on the client side overlapping the range provided to the
-        # `textDocument/codeAction` request. They are provided so that the server knows which
-        # errors are currently presented to the user for the given range. There is no guarantee
-        # that these accurately reflect the error state of the resource. The primary parameter
+        # An array of diagnostics known on the client side overlapping the range
+        # provided to the `textDocument/codeAction` request. They are provided so
+        # that the server knows which errors are currently presented to the user
+        # for the given range. There is no guarantee that these accurately reflect
+        # the error state of the resource. The primary parameter
         # to compute code actions is the provided range.
         #
         # @return [Diagnostic[]]
@@ -31,10 +32,10 @@ module LanguageServer
         #
         # Requested kind of actions to return.
         #
-        # Actions not of this kind are filtered out by the client before being shown. So servers
-        # can omit computing them.
+        # Actions not of this kind are filtered out by the client before being
+        # shown. So servers can omit computing them.
         #
-        # @return [CodeActionKind[] | nil]
+        # @return [string[]]
         def only
           attributes.fetch(:only)
         end
@@ -42,9 +43,7 @@ module LanguageServer
         #
         # The reason why code actions were requested.
         #
-        # @since 3.17.0
-        #
-        # @return [CodeActionTriggerKind | nil]
+        # @return [CodeActionTriggerKind]
         def trigger_kind
           attributes.fetch(:triggerKind)
         end

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

@@ -1,27 +1,29 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Provider options for a [CodeActionRequest](#CodeActionRequest).
-      #
       class CodeActionOptions
-        def initialize(code_action_kinds: nil, resolve_provider: nil, work_done_progress: nil)
+        def initialize(work_done_progress: nil, code_action_kinds: nil, resolve_provider: nil)
           @attributes = {}
 
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:codeActionKinds] = code_action_kinds if code_action_kinds
           @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
+
         #
         # CodeActionKinds that this server may return.
         #
-        # The list of kinds may be generic, such as `CodeActionKind.Refactor`, or the server
-        # may list out every specific kind they provide.
+        # The list of kinds may be generic, such as `CodeActionKind.Refactor`,
+        # or the server may list out every specific kind they provide.
         #
-        # @return [CodeActionKind[] | nil]
+        # @return [string[]]
         def code_action_kinds
           attributes.fetch(:codeActionKinds)
         end
@@ -30,18 +32,11 @@ module LanguageServer
         # The server provides support to resolve additional
         # information for a code action.
         #
-        # @since 3.16.0
-        #
-        # @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/code_action_params.rb

@@ -2,21 +2,38 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # The parameters of a [CodeActionRequest](#CodeActionRequest).
+      # Params for the CodeActionRequest
       #
       class CodeActionParams
-        def initialize(text_document:, range:, context:, work_done_token: nil, partial_result_token: nil)
+        def initialize(work_done_token: nil, partial_result_token: nil, text_document:, range:, context:)
           @attributes = {}
 
+          @attributes[:workDoneToken] = work_done_token if work_done_token
+          @attributes[:partialResultToken] = partial_result_token if partial_result_token
           @attributes[:textDocument] = text_document
           @attributes[:range] = range
           @attributes[:context] = context
-          @attributes[:workDoneToken] = work_done_token if work_done_token
-          @attributes[:partialResultToken] = partial_result_token if partial_result_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
+
+        #
+        # 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 in which the command was invoked.
         #
@@ -41,23 +58,6 @@ module LanguageServer
           attributes.fetch(:context)
         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
-
-        #
-        # An optional token that a server can use to report partial results (e.g. streaming) to
-        # the client.
-        #
-        # @return [ProgressToken | nil]
-        def partial_result_token
-          attributes.fetch(:partialResultToken)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -1,37 +1,39 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Registration options for a [CodeActionRequest](#CodeActionRequest).
-      #
       class CodeActionRegistrationOptions
-        def initialize(document_selector:, code_action_kinds: nil, resolve_provider: nil, work_done_progress: nil)
+        def initialize(document_selector:, work_done_progress: nil, code_action_kinds: nil, resolve_provider: nil)
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
+          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
           @attributes[:codeActionKinds] = code_action_kinds if code_action_kinds
           @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 | null]
+        # @return [DocumentSelector]
         def document_selector
           attributes.fetch(:documentSelector)
         end
 
+        # @return [boolean]
+        def work_done_progress
+          attributes.fetch(:workDoneProgress)
+        end
+
         #
         # CodeActionKinds that this server may return.
         #
-        # The list of kinds may be generic, such as `CodeActionKind.Refactor`, or the server
-        # may list out every specific kind they provide.
+        # The list of kinds may be generic, such as `CodeActionKind.Refactor`,
+        # or the server may list out every specific kind they provide.
         #
-        # @return [CodeActionKind[] | nil]
+        # @return [string[]]
         def code_action_kinds
           attributes.fetch(:codeActionKinds)
         end
@@ -40,18 +42,11 @@ module LanguageServer
         # The server provides support to resolve additional
         # information for a code action.
         #
-        # @since 3.16.0
-        #
-        # @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/code_description.rb

@@ -4,8 +4,6 @@ module LanguageServer
       #
       # Structure to capture a description for an error code.
       #
-      # @since 3.16.0
-      #
       class CodeDescription
         def initialize(href:)
           @attributes = {}
@@ -18,7 +16,7 @@ module LanguageServer
         #
         # An URI to open with more information about the diagnostic error.
         #
-        # @return [URI]
+        # @return [string]
         def href
           attributes.fetch(:href)
         end

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

@@ -2,11 +2,12 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # A code lens represents a [command](#Command) that should be shown along with
+      # A code lens represents a command that should be shown along with
       # source text, like the number of references, a way to run tests, etc.
       #
-      # A code lens is _unresolved_ when no command is associated to it. For performance
-      # reasons the creation of a code lens and resolving should be done in two stages.
+      # A code lens is _unresolved_ when no command is associated to it. For
+      # performance reasons the creation of a code lens and resolving should be done
+      # in two stages.
       #
       class CodeLens
         def initialize(range:, command: nil, data: nil)
@@ -20,7 +21,8 @@ module LanguageServer
         end
 
         #
-        # The range in which this code lens is valid. Should only span a single line.
+        # The range in which this code lens is valid. Should only span a single
+        # line.
         #
         # @return [Range]
         def range
@@ -30,17 +32,16 @@ module LanguageServer
         #
         # The command this code lens represents.
         #
-        # @return [Command | nil]
+        # @return [Command]
         def command
           attributes.fetch(:command)
         end
 
         #
         # A data entry field that is preserved on a code lens item between
-        # a [CodeLensRequest](#CodeLensRequest) and a [CodeLensResolveRequest]
-        # (#CodeLensResolveRequest)
+        # a code lens and a code lens resolve request.
         #
-        # @return [LSPAny | nil]
+        # @return [LSPAny]
         def data
           attributes.fetch(:data)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The client capabilities  of a [CodeLensRequest](#CodeLensRequest).
-      #
       class CodeLensClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}
@@ -16,7 +13,7 @@ module LanguageServer
         #
         # Whether code lens supports dynamic registration.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end

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

@@ -1,32 +1,29 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Code Lens provider options of a [CodeLensRequest](#CodeLensRequest).
-      #
       class CodeLensOptions
-        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
+
         #
         # Code lens has 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