Feature/dialog improvements

demos/BlazorBlueprint.Demo.Shared/CodeExamples/Components/Dialog/alert-service.txt

@@ -0,0 +1,18 @@
+@inject DialogService DialogService
+
+ private async Task HandleAlert()
+{
+    alertStatus = "Waiting...";
+    await DialogService.AlertAsync(
+        "Session Expired",
+        "Please log in again.");
+}
+
+// With custom options:
+var confirmed = await DialogService.ConfirmAsync(
+    "Delete item?",
+    "This action cannot be undone.",
+    new AlertDialogOptions
+    {
+        ButtonText = "Ok, I Accept!",
+    });

demos/BlazorBlueprint.Demo.Shared/CodeExamples/Components/Dialog/confirm-service.txt

@@ -2,7 +2,7 @@
 
 private async Task HandleDelete()
 {
-    var confirmed = await DialogService.Confirm(
+    var confirmed = await DialogService.ConfirmAsync(
         "Delete item?",
         "This action cannot be undone.");
 
@@ -13,12 +13,12 @@ private async Task HandleDelete()
 }
 
 // With custom options:
-var confirmed = await DialogService.Confirm(
+var confirmed = await DialogService.ConfirmAsync(
     "Delete item?",
     "This action cannot be undone.",
     new ConfirmDialogOptions
     {
         ConfirmText = "Yes, delete",
         CancelText = "Keep it",
         Destructive = true
-    });
+    });

demos/BlazorBlueprint.Demo.Shared/CodeExamples/Components/Dialog/custom-service.txt

@@ -0,0 +1,22 @@
+@inject DialogService DialogService
+
+private async Task HandleCustomDialog()
+{
+    var result = await DialogService.OpenAsync<EditUserComponent>(
+        new Dictionary<string, object?>
+        {
+            [nameof(EditUserComponent.UserId)] = 42
+        },
+        new DialogOpenOptions
+        {
+            Title = "Edit User",
+            Size = DialogSize.Large
+        });
+
+    if (result.Cancelled)
+    {
+        return;
+    }
+
+    var data = result.GetData<UserDto>();
+}

demos/BlazorBlueprint.Demo.Shared/CodeExamples/Components/Dialog/prompt-service.txt

@@ -0,0 +1,17 @@
+@inject DialogService DialogService
+
+private async Task HandlePrompt()
+{
+    var name = await DialogService.PromptAsync(
+        "Rename File",
+        "Enter a new file name:",
+        new PromptDialogOptions
+        {
+            DefaultValue = "document.txt",
+            Placeholder = "file-name.txt",
+            Required = true,
+            MaxLength = 50
+        });
+
+    var text = name.Value ?? "Cancelled";
+}

demos/BlazorBlueprint.Demo.Shared/Pages/Components/DialogDemo.razor

@@ -394,6 +394,84 @@
         <CodeBlock Source="Components/Dialog/confirm-service.txt" />
     </div>
 
