StatFloat.cs

The file defines a system for displaying floating status indicators over in-game fish during training. It manages the lifecycle and positional updates of these stat pop effects.

namespace NoChillquarium;

public sealed class StatFloatItem
{
	public string Key { get; set; }
	public string Label { get; set; }
	/// <summary>Optional fish to follow (tank instance id).</summary>
	public string FishId { get; set; }
	/// <summary>Tank-local spawn / draw X.</summary>
	public float X { get; set; }
	/// <summary>Tank-local spawn / draw Y.</summary>
	public float Y { get; set; }
	public float Life { get; set; }
	public float MaxLife { get; set; }
	/// <summary>Seconds before this pop becomes visible (stagger multi-stat).</summary>
	public float Delay { get; set; }
	public float Rise { get; set; }
	public float DriftX { get; set; }
	/// <summary>end | spd | agi — color class.</summary>
	public string Kind { get; set; }
	/// <summary>True once delay elapsed (drawn this frame).</summary>
	public bool Visible => Delay <= 0f && Life > 0f;
}

/// <summary>
/// RPG-style +stat pops over fish while training / dosing.
/// Display points are tenths of the 0–10 internal stat (0.25 → "+3").
/// </summary>
public static class StatFloat
{
	const int MaxVisible = 24;
	const float DefaultLife = 1.8f;

	static readonly List<StatFloatItem> _items = new();
	static readonly Random _rng = new();
	static int _version;
	static string _lastLine = "";
	static float _lastLineTimer;

	public static int Version => _version;
	public static IReadOnlyList<StatFloatItem> Items => _items;

	/// <summary>Compact line for gym side panel, e.g. "+3 Speed  +1 Agility".</summary>
	public static string LastLine => _lastLineTimer > 0f ? _lastLine : "";

	public static void Clear()
	{
		_items.Clear();
		_lastLine = "";
		_lastLineTimer = 0f;
		_version++;
	}

	public static void Tick( float dt )
	{
		if ( dt <= 0f )
			return;
		if ( dt > 0.05f )
			dt = 0.05f;

		if ( _lastLineTimer > 0f )
		{
			_lastLineTimer = MathF.Max( 0f, _lastLineTimer - dt );
			_version++;
		}

		var dirty = false;
		for ( var i = _items.Count - 1; i >= 0; i-- )
		{
			var it = _items[i];

			// Keep locked to swimming fish (lane DriftX + Rise hold vertical stagger).
			if ( !string.IsNullOrEmpty( it.FishId ) )
			{
				var fish = TankSim.FindFish( it.FishId );
				if ( fish is not null )
				{
					it.X = fish.X + it.DriftX;
					// Rise starts negative for upper lanes; floats continue upward as Rise decreases.
					it.Y = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.5f + it.Rise;
				}
			}

			if ( it.Delay > 0f )
			{
				it.Delay -= dt;
				dirty = true;
				continue;
			}

			it.Life -= dt;
			it.Rise -= 42f * dt;
			if ( it.Life <= 0f )
			{
				_items.RemoveAt( i );
				dirty = true;
			}
			else
			{
				dirty = true;
			}
		}

		if ( dirty )
			_version++;
	}

	public static float LifeNorm( StatFloatItem item )
	{
		if ( item is null || !item.Visible || item.MaxLife <= 0f )
			return 0f;
		return Math.Clamp( item.Life / item.MaxLife, 0f, 1f );
	}

	/// <summary>
	/// Fixed visual lane per stat so pops never stack:
	/// END left, SPD center, AGI right — each a bit higher.
	/// </summary>
	static void LaneFor( int statIndex, out float driftX, out float rise0 )
	{
		switch ( statIndex )
		{
			case 0: // END
				driftX = -40f;
				rise0 = 0f;
				break;
			case 1: // SPD
				driftX = 0f;
				rise0 = -16f;
				break;
			default: // AGI
				driftX = 40f;
				rise0 = -32f;
				break;
		}
	}

