Update README

Author: NikolayPianikov

README.md

@@ -1165,6 +1165,7 @@ DI.Setup("Composition")
 | [DisableAutoBindingImplementationTypeNameWildcard](#disableautobindingimplementationtypenamewildcard-hint)                           | Wildcard                                   |            | *         |
 | [DisableAutoBindingLifetimeRegularExpression](#disableautobindinglifetimeregularexpression-hint)                                     | Regular expression                         |            | .+        |
 | [DisableAutoBindingLifetimeWildcard](#disableautobindinglifetimewildcard-hint)                                                       | Wildcard                                   |            | *         |
+| [LightweightAnonymousRoot](#lightweightanonymousroot-hint)                                                                           | _On_ or _Off_                              |            | _On_      |
 
 The list of hints will be gradually expanded to meet the needs and desires for fine-tuning code generation. Please feel free to add your ideas.
 
@@ -1822,6 +1823,16 @@ DI.Setup(nameof(Composition))
     .Root<Service>("MyService");
 ```
 
+### LightweightAnonymousRoot Hint
+
+Controls whether anonymous composition roots are generated in a lightweight manner. When _On_ (default), anonymous roots are optimized for minimal overhead. Set to _Off_ if you need full debugging capabilities for anonymous roots.
+
+```c#
+// LightweightAnonymousRoot = Off
+DI.Setup("Composition")
+    .Bind<IService>().To<Service>();
+```
+
 </details>
 
 <details>

readme/accumulators.md

@@ -105,6 +105,7 @@ partial class Composition
     get
     {
       var perBlockTelemetryRegistry1 = new TelemetryRegistry();
+      var perBlockSqlDataSource5 = new SqlDataSource();
       if (_singletonNetworkDataSource53 is null)
         lock (_lock)
           if (_singletonNetworkDataSource53 is null)
@@ -122,7 +123,7 @@ partial class Composition
         perBlockTelemetryRegistry1.Add(transientSqlDataSource3);
       }
 
-      var transientDashboard2 = new Dashboard(transientSqlDataSource3, _singletonNetworkDataSource53, new SqlDataSource());
+      var transientDashboard2 = new Dashboard(transientSqlDataSource3, _singletonNetworkDataSource53, perBlockSqlDataSource5);
       lock (_lock)
       {
         perBlockTelemetryRegistry1.Add(transientDashboard2);

readme/async-disposable-scope.md

@@ -173,13 +173,13 @@ partial class Composition: IDisposable, IAsyncDisposable
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      Func<Session> transientFunc524 = new Func<Session>(
+      Func<Session> perBlockFunc542 = new Func<Session>(
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       () =>
       {
         return new Session(this);
       });
-      return new Program(transientFunc524);
+      return new Program(perBlockFunc542);
     }
   }
 
@@ -274,8 +274,8 @@ classDiagram
 	Composition ..> Service : IService SessionRoot
 	Service o-- "Scoped" Dependency : IDependency
 	Program o-- "PerBlock" FuncᐸSessionᐳ : FuncᐸSessionᐳ
-	Session *--  Composition : Composition
 	FuncᐸSessionᐳ *--  Session : Session
+	Session *--  Composition : Composition
 	namespace Pure.DI.UsageTests.Lifetimes.AsyncDisposableScopeScenario {
 		class Composition {
 		<<partial>>

readme/async-enumerable.md

@@ -89,14 +89,14 @@ partial class Composition
     get
     {
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
-      async IAsyncEnumerable<IHealthCheck> EnumerationOf_transientIAsyncEnumerable345()
+      async IAsyncEnumerable<IHealthCheck> EnumerationOf_transientIAsyncEnumerable349()
       {
         yield return new MemoryCheck();
         yield return new ExternalServiceCheck();
         await Task.CompletedTask;
       }
 
-      return new HealthService(EnumerationOf_transientIAsyncEnumerable345());
+      return new HealthService(EnumerationOf_transientIAsyncEnumerable349());
     }
   }
 }

readme/async-root.md

@@ -78,24 +78,24 @@ partial class Composition
   {
     Task<IBackupService> transientTask194;
     // Injects an instance factory
-    Func<IBackupService> transientFunc195 = new Func<IBackupService>(
+    Func<IBackupService> perBlockFunc195 = new Func<IBackupService>(
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     () =>
     {
       return new BackupService(new FileStore());
     });
-    Func<IBackupService> localFactory = transientFunc195;
+    Func<IBackupService> localFactory = perBlockFunc195;
     // Injects a task factory creating and scheduling task objects
-    TaskFactory<IBackupService> transientTaskFactory196;
+    TaskFactory<IBackupService> perBlockTaskFactory196;
     CancellationToken localCancellationToken = cancellationToken;
     TaskCreationOptions transientTaskCreationOptions200 = TaskCreationOptions.None;
     TaskCreationOptions localTaskCreationOptions = transientTaskCreationOptions200;
     TaskContinuationOptions transientTaskContinuationOptions201 = TaskContinuationOptions.None;
     TaskContinuationOptions localTaskContinuationOptions = transientTaskContinuationOptions201;
     TaskScheduler transientTaskScheduler202 = TaskScheduler.Default;
     TaskScheduler localTaskScheduler = transientTaskScheduler202;
-    transientTaskFactory196 = new TaskFactory<IBackupService>(localCancellationToken, localTaskCreationOptions, localTaskContinuationOptions, localTaskScheduler);
-    TaskFactory<IBackupService> localTaskFactory = transientTaskFactory196;
+    perBlockTaskFactory196 = new TaskFactory<IBackupService>(localCancellationToken, localTaskCreationOptions, localTaskContinuationOptions, localTaskScheduler);
+    TaskFactory<IBackupService> localTaskFactory = perBlockTaskFactory196;
     // Creates and starts a task using the instance factory
     transientTask194 = localTaskFactory.StartNew(localFactory);
     return transientTask194;

readme/auto-scoped.md

@@ -154,18 +154,18 @@ partial class Composition
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      Func<IListeningSession> transientFunc532 = new Func<IListeningSession>(
+      Func<IListeningSession> perBlockFunc550 = new Func<IListeningSession>(
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       () =>
       {
-        IListeningSession transientIListeningSession533;
+        IListeningSession transientIListeningSession551;
         Composition localParentScope = this;
         // Create a child scope so scoped services (PlaybackQueue) are unique per session.
         var localScope = new Composition(localParentScope);
-        transientIListeningSession533 = localScope.Session;
-        return transientIListeningSession533;
+        transientIListeningSession551 = localScope.Session;
+        return transientIListeningSession551;
       });
-      return new MusicApp(transientFunc532);
+      return new MusicApp(perBlockFunc550);
     }
   }
 

readme/automapper.md

@@ -188,6 +188,7 @@ partial class Composition: IDisposable
   private object[] _disposables;
   private int _disposeIndex;
 
+  private Program? _singletonProgram58;
   private Microsoft.Extensions.Logging.ILogger? _singletonILogger55;
   private Func<Student, Person>? _singletonFunc59;
   private AutoMapper.Mapper? _singletonMapper56;
@@ -214,50 +215,55 @@ partial class Composition: IDisposable
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      if (_root._singletonFunc59 is null)
+      if (_root._singletonProgram58 is null)
         lock (_lock)
-          if (_root._singletonFunc59 is null)
+          if (_root._singletonProgram58 is null)
           {
-            _root._singletonFunc59 = source =>
-            {
-              if (_root._singletonMapper56 is null)
-              {
-                EnsureLoggerFactoryExists();
-                LoggerFactory localLoggerFactory = _root._singletonLoggerFactory54;
-                // Create the mapping configuration
-                var localConfiguration = new MapperConfiguration(cfg =>
+            if (_root._singletonFunc59 is null)
+              lock (_lock)
+                if (_root._singletonFunc59 is null)
                 {
-                  cfg.CreateMap<Student, Person>();
-                }, localLoggerFactory);
-                localConfiguration.CompileMappings();
-                // Create the mapper
-                _root._singletonMapper56 = new Mapper(localConfiguration);
-              }
-
-              AutoMapper.IMapper localMapper = _root._singletonMapper56;
-              // source -> target
-              Person localTarget = localMapper.Map<Student, Person>(source);
-              // Building-up a mapped value with dependencies
-              if (_root._singletonPersonFormatter53 is null)
-              {
-                _root._singletonPersonFormatter53 = new PersonFormatter();
-              }
-
-              localTarget.Formatter = _root._singletonPersonFormatter53;
-              return localTarget;
-            };
-          }
+                  _root._singletonFunc59 = source =>
+                  {
+                    if (_root._singletonMapper56 is null)
+                    {
+                      EnsureLoggerFactoryExists();
+                      LoggerFactory localLoggerFactory = _root._singletonLoggerFactory54;
+                      // Create the mapping configuration
+                      var localConfiguration = new MapperConfiguration(cfg =>
+                      {
+                        cfg.CreateMap<Student, Person>();
+                      }, localLoggerFactory);
+                      localConfiguration.CompileMappings();
+                      // Create the mapper
+                      _root._singletonMapper56 = new Mapper(localConfiguration);
+                    }
+
+                    AutoMapper.IMapper localMapper = _root._singletonMapper56;
+                    // source -> target
+                    Person localTarget = localMapper.Map<Student, Person>(source);
+                    // Building-up a mapped value with dependencies
+                    if (_root._singletonPersonFormatter53 is null)
+                    {
+                      _root._singletonPersonFormatter53 = new PersonFormatter();
+                    }
 
-      if (_root._singletonILogger55 is null)
-        lock (_lock)
-          if (_root._singletonILogger55 is null)
-          {
-            EnsureLoggerFactoryExists();
-            LoggerFactory localLoggerFactory1 = _root._singletonLoggerFactory54;
-            _root._singletonILogger55 = localLoggerFactory1.CreateLogger("info");
+                    localTarget.Formatter = _root._singletonPersonFormatter53;
+                    return localTarget;
+                  };
+                }
+
+            if (_root._singletonILogger55 is null)
+            {
+              EnsureLoggerFactoryExists();
+              LoggerFactory localLoggerFactory1 = _root._singletonLoggerFactory54;
+              _root._singletonILogger55 = localLoggerFactory1.CreateLogger("info");
+            }
+
+            _root._singletonProgram58 = new Program(_root._singletonILogger55, new StudentService(_root._singletonFunc59));
           }
 
-      return new Program(_root._singletonILogger55, new StudentService(_root._singletonFunc59));
+      return _root._singletonProgram58;
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       void EnsureLoggerFactoryExists()
       {
@@ -282,6 +288,7 @@ partial class Composition: IDisposable
       _disposeIndex = 0;
       disposables = _disposables;
       _disposables = new object[1];
+      _singletonProgram58 = null;
       _singletonILogger55 = null;
       _singletonFunc59 = null;
       _singletonMapper56 = null;

readme/bind-attribute.md

@@ -109,7 +109,7 @@ partial class Composition
       EnsureDeviceFeatureProviderExists();
       DeviceFeatureProvider localInstance_1182D1277 = _singletonDeviceFeatureProvider51;
       transientIGps209 = localInstance_1182D1277.Gps;
-      Func<ICamera> transientFunc210 = new Func<ICamera>(
+      Func<ICamera> perBlockFunc210 = new Func<ICamera>(
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       () =>
       {
@@ -119,7 +119,7 @@ partial class Composition
         transientICamera212 = localInstance_1182D1278.Camera;
         return transientICamera212;
       });
-      return new PhotoService(transientIGps209, transientFunc210);
+      return new PhotoService(transientIGps209, perBlockFunc210);
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       void EnsureDeviceFeatureProviderExists()
       {

readme/build-up-of-an-existing-generic-object.md

@@ -106,16 +106,16 @@ partial class Composition
   public IFacade<Guid> GetFacade(string userName)
   {
     if (userName is null) throw new ArgumentNullException(nameof(userName));
-    UserContext<Guid> transientUserContext458;
+    UserContext<Guid> transientUserContext474;
     // The "BuildUp" method injects dependencies into an existing object.
     // This is useful when the object is created externally (e.g., by a UI framework
     // or an ORM) or requires specific initialization before injection.
     UserContext<Guid> localContext = new UserContext<Guid>();
-    Guid transientGuid460 = Guid.NewGuid();
+    Guid transientGuid476 = Guid.NewGuid();
     localContext.UserName = userName;
-    localContext.SetId(transientGuid460);
-    transientUserContext458 = localContext;
-    return new Facade<Guid>(transientUserContext458);
+    localContext.SetId(transientGuid476);
+    transientUserContext474 = localContext;
+    return new Facade<Guid>(transientUserContext474);
   }
 }
 ```

readme/check-for-a-root.md

@@ -116,12 +116,30 @@ partial class Composition
     }
   }
 
-  private IUserRepository Root2
+  private LightweightRoot LightRoot
   {
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      return new SqlUserRepository();
+      Func<IUserRepository> perBlockFunc502 = new Func<IUserRepository>(
+      [MethodImpl(MethodImplOptions.AggressiveInlining)]
+      () =>
+      {
+        return new SqlUserRepository();
+      });
+      return new LightweightRoot()
+      {
+        IUserRepository = perBlockFunc502
+      };
+    }
+  }
+
+  private IUserRepository Root1
+  {
+    [MethodImpl(MethodImplOptions.AggressiveInlining)]
+    get
+    {
+      return LightRoot.IUserRepository();
     }
   }
 
@@ -204,7 +222,7 @@ partial class Composition
     OnNewRoot<IUserService, UserService>(valResolver_0000, "Root", null, Lifetime.Transient);
     Resolver<IUserService>.Value = valResolver_0000;
     var valResolver_0001 = new Resolver_0001();
-    OnNewRoot<IUserRepository, SqlUserRepository>(valResolver_0001, "Root2", "Primary", Lifetime.Transient);
+    OnNewRoot<IUserRepository, SqlUserRepository>(valResolver_0001, "Root1", "Primary", Lifetime.Transient);
     Resolver<IUserRepository>.Value = valResolver_0001;
     _buckets = Buckets<IResolver<Composition, object>>.Create(
       4,
@@ -266,13 +284,19 @@ partial class Composition
       switch (tag)
       {
         case "Primary":
-          return composition.Root2;
+          return composition.Root1;
 
         default:
           return base.ResolveByTag(composition, tag);
       }
     }
   }
