Merge branch 'main' into develop

.website/core/controllers.md

@@ -52,4 +52,4 @@ class MyController extends Controller {
 }
 ```
 
-You can find more information about metadata in the [Metadata](/core/metadata.html) section.
+You can find more information about metadata in the [Metadata](/core/metadata.html) section.

.website/core/providers.md

@@ -87,6 +87,7 @@ class MyModule extends Module {
   )
 }
 ```
+
 :::
 
 ## Global Providers
@@ -103,13 +104,18 @@ class MyProvider extends Provider {
 
 ## Deferred Providers
 
-By default, all providers are created when the module is created. If you want to create the provider after all the modules are created, you can extend the `DeferredProvider` class.
+By default, all providers are created when the module is created. If you want to create the provider after all the modules are registered, you can extend the `DeferredProvider` class.
 
 This class has a `init` property that accepts a function that returns the provider.
 
 Also the `init` function has access to the application context and contains all the providers initialized.
 When a DeferredProvider is initialized, its provider is added to the application context so that it can be used as dependency by other providers. This grant a incremental initialization of the providers.
 
+::: tip
+You can also use a shorthand to create a DeferredProvider by using the `Provider.deferred` factory constructor.
+This constructor uses the same parameters as the `DeferredProvider` class.
+:::
+
 ::: code-group
 
 ```dart [Deferred Provider]

packages/serinus/lib/src/core/provider.dart

@@ -7,6 +7,17 @@ abstract class Provider {
 
   /// The [Provider] constructor is used to create a new instance of the [Provider] class.
   const Provider({this.isGlobal = false});
+
+  /// The factory constructor [Provider.deferred] is used to create a new instance of the [Provider] class with dependencies.
+  /// It uses the [DeferredProvider] class to define a provider that is initialized asynchronously.
+  ///
+  /// The [init] function is called when the provider is initialized.
+  /// The [inject] property contains the types of other [Provider]s that will be injected in the provider.
+  factory Provider.deferred(
+    Future<Provider> Function(ApplicationContext context) init, {
+    required List<Type> inject,
+  }) =>
+      DeferredProvider(init, inject: inject);
 }
 
 /// The [DeferredProvider] class is used to define a provider that is initialized asynchronously.

packages/serinus/test/core/provider_test.dart

@@ -13,6 +13,10 @@ class TestProviderDependent extends Provider {
   TestProviderDependent(TestProvider provider);
 }
 
+class TestProviderDependent2 extends Provider {
+  TestProviderDependent2(TestProvider provider);
+}
+
 class TestProviderOnInit extends Provider with OnApplicationInit {
   bool isInitialized = false;
 
@@ -100,13 +104,18 @@ void main() async {
         DeferredProvider((context) async {
           final dep = context.use<TestProvider>();
           return TestProviderDependent(dep);
+        }, inject: [TestProvider]),
+        Provider.deferred((context) async {
+          final dep = context.use<TestProvider>();
+          return TestProviderDependent2(dep);
         }, inject: [TestProvider])
       ]);
       await container.registerModules(module, Type);
 
       await container.finalize(module);
 
       expect(container.get<TestProviderDependent>(), isNotNull);
+      expect(container.get<TestProviderDependent2>(), isNotNull);
     });
 
     test(