language_server-protocol 3.17.0.5 → 3.18.0.0.pre.1

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

@@ -0,0 +1,95 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Capabilities relating to events from file operations by the user in the client.
+      #
+      # These events do not come from the file system, they come from user operations
+      # like renaming a file in the UI.
+      #
+      # @since 3.16.0
+      #
+      class FileOperationClientCapabilities
+        def initialize(dynamic_registration: nil, did_create: nil, will_create: nil, did_rename: nil, will_rename: nil, did_delete: nil, will_delete: nil)
+          @attributes = {}
+
+          @attributes[:dynamicRegistration] = dynamic_registration unless dynamic_registration.nil?
+          @attributes[:didCreate] = did_create unless did_create.nil?
+          @attributes[:willCreate] = will_create unless will_create.nil?
+          @attributes[:didRename] = did_rename unless did_rename.nil?
+          @attributes[:willRename] = will_rename unless will_rename.nil?
+          @attributes[:didDelete] = did_delete unless did_delete.nil?
+          @attributes[:willDelete] = will_delete unless will_delete.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # Whether the client supports dynamic registration for file requests/notifications.
+        #
+        # @return [boolean]
+        def dynamic_registration
+          attributes.fetch(:dynamicRegistration)
+        end
+
+        #
+        # The client has support for sending didCreateFiles notifications.
+        #
+        # @return [boolean]
+        def did_create
+          attributes.fetch(:didCreate)
+        end
+
+        #
+        # The client has support for sending willCreateFiles requests.
+        #
+        # @return [boolean]
+        def will_create
+          attributes.fetch(:willCreate)
+        end
+
+        #
+        # The client has support for sending didRenameFiles notifications.
+        #
+        # @return [boolean]
+        def did_rename
+          attributes.fetch(:didRename)
+        end
+
+        #
+        # The client has support for sending willRenameFiles requests.
+        #
+        # @return [boolean]
+        def will_rename
+          attributes.fetch(:willRename)
+        end
+
+        #
+        # The client has support for sending didDeleteFiles notifications.
+        #
+        # @return [boolean]
+        def did_delete
+          attributes.fetch(:didDelete)
+        end
+
+        #
+        # The client has support for sending willDeleteFiles requests.
+        #
+        # @return [boolean]
+        def will_delete
+          attributes.fetch(:willDelete)
+        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/file_operation_filter.rb

@@ -3,20 +3,22 @@ module LanguageServer
     module Interface
       #
       # A filter to describe in which file operation requests or notifications
-      # the server is interested in.
+      # the server is interested in receiving.
+      #
+      # @since 3.16.0
       #
       class FileOperationFilter
         def initialize(scheme: nil, pattern:)
           @attributes = {}
 
-          @attributes[:scheme] = scheme if scheme
+          @attributes[:scheme] = scheme unless scheme.nil?
           @attributes[:pattern] = pattern
 
           @attributes.freeze
         end
 
         #
-        # A Uri like `file` or `untitled`.
+        # A Uri scheme like `file` or `untitled`.
         #
         # @return [string]
         def scheme

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

@@ -0,0 +1,83 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Options for notifications/requests for user operations on files.
+      #
+      # @since 3.16.0
+      #
+      class FileOperationOptions
+        def initialize(did_create: nil, will_create: nil, did_rename: nil, will_rename: nil, did_delete: nil, will_delete: nil)
+          @attributes = {}
+
+          @attributes[:didCreate] = did_create unless did_create.nil?
+          @attributes[:willCreate] = will_create unless will_create.nil?
+          @attributes[:didRename] = did_rename unless did_rename.nil?
+          @attributes[:willRename] = will_rename unless will_rename.nil?
+          @attributes[:didDelete] = did_delete unless did_delete.nil?
+          @attributes[:willDelete] = will_delete unless will_delete.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # The server is interested in receiving didCreateFiles notifications.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def did_create
+          attributes.fetch(:didCreate)
+        end
+
+        #
+        # The server is interested in receiving willCreateFiles requests.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def will_create
+          attributes.fetch(:willCreate)
+        end
+
+        #
+        # The server is interested in receiving didRenameFiles notifications.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def did_rename
+          attributes.fetch(:didRename)
+        end
+
+        #
+        # The server is interested in receiving willRenameFiles requests.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def will_rename
+          attributes.fetch(:willRename)
+        end
+
+        #
+        # The server is interested in receiving didDeleteFiles file notifications.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def did_delete
+          attributes.fetch(:didDelete)
+        end
+
+        #
+        # The server is interested in receiving willDeleteFiles file requests.
+        #
+        # @return [FileOperationRegistrationOptions]
+        def will_delete
+          attributes.fetch(:willDelete)
+        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/file_operation_pattern.rb