	/// <summary>
	/// Generic tank-local pop (growth, sell, rare, stage). Optional fish follow.
	/// Kinds: grow · stage · sell · rare · fed · end · spd · agi
	/// </summary>
	public static void PushTag( string label, string kind, float x, float y, string fishId = null, float delay = 0f, float life = 1.45f )
	{
		if ( string.IsNullOrWhiteSpace( label ) )
			return;
		kind ??= "combo";
		life = Math.Clamp( life, 0.6f, 3.2f );
		Push( new StatFloatItem
		{
			Key = Guid.NewGuid().ToString( "N" ).Substring( 0, 8 ),
			Label = label.Trim(),
			FishId = fishId,
			X = x,
			Y = y,
			Life = life,
			MaxLife = life,
			Delay = Math.Max( 0f, delay ),
			Rise = -6f,
			DriftX = (float)(_rng.NextDouble() * 18.0 - 9.0),
			Kind = kind
		} );
	}

	/// <summary>Pop over a living fish (or last known pos if null id only).</summary>
	public static void PushOverFish( FishActor fish, string label, string kind, float delay = 0f, float life = 1.45f )
	{
		if ( fish is null || string.IsNullOrWhiteSpace( label ) )
			return;
		var y = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.55f - 10f;
		PushTag( label, kind, fish.X, y, fish.InstanceId, delay, life );
	}

	/// <summary>0 = Endurance, 1 = Speed, 2 = Agility. <paramref name="applied"/> is real 0–10 delta.</summary>
	public static void Spawn( FishActor fish, int statIndex, float applied, float delay = 0f )
	{
		if ( fish is null )
			return;

		// Always show at least +1 when any gain was attempted (cap still may zero real gain).
		var pts = applied > 0.001f
			? Math.Max( 1, (int)MathF.Round( applied * 10f ) )
			: 0;
		if ( pts <= 0 )
			return;

		var (name, kind) = StatLabel( statIndex );
		LaneFor( statIndex, out var driftX, out var rise0 );
		var baseY = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.55f - 8f;

		Push( new StatFloatItem
		{
			Key = Guid.NewGuid().ToString( "N" ).Substring( 0, 8 ),
			Label = $"+{pts} {name}",
			FishId = fish.InstanceId,
			X = fish.X + driftX,
			Y = baseY + rise0,
			Life = DefaultLife,
			MaxLife = DefaultLife,
			Delay = Math.Max( 0f, delay ),
			Rise = rise0,
			DriftX = driftX,
			Kind = kind
		} );
	}

	/// <summary>
	/// Multi-stat gains as separate staggered pops (END / SPD / AGI lanes).
	/// Gym panel still gets one combined LastLine.
	/// </summary>
	public static void SpawnTrio( FishActor fish, float endGain, float spdGain, float agiGain )
	{
		if ( fish is null )
			return;

		var line = BuildGainLine( endGain, spdGain, agiGain, shortNames: true );
		if ( string.IsNullOrEmpty( line ) )
			return;

		_lastLine = line;
		_lastLineTimer = 2.4f;

		// Fixed order + timing: left→right, one after another (readable, not a pile).
		const float step = 0.18f;
		var delay = 0f;
		if ( endGain > 0.001f )
		{
			Spawn( fish, 0, endGain, delay );
			delay += step;
		}
		if ( spdGain > 0.001f )
		{
			Spawn( fish, 1, spdGain, delay );
			delay += step;
		}
		if ( agiGain > 0.001f )
			Spawn( fish, 2, agiGain, delay );

		_version++;
	}

	/// <summary>End-of-set: staggered totals + long gym last-line.</summary>
	public static void ShowSessionSummary( FishActor fish, float endGain, float spdGain, float agiGain )
	{
		if ( fish is null )
			return;

		var line = BuildGainLine( endGain, spdGain, agiGain, shortNames: true );
		if ( string.IsNullOrEmpty( line ) )
			return;

		_lastLine = "TOTAL  " + line;
		_lastLineTimer = 4.8f;

		const float step = 0.2f;
		var delay = 0.05f;
		if ( endGain > 0.001f )
		{
			SpawnLong( fish, 0, endGain, delay );
			delay += step;
		}
		if ( spdGain > 0.001f )
		{
			SpawnLong( fish, 1, spdGain, delay );
			delay += step;
		}
		if ( agiGain > 0.001f )
			SpawnLong( fish, 2, agiGain, delay );

		_version++;
	}

