deepdrft/DeepDrftPublic.Client/Pages/CutDetailBase.cs

using DeepDrftModels.DTOs;
using DeepDrftPublic.Client.Services;
using DeepDrftPublic.Client.ViewModels;
using Microsoft.AspNetCore.Components;

namespace DeepDrftPublic.Client.Pages;

/// <summary>
/// Load + prerender-bridge logic for the Cut album-detail page (/cuts/{entryKey}). Mirrors
/// <see cref="ReleaseDetailBase"/>'s discipline (id-addressed load in OnParametersSetAsync,
/// PersistentComponentState bridge guarded on id) but carries the multi-track payload (release +
/// ordered track list) the Cut page needs. Kept separate from the single-track base so neither
/// grows a medium conditional — the two release shapes are genuinely different (one track vs many).
/// </summary>
public abstract class CutDetailBase : ComponentBase, IDisposable
{
    private const string PersistKey = "cut-detail";

    [Parameter] public string EntryKey { get; set; } = string.Empty;
    [Inject] public required CutDetailViewModel ViewModel { get; set; }
    [Inject] public required PersistentComponentState PersistentState { get; set; }

    // Theater Mode (Phase 20). The page owns the content gate, so it must re-render when the flag flips
    // on the toggle. Property-injected; no constructor growth.
    [Inject] public required WaveformVisualizerControlState VisualizerControlState { get; set; }

    // Theater Mode is scoped to the currently-playing release (Phase 20 Wave 2 §3). The page observes
    // player state so the toggle availability and content gate re-evaluate live when playback starts,
    // stops, or moves to a different release. Cascaded by AudioPlayerProvider; no constructor growth.
    // The cascade is IsFixed, so the provider's own re-render does not reach this page — the page must
    // subscribe to StateChanged to re-render itself (same posture as AudioPlayerBar).
    [CascadingParameter] public IStreamingPlayerService? PlayerService { get; set; }

    private PersistingComponentStateSubscription _persistingSubscription;
    private IStreamingPlayerService? _subscribedPlayer;

    /// <summary>
    /// True when the currently-playing track belongs to this page's release. Theater Mode only applies
    /// to the playing release: a detail page whose release is not playing ignores the global flag and
    /// shows no toggle. Identity is the release <c>EntryKey</c> — the canonical public key the routes
    /// and <see cref="DeepDrftPublic.Client.Common.ReleaseRoutes"/> use.
    /// </summary>
    protected bool IsThisReleasePlaying =>
        PlayerService?.CurrentTrack?.Release?.EntryKey == EntryKey;

    /// <summary>
    /// True when this page's release content should be hidden for Theater Mode — only when Theater is on
    /// AND this release is the one playing. Drives the eased collapse of the header/track-list regions.
    /// </summary>
    protected bool IsContentHidden => VisualizerControlState.TheaterMode && IsThisReleasePlaying;

    /// <summary>
    /// True when the Theater toggle should be offered on this page: a visualizer subsystem is on AND
    /// this page's release is the one playing.
    /// </summary>
    protected bool ShowTheaterToggle =>
        (VisualizerControlState.LavaEnabled || VisualizerControlState.WaveformEnabled) && IsThisReleasePlaying;

    // The release EntryKey the ViewModel currently holds — tracks param-only navigations (e.g.
    // /cuts/{a} -> /cuts/{b}) which reuse this component instance and fire OnParametersSet without
    // re-running OnInitialized. Without it the page would keep the prior album's tracks.
    private string? _loadedKey;
    private bool _loaded;

    protected override void OnInitialized()
    {
        _persistingSubscription = PersistentState.RegisterOnPersisting(Persist);
        VisualizerControlState.Changed += OnVisualizerStateChanged;
    }

    private void OnVisualizerStateChanged() => InvokeAsync(StateHasChanged);

    private void OnPlayerStateChanged() => InvokeAsync(StateHasChanged);

    protected override async Task OnParametersSetAsync()
    {
        // The player cascade is IsFixed, so the provider's re-render does not reach this page; subscribe
        // to the StateChanged side-channel to re-render when playback moves between releases. Idempotent
        // (reference-guarded) and unsubscribed on dispose — same posture as AudioPlayerBar.
        if (PlayerService is not null && !ReferenceEquals(PlayerService, _subscribedPlayer))
        {
            if (_subscribedPlayer is not null)
                _subscribedPlayer.StateChanged -= OnPlayerStateChanged;

            PlayerService.StateChanged += OnPlayerStateChanged;
            _subscribedPlayer = PlayerService;
        }

        if (_loaded && _loadedKey == EntryKey) return;

        // Capture the key synchronously before any await so a re-entrant call (rapid navigation or a
        // re-render that changes EntryKey while Load is in flight) sees the correct guard state.
        _loadedKey = EntryKey;
        _loaded = true;

        // The bridged payload carries the release and its ordered tracks so the interactive pass
        // renders identically without a second round-trip. Guard on the key: a payload for a different
        // release must not seed this page (stale-bridge bleed across navigation).
        if (PersistentState.TryTakeFromJson<BridgedCut>(PersistKey, out var restored)
            && restored?.Release is not null
            && restored.Release.EntryKey == EntryKey)
        {
            ViewModel.Restore(restored.Release, restored.Tracks);
        }
        else
        {
            await ViewModel.Load(EntryKey);
        }
    }

    private Task Persist()
    {
        if (ViewModel.Release is not null)
            PersistentState.PersistAsJson(PersistKey, new BridgedCut(ViewModel.Release, ViewModel.Tracks));
        return Task.CompletedTask;
    }

    public void Dispose()
    {
        _persistingSubscription.Dispose();
        VisualizerControlState.Changed -= OnVisualizerStateChanged;
        if (_subscribedPlayer is not null)
        {
            _subscribedPlayer.StateChanged -= OnPlayerStateChanged;
            _subscribedPlayer = null;
        }
    }

    // JSON-serializable bridge payload. Round-trips through PersistentComponentState's serializer.
    protected sealed record BridgedCut(ReleaseDto Release, IReadOnlyList<TrackDto> Tracks);
}