Refactor Launcher region and amend docs

Author: MathoMathiasCamara

docs/articles/launcher/launcher.md

@@ -49,3 +49,30 @@ External modules are integrated with the `<embed>` tag; the external web-page mu
 }
 
 ````
+
+### Region
+
+To define a region in the launcher configuration, you can use the `Regions` property. This allows you to specify
+which region should be loaded and where it shoud be placed in the launcher.
+
+The region must define its own size using `css`, if that's a requirement for you. Otherwise the launcher will set an automatic size based on
+the available space.
+
+````json
+{
+  "Regions": [
+    {
+      "Region": "Right",
+      "Name": "MyRegionName"
+    }
+  ]
+}
+
+````
+**Note**: This will work under the following conditions:
+1. You have created an [ASP.net Partial View](https://learn.microsoft.com/en-us/aspnet/core/mvc/views/partial?view=aspnetcore-10.0#declare-partial-views).
+2. You used the `LauncherRegionAttribute` in your partial view.
+3. The name you used in your `LauncherRegion()` is the same in the configuration.
+4. You have placed the partial view inside a folder called `Pages`.
+5. The project in which you defined your partial view support Razor Pages and references the Launcher package or project. 
+

src/Moryx.Launcher/Config/LauncherRegionConfig.cs

@@ -17,8 +17,12 @@ public class LauncherRegionConfig
     [DataMember]
     public LauncherRegion Region { get; set; }
 
+    /// <summary>
+    /// The name of the region for the launcher
+    /// </summary>
+
     [DataMember]
-    public string PluginName { get; set; }
+    public string Name { get; set; }
 }
 
 public enum LauncherRegion

src/Moryx.Launcher/IShellNavigator.cs

@@ -18,5 +18,5 @@ public interface IShellNavigator
     /// <summary>
     /// Get the region configuration
     /// </summary>
-    LauncherRegionItem GetRegion(LauncherRegion region);
+    RegionItem GetRegion(LauncherRegion region);
 }

…Moryx/Modules/LauncherPluginAttribute.cs …oryx.Launcher/LauncherRegionAttribute.cssrc/Moryx/Modules/LauncherPluginAttribute.cs renamed to src/Moryx.Launcher/LauncherRegionAttribute.cs src/Moryx/Modules/LauncherPluginAttribute.cs renamed to src/Moryx.Launcher/LauncherRegionAttribute.cs

@@ -1,18 +1,17 @@
 // Copyright (c) 2026 Phoenix Contact GmbH & Co. KG
 // Licensed under the Apache License, Version 2.0
 
-namespace Moryx.Modules;
 
 /// <summary>
 /// Decorator for partial view (Region)
 /// </summary>
 /// <remarks>
-/// Export view as plugin under given name
+/// Export view as region under given name
 /// </remarks>
-public class LauncherPluginAttribute(string name) : Attribute
+public class LauncherRegionAttribute(string name) : Attribute
 {
     /// <summary>
-    /// Unique name of the plugin
+    /// Unique name of the region
     /// </summary>
     public string Name { get; } = name;
 

src/Moryx.Launcher/Pages/Shared/_Layout.cshtml

@@ -189,7 +189,7 @@
                     @RenderBody()
                 </main>
             </div>
-            @if (_navigator.GetRegion(LauncherRegion.Right) is LauncherRegionItem rightRegion)
+            @if (_navigator.GetRegion(LauncherRegion.Right) is RegionItem rightRegion)
             {
                 <aside class="tw-flex-initial tw-overflow-hidden">@await Html.PartialAsync(rightRegion.PartialView)</aside>
             }

src/Moryx.Launcher/LauncherRegionItem.cs src/Moryx.Launcher/RegionItem.cssrc/Moryx.Launcher/LauncherRegionItem.cs renamed to src/Moryx.Launcher/RegionItem.cs

@@ -3,7 +3,7 @@
 
 namespace Moryx.Launcher;
 
-public class LauncherRegionItem
+public class RegionItem
 {
     /// <summary>
     /// Name of the partial for the given region

src/Moryx.Launcher/ShellNavigator.cs

@@ -109,24 +109,24 @@ private async Task<CompiledPageActionDescriptor[]> CompiledPageActionDescriptors
     }
 
     /// <inheritdoc />
-    public LauncherRegionItem GetRegion(LauncherRegion region)
+    public RegionItem GetRegion(LauncherRegion region)
     {
-        var config = _launcherConfig.Regions?.FirstOrDefault(x => x.Region == region);
+        var config = _launcherConfig.Regions.FirstOrDefault(x => x.Region == region);
         if (config is null)
         {
             return null;
         }
 
         var partialViewAssembly = ReflectionTool.GetAssemblies();
-        var launcherPluginTypes = partialViewAssembly.SelectMany(x => x.GetTypes().Where(t => t.IsClass && t.GetCustomAttribute<LauncherPluginAttribute>() != null));
-        var launcherPluginType = launcherPluginTypes.FirstOrDefault(x => config.PluginName == x.GetCustomAttribute<LauncherPluginAttribute>().Name);
+        var launcherPluginTypes = partialViewAssembly.SelectMany(x => x.GetTypes().Where(t => t.IsClass && t.GetCustomAttribute<LauncherRegionAttribute>() != null));
+        var launcherPluginType = launcherPluginTypes.FirstOrDefault(x => config.Name == x.GetCustomAttribute<LauncherRegionAttribute>().Name);
         if (launcherPluginType is null)
         {
             return null;
         }
         // the name of the Pages/_MyPartialView.cshtml when compiled is ex: ...Pages__MyPartialView
         var viewName = launcherPluginType.Name[("Pages_".Length)..];
-        return new LauncherRegionItem { PartialView = viewName };
+        return new RegionItem { PartialView = viewName };
     }
 
     private ExternalModuleItem[] LoadExternalModules()