Enhance Ribbon API docs and add metadata attributes (#1224)

* Enhance metadata and docs for Placeholder components

Improve XML docs and add [AddedVersion], [DefaultValue], and [Description] attributes to Placeholder and PlaceholderContainer parameters. Remove redundant remarks and clarify default values. Add [ParameterTypeName] to ChildContent for better tooling and documentation support.

* Add Preload Service feature, docs, and navigation

- Added Preload Service route constants and screenshot paths for demos and docs
- Updated navigation menus to include Preload Service under Services
- Added PreloadService documentation page with screenshot and methods table
- Enhanced Preload component parameter documentation with version and default value attributes
- Documented PreloadService Show/Hide methods with XML comments and attributes
- Fixed DemoLink in BreadcrumbService documentation to correct target

* Enhance Progress/ProgressBar API docs and metadata

Improved XML documentation and added metadata attributes ([AddedVersion], [DefaultValue], [Description], [ParameterTypeName]) to parameters and methods in Progress and ProgressBar components. Updated Label to nullable string. Adjusted documentation sections to better reflect available methods and parameters. These changes improve API clarity and tooling support.

* Enhance Ribbon API docs and add metadata attributes

Add detailed XML documentation and custom metadata attributes
([AddedVersion], [DefaultValue], [Description], [ParameterTypeName])
to Ribbon, RibbonTab, RibbonGroup, RibbonItem, RibbonItemGroup,
and RibbonEventArgs. Update event and parameter docs, make
ChildContent nullable and consistent, and improve discoverability
in the documentation page. Improves API clarity and self-documentation.

* Refactor attribute access, improve type name resolution

Refactored PropertyInfoExtenstions to use Attribute.GetCustomAttribute for attribute retrieval, simplifying code. Added NullabilityInfoContext and GetFriendlyTypeName for accurate C# type name generation, including nullable and generic types. Updated GetParameterTypeName to use new logic. Renamed RibbonTab.razor.cs property ChildContent to Content.

* Improve property type name display for complex types

Enhanced type name rendering in DocxPropertyRow to accurately display tuples, generics, nullable types, and object types. Updated extension methods and constants to ensure C#-idiomatic and user-friendly type names in the UI.

* Improve type name display with nullability and generics

Refactored method and property type name extraction to use a new GetFriendlyTypeName extension based on NullabilityInfo, ensuring accurate C#-style type names (including nullability, generics, and tuples). Simplified method signature display in DocxMethodRow.razor. Removed legacy type name formatting logic and centralized type name handling in the new NullabilityInfoExtensions.cs. Attribute extraction now uses Attribute.GetCustomAttribute. These changes modernize and unify type name presentation across the documentation/demo UI.

* Remove [ParameterTypeName] from Accordion components

Removed the [ParameterTypeName] attribute from several parameters
in Accordion and AccordionItem classes. Parameters remain unchanged
and still use [Parameter], but no longer include explicit type
annotations via [ParameterTypeName].

Author: gvreddy04

BlazorBootstrap.Demo.RCL/Components/Layout/DemosMainLayout.razor.cs

@@ -99,7 +99,9 @@ internal override IEnumerable<NavItem> GetNavItems()
             new (){ Id = "605", Text = "Scatter Chart", Href = DemoRouteConstants.Demos_URL_ScatterChart, IconName = IconName.GraphUpArrow, ParentId = "6", Match = NavLinkMatch.All },
 
             new(){ Id = "7", Text = "Services", IconName = IconName.WrenchAdjustableCircleFill, IconColor = IconColor.Success },
-            new (){ Id = "700", Text = "Modal Service", Href = DemoRouteConstants.Demos_URL_ModalService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "700", Text = "Breadcrumb Service", Href = DemoRouteConstants.Demos_URL_BreadcrumbService, IconName = IconName.SegmentedNav, ParentId = "7" },
+            new (){ Id = "701", Text = "Modal Service", Href = DemoRouteConstants.Demos_URL_ModalService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "702", Text = "Preload Service", Href = DemoRouteConstants.Demos_URL_PreloadService, IconName = IconName.ArrowRepeat, ParentId = "7" },
 
             new(){ Id = "19", Text = "Utilities", IconName = IconName.GearWideConnected, IconColor = IconColor.Info },
             new (){ Id = "1900", Text = "Color Utility", Href = DemoRouteConstants.Demos_URL_ColorUtils, IconName = IconName.Palette2, ParentId = "19" },

BlazorBootstrap.Demo.RCL/Components/Layout/DocsMainLayout.razor.cs

@@ -75,8 +75,9 @@ internal override IEnumerable<NavItem> GetNavItems()
             new (){ Id = "605", Text = "Scatter Chart", Href = DemoRouteConstants.Docs_URL_ScatterChart, IconName = IconName.GraphUpArrow, ParentId = "6", Match = NavLinkMatch.All },
 
             new(){ Id = "7", Text = "Services", IconName = IconName.WrenchAdjustableCircleFill, IconColor = IconColor.Success },
-            new (){ Id = "700", Text = "Breadcrumb Service", Href = DemoRouteConstants.Docs_URL_BreadcrumbService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "700", Text = "Breadcrumb Service", Href = DemoRouteConstants.Docs_URL_BreadcrumbService, IconName = IconName.SegmentedNav, ParentId = "7" },
             new (){ Id = "701", Text = "Modal Service", Href = DemoRouteConstants.Docs_URL_ModalService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "702", Text = "Preload Service", Href = DemoRouteConstants.Docs_URL_PreloadService, IconName = IconName.ArrowRepeat, ParentId = "7" },
 
             //new(){ Id = "19", Text = "Utilities", IconName = IconName.GearWideConnected, IconColor = IconColor.Info },
             //new (){ Id = "1900", Text = "Color Utility", Href = DemoRouteConstants.Docs_URL_ColorUtils, IconName = IconName.Palette2, ParentId = "19" },

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/ConfirmDialog/ConfirmDialog_Doc_01_Documentation.razor

@@ -18,6 +18,10 @@
     <DocxTable TItem="ConfirmDialog" DocType="DocType.Parameters" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="ConfirmDialog Methods" PageUrl="@pageUrl" Link="confirm-dialog-methods">
+    <DocxTable TItem="ConfirmDialog" DocType="DocType.Methods" />
+</Section>
+
 <Section Class="p-0" Size="HeadingSize.H3" Name="ConfirmDialogOptions Properties" PageUrl="@pageUrl" Link="confirm-dialog-options-properties">
     <DocxTable TItem="ConfirmDialogOptions" DocType="DocType.Properties" />
 </Section>

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Progress/Progress_Doc_01_Documentation.razor

@@ -18,14 +18,14 @@
     <DocxTable TItem="Progress" DocType="DocType.Parameters" />
 </Section>
 
-<Section Class="p-0" Size="HeadingSize.H3" Name="Progress Methods" PageUrl="@pageUrl" Link="progress-methods">
-    <DocxTable TItem="Progress" DocType="DocType.Methods" />
-</Section>
-
 <Section Class="p-0" Size="HeadingSize.H3" Name="ProgressBar Parameters" PageUrl="@pageUrl" Link="progress-bar-parameters">
     <DocxTable TItem="ProgressBar" DocType="DocType.Parameters" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="ProgressBar Methods" PageUrl="@pageUrl" Link="progress-bar-methods">
+    <DocxTable TItem="ProgressBar" DocType="DocType.Methods" />
+</Section>
+
 @code {
     private const string componentName = nameof(Progress);
     private const string pageUrl = DemoRouteConstants.Docs_URL_Progress;

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Ribbon/Ribbon_Doc_01_Documentation.razor

@@ -26,6 +26,10 @@
     <DocxTable TItem="Ribbon" DocType="DocType.Events" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="RibbonEventArgs Properties" PageUrl="@pageUrl" Link="ribbon-event-args-properties">
+    <DocxTable TItem="RibbonEventArgs" DocType="DocType.Properties" />
+</Section>
+
 <Section Class="p-0" Size="HeadingSize.H3" Name="RibbonTab Parameters" PageUrl="@pageUrl" Link="ribbon-tab-parameters">
     <DocxTable TItem="RibbonTab" DocType="DocType.Parameters" />
 </Section>

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Services/BreadcrumbService/BreadcrumbService_Doc_01_Documentation.razor

@@ -8,7 +8,7 @@
                      MetaDescription="@metaDescription"
                      ImageUrl="@imageUrl" />
 
-<DemoLink Href="@DemoRouteConstants.Demos_URL_ModalService" />
+<DemoLink Href="@DemoRouteConstants.Demos_URL_BreadcrumbService" />
 
 <Section Class="p-0" Size="HeadingSize.H3" Name="Screenshot" PageUrl="@pageUrl" Link="screenshot">
     <img src="@imageUrl" class="img-fluid" alt="@metaTitle" />

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Services/PreloadService/PreloadService_Doc_01_Documentation.razor

@@ -0,0 +1,29 @@
+@attribute [Route(pageUrl)]
+@layout DocsMainLayout
+
+<DocsPageHeadSection PageUrl="@pageUrl"
+                     PageTitle="@pageTitle"
+                     PageDescription="@pageDescription"
+                     MetaTitle="@metaTitle"
+                     MetaDescription="@metaDescription"
+                     ImageUrl="@imageUrl" />
+
+<DemoLink Href="@DemoRouteConstants.Demos_URL_PreloadService" />
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="Screenshot" PageUrl="@pageUrl" Link="screenshot">
+    <img src="@imageUrl" class="img-fluid" alt="@metaTitle" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="PreloadService Methods" PageUrl="@pageUrl" Link="preload-service-methods">
+    <DocxTable TItem="PreloadService" DocType="DocType.Methods" />
+</Section>
+
+@code {
+    private const string componentName = nameof(PreloadService);
+    private const string pageUrl = DemoRouteConstants.Docs_URL_PreloadService;
+    private const string pageTitle = componentName;
+    private const string pageDescription = $"This documentation provides a comprehensive reference for the <code>{componentName}</code> component, guiding you through its configuration options.";
+    private const string metaTitle = $"Blazor {componentName} Component";
+    private const string metaDescription = $"This documentation provides a comprehensive reference for the {componentName} component, guiding you through its configuration options.";
+    private const string imageUrl = DemoScreenshotSrcConstants.Demos_URL_PreloadService;
+}

BlazorBootstrap.Demo.RCL/Components/Shared/DocxTable/DocxMethodRow.razor

@@ -3,8 +3,8 @@
 @typeparam TItem
 
 <tr>
-    <td>@MethodNameWithParameters</td>
-    <td class="text-danger">@ReturnTypeShortName</td>
+    <td>@MethodName</td>
+    <td class="text-danger">@ReturnType</td>
     <td>@((MarkupString)Description)</td>
     <td>@AddedVersion</td>
 </tr>

BlazorBootstrap.Demo.RCL/Components/Shared/DocxTable/DocxMethodRow.razor.cs

@@ -9,15 +9,9 @@ public partial class DocxMethodRow<TItem> : BlazorBootstrapComponentBase
 
     private string Description => MethodInfo.GetMethodDescription();
 
-    public string ReturnType => MethodInfo.GetMethodReturnTypeName() ?? MethodInfo.GetMethodReturnType();
+    public string ReturnType => MethodInfo.GetMethodReturnType();
 
-    public string MethodNameWithParameters => MethodInfo.GetMethodName() ?? $"{MethodInfo.Name}({MethodParameters})";
-
-    public string MethodParameters => MethodInfo.GetMethodParameters();
-
-    public string ReturnTypeShortName => ReturnType.Contains(".")
-        ? ReturnType.Split('.').Last()
-        : ReturnType;
+    public string MethodName => MethodInfo.GetMethodName();
 
     [Parameter]
     public MethodInfo MethodInfo { get; set; } = default!;

BlazorBootstrap.Demo.RCL/Components/Shared/DocxTable/DocxPropertyRow.razor

@@ -4,7 +4,7 @@
 
 <tr>
     <td>@PropertyInfo.Name</td>
-    <td class="text-danger">@PropertyTypeShortName</td>
+    <td class="text-danger">@ParameterTypeName</td>
     <td>@DefaultValue</td>
     <td class="text-center">
         @if (IsRequired)