Add remaining XML doc

Author: xoofx

samples/ControlsDemo/Demos/RadioButtonDemo.cs

@@ -15,9 +15,9 @@ public override Visual Build(DemoContext context)
         // Radio buttons are grouped by an arbitrary key object.
         var group = new object();
 
-        var a = new RadioButton("Choice A").Group(group).IsChecked(true);
-        var b = new RadioButton("Choice B").Group(group);
-        var c = new RadioButton("Choice C").Group(group);
+        var a = new RadioButton("Choice A").GroupBy(group).IsChecked(true);
+        var b = new RadioButton("Choice B").GroupBy(group);
+        var c = new RadioButton("Choice C").GroupBy(group);
 
         string Selected()
         {

src/XenoAtom.Terminal.UI/Controls/Center.cs

@@ -12,8 +12,12 @@
 
 namespace XenoAtom.Terminal.UI.Controls;
 
+/// <summary>
+/// Centers its content within the available bounds.
+/// </summary>
 public sealed partial class Center : ContentVisual
 {
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         var content = Content;
@@ -25,6 +29,7 @@ protected override SizeHints MeasureCore(in LayoutConstraints constraints)
         return content.Measure(constraints);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         Bounds = finalRect;

src/XenoAtom.Terminal.UI/Controls/Collapsible.cs

@@ -39,6 +39,9 @@ public sealed partial class Collapsible : Visual
     private Rectangle _headerRect;
     private Rectangle _contentRect;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Collapsible"/> class.
+    /// </summary>
     public Collapsible()
     {
         Focusable = true;

src/XenoAtom.Terminal.UI/Controls/CommandPalette.cs

@@ -22,6 +22,9 @@ public sealed class CommandPalette : Visual
     private readonly List<CommandPaletteItem> _visibleItems;
     private int _resultsHeight = 8;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="CommandPalette"/> class.
+    /// </summary>
     public CommandPalette()
     {
         Focusable = false;
@@ -59,8 +62,14 @@ public CommandPalette()
         _results.Update(_ => RebuildResults());
     }
 
+    /// <summary>
+    /// Gets the collection of command palette items.
+    /// </summary>
     public BindableList<CommandPaletteItem> Items { get; }
 
+    /// <summary>
+    /// Gets or sets the number of visible result rows.
+    /// </summary>
     public int ResultsHeight
     {
         get => _resultsHeight;
@@ -72,6 +81,9 @@ public int ResultsHeight
         }
     }
 
+    /// <summary>
+    /// Shows the command palette in a popup.
+    /// </summary>
     public void Show()
     {
         VerifyAccess();
@@ -91,17 +103,24 @@ public void Show()
         _hostPopup.Show();
     }
 
+    /// <summary>
+    /// Closes the command palette popup if it is open.
+    /// </summary>
     public void Close() => _hostPopup?.Close();
 
+    /// <inheritdoc />
     protected override int ChildrenCount => 1;
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index) => index == 0 ? _frame : throw new ArgumentOutOfRangeException(nameof(index));
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         return _frame.Measure(constraints);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         _frame.Arrange(finalRect);

src/XenoAtom.Terminal.UI/Controls/ComputedVisual.cs

@@ -12,8 +12,15 @@
 
 namespace XenoAtom.Terminal.UI.Controls;
 
+/// <summary>
+/// Represents a visual whose content is produced by a dynamic builder function.
+/// </summary>
 public sealed partial class ComputedVisual : Visual
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ComputedVisual"/> class.
+    /// </summary>
+    /// <param name="build">The function that builds the child visual.</param>
     public ComputedVisual(Func<Visual?> build)
     {
         this.Child(build);
@@ -23,9 +30,13 @@ public ComputedVisual(Func<Visual?> build)
         this.VerticalAlignment(() => _child?.VerticalAlignment ?? VerticalAlignment.Stretch);
     }
 
+    /// <summary>
+    /// Gets or sets the computed child visual.
+    /// </summary>
     [Bindable]
     public partial Visual? Child { get; set; }
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         var child = Child;
@@ -37,6 +48,7 @@ protected override SizeHints MeasureCore(in LayoutConstraints constraints)
         return child.Measure(constraints);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         var child = Child;
@@ -50,8 +62,10 @@ protected override void ArrangeCore(in Rectangle finalRect)
         child.Arrange(finalRect);
     }
 
