docs/architecture/appendix/diagrams/README.md
This directory serves as an index of all architecture diagrams used throughout the WPF UI documentation.
NuGet Package Distribution Flowchart
Module/Package Dependency Diagram
Core Library Internal Structure (Layer Diagram)
Control Architecture Class Diagram
Target Framework Matrix
Service Registration & DI Integration
Control Lifecycle State Diagram
Navigation System Lifecycle Sequence Diagram
Page Cache Mode State Diagram
Theme Change Flow Sequence Diagram
Theme System Architecture
Win32 Interop Component Diagram
Three-Layer Architecture Diagram
WndProc Message Flow
Control Folder Structure
Partial Class Decomposition
Handle Validation Pattern Flowchart
Feature Folder Patterns
Module Dependency Graph (Public/Internal)
Diagram: Sequence diagram showing theme change propagation
User → OS Settings → WndProc → SystemThemeWatcher → ApplicationThemeManager →
ResourceDictionaryManager → Application.Resources → UI Update
Diagram: Layer diagram showing Win32 interop call flow
High-Level Code → UnsafeNativeMethods (validation) → PInvoke (CsWin32) → Win32 API
Diagram: (Not yet created) Could be added to show:
NavigationService → NavigationView → PageProvider → Page Resolution →
Frame Navigation → INavigationAware Callbacks
Components:
Relationships:
Components:
Relationships:
All diagrams use Mermaid for easy maintenance and version control:
Sequence Diagram:
sequenceDiagram
participant A
participant B
A->>B: Message
B-->>A: Response
Graph Diagram:
graph TD
A[Component A] --> B[Component B]
B --> C[Component C]
style A fill:#e1f5e1
style B fill:#fff4e1
Class Diagram:
classDiagram
class Button {
+Icon IconElement
+Appearance ControlAppearance
}
Button --|> IAppearanceControl
Button --|> IIconControl
For presentations or external documentation:
# Using mmdc (Mermaid CLI)
npm install -g @mermaid-js/mermaid-cli
mmdc -i diagram.mmd -o diagram.png
Architecture diagram maintenance is part of architecture documentation updates. When making architectural changes: