Enhance LineChartDataset documentation and defaults

Updated the `LineChartDataset` class in `LineChartDataset.cs` to include more descriptive attributes for various properties. Key changes include:
- Added detailed descriptions for properties like `CubicInterpolationMode`, `DrawActiveElementsOnTop`, and `Fill`.
- Explicitly set default values for several properties to improve dataset initialization.
- Enhanced comments for the `ShowLine` and `Stepped` properties to clarify their functionality and possible values.
- Overall improvements to documentation and usability for better developer understanding.

NOTE: This commit message is auto-generated using GitHub Copilot.

Author: gvreddy04

BlazorExpress.ChartJS/Models/ChartDataset/LineChart/LineChartDataset.cs

@@ -1,4 +1,7 @@
-namespace BlazorExpress.ChartJS;
+using System.Diagnostics.Metrics;
+using System.Reflection;
+
+namespace BlazorExpress.ChartJS;
 
 /// <summary>
 /// A line chart is a way of plotting data points on a line. 
@@ -214,7 +217,7 @@ public LineChartDataset FillToValue(double value)
     /// </summary>
     [AddedVersion("1.0.0")]
     [DefaultValue("default")]
-    [Description("")]
+    [Description("Supported values are 'default', and 'monotone'.")]
     public string CubicInterpolationMode { get; set; } = "default";
 
     [AddedVersion("1.0.0")]
