Framework/GameHint.cs

A small readonly record struct that represents a game hint. It holds the hint text shown in the HUD and an array of CardObject references to highlight in the world.

namespace CardGames;

/// <summary>
/// A hint produced by a game's <see cref="CardGame.ComputeHint"/>: the suggested move worded for the
/// HUD pill, plus the cards to flash (a gold "look here" pulse) in the world.
/// </summary>
public readonly record struct GameHint( string Text, CardObject[] Cards );