war-pigeon 0.1.0

use crate::messages::discord::{DiscordChannelType, DiscordPartialEmoji, DiscordSnowflake};
use serde::{Deserialize, Serialize};

use super::meta::DiscordMentions;

/// An Action Row is a top-level layout component.
///
/// Action Rows can contain one of the following:
/// - Up to 5 contextually grouped buttons.
/// - A single select component (string select, user select, role select, mentionable select, or channel select).
///
/// NOTE: Label is recommended for use over an Action Row in modals. Action Row with Text Inputs in modals are now deprecated.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordActionRowComponent {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,
    pub components: Vec<DiscordActionRowChild>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(untagged)]
pub enum DiscordActionRowChild {
    Button(DiscordButtonComponent),
    StringSelect(DiscordStringSelectComponent),
    UserSelect(DiscordSelectComponent),
    RoleSelect(DiscordSelectComponent),
    MentionableSelect(DiscordSelectComponent),
    ChannelSelect(DiscordChannelSelectComponent),
}

/// A Button is an interactive component that can only be used in messages.
///
/// It creates clickable elements that users can interact with,
/// sending an interaction to your app when clicked.
///
/// NOTE: Buttons must be placed inside an Action Row or a Section’s accessory field.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordButtonComponent {
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    #[serde(flatten)]
    pub kind: DiscordButtonKind,

    #[serde(skip_serializing_if = "Option::is_none")]
    pub disabled: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(tag = "style")]
pub enum DiscordButtonKind {
    #[serde(rename = "1")]
    Primary {
        label: Option<String>,
        emoji: Option<DiscordPartialEmoji>,
        custom_id: String,
    },

    #[serde(rename = "2")]
    Secondary {
        label: Option<String>,
        emoji: Option<DiscordPartialEmoji>,
        custom_id: String,
    },

    #[serde(rename = "3")]
    Success {
        label: Option<String>,
        emoji: Option<DiscordPartialEmoji>,
        custom_id: String,
    },

    #[serde(rename = "4")]
    Danger {
        label: Option<String>,
        emoji: Option<DiscordPartialEmoji>,
        custom_id: String,
    },

    #[serde(rename = "5")]
    Link {
        label: Option<String>,
        emoji: Option<DiscordPartialEmoji>,
        url: String,
    },

    #[serde(rename = "6")]
    Premium { sku_id: DiscordSnowflake },
}

/// A String Select is an interactive component that allows users to select one or more provided options.
///
/// String Selects can be configured for both single-select and multi-select behavior.
/// When a user finishes making their choice(s) your app receives an interaction.
///
/// NOTE: String Selects are available in messages and modals.
/// They must be placed inside an Action Row in messages and a Label in modals.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordStringSelectComponent {
    /// Optional identifier for component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// ID for the select menu.
    ///
    /// NOTE: 1-100 characters.
    pub custom_id: String,

    /// Specified choices in a select menu.
    ///
    /// NOTE: max limit of 25.
    pub options: Vec<DiscordSelectOption>,

    /// Placeholder text if nothing is selected or default.
    ///
    /// NOTE: max limit of 150 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder: Option<String>,

    /// Minimum number of items that must be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: max limit of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u8>,

    /// Maximum number of items that can be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: max limit of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u8>,

    /// Whether the string select is required to answer in a modal.
    ///
    /// NOTE: defaults to false.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,

    /// Whether select menu is disabled in a message.
    ///
    /// NOTE: defaults to false.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub disabled: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
/// Text Input is an interactive component that allows users to enter free-form text responses in modals.
///
/// It supports both short, single-line inputs and longer, multi-line paragraph inputs. Text Inputs can
/// only be used within modals and must be placed inside a Label.
///
/// NOTE: We no longer recommend using Text Input within an [`ActionRow`] in modals. Going forward all
/// text inputs should be placed a Label component.
pub struct DiscordTextInputComponent {
    /// Optional identifier for component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// ID for the select menu.
    ///
    /// NOTE: 1-100 characters.
    pub custom_id: String,

