Update README

Author: Nikolay Pianikov

AGENTS.md

@@ -4741,6 +4741,82 @@ To run the above code, the following NuGet packages must be added:
 >[!NOTE]
 >Overriding BCL bindings allows you to provide custom implementations for standard types, enabling specialized behavior for your application.
 
+## Default BCL bindings
+
+Pure.DI provides default bindings for commonly used .NET BCL types, so they can be injected without extra setup code.
+
+```c#
+using Shouldly;
+using Pure.DI;
+using System.Globalization;
+using System.Security.Cryptography;
+using System.Text.Json;
+
+DI.Setup(nameof(Composition))
+    .Root<ReportService>("ReportService");
+
+var composition = new Composition();
+var reportService = composition.ReportService;
+
+reportService.JsonOptions.ShouldBe(JsonSerializerOptions.Default);
+reportService.Culture.ShouldBe(CultureInfo.CurrentCulture);
+reportService.FormatProvider.ShouldBe(reportService.Culture);
+reportService.CompareInfo.ShouldBe(CultureInfo.CurrentCulture.CompareInfo);
+reportService.StringComparer.ShouldBe(StringComparer.Ordinal);
+reportService.StringComparison.ShouldBe(StringComparison.Ordinal);
+reportService.TimeProvider.ShouldBe(TimeProvider.System);
+reportService.Completion.Task.CreationOptions
+    .HasFlag(TaskCreationOptions.RunContinuationsAsynchronously)
+    .ShouldBeTrue();
+
+var bytes = new byte[4];
+reportService.RandomNumberGenerator.GetBytes(bytes);
+bytes.Length.ShouldBe(4);
+
+interface IPlugin;
+
+class SearchPlugin : IPlugin;
+
+class ExportPlugin : IPlugin;
+
+class ReportService(
+    JsonSerializerOptions jsonOptions,
+    CultureInfo culture,
+    IFormatProvider formatProvider,
+    CompareInfo compareInfo,
+    StringComparer stringComparer,
+    StringComparison stringComparison,
+    TimeProvider timeProvider,
+    TaskCompletionSource<string> completion,
+    RandomNumberGenerator randomNumberGenerator)
+{
+    public JsonSerializerOptions JsonOptions { get; } = jsonOptions;
+
+    public CultureInfo Culture { get; } = culture;
+
+    public IFormatProvider FormatProvider { get; } = formatProvider;
+
+    public CompareInfo CompareInfo { get; } = compareInfo;
+
+    public StringComparer StringComparer { get; } = stringComparer;
+
+    public StringComparison StringComparison { get; } = stringComparison;
+
+    public TimeProvider TimeProvider { get; } = timeProvider;
+
+    public TaskCompletionSource<string> Completion { get; } = completion;
+
+    public RandomNumberGenerator RandomNumberGenerator { get; } = randomNumberGenerator;
+}
+```
+
+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]
+>Default BCL bindings can still be overridden in the composition when an application needs a different policy.
+
 ## Generics
 
 Generic types are also supported.

README.md

@@ -353,6 +353,7 @@ dotnet run
 - [Service provider](readme/service-provider.md)
 - [Service provider with scope](readme/service-provider-with-scope.md)
 - [Overriding the BCL binding](readme/overriding-the-bcl-binding.md)
+- [Default BCL bindings](readme/default-bcl-bindings.md)
 ### Generics
 - [Generics](readme/generics.md)
 - [Generic composition roots](readme/generic-composition-roots.md)
@@ -2407,7 +2408,7 @@ AI needs to understand the situation it’s in (context). This means knowing det
 | --------------- | ---- | ------ |
 | [AGENTS_SMALL.md](AGENTS_SMALL.md) | 62KB | 16K |
 | [AGENTS_MEDIUM.md](AGENTS_MEDIUM.md) | 112KB | 28K |
-| [AGENTS.md](AGENTS.md) | 411KB | 105K |
+| [AGENTS.md](AGENTS.md) | 413KB | 105K |
 
 For different IDEs, you can use the _AGENTS.md_ file as is by simply copying it to the root directory. For use with _JetBrains Rider_ and _Junie_, please refer to [these instructions](https://www.jetbrains.com/help/junie/customize-guidelines.html). For example, you can copy any _AGENTS.md_ file into your project (using _Pure.DI_) as _.junie/guidelines.md._
 ## How to contribute to Pure.DI

readme/FuncDetails.md

@@ -88,6 +88,7 @@ partial class Func
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     () =>
     {
+      // Creates a deferred value
       return new Service3(new Service4(), new Service4());
     });
     return new CompositionRoot(new Service1(new Service2Func(perBlockFuncIService3)), new Service2Func(perBlockFuncIService3), new Service2Func(perBlockFuncIService3), new Service2Func(perBlockFuncIService3), new Service3(new Service4(), new Service4()), new Service4(), new Service4());

readme/SingletonDetails.md