+    <div class="mt-10 space-y-4">
+        <h2 class="text-2xl font-semibold">
+            Alert Service
+            <span class="bg-primary/10 text-primary rounded px-1.5 py-0.5 text-xs font-normal">
+                New
+            </span>
+        </h2>
+
+        <p class="text-muted-foreground text-sm">
+            Use <code>DialogService.Alert()</code> for simple acknowledgment dialogs.
+            Returns a <code>Task</code> that completes when the user clicks OK.
+        </p>
+
+        <div class="flex items-center gap-4">
+            <BbButton OnClick="HandleAlert">
+                Show Alert
+            </BbButton>
+
+            <span class="text-muted-foreground text-sm">
+                Status: @alertStatus
+            </span>
+        </div>
+
+        <CodeBlock Source="Components/Dialog/alert-service.txt" />
+    </div>
+
+    <div class="mt-10 space-y-4">
+        <h2 class="text-2xl font-semibold">
+            Prompt Service
+            <span class="bg-primary/10 text-primary rounded px-1.5 py-0.5 text-xs font-normal">
+                New
+            </span>
+        </h2>
+
+        <p class="text-muted-foreground text-sm">
+            Use <code>DialogService.Prompt()</code> to collect text input asynchronously.
+            Returns <code>string?</code>.
+        </p>
+
+        <div class="flex items-center gap-4">
+            <BbButton OnClick="HandlePrompt">
+                Rename File
+            </BbButton>
+
+            <span class="text-muted-foreground text-sm">
+                Result: @promptResult
+            </span>
+        </div>
+
+        <CodeBlock Source="Components/Dialog/prompt-service.txt" />
+    </div>
+
+    <div class="mt-10 space-y-4">
+        <h2 class="text-2xl font-semibold">
+            Custom Component Dialog
+            <span class="bg-primary/10 text-primary rounded px-1.5 py-0.5 text-xs font-normal">
+                New
+            </span>
+        </h2>
+
+        <p class="text-muted-foreground text-sm">
+            Use <code>DialogService.Open&lt;TComponent&gt;()</code> to render a fully custom dialog component.
+            Returns a <code>DialogResult</code>.
+        </p>
+
+        <div class="flex items-center gap-4">
+            <BbButton OnClick="HandleCustomDialog">
+                Edit User
+            </BbButton>
+
+            <span class="text-muted-foreground text-sm">
+                Result: @customResult
+            </span>
+        </div>
+
+        <CodeBlock Source="Components/Dialog/custom-service.txt" />
+    </div>
+
     <div class="space-y-4">
         <h2 class="text-2xl font-semibold">Form in Dialog</h2>
         <p class="text-sm text-muted-foreground">
