add support to communitytoolkit.mvvm

Author: StarryXYJ

Demo/AutoSettingUI.Ursa.Demo/AutoSettingUI.Ursa.Demo.csproj

@@ -8,6 +8,8 @@
         <IsAotCompatible>true</IsAotCompatible>
         <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
         <NoWarn>$(NoWarn);IL2026;IL2057;IL2067;IL2070;IL2072;IL2075;IL2104;IL3050</NoWarn>
+        <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
+        <CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)Generated</CompilerGeneratedFilesOutputPath>
 
         <PublishAot>true</PublishAot>
         <SelfContained>true</SelfContained>
@@ -36,18 +38,21 @@
     </ItemGroup>
 
     <ItemGroup>
+      <ProjectReference Include="..\..\src\AutoSettingUI.Generator\AutoSettingUI.Generator.csproj"
+                        OutputItemType="Analyzer"
+                        ReferenceOutputAssembly="false" />
       <ProjectReference Include="..\..\src\Extensions\AutoSettingUI.Ursa\AutoSettingUI.Ursa.csproj"
                         RemoveProperties="PublishAot" />
     </ItemGroup>
 
     <!-- Generator: project reference for normal builds, prebuilt analyzer for AOT publish -->
-    <ItemGroup Condition="'$(PublishAot)' != 'true'">
-      <ProjectReference Include="..\..\src\AutoSettingUI.Generator\AutoSettingUI.Generator.csproj"
-                        OutputItemType="Analyzer"
-                        ReferenceOutputAssembly="false" />
-    </ItemGroup>
+<!--    <ItemGroup Condition="'$(PublishAot)' != 'true'">-->
+<!--      <ProjectReference Include="..\..\src\AutoSettingUI.Generator\AutoSettingUI.Generator.csproj"-->
+<!--                        OutputItemType="Analyzer"-->
+<!--                        ReferenceOutputAssembly="false" />-->
+<!--    </ItemGroup>-->
 
-    <ItemGroup Condition="'$(PublishAot)' == 'true'">
-      <Analyzer Include="..\..\src\AutoSettingUI.Generator\bin\Release\netstandard2.0\AutoSettingUI.Generator.dll" />
-    </ItemGroup>
+<!--    <ItemGroup Condition="'$(PublishAot)' == 'true'">-->
+<!--      <Analyzer Include="..\..\src\AutoSettingUI.Generator\bin\Release\netstandard2.0\AutoSettingUI.Generator.dll" />-->
+<!--    </ItemGroup>-->
 </Project>

Demo/AutoSettingUI.Ursa.Demo/Models/ApplicationSettings.cs

@@ -20,17 +20,19 @@ namespace AutoSettingUI.Ursa.Demo.Models;
 /// Sample application settings class demonstrating various AutoSettingUI features.
 /// </summary>
 [SettingUI]
