language_server-protocol 3.17.0.0 → 3.17.0.2

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # @since 3.16.0
-      #
       class SemanticTokensWorkspaceClientCapabilities
         def initialize(refresh_support: nil)
           @attributes = {}
@@ -19,10 +16,10 @@ module LanguageServer
         #
         # Note that this event is global and will force the client to refresh all
         # semantic tokens currently shown. It should be used with absolute care
-        # and is useful for situation where a server for example detects a project
+        # and is useful for situation where a server for example detect a project
         # wide change that requires such a calculation.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def refresh_support
           attributes.fetch(:refreshSupport)
         end

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

@@ -1,12 +1,8 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Defines the capabilities provided by a language
-      # server.
-      #
       class ServerCapabilities
-        def initialize(position_encoding: nil, text_document_sync: nil, notebook_document_sync: nil, completion_provider: nil, hover_provider: nil, signature_help_provider: nil, declaration_provider: nil, definition_provider: nil, type_definition_provider: nil, implementation_provider: nil, references_provider: nil, document_highlight_provider: nil, document_symbol_provider: nil, code_action_provider: nil, code_lens_provider: nil, document_link_provider: nil, color_provider: nil, workspace_symbol_provider: nil, document_formatting_provider: nil, document_range_formatting_provider: nil, document_on_type_formatting_provider: nil, rename_provider: nil, folding_range_provider: nil, selection_range_provider: nil, execute_command_provider: nil, call_hierarchy_provider: nil, linked_editing_range_provider: nil, semantic_tokens_provider: nil, moniker_provider: nil, type_hierarchy_provider: nil, inline_value_provider: nil, inlay_hint_provider: nil, diagnostic_provider: nil, workspace: nil, experimental: nil)
+        def initialize(position_encoding: nil, text_document_sync: nil, notebook_document_sync: nil, completion_provider: nil, hover_provider: nil, signature_help_provider: nil, declaration_provider: nil, definition_provider: nil, type_definition_provider: nil, implementation_provider: nil, references_provider: nil, document_highlight_provider: nil, document_symbol_provider: nil, code_action_provider: nil, code_lens_provider: nil, document_link_provider: nil, color_provider: nil, document_formatting_provider: nil, document_range_formatting_provider: nil, document_on_type_formatting_provider: nil, rename_provider: nil, folding_range_provider: nil, execute_command_provider: nil, selection_range_provider: nil, linked_editing_range_provider: nil, call_hierarchy_provider: nil, semantic_tokens_provider: nil, moniker_provider: nil, type_hierarchy_provider: nil, inline_value_provider: nil, inlay_hint_provider: nil, diagnostic_provider: nil, workspace_symbol_provider: nil, workspace: nil, experimental: nil)
           @attributes = {}
 
           @attributes[:positionEncoding] = position_encoding if position_encoding
@@ -26,22 +22,22 @@ module LanguageServer
           @attributes[:codeLensProvider] = code_lens_provider if code_lens_provider
           @attributes[:documentLinkProvider] = document_link_provider if document_link_provider
           @attributes[:colorProvider] = color_provider if color_provider
-          @attributes[:workspaceSymbolProvider] = workspace_symbol_provider if workspace_symbol_provider
           @attributes[:documentFormattingProvider] = document_formatting_provider if document_formatting_provider
           @attributes[:documentRangeFormattingProvider] = document_range_formatting_provider if document_range_formatting_provider
           @attributes[:documentOnTypeFormattingProvider] = document_on_type_formatting_provider if document_on_type_formatting_provider
           @attributes[:renameProvider] = rename_provider if rename_provider
           @attributes[:foldingRangeProvider] = folding_range_provider if folding_range_provider
-          @attributes[:selectionRangeProvider] = selection_range_provider if selection_range_provider
           @attributes[:executeCommandProvider] = execute_command_provider if execute_command_provider
