chore: refactored samples folder and converted solution to using .slnx

.github/workflows/ci.yml

@@ -51,22 +51,22 @@ jobs:
                       10.0.x
 
             - name: Restore
-              run: dotnet restore src/Blazing.Mvvm.CI.slnf
+              run: dotnet restore src/Blazing.Mvvm.slnx
 
             - name: Build
-              run: dotnet build src/Blazing.Mvvm.CI.slnf --no-restore --configuration Release -p:GeneratePackageOnBuild=false
+              run: dotnet build src/Blazing.Mvvm.slnx --no-restore --configuration Release -p:GeneratePackageOnBuild=false
 
             - name: Test (${{ matrix.framework }})
               run: |
-                  dotnet test src/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj \
+                  dotnet test src/Tests/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj \
                     --no-build \
                     --configuration Release \
                     --framework ${{ matrix.framework }} \
                     --logger "trx;LogFileName=test-results-${{ matrix.framework }}.trx"
 
             - name: Test Analyzers (${{ matrix.framework }})
               run: |
-                  dotnet test src/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj \
+                  dotnet test src/Tests/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj \
                     --no-build \
                     --configuration Release \
                     --framework ${{ matrix.framework }} \

.github/workflows/release.yml

@@ -24,25 +24,25 @@ jobs:
                       10.0.x
 
             - name: Restore
-              run: dotnet restore src/Blazing.Mvvm.CI.slnf
+              run: dotnet restore src/Blazing.Mvvm.slnx
 
             - name: Build
-              run: dotnet build src/Blazing.Mvvm.CI.slnf --no-restore --configuration Release -p:GeneratePackageOnBuild=false
+              run: dotnet build src/Blazing.Mvvm.slnx --no-restore --configuration Release -p:GeneratePackageOnBuild=false
 
             - name: Test (net8.0)
               run: |
-                  dotnet test src/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net8.0
-                  dotnet test src/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net8.0
+                  dotnet test src/Tests/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net8.0
+                  dotnet test src/Tests/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net8.0
 
             - name: Test (net9.0)
               run: |
-                  dotnet test src/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net9.0
-                  dotnet test src/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net9.0
+                  dotnet test src/Tests/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net9.0
+                  dotnet test src/Tests/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net9.0
 
             - name: Test (net10.0)
               run: |
-                  dotnet test src/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net10.0
-                  dotnet test src/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net10.0
+                  dotnet test src/Tests/Blazing.Mvvm.Tests/Blazing.Mvvm.Tests.csproj --no-build --configuration Release --framework net10.0
+                  dotnet test src/Tests/Blazing.Mvvm.Analyzers.Tests/Blazing.Mvvm.Analyzers.Tests.csproj --no-build --configuration Release --framework net10.0
 
             - name: Extract version from Directory.Build.props
               id: version
@@ -67,9 +67,9 @@ jobs:
             - name: Pack NuGet packages
               if: steps.tag_check.outputs.exists == 'false'
               run: |
-                  dotnet pack src/Blazing.Mvvm.Base/Blazing.Mvvm.Base.csproj \
+                  dotnet pack src/Libraries/Blazing.Mvvm.Base/Blazing.Mvvm.Base.csproj \
                     --no-build --configuration Release --output ./artifacts
-                  dotnet pack src/Blazing.Mvvm/Blazing.Mvvm.csproj \
+                  dotnet pack src/Libraries/Blazing.Mvvm/Blazing.Mvvm.csproj \
                     --no-build --configuration Release --output ./artifacts
 
             - name: Create GitHub Release

.gitignore

@@ -35,6 +35,10 @@ bld/
 
 # Visual Studio 2015/2017 cache/options directory
 .vs/
+
+# Local developer-only sample overrides
+samples/Directory.Build.local.props
+
 # VS Code workspace settings
 .vscode/
 # Uncomment if you have tasks that create the project's static files in wwwroot
@@ -366,4 +370,4 @@ MigrationBackup/
 .ionide/
 
 # Fody - auto-generated XML schema
