Add XML documentation to all public API members

Document all public types, methods, properties, and operators across
the core library and all three rendering packages. Covers Coord types,
model interfaces, readers/writers, renderers, and render contexts.

Author: issus

src/OriginalCircuit.Altium.Rendering.Core/ColorHelper.cs

@@ -16,17 +16,29 @@ public static uint BgrToArgb(int bgrColor)
         return 0xFF000000 | (r << 16) | (g << 8) | b;
     }
 
+    /// <summary>
+    /// Creates a fully opaque ARGB color from individual red, green, and blue components.
+    /// </summary>
     public static uint FromRgb(byte r, byte g, byte b) => 0xFF000000 | ((uint)r << 16) | ((uint)g << 8) | b;
 
-    // Common colors
+    /// <summary>Black (0xFF000000).</summary>
     public const uint Black = 0xFF000000;
+    /// <summary>White (0xFFFFFFFF).</summary>
     public const uint White = 0xFFFFFFFF;
+    /// <summary>Red (0xFFFF0000).</summary>
     public const uint Red = 0xFFFF0000;
+    /// <summary>Green (0xFF00FF00).</summary>
     public const uint Green = 0xFF00FF00;
+    /// <summary>Blue (0xFF0000FF).</summary>
     public const uint Blue = 0xFF0000FF;
+    /// <summary>Yellow (0xFFFFFF00).</summary>
     public const uint Yellow = 0xFFFFFF00;
+    /// <summary>Dark green (0xFF006400).</summary>
     public const uint DarkGreen = 0xFF006400;
+    /// <summary>Dark blue (0xFF00008B).</summary>
     public const uint DarkBlue = 0xFF00008B;
+    /// <summary>Navy (0xFF000080).</summary>
     public const uint Navy = 0xFF000080;
+    /// <summary>Gray (0xFF808080).</summary>
     public const uint Gray = 0xFF808080;
 }

src/OriginalCircuit.Altium.Rendering.Core/CoordTransform.cs

@@ -7,10 +7,29 @@ namespace OriginalCircuit.Altium.Rendering;
 /// </summary>
 public sealed class CoordTransform
 {
+    /// <summary>
+    /// Zoom scale factor applied when converting world units to screen pixels.
+    /// </summary>
     public double Scale { get; set; } = 1.0;
+
+    /// <summary>
+    /// X coordinate of the world-space center point, in raw Altium internal units.
+    /// </summary>
     public double CenterX { get; set; }
+
+    /// <summary>
+    /// Y coordinate of the world-space center point, in raw Altium internal units.
+    /// </summary>
     public double CenterY { get; set; }
+
+    /// <summary>
+    /// Width of the target screen or image in pixels.
+    /// </summary>
     public double ScreenWidth { get; set; }
+
+    /// <summary>
+    /// Height of the target screen or image in pixels.
+    /// </summary>
     public double ScreenHeight { get; set; }
 
     /// <summary>
@@ -22,13 +41,19 @@ public sealed class CoordTransform
     // Altium internal units per mil = 10000 (Coord.FromMils(1).ToRaw() = 10000)
     private const double UnitsPerMil = 10000.0;
 
+    /// <summary>
+    /// Converts world coordinates to screen pixel coordinates, applying scale, centering, and Y-axis inversion.
+    /// </summary>
     public (double x, double y) WorldToScreen(Coord worldX, Coord worldY)
     {
         var sx = (worldX.ToRaw() - CenterX) * Scale + ScreenWidth / 2.0;
         var sy = (CenterY - worldY.ToRaw()) * Scale + ScreenHeight / 2.0; // Y inverted
         return (sx, sy);
     }
 
+    /// <summary>
+    /// Scales a <see cref="Coord"/> value from world units to screen pixel length.
+    /// </summary>
     public double ScaleValue(Coord value) => value.ToRaw() * Scale;
 
     /// <summary>
@@ -54,6 +79,12 @@ public double MapLineWidthEnum(int lineWidthEnum)
         return ScalePixelLength(px);
     }
 