+
+  #pragma warning disable CS0649
+  private sealed class LightweightRoot: LightweightRoot
+  {
+    [OrdinalAttribute()] public Func<IUserRepository> IUserRepository;
+  }
 }
 ```
 
@@ -289,12 +313,23 @@ Class diagram:
 classDiagram
 	SqlUserRepository --|> IUserRepository : "Primary" 
 	UserService --|> IUserService
+	Composition ..> LightweightRoot : LightweightRoot LightRoot69d
 	Composition ..> UserService : IUserService Root
 	Composition ..> SqlUserRepository : IUserRepository _
 	UserService *--  SqlUserRepository : "Primary"  IUserRepository
+	LightweightRoot o-- "PerBlock" FuncᐸIUserRepositoryᐳ : "Primary"  FuncᐸIUserRepositoryᐳ
+	FuncᐸIUserRepositoryᐳ *--  SqlUserRepository : "Primary"  IUserRepository
+	namespace Pure.DI {
+		class LightweightRoot {
+				<<class>>
+			+LightweightRoot()
+			+FuncᐸIUserRepositoryᐳ IUserRepository
+		}
+	}
 	namespace Pure.DI.UsageTests.Hints.CheckForRootScenario {
 		class Composition {
 		<<partial>>
+		-LightweightRoot LightRoot69d
 		+IUserService Root
 		-IUserRepository _
 		+ T ResolveᐸTᐳ()
@@ -318,5 +353,10 @@ classDiagram
 			+IUserRepository Repository
 		}
 	}
+	namespace System {
+		class FuncᐸIUserRepositoryᐳ {
+				<<delegate>>
+		}
+	}
 ```