[Feature] Modal Select Components Support for IF (#3189)

* add interaction service attributes new modal input types

* add new modal component type converters

* relocate hide attribute outside of slash command enum converter for general purpose use

* refactor base inputcomponentbuilder types to use modal component typeconverters

* add builders for new modal input types

* add component insertion methods to modal builder for new input types

* refactor base inputcomponentinfo class to use modal component typeconverters

* add component info classes for newly added modal input types

* add build logic for new modal input metadata classes

* add componet collection properties for new modal input types to modalinfo

* implement convertion logic for new modal inputs to the respond with modal extension methods

* implement modal input typeconverters into interaction service

* add read logic to enum modal component typeconverter

* add default entity modal component typeconverter

* add write logic to default value modal component typeconverter

* add write logic to the nullable modal component typeconverter

* add description property to input label attribute

* add inline docs to modal attributes

* add modal file upload attribute

* add inline docs to input component infos

* add description property to input component builder

* add inline docs to modal component builders

* add modal file upload component info

* add modal file upload component builder

* rename select input attribute

* refactor select input attribute and add description property in moduleClassBuilder

* add inline docs to modalBuilder

* add description to inputComponentInfo

* file-scope namespace for commandBuilder and modal interfaces

* update respondWithModal logic to include new components

* add inline docs and file upload component to modalInfo

* add attachment modal typeconverter

* create base non-input modal component entities

* update modal component typeconverter namespaces and remove unused

* add default min/max values to select input attribute

* create text display builder and info classes

* add text display parsing logic

* add text display attribute

* add modal select menu option attribute

* add docs to text display component info

* fix text display parsing

* add isRequired mapping to select menus

* revert to block-scope to clear diff false-positives

* fix inline doc annotations

* fix build errors

* add interaction parameter to modal component typeconverter write method

* add null check to select menu option attribute

* add null check to default value modalTypeConverter write method

* make ctors of modal component base attributes internal

* implement predicate to hide attribute and enum modalcomponent typeconverter

* fix HideAttribute inline docs build errors

* simplify naming of the component classes and normalize namespaces

* fix build errors in module class builder

* add inline docs to modalComponentTypeConverter TryGetModalInteractionData

* add min/max values parameters to ModalChannelSelectAttribute

* fix defaultArrayModalTypeConverter chanell type write logic

* simplify addDefaultValue methods for channe, mentionable, role, and user selects

* add emoji support to select menu options

* add instance value parsing to enum modalComponentConverter

Author: Cenngo

src/Discord.Net.Interactions/Attributes/HideAttribute.cs

@@ -0,0 +1,25 @@
+using System;
+
+namespace Discord.Interactions;
+
+/// <summary>
+///     Enum values tagged with this attribute will not be displayed as a parameter choice
+/// </summary>
+/// <remarks>
+///     This attribute must be used along with the default <see cref="EnumConverter{T}"/> and <see cref="DefaultEntityTypeConverter{T}"/>.
+/// </remarks>
+[AttributeUsage(AttributeTargets.Field, AllowMultiple = false, Inherited = true)]
+public class HideAttribute : Attribute
+{
+    /// <summary>
+    ///     Can be optionally implemented by inherited types to conditionally hide an enum value.
+    /// </summary>
+    /// <remarks>
+    ///     Only runs on prior to modal construction. For slash command parameters, this method is ignored.
+    /// </remarks>
+    /// <param name="interaction">Interaction that <see cref="IDiscordInteractionExtentions.RespondWithModalAsync{T}(IDiscordInteraction, string, T, RequestOptions, Action{ModalBuilder})"/> is called on.</param>
+    /// <returns>
+    ///     <see langword="true"/> if the attribute should be active and hide the value.
+    /// </returns>
+    public virtual bool Predicate(IDiscordInteraction interaction) => true;
+}

src/Discord.Net.Interactions/Attributes/Modals/InputLabelAttribute.cs

@@ -13,13 +13,20 @@ public class InputLabelAttribute : Attribute
         /// </summary>
         public string Label { get; }
 
+        /// <summary>
+        ///     Gets the label description of the input.
+        /// </summary>
+        public string Description { get; set; }
+
         /// <summary>
         ///     Creates a custom label for an modal input.
         /// </summary>
         /// <param name="label">The label of the input.</param>
-        public InputLabelAttribute(string label)
+        /// <param name="description">The label description of the input.</param>
+        public InputLabelAttribute(string label, string description = null)
         {
             Label = label;
+            Description = description;
         }
     }
 }

src/Discord.Net.Interactions/Attributes/Modals/ModalChannelSelectAttribute.cs

@@ -0,0 +1,16 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a channel select.
+/// </summary>
+public class ModalChannelSelectAttribute : ModalSelectComponentAttribute
+{
+    /// <inheritdoc/>
+    public override ComponentType ComponentType => ComponentType.ChannelSelect;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalChannelSelectAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the channel select component.</param>
+    public ModalChannelSelectAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId, minValues, maxValues) { }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalComponentAttribute.cs

