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

#nullable disable

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,
}
