From a482b2dac480fe43630749454baba490b12017c5 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Mon, 30 Sep 2024 11:54:56 +0300
Subject: [PATCH 01/25] heading are added to the reports

---
 .../Markdown/AnnualReport/ClientsOverview.md  | 20 +++++++++++++++
 .../AnnualReport/EmployeesOverview.md         | 20 +++++++++++++++
 .../Markdown/AnnualReport/OrdersOverview.md   | 25 +++++++++++++++++++
 3 files changed, 65 insertions(+)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md
index 4b7f6e423..cefc7e830 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md
@@ -1,3 +1,23 @@
+---
+Name: "Top 5 Clients by Amount per Month"
+Description: "The report analyzes the top 5 clients based on their total purchase amounts, highlighting key clients such as QUICK-Stop and Ernst Handel. It suggests targeted reward strategies to enhance customer satisfaction and retention, including discounts, exclusive access, and personalized services. Additionally, the report provides general recommendations for creating effective reward programs to foster overall customer loyalty."
+Thumbnail: "images/thumbnail.jpg"
+Published: "2024-09-24"
+Authors:
+  - "Roland B�rgi"
+  - "Anna Kuleshova"
+Tags:
+  - "Top Clients"
+  - "Purchase Analysis"
+  - "Customer Loyalty"
+  - "Reward Programs"
+  - "Client Retention"
+  - "VIP Clients"
+  - "Discount Strategies"
+  - "Customer Satisfaction"
+  - "Loyalty Programs"
+  - "Business Development"
+---
 # Top 5 Clients by Amount per Month
 <style>
     .top-clients-chart {
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md
index 8bd4fdfb4..6a7670b22 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md
@@ -1,3 +1,23 @@
+---
+Name: "Top Employees of the Month Based on Amounts Earned"
+Description: "The attached report highlights the top-performing employees of the month based on their earnings. It recognizes and rewards employees like Nancy Davolio and Margaret Peacock for their exceptional contributions, with Nancy earning the highest amount. The report underscores the importance of acknowledging hard work to boost morale and foster a culture of excellence within the company."
+Thumbnail: "images/thumbnail.jpg"
+Published: "2024-09-24"
+Authors:
+  - "Roland B�rgi"
+  - "Anna Kuleshova"
+Tags:
+  - "Top Employees"
+  - "Monthly Earnings"
+  - "Employee Recognition"
+  - "Performance Metrics"
+  - "Bonus Allocation"
+  - "Productivity"
+  - "Employee Motivation"
+  - "Company Success"
+  - "Performance Review"
+  - "Incentive Programs"
+---
 # Top Employees of the Month Based on Amounts Earned
 <style>
     .top-employees-chart {
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md
index eb689fc89..330710824 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md
@@ -1,3 +1,28 @@
+---
+Name: "Financial Analytical Report on the Number of Orders per Month in 2023"
+Description: "This report provides a detailed analysis of the monthly order volumes for the year 2023. The report is essential for understanding the business’s performance trends and identifying areas for improvement."
+Thumbnail: "images/thumbnail.jpg"
+Published: "2024-09-24"
+Authors:
+  - "Roland B�rgi"
+  - "Anna Kuleshova"
+Tags:
+  - "2023 Orders Analysis"
+  - "Monthly Order Trends"
+  - "Financial Report"
+  - "Business Performance"
+  - "Order Volume"
+  - "Seasonal Trends"
+  - "Capacity Planning"
+  - "Sales Data"
+  - "Order Value Analysis"
+  - "Business Insights"
+  - "Monthly Breakdown"
+  - "Sales Recommendations"
+  - "Order Statistics"
+  - "Performance Analysis"
+---
+
 ### Financial Analytical Report on the Number of Orders per Month in 2023
 
 This report provides a comprehensive analysis of the number of orders received each month in the year 2023. The data, extracted from the provided spreadsheet, highlights the trends and patterns in order volumes over the year. By examining these trends, we can gain insights into the business's performance and identify areas for improvement.

From 9d8a99a37ed0ccb995b771a9f35e73c1503afe1f Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Mon, 30 Sep 2024 12:34:43 +0300
Subject: [PATCH 02/25] xml comments added

---
 src/MeshWeaver.Layout/BodyContentSkin.cs |   8 +-
 src/MeshWeaver.Layout/CardSkin.cs        |  64 +++++++++---
 src/MeshWeaver.Layout/Controls.cs        | 119 ++++++++++++++++++-----
 3 files changed, 152 insertions(+), 39 deletions(-)

diff --git a/src/MeshWeaver.Layout/BodyContentSkin.cs b/src/MeshWeaver.Layout/BodyContentSkin.cs
index e2c9c39e8..796af7d6a 100644
--- a/src/MeshWeaver.Layout/BodyContentSkin.cs
+++ b/src/MeshWeaver.Layout/BodyContentSkin.cs
@@ -1,3 +1,9 @@
 namespace MeshWeaver.Layout;
-
+/// <summary>
+/// Represents the skin for body content.
+/// </summary>
+/// <remarks>
+/// For more information, visit the 
+/// <a href="https://www.fluentui-blazor.net/bodycontent">Fluent UI Blazor BodyContent documentation</a>.
+/// </remarks>
 public record BodyContentSkin : Skin<BodyContentSkin>;
diff --git a/src/MeshWeaver.Layout/CardSkin.cs b/src/MeshWeaver.Layout/CardSkin.cs
index 2cd32e6e9..8cfa13dbc 100644
--- a/src/MeshWeaver.Layout/CardSkin.cs
+++ b/src/MeshWeaver.Layout/CardSkin.cs
@@ -1,17 +1,59 @@
-namespace MeshWeaver.Layout;
-
-public record CardSkin : Skin<CardSkin>
+namespace MeshWeaver.Layout
 {
-    public object AreaRestricted { get; init; }
-    public object Height { get; init; }
-    public object Width { get; init; }
-    public object MinimalStyle { get; init; }
+    /// <summary>
+    /// Represents the skin for a card control with customizable properties.
+    /// </summary>
+    /// <remarks>
+    /// For more information, visit the 
+    /// <a href="https://www.fluentui-blazor.net/card">Fluent UI Blazor Card documentation</a>.
+    /// </remarks>
+    public record CardSkin : Skin<CardSkin>
+    {
+        /// <summary>
+        /// Gets or initializes the area restriction state of the card.
+        /// </summary>
+        public object AreaRestricted { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the height of the card.
+        /// </summary>
+        public object Height { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the width of the card.
+        /// </summary>
+        public object Width { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the minimal style state of the card.
+        /// </summary>
+        public object MinimalStyle { get; init; }
 
-    public CardSkin WithAreaRestricted(object areaRestricted) => This with { AreaRestricted = areaRestricted };
+        /// <summary>
+        /// Sets the area restriction state of the card.
+        /// </summary>
+        /// <param name="areaRestricted">The area restriction state to set.</param>
+        /// <returns>A new <see cref="CardSkin"/> instance with the specified area restriction state.</returns>
+        public CardSkin WithAreaRestricted(object areaRestricted) => This with { AreaRestricted = areaRestricted };
 
-    public CardSkin WithHeight(object height) => This with { Height = height };
+        /// <summary>
+        /// Sets the height of the card.
+        /// </summary>
+        /// <param name="height">The height to set.</param>
+        /// <returns>A new <see cref="CardSkin"/> instance with the specified height.</returns>
+        public CardSkin WithHeight(object height) => This with { Height = height };
 
-    public CardSkin WithWidth(object width) => This with { Width = width };
+        /// <summary>
+        /// Sets the width of the card.
+        /// </summary>
+        /// <param name="width">The width to set.</param>
+        /// <returns>A new <see cref="CardSkin"/> instance with the specified width.</returns>
+        public CardSkin WithWidth(object width) => This with { Width = width };
 
-    public CardSkin WithMinimalStyle() => This with { MinimalStyle = true };
+        /// <summary>
+        /// Sets the minimal style state of the card.
+        /// </summary>
+        /// <returns>A new <see cref="CardSkin"/> instance with the minimal style state set to true.</returns>
+        public CardSkin WithMinimalStyle() => This with { MinimalStyle = true };
+    }
 }
diff --git a/src/MeshWeaver.Layout/Controls.cs b/src/MeshWeaver.Layout/Controls.cs
index d8468f188..fce1dcb45 100644
--- a/src/MeshWeaver.Layout/Controls.cs
+++ b/src/MeshWeaver.Layout/Controls.cs
@@ -1,30 +1,95 @@
-using MeshWeaver.Data;
-using MeshWeaver.Domain;
-using MeshWeaver.Layout.DataGrid;
-
-namespace MeshWeaver.Layout;
-
-public static class Controls
-{
-    public static SplitterControl Splitter => new();
-    public static LayoutControl Layout => new();
-    public static LayoutGridControl LayoutGrid => new();
-
-    public static NavGroupControl NavGroup(string title, object icon=null, object href=null) => new(title, icon, href);
-    public static TabsControl Tabs => new();
-    public static NavMenuControl NavMenu => new();
-
-    public static NavLinkControl NavLink(object title, object href) => new(title, null, href);
-    public static NavLinkControl NavLink(object title, Icon icon, object href) => new(title, icon, href);
-
-    public static LayoutStackControl Stack => new();
-
-    public static ToolbarControl Toolbar => new ToolbarControl();
-
-    public static SelectControl Select(object item) => new(item);
-    public static ListboxControl Listbox(object item) => new(item);
-    public static ComboboxControl Combobox(object item) => new(item);
-
+    using MeshWeaver.Data;
+    using MeshWeaver.Domain;
+    using MeshWeaver.Layout.DataGrid;
+    
+    namespace MeshWeaver.Layout;
+    
+    /// <summary>
+    /// Provides static methods to create various UI controls.
+    /// </summary>
+    public static class Controls
+    {
+        /// <summary>
+        /// Gets a new instance of <see cref="SplitterControl"/>.
+        /// </summary>
+        public static SplitterControl Splitter => new();
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="LayoutControl"/>.
+        /// </summary>
+        public static LayoutControl Layout => new();
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="LayoutGridControl"/>.
+        /// </summary>
+        public static LayoutGridControl LayoutGrid => new();
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="NavGroupControl"/> with the specified title, icon, and href.
+        /// </summary>
+        /// <param name="title">The title of the navigation group.</param>
+        /// <param name="icon">The icon of the navigation group.</param>
+        /// <param name="href">The href of the navigation group.</param>
+        /// <returns>A new instance of <see cref="NavGroupControl"/>.</returns>
+        public static NavGroupControl NavGroup(string title, object icon = null, object href = null) => new(title, icon, href);
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="TabsControl"/>.
+        /// </summary>
+        public static TabsControl Tabs => new();
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="NavMenuControl"/>.
+        /// </summary>
+        public static NavMenuControl NavMenu => new();
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="NavLinkControl"/> with the specified title and href.
+        /// </summary>
+        /// <param name="title">The title of the navigation link.</param>
+        /// <param name="href">The href of the navigation link.</param>
+        /// <returns>A new instance of <see cref="NavLinkControl"/>.</returns>
+        public static NavLinkControl NavLink(object title, object href) => new(title, null, href);
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="NavLinkControl"/> with the specified title, icon, and href.
+        /// </summary>
+        /// <param name="title">The title of the navigation link.</param>
+        /// <param name="icon">The icon of the navigation link.</param>
+        /// <param name="href">The href of the navigation link.</param>
+        /// <returns>A new instance of <see cref="NavLinkControl"/>.</returns>
+        public static NavLinkControl NavLink(object title, Icon icon, object href) => new(title, icon, href);
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="LayoutStackControl"/>.
+        /// </summary>
+        public static LayoutStackControl Stack => new();
+    
+        /// <summary>
+        /// Gets a new instance of <see cref="ToolbarControl"/>.
+        /// </summary>
+        public static ToolbarControl Toolbar => new ToolbarControl();
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="SelectControl"/> with the specified item.
+        /// </summary>
+        /// <param name="item">The item to select.</param>
+        /// <returns>A new instance of <see cref="SelectControl"/>.</returns>
+        public static SelectControl Select(object item) => new(item);
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="ListboxControl"/> with the specified item.
+        /// </summary>
+        /// <param name="item">The item to list.</param>
+        /// <returns>A new instance of <see cref="ListboxControl"/>.</returns>
+        public static ListboxControl Listbox(object item) => new(item);
+    
+        /// <summary>
+        /// Creates a new instance of <see cref="ComboboxControl"/> with the specified item.
+        /// </summary>
+        /// <param name="item">The item to combobox.</param>
+        /// <returns>A new instance of <see cref="ComboboxControl"/>.</returns>
+        public static ComboboxControl Combobox(object item) => new(item);
     public static TextFieldControl Text(object data) => new(data);
 
     public static NumberFieldControl Number(object data, string type) => new(data, type);

From 7c86f17729f46cc0a8246e541fb807a1073597f9 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Mon, 30 Sep 2024 12:47:33 +0300
Subject: [PATCH 03/25] xml comments added

---
 src/MeshWeaver.Layout/LayoutAreaProperties.cs | 38 +++++++++++++++++--
 src/MeshWeaver.Layout/LayoutAreaReference.cs  | 33 +++++++++++++++-
 2 files changed, 66 insertions(+), 5 deletions(-)

diff --git a/src/MeshWeaver.Layout/LayoutAreaProperties.cs b/src/MeshWeaver.Layout/LayoutAreaProperties.cs
index 816373866..619aa8825 100644
--- a/src/MeshWeaver.Layout/LayoutAreaProperties.cs
+++ b/src/MeshWeaver.Layout/LayoutAreaProperties.cs
@@ -3,22 +3,54 @@
 
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents the properties of a layout area.
+    /// </summary>
     public record LayoutAreaProperties
     {
+        /// <summary>
+        /// The name of the properties.
+        /// </summary>
         public const string Properties = nameof(Properties);
+
+        /// <summary>
+        /// Gets or initializes the page title of the layout area.
+        /// </summary>
         public string PageTitle { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the heading of the layout area.
+        /// </summary>
         public string Heading { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the heading menu items of the layout area.
+        /// </summary>
         public ImmutableList<object> HeadingMenu { get; init; } = ImmutableList<object>.Empty;
 
+        /// <summary>
+        /// Gets or initializes the menu controls of the layout area.
+        /// </summary>
         internal ImmutableList<NavLinkControl> MenuControls { get; init; } = ImmutableList<NavLinkControl>.Empty;
 
+        /// <summary>
+        /// Gets or initializes the menu order of the layout area.
+        /// </summary>
         internal int MenuOrder { get; init; }
-        public LayoutAreaProperties WithMenuOrder(int order) => this with { MenuOrder = order };
 
+        /// <summary>
+        /// Sets the menu order of the layout area.
+        /// </summary>
+        /// <param name="order">The menu order to set.</param>
+        /// <returns>A new <see cref="LayoutAreaProperties"/> instance with the specified menu order.</returns>
+        public LayoutAreaProperties WithMenuOrder(int order) => this with { MenuOrder = order };
 
+        /// <summary>
+        /// Sets the menu controls of the layout area.
+        /// </summary>
+        /// <param name="items">The menu controls to set.</param>
+        /// <returns>A new <see cref="LayoutAreaProperties"/> instance with the specified menu controls.</returns>
         public LayoutAreaProperties WithMenu(params NavLinkControl[] items)
             => this with { MenuControls = MenuControls.AddRange(items) };
-
-
     }
 }
diff --git a/src/MeshWeaver.Layout/LayoutAreaReference.cs b/src/MeshWeaver.Layout/LayoutAreaReference.cs
index c59898072..2f5f6166a 100644
--- a/src/MeshWeaver.Layout/LayoutAreaReference.cs
+++ b/src/MeshWeaver.Layout/LayoutAreaReference.cs
@@ -4,15 +4,30 @@
 
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Provides methods and constants for working with layout area references.
+/// </summary>
 public record LayoutAreaReference(string Area) : WorkspaceReference<EntityStore>
 {
     public object Id { get; init; }
     public string Layout { get; init; }
 
     public const string Data = "data";
+
+    /// <summary>
+    /// The constant string for areas.
+    /// </summary>
     public const string Areas = "areas";
+    /// <summary>
+    /// The constant string for properties.
+    /// </summary>
     public const string Properties = "properties";
-
+/// <summary>
+    /// Gets the data pointer for the specified ID and extra segments.
+    /// </summary>
+    /// <param name="id">The ID for the data pointer.</param>
+    /// <param name="extraSegments">The extra segments for the data pointer.</param>
+    /// <returns>A string representing the data pointer.</returns>
     public static string GetDataPointer(string id, params string[] extraSegments) =>
         JsonPointer.Create(
             new[] { Data, JsonSerializer.Serialize(id) }
@@ -22,13 +37,27 @@ public static string GetDataPointer(string id, params string[] extraSegments) =>
         )
         .ToString();
 
+/// <summary>
+    /// Gets the control pointer for the specified area.
+    /// </summary>
+    /// <param name="area">The area for the control pointer.</param>
+    /// <returns>A string representing the control pointer.</returns>
     public static string GetControlPointer(string area) =>
         JsonPointer.Create(Areas, JsonSerializer.Serialize(area)).ToString();
+/// <summary>
+    /// Gets the properties pointer for the specified ID.
+    /// </summary>
+    /// <param name="id">The ID for the properties pointer.</param>
+    /// <returns>A string representing the properties pointer.</returns>
     public static string GetPropertiesPointer(string id) =>
         JsonPointer.Create(Properties, id).ToString();
 
 
-
+/// <summary>
+    /// Converts the layout area reference to an application href.
+    /// </summary>
+    /// <param name="address">The address for the href.</param>
+    /// <returns>A string representing the application href.</returns>
     public string ToAppHref(object address)
     {
         var ret = $"app/{address}/{LayoutExtensions.Encode(Area)}";

From 8ef0d73ecc451ec4f4d43acab9c907eae3df8013 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Tue, 1 Oct 2024 11:11:31 +0300
Subject: [PATCH 04/25] xml comments added

---
 .../FluentIcons.cs                            |   4 +-
 src/MeshWeaver.Layout/Appearance.cs           |  26 ++++
 src/MeshWeaver.Layout/BadgeControl.cs         | 113 ++++++++++++++----
 src/MeshWeaver.Layout/DateTimeControl.cs      |  43 +++++++
 src/MeshWeaver.Layout/EditFormControl.cs      |  26 +++-
 src/MeshWeaver.Layout/ExpandRequest.cs        |  18 ++-
 src/MeshWeaver.Layout/HorizontalAlignment.cs  |  39 ++++--
 src/MeshWeaver.Layout/HtmlControl.cs          |   8 ++
 src/MeshWeaver.Layout/IFormComponent.cs       |   7 +-
 src/MeshWeaver.Layout/IGenericType.cs         |  21 +++-
 .../JsonObjectEqualityComparer.cs             |  60 ++++++----
 11 files changed, 304 insertions(+), 61 deletions(-)

diff --git a/src/MeshWeaver.Application.Styles/FluentIcons.cs b/src/MeshWeaver.Application.Styles/FluentIcons.cs
index 9128cae70..cbb7d7b84 100644
--- a/src/MeshWeaver.Application.Styles/FluentIcons.cs
+++ b/src/MeshWeaver.Application.Styles/FluentIcons.cs
@@ -25,4 +25,6 @@ public static class FluentIcons
     public static Icon SquareMultiple => new(Provider, "SquareMultiple");
     public static Icon WalletCreditCard => new(Provider, "WalletCreditCard");
 
-}
+    <FluentIcon Value="@(new Icons.Regular.Size20.CreditCardPerson())" />
+
+    }
diff --git a/src/MeshWeaver.Layout/Appearance.cs b/src/MeshWeaver.Layout/Appearance.cs
index b7c3f1cad..f7ed28aae 100644
--- a/src/MeshWeaver.Layout/Appearance.cs
+++ b/src/MeshWeaver.Layout/Appearance.cs
@@ -1,12 +1,38 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Provides constants for different appearance styles.
+    /// </summary>
     public static class Appearance
     {
+        /// <summary>
+        /// Represents a neutral appearance style.
+        /// </summary>
         public const string Neutral = nameof(Neutral);
+
+        /// <summary>
+        /// Represents an accent appearance style.
+        /// </summary>
         public const string Accent = nameof(Accent);
+
+        /// <summary>
+        /// Represents a lightweight appearance style.
+        /// </summary>
         public const string Lightweight = nameof(Lightweight);
+
+        /// <summary>
+        /// Represents an outline appearance style.
+        /// </summary>
         public const string Outline = nameof(Outline);
+
+        /// <summary>
+        /// Represents a stealth appearance style.
+        /// </summary>
         public const string Stealth = nameof(Stealth);
+
+        /// <summary>
+        /// Represents a filled appearance style.
+        /// </summary>
         public const string Filled = nameof(Filled);
     }
 }
diff --git a/src/MeshWeaver.Layout/BadgeControl.cs b/src/MeshWeaver.Layout/BadgeControl.cs
index 027689d5e..004180f1c 100644
--- a/src/MeshWeaver.Layout/BadgeControl.cs
+++ b/src/MeshWeaver.Layout/BadgeControl.cs
@@ -1,33 +1,106 @@
-namespace MeshWeaver.Layout;
-
-public record BadgeControl(object Data)
-    : UiControl<BadgeControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion)
+namespace MeshWeaver.Layout
 {
-    public object Appearance { get; init; }
-    public object BackgroundColor { get; init; }
-    public object Circular { get; init; }
-    public object Color { get; init; }
-    public object DismissIcon { get; init; }
-    public object DismissTitle { get; init; }
-    public object Fill { get; init; }
-    public object Height { get; init; }
-    public object Width { get; init; }
+    /// <summary>
+    /// Represents a badge control with custom    /// le properties.
+    /// </summary>
+    /// <remarks>
+    /// For more information, visit the 
+    /// <a href="https://www.fluentui-blazor.net/badge">Fluent UI Blazor Badge documentation</a>.
+    /// </remarks>
+    /// <param name="Data">The data associated with the badge control.</param>
+    public record BadgeControl(object Data)
+        : UiControl<BadgeControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion)
+    {
+        /// <summary>
+        /// Gets or initializes the appearance of the badge.
+        /// </summary>
+        public object Appearance { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the background color of the badge.
+        /// </summary>
+        public object BackgroundColor { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the circular state of the badge.
+        /// </summary>
+        public object Circular { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the color of the badge.
+        /// </summary>
+        public object Color { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the dismiss icon of the badge.
+        /// </summary>
+        public object DismissIcon { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the dismiss title of the badge.
+        /// </summary>
+        public object DismissTitle { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the fill of the badge.
+        /// </summary>
+        public object Fill { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the height of the badge.
+        /// </summary>
+        public object Height { get; init; }
 
-    public BadgeControl WithAppearance(object appearance) => This with { Appearance = appearance };
+        /// <summary>
+        /// Gets or initializes the width of the badge.
+        /// </summary>
+        public object Width { get; init; }
 
-    public BadgeControl WithBackgroundColor(object backgroundColor) => This with { BackgroundColor = backgroundColor };
+        /// <summary>
+        /// Sets the appearance of the badge.
+        /// </summary>
+        /// <param name="appearance">The appearance to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified appearance.</returns>
+        public BadgeControl WithAppearance(object appearance) => this with { Appearance = appearance };
 
-    public BadgeControl WithCircular(object circular) => This with { Circular = circular };
+        /// <summary>
+        /// Sets the background color of the badge.
+        /// </summary>
+        /// <param name="backgroundColor">The background color to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified background color.</returns>
+        public BadgeControl WithBackgroundColor(object backgroundColor) => this with { BackgroundColor = backgroundColor };
 
-    public BadgeControl WithColor(object color) => This with { Color = color };
+        /// <summary>
+        /// Sets the circular state of the badge.
+        /// </summary>
+        /// <param name="circular">The circular state to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified circular state.</returns>
+        public BadgeControl WithCircular(object circular) => this with { Circular = circular };
 
-    public BadgeControl WithDismissIcon(object dismissIcon) => This with { DismissIcon = dismissIcon };
+        /// <summary>
+        /// Sets the color of the badge.
+        /// </summary>
+        /// <param name="color">The color to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified color.</returns>
+        public BadgeControl WithColor(object color) => this with { Color = color };
 
-    public BadgeControl WithDismissTitle(object dismissTitle) => This with { DismissTitle = dismissTitle };
+        /// <summary>
+        /// Sets the dismiss icon of the badge.
+        /// </summary>
+        /// <param name="dismissIcon">The dismiss icon to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified dismiss icon.</returns>
+        public BadgeControl WithDismissIcon(object dismissIcon) => this with { DismissIcon = dismissIcon };
 
-    public BadgeControl WithFill(object fill) => This with { Fill = fill };
+        /// <summary>
+        /// Sets the dismiss title of the badge.
+        /// </summary>
+        /// <param name="dismissTitle">The dismiss title to set.</param>
+        /// <returns>A new <see cref="BadgeControl"/> instance with the specified dismiss title.</returns>
+        public BadgeControl WithDismissTitle(object dismissTitle) => this with { DismissTitle = dismissTitle };
+        public BadgeControl WithFill(object fill) => This with { Fill = fill };
 
     public BadgeControl WithHeight(object height) => This with { Height = height };
 
     public BadgeControl WithWidth(object width) => This with { Width = width };
+    }
 }
diff --git a/src/MeshWeaver.Layout/DateTimeControl.cs b/src/MeshWeaver.Layout/DateTimeControl.cs
index c68fbd083..f481170b5 100644
--- a/src/MeshWeaver.Layout/DateTimeControl.cs
+++ b/src/MeshWeaver.Layout/DateTimeControl.cs
@@ -1,15 +1,58 @@
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Represents a date-time control with customizable properties.
+/// </summary>
+/// <param name="Data">The data associated with the date-time control.</param>
 public record DateTimeControl(object Data) : UiControl<DateTimeControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion), IFormComponent
 {
+    /// <summary>
+    /// Gets or initializes the minimum value for the date-time control.
+    /// </summary>
     public object Min { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the maximum value for the date-time control.
+    /// </summary>
     public object Max { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the step value for the date-time control.
+    /// </summary>
     public object Step { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the state to hide the step value for the date-time control.
+    /// </summary>
     public object HideStep { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the data list for the date-time control.
+    /// </summary>
     public object DataList { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the maximum length for the date-time control.
+    /// </summary>
     public object MaxLength { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the minimum length for the date-time control.
+    /// </summary>
     public object MinLength { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the size of the date-time control.
+    /// </summary>
     public object Size { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the appearance of the date-time control.
+    /// </summary>
     public object Appearance { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the parsing error message for the date-time control.
+    /// </summary>
     public object ParsingErrorMessage { get; init; }
 }
diff --git a/src/MeshWeaver.Layout/EditFormControl.cs b/src/MeshWeaver.Layout/EditFormControl.cs
index 68d8ea803..5976311af 100644
--- a/src/MeshWeaver.Layout/EditFormControl.cs
+++ b/src/MeshWeaver.Layout/EditFormControl.cs
@@ -1,18 +1,42 @@
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Represents an edit form control with customizable properties.
+/// </summary>
 public record EditFormControl()
     : ContainerControlWithItemSkin<EditFormControl, EditFormSkin, EditFormItemSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new())
 {
+    /// <summary>
+    /// Creates a new instance of <see cref="EditFormItemSkin"/> for the specified named area.
+    /// </summary>
+    /// <param name="namedArea">The named area control.</param>
+    /// <returns>A new instance of <see cref="EditFormItemSkin"/>.</returns>
     protected override EditFormItemSkin CreateItemSkin(NamedAreaControl namedArea)
         => new();
 }
 
+/// <summary>
+/// Represents the skin for an edit form control.
+/// </summary>
 public record EditFormSkin : Skin<EditFormSkin>;
 
-
+/// <summary>
+/// Represents the skin for an item in an edit form control.
+/// </summary>
 public record EditFormItemSkin : Skin<EditFormItemSkin>
 {
+    /// <summary>
+    /// Gets or initializes the description of the item.
+    /// </summary>
     public object Description { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the name of the item.
+    /// </summary>
     public object Name { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the label of the item.
+    /// </summary>
     public object Label { get; set; }
 }
diff --git a/src/MeshWeaver.Layout/ExpandRequest.cs b/src/MeshWeaver.Layout/ExpandRequest.cs
index 1d9bfff33..317d1f146 100644
--- a/src/MeshWeaver.Layout/ExpandRequest.cs
+++ b/src/MeshWeaver.Layout/ExpandRequest.cs
@@ -1,8 +1,16 @@
 using MeshWeaver.Data;
 
-namespace MeshWeaver.Layout;
-
-public record ClickedEvent(string Area) : WorkspaceMessage
+namespace MeshWeaver.Layout
 {
-    public object Payload { get; init; }
-};
+    /// <summary>
+    /// Represents an event that occurs when an area is clicked.
+    /// </summary>
+    /// <param name="Area">The area that was clicked.</param>
+    public record ClickedEvent(string Area) : WorkspaceMessage
+    {
+        /// <summary>
+        /// Gets or initializes the payload associated with the clicked event.
+        /// </summary>
+        public object Payload { get; init; }
+    }
+}
diff --git a/src/MeshWeaver.Layout/HorizontalAlignment.cs b/src/MeshWeaver.Layout/HorizontalAlignment.cs
index 0f5084af9..c9ee23e72 100644
--- a/src/MeshWeaver.Layout/HorizontalAlignment.cs
+++ b/src/MeshWeaver.Layout/HorizontalAlignment.cs
@@ -1,10 +1,33 @@
-namespace MeshWeaver.Layout;
-
-public enum HorizontalAlignment
+namespace MeshWeaver.Layout
 {
-    Left,
-    Center,
-    Right,
-    Start,
-    End
+    /// <summary>
+    /// Specifies the horizontal alignment options for a control.
+    /// </summary>
+    public enum HorizontalAlignment
+    {
+        /// <summary>
+        /// Aligns the content to the left.
+        /// </summary>
+        Left,
+
+        /// <summary>
+        /// Centers the content.
+        /// </summary>
+        Center,
+
+        /// <summary>
+        /// Aligns the content to the right.
+        /// </summary>
+        Right,
+
+        /// <summary>
+        /// Aligns the content to the start of the container.
+        /// </summary>
+        Start,
+
+        /// <summary>
+        /// Aligns the content to the end of the container.
+        /// </summary>
+        End
+    }
 }
diff --git a/src/MeshWeaver.Layout/HtmlControl.cs b/src/MeshWeaver.Layout/HtmlControl.cs
index 1c5a0cba3..91828fa39 100644
--- a/src/MeshWeaver.Layout/HtmlControl.cs
+++ b/src/MeshWeaver.Layout/HtmlControl.cs
@@ -1,5 +1,13 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents an HTML control with customizable properties.
+    /// </summary>
+    /// <remarks>
+    /// For more information, visit the 
+    /// <a href="https://www.fluentui-blazor.net/html">Fluent UI Blazor HTML documentation</a>.
+    /// </remarks>
+    /// <param name="Data">The data associated with the HTML control.</param>
     public record HtmlControl(object Data)
         : UiControl<HtmlControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion);
 }
diff --git a/src/MeshWeaver.Layout/IFormComponent.cs b/src/MeshWeaver.Layout/IFormComponent.cs
index bf63b36b3..c204af0bb 100644
--- a/src/MeshWeaver.Layout/IFormComponent.cs
+++ b/src/MeshWeaver.Layout/IFormComponent.cs
@@ -1,8 +1,13 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents a form component with customizable properties.
+    /// </summary>
     public interface IFormComponent : IUiControl
     {
+        /// <summary>
+        /// Gets or initializes the data associated with the form component.
+        /// </summary>
         object Data { get; init; }
-
     }
 }
diff --git a/src/MeshWeaver.Layout/IGenericType.cs b/src/MeshWeaver.Layout/IGenericType.cs
index a052b4409..bb0f9d425 100644
--- a/src/MeshWeaver.Layout/IGenericType.cs
+++ b/src/MeshWeaver.Layout/IGenericType.cs
@@ -1,7 +1,18 @@
-namespace MeshWeaver.Layout;
-
-public interface IGenericType
+namespace MeshWeaver.Layout
 {
-    Type BaseType { get; }
-    Type[] TypeArguments { get; }
+    /// <summary>
+    /// Represents a generic type with base type and type arguments.
+    /// </summary>
+    public interface IGenericType
+    {
+        /// <summary>
+        /// Gets the base type of the generic type.
+        /// </summary>
+        Type BaseType { get; }
+
+        /// <summary>
+        /// Gets the type arguments of the generic type.
+        /// </summary>
+        Type[] TypeArguments { get; }
+    }
 }
diff --git a/src/MeshWeaver.Layout/JsonObjectEqualityComparer.cs b/src/MeshWeaver.Layout/JsonObjectEqualityComparer.cs
index 2d591bb0e..c8f78d4e0 100644
--- a/src/MeshWeaver.Layout/JsonObjectEqualityComparer.cs
+++ b/src/MeshWeaver.Layout/JsonObjectEqualityComparer.cs
@@ -1,32 +1,52 @@
 using System.Text.Json.Nodes;
+using System.Collections.Generic;
 
-namespace MeshWeaver.Layout;
-
-public class JsonObjectEqualityComparer : IEqualityComparer<object>
+namespace MeshWeaver.Layout
 {
-    public static readonly JsonObjectEqualityComparer Instance = new();
-    public new bool Equals(object x, object y)
+    /// <summary>
+    /// Provides a custom equality comparer for JSON objects.
+    /// </summary>
+    public class JsonObjectEqualityComparer : IEqualityComparer<object>
     {
-        if(x == null)
-            return y == null;
-        if(y == null)
-            return false;
+        /// <summary>
+        /// Gets the singleton instance of the <see cref="JsonObjectEqualityComparer"/> class.
+        /// </summary>
+        public static readonly JsonObjectEqualityComparer Instance = new();
 
-        if (x is JsonObject jsonX && y is JsonObject jsonY)
+        /// <summary>
+        /// Determines whether the specified objects are equal.
+        /// </summary>
+        /// <param name="x">The first object to compare.</param>
+        /// <param name="y">The second object to compare.</param>
+        /// <returns><c>true</c> if the specified objects are equal; otherwise, <c>false</c>.</returns>
+        public new bool Equals(object x, object y)
         {
-            return jsonX.ToString() == jsonY.ToString();
+            if (x == null)
+                return y == null;
+            if (y == null)
+                return false;
+
+            if (x is JsonObject jsonX && y is JsonObject jsonY)
+            {
+                return jsonX.ToString() == jsonY.ToString();
+            }
+            if (x is IEnumerable<object> enumerable && y is IEnumerable<object> yEnumerable)
+                return enumerable.SequenceEqual(yEnumerable, this);
+            return x.Equals(y);
         }
-        if(x is IEnumerable<object> enumerable && y is IEnumerable<object> yEnumerable)
-            return enumerable.SequenceEqual(yEnumerable, this);
-        return x.Equals(y);
-    }
 
-    public int GetHashCode(object obj)
-    {
-        if (obj is JsonObject jsonObj)
+        /// <summary>
+        /// Returns a hash code for the specified object.
+        /// </summary>
+        /// <param name="obj">The object for which a hash code is to be returned.</param>
+        /// <returns>A hash code for the specified object.</returns>
+        public int GetHashCode(object obj)
         {
-            return jsonObj.ToString().GetHashCode();
+            if (obj is JsonObject jsonObj)
+            {
+                return jsonObj.ToString().GetHashCode();
+            }
+            return obj.GetHashCode();
         }
-        return obj.GetHashCode();
     }
 }

From 11488d305409b9b8e6248f40f4653c59a1351cb5 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Tue, 1 Oct 2024 11:26:16 +0300
Subject: [PATCH 05/25] catalog items added

---
 src/MeshWeaver.Application.Styles/FluentIcons.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/MeshWeaver.Application.Styles/FluentIcons.cs b/src/MeshWeaver.Application.Styles/FluentIcons.cs
index cbb7d7b84..ecb34a45c 100644
--- a/src/MeshWeaver.Application.Styles/FluentIcons.cs
+++ b/src/MeshWeaver.Application.Styles/FluentIcons.cs
@@ -12,7 +12,6 @@ public static class FluentIcons
     public static Icon Person => new (Provider, "Person");
     public static Icon CalendarDataBar => new (Provider, "CalendarDataBar");
     public static Icon Search => new (Provider, "Search");
-
     public static Icon Add => new (Provider, "Add");
     public static Icon Edit => new (Provider, "Edit");
     public static Icon Delete => new (Provider, "Delete");
@@ -24,7 +23,11 @@ public static class FluentIcons
     public static Icon Folder => new(Provider, "Folder");
     public static Icon SquareMultiple => new(Provider, "SquareMultiple");
     public static Icon WalletCreditCard => new(Provider, "WalletCreditCard");
-
-    <FluentIcon Value="@(new Icons.Regular.Size20.CreditCardPerson())" />
+    public static Icon CreditCardPerson => new(Provider, "CreditCardPerson");
+    public static Icon ShoppingBagPercent => new(Provider, "ShoppingBagPercent");
+    public static Icon Person5 => new(Provider, "Person5");
+    public static Icon BoxCheckmark => new(Provider, "BoxCheckmark");
+    public static Icon ShoppingBag => new(Provider, "ShoppingBag");
+    public static Icon Money => new(Provider, "Money");
 
     }

From 9dc2ca8fd7f36615f4561fd0c1ecdad8e015d436 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Tue, 1 Oct 2024 12:45:57 +0300
Subject: [PATCH 06/25] xml comments added

---
 src/MeshWeaver.Data.Contract/EntityStore.cs   |   5 +
 .../LayoutAreaReferenceExtensions.cs          |  30 +++-
 .../LayoutDefinitionExtensions.cs             | 132 ++++++------------
 src/MeshWeaver.Layout/LayoutGridItemHidden.cs |  75 +++++++++-
 src/MeshWeaver.Layout/LayoutGridItemSkin.cs   |  94 ++++++++++++-
 src/MeshWeaver.Layout/LayoutGridSkin.cs       |  40 ++++++
 src/MeshWeaver.Layout/LayoutSkin.cs           |  15 +-
 src/MeshWeaver.Layout/ListboxControl.cs       |  39 +++++-
 src/MeshWeaver.Layout/MainLayoutAreas.cs      |  72 +++++++---
 src/MeshWeaver.Layout/MarkdownControl.cs      |  12 +-
 .../MarkdownControlExtensions.cs              |  70 ++++++----
 src/MeshWeaver.Layout/MenuItemControl.cs      |  24 +++-
 src/MeshWeaver.Layout/ModalArea.cs            |  27 +++-
 src/MeshWeaver.Layout/ModalDialogOptions.cs   |  46 ++++--
 src/MeshWeaver.Layout/ModuleSetup.cs          |  23 ++-
 src/MeshWeaver.Layout/NamedAreaControl.cs     |  25 +++-
 src/MeshWeaver.Layout/NavMenuControl.cs       |  47 ++++++-
 src/MeshWeaver.Layout/NumberFieldControl.cs   |  73 ++++++++--
 src/MeshWeaver.Layout/Orientation.cs          |  21 ++-
 src/MeshWeaver.Layout/PropertyLayout.cs       |  13 +-
 src/MeshWeaver.Layout/SelectControl.cs        |  23 ++-
 src/MeshWeaver.Layout/Skin.cs                 |  54 +++++--
 src/MeshWeaver.Layout/Skins.cs                |  39 ++++--
 src/MeshWeaver.Layout/SplitterControl.cs      |  40 +++++-
 src/MeshWeaver.Layout/SplitterPaneSkin.cs     |  60 +++++++-
 src/MeshWeaver.Layout/StyleBuilder.cs         |  92 ++++++++++++
 src/MeshWeaver.Layout/TabsControl.cs          |  55 ++++++--
 src/MeshWeaver.Layout/TextFieldControl.cs     |  52 +++++--
 src/MeshWeaver.Layout/ToolbarControl.cs       |  17 ++-
 src/MeshWeaver.Layout/UiActionContext.cs      |  14 +-
 src/MeshWeaver.Layout/VerticalAlignment.cs    |  27 +++-
 31 files changed, 1087 insertions(+), 269 deletions(-)

diff --git a/src/MeshWeaver.Data.Contract/EntityStore.cs b/src/MeshWeaver.Data.Contract/EntityStore.cs
index b0ee5e3c0..3e011623a 100644
--- a/src/MeshWeaver.Data.Contract/EntityStore.cs
+++ b/src/MeshWeaver.Data.Contract/EntityStore.cs
@@ -147,6 +147,11 @@ public override int GetHashCode()
     => Collections.Values
         .Select(x => x.GetHashCode())
         .Aggregate((x, y) => x ^ y);
+
+    public EntityStoreAndUpdates UpdateControl(string mainContent, MeshWeaver.Layout.NamedAreaControl namedAreaControl)
+    {
+        throw new NotImplementedException();
+    }
 }
 public record EntityStoreAndUpdates(IEnumerable<EntityStoreUpdate> Changes, EntityStore Store);
 
diff --git a/src/MeshWeaver.Layout/LayoutAreaReferenceExtensions.cs b/src/MeshWeaver.Layout/LayoutAreaReferenceExtensions.cs
index df3ec592a..b0bb7b483 100644
--- a/src/MeshWeaver.Layout/LayoutAreaReferenceExtensions.cs
+++ b/src/MeshWeaver.Layout/LayoutAreaReferenceExtensions.cs
@@ -2,23 +2,48 @@
 
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Provides extension methods for working with layout area query strings.
+/// </summary>
 public static class LayoutAreaQueryString
 {
     private const string QueryStringParams = nameof(QueryStringParams);
 
+    /// <summary>
+    /// Gets the query string parameters for the specified layout area.
+    /// </summary>
+    /// <param name="layoutArea">The layout area host.</param>
+    /// <returns>A read-only collection of key-value pairs representing the query string parameters.</returns>
     public static IReadOnlyCollection<KeyValuePair<string, string>> GetQueryStringParams(this LayoutAreaHost layoutArea)
         => layoutArea.GetOrAddVariable(QueryStringParams, () => Parse((string)layoutArea.Stream.Reference.Id));
 
+    /// <summary>
+    /// Gets the value of the specified query string parameter for the layout area.
+    /// </summary>
+    /// <param name="layoutArea">The layout area host.</param>
+    /// <param name="key">The key of the query string parameter.</param>
+    /// <returns>The value of the query string parameter, or <c>null</c> if the parameter is not found.</returns>
     public static string GetQueryStringParamValue(this LayoutAreaHost layoutArea, string key)
         => layoutArea.GetQueryStringParams()
             .FirstOrDefault(x => x.Key == key).Value;
     
+    /// <summary>
+    /// Gets the values of the specified query string parameter for the layout area.
+    /// </summary>
+    /// <param name="layoutArea">The layout area host.</param>
+    /// <param name="key">The key of the query string parameter.</param>
+    /// <returns>A read-only collection of values for the query string parameter.</returns>
     public static IReadOnlyCollection<string> GetQueryStringParamValues(this LayoutAreaHost layoutArea, string key)
         => layoutArea.GetQueryStringParams()
             .Where(x => x.Key == key)
             .Select(x => x.Value)
             .ToArray();
 
+    /// <summary>
+    /// Parses the specified query string into a collection of key-value pairs.
+    /// </summary>
+    /// <param name="queryString">The query string to parse.</param>
+    /// <returns>A read-only collection of key-value pairs representing the parsed query string parameters.</returns>
     public static IReadOnlyCollection<KeyValuePair<string, string>> Parse(string queryString)
     {
         var values = new List<KeyValuePair<string, string>>();
@@ -32,10 +57,7 @@ public static IReadOnlyCollection<KeyValuePair<string, string>> Parse(string que
 
                 if (keyValue.Length == 2)
                 {
-                    var key = Uri.UnescapeDataString(keyValue[0]);
-                    var value = Uri.UnescapeDataString(keyValue[1]);
-                    
-                    values.Add(new (key, value));
+                    values.Add(new KeyValuePair<string, string>(keyValue[0], keyValue[1]));
                 }
             }
         }
diff --git a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
index 21cb11e57..70fd0400b 100644
--- a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
+++ b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
@@ -4,20 +4,44 @@
 
 namespace MeshWeaver.Layout;
 
-public static class LayoutDefinitionExtensions{
-
+/// <summary>
+/// Provides extension methods for working with layout definitions.
+/// </summary>
+public static class LayoutDefinitionExtensions
+{
+    /// <summary>
+    /// Adds a view to the layout definition with the specified context and generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="context">The context function to determine when to render the view.</param>
+    /// <param name="generator">The generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         Func<RenderingContext, bool> context,
         Func<LayoutAreaHost, RenderingContext, IObservable<object>> generator
     ) =>
-        layout.WithRenderer(context, (a, ctx, s) => a.RenderArea(ctx, generator.Invoke(a,ctx), s));
-
+        layout.WithRenderer(context, (a, ctx, s) => a.RenderArea(ctx, generator.Invoke(a, ctx), s));
+
+    /// <summary>
+    /// Adds a view to the layout definition for the specified area and generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="area">The area to render the view.</param>
+    /// <param name="generator">The generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         string area,
         Func<LayoutAreaHost, RenderingContext, IObservable<object>> generator
     ) =>
         layout.WithView(c => c.Area == area, generator);
 
+    /// <summary>
+    /// Adds a view to the layout definition with the specified context and observable generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="context">The context function to determine when to render the view.</param>
+    /// <param name="generator">The observable generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         Func<RenderingContext, bool> context,
         IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
@@ -29,95 +53,29 @@ IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
             )
         );
 
+    /// <summary>
+    /// Adds a view to the layout definition for the specified area and observable generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="area">The area to render the view.</param>
+    /// <param name="generator">The observable generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         string area,
         IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
-    )
-        => layout.WithView(c => c.Area == area, generator);
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout,
-        Func<RenderingContext, bool> context,
-        IObservable<Func<LayoutAreaHost, RenderingContext, Task<object>>> generator
-    ) => WithView(layout, context, generator.Cast<ViewDefinition<object>>());
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout,
-        string area,
-        IObservable<Func<LayoutAreaHost, RenderingContext, Task<object>>> generator
-    ) => layout.WithView(c => c.Area == area, generator);
-
-    public static LayoutDefinition WithView<T>(
-        this LayoutDefinition layout,
-        Func<RenderingContext, bool> context,
-        Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<T>> generator
-    ) => WithView(layout,
-        context, Observable.Return((ViewDefinition)(async (x, y, z) => await generator(x, y, z))));
-
-    public static LayoutDefinition WithView<T>(
-        this LayoutDefinition layout,
-        string area,
-        Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<T>> generator
-    ) => layout.WithView(c => c.Area == area, generator);
-    public static LayoutDefinition WithView(this LayoutDefinition layout,Func<RenderingContext, bool> context, ViewDefinition generator) =>
-        WithView(
-            layout,
-            context,
-            Observable.Return(generator)
-        );
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout, string area, ViewDefinition generator) =>
-        layout.WithView(ctx => ctx.Area == area, generator);
-    public static LayoutDefinition WithView<T>(this LayoutDefinition layout,
-        Func<RenderingContext, bool> context,
-        IObservable<ViewDefinition<T>> generator
-    ) =>
-        layout.WithRenderer(context, (a, c,s) => a.RenderArea(c, generator,s));
-
-    public static LayoutDefinition WithView<T>(this LayoutDefinition layout,
-        string area,
-        IObservable<ViewDefinition<T>> generator
     ) =>
         layout.WithView(c => c.Area == area, generator);
 
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout,Func<RenderingContext, bool> context, object view) =>
-        layout.WithRenderer(context, (a, c,s) => a.RenderArea(c, view,s));
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout, string area, object view) =>
-        layout.WithView(c => c.Area == area, view);
+    /// <summary>
+    /// Adds a view to the layout definition with the specified context and generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="context">The context function to determine when to render the view.</param>
+    /// <param name="generator">The generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         Func<RenderingContext, bool> context,
-        Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>> view)
-        => layout.WithRenderer(context, (a, c,s) => a.RenderArea(c, view.Invoke, s));
-
-    public static LayoutDefinition WithView(this LayoutDefinition layout,
-        string area,
-        Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>> view)
-        => layout.WithView(c => c.Area == area, view);
-
-    public static LayoutDefinition WithView<T>(
-        this LayoutDefinition layout,
-        Func<RenderingContext, bool> context,
-        Func<LayoutAreaHost, RenderingContext, T> view)
-        => layout.WithView(context, (a, ctx) => Observable.Return<object>(view(a, ctx)));
-
-    public static LayoutDefinition WithView<T>(
-        this LayoutDefinition layout,
-        string area,
-        Func<LayoutAreaHost, RenderingContext, T> view
-    ) => layout.WithView(c => c.Area == area, view);
-
-
-
-
-
-    public static EntityStoreAndUpdates UpdateControl(this EntityStore store, string id, UiControl control)
-        => new([new EntityStoreUpdate(LayoutAreaReference.Areas, id, control)], store.Update(LayoutAreaReference.Areas, i => i.Update(id,control)));
-    public static EntityStoreAndUpdates UpdateData(this EntityStore store, string id, object control)
-        => new([new EntityStoreUpdate(LayoutAreaReference.Data, id, control)], store.Update(LayoutAreaReference.Data, i => i.Update(id, control)));
-
-    public static LayoutDefinition WithRenderer(
-        this LayoutDefinition layout,
-        Func<RenderingContext, bool> filter,
-        Func<LayoutAreaHost, RenderingContext, EntityStore, EntityStoreAndUpdates> renderer)
-        => layout.WithRenderer(filter, renderer.Invoke);
+        Func<LayoutAreaHost, RenderingContext, Task<object>> generator
+    ) =>
+        layout.WithRenderer(context, (a, ctx, s) => a.RenderArea(ctx, generator.Invoke(a, ctx), s));
 }
diff --git a/src/MeshWeaver.Layout/LayoutGridItemHidden.cs b/src/MeshWeaver.Layout/LayoutGridItemHidden.cs
index 50cc802c4..ae2495e0a 100644
--- a/src/MeshWeaver.Layout/LayoutGridItemHidden.cs
+++ b/src/MeshWeaver.Layout/LayoutGridItemHidden.cs
@@ -1,25 +1,98 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Specifies the visibility options for a layout grid item based on screen size.
+    /// </summary>
     public enum LayoutGridItemHidden
     {
+        /// <summary>
+        /// The item is always visible.
+        /// </summary>
         None,
+
+        /// <summary>
+        /// The item is hidden on extra small screens.
+        /// </summary>
         Xs,
+
+        /// <summary>
+        /// The item is hidden on extra small screens and smaller.
+        /// </summary>
         XsAndDown,
+
+        /// <summary>
+        /// The item is hidden on small screens.
+        /// </summary>
         Sm,
+
+        /// <summary>
+        /// The item is hidden on small screens and smaller.
+        /// </summary>
         SmAndDown,
+
+        /// <summary>
+        /// The item is hidden on medium screens.
+        /// </summary>
         Md,
+
+        /// <summary>
+        /// The item is hidden on medium screens and smaller.
+        /// </summary>
         MdAndDown,
+
+        /// <summary>
+        /// The item is hidden on large screens.
+        /// </summary>
         Lg,
+
+        /// <summary>
+        /// The item is hidden on large screens and smaller.
+        /// </summary>
         LgAndDown,
+
+        /// <summary>
+        /// The item is hidden on extra large screens.
+        /// </summary>
         Xl,
+
+        /// <summary>
+        /// The item is hidden on extra large screens and smaller.
+        /// </summary>
         XlAndDown,
+
+        /// <summary>
+        /// The item is hidden on extra extra large screens.
+        /// </summary>
         Xxl,
+
+        /// <summary>
+        /// The item is hidden on extra extra large screens and larger.
+        /// </summary>
         XxlAndUp,
+
+        /// <summary>
+        /// The item is hidden on extra large screens and larger.
+        /// </summary>
         XlAndUp,
+
+        /// <summary>
+        /// The item is hidden on large screens and larger.
+        /// </summary>
         LgAndUp,
+
+        /// <summary>
+        /// The item is hidden on medium screens and larger.
+        /// </summary>
         MdAndUp,
+
+        /// <summary>
+        /// The item is hidden on small screens and larger.
+        /// </summary>
         SmAndUp,
+
+        /// <summary>
+        /// The item is hidden on extra extra large screens and smaller.
+        /// </summary>
         XxlAndDown,
-        XsAndUp
     }
 }
diff --git a/src/MeshWeaver.Layout/LayoutGridItemSkin.cs b/src/MeshWeaver.Layout/LayoutGridItemSkin.cs
index 49880072f..0474e8737 100644
--- a/src/MeshWeaver.Layout/LayoutGridItemSkin.cs
+++ b/src/MeshWeaver.Layout/LayoutGridItemSkin.cs
@@ -1,26 +1,114 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents the skin for a layout grid item with customizable properties.
+    /// </summary>
     public record LayoutGridItemSkin : Skin<LayoutGridItemSkin>
     {
+        /// <summary>
+        /// Gets or initializes the adaptive rendering state of the layout grid item.
+        /// </summary>
         public object AdaptiveRendering { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the justification of the layout grid item.
+        /// </summary>
         public object Justify { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the hidden state of the layout grid item based on conditions.
+        /// </summary>
         public object HiddenWhen { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the gap between items in the layout grid.
+        /// </summary>
         public object Gap { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the large screen size configuration for the layout grid item.
+        /// </summary>
         public object Lg { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the medium screen size configuration for the layout grid item.
+        /// </summary>
         public object Md { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the small screen size configuration for the layout grid item.
+        /// </summary>
         public object Sm { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the extra large screen size configuration for the layout grid item.
+        /// </summary>
         public object Xl { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the extra small screen size configuration for the layout grid item.
+        /// </summary>
         public object Xs { get; init; }
-        public object Xxl { get; init;}
 
+        /// <summary>
+        /// Gets or initializes the extra extra large screen size configuration for the layout grid item.
+        /// </summary>
+        public object Xxl { get; init; }
+
+        /// <summary>
+        /// Sets the adaptive rendering state of the layout grid item.
+        /// </summary>
+        /// <param name="adaptiveRendering">The adaptive rendering state to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified adaptive rendering state.</returns>
         public LayoutGridItemSkin WithAdaptiveRendering(object adaptiveRendering) => this with { AdaptiveRendering = adaptiveRendering };
+
+        /// <summary>
+        /// Sets the gap between items in the layout grid.
+        /// </summary>
+        /// <param name="gap">The gap to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified gap.</returns>
         public LayoutGridItemSkin WithGap(object gap) => this with { Gap = gap };
+
+        /// <summary>
+        /// Sets the large screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="lg">The large screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified large screen size configuration.</returns>
         public LayoutGridItemSkin WithLg(object lg) => this with { Lg = lg };
+
+        /// <summary>
+        /// Sets the medium screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="md">The medium screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified medium screen size configuration.</returns>
         public LayoutGridItemSkin WithMd(object md) => this with { Md = md };
+
+        /// <summary>
+        /// Sets the small screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="sm">The small screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified small screen size configuration.</returns>
         public LayoutGridItemSkin WithSm(object sm) => this with { Sm = sm };
+
+        /// <summary>
+        /// Sets the extra large screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="xl">The extra large screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified extra large screen size configuration.</returns>
         public LayoutGridItemSkin WithXl(object xl) => this with { Xl = xl };
+
+        /// <summary>
+        /// Sets the extra small screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="xs">The extra small screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified extra small screen size configuration.</returns>
         public LayoutGridItemSkin WithXs(object xs) => this with { Xs = xs };
-        public LayoutGridItemSkin WithXxl(object xxl) => this with { Xxl = xxl };
 
+        /// <summary>
+        /// Sets the extra extra large screen size configuration for the layout grid item.
+        /// </summary>
+        /// <param name="xxl">The extra extra large screen size configuration to set.</param>
+        /// <returns>A new <see cref="LayoutGridItemSkin"/> instance with the specified extra extra large screen size configuration.</returns>
+        public LayoutGridItemSkin WithXxl(object xxl) => this with { Xxl = xxl };
     }
-}
+}
\ No newline at end of file
diff --git a/src/MeshWeaver.Layout/LayoutGridSkin.cs b/src/MeshWeaver.Layout/LayoutGridSkin.cs
index f25ef761c..156b354e7 100644
--- a/src/MeshWeaver.Layout/LayoutGridSkin.cs
+++ b/src/MeshWeaver.Layout/LayoutGridSkin.cs
@@ -1,20 +1,60 @@
 namespace MeshWeaver.Layout;
 
 
+/// <summary>
+/// Represents a layout grid control with customizable properties.
+/// </summary>
 public record LayoutGridControl() : ContainerControlWithItemSkin<LayoutGridControl, LayoutGridSkin, LayoutGridItemSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new())
 {
+    /// <summary>
+    /// Creates a new instance of <see cref="LayoutGridItemSkin"/> for the specified named area.
+    /// </summary>
+    /// <param name="namedArea">The named area control.</param>
+    /// <returns>A new instance of <see cref="LayoutGridItemSkin"/>.</returns>
     protected override LayoutGridItemSkin CreateItemSkin(NamedAreaControl namedArea)
     {
         return new();
     }
 }
+
+/// <summary>
+/// Represents the skin for a layout grid control with customizable properties.
+/// </summary>
 public record LayoutGridSkin : Skin<LayoutGridSkin>
 {
+    /// <summary>
+    /// Gets or initializes the adaptive rendering state of the layout grid.
+    /// </summary>
     public object AdaptiveRendering { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the justification of the layout grid.
+    /// </summary>
     public object Justify { get; init; }
+
+    /// <summary>
+    /// Gets or initializes the spacing between items in the layout grid.
+    /// </summary>
     public object Spacing { get; init; }
 
+    /// <summary>
+    /// Sets the adaptive rendering state of the layout grid.
+    /// </summary>
+    /// <param name="adaptiveRendering">The adaptive rendering state to set.</param>
+    /// <returns>A new <see cref="LayoutGridSkin"/> instance with the specified adaptive rendering state.</returns>
     public LayoutGridSkin WithAdaptiveRendering(object adaptiveRendering) => this with { AdaptiveRendering = adaptiveRendering };
+
+    /// <summary>
+    /// Sets the justification of the layout grid.
+    /// </summary>
+    /// <param name="justify">The justification to set.</param>
+    /// <returns>A new <see cref="LayoutGridSkin"/> instance with the specified justification.</returns>
     public LayoutGridSkin WithJustify(object justify) => this with { Justify = justify };
+
+    /// <summary>
+    /// Sets the spacing between items in the layout grid.
+    /// </summary>
+    /// <param name="spacing">The spacing to set.</param>
+    /// <returns>A new <see cref="LayoutGridSkin"/> instance with the specified spacing.</returns>
     public LayoutGridSkin WithSpacing(object spacing) => this with { Spacing = spacing };
 }
diff --git a/src/MeshWeaver.Layout/LayoutSkin.cs b/src/MeshWeaver.Layout/LayoutSkin.cs
index 7be0a1408..bc4d623b7 100644
--- a/src/MeshWeaver.Layout/LayoutSkin.cs
+++ b/src/MeshWeaver.Layout/LayoutSkin.cs
@@ -1,5 +1,12 @@
-namespace MeshWeaver.Layout;
-
-
-public record SpacerControl() : UiControl<SpacerControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion);
+namespace MeshWeaver.Layout
+{
+	/// <summary>
+	/// Represents a spacer control with customizable properties.
+	/// </summary>
+	/// <remarks>
+	/// For more information, visit the 
+	/// <a href="https://www.fluentui-blazor.net/spacer">Fluent UI Blazor Spacer documentation</a>.
+	/// </remarks>
+	public record SpacerControl() : UiControl<SpacerControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion);
+}
 
diff --git a/src/MeshWeaver.Layout/ListboxControl.cs b/src/MeshWeaver.Layout/ListboxControl.cs
index 84045f293..16c438148 100644
--- a/src/MeshWeaver.Layout/ListboxControl.cs
+++ b/src/MeshWeaver.Layout/ListboxControl.cs
@@ -1,26 +1,59 @@
-
-using MeshWeaver.Domain.Layout;
+using MeshWeaver.Domain.Layout;
 
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Represents a listbox control with customizable properties.
+/// </summary>
+/// <param name="Data">The data associated with the listbox control.</param>
 public record ListboxControl(object Data) : ListControlBase<ListboxControl>(Data), IListControl;
 
+/// <summary>
+/// Represents a list control interface with options.
+/// </summary>
 public interface IListControl : IFormComponent
 {
+    /// <summary>
+    /// Gets or initializes the options for the list control.
+    /// </summary>
     IReadOnlyCollection<Option> Options { get; init; }
 }
 
+/// <summary>
+/// Represents the base class for list controls with customizable properties.
+/// </summary>
+/// <typeparam name="TControl">The type of the list control.</typeparam>
+/// <param name="Data">The data associated with the list control.</param>
 public abstract record ListControlBase<TControl>(object Data)
     : UiControl<TControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion)
     where TControl : ListControlBase<TControl>, IListControl
 {
+    /// <summary>
+    /// Gets or initializes the options for the list control.
+    /// </summary>
     public IReadOnlyCollection<Option> Options { get; init; }
 
-    public TControl WithOptions(IReadOnlyCollection<Option> options) => (TControl) this with { Options = options };
+    /// <summary>
+    /// Sets the options for the list control.
+    /// </summary>
+    /// <param name="options">The options to set.</param>
+    /// <returns>A new instance of the list control with the specified options.</returns>
+    public TControl WithOptions(IReadOnlyCollection<Option> options) => (TControl)this with { Options = options };
 
+    /// <summary>
+    /// Sets the options for the list control from an enumerable collection.
+    /// </summary>
+    /// <typeparam name="T">The type of the options.</typeparam>
+    /// <param name="options">The options to set.</param>
+    /// <returns>A new instance of the list control with the specified options.</returns>
     public TControl WithOptions<T>(IEnumerable<T> options) => 
         WithOptions(options.Select(o => (Option)new Option<T>(o, o.ToString())).ToArray());
 
+    /// <summary>
+    /// Determines whether the specified list control is equal to the current list control.
+    /// </summary>
+    /// <param name="other">The list control to compare with the current list control.</param>
+    /// <returns><c>true</c> if the specified list control is equal to the current list control; otherwise, <c>false</c>.</returns>
     public virtual bool Equals(ListControlBase<TControl> other)
     {
         if (ReferenceEquals(null, other)) return false;
diff --git a/src/MeshWeaver.Layout/MainLayoutAreas.cs b/src/MeshWeaver.Layout/MainLayoutAreas.cs
index 7522c97d0..f3490790d 100644
--- a/src/MeshWeaver.Layout/MainLayoutAreas.cs
+++ b/src/MeshWeaver.Layout/MainLayoutAreas.cs
@@ -1,22 +1,56 @@
-namespace MeshWeaver.Layout;
-
-public static class Area
+namespace MeshWeaver.Layout
 {
-    public const string SideMenu = nameof(SideMenu);
-    public const string Main = nameof(Main);
-    public const string Toolbar = nameof(Toolbar);
-    public const string ContextMenu = nameof(ContextMenu);
-    public const string StatusBar = nameof(StatusBar);
-    public const string Modal = nameof(Modal);
-    public const string Window = nameof(Window);
-
-    internal static readonly IReadOnlyCollection<string> All = new HashSet<string>
+    /// <summary>
+    /// Provides constants for different layout areas.
+    /// </summary>
+    public static class Area
     {
-        SideMenu,
-        Toolbar,
-        Main,
-        ContextMenu,
-        StatusBar,
-        Modal
-    };
+        /// <summary>
+        /// Represents the side menu area.
+        /// </summary>
+        public const string SideMenu = nameof(SideMenu);
+
+        /// <summary>
+        /// Represents the main content area.
+        /// </summary>
+        public const string Main = nameof(Main);
+
+        /// <summary>
+        /// Represents the toolbar area.
+        /// </summary>
+        public const string Toolbar = nameof(Toolbar);
+
+        /// <summary>
+        /// Represents the context menu area.
+        /// </summary>
+        public const string ContextMenu = nameof(ContextMenu);
+
+        /// <summary>
+        /// Represents the status bar area.
+        /// </summary>
+        public const string StatusBar = nameof(StatusBar);
+
+        /// <summary>
+        /// Represents the modal area.
+        /// </summary>
+        public const string Modal = nameof(Modal);
+
+        /// <summary>
+        /// Represents the window area.
+        /// </summary>
+        public const string Window = nameof(Window);
+
+        /// <summary>
+        /// Gets a read-only collection of all layout areas.
+        /// </summary>
+        internal static readonly IReadOnlyCollection<string> All = new HashSet<string>
+        {
+            SideMenu,
+            Toolbar,
+            Main,
+            ContextMenu,
+            StatusBar,
+            Modal
+        };
+    }
 }
diff --git a/src/MeshWeaver.Layout/MarkdownControl.cs b/src/MeshWeaver.Layout/MarkdownControl.cs
index 1ccebe632..000ac751e 100644
--- a/src/MeshWeaver.Layout/MarkdownControl.cs
+++ b/src/MeshWeaver.Layout/MarkdownControl.cs
@@ -1,4 +1,10 @@
 
-namespace MeshWeaver.Layout;
-public record MarkdownControl(object Data)
-    : UiControl<MarkdownControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion);
+namespace MeshWeaver.Layout
+{
+    /// <summary>
+    /// Represents a markdown control with customizable properties.
+    /// </summary>
+    /// <param name="Data">The data associated with the markdown control.</param>
+    public record MarkdownControl(object Data)
+        : UiControl<MarkdownControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion);
+}
diff --git a/src/MeshWeaver.Layout/MarkdownControlExtensions.cs b/src/MeshWeaver.Layout/MarkdownControlExtensions.cs
index bbfa59f65..a54a9c190 100644
--- a/src/MeshWeaver.Layout/MarkdownControlExtensions.cs
+++ b/src/MeshWeaver.Layout/MarkdownControlExtensions.cs
@@ -2,35 +2,51 @@
 using System.Text;
 using MeshWeaver.Utils;
 
-namespace MeshWeaver.Layout;
-
-public static class MarkdownControlExtensions {
-
-    public static MarkdownControl ToMarkdown<T>(this IEnumerable<T> items) 
-        => Controls.Markdown(FormatAsTable(items));
-
-    private static string FormatAsTable<T>(IEnumerable<T> items)
+namespace MeshWeaver.Layout
+{
+    /// <summary>
+    /// Provides extension methods for working with <see cref="MarkdownControl"/>.
+    /// </summary>
+    public static class MarkdownControlExtensions
     {
-        var itemsArray = items as T[] ?? items.ToArray();
-
-        if (itemsArray.Length == 0)
+        /// <summary>
+        /// Converts the specified items to a markdown table.
+        /// </summary>
+        /// <typeparam name="T">The type of the items.</typeparam>
+        /// <param name="items">The items to convert to a markdown table.</param>
+        /// <returns>A <see cref="MarkdownControl"/> containing the markdown table.</returns>
+        public static MarkdownControl ToMarkdown<T>(this IEnumerable<T> items) 
+            => Controls.Markdown(FormatAsTable(items));
+
+        /// <summary>
+        /// Formats the specified items as a markdown table.
+        /// </summary>
+        /// <typeparam name="T">The type of the items.</typeparam>
+        /// <param name="items">The items to format as a markdown table.</param>
+        /// <returns>A string containing the markdown table.</returns>
+        private static string FormatAsTable<T>(IEnumerable<T> items)
         {
-            return string.Empty;
+            var itemsArray = items as T[] ?? items.ToArray();
+
+            if (itemsArray.Length == 0)
+            {
+                return string.Empty;
+            }
+
+            var properties = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
+            var header = string.Join(" | ", properties.Select(p => p.Name.Wordify()));
+            var separator = string.Join(" | ", properties.Select(p => "---"));
+            var rows = itemsArray.Select(item => string.Join(" | ", properties.Select(p => p.GetValue(item)?.ToString() ?? string.Empty)));
+
+            var sb = new StringBuilder();
+            sb.AppendLine(header);
+            sb.AppendLine(separator);
+            foreach (var row in rows)
+            {
+                sb.AppendLine(row);
+            }
+
+            return sb.ToString();
         }
-
-        var properties = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
-        var header = string.Join(" | ", properties.Select(p => p.Name.Wordify()));
-        var separator = string.Join(" | ", properties.Select(p => "---"));
-        var rows = itemsArray.Select(item => string.Join(" | ", properties.Select(p => p.GetValue(item)?.ToString() ?? string.Empty)));
-
-        var sb = new StringBuilder();
-        sb.AppendLine(header);
-        sb.AppendLine(separator);
-        foreach (var row in rows)
-        {
-            sb.AppendLine(row);
-        }
-
-        return sb.ToString();
     }
 }
diff --git a/src/MeshWeaver.Layout/MenuItemControl.cs b/src/MeshWeaver.Layout/MenuItemControl.cs
index b97162b81..ca140d241 100644
--- a/src/MeshWeaver.Layout/MenuItemControl.cs
+++ b/src/MeshWeaver.Layout/MenuItemControl.cs
@@ -1,15 +1,31 @@
 namespace MeshWeaver.Layout;
-
+ /// <summary>
+    /// Represents a menu item control with a title and an icon.
+    /// </summary>
+    /// <param name="Title">The title of the menu item.</param>
+    /// <param name="Icon">The icon of the menu item.</param>
 public record MenuItemControl(object Title, object Icon)
     : ContainerControl<MenuItemControl, MenuItemSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new(Title, Icon))
 {
 }
-
+ /// <summary>
+    /// Represents the skin for a menu item control with a title and an icon.
+    /// </summary>
+    /// <param name="Title">The title of the menu item skin.</param>
+    /// <param name="Icon">The icon of the menu item skin.</param>
 public record MenuItemSkin(object Title, object Icon) : Skin<MenuItemSkin>
 {
-
+/// <summary>
+        /// Sets the title of the menu item skin.
+        /// </summary>
+        /// <param name="title">The title to set.</param>
+        /// <returns>A new <see cref="MenuItemSkin"/> instance with the specified title.</returns>
     public MenuItemSkin WithTitle(object title) => this with { Title = title };
-
+/// <summary>
+        /// Sets the icon of the menu item skin.
+        /// </summary>
+        /// <param name="icon">The icon to set.</param>
+        /// <returns>A new <see cref="MenuItemSkin"/> instance with the specified icon.</returns>
     public MenuItemSkin WithIcon(object icon) => this with { Icon = icon };
 
 
diff --git a/src/MeshWeaver.Layout/ModalArea.cs b/src/MeshWeaver.Layout/ModalArea.cs
index 104d0e3d2..ecde52ec7 100644
--- a/src/MeshWeaver.Layout/ModalArea.cs
+++ b/src/MeshWeaver.Layout/ModalArea.cs
@@ -1,8 +1,23 @@
-namespace MeshWeaver.Layout;
-
-public static class ModalArea
+namespace MeshWeaver.Layout
 {
-    public const string Header = nameof(Header);
-    public const string Main = nameof(Main);
-    public const string Footer = nameof(Footer);
+    /// <summary>
+    /// Provides constants for different modal areas.
+    /// </summary>
+    public static class ModalArea
+    {
+        /// <summary>
+        /// Represents the header area of the modal.
+        /// </summary>
+        public const string Header = nameof(Header);
+
+        /// <summary>
+        /// Represents the main content area of the modal.
+        /// </summary>
+        public const string Main = nameof(Main);
+
+        /// <summary>
+        /// Represents the footer area of the modal.
+        /// </summary>
+        public const string Footer = nameof(Footer);
+    }
 }
diff --git a/src/MeshWeaver.Layout/ModalDialogOptions.cs b/src/MeshWeaver.Layout/ModalDialogOptions.cs
index a926a5747..f3512105f 100644
--- a/src/MeshWeaver.Layout/ModalDialogOptions.cs
+++ b/src/MeshWeaver.Layout/ModalDialogOptions.cs
@@ -1,17 +1,39 @@
-namespace MeshWeaver.Layout;
-
-// TODO V10: Is this used anywhere? (23.03.2024, Roland Bürgi)
-public record ModalDialogOptions(string Size, bool IsClosable)
+namespace MeshWeaver.Layout
 {
-    public ModalDialogOptions()
-        :this(Sizes.Medium, false)
+    /// <summary>
+    /// Represents the options for a modal dialog.
+    /// </summary>
+    /// <param name="Size">The size of the modal dialog.</param>
+    /// <param name="IsClosable">Indicates whether the modal dialog is closable.</param>
+    public record ModalDialogOptions(string Size, bool IsClosable)
     {
-    }
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ModalDialogOptions"/> class with default values.
+        /// </summary>
+        public ModalDialogOptions()
+            : this(Sizes.Medium, false)
+        {
+        }
 
-    public static class Sizes
-    {
-        public const string Medium = "M";
-        public const string Large = "L";
-        public const string Small = "S";
+        /// <summary>
+        /// Provides constants for different modal dialog sizes.
+        /// </summary>
+        public static class Sizes
+        {
+            /// <summary>
+            /// Represents a medium-sized modal dialog.
+            /// </summary>
+            public const string Medium = "M";
+
+            /// <summary>
+            /// Represents a large-sized modal dialog.
+            /// </summary>
+            public const string Large = "L";
+
+            /// <summary>
+            /// Represents a small-sized modal dialog.
+            /// </summary>
+            public const string Small = "S";
+        }
     }
 }
\ No newline at end of file
diff --git a/src/MeshWeaver.Layout/ModuleSetup.cs b/src/MeshWeaver.Layout/ModuleSetup.cs
index 388fb8ac9..29d10f1d9 100644
--- a/src/MeshWeaver.Layout/ModuleSetup.cs
+++ b/src/MeshWeaver.Layout/ModuleSetup.cs
@@ -1,8 +1,19 @@
-namespace MeshWeaver.Layout;
-
-public static class ModuleSetup
+namespace MeshWeaver.Layout
 {
-    public const string ModuleName = "MeshWeaver.Layout";
+    /// <summary>
+    /// Provides constants for module setup, including module name and API version.
+    /// </summary>
+    public static class ModuleSetup
+    {
+        /// <summary>
+        /// The name of the module.
+        /// </summary>
+        public const string ModuleName = "MeshWeaver.Layout";
+
+        /// <summary>
+        /// The version of the API.
+        /// </summary>
+        public const string ApiVersion = "1.0.0";
+    }
+}
 
-    public const string ApiVersion = "1.0.0";
-}
\ No newline at end of file
diff --git a/src/MeshWeaver.Layout/NamedAreaControl.cs b/src/MeshWeaver.Layout/NamedAreaControl.cs
index dd197fe1c..699e9a8cc 100644
--- a/src/MeshWeaver.Layout/NamedAreaControl.cs
+++ b/src/MeshWeaver.Layout/NamedAreaControl.cs
@@ -1,17 +1,36 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents a named area control with customizable properties.
+    /// </summary>
+    /// <param name="Area">The area associated with the named area control.</param>
     public record NamedAreaControl(object Area)
         : UiControl<NamedAreaControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion)
     {
+        /// <summary>
+        /// Gets or initializes the display area of the named area control.
+        /// </summary>
         public object DisplayArea { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the progress display state of the named area control.
+        /// </summary>
         public object ShowProgress { get; init; }
 
+        /// <summary>
+        /// Sets the area of the named area control.
+        /// </summary>
+        /// <param name="area">The area to set.</param>
+        /// <returns>A new <see cref="NamedAreaControl"/> instance with the specified area.</returns>
         public NamedAreaControl WithArea(object area)
             => this with { Area = area };
 
+        /// <summary>
+        /// Sets the display area of the named area control.
+        /// </summary>
+        /// <param name="displayArea">The display area to set.</param>
+        /// <returns>A new <see cref="NamedAreaControl"/> instance with the specified display area.</returns>
         public NamedAreaControl WithDisplayArea(object displayArea)
-        => this with { DisplayArea = displayArea };
-
-
+            => this with { DisplayArea = displayArea };
     }
 }
diff --git a/src/MeshWeaver.Layout/NavMenuControl.cs b/src/MeshWeaver.Layout/NavMenuControl.cs
index c36a9adae..a2d5f4af6 100644
--- a/src/MeshWeaver.Layout/NavMenuControl.cs
+++ b/src/MeshWeaver.Layout/NavMenuControl.cs
@@ -1,22 +1,65 @@
 namespace MeshWeaver.Layout;
-
+/// <summary>
+    /// Represents the skin for a navigation menu with customizable properties.
+    /// </summary>
 public record NavMenuSkin : Skin<NavMenuSkin>
 {
+     /// <summary>
+        /// Gets or initializes the width of the navigation menu.
+        /// </summary>
     public object Width { get; init; }= 250;
+    /// <summary>
+        /// Gets or initializes the collapsible state of the navigation menu.
+        /// </summary>
     public object Collapsible { get; init; } = true;
+    /// <summary>
+        /// Sets the collapsible state of the navigation menu.
+        /// </summary>
+        /// <param name="collapsible">The collapsible state to set.</param>
+        /// <returns>A new <see cref="NavMenuSkin"/> instance with the specified collapsible state.</returns>
     public NavMenuSkin WithCollapsible(bool collapsible) => this with { Collapsible = collapsible };
-
+/// <summary>
+        /// Sets the width of the navigation menu.
+        /// </summary>
+        /// <param name="width">The width to set.</param>
+        /// <returns>A new <see cref="NavMenuSkin"/> instance with the specified width.</returns>
     public NavMenuSkin WithWidth(int width) => this with { Width = width };
 
 }
+ /// <summary>
+    /// Represents a navigation menu control with customizable properties.
+    /// </summary>
 public record NavMenuControl() : ContainerControl<NavMenuControl, NavMenuSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new())
 {
+    /// <summary>
+        /// Adds a navigation link to the navigation menu.
+        /// </summary>
+        /// <param name="title">The title of the navigation link.</param>
+        /// <param name="href">The href of the navigation link.</param>
+        /// <returns>A new <see cref="NavMenuControl"/> instance with the specified navigation link.</returns>
     public NavMenuControl WithNavLink(object title, object href) =>
         WithView(new NavLinkControl(title, null,href));
+        /// <summary>
+        /// Adds a navigation link with an icon to the navigation menu.
+        /// </summary>
+        /// <param name="title">The title of the navigation link.</param>
+        /// <param name="href">The href of the navigation link.</param>
+        /// <param name="icon">The icon of the navigation link.</param>
+        /// <returns>A new <see cref="NavMenuControl"/> instance with the specified navigation link and icon.</returns>
     public NavMenuControl WithNavLink(object title, object href, object icon) =>
         WithView(new NavLinkControl(title, icon, href))
         ;
+         /// <summary>
+        /// Adds a navigation link control to the navigation menu.
+        /// </summary>
+        /// <param name="navLink">The navigation link control to add.</param>
+        /// <returns>A new <see cref="NavMenuControl"/> instance with the specified navigation link control.</returns>
     public NavMenuControl WithNavLink(NavLinkControl navLink) => WithView(navLink);
+/// <summary>
+        /// Adds a navigation group control to the navigation menu.
+        /// </summary>
+        /// <param name="navGroup">The navigation group control to add.</param>
+        /// <returns>A new <see cref="NavMenuControl"/> instance with the specified navigation group control.</returns>
 
     public NavMenuControl WithNavGroup(NavGroupControl navGroup) =>
         WithView(navGroup);
diff --git a/src/MeshWeaver.Layout/NumberFieldControl.cs b/src/MeshWeaver.Layout/NumberFieldControl.cs
index 5739608ab..19d62ebd3 100644
--- a/src/MeshWeaver.Layout/NumberFieldControl.cs
+++ b/src/MeshWeaver.Layout/NumberFieldControl.cs
@@ -1,16 +1,61 @@
-namespace MeshWeaver.Layout;
-
-public record NumberFieldControl(object Data, string Type)
-    : UiControl<NumberFieldControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion), IFormComponent
+namespace MeshWeaver.Layout
 {
-    public object HideStep { get; init; }
-    public object DataList { get; init; }
-    public object MaxLength { get; init; }
-    public object MinLength { get; init; }
-    public object Size { get; init; }
-    public object Step { get; init; }
-    public object Min { get; init; }
-    public object Max { get; init; }
-    public object Appearance { get; init; }
-    public object ParsingErrorMessage { get; init; }
+    /// <summary>
+    /// Represents a number field control with customizable properties.
+    /// </summary>
+    /// <param name="Data">The data associated with the number field control.</param>
+    /// <param name="Type">The type of the number field control.</param>
+    public record NumberFieldControl(object Data, string Type)
+        : UiControl<NumberFieldControl>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion), IFormComponent
+    {
+        /// <summary>
+        /// Gets or initializes the state to hide the step value for the number field control.
+        /// </summary>
+        public object HideStep { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the data list for the number field control.
+        /// </summary>
+        public object DataList { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the maximum length for the number field control.
+        /// </summary>
+        public object MaxLength { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the minimum length for the number field control.
+        /// </summary>
+        public object MinLength { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the size of the number field control.
+        /// </summary>
+        public object Size { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the step value for the number field control.
+        /// </summary>
+        public object Step { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the minimum value for the number field control.
+        /// </summary>
+        public object Min { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the maximum value for the number field control.
+        /// </summary>
+        public object Max { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the appearance of the number field control.
+        /// </summary>
+        public object Appearance { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the parsing error message for the number field control.
+        /// </summary>
+        public object ParsingErrorMessage { get; init; }
+    }
 }
diff --git a/src/MeshWeaver.Layout/Orientation.cs b/src/MeshWeaver.Layout/Orientation.cs
index 819b7b777..c347dc69e 100644
--- a/src/MeshWeaver.Layout/Orientation.cs
+++ b/src/MeshWeaver.Layout/Orientation.cs
@@ -1,7 +1,18 @@
-namespace MeshWeaver.Layout;
-
-public enum  Orientation
+namespace MeshWeaver.Layout
 {
-    Horizontal,
-    Vertical
+    /// <summary>
+    /// Specifies the orientation options for a control.
+    /// </summary>
+    public enum Orientation
+    {
+        /// <summary>
+        /// The control is oriented horizontally.
+        /// </summary>
+        Horizontal,
+
+        /// <summary>
+        /// The control is oriented vertically.
+        /// </summary>
+        Vertical
+    }
 }
diff --git a/src/MeshWeaver.Layout/PropertyLayout.cs b/src/MeshWeaver.Layout/PropertyLayout.cs
index 9faee89b7..0510db788 100644
--- a/src/MeshWeaver.Layout/PropertyLayout.cs
+++ b/src/MeshWeaver.Layout/PropertyLayout.cs
@@ -1,3 +1,10 @@
-namespace MeshWeaver.Layout;
-
-public record PropertyLayout(string SystemName, string DisplayName, IUiControl Control);
\ No newline at end of file
+namespace MeshWeaver.Layout
+{
+	/// <summary>
+	/// Represents the layout of a property with a system name, display name, and associated control.
+	/// </summary>
+	/// <param name="SystemName">The system name of the property.</param>
+	/// <param name="DisplayName">The display name of the property.</param>
+	/// <param name="Control">The UI control associated with the property.</param>
+	public record PropertyLayout(string SystemName, string DisplayName, IUiControl Control);
+}
diff --git a/src/MeshWeaver.Layout/SelectControl.cs b/src/MeshWeaver.Layout/SelectControl.cs
index 04309089e..985fd3663 100644
--- a/src/MeshWeaver.Layout/SelectControl.cs
+++ b/src/MeshWeaver.Layout/SelectControl.cs
@@ -1,8 +1,21 @@
-namespace MeshWeaver.Layout;
-
-public record SelectControl(object Data) : ListControlBase<SelectControl>(Data), IListControl
+namespace MeshWeaver.Layout
 {
-    public SelectPosition? Position { get; init; }
+    /// <summary>
+    /// Represents a select control with customizable properties.
+    /// </summary>
+    /// <param name="Data">The data associated with the select control.</param>
+    public record SelectControl(object Data) : ListControlBase<SelectControl>(Data), IListControl
+    {
+        /// <summary>
+        /// Gets or initializes the position of the select control.
+        /// </summary>
+        public SelectPosition? Position { get; init; }
 
-    SelectControl WithPosition(SelectPosition position) => this with { Position = position };
+        /// <summary>
+        /// Sets the position of the select control.
+        /// </summary>
+        /// <param name="position">The position to set.</param>
+        /// <returns>A new <see cref="SelectControl"/> instance with the specified position.</returns>
+        public SelectControl WithPosition(SelectPosition position) => this with { Position = position };
+    }
 }
diff --git a/src/MeshWeaver.Layout/Skin.cs b/src/MeshWeaver.Layout/Skin.cs
index 765d9bd09..0b7cd2c13 100644
--- a/src/MeshWeaver.Layout/Skin.cs
+++ b/src/MeshWeaver.Layout/Skin.cs
@@ -1,15 +1,47 @@
-namespace MeshWeaver.Layout;
-
-public abstract record Skin;
-public abstract record Skin<TSkin> : Skin
-where TSkin: Skin<TSkin>
+namespace MeshWeaver.Layout
 {
-    protected TSkin This => (TSkin)this;
-    public object Class { get; init; }
-    public object Style { get; init; }
-    public TSkin WithClass(object @class) => This with { Class = @class };
-    public TSkin WithStyle(object style) => This with { Style = style };
+    /// <summary>
+    /// Represents the base class for skins.
+    /// </summary>
+    public abstract record Skin;
+
+    /// <summary>
+    /// Represents a generic skin with customizable properties.
+    /// </summary>
+    /// <typeparam name="TSkin">The type of the skin.</typeparam>
+    public abstract record Skin<TSkin> : Skin
+    where TSkin : Skin<TSkin>
+    {
+        /// <summary>
+        /// Gets the current instance of the skin.
+        /// </summary>
+        protected TSkin This => (TSkin)this;
+
+        /// <summary>
+        /// Gets or initializes the CSS class of the skin.
+        /// </summary>
+        public object Class { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the style of the skin.
+        /// </summary>
+        public object Style { get; init; }
 
+        /// <summary>
+        /// Sets the CSS class of the skin.
+        /// </summary>
+        /// <param name="class">The CSS class to set.</param>
+        /// <returns>A new instance of the skin with the specified CSS class.</returns>
+        public TSkin WithClass(object @class) => This with { Class = @class };
+
+        /// <summary>
+        /// Sets the style of the skin.
+        /// </summary>
+        /// <param name="style">The style to set.</param>
+        /// <returns>A new instance of the skin with the specified style.</returns>
+        public TSkin WithStyle(object style) => This with { Style = style };
+    }
+}
     //public const string Modal = nameof(Modal);
     //public const string ContextMenu = nameof(ContextMenu);
     //public const string Toolbar = nameof(Toolbar);
@@ -21,4 +53,4 @@ public abstract record Skin<TSkin> : Skin
     //public const string GridLayout = nameof(GridLayout);
     //public const string Action = nameof(Action);
     //public const string Link = nameof(Link);
-}
+
diff --git a/src/MeshWeaver.Layout/Skins.cs b/src/MeshWeaver.Layout/Skins.cs
index f000c148d..d406622c1 100644
--- a/src/MeshWeaver.Layout/Skins.cs
+++ b/src/MeshWeaver.Layout/Skins.cs
@@ -1,10 +1,33 @@
-namespace MeshWeaver.Layout;
-
-public static class Skins
+namespace MeshWeaver.Layout
 {
-    public static BodyContentSkin BodyContent => new ();
-    public static LayoutSkin Layout => new();
-    public static HeaderSkin Header => new();
-    public static FooterSkin Footer => new();
-    public static CardSkin Card => new();
+    /// <summary>
+    /// Provides static properties to access various skins.
+    /// </summary>
+    public static class Skins
+    {
+        /// <summary>
+        /// Gets the skin for body content.
+        /// </summary>
+        public static BodyContentSkin BodyContent => new();
+
+        /// <summary>
+        /// Gets the skin for layout.
+        /// </summary>
+        public static LayoutSkin Layout => new();
+
+        /// <summary>
+        /// Gets the skin for header.
+        /// </summary>
+        public static HeaderSkin Header => new();
+
+        /// <summary>
+        /// Gets the skin for footer.
+        /// </summary>
+        public static FooterSkin Footer => new();
+
+        /// <summary>
+        /// Gets the skin for card.
+        /// </summary>
+        public static CardSkin Card => new();
+    }
 }
diff --git a/src/MeshWeaver.Layout/SplitterControl.cs b/src/MeshWeaver.Layout/SplitterControl.cs
index e1c914025..25e96b4fb 100644
--- a/src/MeshWeaver.Layout/SplitterControl.cs
+++ b/src/MeshWeaver.Layout/SplitterControl.cs
@@ -1,22 +1,60 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents a splitter control with customizable properties.
+    /// </summary>
     public record SplitterControl() : 
         ContainerControlWithItemSkin<SplitterControl, SplitterSkin, SplitterPaneSkin>
         (ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new SplitterSkin())
     {
+        /// <summary>
+        /// Creates a new instance of <see cref="SplitterPaneSkin"/> for the specified named area.
+        /// </summary>
+        /// <param name="namedArea">The named area control.</param>
+        /// <returns>A new instance of <see cref="SplitterPaneSkin"/>.</returns>
         protected override SplitterPaneSkin CreateItemSkin(NamedAreaControl namedArea)
             => new();
     }
 
+    /// <summary>
+    /// Represents the skin for a splitter control with customizable properties.
+    /// </summary>
     public record SplitterSkin : Skin<SplitterSkin>
     {
+        /// <summary>
+        /// Gets or sets the width of the splitter.
+        /// </summary>
         public object Width { get; set; }
+
+        /// <summary>
+        /// Gets or sets the height of the splitter.
+        /// </summary>
         public object Height { get; set; }
 
+        /// <summary>
+        /// Gets or sets the orientation of the splitter.
+        /// </summary>
         public object Orientation { get; set; }
+
+        /// <summary>
+        /// Sets the width of the splitter.
+        /// </summary>
+        /// <param name="width">The width to set.</param>
+        /// <returns>A new <see cref="SplitterSkin"/> instance with the specified width.</returns>
         public SplitterSkin WithWidth(object width) => this with { Width = width };
+
+        /// <summary>
+        /// Sets the height of the splitter.
+        /// </summary>
+        /// <param name="height">The height to set.</param>
+        /// <returns>A new <see cref="SplitterSkin"/> instance with the specified height.</returns>
         public SplitterSkin WithHeight(object height) => this with { Height = height };
-        public SplitterSkin WithOrientation(object orientation) => this with { Orientation = orientation };
 
+        /// <summary>
+        /// Sets the orientation of the splitter.
+        /// </summary>
+        /// <param name="orientation">The orientation to set.</param>
+        /// <returns>A new <see cref="SplitterSkin"/> instance with the specified orientation.</returns>
+        public SplitterSkin WithOrientation(object orientation) => this with { Orientation = orientation };
     }
 }
diff --git a/src/MeshWeaver.Layout/SplitterPaneSkin.cs b/src/MeshWeaver.Layout/SplitterPaneSkin.cs
index 876398143..5a5d4d9f9 100644
--- a/src/MeshWeaver.Layout/SplitterPaneSkin.cs
+++ b/src/MeshWeaver.Layout/SplitterPaneSkin.cs
@@ -1,22 +1,80 @@
 namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents the skin for a splitter pane with customizable properties.
+    /// </summary>
     public record SplitterPaneSkin : Skin<SplitterPaneSkin>
     {
+        /// <summary>
+        /// Gets or initializes a value indicating whether the pane is collapsible.
+        /// </summary>
         public bool Collapsible { get; init; }
+
+        /// <summary>
+        /// Gets or initializes a value indicating whether the pane is collapsed.
+        /// </summary>
         public bool Collapsed { get; init; }
 
+        /// <summary>
+        /// Gets or initializes the maximum size of the pane.
+        /// </summary>
         public string Max { get; init; }
+
+        /// <summary>
+        /// Gets or initializes the minimum size of the pane.
+        /// </summary>
         public string Min { get; init; }
+
+        /// <summary>
+        /// Gets or initializes a value indicating whether the pane is resizable.
+        /// </summary>
         public bool Resizable { get; init; } = true;
 
+        /// <summary>
+        /// Gets or initializes the size of the pane.
+        /// </summary>
         public string Size { get; init; }
 
+        /// <summary>
+        /// Sets the collapsible state of the pane.
+        /// </summary>
+        /// <param name="collapsible">The collapsible state to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified collapsible state.</returns>
         public SplitterPaneSkin WithCollapsible(bool collapsible) => this with { Collapsible = collapsible };
+
+        /// <summary>
+        /// Sets the collapsed state of the pane.
+        /// </summary>
+        /// <param name="collapsed">The collapsed state to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified collapsed state.</returns>
         public SplitterPaneSkin WithCollapsed(bool collapsed) => this with { Collapsed = collapsed };
+
+        /// <summary>
+        /// Sets the maximum size of the pane.
+        /// </summary>
+        /// <param name="max">The maximum size to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified maximum size.</returns>
         public SplitterPaneSkin WithMax(string max) => this with { Max = max };
+
+        /// <summary>
+        /// Sets the minimum size of the pane.
+        /// </summary>
+        /// <param name="min">The minimum size to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified minimum size.</returns>
         public SplitterPaneSkin WithMin(string min) => this with { Min = min };
+
+        /// <summary>
+        /// Sets the resizable state of the pane.
+        /// </summary>
+        /// <param name="resizable">The resizable state to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified resizable state.</returns>
         public SplitterPaneSkin WithResizable(bool resizable) => this with { Resizable = resizable };
-        public SplitterPaneSkin WithSize(string size) => this with { Size = size };
 
+        /// <summary>
+        /// Sets the size of the pane.
+        /// </summary>
+        /// <param name="size">The size to set.</param>
+        /// <returns>A new <see cref="SplitterPaneSkin"/> instance with the specified size.</returns>
+        public SplitterPaneSkin WithSize(string size) => this with { Size = size };
     }
 }
diff --git a/src/MeshWeaver.Layout/StyleBuilder.cs b/src/MeshWeaver.Layout/StyleBuilder.cs
index 89431c743..c52d4f582 100644
--- a/src/MeshWeaver.Layout/StyleBuilder.cs
+++ b/src/MeshWeaver.Layout/StyleBuilder.cs
@@ -3,25 +3,117 @@
 
 namespace MeshWeaver.Layout;
 
+/// <summary>
+/// Provides methods to build and configure styles dynamically.
+/// </summary>
 public record StyleBuilder
 {
     private ImmutableList<Action<dynamic>> actions = ImmutableList.Create<Action<dynamic>>();
 
+    /// <summary>
+    /// Sets the display style to "flex".
+    /// </summary>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder Flex() => WithDisplay("flex");
+
+    /// <summary>
+    /// Sets the display style.
+    /// </summary>
+    /// <param name="value">The display style value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithDisplay(object value) => With(d => d.Display = value);
+
+    /// <summary>
+    /// Sets the width style.
+    /// </summary>
+    /// <param name="value">The width value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithWidth(object value) => With(d => d.Width = value);
+
+    /// <summary>
+    /// Sets the minimum width style.
+    /// </summary>
+    /// <param name="value">The minimum width value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithMinWidth(object value) => With(d => d.MinWidth = value);
+
+    /// <summary>
+    /// Sets the height style.
+    /// </summary>
+    /// <param name="value">The height value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithHeight(object value) => With(d => d.Height = value);
+
+    /// <summary>
+    /// Sets the flex direction style.
+    /// </summary>
+    /// <param name="value">The flex direction value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithFlexDirection(object value) => With(d => d.FlexDirection = value);
+
+    /// <summary>
+    /// Sets the flex wrap style.
+    /// </summary>
+    /// <param name="value">The flex wrap value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithFlexWrap(object value) => With(d => d.FlexWrap = value);
+
+    /// <summary>
+    /// Sets the flex flow style.
+    /// </summary>
+    /// <param name="value">The flex flow value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithFlexFlow(object value) => With(d => d.FlexFlow = value);
+
+    /// <summary>
+    /// Sets the justify content style.
+    /// </summary>
+    /// <param name="value">The justify content value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithJustifyContent(object value) => With(d => d.JustifyContent = value);
+
+    /// <summary>
+    /// Sets the align content style.
+    /// </summary>
+    /// <param name="value">The align content value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithAlignContent(object value) => With(d => d.AlignContent = value);
+
+    /// <summary>
+    /// Sets the align items style.
+    /// </summary>
+    /// <param name="value">The align items value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithAlignItems(object value) => With(d => d.AlignItems = value);
+
+    /// <summary>
+    /// Sets the gap style.
+    /// </summary>
+    /// <param name="value">The gap value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithGap(object value) => With(d => d.Gap = value);
+
+    /// <summary>
+    /// Sets the row gap style.
+    /// </summary>
+    /// <param name="value">The row gap value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithRowGap(object value) => With(d => d.RowGap = value);
+
+    /// <summary>
+    /// Sets the column gap style.
+    /// </summary>
+    /// <param name="value">The column gap value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithColumnGap(object value) => With(d => d.ColumnGap = value);
+
+    /// <summary>
+    /// Sets the align self style.
+    /// </summary>
+    /// <param name="value">The align self value.</param>
+    /// <returns>The updated <see cref="StyleBuilder"/> instance.</returns>
     public StyleBuilder WithAlignSelf(object value) => With(d => d.AlignSelf = value);
+
     public StyleBuilder WithFlexBasis(object value) => With(d => d.FlexBasis = value);
     public StyleBuilder WithFlexGrow(object value) => With(d => d.FlexGrow = value);
     public StyleBuilder WithFlexShrink(object value) => With(d => d.FlexShrink = value);
diff --git a/src/MeshWeaver.Layout/TabsControl.cs b/src/MeshWeaver.Layout/TabsControl.cs
index 65fdfc50a..5f8216353 100644
--- a/src/MeshWeaver.Layout/TabsControl.cs
+++ b/src/MeshWeaver.Layout/TabsControl.cs
@@ -1,21 +1,46 @@
-namespace MeshWeaver.Layout;
-
-public record TabsControl() :
-    ContainerControlWithItemSkin<TabsControl,TabsSkin,TabSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new())
+namespace MeshWeaver.Layout
 {
+    /// <summary>
+    /// Represents a tabs control with customizable properties.
+    /// </summary>
+    public record TabsControl() :
+        ContainerControlWithItemSkin<TabsControl, TabsSkin, TabSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new())
+    {
+        /// <summary>
+        /// Creates a new instance of <see cref="TabSkin"/> for the specified named area.
+        /// </summary>
+        /// <param name="namedArea">The named area control.</param>
+        /// <returns>A new instance of <see cref="TabSkin"/>.</returns>
+        protected override TabSkin CreateItemSkin(NamedAreaControl namedArea)
+        {
+            return new TabSkin(namedArea.Id);
+        }
+    }
 
-
-    protected override TabSkin CreateItemSkin(NamedAreaControl namedArea)
+    /// <summary>
+    /// Represents the skin for a tabs control with customizable properties.
+    /// </summary>
+    public record TabsSkin : Skin<TabsSkin>
     {
-        return new TabSkin(namedArea.Id);
+        /// <summary>
+        /// Gets or initializes the ID of the active tab.
+        /// </summary>
+        public object ActiveTabId { get; init; }
+
+        /// <summary>
+        /// Gets or sets the orientation of the tabs.
+        /// </summary>
+        public object Orientation { get; set; }
+
+        /// <summary>
+        /// Gets or sets the height of the tabs.
+        /// </summary>
+        public object Height { get; set; }
     }
-}
 
-public record TabsSkin : Skin<TabsSkin>
-{
-    public object ActiveTabId { get; init; }
-    public object Orientation { get; set; }
-    public object Height { get; set; }
+    /// <summary>
+    /// Represents the skin for an individual tab with a label.
+    /// </summary>
+    /// <param name="Label">The label of the tab.</param>
+    public record TabSkin(object Label) : Skin<TabSkin>;
 }
-
-public record TabSkin(object Label) : Skin<TabSkin>;
diff --git a/src/MeshWeaver.Layout/TextFieldControl.cs b/src/MeshWeaver.Layout/TextFieldControl.cs
index e13d752db..ac30ffbd8 100644
--- a/src/MeshWeaver.Layout/TextFieldControl.cs
+++ b/src/MeshWeaver.Layout/TextFieldControl.cs
@@ -1,18 +1,46 @@
-namespace MeshWeaver.Layout;
-
-public record TextFieldControl(object Data)
-    : InputBaseControl<TextFieldControl>(Data), IInputControl
+namespace MeshWeaver.Layout
 {
-    public object IconStart { get; init; }
-
-    public object IconEnd { get; init; }
+    /// <summary>
+    /// Represents a text field control with customizable properties.
+    /// </summary>
+    /// <param name="Data">The data associated with the text field control.</param>
+    public record TextFieldControl(object Data)
+        : InputBaseControl<TextFieldControl>(Data), IInputControl
+    {
+        /// <summary>
+        /// Gets or initializes the start icon of the text field control.
+        /// </summary>
+        public object IconStart { get; init; }
 
-    public object Autocomplete { get; init; }
+        /// <summary>
+        /// Gets or initializes the end icon of the text field control.
+        /// </summary>
+        public object IconEnd { get; init; }
 
-    public TextFieldControl WithIconStart(object icon) => this with { IconStart = icon };
+        /// <summary>
+        /// Gets or initializes the autocomplete attribute of the text field control.
+        /// </summary>
+        public object Autocomplete { get; init; }
 
-    public TextFieldControl WithIconEnd(object icon) => this with { IconEnd = icon };
+        /// <summary>
+        /// Sets the start icon of the text field control.
+        /// </summary>
+        /// <param name="icon">The start icon to set.</param>
+        /// <returns>A new <see cref="TextFieldControl"/> instance with the specified start icon.</returns>
+        public TextFieldControl WithIconStart(object icon) => this with { IconStart = icon };
 
-    public TextFieldControl WithAutocomplete(object autocomplete) => this with { Autocomplete = autocomplete };
-}
+        /// <summary>
+        /// Sets the end icon of the text field control.
+        /// </summary>
+        /// <param name="icon">The end icon to set.</param>
+        /// <returns>A new <see cref="TextFieldControl"/> instance with the specified end icon.</returns>
+        public TextFieldControl WithIconEnd(object icon) => this with { IconEnd = icon };
 
+        /// <summary>
+        /// Sets the autocomplete attribute of the text field control.
+        /// </summary>
+        /// <param name="autocomplete">The autocomplete attribute to set.</param>
+        /// <returns>A new <see cref="TextFieldControl"/> instance with the specified autocomplete attribute.</returns>
+        public TextFieldControl WithAutocomplete(object autocomplete) => this with { Autocomplete = autocomplete };
+    }
+}
\ No newline at end of file
diff --git a/src/MeshWeaver.Layout/ToolbarControl.cs b/src/MeshWeaver.Layout/ToolbarControl.cs
index c369c2ed7..ddecbd50a 100644
--- a/src/MeshWeaver.Layout/ToolbarControl.cs
+++ b/src/MeshWeaver.Layout/ToolbarControl.cs
@@ -1,10 +1,25 @@
 namespace MeshWeaver.Layout
 {
-    public record ToolbarControl() : ContainerControl<ToolbarControl,ToolbarSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new());
+    /// <summary>
+    /// Represents a toolbar control with customizable properties.
+    /// </summary>
+    public record ToolbarControl() : ContainerControl<ToolbarControl, ToolbarSkin>(ModuleSetup.ModuleName, ModuleSetup.ApiVersion, new());
 
+    /// <summary>
+    /// Represents the skin for a toolbar control with customizable properties.
+    /// </summary>
     public record ToolbarSkin : Skin<ToolbarSkin>
     {
+        /// <summary>
+        /// Gets or sets the orientation of the toolbar.
+        /// </summary>
         public object Orientation { get; set; }
+
+        /// <summary>
+        /// Sets the orientation of the toolbar.
+        /// </summary>
+        /// <param name="orientation">The orientation to set.</param>
+        /// <returns>A new <see cref="ToolbarSkin"/> instance with the specified orientation.</returns>
         public ToolbarSkin WithOrientation(object orientation) => this with { Orientation = orientation };
     }
 }
diff --git a/src/MeshWeaver.Layout/UiActionContext.cs b/src/MeshWeaver.Layout/UiActionContext.cs
index 5d3231f6c..aaeed775b 100644
--- a/src/MeshWeaver.Layout/UiActionContext.cs
+++ b/src/MeshWeaver.Layout/UiActionContext.cs
@@ -1,6 +1,14 @@
 using MeshWeaver.Layout.Composition;
 using MeshWeaver.Messaging;
 
-namespace MeshWeaver.Layout;
-
-public record UiActionContext(string Area, object Payload, IMessageHub Hub, LayoutAreaHost Host);
+namespace MeshWeaver.Layout
+{
+	/// <summary>
+	/// Represents the context for a UI action, including the area, payload, message hub, and layout area host.
+	/// </summary>
+	/// <param name="Area">The area where the UI action is performed.</param>
+	/// <param name="Payload">The payload associated with the UI action.</param>
+	/// <param name="Hub">The message hub for handling messages related to the UI action.</param>
+	/// <param name="Host">The layout area host associated with the UI action.</param>
+	public record UiActionContext(string Area, object Payload, IMessageHub Hub, LayoutAreaHost Host);
+}
diff --git a/src/MeshWeaver.Layout/VerticalAlignment.cs b/src/MeshWeaver.Layout/VerticalAlignment.cs
index f0a8ed43c..0b8dca71a 100644
--- a/src/MeshWeaver.Layout/VerticalAlignment.cs
+++ b/src/MeshWeaver.Layout/VerticalAlignment.cs
@@ -1,8 +1,23 @@
-namespace MeshWeaver.Layout;
-
-public enum VerticalAlignment
+namespace MeshWeaver.Layout
 {
-    Top,
-    Center,
-    Bottom
+    /// <summary>
+    /// Specifies the vertical alignment options for a control.
+    /// </summary>
+    public enum VerticalAlignment
+    {
+        /// <summary>
+        /// Aligns the control at the top.
+        /// </summary>
+        Top,
+
+        /// <summary>
+        /// Aligns the control in the center.
+        /// </summary>
+        Center,
+
+        /// <summary>
+        /// Aligns the control at the bottom.
+        /// </summary>
+        Bottom
+    }
 }

From a6446bab0df357900489fa27e66f5cee8f5bdb17 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Tue, 1 Oct 2024 19:48:16 +0200
Subject: [PATCH 07/25] fixing code views

---
 src/MeshWeaver.Blazor/BlazorClientRegistry.cs | 3 ++-
 src/MeshWeaver.Data/Workspace.cs              | 4 +++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/MeshWeaver.Blazor/BlazorClientRegistry.cs b/src/MeshWeaver.Blazor/BlazorClientRegistry.cs
index cea78bf6c..666722f7d 100644
--- a/src/MeshWeaver.Blazor/BlazorClientRegistry.cs
+++ b/src/MeshWeaver.Blazor/BlazorClientRegistry.cs
@@ -1,6 +1,7 @@
 using System.Collections.Immutable;
 using System.Runtime.CompilerServices;
 using System.Text.Json;
+using MeshWeaver.Application;
 using MeshWeaver.Data;
 using Microsoft.DotNet.Interactive.Formatting;
 using MeshWeaver.Data.Serialization;
@@ -23,7 +24,7 @@ internal static MessageHubConfiguration AddBlazor(
     ) => config
         .AddData()
         .AddLayoutClient(c => (configuration ?? (x => x)).Invoke(c.WithView(DefaultFormatting)))
-
+        .WithTypes(typeof(ApplicationAddress))
     ;
     #region Standard Formatting
     private static ViewDescriptor DefaultFormatting(
diff --git a/src/MeshWeaver.Data/Workspace.cs b/src/MeshWeaver.Data/Workspace.cs
index 9ccd9a1d8..76cf832ae 100644
--- a/src/MeshWeaver.Data/Workspace.cs
+++ b/src/MeshWeaver.Data/Workspace.cs
@@ -3,6 +3,7 @@
 using System.Reactive.Linq;
 using System.Reflection;
 using System.Text.Json;
+using System.Text.Json.Nodes;
 using Microsoft.Extensions.Logging;
 using MeshWeaver.Activities;
 using MeshWeaver.Data.Serialization;
@@ -210,7 +211,8 @@ TReference reference
         where TReference : WorkspaceReference
     {
         // link to deserialized world. Will also potentially link to workspace.
-
+        if(owner is JsonObject obj)
+            owner = obj.Deserialize<object>(Hub.JsonSerializerOptions);
         var ret = new SynchronizationStream<TReduced, TReference>(
             owner,
             owner,

From b66931e3d4013c15aac0c707c7ba2f995f4db426 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Wed, 2 Oct 2024 00:28:50 +0200
Subject: [PATCH 08/25] Bug fixes

---
 .../OrdersSummaryArea.cs                      |  1 -
 .../NumberFieldView.razor.cs                  |  2 +-
 src/MeshWeaver.Data.Contract/EntityStore.cs   |  4 -
 .../Documentation/DocumentationLayout.cs      |  7 +-
 .../Composition/LayoutAreaHost.cs             |  6 +-
 src/MeshWeaver.Layout/ContainerControl.cs     |  2 +-
 .../LayoutDefinitionExtensions.cs             | 75 ++++++++++++++++---
 7 files changed, 72 insertions(+), 25 deletions(-)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
index 7fe72bfb1..6a79741fd 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
@@ -1,7 +1,6 @@
 using System.Reactive.Linq;
 using MeshWeaver.Application.Styles;
 using MeshWeaver.Data;
-using MeshWeaver.Domain.Layout;
 using MeshWeaver.Domain.Layout.Documentation;
 using MeshWeaver.Layout;
 using MeshWeaver.Layout.Composition;
diff --git a/src/MeshWeaver.Blazor/NumberFieldView.razor.cs b/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
index 467869a4d..5bee34252 100644
--- a/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
+++ b/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
@@ -17,7 +17,7 @@ public partial class NumberFieldView<TValue>
         /// Allows associating a <see href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist">datalist</see> to the element by <see href="https://developer.mozilla.org/en-US/docs/Web/API/Element/id">id</see>.
         /// </summary>
 
-        public string? DataList { get; set; }
+        public string DataList { get; set; }
 
         /// <summary>
         /// Gets or sets the maximum length.
diff --git a/src/MeshWeaver.Data.Contract/EntityStore.cs b/src/MeshWeaver.Data.Contract/EntityStore.cs
index 3e011623a..eac9926e3 100644
--- a/src/MeshWeaver.Data.Contract/EntityStore.cs
+++ b/src/MeshWeaver.Data.Contract/EntityStore.cs
@@ -148,10 +148,6 @@ public override int GetHashCode()
         .Select(x => x.GetHashCode())
         .Aggregate((x, y) => x ^ y);
 
-    public EntityStoreAndUpdates UpdateControl(string mainContent, MeshWeaver.Layout.NamedAreaControl namedAreaControl)
-    {
-        throw new NotImplementedException();
-    }
 }
 public record EntityStoreAndUpdates(IEnumerable<EntityStoreUpdate> Changes, EntityStore Store);
 
diff --git a/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs b/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
index 618456504..f5b2cb5bd 100644
--- a/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
+++ b/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
@@ -20,7 +20,7 @@ public static LayoutDefinition AddDocumentation(this LayoutDefinition layout)
                 _ => true,
                 (tabs, host, ctx) => tabs.WithView(NamedArea(host.Stream.Reference.Area), ctx.DisplayName)
                 )
-            .WithView(nameof(Doc), (Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>>)Doc);
+            .WithView(nameof(Doc), Doc);
 
 
 
@@ -106,8 +106,7 @@ public static LayoutAreaReference GetLayoutAreaReferenceForEmbeddedResource(this
 
     private const string ReadPattern = @"^(?<sourceType>[^@]+)/(?<sourceId>[^@]+)/(?<documentId>[^@]+)$";
 
-    public static async Task<object> Doc(LayoutAreaHost area, RenderingContext context,
-        CancellationToken cancellationToken)
+    public static async Task<object> Doc(LayoutAreaHost area, RenderingContext context, CancellationToken cancellationToken)
     {
         if (area.Stream.Reference.Id is not string path)
             throw new InvalidOperationException("No file name specified.");
@@ -127,7 +126,7 @@ public static async Task<object> Doc(LayoutAreaHost area, RenderingContext conte
         {
             var extension = documentId.Split('.').Last();
             using var reader = new StreamReader(stream);
-            return new MarkdownControl(Format(await reader.ReadToEndAsync(cancellationToken), extension));
+            return new MarkdownControl(Format(await reader.ReadToEndAsync(), extension));
         }
 
         // Resource not found, return a warning control/message instead
diff --git a/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs b/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
index 949a51e0f..75a600741 100644
--- a/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
+++ b/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
@@ -281,8 +281,10 @@ internal EntityStoreAndUpdates RenderArea(RenderingContext context, ViewDefiniti
         });
         return DisposeExistingAreas(store, context);
     }
-    internal EntityStoreAndUpdates RenderArea(RenderingContext context, 
-        IObservable<ViewDefinition> generator, EntityStore store)
+    internal EntityStoreAndUpdates RenderArea(
+        RenderingContext context, 
+        IObservable<ViewDefinition> generator, 
+        EntityStore store)
     {
         AddDisposable(context.Area, generator.Subscribe(vd =>
                 InvokeAsync(async ct =>
diff --git a/src/MeshWeaver.Layout/ContainerControl.cs b/src/MeshWeaver.Layout/ContainerControl.cs
index 8aa3d96f1..1936553e9 100644
--- a/src/MeshWeaver.Layout/ContainerControl.cs
+++ b/src/MeshWeaver.Layout/ContainerControl.cs
@@ -134,7 +134,7 @@ public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, T> viewDefini
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, Task<T>> viewDefinition)
         => WithView((h, c, _) => viewDefinition.Invoke(h, c), x => x);
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, IObservable<T>> viewDefinition)
-        => WithView((h,c,_) => viewDefinition.Invoke(h,c), x => x);
+        => WithView((h,c,store) => h.RenderArea(c,(hh,cc,_)=>viewDefinition.Invoke(hh,cc), store), x => x);
     public TControl WithView<T>(ViewStream<T> viewDefinition)
         => WithView(viewDefinition, x => x);
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, IObservable<T>> viewDefinition, Func<NamedAreaControl, NamedAreaControl> options)
diff --git a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
index 70fd0400b..87782d5d6 100644
--- a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
+++ b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
@@ -35,6 +35,31 @@ Func<LayoutAreaHost, RenderingContext, IObservable<object>> generator
     ) =>
         layout.WithView(c => c.Area == area, generator);
 
+    /// <summary>
+    /// Synchronous View
+    /// </summary>
+    /// <param name="layout">The layout definition</param>
+    /// <param name="area">The area of the view</param>
+    /// <param name="generator">The generator of the view</param>
+    /// <returns>The updated layout definition.</returns>
+    public static LayoutDefinition WithView(this LayoutDefinition layout,
+        string area,
+        Func<LayoutAreaHost, RenderingContext, object> generator
+    ) => layout.WithView(ctx => ctx.Area == area, generator);
+
+    /// <summary>
+    /// Synchronous View
+    /// </summary>
+    /// <param name="layout">The layout definition</param>
+    /// <param name="filter">The filter of the view</param>
+    /// <param name="generator">The generator of the view</param>
+    /// <returns></returns>
+    public static LayoutDefinition WithView(this LayoutDefinition layout,
+        Func<RenderingContext, bool> filter,
+        Func<LayoutAreaHost, RenderingContext, object> generator
+    ) => layout.WithView(filter, (h,c, _) => Task.FromResult(generator.Invoke(h,c)));
+
+
     /// <summary>
     /// Adds a view to the layout definition with the specified context and observable generator.
     /// </summary>
@@ -44,27 +69,48 @@ Func<LayoutAreaHost, RenderingContext, IObservable<object>> generator
     /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         Func<RenderingContext, bool> context,
-        IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
+        IObservable<Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>>> generator
     ) =>
-        WithView(layout,
-            context,
-            generator.Select(o =>
-                (Func<LayoutAreaHost, RenderingContext, Task<object>>)((a, c) => Task.FromResult(o.Invoke(a, c)))
-            )
-        );
+        layout.WithRenderer(context, (host, ctx, store) => host.RenderArea(ctx, generator.Cast<ViewDefinition>(), store));
 
     /// <summary>
     /// Adds a view to the layout definition for the specified area and observable generator.
     /// </summary>
     /// <param name="layout">The layout definition.</param>
     /// <param name="area">The area to render the view.</param>
-    /// <param name="generator">The observable generator function to produce the view content.</param>
+    /// <param name="view">The view to be rendered.</param>
     /// <returns>The updated layout definition.</returns>
+
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         string area,
-        IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
+        object view
     ) =>
-        layout.WithView(c => c.Area == area, generator);
+        layout.WithView(c => c.Area == area, view);
+
+    /// <summary>
+    /// Adds a view to the layout definition for the specified area and observable generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="filter">The filter to render the view.</param>
+    /// <param name="view">The view to be rendered.</param>
+    /// <returns>The updated layout definition.</returns>
+    public static LayoutDefinition WithView(this LayoutDefinition layout,
+        Func<RenderingContext, bool> filter,
+        object view
+    ) =>
+        layout.WithRenderer(filter, (h,c,s) => h.RenderArea(c, view, s));
+
+    /// <summary>
+    /// Adds a view to the layout definition with the specified context and generator.
+    /// </summary>
+    /// <param name="layout">The layout definition.</param>
+    /// <param name="area">The area to render the view.</param>
+    /// <param name="generator">The generator function to produce the view content.</param>
+    /// <returns>The updated layout definition.</returns>
+    public static LayoutDefinition WithView(this LayoutDefinition layout,
+        string area,
+        Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>> generator
+    ) => layout.WithView(ctx => ctx.Area == area, generator);
 
     /// <summary>
     /// Adds a view to the layout definition with the specified context and generator.
@@ -75,7 +121,12 @@ IObservable<Func<LayoutAreaHost, RenderingContext, object>> generator
     /// <returns>The updated layout definition.</returns>
     public static LayoutDefinition WithView(this LayoutDefinition layout,
         Func<RenderingContext, bool> context,
-        Func<LayoutAreaHost, RenderingContext, Task<object>> generator
+        Func<LayoutAreaHost, RenderingContext,  CancellationToken, Task<object>> generator
     ) =>
-        layout.WithRenderer(context, (a, ctx, s) => a.RenderArea(ctx, generator.Invoke(a, ctx), s));
+        layout.WithRenderer(context, (a, ctx, s) => a.RenderArea(ctx, generator.Invoke, s));
+    public static EntityStoreAndUpdates UpdateControl(this EntityStore store, string id, UiControl control)
+        => new([new EntityStoreUpdate(LayoutAreaReference.Areas, id, control)], store.Update(LayoutAreaReference.Areas, i => i.Update(id, control)));
+    public static EntityStoreAndUpdates UpdateData(this EntityStore store, string id, object control)
+        => new([new EntityStoreUpdate(LayoutAreaReference.Data, id, control)], store.Update(LayoutAreaReference.Areas, i => i.Update(id, control)));
+
 }

From f283a8348b9f3d48d279a1317a16aa41261673fe Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Wed, 2 Oct 2024 12:44:04 +0300
Subject: [PATCH 09/25] build warnings for missing xml comments fixed

---
 .../AnnualReportExtensions.cs                 |  9 +++
 .../AnnualReportSummaryArea.cs                | 23 ++++++-
 .../LayoutTemplates.cs                        | 61 ++++++++++++-------
 .../NorthwindDataCube.cs                      | 16 ++++-
 .../NumberExtensions.cs                       | 14 +++++
 .../ProductOverviewArea.cs                    |  9 ++-
 .../ProductOverviewItem.cs                    | 10 ++-
 .../TopProductsArea.cs                        |  7 ++-
 8 files changed, 116 insertions(+), 33 deletions(-)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportExtensions.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportExtensions.cs
index f6d97f84d..4e420c5a1 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportExtensions.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportExtensions.cs
@@ -1,10 +1,19 @@
 using MeshWeaver.Layout;
 using MeshWeaver.Layout.Composition;
+using System;
 
 namespace MeshWeaver.Northwind.ViewModel
 {
+    /// <summary>
+    /// Provides extension methods for the annual report.
+    /// </summary>
     public static class AnnualReportExtensions
     {
+        /// <summary>
+        /// Gets the year from the query string parameters of the layout area.
+        /// </summary>
+        /// <param name="layoutArea">The layout area host.</param>
+        /// <returns>The year as an integer. If the year is not specified or invalid, returns the current year.</returns>
         public static int Year(this LayoutAreaHost layoutArea)
         {
             var yearString = layoutArea.GetQueryStringParamValue(nameof(Year));
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
index 77e2ed313..53032aeac 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
@@ -5,22 +5,39 @@
 using static MeshWeaver.Northwind.ViewModel.LayoutTemplates;
 
 namespace MeshWeaver.Northwind.ViewModel;
-
+/// <summary>
+    /// Provides methods to add and render the annual report summary area.
+    /// </summary>
 public static class AnnualReportSummaryArea
 {
+     /// <summary>
+        /// Adds the annual report summary view to the layout definition.
+        /// </summary>
+        /// <param name="layout">The layout definition.</param>
+        /// <returns>The updated layout definition with the annual report summary view.</returns>
     public static LayoutDefinition AddAnnualReportSummary(this LayoutDefinition layout)
         => 
             layout
                 .WithView(nameof(AnnualReportSummary), Controls.Layout.WithView(AnnualReportSummary))
     ;
-
+  /// <summary>
+        /// Renders the annual report summary area.
+        /// </summary>
+        /// <param name="layoutArea">The layout area host.</param>
+        /// <param name="context">The rendering context.</param>
+        /// <returns>An object representing the rendered annual report summary area.</returns>
     public static object AnnualReportSummary(this LayoutAreaHost layoutArea, RenderingContext context)
         => Controls.LayoutGrid
             .WithView(ValueBoxes, skin => skin.WithXs(12))
             .WithView(SummaryCharts, skin => skin.WithXs(12))
             .WithSkin(skin => skin.WithSpacing(5))
         ;
-
+ /// <summary>
+        /// Creates an observable sequence of value boxes for the annual report summary.
+        /// </summary>
+        /// <param name="layoutArea">The layout area host.</param>
+        /// <param name="context">The rendering context.</param>
+        /// <returns>An observable sequence of value boxes.</returns>
     private static IObservable<object> ValueBoxes(LayoutAreaHost layoutArea, RenderingContext context)
     {
         var currentYear = layoutArea.Year();
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/LayoutTemplates.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/LayoutTemplates.cs
index 886bb26be..4b15b9dcb 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/LayoutTemplates.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/LayoutTemplates.cs
@@ -1,29 +1,46 @@
 using MeshWeaver.Domain;
 using MeshWeaver.Layout;
 
-namespace MeshWeaver.Northwind.ViewModel;
-
-public static class LayoutTemplates
+namespace MeshWeaver.Northwind.ViewModel
 {
-    public static object ValueBox(string title, Icon icon, string value, object growth) =>
-        Controls.Stack
-            .WithSkin(skin => skin.WithOrientation(Orientation.Horizontal))
-            .WithHorizontalGap(10)
-            .WithView(Controls.Icon(icon).WithWidth("48px"))
-            .WithView(Controls.Stack
-                .WithVerticalGap(10)
-                .WithView(Controls.Stack.WithView(Controls.H3(title)).WithView(growth)
-                    .WithOrientation(Orientation.Horizontal).WithHorizontalGap(5))
-                .WithView(Controls.H2(value))
-            );
-
-    public static object GrowthPercentage(double current, double previous)
+    /// <summary>
+    /// Provides layout templates for the Northwind view model.
+    /// </summary>
+    public static class LayoutTemplates
     {
-        var delta = current - previous;
-        var percentage = delta / previous;
-        var sign = delta >= 0 ? "+" : "-";
-        var color = delta >= 0 ? "green" : "red";
-        return Controls.Html($"<span style='color:{color}'>{sign}{percentage:P0}</span>");
-    }
+        /// <summary>
+        /// Creates a value box with a title, icon, value, and growth indicator.
+        /// </summary>
+        /// <param name="title">The title of the value box.</param>
+        /// <param name="icon">The icon to display in the value box.</param>
+        /// <param name="value">The value to display in the value box.</param>
+        /// <param name="growth">The growth indicator to display in the value box.</param>
+        /// <returns>An object representing the value box.</returns>
+        public static object ValueBox(string title, Icon icon, string value, object growth) =>
+            Controls.Stack
+                .WithSkin(skin => skin.WithOrientation(Orientation.Horizontal))
+                .WithHorizontalGap(10)
+                .WithView(Controls.Icon(icon).WithWidth("48px"))
+                .WithView(Controls.Stack
+                    .WithVerticalGap(10)
+                    .WithView(Controls.Stack.WithView(Controls.H3(title)).WithView(growth)
+                        .WithOrientation(Orientation.Horizontal).WithHorizontalGap(5))
+                    .WithView(Controls.H2(value))
+                );
 
+        /// <summary>
+        /// Creates a growth percentage indicator based on current and previous values.
+        /// </summary>
+        /// <param name="current">The current value.</param>
+        /// <param name="previous">The previous value.</param>
+        /// <returns>An object representing the growth percentage indicator.</returns>
+        public static object GrowthPercentage(double current, double previous)
+        {
+            var delta = current - previous;
+            var percentage = delta / previous;
+            var sign = delta >= 0 ? "+" : "-";
+            var color = delta >= 0 ? "green" : "red";
+            return Controls.Html($"<span style='color:{color}'>{sign}{percentage:P0}</span>");
+        }
+    }
 }
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
index f363b6425..e483785b1 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
@@ -229,16 +229,26 @@ protected NorthwindDataCube(NorthwindDataCube original)
         [NotVisible]
         public string Discontinued { get; init; }
     }
-
-    public record LabeledNorthwindDataCube : NorthwindDataCube
+ /// <summary>
+    /// Initializes a new instance of the <see cref="LabeledNorthwindDataCube"/> class with the specified label and original data cube.
+    /// </summary>
+        public record LabeledNorthwindDataCube : NorthwindDataCube
     {
+       /// <summary>
+    /// Initializes a new instance of the <see cref="LabeledNorthwindDataCube"/> class.
+    /// </summary> 
         public LabeledNorthwindDataCube(string label, NorthwindDataCube original) : base(original)
         {
             Label = label;
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="LabeledNorthwindDataCube"/> class.
+        /// </summary>
         public LabeledNorthwindDataCube() { }
-
+ /// <summary>
+    /// Gets the label for the data cube.
+    /// </summary>
         [NotVisible]
         [Dimension(typeof(string), nameof(Label))]
         public string Label { get; init; }
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NumberExtensions.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NumberExtensions.cs
index 24b26e289..d4ae795bf 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NumberExtensions.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NumberExtensions.cs
@@ -2,8 +2,17 @@
 
 namespace MeshWeaver.Northwind.ViewModel
 {
+    /// <summary>
+    /// Provides extension methods for formatting numbers with suffixes.
+    /// </summary>
     public static class NumberExtensions
     {
+        /// <summary>
+        /// Converts a double to a string with a suffix format (e.g., K for thousands, M for millions, B for billions).
+        /// </summary>
+        /// <param name="num">The number to format.</param>
+        /// <param name="format">The format string to use if no suffix is applied. Default is "0.##".</param>
+        /// <returns>A string representing the formatted number with the appropriate suffix.</returns>
         public static string ToSuffixFormat(this double num, string format = "0.##")
         {
             switch (num)
@@ -22,6 +31,11 @@ public static string ToSuffixFormat(this double num, string format = "0.##")
             }
         }
 
+        /// <summary>
+        /// Converts an integer to a string with a suffix format (e.g., K for thousands, M for millions, B for billions).
+        /// </summary>
+        /// <param name="num">The number to format.</param>
+        /// <returns>A string representing the formatted number with the appropriate suffix.</returns>
         public static string ToSuffixFormat(this int num) =>
             ((double)num).ToSuffixFormat("0");
     }
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewArea.cs
index cf366b8c7..f2be13e7c 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewArea.cs
@@ -6,9 +6,16 @@
 using MeshWeaver.Northwind.Domain;
 
 namespace MeshWeaver.Northwind.ViewModel;
-
+ /// <summary>
+    /// Provides methods to add and render the product overview area.
+    /// </summary>
 public static class ProductOverviewArea
 {
+     /// <summary>
+        /// Adds the product overview view to the layout definition.
+        /// </summary>
+        /// <param name="layout">The layout definition.</param>
+        /// <returns>The updated layout definition with the product overview view.</returns>
     public static LayoutDefinition AddProductOverview(this LayoutDefinition layout)
         => 
             layout
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewItem.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewItem.cs
index a65f9ba6a..8a43aac7e 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewItem.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/ProductOverviewItem.cs
@@ -3,7 +3,8 @@
 namespace MeshWeaver.Northwind.ViewModel;
 
 /// <summary>
-/// Represents an overview item for a product.
+/// Gets the unit price formatted as a numeric value with two decimal places.
+/// /// Represents an overview item for a product.
 /// </summary>
 public record ProductOverviewItem
 {
@@ -22,10 +23,10 @@ public record ProductOverviewItem
     /// </summary>
     public string CategoryName { get; init; }
 
-    [DisplayFormat(DataFormatString = "N2")]
     /// <summary>
     /// Gets the unit price.
     /// </summary>
+    [DisplayFormat(DataFormatString = "N2")]
     public double UnitPrice { get; init; }
 
     /// <summary>
@@ -39,6 +40,9 @@ public record ProductOverviewItem
     [DisplayFormat(DataFormatString = "N2")]
     public double DiscountGiven { get; init; }
 
+    /// <summary>
+    /// Gets the total amount.
+    /// </summary>
     [DisplayFormat(DataFormatString = "N2")]
-    public double TotalAmount { get; init; }
+       public double TotalAmount { get; init; }
 }
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/TopProductsArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/TopProductsArea.cs
index 5e46129f2..a344e754d 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/TopProductsArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/TopProductsArea.cs
@@ -24,7 +24,12 @@ public static LayoutDefinition AddTopProducts(this LayoutDefinition layout)
                 layout
                     .WithView(nameof(TopProducts), TopProducts)
         ;
-
+/// <summary>
+        /// Renders the top products view.
+        /// </summary>
+        /// <param name="layoutArea">The layout area host.</param>
+        /// <param name="context">The rendering context.</param>
+        /// <returns>An observable sequence of objects representing the rendered top products view.</returns>
         public static IObservable<object> TopProducts(this LayoutAreaHost layoutArea, RenderingContext context)
             => layoutArea.YearlyNorthwindData()
                 .Select(d =>

From bcb0fc46a55625cfda6e53425fa98ec0d013962e Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Wed, 2 Oct 2024 16:55:53 +0300
Subject: [PATCH 10/25] more xml comments added

---
 .../AnnualReportSummaryArea.cs                | 26 +++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
index 53032aeac..0ae08d1c9 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportSummaryArea.cs
@@ -59,7 +59,12 @@ private static IObservable<object> ValueBoxes(LayoutAreaHost layoutArea, Renderi
                 })
             ;
     }
-
+/// <summary>
+/// Renders the summary charts for the annual report.
+/// </summary>
+/// <param name="layoutArea">The layout area host.</param>
+/// <param name="context">The rendering context.</param>
+/// <returns>An object representing the rendered summary charts.</returns>
     public static object SummaryCharts(LayoutAreaHost layoutArea, RenderingContext context)
         => Controls.LayoutGrid
             .WithView(
@@ -121,12 +126,29 @@ private static object Orders(SummaryItem current, SummaryItem previous) =>
         );
 
 }
-
+/// <summary>
+/// Represents a summary item for the annual report.
+/// </summary>
 public record SummaryItem
 {
+    /// <summary>
+    /// Gets the year of the summary item.
+    /// </summary>
     public int Year { get; init; }
+     /// <summary>
+    /// Gets the number of customers in the summary item.
+    /// </summary>
     public int Customers { get; init; }
+    /// <summary>
+    /// Gets the number of products in the summary item.
+    /// </summary>
     public int Products { get; init; }
+    /// <summary>
+    /// Gets the total sales in the summary item.
+    /// </summary>
     public double Sales { get; init; }
+    /// <summary>
+    /// Gets the number of orders in the summary item.
+    /// </summary>
     public int Orders { get; init; }
 }

From 4101d79bc89d5031d0a62c6aec4672d7f3092421 Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Wed, 2 Oct 2024 12:06:21 +0200
Subject: [PATCH 11/25] removed PivotArrayChartBuilderBase.WithLegend() which
 actually hided the inherited one with the same code

---
 .../PivotArrayChartBuilderBase.cs                          | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/src/MeshWeaver.Charting.Pivot/PivotArrayChartBuilderBase.cs b/src/MeshWeaver.Charting.Pivot/PivotArrayChartBuilderBase.cs
index 15a6f2dcb..88d32ee3c 100644
--- a/src/MeshWeaver.Charting.Pivot/PivotArrayChartBuilderBase.cs
+++ b/src/MeshWeaver.Charting.Pivot/PivotArrayChartBuilderBase.cs
@@ -1,6 +1,5 @@
 using MeshWeaver.Charting.Builders.DataSetBuilders;
 using MeshWeaver.Charting.Models;
-using MeshWeaver.Charting.Models.Options;
 using MeshWeaver.Pivot.Builder;
 
 namespace MeshWeaver.Charting.Pivot;
@@ -16,12 +15,6 @@ protected PivotArrayChartBuilderBase(PivotBuilderBase<T, TTransformed, TIntermed
     {
     }
 
-    public IPivotArrayChartBuilder WithLegend(Func<Legend, Legend> func)
-    {
-        Chart = Chart.WithLegend(func);
-        return this;
-    }
-
     public virtual IPivotArrayChartBuilder WithSmoothedLines(params string[] linesToSmooth)
     {
         PivotChartModelBuilder.AddPostProcessor(model => model with

From 3bfdb1161d862428bcdf88e4c4154882c274192c Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Wed, 2 Oct 2024 12:10:02 +0200
Subject: [PATCH 12/25] removed nullable string usage in a context without
 #nullable annotation

---
 src/MeshWeaver.Blazor/NumberFieldView.razor.cs | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/src/MeshWeaver.Blazor/NumberFieldView.razor.cs b/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
index 5bee34252..90997ea1b 100644
--- a/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
+++ b/src/MeshWeaver.Blazor/NumberFieldView.razor.cs
@@ -5,70 +5,56 @@ namespace MeshWeaver.Blazor
     public partial class NumberFieldView<TValue>
         where TValue:new()
     {
-
-
         /// <summary>
         /// When true, spin buttons will not be rendered.
         /// </summary>
-
         public bool HideStep { get; set; }
 
         /// <summary>
         /// Allows associating a <see href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist">datalist</see> to the element by <see href="https://developer.mozilla.org/en-US/docs/Web/API/Element/id">id</see>.
         /// </summary>
-
         public string DataList { get; set; }
 
         /// <summary>
         /// Gets or sets the maximum length.
         /// </summary>
-
         public int MaxLength { get; set; } = 14;
 
         /// <summary>
         /// Gets or sets the minimum length.
         /// </summary>
-
         public int MinLength { get; set; } = 1;
 
         /// <summary>
         /// Gets or sets the size.
         /// </summary>
-
         public int Size { get; set; } = 20;
 
         /// <summary>
         /// Gets or sets the amount to increase/decrease the number with. Only use whole number when TValue is int or long. 
         /// </summary>
-
         public string Step { get; set; }
 
         /// <summary>
         /// Gets or sets the maximum value.
         /// </summary>
-
         public string Max { get; set; }
 
         /// <summary>
         /// Gets or sets the minimum value.
         /// </summary>
-
         public string Min { get; set; }
 
         /// <summary>
         /// Gets or sets the <see cref="FluentInputAppearance" />.
         /// </summary>
-
         public FluentInputAppearance Appearance { get; set; } = FluentInputAppearance.Outline;
 
         /// <summary>
         /// Gets or sets the error message to show when the field can not be parsed.
         /// </summary>
-
         public string ParsingErrorMessage { get; set; } = "The {0} field must be a number.";
 
-
-
         protected override void BindData()
         {
             base.BindData();
@@ -83,8 +69,6 @@ protected override void BindData()
             DataBind(ViewModel.Min, x => x.Min);
             DataBind(ViewModel.Appearance, x => x.Appearance);
             DataBind(ViewModel.ParsingErrorMessage, x => x.ParsingErrorMessage);
-
         }
-
     }
 }

From 50a3b73b6f43ff16814de5bf5409832d42589496 Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Wed, 2 Oct 2024 16:27:45 +0200
Subject: [PATCH 13/25] removed duplicate TStream generic specified on
 ReduceManager.UpdateParent() method

---
 src/MeshWeaver.Data/ReduceManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MeshWeaver.Data/ReduceManager.cs b/src/MeshWeaver.Data/ReduceManager.cs
index 98e5dbeb3..5349aa5f9 100644
--- a/src/MeshWeaver.Data/ReduceManager.cs
+++ b/src/MeshWeaver.Data/ReduceManager.cs
@@ -154,7 +154,7 @@ protected static ISynchronizationStream CreateReducedStream<TReference, TReduced
 
         return reducedStream;
     }
-    internal static void UpdateParent<TStream, TReference, TReduced>(
+    internal static void UpdateParent<TReference, TReduced>(
         ISynchronizationStream<TStream> parent,
         TReference reference,
         ChangeItem<TReduced> change,

From b5ff829220c256c9cdf00c9158dd11797c728621 Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Wed, 2 Oct 2024 16:29:56 +0200
Subject: [PATCH 14/25] added xml-doc for NorthwindDataCube protected
 constructor

---
 .../MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
index e483785b1..74af30535 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/NorthwindDataCube.cs
@@ -46,6 +46,10 @@ public NorthwindDataCube(Order order, OrderDetails details, Product product)
             Amount = product.UnitPrice * details.Quantity * (1 - details.Discount);
         }
 
+        /// <summary>
+        /// Initializes a new instance of the NorthwindDataCube with values taken from another existed NorthwindDataCube instance.
+        /// </summary>
+        /// <param name="original">Original NorthwindDataCube instance to copy the values from.</param>
         protected NorthwindDataCube(NorthwindDataCube original)
         {
             OrderId = original.OrderId;

From 29ed71d3a27babecfc8d6de99862ba35a7e24d8b Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Wed, 2 Oct 2024 08:56:14 +0200
Subject: [PATCH 15/25] a bit of flexibility to be able to specify different
 icons for Annual Report nav menu subitems

---
 .../AnnualReportConfiguration.cs              | 24 +++++++++++++++----
 1 file changed, 19 insertions(+), 5 deletions(-)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportConfiguration.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportConfiguration.cs
index fb63165d7..9468ddee9 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportConfiguration.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/AnnualReportConfiguration.cs
@@ -1,5 +1,6 @@
 using MeshWeaver.Application.Styles;
 using MeshWeaver.Collections;
+using MeshWeaver.Domain;
 using MeshWeaver.Domain.Layout.Documentation;
 using MeshWeaver.Layout;
 using MeshWeaver.Layout.Composition;
@@ -43,11 +44,11 @@ private static LayoutDefinition AddAnnualReportMenu(this LayoutDefinition layout
                 .WithNavGroup(
                     AnnualReportDocuments.Aggregate(
                         Controls.NavGroup("Financial Report 2023", FluentIcons.Folder)
-                            .WithSkin(skin => 
+                            .WithSkin(skin =>
                                 skin.WithHref(layout.DocumentHref(SummaryDocument))
-                                .WithExpanded(true)), 
-                            (navGroup, documentName) => navGroup.WithLink(Path.GetFileNameWithoutExtension(documentName).Wordify(), 
-                                layout.DocumentationPath(ThisAssembly, documentName), FluentIcons.Document))
+                                .WithExpanded(true)),
+                            (navGroup, documentName) => navGroup.WithLink(Path.GetFileNameWithoutExtension(documentName).Wordify(),
+                                layout.DocumentationPath(ThisAssembly, documentName), GetIcon(documentName)))
                 )
         );
 
@@ -66,6 +67,19 @@ private static string DocumentHref(this LayoutDefinition layout, string document
     private static string DocumentFolder =>
         $"{ThisAssembly.GetName().Name}.Markdown.AnnualReport";
 
-    private static System.Reflection.Assembly ThisAssembly 
+    private static readonly IReadOnlyDictionary<string, Icon> DocumentIcons = new Dictionary<string, Icon>()
+    {
+        { "ClientsOverview.md", FluentIcons.CreditCardPerson },
+        { "DiscountsOverview.md", FluentIcons.ShoppingBagPercent },
+        { "EmployeesOverview.md", FluentIcons.Person5 },
+        { "OrdersOverview.md", FluentIcons.BoxCheckmark },
+        { "ProductOverview.md", FluentIcons.ShoppingBag },
+        { "SalesOverview.md", FluentIcons.Money },
+    };
+
+    private static Icon GetIcon(string documentName)
+        => DocumentIcons.TryGetValue(documentName, out var icon) ? icon : FluentIcons.Document;
+
+    private static System.Reflection.Assembly ThisAssembly
         => typeof(AnnualReportConfiguration).Assembly;
 }

From ce75dae8c567d8be4eb4ea3ddb44bb9f9bf64ac0 Mon Sep 17 00:00:00 2001
From: Anna Kuleshova <akuleshova@systemorph.com>
Date: Thu, 3 Oct 2024 10:56:21 +0300
Subject: [PATCH 16/25] reports renaming according to recommendations from
 Markus

---
 .../AnnualReport/AnnualReportSummary.md       |  2 +-
 ...countsOverview.md => DiscountsAnalysis.md} |  0
 .../{OrdersOverview.md => OrdersReview.md}    |  0
 .../{SalesOverview.md => SalesAnalysis.md}    |  2 ++
 ...ientsOverview.md => TopClientsOverview.md} |  0
 ...ductOverview.md => TopProductsOverview.md} |  0
 ...Overview.md => TopSalesRepresentatives.md} |  0
 .../Markdown/Northwind.md                     | 21 ------------
 .../Markdown/Overview.md                      | 33 -------------------
 9 files changed, 3 insertions(+), 55 deletions(-)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{DiscountsOverview.md => DiscountsAnalysis.md} (100%)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{OrdersOverview.md => OrdersReview.md} (100%)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{SalesOverview.md => SalesAnalysis.md} (98%)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{ClientsOverview.md => TopClientsOverview.md} (100%)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{ProductOverview.md => TopProductsOverview.md} (100%)
 rename modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/{EmployeesOverview.md => TopSalesRepresentatives.md} (100%)
 delete mode 100644 modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Northwind.md
 delete mode 100644 modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Overview.md

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/AnnualReportSummary.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/AnnualReportSummary.md
index ec5d1af95..79327168d 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/AnnualReportSummary.md
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/AnnualReportSummary.md
@@ -1,3 +1,3 @@
-# Financial Report 2023
+# Sales Dashboard
 
 @("AnnualReportSummary"){ Id = "?Year=2023" }
\ No newline at end of file
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/DiscountsOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/DiscountsAnalysis.md
similarity index 100%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/DiscountsOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/DiscountsAnalysis.md
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersReview.md
similarity index 100%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/OrdersReview.md
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesAnalysis.md
similarity index 98%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesAnalysis.md
index 97742e26b..aa31ea311 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesOverview.md
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/SalesAnalysis.md
@@ -30,6 +30,8 @@ Tags:
 </style>
 
 This report provides a detailed comparison of sales across various product categories between the years 2022 and 2023. The analysis highlights the growth in sales for each category, showcasing the overall performance and trends within the market. The data reveals significant increases in sales across all categories, with some experiencing remarkable growth rates. 
+Click the year above the chart to select which information to display.
+
 <div class="sales-by-category-comparison-chart">
 
 @("SalesByCategoryWithPrevYear"){ Id = "?Year=2023" }
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopClientsOverview.md
similarity index 100%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ClientsOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopClientsOverview.md
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ProductOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopProductsOverview.md
similarity index 100%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/ProductOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopProductsOverview.md
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopSalesRepresentatives.md
similarity index 100%
rename from modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/EmployeesOverview.md
rename to modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/AnnualReport/TopSalesRepresentatives.md
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Northwind.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Northwind.md
deleted file mode 100644
index 16b281d8d..000000000
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Northwind.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Overview of the Project
-
-The Northwind.ViewModel project is designed to provide a structured and efficient way to represent and manipulate data from the Northwind Database within an application. This project focuses on creating view models that encapsulate the data and business logic required for the presentation layer, ensuring a clear separation of concerns and enhancing maintainability.
-
-## Key Features
-
-- **Data Representation**: Provides view models that represent the data entities from the Northwind Database, such as products, orders, customers, and employees.
-- **Business Logic**: Encapsulates business logic within the view models to ensure that the presentation layer remains clean and focused on UI concerns.
-- **Data Binding**: Facilitates data binding in UI frameworks, making it easier to display and interact with data in a user-friendly manner.
-- **Validation**: Includes validation logic within the view models to ensure data integrity and provide immediate feedback to users.
-- **Interactivity**: Supports interactive features, such as filtering and sorting, to enhance the user experience in reporting and data visualization.
-
-## Components
-
-- **ProductViewModel**: Represents product data, including details such as name, category, price, and stock levels.
-- **OrderViewModel**: Encapsulates order information, including customer details, order items, and order status.
-- **CustomerViewModel**: Manages customer data, including contact information, order history, and preferences.
-- **EmployeeViewModel**: Handles employee information, including roles, contact details, and performance metrics.
-
-The Northwind.ViewModel project aims to provide a robust foundation for building interactive and data-driven applications, leveraging the rich dataset of the Northwind Database.
-
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Overview.md b/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Overview.md
deleted file mode 100644
index 28d8f8ad3..000000000
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/Markdown/Overview.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-Name: "Northwind Overview"
-Description: "This is a sample description of the article."
-Thumbnail: "images/thumbnail.jpg"
-Published: "2024-09-24"
-Authors:
-  - "Roland Bürgi"
-  - "Anna Kuleshova"
-Tags:
-  - "Northwind"
-  - "Conceptual"
----
-
-# Northwind
-
-This is a model for the [Northwind Database](https://github.com/microsoft/sql-server-samples/blob/master/samples/databases/northwind-pubs/readme.md). 
-It is a small data domain modelling an e-commerce store. The complexity is moderate, it is more realistic than,
-e.g. a TODO application or a blog application. Nevertheless, the complexity is not too big, so that we can 
-describe the basic principles of data modeling. 
-
-## Counter
-
-The counter doesn't really fit here, we should move it to a spearate project. 
-
-@("ProductSummary"){ Layout = "Documentation" }
-
-## Interactive Reporting
-
-Make your reports interactive by using the [Interactive Reporting](InteractiveReporting.md) feature. Here an example:
-
-@("OrderSummary"){ Layout = "Documentation" }
-
-

From 2f71a834a4105ed17fc5563012f19239b8bb7fec Mon Sep 17 00:00:00 2001
From: Dmitry Kalabin <dkalabin@systemorph.com>
Date: Thu, 3 Oct 2024 13:13:32 +0200
Subject: [PATCH 17/25] fix after merge

---
 .../Documentation/DocumentationLayout.cs                        | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs b/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
index f5b2cb5bd..1716a735a 100644
--- a/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
+++ b/src/MeshWeaver.Documentation/Documentation/DocumentationLayout.cs
@@ -20,7 +20,7 @@ public static LayoutDefinition AddDocumentation(this LayoutDefinition layout)
                 _ => true,
                 (tabs, host, ctx) => tabs.WithView(NamedArea(host.Stream.Reference.Area), ctx.DisplayName)
                 )
-            .WithView(nameof(Doc), Doc);
+            .WithView(nameof(Doc), (Func<LayoutAreaHost, RenderingContext, CancellationToken, Task<object>>)Doc);
 
 
 

From 89d5ec06f3c7e8700e8b440e826bbdfcdec4c46a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Thu, 3 Oct 2024 15:31:04 +0200
Subject: [PATCH 18/25] bug fixes

# Conflicts:
#	src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
---
 .../OrdersSummaryArea.cs                      |  3 +-
 src/MeshWeaver.Data.Contract/EntityStore.cs   |  8 ++-
 .../IDomainLayoutService.cs                   | 30 ++------
 .../Composition/LayoutAreaHost.cs             |  3 +-
 src/MeshWeaver.Layout/ContainerControl.cs     |  2 +-
 .../LayoutDefinitionExtensions.cs             |  2 +-
 src/MeshWeaver.Layout/Template.cs             | 71 ++++++++++++++++---
 src/MeshWeaver.Layout/UiControl.cs            | 11 ++-
 test/MeshWeaver.Layout.Test/LayoutTest.cs     |  5 +-
 9 files changed, 85 insertions(+), 50 deletions(-)

diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs b/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
index 6a79741fd..deb73910a 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/OrdersSummaryArea.cs
@@ -47,7 +47,8 @@ RenderingContext ctx
     )
     {
         var years = layoutArea
-            .Workspace.GetObservable<Order>()
+            .Workspace
+            .GetObservable<Order>()
             .DistinctUntilChanged()
             .Select(x =>
                 x.Select(y => y.OrderDate.Year)
diff --git a/src/MeshWeaver.Data.Contract/EntityStore.cs b/src/MeshWeaver.Data.Contract/EntityStore.cs
index eac9926e3..f39b855d0 100644
--- a/src/MeshWeaver.Data.Contract/EntityStore.cs
+++ b/src/MeshWeaver.Data.Contract/EntityStore.cs
@@ -149,7 +149,13 @@ public override int GetHashCode()
         .Aggregate((x, y) => x ^ y);
 
 }
-public record EntityStoreAndUpdates(IEnumerable<EntityStoreUpdate> Changes, EntityStore Store);
+
+public record EntityStoreAndUpdates(IEnumerable<EntityStoreUpdate> Changes, EntityStore Store)
+{
+    public EntityStoreAndUpdates(EntityStore Store) : this([], Store)
+    {
+    }
+}
 
 public record EntityStoreUpdate(string Collection, object Id, object Value)
 {
diff --git a/src/MeshWeaver.Documentation/IDomainLayoutService.cs b/src/MeshWeaver.Documentation/IDomainLayoutService.cs
index eb0d9b829..a46220515 100644
--- a/src/MeshWeaver.Documentation/IDomainLayoutService.cs
+++ b/src/MeshWeaver.Documentation/IDomainLayoutService.cs
@@ -97,11 +97,13 @@ public DomainViewConfiguration WithPropertyView(Func<EditFormControl, PropertyRe
 
     public object DetailsLayout(LayoutAreaHost host, RenderingContext ctx, EntityRenderingContext context)
     {
-            
 
+
+        var stream = host.Workspace
+            .GetStreamFor(new EntityReference(context.TypeDefinition.CollectionName, context.Id), host.Stream.Subscriber);
         var ret = 
             
-            Template.Bind(context.IdString,
+            stream.Bind(context.IdString,
             oo =>
                 context.TypeDefinition.Type.GetProperties()
                     .Aggregate(Controls.EditForm, (grid, property) =>
@@ -111,31 +113,7 @@ public object DetailsLayout(LayoutAreaHost host, RenderingContext ctx, EntityRen
                         )
         );
 
-        var stream = host.Workspace
-            .GetStreamFor(new EntityReference(context.TypeDefinition.CollectionName, context.Id), host.Stream.Subscriber);
 
-        object current = null;
-        var forwardSubscription = stream.Subscribe(changeItem =>
-        {
-            if (Equals(changeItem.Value, current))
-                return;
-            current = changeItem.Value;
-            host.Stream.SetData(context.IdString, changeItem.SetValue(current));
-        });
-        //var subscription = host.Stream.Subscribe(changeItem =>
-        //{
-        //    if(changeItem.Patch?.Value is null)
-        //        return;
-        //    if (changeItem.ChangedBy.Equals(host.Stream.Subscriber) &&changeItem.Patch.Value.Operations.Any(x => x.Path.ToString().StartsWith(ret.DataContext)))
-        //    {
-        //        var instance = changeItem.Value.GetCollection(LayoutAreaReference.Data)?.Instances
-        //            .GetValueOrDefault(context.IdString);
-        //        if(instance is not null)
-        //            stream.Update(i => changeItem.SetValue(instance));
-        //    }
-        //});
-
-        host.AddDisposable(context.RenderingContext.Area, forwardSubscription);
         return ret;
     }
 
diff --git a/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs b/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
index 75a600741..8b2cad450 100644
--- a/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
+++ b/src/MeshWeaver.Layout/Composition/LayoutAreaHost.cs
@@ -254,8 +254,7 @@ private EntityStoreAndUpdates DisposeExistingAreas(EntityStore store, RenderingC
     }
 
 
-    internal EntityStoreAndUpdates 
-        RenderArea<T>(RenderingContext context, ViewStream<T> generator, EntityStore store)
+    internal EntityStoreAndUpdates RenderArea<T>(RenderingContext context, ViewStream<T> generator, EntityStore store)
     {
         var ret = DisposeExistingAreas(store, context);
         AddDisposable(context.Parent?.Area ?? context.Area,
diff --git a/src/MeshWeaver.Layout/ContainerControl.cs b/src/MeshWeaver.Layout/ContainerControl.cs
index 1936553e9..8aa3d96f1 100644
--- a/src/MeshWeaver.Layout/ContainerControl.cs
+++ b/src/MeshWeaver.Layout/ContainerControl.cs
@@ -134,7 +134,7 @@ public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, T> viewDefini
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, Task<T>> viewDefinition)
         => WithView((h, c, _) => viewDefinition.Invoke(h, c), x => x);
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, IObservable<T>> viewDefinition)
-        => WithView((h,c,store) => h.RenderArea(c,(hh,cc,_)=>viewDefinition.Invoke(hh,cc), store), x => x);
+        => WithView((h,c,_) => viewDefinition.Invoke(h,c), x => x);
     public TControl WithView<T>(ViewStream<T> viewDefinition)
         => WithView(viewDefinition, x => x);
     public TControl WithView<T>(Func<LayoutAreaHost, RenderingContext, IObservable<T>> viewDefinition, Func<NamedAreaControl, NamedAreaControl> options)
diff --git a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
index c21182a29..65cf745c8 100644
--- a/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
+++ b/src/MeshWeaver.Layout/LayoutDefinitionExtensions.cs
@@ -148,7 +148,7 @@ Func<LayoutAreaHost, RenderingContext, T> view
     public static EntityStoreAndUpdates UpdateControl(this EntityStore store, string id, UiControl control)
         => new ([new EntityStoreUpdate(LayoutAreaReference.Areas, id, control)], store.Update(LayoutAreaReference.Areas, i => i.Update(id, control)));
     public static EntityStoreAndUpdates UpdateData(this EntityStore store, string id, object control)
-        => new ([new EntityStoreUpdate(LayoutAreaReference.Data, id, control)], store.Update(LayoutAreaReference.Data, i => i.Update(id, control)));
+        => new([new EntityStoreUpdate(LayoutAreaReference.Data, id, control)], store.Update(LayoutAreaReference.Data, i => i.Update(id, control)));
 
     public static LayoutDefinition WithRenderer(
         this LayoutDefinition layout,
diff --git a/src/MeshWeaver.Layout/Template.cs b/src/MeshWeaver.Layout/Template.cs
index f0602db47..5dd00499b 100644
--- a/src/MeshWeaver.Layout/Template.cs
+++ b/src/MeshWeaver.Layout/Template.cs
@@ -1,6 +1,7 @@
 using System.Linq.Expressions;
 using System.Reflection;
 using MeshWeaver.Data;
+using MeshWeaver.Data.Serialization;
 using MeshWeaver.Domain.Layout;
 using MeshWeaver.Layout.Composition;
 using MeshWeaver.Layout.DataBinding;
@@ -9,16 +10,34 @@
 namespace MeshWeaver.Layout;
 
 public static class Template{
-
     /// <summary>
     /// This is a generic template method which can be used if streams are connected to synchronize with Workspace.
     /// </summary>
-    /// <typeparam name="TView"></typeparam>
+    /// <typeparam name="TView">Type of the view</typeparam>
+    /// <typeparam name="TEntity">The type of the entity to be data bound</typeparam>
     /// <param name="id">Id to be referenced in the data binding</param>
     /// <param name="dataTemplate">View Template.</param>
-    /// <returns></returns>
-    public static TView Bind<TView>(string id, Expression<Func<object, TView>> dataTemplate)
-        where TView : UiControl => BindObject(null, id, dataTemplate);
+    /// <returns>The view template</returns>
+    public static TView Bind<TEntity, TView>(this ISynchronizationStream<TEntity> stream, string id, Expression<Func<TEntity, TView>> dataTemplate)
+        where TView : UiControl
+    {
+        object current = null;
+
+        return (TView)GetTemplateControl(id, dataTemplate)
+            .WithBuildup((host, context, store) =>
+            {
+                var forwardSubscription = stream.Subscribe(changeItem =>
+                {
+                    if (Equals(changeItem.Value, current))
+                        return;
+                    current = changeItem.Value;
+                    host.Stream.SetData(id, changeItem.SetValue(current));
+                });
+                host.AddDisposable(context.Area, forwardSubscription);
+                return new(store);
+            });
+
+    }
 
 
     /// <summary>
@@ -52,6 +71,33 @@ Expression<Func<T, TView>> dataTemplate
 
         return new ItemTemplateControl(view, data);
     }
+    /// <summary>
+    /// Takes expression tree of data template and replaces all property getters by binding instances and sets data context property
+    /// </summary>
+    [ReplaceBindMethod]
+    public static TView BindObservable<T, TView>(
+        this IObservable<T> stream,
+        string id,
+        Expression<Func<T, TView>> dataTemplate
+    )
+        where TView : UiControl
+    {
+        object current = null;
+        return (TView)GetTemplateControl(id, dataTemplate)
+            .WithBuildup((host, context, store) =>
+            {
+                var forwardSubscription = stream.Subscribe(val =>
+                {
+                    if (Equals(val, current))
+                        return;
+                    current = val;
+                    host.Stream.SetData(id, new ChangeItem<object>(host.Stream.Owner, host.Stream.Reference, val, host.Stream.Owner, null, host.Hub.Version));
+                });
+                host.AddDisposable(context.Area, forwardSubscription);
+                return new(store);
+            });
+    }
+
     private static readonly MethodInfo ItemTemplateMethodNonGeneric = ReflectionHelper.GetStaticMethodGeneric(
         () => ItemTemplateNonGeneric<object, UiControl>(default(IEnumerable<object>), null)
     );
@@ -99,12 +145,19 @@ Expression<Func<T, TView>> dataTemplate
     )
         where TView : UiControl
     {
-        var topLevel = UpdateData(data, id);
+        var view = GetTemplateControl(id, dataTemplate);
+        if(data != null)
+            view = (TView)view.WithBuildup((_,_,store) => store.UpdateData(id, data));
+        return view;
+    }
+
+    private static TView GetTemplateControl<T, TView>(string id, Expression<Func<T, TView>> dataTemplate)
+        where TView : UiControl
+    {
+        var topLevel = LayoutAreaReference.GetDataPointer(id);
         var view = dataTemplate.Build(topLevel, out var _);
         if (view == null)
             throw new ArgumentException("Data template was not specified.");
-        if(data != null)
-            view = (TView)view.WithUpdates(store => store.UpdateData(id, data));
         return view;
     }
 
@@ -170,7 +223,7 @@ Expression<Func<T, TView>> dataTemplate
                 {
                     DataContext = dataContext
                 }
-                .WithUpdates(store => store.UpdateData(id, data))
+                .WithBuildup((_,_,store) => store.UpdateData(id, data))
             ;
     }
 
diff --git a/src/MeshWeaver.Layout/UiControl.cs b/src/MeshWeaver.Layout/UiControl.cs
index 91a2721bc..d19ac4d17 100644
--- a/src/MeshWeaver.Layout/UiControl.cs
+++ b/src/MeshWeaver.Layout/UiControl.cs
@@ -69,11 +69,10 @@ public UiControl AddSkin(Skin skin)
     => this with { Skins = (Skins ?? ImmutableList<Skin>.Empty).Add(skin) };
 
 
-    protected ImmutableList<Func<EntityStore, EntityStoreAndUpdates>> Updates { get; init; } =
-        ImmutableList<Func<EntityStore, EntityStoreAndUpdates>>.Empty;
-    public UiControl WithUpdates(Func<EntityStore, EntityStoreAndUpdates> update)
+    protected ImmutableList<Func<LayoutAreaHost, RenderingContext, EntityStore, EntityStoreAndUpdates>> Buildup { get; init; } = [];
+    public UiControl WithBuildup(Func<LayoutAreaHost, RenderingContext, EntityStore, EntityStoreAndUpdates> buildup)
     {
-        return this with { Updates = Updates.Add(update) };
+        return this with { Buildup = Buildup.Add(buildup) };
     }
 
 
@@ -181,10 +180,10 @@ protected override void Dispose()
 
     protected override EntityStoreAndUpdates Render
         (LayoutAreaHost host, RenderingContext context, EntityStore store) =>
-        Updates
+        Buildup
             .Aggregate(RenderSelf(host, context, store), (r, u) =>
             {
-                var updated = u.Invoke(r.Store);
+                var updated = u.Invoke(host, context, r.Store);
                 return new(r.Changes.Concat(updated.Changes), updated.Store);
             });
     protected virtual EntityStoreAndUpdates RenderSelf(LayoutAreaHost host, RenderingContext context, EntityStore store)
diff --git a/test/MeshWeaver.Layout.Test/LayoutTest.cs b/test/MeshWeaver.Layout.Test/LayoutTest.cs
index d2d56e908..52adcbd0f 100644
--- a/test/MeshWeaver.Layout.Test/LayoutTest.cs
+++ b/test/MeshWeaver.Layout.Test/LayoutTest.cs
@@ -146,8 +146,7 @@ private static object UpdatingView()
 
         return Controls
             .Stack
-            .WithView( (_, _) =>
-                Template.Bind(toolbar, nameof(toolbar), tb => Controls.Text(tb.Year)), "Toolbar")
+            .WithView(Template.Bind(toolbar, nameof(toolbar), tb => Controls.Text(tb.Year)), "Toolbar")
             .WithView((area, _) =>
                 area.GetDataStream<Toolbar>(nameof(toolbar))
                     .Select(tb => Controls.Html($"Report for year {tb.Year}")), "Content");
@@ -166,7 +165,7 @@ public async Task TestUpdatingView()
         );
         var reportArea = $"{reference.Area}/Content";
         var content = await stream.GetControlStream(reportArea)
-            .Timeout(3.Seconds())
+           // .Timeout(3.Seconds())
             .FirstAsync(x => x is not null);
         content.Should().BeOfType<HtmlControl>().Which.Data.ToString().Should().Contain("2024");
 

From e6d721a032ef0c6d4b4dc6ef5f6ebce51ceaf51e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Fri, 4 Oct 2024 10:26:50 +0200
Subject: [PATCH 19/25] fixing string id for details view

---
 src/MeshWeaver.Documentation/DomainViews.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/MeshWeaver.Documentation/DomainViews.cs b/src/MeshWeaver.Documentation/DomainViews.cs
index 87a7c4251..8c7991428 100644
--- a/src/MeshWeaver.Documentation/DomainViews.cs
+++ b/src/MeshWeaver.Documentation/DomainViews.cs
@@ -40,7 +40,8 @@ public static object Details(LayoutAreaHost area, RenderingContext ctx)
         {
             var typeDefinition = typeSource.TypeDefinition;
             var idString = parts[1];
-            var id = JsonSerializer.Deserialize(idString, typeDefinition.GetKeyType());
+            var keyType = typeDefinition.GetKeyType();
+            var id = keyType == typeof(string) ? idString : JsonSerializer.Deserialize(idString, keyType);
             return area.Hub.ServiceProvider.GetRequiredService<IDomainLayoutService>().Render(new(area, typeDefinition, idString, id, ctx));
         }
         catch (Exception e)

From 86e6de0d313fd1c9ed25d6878ea3e227f77c6273 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Fri, 4 Oct 2024 23:05:14 +0200
Subject: [PATCH 20/25] added MeshWeaver.Azure.Publish

---
 .config/dotnet-tools.json                     | 12 +++
 Directory.Packages.props                      |  2 +
 MeshWeaver.sln                                |  8 +-
 .../MeshWeaver.Northwind.ViewModel.csproj     | 53 ++++++++-----
 .../MeshWeaver.Azure.Publish.csproj           | 23 ++++++
 ...eshWeaver.Azure.Publish.runtimeconfig.json |  9 +++
 src/MeshWeaver.Azure.Publish/Program.cs       | 77 +++++++++++++++++++
 src/MeshWeaver.Search/MarkdownIndexer.cs      |  3 +-
 src/MeshWeaver.Search/MeshArticleIndex.cs     | 19 +++++
 .../MeshWeaver.Search.csproj                  |  2 +-
 .../ArticleParsingTest.cs                     |  1 -
 11 files changed, 185 insertions(+), 24 deletions(-)
 create mode 100644 .config/dotnet-tools.json
 create mode 100644 src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
 create mode 100644 src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.runtimeconfig.json
 create mode 100644 src/MeshWeaver.Azure.Publish/Program.cs

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
new file mode 100644
index 000000000..49c65db34
--- /dev/null
+++ b/.config/dotnet-tools.json
@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "meshweaver.azure.publish": {
+      "version": "1.0.0",
+      "commands": [
+        "meshweaver-azure-publish"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/Directory.Packages.props b/Directory.Packages.props
index f4423de37..17c2af4d6 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -37,6 +37,8 @@
     <PackageVersion Include="Microsoft.Orleans.Serialization.Abstractions" Version="8.2.0" />
     <PackageVersion Include="OpenTelemetry" Version="1.9.0" />
     <PackageVersion Include="System.Collections.Immutable" Version="8.0.0" />
+    <PackageVersion Include="System.CommandLine" Version="2.0.0-beta4.22272.1" />
+    <PackageVersion Include="System.CommandLine.NamingConventionBinder" Version="2.0.0-beta4.22272.1" />
     <PackageVersion Include="System.Text.Encodings.Web" Version="8.0.0" />
     <PackageVersion Include="System.Text.Json" Version="8.0.4" />
     <PackageVersion Include="Microsoft.CodeAnalysis.Analyzers" Version="3.11.0-beta1.24219.2" />
diff --git a/MeshWeaver.sln b/MeshWeaver.sln
index 43cbe1b2e..d2738355d 100644
--- a/MeshWeaver.sln
+++ b/MeshWeaver.sln
@@ -207,8 +207,8 @@ EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "monolith", "monolith", "{4E1A12BB-5348-4DA4-B05F-F831DC16F7DE}"
 	ProjectSection(SolutionItems) = preProject
 		monolith\Directory.Build.props = monolith\Directory.Build.props
-		Readme.md = Readme.md
 		MIT License.md = MIT License.md
+		Readme.md = Readme.md
 	EndProjectSection
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MeshWeaver.Portal", "monolith\MeshWeaver.Portal\MeshWeaver.Portal.csproj", "{1471FB82-912E-411A-9141-096E0AECAAAE}"
@@ -221,6 +221,8 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MeshWeaver.Search", "src\Me
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MeshWeaver.Search.Test", "test\MeshWeaver.Search.Test\MeshWeaver.Search.Test.csproj", "{BDEC6D93-F212-456F-BEEE-DE2BADAE2A56}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MeshWeaver.Azure.Publish", "src\MeshWeaver.Azure.Publish\MeshWeaver.Azure.Publish.csproj", "{844B4566-81A4-4CB2-9761-9B174FB7BCCB}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -587,6 +589,10 @@ Global
 		{BDEC6D93-F212-456F-BEEE-DE2BADAE2A56}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{BDEC6D93-F212-456F-BEEE-DE2BADAE2A56}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{BDEC6D93-F212-456F-BEEE-DE2BADAE2A56}.Release|Any CPU.Build.0 = Release|Any CPU
+		{844B4566-81A4-4CB2-9761-9B174FB7BCCB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{844B4566-81A4-4CB2-9761-9B174FB7BCCB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{844B4566-81A4-4CB2-9761-9B174FB7BCCB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{844B4566-81A4-4CB2-9761-9B174FB7BCCB}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
diff --git a/modules/Northwind/MeshWeaver.Northwind.ViewModel/MeshWeaver.Northwind.ViewModel.csproj b/modules/Northwind/MeshWeaver.Northwind.ViewModel/MeshWeaver.Northwind.ViewModel.csproj
index 1c2e39df5..928174865 100644
--- a/modules/Northwind/MeshWeaver.Northwind.ViewModel/MeshWeaver.Northwind.ViewModel.csproj
+++ b/modules/Northwind/MeshWeaver.Northwind.ViewModel/MeshWeaver.Northwind.ViewModel.csproj
@@ -1,32 +1,48 @@
 <Project Sdk="Microsoft.NET.Sdk">
     <PropertyGroup>
+        <TargetFramework>net8.0</TargetFramework>
         <HasMeshNodes>true</HasMeshNodes>
         <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
     </PropertyGroup>
     <ItemGroup>
-    <ProjectReference Include="..\..\..\src\MeshWeaver.DataCubes\MeshWeaver.DataCubes.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Documentation\MeshWeaver.Domain.Layout.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Mesh.Contract\MeshWeaver.Mesh.Contract.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Messaging.Hub\MeshWeaver.Messaging.Hub.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Data\MeshWeaver.Data.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Import\MeshWeaver.Import.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Layout\MeshWeaver.Layout.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Pivot\MeshWeaver.Pivot.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Charting.Pivot\MeshWeaver.Charting.Pivot.csproj" />
-    <ProjectReference Include="..\..\..\src\MeshWeaver.Reporting\MeshWeaver.Reporting.csproj" />
-    <ProjectReference Include="..\MeshWeaver.Northwind.Model\MeshWeaver.Northwind.Model.csproj" />
-  </ItemGroup>
-  <ItemGroup>
-      <!-- Include all Markdown files in the Markdown folder as embedded resources -->
-      <EmbeddedResource Include="Markdown\**\*.md" />
-  </ItemGroup>
+        <ProjectReference Include="..\..\..\src\MeshWeaver.DataCubes\MeshWeaver.DataCubes.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Documentation\MeshWeaver.Domain.Layout.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Mesh.Contract\MeshWeaver.Mesh.Contract.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Messaging.Hub\MeshWeaver.Messaging.Hub.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Data\MeshWeaver.Data.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Import\MeshWeaver.Import.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Layout\MeshWeaver.Layout.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Pivot\MeshWeaver.Pivot.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Charting.Pivot\MeshWeaver.Charting.Pivot.csproj" />
+        <ProjectReference Include="..\..\..\src\MeshWeaver.Reporting\MeshWeaver.Reporting.csproj" />
+        <ProjectReference Include="..\MeshWeaver.Northwind.Model\MeshWeaver.Northwind.Model.csproj" />
+    </ItemGroup>
+
+    <ItemGroup>
+        <!-- Include all Markdown files in the Markdown folder as embedded resources -->
+        <EmbeddedResource Include="Markdown\**\*.md" />
+    </ItemGroup>
+
+    <UsingTask TaskName="MeshWeaver.BuildTasks.ProcessFilesTask" AssemblyFile="$(TargetDir)MeshWeaver.BuildTasks.dll" />
+
+    <Target Name="ProcessFiles" DependsOnTargets="Build">
+        <!-- Define the input files -->
+        <ItemGroup>
+            <InputFiles Include="Markdown\**\*.md" />
+        </ItemGroup>
+
+        <!-- Execute the custom task -->
+        <ProcessFilesTask InputFiles="@(InputFiles)" BlobStorageConnectionString="YourConnectionString" BlobContainerName="YourContainerName" Address="YourAddress" />
+    </Target>
+
     <PropertyGroup>
-        <!--generate xml comment files -->
+        <!-- Generate XML comment files -->
         <GenerateDocumentationFile>true</GenerateDocumentationFile>
         <DocumentationFile>bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml</DocumentationFile>
         <!-- Embed source files in the PDB -->
         <EmbedAllSources>true</EmbedAllSources>
     </PropertyGroup>
+
     <ItemGroup>
         <EmbeddedResource Include="bin\$(Configuration)\$(TargetFramework)\$(AssemblyName).xml">
             <LogicalName>$(AssemblyName).xml</LogicalName>
@@ -34,5 +50,4 @@
             <Embed>true</Embed>
         </EmbeddedResource>
     </ItemGroup>
-
-</Project>
+</Project>
\ No newline at end of file
diff --git a/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
new file mode 100644
index 000000000..f2f285cfd
--- /dev/null
+++ b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
@@ -0,0 +1,23 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+      <OutputType>Exe</OutputType>
+      <PackAsTool>true</PackAsTool>
+      <ToolCommandName>meshweaver-azure-publish</ToolCommandName>
+      <PackageVersion>1.0.0</PackageVersion>
+  </PropertyGroup>
+  <ItemGroup>
+      <PackageReference Include="Azure.Storage.Blobs" />
+      <PackageReference Include="System.CommandLine" />
+      <PackageReference Include="System.CommandLine.NamingConventionBinder" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\MeshWeaver.Search\MeshWeaver.Search.csproj" />
+  </ItemGroup>
+  <!--<ItemGroup>
+      <None Update="MeshWeaver.Azure.Publish.runtimeconfig.json">
+          <Pack>true</Pack>
+          <PackagePath>tools/net8.0/any/</PackagePath>
+      </None>
+  </ItemGroup>-->
+</Project>
diff --git a/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.runtimeconfig.json b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.runtimeconfig.json
new file mode 100644
index 000000000..170449ccb
--- /dev/null
+++ b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.runtimeconfig.json
@@ -0,0 +1,9 @@
+{
+  "runtimeOptions": {
+    "tfm": "net8.0",
+    "framework": {
+      "name": "Microsoft.NETCore.App",
+      "version": "8.0.0"
+    }
+  }
+}
diff --git a/src/MeshWeaver.Azure.Publish/Program.cs b/src/MeshWeaver.Azure.Publish/Program.cs
new file mode 100644
index 000000000..a394bfe06
--- /dev/null
+++ b/src/MeshWeaver.Azure.Publish/Program.cs
@@ -0,0 +1,77 @@
+using System.CommandLine;
+using System.CommandLine.NamingConventionBinder;
+using Azure.Storage.Blobs;
+using MeshWeaver.Search;
+
+namespace MeshWeaver.Azure.Publish
+{
+    public static class Program
+    {
+        public static async Task Main(string[] args)
+        {
+            var rootCommand = new RootCommand
+            {
+                new Option<string>(
+                    "--path",
+                    "The input files to process"),
+                new Option<string>(
+                    "--connection-string",
+                    "The connection string for the blob storage"),
+                new Option<string>(
+                    "--container",
+                    "The name of the blob container"),
+                new Option<string>(
+                    "--address",
+                    "The address to use")
+            };
+
+            rootCommand.Description = "MeshWeaver Build Tasks";
+
+            rootCommand.Handler = CommandHandler.Create<string, string, string, string>((filePath, blobStorageConnectionString, blobContainerName, address) =>
+            {
+                // Call your custom task logic here
+                Console.WriteLine($"Processing files from path: {filePath}");
+                Console.WriteLine($"Blob Storage Connection String: {blobStorageConnectionString}");
+                Console.WriteLine($"Blob Container Name: {blobContainerName}");
+                Console.WriteLine($"Address: {address}");
+            });
+
+            await rootCommand.InvokeAsync(args);
+        }
+
+        public static bool Execute(string connectionString, string container, string path, string address)
+        {
+            try
+            {
+                var blobServiceClient = new BlobServiceClient(connectionString);
+                var blobContainerClient = blobServiceClient.GetBlobContainerClient(container);
+
+                foreach (var inputFile in Directory.GetFiles(path))
+                {
+                    var filePath = Path.GetRelativePath(path, inputFile);
+                    var fileContent = File.ReadAllText(filePath);
+
+                    // Parse metadata and HTML
+                    var (article, html) = MarkdownIndexer.ParseArticle(filePath, fileContent, address);
+
+                    // Store metadata and HTML in blob storage
+                    var htmlBlobClient = blobContainerClient.GetBlobClient(Path.GetFileName(filePath));
+
+                    htmlBlobClient.Upload(new BinaryData(html));
+
+                    // Set metadata on the HTML blob
+                    htmlBlobClient.SetMetadata(article.ToMetadata());
+                }
+
+                return true;
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine(ex);
+                return false;
+            }
+        }
+
+
+    }
+}
diff --git a/src/MeshWeaver.Search/MarkdownIndexer.cs b/src/MeshWeaver.Search/MarkdownIndexer.cs
index eed0723b4..7d9e7cd5a 100644
--- a/src/MeshWeaver.Search/MarkdownIndexer.cs
+++ b/src/MeshWeaver.Search/MarkdownIndexer.cs
@@ -3,10 +3,9 @@
 using Markdig;
 using Markdig.Extensions.Yaml;
 using Markdig.Syntax;
-using MeshWeaver.Search;
 using Markdown = Markdig.Markdown;
 
-namespace MeshWeaver.Ai.Index;
+namespace MeshWeaver.Search;
 
 public static class MarkdownIndexer
 {
diff --git a/src/MeshWeaver.Search/MeshArticleIndex.cs b/src/MeshWeaver.Search/MeshArticleIndex.cs
index c4c5198d8..4e9e36d3c 100644
--- a/src/MeshWeaver.Search/MeshArticleIndex.cs
+++ b/src/MeshWeaver.Search/MeshArticleIndex.cs
@@ -1,4 +1,6 @@
 using System.ComponentModel.DataAnnotations;
+using System.Globalization;
+using System.Text.Json;
 using Azure.Search.Documents.Indexes;
 using Azure.Search.Documents.Indexes.Models;
 
@@ -25,4 +27,21 @@ public class MeshArticleIndex
     [VectorSearchField(VectorSearchDimensions = 1536, VectorSearchProfileName = "vector-profile")]
     public float[] VectorRepresentation { get; set; }
 
+
+    public IDictionary<string, string> ToMetadata() =>
+        new Dictionary<string, string>()
+        {
+            { nameof(Url), Url },
+            { nameof(Name), Name },
+            { nameof(Description), Description },
+            { nameof(Thumbnail), Thumbnail },
+            { nameof(Published), Published.ToString(CultureInfo.InvariantCulture) },
+            { nameof(Authors), JsonSerializer.Serialize(Authors) },
+            { nameof(Tags), JsonSerializer.Serialize(Tags) },
+            { nameof(Path), Path },
+        };
+
+
+
 }
+
diff --git a/src/MeshWeaver.Search/MeshWeaver.Search.csproj b/src/MeshWeaver.Search/MeshWeaver.Search.csproj
index 2c848d917..eb6b99c65 100644
--- a/src/MeshWeaver.Search/MeshWeaver.Search.csproj
+++ b/src/MeshWeaver.Search/MeshWeaver.Search.csproj
@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
-  <ItemGroup>
+    <ItemGroup>
     <PackageReference Include="Azure.Search.Documents" />
     <PackageReference Include="Markdig" />
   </ItemGroup>
diff --git a/test/MeshWeaver.Search.Test/ArticleParsingTest.cs b/test/MeshWeaver.Search.Test/ArticleParsingTest.cs
index 0e0f5f65f..4c78dad0f 100644
--- a/test/MeshWeaver.Search.Test/ArticleParsingTest.cs
+++ b/test/MeshWeaver.Search.Test/ArticleParsingTest.cs
@@ -1,7 +1,6 @@
 using System.Text;
 using Azure.Provisioning.Storage;
 using Azure.Storage.Blobs;
-using MeshWeaver.Ai.Index;
 using MeshWeaver.Hub.Fixture;
 using Xunit.Abstractions;
 

From 756d7357e165f37ad86d6b13826fa0b48b277d44 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Sat, 5 Oct 2024 16:01:44 +0200
Subject: [PATCH 21/25] iterating on publish tool

---
 .config/dotnet-tools.json                     |  2 +-
 Directory.Packages.props                      |  5 ++
 .../MeshWeaver.Azure.Publish.csproj           |  3 +-
 src/MeshWeaver.Azure.Publish/Program.cs       | 86 +++++++++++++++----
 4 files changed, 77 insertions(+), 19 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 49c65db34..8e3aae52b 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -5,7 +5,7 @@
     "meshweaver.azure.publish": {
       "version": "1.0.0",
       "commands": [
-        "meshweaver-azure-publish"
+        "MeshWeaver.Azure.Publish"
       ]
     }
   }
diff --git a/Directory.Packages.props b/Directory.Packages.props
index 17c2af4d6..6a70d02f2 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -16,6 +16,8 @@
     <PackageVersion Include="Azure.Provisioning.Storage" Version="0.2.0" />
     <PackageVersion Include="Azure.Search.Documents" Version="11.6.0" />
     <PackageVersion Include="Azure.Storage.Blobs" Version="12.22.0" />
+    <PackageVersion Include="Azure.Storage.Files.Shares" Version="12.22.0" />
+    <PackageVersion Include="Azure.Storage.Queues" Version="12.22.0" />
     <PackageVersion Include="Castle.Core" Version="5.1.1" />
     <PackageVersion Include="CSharpVitamins.ShortGuid" Version="2.0.0" />
     <PackageVersion Include="CsvHelper" Version="15.0.5" />
@@ -32,6 +34,9 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
       <PrivateAssets>all</PrivateAssets>
     </PackageVersion>
+    <PackageVersion Include="Microsoft.Extensions.Azure" Version="1.7.3" />
+    <PackageVersion Include="Microsoft.Extensions.Configuration.UserSecrets" Version="8.0.0" />
+    <PackageVersion Include="Microsoft.Extensions.Logging.Console" Version="8.0.0" />
     <PackageVersion Include="Microsoft.Orleans.Core.Abstractions" Version="8.2.0" />
     <PackageVersion Include="Microsoft.Orleans.Runtime" Version="8.2.0" />
     <PackageVersion Include="Microsoft.Orleans.Serialization.Abstractions" Version="8.2.0" />
diff --git a/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
index f2f285cfd..b1ae36a0f 100644
--- a/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
+++ b/src/MeshWeaver.Azure.Publish/MeshWeaver.Azure.Publish.csproj
@@ -2,11 +2,10 @@
   <PropertyGroup>
       <OutputType>Exe</OutputType>
       <PackAsTool>true</PackAsTool>
-      <ToolCommandName>meshweaver-azure-publish</ToolCommandName>
-      <PackageVersion>1.0.0</PackageVersion>
   </PropertyGroup>
   <ItemGroup>
       <PackageReference Include="Azure.Storage.Blobs" />
+      <PackageReference Include="Microsoft.Extensions.Logging.Console" />
       <PackageReference Include="System.CommandLine" />
       <PackageReference Include="System.CommandLine.NamingConventionBinder" />
   </ItemGroup>
diff --git a/src/MeshWeaver.Azure.Publish/Program.cs b/src/MeshWeaver.Azure.Publish/Program.cs
index a394bfe06..d38fdfea7 100644
--- a/src/MeshWeaver.Azure.Publish/Program.cs
+++ b/src/MeshWeaver.Azure.Publish/Program.cs
@@ -1,7 +1,9 @@
 using System.CommandLine;
 using System.CommandLine.NamingConventionBinder;
+using System.Text.Json;
 using Azure.Storage.Blobs;
 using MeshWeaver.Search;
+using Microsoft.Extensions.Logging;
 
 namespace MeshWeaver.Azure.Publish
 {
@@ -9,6 +11,12 @@ public static class Program
     {
         public static async Task Main(string[] args)
         {
+            using var loggerFactory = LoggerFactory.Create(builder =>
+            {
+                builder.AddConsole();
+            });
+            var logger = loggerFactory.CreateLogger(typeof(Program));
+
             var rootCommand = new RootCommand
             {
                 new Option<string>(
@@ -27,51 +35,97 @@ public static async Task Main(string[] args)
 
             rootCommand.Description = "MeshWeaver Build Tasks";
 
-            rootCommand.Handler = CommandHandler.Create<string, string, string, string>((filePath, blobStorageConnectionString, blobContainerName, address) =>
+            rootCommand.Handler = CommandHandler.Create<string, string, string, string>(async (path, connectionString, container, address) =>
             {
+                if (string.IsNullOrEmpty(path) || string.IsNullOrEmpty(connectionString) || string.IsNullOrEmpty(container) || string.IsNullOrEmpty(address))
+                {
+                    logger.LogError("Error: All options (--path, --connection-string, --container, --address) must be provided and cannot be null or empty.");
+                    return;
+                }
+
                 // Call your custom task logic here
-                Console.WriteLine($"Processing files from path: {filePath}");
-                Console.WriteLine($"Blob Storage Connection String: {blobStorageConnectionString}");
-                Console.WriteLine($"Blob Container Name: {blobContainerName}");
-                Console.WriteLine($"Address: {address}");
+                logger.LogInformation($"Processing files from path: {path}");
+                logger.LogInformation($"Blob Storage Connection String: {connectionString}");
+                logger.LogInformation($"Blob Container Name: {container}");
+                logger.LogInformation($"Address: {address}");
+
+                await ExecuteAsync(connectionString, container, path, address, logger);
             });
 
             await rootCommand.InvokeAsync(args);
         }
 
-        public static bool Execute(string connectionString, string container, string path, string address)
+        public static async Task<bool> ExecuteAsync(string connectionString, string container, string path, string address, ILogger logger)
         {
             try
             {
                 var blobServiceClient = new BlobServiceClient(connectionString);
                 var blobContainerClient = blobServiceClient.GetBlobContainerClient(container);
 
+                // Create the container if it doesn't exist
+                await blobContainerClient.CreateIfNotExistsAsync();
+
+                var localFiles = Directory.GetFiles(path).Select(f => Path.Combine(address, Path.GetRelativePath(path, f))).ToHashSet();
+                var blobs = blobContainerClient.GetBlobs().ToDictionary(b => b.Name);
+
+                // Delete blobs that no longer exist in the local directory
+                foreach (var blob in blobs)
+                {
+                    if (!localFiles.Contains(blob.Key))
+                    {
+                        logger.LogInformation($"Deleting blob {blob.Key} as it no longer exists in the local directory.");
+                        await blobContainerClient.DeleteBlobAsync(blob.Key);
+                    }
+                }
+
                 foreach (var inputFile in Directory.GetFiles(path))
                 {
-                    var filePath = Path.GetRelativePath(path, inputFile);
-                    var fileContent = File.ReadAllText(filePath);
+                    var filePath = Path.Combine(address, Path.GetRelativePath(path, inputFile));
+                    var fileContent = await File.ReadAllTextAsync(inputFile);
+                    var fileLastModified = File.GetLastWriteTimeUtc(inputFile);
 
-                    // Parse metadata and HTML
-                    var (article, html) = MarkdownIndexer.ParseArticle(filePath, fileContent, address);
+                    // Check if the blob exists and if the local file is newer
+                    if (blobs.TryGetValue(filePath, out var blobItem) && blobItem.Properties.LastModified >= fileLastModified)
+                    {
+                        logger.LogInformation($"Skipping upload for {filePath} as the blob is up-to-date.");
+                        continue;
+                    }
 
-                    // Store metadata and HTML in blob storage
-                    var htmlBlobClient = blobContainerClient.GetBlobClient(Path.GetFileName(filePath));
+                    logger.LogInformation($"Uploading file {inputFile} to {filePath}");
 
-                    htmlBlobClient.Upload(new BinaryData(html));
+                    if (Path.GetExtension(filePath) == "md")
+                        await ParseAndUploadHtml(address, logger, filePath, fileContent, blobContainerClient);
+
+                    // upload the file
+                    var markdownBlobClient = blobContainerClient.GetBlobClient(filePath);
+                    await markdownBlobClient.UploadAsync(new BinaryData(fileContent), overwrite: true);
 
-                    // Set metadata on the HTML blob
-                    htmlBlobClient.SetMetadata(article.ToMetadata());
                 }
 
                 return true;
             }
             catch (Exception ex)
             {
-                Console.WriteLine(ex);
+                logger.LogError(ex, "An error occurred during execution.");
                 return false;
             }
         }
 
+        private static async Task ParseAndUploadHtml(string address, ILogger logger, string filePath, string fileContent,
+            BlobContainerClient blobContainerClient)
+        {
+            // Parse metadata and HTML
+            var (article, html) = MarkdownIndexer.ParseArticle(filePath, fileContent, address);
+
+            // Store metadata and HTML in blob storage
+            var htmlFilePath = Path.ChangeExtension(filePath, ".html");
+            var htmlBlobClient = blobContainerClient.GetBlobClient(htmlFilePath);
+            await htmlBlobClient.UploadAsync(new BinaryData(html), overwrite: true);
 
+            // Set metadata on the HTML blob
+            var metadata = article.ToMetadata();
+            logger.LogInformation($"{JsonSerializer.Serialize(metadata)}");
+            await htmlBlobClient.SetMetadataAsync(metadata);
+        }
     }
 }

From 7e2ba51fc736a9e90561576be9bb6dba9cbcfb61 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Sun, 6 Oct 2024 16:16:02 +0200
Subject: [PATCH 22/25] Iterating on tool

---
 src/MeshWeaver.Azure.Publish/Program.cs   | 107 ++++++++++++++--------
 src/MeshWeaver.Search/MeshArticleIndex.cs |   5 +-
 2 files changed, 70 insertions(+), 42 deletions(-)

diff --git a/src/MeshWeaver.Azure.Publish/Program.cs b/src/MeshWeaver.Azure.Publish/Program.cs
index d38fdfea7..486ea0970 100644
--- a/src/MeshWeaver.Azure.Publish/Program.cs
+++ b/src/MeshWeaver.Azure.Publish/Program.cs
@@ -28,6 +28,9 @@ public static async Task Main(string[] args)
                 new Option<string>(
                     "--container",
                     "The name of the blob container"),
+                new Option<string>(
+                    "--html-container",
+                    "The name of the blob container containing pre-rendered html"),
                 new Option<string>(
                     "--address",
                     "The address to use")
@@ -35,7 +38,7 @@ public static async Task Main(string[] args)
 
             rootCommand.Description = "MeshWeaver Build Tasks";
 
-            rootCommand.Handler = CommandHandler.Create<string, string, string, string>(async (path, connectionString, container, address) =>
+            rootCommand.Handler = CommandHandler.Create<string, string, string, string, string>(async (path, connectionString, container, htmlContainer, address) =>
             {
                 if (string.IsNullOrEmpty(path) || string.IsNullOrEmpty(connectionString) || string.IsNullOrEmpty(container) || string.IsNullOrEmpty(address))
                 {
@@ -44,29 +47,28 @@ public static async Task Main(string[] args)
                 }
 
                 // Call your custom task logic here
-                logger.LogInformation($"Processing files from path: {path}");
-                logger.LogInformation($"Blob Storage Connection String: {connectionString}");
-                logger.LogInformation($"Blob Container Name: {container}");
-                logger.LogInformation($"Address: {address}");
-
-                await ExecuteAsync(connectionString, container, path, address, logger);
+                logger.LogInformation("Processing files from\npath: {path}\nstorage: {connectionString}\ncontainer: {container}\nhtmlContainer: {htmlContainer}\naddress: {address}", path, connectionString, container, htmlContainer, address);
+                await ExecuteAsync(connectionString, container, htmlContainer, path, address, logger);
             });
 
             await rootCommand.InvokeAsync(args);
         }
 
-        public static async Task<bool> ExecuteAsync(string connectionString, string container, string path, string address, ILogger logger)
+        public static async Task<bool> ExecuteAsync(string connectionString, string container, string htmlContainer, string path, string address, ILogger logger)
         {
             try
             {
                 var blobServiceClient = new BlobServiceClient(connectionString);
-                var blobContainerClient = blobServiceClient.GetBlobContainerClient(container);
+                var blobContainer = blobServiceClient.GetBlobContainerClient(container);
+                var htmlBlobContainer = htmlContainer == null ? null : blobServiceClient.GetBlobContainerClient(container);
 
                 // Create the container if it doesn't exist
-                await blobContainerClient.CreateIfNotExistsAsync();
+                await blobContainer.CreateIfNotExistsAsync();
+                if(htmlContainer != null)
+                    await htmlBlobContainer.CreateIfNotExistsAsync();
 
                 var localFiles = Directory.GetFiles(path).Select(f => Path.Combine(address, Path.GetRelativePath(path, f))).ToHashSet();
-                var blobs = blobContainerClient.GetBlobs().ToDictionary(b => b.Name);
+                var blobs = blobContainer.GetBlobs().ToDictionary(b => b.Name);
 
                 // Delete blobs that no longer exist in the local directory
                 foreach (var blob in blobs)
@@ -74,32 +76,43 @@ public static async Task<bool> ExecuteAsync(string connectionString, string cont
                     if (!localFiles.Contains(blob.Key))
                     {
                         logger.LogInformation($"Deleting blob {blob.Key} as it no longer exists in the local directory.");
-                        await blobContainerClient.DeleteBlobAsync(blob.Key);
+                        await blobContainer.DeleteBlobAsync(blob.Key);
                     }
                 }
 
                 foreach (var inputFile in Directory.GetFiles(path))
                 {
-                    var filePath = Path.Combine(address, Path.GetRelativePath(path, inputFile));
-                    var fileContent = await File.ReadAllTextAsync(inputFile);
-                    var fileLastModified = File.GetLastWriteTimeUtc(inputFile);
-
-                    // Check if the blob exists and if the local file is newer
-                    if (blobs.TryGetValue(filePath, out var blobItem) && blobItem.Properties.LastModified >= fileLastModified)
+                    try
                     {
-                        logger.LogInformation($"Skipping upload for {filePath} as the blob is up-to-date.");
-                        continue;
+                        var filePath = Path.Combine(address, Path.GetRelativePath(path, inputFile)).Replace('\\', '/');
+                        var fileContent = await File.ReadAllTextAsync(inputFile);
+                        var fileLastModified = File.GetLastWriteTimeUtc(inputFile);
+
+                        // Check if the blob exists and if the local file is newer
+                        if (blobs.TryGetValue(filePath, out var blobItem) && blobItem.Properties.LastModified >= fileLastModified)
+                        {
+                            logger.LogInformation($"Skipping upload for {filePath} as the blob is up-to-date.");
+                            continue;
+                        }
+
+                        var extension = Path.GetExtension(filePath);
+                        logger.LogInformation($"Uploading file {inputFile} to {filePath}. Parsing as {extension}");
+
+                        var metadata = extension switch
+                        {
+                            ".md" => await ParseMarkdown(address, logger, filePath, fileContent, htmlBlobContainer),
+                            _ => DefaultMetadata(filePath, extension.Trim('.'))
+                        };
+
+                        logger.LogInformation("Uploading {filePath} with {metadata}", filePath, JsonSerializer.Serialize(metadata));
+                        var blob = blobContainer.GetBlobClient(filePath);
+                        await blob.UploadAsync(new BinaryData(fileContent), overwrite: true);
+                        await blob.SetMetadataAsync(metadata);
+                    }
+                    catch (Exception ex)
+                    {
+                        logger.LogError(ex, "An error occurred during file upload.");
                     }
-
-                    logger.LogInformation($"Uploading file {inputFile} to {filePath}");
-
-                    if (Path.GetExtension(filePath) == "md")
-                        await ParseAndUploadHtml(address, logger, filePath, fileContent, blobContainerClient);
-
-                    // upload the file
-                    var markdownBlobClient = blobContainerClient.GetBlobClient(filePath);
-                    await markdownBlobClient.UploadAsync(new BinaryData(fileContent), overwrite: true);
-
                 }
 
                 return true;
@@ -111,21 +124,35 @@ public static async Task<bool> ExecuteAsync(string connectionString, string cont
             }
         }
 
-        private static async Task ParseAndUploadHtml(string address, ILogger logger, string filePath, string fileContent,
-            BlobContainerClient blobContainerClient)
+        private static Dictionary<string, string> DefaultMetadata(string filePath, string type)
+        {
+            return new Dictionary<string, string>
+            {
+                { "type", type },
+                { "path", filePath }
+            };
+}
+
+        private static async Task<IDictionary<string, string>> ParseMarkdown(string address, ILogger logger, string filePath, string fileContent, BlobContainerClient htmlContainer)
         {
             // Parse metadata and HTML
             var (article, html) = MarkdownIndexer.ParseArticle(filePath, fileContent, address);
 
-            // Store metadata and HTML in blob storage
-            var htmlFilePath = Path.ChangeExtension(filePath, ".html");
-            var htmlBlobClient = blobContainerClient.GetBlobClient(htmlFilePath);
-            await htmlBlobClient.UploadAsync(new BinaryData(html), overwrite: true);
-
             // Set metadata on the HTML blob
-            var metadata = article.ToMetadata();
-            logger.LogInformation($"{JsonSerializer.Serialize(metadata)}");
-            await htmlBlobClient.SetMetadataAsync(metadata);
+            var metadata = article?.ToMetadata(filePath, "md") ?? DefaultMetadata(filePath, "md");
+
+            if (htmlContainer != null)
+            {
+                // Store metadata and HTML in blob storage
+                var htmlFilePath = Path.ChangeExtension(filePath, ".html");
+                logger.LogInformation("Uploading pre-rendered html {path}", htmlFilePath);
+                var htmlBlobClient = htmlContainer.GetBlobClient(htmlFilePath);
+                await htmlBlobClient.UploadAsync(new BinaryData(html), overwrite: true);
+                await htmlBlobClient.SetMetadataAsync(metadata);
+
+            }
+
+            return metadata;
         }
     }
 }
diff --git a/src/MeshWeaver.Search/MeshArticleIndex.cs b/src/MeshWeaver.Search/MeshArticleIndex.cs
index 4e9e36d3c..4f5cca7d9 100644
--- a/src/MeshWeaver.Search/MeshArticleIndex.cs
+++ b/src/MeshWeaver.Search/MeshArticleIndex.cs
@@ -28,7 +28,7 @@ public class MeshArticleIndex
     public float[] VectorRepresentation { get; set; }
 
 
-    public IDictionary<string, string> ToMetadata() =>
+    public IDictionary<string, string> ToMetadata(string path, string type) =>
         new Dictionary<string, string>()
         {
             { nameof(Url), Url },
@@ -38,7 +38,8 @@ public IDictionary<string, string> ToMetadata() =>
             { nameof(Published), Published.ToString(CultureInfo.InvariantCulture) },
             { nameof(Authors), JsonSerializer.Serialize(Authors) },
             { nameof(Tags), JsonSerializer.Serialize(Tags) },
-            { nameof(Path), Path },
+            { nameof(Path), path },
+            { nameof(Type), type },
         };
 
 

From 194bea150d26514c9c6ca6f3e5f5d0a6af5d8d82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Sun, 6 Oct 2024 20:20:43 +0200
Subject: [PATCH 23/25] fixes

---
 src/MeshWeaver.Azure.Publish/Program.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/MeshWeaver.Azure.Publish/Program.cs b/src/MeshWeaver.Azure.Publish/Program.cs
index 486ea0970..620551468 100644
--- a/src/MeshWeaver.Azure.Publish/Program.cs
+++ b/src/MeshWeaver.Azure.Publish/Program.cs
@@ -67,8 +67,9 @@ public static async Task<bool> ExecuteAsync(string connectionString, string cont
                 if(htmlContainer != null)
                     await htmlBlobContainer.CreateIfNotExistsAsync();
 
-                var localFiles = Directory.GetFiles(path).Select(f => Path.Combine(address, Path.GetRelativePath(path, f))).ToHashSet();
-                var blobs = blobContainer.GetBlobs().ToDictionary(b => b.Name);
+
+                var localFiles = Directory.GetFiles(path, "*", SearchOption.AllDirectories).Select(f => Path.Combine(address, Path.GetRelativePath(path, f))).ToHashSet();
+                var blobs = blobContainer.GetBlobs(prefix:address).ToDictionary(b => b.Name);
 
                 // Delete blobs that no longer exist in the local directory
                 foreach (var blob in blobs)

From 003a85eb0a2eae87ec9f8f43cedc9f53a2ba7fd4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Mon, 7 Oct 2024 18:33:05 +0200
Subject: [PATCH 24/25] Fix test

---
 .../SynchronizationStreamTest.cs              | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/test/MeshWeaver.Data.Test/SynchronizationStreamTest.cs b/test/MeshWeaver.Data.Test/SynchronizationStreamTest.cs
index 74a6b5aa4..fecd07ae9 100644
--- a/test/MeshWeaver.Data.Test/SynchronizationStreamTest.cs
+++ b/test/MeshWeaver.Data.Test/SynchronizationStreamTest.cs
@@ -40,14 +40,19 @@ public async Task ParallelUpdate()
             .Subscribe(tracker.Add);
 
         var count = 0;
-        Enumerable.Range(0, 10).AsParallel().ForEach(_ => stream.Update(state =>
+        Enumerable.Range(0, 10).AsParallel().Select(_ =>
         {
-            var instance = new MyData(Instance, (++count).ToString());
-            var existingInstance = state.Collections.GetValueOrDefault(collectionName)?.Instances.GetValueOrDefault(Instance);
-            return stream.ApplyChanges(
-                (state ?? new()).Update(collectionName, i => i.Update(Instance, instance)),
-                [new(collectionName, Instance, instance){OldValue = existingInstance }]);
-        }));
+            stream.Update(state =>
+            {
+                var instance = new MyData(Instance, (++count).ToString());
+                var existingInstance = state.Collections.GetValueOrDefault(collectionName)?.Instances
+                    .GetValueOrDefault(Instance);
+                return stream.ApplyChanges(
+                    (state ?? new()).Update(collectionName, i => i.Update(Instance, instance)),
+                    [new(collectionName, Instance, instance) { OldValue = existingInstance }]);
+            });
+            return true;
+        }).ToArray();
         await DisposeAsync();
 
         tracker.Should().HaveCount(10)

From 8f9fa0f3f81e0610cb8075492b03113c7dead791 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roland=20B=C3=BCrgi?= <rbuergi@systemorph.com>
Date: Mon, 7 Oct 2024 18:49:43 +0200
Subject: [PATCH 25/25] fixing stream initialization

---
 .../Serialization/SynchronizationStream.cs           | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/src/MeshWeaver.Data/Serialization/SynchronizationStream.cs b/src/MeshWeaver.Data/Serialization/SynchronizationStream.cs
index d1c0e73f3..f18cbad6f 100644
--- a/src/MeshWeaver.Data/Serialization/SynchronizationStream.cs
+++ b/src/MeshWeaver.Data/Serialization/SynchronizationStream.cs
@@ -146,6 +146,7 @@ public virtual void Initialize(ChangeItem<TStream> initial)
         current = initial ?? throw new ArgumentNullException(nameof(initial));
         Store.OnNext(initial);
         initialized.SetResult(current.Value);
+        deferral.Dispose();
     }
 
     public void OnCompleted()
@@ -181,8 +182,13 @@ IMessageDelivery<WorkspaceMessage> delivery
     public void Update(Func<TStream, ChangeItem<TStream>> update) => 
         InvokeAsync(() => SetCurrent(update.Invoke(Current is null ? default : Current.Value)));
 
-    public void OnNext(ChangeItem<TStream> value) =>
-        InvokeAsync(() => SetCurrent(value));
+    public void OnNext(ChangeItem<TStream> value)
+    {
+        if(!IsInitialized)
+            Initialize(value);
+        else
+            InvokeAsync(() => SetCurrent(value));
+    }
 
     public virtual DataChangeResponse RequestChange(Func<TStream, ChangeItem<TStream>> update)
     {
@@ -207,6 +213,7 @@ public SynchronizationStream(object Owner,
         this.Reference = Reference;
         this.InitializationMode = InitializationMode;
         synchronizationStreamHub = Hub.GetHostedHub(new SynchronizationStreamAddress(Hub.Address));
+        deferral = synchronizationStreamHub.Defer(_ => true);
     }
 
 
@@ -226,6 +233,7 @@ private record SynchronizationStreamAddress(object Host) : IHostedAddress
     }
 
     private readonly IMessageHub synchronizationStreamHub;
+    private readonly IDisposable deferral;
 
     //private void InvokeAsync(Func<CancellationToken, Task> task)
     //    => synchronizationStreamHub.InvokeAsync(task);