@@ -0,0 +1,17 @@
+using System;
+
+namespace Discord.Interactions;
+
+/// <summary>
+///     Mark an <see cref="IModal"/> property as a modal component field.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
+public abstract class ModalComponentAttribute : Attribute
+{
+    /// <summary>
+    ///     Gets the type of the component.
+    /// </summary>
+    public abstract ComponentType ComponentType { get; }
+
+    internal ModalComponentAttribute() { }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalFileUploadAttribute.cs

@@ -0,0 +1,32 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a file upload input.
+/// </summary>
+public class ModalFileUploadAttribute : ModalInputAttribute
+{
+    /// <inheritdoc/>
+    public override ComponentType ComponentType => ComponentType.FileUpload;
+
+    /// <summary>
+    ///     Get the minimum number of files that can be uploaded.
+    /// </summary>
+    public int MinValues { get; set; } = 1;
+
+    /// <summary>
+    ///     Get the maximum number of files that can be uploaded.
+    /// </summary>
+    public int MaxValues { get; set; } = 1;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalFileUploadAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the file upload component.</param>
+    /// <param name="minValues">Minimum number of files that can be uploaded.</param>
+    /// <param name="maxValues">Maximum number of files that can be uploaded.</param>
+    public ModalFileUploadAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId)
+    {
+        MinValues = minValues;
+        MaxValues = maxValues;
+    }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalInputAttribute.cs

@@ -6,23 +6,18 @@ namespace Discord.Interactions
     ///     Mark an <see cref="IModal"/> property as a modal input field.
     /// </summary>
     [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
-    public abstract class ModalInputAttribute : Attribute
+    public abstract class ModalInputAttribute : ModalComponentAttribute
     {
         /// <summary>
         ///     Gets the custom id of the text input.
         /// </summary>
         public string CustomId { get; }
 
-        /// <summary>
-        ///     Gets the type of the component.
-        /// </summary>
-        public abstract ComponentType ComponentType { get; }
-
         /// <summary>
         ///     Create a new <see cref="ModalInputAttribute"/>.
         /// </summary>
         /// <param name="customId">The custom id of the input.</param>
-        protected ModalInputAttribute(string customId)
+        internal ModalInputAttribute(string customId)
         {
             CustomId = customId;
         }

src/Discord.Net.Interactions/Attributes/Modals/ModalMentionableSelectAttribute.cs

@@ -0,0 +1,18 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a mentionable select input.
+/// </summary>
+public class ModalMentionableSelectAttribute : ModalSelectComponentAttribute
+{
+    /// <inheritdoc />
+    public override ComponentType ComponentType => ComponentType.MentionableSelect;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalMentionableSelectAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the mentionable select component.</param>
+    /// <param name="minValues">Minimum number of values that can be selected.</param>
+    /// <param name="maxValues">Maximum number of values that can be selected</param>
+    public ModalMentionableSelectAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId, minValues, maxValues) { }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalRoleSelectAttribute.cs

@@ -0,0 +1,18 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a role select input.
+/// </summary>
+public class ModalRoleSelectAttribute : ModalSelectComponentAttribute
+{
+    /// <inheritdoc/>
+    public override ComponentType ComponentType => ComponentType.RoleSelect;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalRoleSelectAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the role select component.</param>
+    /// <param name="minValues">Minimum number of values that can be selected.</param>
+    /// <param name="maxValues">Maximum number of values that can be selected.</param>
+    public ModalRoleSelectAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId, minValues, maxValues) { }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalSelectComponentAttribute.cs

@@ -0,0 +1,28 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Base attribute for select-menu, user, channel, role, and mentionable select inputs in modals.
+/// </summary>
+public abstract class ModalSelectComponentAttribute : ModalInputAttribute
+{
+    /// <summary>
+    ///     Gets or sets the minimum number of values that can be selected.
+    /// </summary>
+    public int MinValues { get; set; } = 1;
+
+    /// <summary>
+    ///     Gets or sets the maximum number of values that can be selected.
+    /// </summary>
+    public int MaxValues { get; set; } = 1;
+
+    /// <summary>
+    ///     Gets or sets the placeholder text.
+    /// </summary>
+    public string Placeholder { get; set; }
+
+    internal ModalSelectComponentAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId)
+    {
+        MinValues = minValues;
+        MaxValues = maxValues;
+    }
+}

src/Discord.Net.Interactions/Attributes/Modals/ModalSelectMenuAttribute.cs

@@ -0,0 +1,18 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a select menu input.
+/// </summary>
+public sealed class ModalSelectMenuAttribute : ModalSelectComponentAttribute
+{
+    /// <inheritdoc />
+    public override ComponentType ComponentType => ComponentType.SelectMenu;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalSelectMenuAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the select menu component.</param>
+    /// <param name="minValues">Minimum number of values that can be selected.</param>
+    /// <param name="maxValues">Maximum number of values that can be selected.</param>
+    public ModalSelectMenuAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId, minValues, maxValues) { }
+}