Merge remote-tracking branch 'MudBlazor/dev' into feature/datetime-picker

Author: ralvarezing

.github/release.yml

@@ -5,8 +5,6 @@ changelog:
       - docs
       - tests
       - dependency
-      - refactor
-      - reverted
   categories:
     - title: Breaking Changes
       labels:

.github/renovate.json

@@ -4,7 +4,8 @@
         "config:recommended"
     ],
     "ignorePresets": [
-        ":ignoreModulesAndTests"
+        ":ignoreModulesAndTests",
+        "mergeConfidence:all-badges"
     ],
     "labels": [
         "dependency"
@@ -24,9 +25,9 @@
         },
         {
             "matchPackageNames": [
-                "AspNetCore.SassCompiler"
+                "FluentAssertions"
             ],
-            "enabled": false
+            "allowedVersions": "< 8.0.0"
         }
     ]
 }

.github/workflows/build-test-mudblazor.yml

@@ -9,6 +9,7 @@ jobs:
   build-test:
     name: Build and test mudblazor projects
     uses: MudBlazor/Workflows/.github/workflows/template-build-test.yml@main
+    secrets: inherit
     with:
       check-eslint: 'MudBlazor/TScripts'
       publish-coverage: true

.github/workflows/deploy-mudblazor-nuget.yml

@@ -51,9 +51,16 @@ jobs:
       with:
         dotnet-version: |
           8.0.x
+          9.0.x
     - name: Pack nuget package
       run: dotnet pack -c Release --output nupkgs /p:Version=${{ needs.get-version.outputs.VERSION }}
       working-directory: ./src/MudBlazor
