A minimal, high‑performance MVVM core for .NET with deterministic async command model, lightweight ViewModel base classes, and a small hierarchical service provider designed for UI applications.
$ dotnet add package NuExt.Minimal.MvvmNuExt.Minimal.Mvvm is a high‑performance, dependency‑free MVVM core for .NET focused on robust async flows and deterministic command execution. It provides a minimal, clear API with Bindable/ViewModel base types, a self‑validating command model (Relay/Async/Composite), and a lightweight service provider.
Core
Minimal.Mvvm.BindableBase — lightweight INotifyPropertyChanged base.Minimal.Mvvm.ViewModelBase — lean ViewModel foundation with simple service access.Minimal.Mvvm.WeakEvent — lightweight weak‑event storage for (object sender, TEventArgs) handlers.Command model (self‑validating)
RelayCommand, RelayCommand<T>, AsyncCommand, AsyncCommand<T>, AsyncValueCommand, AsyncValueCommand<T>, CompositeCommand) validate their state internally:
if CanExecute(parameter) is false, Execute(parameter) does nothing. This guarantees consistent behavior for both UI‑bound and programmatic calls.Semantics
AsyncCommand provides cancellation and reentrancy control (AllowConcurrentExecution, default: false).AsyncValueCommand / AsyncValueCommand<T> are ValueTask-based async commands.UnhandledException (per‑command) first; if not handled, to AsyncCommand.GlobalUnhandledException.Cancel() signals the current operation via CancellationToken; if nothing is executing, it’s a no‑op.Command implementations
RelayCommand / RelayCommand<T> — classic synchronous delegate‑based commands (can be invoked concurrently from multiple threads).AsyncCommand / AsyncCommand<T> — asynchronous commands with predictable error propagation and cancellation.AsyncValueCommand / AsyncValueCommand<T> — asynchronous commands built on ValueTask for allocation‑sensitive scenarios.CompositeCommand — aggregates multiple commands and executes them sequentially; awaits ExecuteAsync(...) and calls Execute(...) for non‑async commands.Service Provider Integration
Minimal.Mvvm.ServiceProvider: lightweight service registration/resolution in UI scenarios.ViewModelBase.Services is created lazily and disposed via your cleanup.ServiceProvider.Default acts as the application-level container. Prefer registering app-wide services there; ViewModels may register local overrides in their own scope.Use the NuExt.Minimal.Mvvm.SourceGenerator for compile‑time boilerplate generation in ViewModels.
AsyncCommand with concurrency and cancellationpublic class SearchViewModel : ViewModelBase
{
public IAsyncCommand<string> SearchCommand { get; }
public ICommand CancelCommand { get; }
public SearchViewModel()
{
SearchCommand = new AsyncCommand<string>(SearchAsync, CanSearch)
{
AllowConcurrentExecution = true
};
CancelCommand = new RelayCommand(() => SearchCommand.Cancel());
}
private async Task SearchAsync(string query, CancellationToken cancellationToken)
{
await Task.Delay(1000, cancellationToken);
Results = $"Results for: {query}";
}
private bool CanSearch(string query) => !string.IsNullOrWhiteSpace(query);
private string _results = string.Empty;
public string Results
{
get => _results;
private set => SetProperty(ref _results, value);
}
}
public class DataViewModel : ViewModelBase
{
public IAsyncCommand LoadDataCommand { get; }
public DataViewModel()
{
LoadDataCommand = new AsyncCommand(LoadDataAsync);
LoadDataCommand.UnhandledException += (sender, e) =>
{
if (e.Exception is HttpRequestException httpEx)
{
ShowError($"Network error: {httpEx.Message}");
e.Handled = true; // local tier handled
}
};
}
private async Task LoadDataAsync(CancellationToken cancellationToken)
{
throw new HttpRequestException("Connection failed");
}
private void ShowError(string message) { /* UI */ }
}
Global fallback: subscribe to AsyncCommand.GlobalUnhandledException once at app startup (composition root) for logging/telemetry.
AsyncCommand.GlobalUnhandledException += (sender, e) =>
{
Logger.LogError(e.Exception, "Global command error");
e.Handled = true;
};
To further simplify your ViewModel development, consider using the source generator provided by the NuExt.Minimal.Mvvm.SourceGenerator package. Here's an example:
using Minimal.Mvvm;
public partial class ProductViewModel : ViewModelBase
{
[Notify]
private string _name = string.Empty;
[Notify(Setter = AccessModifier.Private)]
private decimal _price;
public ProductViewModel()
{
SaveCommand = new AsyncCommand(SaveAsync);
}
[Notify]
private async Task SaveAsync(CancellationToken token)
{
await Task.Delay(500, token);
Price = 99.99m;
}
}
public sealed class MyViewModel : ViewModelBase
{
public MyViewModel(IServiceContainer fallback) : base(fallback)
{
// Application scope (global): ServiceProvider.Default for app-level services.
ServiceProvider.Default.RegisterService<IMyService, MyService>();
// ViewModel scope (local container); override per-VM if needed.
Services.RegisterService<IMyService, MyVmSpecificService>(); // singleton
Services.RegisterTransient<INotification>(() => new Toast()); // transient
}
public void Use()
{
// Resolution order: local → fallback → parent → default
var svc = Services.GetService<IMyService>();
var toast = Services.GetService<INotification>();
}
}
Notes (UI lifetimes):
- Scope = the ViewModel instance (local container). Local services live as long as the VM does.
- Application scope =
ServiceProvider.Default.- Singleton (lazy) = created on first successful resolution and cached in the owning container.
- Transient = new instance per resolution (not cached).
- Cleanup: call
Services.CleanupAsync(...)during uninitialization if you need deterministic disposal of local singletons.
AsyncValueCommand for allocation‑sensitive hot pathspublic sealed class ValidateViewModel : ViewModelBase
{
public IAsyncCommand ValidateCommand { get; }
public ValidateViewModel()
{
// Often completes synchronously; ValueTask avoids allocations in that case.
ValidateCommand = new AsyncValueCommand(ValidateAsync);
}
private ValueTask ValidateAsync(CancellationToken ct)
{
// synchronous fast path
if (IsValidFast()) return ValueTask.CompletedTask;
// fallback async path
return SlowValidateAsync(ct);
}
private bool IsValidFast() => /* lightweight checks */;
private async ValueTask SlowValidateAsync(CancellationToken ct)
{
await Task.Delay(50, ct);
// heavy checks...
}
}
ServiceProvider.Default at startup.ViewModelBase.Services (scope = the ViewModel).var app = new ServiceProvider((System.IServiceProvider)existing);
Then either set it as application scope (ServiceProvider.Default = app) or pass as a ViewModel fallback (: base(app)).name overloads to keep side‑by‑side implementations.ServiceProvider.Default.RegisterService<T>(...)Services.RegisterService<T>(...)RegisterTransient<T>(...)[UseCommandManager] exampleIn WPF, [UseCommandManager] wires a generated command property to CommandManager.RequerySuggested, so CanExecute is reevaluated automatically on typical UI events (focus changes, keyboard, window activation). You don’t need to call RaiseCanExecuteChanged() manually.
using Minimal.Mvvm;
using System.Threading;
using System.Threading.Tasks;
public partial class LoginViewModel : ViewModelBase
{
[Notify] private string _userName = string.Empty;
[Notify] private string _password = string.Empty;
// Field-based pattern: generator creates the LoginCommand property.
// [UseCommandManager] auto-subscribes the property setter to WPF CommandManager.RequerySuggested.
[Notify, UseCommandManager]
private IAsyncCommand? _loginCommand;
public LoginViewModel()
{
LoginCommand = new AsyncCommand(LoginAsync, CanLogin);
}
private bool CanLogin() =>
!string.IsNullOrWhiteSpace(UserName) &&
!string.IsNullOrWhiteSpace(Password);
private async Task LoginAsync(CancellationToken ct)
{
await Task.Delay(250, ct);
// sign-in...
}
}
Alternatively, you can place
[Notify, UseCommandManager]on a method that should become a command; the generator will create the command property and wire WPF requery in the property setter as well.
<Window x:Class="MyApp.Views.LoginView"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:vm="clr-namespace:MyApp.ViewModels"
Title="Login" Width="360" Height="220">
<Window.DataContext>
<vm:LoginViewModel/>
</Window.DataContext>
<StackPanel Margin="16" VerticalAlignment="Center">
<TextBox Margin="0,0,0,8"
Text="{Binding UserName, UpdateSourceTrigger=PropertyChanged}"/>
<TextBox Margin="0,0,0,12"
Text="{Binding Password, UpdateSourceTrigger=PropertyChanged}"/>
<!-- CanExecute will re-evaluate automatically on UI changes thanks to [UseCommandManager] -->
<Button Content="Sign in"
Command="{Binding LoginCommand}"
HorizontalAlignment="Right"
MinWidth="96" Padding="12,6"/>
</StackPanel>
</Window>
[UseCommandManager] is WPF‑only; Avalonia/WinUI don’t have CommandManager.CommandManager.InvalidateRequerySuggested().You have two options to enable AsyncValueCommand* on legacy TFMs:
Recommended: install the binary add‑on
dotnet add package NuExt.Minimal.Mvvm.Legacy
This adds AsyncValueCommand* for net462/netstandard2.0 and pulls System.Threading.Tasks.Extensions only on legacy.
Sources‑only workflow: opt‑in via .Sources and NUEXT_ENABLE_VALUETASK + System.Threading.Tasks.Extensions.
Q: How is this different from CommunityToolkit.Mvvm?
A: NuExt.Minimal.Mvvm focuses on a smaller, deterministic core with strict command semantics (no‑op Execute when CanExecute is false), explicit async error pipeline (local → global), and no external dependencies. CommunityToolkit.Mvvm provides a broader toolbox (messaging, DI helpers, attributes, etc.). If you need a minimal, performance‑oriented core with predictable async/command behavior, NuExt.Minimal.Mvvm is a good fit; if you want a feature‑rich toolkit, CommunityToolkit.Mvvm may be preferable.
Q: Do I have to wire WPF CommandManager.RequerySuggested myself?
A: No. With the source generator, mark the command with [UseCommandManager], and the generated property will auto‑subscribe/unsubscribe for requery.
Q: What is the command error flow?
A: Exceptions raised during AsyncCommand execution are first published to UnhandledException; if not handled there, they flow to AsyncCommand.GlobalUnhandledException.
Q: How do I integrate my existing DI container?
A: Wrap it as a parent via new ServiceProvider(System.IServiceProvider parent).
Use it in one of two ways:
ServiceProvider.Default = new ServiceProvider(parent), so all ViewModels can resolve app‑wide services via the default provider.: base(fallback)) when you need a VM to resolve “up” into the external container while still allowing local overrides in that VM scope.Q: Where are scoped services?
A: A ViewModel is the scope. Register app‑wide singletons in ServiceProvider.Default (application scope).
Register per‑VM overrides in ViewModelBase.Services (the VM’s local scope). Transients are created per resolution.
Q: What is the “application scope”?
A: ServiceProvider.Default. Register app-wide singletons there; ViewModels resolve with the order local → fallback → parent → default.
Via NuGet:
dotnet add package NuExt.Minimal.Mvvm
Or via Visual Studio:
Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution....NuExt.Minimal.Mvvm.A source package is also available: NuExt.Minimal.Mvvm.Sources. This package allows you to embed the entire framework directly into your application, enabling easier source code exploring and debugging.
See ValueTask commands on legacy targets for legacy opt‑in details.
To install the source code package, use the following command:
dotnet add package NuExt.Minimal.Mvvm.Sources
Or via Visual Studio:
Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution....NuExt.Minimal.Mvvm.Sources.Legacy only: to use
AsyncValueCommand*on .NET Framework 4.6.2 / .NET Standard 2.0, see ValueTask commands on legacy targets (binary add‑on or.Sourcesopt‑in withNUEXT_ENABLE_VALUETASKandSystem.Threading.Tasks.Extensions).
Issues and PRs are welcome. Keep changes minimal and performance-conscious.
MIT. See LICENSE.