Program.cs

// MIT License
// Copyright (c) 2025 Dave Black
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in all
// copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.

using Avalonia;
using Avalonia.WebView.Desktop;
using Dock.Settings;
using MermaidPad.Services.Platforms;
using Serilog;

namespace MermaidPad;

internal static 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)
    {
        // CRITICAL: Check platform compatibility FIRST, before any other initialization
        // This attempts to prevent crashes from architecture mismatches (e.g., x64 app on arm64 via Rosetta)
        PlatformCompatibilityChecker.CheckCompatibility();

        // Check filesystem permissions (Mac/Linux only)
        // Verifies app can write to config directory, assets directory, log files, and temp directory
        PlatformCompatibilityChecker.CheckFilesystemPermissions();

        // If we get here, platform compatibility and permissions are OK
        try
        {
            BuildAvaloniaApp().StartWithClassicDesktopLifetime(args);
        }
        catch (Exception exception)
        {
            Log.Fatal(exception, "Fatal exception on main/UI thread");
            throw;
        }
        finally
        {
            Log.CloseAndFlush();
        }
    }

    // Avalonia configuration, don't remove; also used by visual designer.
    private static AppBuilder BuildAvaloniaApp() =>
        AppBuilder.Configure(static () => new App())
            .UsePlatformDetect()
            .BringWindowsToFrontOnDrag()    // brings main app and floating windows to front when dragging Dock windows
            .EnableWindowMagnetism()        // enables window magnetism (snap-to-edge) for Dock
            .UseFloatingDockAdorner()       // enables floating dock adorners for Dock
            .UseOwnerForFloatingWindows()   // makes floating Dock windows owned by main app window

            //TODO - DaveBlack: The 'UsePinnedDockWindow' setting fixes the "air-space/z-index" ordering issue for the WebView control - BUT, it breaks the ability to re-dock the pinned panel.
            //.UsePinnedDockWindow()          // uses floating windows for pinned Dock windows (pinned windows stay on top of other windows)
            .UseDesktopWebView()            // this handles cross-platform WebView support
            .LogToTrace();
}