// Copyright(c) .NET Foundation.All rights reserved.
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.

namespace Microsoft.AspNetCore.Razor.Language
{
    /// <summary>
    /// The way a directive can be used. The usage determines how many, and where directives can exist per file.
    /// </summary>
    public enum DirectiveUsage
    {
        /// <summary>
        /// Directive can exist anywhere in the file.
        /// </summary>
        Unrestricted,

        /// <summary>
        /// Directive must exist prior to any HTML or code and have no duplicates. When importing the directive, if it is 
        /// <see cref="DirectiveKind.SingleLine"/>, the last occurrence of the directive is imported.
        /// </summary>
        FileScopedSinglyOccurring,

        /// <summary>
        /// Directive must exist prior to any HTML or code.
        /// </summary>
        FileScopedMultipleOccurring,
    }
}