@@ -3,31 +3,29 @@ module LanguageServer
     module Interface
       #
       # A pattern to describe in which file operation requests or notifications
-      # the server is interested in.
+      # the server is interested in receiving.
+      #
+      # @since 3.16.0
       #
       class FileOperationPattern
         def initialize(glob:, matches: nil, options: nil)
           @attributes = {}
 
           @attributes[:glob] = glob
-          @attributes[:matches] = matches if matches
-          @attributes[:options] = options if options
+          @attributes[:matches] = matches unless matches.nil?
+          @attributes[:options] = options unless options.nil?
 
           @attributes.freeze
         end
 
         #
         # The glob pattern to match. Glob patterns can have the following syntax:
-        # - `*` to match one or more characters in a path segment
+        # - `*` to match zero or more characters in a path segment
         # - `?` to match on one character in a path segment
         # - `**` to match any number of path segments, including none
-        # - `{}` to group sub patterns into an OR expression. (e.g. `**​/*.{ts,js}`
-        # matches all TypeScript and JavaScript files)
-        # - `[]` to declare a range of characters to match in a path segment
-        # (e.g., `example.[0-9]` to match on `example.0`, `example.1`, …)
-        # - `[!...]` to negate a range of characters to match in a path segment
-        # (e.g., `example.[!0-9]` to match on `example.a`, `example.b`, but
-        # not `example.0`)
+        # - `{}` to group sub patterns into an OR expression. (e.g. `**​/*.{ts,js}` matches all TypeScript and JavaScript files)
+        # - `[]` to declare a range of characters to match in a path segment (e.g., `example.[0-9]` to match on `example.0`, `example.1`, …)
+        # - `[!...]` to negate a range of characters to match in a path segment (e.g., `example.[!0-9]` to match on `example.a`, `example.b`, but not `example.0`)
         #
         # @return [string]
         def glob

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

@@ -4,11 +4,13 @@ module LanguageServer
       #
       # Matching options for the file operation pattern.
       #
+      # @since 3.16.0
+      #
       class FileOperationPatternOptions
         def initialize(ignore_case: nil)
           @attributes = {}
 
-          @attributes[:ignoreCase] = ignore_case if ignore_case
+          @attributes[:ignoreCase] = ignore_case unless ignore_case.nil?
 
           @attributes.freeze
         end

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

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # The options to register for file operations.
       #
+      # @since 3.16.0
+      #
       class FileOperationRegistrationOptions
         def initialize(filters:)
           @attributes = {}

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

@@ -4,6 +4,8 @@ module LanguageServer
       #
       # Represents information on a file/folder rename.
       #
+      # @since 3.16.0
+      #
       class FileRename
         def initialize(old_uri:, new_uri:)
           @attributes = {}
@@ -15,17 +17,17 @@ module LanguageServer
         end
 
         #
-        # A file:// URI for the original location of the file/folder being renamed.
+        # A URI for the original location of the file/folder being renamed.
         #
-        # @return [string]
+        # @return [DocumentUri]
         def old_uri
           attributes.fetch(:oldUri)
         end
 
         #
