draft: implement hs visualizer

.gitignore

@@ -11,3 +11,4 @@ output.osu
 .idea
 .vscode
 .dotnet-home/
+/MapWizard.sln.DotSettings.user

MapWizard.CLI/MapWizard.CLI.csproj

@@ -5,7 +5,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="MapWizard.BeatmapParser" Version="1.0.3" />
+    <PackageReference Include="MapWizard.BeatmapParser" Version="1.0.5" />
   </ItemGroup>
 
   <PropertyGroup>

MapWizard.CLI/ParserCompliancy/Decoding.cs

@@ -29,9 +29,10 @@ public static void DecodeAllMapsFrom(string folderPath)
                 ConsoleUtils.ProgressBar.DrawProgressBar(osuFiles.Length, parsedBeatmaps.Count);
                 parsedBeatmaps.Add(Beatmap.Decode(new FileInfo(osuFile)));
             }
-            catch (Exception e)
+            catch (Exception ex)
             {
-                parsingErrors.Add((osuFile, e));
+                MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
+                parsingErrors.Add((osuFile, ex));
             }
         }
 
@@ -50,4 +51,4 @@ public static void DecodeAllMapsFrom(string folderPath)
             Console.WriteLine("Errors file written");
         }
     }
-}
+}

MapWizard.CLI/ParserCompliancy/Encoding.cs

@@ -62,6 +62,7 @@ public static void EncodeAllMapsFrom(string folderPath)
             }
             catch (Exception ex)
             {
+                MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
                 Console.WriteLine($"Errors when processing {osuFile}: {ex}");
             }
         }

MapWizard.Desktop/Converters/ColorToHexConverter.cs

@@ -30,8 +30,9 @@ public object ConvertBack(object? value, Type targetType, object? parameter, Cul
                 {
                     return ColorTranslator.FromHtml(hex); // Convert HTML color string to Color
                 }
-                catch
+                catch (Exception ex)
                 {
+                    MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
                     return Color.Black; // Default if parsing fails
                 }
             }

MapWizard.Desktop/Converters/MapPathSummaryConverter.cs

@@ -35,8 +35,9 @@ public object Convert(object? value, Type targetType, object? parameter, Culture
         {
             fileName = Path.GetFileNameWithoutExtension(rawPath);
         }
-        catch
+        catch (Exception ex)
         {
+            MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
             fileName = rawPath;
         }
 
@@ -82,8 +83,9 @@ private static bool IsValidOsuMapPath(string path)
 
             return File.Exists(Path.GetFullPath(path));
         }
-        catch
+        catch (Exception ex)
         {
+            MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
             return false;
         }
     }

MapWizard.Desktop/DependencyInjection/ServiceCollectionExtensions.cs

@@ -1,11 +1,23 @@
 using System;
 using Avalonia.Controls;
 using MapWizard.Desktop.Services;
+using MapWizard.Desktop.Services.ComboColourService;
+using MapWizard.Desktop.Services.HitsoundService;
+using MapWizard.Desktop.Services.MapCleanerService;
+using MapWizard.Desktop.Services.MemoryService;
+using MapWizard.Desktop.Services.MetadataService;
+using MapWizard.Desktop.Services.Playback;
 using MapWizard.Desktop.ViewModels;
 using MapWizard.Desktop.Views;
 using Microsoft.Extensions.DependencyInjection;
 using SukiUI.Dialogs;
 using SukiUI.Toasts;
+using ComboColourStudioView = MapWizard.Desktop.Views.ComboColourStudio.ComboColourStudioView;
+using HitSoundVisualizerView = MapWizard.Desktop.Views.HitSoundVisualizer.HitSoundVisualizerView;
+using MapCleanerView = MapWizard.Desktop.Views.MapCleaner.MapCleanerView;
+using MetadataManagerView = MapWizard.Desktop.Views.MetadataManager.MetadataManagerView;
+using SettingsView = MapWizard.Desktop.Views.Settings.SettingsView;
+using WelcomePageView = MapWizard.Desktop.Views.WelcomePage.WelcomePageView;
 
 namespace MapWizard.Desktop.DependencyInjection;
 
