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

namespace Microsoft.TemplateEngine.Orchestrator.RunnableProjects.ConfigModel
{
    /// <summary>
    /// Represents an instruction that should be manually performed by the user
    /// as part of a post action.
    /// </summary>
    public sealed class ManualInstructionModel : ConditionedConfigurationElement
    {
        internal ManualInstructionModel(string? id, string text)
        {
            Id = id;
            Text = text;
        }

        internal ManualInstructionModel(string? id, string text, string? condition)
        {
            Id = id;
            Text = text;
            Condition = condition;
        }

        /// <summary>
        /// Gets the string identifying this instruction within the post action.
        /// This property can be null if the author has not provided one. In that case this manual instruction
        /// cannot be referenced in a context where an id is required, such as in templatestrings.json files.
        /// </summary>
        public string? Id { get; }

        /// <summary>
        /// Gets the text explaining the steps the user should take.
        /// </summary>
        public string Text { get; private set; }

        /// <summary>
        /// Localizes this manual instruction by replacing the value of the <see cref="Text"/> property the given text.
        /// </summary>
        /// <param name="localizedText">Localized <see cref="Text"/>.</param>
        internal void Localize(string localizedText)
        {
            Text = localizedText;
        }
    }
}