mass update xml documentation

Author: pwelter34

samples/Sample.Core/Pages/Loading/Index.razor

@@ -18,13 +18,11 @@
 
 <h3>Block Mode - No Content</h3>
 
-<LoadingBlock IsLoading="IsLoading"
-              LoadingText="Loading ..." />
+<LoadingBlock IsLoading="IsLoading" />
 
 <h3>Block Mode - With Content</h3>
 
-<LoadingBlock IsLoading="IsLoading"
-              LoadingText="Loading ...">
+<LoadingBlock IsLoading="IsLoading">
     <EditForm Model="Register">
         <DataAnnotationsValidator />
         <ValidationSummary />
@@ -79,15 +77,13 @@
     </EditForm>
 
     <LoadingBlock IsLoading="IsLoading"
-                  LoadingText="Loading ..."
                   ShowOverlay="true" />
 </div>
 
 
 <h3>Overlay Mode - With Content</h3>
 
 <LoadingBlock IsLoading="IsLoading"
-              LoadingText="Loading ..."
               ShowOverlay="true">
     <EditForm Model="Register">
         <DataAnnotationsValidator />

src/LoreSoft.Blazor.Controls/Buttons/BusyButton.cs

@@ -6,33 +6,67 @@
 
 namespace LoreSoft.Blazor.Controls;
 
+/// <summary>
+/// A button component that displays a busy indicator and disables itself while an operation is in progress.
+/// </summary>
 public class BusyButton : ComponentBase
 {
+    /// <summary>
+    /// Indicates whether the button is busy. When <c>true</c>, the busy indicator is shown and the button is disabled.
+    /// </summary>
     [Parameter]
     public bool Busy { get; set; }
 
+    /// <summary>
+    /// Indicates whether the button is disabled. When <c>true</c>, the button cannot be clicked.
+    /// </summary>
     [Parameter]
     public bool Disabled { get; set; }
 
+    /// <summary>
+    /// The text to display when the button is busy. This text is shown in the busy template if no custom template is provided. Defaults to "Processing".
+    /// </summary>
     [Parameter]
     public string BusyText { get; set; } = "Processing";
 
+    /// <summary>
+    /// Custom template to display when the button is busy. If not set, a default template is used.
+    /// </summary>
     [Parameter]
     public RenderFragment? BusyTemplate { get; set; }
 
+    /// <summary>
+    /// The content to display inside the button when it is not busy.
+    /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
+    /// <summary>
+    /// Additional attributes to be applied to the button element.
+    /// </summary>
     [Parameter(CaptureUnmatchedValues = true)]
     public Dictionary<string, object> AdditionalAttributes { get; set; } = [];
 
+    /// <summary>
+    /// The event callback to trigger when the button is clicked. Automatically sets the button to busy while executing.
+    /// </summary>
     [Parameter]
     public EventCallback Trigger { get; set; }
 
+    /// <summary>
+    /// Indicates whether the button is currently executing the trigger callback.
+    /// </summary>
     private bool Executing { get; set; }
 
+    /// <summary>
+    /// The CSS class name for the button element. Computed based on AdditionalAttributes and default class.
+    /// </summary>
     protected string? ClassName { get; set; }
 
+    /// <summary>
+    /// Builds the render tree for the BusyButton component.
+    /// </summary>
+    /// <param name="builder">The <see cref="RenderTreeBuilder"/> used to build the component's render tree.</param>
     protected override void BuildRenderTree(RenderTreeBuilder builder)
     {
         builder.OpenElement(0, "button");
@@ -58,6 +92,9 @@ protected override void BuildRenderTree(RenderTreeBuilder builder)
         builder.CloseElement(); // button
     }
 
+    /// <summary>
+    /// Sets parameters and updates the CSS class name and default busy template.
+    /// </summary>
     protected override void OnParametersSet()
     {
         base.OnParametersSet();
@@ -89,8 +126,14 @@ protected override void OnParametersSet()
         };
     }
 
+    /// <summary>
+    /// Gets a value indicating whether the button is busy, either by the <see cref="Busy"/> parameter or while executing the trigger.
+    /// </summary>
     protected bool IsBusy => Busy || Executing;
 
+    /// <summary>
+    /// Executes the <see cref="Trigger"/> callback and manages the busy state.
+    /// </summary>
     private async Task ExecuteTrigger()
     {
         if (!Trigger.HasDelegate)

src/LoreSoft.Blazor.Controls/Conditional/Conditional.cs

@@ -3,41 +3,61 @@
 
 namespace LoreSoft.Blazor.Controls;
 
+/// <summary>
+/// Renders content conditionally based on a boolean value.
+/// </summary>
 public class Conditional : ComponentBase
 {
+    /// <summary>
+    /// The condition to evaluate. If <c>true</c>, <see cref="Passed"/> or <see cref="ChildContent"/> is rendered; otherwise, <see cref="Failed"/> is rendered.
+    /// </summary>
     [Parameter]
     public bool Condition { get; set; }
 
+    /// <summary>
+    /// The default content to render when <see cref="Condition"/> is <c>true</c> and <see cref="Passed"/> is not set.
+    /// </summary>
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
+    /// <summary>
+    /// The content to render when <see cref="Condition"/> is <c>true</c>. If set, <see cref="ChildContent"/> is ignored.
+    /// </summary>
     [Parameter]
     public RenderFragment? Passed { get; set; }
 
+    /// <summary>
+    /// The content to render when <see cref="Condition"/> is <c>false</c>.
+    /// </summary>
     [Parameter]
     public RenderFragment? Failed { get; set; }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Builds the render tree for the <see cref="Conditional"/> component.
+    /// </summary>
+    /// <param name="builder">The <see cref="RenderTreeBuilder"/> used to build the component's render tree.</param>
     protected override void BuildRenderTree(RenderTreeBuilder builder)
     {
         if (Condition)
         {
             if (Passed != null)
             {
-                builder.AddContent(1, Passed);
+                builder.AddContent(0, Passed);
             }
             else if (ChildContent != null)
             {
-                builder.AddContent(2, ChildContent);
+                builder.AddContent(1, ChildContent);
             }
         }
         else if (Failed != null)
         {
-            builder.AddContent(3, Failed);
+            builder.AddContent(2, Failed);
         }
     }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Called when component parameters are set. Throws if both <see cref="Passed"/> and <see cref="ChildContent"/> are specified.
+    /// </summary>
     protected override void OnParametersSet()
     {
         base.OnParametersSet();