feat: add modular application shell

Author: Hongwei-MB

src/Framework/Core/Runtime/Lifecycle/IModuleInitializationContext.cs

@@ -0,0 +1,12 @@
+using ChengYuan.Core.Modularity;
+
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IModuleInitializationContext
+{
+    IServiceProvider ServiceProvider { get; }
+
+    IModuleCatalog ModuleCatalog { get; }
+
+    CancellationToken CancellationToken { get; }
+}

src/Framework/Core/Runtime/Lifecycle/IModuleShutdownContext.cs

@@ -0,0 +1,12 @@
+using ChengYuan.Core.Modularity;
+
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IModuleShutdownContext
+{
+    IServiceProvider ServiceProvider { get; }
+
+    IModuleCatalog ModuleCatalog { get; }
+
+    CancellationToken CancellationToken { get; }
+}

src/Framework/Core/Runtime/Lifecycle/IOnModuleInitialize.cs

@@ -0,0 +1,6 @@
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IOnModuleInitialize
+{
+    Task InitializeAsync(IModuleInitializationContext context);
+}

src/Framework/Core/Runtime/Lifecycle/IOnModulePostInitialize.cs

@@ -0,0 +1,6 @@
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IOnModulePostInitialize
+{
+    Task PostInitializeAsync(IModuleInitializationContext context);
+}

src/Framework/Core/Runtime/Lifecycle/IOnModulePreInitialize.cs

@@ -0,0 +1,6 @@
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IOnModulePreInitialize
+{
+    Task PreInitializeAsync(IModuleInitializationContext context);
+}

src/Framework/Core/Runtime/Lifecycle/IOnModuleShutdown.cs

@@ -0,0 +1,6 @@
+namespace ChengYuan.Core.Lifecycle;
+
+public interface IOnModuleShutdown
+{
+    Task ShutdownAsync(IModuleShutdownContext context);
+}

src/Framework/Core/Runtime/Lifecycle/ModuleInitializationContext.cs

@@ -0,0 +1,15 @@
+using ChengYuan.Core.Modularity;
+
+namespace ChengYuan.Core.Lifecycle;
+
+public sealed class ModuleInitializationContext(
+    IServiceProvider serviceProvider,
+    IModuleCatalog moduleCatalog,
+    CancellationToken cancellationToken) : IModuleInitializationContext
+{
+    public IServiceProvider ServiceProvider { get; } = serviceProvider;
+
+    public IModuleCatalog ModuleCatalog { get; } = moduleCatalog;
+
+    public CancellationToken CancellationToken { get; } = cancellationToken;
+}

src/Framework/Core/Runtime/Lifecycle/ModuleShutdownContext.cs

@@ -0,0 +1,15 @@
+using ChengYuan.Core.Modularity;
+
+namespace ChengYuan.Core.Lifecycle;
+
+public sealed class ModuleShutdownContext(
+    IServiceProvider serviceProvider,
+    IModuleCatalog moduleCatalog,
+    CancellationToken cancellationToken) : IModuleShutdownContext
+{
+    public IServiceProvider ServiceProvider { get; } = serviceProvider;
+
+    public IModuleCatalog ModuleCatalog { get; } = moduleCatalog;
+
+    public CancellationToken CancellationToken { get; } = cancellationToken;
+}

src/Framework/Core/Runtime/Modularity/IModularApplication.cs

@@ -0,0 +1,12 @@
+namespace ChengYuan.Core.Modularity;
+
+public interface IModularApplication
+{
+    IServiceProvider Services { get; }
+
+    IModuleCatalog ModuleCatalog { get; }
+
+    Task InitializeAsync(CancellationToken cancellationToken = default);
+
+    Task ShutdownAsync(CancellationToken cancellationToken = default);
+}

src/Framework/Core/Runtime/Modularity/IModuleCatalog.cs

@@ -0,0 +1,20 @@
+using System.Diagnostics.CodeAnalysis;
+
+namespace ChengYuan.Core.Modularity;
+
+public interface IModuleCatalog
+{
+    IReadOnlyList<IModuleDescriptor> Modules { get; }
+
+    IReadOnlyList<Type> ModuleTypes { get; }
+
+    IModuleDescriptor GetModule(Type moduleType);
+
+    bool TryGetModule(Type moduleType, [NotNullWhen(true)] out IModuleDescriptor? descriptor);
+
+    bool IsLoaded<TModule>() where TModule : ModuleBase;
+
+    IReadOnlyList<IModuleDescriptor> GetInitializationOrder();
+
+    IReadOnlyList<IModuleDescriptor> GetShutdownOrder();
+}