language_server-protocol 3.16.0.1 → 3.17.0.0

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

@@ -0,0 +1,50 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Notebook specific client capabilities.
+      #
+      # @since 3.17.0
+      #
+      class NotebookDocumentSyncClientCapabilities
+        def initialize(dynamic_registration: nil, execution_summary_support: nil)
+          @attributes = {}
+
+          @attributes[:dynamicRegistration] = dynamic_registration if dynamic_registration
+          @attributes[:executionSummarySupport] = execution_summary_support if execution_summary_support
+
+          @attributes.freeze
+        end
+
+        #
+        # Whether implementation supports dynamic registration. If this is
+        # set to `true` the client supports the new
+        # `(TextDocumentRegistrationOptions & StaticRegistrationOptions)`
+        # return value for the corresponding server capability as well.
+        #
+        # @return [boolean | nil]
+        def dynamic_registration
+          attributes.fetch(:dynamicRegistration)
+        end
+
+        #
+        # The client supports sending execution summary data per cell.
+        #
+        # @return [boolean | nil]
+        def execution_summary_support
+          attributes.fetch(:executionSummarySupport)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,58 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Options specific to a notebook plus its cells
+      # to be synced to the server.
+      #
+      # If a selector provides a notebook document
+      # filter but no cell selector all cells of a
+      # matching notebook document will be synced.
+      #
+      # If a selector provides no notebook document
+      # filter but only a cell selector all notebook
+      # document that contain at least one matching
+      # cell will be synced.
+      #
+      # @since 3.17.0
+      #
+      class NotebookDocumentSyncOptions
+        def initialize(notebook_selector:, save: nil)
+          @attributes = {}
+
+          @attributes[:notebookSelector] = notebook_selector
+          @attributes[:save] = save if save
+
+          @attributes.freeze
+        end
+
+        #
+        # The notebooks to be synced
+        #
+        # @return [{ notebook:string | NotebookDocumentFilter, cells:{ language:string }[] } | { notebook:string | NotebookDocumentFilter, cells:{ language:string }[] }[]]
+        def notebook_selector
+          attributes.fetch(:notebookSelector)
+        end
+
+        #
+        # Whether save notification should be forwarded to
+        # the server. Will only be honored if mode === `notebook`.
+        #
+        # @return [boolean | nil]
+        def save
+          attributes.fetch(:save)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,58 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Registration options specific to a notebook.
+      #
+      # @since 3.17.0
+      #
+      class NotebookDocumentSyncRegistrationOptions
+        def initialize(notebook_selector:, save: nil, id: nil)
+          @attributes = {}
+
+          @attributes[:notebookSelector] = notebook_selector
+          @attributes[:save] = save if save
+          @attributes[:id] = id if id
+
+          @attributes.freeze
+        end
+
+        #
+        # The notebooks to be synced
+        #
+        # @return [{ notebook:string | NotebookDocumentFilter, cells:{ language:string }[] } | { notebook:string | NotebookDocumentFilter, cells:{ language:string }[] }[]]
+        def notebook_selector
+          attributes.fetch(:notebookSelector)
+        end
+
+        #
+        # Whether save notification should be forwarded to
+        # the server. Will only be honored if mode === `notebook`.
+        #
+        # @return [boolean | nil]
+        def save
+          attributes.fetch(:save)
+        end
+
+        #
+        # The id used to register the request. The id can be used to deregister
+        # the request again. See also Registration#id.
+        #
+        # @return [string | nil]
+        def id
+          attributes.fetch(:id)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -1,38 +1,37 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # A text document identifier to optionally denote a specific version of a text document.
+      #
       class OptionalVersionedTextDocumentIdentifier
-        def initialize(uri:, version:)
+        def initialize(version:, uri:)
           @attributes = {}
 
-          @attributes[:uri] = uri
           @attributes[:version] = version
+          @attributes[:uri] = uri
 
           @attributes.freeze
         end
 
         #
