[Feature] Modal Select Components Support for IF

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) { }
+}

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

@@ -0,0 +1,58 @@
+using System;
+
+namespace Discord.Interactions;
+
+/// <summary>
+///     Adds a select menu option to the marked field.
+/// </summary>
+/// <remarks>
+///     To add additional metadata to enum fields, use <see cref="SelectMenuOptionAttribute"/> instead.
+/// </remarks>
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+public class ModalSelectMenuOptionAttribute : Attribute
+{
+    /// <summary>
+    ///     Gets the label of the option.
+    /// </summary>
+    public string Label { get; }
+
+    /// <summary>
+    ///     Gets or sets the description of the option.
+    /// </summary>
+    public string Description { get; set; }
+
+    /// <summary>
+    ///     Gets the value of the option.
+    /// </summary>
+    public string Value { get; }
+
+    /// <summary>
+    ///     Gets or sets the emote of the option.
+    /// </summary>
+    /// <remarks>
+    ///     Can be either an <see cref="Emoji"/> or an <see cref="Discord.Emote"/>
+    /// </remarks>
+    public string Emote { get; set; }
+
+    /// <summary>
+    ///     Gets or sets whether the option is selected by default.
+    /// </summary>
+    public bool IsDefault { get; set; }
+
+    /// <summary>
+    ///     Create a new <see cref="ModalSelectComponentAttribute"/>.
+    /// </summary>
+    /// <param name="label">Label of the option.</param>
+    /// <param name="value">Value of the option.</param>
+    /// <param name="description">Description of the option.</param>
+    /// <param name="emote">Emote of the option. Can be either an <see cref="Emoji"/> or an <see cref="Discord.Emote"/></param>
+    /// <param name="isDefault">Whether the option is selected by default</param>
+    public ModalSelectMenuOptionAttribute(string label, string value, string description = null, string emote = null, bool isDefault = false)
+    {
+        Label = label;
+        Value = value;
+        Description = description;
+        Emote = emote;
+        IsDefault = isDefault;
+    }
+}

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

@@ -0,0 +1,24 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a text input.
+/// </summary>
+public class ModalTextDisplayAttribute : ModalComponentAttribute
+{
+    /// <inheritdoc/>
+    public override ComponentType ComponentType => ComponentType.TextDisplay;
+
+    /// <summary>
+    ///     Gets the content of the text display.
+    /// </summary>
+    public string Content { get; }
+
+    /// <summary>
+    ///     Create a new <see cref="ModalTextInputAttribute"/>.
+    /// </summary>
+    /// <param name="content">Content of the text display.</param>
+    public ModalTextDisplayAttribute(string content = null)
+    {
+        Content = content;
+    }
+}

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

@@ -0,0 +1,18 @@
+namespace Discord.Interactions;
+
+/// <summary>
+///     Marks a <see cref="IModal"/> property as a user select input.
+/// </summary>
+public class ModalUserSelectAttribute : ModalSelectComponentAttribute
+{
+    /// <inheritdoc/>
+    public override ComponentType ComponentType => ComponentType.UserSelect;
+
+    /// <summary>
+    ///     Create a new <see cref="ModalUserSelectAttribute"/>.
+    /// </summary>
+    /// <param name="customId">Custom ID of the user 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 ModalUserSelectAttribute(string customId, int minValues = 1, int maxValues = 1) : base(customId, minValues, maxValues) { }
+}

src/Discord.Net.Interactions/Builders/Modals/Components/ChannelSelectComponentBuilder.cs

@@ -0,0 +1,47 @@
+using System.Collections.Generic;
+using System.Linq;
+
+namespace Discord.Interactions.Builders;
+
+/// <summary>
+///     Represents a builder for creating <see cref="ChannelSelectComponentInfo"/>.
+/// </summary>
+public class ChannelSelectComponentBuilder : SnowflakeSelectComponentBuilder<ChannelSelectComponentInfo, ChannelSelectComponentBuilder>
+{
+    protected override ChannelSelectComponentBuilder Instance => this;
+
+    /// <summary>
+    ///     Initializes a new <see cref="ChannelSelectComponentBuilder"/>.
+    /// </summary>
+    /// <param name="modal">Parent modal of this component.</param>
+    public ChannelSelectComponentBuilder(ModalBuilder modal) : base(modal, ComponentType.ChannelSelect) { }
+
+    /// <summary>
+    ///     Adds a default value to <see cref="SnowflakeSelectComponentBuilder{TInfo, TBuilder}.DefaultValues"/>.
+    /// </summary>
+    /// <param name="channelId">The channel ID to add as a default value.</param>
+    /// <returns>
+    ///     The builder instance.
+    /// </returns>
+    public ChannelSelectComponentBuilder AddDefaulValue(ulong channelId)
+    {
+        _defaultValues.Add(new SelectMenuDefaultValue(channelId, SelectDefaultValueType.Channel));
+        return this;
+    }
+
+    /// <summary>
+    ///     Adds default values to <see cref="SnowflakeSelectComponentBuilder{TInfo, TBuilder}.DefaultValues"/>.
+    /// </summary>
+    /// <param name="channels">The channels to add as a default value.</param>
+    /// <returns>
+    ///     The builder instance.
+    /// </returns>
+    public ChannelSelectComponentBuilder AddDefaultValues(params IEnumerable<IChannel> channels)
+    {
+        _defaultValues.AddRange(channels.Select(x => new SelectMenuDefaultValue(x.Id, SelectDefaultValueType.Channel)));
+        return this;
+    }
+
+    internal override ChannelSelectComponentInfo Build(ModalInfo modal)
+        => new(this, modal);
+}