Implement RadioGroup, CheckboxGroup, and Checkbox modal components (#138)

* Implement new modal components: RadioGroup, CheckboxGroup, Checkbox

This commit introduces support for the new Discord components: Radio Group, Checkbox Group, and Checkbox.

Key changes:
- Added `ComponentType` enum values for `RadioGroup`, `CheckboxGroup`, and `Checkbox`.
- Created JSON models for local and modal (transient) representations of these components.
- Implemented `LocalComponent` classes (`LocalRadioGroupComponent`, `LocalCheckboxGroupComponent`, `LocalCheckboxComponent`) for constructing these components.
- Implemented `IModalComponent` interfaces and `TransientModalComponent` classes for handling received components in modal submissions.
- Updated `LocalComponent.ToModel()` to serialize the new components properly.
- Updated `BindValues` command execution step to support parameter binding for these new component types in modal commands.

Co-authored-by: Quahu <24848652+Quahu@users.noreply.github.com>

* Implement new modal components: RadioGroup, CheckboxGroup, Checkbox

This commit introduces support for the new Discord components: Radio Group, Checkbox Group, and Checkbox.

Key changes:
- Added `ComponentType` enum values for `RadioGroup`, `CheckboxGroup`, and `Checkbox`.
- Created JSON models for local and modal (transient) representations of these components.
- Implemented `LocalComponent` classes (`LocalRadioGroupComponent`, `LocalCheckboxGroupComponent`, `LocalCheckboxComponent`) for constructing these components.
- Implemented `IModalComponent` interfaces and `TransientModalComponent` classes for handling received components in modal submissions.
- Updated `LocalComponent.ToModel()` to serialize the new components properly.
- Updated `BindValues` command execution step to support parameter binding for these new component types in modal commands.
- Added fluent builder extension methods for the new local components.

Co-authored-by: Quahu <24848652+Quahu@users.noreply.github.com>

* Implement new modal components: RadioGroup, CheckboxGroup, Checkbox

This commit introduces support for the new Discord components: Radio Group, Checkbox Group, and Checkbox.

Key changes:
- Added `ComponentType` enum values for `RadioGroup`, `CheckboxGroup`, and `Checkbox`.
- Created JSON models for local and modal (transient) representations of these components.
- Implemented `LocalComponent` classes (`LocalRadioGroupComponent`, `LocalCheckboxGroupComponent`, `LocalCheckboxComponent`) for constructing these components.
- Implemented `IModalComponent` interfaces and `TransientModalComponent` classes for handling received components in modal submissions.
- Updated `LocalComponent.ToModel()` to serialize the new components properly.
- Updated `BindValues` command execution step to support parameter binding for these new component types in modal commands.
- Added fluent builder extension methods for the new local components.
- Ensured consistency with existing component patterns, including usage of `Optional<T>` and generic extension methods.

Co-authored-by: Quahu <24848652+Quahu@users.noreply.github.com>

* Implement new modal components: RadioGroup, CheckboxGroup, Checkbox

This commit introduces full support for the new Discord modal components: Radio Group, Checkbox Group, and Checkbox.

Key changes:
- Added `ComponentType` enum values for `RadioGroup`, `CheckboxGroup`, and `Checkbox`.
- Created JSON models for local and modal (transient) representations of these components.
- Implemented `LocalComponent` classes (`LocalRadioGroupComponent`, `LocalCheckboxGroupComponent`, `LocalCheckboxComponent`) and their option classes.
- Implemented `IModalComponent` interfaces and `TransientModalComponent` classes.
- Updated `LocalComponent.ToModel()` to serialize the new components properly, using `OptionalGuard` for validation.
- Updated `ModalComponentConverter` to handle polymorphic deserialization of the new component types.
- Updated `BindValues` command execution step to support parameter binding for these new component types in modal commands.
- Added fluent builder extension methods and static factory methods (`LocalComponent.RadioGroup`, etc.).
- Ensured correct use of `Optional<IList<T>>` for option lists and removed unsupported `Emoji` properties from options.

Co-authored-by: Quahu <24848652+Quahu@users.noreply.github.com>

* Implement new modal components: RadioGroup, CheckboxGroup, Checkbox

This commit fully implements support for the new Discord modal components: Radio Group, Checkbox Group, and Checkbox.

Key changes:
- Added `ComponentType` enum values for `RadioGroup`, `CheckboxGroup`, and `Checkbox`.
- Created JSON models for local and modal (transient) representations of these components.
- Implemented `LocalComponent` classes (`LocalRadioGroupComponent`, `LocalCheckboxGroupComponent`, `LocalCheckboxComponent`) and their option classes.
- Implemented `IModalComponent` interfaces and `TransientModalComponent` classes for receiving modal submissions.
- Updated `LocalComponent.ToModel()` to serialize the new components properly, using `OptionalGuard` for validation.
- Updated `ModalComponentConverter` to handle polymorphic deserialization of the new component types.
- Updated `BindValues` command execution step to support parameter binding for these new component types in modal commands.
- Added fluent builder extension methods and static factory methods (`LocalComponent.RadioGroup`, etc.).
- Ensured correct use of `Optional<IList<T>>` for option lists and removed unsupported `Emoji` properties from options.
- Added `Label` support for Checkbox (optional).

Co-authored-by: Quahu <24848652+Quahu@users.noreply.github.com>

* Remove label from Checkbox factory method

---------

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>

Author: Quahu

src/Disqord.Bot/Commands/Implementation/Components/ExecutionSteps/BindValues.cs

@@ -190,6 +190,20 @@ protected virtual MultiString GetRawArgumentFromModalComponent(IModalComponent m
                 {
                     return ToMultiString(fileUploadComponent.AttachmentIds.Select(static id => id.ToString()));
                 }
+                case IModalRadioGroupComponent radioGroupComponent:
+                {
+                    return radioGroupComponent.Value != null
+                        ? new MultiString(radioGroupComponent.Value)
+                        : default;
+                }
+                case IModalCheckboxGroupComponent checkboxGroupComponent:
+                {
+                    return ToMultiString(checkboxGroupComponent.Values);
+                }
+                case IModalCheckboxComponent checkboxComponent:
+                {
+                    return new MultiString(checkboxComponent.Value.ToString());
+                }
                 default:
                 {
                     ThrowNotImplementedException($"{nameof(BindValues)}.{nameof(GetRawArgumentFromModalComponent)}() does not support the modal component of type: {modalComponent.Type} (ID: {modalComponent.Id}).");

src/Disqord.Core/Entities/Core/Interactions/Components/Modal/IModalCheckboxComponent.cs

@@ -0,0 +1,6 @@
+namespace Disqord;
+
+public interface IModalCheckboxComponent : IModalComponent, ICustomIdentifiableEntity
+{
+    bool Value { get; }
+}

src/Disqord.Core/Entities/Core/Interactions/Components/Modal/IModalCheckboxGroupComponent.cs

@@ -0,0 +1,8 @@
+using System.Collections.Generic;
+
+namespace Disqord;
+
+public interface IModalCheckboxGroupComponent : IModalComponent, ICustomIdentifiableEntity
+{
+    IReadOnlyList<string> Values { get; }
+}

src/Disqord.Core/Entities/Core/Interactions/Components/Modal/IModalRadioGroupComponent.cs

@@ -0,0 +1,6 @@
+namespace Disqord;
+
+public interface IModalRadioGroupComponent : IModalComponent, ICustomIdentifiableEntity
+{
+    string? Value { get; }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/Extensions/LocalCheckboxComponentExtensions.cs

@@ -0,0 +1,25 @@
+namespace Disqord;
+
+public static class LocalCheckboxComponentExtensions
+{
+    public static TCheckboxComponent WithLabel<TCheckboxComponent>(this TCheckboxComponent checkboxComponent, string label)
+        where TCheckboxComponent : LocalCheckboxComponent
+    {
+        checkboxComponent.Label = label;
+        return checkboxComponent;
+    }
+
+    public static TCheckboxComponent WithIsDefault<TCheckboxComponent>(this TCheckboxComponent checkboxComponent, bool isDefault = true)
+        where TCheckboxComponent : LocalCheckboxComponent
+    {
+        checkboxComponent.IsDefault = isDefault;
+        return checkboxComponent;
+    }
+
+    public static TCheckboxComponent WithIsDisabled<TCheckboxComponent>(this TCheckboxComponent checkboxComponent, bool isDisabled = true)
+        where TCheckboxComponent : LocalCheckboxComponent
+    {
+        checkboxComponent.IsDisabled = isDisabled;
+        return checkboxComponent;
+    }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/Extensions/LocalCheckboxGroupComponentExtensions.cs

@@ -0,0 +1,73 @@
+using System.Collections.Generic;
+using Qommon;
+
+namespace Disqord;
+
+public static class LocalCheckboxGroupComponentExtensions
+{
+    public static TCheckboxGroupComponent AddOption<TCheckboxGroupComponent>(this TCheckboxGroupComponent component, string label, string value, string? description = null, bool isDefault = false)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        var option = new LocalCheckboxGroupOption(label, value)
+        {
+            IsDefault = isDefault
+        };
+
+        if (description != null)
+            option.Description = description;
+
+        return component.AddOption(option);
+    }
+
+    public static TCheckboxGroupComponent AddOption<TCheckboxGroupComponent>(this TCheckboxGroupComponent component, LocalCheckboxGroupOption option)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        if (component.Options.Add(option, out var list))
+            component.Options = new(list);
+
+        return component;
+    }
+
+    public static TCheckboxGroupComponent WithOptions<TCheckboxGroupComponent>(this TCheckboxGroupComponent component, IEnumerable<LocalCheckboxGroupOption> options)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        Guard.IsNotNull(options);
+
+        if (component.Options.With(options, out var list))
+            component.Options = new(list);
+
+        return component;
+    }
+
+    public static TCheckboxGroupComponent WithOptions<TCheckboxGroupComponent>(this TCheckboxGroupComponent component, params LocalCheckboxGroupOption[] options)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+        => component.WithOptions((IEnumerable<LocalCheckboxGroupOption>) options);
+
+    public static TCheckboxGroupComponent WithMinimumSelectedOptions<TCheckboxGroupComponent>(this TCheckboxGroupComponent checkboxGroupComponent, int minimumSelectedOptions)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        checkboxGroupComponent.MinimumSelectedOptions = minimumSelectedOptions;
+        return checkboxGroupComponent;
+    }
+
+    public static TCheckboxGroupComponent WithMaximumSelectedOptions<TCheckboxGroupComponent>(this TCheckboxGroupComponent checkboxGroupComponent, int maximumSelectedOptions)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        checkboxGroupComponent.MaximumSelectedOptions = maximumSelectedOptions;
+        return checkboxGroupComponent;
+    }
+
+    public static TCheckboxGroupComponent WithIsRequired<TCheckboxGroupComponent>(this TCheckboxGroupComponent checkboxGroupComponent, bool isRequired = true)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        checkboxGroupComponent.IsRequired = isRequired;
+        return checkboxGroupComponent;
+    }
+
+    public static TCheckboxGroupComponent WithIsDisabled<TCheckboxGroupComponent>(this TCheckboxGroupComponent checkboxGroupComponent, bool isDisabled = true)
+        where TCheckboxGroupComponent : LocalCheckboxGroupComponent
+    {
+        checkboxGroupComponent.IsDisabled = isDisabled;
+        return checkboxGroupComponent;
+    }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/Extensions/LocalCheckboxGroupOptionExtensions.cs

