Add comments in C# scripts

Author: asus4

Assets/NativeDialogSample.cs

@@ -2,19 +2,41 @@
 using System.Collections;
 using NativeDialog;
 
+/// <summary>
+/// Sample component demonstrating the usage of native dialog functionality.
+/// Provides various examples of showing select and submit dialogs with different configurations.
+/// </summary>
 public class NativeDialogSample : MonoBehaviour
 {
+    /// <summary>
+    /// Label text for the positive/confirm button in dialogs.
+    /// </summary>
     [SerializeField] private string decideLabel = "Decide";
+    
+    /// <summary>
+    /// Label text for the negative/reject button in dialogs.
+    /// </summary>
     [SerializeField] private string cancelLabel = "Cancel";
+    
+    /// <summary>
+    /// Label text for the close button in submit-only dialogs.
+    /// </summary>
     [SerializeField] private string closeLabel = "Close";
 
+    /// <summary>
+    /// Initializes the dialog labels when the component starts.
+    /// </summary>
     private void Start()
     {
         DialogManager.SetLabel(decideLabel, cancelLabel, closeLabel);
     }
 
     #region Invoked from Unity GUI
 
+    /// <summary>
+    /// Shows a simple selection dialog with OK/Cancel buttons.
+    /// Logs the user's choice to the console.
+    /// </summary>
     public void ShowSelectDialog()
     {
         const string message = "A simple select dialog";
@@ -24,6 +46,10 @@ public void ShowSelectDialog()
         });
     }
 
+    /// <summary>
+    /// Shows a selection dialog with both title and message.
+    /// Useful for providing more context to the user.
+    /// </summary>
     public void ShowSelectDialogWithTitle()
     {
         const string title = "A title";
@@ -34,6 +60,10 @@ public void ShowSelectDialogWithTitle()
         });
     }
 
+    /// <summary>
+    /// Shows a submit-only dialog with a single OK button.
+    /// Used for notifications or acknowledgments.
+    /// </summary>
     public void ShowSubmitDialog()
     {
         const string message = "A simple submit dialog";
@@ -43,6 +73,10 @@ public void ShowSubmitDialog()
         });
     }
 
+    /// <summary>
+    /// Shows a submit dialog with both title and message.
+    /// Provides a more detailed notification to the user.
+    /// </summary>
     public void ShowSubmitDialogWithTitle()
     {
         const string title = "A title";
@@ -53,6 +87,10 @@ public void ShowSubmitDialogWithTitle()
         });
     }
 
