using Godot;

namespace Mr.BrickAdventures.scripts.Resources;

/// <summary>
/// One authored Level: its stable id, its display name key, and the scene to load.
/// </summary>
/// <remarks>
/// <para>
/// <see cref="Id"/> is what Playthroughs and Best Times reference, so it must never change once a
/// build has shipped — unlike position in a list, which is what the old
/// <c>GameManager.LevelScenes</c> array used and which every save depended on.
/// </para>
/// <para>
/// The scene is a <see cref="PackedScene"/> rather than a path string. The previous
/// <c>ScenePath</c> field was never read by anything and had rotted: <c>forest_1.tres</c> pointed at
/// <c>res://scenes/level_forest_5.tscn</c>, which does not exist. An exported reference is tracked by
/// the editor and cannot drift.
/// </para>
/// </remarks>
[GlobalClass]
public partial class LevelResource : Resource
{
    /// <summary>Stable identity. Referenced by saves — do not change after shipping.</summary>
    [Export]
    public string Id { get; set; } = string.Empty;

    /// <summary>Translation key for the player-facing name. Labels auto-translate it.</summary>
    [Export]
    public string LevelName { get; set; } = string.Empty;

    [Export]
    public PackedScene Scene { get; set; }
}