-          @attributes[:callHierarchyProvider] = call_hierarchy_provider if call_hierarchy_provider
+          @attributes[:selectionRangeProvider] = selection_range_provider if selection_range_provider
           @attributes[:linkedEditingRangeProvider] = linked_editing_range_provider if linked_editing_range_provider
+          @attributes[:callHierarchyProvider] = call_hierarchy_provider if call_hierarchy_provider
           @attributes[:semanticTokensProvider] = semantic_tokens_provider if semantic_tokens_provider
           @attributes[:monikerProvider] = moniker_provider if moniker_provider
           @attributes[:typeHierarchyProvider] = type_hierarchy_provider if type_hierarchy_provider
           @attributes[:inlineValueProvider] = inline_value_provider if inline_value_provider
           @attributes[:inlayHintProvider] = inlay_hint_provider if inlay_hint_provider
           @attributes[:diagnosticProvider] = diagnostic_provider if diagnostic_provider
+          @attributes[:workspaceSymbolProvider] = workspace_symbol_provider if workspace_symbol_provider
           @attributes[:workspace] = workspace if workspace
           @attributes[:experimental] = experimental if experimental
 
@@ -57,9 +53,7 @@ module LanguageServer
         #
         # If omitted it defaults to 'utf-16'.
         #
-        # @since 3.17.0
-        #
-        # @return [PositionEncodingKind | nil]
+        # @return [string]
         def position_encoding
           attributes.fetch(:positionEncoding)
         end
@@ -67,9 +61,10 @@ module LanguageServer
         #
         # Defines how text documents are synced. Is either a detailed structure
         # defining each notification or for backwards compatibility the
-        # TextDocumentSyncKind number.
+        # TextDocumentSyncKind number. If omitted it defaults to
+        # `TextDocumentSyncKind.None`.
         #
-        # @return [TextDocumentSyncOptions | TextDocumentSyncKind | nil]
+        # @return [TextDocumentSyncOptions | TextDocumentSyncKind]
         def text_document_sync
           attributes.fetch(:textDocumentSync)
         end
@@ -77,9 +72,7 @@ module LanguageServer
         #
         # Defines how notebook documents are synced.
         #
-        # @since 3.17.0
-        #
-        # @return [NotebookDocumentSyncOptions | NotebookDocumentSyncRegistrationOptions | nil]
+        # @return [NotebookDocumentSyncOptions | NotebookDocumentSyncRegistrationOptions]
         def notebook_document_sync
           attributes.fetch(:notebookDocumentSync)
         end
@@ -87,7 +80,7 @@ module LanguageServer
         #
         # The server provides completion support.
         #
-        # @return [CompletionOptions | nil]
+        # @return [CompletionOptions]
         def completion_provider
           attributes.fetch(:completionProvider)
         end
@@ -95,7 +88,7 @@ module LanguageServer
         #
         # The server provides hover support.
         #
-        # @return [boolean | HoverOptions | nil]
+        # @return [boolean | HoverOptions]
         def hover_provider
           attributes.fetch(:hoverProvider)
         end
@@ -103,15 +96,15 @@ module LanguageServer
         #
         # The server provides signature help support.
         #
-        # @return [SignatureHelpOptions | nil]
+        # @return [SignatureHelpOptions]
         def signature_help_provider
           attributes.fetch(:signatureHelpProvider)
         end
 
         #
-        # The server provides Goto Declaration support.
+        # The server provides go to declaration support.
         #
-        # @return [boolean | DeclarationOptions | DeclarationRegistrationOptions | nil]
+        # @return [boolean | DeclarationOptions | DeclarationRegistrationOptions]
         def declaration_provider
           attributes.fetch(:declarationProvider)
         end
@@ -119,23 +112,23 @@ module LanguageServer
         #
         # The server provides goto definition support.
         #
-        # @return [boolean | DefinitionOptions | nil]
+        # @return [boolean | DefinitionOptions]
         def definition_provider
           attributes.fetch(:definitionProvider)
         end
 
         #
-        # The server provides Goto Type Definition support.
+        # The server provides goto type definition support.
         #
