Update README.md

Author: NikolayPianikov

AI_CONTEXT_LARGE.md

@@ -1209,16 +1209,26 @@ class Service : IService
     // The Dependency attribute specifies to perform an injection,
     // the integer value in the argument specifies
     // the ordinal of injection
-    [Dependency] internal IDependency? DependencyVal;
+    [Dependency] public IDependency? DependencyVal;
 
-    public IDependency? Dependency => DependencyVal;
+    public IDependency? Dependency
+    {
+        get
+        {
+            return DependencyVal;
+        }
+    }
 }
 ```
 
 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)
 
+The key points are:
+- The field must be writable
+- The `Dependency` (or `Ordinal`) attribute is used to mark the field for injection
+- The container automatically injects the dependency when resolving the object graph
 
 ## Method injection
 
@@ -1265,6 +1275,10 @@ 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)
 
+The key points are:
+- The method must be available to be called from a composition class
+- The `Dependency` (or `Ordinal`) attribute is used to mark the method for injection
+- The container automatically calls the method to inject dependencies
 
 ## Property injection
 
@@ -1299,18 +1313,23 @@ class Service : IService
     // The Dependency attribute specifies to perform an injection,
     // the integer value in the argument specifies
     // the ordinal of injection
-    [Dependency]
-    public IDependency? Dependency { get; set; }
+    [Dependency] public IDependency? Dependency { get; set; }
 }
 ```
 
 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)
 
+The key points are:
+- The property must be writable
+- The `Dependency` (or `Ordinal`) attribute is used to mark the property for injection
+- The container automatically injects the dependency when resolving the object graph
 
 ## Default values
 
+This example demonstrates how to use default values in dependency injection when explicit injection is not possible.
+
 ```c#
 using Shouldly;
 using Pure.DI;
@@ -1352,10 +1371,19 @@ 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)
 
+The key points are:
+- Default constructor arguments can be used for simple values
+- The DI container will use these defaults if no explicit bindings are provided
+
+This example illustrates how to handle default values in a dependency injection scenario:
+- **Constructor Default Argument**: The `Service` class has a constructor with a default value for the name parameter. If no value is provided, “My Service” will be used.
+- **Required Property with Default**: The Dependency property is marked as required but has a default instantiation. This ensures that:
+  - The property must be set
+  - If no explicit injection occurs, a default value will be used
 
 ## Required properties or fields
 
-All properties or fields marked with the _required_ keyword automatically become injected dependencies.
+This example demonstrates how the `required` modifier can be used to automatically inject dependencies into properties and fields. When a property or field is marked with `required`, the DI will automatically inject the dependency without additional effort.
 
 ```c#
 using Shouldly;
@@ -1401,6 +1429,7 @@ 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)
 
+This approach simplifies dependency injection by eliminating the need to manually configure bindings for required dependencies, making the code more concise and easier to maintain.
 
 ## Overrides
 
@@ -7450,7 +7479,7 @@ internal partial class Composition
 
         // Models
         .Bind().To<Log<TT>>()
-        .Bind().As(Singleton).To<Clock.Models.Timer>()
+        .Bind().As(Singleton).To<Timer>()
         .Bind().As(PerBlock).To<SystemClock>()
 
         // Infrastructure
@@ -7516,15 +7545,15 @@ public class App : Application
                     desktop.MainWindow = composition.MainWindow;
                     break;
 
-                case ISingleViewApplicationLifetime singleViewPlatform:
-                    singleViewPlatform.MainView = composition.MainWindow;
+                case ISingleViewApplicationLifetime singleView:
+                    singleView.MainView = composition.MainWindow;
                     break;
             }
 
             // Handles disposables
-            if (ApplicationLifetime is IControlledApplicationLifetime controlledApplicationLifetime)
+            if (ApplicationLifetime is IControlledApplicationLifetime controlledLifetime)
             {
-                controlledApplicationLifetime.Exit += (_, _) => composition.Dispose();
+                controlledLifetime.Exit += (_, _) => composition.Dispose();
             }
         }
 
@@ -8660,7 +8689,7 @@ internal partial class Composition
 
         // Models
         .Bind().To<Log<TT>>()