    /// The style for the text input.
    pub style: DiscordTextInputStyle,

    /// Minimum number of items that must be chosen.
    ///
    /// NOTE: defaults to 0.
    ///
    /// NOTE: max limit of 4000.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u16>,

    /// Maximum number of items that can be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: max limit of 4000.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u16>,

    /// Whether this component is required to be filled.
    ///
    /// NOTE: defaults to [`true`].
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,

    /// Pre-filled value for this component.
    ///
    /// NOTE: max limit of 4000 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub value: Option<String>,

    /// Custom placeholder text if the input is empty.
    ///
    /// NOTE: max limit of 100 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder: Option<String>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub enum DiscordTextInputStyle {
    /// Single-line text input.
    #[serde(rename = "1")]
    Short,

    /// Multi-line text input.
    #[serde(rename = "2")]
    Paragraph,
}

/// An interactive component which allows users to select one or more options.
///
/// This selector can be used for User, Role, and Mentions selectors.
///
/// Options are automatically populated based on server settings like roles,
/// users, and mentions.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordSelectComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the select menu.
    ///
    /// NOTE: must be 1-100 characters.
    pub custom_id: String,

    /// Placeholder text if nothing is selected.
    ///
    ///  NOTE: max limit of 150 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder: Option<String>,

    /// Default selected values.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default_values: Option<Vec<DiscordSelectDefaultValue>>,

    /// Minimum number of items that must be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: minimum of 0, maximum of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u8>,

    /// Maximum number of items that can be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: minimum of 0, maximum of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u8>,

    /// Whether the select is required in a modal.
    ///
    /// NOTE: defaults to true.
    ///
    /// NOTE: ignored in messages.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,

    /// Whether the select menu is disabled in a message.
    ///
    /// Defaults to false. Invalid in modals.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub disabled: Option<bool>,
}

/// A Channel Select is an interactive component that allows users
/// to select one or more channels in a message or modal.
///
/// Options are automatically populated based on available channels
/// in the server and can be filtered by channel types.
///
/// Channel Selects can be configured for both single-select and
/// multi-select behavior. When a user finishes making their choice(s)
/// your app receives an interaction.
///
/// Channel Selects are available in messages and modals. They must be
/// placed inside an Action Row in messages and a Label in modals.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordChannelSelectComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the select menu.
    ///
    /// NOTE: must be 1-100 characters.
    pub custom_id: String,

    /// List of channel types to include in the channel select component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub channel_types: Option<Vec<DiscordChannelType>>,

    /// Placeholder text if nothing is selected.
    ///
    ///  NOTE: max limit of 150 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder: Option<String>,

    /// Default selected values.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default_values: Option<Vec<DiscordSelectDefaultValue>>,

    /// Minimum number of items that must be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: minimum of 0, maximum of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u8>,

    /// Maximum number of items that can be chosen.
    ///
    /// NOTE: defaults to 1.
    ///
    /// NOTE: minimum of 0, maximum of 25.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u8>,

    /// Whether the select is required in a modal.
    ///
    /// NOTE: defaults to true.
    ///
    /// NOTE: ignored in messages.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,

    /// Whether the select menu is disabled in a message.
    ///
    /// Defaults to false. Invalid in modals.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub disabled: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordSelectDefaultValue {
    /// ID of a user, role, or channel.
    pub id: DiscordSnowflake,

    /// Type of value the ID represents.
    pub r#type: DiscordMentions,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordSelectOption {
    pub label: String,
    pub value: String,
    pub description: Option<String>,
    pub emoji: Option<DiscordPartialEmoji>,
    pub default: Option<bool>,
}

/// A Section is a top-level layout component that allows you to
/// contextually associate content with an accessory component.
///
/// The typical use-case is to contextually associate text content with an accessory.
///
/// NOTE: Sections are currently only available in messages.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct DiscordSectionComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// One to three child components representing the
    /// content of the section that is contextually
    /// associated to the accessory.
    pub components: Vec<DiscordTextDisplayComponent>,

    /// A component that is contextually associated to the content of the section.
    pub accessory: Vec<DiscordSectionAccessory>,
}