@@ -0,0 +1,30 @@
+using Qommon;
+
+namespace Disqord;
+
+public static class LocalCheckboxGroupOptionExtensions
+{
+    public static LocalCheckboxGroupOption WithLabel(this LocalCheckboxGroupOption option, string label)
+    {
+        option.Label = label;
+        return option;
+    }
+
+    public static LocalCheckboxGroupOption WithValue(this LocalCheckboxGroupOption option, string value)
+    {
+        option.Value = value;
+        return option;
+    }
+
+    public static LocalCheckboxGroupOption WithDescription(this LocalCheckboxGroupOption option, string description)
+    {
+        option.Description = description;
+        return option;
+    }
+
+    public static LocalCheckboxGroupOption WithIsDefault(this LocalCheckboxGroupOption option, bool isDefault = true)
+    {
+        option.IsDefault = isDefault;
+        return option;
+    }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/Extensions/LocalRadioGroupComponentExtensions.cs

@@ -0,0 +1,59 @@
+using System.Collections.Generic;
+using Qommon;
+
+namespace Disqord;
+
+public static class LocalRadioGroupComponentExtensions
+{
+    public static TRadioGroupComponent AddOption<TRadioGroupComponent>(this TRadioGroupComponent component, string label, string value, string? description = null, bool isDefault = false)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+    {
+        var option = new LocalRadioGroupOption(label, value)
+        {
+            IsDefault = isDefault
+        };
+
+        if (description != null)
+            option.Description = description;
+
+        return component.AddOption(option);
+    }
+
+    public static TRadioGroupComponent AddOption<TRadioGroupComponent>(this TRadioGroupComponent component, LocalRadioGroupOption option)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+    {
+        if (component.Options.Add(option, out var list))
+            component.Options = new(list);
+
+        return component;
+    }
+
+    public static TRadioGroupComponent WithOptions<TRadioGroupComponent>(this TRadioGroupComponent component, IEnumerable<LocalRadioGroupOption> options)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+    {
+        Guard.IsNotNull(options);
+
+        if (component.Options.With(options, out var list))
+            component.Options = new(list);
+
+        return component;
+    }
+
+    public static TRadioGroupComponent WithOptions<TRadioGroupComponent>(this TRadioGroupComponent component, params LocalRadioGroupOption[] options)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+        => component.WithOptions((IEnumerable<LocalRadioGroupOption>) options);
+
+    public static TRadioGroupComponent WithIsRequired<TRadioGroupComponent>(this TRadioGroupComponent radioGroupComponent, bool isRequired = true)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+    {
+        radioGroupComponent.IsRequired = isRequired;
+        return radioGroupComponent;
+    }
+
+    public static TRadioGroupComponent WithIsDisabled<TRadioGroupComponent>(this TRadioGroupComponent radioGroupComponent, bool isDisabled = true)
+        where TRadioGroupComponent : LocalRadioGroupComponent
+    {
+        radioGroupComponent.IsDisabled = isDisabled;
+        return radioGroupComponent;
+    }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/Extensions/LocalRadioGroupOptionExtensions.cs

@@ -0,0 +1,30 @@
+using Qommon;
+
+namespace Disqord;
+
+public static class LocalRadioGroupOptionExtensions
+{
+    public static LocalRadioGroupOption WithLabel(this LocalRadioGroupOption option, string label)
+    {
+        option.Label = label;
+        return option;
+    }
+
+    public static LocalRadioGroupOption WithValue(this LocalRadioGroupOption option, string value)
+    {
+        option.Value = value;
+        return option;
+    }
+
+    public static LocalRadioGroupOption WithDescription(this LocalRadioGroupOption option, string description)
+    {
+        option.Description = description;
+        return option;
+    }
+
+    public static LocalRadioGroupOption WithIsDefault(this LocalRadioGroupOption option, bool isDefault = true)
+    {
+        option.IsDefault = isDefault;
+        return option;
+    }
+}

src/Disqord.Core/Entities/Local/Interaction/Components/LocalComponent.Construction.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using System.Collections.Generic;
 
 namespace Disqord;
@@ -160,4 +160,24 @@ public static LocalFileUploadComponent FileUpload(string customId)
         return new LocalFileUploadComponent()
             .WithCustomId(customId);
     }
+
+    public static LocalRadioGroupComponent RadioGroup(string customId, params IEnumerable<LocalRadioGroupOption> options)
+    {
+        return new LocalRadioGroupComponent()
+            .WithCustomId(customId)
+            .WithOptions(options);
+    }
+
+    public static LocalCheckboxGroupComponent CheckboxGroup(string customId, params IEnumerable<LocalCheckboxGroupOption> options)
+    {
+        return new LocalCheckboxGroupComponent()
+            .WithCustomId(customId)
+            .WithOptions(options);
+    }
+
+    public static LocalCheckboxComponent Checkbox(string customId)
+    {
+        return new LocalCheckboxComponent()
+            .WithCustomId(customId);
+    }
 }