language_server-protocol 3.17.0.5 → 3.18.0.0.pre.1

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

@@ -0,0 +1,47 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # @since 3.18.0
+      #
+      class NotebookDocumentFilterWithCells
+        def initialize(notebook: nil, cells:)
+          @attributes = {}
+
+          @attributes[:notebook] = notebook unless notebook.nil?
+          @attributes[:cells] = cells
+
+          @attributes.freeze
+        end
+
+        #
+        # The notebook to be synced If a string
+        # value is provided it matches against the
+        # notebook type. '*' matches every notebook.
+        #
+        # @return [string | NotebookDocumentFilter]
+        def notebook
+          attributes.fetch(:notebook)
+        end
+
+        #
+        # The cells of the matching notebook to be synced.
+        #
+        # @return [NotebookCellLanguage[]]
+        def cells
+          attributes.fetch(:cells)
+        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_filter_with_notebook.rb

@@ -0,0 +1,47 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # @since 3.18.0
+      #
+      class NotebookDocumentFilterWithNotebook
+        def initialize(notebook:, cells: nil)
+          @attributes = {}
+
+          @attributes[:notebook] = notebook
+          @attributes[:cells] = cells unless cells.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # The notebook to be synced If a string
+        # value is provided it matches against the
+        # notebook type. '*' matches every notebook.
+        #
+        # @return [string | NotebookDocumentFilter]
+        def notebook
+          attributes.fetch(:notebook)
+        end
+
+        #
+        # The cells of the matching notebook to be synced.
+        #
+        # @return [NotebookCellLanguage[]]
+        def cells
+          attributes.fetch(:cells)
+        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_identifier.rb

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # A literal to identify a notebook document in the client.
       #
+      # @since 3.17.0
+      #
       class NotebookDocumentIdentifier
         def initialize(uri:)
           @attributes = {}
@@ -14,9 +16,9 @@ module LanguageServer
         end
 
         #
-        # The notebook document's URI.
+        # The notebook document's uri.
         #
-        # @return [string]
+        # @return [URI]
         def uri
           attributes.fetch(:uri)
         end

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

@@ -4,12 +4,14 @@ module LanguageServer
       #
       # 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[:dynamicRegistration] = dynamic_registration unless dynamic_registration.nil?
+          @attributes[:executionSummarySupport] = execution_summary_support unless execution_summary_support.nil?
 
           @attributes.freeze
         end

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

@@ -11,15 +11,17 @@ module LanguageServer
       #
       # If a selector provides no notebook document
       # filter but only a cell selector all notebook
-      # documents that contain at least one matching
+      # 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[:save] = save unless save.nil?
 
           @attributes.freeze
         end
@@ -27,7 +29,7 @@ module LanguageServer
         #
         # The notebooks to be synced
         #
-        # @return [({ notebook: string | NotebookDocumentFilter; cells?: { language: string; }[]; } | { notebook?: string | NotebookDocumentFilter; cells: { ...; }[]; })[]]
+        # @return [NotebookDocumentFilterWithNotebook | NotebookDocumentFilterWithCells[]]
         def notebook_selector
           attributes.fetch(:notebookSelector)
         end

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

@@ -4,13 +4,15 @@ module LanguageServer
       #
       # 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[:save] = save unless save.nil?
+          @attributes[:id] = id unless id.nil?
 
           @attributes.freeze
         end
@@ -18,7 +20,7 @@ module LanguageServer
         #
         # The notebooks to be synced
         #
-        # @return [({ notebook: string | NotebookDocumentFilter; cells?: { language: string; }[]; } | { notebook?: string | NotebookDocumentFilter; cells: { ...; }[]; })[]]
+        # @return [NotebookDocumentFilterWithNotebook | NotebookDocumentFilterWithCells[]]
         def notebook_selector
           attributes.fetch(:notebookSelector)
         end

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

@@ -7,7 +7,7 @@ module LanguageServer
 
           @attributes[:jsonrpc] = jsonrpc
           @attributes[:method] = method
-          @attributes[:params] = params if params
+          @attributes[:params] = params unless params.nil?
 
           @attributes.freeze
         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 | nil]
+        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

@@ -10,7 +10,7 @@ module LanguageServer
           @attributes = {}
 
           @attributes[:label] = label
-          @attributes[:documentation] = documentation if documentation
+          @attributes[:documentation] = documentation unless documentation.nil?
 
           @attributes.freeze
         end
