Enhance API docs and metadata for GoogleMap, Markdown, Modal (#1222)

Added [AddedVersion], [DefaultValue], [Description], and [ParameterTypeName] attributes to public properties and methods in GoogleMap, Markdown, and Modal components. Improved XML documentation with clearer default values and descriptions. Updated several parameters to be nullable where appropriate. These changes improve API discoverability, tooling support, and overall self-documentation. No functional logic was changed.

Author: gvreddy04

blazorbootstrap/Components/Maps/GoogleMap.razor.cs

@@ -22,6 +22,8 @@ protected override async Task OnInitializedAsync()
     /// </summary>
     /// <param name="marker">The marker to add to the map.</param>
     /// <returns>A completed task.</returns>
+    [AddedVersion("3.0.0")]
+    [Description("Adds a marker to the GoogleMap.")]
     public ValueTask AddMarkerAsync(GoogleMapMarker marker)
     {
         JSRuntime.InvokeVoidAsync("window.blazorBootstrap.googlemaps.addMarker", Id, marker, objRef);
@@ -40,6 +42,8 @@ public async Task OnMarkerClickJS(GoogleMapMarker marker)
     /// Refreshes the Google Map component.
     /// </summary>
     /// <returns>A completed task.</returns>
+    [AddedVersion("3.0.0")]
+    [Description("Refreshes the Google Map component.")]
     public ValueTask RefreshAsync()
     {
         JSRuntime.InvokeVoidAsync("window.blazorBootstrap.googlemaps.initialize", Id, Zoom, Center, Markers, Clickable, objRef);
@@ -51,6 +55,8 @@ public ValueTask RefreshAsync()
     /// Updates the markers on the Google Map.
     /// </summary>
     /// <returns>A completed task.</returns>
+    [AddedVersion("3.0.0")]
+    [Description("Updates the markers on the Google Map.")]
     public ValueTask UpdateMarkersAsync(IEnumerable<GoogleMapMarker> markers)
     {
         JSRuntime.InvokeVoidAsync("window.blazorBootstrap.googlemaps.updateMarkers", Id, markers, objRef);
@@ -76,79 +82,125 @@ private void OnScriptLoad()
 
     /// <summary>
     /// Gets or sets the Google Map API key.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
     /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the Google Map API key.")]
+    [ParameterTypeName("string?")]
     [Parameter]
     public string? ApiKey { get; set; }
 
     /// <summary>
     /// Gets or sets the center parameter.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
     /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the center parameter.")]
+    [ParameterTypeName("GoogleMapCenter?")]
     [Parameter] 
-    public GoogleMapCenter Center { get; set; } = default!;
+    public GoogleMapCenter? Center { get; set; }
 
     /// <summary>
     /// Makes the marker clickable if set to <see langword="true" />.
+    /// <para>
+    /// Default value is <see langword="false" />.
+    /// </para>
     /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(false)]
+    [Description("Makes the marker clickable if set to <b>true</b>.")]
     [Parameter] 
     public bool Clickable { get; set; }
 
     private string? GoogleMapsJsFileUrl => $"https://maps.googleapis.com/maps/api/js?key={ApiKey}&libraries=maps,marker";
 
     /// <summary>
     /// Gets or sets the height of the <see cref="GoogleMap" />.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see langword="null" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the height of the <b>GoogleMap</b>.")]
+    [ParameterTypeName("double?")]
     [Parameter]
     public double? Height { get; set; }
 
     /// <summary>
     /// Gets or sets the units for the <see cref="Height" />.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="Unit.Px" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(Unit.Px)]
+    [Description("Gets or sets the units for the <b>Height</b>.")]
     [Parameter]
     public Unit HeightUnit { get; set; } = Unit.Px;
 
     /// <summary>
     /// Gets or sets the markers.
+    /// <para>
+    /// Default value is <see langword="null" />.
+    /// </para>
     /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the markers.")]
+    [ParameterTypeName("IEnumerable<GoogleMapMarker>?")]
     [Parameter] 
     public IEnumerable<GoogleMapMarker>? Markers { get; set; }
 
     /// <summary>
     /// Event fired when a user clicks on a marker.
     /// This event fires only when <see cref="Clickable" /> is set to <see langword="true" />.
     /// </summary>
+    [AddedVersion("3.0.0")]
+    [Description("Event fired when a user clicks on a marker. This event fires only when <b>Clickable</b> is set to <b>true</b>.")]
     [Parameter] 
     public EventCallback<GoogleMapMarker> OnMarkerClick { get; set; }
 
     /// <summary>
     /// Gets or sets the width of the <see cref="GoogleMap" />.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see langword="null" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the width of the <b>GoogleMap</b>.")]
+    [ParameterTypeName("double?")]
     [Parameter]
     public double? Width { get; set; }
 
     /// <summary>
     /// Gets or sets the units for the <see cref="Width" />.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see cref="Unit.Percentage" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(Unit.Percentage)]
+    [Description("Gets or sets the units for the <b>Width</b>.")]
     [Parameter]
     public Unit WidthUnit { get; set; } = Unit.Percentage;
 
     /// <summary>
     /// Gets or sets the zoom level of the <see cref="GoogleMap" />.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is 14.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.0.0")]
+    [DefaultValue(14)]
+    [Description("Gets or sets the zoom level of the <b>GoogleMap</b>.")]
     [Parameter]
     public int Zoom { get; set; } = 14;
 

blazorbootstrap/Components/Markdown/Markdown.razor.cs

@@ -678,24 +678,40 @@ private static void RemoveLastLineBreak(List<string> htmlLines)
 
     /// <summary>
     /// Gets or sets the CSS class for blockquotes.
+    /// <para>
+    /// Default value is "blockquote".
+    /// </para>
     /// </summary>
+    [AddedVersion("3.1.0")]
+    [DefaultValue("blockquote")]
+    [Description("Gets or sets the CSS class for blockquotes.")]
     [Parameter]
-    public string? BlockquotesCssClass { get; set; } = "blockquote";
+    public string BlockquotesCssClass { get; set; } = "blockquote";
 
     /// <summary>
     /// Gets or sets the content to be rendered within the component.
-    /// </summary>
-    /// <remarks>
+    /// <para>
     /// Default value is <see langword="null" />.
-    /// </remarks>
+    /// </para>
+    /// </summary>
+    [AddedVersion("3.1.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the content to be rendered within the component.")]
+    [ParameterTypeName("RenderFragment?")]
     [Parameter]
     public RenderFragment? ChildContent { get; set; }
 
     /// <summary>
     /// Gets or sets the CSS class for table.
+    /// <para>
+    /// Default value is "table".
+    /// </para>
     /// </summary>
+    [AddedVersion("3.1.0")]
+    [DefaultValue("table")]
+    [Description("Gets or sets the CSS class for table.")]
     [Parameter]
-    public string? TableCssClass { get; set; } = "table";
+    public string TableCssClass { get; set; } = "table";
 
     #endregion
 }