Added comments.

Author: TiLied

CSharpToJavaScript/APIs/JS/GlobalObject.cs

@@ -4,44 +4,120 @@ namespace CSharpToJavaScript.APIs.JS.Ecma;
 
 public partial class GlobalObject
 {
+	/// <summary>
+	/// Translates this method into the "===" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_equality
+	/// </remarks>
+	/// <param name="left">x</param>
+	/// <param name="right">y</param>
+	/// <returns></returns>
 	[Binary("===")]
 	public static bool EqualsStrict(dynamic left, dynamic right)
 	{
 		return left == right;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "!==" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Strict_inequality
+	/// </remarks>
+	/// <param name="left">x</param>
+	/// <param name="right">y</param>
+	/// <returns></returns>
 	[Binary("!==")]
 	public static bool InequalsStrict(dynamic left, dynamic right)
 	{
 		return left != right;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "delete" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/delete
+	/// </remarks>
+	/// <param name="arg">object.property</param>
+	/// <returns>true for all cases except when the property is an own non-configurable property, in which case false is returned in non-strict mode.</returns>
 	[Unary("delete ")]
 	public static bool Delete(dynamic arg)
 	{
 		return true;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "void" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/void
+	/// </remarks>
+	/// <param name="arg">expression</param>
+	/// <returns>Undefined</returns>
 	[Unary("void ")]
 	public static Undefined Void(dynamic arg)
 	{
 		return new Undefined();
 	}
+	
+	/// <summary>
+	/// Translates this method into the "typeof" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof
+	/// </remarks>
+	/// <param name="operand">An expression representing the object or primitive whose type is to be returned.</param>
+	/// <returns>string</returns>
 	[Unary("typeof ")]
-	public static string TypeOf(dynamic arg)
+	public static string TypeOf(dynamic operand)
 	{
 		return string.Empty;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "instanceof" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof
+	/// </remarks>
+	/// <param name="obj">The object to test.</param>
+	/// <param name="constructor">Constructor to test against.</param>
+	/// <returns>bool</returns>
 	[Binary("instanceof")]
-	public static bool InstanceOf(dynamic left, dynamic right)
+	public static bool InstanceOf(dynamic obj, dynamic constructor)
 	{
 		return true;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "in" operator.
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/in
+	/// </remarks>
+	/// <param name="prop">A string or symbol representing a property name (non-symbols will be coerced to strings). Can also be a private element identifier.</param>
+	/// <param name="obj">Object to check if it (or its prototype chain) contains the property with specified name (prop).</param>
+	/// <returns>bool</returns>
 	[Binary("in")]
-	public static bool In(dynamic left, dynamic right)
+	public static bool In(dynamic prop, dynamic obj)
 	{
 		return true;
 	}
+	
+	/// <summary>
+	/// Translates this method into the "," operator. (As a binary)
+	/// </summary>
+	/// <remarks>
+	/// See mdn: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Comma_operator
+	/// </remarks>
+	/// <param name="expr1">First expression.</param>
+	/// <param name="expr2">Second expression.</param>
+	/// <returns>dynamic</returns>
 	[Binary(",")]
-	public static dynamic Comma(dynamic left, dynamic right)
+	public static dynamic Comma(dynamic expr1, dynamic expr2)
 	{
-		return right;
+		return expr2;
 	}
 }

CSharpToJavaScript/Utils/Attributes.cs

@@ -2,11 +2,18 @@
 
 namespace CSharpToJavaScript.Utils;
 
+/// <summary>
+/// 
+/// </summary>
 [AttributeUsage(AttributeTargets.Class)]
 internal class IgnoreAttribute : Attribute
 {
 	public IgnoreAttribute() { }
 }
+
+/// <summary>
+/// Translates class/method to a specified value.
+/// </summary>
 [AttributeUsage(AttributeTargets.All)]
 public class ValueAttribute : Attribute
 {
@@ -17,6 +24,17 @@ public ValueAttribute(string value)
 	}
 }
 
+/// <summary>
+/// Changes class/method based on options.
+/// </summary>
+/// <remarks>
+/// Default: do nothing.<br />
+/// ToLower: convert to lowercase.<br />
+/// FirstCharToLowerCase: convert the first char to lowercase.<br />
+/// None: convert to empty.<br />
+/// NoneWithLeadingDotRemoved: convert to empty with the leading dot removed.<br />
+/// NoneWithTailingDotRemoved: convert to empty with the trailing dot removed.<br />
+/// </remarks>
 [AttributeUsage(AttributeTargets.All)]
 public class ToAttribute : Attribute
 {
@@ -52,6 +70,9 @@ public string Convert(string str)
 	}
 }
 
+/// <summary>
+/// Translates a method into a binary operator.
+/// </summary>
 [AttributeUsage(AttributeTargets.All)]
 public class BinaryAttribute : Attribute
 {
@@ -61,6 +82,10 @@ public BinaryAttribute(string value)
 		Value = value;
 	}
 }
+
+/// <summary>
+/// Translates a method into an unary operator.
+/// </summary>
 [AttributeUsage(AttributeTargets.All)]
 public class UnaryAttribute : Attribute
 {
@@ -70,6 +95,10 @@ public UnaryAttribute(string value)
 		Value = value;
 	}
 }
+
+/// <summary>
+/// Translates a class into a JS object.
+/// </summary>
 [AttributeUsage(AttributeTargets.All)]
 public class ToObjectAttribute : Attribute
 {