-        # The text document's URI.
+        # The version number of this document. If a versioned text document identifier
+        # is sent from the server to the client and the file is not open in the editor
+        # (the server has not received an open notification before) the server can send
+        # `null` to indicate that the version is unknown and the content on disk is the
+        # truth (as specified with document content ownership).
         #
-        # @return [string]
-        def uri
-          attributes.fetch(:uri)
+        # @return [integer | null]
+        def version
+          attributes.fetch(:version)
         end
 
         #
-        # The version number of this document. If an optional versioned text document
-        # identifier is sent from the server to the client and the file is not
-        # open in the editor (the server has not received an open notification
-        # before) the server can send `null` to indicate that the version is
-        # known and the content on disk is the master (as specified with document
-        # content ownership).
+        # The text document's uri.
         #
-        # The version number of a document will increase after each change,
-        # including undo/redo. The number doesn't need to be consecutive.
-        #
-        # @return [number]
-        def version
-          attributes.fetch(:version)
+        # @return [DocumentUri]
+        def uri
+          attributes.fetch(:uri)
         end
 
         attr_reader :attributes

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

@@ -18,16 +18,14 @@ module LanguageServer
         #
         # The label of this parameter information.
         #
-        # Either a string or an inclusive start and exclusive end offsets within
-        # its containing signature label. (see SignatureInformation.label). The
-        # offsets are based on a UTF-16 string representation as `Position` and
-        # `Range` does.
+        # Either a string or an inclusive start and exclusive end offsets within its containing
+        # signature label. (see SignatureInformation.label). The offsets are based on a UTF-16
+        # string representation as `Position` and `Range` does.
         #
-        # *Note*: a label of type string should be a substring of its containing
-        # signature label. Its intended use case is to highlight the parameter
-        # label part in the `SignatureInformation.label`.
+        # *Note*: a label of type string should be a substring of its containing signature label.
+        # Its intended use case is to highlight the parameter label part in the `SignatureInformation.label`.
         #
-        # @return [string | [number, number]]
+        # @return [string | uinteger, uinteger]
         def label
           attributes.fetch(:label)
         end
@@ -36,7 +34,7 @@ module LanguageServer
         # The human-readable doc-comment of this parameter. Will be shown
         # in the UI but can be omitted.
         #
-        # @return [string | MarkupContent]
+        # @return [string | MarkupContent | nil]
         def documentation
           attributes.fetch(:documentation)
         end

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

@@ -11,10 +11,10 @@ module LanguageServer
         end
 
         #
-        # An optional token that a server can use to report partial results (e.g.
-        # streaming) to the client.
+        # An optional token that a server can use to report partial results (e.g. streaming) to
+        # the client.
         #
-        # @return [ProgressToken]
+        # @return [ProgressToken | nil]
         def partial_result_token
           attributes.fetch(:partialResultToken)
         end

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

@@ -1,6 +1,35 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Position in a text document expressed as zero-based line and character
+      # offset. Prior to 3.17 the offsets were always based on a UTF-16 string
+      # representation. So a string of the form `a𐐀b` the character offset of the
+      # character `a` is 0, the character offset of `𐐀` is 1 and the character
+      # offset of b is 3 since `𐐀` is represented using two code units in UTF-16.
+      # Since 3.17 clients and servers can agree on a different string encoding
+      # representation (e.g. UTF-8). The client announces it's supported encoding
+      # via the client capability [`general.positionEncodings`](#clientCapabilities).
+      # The value is an array of position encodings the client supports, with
+      # decreasing preference (e.g. the encoding at index `0` is the most preferred
+      # one). To stay backwards compatible the only mandatory encoding is UTF-16
+      # represented via the string `utf-16`. The server can pick one of the
+      # encodings offered by the client and signals that encoding back to the
+      # client via the initialize result's property
+      # [`capabilities.positionEncoding`](#serverCapabilities). If the string value
+      # `utf-16` is missing from the client's capability `general.positionEncodings`
+      # servers can safely assume that the client supports UTF-16. If the server
+      # omits the position encoding in its initialize result the encoding defaults
+      # to the string value `utf-16`. Implementation considerations: since the
+      # conversion from one encoding into another requires the content of the
+      # file / line the conversion is best done where the file is read which is
+      # usually on the server side.
+      #
+      # Positions are line end character agnostic. So you can not specify a position
+      # that denotes `\r|\n` or `\n|` where `|` represents the character offset.
+      #
+      # @since 3.17.0 - support for negotiated position encoding.
+      #
       class Position
         def initialize(line:, character:)
           @attributes = {}
