From ee6cb4044349ff388efaa9bad1980f6dbc97cffa Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 31 Mar 2026 10:02:25 +0000
Subject: [PATCH 1/2] Initial plan


From 28fbb4cf15b2b5abf9c11c1c5d3db01332fe87e7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 31 Mar 2026 21:48:57 +0000
Subject: [PATCH 2/2] Add materialDesignInternal XML namespace and update
 README documentation

Agent-Logs-Url: https://github.com/MaterialDesignInXAML/MaterialDesignInXamlToolkit/sessions/7b42c504-036c-4afa-bada-baba0a8efd08

Co-authored-by: nicolaihenriksen <19572699+nicolaihenriksen@users.noreply.github.com>
---
 README.md                                     | 19 +++++++++++++++++++
 .../Properties/AssemblyInfo.cs                |  5 +++++
 2 files changed, 24 insertions(+)

diff --git a/README.md b/README.md
index 414be45741..183c544cf3 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,25 @@ Install-Package MaterialDesignThemes
   [...] >
 ```
 
+### XML Namespaces
+
+The toolkit exposes two XML namespaces for use in XAML:
+
+| Prefix | URI | Description |
+|--------|-----|-------------|
+| `materialDesign` | `http://materialdesigninxaml.net/winfx/xaml/themes` | Primary namespace for all public Material Design types, controls, and converters. |
+| `materialDesignInternal` | `http://materialdesigninxaml.net/winfx/xaml/themes-internal` | Namespace for types in internal sub-namespaces (`MaterialDesignThemes.Wpf.Internal`, `MaterialDesignThemes.Wpf.Converters.Internal`, `MaterialDesignThemes.Wpf.Behaviors.Internal`). |
+
+> [!WARNING]
+> Types exposed via the `materialDesignInternal` namespace are considered **internal implementation details** and are **not guaranteed to maintain backwards-compatibility between versions**. Use them at your own risk.
+
+To use the internal namespace in XAML:
+
+```xml
+<Window ...
+  xmlns:materialDesignInternal="http://materialdesigninxaml.net/winfx/xaml/themes-internal">
+```
+
 
 ## Building the source
 
diff --git a/src/MaterialDesignThemes.Wpf/Properties/AssemblyInfo.cs b/src/MaterialDesignThemes.Wpf/Properties/AssemblyInfo.cs
index a730e8f92a..2d3782e0a7 100644
--- a/src/MaterialDesignThemes.Wpf/Properties/AssemblyInfo.cs
+++ b/src/MaterialDesignThemes.Wpf/Properties/AssemblyInfo.cs
@@ -5,6 +5,11 @@
 [assembly: XmlnsDefinition("http://materialdesigninxaml.net/winfx/xaml/themes", "MaterialDesignThemes.Wpf.Transitions")]
 [assembly: XmlnsDefinition("http://materialdesigninxaml.net/winfx/xaml/themes", "MaterialDesignThemes.Wpf.Converters")]
 
+[assembly: XmlnsPrefix("http://materialdesigninxaml.net/winfx/xaml/themes-internal", "materialDesignInternal")]
+[assembly: XmlnsDefinition("http://materialdesigninxaml.net/winfx/xaml/themes-internal", "MaterialDesignThemes.Wpf.Internal")]
+[assembly: XmlnsDefinition("http://materialdesigninxaml.net/winfx/xaml/themes-internal", "MaterialDesignThemes.Wpf.Converters.Internal")]
+[assembly: XmlnsDefinition("http://materialdesigninxaml.net/winfx/xaml/themes-internal", "MaterialDesignThemes.Wpf.Behaviors.Internal")]
+
 // Setting ComVisible to false makes the types in this assembly not visible 
 // to COM components.  If you need to access a type in this assembly from 
 // COM, set the ComVisible attribute to true on that type.