/// <summary>
///     A fully deserialized PSEM table with named, typed fields.
/// </summary>
public sealed class ParsedTable
{
#region Properties
    /// <summary>Gets the table definition used for parsing.</summary>
    public required TableDefinition Definition { get; init; }
    /// <summary>Gets the raw table data.</summary>
    public required ReadOnlyMemory<byte> RawData { get; init; }
    /// <summary>Gets the parsed fields in order.</summary>
    public required ImmutableArray<ParsedTableField> Fields { get; init; }
    /// <summary>Gets the table display name (e.g., "ST1").</summary>
    public string DisplayName => Definition.DisplayName;
    /// <summary>Gets the table description.</summary>
    public string Description => Definition.Description;

#endregion
#region Methods
    /// <summary>
    ///     Gets a parsed field by name.
    /// </summary>
    /// <param name = "fieldName">The field name to find.</param>
    /// <returns>The parsed field, or null if not found.</returns>
    public ParsedTableField? GetField(string fieldName) => Fields.FirstOrDefault(f => f.Definition.Name.Equals(fieldName, StringComparison.Ordinal));
    /// <summary>
    ///     Gets the display value of a field by name.
    /// </summary>
    /// <param name = "fieldName">The field name to find.</param>
    /// <returns>The display value, or null if not found.</returns>
    public string? GetValue(string fieldName) => GetField(fieldName)?.DisplayValue;
#endregion
}