This release focuses on improving compatibility, enhancing project templates, and expanding built-in support for standard .NET types.

🚀 New Features

• Native AOT Support: Pure.DI.MS now fully supports Native AOT compilation, enabling better compatibility with modern .NET applications.
• Enhanced Project Templates: Improved templates with automatic version configuration make creating new projects faster and more convenient.
• Extended Built-in Type Support: Added out-of-the-box support for additional .NET standard types including TaskCompletionSource, CultureInfo, IFormatProvider, RandomNumberGenerator, IReadOnlySet, TimeProvider, and StringComparer.

🐞 Bug Fixes

• Improved Native AOT compatibility in Pure.DI.MS.
• Better handling of version placeholders in project templates.
• Optimized code generation for improved performance and reduced overhead.

🎨 Improvements

• More readable generated code with improved formatting and detailed comments.
• Enhanced documentation with better examples and getting started guides.
• Optimized performance by removing unnecessary synchronization in generated code.

Full Changelog: 2.4.2...2.4.3

🚀 Improvements

• Emit _lock field only when actually used. The thread-safety _lock field is no longer emitted in generated compositions when no lock(...) statement references it. Previously it was created conservatively for any composition with overrides, wasting memory on every instance. No behavioral changes for compositions that genuinely require thread safety.

🐛 Bug Fixes

• Fix nullable reference type support. Distinguish T and T? in DI contracts and fix invalid ?? generated for nullable generic singleton dependencies.

Full Changelog: 2.4.1...2.4.2

🚀 New Features

Enhanced Code Generation

• Improved type handling and formatting logic for better class diagram generation
• Optimized Local Functions Logic — performance improvements in local function handling

🐛 Bug Fixes

Localization Issues — fixed localization problems across multiple language resource files. Updated all localization strings for Arabic, Bengali, German, Spanish, French, Hebrew, Hindi, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Thai, Vietnamese, and Chinese

Full Changelog: 2.4.0...2.4.1

❗ Breaking Changes

• Nullable Reference Types — This release introduces full support for nullable reference types, which changes how Pure.DI handles nullable types throughout the pipeline. Code that previously relied on automatic null checks for nullable arguments may need adjustment.

🚀 New Features

• Nullable Reference Types — Breaking change! Pure.DI now fully preserves nullable reference type annotations throughout the dependency injection pipeline.

  • Nullable composition arguments (.Arg<T?>()) and root arguments (.RootArg<T?>()) no longer generate null checks, allowing null values to flow through as intended.
  • Non-null bindings can satisfy nullable dependencies — useful for optional constructor parameters, nullable factory results, and nullable collection elements.
  • Type system integration: nullable annotations are preserved when reading contracts, building graphs, and generating composition members.
  • Generic constraint awareness: prefer where T : class? over where T : class for contracts with nullable generic arguments to avoid C# compiler warnings.
  • New warnings for ambiguous nullable root types in Resolve methods help catch potential issues early.
  • See readme/nullable-reference-types.md for detailed examples and best practices.

• TryBuildUp for Builders

  • New TryBuildUp method generated alongside BuildUp for safe type-based composition.
  • Returns false instead of throwing when the runtime subtype is unknown, enabling graceful fallback handling.
  • Example: composition.TryBuildUp(externalRobot) returns false for unsupported types while composition.BuildUp(externalRobot) would throw ArgumentException.
  • See readme/builders.md for usage examples.

👥 Contributors

Thanks to everyone who contributed to this release:

• Adam Hathcock (@adamhathcock)
• Nikolay Pianikov (@NikolayPianikov)

Full Changelog: 2.3.7...2.4.0

Contributors

• @adamhathcock
• @NikolayPianikov

🚀 New Features

• Generate Interfaces from Classes — special thanks to Adam Hathcock for designing and implementing this feature! 🎉

  • New [GenerateInterface] attribute lets a concrete service produce a matching interface automatically, so consumers can depend on the abstraction without hand-writing it.
  • Customize the generated interface: set the interface name, namespace, and access level via named arguments.
  • Generate several interfaces from one class by applying [GenerateInterface] multiple times, with per-interface member selection.
  • Ignore specific members with [IgnoreInterface], which takes precedence over [GenerateInterface].
  • Generic interfaces are supported.
  • XML documentation comments on source members are preserved on the generated interface.

• Scope Setup

  • New SetupScope method for composing scoped sub-graphs from a parent composition — open a scope per request/operation, share scoped instances inside it, and dispose them at the end.
  • Scopes can be produced by factory methods, enabling custom scope creation logic.
  • Parent and child scopes are validated to be distinct, preventing accidental self-nesting.
  • New Hint.ScopeMethodName hint lets you rename the generated scope factory method to fit your domain (e.g. SetupScope, CreateScope, BeginRequest):

    DI.Setup()
     .Hint(Hint.ScopeMethodName, "SetupScope")
     .Bind().As(Scoped).To<RequestContext>();

• Unity Scene Scopes

  • New Unity scene scopes scenario: each loaded Unity scene gets its own scope, so scoped services are shared within a scene and isolated between scenes — Unity creates the MonoBehaviour instances and Pure.DI builds them up.