-FodyWeavers.xsd
+FodyWeavers.xsd

HISTORY.md

@@ -1,101 +1,116 @@
 # Version History
+
 <!-- TOC -->
-#### Table of Contents
-
-- [V3.2.1 - 2 February 2026](#v3.2.1-2-february-2026)
-- [V3.2.0 - 7 January 2026](#v3.2.0-7-january-2026)
-- [V3.1.0 - 3 December 2025](#v3.1.0-3-december-2025)
-- [V3.0.0 - 18 November 2025](#v3.0.0-18-november-2025)
-- [V2.2.0 7 December, 2024](#v2.2.0-7-december-2024)
-- [V2.1.1 4 December, 2024](#v2.1.1-4-december-2024)
-- [V2.1.0 3 December, 2024](#v2.1.0-3-december-2024)
-- [V2.0.0 30 November, 2024](#v2.0.0-30-november-2024)
-- [v1.4.0 21 November, 2023](#v1.4.0-21-november-2023)
-- [v1.3.0 (beta) 1 November, 2023](#v1.3.0-beta-1-november-2023)
-- [v1.2.1 1 November, 2023](#v1.2.1-1-november-2023)
-- [26 October, 2023](#october-2023)
-- [v1.1.0 9 October, 2023](#v1.1.0-9-october-2023)
-- [v1.0.2 27 July, 2023](#v1.0.2-27-july-2023)
-- [v1.0.2 25 July, 2023](#v1.0.2-25-july-2023)
-- [v1.0.1 19 May, 2023](#v1.0.1-19-may-2023)
-- [v1.0.0 10 May, 2023-](#v1.0.0-10-may-2023)
+## Table of Contents
+
+- [Version History](#version-history)
+  - [Table of Contents](#table-of-contents)
+  - [V3.2.1 - 2 February 2026](#v321---2-february-2026)
+  - [V3.2.0 - 7 January 2026](#v320---7-january-2026)
+  - [V3.1.0 - 3 December 2025](#v310---3-december-2025)
+  - [V3.0.0 - 18 November 2025](#v300---18-november-2025)
+  - [V2.2.0 7 December, 2024](#v220-7-december-2024)
+  - [V2.1.1 4 December, 2024](#v211-4-december-2024)
+  - [V2.1.0 3 December, 2024](#v210-3-december-2024)
+  - [V2.0.0 30 November, 2024](#v200-30-november-2024)
+  - [v1.4.0 21 November, 2023](#v140-21-november-2023)
+  - [v1.3.0 (beta) 1 November, 2023](#v130-beta-1-november-2023)
+  - [v1.2.1 1 November, 2023](#v121-1-november-2023)
+  - [26 October, 2023](#26-october-2023)
+  - [v1.1.0 9 October, 2023](#v110-9-october-2023)
+  - [v1.0.2 27 July, 2023](#v102-27-july-2023)
+  - [v1.0.2 25 July, 2023](#v102-25-july-2023)
+  - [v1.0.1 19 May, 2023](#v101-19-may-2023)
+  - [v1.0.0 10 May, 2023](#v100-10-may-2023)
 
 <!-- TOC -->
 
-### V3.2.1 - 2 February 2026
+## V3.2.1 - 2 February 2026
 
 This maintenance release focuses on improvements to the sample project and bug fixes.
 
 **Improvements:**
+
 - **IAsyncRelayCommand Edge Case Fix:** ([Issue #65](https://github.com/gragra33/Blazing.Mvvm/issues/65)) Improved support for edge cases where `PropertyChanged` events were blocked when `ExecutionTask` is awaited, particularly when `AllowConcurrentExecutions` is set to `false`. This ensures UI updates propagate correctly even when awaiting long-running async commands. [@gragra33](https://github.com/gragra33) & [@teunlielu](https://github.com/teunlielu)
 
 > [!WARNING]
 > Updates to `ViewModelBase` and `ValidatorViewModelBase` now implement `IDisposable` for `PropertyChanged` event tracking. This may cause build errors when `IDisposable` is implemented manually. Use `protected override void Dispose(bool disposing)` to handle manual disposal in derived classes.
 
 **Sample Project Refactoring:**
-- **Major Consolidation:** Refactored `Blazing.Mvvm.Sample.Server`, `Blazing.Mvvm.Sample.Wasm`, `Blazing.Mvvm.Sample.WebApp`, `Blazing.Mvvm.Sample.HybridMaui`, and `Blazing.SubpathHosting.Server` to use a centralized **` Blazing.Mvvm.Sample.Shared`** library. [@gragra33](https://github.com/gragra33)
+
+- **Major Consolidation:** Refactored `Blazing.Mvvm.Sample.Server`, `Blazing.Mvvm.Sample.Wasm`, `Blazing.Mvvm.Sample.WebApp`, `Blazing.Mvvm.Sample.HybridMaui`, and `Blazing.SubpathHosting.Server` to use a centralized **`Blazing.Mvvm.Sample.Shared`** library. [@gragra33](https://github.com/gragra33)
 - **Integrated Standalone Samples:** Moved content from `ParameterResolution.Sample.Wasm` and `Blazing.Mvvm.ParentChildSample` into the shared library, making these patterns available across all sample applications. [@gragra33](https://github.com/gragra33)
 - **New RelayCommand Sample Page:** Added comprehensive `RelayCommands` page demonstrating synchronous and asynchronous command patterns, `AllowConcurrentExecutions` behavior, command parameters, and `CanExecute` validation. [@gragra33](https://github.com/gragra33)
 
 **Component Libraries:**
+
 - **MvvmButton Component:** New MVVM-aware button component (`Blazing.Buttons`) with integrated command binding and automatic state management. [@gragra33](https://github.com/gragra33)
 - **Bootstrap Components:** Added production-ready Bootstrap 5 wrapper components, including `BootstrapAccordion`, `BootstrapBreadcrumbs`, `BootstrapCard`, `BootstrapNavMenu`, and `BootstrapRowGroup` to `Blazing.Mvvm.Sample.Shared`. [@gragra33](https://github.com/gragra33)
 - **ConditionalSwitch Component:** Added declarative conditional rendering components (`ConditionalSwitch`, `When`, `Otherwise`) to `Blazing.Common` library. [@gragra33](https://github.com/gragra33)
 
 **Documentation:**
+
 - Updated `Blazing.SubpathHosting.Server` readme with comprehensive information about sample architecture, component libraries, and recent updates. [@gragra33](https://github.com/gragra33)
-- Added reference to **[Subpath_Hosting_Guidance.md](https://github.com/gragra33/Blazing.Mvvm/tree/master/src/samples/Blazing.SubpathHosting.Server/Subpath_Hosting_Guidance.md)** for detailed subpath hosting best practices. [@gragra33](https://github.com/gragra33)
+- Added reference to **[Subpath_Hosting_Guidance.md](https://github.com/gragra33/Blazing.Mvvm/tree/master/samples/Blazing.SubpathHosting.Server/Subpath_Hosting_Guidance.md)** for detailed subpath hosting best practices. [@gragra33](https://github.com/gragra33)
 
 **Benefits of Refactoring:**
+
 - Demonstrates best practices for code sharing across Blazor hosting models (Server, WebAssembly, Web App, Hybrid MAUI)
 - Reduces code duplication and maintenance overhead
 - Provides consistent examples across all hosting models
 - Easier to add new features that work everywhere
 
-### V3.2.0 - 7 January 2026
+## V3.2.0 - 7 January 2026
 
 This release adds support for:
-  - automatic two-way binding support, eliminating the need for manual PropertyChanged event handling in components. [@gragra33](https://github.com/gragra33)
-  - complex route patterns with multiple parameters and query strings. [@gragra33](https://github.com/gragra33)
+
+- automatic two-way binding support, eliminating the need for manual PropertyChanged event handling in components. [@gragra33](https://github.com/gragra33)
+- complex route patterns with multiple parameters and query strings. [@gragra33](https://github.com/gragra33)
 
 **New Features:**
+
 - **Automatic Two-Way Binding:** Components with `EventCallback<T>` parameters following the `{PropertyName}Changed` convention and corresponding `[ViewParameter]` properties in ViewModels now automatically wire up two-way binding. [@gragra33](https://github.com/gragra33)
-- **Multi-Parameter Route Support:** Full support for routes with multiple parameters (e.g., `/users/{userId}/posts/{postId}`). 
-- **Enhanced Route Parameter Substitution:** Smart substitution of route parameters with proper URL encoding and query string handling. 
-- **Combined Parameters + Query Strings:** Navigate with both route parameters and query strings in a single call (e.g., `1/101?filter=recent&sort=desc`). 
-- **Complex Multi-Level Routes:** Support for deeply nested routes with multiple segments and parameters. 
+- **Multi-Parameter Route Support:** Full support for routes with multiple parameters (e.g., `/users/{userId}/posts/{postId}`).
+- **Enhanced Route Parameter Substitution:** Smart substitution of route parameters with proper URL encoding and query string handling.
+- **Combined Parameters + Query Strings:** Navigate with both route parameters and query strings in a single call (e.g., `1/101?filter=recent&sort=desc`).
+- **Complex Multi-Level Routes:** Support for deeply nested routes with multiple segments and parameters.
 
-**New Sample:** 
-- [ParameterResolution.Sample.Wasm](https://github.com/gragra33/Blazing.Mvvm/tree/master/src/samples/ParameterResolution.Sample.Wasm)** - Demonstrates parameter resolution between Views and ViewModels using `ViewParameter` attribute, and automatic two-way binding with `@bind-` syntax
+**New Sample:**
+
+- [ParameterResolution.Sample.Wasm](https://github.com/gragra33/Blazing.Mvvm/tree/master/samples/libs/Blazing.Mvvm.Sample.Shared/Pages/ParameterResolution) - Demonstrates parameter resolution between Views and ViewModels using `ViewParameter` attribute, and automatic two-way binding with `@bind-` syntax
 
 **Updated Samples:**
+
 - Updated sample projects to demonstrate complex route patterns:
   - `Blazing.Mvvm.Sample.Server`, `Blazing.Mvvm.Sample.WebApp`, `Blazing.Mvvm.Sample.Wasm`, `Blazing.Mvvm.Sample.HybridMaui`
 
-### V3.1.0 - 3 December 2025
+## V3.1.0 - 3 December 2025
 
 This release adds automatic base path detection for YARP reverse proxy scenarios and simplifies configuration.
 
 **New Features:**
+
 - **Automatic Base Path Detection:** Base path is now automatically detected from `NavigationManager.BaseUri`, eliminating the need for manual `BasePath` configuration in most scenarios. [@gragra33](https://github.com/gragra33) & [@teunlielu](https://github.com/teunlielu)
 - **YARP Support:** Full support for YARP (Yet Another Reverse Proxy) with automatic detection of dynamically assigned paths via `PathBase`. [@gragra33](https://github.com/gragra33) & [@teunlielu](https://github.com/teunlielu)
 - **Dynamic Per-Request Base Paths:** Supports scenarios where different requests have different base paths, ideal for multi-tenant applications. [@gragra33](https://github.com/gragra33) & [@teunlielu](https://github.com/teunlielu)
 
 **Improvements:**
+
 - `BasePath` property is now marked as `[Obsolete]` but remains functional for backward compatibility. [@gragra33](https://github.com/gragra33)
 - Added new unit tests and integration tests for dynamic base path scenarios. [@gragra33](https://github.com/gragra33)
 - Enhanced logging for base path detection to aid in diagnostics. [@gragra33](https://github.com/gragra33)
 - Updated documentation with YARP configuration examples and best practices. [@gragra33](https://github.com/gragra33)
 - Updated `Blazing.SubpathHosting.Server` to support new base path detection features.[@gragra33](https://github.com/gragra33)
 
 **Configuration:**
+
 - **No configuration required** for most scenarios - base path is automatically detected
 - For YARP scenarios, simply use `app.UseForwardedHeaders()` and optionally handle `X-Forwarded-Prefix` header
 - Existing code using `BasePath` is now marked `obsolete`, but continues to work without changes. Will be removed in a future release.
 
-See the [Subpath Hosting](../readme.md#subpath-hosting) section in the readme for updated configuration examples.
+See the [Subpath Hosting](README.md#subpath-hosting) section in the readme for updated configuration examples.
 
-### V3.0.0 - 18 November 2025
+## V3.0.0 - 18 November 2025
 
 This is a major release with new features and enhancements.
 
@@ -113,19 +128,19 @@ This is a major release with new features and enhancements.
   - Running samples with different .NET target frameworks
 - Documentation updates and improvements. [@gragra33](https://github.com/gragra33)
 
-### V2.2.0 7 December, 2024
+## V2.2.0 7 December, 2024
 
 - Added support for `ObservableRecipient` being set to inactive when disposing the `MvvmComponentBase`, `MvvmOwningComponentBase`, `MvvmLayoutComponentBase`, and `RecipientViewModelBase`. [@gragra33](https://github.com/gragra33) & [@teunlielu](https://github.com/teunlielu)
 
-### V2.1.1 4 December, 2024
+## V2.1.1 4 December, 2024
 
 - Version bump to fix a nuget release issue
 
-### V2.1.0 3 December, 2024
+## V2.1.0 3 December, 2024
 
 - Added MAUI Blazor Hybrid App support + sample HybridMaui app. [@hakakou](https://github.com/hakakou)
 
-### V2.0.0 30 November, 2024
+## V2.0.0 30 November, 2024
 
 This is a major release with breaking changes, migration notes can be found [here](docs/migration-notes/v1.4_to_v2.md).
 
@@ -141,43 +156,45 @@ This is a major release with breaking changes, migration notes can be found [her
 - Documentation updates. [@mishael-o](https://github.com/mishael-o) & [@gragra33](https://github.com/gragra33)
 
 **BREAKING CHANGES:**
+
 - Renamed `BlazorHostingModel` to `BlazorHostingModelType` to avoid confusion
 
-### v1.4.0 21 November, 2023
+## v1.4.0 21 November, 2023
 
 - Now officially supports .Net 8.0 & .Net 7.0
 
-### v1.3.0 (beta) 1 November, 2023
+## v1.3.0 (beta) 1 November, 2023
 
 - pre-release of .Net 8.0 RC2 `(Auto) Blazor WebApp` with new hosting model configuration support
 
-### v1.2.1 1 November, 2023
+## v1.2.1 1 November, 2023
 
 - added .Net 7.0+ `Blazor Server App` support
 - new hosting model configuration support added. Special thanks to [@bbunderson](https://github.com/bbunderson) for implementation.
 
-### 26 October, 2023
+## 26 October, 2023
 
 - pre-release of .Net 7.0+ `Blazor Server App` support
 - pre-release of .Net 8.0 RC2 `(Auto) Blazor WebApp` support
 
-### v1.1.0 9 October, 2023
+## v1.1.0 9 October, 2023
 
 - Added `MvvmLayoutComponentBase` to support MVVM in the MainLayout.razor
 - Updated sample project with example of `MvvmLayoutComponentBase` usage
 
-### v1.0.2 27 July, 2023
+## v1.0.2 27 July, 2023
 
 - Fixed rare crossthread issue in MvvmComponentBase
 
-### v1.0.2 25 July, 2023
+## v1.0.2 25 July, 2023
 
 - Added Added logging at start and end of `MvvmNavigationManager` cache generation for improved debugging experience
 
-### v1.0.1 19 May, 2023
+## v1.0.1 19 May, 2023
 
 - Added non-generic `RecipientViewModelBase`
 - Added `ValidatorViewModelBase`
 
-### v1.0.0 10 May, 2023-
+## v1.0.0 10 May, 2023
+
 - Initial release.