// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.

namespace System.Speech.Internal.SrgsParser
{
    /// <summary>
    /// Interface definition for the IElementFactory
    /// </summary>
    internal interface IElementFactory
    {
        // Grammar
        void RemoveAllRules();

        IElementText CreateText(IElement parent, string value);
        IToken CreateToken(IElement parent, string content, string? pronunciation, string? display, float reqConfidence);
        IPropertyTag CreatePropertyTag(IElement parent);
        ISemanticTag CreateSemanticTag(IElement parent);
        IItem CreateItem(IElement? parent, IRule rule, int minRepeat, int maxRepeat, float repeatProbability, float weight);
        IRuleRef CreateRuleRef(IElement parent, Uri srgsUri);
        IRuleRef CreateRuleRef(IElement parent, Uri srgsUri, string? semanticKey, string? parameters);
        void InitSpecialRuleRef(IElement parent, IRuleRef special);
        IOneOf CreateOneOf(IElement parent, IRule rule);
        ISubset CreateSubset(IElement parent, string text, MatchMode matchMode);

        IGrammar Grammar { get; }

        IRuleRef Null { get; }
        IRuleRef Void { get; }
        IRuleRef Garbage { get; }

        string AddScript(IGrammar grammar, string rule, string code, string? filename, int line);
        void AddScript(IGrammar grammar, string script, string? filename, int line);
        void AddScript(IGrammar grammar, string rule, string code);

        void AddItem(IOneOf oneOf, IItem value);
        void AddElement(IRule rule, IElement value);
        void AddElement(IItem item, IElement value);
    }
}