Add BreadcrumbService docs, metadata, and menu entry

- Added BreadcrumbService documentation page and menu entry
- Expanded Breadcrumb and BreadcrumbItem with XML docs and metadata attributes ([AddedVersion], [DefaultValue], [Description], [ParameterTypeName])
- Made Breadcrumb.Items nullable and updated its documentation
- Introduced MethodNameAttribute for method signature annotation
- Updated BreadcrumbService with metadata and [MethodName] usage
- Enhanced MethodInfoExtensions and DocxMethodRow to support method name display from attribute
- Updated DemoRouteConstants with Docs_URL_BreadcrumbService route
- Improved documentation tables for Breadcrumb, BreadcrumbItem, and BreadcrumbService

Author: gvreddy04

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

@@ -75,7 +75,8 @@ 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 = "Modal Service", Href = DemoRouteConstants.Docs_URL_ModalService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "700", Text = "Breadcrumb Service", Href = DemoRouteConstants.Docs_URL_BreadcrumbService, IconName = IconName.WindowStack, ParentId = "7" },
+            new (){ Id = "701", Text = "Modal Service", Href = DemoRouteConstants.Docs_URL_ModalService, IconName = IconName.WindowStack, 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/Breadcrumb/Breadcrumb_Doc_01_Documentation.razor

@@ -18,6 +18,14 @@
     <DocxTable TItem="Breadcrumb" DocType="DocType.Parameters" />
 </Section>
 
+<Section Class="p-0" Size="HeadingSize.H3" Name="BreadcrumbItem Properties" PageUrl="@pageUrl" Link="breadcrumb-item-properties">
+    <DocxTable TItem="BreadcrumbItem" DocType="DocType.Properties" />
+</Section>
+
+<Section Class="p-0" Size="HeadingSize.H3" Name="BreadcrumbService Methods" PageUrl="@pageUrl" Link="breadcrumb-service-methods">
+    <DocxTable TItem="BreadcrumbService" DocType="DocType.Methods" />
+</Section>
+
 @code {
     private const string componentName = nameof(Breadcrumb);
     private const string pageUrl = DemoRouteConstants.Docs_URL_Breadcrumb;

BlazorBootstrap.Demo.RCL/Components/Pages/Docs/Services/BreadcrumbService/BreadcrumbService_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_ModalService" />
+
+<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="BreadcrumbService Methods" PageUrl="@pageUrl" Link="breadcrumb-service-methods">
+    <DocxTable TItem="BreadcrumbService" DocType="DocType.Methods" />
+</Section>
+
+@code {
+    private const string componentName = nameof(BreadcrumbService);
+    private const string pageUrl = DemoRouteConstants.Docs_URL_BreadcrumbService;
+    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_Breadcrumb;
+}

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

@@ -11,7 +11,7 @@ public partial class DocxMethodRow<TItem> : BlazorBootstrapComponentBase
 
     public string ReturnType => MethodInfo.GetMethodReturnTypeName() ?? MethodInfo.GetMethodReturnType();
 
-    public string MethodNameWithParameters => $"{MethodInfo.Name}({MethodParameters})";
+    public string MethodNameWithParameters => MethodInfo.GetMethodName() ?? $"{MethodInfo.Name}({MethodParameters})";
 
     public string MethodParameters => MethodInfo.GetMethodParameters();
 

BlazorBootstrap.Demo.RCL/Constants/DemoRouteConstants.cs

@@ -195,6 +195,7 @@ public static class DemoRouteConstants
 
     // Services
     public const string Docs_URL_Services_Prefix = Docs_URL_Prefix + "/services";
+    public const string Docs_URL_BreadcrumbService = Docs_URL_Services_Prefix + "/breadcrumb-service";
     public const string Docs_URL_ModalService = Docs_URL_Services_Prefix + "/modal-service";
 
     // Utilities

BlazorBootstrap.Demo.RCL/Extensions/MethodInfoExtensions.cs

@@ -32,6 +32,17 @@ public static string GetMethodDescription(this MethodInfo methodInfo)
         return descriptionAttribute?.Description ?? string.Empty;
     }
 
+    /// <summary>
+    /// Get method name.
+    /// </summary>
+    /// <param name="methodInfo"></param>
+    /// <returns>string</returns>
+    public static string GetMethodName(this MethodInfo methodInfo)
+    {
+        var methodNameAttribute = methodInfo.GetCustomAttributes(typeof(MethodNameAttribute), false).FirstOrDefault() as MethodNameAttribute;
+        return methodNameAttribute?.MethodName ?? null!;
+    }
+
     public static string GetMethodParameters(this MethodInfo methodInfo)
     {
         var parameters = methodInfo.GetParameters();

blazorbootstrap/Attributes/MethodNameAttribute.cs

@@ -0,0 +1,22 @@
+namespace BlazorBootstrap;
+
+/// <summary>
+/// Attribute to specify the method name with parameters.
+/// </summary>
+public class MethodNameAttribute : Attribute
+{
+    #region Constructors
+    
+    public MethodNameAttribute(string methodName)
+    {
+        MethodName = methodName;
+    }
+
+    #endregion
+
+    #region Properties, Indexers
+
+    public string MethodName { get; }
+
+    #endregion
+}

blazorbootstrap/Components/Breadcrumb/Breadcrumb.razor.cs

@@ -37,16 +37,21 @@ private void OnNotify(List<BreadcrumbItem> items)
 
     #region Properties, Indexers
 
-    [Inject] private BreadcrumbService BreadcrumbService { get; set; } = default!;
+    [Inject] 
+    private BreadcrumbService BreadcrumbService { get; set; } = default!;
 
     /// <summary>
     /// Gets or sets the items.
     /// </summary>
     /// <remarks>
-    /// Default value is null.
+    /// Default value is <see langword="null"/>.
     /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the items.")]
+    [ParameterTypeName("List<BreadcrumbItem>?")]
     [Parameter]
-    public List<BreadcrumbItem> Items { get; set; } = default!;
+    public List<BreadcrumbItem>? Items { get; set; }
 
     #endregion
 }

blazorbootstrap/Models/BreadcrumbItem.cs

@@ -1,11 +1,45 @@
 namespace BlazorBootstrap;
 
+/// <summary>
+/// Represents a single breadcrumb navigation item.
+/// </summary>
 public class BreadcrumbItem
 {
     #region Properties, Indexers
 
+    /// <summary>
+    /// Gets or sets the navigation URL for the breadcrumb item.
+    /// </summary>
+    /// <remarks>
+    /// Default value is <see langword="null" />.
+    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the navigation URL for the breadcrumb item.")]
+    [ParameterTypeName("string?")]
     public string? Href { get; set; }
+
+    /// <summary>
+    /// Gets or sets whether this item represents the current page.
+    /// </summary>
+    /// <remarks>
+    /// Default value is <see langword="false"/>.
+    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(false)]
+    [Description("Gets or sets whether this item represents the current page.")]
     public bool IsCurrentPage { get; set; }
+
+    /// <summary>
+    /// Gets or sets the display text for the breadcrumb item.
+    /// </summary>
+    /// <remarks>
+    /// Default value is <see langword="null" />.
+    /// </remarks>
+    [AddedVersion("1.0.0")]
+    [DefaultValue(null)]
+    [Description("Gets or sets the display text for the breadcrumb item.")]
+    [ParameterTypeName("string?")]
     public string? Text { get; set; }
 
     #endregion

blazorbootstrap/Services/BreadcrumbService.cs

@@ -1,15 +1,30 @@
 namespace BlazorBootstrap;
 
+/// <summary>
+/// Provides a simple publish/subscribe mechanism to update `Breadcrumb` items from anywhere in the application.
+/// </summary>
 public class BreadcrumbService
 {
     #region Events
 
+    /// <summary>
+    /// Occurs when breadcrumb items are updated via <see cref="Notify(List{BreadcrumbItem})" />.
+    /// </summary>
+    [AddedVersion("1.9.2")]
+    [Description("Occurs when breadcrumb items are updated via Notify(List<BreadcrumbItem>).")]
     internal event Action<List<BreadcrumbItem>> OnNotify = default!;
 
     #endregion
 
     #region Methods
 
+    /// <summary>
+    /// Notifies subscribers with the latest breadcrumb items.
+    /// </summary>
+    /// <param name="items">The breadcrumb items.</param>
+    [AddedVersion("1.9.2")]
+    [Description("Notifies subscribers with the latest breadcrumb items.")]
+    [MethodName("Notify(List<BreadcrumbItem> items)")]
     public void Notify(List<BreadcrumbItem> items) => OnNotify?.Invoke(items);
 
     #endregion