@@ -14,20 +43,24 @@ module LanguageServer
         #
         # Line position in a document (zero-based).
         #
-        # @return [number]
+        # If a line number is greater than the number of lines in a document, it defaults back to the number of lines in the document.
+        # If a line number is negative, it defaults to 0.
+        #
+        # @return [uinteger]
         def line
           attributes.fetch(:line)
         end
 
         #
-        # Character offset on a line in a document (zero-based). Assuming that
-        # the line is represented as a string, the `character` value represents
-        # the gap between the `character` and `character + 1`.
+        # Character offset on a line in a document (zero-based).
+        #
+        # The meaning of this offset is determined by the negotiated
+        # `PositionEncodingKind`.
         #
-        # If the character value is greater than the line length it defaults back
-        # to the line length.
+        # If the character value is greater than the line length it defaults back to the
+        # line length.
         #
-        # @return [number]
+        # @return [uinteger]
         def character
           attributes.fetch(:character)
         end

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

@@ -2,11 +2,12 @@ module LanguageServer
   module Protocol
     module Interface
       class PrepareRenameParams
-        def initialize(text_document:, position:)
+        def initialize(text_document:, position:, work_done_token: nil)
           @attributes = {}
 
           @attributes[:textDocument] = text_document
           @attributes[:position] = position
+          @attributes[:workDoneToken] = work_done_token if work_done_token
 
           @attributes.freeze
         end
@@ -27,6 +28,14 @@ module LanguageServer
           attributes.fetch(:position)
         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/prepare_rename_result.rb

@@ -0,0 +1,60 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class PrepareRenameResult
+        def initialize(start:, end:, range:, placeholder:, default_behavior:)
+          @attributes = {}
+
+          @attributes[:start] = start
+          @attributes[:end] = binding.local_variable_get(:end)
+          @attributes[:range] = range
+          @attributes[:placeholder] = placeholder
+          @attributes[:defaultBehavior] = default_behavior
+
+          @attributes.freeze
+        end
+
+        #
+        # The range's start position.
+        #
+        # @return [Position]
+        def start
+          attributes.fetch(:start)
+        end
+
+        #
+        # The range's end position.
+        #
+        # @return [Position]
+        def end
+          attributes.fetch(:end)
+        end
+
+        # @return [Range]
+        def range
+          attributes.fetch(:range)
+        end
+
+        # @return [string]
+        def placeholder
+          attributes.fetch(:placeholder)
+        end
+
+        # @return [boolean]
+        def default_behavior
+          attributes.fetch(:defaultBehavior)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # A previous result id in a workspace pull request.
+      #
+      # @since 3.17.0
+      #
+      class PreviousResultId
+        def initialize(uri:, value:)
+          @attributes = {}
+
+          @attributes[:uri] = uri
+          @attributes[:value] = value
+
+          @attributes.freeze
+        end
+
+        #
+        # The URI for which the client knows a
+        # result id.
+        #
+        # @return [DocumentUri]
+        def uri
+          attributes.fetch(:uri)
+        end
+
+        #
+        # The value of the previous result id.
+        #
+        # @return [string]
+        def value
+          attributes.fetch(:value)
+        end
+
+        attr_reader :attributes
+
+        def to_hash
+          attributes
+        end
+
+        def to_json(*args)
+          to_hash.to_json(*args)
+        end
+      end
+    end
+  end
+end

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