+    /// <summary>
+    /// Shows a dialog that automatically dismisses after 3 seconds.
+    /// Demonstrates how to programmatically close dialogs.
+    /// </summary>
     public void ShowDialogWithAutoDismiss()
     {
         const string message = "A dialog with auto dismiss";

Packages/com.github.asus4.nativedialog/Runtime/DialogManager.cs

@@ -5,13 +5,19 @@
 namespace NativeDialog
 {
     /// <summary>
-    /// Popup Native Dialog
+    /// Manages Native Dialog popups across different platforms.
+    /// Provides a unified interface for showing native select and submit dialogs on iOS, Android, and Unity Editor.
     /// </summary>
     public sealed class DialogManager : MonoBehaviour, IDialogReceiver
     {
 
         #region Singleton
         private static DialogManager instance;
+        
+        /// <summary>
+        /// Gets the singleton instance of DialogManager.
+        /// Creates a new instance if one doesn't exist.
+        /// </summary>
         public static DialogManager Instance
         {
             get
@@ -33,10 +39,11 @@ public static DialogManager Instance
 
         #region Members
         private Dictionary<int, Action<bool>> callbacks;
+
         private IDialog dialog;
         #endregion
 
-        #region Lyfecycles
+        #region Lifecycles
         private void Awake()
         {
             if (instance == null)
@@ -92,39 +99,78 @@ private void OnDestroy()
         }
         #endregion
 
+        #region Public Methods
+
+        /// <summary>
+        /// Sets the button labels for all future dialogs.
+        /// </summary>
+        /// <param name="decide">Label for the positive/confirm button</param>
+        /// <param name="cancel">Label for the negative/cancel button</param>
+        /// <param name="close">Label for the close button in submit dialogs</param>
         public static void SetLabel(string decide, string cancel, string close)
         {
             Instance.dialog.SetLabel(decide, cancel, close);
         }
 
+        /// <summary>
+        /// Shows a selection dialog with OK/Cancel buttons.
+        /// </summary>
+        /// <param name="message">The message to display</param>
+        /// <param name="callback">Callback invoked with true for OK, false for Cancel</param>
+        /// <returns>Dialog ID that can be used to dismiss the dialog</returns>
         public static int ShowSelect(string message, Action<bool> callback)
         {
             int id = Instance.dialog.ShowSelect(message);
             Instance.callbacks.Add(id, callback);
             return id;
         }
 
+        /// <summary>
+        /// Shows a selection dialog with title and OK/Cancel buttons.
+        /// </summary>
+        /// <param name="title">The dialog title</param>
+        /// <param name="message">The message to display</param>
+        /// <param name="callback">Callback invoked with true for OK, false for Cancel</param>
+        /// <returns>Dialog ID that can be used to dismiss the dialog</returns>
         public static int ShowSelect(string title, string message, Action<bool> callback)
         {
             int id = Instance.dialog.ShowSelect(title, message);
             Instance.callbacks.Add(id, callback);
             return id;
         }
 
+        /// <summary>
+        /// Shows a submit dialog with only an OK button.
+        /// </summary>
+        /// <param name="message">The message to display</param>
+        /// <param name="callback">Callback invoked when the dialog is closed</param>
+        /// <returns>Dialog ID that can be used to dismiss the dialog</returns>
         public static int ShowSubmit(string message, Action<bool> callback)
         {
             int id = Instance.dialog.ShowSubmit(message);
             Instance.callbacks.Add(id, callback);
             return id;
         }
 
-        public static int ShowSubmit(string title, string message, Action<bool> del)
+        /// <summary>
+        /// Shows a submit dialog with title and only an OK button.
+        /// </summary>
+        /// <param name="title">The dialog title</param>
+        /// <param name="message">The message to display</param>
+        /// <param name="callback">Callback invoked when the dialog is closed</param>
+        /// <returns>Dialog ID that can be used to dismiss the dialog</returns>
+        public static int ShowSubmit(string title, string message, Action<bool> callback)
         {
             int id = Instance.dialog.ShowSubmit(title, message);
-            Instance.callbacks.Add(id, del);
+            Instance.callbacks.Add(id, callback);
             return id;
         }
 
+        /// <summary>
+        /// Programmatically dismisses a dialog.
+        /// Invokes the callback with false (cancelled).
+        /// </summary>
+        /// <param name="id">The ID of the dialog to dismiss</param>
         public static void Dismiss(int id)
         {
             Instance.dialog.Dismiss(id);
@@ -141,6 +187,7 @@ public static void Dismiss(int id)
             }
         }
 
+        #endregion // Public Methods
 
         #region Invoked from Native Plugin
         public void OnSubmit(string idStr)

Packages/com.github.asus4.nativedialog/Runtime/Internal/DialogAndroid.cs

@@ -4,6 +4,9 @@
 
 namespace NativeDialog
 {
+    /// <summary>
+    /// Android-specific implementation of native dialogs using AndroidJavaClass.
+    /// </summary>
     internal sealed class DialogAndroid : IDialog
     {
         private readonly AndroidJavaClass cls;

Packages/com.github.asus4.nativedialog/Runtime/Internal/DialogIOS.cs

@@ -4,6 +4,9 @@
 
 namespace NativeDialog
 {
+    /// <summary>
+    /// iOS-specific implementation of native dialogs using DllImport to call native methods.
+    /// </summary>
     internal sealed class DialogIOS : IDialog
     {
         public void Dispose()

Packages/com.github.asus4.nativedialog/Runtime/Internal/DialogMock.cs

@@ -3,6 +3,10 @@
 
 namespace NativeDialog
 {
+    /// <summary>
+    /// Mock implementation of dialogs for Unity Editor testing.
+    /// Simulates dialog behavior with configurable delays and results.
+    /// </summary>
     internal sealed class DialogMock : MonoBehaviour, IDialog
     {
         [SerializeField]

Packages/com.github.asus4.nativedialog/Runtime/Internal/IDialog.cs

@@ -1,5 +1,9 @@
 namespace NativeDialog
 {
+    /// <summary>
+    /// Interface for platform-specific dialog implementations.
+    /// Defines methods for showing native dialogs across different platforms.
+    /// </summary>
     internal interface IDialog : System.IDisposable
     {
         void SetLabel(string decide, string cancel, string close);

Packages/com.github.asus4.nativedialog/Runtime/Internal/IDialogReceiver.cs

@@ -1,5 +1,9 @@
 namespace NativeDialog
 {
+    /// <summary>
+    /// Interface for receiving callbacks from native dialog implementations.
+    /// Handles user interactions with dialog buttons.
+    /// </summary>
     internal interface IDialogReceiver
     {
         void OnSubmit(string idStr);