-        .Bind().To<Clock.Models.Timer>()
+        .Bind().To<Timer>()
         .Bind().As(PerBlock).To<SystemClock>()
 
         // Infrastructure
@@ -8742,7 +8771,7 @@ internal partial class Composition
 
         // Models
         .Bind().To<Log<TT>>()
-        .Bind().To<Clock.Models.Timer>()
+        .Bind().To<Timer>()
         .Bind().As(PerBlock).To<SystemClock>()
 
         // Infrastructure
@@ -8815,7 +8844,7 @@ internal partial class Composition
 
         // Models
         .Bind().To<Log<TT>>()
-        .Bind().As(Singleton).To<Clock.Models.Timer>()
+        .Bind().As(Singleton).To<Timer>()
         .Bind().As(PerBlock).To<SystemClock>()
 
         // Infrastructure
@@ -12172,21 +12201,21 @@ DI.Setup("Composition")
 </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 Overrider</summary><blockquote>
+<details><summary>Field Cleaner</summary><blockquote>
 
-Atomically generated smart tag with value "Overrider".
+Atomically generated smart tag with value "Cleaner".
             It's used for:
 
-            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Overrider) -- _GraphOverrider_ as _PerBlock_
+            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Cleaner) -- _GraphCleaner_ as _PerBlock_
 </blockquote></details>
 
 
@@ -12199,46 +12228,46 @@ Atomically generated smart tag with value "GenericType".
 </blockquote></details>
 
 
-<details><summary>Field Injection</summary><blockquote>
+<details><summary>Field Override</summary><blockquote>
 
-Atomically generated smart tag with value "Injection".
+Atomically generated smart tag with value "Override".
+            It's used for:
 
+            class _Generator__OverrideIdProvider_ <-- _IIdGenerator_(Override) -- _IdGenerator_ as _PerResolve_
 </blockquote></details>
 
 
-<details><summary>Field CompositionClass</summary><blockquote>
+<details><summary>Field UsingDeclarations</summary><blockquote>
 
-Atomically generated smart tag with value "CompositionClass".
+Atomically generated smart tag with value "UsingDeclarations".
             It's used for:
 
-            class _Generator__CodeBuilder_ <-- _IBuilder`2_(CompositionClass) -- _CompositionClassBuilder_ as _PerBlock_
+            class _Generator__CompositionClassBuilder_ <-- _IBuilder`2_(UsingDeclarations) -- _UsingDeclarationsBuilder_ as _PerBlock_
 </blockquote></details>
 
 
-<details><summary>Field UsingDeclarations</summary><blockquote>
+<details><summary>Field Injection</summary><blockquote>
 
-Atomically generated smart tag with value "UsingDeclarations".
-            It's used for:
+Atomically generated smart tag with value "Injection".
 
-            class _Generator__CompositionClassBuilder_ <-- _IBuilder`2_(UsingDeclarations) -- _UsingDeclarationsBuilder_ as _PerBlock_
 </blockquote></details>
 
 
-<details><summary>Field Override</summary><blockquote>
+<details><summary>Field CompositionClass</summary><blockquote>
 
-Atomically generated smart tag with value "Override".
+Atomically generated smart tag with value "CompositionClass".
             It's used for:
 
-            class _Generator__OverrideIdProvider_ <-- _IIdGenerator_(Override) -- _IdGenerator_ as _PerResolve_
+            class _Generator__CodeBuilder_ <-- _IBuilder`2_(CompositionClass) -- _CompositionClassBuilder_ as _PerBlock_
 </blockquote></details>
 
 
-<details><summary>Field Cleaner</summary><blockquote>
+<details><summary>Field UniqueTag</summary><blockquote>
 
-Atomically generated smart tag with value "Cleaner".
+Atomically generated smart tag with value "UniqueTag".
             It's used for:
 
-            class _Generator__DependencyGraphBuilder_ <-- _IGraphRewriter_(Cleaner) -- _GraphCleaner_ as _PerBlock_
+            class _Generator__ApiInvocationProcessor_ <-- (UniqueTag) -- _IdGenerator_ as _PerResolve_
 </blockquote></details>
 
 

