/// <summary>
///     Defines a single field within a PSEM table, including its offset, size, type, and optional sub-fields.
/// </summary>
public sealed class TableFieldDefinition
{
#region Properties
    /// <summary>Gets the field name.</summary>
    public required string Name { get; init; }
    /// <summary>Gets the byte offset within the table.</summary>
    public required int Offset { get; init; }
    /// <summary>Gets the field size in bytes.</summary>
    public required int Size { get; init; }
    /// <summary>Gets the data type for interpretation.</summary>
    public required FieldType Type { get; init; }
    /// <summary>Gets the human-readable description.</summary>
    public string Description { get; init; } = string.Empty;
    /// <summary>Gets whether this field is read-only.</summary>
    public bool IsReadOnly { get; init; }
    /// <summary>Gets sub-fields for BitField types (bit position ranges within this field).</summary>
    public ImmutableArray<BitFieldDefinition> BitFields { get; init; } = [];
    /// <summary>Gets enum value mappings for Enum type fields.</summary>
    public ImmutableDictionary<int, string> EnumValues { get; init; } = ImmutableDictionary<int, string>.Empty;
#endregion
}