@@ -18,16 +18,18 @@ 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`.
+        # To avoid ambiguities a server should use the [start, end] offset value instead of using
+        # a substring. Whether a client support this is controlled via `labelOffsetSupport` client
+        # capability.
         #
-        # @return [string | [number, number]]
+        # *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 | [uinteger, uinteger]]
         def label
           attributes.fetch(:label)
         end

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

@@ -5,14 +5,14 @@ module LanguageServer
         def initialize(partial_result_token: nil)
           @attributes = {}
 
-          @attributes[:partialResultToken] = partial_result_token if partial_result_token
+          @attributes[:partialResultToken] = partial_result_token unless partial_result_token.nil?
 
           @attributes.freeze
         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]
         def partial_result_token

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`](https://microsoft.github.io/language-server-protocol/specifications/specification-current/#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`](https://microsoft.github.io/language-server-protocol/specifications/specification-current/#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,19 +43,18 @@ module LanguageServer
         #
         # Line position in a document (zero-based).
         #
-        # @return [number]
+        # @return [uinteger]
         def line
           attributes.fetch(:line)
         end
 
         #
-        # Character offset on a line in a document (zero-based). The meaning of this
-        # offset is determined by the negotiated `PositionEncodingKind`.
+        # Character offset on a line in a document (zero-based).
         #
-        # If the character value is greater than the line length it defaults back
-        # to the line length.
+        # The meaning of this offset is determined by the negotiated
+        # `PositionEncodingKind`.
         #
-        # @return [number]
+        # @return [uinteger]
         def character
           attributes.fetch(:character)
         end

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

@@ -0,0 +1,33 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # @since 3.18.0
+      #
+      class PrepareRenameDefaultBehavior
+        def initialize(default_behavior:)
+          @attributes = {}
+
+          @attributes[:defaultBehavior] = default_behavior
+
+          @attributes.freeze
+        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/prepare_rename_params.rb

@@ -7,7 +7,7 @@ module LanguageServer
 
           @attributes[:textDocument] = text_document
           @attributes[:position] = position
-          @attributes[:workDoneToken] = work_done_token if work_done_token
+          @attributes[:workDoneToken] = work_done_token unless work_done_token.nil?
 
           @attributes.freeze
         end

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

@@ -0,0 +1,39 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # @since 3.18.0
+      #
+      class PrepareRenamePlaceholder
+        def initialize(range:, placeholder:)
+          @attributes = {}
+
+          @attributes[:range] = range
+          @attributes[:placeholder] = placeholder
+
+          @attributes.freeze
+        end
+
+        # @return [Range]
+        def range
+          attributes.fetch(:range)
+        end
+
+        # @return [string]
+        def placeholder
+          attributes.fetch(:placeholder)
+        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/prepare_rename_result.rb

@@ -0,0 +1,69 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      class PrepareRenameResult
+        def initialize(start: nil, end: nil, range: nil, placeholder: nil, default_behavior: nil)
+          @attributes = {}
+
+          @attributes[:start] = start unless start.nil?
+          @attributes[:end] = binding.local_variable_get(:end) unless binding.local_variable_get(:end).nil?
+          @attributes[:range] = range unless range.nil?
+          @attributes[:placeholder] = placeholder unless placeholder.nil?
+          @attributes[:defaultBehavior] = default_behavior unless default_behavior.nil?
+
+          @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

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # A previous result id in a workspace pull request.
       #
+      # @since 3.17.0
+      #
       class PreviousResultId
         def initialize(uri:, value:)
           @attributes = {}
@@ -15,10 +17,10 @@ module LanguageServer
         end
 
         #
-        # The URI for which the client knows a
+        # The URI for which the client knowns a
         # result id.
         #
-        # @return [string]
+        # @return [DocumentUri]
         def uri
           attributes.fetch(:uri)
         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,19 +1,33 @@
 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)
+        def initialize(version_support: nil, related_information: nil, tag_support: nil, code_description_support: nil, data_support: nil)
           @attributes = {}
 
-          @attributes[:relatedInformation] = related_information if related_information
-          @attributes[:tagSupport] = tag_support if tag_support
-          @attributes[:versionSupport] = version_support if version_support
-          @attributes[:codeDescriptionSupport] = code_description_support if code_description_support
-          @attributes[:dataSupport] = data_support if data_support
+          @attributes[:versionSupport] = version_support unless version_support.nil?
+          @attributes[:relatedInformation] = related_information unless related_information.nil?
+          @attributes[:tagSupport] = tag_support unless tag_support.nil?
+          @attributes[:codeDescriptionSupport] = code_description_support unless code_description_support.nil?
+          @attributes[:dataSupport] = data_support unless data_support.nil?
 
           @attributes.freeze
         end
 
+        #
+        # Whether the client interprets the version property of the
+        # `textDocument/publishDiagnostics` notification's parameter.
+        #
+        # @since 3.15.0
+        #
+        # @return [boolean]
+        def version_support
+          attributes.fetch(:versionSupport)
+        end
+
         #
         # Whether the clients accepts diagnostics with related information.
         #
@@ -26,23 +40,18 @@ 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 [ClientDiagnosticsTagOptions]
         def tag_support
           attributes.fetch(:tagSupport)
         end
 
-        #
-        # Whether the client interprets the version property of the
-        # `textDocument/publishDiagnostics` notification's parameter.
-        #
-        # @return [boolean]
-        def version_support
-          attributes.fetch(:versionSupport)
-        end
-
         #
         # Client supports a codeDescription property
         #
+        # @since 3.16.0
+        #
         # @return [boolean]
         def code_description_support
           attributes.fetch(:codeDescriptionSupport)
@@ -53,6 +62,8 @@ module LanguageServer
         # preserved between a `textDocument/publishDiagnostics` and
         # `textDocument/codeAction` request.
         #
+        # @since 3.16.0
+        #
         # @return [boolean]
         def data_support
           attributes.fetch(:dataSupport)

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

@@ -1,12 +1,15 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # The publish diagnostic notification's parameters.
+      #
       class PublishDiagnosticsParams
         def initialize(uri:, version: nil, diagnostics:)
           @attributes = {}
 
           @attributes[:uri] = uri
-          @attributes[:version] = version if version
+          @attributes[:version] = version unless version.nil?
           @attributes[:diagnostics] = diagnostics
 
           @attributes.freeze
@@ -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]
         def version
           attributes.fetch(:version)
         end