Simplifying samples

Author: NikolayPianikov

AI_CONTEXT_LARGE.md

@@ -164,7 +164,7 @@ This can be done if these methods are not needed, in case only certain compositi
 
 ## Resolve methods
 
-This example shows how to resolve the composition roots using the _Resolve_ methods by _Service Locator_ approach. `Resolve` methods are generated automatically for each registered root.
+This example shows how to resolve the roots of a composition using `Resolve` methods to use the composition as a _Service Locator_. The `Resolve` methods are generated automatically without additional effort.
 
 ```c#
 using Pure.DI;
@@ -209,13 +209,10 @@ class OtherService : IService;
 To run the above code, the following NuGet package must be added:
  - [Pure.DI](https://www.nuget.org/packages/Pure.DI)
 
-_Resolve_ methods are similar to calls to the roots of a composition. Composition roots are common properties. Their use is efficient and does not cause exceptions. And that is why it is recommended to use them. In contrast, _Resolve_ methods have a number of disadvantages:
-
-- They provide access to an unlimited set of dependencies.
-
-- Their use can potentially lead to runtime exceptions, for example, when the corresponding root has not been defined.
-
-- Lead to performance degradation because they search for the root of a composition based on its type.
+_Resolve_ methods are similar to calls to composition roots. Composition roots are properties (or methods). Their use is efficient and does not cause exceptions. This is why they are recommended to be used. In contrast, _Resolve_ methods have a number of disadvantages:
+- They provide access to an unlimited set of dependencies (_Service Locator_).
+- Their use can potentially lead to runtime exceptions. For example, when the corresponding root has not been defined.
+- Sometimes cannot be used directly, e.g., for MAUI/WPF/Avalonia binding.
 
 ## Simplified binding
 
@@ -1649,8 +1646,8 @@ class Service : IService
 partial class Composition
 {
     private void Setup() =>
-        DI.Setup(nameof(Composition))
 
+        DI.Setup(nameof(Composition))
             .Arg<Serilog.ILogger>("logger", "from arg")
             .Bind().To(ctx =>
             {
@@ -1742,8 +1739,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     .Bind().As(Transient).To<Dependency>()
     .Bind().To<Service>()
     .Root<IService>("Root");
@@ -1801,8 +1796,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     .Bind().As(Singleton).To<Dependency>()
     .Bind().To<Service>()
     .Root<IService>("Root");
@@ -1863,8 +1856,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     .Bind().As(PerResolve).To<Dependency>()
     .Bind().As(Singleton).To<(IDependency dep3, IDependency dep4)>()
 
@@ -1915,8 +1906,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     .Bind().As(PerBlock).To<Dependency>()
     .Bind().As(Singleton).To<(IDependency dep3, IDependency dep4)>()
 
@@ -2027,9 +2016,8 @@ partial class Program(Func<Session> sessionFactory)
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
-            // This hint indicates to not generate methods such as Resolve
-            .Hint(Hint.Resolve, "Off")
             .Bind().As(Scoped).To<Dependency>()
             .Bind().To<Service>()
 
@@ -2090,9 +2078,8 @@ partial class Program(Func<IService> serviceFactory)
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
-            // This hint indicates to not generate methods such as Resolve
-            .Hint(Hint.Resolve, "Off")
             .Bind().As(Scoped).To<Dependency>()
             // Session composition root
             .Root<Service>("SessionRoot", kind: RootKinds.Private)
@@ -2101,7 +2088,7 @@ partial class Composition
             {
                 // Creates a new scope from the parent scope
                 var scope = new Composition(parentScope);
-                // Provides a scope root
+                // Provides the session root in a new scope
                 return scope.SessionRoot;
             })
 
@@ -2127,8 +2114,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     // Default Lifetime applies
     // to all bindings until the end of the chain
     // or the next call to the DefaultLifetime method
@@ -2181,8 +2166,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     // Default lifetime applied to a specific type
     .DefaultLifetime<IDependency>(Singleton)
     .Bind().To<Dependency>()
@@ -2233,8 +2216,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     // Default lifetime applied to a specific type
     .DefaultLifetime<IDependency>(Singleton, "some tag")
     .Bind("some tag").To<Dependency>()
@@ -2340,8 +2321,6 @@ using Pure.DI;
 using static Pure.DI.Lifetime;
 
 DI.Setup(nameof(Composition))
-    // This hint indicates to not generate methods such as Resolve
-    .Hint(Hint.Resolve, "Off")
     .Bind().As(Singleton).To<Dependency>()
     .Bind().To<Service>()
     .Root<IService>("Root");
@@ -2459,9 +2438,8 @@ partial class Program(Func<Session> sessionFactory)
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
-            // This hint indicates to not generate methods such as Resolve
-            .Hint(Hint.Resolve, "Off")
             .Bind().As(Scoped).To<Dependency>()
             .Bind().To<Service>()
 
@@ -2845,7 +2823,6 @@ By default, tasks are started automatically when they are injected. But you can
 using Pure.DI;
 
 DI.Setup(nameof(Composition))
-    .Hint(Hint.Resolve, "Off")
     // Overrides the default binding that performs an auto-start of a task
     // when it is created. This binding will simply create the task.
     // The start will be handled by the consumer.
@@ -6443,6 +6420,7 @@ public partial class Composition
     // In fact, this method will not be called at runtime
     [Conditional("DI")]
     void Setup() =>
+
         DI.Setup()
             .Bind<IDependency>().To<Dependency>()
             .Bind<long>().To(_ => GenerateId())
@@ -6478,6 +6456,7 @@ class Service(IDependency dependency) : IService;
 
 partial class Composition
 {
+
     // This method will not be called in runtime
     static void Setup1() =>
         DI.Setup()
@@ -6556,6 +6535,7 @@ class Service(IDependency dependency) : IService
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
             .Bind().To<Dependency>()
             .Bind().To<Service>()
@@ -6627,6 +6607,7 @@ class Service(Func<Owned<IDependency>> dependencyFactory)
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
             .Bind().To<Dependency>()
             .Bind().To<Service>()
@@ -6727,6 +6708,7 @@ class Service(
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
             .Bind().To<Dependency>()
             .Bind("single").As(Lifetime.Singleton).To<Dependency>()
@@ -6825,6 +6807,7 @@ class Service(
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
             .Bind().To<Dependency>()
             .Bind("single").As(Lifetime.Singleton).To<Dependency>()
@@ -6895,8 +6878,8 @@ class Service(IDependency dependency) : IService
 partial class Composition
 {
     static void Setup() =>
-        DI.Setup()
 
+        DI.Setup()
             .Bind().To<Dependency>()
             .Bind().To<Service>()
 
@@ -6974,6 +6957,7 @@ class Service(Func<Owned<IDependency>> dependencyFactory)
 partial class Composition
 {
     static void Setup() =>
+
         DI.Setup()
             .Bind<IDependency>().To<Dependency>()
             .Bind().To<Service>()
@@ -7123,7 +7107,6 @@ using Pure.DI;
 using OtherAssembly;
 
 DI.Setup(nameof(Composition))
-    .Hint(Hint.Resolve, "Off")
     // Binds to exposed composition roots from other project
     .RootArg<CompositionInOtherProject>("baseComposition")
     .Root<Program>("GetProgram");
@@ -7207,7 +7190,6 @@ using static Pure.DI.Lifetime;
 using OtherAssembly;
 
 DI.Setup(nameof(Composition))
-    .Hint(Hint.Resolve, "Off")
     .RootArg<int>("id")
     // Binds to exposed composition roots from other project
     .Bind().As(Singleton).To<CompositionWithGenericRootsAndArgsInOtherProject>()
@@ -7262,8 +7244,8 @@ class Service : IService
 partial class Composition
 {
     private void Setup() =>
-        DI.Setup(nameof(Composition))
 
+        DI.Setup(nameof(Composition))
             .Hint(Hint.OnNewInstance, "On")
             .Hint(Hint.OnDependencyInjection, "On")
             // Excluding loggers
@@ -12240,21 +12222,21 @@ DI.Setup("Composition")
 </blockquote></details>
 
 
-<details><summary>Field GenericType</summary><blockquote>
+<details><summary>Field UniqueTag</summary><blockquote>
 
-Atomically generated smart tag with value "GenericType".
+Atomically generated smart tag with value "UniqueTag".
             It's used for:
 
-            class _Generator__TypeResolver_ <-- _IIdGenerator_(GenericType) -- _IdGenerator_ as _PerResolve_
+            class _Generator__ApiInvocationProcessor_ <-- (UniqueTag) -- _IdGenerator_ as _PerResolve_
 </blockquote></details>
 
 
-<details><summary>Field Overrider</summary><blockquote>
+<details><summary>Field GenericType</summary><blockquote>
 
-Atomically generated smart tag with value "Overrider".
+Atomically generated smart tag with value "GenericType".
             It's used for:
 
-            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Overrider) -- _GraphOverrider_ as _PerBlock_
+            class _Generator__TypeResolver_ <-- _IIdGenerator_(GenericType) -- _IdGenerator_ as _PerResolve_
 </blockquote></details>
 
 
@@ -12274,30 +12256,30 @@ Atomically generated smart tag with value "Override".
 </blockquote></details>
 
 
-<details><summary>Field Cleaner</summary><blockquote>
+<details><summary>Field CompositionClass</summary><blockquote>
 
-Atomically generated smart tag with value "Cleaner".
+Atomically generated smart tag with value "CompositionClass".
             It's used for:
 
-            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Cleaner) -- _GraphCleaner_ as _PerBlock_
+            class _Generator__CodeBuilder_ <-- _IBuilder`2_(CompositionClass) -- _CompositionClassBuilder_ as _PerBlock_
 </blockquote></details>
 
 
-<details><summary>Field UniqueTag</summary><blockquote>
+<details><summary>Field Overrider</summary><blockquote>
 
-Atomically generated smart tag with value "UniqueTag".
+Atomically generated smart tag with value "Overrider".
             It's used for:
 
-            class _Generator__ApiInvocationProcessor_ <-- (UniqueTag) -- _IdGenerator_ as _PerResolve_
+            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Overrider) -- _GraphOverrider_ as _PerBlock_
 </blockquote></details>
 
 
-<details><summary>Field CompositionClass</summary><blockquote>
+<details><summary>Field Cleaner</summary><blockquote>
 
-Atomically generated smart tag with value "CompositionClass".
+Atomically generated smart tag with value "Cleaner".
             It's used for:
 
-            class _Generator__CodeBuilder_ <-- _IBuilder`2_(CompositionClass) -- _CompositionClassBuilder_ as _PerBlock_
+            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Cleaner) -- _GraphCleaner_ as _PerBlock_
 </blockquote></details>