Reflexor 0.0.6

dotnet add package Reflexor --version 0.0.6
                    
NuGet\Install-Package Reflexor -Version 0.0.6
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Reflexor" Version="0.0.6">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Reflexor" Version="0.0.6" />
                    
Directory.Packages.props
<PackageReference Include="Reflexor">
  <PrivateAssets>all</PrivateAssets>
  <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
</PackageReference>
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Reflexor --version 0.0.6
                    
#r "nuget: Reflexor, 0.0.6"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Reflexor@0.0.6
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Reflexor&version=0.0.6
                    
Install as a Cake Addin
#tool nuget:?package=Reflexor&version=0.0.6
                    
Install as a Cake Tool

Reflexor

<img src="https://raw.githubusercontent.com/sadicangel/reflexor/refs/heads/main/icon.png" width="256"/>

Reflexor is a C# source generator that produces mutable proxy types for immutable record and class types.

Whether you're working with immutable data models and need editable views, UI bindings, or draft mutations, Reflexor lets you work with a mutable representation of your readonly types — without writing boilerplate code.


✨ Features

  • 🧬 Generates mutable struct proxies for immutable record and class types.
  • 🛠️ Keeps property names, types, and structure aligned.
  • 💨 Designed for performance and minimal memory overhead.
  • ✅ Supports init-only and positional parameters.
  • ✅ Supports static members and static classes on .NET 10.

🚀 Example

Original Record

[Reflexor]
public record User(string UserName, int Age);

Generated Proxy

public partial struct UserProxy
{
    public string UserName { get; set; }
    public int Age { get; set; }
}
// Property implementations omitted for brevity
var user = new User("John_Doe", 29);
// user.UserName = "Jane_Doe"; error CS8852

var proxy = new UserProxy(user);
proxy.UserName = "Jane_Doe";

Console.WriteLine(user.UserName);
// "Jane_Doe"

🧩 Usage

1. Install the NuGet Package

dotnet add package Reflexor

Reflexor targets .NET 10 consumers. The source generator itself is packaged as a netstandard2.0 analyzer.

2. Annotate Your Types

Just add a [Reflexor] attribute to any immutable record or class.

[Reflexor]
public record Order(int Id, DateTime Date, string Customer);

That's it — Reflexor will generate a proxy type automatically!


🛡️ Why Use Proxies?

Working with immutable models is great for safety, but tricky for things like:

  • UI data binding (e.g., Blazor, WPF, MAUI)
  • Form editing and validation
  • Intermediate "draft" state management
  • Patch or delta generation

Reflexor bridges this gap by creating mutable counterparts on the fly.


👷‍♂️ Contributing

Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.


📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.0.6 96 5/13/2026
0.0.5 89 5/13/2026
0.0.4 92 5/13/2026
0.0.3 101 5/12/2026
0.0.2 98 5/12/2026
0.0.1 89 5/11/2026