/// A Text Display is a content component that allows you to add markdown
/// formatted text, including mentions (users, roles, etc) and emojis.
///
/// The behavior of this component is extremely similar to the content
/// field of a message, but allows you to add multiple text components,
/// controlling the layout of your message.
///
/// When sent in a message, pingable mentions (@user, @role, etc) present
/// in this component will ping and send notifications based on the value
/// of the allowed mention object set in message.allowed_mentions.
///
/// NOTE: To use this component in messages you must send the message flag
/// `1 << 15` (IS_COMPONENTS_V2) which can be activated on a per-message basis.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordTextDisplayComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Text that will be displayed similar to a message.
    pub content: String,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub enum DiscordSectionAccessory {
    Button(DiscordButtonComponent),
    Thumbnail(DiscordThumbnailComponent),
}

/// A Thumbnail is a content component that displays visual media in a small form-factor.
///
/// It is intended as an accessory for to other content, and is primarily usable with sections.
/// The media displayed is defined by the unfurled media item structure, which supports both
/// uploaded media and externally hosted media.
///
/// Thumbnails are currently only available in messages as an accessory in a section.
///
/// NOTE: Thumbnails currently only support images, including animated formats like GIF and WEBP.
/// NOTE: Videos are not supported at this time.
///
/// NOTE: To use this component, you need to send the message flag `1 << 15` (IS_COMPONENTS_V2),
/// which can be activated on a per-message basis.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordThumbnailComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// A url or attachment provided as an unfurled media item.
    pub media: DiscordUnfurledMediaItem,

    /// Alt text for the media.
    ///
    /// NOTE: max limit of 1024 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// Whether the thumbnail should be a spoiler (or blurred out).
    ///
    /// NOTE: defaults to [`false`].
    pub spoiler: Option<bool>,
}

/// A piece of media used within a Discord component.
///
/// An unfurled media item can reference either:
/// - external media via a direct URL
/// - uploaded media via an `attachment://<filename>` reference
///
/// When sending requests to Discord, only [`Self::url`] is developer-settable.
/// All other fields are populated by Discord in responses.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordUnfurledMediaItem {
    /// The media location.
    ///
    /// Supports arbitrary URLs and `attachment://<filename>` references.
    pub url: String,

    /// The proxied URL of the media item.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub proxy_url: Option<String>,

    /// The height of the media item, if it is an image or video.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub height: Option<i64>,

    /// The width of the media item, if it is an image or video.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub width: Option<i64>,

    /// A ThumbHash placeholder for the media item, if it is an image or video.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder: Option<String>,

    /// The version of the placeholder, if present.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub placeholder_version: Option<i64>,

    /// The media type of the content.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub content_type: Option<String>,

    /// Unfurled media item flags combined as a bitfield.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub flags: Option<i64>,

    /// The ID of the uploaded attachment backing this media item.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub attachment_id: Option<String>,
}

/// A media gallery component for Discord messages.
///
/// This component allows displaying between 1 and 10 media items in a gallery format,
/// where each item can optionally include a description and spoiler flag.
///
/// ## Notes
/// - `type` is always `12` for media gallery components.
/// - Requires message flag `1 << 15` (`IS_COMPONENTS_V2`) to be set.
/// - Each gallery must contain **1 to 10 items**.
/// - Each item references media via [`DiscordUnfurledMediaItem`].
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct DiscordMediaGalleryComponent {
    /// The component type.
    ///
    /// Always `12` for a media gallery component.
    #[serde(rename = "type")]
    pub kind: u8,

    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// The media items displayed in the gallery.
    ///
    /// NOTE: Must contain between **1 and 10 items**.
    pub items: Vec<DiscordMediaGalleryItem>,
}

