acdream/tests/AcDream.UI.Abstractions.Tests/Panels/Chat/ChatInputParserAtPrefixTests.cs

using AcDream.UI.Abstractions.Panels.Chat;

namespace AcDream.UI.Abstractions.Tests.Panels.Chat;

/// <summary>
/// Phase J Tier 1: ACE accepts <c>/</c> and <c>@</c> as equivalent verb
/// prefixes (per ACE help: "Note: You may substitute a forward slash
/// (/) for the at symbol (@)."). For verbs the parser recognizes, we
/// normalize <c>@</c> to <c>/</c> and re-enter parsing. For unknown
/// <c>@</c>-verbs (e.g. <c>@acehelp</c>, <c>@tele</c>, <c>@die</c>),
/// we keep the original <c>@</c> intact so ACE's CommandManager
/// intercepts the message server-side.
/// </summary>
public sealed class ChatInputParserAtPrefixTests
{
    [Theory]
    [InlineData("@a hi gang",         ChatChannelKind.Allegiance, "hi gang")]
    [InlineData("@guild hi gang",     ChatChannelKind.Allegiance, "hi gang")]
    [InlineData("@p heads up",        ChatChannelKind.Patron,     "heads up")]
    [InlineData("@patron heads up",   ChatChannelKind.Patron,     "heads up")]
    [InlineData("@f buff time",       ChatChannelKind.Fellowship, "buff time")]
    // Campaign CH slice CH4 (2026-08-09): "/g" moved from General to
    // Fellowship (Tier 1 fix #1 — retail binds g/group/party to
    // Fellowship, 0x800); "/allegiance" is DELETED from this table — it
    // is now RetailClientCommandCatalog's allegiance MANAGEMENT command,
    // not a channel verb (Tier 1 fix #3).
    [InlineData("@g general msg",     ChatChannelKind.Fellowship, "general msg")]
    [InlineData("@general general msg", ChatChannelKind.General,  "general msg")]
    public void AtPrefix_KnownChannelVerb_RoutesSameAsSlash(string raw, ChatChannelKind expected, string text)
    {
        var parsed = ChatInputParser.Parse(raw, ChatChannelKind.Say, lastTellSender: null);

        Assert.NotNull(parsed);
        Assert.Equal(expected, parsed!.Value.Channel);
        Assert.Null(parsed.Value.TargetName);
        Assert.Equal(text, parsed.Value.Text);
    }

    [Fact]
    public void AtTell_KnownVerb_RoutesAsTell()
    {
        var parsed = ChatInputParser.Parse("@tell Bestie hi", ChatChannelKind.Say, lastTellSender: null);

        Assert.NotNull(parsed);
        Assert.Equal(ChatChannelKind.Tell, parsed!.Value.Channel);
        Assert.Equal("Bestie", parsed.Value.TargetName);
        Assert.Equal("hi", parsed.Value.Text);
    }

    [Fact]
    public void AtReply_NeedsLastIncomingTell_LikeSlashReply()
    {
        var with = ChatInputParser.Parse("@reply back at you", ChatChannelKind.Say, lastTellSender: "Bestie");
        Assert.NotNull(with);
        Assert.Equal(ChatChannelKind.Tell, with!.Value.Channel);
        Assert.Equal("Bestie", with.Value.TargetName);
        Assert.Equal("back at you", with.Value.Text);

        var without = ChatInputParser.Parse("@reply hi", ChatChannelKind.Say, lastTellSender: null);
        Assert.Null(without);
    }

    [Theory]
    [InlineData("@acehelp")]
    [InlineData("@acecommands")]
    [InlineData("@tele 30 30 30")]
    [InlineData("@die")]
    [InlineData("@version")]
    [InlineData("@loc")]                  // ACE has @loc server-side too; passes through
    [InlineData("@nonsense filler")]
    // "@allegiance"/"@all" are RetailClientCommandCatalog verbs (the
    // management command), NOT ChatInputParser channel verbs — at this
    // layer (pure Parse, no catalog check) they pass through unknown.
    [InlineData("@allegiance boot Bob")]
    [InlineData("@house open")]
    public void AtPrefix_UnknownVerb_PassesThroughIntactAsDefaultChannel(string raw)
    {
        // Critical: the @-prefix is preserved in Text so ACE's
        // CommandManager recognizes the message as a server-side
        // command when it arrives via Talk. If we substituted to /,
        // ACE would treat it as plain speech and broadcast it.
        var parsed = ChatInputParser.Parse(raw, ChatChannelKind.Say, lastTellSender: null);

        Assert.NotNull(parsed);
        Assert.Equal(ChatChannelKind.Say, parsed!.Value.Channel);
        Assert.Equal(raw, parsed.Value.Text);
    }

    [Fact]
    public void Retell_WithLastOutgoingTarget_RoutesToTell()
    {
        var parsed = ChatInputParser.Parse(
            "/retell once more with feeling",
            ChatChannelKind.Say,
            lastTellSender: null,
            lastOutgoingTellTarget: "Caith");

        Assert.NotNull(parsed);
        Assert.Equal(ChatChannelKind.Tell, parsed!.Value.Channel);
        Assert.Equal("Caith", parsed.Value.TargetName);
        Assert.Equal("once more with feeling", parsed.Value.Text);
    }

    [Fact]
    public void Retell_AtPrefix_AlsoWorks()
    {
        var parsed = ChatInputParser.Parse(
            "@retell hi again",
            ChatChannelKind.Say,
            lastTellSender: null,
            lastOutgoingTellTarget: "Caith");

        Assert.NotNull(parsed);
        Assert.Equal(ChatChannelKind.Tell, parsed!.Value.Channel);
        Assert.Equal("Caith", parsed.Value.TargetName);
        Assert.Equal("hi again", parsed.Value.Text);
    }

    [Fact]
    public void Retell_NoPriorOutgoingTell_ReturnsNull()
    {
        var parsed = ChatInputParser.Parse(
            "/retell hello",
            ChatChannelKind.Say,
            lastTellSender: "Bestie",   // incoming is irrelevant for retell
            lastOutgoingTellTarget: null);

        Assert.Null(parsed);
    }

    [Fact]
    public void Retell_BareVerb_ReturnsNull()
    {
        var parsed = ChatInputParser.Parse(
            "/retell",
            ChatChannelKind.Say,
            lastTellSender: null,
            lastOutgoingTellTarget: "Caith");

        Assert.Null(parsed);
    }
}