MVVM_Utility 1.0.4

Mvvm.TrackableViewModel

Mvvm.TrackableViewModel is a lightweight utility library that simplifies MVVM development by providing deep cloning, edit tracking, and change detection for parent-child view models.

Ideal for WPF, WinForms, and Blazor applications that require editing and rollback support in nested view model hierarchies.

✨ Features

• ✅ Deep cloning with System.Text.Json or Newtonsoft.Json
• ✅ Built-in support for IEditableObject (BeginEdit, CancelEdit, EndEdit)
• ✅ Implements IChangeTracking for automatic change detection
• ✅ Tracks and propagates change state across nested view models
• ✅ Seamlessly integrates with UI data binding
• ✅ Multi-targeting: .NET Framework 4.6.2+, .NET 5–9

📦 Installation

Use the .NET CLI:

dotnet add package Mvvm.TrackableViewModel

Or via NuGet Package Manager:

Install-Package Mvvm.TrackableViewModel

🧪 Example Usage

public class PersonViewModel : ParentBaseViewModel<PersonViewModel>
{
    private string _name;
    public string Name
    {
        get => _name;
        set => UpdateObservable(ref _name, value);
    }

    private int _age;
    public int Age
    {
        get => _age;
        set => UpdateObservable(ref _age, value);
    }

    public PersonViewModel(string name, int age)
    {
        Name = name;
        Age = age;
    }
}

// Usage
var person = new PersonViewModel("Alice", 30);
person.BeginEdit();

person.Name = "Bob"; // This will trigger change tracking

if (person.IsChanged)
{
    person.CancelEdit(); // Reverts changes
    // or
    person.EndEdit(); // Accepts changes and exits edit mode
}

🧠 How it Works

• BeginEdit() makes a deep clone of the current view model.
• CancelEdit() reverts all properties back to the cloned state.
• EndEdit() clears the backup and marks the model as clean.
• IsChanged gets updated automatically whenever any property changes.
• Changes in child view models or collections are automatically tracked.

📂 Supported Frameworks

• .NET 5.0
• .NET 6.0
• .NET 7.0
• .NET 8.0
• .NET 9.0
• .NET Framework 4.6.2 and 4.8

🔒 License

© 2025 Abdou Djalilou Ali. All rights reserved.
Licensed under the MIT License.

🙌 Contributing

Feel free to open issues or submit pull requests to improve functionality or documentation!