@@ -603,13 +681,17 @@
 </div>
 
 @code {
-    private string confirmResult = "None";
     private bool isDialogOpen = false;
     private DateTime? dialogDatePickerValue;
     private string? selectedComboboxFramework;
     private string? selectedDialogFruit;
     private IEnumerable<string>? selectedTechnologies = new List<string>();
 
+    private string confirmResult = "None";
+    private string alertStatus = "Idle";
+    private string promptResult = "-";
+    private string customResult = "-";
+
     // Form in Dialog
     private string? formFirstName;
     private string? formLastName;
@@ -663,16 +745,16 @@
 
     private async Task HandleConfirmDelete()
     {
-        var confirmed = await DialogService.Confirm(
+        var result = await DialogService.ConfirmAsync(
             "Delete item?",
             "This action cannot be undone. The item will be permanently removed.");
 
-        confirmResult = confirmed ? "Confirmed" : "Cancelled";
+        confirmResult = result.Confirmed ? "Confirmed" : "Cancelled";
     }
 
     private async Task HandleDestructiveDelete()
     {
-        var confirmed = await DialogService.Confirm(
+        var data = await DialogService.ConfirmAsync(
             "Delete item?",
             "This action cannot be undone.",
             new ConfirmDialogOptions
@@ -682,6 +764,102 @@
                 Destructive = true
             });
 
-        confirmResult = confirmed ? "Deleted!" : "Kept";
+        confirmResult = data.Confirmed ? "Deleted!" : "Kept";
     }
+
+    private async Task HandleAlert()
+    {
+        alertStatus = "Waiting...";
+        await DialogService.AlertAsync(
+            "Session Expired",
+            "Please log in again.");
+
+        alertStatus = "Acknowledged";
+    }
+
+    private async Task HandlePrompt()
+    {
+        var name = await DialogService.PromptAsync(
+            "Rename File",
+            "Enter a new file name:",
+            new PromptDialogOptions
+            {
+                DefaultValue = "document.txt",
+                Placeholder = "file-name.txt",
+                Required = true,
+                MaxLength = 50
+            });
+
+        promptResult = name.Value ?? "Cancelled";
+    }
+
+    private async Task HandleCustomDialog()
+    {
+        var result = await DialogService.OpenAsync<EditUserDemoComponent>(
+            new Dictionary<string, object?>
+            {
+                ["UserId"] = 42
+            },
+            new DialogOpenOptions
+            {
+                Title = "Edit User",
+                Size = DialogSize.Large
+            });
+
+        if (!result.Cancelled)
+        {
+            var data = result.GetData<UserDto>();
+            customResult = $"Saved: {data}";
+        }
+        else
+        {
+            customResult = "Cancelled";
+        }
+    }
+
+    public sealed class EditUserDemoComponent : ComponentBase
+    {
+        [Parameter] public int UserId { get; set; }
+
+        [CascadingParameter]
+        public IDialogReference DialogRef { get; set; } = default!;
+
+        private string? userName;
+        private string? userEmail;
+
+        protected override void OnInitialized()
+        {
+            // Simulate loading user data
+            userName = $"User {UserId}";
+            userEmail = "example@company.com";
+        }
+
+        private Task Save()
+        {
+            var dto = new UserDto(
+                UserId,
+                userName ?? string.Empty,
+                userEmail ?? string.Empty);
+
+            return DialogRef.CloseAsync(DialogResult.Ok(dto));
+        }
+
+        private Task Cancel()
+            => DialogRef.CancelAsync();
+
+        protected override void BuildRenderTree(Microsoft.AspNetCore.Components.Rendering.RenderTreeBuilder __builder)
+        {
+            <div class="space-y-4">
+                <div>Editing User @UserId</div>
+                <BbInput @bind-Value="userName" Placeholder="Name" />
+                <BbInput @bind-Value="userEmail" Placeholder="Email" Type="InputType.Email" />
+                <div class="flex justify-end gap-2">
+                    <BbButton Variant="ButtonVariant.Outline" OnClick="Cancel">Cancel</BbButton>
+                    <BbButton OnClick="Save">Save</BbButton>
+                </div>
+            </div>
+        }
+    }
+
+    public sealed record UserDto(int Id, string Name, string Email);
 }

src/BlazorBlueprint.Components/Components/Chart/Series/BbBar.razor.cs

@@ -57,7 +57,7 @@ public partial class BbBar : SeriesBase
     /// Gets or sets the position of the data label relative to the bar.
     /// </summary>
     /// <remarks>
-    /// Default is <see cref="Components.LabelPosition.Top"/> for vertical bars.
+    /// Default is <see cref="LabelPosition.Top"/> for vertical bars.
     /// </remarks>
     [Parameter]
     public LabelPosition LabelPosition { get; set; } = LabelPosition.Top;

src/BlazorBlueprint.Components/Components/Chart/Series/BbPie.razor.cs

@@ -70,7 +70,7 @@ public partial class BbPie : SeriesBase
     /// Gets or sets the label position relative to pie slices.
     /// </summary>
     /// <remarks>
-    /// Default is <see cref="Components.LabelPosition.Outside"/>. Use <see cref="Components.LabelPosition.Inside"/>
+    /// Default is <see cref="LabelPosition.Outside"/>. Use <see cref="LabelPosition.Inside"/>
     /// to render labels within slice areas.
     /// </remarks>
     [Parameter]

src/BlazorBlueprint.Components/Components/Dialog/AlertDialogData.cs

@@ -0,0 +1,16 @@
+namespace BlazorBlueprint.Components;
+
+/// <summary>
+/// Represents a pending alert dialog managed by <see cref="DialogService"/>.
+/// </summary>
+/// <remarks>
+/// An alert dialog presents a message with a single acknowledgment button.
+/// It resolves with a confirmed <see cref="DialogResult"/> when dismissed.
+/// </remarks>
+public sealed class AlertDialogData : DialogData
+{
+    /// <summary>
+    /// Gets or sets the customization options for the alert dialog.
+    /// </summary>
+    public AlertDialogOptions Options { get; set; } = new();
+}

src/BlazorBlueprint.Components/Components/Dialog/AlertDialogOptions.cs

@@ -0,0 +1,13 @@
+namespace BlazorBlueprint.Components;
+
+/// <summary>
+/// Options for customizing an alert dialog shown via <see cref="DialogService"/>.
+/// </summary>
+public sealed class AlertDialogOptions
+{
+    /// <summary>
+    /// The label for the acknowledgment button.
+    /// Default: "OK".
+    /// </summary>
+    public string ButtonText { get; set; } = "OK";
+}