+    /// <summary>
+    /// Computes <see cref="Scale"/>, <see cref="CenterX"/>, and <see cref="CenterY"/> so that
+    /// the given bounding rectangle fits within the screen dimensions.
+    /// </summary>
+    /// <param name="bounds">The world-space bounding rectangle to fit.</param>
+    /// <param name="margin">Fraction of the screen area to use (default 0.95 leaves a 5% margin).</param>
     public void AutoZoom(CoordRect bounds, double margin = 0.95)
     {
         if (bounds.Width.ToRaw() == 0 && bounds.Height.ToRaw() == 0) return;

src/OriginalCircuit.Altium.Rendering.Core/IRenderContext.cs

@@ -37,10 +37,15 @@ public enum TextVAlign
 /// </summary>
 public sealed record TextRenderOptions
 {
+    /// <summary>Font family name (e.g. "Arial").</summary>
     public string FontFamily { get; init; } = "Arial";
+    /// <summary>Whether the font is bold.</summary>
     public bool Bold { get; init; }
+    /// <summary>Whether the font is italic.</summary>
     public bool Italic { get; init; }
+    /// <summary>Horizontal text alignment relative to the anchor point.</summary>
     public TextHAlign HorizontalAlignment { get; init; } = TextHAlign.Left;
+    /// <summary>Vertical text alignment relative to the anchor point.</summary>
     public TextVAlign VerticalAlignment { get; init; } = TextVAlign.Baseline;
 }
 
@@ -55,57 +60,83 @@ public sealed record TextRenderOptions
 /// </summary>
 public interface IRenderContext
 {
+    /// <summary>Clears the entire canvas with the specified background color.</summary>
     void Clear(uint argbColor);
 
+    /// <summary>Draws a line between two points.</summary>
     void DrawLine(double x1, double y1, double x2, double y2, uint color, double width,
         LineStyle style = LineStyle.Solid);
 
+    /// <summary>Draws an elliptical arc.</summary>
     void DrawArc(double cx, double cy, double rx, double ry, double startAngle, double sweepAngle,
         uint color, double width);
 
+    /// <summary>Draws a rectangle outline.</summary>
     void DrawRectangle(double x, double y, double width, double height, uint color, double lineWidth);
+    /// <summary>Fills a rectangle.</summary>
     void FillRectangle(double x, double y, double width, double height, uint color);
 
+    /// <summary>Draws a rounded rectangle outline with independent corner radii.</summary>
     void DrawRoundedRectangle(double x, double y, double width, double height,
         double cornerRadiusX, double cornerRadiusY, uint color, double lineWidth);
 
+    /// <summary>Fills a rounded rectangle.</summary>
     void FillRoundedRectangle(double x, double y, double width, double height,
         double cornerRadius, uint color);
 
+    /// <summary>Draws an ellipse outline.</summary>
     void DrawEllipse(double cx, double cy, double rx, double ry, uint color, double width);
+    /// <summary>Fills an ellipse.</summary>
     void FillEllipse(double cx, double cy, double rx, double ry, uint color);
 
+    /// <summary>Draws a closed polygon outline.</summary>
     void DrawPolygon(ReadOnlySpan<double> xPoints, ReadOnlySpan<double> yPoints, uint color, double width);
+    /// <summary>Fills a closed polygon.</summary>
     void FillPolygon(ReadOnlySpan<double> xPoints, ReadOnlySpan<double> yPoints, uint color);
 
+    /// <summary>Draws an open polyline through the given points.</summary>
     void DrawPolyline(ReadOnlySpan<double> xPoints, ReadOnlySpan<double> yPoints, uint color, double width,
         LineStyle style = LineStyle.Solid);
 
+    /// <summary>Draws a cubic bezier curve.</summary>
     void DrawBezier(double x0, double y0, double x1, double y1, double x2, double y2,
         double x3, double y3, uint color, double width);
 
+    /// <summary>Fills a pie (arc sector) shape.</summary>
     void FillPie(double cx, double cy, double rx, double ry, double startAngle, double sweepAngle,
         uint color);
 
+    /// <summary>Draws a pie (arc sector) outline.</summary>
     void DrawPie(double cx, double cy, double rx, double ry, double startAngle, double sweepAngle,
         uint color, double lineWidth);
 
+    /// <summary>Draws text at the specified position using the given font family.</summary>
     void DrawText(string text, double x, double y, double fontSize, uint color,
         string fontFamily = "Arial");
 
+    /// <summary>Draws text at the specified position using detailed text rendering options.</summary>
     void DrawText(string text, double x, double y, double fontSize, uint color,
         TextRenderOptions options);
 
+    /// <summary>Measures the dimensions of the specified text without rendering it.</summary>
     TextMetrics MeasureText(string text, double fontSize, TextRenderOptions? options = null);
 
+    /// <summary>Draws a raster image from raw byte data into the specified rectangle.</summary>
     void DrawImage(ReadOnlySpan<byte> imageData, double x, double y, double width, double height);
 
+    /// <summary>Sets a rectangular clipping region.</summary>
     void SetClipRect(double x, double y, double w, double h);
+    /// <summary>Resets the clipping region to the full canvas.</summary>
     void ResetClip();
 
+    /// <summary>Saves the current graphics state (transform, clip) onto a stack.</summary>
     void SaveState();
+    /// <summary>Restores the most recently saved graphics state from the stack.</summary>
     void RestoreState();
+    /// <summary>Applies a translation to the current transform.</summary>
     void Translate(double dx, double dy);
+    /// <summary>Applies a rotation (in degrees) to the current transform.</summary>
     void Rotate(double angleDegrees);
+    /// <summary>Applies a scale to the current transform.</summary>
     void Scale(double sx, double sy);
 }

src/OriginalCircuit.Altium.Rendering.Core/PcbComponentRenderer.cs

@@ -11,11 +11,20 @@ public sealed class PcbComponentRenderer
 {
     private readonly CoordTransform _transform;
 
+    /// <summary>
+    /// Initializes a new instance of <see cref="PcbComponentRenderer"/> with the specified coordinate transform.
+    /// </summary>
+    /// <param name="transform">The coordinate transform used to map world coordinates to screen coordinates.</param>
     public PcbComponentRenderer(CoordTransform transform)
     {
         _transform = transform ?? throw new ArgumentNullException(nameof(transform));
     }
 
+    /// <summary>
+    /// Renders all primitives of a PCB component to the specified context, sorted by layer draw priority.
+    /// </summary>
+    /// <param name="component">The PCB component to render.</param>
+    /// <param name="context">The render context to draw into.</param>
     public void Render(IPcbComponent component, IRenderContext context)
     {
         ArgumentNullException.ThrowIfNull(component);