Remove attributes and update ChartComponentBase methods

This commit removes the `AddedVersionAttribute` and `ParameterTypeNameAttribute` classes. The `BlazorExpress.Core` package version is updated from `0.0.4` to `0.1.0`. Several new asynchronous methods are added to the `ChartComponentBase` class, including `AddDataAsync`, `AddDatasetAsync`, and `InitializeAsync`, all marked with the `AddedVersion("1.0.0")` attribute. The `ResizeAsync` and `UpdateAsync` methods are updated with detailed XML documentation and versioning. New properties `Height` and `Width` are introduced, both marked with `AddedVersion("1.0.0")` and `ParameterTypeName("int?")`.

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

Author: gvreddy04

BlazorExpress.ChartJS/Attributes/AddedVersionAttribute.cs

@@ -32,7 +32,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="BlazorExpress.Core" Version="0.0.4" />
+    <PackageReference Include="BlazorExpress.Core" Version="0.1.0" />
     <PackageReference Include="Microsoft.AspNetCore.Components.Web" Version="8.0.17" />
   </ItemGroup>
 

BlazorExpress.ChartJS/Attributes/ParameterTypeNameAttribute.cs

@@ -26,20 +26,55 @@ public abstract class ChartComponentBase : BlazorExpressComponentCore, IDisposab
 
     //public async Task ToBase64Image(string type, double quality) { }
 
+    /// <summary>
+    /// Asynchronously adds a new data entry to the specified chart data.
+    /// </summary>
+    /// <param name="chartData">The chart data to which the new entry will be added.</param>
+    /// <param name="dataLabel">The label associated with the new data entry.</param>
+    /// <param name="data">The dataset containing the data to be added.</param>
+    /// <returns>A task representing the asynchronous operation, with a result of the updated <see cref="ChartData"/>.</returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously adds a new data entry to the specified chart data.")]
     public virtual async Task<ChartData> AddDataAsync(ChartData chartData, string dataLabel, IChartDatasetData data) => await Task.FromResult(chartData);
 
+    /// <summary>
+    /// Asynchronously adds a new dataset to the specified chart data.
+    /// </summary>
+    /// <param name="chartData">The chart data to which the dataset will be added.</param>
+    /// <param name="dataLabel">The label for the new dataset.</param>
+    /// <param name="data">A read-only collection of data points to be included in the new dataset.</param>
+    /// <returns>A task that represents the asynchronous operation. The task result contains the updated chart data with the new
+    /// dataset added.</returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously adds a new dataset to the specified chart data.")]
     public virtual async Task<ChartData> AddDataAsync(ChartData chartData, string dataLabel, IReadOnlyCollection<IChartDatasetData> data) => await Task.FromResult(chartData);
 
+    /// <summary>
+    /// Asynchronously adds a dataset to the specified chart data.
+    /// </summary>
+    /// <param name="chartData">The chart data to which the dataset will be added.</param>
+    /// <param name="chartDataset">The dataset to add to the chart data.</param>
+    /// <param name="chartOptions">The options that configure the chart's appearance and behavior.</param>
+    /// <returns>A task that represents the asynchronous operation. The task result contains the updated chart data with the new
+    /// dataset added.</returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously adds a dataset to the specified chart data.")]
     public virtual async Task<ChartData> AddDatasetAsync(ChartData chartData, IChartDataset chartDataset, IChartOptions chartOptions) => await Task.FromResult(chartData);
 
     //public async Task Clear() { }
 
     /// <summary>
-    /// Initialize the chart.
+    /// Asynchronously initializes the chart with the specified data and options.
     /// </summary>
-    /// <param name="chartData"></param>
-    /// <param name="chartOptions"></param>
-    /// <param name="plugins"></param>
+    /// <remarks>This method prepares the chart for rendering by invoking the necessary JavaScript functions
+    /// to set up the chart with the provided data and options. Ensure that <paramref name="chartData"/> contains valid
+    /// datasets before calling this method.</remarks>
+    /// <param name="chartData">The data to be used for the chart. Must contain at least one dataset.</param>
+    /// <param name="chartOptions">The options to configure the chart's appearance and behavior.</param>
+    /// <param name="plugins">An optional array of plugin identifiers to enhance the chart's functionality.</param>
+    /// <returns>A task that represents the asynchronous initialization operation.</returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously initializes the chart with the specified data and options.")]
     public virtual async Task InitializeAsync(ChartData chartData, IChartOptions chartOptions, string[]? plugins = null)
     {
         if (chartData is not null && chartData.Datasets is not null && chartData.Datasets.Any())
@@ -54,12 +89,18 @@ public virtual async Task InitializeAsync(ChartData chartData, IChartOptions cha
     //public async Task Reset() { }
 
     /// <summary>
-    /// Resize the chart.
+    /// Asynchronously resizes the chart to the specified dimensions.
     /// </summary>
-    /// <param name="width"></param>
-    /// <param name="height"></param>
-    /// <param name="widthUnit"></param>
-    /// <param name="heightUnit"></param>
+    /// <remarks>This method updates the chart's dimensions by invoking a JavaScript function. Ensure that the
+    /// chart is properly initialized before calling this method. The operation is performed asynchronously and will not
+    /// block the calling thread.</remarks>
+    /// <param name="width">The new width of the chart. Must be a non-negative integer.</param>
+    /// <param name="height">The new height of the chart. Must be a non-negative integer.</param>
+    /// <param name="widthUnit">The unit of measurement for the width. Defaults to pixels.</param>
+    /// <param name="heightUnit">The unit of measurement for the height. Defaults to pixels.</param>
+    /// <returns>A task that represents the asynchronous resize operation.</returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously resizes the chart to the specified dimensions.")]
     public async Task ResizeAsync(int width, int height, Unit widthUnit = Unit.Px, Unit heightUnit = Unit.Px)
     {
         var widthWithUnit = $"width:{width.ToString(CultureInfo.InvariantCulture)}{widthUnit.ToCssString()}";
@@ -68,10 +109,15 @@ public async Task ResizeAsync(int width, int height, Unit widthUnit = Unit.Px, U
     }
 
     /// <summary>
-    /// Update the chart.
+    /// Asynchronously updates the chart with the specified data and options.
     /// </summary>
-    /// <param name="chartData"></param>
-    /// <param name="chartOptions"></param>
+    /// <remarks>This method updates the chart by invoking a JavaScript function to render the new data and
+    /// options. Ensure that <paramref name="chartData"/> contains valid datasets to avoid no operation.</remarks>
+    /// <param name="chartData">The data to be displayed on the chart. Must not be null and must contain at least one dataset.</param>
+    /// <param name="chartOptions">The options to configure the chart's appearance and behavior.</param>
+    /// <returns></returns>
+    [AddedVersion("1.0.0")]
+    [Description("Asynchronously updates the chart with the specified data and options.")]
     public virtual async Task UpdateAsync(ChartData chartData, IChartOptions chartOptions)
     {
         if (chartData is null || chartData.Datasets is null || !chartData.Datasets.Any())
@@ -169,6 +215,7 @@ private object GetChartDataObject(ChartData chartData)
     [AddedVersion("1.0.0")]
     [DefaultValue(null)]
     [Description("Gets or sets chart container height.")]
+    [ParameterTypeName("int?")]
     [Parameter]
     public int? Height { get; set; }
 
@@ -209,6 +256,7 @@ private object GetChartDataObject(ChartData chartData)
     [AddedVersion("1.0.0")]
     [DefaultValue(null)]
     [Description("Gets or sets chart container width.")]
+    [ParameterTypeName("int?")]
     [Parameter]
     public int? Width { get; set; }