Add Avalonia UI project for cross-platform support

AVALONIA_MIGRATION.md

@@ -0,0 +1,200 @@
+# Avalonia UI Migration Documentation
+
+## Overview
+
+This document describes the migration from WPF to Avalonia UI for the Algoloop application. The Avalonia UI project provides a cross-platform alternative to the existing WPF application.
+
+## What Changed
+
+### New Project: Algoloop.Avalonia
+
+A new Avalonia UI project has been added to the solution targeting .NET 8.0. This project:
+- Uses Avalonia 11.2.2 for cross-platform UI
+- Implements a minimal main window with menu and tabbed interface
+- Provides standalone ViewModels without WPF dependencies
+- Includes the FluentTheme for modern UI styling
+
+### Project Structure
+
+```
+Algoloop.Avalonia/
+├── Algoloop.Avalonia.csproj  # Project file
+├── Program.cs                  # Application entry point
+├── App.axaml                   # Application definition
+├── App.axaml.cs                # Application code-behind
+├── MainWindow.axaml            # Main window XAML
+├── MainWindow.axaml.cs         # Main window code-behind
+├── Styles.axaml                # Application styles
+├── ViewModels/
+│   └── MainViewModel.cs        # Main view model
+└── Resources/
+    └── AlgoloopIcon.ico       # Application icon
+```
+
+### Key Components
+
+#### Program.cs
+The entry point that configures and starts the Avalonia application with classic desktop lifetime.
+
+#### App.axaml / App.axaml.cs
+The main application class that:
+- Loads the FluentTheme
+- Initializes the application styles
+- Creates and shows the main window
+
+#### MainWindow.axaml / MainWindow.axaml.cs
+The main application window featuring:
+- File menu with Save and Exit commands
+- Help menu
+- Status bar
+- Tabbed interface with:
+  - Markets (placeholder)
+  - Strategies (placeholder)
+  - Research (placeholder)
+  - Log (DataGrid with sample data)
+
+#### ViewModels
+Simplified ViewModels created specifically for Avalonia:
+- **MainViewModel**: Main application view model with Save and Exit commands
+- **LogViewModel**: Log view model with sample log entries
+
+### Dependencies
+
+The Avalonia project uses the following NuGet packages:
+- Avalonia 11.2.2
+- Avalonia.Desktop 11.2.2
+- Avalonia.Controls.DataGrid 11.2.2
+- Avalonia.Themes.Fluent 11.2.2
+- Avalonia.Diagnostics 11.2.2 (Debug only)
+- CommunityToolkit.Mvvm 8.4.0
+
+## How to Build and Run
+
+### Prerequisites
+- .NET 8.0 SDK or later
+- Platform-specific requirements:
+  - Windows: No additional requirements
+  - Linux: See [Avalonia Linux setup](https://docs.avaloniaui.net/docs/get-started/set-up-an-editor/linux)
+  - macOS: See [Avalonia macOS setup](https://docs.avaloniaui.net/docs/get-started/set-up-an-editor/macos)
+
+### Build Instructions
+
+#### Build the Avalonia project:
+```bash
+dotnet build Algoloop.Avalonia/Algoloop.Avalonia.csproj
+```
+
+#### Build the entire solution:
+```bash
+dotnet build Algoloop.sln
+```
+
+### Run Instructions
+
+#### Run the Avalonia UI application:
+```bash
+dotnet run --project Algoloop.Avalonia
+```
+
+#### On Windows, you can also run the executable directly:
+```bash
+.\Algoloop.Avalonia\bin\Debug\net8.0\Algoloop.Avalonia.exe
+```
+
+## Known Limitations
+
+### Current Implementation Status
+
+1. **Minimal UI Implementation**
+   - The current implementation provides a basic window structure
+   - Only the Log tab has a functional DataGrid with sample data
+   - Markets, Strategies, and Research tabs show placeholders
+
+2. **ViewModels**
+   - Simplified ViewModels created specifically for Avalonia
+   - No integration with existing WPF ViewModels (which have WPF dependencies)
+   - Business logic from Algoloop core projects needs to be integrated
+
+3. **Missing Features**
+   - No integration with QuantConnect Lean engine
+   - No data loading or persistence
+   - No charts or visualizations
+   - No strategy/market management
+   - No settings or configuration UI
+
+4. **Platform-Specific Limitations**
+   - The original WPF ViewModels use System.Windows which is Windows-specific
+   - Some features may require platform-specific implementations
+
+### WPF Project Status
+
+- The WPF project (Algoloop.Wpf) remains unchanged and fully functional
+- Both WPF and Avalonia projects can coexist in the solution
+- WPF is still the primary/recommended UI for production use
+
+## Next Steps for Full Migration
+
+To achieve feature parity with the WPF version, the following work is needed:
+
+1. **Refactor ViewModels**
+   - Extract business logic from WPF-specific ViewModels
+   - Create platform-agnostic ViewModels or shared view model library
+   - Implement proper MVVM patterns without WPF dependencies
+
+2. **Implement Core Features**
+   - Markets management UI
+   - Strategies management UI
+   - Research/Jupyter notebook integration
+   - Settings and configuration
+   - Chart visualizations (using OxyPlot.Avalonia or similar)
+
+3. **Integrate Business Logic**
+   - Connect to QuantConnect Lean engine
+   - Implement data loading and persistence
+   - Add backtesting capabilities
+   - Integrate market data providers
+
+4. **Testing and Validation**
+   - Cross-platform testing (Windows, Linux, macOS)
+   - UI/UX refinement
+   - Performance optimization
+
+5. **Documentation**
+   - User guide for Avalonia version
+   - Developer documentation
+   - Migration guide for contributors
+
+## Architecture Notes
+
+### Separation of Concerns
+
+The Avalonia implementation intentionally avoids direct references to WPF projects to maintain cross-platform compatibility. Future development should:
+- Keep UI code platform-agnostic where possible
+- Use dependency injection for platform-specific services
+- Share business logic through non-UI projects
+
+### Recommended Approach
+
+For a production-ready Avalonia migration:
+1. Create shared ViewModel library (no WPF/Avalonia dependencies)
+2. Use interfaces for platform-specific services
+3. Implement proper dependency injection
+4. Use platform-specific view implementations (WPF/Avalonia)
+
+## References
+
+- [Avalonia Documentation](https://docs.avaloniaui.net/)
+- [Avalonia Samples](https://github.com/AvaloniaUI/Avalonia.Samples)
+- [MVVM Toolkit](https://learn.microsoft.com/en-us/dotnet/communitytoolkit/mvvm/)
+- [WPF to Avalonia Migration Guide](https://docs.avaloniaui.net/docs/guides/platforms/wpf-migration)
+
+## Support
+
+For questions or issues related to the Avalonia migration:
+1. Check existing documentation
+2. Review Avalonia samples and documentation
+3. Create an issue in the repository with "Avalonia" label
+
+## License
+
+The Avalonia project follows the same license as the main Algoloop project.

Algoloop.Avalonia/Algoloop.Avalonia.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <OutputType>WinExe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <BuiltInComInteropSupport>true</BuiltInComInteropSupport>
+    <ApplicationIcon>Resources\AlgoloopIcon.ico</ApplicationIcon>
+    <AvaloniaUseCompiledBindingsByDefault>false</AvaloniaUseCompiledBindingsByDefault>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <AvaloniaResource Include="Resources\**" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Avalonia" Version="11.2.2" />
+    <PackageReference Include="Avalonia.Desktop" Version="11.2.2" />
+    <PackageReference Include="Avalonia.Controls.DataGrid" Version="11.2.2" />
+    <PackageReference Include="Avalonia.Themes.Fluent" Version="11.2.2" />
+    <PackageReference Include="Avalonia.Diagnostics" Version="11.2.2" Condition="'$(Configuration)' == 'Debug'" PrivateAssets="All" />
+    <PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.0" />
+  </ItemGroup>
+</Project>
+

Algoloop.Avalonia/App.axaml

@@ -0,0 +1,9 @@
+<Application xmlns="https://github.com/avaloniaui"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+             x:Class="Algoloop.Avalonia.App"
+             RequestedThemeVariant="Default">
+    <Application.Styles>
+        <FluentTheme />
+        <StyleInclude Source="avares://Algoloop.Avalonia/Styles.axaml"/>
+    </Application.Styles>
+</Application>

Algoloop.Avalonia/App.axaml.cs

@@ -0,0 +1,27 @@
+using Algoloop.Avalonia.ViewModels;
+using Avalonia;
+using Avalonia.Controls.ApplicationLifetimes;
+using Avalonia.Markup.Xaml;
+
+namespace Algoloop.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
+            {
+                DataContext = new MainViewModel()
+            };
+        }
+
+        base.OnFrameworkInitializationCompleted();
+    }
+}

Algoloop.Avalonia/MainWindow.axaml

@@ -0,0 +1,59 @@
+<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"
+        mc:Ignorable="d" d:DesignWidth="1200" d:DesignHeight="800"
+        x:Class="Algoloop.Avalonia.MainWindow"
+        Title="{Binding Title}"
+        Width="1200" Height="800"
+        Icon="/Resources/AlgoloopIcon.ico">
+
+    <DockPanel LastChildFill="True">
+        <!-- Menu at the top -->
+        <Menu DockPanel.Dock="Top">
+            <MenuItem Header="_File">
+                <MenuItem Header="_Save" Command="{Binding SaveCommand}" />
+                <Separator />
+                <MenuItem Header="E_xit" Command="{Binding ExitCommand}" CommandParameter="{Binding $parent[Window]}" />
+            </MenuItem>
+            <MenuItem Header="_Help">
+                <MenuItem Header="_About" />
+            </MenuItem>
+        </Menu>
+
+        <!-- Status bar at the bottom -->
+        <Border DockPanel.Dock="Bottom" Background="{DynamicResource SystemControlBackgroundChromeMediumLowBrush}" BorderThickness="0,1,0,0" BorderBrush="{DynamicResource SystemControlForegroundBaseMediumLowBrush}" Padding="5">
+            <TextBlock Text="{Binding StatusMessage}" />
+        </Border>
+
+        <!-- Main content area with TabControl -->
+        <TabControl>
+            <TabItem Header="Markets">
+                <Grid>
+                    <TextBlock Text="Markets View (To be implemented)" HorizontalAlignment="Center" VerticalAlignment="Center" FontSize="16" />
+                </Grid>
+            </TabItem>
+            <TabItem Header="Strategies">
+                <Grid>
+                    <TextBlock Text="Strategies View (To be implemented)" HorizontalAlignment="Center" VerticalAlignment="Center" FontSize="16" />
+                </Grid>
+            </TabItem>
+            <TabItem Header="Research">
+                <Grid>
+                    <TextBlock Text="Research View (To be implemented)" HorizontalAlignment="Center" VerticalAlignment="Center" FontSize="16" />
+                </Grid>
+            </TabItem>
+            <TabItem Header="Log">
+                <DataGrid ItemsSource="{Binding LogViewModel.Logs}" 
+                          IsReadOnly="True"
+                          AutoGenerateColumns="False">
+                    <DataGrid.Columns>
+                        <DataGridTextColumn Header="Time" Binding="{Binding Time}" Width="150" />
+                        <DataGridTextColumn Header="Level" Binding="{Binding Level}" Width="80" />
+                        <DataGridTextColumn Header="Message" Binding="{Binding Message}" Width="*" />
+                    </DataGrid.Columns>
+                </DataGrid>
+            </TabItem>
+        </TabControl>
+    </DockPanel>
+</Window>

Algoloop.Avalonia/MainWindow.axaml.cs

@@ -0,0 +1,11 @@
+using Avalonia.Controls;
+
+namespace Algoloop.Avalonia;
+
+public partial class MainWindow : Window
+{
+    public MainWindow()
+    {
+        InitializeComponent();
+    }
+}

Algoloop.Avalonia/Program.cs

@@ -0,0 +1,20 @@
+using Avalonia;
+using System;
+
+namespace Algoloop.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()
+            .LogToTrace();
+}