GFramework/GFramework.Game/Config/YamlConfigObjectConstraints.cs

namespace GFramework.Game.Config;

/// <summary>
///     表示一个对象节点上声明的属性数量约束、字段依赖约束、条件子 schema 与组合约束。
///     该模型将对象级约束与数组 / 标量约束拆开保存，避免运行时节点继续暴露无关成员。
/// </summary>
internal sealed class YamlConfigObjectConstraints
{
    /// <summary>
    ///     初始化对象约束模型。
    /// </summary>
    /// <param name="minProperties">最小属性数量约束。</param>
    /// <param name="maxProperties">最大属性数量约束。</param>
    /// <param name="dependentRequired">对象内字段依赖约束。</param>
    /// <param name="dependentSchemas">对象内条件 schema 约束。</param>
    /// <param name="allOfSchemas">对象内组合 schema 约束。</param>
    /// <param name="conditionalSchemas">对象内条件分支约束。</param>
    public YamlConfigObjectConstraints(
        int? minProperties,
        int? maxProperties,
        IReadOnlyDictionary<string, IReadOnlyList<string>>? dependentRequired,
        IReadOnlyDictionary<string, YamlConfigSchemaNode>? dependentSchemas,
        IReadOnlyList<YamlConfigSchemaNode>? allOfSchemas,
        YamlConfigConditionalSchemas? conditionalSchemas)
    {
        MinProperties = minProperties;
        MaxProperties = maxProperties;
        DependentRequired = dependentRequired;
        DependentSchemas = dependentSchemas;
        AllOfSchemas = allOfSchemas;
        ConditionalSchemas = conditionalSchemas;
    }

    /// <summary>
    ///     获取最小属性数量约束。
    /// </summary>
    public int? MinProperties { get; }

    /// <summary>
    ///     获取最大属性数量约束。
    /// </summary>
    public int? MaxProperties { get; }

    /// <summary>
    ///     获取对象内字段依赖约束。
    ///     键表示“触发字段”，值表示“触发字段出现后还必须存在的同级字段集合”。
    /// </summary>
    public IReadOnlyDictionary<string, IReadOnlyList<string>>? DependentRequired { get; }

    /// <summary>
    ///     获取对象内条件 schema 约束。
    ///     键表示“触发字段”，值表示“触发字段出现后当前对象还必须满足的额外 schema 子树”。
    /// </summary>
    public IReadOnlyDictionary<string, YamlConfigSchemaNode>? DependentSchemas { get; }

    /// <summary>
    ///     获取对象内 <c>allOf</c> 组合约束。
    ///     每个条目都表示“当前对象还必须额外满足的 focused constraint block”。
    /// </summary>
    public IReadOnlyList<YamlConfigSchemaNode>? AllOfSchemas { get; }

    /// <summary>
    ///     获取对象内 object-focused <c>if</c> / <c>then</c> / <c>else</c> 条件约束。
    ///     该模型会先用 <c>if</c> 试匹配当前对象，再只对命中的分支叠加 focused constraint block。
    /// </summary>
    public YamlConfigConditionalSchemas? ConditionalSchemas { get; }
}