@@ -22,7 +22,7 @@ module LanguageServer
         #
         # The progress data.
         #
-        # @return [T]
+        # @return [LSPAny]
         def value
           attributes.fetch(:value)
         end

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The publish diagnostic client capabilities.
+      #
       class PublishDiagnosticsClientCapabilities
         def initialize(related_information: nil, tag_support: nil, version_support: nil, code_description_support: nil, data_support: nil)
           @attributes = {}
@@ -17,7 +20,7 @@ module LanguageServer
         #
         # Whether the clients accepts diagnostics with related information.
         #
-        # @return [boolean]
+        # @return [boolean | nil]
         def related_information
           attributes.fetch(:relatedInformation)
         end
@@ -26,7 +29,9 @@ module LanguageServer
         # Client supports the tag property to provide meta data about a diagnostic.
         # Clients supporting tags have to handle unknown tags gracefully.
         #
-        # @return [{ valueSet: DiagnosticTag[]; }]
+        # @since 3.15.0
+        #
+        # @return [{ valueSet:DiagnosticTag[] } | nil]
         def tag_support
           attributes.fetch(:tagSupport)
         end
@@ -35,7 +40,9 @@ module LanguageServer
         # Whether the client interprets the version property of the
         # `textDocument/publishDiagnostics` notification's parameter.
         #
-        # @return [boolean]
+        # @since 3.15.0
+        #
+        # @return [boolean | nil]
         def version_support
           attributes.fetch(:versionSupport)
         end
@@ -43,7 +50,9 @@ module LanguageServer
         #
         # Client supports a codeDescription property
         #
-        # @return [boolean]
+        # @since 3.16.0
+        #
+        # @return [boolean | nil]
         def code_description_support
           attributes.fetch(:codeDescriptionSupport)
         end
@@ -53,7 +62,9 @@ module LanguageServer
         # preserved between a `textDocument/publishDiagnostics` and
         # `textDocument/codeAction` request.
         #
-        # @return [boolean]
+        # @since 3.16.0
+        #
+        # @return [boolean | nil]
         def data_support
           attributes.fetch(:dataSupport)
         end

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The publish diagnostic notification's parameters.
+      #
       class PublishDiagnosticsParams
         def initialize(uri:, version: nil, diagnostics:)
           @attributes = {}
@@ -15,16 +18,17 @@ module LanguageServer
         #
         # The URI for which diagnostic information is reported.
         #
-        # @return [string]
+        # @return [DocumentUri]
         def uri
           attributes.fetch(:uri)
         end
 
         #
-        # Optional the version number of the document the diagnostics are published
-        # for.
+        # Optional the version number of the document the diagnostics are published for.
         #
-        # @return [number]
+        # @since 3.15.0
+        #
+        # @return [integer | nil]
         def version
           attributes.fetch(:version)
         end

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

@@ -1,6 +1,19 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # A range in a text document expressed as (zero-based) start and end positions.
+      #
+      # If you want to specify a range that contains a line including the line ending
+      # character(s) then use an end position denoting the start of the next line.
+      # For example:
+      # ```ts
+      # {
+      #     start: { line: 5, character: 23 }
+      #     end : { line 6, character : 0 }
+      # }
+      # ```
+      #
       class Range
         def initialize(start:, end:)
           @attributes = {}

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

@@ -1,6 +1,9 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Client Capabilities for a [ReferencesRequest](#ReferencesRequest).
+      #
       class ReferenceClientCapabilities
         def initialize(dynamic_registration: nil)
           @attributes = {}
@@ -13,7 +16,7 @@ module LanguageServer
         #
         # Whether references supports dynamic registration.
         #
-        # @return [boolean]
+        # @return [boolean | nil]
         def dynamic_registration
           attributes.fetch(:dynamicRegistration)
         end

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

@@ -1,6 +1,10 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Value-object that contains additional information when
+      # requesting references.
+      #
       class ReferenceContext
         def initialize(include_declaration:)
           @attributes = {}

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

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