mod_ui_base/src/Messages/MessagesHelper.cs

using Cthangover.Core.Events;
using Cthangover.Core.Scenes;
using Cthangover.Core.UI.Theming;
using Cthangover.Core.Utils;
using Godot;
using Cthangover.Core.UI.Messages;

namespace Cthangover.Mods.Interface.Messages
{
    /// <summary>
    /// Static factory for floating UI messages (like "Quest updated" or item
    /// pickup notifications). Manages a cycling position index of 0-5 so
    /// consecutive messages stack vertically without overlapping. Each message
    /// is instantiated from message.tscn and parented to the Background node
    /// (found via scene tree search). Messages auto-fade and self-destruct
    /// via UiMessage's OnUpdate.
    /// </summary>
    public static class MessagesHelper
    {
        private const int maxMessageIndex = 5;
        private static int lastMessageIndex = 0;

        private static ModScenePrefab prefab;

        private static int GetNextIndex(int index)
        {
            if (index++ >= maxMessageIndex)
                index = 0;
            return index;
        }

		private static float GetPositionByLastIndex(int index)
		{
			return (index - 1) * 60;
		}

        /// <summary>
        /// Resets the cycling position index to 0. Call when UI state resets
        /// to prevent messages from accumulating at high Y positions.
        /// </summary>
        public static void ClearLastIndex()
        {
            lastMessageIndex = 0;
        }

        /// <summary>
        /// Shows a message in the default warning colour at the next vertical slot.
        /// </summary>
        /// <param name="text">The message text to display.</param>
        /// <param name="speed">Fade speed multiplier (higher = faster fade, default 1).</param>
        public static void AddMessage(string text, float speed = 1f)
        {
            AddMessage(text, UiTokens.Warning, speed);
        }


        /// <summary>
        /// Shows a message with a custom color at the next vertical slot.
        /// Messages auto-fade and self-destruct after ~3 seconds of display plus
        /// a fade duration determined by <paramref name="speed"/>.
        /// </summary>
        /// <param name="text">The message text to display.</param>
        /// <param name="color">The text color.</param>
        /// <param name="speed">Fade speed multiplier (higher = faster fade, default 1).</param>
        public static void AddMessage(string text, Color color, float speed = 1f)
        {
            var nextIndex = GetNextIndex(lastMessageIndex);
            AddMessage(GetPositionByLastIndex(nextIndex), text, color, speed);
            lastMessageIndex = nextIndex;
        }


        /// <summary>
        /// Shows a message in the default warning colour at a specific vertical
        /// position, bypassing the cycling slot system.
        /// </summary>
        /// <param name="position">Y-offset in pixels for this message.</param>
        /// <param name="text">The message text to display.</param>
        /// <param name="speed">Fade speed multiplier (default 1).</param>
        public static void AddMessage(float position, string text, float speed = 1f)
        {
            AddMessage(position, text, UiTokens.Warning, speed);
        }

        /// <summary>
        /// Instantiates a <see cref="UiMessage"/> from <c>message.tscn</c>, parents
        /// it to the Background node, and configures it for display and auto-fade.
        /// </summary>
        /// <param name="position">Y-offset in pixels for this message.</param>
        /// <param name="text">The message text to display.</param>
        /// <param name="color">The text color.</param>
        /// <param name="speed">Fade speed multiplier (default 1).</param>
        public static void AddMessage(float position, string text, Color color, float speed = 1f)
        {
            if (prefab == null)
                prefab = new ModScenePrefab("scenes/ui/message.tscn");

            var instance = prefab.Instantiate<UiMessage>();
            var background = SceneContextNode.FindNode<Control>("Background");
            if (background == null)
            {
                background = SceneContextNode.Instance?.GetTree()?.GetFirstNodeInGroup("Background") as Control;
                if (background == null)
                {
                    GameLogger.Log("UI", "Background node not found for messages", LogLevel.Error);
                    return;
                }
            }
            background.AddChild(instance);
            instance.Setup(position, text, speed, color);

            ModEventBus.Publish(new NotificationRequestedEvent
            {
                Text = text,
                Category = "message",
            });
        }

    }

}