@@ -15,6 +27,7 @@ public static void AddCommonServices(this IServiceCollection collection)
     {
         // ViewModels
         collection.AddTransient<HitSoundCopierViewModel>();
+        collection.AddTransient<HitSoundVisualizerViewModel>();
         collection.AddTransient<MetadataManagerViewModel>();
         collection.AddTransient<ComboColourStudioViewModel>();
         collection.AddTransient<MapCleanerViewModel>();
@@ -24,6 +37,7 @@ public static void AddCommonServices(this IServiceCollection collection)
 
         // Views
         collection.AddTransient<HitSoundCopierView>();
+        collection.AddTransient<HitSoundVisualizerView>();
         collection.AddTransient<MetadataManagerView>();
         collection.AddTransient<ComboColourStudioView>();
         collection.AddTransient<MapCleanerView>();
@@ -42,6 +56,7 @@ public static void AddCommonServices(this IServiceCollection collection)
         collection.AddScoped<IHitSoundService, HitSoundService>();
         collection.AddScoped<IComboColourStudioService, ComboColourStudioService>();
         collection.AddScoped<IMapCleanerService, MapCleanerService>();
+        collection.AddSingleton<IAudioPlaybackService, ManagedBassPlaybackService>();
         collection.AddSingleton<IComboColourProjectStore, ComboColourProjectStore>();
         collection.AddScoped<IOsuMemoryReaderService, OsuMemoryReaderService>();
         collection.AddSingleton<ISongLibraryService, SongLibraryService>();

MapWizard.Desktop/Enums/NavigationPage.cs

@@ -4,6 +4,7 @@ public enum NavigationPage
 {
     Welcome,
     HitSoundCopier,
+    HitSoundVisualizer,
     MetadataManager,
     ComboColourStudio,
     MapCleaner,

MapWizard.Desktop/Enums/ResultStatus.cs

@@ -1,3 +1,5 @@
+namespace MapWizard.Desktop.Enums;
+
 public enum ResultStatus
 {
     Success,

MapWizard.Desktop/MapWizard.Desktop.csproj

@@ -20,8 +20,10 @@
     <PackageReference Condition="'$(Configuration)' == 'Debug'" Include="Avalonia.Diagnostics" Version="11.3.9" />
     <PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.0" />
     <PackageReference Include="DialogHost.Avalonia" Version="0.10.4" />
-    <PackageReference Include="MapWizard.BeatmapParser" Version="1.0.3" />
-    <PackageReference Include="Material.Icons.Avalonia" Version="2.4.1" />
+    <PackageReference Include="JAJ.Packages.MiniAudioEx" Version="3.0.0" />
+    <PackageReference Include="ManagedBass" Version="4.0.2" />
+    <PackageReference Include="MapWizard.BeatmapParser" Version="1.0.5" />
+    <PackageReference Include="Material.Icons.Avalonia" Version="3.0.0" />
     <PackageReference Include="MessageBox.Avalonia" Version="3.3.1.1" />
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="10.0.3" />
     <PackageReference Include="OsuMemoryDataProvider" Version="0.11.1" />
@@ -38,9 +40,20 @@
   </ItemGroup>
 
   <ItemGroup>
-    <Folder Include="Assets\" />
+    <None Include="Assets\Skins\Legacy\**\*" CopyToOutputDirectory="PreserveNewest" />
     <AvaloniaResource Include="Assets\app-icon.ico" />
     <AvaloniaResource Include="Assets\app-icon.png" />
     <AvaloniaResource Include="Assets\app-icon.svg" />
   </ItemGroup>
+
+  <ItemGroup>
+    <Folder Include="Assets\Skins\Legacy\" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <None Include="Native\Bass\linux-x64\libbass.so" Link="libbass.so" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
+    <None Include="Native\Bass\win-x64\bass.dll" Link="bass.dll" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
+    <None Include="Native\Bass\osx\libbass.dylib" Link="libbass.dylib" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
+    <None Include="Native\Bass\BASS-LICENSE.txt" Link="BASS-LICENSE.txt" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
+  </ItemGroup>
 </Project>

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundTimelineContextRequest.cs

@@ -0,0 +1,9 @@
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundTimelineContextRequest
+{
+    public int TimeMs { get; set; }
+    public int PointId { get; set; } = -1;
+    public int? SampleChangeTimeMs { get; set; }
+    public bool IsSampleRow { get; set; }
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundTimelineRowAddRequest.cs

@@ -0,0 +1,7 @@
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundTimelineRowAddRequest
+{
+    public int TimeMs { get; set; }
+    public int RowIndex { get; set; }
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundTimelineZoomRequest.cs

@@ -0,0 +1,7 @@
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundTimelineZoomRequest
+{
+    public int AnchorTimeMs { get; set; }
+    public double ZoomFactor { get; set; } = 1d;
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundVisualizerDocument.cs

@@ -0,0 +1,20 @@
+using System.Collections.Generic;
+using MapWizard.Tools.HitSounds.Timeline;
+
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundVisualizerDocument
+{
+    public string BeatmapPath { get; set; } = string.Empty;
+    public string MapsetDirectoryPath { get; set; } = string.Empty;
+    public string AudioFilePath { get; set; } = string.Empty;
+    public string DisplayTitle { get; set; } = string.Empty;
+    public double EndTimeMs { get; set; }
+
+    // Export-compatible working structure used by the hitsound copier.
+    public HitSoundTimeline Timeline { get; set; } = new();
+
+    public IReadOnlyList<HitSoundVisualizerPoint> Points { get; set; } = [];
+    public IReadOnlyList<HitSoundVisualizerSampleChange> SampleChanges { get; set; } = [];
+    public IReadOnlyList<HitSoundVisualizerSnapTick> SnapTicks { get; set; } = [];
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundVisualizerPoint.cs

@@ -0,0 +1,15 @@
+using BeatmapParser.Enums;
+
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundVisualizerPoint
+{
+    public int Id { get; set; }
+    public int TimeMs { get; set; }
+    public SampleSet SampleSet { get; set; } = SampleSet.Normal;
+    public int? SampleIndexOverride { get; set; }
+    public int? SampleVolumeOverridePercent { get; set; }
+    public bool IsAutoSampleSet { get; set; }
+    public HitSound HitSound { get; set; } = HitSound.Normal;
+    public bool IsDraggable { get; set; }
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundVisualizerSampleChange.cs

@@ -0,0 +1,11 @@
+using BeatmapParser.Enums;
+
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundVisualizerSampleChange
+{
+    public int TimeMs { get; set; }
+    public SampleSet SampleSet { get; set; } = SampleSet.Normal;
+    public int Index { get; set; }
+    public int Volume { get; set; }
+}

MapWizard.Desktop/Models/HitSoundVisualizer/HitSoundVisualizerSnapTick.cs

@@ -0,0 +1,11 @@
+namespace MapWizard.Desktop.Models.HitSoundVisualizer;
+
+public class HitSoundVisualizerSnapTick
+{
+    public int TimeMs { get; set; }
+    public double ExactTimeMs { get; set; }
+    public string Label { get; set; } = string.Empty;
+    public int Strength { get; set; }
+    public int Denominator { get; set; }
+    public bool IsMeasureLine { get; set; }
+}

MapWizard.Desktop/Models/MapsetDifficultyCard.cs

@@ -6,10 +6,29 @@ public partial class MapsetDifficultyCard(string path) : ObservableObject
 {
     [ObservableProperty] private bool _isSelected;
 
-    public SelectedMap Beatmap { get; } = new()
+    public string Path { get; } = path;
+    public string DifficultyLabel { get; } = ResolveDifficultyLabel(path);
+
+    private static string ResolveDifficultyLabel(string beatmapPath)
     {
-        Path = path
-    };
+        if (string.IsNullOrWhiteSpace(beatmapPath))
+        {
+            return "Unknown Difficulty";
+        }
+
+        var fileName = System.IO.Path.GetFileNameWithoutExtension(beatmapPath);
+        if (string.IsNullOrWhiteSpace(fileName))
+        {
+            return "Unknown Difficulty";
+        }
+
+        var openBracketIndex = fileName.LastIndexOf('[');
+        var closeBracketIndex = fileName.LastIndexOf(']');
+        if (openBracketIndex >= 0 && closeBracketIndex > openBracketIndex)
+        {
+            return fileName.Substring(openBracketIndex, closeBracketIndex - openBracketIndex + 1);
+        }
 
-    public string Path => Beatmap.Path;
+        return fileName;
+    }
 }

MapWizard.Desktop/Models/Result.cs

@@ -1,3 +1,5 @@
+using MapWizard.Desktop.Enums;
+
 namespace MapWizard.Desktop.Models;
 
 public class Result<T>

MapWizard.Desktop/Models/SelectedMap.cs

@@ -92,8 +92,9 @@ private void LoadBeatmapCardData()
             var resolvedBackgroundPath = MapsetAssetPathUtils.ResolveRelativePathFromBeatmap(fullPath, backgroundRelativePath);
             LoadBackgroundImage(resolvedBackgroundPath);
         }
-        catch
+        catch (Exception ex)
         {
+            MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
             ApplyFallbackCardData(normalizedPath);
         }
     }
@@ -128,8 +129,9 @@ private void LoadBackgroundImage(string? backgroundPath)
             var fullPath = System.IO.Path.GetFullPath(backgroundPath);
             BackgroundImage = File.Exists(fullPath) ? new Bitmap(fullPath) : null;
         }
-        catch
+        catch (Exception ex)
         {
+            MapWizard.Tools.HelperExtensions.MapWizardLogger.LogException(ex);
             BackgroundImage = null;
         }
     }

MapWizard.Desktop/Models/Settings/AudioOutputDeviceOption.cs

@@ -0,0 +1,22 @@
+namespace MapWizard.Desktop.Models.Settings;
+
+public sealed class AudioOutputDeviceOption
+{
+    public AudioOutputDeviceOption(string id, string displayName, bool isDefault, bool isEnabled)
+    {
+        Id = id;
+        DisplayName = displayName;
+        IsDefault = isDefault;
+        IsEnabled = isEnabled;
+    }
+
+    public string Id { get; }
+
+    public string DisplayName { get; }
+
+    public bool IsDefault { get; }
+
+    public bool IsEnabled { get; }
+
+    public override string ToString() => DisplayName;
+}

MapWizard.Desktop/Models/Settings/MainSettings.cs

@@ -10,4 +10,16 @@ public class MainSettings
 
     [Setting("General", "UpdateStream")]
     public UpdateStream UpdateStream { get; set; } = UpdateStream.Release;
+
+    [Setting("General", "EnableHitSoundVisualizer")]
+    public bool EnableHitSoundVisualizer { get; set; } = false;
+
+    [Setting("Audio", "PreviewSongVolumePercent")]
+    public int AudioPreviewSongVolumePercent { get; set; } = 80;
+
+    [Setting("Audio", "PreviewHitSoundVolumePercent")]
+    public int AudioPreviewHitSoundVolumePercent { get; set; } = 100;
+
+    [Setting("Audio", "OutputDeviceId")]
+    public string AudioOutputDeviceId { get; set; } = "default";
 }