From 4b19c9f30ba66a34712699bc66b91cd751f59b98 Mon Sep 17 00:00:00 2001
From: Denis-RZ <77514212+Denis-RZ@users.noreply.github.com>
Date: Sat, 7 Jun 2025 11:59:32 +0800
Subject: [PATCH] Expand Avalonia UI functionality

---
 README.md                                     |  11 +-
 UniversalCodePatcher.Avalonia/App.axaml       |  10 +
 UniversalCodePatcher.Avalonia/App.axaml.cs    |  23 ++
 .../MainWindow.axaml                          |  80 +++++
 .../MainWindow.axaml.cs                       | 332 ++++++++++++++++++
 UniversalCodePatcher.Avalonia/Program.cs      |  21 ++
 .../UniversalCodePatcher.Avalonia.csproj      |  26 ++
 UniversalCodePatcher.Avalonia/app.manifest    |  18 +
 UniversalCodePatcher.sln                      |  42 ++-
 docs/avalonia_reference.md                    |  32 ++
 10 files changed, 574 insertions(+), 21 deletions(-)
 create mode 100644 UniversalCodePatcher.Avalonia/App.axaml
 create mode 100644 UniversalCodePatcher.Avalonia/App.axaml.cs
 create mode 100644 UniversalCodePatcher.Avalonia/MainWindow.axaml
 create mode 100644 UniversalCodePatcher.Avalonia/MainWindow.axaml.cs
 create mode 100644 UniversalCodePatcher.Avalonia/Program.cs
 create mode 100644 UniversalCodePatcher.Avalonia/UniversalCodePatcher.Avalonia.csproj
 create mode 100644 UniversalCodePatcher.Avalonia/app.manifest
 create mode 100644 docs/avalonia_reference.md

diff --git a/README.md b/README.md
index 72089ca..b2abcda 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,8 @@ Intelligent multi-language code patcher with modular architecture.
 - **Semantic Code Analysis**: Advanced AST-based parsing (not regex!)
 - **Multiple Languages**: JavaScript, TypeScript, C# support
 - **Diff Engine**: Create and apply unified diffs without Git dependency
-- **Visual Interface**: Professional WinForms GUI
+- **Visual Interface**: Professional WinForms GUI
+- **Cross Platform UI**: Reference Avalonia version for Linux
 - **Backup System**: Automatic backups before patching
 
 ## Modules
@@ -29,8 +30,12 @@ Intelligent multi-language code patcher with modular architecture.
 ## Building
 
 1. Open UniversalCodePatcher.sln in Visual Studio
-2. Build solution (Ctrl+Shift+B)
-3. Run (F5)
+2. Build solution (Ctrl+Shift+B)
+3. Run (F5)
+4. Alternatively run the Avalonia UI with:
+   ```bash
+   dotnet run --project UniversalCodePatcher.Avalonia
+   ```
 
 ## Usage
 