-        # @return [boolean | TypeDefinitionOptions | TypeDefinitionRegistrationOptions | nil]
+        # @return [boolean | TypeDefinitionOptions | TypeDefinitionRegistrationOptions]
         def type_definition_provider
           attributes.fetch(:typeDefinitionProvider)
         end
 
         #
-        # The server provides Goto Implementation support.
+        # The server provides goto implementation support.
         #
-        # @return [boolean | ImplementationOptions | ImplementationRegistrationOptions | nil]
+        # @return [boolean | ImplementationOptions | ImplementationRegistrationOptions]
         def implementation_provider
           attributes.fetch(:implementationProvider)
         end
@@ -143,7 +136,7 @@ module LanguageServer
         #
         # The server provides find references support.
         #
-        # @return [boolean | ReferenceOptions | nil]
+        # @return [boolean | ReferenceOptions]
         def references_provider
           attributes.fetch(:referencesProvider)
         end
@@ -151,7 +144,7 @@ module LanguageServer
         #
         # The server provides document highlight support.
         #
-        # @return [boolean | DocumentHighlightOptions | nil]
+        # @return [boolean | DocumentHighlightOptions]
         def document_highlight_provider
           attributes.fetch(:documentHighlightProvider)
         end
@@ -159,17 +152,17 @@ module LanguageServer
         #
         # The server provides document symbol support.
         #
-        # @return [boolean | DocumentSymbolOptions | nil]
+        # @return [boolean | DocumentSymbolOptions]
         def document_symbol_provider
           attributes.fetch(:documentSymbolProvider)
         end
 
         #
-        # The server provides code actions. CodeActionOptions may only be
-        # specified if the client states that it supports
-        # `codeActionLiteralSupport` in its initial `initialize` request.
+        # The server provides code actions. The `CodeActionOptions` return type is
+        # only valid if the client signals code action literal support via the
+        # property `textDocument.codeAction.codeActionLiteralSupport`.
         #
-        # @return [boolean | CodeActionOptions | nil]
+        # @return [boolean | CodeActionOptions]
         def code_action_provider
           attributes.fetch(:codeActionProvider)
         end
@@ -177,7 +170,7 @@ module LanguageServer
         #
         # The server provides code lens.
         #
-        # @return [CodeLensOptions | nil]
+        # @return [CodeLensOptions]
         def code_lens_provider
           attributes.fetch(:codeLensProvider)
         end
@@ -185,7 +178,7 @@ module LanguageServer
         #
         # The server provides document link support.
         #
-        # @return [DocumentLinkOptions | nil]
+        # @return [DocumentLinkOptions]
         def document_link_provider
           attributes.fetch(:documentLinkProvider)
         end
@@ -193,23 +186,15 @@ module LanguageServer
         #
         # The server provides color provider support.
         #
-        # @return [boolean | DocumentColorOptions | DocumentColorRegistrationOptions | nil]
+        # @return [boolean | DocumentColorOptions | DocumentColorRegistrationOptions]
         def color_provider
           attributes.fetch(:colorProvider)
         end
 
-        #
-        # The server provides workspace symbol support.
-        #
-        # @return [boolean | WorkspaceSymbolOptions | nil]
-        def workspace_symbol_provider
-          attributes.fetch(:workspaceSymbolProvider)
-        end
-
         #
         # The server provides document formatting.
         #
-        # @return [boolean | DocumentFormattingOptions | nil]
+        # @return [boolean | DocumentFormattingOptions]
         def document_formatting_provider
           attributes.fetch(:documentFormattingProvider)
         end
@@ -217,7 +202,7 @@ module LanguageServer
         #
         # The server provides document range formatting.
         #
-        # @return [boolean | DocumentRangeFormattingOptions | nil]
+        # @return [boolean | DocumentRangeFormattingOptions]
         def document_range_formatting_provider
           attributes.fetch(:documentRangeFormattingProvider)
         end
@@ -225,7 +210,7 @@ module LanguageServer
         #
         # The server provides document formatting on typing.
         #