/// A single item within a media gallery.
///
/// Each item represents one media entry, optionally including
/// a description and spoiler flag.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct DiscordMediaGalleryItem {
    /// The media content for this item.
    ///
    /// Can reference either:
    /// - an external URL
    /// - an uploaded attachment via `attachment://<filename>`
    pub media: DiscordUnfurledMediaItem,

    /// Optional alt text describing the media.
    ///
    /// Maximum length: 1024 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// Whether the media should be marked as a spoiler (blurred).
    ///
    /// Defaults to `false` if not provided.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub spoiler: Option<bool>,
}

/// A Separator is a top-level layout component that adds vertical
/// padding and visual division between other components.
///
/// ## Notes
/// - Separators are currently only available in messages.
///
/// - To use this component in messages you must send the
///   message flag 1 << 15 (IS_COMPONENTS_V2) which can be
///   activated on a per-message basis.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordSeparatorComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Whether a visual divider should be displayed in the component.
    ///
    /// NOTE: defaults to `true`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub divider: Option<bool>,

    /// Size of separator padding.
    ///
    /// NOTE: defaults to 1 ([`DiscordSeparatorPadding::Small`]).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub spacing: Option<DiscordSeparatorPadding>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub enum DiscordSeparatorPadding {
    #[serde(rename = "1")]
    Small,

    #[serde(rename = "2")]
    Large,
}

/// A file component for Discord messages.
///
/// This component allows displaying an uploaded file as an attachment and
/// referencing it via an unfurled media item.
///
/// ## Notes
/// - `type` is always `13` for file components.
/// - The [`Self::file`] field must use the `attachment://<filename>` syntax.
/// - To use this component, the message must include the flag:
///   `1 << 15` (`IS_COMPONENTS_V2`).
/// - Some fields are response-only and ignored when sending requests.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordFileComponent {
    /// The component type.
    ///
    /// Always `13` for a file component.
    #[serde(rename = "type")]
    pub kind: u8,

    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// The unfurled media item representing the file.
    ///
    /// This must use the `attachment://<filename>` format and cannot reference
    /// arbitrary external URLs.
    pub file: DiscordUnfurledMediaItem,

    /// Whether the file should be marked as a spoiler (blurred).
    ///
    /// Defaults to `false`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub spoiler: Option<bool>,

    /// The name of the file.
    ///
    /// This field is ignored when sending requests and is populated by Discord
    /// in responses.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,

    /// The size of the file in bytes.
    ///
    /// This field is ignored when sending requests and is populated by Discord
    /// in responses.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub size: Option<u64>,
}

/// A Container is a top-level layout component.
///
/// Containers offer the ability to visually encapsulate a collection of
/// components and have an optional customizable accent color bar.
///
/// NOTE: Containers are currently only available in messages.
///
/// NOTE: To use this component in messages you must send the message flag
/// `1 << 15` (IS_COMPONENTS_V2) which can be activated on a per-message basis.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct DiscordContainerComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Child components that are encapsulated within the Container.
    pub components: Vec<DiscordContainerComponentChild>,

    /// Color for the accent on the container as RGB from 0x000000 to 0xFFFFFF.
    pub accent_color: Option<u64>,

    /// Whether the container should be a spoiler (or blurred out).
    ///
    /// NOTE: defaults to `false`.
    pub spoiler: Option<bool>,
}

#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub enum DiscordContainerComponentChild {
    ActionRow(DiscordActionRowComponent),
    TextDisplay(DiscordTextDisplayComponent),
    Section(DiscordSectionComponent),
    MediaGallery(DiscordMediaGalleryComponent),
    Separator(DiscordSeparatorComponent),
    File(DiscordFileComponent),
}

/// A label component for Discord modals.
///
/// Labels wrap another modal component with label text and an optional
/// description.
///
/// The description may render above or below the child component depending
/// on the platform.
///
/// NOTE: `type` is always `18` for a label component.
/// NOTE: `label` has a maximum length of 45 characters.
/// NOTE: `description` has a maximum length of 100 characters.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
pub struct DiscordLabelComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// The label text displayed for the wrapped component.
    ///
    /// NOTE: max limit of 45 characters.
    pub label: String,

    /// Optional description text for the label.
    ///
    /// NOTE: max limit of 100 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// The child component wrapped by this label.
    pub component: DiscordLabelChildComponent,
}

