feat: add radio and checkbox group components for modals

Introduces DiscordRadioGroupComponent, DiscordCheckboxGroupComponent, and DiscordCheckboxComponent for modal-only usage, along with their option classes. Updates validation logic to restrict these components to modals, extends serialization and deserialization support, and adds new ComponentType enum values. Also adds builder methods to DiscordLabelComponent for attaching these new components.

Author: Lulalaby

DisCatSharp/Entities/Components/DiscordLabelComponent.cs

@@ -1,3 +1,5 @@
+using System.Collections.Generic;
+
 using DisCatSharp.Enums;
 using DisCatSharp.Net.Serialization;
 
@@ -75,6 +77,36 @@ public DiscordLabelComponent WithFileUploadComponent(DiscordFileUploadComponent
 		return this;
 	}
 
+	/// <summary>
+	/// 	Sets the radio group component for the label.
+	/// </summary>
+	/// <param name="component">The radio group component to attach to the label.</param>
+	public DiscordLabelComponent WithRadioGroupComponent(DiscordRadioGroupComponent component)
+	{
+		this.Component = component;
+		return this;
+	}
+
+	/// <summary>
+	/// 	Sets the checkbox group component for the label.
+	/// </summary>
+	/// <param name="component">The checkbox group component to attach to the label.</param>
+	public DiscordLabelComponent WithCheckboxGroupComponent(DiscordCheckboxGroupComponent component)
+	{
+		this.Component = component;
+		return this;
+	}
+
+	/// <summary>
+	/// 	Sets the checkbox component for the label.
+	/// </summary>
+	/// <param name="component">The checkbox component to attach to the label.</param>
+	public DiscordLabelComponent WithCheckboxComponent(DiscordCheckboxComponent component)
+	{
+		this.Component = component;
+		return this;
+	}
+
 	/// <summary>
 	///     The label.
 	/// </summary>