-        # A file:// URI for the new location of the file/folder being renamed.
+        # A URI for the new location of the file/folder being renamed.
         #
-        # @return [string]
+        # @return [DocumentUri]
         def new_uri
           attributes.fetch(:newUri)
         end

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

@@ -6,14 +6,15 @@ module LanguageServer
           @attributes = {}
 
           @attributes[:globPattern] = glob_pattern
-          @attributes[:kind] = kind if kind
+          @attributes[:kind] = kind unless kind.nil?
 
           @attributes.freeze
         end
 
         #
-        # The glob pattern to watch. See {@link GlobPattern glob pattern}
-        # for more detail.
+        # The glob pattern to watch. See {@link GlobPattern glob pattern} for more detail.
+        #
+        # @since 3.17.0 support for relative patterns.
         #
         # @return [GlobPattern]
         def glob_pattern
@@ -25,7 +26,7 @@ module LanguageServer
         # to WatchKind.Create | WatchKind.Change | WatchKind.Delete
         # which is 7.
         #
-        # @return [number]
+        # @return [WatchKind]
         def kind
           attributes.fetch(:kind)
         end

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

@@ -2,69 +2,63 @@ module LanguageServer
   module Protocol
     module Interface
       #
-      # Represents a folding range. To be valid, start and end line must be bigger
-      # than zero and smaller than the number of lines in the document. Clients
-      # are free to ignore invalid ranges.
+      # Represents a folding range. To be valid, start and end line must be bigger than zero and smaller
+      # than the number of lines in the document. Clients are free to ignore invalid ranges.
       #
       class FoldingRange
         def initialize(start_line:, start_character: nil, end_line:, end_character: nil, kind: nil, collapsed_text: nil)
           @attributes = {}
 
           @attributes[:startLine] = start_line
-          @attributes[:startCharacter] = start_character if start_character
+          @attributes[:startCharacter] = start_character unless start_character.nil?
           @attributes[:endLine] = end_line
-          @attributes[:endCharacter] = end_character if end_character
-          @attributes[:kind] = kind if kind
-          @attributes[:collapsedText] = collapsed_text if collapsed_text
+          @attributes[:endCharacter] = end_character unless end_character.nil?
+          @attributes[:kind] = kind unless kind.nil?
+          @attributes[:collapsedText] = collapsed_text unless collapsed_text.nil?
 
           @attributes.freeze
         end
 
         #
-        # The zero-based start line of the range to fold. The folded area starts
-        # after the line's last character. To be valid, the end must be zero or
-        # larger and smaller than the number of lines in the document.
+        # The zero-based start line of the range to fold. The folded area starts after the line's last character.
+        # To be valid, the end must be zero or larger and smaller than the number of lines in the document.
         #
-        # @return [number]
+        # @return [uinteger]
         def start_line
           attributes.fetch(:startLine)
         end
 
         #
-        # The zero-based character offset from where the folded range starts. If
-        # not defined, defaults to the length of the start line.
+        # The zero-based character offset from where the folded range starts. If not defined, defaults to the length of the start line.
         #
-        # @return [number]
+        # @return [uinteger]
         def start_character
           attributes.fetch(:startCharacter)
         end
 
         #
-        # The zero-based end line of the range to fold. The folded area ends with
-        # the line's last character. To be valid, the end must be zero or larger
-        # and smaller than the number of lines in the document.
+        # The zero-based end line of the range to fold. The folded area ends with the line's last character.
+        # To be valid, the end must be zero or larger and smaller than the number of lines in the document.
         #
-        # @return [number]
+        # @return [uinteger]
         def end_line
           attributes.fetch(:endLine)
         end
 
         #
-        # The zero-based character offset before the folded range ends. If not
-        # defined, defaults to the length of the end line.
+        # The zero-based character offset before the folded range ends. If not defined, defaults to the length of the end line.
         #
-        # @return [number]
+        # @return [uinteger]
         def end_character
           attributes.fetch(:endCharacter)
         end
 
         #