/// Components that may be wrapped by a [`DiscordLabelComponent`].
///
/// NOTE: These are modal-oriented child components supported by Discord labels.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
#[serde(tag = "type")]
pub enum DiscordLabelChildComponent {
    /// A text input component.
    #[serde(rename = "4")]
    TextInput(DiscordTextInputComponent),

    /// A string select component.
    #[serde(rename = "3")]
    StringSelect(DiscordStringSelectComponent),

    /// A user select component.
    #[serde(rename = "5")]
    UserSelect(DiscordSelectComponent),

    /// A role select component.
    #[serde(rename = "6")]
    RoleSelect(DiscordSelectComponent),

    /// A mentionable select component.
    #[serde(rename = "7")]
    MentionableSelect(DiscordSelectComponent),

    /// A channel select component.
    #[serde(rename = "8")]
    ChannelSelect(DiscordChannelSelectComponent),

    /// A file upload component.
    #[serde(rename = "19")]
    FileUpload(DiscordFileUploadComponent),

    /// A radio group component.
    #[serde(rename = "21")]
    RadioGroup(DiscordRadioGroupComponent),

    /// A checkbox group component.
    #[serde(rename = "22")]
    CheckboxGroup(DiscordCheckboxGroupComponent),

    /// A checkbox component.
    #[serde(rename = "23")]
    Checkbox(DiscordCheckboxComponent),
}

/// A radio group component for Discord modals.
///
/// This component allows users to select **exactly one** option from a list.
///
/// ## Notes
/// - `type` is always `21` for radio group components.
/// - Must be placed inside a [`DiscordLabelComponent`].
/// - Must contain between **2 and 10 options**.
/// - `custom_id` must be between 1 and 100 characters.
/// - `required` defaults to `true`.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordRadioGroupComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the radio group.
    ///
    /// NOTE: Must be between 1 and 100 characters.
    pub custom_id: String,

    /// The selectable options in the radio group.
    ///
    /// NOTE: Must contain between **2 and 10 options**.
    pub options: Vec<DiscordRadioGroupOption>,

    /// Whether a selection is required before submitting the modal.
    ///
    /// NOTE: Defaults to `true`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,
}

/// A single selectable option within a [`DiscordRadioGroup`].
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordRadioGroupOption {
    /// Developer-defined value for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    pub value: String,

    /// User-facing label for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    pub label: String,

    /// Optional description for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// Whether this option should be selected by default.
    ///
    /// NOTE: Defaults to `false`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default: Option<bool>,
}

/// A file upload component for Discord modals.
///
/// This component allows users to upload files as part of a modal submission.
///
/// ## Notes
/// - `type` is always `19` for file upload components.
/// - Must be placed inside a [`DiscordLabelComponent`].
/// - Users can upload between **0 and 10 files**.
/// - The maximum file size is determined by the channel's upload limits.
/// - `custom_id` must be between 1 and 100 characters.
/// - `min_values` defaults to `1` (can be set to `0`).
/// - `max_values` defaults to `1`.
/// - `required` defaults to `true`.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordFileUploadComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the file upload component.
    ///
    /// NOTE: Must be between 1 and 100 characters.
    pub custom_id: String,

    /// Minimum number of files that must be uploaded.
    ///
    /// NOTE: Defaults to `1`.
    ///
    /// NOTE: Minimum allowed value is `0`, maximum is `10`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u8>,

    /// Maximum number of files that can be uploaded.
    ///
    /// NOTE: Defaults to `1`.
    ///
    /// NOTE: Maximum allowed value is `10`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u8>,

    /// Whether this component is required to be filled before submitting the modal.
    ///
    /// NOTE: Defaults to `true`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,
}

