GuiBlast 2.1.1

GuiBlast

NuGet NuGet Downloads License

RoadWarrior

GuiBlast provides simple, cross-platform modal prompts and dynamic forms using Avalonia. It works out-of-the-box in .NET console apps, LINQPad, and PowerShell scripts — no window management required.

✨ Features

• 🔹 Minimal blocking & async APIs (Input, Confirm, Message)
• 🔹 JSON-driven dynamic forms with validation & visibility rules
• 🔹 Light/Dark theme switching via Theme.Set
• 🔹 Runs Avalonia on a hidden UI thread → safe for console and scripting environments

📦 Installation

dotnet add package GuiBlast

Or install from NuGet Gallery.

🚀 Quick Example

using GuiBlast.Forms.Rendering;
using GuiBlast.Forms.Result;
namespace GuiBlast.TryOut;
class Program
{
 static void Main()
 {
 // Step 1: Prompt for name
 var userName = Prompts.Input("Your Name", "Please enter your name:");
 // Step 2: Load form JSON spec
 var json = File.ReadAllText("form.json");
 // Step 3: Pre-fill the form with the name
 var overrides = new Dictionary<string, object?>
 {
 ["name"] = userName
 };
 // Step 4: Show form
 var result = DynamicForm.ShowJsonAsync(json, overrides).Result;
 // Step 5: Print outcome
 Console.WriteLine($"Submitted: {result.Submitted}");
 Console.WriteLine("---- TEXT ----");
 Console.WriteLine(result.ToText());
 Console.WriteLine("---- JSON ----");
 Console.WriteLine(result.ToJson(indented: true));
 Console.WriteLine("---- DIRECT TO WRITER ----");
 result.WriteText(); 
 }
}

📋 JSON Form Specification

GuiBlast forms are defined declaratively in JSON:

{
 "title": "Peer",
 "size": { "width": 420, "height": 320 },
 "resizable": true,
 "data": {
 "name": "Alice",
 "role": "User",
 "enabled": true,
 "quota": 5,
 "tags": ["a", "c"]
 },
 "fields": [
 { "key": "name", "type": "text", "label": "Name", "required": true },
 {
 "key": "role",
 "type": "select",
 "label": "Role",
 "options": [
 { "value": "User", "label": "User" },
 { "value": "Admin", "label": "Admin" },
 { "value": "Guest", "label": "Guest" }
 ]
 },
 { "key": "enabled", "type": "switch", "label": "Enabled" },
 { "key": "quota", "type": "number", "label": "Quota (GB)", "min": 0, "max": 100 },
 {
 "key": "tags",
 "type": "multiselect",
 "label": "Tags",
 "options": [
 { "value": "a", "label": "a" },
 { "value": "b", "label": "b" },
 { "value": "c", "label": "c" }
 ]
 },
 { "key": "when", "type": "datetime", "label": "When" }
 ],
 "visibility": [
 { "field": "role", "eq": "Admin", "show": ["quota"] },
 { "field": "role", "neq": "Admin", "hide": ["quota"] }
 ],
 "actions": [
 { "id": "save", "label": "Save", "submit": true },
 { "id": "cancel", "label": "Cancel", "dismiss": true }
 ]
}

🔧 Supported Field Types

• text, number, switch
• select, multiselect
• datetime

Validation & conditional visibility can be expressed directly in JSON.

🤖 AI assistants

This assembly carries the Blast.PrimaryFacade convention: an [AssemblyMetadata("Blast.PrimaryFacade", "...")] attribute names the canonical front-door type(s) of the package, so AI helpers (e.g. TaskBlaster's script assistant) can identify the entry points without scanning every public type.

For GuiBlast the front doors are:

Read it back from a loaded assembly via reflection:

var facade = typeof(GuiBlast.Prompts).Assembly
 .GetCustomAttributes<AssemblyMetadataAttribute>()
 .FirstOrDefault(a => a.Key == "Blast.PrimaryFacade")?.Value;

The value is a hint for tooling; consumers don't need to read it.

📜 License

MIT