namespace DeepDrftPublic.Client.Services;

/// <summary>
/// Holds the Mix visualizer's four continuous-control positions for the lifetime of the WASM app
/// instance. Scoped in DI, so it lives across SPA navigations within one listening session — open a
/// second mix and the sliders keep where you left them — but a fresh page load (F5) constructs a new
/// instance, resetting to defaults. That matches the spec's "persist within session, reset on fresh
/// load" without any cookie/localStorage round-trip (see mix-visualizer-webgl-renderer §3c).
///
/// One state object, four properties — not four sibling holders (Daniel's decided shape, spec §3c).
/// Each C#-side default mirrors a TS-side tuning anchor in MixVisualizer.ts; keep the two in sync, as
/// the existing <c>DefaultVisibleSeconds</c> / <c>DEFAULT_VISIBLE_SECONDS</c> pair does.
///
/// <para>
/// <see cref="Changed"/> is the decoupling seam between the controls row and the visualizer bridge.
/// The controls component (a sibling of the backdrop in the page tree) only mutates this shared state
/// and raises <see cref="Changed"/>; the bridge component (<c>MixWaveformVisualizer</c>) subscribes
/// and pushes the affected uniform to the JS module. This keeps the JS module handle single-owned by
/// the bridge — no handle sharing, no service-locator, no cross-component interop.
/// </para>
/// </summary>
public sealed class MixVisualizerControlState
{
    /// <summary>
    /// Default opening window. Mirrors <c>DEFAULT_VISIBLE_SECONDS</c> in MixVisualizer.ts; keep the
    /// two in sync (the TS owns the rendering anchors, this owns the C#-side session default).
    /// </summary>
    public const double DefaultVisibleSeconds = 10.0;

    // R2 TEMP (Phase 10 reframe Wave R2): the three controls below are re-routed to the new
    // lava physics for Daniel's in-browser test — the JS handle setters map them as:
    //   Bubblyness → lava GRAVITY, Detach → lava HEAT, ColorShiftSpeed → COLLISION STRENGTH.
    // The defaults are bumped so the lava looks ALIVE on open (heat non-zero). Wave R4
    // replaces this with the proper six-knob set + its own typed properties. Keep these
    // mirrored to the DEFAULT_* anchors in MixVisualizer.ts, as the existing sync discipline.

    /// <summary>
    /// Default GRAVITY dial (R2 temp; was bulge). Mirrors <c>DEFAULT_BUBBLYNESS</c> in MixVisualizer.ts.
    /// Normalized [0,1]; 0 = near-weightless float, 1 = wax falls + settles fast.
    /// </summary>
    public const double DefaultBubblyness = 0.5;

    /// <summary>
    /// Default HEAT dial (R2 temp; was detach). Mirrors <c>DEFAULT_DETACH</c> in MixVisualizer.ts.
    /// Normalized [0,1]; 0 = wax rests at the bottom (collision-only), 1 = many bubbles rising.
    /// Non-zero default so the lamp is alive on open.
    /// </summary>
    public const double DefaultDetach = 0.45;

    /// <summary>
    /// Default COLLISION-STRENGTH dial (R2 temp; was color-shift). Mirrors
    /// <c>DEFAULT_COLOR_SHIFT_SPEED</c> in MixVisualizer.ts. Normalized [0,1]; 0 = soft shove,
    /// 1 = hard elastic wall.
    /// </summary>
    public const double DefaultColorShiftSpeed = 0.5;

    /// <summary>Visible time-span in seconds (the resolution/zoom control). Reused as-is from 8.K.</summary>
    public double VisibleSeconds { get; set; } = DefaultVisibleSeconds;

    /// <summary>Bulge amount, normalized [0,1]. Inert until Wave 3 consumes the uniform.</summary>
    public double Bubblyness { get; set; } = DefaultBubblyness;

    /// <summary>Lava-lamp detachment, normalized [0,1]. Inert until Wave 3 consumes the uniform.</summary>
    public double Detach { get; set; } = DefaultDetach;

    /// <summary>Gradient-morph rate, normalized [0,1]. Inert until Wave 3 consumes the uniform.</summary>
    public double ColorShiftSpeed { get; set; } = DefaultColorShiftSpeed;

    /// <summary>
    /// Raised whenever any control value changes. The visualizer bridge subscribes to push the
    /// affected uniform(s). Mutators set the property then raise this; subscribers re-read the values.
    /// </summary>
    public event Action? Changed;

    /// <summary>Raise <see cref="Changed"/>. Called by the controls component after mutating a value.</summary>
    public void NotifyChanged() => Changed?.Invoke();
}