Update README

Author: NikolayPianikov

AGENTS.md

@@ -2471,14 +2471,12 @@ To run the above code, the following NuGet packages must be added:
 
 ## Scope
 
-Demonstrates scoped lifetime with `Hint(Hint.ScopeFactory, "on")` where scopes are represented by generated `Scope` objects created via `CreateScope()`.
-
 ```c#
 using Shouldly;
 using Pure.DI;
 using static Pure.DI.Lifetime;
 
-var composition = new Composition(desc: "Checkout");
+var composition = new Composition();
 IRequestContext ctx1;
 IRequestContext ctx2;
 
@@ -2545,9 +2543,7 @@ interface ICheckoutService
 
 // "Controller/service" that participates in request processing.
 // It depends on a scoped context (per-request resource).
-sealed class CheckoutService(
-    string description,
-    IRequestContext context)
+sealed class CheckoutService(IRequestContext context)
     : ICheckoutService
 {
     public IRequestContext Context => context;
@@ -2556,7 +2552,7 @@ sealed class CheckoutService(
 // Represents a scope
 class Scope(Composition composition): IDisposable
 {
-    private readonly Composition _scope = composition.CreateScope();
+    private readonly Composition _scope = Composition.SetupScope(composition, new Composition());
 
     public ICheckoutService Checkout => _scope.RequestRoot;
 
@@ -2568,8 +2564,7 @@ partial class Composition
     static void Setup() =>
 
         DI.Setup()
-            .Hint(Hint.ScopeFactoryName, "CreateScope")
-            .Arg<string>("desc")
+            .Hint(Hint.ScopeMethodName, "SetupScope")
             // Per-request lifetime
             .Bind().As(Scoped).To<RequestContext>()
 
@@ -2588,12 +2583,8 @@ To run the above code, the following NuGet packages must be added:
  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
  - [Shouldly](https://www.nuget.org/packages/Shouldly)
 
->[!NOTE]
->This approach is useful when you need runtime scope creation without deriving a child composition type.
-
-## Scope factory
 
-Demonstrates scoped lifetime with `Hint(Hint.ScopeFactory, "on")` where scopes are represented by generated `Scope` objects created via `CreateScope()`.
+## Scope setup method
 
 ```c#
 using Shouldly;
@@ -2605,7 +2596,7 @@ IRequestContext ctx1;
 IRequestContext ctx2;
 
 // Request #1
