Merge branch 'feature/v3_7_0'

Author: matarillo

LanguageServer/Parameters/General/PublishDiagnosticsCapabilities.cs

@@ -0,0 +1,15 @@
+namespace LanguageServer.Parameters.General
+{
+    /// <summary>
+    /// For <c>initialize</c>
+    /// </summary>
+    /// <seealso>Spec 3.7.0</seealso>
+    public class PublishDiagnosticsCapabilities
+    {
+        /// <summary>
+        /// Whether the clients accepts diagnostics with related information.
+        /// </summary>
+        /// <seealso>Spec 3.7.0</seealso>
+        public bool? relatedInformation { get; set; }
+    }
+}

LanguageServer/Parameters/General/TextDocumentClientCapabilities.cs

@@ -3,7 +3,7 @@
     /// <summary>
     /// For <c>initialize</c>
     /// </summary>
-    /// <seealso>Spec 3.4.0</seealso>
+    /// <seealso>Spec 3.7.0</seealso>
     public class TextDocumentClientCapabilities
     {
         /// <summary>
@@ -112,5 +112,11 @@ public class TextDocumentClientCapabilities
         /// Capabilities specific to the <c>textDocument/rename</c>
         /// </summary>
         public RegistrationCapabilities rename { get; set; }
+
+        /// <summary>
+        /// Capabilities specific to <c>textDocument/publishDiagnostics</c>.
+        /// </summary>
+        /// <seealso>Spec 3.7.0</seealso>
+        public PublishDiagnosticsCapabilities publishDiagnostics { get; set; }
     }
 }

LanguageServer/Parameters/TextDocument/CodeActionContext.cs

@@ -1,11 +1,16 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
-
-namespace LanguageServer.Parameters.TextDocument
+namespace LanguageServer.Parameters.TextDocument
 {
+    /// <summary>
+    /// For <c>textDocument/codeAction</c>
+    /// </summary>
+    /// <remarks>
+    /// Contains additional diagnostic information about the context in which a code action is run.
+    /// </remarks>
     public class CodeActionContext
     {
+        /// <summary>
+        /// An array of diagnostics.
+        /// </summary>
         public Diagnostic[] diagnostics { get; set; }
     }
 }

LanguageServer/Parameters/TextDocument/CodeActionParams.cs

@@ -1,8 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Text;
-
-namespace LanguageServer.Parameters.TextDocument
+namespace LanguageServer.Parameters.TextDocument
 {
     /// <summary>
     /// For <c>textDocument/codeAction</c>

LanguageServer/Parameters/TextDocument/Diagnostic.cs

@@ -2,16 +2,49 @@
 
 namespace LanguageServer.Parameters.TextDocument
 {
-    public class Diagnostic
-    {
-        public Range range { get; set; }
+	/// <summary>
+	/// For <c>textDocument/codeAction</c> and <c>textDocument/publishDiagnostics</c>
+	/// </summary>
+	/// <seealso>Spec 3.7.0</seealso>
+	public class Diagnostic
+	{
+		/// <summary>
+		/// The range at which the message applies.
+		/// </summary>
+		public Range range { get; set; }
 
-	    public DiagnosticSeverity? severity { get; set; }
+		/// <summary>
+		/// The diagnostic's severity. Can be omitted.
+		/// </summary>
+		/// <remarks>
+		/// If omitted it is up to the client to interpret diagnostics as error, warning, info or hint.
+		/// </remarks>
+		public DiagnosticSeverity? severity { get; set; }
 
-	    public NumberOrString code { get; set; }
+		/// <summary>
+		/// The diagnostic's code. Can be omitted.
+		/// </summary>
+		public NumberOrString code { get; set; }
 
-        public string source { get; set; }
+		/// <summary>
+		/// A human-readable string describing the source of this diagnostic,
+		/// e.g. <c>'typescript'</c> or <c>'super lint'</c>.
+		/// </summary>
+		public string source { get; set; }
 
-    	public string message { get; set; }
-    }
-}
+		/// <summary>
+		/// The diagnostic's message.
+		/// </summary>
+		public string message { get; set; }
+
+		/// <summary>
+		/// An array of related diagnostic information.
+		/// </summary>
+		/// <remarks>
+		/// e.g. when symbol-names within a scope collide
+		/// all definitions can be marked via this property.
+		/// </remarks>
+		/// <seealso>Spec 3.7.0</seealso>
+		public DiagnosticRelatedInformation[] relatedInformation { get; set; }
+	}
+}

LanguageServer/Parameters/TextDocument/DiagnosticRelatedInformation.cs

@@ -0,0 +1,26 @@
+namespace LanguageServer.Parameters.TextDocument
+{
+    /// <summary>
+    /// Represents a related message and source code location for a diagnostic.
+    /// For <c>textDocument/codeAction</c> and <c>textDocument/publishDiagnostics</c>
+    /// </summary>
+    /// <remarks>
+    /// This should be used to point to code locations that cause or related to a diagnostics,
+    /// e.g when duplicating a symbol in a scope.
+    /// </remarks>
+    /// <seealso>Spec 3.7.0</seealso>
+    public class DiagnosticRelatedInformation
+    {
+        /// <summary>
+        /// The location of this related diagnostic information.
+        /// </summary>
+        /// <seealso>Spec 3.7.0</seealso>
+        public Location location { get; set; }
+
+        /// <summary>
+        /// The message of this related diagnostic information.
+        /// </summary>
+        /// <seealso>Spec 3.7.0</seealso>
+        public string message { get; set; }
+    }
+}

LanguageServer/Parameters/TextDocument/DiagnosticSeverity.cs

@@ -1,10 +1,28 @@
 namespace LanguageServer.Parameters.TextDocument
 {
+    /// <summary>
+    /// Diagnostic severities
+    /// </summary>
     public enum DiagnosticSeverity
     {
+        /// <summary>
+        /// Reports an error.
+        /// </summary>
         Error = 1,
+
+        /// <summary>
+        /// Reports a warning.
+        /// </summary>
         Warning = 2,
+
+        /// <summary>
+        /// Reports an information.
+        /// </summary>
         Information = 3,
+
+        /// <summary>
+        /// Reports a hint.
+        /// </summary>
         Hint = 4,
     }
-}
+}

LanguageServer/Parameters/TextDocument/PublishDiagnosticsParams.cs

@@ -1,13 +1,20 @@
 using System;
-using System.Collections.Generic;
-using System.Text;
 
 namespace LanguageServer.Parameters.TextDocument
 {
+    /// <summary>
+    /// For <c>textDocument/publishDiagnostics</c>
+    /// </summary>
     public class PublishDiagnosticsParams
     {
+        /// <summary>
+        /// The URI for which diagnostic information is reported.
+        /// </summary>
         public Uri uri { get; set; }
 
+        /// <summary>
+        /// An array of diagnostic information items.
+        /// </summary>
         public Diagnostic[] diagnostics { get; set; }
     }
 }