-        # @return [DocumentOnTypeFormattingOptions | nil]
+        # @return [DocumentOnTypeFormattingOptions]
         def document_on_type_formatting_provider
           attributes.fetch(:documentOnTypeFormattingProvider)
         end
@@ -235,7 +220,7 @@ module LanguageServer
         # specified if the client states that it supports
         # `prepareSupport` in its initial `initialize` request.
         #
-        # @return [boolean | RenameOptions | nil]
+        # @return [boolean | RenameOptions]
         def rename_provider
           attributes.fetch(:renameProvider)
         end
@@ -243,63 +228,55 @@ module LanguageServer
         #
         # The server provides folding provider support.
         #
-        # @return [boolean | FoldingRangeOptions | FoldingRangeRegistrationOptions | nil]
+        # @return [boolean | FoldingRangeOptions | FoldingRangeRegistrationOptions]
         def folding_range_provider
           attributes.fetch(:foldingRangeProvider)
         end
 
-        #
-        # The server provides selection range support.
-        #
-        # @return [boolean | SelectionRangeOptions | SelectionRangeRegistrationOptions | nil]
-        def selection_range_provider
-          attributes.fetch(:selectionRangeProvider)
-        end
-
         #
         # The server provides execute command support.
         #
-        # @return [ExecuteCommandOptions | nil]
+        # @return [ExecuteCommandOptions]
         def execute_command_provider
           attributes.fetch(:executeCommandProvider)
         end
 
         #
-        # The server provides call hierarchy support.
-        #
-        # @since 3.16.0
+        # The server provides selection range support.
         #
-        # @return [boolean | CallHierarchyOptions | CallHierarchyRegistrationOptions | nil]
-        def call_hierarchy_provider
-          attributes.fetch(:callHierarchyProvider)
+        # @return [boolean | SelectionRangeOptions | SelectionRangeRegistrationOptions]
+        def selection_range_provider
+          attributes.fetch(:selectionRangeProvider)
         end
 
         #
         # The server provides linked editing range support.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | LinkedEditingRangeOptions | LinkedEditingRangeRegistrationOptions | nil]
+        # @return [boolean | LinkedEditingRangeOptions | LinkedEditingRangeRegistrationOptions]
         def linked_editing_range_provider
           attributes.fetch(:linkedEditingRangeProvider)
         end
 
         #
-        # The server provides semantic tokens support.
+        # The server provides call hierarchy support.
         #
-        # @since 3.16.0
+        # @return [boolean | CallHierarchyOptions | CallHierarchyRegistrationOptions]
+        def call_hierarchy_provider
+          attributes.fetch(:callHierarchyProvider)
+        end
+
+        #
+        # The server provides semantic tokens support.
         #
-        # @return [SemanticTokensOptions | SemanticTokensRegistrationOptions | nil]
+        # @return [SemanticTokensOptions | SemanticTokensRegistrationOptions]
         def semantic_tokens_provider
           attributes.fetch(:semanticTokensProvider)
         end
 
         #
-        # The server provides moniker support.
+        # Whether server provides moniker support.
         #
-        # @since 3.16.0
-        #
-        # @return [boolean | MonikerOptions | MonikerRegistrationOptions | nil]
+        # @return [boolean | MonikerOptions | MonikerRegistrationOptions]
         def moniker_provider
           attributes.fetch(:monikerProvider)
         end
@@ -307,9 +284,7 @@ module LanguageServer
         #
         # The server provides type hierarchy support.
         #
-        # @since 3.17.0
-        #
-        # @return [boolean | TypeHierarchyOptions | TypeHierarchyRegistrationOptions | nil]
+        # @return [boolean | TypeHierarchyOptions | TypeHierarchyRegistrationOptions]
         def type_hierarchy_provider
           attributes.fetch(:typeHierarchyProvider)
         end
@@ -317,9 +292,7 @@ module LanguageServer
         #
         # The server provides inline values.
         #