AI_CONTEXT_MEDIUM.md

@@ -1209,16 +1209,26 @@ class Service : IService
     // The Dependency attribute specifies to perform an injection,
     // the integer value in the argument specifies
     // the ordinal of injection
-    [Dependency] internal IDependency? DependencyVal;
+    [Dependency] public IDependency? DependencyVal;
 
-    public IDependency? Dependency => DependencyVal;
+    public IDependency? Dependency
+    {
+        get
+        {
+            return DependencyVal;
+        }
+    }
 }
 ```
 
 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)
 
+The key points are:
+- The field must be writable
+- The `Dependency` (or `Ordinal`) attribute is used to mark the field for injection
+- The container automatically injects the dependency when resolving the object graph
 
 ## Method injection
 
@@ -1265,6 +1275,10 @@ 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)
 
+The key points are:
+- The method must be available to be called from a composition class
+- The `Dependency` (or `Ordinal`) attribute is used to mark the method for injection
+- The container automatically calls the method to inject dependencies
 
 ## Property injection
 
@@ -1299,15 +1313,18 @@ class Service : IService
     // The Dependency attribute specifies to perform an injection,
     // the integer value in the argument specifies
     // the ordinal of injection
-    [Dependency]
-    public IDependency? Dependency { get; set; }
+    [Dependency] public IDependency? Dependency { get; set; }
 }
 ```
 
 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)
 
+The key points are:
+- The property must be writable
+- The `Dependency` (or `Ordinal`) attribute is used to mark the property for injection
+- The container automatically injects the dependency when resolving the object graph
 
 ## Transient
 
@@ -3780,58 +3797,6 @@ To run the above code, the following NuGet packages must be added:
  - [Shouldly](https://www.nuget.org/packages/Shouldly)
 
 
-## Custom universal attribute
-
-You can use a combined attribute, and each method in the list above has an optional parameter that defines the argument number (the default is 0) from where to get the appropriate metadata for _tag_, _ordinal_, or _type_.
-
-```c#
-using Shouldly;
-using Pure.DI;
-
-DI.Setup(nameof(PersonComposition))
-    .TagAttribute<InjectAttribute<TT>>()
-    .OrdinalAttribute<InjectAttribute<TT>>(1)
-    .TypeAttribute<InjectAttribute<TT>>()
-    .Arg<int>("personId")
-    .Bind().To(_ => new Uri("https://github.com/DevTeam/Pure.DI"))
-    .Bind("NikName").To(_ => "Nik")
-    .Bind().To<Person>()
-
-    // Composition root
-    .Root<IPerson>("Person");
-
-var composition = new PersonComposition(personId: 123);
-var person = composition.Person;
-person.ToString().ShouldBe("123 Nik https://github.com/DevTeam/Pure.DI");
-
-[AttributeUsage(
-    AttributeTargets.Constructor
-    | AttributeTargets.Method
-    | AttributeTargets.Parameter
-    | AttributeTargets.Property
-    | AttributeTargets.Field)]
-class InjectAttribute<T>(object? tag = null, int ordinal = 0) : Attribute;
-
-interface IPerson;
-
-class Person([Inject<string>("NikName")] string name) : IPerson
-{
-    private object? _state;
-
-    [Inject<int>(ordinal: 1)] internal object Id = "";
-
-    public void Initialize([Inject<Uri>] object state) =>
-        _state = state;
-
-    public override string ToString() => $"{Id} {name} {_state}";
-}
-```
-
-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)
-
-
 ## Decorator
 
 Interception is the ability to intercept calls between objects in order to enrich or change their behavior, but without having to change their code. A prerequisite for interception is weak binding. That is, if programming is abstraction-based, the underlying implementation can be transformed or improved by "packaging" it into other implementations of the same abstraction. At its core, intercept is an application of the Decorator design pattern. This pattern provides a flexible alternative to inheritance by dynamically "attaching" additional responsibility to an object. Decorator "packs" one implementation of an abstraction into another implementation of the same abstraction like a "matryoshka doll".