-        # Describes the kind of the folding range such as `comment` or `region`.
-        # The kind is used to categorize folding ranges and used by commands like
-        # 'Fold all comments'. See [FoldingRangeKind](#FoldingRangeKind) for an
-        # enumeration of standardized kinds.
+        # Describes the kind of the folding range such as 'comment' or 'region'. The kind
+        # is used to categorize folding ranges and used by commands like 'Fold all comments'.
+        # See {@link FoldingRangeKind} for an enumeration of standardized kinds.
         #
-        # @return [string]
+        # @return [FoldingRangeKind]
         def kind
           attributes.fetch(:kind)
         end
@@ -74,6 +68,8 @@ module LanguageServer
         # collapsed. If not defined or not supported by the client, a default
         # will be chosen by the client.
         #
+        # @since 3.17.0
+        #
         # @return [string]
         def collapsed_text
           attributes.fetch(:collapsedText)

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

@@ -5,11 +5,11 @@ module LanguageServer
         def initialize(dynamic_registration: nil, range_limit: nil, line_folding_only: nil, folding_range_kind: nil, folding_range: nil)
           @attributes = {}
 
-          @attributes[:dynamicRegistration] = dynamic_registration if dynamic_registration
-          @attributes[:rangeLimit] = range_limit if range_limit
-          @attributes[:lineFoldingOnly] = line_folding_only if line_folding_only
-          @attributes[:foldingRangeKind] = folding_range_kind if folding_range_kind
-          @attributes[:foldingRange] = folding_range if folding_range
+          @attributes[:dynamicRegistration] = dynamic_registration unless dynamic_registration.nil?
+          @attributes[:rangeLimit] = range_limit unless range_limit.nil?
+          @attributes[:lineFoldingOnly] = line_folding_only unless line_folding_only.nil?
+          @attributes[:foldingRangeKind] = folding_range_kind unless folding_range_kind.nil?
+          @attributes[:foldingRange] = folding_range unless folding_range.nil?
 
           @attributes.freeze
         end
@@ -30,7 +30,7 @@ module LanguageServer
         # per document. The value serves as a hint, servers are free to follow the
         # limit.
         #
-        # @return [number]
+        # @return [uinteger]
         def range_limit
           attributes.fetch(:rangeLimit)
         end
@@ -48,7 +48,9 @@ module LanguageServer
         #
         # Specific options for the folding range kind.
         #
-        # @return [{ valueSet?: string[]; }]
+        # @since 3.17.0
+        #
+        # @return [ClientFoldingRangeKindOptions]
         def folding_range_kind
           attributes.fetch(:foldingRangeKind)
         end
@@ -56,7 +58,9 @@ module LanguageServer
         #
         # Specific options for the folding range.
         #
-        # @return [{ collapsedText?: boolean; }]
+        # @since 3.17.0
+        #
+        # @return [ClientFoldingRangeOptions]
         def folding_range
           attributes.fetch(:foldingRange)
         end

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

@@ -5,7 +5,7 @@ module LanguageServer
         def initialize(work_done_progress: nil)
           @attributes = {}
 
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
 
           @attributes.freeze
         end

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

@@ -1,17 +1,28 @@
 module LanguageServer
   module Protocol
     module Interface
+      #
+      # Parameters for a {@link FoldingRangeRequest}.
+      #
       class FoldingRangeParams
-        def initialize(work_done_token: nil, partial_result_token: nil, text_document:)
+        def initialize(text_document:, work_done_token: nil, partial_result_token: nil)
           @attributes = {}
 
-          @attributes[:workDoneToken] = work_done_token if work_done_token
-          @attributes[:partialResultToken] = partial_result_token if partial_result_token
           @attributes[:textDocument] = text_document
+          @attributes[:workDoneToken] = work_done_token unless work_done_token.nil?
+          @attributes[:partialResultToken] = partial_result_token unless partial_result_token.nil?
 
           @attributes.freeze
         end
 