-        # @since 3.17.0
-        #
-        # @return [boolean | InlineValueOptions | InlineValueRegistrationOptions | nil]
+        # @return [boolean | InlineValueOptions | InlineValueRegistrationOptions]
         def inline_value_provider
           attributes.fetch(:inlineValueProvider)
         end
@@ -327,9 +300,7 @@ module LanguageServer
         #
         # The server provides inlay hints.
         #
-        # @since 3.17.0
-        #
-        # @return [boolean | InlayHintOptions | InlayHintRegistrationOptions | nil]
+        # @return [boolean | InlayHintOptions | InlayHintRegistrationOptions]
         def inlay_hint_provider
           attributes.fetch(:inlayHintProvider)
         end
@@ -337,17 +308,23 @@ module LanguageServer
         #
         # The server has support for pull model diagnostics.
         #
-        # @since 3.17.0
-        #
-        # @return [DiagnosticOptions | DiagnosticRegistrationOptions | nil]
+        # @return [DiagnosticOptions | DiagnosticRegistrationOptions]
         def diagnostic_provider
           attributes.fetch(:diagnosticProvider)
         end
 
         #
-        # Workspace specific server capabilities.
+        # The server provides workspace symbol support.
+        #
+        # @return [boolean | WorkspaceSymbolOptions]
+        def workspace_symbol_provider
+          attributes.fetch(:workspaceSymbolProvider)
+        end
+
+        #
+        # Workspace specific server capabilities
         #
-        # @return [{ workspaceFolders:WorkspaceFoldersServerCapabilities, fileOperations:FileOperationOptions } | nil]
+        # @return [{ workspaceFolders?: WorkspaceFoldersServerCapabilities; fileOperations?: { didCreate?: FileOperationRegistrationOptions; ... 4 more ...; willDelete?: FileOperationRegistrationOptions; }; }]
         def workspace
           attributes.fetch(:workspace)
         end
@@ -355,7 +332,7 @@ module LanguageServer
         #
         # Experimental server capabilities.
         #
-        # @return [T | nil]
+        # @return [LSPAny]
         def experimental
           attributes.fetch(:experimental)
         end

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

@@ -10,7 +10,10 @@ module LanguageServer
           @attributes.freeze
         end
 
-        # @return [TraceValues]
+        #
+        # The new value that should be assigned to the trace setting.
+        #
+        # @return [TraceValue]
         def value
           attributes.fetch(:value)
         end

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

@@ -2,9 +2,7 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Client capabilities for the showDocument request.
-      #
-      # @since 3.16.0
+      # Client capabilities for the show document request.
       #
       class ShowDocumentClientCapabilities
         def initialize(support:)
@@ -16,7 +14,7 @@ module LanguageServer
         end
 
         #
-        # The client has support for the showDocument
+        # The client has support for the show document
         # request.
         #
         # @return [boolean]

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

@@ -4,8 +4,6 @@ module LanguageServer
       #
       # Params to show a document.
       #
-      # @since 3.16.0
-      #
       class ShowDocumentParams
         def initialize(uri:, external: nil, take_focus: nil, selection: nil)
           @attributes = {}
@@ -21,7 +19,7 @@ module LanguageServer
         #
         # The document uri to show.
         #
-        # @return [URI]
+        # @return [string]
         def uri
           attributes.fetch(:uri)
         end
@@ -31,7 +29,7 @@ module LanguageServer
         # To show for example `https://code.visualstudio.com/`
         # in the default WEB browser set `external` to `true`.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def external
           attributes.fetch(:external)
         end
@@ -42,7 +40,7 @@ module LanguageServer
         # Clients might ignore this property if an external
         # program is started.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def take_focus
           attributes.fetch(:takeFocus)
         end
@@ -53,7 +51,7 @@ module LanguageServer
         # external program is started or the file is not a text
         # file.
         #
-        # @return [Range | nil]
+        # @return [Range]
         def selection
           attributes.fetch(:selection)
         end

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