/// A checkbox group component for Discord modals.
///
/// This component allows users to select **one or more options** via checkboxes.
///
/// ## Notes
/// - `type` is always `22` for checkbox group components.
/// - Must be placed inside a [`DiscordLabelComponent`].
/// - Must contain between **1 and 10 options**.
/// - `custom_id` must be between 1 and 100 characters.
/// - `min_values` defaults to `1`.
/// - `max_values` defaults to the number of options.
/// - `required` defaults to `true`.
///
/// ## Constraints
/// - `min_values` must be:
///   - omitted, or
///   - at least `1` if `required` is `true` or omitted.
/// - `min_values` range: `0..=10`
/// - `max_values` range: `1..=10`
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordCheckboxGroupComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the checkbox group.
    ///
    /// NOTE: Must be between 1 and 100 characters.
    pub custom_id: String,

    /// The selectable options in the checkbox group.
    ///
    /// NOTE: Must contain between **1 and 10 options**.
    pub options: Vec<DiscordCheckboxGroupOption>,

    /// Minimum number of options that must be selected.
    ///
    /// NOTE: Defaults to `1`.
    ///
    /// NOTE: Minimum allowed value is `0`, maximum is `10`.
    ///
    /// NOTE: Must be `>= 1` if `required` is `true` or not provided.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub min_values: Option<u8>,

    /// Maximum number of options that can be selected.
    ///
    /// NOTE: Defaults to the number of options.
    ///
    /// NOTE: Minimum allowed value is `1`, maximum is `10`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_values: Option<u8>,

    /// Whether selecting at least one option is required.
    ///
    /// NOTE: Defaults to `true`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,
}

/// A single selectable option within a [`DiscordCheckboxGroup`].
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordCheckboxGroupOption {
    /// Developer-defined value for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    pub value: String,

    /// User-facing label for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    pub label: String,

    /// Optional description for this option.
    ///
    /// NOTE: Maximum length of 100 characters.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,

    /// Whether this option should be selected by default.
    ///
    /// NOTE: Defaults to `false`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default: Option<bool>,
}

/// A checkbox component for Discord modals.
///
/// This component represents a single **boolean-style input** (yes/no).
///
/// ## Notes
/// - `type` is always `23` for checkbox components.
/// - Must be placed inside a [`DiscordLabelComponent`].
/// - `custom_id` must be between 1 and 100 characters.
/// - Cannot be marked as required directly.
///
/// ## Tip
/// If you need a required checkbox, use a [`DiscordCheckboxGroup`]
/// with a single option and `required = true`.
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
pub struct DiscordCheckboxComponent {
    /// Optional identifier for the component.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub id: Option<u32>,

    /// Developer-defined identifier for the checkbox.
    ///
    /// NOTE: Must be between 1 and 100 characters.
    pub custom_id: String,

    /// Whether the checkbox is selected by default.
    ///
    /// NOTE: Defaults to `false`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default: Option<bool>,
}

/// The different types of discord message components.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "type")]
pub enum DiscordComponent {
    /// An Action Row is a top-level layout component.
    ///
    /// Action Rows can contain one of the following:
    /// - Up to 5 contextually grouped buttons.
    /// - A single select component (string select, user select, role select, mentionable select, or channel select).
    #[serde(rename = "1")]
    ActionRow(DiscordActionRowComponent),

    /// A Button is an interactive component that can only be used in messages.
    ///
    /// It creates clickable elements that users can interact with,
    /// sending an interaction to your app when clicked.
    #[serde(rename = "2")]
    Button(DiscordButtonComponent),

    /// A String Select is an interactive component that allows users to select one or more provided options.
    ///
    /// String Selects can be configured for both single-select and multi-select behavior.
    /// When a user finishes making their choice(s) your app receives an interaction.
    #[serde(rename = "3")]
    StringSelect(DiscordStringSelectComponent),

    /// Text Input is an interactive component that allows users to enter free-form text responses in modals.
    ///
    /// It supports both short, single-line inputs and longer, multi-line paragraph inputs. Text Inputs can
    /// only be used within modals and must be placed inside a Label.
    #[serde(rename = "4")]
    TextInput(DiscordTextInputComponent),