@@ -77,8 +77,8 @@ partial class Singleton
 {
   private Singleton _root;
 
-  private Service1? _scopedService160;
-  private Service4? _scopedService463;
+  private Service1? _scopedService170;
+  private Service4? _scopedService473;
 
   [OrdinalAttribute(256)]
   public Singleton()
@@ -95,22 +95,22 @@ partial class Singleton
   [MethodImpl(MethodImplOptions.AggressiveInlining)]
   public partial CompositionRoot TestPureDIByCR()
   {
-    if (_scopedService160 is null)
+    if (_scopedService170 is null)
     {
-      if (_scopedService463 is null)
+      if (_scopedService473 is null)
       {
-        _scopedService463 = new Service4();
+        _scopedService473 = new Service4();
       }
 
-      _scopedService160 = new Service1(new Service2(new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463)));
+      _scopedService170 = new Service1(new Service2(new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473)));
     }
 
-    if (_scopedService463 is null)
+    if (_scopedService473 is null)
     {
-      _scopedService463 = new Service4();
+      _scopedService473 = new Service4();
     }
 
-    return new CompositionRoot(_scopedService160, new Service2(new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463)), new Service2(new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463)), new Service2(new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463), new Service3(_scopedService463, _scopedService463)), new Service3(_scopedService463, _scopedService463), _scopedService463, _scopedService463);
+    return new CompositionRoot(_scopedService170, new Service2(new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473)), new Service2(new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473)), new Service2(new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473), new Service3(_scopedService473, _scopedService473)), new Service3(_scopedService473, _scopedService473), _scopedService473, _scopedService473);
   }
 
   [MethodImpl(MethodImplOptions.AggressiveInlining)]

readme/accumulators.md

@@ -101,7 +101,7 @@ partial class Composition
   private readonly Object _lock = new Object();
 #endif
 
-  private NetworkDataSource? _singletonNetworkDataSource64;
+  private NetworkDataSource? _singletonNetworkDataSource74;
 
   public (IDashboard dashboard, TelemetryRegistry registry) Root
   {
@@ -110,15 +110,15 @@ partial class Composition
     {
       var perBlockTelemetryRegistry = new TelemetryRegistry();
       var perBlockSqlDataSource = new SqlDataSource();
-      if (_singletonNetworkDataSource64 is null)
+      if (_singletonNetworkDataSource74 is null)
         lock (_lock)
-          if (_singletonNetworkDataSource64 is null)
+          if (_singletonNetworkDataSource74 is null)
           {
-            NetworkDataSource _singletonNetworkDataSource64Temp;
-            _singletonNetworkDataSource64Temp = new NetworkDataSource();
-            perBlockTelemetryRegistry.Add(_singletonNetworkDataSource64Temp);
+            NetworkDataSource _singletonNetworkDataSource74Temp;
+            _singletonNetworkDataSource74Temp = new NetworkDataSource();
+            perBlockTelemetryRegistry.Add(_singletonNetworkDataSource74Temp);
             Thread.MemoryBarrier();
-            _singletonNetworkDataSource64 = _singletonNetworkDataSource64Temp;
+            _singletonNetworkDataSource74 = _singletonNetworkDataSource74Temp;
           }
 
       var transientSqlDataSource = new SqlDataSource();
@@ -127,7 +127,7 @@ partial class Composition
         perBlockTelemetryRegistry.Add(transientSqlDataSource);
       }
 
-      var transientDashboard = new Dashboard(transientSqlDataSource, _singletonNetworkDataSource64, perBlockSqlDataSource);
+      var transientDashboard = new Dashboard(transientSqlDataSource, _singletonNetworkDataSource74, perBlockSqlDataSource);
       lock (_lock)
       {
         perBlockTelemetryRegistry.Add(transientDashboard);

readme/async-disposable-scope.md

@@ -130,7 +130,7 @@ partial class Composition: IDisposable, IAsyncDisposable
   private object[] _disposables;
   private int _disposeIndex;
 
-  private Dependency? _scopedDependency62;
+  private Dependency? _scopedDependency72;
 
   [OrdinalAttribute(256)]
   public Composition()
@@ -157,15 +157,15 @@ partial class Composition: IDisposable, IAsyncDisposable
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      if (_scopedDependency62 is null)
+      if (_scopedDependency72 is null)
         lock (_lock)
-          if (_scopedDependency62 is null)
+          if (_scopedDependency72 is null)
           {
-            _scopedDependency62 = new Dependency();
-            _disposables[_disposeIndex++] = _scopedDependency62;
+            _scopedDependency72 = new Dependency();
+            _disposables[_disposeIndex++] = _scopedDependency72;
           }
 
-      return new Service(_scopedDependency62);
+      return new Service(_scopedDependency72);
     }
   }
 
@@ -178,6 +178,7 @@ partial class Composition: IDisposable, IAsyncDisposable
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       () =>
       {
+        // Creates a deferred value
         return new Session(this);
       });
       return new Program(perBlockFuncSession);
@@ -194,7 +195,7 @@ partial class Composition: IDisposable, IAsyncDisposable
       _disposeIndex = 0;
       disposables = _disposables;
       _disposables = new object[1];