+    - name: Check package contains css
+      shell: pwsh
+      run: ./tools/CheckPackageContainsStaticAssets.ps1 ./src/MudBlazor/nupkgs MudBlazor.min.css
+    - name: Check package contains js
+      shell: pwsh
+      run: ./tools/CheckPackageContainsStaticAssets.ps1 ./src/MudBlazor/nupkgs MudBlazor.min.js
     - name: Publish nuget package
       run: dotnet nuget push nupkgs/*.nupkg -k ${{ secrets.NUGET_KEY }} -s https://api.nuget.org/v3/index.json --skip-duplicate
       working-directory: ./src/MudBlazor

.github/workflows/deploy-mudblazor.yml

@@ -10,7 +10,7 @@ on:
         type: string
   push:
     tags: 
-      - "v7.[0-9]+.[0-9]+"
+      - "v8.[0-9]+.[0-9]+"
 
 jobs:
   get-version:

.github/workflows/deploy-trymudblazor.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
   push:
     tags: 
-      - "v7.[0-9]+.[0-9]+"
+      - "v8.[0-9]+.[0-9]+"
 
 jobs:
   wait-for-nuget:

.github/workflows/sonar.yml

@@ -9,7 +9,7 @@
             "type": "blazorwasm",
             "request": "launch",
             "preLaunchTask": "build",
-            "program": "${workspaceFolder}/src/MudBlazor.UnitTests.Viewer/bin/Debug/net8.0/MudBlazor.UnitTests.Viewer.dll",
+            "program": "${workspaceFolder}/src/MudBlazor.UnitTests.Viewer/bin/Debug/net9.0/MudBlazor.UnitTests.Viewer.dll",
             "cwd": "${workspaceFolder}/src/MudBlazor.UnitTests.Viewer",
             "browser": "edge",
             "env": {
@@ -22,7 +22,7 @@
             "request": "launch",
             "preLaunchTask": "build",
             "hosted": true,
-            "program": "${workspaceFolder}/src/MudBlazor.Docs.WasmHost/bin/Debug/net8.0/MudBlazor.Docs.WasmHost.dll",
+            "program": "${workspaceFolder}/src/MudBlazor.Docs.WasmHost/bin/Debug/net9.0/MudBlazor.Docs.WasmHost.dll",
             "cwd": "${workspaceFolder}/src/MudBlazor.Docs.WasmHost",
             "browser": "edge",
             "env": {
@@ -34,7 +34,7 @@
             "type": "blazorwasm",
             "request": "launch",
             "preLaunchTask": "build",
-            "program": "${workspaceFolder}/src/MudBlazor.Docs.Wasm/bin/Debug/net8.0/MudBlazor.Docs.Wasm.dll",
+            "program": "${workspaceFolder}/src/MudBlazor.Docs.Wasm/bin/Debug/net9.0/MudBlazor.Docs.Wasm.dll",
             "cwd": "${workspaceFolder}/src/MudBlazor.Docs.Wasm",
             "browser": "edge",
             "env": {
@@ -46,7 +46,7 @@
             "type": "coreclr",
             "request": "launch",
             "preLaunchTask": "build",
-            "program": "${workspaceFolder}/src/MudBlazor.Docs.Server/bin/Debug/net8.0/MudBlazor.Docs.Server.dll",
+            "program": "${workspaceFolder}/src/MudBlazor.Docs.Server/bin/Debug/net9.0/MudBlazor.Docs.Server.dll",
             "cwd": "${workspaceFolder}/src/MudBlazor.Docs.Server",
             "stopAtEntry": false,
             "serverReadyAction": {

.vscode/launch.json

@@ -73,7 +73,7 @@
             "problemMatcher": []
         },
         {
-            "label": "compile docs",
+            "label": "docs generator",
             "command": "dotnet",
             "type": "shell",
             "args": [

.vscode/tasks.json

@@ -1,5 +1,3 @@
 # MudBlazor Changelog
 
-## Please refer to github releases
-
-https://github.com/MudBlazor/MudBlazor/releases
+Find an up-to-date summary of changes from each version on the [Releases page](https://github.com/MudBlazor/MudBlazor/releases).

CHANGELOG.md

@@ -434,6 +434,12 @@ cs files start with an underscore.
 
 ### Continuous Integration
 
-We have an Azure DevOps pipeline which will automatically execute the entire
-test suite on all pushes and PRs. If your commit or PR breaks the tests
-you'll be notified.
+We have a GitHub action which runs against all Pull Requests.
+
+It performs the following checks.
+- Builds the project.
+- Runs the test suite.
+- Checks the code coverage.
+- Checks the code quality.
+
+We generally require all these checks to pass before merging contributions.

CONTRIBUTING.md

@@ -0,0 +1,25 @@
+## Migration Guide: Overview
+Welcome to the MudBlazor Migration Guide for upgrading your project to newer versions. This guide provides essential information to help you transition smoothly to the latest version of MudBlazor.
+
+Each release might include new features, improvements, bug fixes, and, in some cases, breaking changes. To ensure you can adopt the new version without issues, we have outlined the necessary steps and linked to detailed migration instructions for specific releases.
+
+#
+
+### How to Use This Guide
+- Identify Your Current Version
+  * Before starting, confirm which version you are upgrading from.
+- Follow the Version-Specific Guide
+  * Each release has a dedicated GitHub issue containing all the details for migrating.
+  * If you're upgrading across multiple versions, follow each guide sequentially, starting from your current version and progressing to the latest.
+- Address Breaking Changes
+  * Pay attention to any breaking changes or deprecated features listed for the target version.
+
+#
+
+### Migration Guides by Version
+#### v7.0.0 
+ - [Migration Guide](https://github.com/MudBlazor/MudBlazor/issues/8447)
+ - [Feedback/Discussion](https://github.com/MudBlazor/MudBlazor/discussions/8976)
+#### v8.0.0 
+ - [Migration Guide](https://github.com/MudBlazor/MudBlazor/issues/9953)
+ - [Feedback/Discussion](https://github.com/MudBlazor/MudBlazor/discussions/10003)

MIGRATION.md

@@ -9,6 +9,7 @@
 # Material Design components for Blazor
 ![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/mudblazor/mudblazor/build-test-mudblazor.yml?branch=dev&logo=github&style=flat-square)
 [![Codecov](https://img.shields.io/codecov/c/github/MudBlazor/MudBlazor)](https://app.codecov.io/github/MudBlazor/MudBlazor)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=MudBlazor_MudBlazor&metric=alert_status)](https://sonarcloud.io/summary/overall?id=MudBlazor_MudBlazor)
 [![GitHub](https://img.shields.io/github/license/mudblazor/mudblazor?color=594ae2&logo=github&style=flat-square)](https://github.com/mudblazor/MudBlazor/blob/master/LICENSE)
 [![GitHub Repo stars](https://img.shields.io/github/stars/mudblazor/mudblazor?color=594ae2&style=flat-square&logo=github)](https://github.com/mudblazor/MudBlazor/stargazers)
 [![GitHub last commit](https://img.shields.io/github/last-commit/mudblazor/mudblazor?color=594ae2&style=flat-square&logo=github)](https://github.com/mudblazor/mudblazor)
@@ -25,7 +26,7 @@ MudBlazor is an ambitious Material Design component framework for Blazor with an
 - [MudBlazor.com](https://mudblazor.com)
 - [Try.MudBlazor.com](https://try.mudblazor.com/)
 
-### Why is MudBlazor so successful?
+## Why is MudBlazor so successful?
 - Clean and aesthetic graphic design based on Material Design.
 - Clear and easy to understand structure.
 - Good documentation with many examples and source snippets.
@@ -40,14 +41,17 @@ MudBlazor is an ambitious Material Design component framework for Blazor with an
 | :--- | :---: | :---: |
 | 1.x.x - 2.0.x | .NET 3.1 | Ended 03/2021 |
 | 5.x.x | .NET 5 | Ended 01/2022 |
-| 6.x.x | [.NET 6](https://dotnet.microsoft.com/download/dotnet/6.0), [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | :heavy_check_mark: |
-| 7.x.x | [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | :heavy_check_mark: |
+| 6.x.x | [.NET 6](https://dotnet.microsoft.com/download/dotnet/6.0), [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | Ended 01/2025 |
+| 7.x.x | [.NET 7](https://dotnet.microsoft.com/download/dotnet/7.0), [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0) | Limited |
+| 8.x.x | [.NET 8](https://dotnet.microsoft.com/download/dotnet/8.0), [.NET 9](https://dotnet.microsoft.com/download/dotnet/9.0) | :heavy_check_mark: |
 
-:information_source: Currently only interactive rendering modes are supported - [Learn more](https://learn.microsoft.com/aspnet/core/blazor/components/render-modes).
+> [!TIP]
+> If you're updating to a newer version of MudBlazor, make sure to check out the [Migration Guide](https://github.com/MudBlazor/MudBlazor/blob/dev/MIGRATION.md) for detailed instructions on handling breaking changes and new features.  
 
-:warning: Blazor only supports [current browser versions](https://learn.microsoft.com/aspnet/core/blazor/supported-platforms).
-To ensure a seamless experience with MudBlazor, please use an up-to-date web browser.
-If a browser version is no longer maintained by its publisher, we cannot guarantee compatibility with MudBlazor.
+> [!WARNING]
+> 1. Static rendering is not supported - [Learn more](https://learn.microsoft.com/aspnet/core/blazor/components/render-modes).
+> 2. We cannot guarantee compatibility with browsers no longer maintained by their publishers.
+For the best experience, use an up-to-date browser - See [Blazor supported platforms](https://learn.microsoft.com/aspnet/core/blazor/supported-platforms).
 
 ## Stats
 ![Alt](https://repobeats.axiom.co/api/embed/db53a44092e88fc34a4c0f37db12773b6787ec7e.svg "Repobeats analytics image")
@@ -63,8 +67,9 @@ Please note there is no guarantee your PR will be merged, so if you want to be s
 Check out the [contribution guidelines](/CONTRIBUTING.md) to understand our goals and learn more about the internals of the project.
 
 ## Getting Started
-Full installation instructions can be found [on our website](https://mudblazor.com/getting-started/installation).  
-Alternatively use one of our templates from the [MudBlazor.Templates](https://github.com/mudblazor/Templates) repo.
+We have premade templates available at the [MudBlazor.Templates](https://github.com/mudblazor/Templates) repository.
+
+Full installation instructions can be found [on our website](https://mudblazor.com/getting-started/installation).
 
 ### Quick Installation Guide
 Install Package
@@ -102,19 +107,26 @@ builder.Services.AddMudServices();
 
 ### Usage
 ```razor
-<MudText Typo="Typo.h6">MudBlazor is @Text</MudText>
-<MudButton Variant="Variant.Filled" Color="Color.Primary" OnClick="ButtonOnClick">@ButtonText</MudButton>
+<MudText Typo="Typo.h6">
+    MudBlazor is @Text
+</MudText>
+
+<MudButton Variant="Variant.Filled" 
+           Color="Color.Primary" 
+           OnClick="ButtonOnClick">
+    @ButtonText
+</MudButton>
 
 @code {
-  public string Text { get; set; } = "????";
-  public string ButtonText { get; set; } = "Click Me";
-  public int ButtonClicked { get; set; }
-
-  void ButtonOnClick()
-  {
-      ButtonClicked += 1;
-      Text = $"Awesome x {ButtonClicked}";
-      ButtonText = "Click Me Again";
-  }
+    string Text { get; set; } = "????";
+    string ButtonText { get; set; } = "Click Me";
+    int ClickCount { get; set; }
+
+    void ButtonOnClick()
+    {
+        ClickCount += 1;
+        Text = $"Awesome x {ClickCount}";
+        ButtonText = "Click Me Again";
+    }
 }
 ```

README.md

@@ -1,36 +1,48 @@
 # MudBlazor Roadmap
 
-MudBlazor is growing, with a significant reduction in the number of bugs.
-We remain committed to maintaining and improving the project, but as a non-commercial project we rely heavily on community contributions.
-We try to review and merge important bug fixes as soon as possible, so if your bug-fix pull request (PR) is overlooked, please tag a team member.
+MudBlazor continues to thrive with millions of downloads on [NuGet](https://www.nuget.org/packages/MudBlazor/) and thousands of members on [Discord](https://discord.gg/mudblazor).
 
-## .NET Versions
+With the recent release of v7, and now v8, we've made significant progress in ensuring the library remains healthy and robust.
+Not only have we introduced countless new features and bug fixes, but we've built a more stable foundation for future development, allowing us to continue moving the project forward to meet the needs of the community.
 
-We fully support both .NET 7 and .NET 8, and our top priority is to continue supporting upcoming .NET versions.
+## Migration
 
-## Breaking Changes
+### .NET Lifecycle
 
-We avoided breaking changes for a very long time and have now finally merged several of them and removed all obsolete APIs from v6 in the move to v7.
-Please view the [v7.0.0 Migration Guide](https://github.com/MudBlazor/MudBlazor/issues/8447) to get an idea of what changes you will have to make in your projects.
+Builds are no longer provided for .NET 6 or .NET 7.
+This change aligns with Microsoft's [.NET support policies](https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core) and lets us focus on providing the best support for newer editions.
 
-We may make further breaking changes in the future, but we will try to keep them to a minimum and provide a migration guide for each major release.
+Update your SDK to .NET 8 or .NET 9 to get the latest packages.
 
-For those unable to immediately upgrade their projects to v7:
-We will maintain v6.x for some time, largely relying on community contributions for bug fixes and backports.
+### MudBlazor Lifecycle
 
-## Looking Ahead
+**v8:**
+This is the current recommended version and all new features and development effort will be directed here.
+
+**v7:**
+We will continue to accept bugfixes from the community for v7 but no new features will be introduced and we won't accept any requests.
+
+**v6:**
+Support for v6 ended 01/2025 and no new patches will be released.
 
-Right now we are focused on getting v7 stable and bug-free.
-After v7 has settled we will start proper work on v8.
-You can find our current plans on the [v8 project board](https://github.com/orgs/MudBlazor/projects/3).
-There is no ETA currently, but we aim to have more regular major releases with less breaking changes in the future.
+### Migrating from a Previous Version
 
-Understand that our team members contribute to this project during their personal free time, so please don't expect the team to fix bugs for you.
-It's not feasible for us to offer free support to everyone, but we do our best to review and merge your PRs.
-That being said, we feel responsible for MudBlazor and intend to keep it going for the foreseeable future at a sustainable cost of free time by merging important bug fixes and new features if they enhance the project.
+The release of v7 addressed several long-standing needs for breaking changes and our goal for v8 is to build on that success while ensuring a smoother transition.
 
-Please keep giving us your ideas so we can consider them for upcoming versions!
+For help with migrating to a new version, please refer to the [v7.0.0 Migration Guide](https://github.com/MudBlazor/MudBlazor/issues/8447) or [v8.0.0 Migration Guide](https://github.com/MudBlazor/MudBlazor/issues/9953).
+In addition we've created a [built-in analyzer](https://mudblazor.com/features/analyzers) that identifies parameters that have been removed or renamed.
+
+## Looking Ahead
+
+We are passionate about improving the library but can't make firm promises about release timelines or specific features as the MudBlazor team is made up of volunteers who contribute to the project in their personal time.
+
+Our goal is to keep MudBlazor stable, performant, and evolving with thoughtful enhancements, but the pace of development depends on the availability of contributors.
+We appreciate your support as we continue to work on keeping MudBlazor the premiere UI library for Blazor.
 
 ## Get Involved
 
-Contributions from the community are what makes MudBlazor successful. If you are proficient in technologies such as C#, Blazor, JavaScript, or CSS, and you wish to give something back, please contact the team [on Discord](https://discord.gg/mudblazor)! You can join our Contribution Team channel and discuss with other team members what you want to do to help and start making a difference on this very roadmap.
+MudBlazor thrives thanks to our amazing community. Whether you specialize in C#, Blazor, JavaScript, CSS, documentation, testing, or design, your help is always welcome.
+
+If you’re interested in contributing, please check out [our contribution guidelines](https://github.com/MudBlazor/MudBlazor/blob/dev/CONTRIBUTING.md) to get started.
+
+You can also open an issue, start a discussion, or tag a member of the team in relevant GitHub issues to collaborate with us.