	/// <summary>Same lanes as Spawn, longer life for end-of-set totals.</summary>
	static void SpawnLong( FishActor fish, int statIndex, float applied, float delay )
	{
		if ( fish is null )
			return;
		var pts = applied > 0.001f
			? Math.Max( 1, (int)MathF.Round( applied * 10f ) )
			: 0;
		if ( pts <= 0 )
			return;

		var (name, kind) = StatLabel( statIndex );
		LaneFor( statIndex, out var driftX, out var rise0 );
		var baseY = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.6f - 12f;
		const float life = 2.6f;

		Push( new StatFloatItem
		{
			Key = Guid.NewGuid().ToString( "N" ).Substring( 0, 8 ),
			Label = $"+{pts} {name}",
			FishId = fish.InstanceId,
			X = fish.X + driftX,
			Y = baseY + rise0,
			Life = life,
			MaxLife = life,
			Delay = Math.Max( 0f, delay ),
			Rise = rise0,
			DriftX = driftX,
			Kind = kind
		} );
	}

	/// <summary>Short labels: END/SPD/AGI. Largest gain first.</summary>
	public static string BuildGainLine( float end, float spd, float agi, bool shortNames = true )
	{
		var parts = new List<string>( 3 );
		void Add( int stat, float gain )
		{
			if ( gain <= 0.001f )
				return;
			var pts = Math.Max( 1, (int)MathF.Round( gain * 10f ) );
			var name = shortNames ? ShortStat( stat ) : StatLabel( stat ).Name;
			parts.Add( $"+{pts} {name}" );
		}

		var order = new[] { (0, end), (1, spd), (2, agi) };
		Array.Sort( order, ( a, b ) => b.Item2.CompareTo( a.Item2 ) );
		foreach ( var (stat, gain) in order )
			Add( stat, gain );
		return string.Join( "  ", parts );
	}

	static string ShortStat( int statIndex ) => statIndex switch
	{
		0 => "END",
		1 => "SPD",
		_ => "AGI"
	};

	static (string Name, string Kind) StatLabel( int statIndex ) => statIndex switch
	{
		0 => ("END", "end"),
		1 => ("SPD", "spd"),
		_ => ("AGI", "agi")
	};

	/// <summary>Weed gummies bite — one vibe line, not a stack of overlapping pops.</summary>
	public static void SpawnWeedHigh( FishActor fish, float endGain, float agiGain, float spdLoss )
	{
		if ( fish is null )
			return;

		var bits = new List<string> { "+Chill", "+Munchies" };
		if ( endGain > 0.05f )
			bits.Add( $"+{Math.Max( 1, (int)MathF.Round( endGain * 10f ) )} END" );
		if ( agiGain > 0.05f )
			bits.Add( $"+{Math.Max( 1, (int)MathF.Round( agiGain * 10f ) )} AGI" );
		if ( spdLoss > 0.05f )
			bits.Add( $"-{Math.Max( 1, (int)MathF.Round( spdLoss * 10f ) )} SPD" );
		bits.Add( "+Vibes" );

		var line = string.Join( "  ", bits );
		_lastLine = line;
		_lastLineTimer = 2.6f;

		Push( new StatFloatItem
		{
			Key = Guid.NewGuid().ToString( "N" ).Substring( 0, 8 ),
			Label = line.Length > 28 ? "+Chill  +Munchies  +Vibes" : line,
			FishId = fish.InstanceId,
			X = fish.X,
			Y = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.55f - 10f,
			Life = DefaultLife + 0.4f,
			MaxLife = DefaultLife + 0.4f,
			Delay = 0f,
			Rise = 0f,
			DriftX = 0f,
			Kind = "weed"
		} );
		_version++;
	}

	public static void SpawnFlavor( FishActor fish, string label, string kind, float delay = 0f )
	{
		if ( fish is null || string.IsNullOrWhiteSpace( label ) )
			return;

		Push( new StatFloatItem
		{
			Key = Guid.NewGuid().ToString( "N" ).Substring( 0, 8 ),
			Label = label,
			FishId = fish.InstanceId,
			X = fish.X,
			Y = fish.DrawY - (fish.Species?.Height ?? 30f) * 0.5f - 8f,
			Life = DefaultLife + 0.25f,
			MaxLife = DefaultLife + 0.25f,
			Delay = Math.Max( 0f, delay ),
			Rise = 0f,
			DriftX = 0f,
			Kind = kind
		} );
	}

	static void Push( StatFloatItem item )
	{
		_items.Add( item );
		while ( _items.Count > MaxVisible )
			_items.RemoveAt( 0 );
		_version++;
	}
}