+        #
+        # The text document.
+        #
+        # @return [TextDocumentIdentifier]
+        def text_document
+          attributes.fetch(:textDocument)
+        end
+
         #
         # An optional token that a server can use to report work done progress.
         #
@@ -21,22 +32,14 @@ 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]
         def partial_result_token
           attributes.fetch(:partialResultToken)
         end
 
-        #
-        # The text document.
-        #
-        # @return [TextDocumentIdentifier]
-        def text_document
-          attributes.fetch(:textDocument)
-        end
-
         attr_reader :attributes
 
         def to_hash

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

@@ -6,17 +6,17 @@ module LanguageServer
           @attributes = {}
 
           @attributes[:documentSelector] = document_selector
-          @attributes[:workDoneProgress] = work_done_progress if work_done_progress
-          @attributes[:id] = id if id
+          @attributes[:workDoneProgress] = work_done_progress unless work_done_progress.nil?
+          @attributes[:id] = id unless id.nil?
 
           @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]
+        # @return [DocumentSelector | nil]
         def document_selector
           attributes.fetch(:documentSelector)
         end

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

@@ -0,0 +1,46 @@
+module LanguageServer
+  module Protocol
+    module Interface
+      #
+      # Client workspace capabilities specific to folding ranges
+      #
+      # @since 3.18.0
+      #
+      class FoldingRangeWorkspaceClientCapabilities
+        def initialize(refresh_support: nil)
+          @attributes = {}
+
+          @attributes[:refreshSupport] = refresh_support unless refresh_support.nil?
+
+          @attributes.freeze
+        end
+
+        #
+        # Whether the client implementation supports a refresh request sent from the
+        # server to the client.
+        #
+        # Note that this event is global and will force the client to refresh all
+        # folding ranges currently shown. It should be used with absolute care and is
+        # useful for situation where a server for example detects a project wide
+        # change that requires such a calculation.
+        #
+        # @since 3.18.0
+        #
+        # @return [boolean]
+        def refresh_support
+          attributes.fetch(:refreshSupport)
+        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/formatting_options.rb

@@ -10,9 +10,9 @@ module LanguageServer
 
           @attributes[:tabSize] = tab_size
           @attributes[:insertSpaces] = insert_spaces
-          @attributes[:trimTrailingWhitespace] = trim_trailing_whitespace if trim_trailing_whitespace
-          @attributes[:insertFinalNewline] = insert_final_newline if insert_final_newline
-          @attributes[:trimFinalNewlines] = trim_final_newlines if trim_final_newlines
+          @attributes[:trimTrailingWhitespace] = trim_trailing_whitespace unless trim_trailing_whitespace.nil?
+          @attributes[:insertFinalNewline] = insert_final_newline unless insert_final_newline.nil?
+          @attributes[:trimFinalNewlines] = trim_final_newlines unless trim_final_newlines.nil?
 
           @attributes.freeze
         end
@@ -20,7 +20,7 @@ module LanguageServer
         #
         # Size of a tab in spaces.
         #
-        # @return [number]
+        # @return [uinteger]
         def tab_size
           attributes.fetch(:tabSize)
         end
@@ -36,6 +36,8 @@ module LanguageServer
         #
         # Trim trailing whitespace on a line.
         #
+        # @since 3.15.0
+        #
         # @return [boolean]
         def trim_trailing_whitespace
           attributes.fetch(:trimTrailingWhitespace)
@@ -44,6 +46,8 @@ module LanguageServer
         #
         # Insert a newline character at the end of the file if one does not exist.
         #
+        # @since 3.15.0
+        #
         # @return [boolean]
         def insert_final_newline
           attributes.fetch(:insertFinalNewline)
@@ -52,6 +56,8 @@ module LanguageServer
         #
         # Trim all newlines after the final newline at the end of the file.
         #
+        # @since 3.15.0
+        #
         # @return [boolean]
         def trim_final_newlines
           attributes.fetch(:trimFinalNewlines)