• Microsoft DI Integration: Scoped Lifetimes

  • IServiceProvider integration now supports scoped lifetimes end-to-end via composition.CreateScope(), matching Microsoft.Extensions.DependencyInjection semantics.
  • Tag-based resolution and value-type roots are supported through the integration.

• Generated Code is Marked

  • All generated code is now decorated with [GeneratedCode], so analyzers, coverage, and code-style tools can recognize and skip it correctly.
  • The generated Composition class embeds the actual Pure.DI package version it was produced with, instead of a hard-coded string.

🐛 Bug Fixes

• Fixed scoped/singleton instance propagation through nested scopes.
• Fixed read-only handling of setup-context arguments inside generated scope methods.

👥 Contributors

Thanks to everyone who contributed to this release:

• Adam Hathcock (@adamhathcock)
• Nikolay Pianikov (@NikolayPianikov)

Full Changelog: 2.3.6...2.3.7

Contributors

• @adamhathcock
• @NikolayPianikov

🚀 New Features

• BCL Dictionary Support

  • Added support for injecting .NET Base Class Library Dictionary<TKey, TValue> types
  • Extended injection capabilities to cover standard dictionary types from BCL

• IContext Extensions

  • Added RootName and RootType properties to IContext interface
  • Added IsLockRequired property to IContext

• Extended Factory Method Bindings

  • Added support for up to 16-parameter factory method bindings
  • Increased from previous limit, supporting more complex factory scenarios

⚡ Performance Improvements

• Metadata Analysis

  • Optimized metadata analysis pipeline
  • Reduced overhead in setup metadata detection

• Code Generation

  • Optimized factory code generation with reduced allocations
  • Optimized type resolution process

• Graph Building

  • Reduced semantic analysis overhead by favoring syntactic analysis
  • Improved graph construction performance

📝 Documentation

• Updated and improved README documentation
• Added "Article Basics" documentation

Full Changelog: 2.3.5...2.3.6

🐛 Bug Fixes

• #140 Incorrect generated code for the PerBlock lifetime: a local or parameter named ... cannot be declared in this scope because that name is used in an enclosing local scope to define a local or parameter
• #141 Objects created without explicit binding began to use the specified default lifetime instead of Transient

Contributors

@YoshihiroIto
@NikolayPianikov

Full Changelog: 2.3.4...2.3.5

Contributors

• @YoshihiroIto
• @NikolayPianikov

🚀 New Features

• Auto-Bindings Default Lifetime Support

  • Added support for default lifetime configuration in auto-bindings
  • Improves consistency and reduces manual configuration

• Anonymous Roots (#138)

  • Made anonymous roots lightweight
  • Reduced memory footprint and improved performance for anonymous root scenarios

🐛 Bug Fixes

• #132 : Fixed optional enum default value emission

  • Fixed issue where optional enum default values were emitted as int literals, causing CS1503 compilation error
  • Enum default values from other assemblies are now correctly generated
  • Enhanced handling of explicit default values for enum types in dependency injection

• #133 : Fixed null parameter issue in self-injecting registrations

  • Fixed issue where null was passed as parameter when a registration injects itself
  • Improved Lazy status determination by properly taking into account injected dependencies

• DIE043: Fixed casting exception

  • Fixed "Unable to cast object of type 'System.Int32' to type 'System.String'" error
  • Improved type handling in dependency graph construction

• Improved error message for unresolved dependencies

⚡ Performance Improvements (#136)

• Cache Refactoring

  • Significant performance improvements through cache refactoring
  • Reduced redundant operations in dependency graph building

• Graph Build Optimizations

  • Optimization of graph build process to reduce computation time
  • Reduced number of attempts to build a dependency graph
  • Improved metadata analysis with preference for syntactic analysis instead of semantic

• Variable Management

  • Optimization of Var and VarsMap handling
  • Improved graph build context preparation
  • Enhanced scope persistence rules with helper methods

• Metadata Analysis

  • Optimized metadata analysis pipeline
  • Reduced overhead in setup metadata detection

• GraphOverrider

  • Refactored GraphOverrider internals into focused helpers
  • Improved override depth handling

• Code Generation

  • Spot optimization to eliminate unnecessary local values in generation
  • Optimized dependency graph construction by handling duplicate injections

• Multithreading

  • Removed multithreading to improve stability

Full Changelog: 2.3.3...2.3.4

🐞 Bug Fixes

• #132 Optional enum default value is emitted as int literal, causing CS1503

Full Changelog: 2.3.2...2.3.3

🚀 New Features

• Setup Context Support, see these examples:

  • Dependent compositions with setup context
  • Dependent compositions with setup context members
  • Dependent compositions with setup context members and property accessors
  • Dependent compositions with setup context root argument

• Added support for deep and one-level override behavior, see this example:

  • Override depth

• Error Handling and Diagnostics

  • Added specific IDs for errors and warnings to improve clarity
  • Added errors and warning descriptions
  • Linked diagnostics to documentation with help links in diagnostic descriptors
  • Added localization support for new error and warning messages

• Code Generation Enhancements

  • Optimize dependency graph construction by handling duplicate injections and improving object creation workflow

Contributors

@xchesh
@NikolayPianikov

Contributors

• @xchesh
• @NikolayPianikov