using DeepDrftModels.DTOs; using DeepDrftPublic.Client.Services; using DeepDrftPublic.Client.ViewModels; using Microsoft.AspNetCore.Components; namespace DeepDrftPublic.Client.Pages; /// /// Load + prerender-bridge logic for the Cut album-detail page (/cuts/{entryKey}). Mirrors /// '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). /// 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; /// /// 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 EntryKey — the canonical public key the routes /// and use. /// protected bool IsThisReleasePlaying => PlayerService?.CurrentTrack?.Release?.EntryKey == EntryKey; /// /// 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. /// protected bool IsContentHidden => VisualizerControlState.TheaterMode && IsThisReleasePlaying; /// /// 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. /// 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(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 Tracks); }