C1.QuietPrompts.Core 1.0.1

QuietPrompts NuGet Packages

QuietPrompts is a silent, non-intrusive prompt system for desktop applications, split into two NuGet packages:

📦 Packages

C1.QuietPrompts.Core

Core library containing interfaces, models, and base functionality for the QuietPrompts system.

<PackageReference Include="C1.QuietPrompts.Core" Version="1.0.1" />

dotnet add package C1.QuietPrompts.Core

C1.QuietPrompts.UI

Avalonia-based UI implementation with support for themes, background images, and sound.

<PackageReference Include="C1.QuietPrompts.UI" Version="1.0.1" />

dotnet add package C1.QuietPrompts.UI

🚀 Quick Start

1. Basic Setup

using QuietPrompts.Core;
using QuietPrompts.UI.Services;

// Create the prompt service
var promptService = new AvaloniaPromptService();

// Show a simple information prompt
await promptService.ShowInformationAsync("Hello", "Welcome to QuietPrompts!");

2. Custom Prompts

var config = new PromptConfig
{
    Title = "Custom Prompt",
    Message = "Choose your action:",
    Buttons = new List<PromptButton>
    {
        new() { Text = "Save", Result = PromptResult.Custom1, IsDefault = true },
        new() { Text = "Cancel", Result = PromptResult.Cancel, IsCancel = true }
    }
};

var result = await promptService.ShowPromptAsync(config);

3. Themed Prompts with Background Images

var themedConfig = new PromptConfig
{
    Title = "Styled Prompt",
    Message = "This prompt has a custom theme and background!",
    BackgroundImagePath = @"C:\path\to\your\image.jpg",
    Theme = new PromptTheme
    {
        ForegroundColor = "White",
        FontFamily = "Segoe UI",
        FontSize = 16,
        BackgroundColor = "#2D3748"
    },
    Position = PromptPosition.TopRight
};

var result = await promptService.ShowPromptAsync(themedConfig);

🎨 Features

• Silent Operation: Non-blocking, non-intrusive prompts
• Customizable Themes: Colors, fonts, and styling
• Background Images: Support for image backgrounds with opacity
• Positioning: Place prompts anywhere on screen
• Auto-dismiss: Optional automatic closing with timers
• Sound Support: System sounds and custom audio files
• Keyboard Navigation: Full keyboard support (Tab, Enter, Escape, arrows)
• Symbol Packages: Full debugging support with source symbols

🔧 Advanced Configuration

Sound Integration

var soundConfig = new PromptConfig
{
    Title = "Sound Prompt",
    Message = "This plays a sound!",
    Sound = PromptSound.Information,  // System sound
    // OR
    SoundPath = @"C:\path\to\custom\sound.wav"  // Custom sound file
};

Auto-dismiss with Timer

var timedConfig = new PromptConfig
{
    Title = "Auto-Close",
    Message = "This will close automatically in 5 seconds",
    AutoDismissAfter = TimeSpan.FromSeconds(5)
};

Multiple Positioning Options

var config = new PromptConfig
{
    Position = PromptPosition.TopRight,    // TopRight, TopLeft, BottomRight, BottomLeft, Center
    TopMost = true                         // Always on top
};

🔗 Dependencies

Core Package

• .NET 8.0+
• System.Text.Json
• System.Windows.Extensions

UI Package

• .NET 8.0+
• Avalonia 11.3.2+
• C1.QuietPrompts.Core

📚 Documentation

For complete documentation, examples, and API reference, visit the GitHub repository.

🐛 Symbol Packages

Both packages include symbol packages (.snupkg) for enhanced debugging experience:

• Source code navigation
• Breakpoint support in library code
• Enhanced stack traces

Symbol packages are automatically available when debugging your application.

License

This project is licensed under the Corpi1 Software License (Based on Mozilla Public License 2.0).

You are free to use, modify, and distribute the software. Businesses and individuals can use it, including in commercial activities. However, you may not sell, repackage, or monetize the software itself.

See the LICENSE file for full terms.