-using (var request1 = composition.CreateScope())
+using (var request1 = Composition.SetupScope(composition, new Composition()))
 {
     var checkout11 = request1.RequestRoot;
     var checkout12 = request1.RequestRoot;
@@ -2620,7 +2611,7 @@ using (var request1 = composition.CreateScope())
 ctx1.IsDisposed.ShouldBeTrue();
 
 // Request #2
-using (var request2 = composition.CreateScope())
+using (var request2 = Composition.SetupScope(composition, new Composition()))
 {
     var checkout2 = request2.RequestRoot;
     ctx2 = checkout2.Context;
@@ -2678,7 +2669,7 @@ partial class Composition
     static void Setup() =>
 
         DI.Setup()
-            .Hint(Hint.ScopeFactoryName, "CreateScope")
+            .Hint(Hint.ScopeMethodName, "SetupScope")
             // Per-request lifetime
             .Bind().As(Scoped).To<RequestContext>()
 
@@ -2696,8 +2687,6 @@ To run the above code, the following NuGet packages must be added:
  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
  - [Shouldly](https://www.nuget.org/packages/Shouldly)
 
->[!NOTE]
->This approach is useful when you need runtime scope creation without deriving a child composition type.
 
 ## Scoped
 

AGENTS_SMALL.md

@@ -1185,14 +1185,12 @@ To run the above code, the following NuGet packages must be added:
 
 ## Scope
 
-Demonstrates scoped lifetime with `Hint(Hint.ScopeFactory, "on")` where scopes are represented by generated `Scope` objects created via `CreateScope()`.
-
 ```c#
 using Shouldly;
 using Pure.DI;
 using static Pure.DI.Lifetime;
 
-var composition = new Composition(desc: "Checkout");
+var composition = new Composition();
 IRequestContext ctx1;
 IRequestContext ctx2;
 
@@ -1259,9 +1257,7 @@ interface ICheckoutService
 
 // "Controller/service" that participates in request processing.
 // It depends on a scoped context (per-request resource).
-sealed class CheckoutService(
-    string description,
-    IRequestContext context)
+sealed class CheckoutService(IRequestContext context)
     : ICheckoutService
 {
     public IRequestContext Context => context;
@@ -1270,7 +1266,7 @@ sealed class CheckoutService(
 // Represents a scope
 class Scope(Composition composition): IDisposable
 {
-    private readonly Composition _scope = composition.CreateScope();
+    private readonly Composition _scope = Composition.SetupScope(composition, new Composition());
 
     public ICheckoutService Checkout => _scope.RequestRoot;
 
@@ -1282,8 +1278,7 @@ partial class Composition
     static void Setup() =>
 
         DI.Setup()
-            .Hint(Hint.ScopeFactoryName, "CreateScope")
-            .Arg<string>("desc")
+            .Hint(Hint.ScopeMethodName, "SetupScope")
             // Per-request lifetime
             .Bind().As(Scoped).To<RequestContext>()
 
@@ -1302,12 +1297,8 @@ To run the above code, the following NuGet packages must be added:
  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
  - [Shouldly](https://www.nuget.org/packages/Shouldly)
 
->[!NOTE]
->This approach is useful when you need runtime scope creation without deriving a child composition type.
-
-## Scope factory
 
-Demonstrates scoped lifetime with `Hint(Hint.ScopeFactory, "on")` where scopes are represented by generated `Scope` objects created via `CreateScope()`.
+## Scope setup method
 
 ```c#
 using Shouldly;
@@ -1319,7 +1310,7 @@ IRequestContext ctx1;
 IRequestContext ctx2;
 
 // Request #1
-using (var request1 = composition.CreateScope())
+using (var request1 = Composition.SetupScope(composition, new Composition()))
 {
     var checkout11 = request1.RequestRoot;
     var checkout12 = request1.RequestRoot;
@@ -1334,7 +1325,7 @@ using (var request1 = composition.CreateScope())
 ctx1.IsDisposed.ShouldBeTrue();
 
 // Request #2
-using (var request2 = composition.CreateScope())
+using (var request2 = Composition.SetupScope(composition, new Composition()))
 {
     var checkout2 = request2.RequestRoot;
     ctx2 = checkout2.Context;
@@ -1392,7 +1383,7 @@ partial class Composition
     static void Setup() =>
 
         DI.Setup()
-            .Hint(Hint.ScopeFactoryName, "CreateScope")
+            .Hint(Hint.ScopeMethodName, "SetupScope")
             // Per-request lifetime
             .Bind().As(Scoped).To<RequestContext>()
 
@@ -1410,8 +1401,6 @@ To run the above code, the following NuGet packages must be added:
  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
  - [Shouldly](https://www.nuget.org/packages/Shouldly)
 
->[!NOTE]
->This approach is useful when you need runtime scope creation without deriving a child composition type.
 
 ## Scoped
 

README.md

@@ -322,7 +322,7 @@ dotnet run
 - [PerResolve](readme/perresolve.md)
 - [PerBlock](readme/perblock.md)
 - [Scope](readme/scope.md)
-- [Scope factory](readme/scope-factory.md)
+- [Scope setup method](readme/scope-setup-method.md)
 - [Scoped](readme/scoped.md)
 - [Auto scoped](readme/auto-scoped.md)
 - [Default lifetime](readme/default-lifetime.md)
@@ -1175,7 +1175,7 @@ DI.Setup("Composition")
 | [DisableAutoBindingLifetimeRegularExpression](#disableautobindinglifetimeregularexpression-hint)                                     | Regular expression                         |            | .+        |
 | [DisableAutoBindingLifetimeWildcard](#disableautobindinglifetimewildcard-hint)                                                       | Wildcard                                   |            | *         |
 | [LightweightAnonymousRoot](#lightweightanonymousroot-hint)                                                                           | _On_ or _Off_                              |            | _On_      |
-| [ScopeFactoryName](#scopefactoryname-hint)                                                                                           | Method name                                |            |           |
+| [ScopeMethodName](#ScopeMethodName-hint)                                                                                           | Method name                                |            |           |
 
 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.
 
@@ -1843,14 +1843,14 @@ DI.Setup("Composition")
     .Bind<IService>().To<Service>();
 ```
 
-### ScopeFactoryName Hint
+### ScopeMethodName Hint
 
 Sets the scope factory name to be used for creating scopes.
 
 ```c#
-// ScopeFactoryName = CreateScope
+// ScopeMethodName = CreateScope
 DI.Setup("Composition")
-    .Hint(Hint.ScopeFactoryName, "CreateScope")
+    .Hint(Hint.ScopeMethodName, "CreateScope")
     .Bind<IDependency>().As(Lifetime.Scoped).To<Dependency>();
 ```
 
@@ -2036,7 +2036,7 @@ AI needs to understand the situation it’s in (context). This means knowing det
 
 | AI context file | Size | Tokens |
 | --------------- | ---- | ------ |
-| [AGENTS_SMALL.md](AGENTS_SMALL.md) | 63KB | 16K |
+| [AGENTS_SMALL.md](AGENTS_SMALL.md) | 62KB | 16K |
 | [AGENTS_MEDIUM.md](AGENTS_MEDIUM.md) | 106KB | 27K |
 | [AGENTS.md](AGENTS.md) | 387KB | 99K |
 
@@ -2129,9 +2129,9 @@ Thanks!
 
 ## Benchmarks
 
-BenchmarkDotNet v0.14.0, Windows 10 (10.0.19045.4894/22H2/2022Update)
-AMD Ryzen 9 5900X, 1 CPU, 24 logical and 12 physical cores
-.NET SDK 9.0.100
+BenchmarkDotNet v0.15.8, Windows 10 (10.0.19045.6456/22H2/2022Update)
+AMD Ryzen 9 5900X 4.20GHz, 1 CPU, 24 logical and 12 physical cores
+.NET SDK 10.0.102
 
 <details>
 <summary>Transient</summary>

readme/bind-attribute-with-lifetime-and-tag.md

@@ -89,28 +89,28 @@ partial class Composition
   private readonly Object _lock = new Object();
 #endif
 
-  private IGpu? _singletonIGpu2147483136;
+  private IGpu? _singletonIGpu2147483137;
   private GraphicsAdapter? _singletonGraphicsAdapter62;
 
   public IRenderer Renderer
   {
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      if (_singletonIGpu2147483136 is null)
+      if (_singletonIGpu2147483137 is null)
         lock (_lock)
-          if (_singletonIGpu2147483136 is null)
+          if (_singletonIGpu2147483137 is null)
           {
             if (_singletonGraphicsAdapter62 is null)
             {
               _singletonGraphicsAdapter62 = new GraphicsAdapter();
             }
 
             GraphicsAdapter localInstance_1182D1279 = _singletonGraphicsAdapter62;
-            _singletonIGpu2147483136 = localInstance_1182D1279.HighPerfGpu;
+            _singletonIGpu2147483137 = localInstance_1182D1279.HighPerfGpu;
           }
 
-      return new RayTracer(_singletonIGpu2147483136);
+      return new RayTracer(_singletonIGpu2147483137);
     }
   }
 }

readme/check-for-a-root.md

@@ -313,7 +313,7 @@ Class diagram:
 classDiagram
 	SqlUserRepository --|> IUserRepository : "Primary" 
 	UserService --|> IUserService
-	Composition ..> LightweightRoot : LightweightRoot LightRoot102d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot104d
 	Composition ..> UserService : IUserService Root
 	Composition ..> SqlUserRepository : IUserRepository _
 	UserService *--  SqlUserRepository : "Primary"  IUserRepository
@@ -329,7 +329,7 @@ classDiagram
 	namespace Pure.DI.UsageTests.Hints.CheckForRootScenario {
 		class Composition {
 		<<partial>>
-		-LightweightRoot LightRoot102d
+		-LightweightRoot LightRoot104d
 		+IUserService Root
 		-IUserRepository _
 		+ T ResolveᐸTᐳ()

readme/composition-roots.md

@@ -333,7 +333,7 @@ classDiagram
 	PdfInvoiceGenerator --|> IInvoiceGenerator
 	HtmlInvoiceGenerator --|> IInvoiceGenerator : "Online" 
 	FileLogger --|> ILogger
-	Composition ..> LightweightRoot : LightweightRoot LightRoot102d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot104d
 	Composition ..> HtmlInvoiceGenerator : IInvoiceGenerator OnlineInvoiceGenerator
 	Composition ..> FileLogger : ILogger _
 	Composition ..> PdfInvoiceGenerator : IInvoiceGenerator InvoiceGenerator
@@ -351,7 +351,7 @@ classDiagram
 		class Composition {
 		<<partial>>
 		+IInvoiceGenerator InvoiceGenerator
-		-LightweightRoot LightRoot102d
+		-LightweightRoot LightRoot104d
 		+IInvoiceGenerator OnlineInvoiceGenerator
 		-ILogger _
 		+ T ResolveᐸTᐳ()

readme/keyed-service-provider.md

@@ -335,7 +335,7 @@ Class diagram:
 classDiagram
 	PayPalGateway --|> IPaymentGateway : "PayPal" 
 	OnlineOrderService --|> IOrderService : "Online" 
-	Composition ..> LightweightRoot : LightweightRoot LightRoot102d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot104d
 	Composition ..> OnlineOrderService : IOrderService _
 	Composition ..> PayPalGateway : IPaymentGateway _
 	OnlineOrderService o-- "Singleton" PayPalGateway : "PayPal"  IPaymentGateway
@@ -354,7 +354,7 @@ classDiagram
 	namespace Pure.DI.UsageTests.BCL.KeyedServiceProviderScenario {
 		class Composition {
 		<<partial>>
-		-LightweightRoot LightRoot102d
+		-LightweightRoot LightRoot104d
 		-IPaymentGateway _
 		-IOrderService _
 		+ T ResolveᐸTᐳ()

readme/light-roots.md

@@ -437,7 +437,7 @@ classDiagram
 	PrometheusMetrics --|> IMetrics
 	AppConfiguration --|> IConfiguration
 	ApplicationService --|> IApplicationService
-	Composition ..> LightweightRoot : LightweightRoot LightRoot102d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot104d
 	Composition ..> PrometheusMetrics : IMetrics _
 	Composition ..> MemoryCache : ICache _
 	Composition ..> ConsoleLogger : ILogger _
@@ -478,7 +478,7 @@ classDiagram
 		<<partial>>
 		+IApplicationService ApplicationService
 		+IConfiguration Config
-		-LightweightRoot LightRoot102d
+		-LightweightRoot LightRoot104d
 		-ILogger _
 		-ICache _
 		-IMetrics _

readme/request-overrides.md

@@ -149,21 +149,21 @@ partial class Composition
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      Func<Request, Handler> transientFunc658 = request =>
+      Func<Request, Handler> transientFunc657 = request =>
       {
         // Outer override applies to the request handler and its main workflow.
         IRequestContext overriddenIRequestContext6 = new RequestContext(request.TenantId, request.UserId, false);
-        Func<IRepository> transientFunc662 =
+        Func<IRepository> transientFunc661 =
         [MethodImpl(MethodImplOptions.AggressiveInlining)]
         () =>
         {
           // Inner override applies to repository dependencies only.
           IRequestContext overriddenIRequestContext6 = RequestContext.System;
           return new Repository(overriddenIRequestContext6);
         };
-        return new Handler(new Service(overriddenIRequestContext6, transientFunc662, new AuditWriter(overriddenIRequestContext6)));
+        return new Handler(new Service(overriddenIRequestContext6, transientFunc661, new AuditWriter(overriddenIRequestContext6)));
       };
-      return transientFunc658;
+      return transientFunc657;
     }
   }
 

readme/resolve-methods.md

@@ -267,7 +267,7 @@ classDiagram
 	Device --|> IDevice
 	TemperatureSensor --|> ISensor
 	HumiditySensor --|> ISensor : "Humidity" 
-	Composition ..> LightweightRoot : LightweightRoot LightRoot102d
+	Composition ..> LightweightRoot : LightweightRoot LightRoot104d
 	Composition ..> HumiditySensor : ISensor HumiditySensor
 	Composition ..> TemperatureSensor : ISensor _
 	TemperatureSensor *--  Device : IDevice
@@ -284,7 +284,7 @@ classDiagram
 		class Composition {
 		<<partial>>
 		+ISensor HumiditySensor
-		-LightweightRoot LightRoot102d
+		-LightweightRoot LightRoot104d
 		-ISensor _
 		+ T ResolveᐸTᐳ()
 		+ T ResolveᐸTᐳ(object? tag)