diff --git a/UniversalCodePatcher.Avalonia/App.axaml b/UniversalCodePatcher.Avalonia/App.axaml
new file mode 100644
index 0000000..2189954
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/App.axaml
@@ -0,0 +1,10 @@
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="UniversalCodePatcher.Avalonia.App"
+             RequestedThemeVariant="Default">
+             <!-- "Default" ThemeVariant follows system theme variant. "Dark" or "Light" are other available options. -->
+
+    <Application.Styles>
+        <FluentTheme />
+    </Application.Styles>
+</Application>
diff --git a/UniversalCodePatcher.Avalonia/App.axaml.cs b/UniversalCodePatcher.Avalonia/App.axaml.cs
new file mode 100644
index 0000000..9a898fa
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/App.axaml.cs
@@ -0,0 +1,23 @@
+using Avalonia;
+using Avalonia.Controls.ApplicationLifetimes;
+using Avalonia.Markup.Xaml;
+
+namespace UniversalCodePatcher.Avalonia;
+
+public partial class App : Application
+{
+    public override void Initialize()
+    {
+        AvaloniaXamlLoader.Load(this);
+    }
+
+    public override void OnFrameworkInitializationCompleted()
+    {
+        if (ApplicationLifetime is IClassicDesktopStyleApplicationLifetime desktop)
+        {
+            desktop.MainWindow = new MainWindow();
+        }
+
+        base.OnFrameworkInitializationCompleted();
+    }
+}
diff --git a/UniversalCodePatcher.Avalonia/MainWindow.axaml b/UniversalCodePatcher.Avalonia/MainWindow.axaml
new file mode 100644
index 0000000..8b76f77
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/MainWindow.axaml
@@ -0,0 +1,80 @@
+<Window xmlns="https://github.com/avaloniaui"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+        xmlns:dg="clr-namespace:Avalonia.Controls;assembly=Avalonia.Controls.DataGrid"
+        x:Class="UniversalCodePatcher.Avalonia.MainWindow"
+        mc:Ignorable="d"
+        Title="Universal Code Patcher" Width="1024" Height="768">
+  <DockPanel>
+    <Menu DockPanel.Dock="Top">
+      <MenuItem Header="_File">
+        <MenuItem Header="_New Project" Click="OnNewProject"/>
+        <MenuItem Header="_Open Project" Click="OnOpenProject"/>
+        <MenuItem Header="_Save" Click="OnSaveProject"/>
+        <MenuItem x:Name="RecentMenu" Header="Recent Projects"/>
+        <Separator/>
+        <MenuItem Header="E_xit" Click="OnExit"/>
+      </MenuItem>
+      <MenuItem Header="_Edit">
+        <MenuItem Header="_Undo" Click="OnUndo"/>
+        <MenuItem Header="_Redo" Click="OnRedo"/>
+        <MenuItem Header="Select _All Files" Click="OnSelectAllFiles"/>
+        <MenuItem Header="_Find in Files" Click="OnFindInFiles"/>
+      </MenuItem>
+      <MenuItem Header="_View">
+        <MenuItem Header="_Refresh" Click="OnRefresh"/>
+        <MenuItem x:Name="HiddenToggle" Header="Show Hidden Files" Click="OnToggleHidden"/>
+        <MenuItem Header="Expand All" Click="OnExpandAll"/>
+        <MenuItem Header="Collapse All" Click="OnCollapseAll"/>
+      </MenuItem>
+      <MenuItem Header="_Tools">
+        <MenuItem Header="_Settings" Click="OnSettings"/>
+        <MenuItem Header="_Backup Manager" Click="OnBackupManager"/>
+        <MenuItem Header="_Module Manager" Click="OnModuleManager"/>
+      </MenuItem>
+      <MenuItem Header="_Help">
+        <MenuItem Header="_About" Click="OnAbout"/>
+        <MenuItem Header="_Documentation" Click="OnDocumentation"/>
+      </MenuItem>
+    </Menu>
+    <Border DockPanel.Dock="Bottom" Background="#EEE" Padding="4">
+      <TextBlock Name="StatusText" Text="Ready"/>
+    </Border>
+    <Grid>
+      <Grid.ColumnDefinitions>
+        <ColumnDefinition Width="250"/>
+        <ColumnDefinition Width="5"/>
+        <ColumnDefinition Width="*"/>
+      </Grid.ColumnDefinitions>
+      <TreeView Grid.Column="0" Name="ProjectTree"/>
+      <GridSplitter Grid.Column="1" Width="5"/>
+      <Grid Grid.Column="2" RowDefinitions="*,Auto">
+        <TabControl Name="MainTabs" Grid.Row="0">
+          <TabItem Header="Source">
+            <TextBox Name="SourceBox" AcceptsReturn="True" FontFamily="Consolas"/>
+          </TabItem>
+          <TabItem Header="Preview">
+            <TextBox Name="PreviewBox" AcceptsReturn="True" IsReadOnly="True" FontFamily="Consolas"/>
+          </TabItem>
+          <TabItem Header="Rules">
+            <dg:DataGrid Name="RulesGrid"/>
+          </TabItem>
+        </TabControl>
+        <StackPanel Grid.Row="1" Orientation="Vertical">
+          <Border BorderBrush="Gray" BorderThickness="1" Padding="4" Margin="0,0,0,4" Height="150">
+            <StackPanel>
+              <TextBlock Text="Patch Results" FontWeight="Bold"/>
+              <ListBox Name="ResultsList"/>
+            </StackPanel>
+          </Border>
+          <StackPanel Orientation="Horizontal" HorizontalAlignment="Right">
+            <Button Name="ApplyButton" Content="Apply Patches" Margin="5"/>
+            <Button Name="PreviewButton" Content="Preview" Margin="5"/>
+            <Button Name="CancelButton" Content="Cancel" Margin="5"/>
+          </StackPanel>
+        </StackPanel>
+      </Grid>
+    </Grid>
+  </DockPanel>
+</Window>
diff --git a/UniversalCodePatcher.Avalonia/MainWindow.axaml.cs b/UniversalCodePatcher.Avalonia/MainWindow.axaml.cs
new file mode 100644
index 0000000..b930beb
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/MainWindow.axaml.cs
@@ -0,0 +1,332 @@
+using Avalonia.Controls;
+using Avalonia.Controls.ApplicationLifetimes;
+using Avalonia.Interactivity;
+using Avalonia.Platform.Storage;
+using Avalonia;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Text.Json;
+using System;
+using Avalonia.VisualTree;
+using Avalonia.Layout;
+
+namespace UniversalCodePatcher.Avalonia;
+
+public partial class MainWindow : Window
+{
+    private string? _projectPath;
+    private bool _showHiddenFiles;
+    private bool _isDirty;
+    private readonly List<string> _recentProjects = new();
+    private const int MaxRecent = 5;
+
+    private string RecentFile => Path.Combine(
+        Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
+        "UniversalCodePatcher", "recent.txt");
+
+    public MainWindow()
+    {
+        InitializeComponent();
+        LoadRecentProjects();
+        SourceBox.PropertyChanged += (_, e) =>
+        {
+            if (e.Property == TextBox.TextProperty)
+                _isDirty = true;
+        };
+    }
+
+    private async void OnNewProject(object? sender, RoutedEventArgs e)
+    {
+        var picker = TopLevel.GetTopLevel(this)?.StorageProvider;
+        if (picker == null)
+            return;
+        var folder = await picker.OpenFolderPickerAsync(new FolderPickerOpenOptions());
+        var path = folder.Count > 0 ? folder[0].Path.LocalPath : null;
+        if (path != null)
+        {
+            _projectPath = path;
+            LoadProject(path);
+            AddRecentProject(path);
+            _isDirty = false;
+        }
+    }
+
+    private void OnOpenProject(object? sender, RoutedEventArgs e)
+    {
+        OnNewProject(sender, e);
+    }
+
+    private void AddRecentProject(string path)
+    {
+        Directory.CreateDirectory(Path.GetDirectoryName(RecentFile)!);
+        _recentProjects.Remove(path);
+        _recentProjects.Insert(0, path);
+        if (_recentProjects.Count > MaxRecent)
+            _recentProjects.RemoveAt(_recentProjects.Count - 1);
+        File.WriteAllLines(RecentFile, _recentProjects);
+        PopulateRecentMenu();
+    }
+
+    private void LoadRecentProjects()
+    {
+        if (File.Exists(RecentFile))
+            _recentProjects.AddRange(File.ReadAllLines(RecentFile));
+        PopulateRecentMenu();
+    }
+
+    private void PopulateRecentMenu()
+    {
+        if (this.FindControl<MenuItem>("RecentMenu") is { } recent)
+        {
+            recent.Items.Clear();
+            foreach (var p in _recentProjects)
+            {
+                var item = new MenuItem { Header = p };
+                item.Click += (_, _) => { _projectPath = p; LoadProject(p); };
+                recent.Items.Add(item);
+            }
+        }
+    }
+
+    private async void OnSaveProject(object? sender, RoutedEventArgs e)
+    {
+        if (_projectPath == null)
+            return;
+        var picker = TopLevel.GetTopLevel(this)?.StorageProvider;
+        if (picker == null)
+            return;
+        var file = await picker.SaveFilePickerAsync(new FilePickerSaveOptions
+        {
+            SuggestedFileName = "project.json"
+        });
+        if (file != null)
+        {
+            var state = new { ProjectPath = _projectPath };
+            await using var stream = await file.OpenWriteAsync();
+            await JsonSerializer.SerializeAsync(stream, state);
+            _isDirty = false;
+        }
+    }
+
+    private async void OnExit(object? sender, RoutedEventArgs e)
+    {
+        if (_isDirty)
+        {
+            var confirm = new Window
+            {
+                Width = 300,
+                Height = 120,
+                Title = "Exit",
+                Content = new StackPanel
+                {
+                    Margin = new Thickness(20),
+                    Children =
+                    {
+                        new TextBlock { Text = "Unsaved changes. Exit anyway?" },
+                        new StackPanel
+                        {
+                            Orientation = Orientation.Horizontal,
+                            HorizontalAlignment = HorizontalAlignment.Right,
+                            Children =
+                            {
+                                new Button { Content = "Yes", Margin = new Thickness(5), IsDefault = true },
+                                new Button { Content = "No", Margin = new Thickness(5), IsCancel = true }
+                            }
+                        }
+                    }
+                }
+            };
+            var yesButton = ((confirm.Content as StackPanel)!.Children[1] as StackPanel)!.Children[0] as Button;
+            var noButton = ((confirm.Content as StackPanel)!.Children[1] as StackPanel)!.Children[1] as Button;
+            bool result = false;
+            yesButton!.Click += (_, _) => { result = true; confirm.Close(); };
+            noButton!.Click += (_, _) => { confirm.Close(); };
+            await confirm.ShowDialog(this);
+            if (!result)
+                return;
+        }
+        (Application.Current?.ApplicationLifetime as IClassicDesktopStyleApplicationLifetime)?.Shutdown();
+    }
+
+    private void OnUndo(object? sender, RoutedEventArgs e)
+    {
+        SourceBox.Undo();
+    }
+
+    private void OnRedo(object? sender, RoutedEventArgs e)
+    {
+        SourceBox.Redo();
+    }
+
+    private async void OnAbout(object? sender, RoutedEventArgs e)
+    {
+        var about = new Window
+        {
+            Width = 300,
+            Height = 150,
+            Title = "About",
+            Content = new TextBlock { Text = "Universal Code Patcher", Margin = new Thickness(20) }
+        };
+        await about.ShowDialog(this);
+    }
+
+    private void LoadProject(string path)
+    {
+        ProjectTree.Items.Clear();
+        foreach (var item in BuildTree(path))
+            ProjectTree.Items.Add(item);
+        StatusText.Text = $"Loaded: {path}";
+    }
+
+    private IEnumerable<TreeViewItem> BuildTree(string path)
+    {
+        var root = new TreeViewItem { Header = Path.GetFileName(path), Tag = path };
+        foreach (var file in Directory.GetFiles(path))
+        {
+            if (!_showHiddenFiles && Path.GetFileName(file).StartsWith('.'))
+                continue;
+            root.Items.Add(new TreeViewItem { Header = Path.GetFileName(file), Tag = file });
+        }
+        foreach (var dir in Directory.GetDirectories(path))
+        {
+            if (!_showHiddenFiles && Path.GetFileName(dir).StartsWith('.'))
+                continue;
+            root.Items.Add(BuildSubTree(dir));
+        }
+        return new[] { root };
+    }
+
+    private TreeViewItem BuildSubTree(string dir)
+    {
+        var node = new TreeViewItem { Header = Path.GetFileName(dir), Tag = dir };
+        foreach (var file in Directory.GetFiles(dir))
+        {
+            if (!_showHiddenFiles && Path.GetFileName(file).StartsWith('.'))
+                continue;
+            node.Items.Add(new TreeViewItem { Header = Path.GetFileName(file), Tag = file });
+        }
+        foreach (var sub in Directory.GetDirectories(dir))
+        {
+            if (!_showHiddenFiles && Path.GetFileName(sub).StartsWith('.'))
+                continue;
+            node.Items.Add(BuildSubTree(sub));
+        }
+        return node;
+    }
+
+    private void OnRefresh(object? sender, RoutedEventArgs e)
+    {
+        if (_projectPath != null)
+            LoadProject(_projectPath);
+    }
+
+    private void OnToggleHidden(object? sender, RoutedEventArgs e)
+    {
+        _showHiddenFiles = HiddenToggle.IsChecked == true;
+        OnRefresh(sender, e);
+    }
+
+    private void ExpandCollapseAll(bool expand)
+    {
+        foreach (var item in ProjectTree.Items)
+            ExpandNode(item as TreeViewItem, expand);
+    }
+
+    private void ExpandNode(TreeViewItem? node, bool expand)
+    {
+        if (node == null) return;
+        node.IsExpanded = expand;
+        foreach (var child in node.Items)
+            ExpandNode(child as TreeViewItem, expand);
+    }
+
+    private void OnExpandAll(object? sender, RoutedEventArgs e) => ExpandCollapseAll(true);
+    private void OnCollapseAll(object? sender, RoutedEventArgs e) => ExpandCollapseAll(false);
+
+    private void OnSelectAllFiles(object? sender, RoutedEventArgs e)
+    {
+        foreach (var item in ProjectTree.Items)
+            SelectNode(item as TreeViewItem);
+    }
+
+    private void SelectNode(TreeViewItem? node)
+    {
+        if (node == null) return;
+        node.IsSelected = true;
+        foreach (var child in node.Items)
+            SelectNode(child as TreeViewItem);
+    }
+
+    private async void OnFindInFiles(object? sender, RoutedEventArgs e)
+    {
+        if (_projectPath == null) return;
+        var input = new Window
+        {
+            Width = 300,
+            Height = 120,
+            Title = "Find",
+            Content = new StackPanel
+            {
+                Margin = new Thickness(10),
+                Children =
+                {
+                    new TextBox { Name = "QueryBox" },
+                    new Button { Content = "Search", Margin = new Thickness(0,5,0,0), HorizontalAlignment = HorizontalAlignment.Right }
+                }
+            }
+        };
+        var queryBox = input.FindControl<TextBox>("QueryBox");
+        var searchButton = input.GetVisualDescendants().OfType<Button>().First();
+        string? query = null;
+        searchButton.Click += (_, _) => { query = queryBox.Text; input.Close(); };
+        await input.ShowDialog(this);
+        if (string.IsNullOrWhiteSpace(query)) return;
+        var results = new List<string>();
+        foreach (var file in Directory.EnumerateFiles(_projectPath, "*", SearchOption.AllDirectories))
+        {
+            if (!_showHiddenFiles && Path.GetFileName(file).StartsWith('.'))
+                continue;
+            var text = await File.ReadAllTextAsync(file);
+            if (text.Contains(query, StringComparison.OrdinalIgnoreCase))
+                results.Add(file);
+        }
+        var dlg = new Window
+        {
+            Width = 400,
+            Height = 300,
+            Title = "Search Results",
+            Content = new ListBox { ItemsSource = results }
+        };
+        await dlg.ShowDialog(this);
+    }
+
+    private async void OnSettings(object? sender, RoutedEventArgs e)
+    {
+        var dlg = new Window { Width = 400, Height = 300, Title = "Settings" };
+        await dlg.ShowDialog(this);
+    }
+
+    private async void OnBackupManager(object? sender, RoutedEventArgs e)
+    {
+        var dlg = new Window { Width = 400, Height = 300, Title = "Backup Manager" };
+        await dlg.ShowDialog(this);
+    }
+
+    private async void OnModuleManager(object? sender, RoutedEventArgs e)
+    {
+        var dlg = new Window { Width = 400, Height = 300, Title = "Module Manager" };
+        await dlg.ShowDialog(this);
+    }
+
+    private void OnDocumentation(object? sender, RoutedEventArgs e)
+    {
+        var url = "https://example.com/docs";
+        try
+        {
+            Process.Start(new ProcessStartInfo { FileName = url, UseShellExecute = true });
+        }
+        catch { }
+    }
+}
diff --git a/UniversalCodePatcher.Avalonia/Program.cs b/UniversalCodePatcher.Avalonia/Program.cs
new file mode 100644
index 0000000..5bca31a
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/Program.cs
@@ -0,0 +1,21 @@
+using Avalonia;
+using System;
+
+namespace UniversalCodePatcher.Avalonia;
+
+class Program
+{
+    // Initialization code. Don't use any Avalonia, third-party APIs or any
+    // SynchronizationContext-reliant code before AppMain is called: things aren't initialized
+    // yet and stuff might break.
+    [STAThread]
+    public static void Main(string[] args) => BuildAvaloniaApp()
+        .StartWithClassicDesktopLifetime(args);
+
+    // Avalonia configuration, don't remove; also used by visual designer.
+    public static AppBuilder BuildAvaloniaApp()
+        => AppBuilder.Configure<App>()
+            .UsePlatformDetect()
+            .WithInterFont()
+            .LogToTrace();
+}
diff --git a/UniversalCodePatcher.Avalonia/UniversalCodePatcher.Avalonia.csproj b/UniversalCodePatcher.Avalonia/UniversalCodePatcher.Avalonia.csproj
new file mode 100644
index 0000000..231ca84
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/UniversalCodePatcher.Avalonia.csproj
@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>WinExe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <BuiltInComInteropSupport>true</BuiltInComInteropSupport>
+    <ApplicationManifest>app.manifest</ApplicationManifest>
+    <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Avalonia" Version="11.3.0" />
+    <PackageReference Include="Avalonia.Controls.DataGrid" Version="11.3.0" />
+    <PackageReference Include="Avalonia.Desktop" Version="11.3.0" />
+    <PackageReference Include="Avalonia.Themes.Fluent" Version="11.3.0" />
+    <PackageReference Include="Avalonia.Fonts.Inter" Version="11.3.0" />
+    <!--Condition below is needed to remove Avalonia.Diagnostics package from build output in Release configuration.-->
+    <PackageReference Include="Avalonia.Diagnostics" Version="11.3.0">
+      <IncludeAssets Condition="'$(Configuration)' != 'Debug'">None</IncludeAssets>
+      <PrivateAssets Condition="'$(Configuration)' != 'Debug'">All</PrivateAssets>
+    </PackageReference>
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\UniversalCodePatcher\UniversalCodePatcher.csproj" />
+  </ItemGroup>
+</Project>
diff --git a/UniversalCodePatcher.Avalonia/app.manifest b/UniversalCodePatcher.Avalonia/app.manifest
new file mode 100644
index 0000000..6f1ca6e
--- /dev/null
+++ b/UniversalCodePatcher.Avalonia/app.manifest
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+<assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
+  <!-- This manifest is used on Windows only.
+       Don't remove it as it might cause problems with window transparency and embedded controls.
+       For more details visit https://learn.microsoft.com/en-us/windows/win32/sbscs/application-manifests -->
+  <assemblyIdentity version="1.0.0.0" name="UniversalCodePatcher.Avalonia.Desktop"/>
+
+  <compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
+    <application>
+      <!-- A list of the Windows versions that this application has been tested on
+           and is designed to work with. Uncomment the appropriate elements
+           and Windows will automatically select the most compatible environment. -->
+
+      <!-- Windows 10 -->
+      <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
+    </application>
+  </compatibility>
+</assembly>
diff --git a/UniversalCodePatcher.sln b/UniversalCodePatcher.sln
index 00b9081..889a59b 100644
--- a/UniversalCodePatcher.sln
+++ b/UniversalCodePatcher.sln
@@ -2,12 +2,14 @@
 # Visual Studio Version 17
 VisualStudioVersion = 17.0.31903.59
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher", "UniversalCodePatcher\UniversalCodePatcher.csproj", "{12345678-1234-5678-9ABC-123456789ABC}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher.GUI", "UniversalCodePatcher.GUI\UniversalCodePatcher.GUI.csproj", "{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}"
-EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher.Tests", "UniversalCodePatcher.Tests\UniversalCodePatcher.Tests.csproj", "{0EB6B98C-5E38-4425-A34D-B3DCE204D063}"
-EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher", "UniversalCodePatcher\UniversalCodePatcher.csproj", "{12345678-1234-5678-9ABC-123456789ABC}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher.GUI", "UniversalCodePatcher.GUI\UniversalCodePatcher.GUI.csproj", "{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher.Tests", "UniversalCodePatcher.Tests\UniversalCodePatcher.Tests.csproj", "{0EB6B98C-5E38-4425-A34D-B3DCE204D063}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "UniversalCodePatcher.Avalonia", "UniversalCodePatcher.Avalonia\UniversalCodePatcher.Avalonia.csproj", "{D84CC7A1-EF75-42F7-9505-3DF086C472FE}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -17,18 +19,22 @@ Global
 		{12345678-1234-5678-9ABC-123456789ABC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{12345678-1234-5678-9ABC-123456789ABC}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{12345678-1234-5678-9ABC-123456789ABC}.Release|Any CPU.ActiveCfg = Release|Any CPU
-                {12345678-1234-5678-9ABC-123456789ABC}.Release|Any CPU.Build.0 = Release|Any CPU
-                {9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-                {9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Debug|Any CPU.Build.0 = Debug|Any CPU
-                {9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Release|Any CPU.ActiveCfg = Release|Any CPU
-                {9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Release|Any CPU.Build.0 = Release|Any CPU
-                {0EB6B98C-5E38-4425-A34D-B3DCE204D063}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{12345678-1234-5678-9ABC-123456789ABC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{9354B93E-60F7-4433-9E7D-189BE0A0B5D5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{0EB6B98C-5E38-4425-A34D-B3DCE204D063}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{0EB6B98C-5E38-4425-A34D-B3DCE204D063}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{0EB6B98C-5E38-4425-A34D-B3DCE204D063}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{0EB6B98C-5E38-4425-A34D-B3DCE204D063}.Release|Any CPU.Build.0 = Release|Any CPU
-EndGlobalSection
-        GlobalSection(SolutionProperties) = preSolution
-                HideSolutionNode = FALSE
-                StartupItem = UniversalCodePatcher.GUI\UniversalCodePatcher.GUI.csproj
-        EndGlobalSection
-EndGlobal
+		{D84CC7A1-EF75-42F7-9505-3DF086C472FE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D84CC7A1-EF75-42F7-9505-3DF086C472FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D84CC7A1-EF75-42F7-9505-3DF086C472FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D84CC7A1-EF75-42F7-9505-3DF086C472FE}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+		StartupItem = UniversalCodePatcher.GUI\UniversalCodePatcher.GUI.csproj
+	EndGlobalSection
+EndGlobal
diff --git a/docs/avalonia_reference.md b/docs/avalonia_reference.md
new file mode 100644
index 0000000..be73f87
--- /dev/null
+++ b/docs/avalonia_reference.md
@@ -0,0 +1,32 @@
+# Avalonia Reference Implementation
+
+This directory contains a minimal Avalonia UI for **Universal Code Patcher**. The project is located at `UniversalCodePatcher.Avalonia` and can be started on Linux with:
+
+```bash
+cd UniversalCodePatcher.Avalonia
+dotnet run
+```
+
+## Features
+
+- Menu with basic project actions (New, Open, Save, Exit, Undo/Redo, About).
+- Tree view for project files.
+- Tab control with **Source**, **Preview** and **Rules** pages.
+- Simple results panel and status text.
+
+The UI hooks into the existing business logic through the shared `UniversalCodePatcher` library. File selection uses the built-in storage provider and the tree is populated recursively from the chosen directory.
+
+## Differences from WinForms
+
+- Uses Avalonia XAML layouts instead of WinForms designers.
+- Status bar and group boxes are implemented using simple `Border` elements because Avalonia does not provide built‑in equivalents.
+- Data grid control comes from the `Avalonia.Controls.DataGrid` package and is referenced using the `dg:` namespace prefix.
+- Cross‑platform storage dialogs (`OpenFolderPickerAsync`) are used in place of `FolderBrowserDialog`.
+
+## Notes for WinForms Fixes
+
+- Decouple business logic from `System.Windows.Forms` specific classes so both UIs can reuse the same services.
+- Ensure path handling uses `Path.Combine` and `Path` APIs for Linux compatibility.
+- Review dialog usage: replace hard coded Windows dialogs with abstractions to allow alternative implementations.
+
+This Avalonia project serves as a lightweight reference for the desired layout and integration points.