@@ -100,6 +132,13 @@ public DiscordLabelComponent WithFileUploadComponent(DiscordFileUploadComponent
 	public ComponentType SubComponentType
 		=> (this.Component as DiscordComponent).Type;
 
+	/// <inheritdoc />
+	public override IEnumerable<DiscordComponent> GetChildren()
+	{
+		if (this.Component is DiscordComponent component)
+			yield return component;
+	}
+
 	/// <summary>
 	///     Assigns a unique id to this component.
 	/// </summary>

DisCatSharp/Entities/Components/V2Components/DiscordCheckboxComponent.cs

@@ -0,0 +1,61 @@
+using System;
+
+using DisCatSharp.Enums;
+
+using Newtonsoft.Json;
+
+namespace DisCatSharp.Entities;
+
+/// <summary>
+///     Represents a single checkbox component. Modal-only.
+/// </summary>
+public sealed class DiscordCheckboxComponent : DiscordComponent, ILabelComponent
+{
+	/// <summary>
+	///     Creates a new empty checkbox component.
+	/// </summary>
+	internal DiscordCheckboxComponent()
+	{
+		this.Type = ComponentType.Checkbox;
+	}
+
+	/// <summary>
+	///     Creates a new checkbox component with the provided options.
+	/// </summary>
+	/// <param name="customId">The custom id for this component.</param>
+	/// <param name="isDefault">Whether the checkbox is checked by default.</param>
+	public DiscordCheckboxComponent(string? customId = null, bool? isDefault = null)
+		: this()
+	{
+		this.CustomId = customId ?? Guid.NewGuid().ToString();
+		this.Default = isDefault;
+	}
+
+	/// <summary>
+	///     The custom id for this component.
+	/// </summary>
+	[JsonProperty("custom_id", NullValueHandling = NullValueHandling.Ignore)]
+	public override string? CustomId { get; internal set; } = Guid.NewGuid().ToString();
+
+	/// <summary>
+	///     Whether the checkbox is checked by default.
+	/// </summary>
+	[JsonProperty("default", NullValueHandling = NullValueHandling.Ignore)]
+	public bool? Default { get; internal set; }
+
+	/// <summary>
+	///     The submitted value. Present on modal submit interactions.
+	/// </summary>
+	[JsonProperty("value", NullValueHandling = NullValueHandling.Ignore)]
+	public bool? Value { get; internal set; }
+
+	/// <summary>
+	///     Assigns a unique id to this component.
+	/// </summary>
+	/// <param name="id">The id to assign.</param>
+	public DiscordCheckboxComponent WithId(int id)
+	{
+		this.Id = id;
+		return this;
+	}
+}

DisCatSharp/Entities/Components/V2Components/DiscordCheckboxGroupComponent.cs

@@ -0,0 +1,104 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+using DisCatSharp.Enums;
+
+using Newtonsoft.Json;
+
+namespace DisCatSharp.Entities;
+
+/// <summary>
+///     Represents a checkbox group component. Modal-only.
+/// </summary>
+public sealed class DiscordCheckboxGroupComponent : DiscordComponent, ILabelComponent
+{
+	/// <summary>
+	///     Creates a new empty checkbox group component.
+	/// </summary>
+	internal DiscordCheckboxGroupComponent()
+	{
+		this.Type = ComponentType.CheckboxGroup;
+	}
+
+	/// <summary>
+	///     Creates a new checkbox group component with the provided options.
+	/// </summary>
+	/// <param name="options">The selectable options. Must contain between 1 and 10 entries.</param>
+	/// <param name="customId">The custom id for this component.</param>
+	/// <param name="minValues">The minimum number of selections. Defaults to 1.</param>
+	/// <param name="maxValues">The maximum number of selections. Defaults to the number of options.</param>
+	/// <param name="required">Whether a selection is required.</param>
+	public DiscordCheckboxGroupComponent(IEnumerable<DiscordCheckboxGroupComponentOption> options, string? customId = null, int? minValues = null, int? maxValues = null, bool? required = null)
+		: this()
+	{
+		ArgumentNullException.ThrowIfNull(options);
+		var optionList = options.ToList();
+		if (optionList.Count is < 1 or > 10)
+			throw new ArgumentException("Checkbox groups must include between 1 and 10 options.");
+
+		var minimum = minValues ?? 1;
+		var maximum = maxValues ?? optionList.Count;
+
+		if (minimum is < 0 or > 10)
+			throw new ArgumentException("Minimum values must be between 0 and 10.", nameof(minValues));
+		if (maximum is < 1 or > 10)
+			throw new ArgumentException("Maximum values must be between 1 and 10.", nameof(maxValues));
+		if (minimum > maximum)
+			throw new ArgumentException("Minimum values cannot exceed maximum values.");
+		if (maximum > optionList.Count)
+			throw new ArgumentException("Maximum values cannot exceed the number of options.");
+
+		this.CustomId = customId ?? Guid.NewGuid().ToString();
+		this.Options = optionList;
+		this.MinimumValues = minimum;
+		this.MaximumValues = maximum;
+		this.Required = required;
+	}
+
+	/// <summary>
+	///     The custom id for this component.
+	/// </summary>
+	[JsonProperty("custom_id", NullValueHandling = NullValueHandling.Ignore)]
+	public override string? CustomId { get; internal set; } = Guid.NewGuid().ToString();
+
+	/// <summary>
+	///     The available options.
+	/// </summary>
+	[JsonProperty("options", NullValueHandling = NullValueHandling.Ignore)]
+	public IReadOnlyList<DiscordCheckboxGroupComponentOption> Options { get; internal set; } = Array.Empty<DiscordCheckboxGroupComponentOption>();
+
+	/// <summary>
+	///     The minimum number of selections.
+	/// </summary>
+	[JsonProperty("min_values", NullValueHandling = NullValueHandling.Ignore)]
+	public int? MinimumValues { get; internal set; } = 1;
+
+	/// <summary>
+	///     The maximum number of selections.
+	/// </summary>
+	[JsonProperty("max_values", NullValueHandling = NullValueHandling.Ignore)]
+	public int? MaximumValues { get; internal set; }
+
+	/// <summary>
+	///     Whether the component requires a selection.
+	/// </summary>
+	[JsonProperty("required", NullValueHandling = NullValueHandling.Ignore)]
+	public bool? Required { get; internal set; }
+
+	/// <summary>
+	///     The submitted values. Present on modal submit interactions.
+	/// </summary>
+	[JsonProperty("values", NullValueHandling = NullValueHandling.Ignore)]
+	public string[]? Values { get; internal set; }
+
+	/// <summary>
+	///     Assigns a unique id to this component.
+	/// </summary>
+	/// <param name="id">The id to assign.</param>
+	public DiscordCheckboxGroupComponent WithId(int id)
+	{
+		this.Id = id;
+		return this;
+	}
+}

DisCatSharp/Entities/Components/V2Components/DiscordCheckboxGroupComponentOption.cs

@@ -0,0 +1,61 @@
+using System;
+
+using Newtonsoft.Json;
+
+namespace DisCatSharp.Entities;
+
+/// <summary>
+///     Represents an option within a checkbox group component.
+/// </summary>
+public sealed class DiscordCheckboxGroupComponentOption : ObservableApiObject
+{
+	/// <summary>
+	///     Creates a new checkbox group option.
+	/// </summary>
+	/// <param name="label">The display label. Max 100 characters.</param>
+	/// <param name="value">The option value. Max 100 characters.</param>
+	/// <param name="description">An optional description. Max 100 characters.</param>
+	/// <param name="isDefault">Whether this option should be selected by default.</param>
+	public DiscordCheckboxGroupComponentOption(string label, string value, string? description = null, bool isDefault = false)
+	{
+		if (string.IsNullOrWhiteSpace(label))
+			throw new ArgumentException("Label must be provided.", nameof(label));
+		if (string.IsNullOrWhiteSpace(value))
+			throw new ArgumentException("Value must be provided.", nameof(value));
+		if (label.Length > 100)
+			throw new ArgumentException("Option label cannot exceed 100 characters.", nameof(label));
+		if (value.Length > 100)
+			throw new ArgumentException("Option value cannot exceed 100 characters.", nameof(value));
+		if (description is { Length: > 100 })
+			throw new ArgumentException("Option description cannot exceed 100 characters.", nameof(description));
+
+		this.Label = label;
+		this.Value = value;
+		this.Description = description;
+		this.Default = isDefault;
+	}
+
+	/// <summary>
+	///     The display label.
+	/// </summary>
+	[JsonProperty("label", NullValueHandling = NullValueHandling.Ignore)]
+	public string Label { get; internal set; }
+
+	/// <summary>
+	///     The underlying value returned on submit.
+	/// </summary>
+	[JsonProperty("value", NullValueHandling = NullValueHandling.Ignore)]
+	public string Value { get; internal set; }
+
+	/// <summary>
+	///     Optional helper text.
+	/// </summary>
+	[JsonProperty("description", NullValueHandling = NullValueHandling.Ignore)]
+	public string? Description { get; internal set; }
+
+	/// <summary>
+	///     Whether this option is pre-selected.
+	/// </summary>
+	[JsonProperty("default", NullValueHandling = NullValueHandling.Ignore)]
+	public bool Default { get; internal set; }
+}

DisCatSharp/Entities/Components/V2Components/DiscordRadioGroupComponent.cs

@@ -0,0 +1,85 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+using DisCatSharp.Enums;
+
+using Newtonsoft.Json;
+
+namespace DisCatSharp.Entities;
+
+/// <summary>
+///     Represents a radio group component. Modal-only.
+/// </summary>
+public sealed class DiscordRadioGroupComponent : DiscordComponent, ILabelComponent
+{
+	/// <summary>
+	///     Creates a new empty radio group component.
+	/// </summary>
+	internal DiscordRadioGroupComponent()
+	{
+		this.Type = ComponentType.RadioGroup;
+	}
+
+	/// <summary>
+	///     Creates a new radio group component with the provided options.
+	/// </summary>
+	/// <param name="options">The selectable options. Must contain between 2 and 10 entries.</param>
+	/// <param name="customId">The custom id for this component.</param>
+	/// <param name="required">Whether a selection is required.</param>
+	public DiscordRadioGroupComponent(IEnumerable<DiscordRadioGroupComponentOption> options, string? customId = null, bool? required = null)
+		: this()
+	{
+		ArgumentNullException.ThrowIfNull(options);
+		var optionList = options.ToList();
+		if (optionList.Count is < 2 or > 10)
+			throw new ArgumentException("Radio groups must include between 2 and 10 options.");
+		if (optionList.Count(x => x.Default) > 1)
+			throw new ArgumentException("Only one radio option can be marked as default.");
+
+		this.CustomId = customId ?? Guid.NewGuid().ToString();
+		this.Options = optionList;
+		this.Required = required;
+	}
+
+	/// <summary>
+	///     The custom id for this component.
+	/// </summary>
+	[JsonProperty("custom_id", NullValueHandling = NullValueHandling.Ignore)]
+	public override string? CustomId { get; internal set; } = Guid.NewGuid().ToString();
+
+	/// <summary>
+	///     The available options.
+	/// </summary>
+	[JsonProperty("options", NullValueHandling = NullValueHandling.Ignore)]
+	public IReadOnlyList<DiscordRadioGroupComponentOption> Options { get; internal set; } = Array.Empty<DiscordRadioGroupComponentOption>();
+
+	/// <summary>
+	///     Whether the component requires a selection.
+	/// </summary>
+	[JsonProperty("required", NullValueHandling = NullValueHandling.Ignore)]
+	public bool? Required { get; internal set; }
+
+	/// <summary>
+	///     The submitted values. Present on modal submit interactions.
+	/// </summary>
+	[JsonProperty("values", NullValueHandling = NullValueHandling.Ignore)]
+	public string[]? Values { get; internal set; }
+
+	/// <summary>
+	///     Convenience accessor for the first submitted value.
+	/// </summary>
+	[JsonIgnore]
+	public string? SelectedValue
+		=> this.Values?.FirstOrDefault();
+
+	/// <summary>
+	///     Assigns a unique id to this component.
+	/// </summary>
+	/// <param name="id">The id to assign.</param>
+	public DiscordRadioGroupComponent WithId(int id)
+	{
+		this.Id = id;
+		return this;
+	}
+}