feat: support select in modals

Author: Jiralite

deno/payloads/v10/_interactions/modalSubmit.ts

@@ -1,4 +1,4 @@
-import type { APIBaseComponent } from '../channel';
+import type { APIBaseComponent, APILabelComponent } from '../channel';
 import type {
 	APIBaseInteraction,
 	APIDMInteractionWrapper,
@@ -17,6 +17,10 @@ export interface ModalSubmitActionRowComponent extends APIBaseComponent<Componen
 	components: ModalSubmitComponent[];
 }
 
+export interface ModalSubmitLabelComponent extends APIBaseComponent<ComponentType.Label> {
+	component: APILabelComponent;
+}
+
 /**
  * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-modal-submit-data-structure}
  */
@@ -28,7 +32,7 @@ export interface APIModalSubmission {
 	/**
 	 * A list of child components
 	 */
-	components: ModalSubmitActionRowComponent[];
+	components: (ModalSubmitActionRowComponent | ModalSubmitLabelComponent)[];
 }
 
 /**

deno/payloads/v10/_interactions/responses.ts

@@ -1,5 +1,5 @@
 import type { RESTPostAPIWebhookWithTokenJSONBody } from '../../../v10';
-import type { APIActionRowComponent, APIComponentInModalActionRow } from '../channel';
+import type { APIActionRowComponent, APIComponentInModalActionRow, APILabelComponent } from '../channel';
 import type { APIApplicationCommandOptionChoice } from './applicationCommands';
 
 /**
@@ -140,6 +140,8 @@ export interface APIModalInteractionResponseCallbackData {
 	title: string;
 	/**
 	 * Between 1 and 5 (inclusive) components that make up the modal
+	 *
+	 * @remarks Using action rows inside modals is deprecated.
 	 */
-	components: APIActionRowComponent<APIComponentInModalActionRow>[];
+	components: APIActionRowComponent<APIComponentInModalActionRow>[] | APILabelComponent;
 }

deno/payloads/v10/channel.ts

@@ -1705,7 +1705,10 @@ export enum ComponentType {
 	 * Container that visually groups a set of components
 	 */
 	Container,
-
+	/**
+	 * Labels for use in modals.
+	 */
+	Label,
 	// EVERYTHING BELOW THIS LINE SHOULD BE OLD NAMES FOR RENAMED ENUM MEMBERS //
 
 	/**
@@ -1717,7 +1720,7 @@ export enum ComponentType {
 }
 
 /**
- * An Action Row is a top-level layout component used in messages and modals.
+ * An Action Row is a top-level layout component used in messages. Use in modals is deprecated.
  *
  * @see {@link https://discord.com/developers/docs/components/reference#action-row}
  */
@@ -1930,6 +1933,13 @@ export interface APIStringSelectComponent extends APIBaseSelectMenuComponent<Com
 	options: APISelectMenuOption[];
 }
 
+/**
+ * A string select menu component that may be used in modals.
+ */
+export interface APIStringSelectComponentInModal extends APIStringSelectComponent {
+	required?: boolean;
+}
+
 /**
  * A User Select is an interactive component that allows users to select one or more users in a message. Options are automatically populated based on the server's available users.
  *
@@ -2051,16 +2061,7 @@ export interface APISelectMenuOption {
 	default?: boolean;
 }
 
-/**
- * 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 an Action Row.
- *
- * When defining a text input component, you can set attributes to customize the behavior and appearance of it. However, not all attributes will be returned in the text input interaction payload.
- *
- * @see {@link https://discord.com/developers/docs/components/reference#text-input}
- */
-export interface APITextInputComponent extends APIBaseComponent<ComponentType.TextInput> {
+export interface APIBaseTextInputComponent extends APIBaseComponent<ComponentType.TextInput> {
 	/**
 	 * One of text input styles
 	 */
@@ -2095,6 +2096,27 @@ export interface APITextInputComponent extends APIBaseComponent<ComponentType.Te
 	required?: boolean;
 }
 
+/**
+ * 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 an Action Row.
+ *
+ * When defining a text input component, you can set attributes to customize the behavior and appearance of it. However, not all attributes will be returned in the text input interaction payload.
+ *
+ * @see {@link https://discord.com/developers/docs/components/reference#text-input}
+ */
+export interface APITextInputComponent extends APIBaseTextInputComponent {
+	/**
+	 * Text that appears on top of the text input field, max 45 characters
+	 */
+	label: string;
+}
+
+/**
+ * A text input component that may be used in modals.
+ */
+export interface APITextInputComponentInModal extends APIBaseTextInputComponent {}
+
 export enum UnfurledMediaItemLoadingState {
 	Unknown,
 	Loading,
@@ -2305,6 +2327,12 @@ export interface APIContainerComponent extends APIBaseComponent<ComponentType.Co
 	components: APIComponentInContainer[];
 }
 
+export interface APILabelComponent extends APIBaseComponent<ComponentType.Label> {
+	label: string;
+	description?: string;
+	component: APIStringSelectComponentInModal | APITextInputComponentInModal;
+}
+
 /**
  * @see {@link https://discord.com/developers/docs/resources/channel#message-snapshot-object}
  */

deno/payloads/v9/_interactions/modalSubmit.ts

@@ -1,4 +1,4 @@
-import type { APIBaseComponent } from '../channel';
+import type { APIBaseComponent, APILabelComponent } from '../channel';
 import type {
 	APIBaseInteraction,
 	APIDMInteractionWrapper,
@@ -17,6 +17,10 @@ export interface ModalSubmitActionRowComponent extends APIBaseComponent<Componen
 	components: ModalSubmitComponent[];
 }
 
+export interface ModalSubmitLabelComponent extends APIBaseComponent<ComponentType.Label> {
+	component: APILabelComponent;
+}
+
 /**
  * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-modal-submit-data-structure}
  */
@@ -28,7 +32,7 @@ export interface APIModalSubmission {
 	/**
 	 * A list of child components
 	 */
-	components: ModalSubmitActionRowComponent[];
+	components: (ModalSubmitActionRowComponent | ModalSubmitLabelComponent)[];
 }
 
 /**