    /// A User Select is an interactive component that allows users to select
    /// one or more users in a message or modal.
    ///
    /// Options are automatically populated based on the server’s available users.
    #[serde(rename = "5")]
    UserSelect(DiscordSelectComponent),

    /// A Role Select is an interactive component that allows users to select
    /// one or more roles in a message or modal.
    ///
    /// Options are automatically populated based on the server’s available roles.
    #[serde(rename = "6")]
    RoleSelect(DiscordSelectComponent),

    /// A Mentionable Select is an interactive component that allows users to select
    /// one or more mentionables in a message or modal.
    ///
    /// Options are automatically populated based on available mentionables in the server.
    #[serde(rename = "7")]
    MentionableSelect(DiscordSelectComponent),

    /// A Channel Select is an interactive component that allows users
    /// to select one or more channels in a message or modal.
    ///
    /// Options are automatically populated based on available channels
    /// in the server and can be filtered by channel types.
    #[serde(rename = "8")]
    ChannelSelect(DiscordChannelSelectComponent),

    /// A Section is a top-level layout component that allows you to
    /// contextually associate content with an accessory component.
    ///
    /// The typical use-case is to contextually associate text content with an accessory.
    #[serde(rename = "9")]
    Section(DiscordSectionComponent),

    /// A Text Display is a content component that allows you to add markdown
    /// formatted text, including mentions (users, roles, etc) and emojis.
    ///
    /// The behavior of this component is extremely similar to the content
    /// field of a message, but allows you to add multiple text components,
    /// controlling the layout of your message.
    #[serde(rename = "10")]
    TextDisplay(DiscordTextDisplayComponent),

    /// A Thumbnail is a content component that displays visual media in a small form-factor.
    ///
    /// It is intended as an accessory for to other content, and is primarily usable with sections.
    /// The media displayed is defined by the unfurled media item structure, which supports both
    /// uploaded media and externally hosted media.
    #[serde(rename = "11")]
    Thumbnail(DiscordThumbnailComponent),

    /// A media gallery component for Discord messages.
    ///
    /// This component allows displaying between 1 and 10 media items in a gallery format,
    /// where each item can optionally include a description and spoiler flag.
    #[serde(rename = "12")]
    MediaGallery(DiscordMediaGalleryComponent),

    /// A file component for Discord messages.
    ///
    /// This component allows displaying an uploaded file as an attachment and
    /// referencing it via an unfurled media item.
    #[serde(rename = "13")]
    File(DiscordFileComponent),

    /// A Separator is a top-level layout component that adds vertical
    /// padding and visual division between other components.
    #[serde(rename = "14")]
    Separator(DiscordSeparatorComponent),

    /// A Container is a top-level layout component.
    ///
    /// Containers offer the ability to visually encapsulate a collection of
    /// components and have an optional customizable accent color bar.
    #[serde(rename = "17")]
    Container(DiscordContainerComponent),

    /// A label component for Discord modals.
    ///
    /// Labels wrap another modal component with label text and an optional
    /// description.
    #[serde(rename = "18")]
    Label(DiscordLabelComponent),

    /// A file upload component for Discord modals.
    ///
    /// This component allows users to upload files as part of a modal submission.
    #[serde(rename = "19")]
    FileUpload(DiscordFileUploadComponent),

    /// A radio group component for Discord modals.
    ///
    /// This component allows users to select **exactly one** option from a list.
    #[serde(rename = "21")]
    RadioGroup(DiscordRadioGroupComponent),

    /// A checkbox group component for Discord modals.
    ///
    /// This component allows users to select **one or more options** via checkboxes.
    #[serde(rename = "22")]
    CheckboxGroup(DiscordCheckboxGroupComponent),

    /// A checkbox component for Discord modals.
    ///
    /// This component represents a single **boolean-style input** (yes/no).
    #[serde(rename = "23")]
    Checkbox(DiscordCheckboxComponent),
}