@@ -231,8 +234,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Draw the active points of a dataset over the other points of the dataset.")]
     [ParameterTypeName("List<bool>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<bool>? DrawActiveElementsOnTop { get; set; }
@@ -245,7 +248,7 @@ public LineChartDataset FillToValue(double value)
     /// </summary>
     [AddedVersion("1.0.0")]
     [DefaultValue(false)]
-    [Description("")]
+    [Description("How to fill the area under the line.")]
     public object Fill { get; set; } = false;
 
     /// <summary>
@@ -255,8 +258,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("The line fill color when hovered.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public string? HoverBackgroundColor { get; set; }
@@ -268,8 +271,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Cap style of the line when hovered.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public string? HoverBorderCapStyle { get; set; }
@@ -281,21 +284,21 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("The line color when hovered.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public string? HoverBorderColor { get; set; }
 
     /// <summary>
-    /// Gets or sets the length and spacing of dashes when hovered.
+    /// Length and spacing of dashes when hovered.
     /// <para>
     /// Default value is <see langword="null"/>.
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Length and spacing of dashes when hovered.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? HoverBorderDash { get; set; }
@@ -307,33 +310,33 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Offset for line dashes when hovered.")]
     [ParameterTypeName("double?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public double? HoverBorderDashOffset { get; set; }
 
     /// <summary>
-    /// Line joint style. 
+    /// Line joint style when hovered.
     /// There are three possible values for this property: 'round', 'bevel', and 'miter'.
     /// <para>
     /// Default value is 'miter'.
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("miter")]
+    [Description("Line joint style. There are three possible values for this property: 'round', 'bevel', and 'miter'.")]
     public string HoverBorderJoinStyle { get; set; } = "miter";
 
     /// <summary>
-    /// The bar border width when hovered (in pixels) when hovered.
+    /// The line width (in pixels) when hovered.
     /// <para>
     /// Default value is <see langword="null"/>.
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("The line width (in pixels) when hovered.")]
     [ParameterTypeName("double?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public double? HoverBorderWidth { get; set; }
@@ -345,11 +348,11 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("x")]
+    [Description("The base axis of the dataset. 'x' for horizontal lines and 'y' for vertical lines.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
-    public string? IndexAxis { get; set; }
+    public string? IndexAxis { get; set; } = "x";
 
     /// <summary>
     /// The fill color for points.
@@ -358,8 +361,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("rgba(0, 0, 0, 0.1)")]
+    [Description("The fill color for points.")]
     [ParameterTypeName("List<string>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? PointBackgroundColor { get; set; }
@@ -371,8 +374,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("rgba(0, 0, 0, 0.1)")]
+    [Description("The border color for points.")]
     [ParameterTypeName("List<string>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? PointBorderColor { get; set; }
@@ -384,8 +387,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(1)]
+    [Description("The width of the point border in pixels.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointBorderWidth { get; set; }
@@ -397,8 +400,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(1)]
+    [Description("The pixel size of the non-displayed point that reacts to mouse events.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointHitRadius { get; set; }
@@ -410,8 +413,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Point background color when hovered.")]
     [ParameterTypeName("List<string>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? PointHoverBackgroundColor { get; set; }
@@ -423,8 +426,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("Point border color when hovered.")]
     [ParameterTypeName("List<string>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? PointHoverBorderColor { get; set; }
@@ -436,8 +439,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(1)]
+    [Description("Border width of point when hovered.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointHoverBorderWidth { get; set; }
@@ -449,8 +452,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(4)]
+    [Description("The radius of the point when hovered.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointHoverRadius { get; set; }
@@ -462,8 +465,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(3)]
+    [Description("The radius of the point shape. If set to 0, the point is not rendered.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointRadius { get; set; }
@@ -475,23 +478,23 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(0)]
+    [Description("The rotation of the point in degrees.")]
     [ParameterTypeName("List<double>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<double>? PointRotation { get; set; }
 
     /// <summary>
     /// Style of the point.
-    /// Supported values are 'circle', 'cross', 'crossRot', 'dash', 'line', 'rect', 'rectRounded', 'rectRot', 'star', and 'triangle' to style.
-    /// the point.
+    /// Supported values are 'circle', 'cross', 'crossRot', 'dash', 'line', 'rect', 'rectRounded', 'rectRot', 'star', and 'triangle'.
     /// <para>
     /// Default value is 'circle'.
     /// </para>
+    /// <see href="https://www.chartjs.org/docs/latest/configuration/elements.html#point-styles" />
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("circle")]
+    [Description("Style of the point. Supported values are 'circle', 'cross', 'crossRot', 'dash', 'line', 'rect', 'rectRounded', 'rectRot', 'star', and 'triangle'.")]
     [ParameterTypeName("List<string>?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public List<string>? PointStyle { get; set; }
@@ -500,15 +503,14 @@ public LineChartDataset FillToValue(double value)
     //https://www.chartjs.org/docs/latest/charts/line.html#segment
 
     /// <summary>
-    /// If <see langword="false" />, the lines between points are not drawn.
+    /// If <see langword="false" />, the line is not drawn for this dataset.
     /// <para>
     /// Default value is <see langword="true"/>.
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
-    //[ParameterTypeName("")]
+    [DefaultValue(true)]
+    [Description("If false, the line is not drawn for this dataset.")]
     public bool ShowLine { get; set; } = true;
 
     /// <summary>
@@ -521,8 +523,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(null)]
+    [Description("If true, lines will be drawn between points with no or null data. If false, points with null data will create a break in the line. Can also be a number specifying the maximum gap length to span. The unit of the value depends on the scale used.")]
     [ParameterTypeName("bool?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public bool? SpanGaps { get; set; }
@@ -531,15 +533,22 @@ public LineChartDataset FillToValue(double value)
     //https://www.chartjs.org/docs/latest/charts/line.html#general
 
     /// <summary>
-    /// true to show the line as a stepped line (tension will be ignored).
+    /// If the stepped value is set to anything other than <see langword="false"/>, tension will be ignored.
+    /// The following values are supported for stepped.
+    /// - false: No Step Interpolation(default)
+    /// - true: Step-before Interpolation(eq. 'before')
+    /// - 'before': Step-before Interpolation
+    /// - 'after': Step-after Interpolation
+    /// - 'middle': Step-middle Interpolation
     /// <para>
     /// Default value is <see langword="false"/>.
     /// </para>
+    /// <see href="https://www.chartjs.org/docs/latest/charts/line.html#stepped" />
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
-    public bool Stepped { get; set; }
+    [DefaultValue(false)]
+    [Description("If the stepped value is set to anything other than false, tension will be ignored. <br /> <div>The following values are supported for stepped. <ol class=\"pl-4\"><li><b>false</b>: No Step Interpolation(default)</li><li><b>true</b>: Step-before Interpolation(eq. 'before')</li><li><b>'before'</b>: Step-before Interpolation</li><li><b>'after'</b>: Step-after Interpolation</li><li><b>'middle'</b>: Step-middle Interpolation</ol></div>")]
+    public object Stepped { get; set; } = false;
 
     /// <summary>
     /// Bezier curve tension of the line. Set to 0 to draw straight lines.
@@ -549,8 +558,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue(0)]
+    [Description("Bezier curve tension of the line. Set to 0 to draw straightlines. This option is ignored if monotone cubic interpolation is used.")]
     public double Tension { get; set; }
 
     /// <summary>
@@ -560,8 +569,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("Default value is 'first x axis'.")]
+    [Description("The ID of the x-axis to plot this dataset on. Default value is 'first x axis'.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public string? XAxisID { get; set; }
@@ -573,8 +582,8 @@ public LineChartDataset FillToValue(double value)
     /// </para>
     /// </summary>
     [AddedVersion("1.0.0")]
-    [DefaultValue("")]
-    [Description("")]
+    [DefaultValue("Default value is 'first y axis'.")]
+    [Description("The ID of the y-axis to plot this dataset on. Default value is 'first y axis'.")]
     [ParameterTypeName("string?")]
     [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
     public string? YAxisID { get; set; }