Refactor chart interop and introduce bubble chart support

Updated interop classes for various chart types to use correct prefixes.
Removed `BubbleData` and restructured bubble chart data handling with new
`BubbleChart`, `BubbleChartDataPoint`, and `BubbleChartDatasetData` classes.
Introduced `BubbleChartInterop` for JavaScript interop methods and
`BubbleChartOptions` for configuration. Overall, these changes enhance
the bubble chart functionality in the BlazorExpress.ChartJS library.

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

Author: gvreddy04

BlazorExpress.ChartJS/ChartComponents/BubbleChart.razor

@@ -0,0 +1,6 @@
+@namespace BlazorExpress.ChartJS
+@inherits ChartComponentBase
+
+<div class="@ContainerClassNames" style="@ContainerStyleNames">
+    <canvas @ref="@Element" id="@Id" class="@Class" style="@Style" width="@Width" height="@Height" @attributes="@AdditionalAttributes"></canvas>
+</div>

BlazorExpress.ChartJS/ChartComponents/BubbleChart.razor.cs

@@ -0,0 +1,191 @@
+namespace BlazorExpress.ChartJS;
+
+public partial class BubbleChart : ChartComponentBase
+{
+    #region Constructors
+
+    public BubbleChart()
+    {
+        _chartType = ChartType.Bubble;
+    }
+
+    #endregion
+
+    #region Methods
+
+    /// <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.")]
+    [MethodReturnTypeName($"Task<{nameof(ChartData)}>")]
+    public override async Task<ChartData> AddDataAsync(ChartData chartData, string dataLabel, IChartDatasetData data)
+    {
+        if (chartData is null)
+            throw new ArgumentNullException(nameof(chartData));
+
+        if (chartData.Datasets is null)
+            throw new ArgumentNullException(nameof(chartData.Datasets));
+
+        if (data is null)
+            throw new ArgumentNullException(nameof(data));
+
+        foreach (var dataset in chartData.Datasets)
+            if (dataset is BubbleChartDataset bubbleChartDataset && bubbleChartDataset.Label == dataLabel)
+                if (data is BubbleChartDatasetData bubbleChartDatasetData && bubbleChartDatasetData.Data is BubbleChartDataPoint bubbleChartDataPoint)
+                    bubbleChartDataset.Data?.Add(bubbleChartDataPoint);
+
+        await JSRuntime.InvokeVoidAsync(BubbleChartInterop.AddDatasetData, Id, dataLabel, data);
+
+        return 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.")]
+    [MethodReturnTypeName($"Task<{nameof(ChartData)}>")]
+    public override async Task<ChartData> AddDataAsync(ChartData chartData, string dataLabel, IReadOnlyCollection<IChartDatasetData> data)
+    {
+        if (chartData is null)
+            throw new ArgumentNullException(nameof(chartData));
+
+        if (chartData.Datasets is null)
+            throw new ArgumentException("chartData.Datasets must not be null", nameof(chartData));
+
+        if (chartData.Labels is null)
+            throw new ArgumentException("chartData.Labels must not be null", nameof(chartData));
+
+        if (dataLabel is null)
+            throw new ArgumentNullException(nameof(dataLabel));
+
+        if (string.IsNullOrWhiteSpace(dataLabel))
+            throw new Exception($"{nameof(dataLabel)} cannot be empty.");
+
+        if (data is null)
+            throw new ArgumentNullException(nameof(data));
+
+        if (!data.Any())
+            throw new ArgumentException($"{nameof(data)} cannot be empty.", nameof(data));
+
+        if (chartData.Datasets.Count != data.Count)
+            throw new InvalidDataException("The chart dataset count and the new data points count do not match.");
+
+        if (chartData.Labels.Contains(dataLabel))
+            throw new Exception($"{dataLabel} already exists.");
+
+        chartData.Labels.Add(dataLabel);
+
+        foreach (var dataset in chartData.Datasets)
+            if (dataset is BubbleChartDataset bubbleChartDataset)
+            {
+                var chartDatasetData = data.FirstOrDefault(x => x is BubbleChartDatasetData bubbleChartDatasetData && bubbleChartDatasetData.DatasetLabel == bubbleChartDataset.Label);
+
+                if (chartDatasetData is BubbleChartDatasetData bubbleChartDatasetData && bubbleChartDatasetData.Data is BubbleChartDataPoint bubbleChartDataPoint)
+                    bubbleChartDataset.Data?.Add(bubbleChartDataPoint);
+            }
+
+        await JSRuntime.InvokeVoidAsync(BubbleChartInterop.AddDatasetsData, Id, dataLabel, data?.Select(x => (BubbleChartDatasetData)x));
+
+        return 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.")]
+    [MethodReturnTypeName($"Task<{nameof(ChartData)}>")]
+    public override async Task<ChartData> AddDatasetAsync(ChartData chartData, IChartDataset chartDataset, IChartOptions chartOptions)
+    {
+        if (chartData is null)
+            throw new ArgumentNullException(nameof(chartData));
+
+        if (chartData.Datasets is null)
+            throw new ArgumentNullException(nameof(chartData.Datasets));
+
+        if (chartDataset is null)
+            throw new ArgumentNullException(nameof(chartDataset));
+
+        if (chartDataset is BubbleChartDataset)
+        {
+            chartData.Datasets.Add(chartDataset);
+            await JSRuntime.InvokeVoidAsync(BubbleChartInterop.AddDataset, Id, (BubbleChartDataset)chartDataset);
+        }
+
+        return chartData;
+    }
+
+    /// <summary>
+    /// Asynchronously initializes the chart with the specified data and options.
+    /// </summary>
+    /// <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.")]
+    [MethodReturnTypeName(nameof(Task))]
+    public override async Task InitializeAsync(ChartData chartData, IChartOptions chartOptions, string[]? plugins = null)
+    {
+        if (chartData is null)
+            throw new ArgumentNullException(nameof(chartData));
+
+        if (chartData.Datasets is null)
+            throw new ArgumentNullException(nameof(chartData.Datasets));
+
+        if (chartOptions is null)
+            throw new ArgumentNullException(nameof(chartOptions));
+
+        var datasets = chartData.Datasets.OfType<BubbleChartDataset>();
+        var data = new { chartData.Labels, Datasets = datasets };
+        await JSRuntime.InvokeVoidAsync(BubbleChartInterop.Initialize, Id, GetChartType(), data, (BubbleChartOptions)chartOptions, plugins);
+    }
+
+    /// <summary>
+    /// Asynchronously updates the chart with the specified data and options.
+    /// </summary>
+    /// <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.")]
+    [MethodReturnTypeName(nameof(Task))]
+    public override async Task UpdateAsync(ChartData chartData, IChartOptions chartOptions)
+    {
+        if (chartData is null)
+            throw new ArgumentNullException(nameof(chartData));
+
+        if (chartData.Datasets is null)
+            throw new ArgumentNullException(nameof(chartData.Datasets));
+
+        if (chartOptions is null)
+            throw new ArgumentNullException(nameof(chartOptions));
+
+        var datasets = chartData.Datasets.OfType<BubbleChartDataset>();
+        var data = new { chartData.Labels, Datasets = datasets };
+        await JSRuntime.InvokeVoidAsync(BubbleChartInterop.Update, Id, GetChartType(), data, (BubbleChartOptions)chartOptions);
+    }
+
+    #endregion
+}

BlazorExpress.ChartJS/Interop/BubbleChartInterop.cs

@@ -0,0 +1,20 @@
+namespace BlazorExpress.ChartJS;
+
+public class BubbleChartInterop
+{
+    #region Fields and Constants
+
+    private const string Prefix = "window.blazorexpress.chartjs.bubble.";
+
+    public const string AddDatasetData = Prefix + "addDatasetData";
+
+    public const string AddDatasetsData = Prefix + "addDatasetsData";
+
+    public const string AddDataset = Prefix + "addDataset";
+
+    public const string Initialize = Prefix + "initialize";
+
+    public const string Update = Prefix + "update";
+
+    #endregion
+}

BlazorExpress.ChartJS/Interop/DoughnutChartInterop.cs

@@ -4,7 +4,7 @@ public class DoughnutChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.doughnut.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Interop/LineChartInterop.cs

@@ -4,7 +4,7 @@ public class LineChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.line.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Interop/PieChartInterop.cs

@@ -4,7 +4,7 @@ public class PieChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.pie.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Interop/PolarAreaChartInterop.cs

@@ -4,7 +4,7 @@ public class PolarAreaChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.polarArea.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Interop/RadarChartInterop.cs

@@ -4,7 +4,7 @@ public class RadarChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.radar.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Interop/ScatterChartInterop.cs

@@ -4,7 +4,7 @@ public class ScatterChartInterop
 {
     #region Fields and Constants
 
-    private const string Prefix = "window.blazorexpress.chartjs.bar.";
+    private const string Prefix = "window.blazorexpress.chartjs.scatter.";
 
     public const string AddDatasetData = Prefix + "addDatasetData";
 

BlazorExpress.ChartJS/Models/ChartDataset/BubbleChart/BubbleChartDataPoint.cs

@@ -0,0 +1,6 @@
+namespace BlazorExpress.ChartJS;
+
+/// <summary>
+/// <see href="https://www.chartjs.org/docs/latest/charts/bubble.html#data-structure" />
+/// </summary>
+public record BubbleChartDataPoint(double X, double Y, double R);