-[MainHeader("Application Settings")]
-public class ApplicationSettings
+public partial class ApplicationSettings:ObservableObject
 {
+    
     [Title("Application Name")]
-    public string AppName { get; set; } = "My Application";
+    [ObservableProperty]
+    private string _appName= "My Application";
 
-    
-    public string Version { get; set; } = "1.0.0";
+    [ObservableProperty]
+    private string _version="1.0.0";
 
     [Title("Enable Logging")]
-    public bool EnableLogging { get; set; } = true;
+    [ObservableProperty]
+    private bool _enableLogging;
 
     [Title("Log Level")]
     public LogLevel LogLevel { get; set; } = LogLevel.Info;
@@ -62,7 +64,7 @@ public Slider VolumeFactory()
 /// Sample user preferences class demonstrating delegate properties and collection editors.
 /// </summary>
 [SettingUI]
-[MainHeader("User Preferences")]
+
 public class UserPreferences : INotifyPropertyChanged
 {
     private bool _isAdmin = true;
@@ -74,7 +76,8 @@ protected virtual void OnPropertyChanged(string propertyName)
     {
         PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
     }
-
+    
+    
     [SubHeader("Display")]
     [Title("Theme")]
     public Theme Theme { get; set; } = Theme.Light;

README.md

@@ -10,6 +10,7 @@
 - 🔌 **Extensible** — Inject your own `ISettingDescriptorProvider` or `IPropertyValueAccessor` to override the defaults.
 - 🧭 **Built-in navigation** — Sections are listed in a sidebar tree; clicking navigates directly to the section.
 - 🎯 **Extended Controls** — Built-in support for ColorPicker, DatePicker, TimePicker, NumericUpDown, and more.
+- 🔄 **MVVM Support** — Works seamlessly with CommunityToolkit.Mvvm `[ObservableProperty]` attribute on partial classes.
 
 ## Installation
 
@@ -86,7 +87,52 @@ For AOT support, also add the generator:
 dotnet add package AutoSettingUI.Generator
 ```
 
-### 2. Define a Settings Model
+### 2. Add Style References (Required for Avalonia/Ursa)
+
+> **⚠️ Important:** For Avalonia and Ursa projects, you **must** add the theme style reference to your `App.axaml` file. Without this, the controls will not render correctly.
+
+#### Avalonia
+
+Add to your `App.axaml`:
+
+```xml
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="YourApp.App">
+    <Application.Styles>
+        <FluentTheme />
+        <!-- Required for ColorPicker support (optional) -->
+        <StyleInclude Source="avares://Avalonia.Controls.ColorPicker/Themes/Fluent/Fluent.xaml"/>
+        <!-- Required for AutoSettingUI.Avalonia -->
+        <StyleInclude Source="avares://AutoSettingUI.Avalonia/Themes/Generic.axaml"/>
+    </Application.Styles>
+</Application>
+```
+
+#### Ursa
+
+Add to your `App.axaml`:
+
+```xml
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             xmlns:u-semi="https://irihi.tech/ursa/themes/semi"
+             x:Class="YourApp.App">
+    <Application.Styles>
+        <u-semi:SemiTheme Locale="zh-CN" />
+        <!-- Required for ColorPicker support (optional) -->
+        <StyleInclude Source="avares://Avalonia.Controls.ColorPicker/Themes/Fluent/Fluent.xaml"/>
+        <!-- Required for AutoSettingUI.Ursa -->
+        <StyleInclude Source="avares://AutoSettingUI.Ursa/Themes/Generic.axaml"/>
+    </Application.Styles>
+</Application>
+```
+
+#### WPF
+
+WPF does not require additional style references. The default styles are included automatically.
+
+### 3. Define a Settings Model
 
 ```csharp
 using AutoSettingUI.Core.Attributes;
@@ -116,7 +162,34 @@ public sealed class AppSettings
 }
 ```
 
-### 3. Bind the Panel
+#### Using with CommunityToolkit.Mvvm
+
+AutoSettingUI supports `[ObservableProperty]` from CommunityToolkit.Mvvm. Use partial classes with private fields:
+
+```csharp
+using CommunityToolkit.Mvvm.ComponentModel;
+using AutoSettingUI.Core.Attributes;
+
+[SettingUI]
+[MainHeader("Application Settings")]
+public partial class ApplicationSettings : ObservableObject
+{
+    [Title("Application Name")]
+    [ObservableProperty]
+    private string _appName = "My Application";
+
+    [ObservableProperty]
+    private string _version = "1.0.0";
+
+    [Title("Enable Logging")]
+    [ObservableProperty]
+    private bool _enableLogging;
+}
+```
+
+> **Note:** The source generator automatically detects fields marked with `[ObservableProperty]` and generates UI for the corresponding properties. Field naming conventions (`_fieldName` or `m_fieldName`) are automatically converted to property names (`FieldName`).
+
+### 4. Bind the Panel
 
 Avalonia:
 
@@ -154,7 +227,7 @@ public class MainViewModel
 }
 ```
 
-### 4. AOT Support (Optional)
+### 5. AOT Support (Optional)
 
 For Native AOT or trimming, make sure the generator is referenced by the **app** project. In most cases the generated provider is picked up automatically. If you want to force it (or you see fallback-to-TextBox in AOT), do:
 
@@ -167,7 +240,7 @@ AotSettingRegistry.Provider = provider;
 AotSettingRegistry.Accessor = provider;
 ```
 
-### 5. Publish AOT (Example)
+### 6. Publish AOT (Example)
 
 ```bash
 # Ursa demo

README.zh-CN.md

@@ -10,20 +10,21 @@
 - 🔌 **高度可扩展** — 可注入自定义 `ISettingDescriptorProvider` 或 `IPropertyValueAccessor`，覆盖默认实现。
 - 🧭 **内置导航栏** — 各设置分组以树形列表展示在侧边栏，点击即可滚动定位到对应区域。
 - 🎯 **扩展控件支持** — 内置 ColorPicker、DatePicker、TimePicker、NumericUpDown 等扩展控件。
+- 🔄 **MVVM 支持** — 完美支持 CommunityToolkit.Mvvm 的 `[ObservableProperty]` 特性，可在 partial 类上使用。
 
 ## 安装
 
 根据你的 UI 框架选择对应的包：
 
 ```xml
 <!-- Avalonia -->
-<PackageReference Include="AutoSettingUI.Avalonia" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.Avalonia" />
 
 <!-- Ursa (带 Ursa 主题的 Avalonia) -->
-<PackageReference Include="AutoSettingUI.Ursa" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.Ursa" />
 
 <!-- WPF -->
-<PackageReference Include="AutoSettingUI.WPF" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.WPF" />
 ```
 
 > **注意：** `AutoSettingUI.Core` 会作为依赖自动引入。`AutoSettingUI.Generator` 仅在 AOT 场景需要，需要在应用项目中单独引用。
@@ -40,13 +41,13 @@
 
 ```xml
 <!-- Avalonia -->
-<PackageReference Include="AutoSettingUI.Avalonia" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.Avalonia" />
 
 <!-- Ursa (带 Ursa 主题的 Avalonia) -->
-<PackageReference Include="AutoSettingUI.Ursa" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.Ursa"  />
 
 <!-- WPF -->
-<PackageReference Include="AutoSettingUI.WPF" Version="1.0.0" />
+<PackageReference Include="AutoSettingUI.WPF"  />
 ```
 
 如需 AOT 支持，请在 **应用项目** 中额外引用源代码生成器：
@@ -87,6 +88,33 @@ public sealed class AppSettings
 }
 ```
 
+#### 配合 CommunityToolkit.Mvvm 使用
+
+AutoSettingUI 支持 CommunityToolkit.Mvvm 的 `[ObservableProperty]` 特性。使用 partial 类和私有字段：
+
+```csharp
+using CommunityToolkit.Mvvm.ComponentModel;
+using AutoSettingUI.Core.Attributes;
+
+[SettingUI]
+[MainHeader("应用程序设置")]
+public partial class ApplicationSettings : ObservableObject
+{
+    [Title("应用程序名称")]
+    [ObservableProperty]
+    private string _appName = "我的应用程序";
+
+    [ObservableProperty]
+    private string _version = "1.0.0";
+
+    [Title("启用日志")]
+    [ObservableProperty]
+    private bool _enableLogging;
+}
+```
+
+> **注意：** 源码生成器会自动检测标记了 `[ObservableProperty]` 的字段，并为对应的属性生成 UI。字段命名约定（`_fieldName` 或 `m_fieldName`）会自动转换为属性名（`FieldName`）。
+
 ### 3. 绑定面板
 
 Avalonia:

src/AutoSettingUI.Core/Attributes/MainHeaderAttribute.cs

@@ -5,7 +5,7 @@ namespace AutoSettingUI.Core.Attributes;
 /// Main headers create a container that groups subsequent properties until the next MainHeader or end.
 /// They also appear in the navigation table of contents.
 /// </summary>
-[AttributeUsage(AttributeTargets.Class | AttributeTargets.Property | AttributeTargets.Field, Inherited = false, AllowMultiple = false)]
+[AttributeUsage(AttributeTargets.Class /*| AttributeTargets.Property | AttributeTargets.Field*/, Inherited = false, AllowMultiple = false)]
 public sealed class MainHeaderAttribute : Attribute
 {
     /// <summary>