-      _scopedDependency62 = null;
+      _scopedDependency72 = null;
     }
 
     while (disposeIndex-- > 0)
@@ -230,7 +231,7 @@ partial class Composition: IDisposable, IAsyncDisposable
       _disposeIndex = 0;
       disposables = _disposables;
       _disposables = new object[1];
-      _scopedDependency62 = null;
+      _scopedDependency72 = null;
     }
 
     while (disposeIndex-- > 0)

readme/async-disposable-singleton.md

@@ -118,22 +118,22 @@ partial class Composition: IDisposable, IAsyncDisposable
   private object[] _disposables = new object[1];
   private int _disposeIndex;
 
-  private AuditLogWriter? _singletonAuditLogWriter62;
+  private AuditLogWriter? _singletonAuditLogWriter72;
 
   public ICheckoutService CheckoutService
   {
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      if (_singletonAuditLogWriter62 is null)
+      if (_singletonAuditLogWriter72 is null)
         lock (_lock)
-          if (_singletonAuditLogWriter62 is null)
+          if (_singletonAuditLogWriter72 is null)
           {
-            _singletonAuditLogWriter62 = new AuditLogWriter();
-            _disposables[_disposeIndex++] = _singletonAuditLogWriter62;
+            _singletonAuditLogWriter72 = new AuditLogWriter();
+            _disposables[_disposeIndex++] = _singletonAuditLogWriter72;
           }
 
-      return new CheckoutService(_singletonAuditLogWriter62);
+      return new CheckoutService(_singletonAuditLogWriter72);
     }
   }
 
@@ -147,7 +147,7 @@ partial class Composition: IDisposable, IAsyncDisposable
       _disposeIndex = 0;
       disposables = _disposables;
       _disposables = new object[1];
-      _singletonAuditLogWriter62 = null;
+      _singletonAuditLogWriter72 = null;
     }
 
     while (disposeIndex-- > 0)
@@ -183,7 +183,7 @@ partial class Composition: IDisposable, IAsyncDisposable
       _disposeIndex = 0;
       disposables = _disposables;
       _disposables = new object[1];
-      _singletonAuditLogWriter62 = null;
+      _singletonAuditLogWriter72 = null;
     }
 
     while (disposeIndex-- > 0)

readme/async-root.md

@@ -71,15 +71,16 @@ partial class Composition
   public Task<IBackupService> GetBackupServiceAsync(CancellationToken cancellationToken)
   {
     Task<IBackupService> transientTaskIBackupService;
-    // Injects an instance factory
+    // Creates the task value factory
     Func<IBackupService> perBlockFuncIBackupService = new Func<IBackupService>(
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     () =>
     {
+      // Creates a deferred value
       return new BackupService(new FileStore());
     });
     Func<IBackupService> localFactory = perBlockFuncIBackupService;
-    // Injects a task factory creating and scheduling task objects
+    // Creates the task factory
     TaskFactory<IBackupService> perBlockTaskFactoryIBackupService;
     CancellationToken localCancellationToken = cancellationToken;
     TaskCreationOptions transientTaskCreationOptions = TaskCreationOptions.None;
@@ -90,7 +91,7 @@ partial class Composition
     TaskScheduler localTaskScheduler = transientTaskScheduler;
     perBlockTaskFactoryIBackupService = new TaskFactory<IBackupService>(localCancellationToken, localTaskCreationOptions, localTaskContinuationOptions, localTaskScheduler);
     TaskFactory<IBackupService> localTaskFactory = perBlockTaskFactoryIBackupService;
-    // Creates and starts a task using the instance factory
+    // Starts the task
     transientTaskIBackupService = localTaskFactory.StartNew(localFactory);
     return transientTaskIBackupService;
   }

readme/auto-scoped.md

@@ -130,7 +130,7 @@ partial class Composition
   private readonly Object _lock;
 #endif
 
-  private PlaybackQueue? _scopedPlaybackQueue62;
+  private PlaybackQueue? _scopedPlaybackQueue72;
 
   [OrdinalAttribute(256)]
   public Composition()
@@ -159,6 +159,7 @@ partial class Composition
       [MethodImpl(MethodImplOptions.AggressiveInlining)]
       () =>
       {
+        // Creates a deferred value
         IListeningSession transientIListeningSession;
         Composition localParentScope = this;
         // Create a child scope so scoped services (PlaybackQueue) are unique per session.
@@ -175,14 +176,14 @@ partial class Composition
     [MethodImpl(MethodImplOptions.AggressiveInlining)]
     get
     {
-      if (_scopedPlaybackQueue62 is null)
+      if (_scopedPlaybackQueue72 is null)
         lock (_lock)
-          if (_scopedPlaybackQueue62 is null)
+          if (_scopedPlaybackQueue72 is null)
           {
-            _scopedPlaybackQueue62 = new PlaybackQueue();
+            _scopedPlaybackQueue72 = new PlaybackQueue();
           }
 
-      return new ListeningSession(_scopedPlaybackQueue62);
+      return new ListeningSession(_scopedPlaybackQueue72);
     }
   }
 }