GFramework/GFramework.Core.Tests/State/TestStateV2.cs

// Copyright (c) 2025-2026 GeWuYou
// SPDX-License-Identifier: Apache-2.0

using GFramework.Core.Abstractions.State;

namespace GFramework.Core.Tests.State;

/// <summary>
///     为 <see cref="StateMachineTests" /> 提供可配置转移结果的同步测试状态。
/// </summary>
public sealed class TestStateV2 : IState
{
    /// <summary>
    ///     获取或设置是否允许向目标状态转移。
    /// </summary>
    public bool AllowTransition { get; set; } = true;

    /// <summary>
    ///     获取进入状态是否已被调用。
    /// </summary>
    public bool EnterCalled { get; private set; }

    /// <summary>
    ///     获取离开状态是否已被调用。
    /// </summary>
    public bool ExitCalled { get; private set; }

    /// <summary>
    ///     获取进入回调被调用的次数。
    /// </summary>
    public int EnterCallCount { get; private set; }

    /// <summary>
    ///     获取离开回调被调用的次数。
    /// </summary>
    public int ExitCallCount { get; private set; }

    /// <summary>
    ///     获取最近一次进入时的来源状态。
    /// </summary>
    public IState? EnterFrom { get; private set; }

    /// <summary>
    ///     获取最近一次离开时的目标状态。
    /// </summary>
    public IState? ExitTo { get; private set; }

    /// <summary>
    ///     记录进入状态时的来源状态与调用次数。
    /// </summary>
    /// <param name="from">触发进入的来源状态。</param>
    public void OnEnter(IState? from)
    {
        EnterCalled = true;
        EnterCallCount++;
        EnterFrom = from;
    }

    /// <summary>
    ///     记录离开状态时的目标状态与调用次数。
    /// </summary>
    /// <param name="to">即将切换到的目标状态。</param>
    public void OnExit(IState? to)
    {
        ExitCalled = true;
        ExitCallCount++;
        ExitTo = to;
    }

    /// <summary>
    ///     根据 <see cref="AllowTransition" /> 返回是否允许切换。
    /// </summary>
    /// <param name="target">目标状态。</param>
    /// <returns>允许切换时返回 <see langword="true" />，否则返回 <see langword="false" />。</returns>
    public bool CanTransitionTo(IState target)
    {
        return AllowTransition;
    }
}