namespace AcDream.Core.CharGen;

/// <summary>
/// One profession preset offered on the Profession page. Retail's
/// <c>gmCGProfessionPage::UpdateProfession @ 0x004821b0</c> switches on
/// <c>CharGenState.template_</c> and resolves BOTH the button to highlight
/// AND the description string from the SAME 0..6 index: 0 → button
/// 0x100003d9 / <c>ID_CharGen_CustomText</c> ("Custom"), 1 → 0x100003da
/// (Bow Hunter), 2 → 0x100003df (Swashbuckler), 3 → 0x100003db (Life
/// Caster), 4 → 0x100003dc (War Caster), 5 → 0x100003dd (Wayfarer), 6 →
/// 0x100003de (Soldier). "Custom" is therefore template index 0, NOT a
/// special UI-only mode with no data — it is a real <see cref="ChargenTemplate"/>
/// entry (confirmed against the installed DAT: each human heritage ships
/// this row as "Adventurer", sitting at the attribute floor rather than
/// spending the full credit budget). The seven profession buttons all wire
/// to <c>CharGenState::SetTemplate(state, N, 1) @ 0x005C5A60</c> (N =
/// 0..6, the second arg a "commit" flag); <c>SetTemplate</c> writes
/// <c>template_ = N</c> and, because <c>N != 0xffffffff</c> (retail's
/// no-template sentinel — never sent by any button), immediately calls
/// <c>CharGenState::ApplyTemplate @ 0x005C5080</c>, which re-reads that
/// template row's six attributes and skill list and re-applies them.
/// Selecting "Custom" therefore RESETS the attribute sliders and skill
/// picks to the Adventurer row's floor spread rather than leaving the
/// current values untouched — retail's own Custom-button handler
/// (<c>gmCGProfessionPage::ListenToElementMessage</c> case 0xed) calls
/// <c>SetTemplate(state, 0, 1)</c> then <c>gmCGProfessionPage::UpdateToDefaultAttributes
/// @ 0x00482860</c> to refresh the slider UI to match. ACE's
/// <c>PlayerFactory.CreatePlayer</c> confirms the same indexing server-side:
/// it indexes <c>heritageGroup.Templates[characterCreateInfo.TemplateOption]</c>
/// with no special-cased "no template" branch
/// (references/ACE/Source/ACE.Server/Factories/PlayerFactory.cs:135-138).
/// Retail schema: <c>Template_CG::Serialize @ 0x005C0450</c> (ACE's
/// <c>TemplateCG.Unpack</c> mirrors the same field order).
/// </summary>
public sealed record ChargenTemplate(
    string Name,
    uint IconId,
    uint TitleStringId,
    ChargenAttributeValues Attributes,
    IReadOnlyList<uint> NormalSkills,
    IReadOnlyList<uint> PrimarySkills);