@@ -2,9 +2,7 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # The result of a showDocument request.
-      #
-      # @since 3.16.0
+      # The result of an show document request.
       #
       class ShowDocumentResult
         def initialize(success:)

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # The parameters of a notification message.
-      #
       class ShowMessageParams
         def initialize(type:, message:)
           @attributes = {}
@@ -15,7 +12,7 @@ module LanguageServer
         end
 
         #
-        # The message type. See {@link MessageType}
+        # The message type. See {@link MessageType}.
         #
         # @return [MessageType]
         def type

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

@@ -16,7 +16,7 @@ module LanguageServer
         #
         # Capabilities specific to the `MessageActionItem` type.
         #
-        # @return [{ additionalPropertiesSupport:boolean } | nil]
+        # @return [{ additionalPropertiesSupport?: boolean; }]
         def message_action_item
           attributes.fetch(:messageActionItem)
         end

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

@@ -21,7 +21,7 @@ module LanguageServer
         end
 
         #
-        # The actual message.
+        # The actual message
         #
         # @return [string]
         def message
@@ -31,7 +31,7 @@ module LanguageServer
         #
         # The message action items to present.
         #
-        # @return [MessageActionItem[] | nil]
+        # @return [MessageActionItem[]]
         def actions
           attributes.fetch(:actions)
         end

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

@@ -18,7 +18,8 @@ module LanguageServer
         end
 
         #
-        # One or more signatures.
+        # One or more signatures. If no signatures are available the signature help
+        # request should return `null`.
         #
         # @return [SignatureInformation[]]
         def signatures
@@ -27,8 +28,8 @@ module LanguageServer
 
         #
         # The active signature. If omitted or the value lies outside the
-        # range of `signatures` the value defaults to zero or is ignored if
-        # the `SignatureHelp` has no signatures.
+        # range of `signatures` the value defaults to zero or is ignore if
+        # the `SignatureHelp` as no signatures.
         #
         # Whenever possible implementors should make an active decision about
         # the active signature and shouldn't rely on a default value.
@@ -36,7 +37,7 @@ module LanguageServer
         # In future version of the protocol this property might become
         # mandatory to better express this.
         #
-        # @return [uinteger | nil]
+        # @return [number]
         def active_signature
           attributes.fetch(:activeSignature)
         end
@@ -50,7 +51,7 @@ module LanguageServer
         # mandatory to better express the active parameter if the
         # active signature does have any.
         #
-        # @return [uinteger | nil]
+        # @return [number]
         def active_parameter
           attributes.fetch(:activeParameter)
         end

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

@@ -1,9 +1,6 @@
 module LanguageServer
   module Protocol
     module Interface
-      #
-      # Client Capabilities for a [SignatureHelpRequest](#SignatureHelpRequest).
-      #
       class SignatureHelpClientCapabilities
         def initialize(dynamic_registration: nil, signature_information: nil, context_support: nil)
           @attributes = {}
@@ -18,7 +15,7 @@ module LanguageServer
         #
         # Whether signature help supports dynamic registration.
         #
-        # @return [boolean | nil]
+        # @return [boolean]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end
@@ -27,7 +24,7 @@ module LanguageServer
         # The client supports the following `SignatureInformation`
         # specific properties.
         #
-        # @return [{ documentationFormat:MarkupKind[], parameterInformation:{ labelOffsetSupport:boolean }, activeParameterSupport:boolean } | nil]
+        # @return [{ documentationFormat?: MarkupKind[]; parameterInformation?: { labelOffsetSupport?: boolean; }; activeParameterSupport?: boolean; }]
         def signature_information
           attributes.fetch(:signatureInformation)
         end
@@ -38,9 +35,7 @@ module LanguageServer
         # contextSupport will also support the `retriggerCharacters` on
         # `SignatureHelpOptions`.
         #
-        # @since 3.15.0
-        #
-        # @return [boolean | nil]
+        # @return [boolean]
         def context_support
           attributes.fetch(:contextSupport)
         end