+    /// <inheritdoc />
     protected override int ChildrenCount => _child is null ? 0 : 1;
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index)
     {
         if (index == 0 && _child is not null)

src/XenoAtom.Terminal.UI/Controls/ContentSwitcher.cs

@@ -16,20 +16,29 @@ public sealed partial class ContentSwitcher : Panel
 {
     private Visual? _active;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ContentSwitcher"/> class.
+    /// </summary>
     public ContentSwitcher()
     {
         this.SelectedIndex(0);
     }
 
+    /// <summary>
+    /// Gets or sets the index of the active child.
+    /// </summary>
     [Bindable]
     public partial int SelectedIndex { get; set; }
 
+    /// <inheritdoc />
     protected override int ChildrenCount
         => TryGetActiveChild(out _) ? 1 : 0;
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index)
         => index == 0 && TryGetActiveChild(out var child) ? child : throw new ArgumentOutOfRangeException(nameof(index));
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         if (!TryGetActiveChild(out var child))
@@ -40,6 +49,7 @@ protected override SizeHints MeasureCore(in LayoutConstraints constraints)
         return child.Measure(constraints);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         if (!TryGetActiveChild(out var child))

src/XenoAtom.Terminal.UI/Controls/ContentVisual.cs

@@ -12,20 +12,27 @@ namespace XenoAtom.Terminal.UI.Controls;
 /// </summary>
 public abstract partial class ContentVisual : Visual
 {
+    /// <summary>
+    /// Gets or sets the single content visual.
+    /// </summary>
     [Bindable]
     public partial Visual? Content { get; set; }
 
+    /// <inheritdoc />
     protected override int ChildrenCount => _content is null ? 0 : 1;
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index)
         => index == 0 && _content is not null ? _content : throw new ArgumentOutOfRangeException(nameof(index));
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         var content = Content;
         return content is null ? SizeHints.Fixed(Size.Zero) : content.Measure(constraints);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         Bounds = finalRect;

src/XenoAtom.Terminal.UI/Controls/DockLayout.cs

@@ -12,23 +12,39 @@
 
 namespace XenoAtom.Terminal.UI.Controls;
 
+/// <summary>
+/// Arranges top, bottom, and content regions in a vertical dock layout.
+/// </summary>
 public sealed partial class DockLayout : Visual
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="DockLayout"/> class.
+    /// </summary>
     public DockLayout()
     {
         HorizontalAlignment = HorizontalAlignment.Stretch;
         VerticalAlignment = VerticalAlignment.Stretch;
     }
 
+    /// <summary>
+    /// Gets or sets the top region content.
+    /// </summary>
     [Bindable]
     public partial Visual? Top { get; set; }
 
+    /// <summary>
+    /// Gets or sets the bottom region content.
+    /// </summary>
     [Bindable]
     public partial Visual? Bottom { get; set; }
 
+    /// <summary>
+    /// Gets or sets the main content region.
+    /// </summary>
     [Bindable]
     public partial Visual? Content { get; set; }
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         var top = Top;
@@ -83,6 +99,7 @@ protected override SizeHints MeasureCore(in LayoutConstraints constraints)
             shrinkY: contentHints.FlexShrinkY).Normalize();
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         Bounds = finalRect;
@@ -115,6 +132,7 @@ protected override void ArrangeCore(in Rectangle finalRect)
         }
     }
 
+    /// <inheritdoc />
     protected override int ChildrenCount
     {
         get
@@ -127,6 +145,7 @@ protected override int ChildrenCount
         }
     }
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index)
     {
         if ((uint)index >= (uint)ChildrenCount)

src/XenoAtom.Terminal.UI/Controls/Footer.cs

@@ -10,25 +10,42 @@
 
 namespace XenoAtom.Terminal.UI.Controls;
 
+/// <summary>
+/// Represents a footer bar with left, center, and right slots.
+/// </summary>
 public sealed partial class Footer : Visual
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Footer"/> class.
+    /// </summary>
     public Footer()
     {
         HorizontalAlignment = HorizontalAlignment.Stretch;
     }
 
+    /// <summary>
+    /// Gets or sets the left-aligned content.
+    /// </summary>
     [Bindable]
     public partial Visual? Left { get; set; }
 
+    /// <summary>
+    /// Gets or sets the centered content.
+    /// </summary>
     [Bindable]
     public partial Visual? Center { get; set; }
 
+    /// <summary>
+    /// Gets or sets the right-aligned content.
+    /// </summary>
     [Bindable]
     public partial Visual? Right { get; set; }
 
+    /// <inheritdoc />
     protected override int ChildrenCount
         => (_left is null ? 0 : 1) + (_center is null ? 0 : 1) + (_right is null ? 0 : 1);
 
+    /// <inheritdoc />
     protected override Visual GetChild(int index)
     {
         if (_left is not null)
@@ -51,6 +68,7 @@ protected override Visual GetChild(int index)
         throw new ArgumentOutOfRangeException(nameof(index));
     }
 
+    /// <inheritdoc />
     protected override SizeHints MeasureCore(in LayoutConstraints constraints)
     {
         var labelConstraints = new LayoutConstraints(0, LayoutConstants.Infinite, 0, 1);
@@ -72,6 +90,7 @@ protected override SizeHints MeasureCore(in LayoutConstraints constraints)
         return SizeHints.FlexX(min: new Size(0, 1), natural: natural, growX: 1, shrinkX: 1);
     }
 
+    /// <inheritdoc />
     protected override void ArrangeCore(in Rectangle finalRect)
     {
         var left = _left;
@@ -101,6 +120,7 @@ protected override void ArrangeCore(in Rectangle finalRect)
         }
     }
 
+    /// <inheritdoc />
     protected override void RenderOverride(CellBuffer buffer)
     {
         var rect = Bounds;