@discordjs/builders 1.11.3 → 1.12.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _sapphire_shapeshift from '@sapphire/shapeshift';
-import { APIEmbedField, APIEmbedAuthor, APIEmbedFooter, APIEmbedImage, APIEmbed, APISelectMenuOption, APIMessageComponentEmoji, ButtonStyle, ChannelType, APIActionRowComponent, APIComponentInActionRow, APIMessageComponent, APIBaseComponent, ComponentType, APIButtonComponent, Snowflake, APISelectMenuComponent, APIChannelSelectComponent, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIComponentInMessageActionRow, APIComponentInModalActionRow, APIFileComponent, APISeparatorComponent, SeparatorSpacingSize, APITextDisplayComponent, APIContainerComponent, APIMediaGalleryComponent, APISectionComponent, APIComponentInContainer, APIMediaGalleryItem, APIThumbnailComponent, APIModalComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, InteractionContextType, Permissions, ApplicationIntegrationType, RESTPostAPIChatInputApplicationCommandsJSONBody, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
+import { APIEmbedField, APIEmbedAuthor, APIEmbedFooter, APIEmbedImage, APIEmbed, APISelectMenuOption, APIMessageComponentEmoji, ButtonStyle, ChannelType, APIActionRowComponent, APIComponentInActionRow, APIMessageComponent, APIModalComponent, APIBaseComponent, ComponentType, APIButtonComponent, Snowflake, APISelectMenuComponent, APIChannelSelectComponent, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIComponentInMessageActionRow, APIComponentInModalActionRow, APILabelComponent, APIFileComponent, APISeparatorComponent, SeparatorSpacingSize, APITextDisplayComponent, APIContainerComponent, APIMediaGalleryComponent, APISectionComponent, APIComponentInContainer, APIMediaGalleryItem, APIThumbnailComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, InteractionContextType, Permissions, ApplicationIntegrationType, RESTPostAPIChatInputApplicationCommandsJSONBody, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
 export * from '@discordjs/formatters';
 import { JSONEncodable, Equatable } from '@discordjs/util';
 
@@ -52,25 +52,25 @@ declare const embedFooterPredicate: _sapphire_shapeshift.ObjectValidator<{
 declare const timestampPredicate: _sapphire_shapeshift.UnionValidator<number | Date | null>;
 declare const titlePredicate: _sapphire_shapeshift.UnionValidator<string | null>;
 
-declare const Assertions$6_RGBPredicate: typeof RGBPredicate;
-declare const Assertions$6_authorNamePredicate: typeof authorNamePredicate;
-declare const Assertions$6_colorPredicate: typeof colorPredicate;
-declare const Assertions$6_embedAuthorPredicate: typeof embedAuthorPredicate;
-declare const Assertions$6_embedFieldPredicate: typeof embedFieldPredicate;
-declare const Assertions$6_embedFieldsArrayPredicate: typeof embedFieldsArrayPredicate;
-declare const Assertions$6_embedFooterPredicate: typeof embedFooterPredicate;
-declare const Assertions$6_fieldInlinePredicate: typeof fieldInlinePredicate;
-declare const Assertions$6_fieldLengthPredicate: typeof fieldLengthPredicate;
-declare const Assertions$6_fieldNamePredicate: typeof fieldNamePredicate;
-declare const Assertions$6_fieldValuePredicate: typeof fieldValuePredicate;
-declare const Assertions$6_footerTextPredicate: typeof footerTextPredicate;
-declare const Assertions$6_imageURLPredicate: typeof imageURLPredicate;
-declare const Assertions$6_timestampPredicate: typeof timestampPredicate;
-declare const Assertions$6_titlePredicate: typeof titlePredicate;
-declare const Assertions$6_urlPredicate: typeof urlPredicate;
-declare const Assertions$6_validateFieldLength: typeof validateFieldLength;
-declare namespace Assertions$6 {
-  export { Assertions$6_RGBPredicate as RGBPredicate, Assertions$6_authorNamePredicate as authorNamePredicate, Assertions$6_colorPredicate as colorPredicate, descriptionPredicate$1 as descriptionPredicate, Assertions$6_embedAuthorPredicate as embedAuthorPredicate, Assertions$6_embedFieldPredicate as embedFieldPredicate, Assertions$6_embedFieldsArrayPredicate as embedFieldsArrayPredicate, Assertions$6_embedFooterPredicate as embedFooterPredicate, Assertions$6_fieldInlinePredicate as fieldInlinePredicate, Assertions$6_fieldLengthPredicate as fieldLengthPredicate, Assertions$6_fieldNamePredicate as fieldNamePredicate, Assertions$6_fieldValuePredicate as fieldValuePredicate, Assertions$6_footerTextPredicate as footerTextPredicate, Assertions$6_imageURLPredicate as imageURLPredicate, Assertions$6_timestampPredicate as timestampPredicate, Assertions$6_titlePredicate as titlePredicate, Assertions$6_urlPredicate as urlPredicate, Assertions$6_validateFieldLength as validateFieldLength };
+declare const Assertions$7_RGBPredicate: typeof RGBPredicate;
+declare const Assertions$7_authorNamePredicate: typeof authorNamePredicate;
+declare const Assertions$7_colorPredicate: typeof colorPredicate;
+declare const Assertions$7_embedAuthorPredicate: typeof embedAuthorPredicate;
+declare const Assertions$7_embedFieldPredicate: typeof embedFieldPredicate;
+declare const Assertions$7_embedFieldsArrayPredicate: typeof embedFieldsArrayPredicate;
+declare const Assertions$7_embedFooterPredicate: typeof embedFooterPredicate;
+declare const Assertions$7_fieldInlinePredicate: typeof fieldInlinePredicate;
+declare const Assertions$7_fieldLengthPredicate: typeof fieldLengthPredicate;
+declare const Assertions$7_fieldNamePredicate: typeof fieldNamePredicate;
+declare const Assertions$7_fieldValuePredicate: typeof fieldValuePredicate;
+declare const Assertions$7_footerTextPredicate: typeof footerTextPredicate;
+declare const Assertions$7_imageURLPredicate: typeof imageURLPredicate;
+declare const Assertions$7_timestampPredicate: typeof timestampPredicate;
+declare const Assertions$7_titlePredicate: typeof titlePredicate;
+declare const Assertions$7_urlPredicate: typeof urlPredicate;
+declare const Assertions$7_validateFieldLength: typeof validateFieldLength;
+declare namespace Assertions$7 {
+  export { Assertions$7_RGBPredicate as RGBPredicate, Assertions$7_authorNamePredicate as authorNamePredicate, Assertions$7_colorPredicate as colorPredicate, descriptionPredicate$1 as descriptionPredicate, Assertions$7_embedAuthorPredicate as embedAuthorPredicate, Assertions$7_embedFieldPredicate as embedFieldPredicate, Assertions$7_embedFieldsArrayPredicate as embedFieldsArrayPredicate, Assertions$7_embedFooterPredicate as embedFooterPredicate, Assertions$7_fieldInlinePredicate as fieldInlinePredicate, Assertions$7_fieldLengthPredicate as fieldLengthPredicate, Assertions$7_fieldNamePredicate as fieldNamePredicate, Assertions$7_fieldValuePredicate as fieldValuePredicate, Assertions$7_footerTextPredicate as footerTextPredicate, Assertions$7_imageURLPredicate as imageURLPredicate, Assertions$7_timestampPredicate as timestampPredicate, Assertions$7_titlePredicate as titlePredicate, Assertions$7_urlPredicate as urlPredicate, Assertions$7_validateFieldLength as validateFieldLength };
 }
 
 /**
@@ -393,32 +393,32 @@ declare const channelTypesValidator: _sapphire_shapeshift.ArrayValidator<Channel
 declare const urlValidator: _sapphire_shapeshift.StringValidator<string>;
 declare function validateRequiredButtonParameters(style?: ButtonStyle, label?: string, emoji?: APIMessageComponentEmoji, customId?: string, skuId?: string, url?: string): void;
 
-declare const Assertions$5_buttonLabelValidator: typeof buttonLabelValidator;
-declare const Assertions$5_buttonStyleValidator: typeof buttonStyleValidator;
-declare const Assertions$5_channelTypesValidator: typeof channelTypesValidator;
-declare const Assertions$5_customIdValidator: typeof customIdValidator;
-declare const Assertions$5_defaultValidator: typeof defaultValidator;
-declare const Assertions$5_disabledValidator: typeof disabledValidator;
-declare const Assertions$5_emojiValidator: typeof emojiValidator;
-declare const Assertions$5_idValidator: typeof idValidator;
-declare const Assertions$5_jsonOptionValidator: typeof jsonOptionValidator;
-declare const Assertions$5_labelValueDescriptionValidator: typeof labelValueDescriptionValidator;
-declare const Assertions$5_minMaxValidator: typeof minMaxValidator;
-declare const Assertions$5_optionValidator: typeof optionValidator;
-declare const Assertions$5_optionsLengthValidator: typeof optionsLengthValidator;
-declare const Assertions$5_optionsValidator: typeof optionsValidator;
-declare const Assertions$5_urlValidator: typeof urlValidator;
-declare const Assertions$5_validateRequiredButtonParameters: typeof validateRequiredButtonParameters;
-declare const Assertions$5_validateRequiredSelectMenuOptionParameters: typeof validateRequiredSelectMenuOptionParameters;
-declare const Assertions$5_validateRequiredSelectMenuParameters: typeof validateRequiredSelectMenuParameters;
-declare namespace Assertions$5 {
-  export { Assertions$5_buttonLabelValidator as buttonLabelValidator, Assertions$5_buttonStyleValidator as buttonStyleValidator, Assertions$5_channelTypesValidator as channelTypesValidator, Assertions$5_customIdValidator as customIdValidator, Assertions$5_defaultValidator as defaultValidator, Assertions$5_disabledValidator as disabledValidator, Assertions$5_emojiValidator as emojiValidator, Assertions$5_idValidator as idValidator, Assertions$5_jsonOptionValidator as jsonOptionValidator, Assertions$5_labelValueDescriptionValidator as labelValueDescriptionValidator, Assertions$5_minMaxValidator as minMaxValidator, Assertions$5_optionValidator as optionValidator, Assertions$5_optionsLengthValidator as optionsLengthValidator, Assertions$5_optionsValidator as optionsValidator, placeholderValidator$1 as placeholderValidator, Assertions$5_urlValidator as urlValidator, Assertions$5_validateRequiredButtonParameters as validateRequiredButtonParameters, Assertions$5_validateRequiredSelectMenuOptionParameters as validateRequiredSelectMenuOptionParameters, Assertions$5_validateRequiredSelectMenuParameters as validateRequiredSelectMenuParameters };
+declare const Assertions$6_buttonLabelValidator: typeof buttonLabelValidator;
+declare const Assertions$6_buttonStyleValidator: typeof buttonStyleValidator;
+declare const Assertions$6_channelTypesValidator: typeof channelTypesValidator;
+declare const Assertions$6_customIdValidator: typeof customIdValidator;
+declare const Assertions$6_defaultValidator: typeof defaultValidator;
+declare const Assertions$6_disabledValidator: typeof disabledValidator;
+declare const Assertions$6_emojiValidator: typeof emojiValidator;
+declare const Assertions$6_idValidator: typeof idValidator;
+declare const Assertions$6_jsonOptionValidator: typeof jsonOptionValidator;
+declare const Assertions$6_labelValueDescriptionValidator: typeof labelValueDescriptionValidator;
+declare const Assertions$6_minMaxValidator: typeof minMaxValidator;
+declare const Assertions$6_optionValidator: typeof optionValidator;
+declare const Assertions$6_optionsLengthValidator: typeof optionsLengthValidator;
+declare const Assertions$6_optionsValidator: typeof optionsValidator;
+declare const Assertions$6_urlValidator: typeof urlValidator;
+declare const Assertions$6_validateRequiredButtonParameters: typeof validateRequiredButtonParameters;
+declare const Assertions$6_validateRequiredSelectMenuOptionParameters: typeof validateRequiredSelectMenuOptionParameters;
+declare const Assertions$6_validateRequiredSelectMenuParameters: typeof validateRequiredSelectMenuParameters;
+declare namespace Assertions$6 {
+  export { Assertions$6_buttonLabelValidator as buttonLabelValidator, Assertions$6_buttonStyleValidator as buttonStyleValidator, Assertions$6_channelTypesValidator as channelTypesValidator, Assertions$6_customIdValidator as customIdValidator, Assertions$6_defaultValidator as defaultValidator, Assertions$6_disabledValidator as disabledValidator, Assertions$6_emojiValidator as emojiValidator, Assertions$6_idValidator as idValidator, Assertions$6_jsonOptionValidator as jsonOptionValidator, Assertions$6_labelValueDescriptionValidator as labelValueDescriptionValidator, Assertions$6_minMaxValidator as minMaxValidator, Assertions$6_optionValidator as optionValidator, Assertions$6_optionsLengthValidator as optionsLengthValidator, Assertions$6_optionsValidator as optionsValidator, placeholderValidator$1 as placeholderValidator, Assertions$6_urlValidator as urlValidator, Assertions$6_validateRequiredButtonParameters as validateRequiredButtonParameters, Assertions$6_validateRequiredSelectMenuOptionParameters as validateRequiredSelectMenuOptionParameters, Assertions$6_validateRequiredSelectMenuParameters as validateRequiredSelectMenuParameters };
 }
 
 /**
  * Any action row component data represented as an object.
  */
-type AnyAPIActionRowComponent = APIActionRowComponent<APIComponentInActionRow> | APIComponentInActionRow | APIMessageComponent;
+type AnyAPIActionRowComponent = APIActionRowComponent<APIComponentInActionRow> | APIComponentInActionRow | APIMessageComponent | APIModalComponent;
 /**
  * The base component builder that contains common symbols for all sorts of components.
  *
@@ -578,6 +578,13 @@ declare abstract class BaseSelectMenuBuilder<SelectMenuType extends APISelectMen
      * @param disabled - Whether this select menu is disabled
      */
     setDisabled(disabled?: boolean): this;
+    /**
+     * Sets whether this select menu is required.
+     *
+     * @remarks Only for use in modals.
+     * @param required - Whether this select menu is required
+     */
+    setRequired(required?: boolean): this;
     /**
      * {@inheritDoc ComponentBuilder.toJSON}
      */
@@ -876,7 +883,7 @@ declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> i
      * ```ts
      * const textInput = new TextInputBuilder({
      * 	custom_id: 'a cool text input',
-     * 	label: 'Type something',
+     * 	placeholder: 'Type something',
      * 	style: TextInputStyle.Short,
      * });
      * ```
@@ -884,7 +891,7 @@ declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> i
      * Creating a text input using setters and API data:
      * ```ts
      * const textInput = new TextInputBuilder({
-     * 	label: 'Type something else',
+     * 	placeholder: 'Type something else',
      * })
      * 	.setCustomId('woah')
      * 	.setStyle(TextInputStyle.Paragraph);
@@ -903,6 +910,7 @@ declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> i
      * Sets the label for this text input.
      *
      * @param label - The label to use
+     * @deprecated Use a label builder to create a label (and optionally a description) instead.
      */
     setLabel(label: string): this;
     /**
@@ -1030,6 +1038,97 @@ declare class ActionRowBuilder<ComponentType extends AnyComponentBuilder> extend
     toJSON(): APIActionRowComponent<ReturnType<ComponentType['toJSON']>>;
 }
 
+interface LabelBuilderData extends Partial<Omit<APILabelComponent, 'component'>> {
+    component?: ChannelSelectMenuBuilder | MentionableSelectMenuBuilder | RoleSelectMenuBuilder | StringSelectMenuBuilder | TextInputBuilder | UserSelectMenuBuilder;
+}
+/**
+ * A builder that creates API-compatible JSON data for labels.
+ */
+declare class LabelBuilder extends ComponentBuilder<LabelBuilderData> {
+    /**
+     * @internal
+     */
+    readonly data: LabelBuilderData;
+    /**
+     * Creates a new label.
+     *
+     * @param data - The API data to create this label with
+     * @example
+     * Creating a label from an API data object:
+     * ```ts
+     * const label = new LabelBuilder({
+     * 	label: "label",
+     * 	component,
+     * });
+     * ```
+     * @example
+     * Creating a label using setters and API data:
+     * ```ts
+     * const label = new LabelBuilder({
+     * 	label: 'label',
+     * 	component,
+     * }).setLabel('new text');
+     * ```
+     */
+    constructor(data?: Partial<APILabelComponent>);
+    /**
+     * Sets the label for this label.
+     *
+     * @param label - The label to use
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the description for this label.
+     *
+     * @param description - The description to use
+     */
+    setDescription(description: string): this;
+    /**
+     * Clears the description for this label.
+     */
+    clearDescription(): this;
+    /**
+     * Sets a string select menu component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setStringSelectMenuComponent(input: APIStringSelectComponent | StringSelectMenuBuilder | ((builder: StringSelectMenuBuilder) => StringSelectMenuBuilder)): this;
+    /**
+     * Sets a user select menu component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setUserSelectMenuComponent(input: APIUserSelectComponent | UserSelectMenuBuilder | ((builder: UserSelectMenuBuilder) => UserSelectMenuBuilder)): this;
+    /**
+     * Sets a role select menu component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setRoleSelectMenuComponent(input: APIRoleSelectComponent | RoleSelectMenuBuilder | ((builder: RoleSelectMenuBuilder) => RoleSelectMenuBuilder)): this;
+    /**
+     * Sets a mentionable select menu component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setMentionableSelectMenuComponent(input: APIMentionableSelectComponent | MentionableSelectMenuBuilder | ((builder: MentionableSelectMenuBuilder) => MentionableSelectMenuBuilder)): this;
+    /**
+     * Sets a channel select menu component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setChannelSelectMenuComponent(input: APIChannelSelectComponent | ChannelSelectMenuBuilder | ((builder: ChannelSelectMenuBuilder) => ChannelSelectMenuBuilder)): this;
+    /**
+     * Sets a text input component to this label.
+     *
+     * @param input - A function that returns a component builder or an already built builder
+     */
+    setTextInputComponent(input: APITextInputComponent | TextInputBuilder | ((builder: TextInputBuilder) => TextInputBuilder)): this;
+    /**
+     * {@inheritDoc ComponentBuilder.toJSON}
+     */
+    toJSON(): APILabelComponent;
+}
+
 declare class FileBuilder extends ComponentBuilder<APIFileComponent> {
     /**
      * Creates a new file from API data.
@@ -1592,6 +1691,10 @@ interface MappedComponentTypes {
      * The media gallery component type is associated with a {@link MediaGalleryBuilder}.
      */
     [ComponentType.MediaGallery]: MediaGalleryBuilder;
+    /**
+     * The label component type is associated with a {@link LabelBuilder}.
+     */
+    [ComponentType.Label]: LabelBuilder;
 }
 /**
  * Factory for creating components from API data.
@@ -1618,17 +1721,39 @@ declare const requiredValidator: _sapphire_shapeshift.BooleanValidator<boolean>;
 declare const valueValidator: _sapphire_shapeshift.StringValidator<string>;
 declare const placeholderValidator: _sapphire_shapeshift.StringValidator<string>;
 declare const labelValidator: _sapphire_shapeshift.StringValidator<string>;
-declare function validateRequiredParameters$3(customId?: string, style?: TextInputStyle, label?: string): void;
-
-declare const Assertions$4_labelValidator: typeof labelValidator;
-declare const Assertions$4_maxLengthValidator: typeof maxLengthValidator;
-declare const Assertions$4_minLengthValidator: typeof minLengthValidator;
-declare const Assertions$4_placeholderValidator: typeof placeholderValidator;
-declare const Assertions$4_requiredValidator: typeof requiredValidator;
-declare const Assertions$4_textInputStyleValidator: typeof textInputStyleValidator;
-declare const Assertions$4_valueValidator: typeof valueValidator;
-declare namespace Assertions$4 {
-  export { Assertions$4_labelValidator as labelValidator, Assertions$4_maxLengthValidator as maxLengthValidator, Assertions$4_minLengthValidator as minLengthValidator, Assertions$4_placeholderValidator as placeholderValidator, Assertions$4_requiredValidator as requiredValidator, Assertions$4_textInputStyleValidator as textInputStyleValidator, validateRequiredParameters$3 as validateRequiredParameters, Assertions$4_valueValidator as valueValidator };
+declare const textInputPredicate: _sapphire_shapeshift.ObjectValidator<{
+    type: ComponentType;
+    custom_id: string;
+    style: TextInputStyle;
+    id: number | undefined;
+    min_length: number | undefined;
+    max_length: number | undefined;
+    placeholder: string | undefined;
+    value: string | undefined;
+    required: boolean | undefined;
+}, _sapphire_shapeshift.UndefinedToOptional<{
+    type: ComponentType;
+    custom_id: string;
+    style: TextInputStyle;
+    id: number | undefined;
+    min_length: number | undefined;
+    max_length: number | undefined;
+    placeholder: string | undefined;
+    value: string | undefined;
+    required: boolean | undefined;
+}>>;
+declare function validateRequiredParameters$3(customId?: string, style?: TextInputStyle): void;
+
+declare const Assertions$5_labelValidator: typeof labelValidator;
+declare const Assertions$5_maxLengthValidator: typeof maxLengthValidator;
+declare const Assertions$5_minLengthValidator: typeof minLengthValidator;
+declare const Assertions$5_placeholderValidator: typeof placeholderValidator;
+declare const Assertions$5_requiredValidator: typeof requiredValidator;
+declare const Assertions$5_textInputPredicate: typeof textInputPredicate;
+declare const Assertions$5_textInputStyleValidator: typeof textInputStyleValidator;
+declare const Assertions$5_valueValidator: typeof valueValidator;
+declare namespace Assertions$5 {
+  export { Assertions$5_labelValidator as labelValidator, Assertions$5_maxLengthValidator as maxLengthValidator, Assertions$5_minLengthValidator as minLengthValidator, Assertions$5_placeholderValidator as placeholderValidator, Assertions$5_requiredValidator as requiredValidator, Assertions$5_textInputPredicate as textInputPredicate, Assertions$5_textInputStyleValidator as textInputStyleValidator, validateRequiredParameters$3 as validateRequiredParameters, Assertions$5_valueValidator as valueValidator };
 }
 
 /**
@@ -1642,7 +1767,7 @@ declare class ModalBuilder implements JSONEncodable<APIModalInteractionResponseC
     /**
      * The components within this modal.
      */
-    readonly components: ActionRowBuilder<ModalActionRowComponentBuilder>[];
+    readonly components: (ActionRowBuilder<ModalActionRowComponentBuilder> | LabelBuilder)[];
     /**
      * Creates a new modal from API data.
      *
@@ -1665,14 +1790,65 @@ declare class ModalBuilder implements JSONEncodable<APIModalInteractionResponseC
      * Adds components to this modal.
      *
      * @param components - The components to add
+     * @deprecated Use {@link ModalBuilder.addLabelComponents} or {@link ModalBuilder.addActionRowComponents} instead
+     */
+    addComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder> | APIActionRowComponent<APIComponentInModalActionRow> | APILabelComponent | APITextInputComponent | LabelBuilder | TextInputBuilder>): this;
+    /**
+     * Adds label components to this modal.
+     *
+     * @param components - The components to add
+     */
+    addLabelComponents(...components: RestOrArray<APILabelComponent | LabelBuilder | ((builder: LabelBuilder) => LabelBuilder)>): this;
+    /**
+     * Adds action rows to this modal.
+     *
+     * @param components - The components to add
+     * @deprecated Use {@link ModalBuilder.addLabelComponents} instead
+     */
+    addActionRowComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder> | APIActionRowComponent<APIComponentInModalActionRow> | ((builder: ActionRowBuilder<ModalActionRowComponentBuilder>) => ActionRowBuilder<ModalActionRowComponentBuilder>)>): this;
+    /**
+     * Sets the labels for this modal.
+     *
+     * @param components - The components to set
+     */
+    setLabelComponents(...components: RestOrArray<APILabelComponent | LabelBuilder | ((builder: LabelBuilder) => LabelBuilder)>): this;
+    /**
+     * Removes, replaces, or inserts labels for this modal.
+     *
+     * @remarks
+     * This method behaves similarly
+     * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+     * The maximum amount of labels that can be added is 5.
+     *
+     * It's useful for modifying and adjusting order of the already-existing labels of a modal.
+     * @example
+     * Remove the first label:
+     * ```ts
+     * modal.spliceLabelComponents(0, 1);
+     * ```
+     * @example
+     * Remove the first n labels:
+     * ```ts
+     * const n = 4;
+     * modal.spliceLabelComponents(0, n);
+     * ```
+     * @example
+     * Remove the last label:
+     * ```ts
+     * modal.spliceLabelComponents(-1, 1);
+     * ```
+     * @param index - The index to start at
+     * @param deleteCount - The number of labels to remove
+     * @param labels - The replacing label objects
      */
-    addComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder> | APIActionRowComponent<APIComponentInModalActionRow>>): this;
+    spliceLabelComponents(index: number, deleteCount: number, ...labels: (APILabelComponent | LabelBuilder | ((builder: LabelBuilder) => LabelBuilder))[]): this;
     /**
      * Sets components for this modal.
      *
      * @param components - The components to set
+     * @deprecated Use {@link ModalBuilder.setLabelComponents} instead
      */
-    setComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder>>): this;
+    setComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder> | LabelBuilder>): this;
     /**
      * {@inheritDoc ComponentBuilder.toJSON}
      */
@@ -1680,13 +1856,112 @@ declare class ModalBuilder implements JSONEncodable<APIModalInteractionResponseC
 }
 
 declare const titleValidator: _sapphire_shapeshift.StringValidator<string>;
-declare const componentsValidator: _sapphire_shapeshift.ArrayValidator<[ActionRowBuilder<AnyComponentBuilder>, ...ActionRowBuilder<AnyComponentBuilder>[]], ActionRowBuilder<AnyComponentBuilder>>;
-declare function validateRequiredParameters$2(customId?: string, title?: string, components?: ActionRowBuilder<ModalActionRowComponentBuilder>[]): void;
+declare const componentsValidator: _sapphire_shapeshift.ArrayValidator<[LabelBuilder | ActionRowBuilder<AnyComponentBuilder>, ...(LabelBuilder | ActionRowBuilder<AnyComponentBuilder>)[]], LabelBuilder | ActionRowBuilder<AnyComponentBuilder>>;
+declare function validateRequiredParameters$2(customId?: string, title?: string, components?: (ActionRowBuilder<ModalActionRowComponentBuilder> | LabelBuilder)[]): void;
+
+declare const Assertions$4_componentsValidator: typeof componentsValidator;
+declare const Assertions$4_titleValidator: typeof titleValidator;
+declare namespace Assertions$4 {
+  export { Assertions$4_componentsValidator as componentsValidator, Assertions$4_titleValidator as titleValidator, validateRequiredParameters$2 as validateRequiredParameters };
+}
+
+declare const labelPredicate: _sapphire_shapeshift.ObjectValidator<{
+    id: number | undefined;
+    type: ComponentType;
+    label: string;
+    description: string | undefined;
+    component: _sapphire_shapeshift.UndefinedToOptional<{
+        type: any;
+        custom_id: any;
+        style: any;
+        id: any;
+        min_length: any;
+        max_length: any;
+        placeholder: any;
+        value: any;
+        required: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        default_values: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        default_values: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        options: any;
+    }>;
+}, _sapphire_shapeshift.UndefinedToOptional<{
+    id: number | undefined;
+    type: ComponentType;
+    label: string;
+    description: string | undefined;
+    component: _sapphire_shapeshift.UndefinedToOptional<{
+        type: any;
+        custom_id: any;
+        style: any;
+        id: any;
+        min_length: any;
+        max_length: any;
+        placeholder: any;
+        value: any;
+        required: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        default_values: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        default_values: any;
+    }> | _sapphire_shapeshift.UndefinedToOptional<{
+        id: any;
+        placeholder: any;
+        min_values: any;
+        max_values: any;
+        custom_id: any;
+        disabled: any;
+    } & {
+        type: any;
+        options: any;
+    }>;
+}>>;
 
-declare const Assertions$3_componentsValidator: typeof componentsValidator;
-declare const Assertions$3_titleValidator: typeof titleValidator;
+declare const Assertions$3_labelPredicate: typeof labelPredicate;
 declare namespace Assertions$3 {
-  export { Assertions$3_componentsValidator as componentsValidator, Assertions$3_titleValidator as titleValidator, validateRequiredParameters$2 as validateRequiredParameters };
+  export { Assertions$3_labelPredicate as labelPredicate };
 }
 
 declare const unfurledMediaItemPredicate: _sapphire_shapeshift.ObjectValidator<{
@@ -2608,4 +2883,4 @@ declare function isValidationEnabled(): boolean;
  */
 declare const version: string;
 
-export { ActionRowBuilder, type AnyAPIActionRowComponent, type AnyComponentBuilder, ApplicationCommandNumericOptionMinMaxValueMixin, type ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, ApplicationCommandOptionChannelTypesMixin, ApplicationCommandOptionWithAutocompleteMixin, ApplicationCommandOptionWithChoicesMixin, BaseSelectMenuBuilder, ButtonBuilder, ChannelSelectMenuBuilder, Assertions$5 as ComponentAssertions, ComponentBuilder, Assertions$2 as ComponentsV2Assertions, ContainerBuilder, type ContainerComponentBuilder, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, type ContextMenuCommandType, Assertions$6 as EmbedAssertions, type EmbedAuthorData, type EmbedAuthorOptions, EmbedBuilder, type EmbedFooterData, type EmbedFooterOptions, type EmbedImageData, FileBuilder, type IconData, type MappedComponentTypes, MediaGalleryBuilder, MediaGalleryItemBuilder, MentionableSelectMenuBuilder, type MessageActionRowComponentBuilder, type MessageComponentBuilder, type ModalActionRowComponentBuilder, Assertions$3 as ModalAssertions, ModalBuilder, type ModalComponentBuilder, type RGBTuple, type RestOrArray, RoleSelectMenuBuilder, SectionBuilder, StringSelectMenuBuilder as SelectMenuBuilder, StringSelectMenuOptionBuilder as SelectMenuOptionBuilder, SeparatorBuilder, SharedNameAndDescription, SharedSlashCommand, SharedSlashCommandOptions, SharedSlashCommandSubcommands, Assertions$1 as SlashCommandAssertions, SlashCommandAttachmentOption, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, type SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, type SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, Assertions$4 as TextInputAssertions, TextInputBuilder, ThumbnailBuilder, type ToAPIApplicationCommandOptions, UserSelectMenuBuilder, createComponentBuilder, disableValidators, embedLength, enableValidators, isValidationEnabled, normalizeArray, resolveBuilder, version };
+export { ActionRowBuilder, type AnyAPIActionRowComponent, type AnyComponentBuilder, ApplicationCommandNumericOptionMinMaxValueMixin, type ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, ApplicationCommandOptionChannelTypesMixin, ApplicationCommandOptionWithAutocompleteMixin, ApplicationCommandOptionWithChoicesMixin, BaseSelectMenuBuilder, ButtonBuilder, ChannelSelectMenuBuilder, Assertions$6 as ComponentAssertions, ComponentBuilder, Assertions$2 as ComponentsV2Assertions, ContainerBuilder, type ContainerComponentBuilder, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, type ContextMenuCommandType, Assertions$7 as EmbedAssertions, type EmbedAuthorData, type EmbedAuthorOptions, EmbedBuilder, type EmbedFooterData, type EmbedFooterOptions, type EmbedImageData, FileBuilder, type IconData, Assertions$3 as LabelAssertions, LabelBuilder, type LabelBuilderData, type MappedComponentTypes, MediaGalleryBuilder, MediaGalleryItemBuilder, MentionableSelectMenuBuilder, type MessageActionRowComponentBuilder, type MessageComponentBuilder, type ModalActionRowComponentBuilder, Assertions$4 as ModalAssertions, ModalBuilder, type ModalComponentBuilder, type RGBTuple, type RestOrArray, RoleSelectMenuBuilder, SectionBuilder, StringSelectMenuBuilder as SelectMenuBuilder, StringSelectMenuOptionBuilder as SelectMenuOptionBuilder, SeparatorBuilder, SharedNameAndDescription, SharedSlashCommand, SharedSlashCommandOptions, SharedSlashCommandSubcommands, Assertions$1 as SlashCommandAssertions, SlashCommandAttachmentOption, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, type SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, type SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, Assertions$5 as TextInputAssertions, TextInputBuilder, ThumbnailBuilder, type ToAPIApplicationCommandOptions, UserSelectMenuBuilder, createComponentBuilder, disableValidators, embedLength, enableValidators, isValidationEnabled, normalizeArray, resolveBuilder, version };