@discordjs/builders 1.7.0-dev.1699704223-5b0aa92c8 → 1.7.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, APIActionRowComponentTypes, APIBaseComponent, ComponentType, APIButtonComponent, APISelectMenuComponent, APIChannelSelectComponent, APIMentionableSelectComponent, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIMessageActionRowComponent, APIModalActionRowComponent, APIModalComponent, APIMessageComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
+import { APIEmbedField, APIEmbedAuthor, APIEmbedFooter, APIEmbedImage, APIEmbed, APISelectMenuOption, APIMessageComponentEmoji, ButtonStyle, ChannelType, APIActionRowComponent, APIActionRowComponentTypes, APIBaseComponent, ComponentType, APIButtonComponent, APISelectMenuComponent, APIChannelSelectComponent, Snowflake, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIMessageActionRowComponent, APIModalActionRowComponent, APIModalComponent, APIMessageComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
 export * from '@discordjs/formatters';
 import { JSONEncodable, Equatable } from '@discordjs/util';
 
@@ -96,10 +96,10 @@ declare namespace Assertions$5 {
 /**
  * Normalizes data that is a rest parameter or an array into an array with a depth of 1.
  *
- * @typeParam T - The data that must satisfy {@link RestOrArray}.
+ * @typeParam ItemType - The data that must satisfy {@link RestOrArray}.
  * @param arr - The (possibly variadic) data to normalize
  */
-declare function normalizeArray<T>(arr: RestOrArray<T>): T[];
+declare function normalizeArray<ItemType>(arr: RestOrArray<ItemType>): ItemType[];
 /**
  * Represents data that may be an array or came from a rest parameter.
  *
@@ -107,7 +107,7 @@ declare function normalizeArray<T>(arr: RestOrArray<T>): T[];
  * This type is used throughout builders to ensure both an array and variadic arguments
  * may be used. It is normalized with {@link normalizeArray}.
  */
-type RestOrArray<T> = T[] | [T[]];
+type RestOrArray<Type> = Type[] | [Type[]];
 
 /**
  * A tuple satisfying the RGB color model.
@@ -640,6 +640,18 @@ declare class ChannelSelectMenuBuilder extends BaseSelectMenuBuilder<APIChannelS
      * @param types - The channel types to use
      */
     setChannelTypes(...types: RestOrArray<ChannelType>): this;
+    /**
+     * Adds default channels to this auto populated select menu.
+     *
+     * @param channels - The channels to add
+     */
+    addDefaultChannels(...channels: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default channels to this auto populated select menu.
+     *
+     * @param channels - The channels to set
+     */
+    setDefaultChannels(...channels: RestOrArray<Snowflake>): this;
     /**
      * {@inheritDoc BaseSelectMenuBuilder.toJSON}
      */
@@ -673,6 +685,30 @@ declare class MentionableSelectMenuBuilder extends BaseSelectMenuBuilder<APIMent
      * ```
      */
     constructor(data?: Partial<APIMentionableSelectComponent>);
+    /**
+     * Adds default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to add
+     */
+    addDefaultRoles(...roles: RestOrArray<Snowflake>): this;
+    /**
+     * Adds default users to this auto populated select menu.
+     *
+     * @param users - The users to add
+     */
+    addDefaultUsers(...users: RestOrArray<Snowflake>): this;
+    /**
+     * Adds default values to this auto populated select menu.
+     *
+     * @param values - The values to add
+     */
+    addDefaultValues(...values: RestOrArray<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.User>>): this;
+    /**
+     * Sets default values to this auto populated select menu.
+     *
+     * @param values - The values to set
+     */
+    setDefaultValues(...values: RestOrArray<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.User>>): this;
 }
 
 /**
@@ -702,6 +738,18 @@ declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectC
      * ```
      */
     constructor(data?: Partial<APIRoleSelectComponent>);
+    /**
+     * Adds default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to add
+     */
+    addDefaultRoles(...roles: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to set
+     */
+    setDefaultRoles(...roles: RestOrArray<Snowflake>): this;
 }
 
 /**
@@ -817,6 +865,18 @@ declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectC
      * ```
      */
     constructor(data?: Partial<APIUserSelectComponent>);
+    /**
+     * Adds default users to this auto populated select menu.
+     *
+     * @param users - The users to add
+     */
+    addDefaultUsers(...users: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default users to this auto populated select menu.
+     *
+     * @param users - The users to set
+     */
+    setDefaultUsers(...users: RestOrArray<Snowflake>): this;
 }
 
 /**
@@ -930,13 +990,13 @@ type AnyComponentBuilder = MessageActionRowComponentBuilder | ModalActionRowComp
 /**
  * A builder that creates API-compatible JSON data for action rows.
  *
- * @typeParam T - The types of components this action row holds
+ * @typeParam ComponentType - The types of components this action row holds
  */
-declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentBuilder<APIActionRowComponent<APIMessageActionRowComponent | APIModalActionRowComponent>> {
+declare class ActionRowBuilder<ComponentType extends AnyComponentBuilder> extends ComponentBuilder<APIActionRowComponent<APIMessageActionRowComponent | APIModalActionRowComponent>> {
     /**
      * The components within this action row.
      */
-    readonly components: T[];
+    readonly components: ComponentType[];
     /**
      * Creates a new action row from API data.
      *
@@ -977,17 +1037,17 @@ declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentB
      *
      * @param components - The components to add
      */
-    addComponents(...components: RestOrArray<T>): this;
+    addComponents(...components: RestOrArray<ComponentType>): this;
     /**
      * Sets components for this action row.
      *
      * @param components - The components to set
      */
-    setComponents(...components: RestOrArray<T>): this;
+    setComponents(...components: RestOrArray<ComponentType>): this;
     /**
      * {@inheritDoc ComponentBuilder.toJSON}
      */
-    toJSON(): APIActionRowComponent<ReturnType<T['toJSON']>>;
+    toJSON(): APIActionRowComponent<ReturnType<ComponentType['toJSON']>>;
 }
 
 /**
@@ -1030,19 +1090,19 @@ interface MappedComponentTypes {
 /**
  * Factory for creating components from API data.
  *
- * @typeParam T - The type of component to use
+ * @typeParam ComponentType - The type of component to use
  * @param data - The API data to transform to a component class
  */
-declare function createComponentBuilder<T extends keyof MappedComponentTypes>(data: (APIModalComponent | APIMessageComponent) & {
-    type: T;
-}): MappedComponentTypes[T];
+declare function createComponentBuilder<ComponentType extends keyof MappedComponentTypes>(data: (APIModalComponent | APIMessageComponent) & {
+    type: ComponentType;
+}): MappedComponentTypes[ComponentType];
 /**
  * Factory for creating components from API data.
  *
- * @typeParam C - The type of component to use
+ * @typeParam ComponentBuilder - The type of component to use
  * @param data - The API data to transform to a component class
  */
-declare function createComponentBuilder<C extends MessageComponentBuilder | ModalComponentBuilder>(data: C): C;
+declare function createComponentBuilder<ComponentBuilder extends MessageComponentBuilder | ModalComponentBuilder>(data: ComponentBuilder): ComponentBuilder;
 
 declare const textInputStyleValidator: _sapphire_shapeshift.NativeEnumValidator<typeof TextInputStyle>;
 declare const minLengthValidator: _sapphire_shapeshift.NumberValidator<number>;
@@ -1329,11 +1389,11 @@ declare abstract class ApplicationCommandNumericOptionMinMaxValueMixin {
 /**
  * This mixin holds choices and autocomplete symbols used for options.
  */
-declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<T extends number | string> {
+declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<ChoiceType extends number | string> {
     /**
      * The choices of this option.
      */
-    readonly choices?: APIApplicationCommandOptionChoice<T>[];
+    readonly choices?: APIApplicationCommandOptionChoice<ChoiceType>[];
     /**
      * Whether this option utilizes autocomplete.
      */
@@ -1349,13 +1409,13 @@ declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<T extends
      *
      * @param choices - The choices to add
      */
-    addChoices(...choices: APIApplicationCommandOptionChoice<T>[]): this;
+    addChoices(...choices: APIApplicationCommandOptionChoice<ChoiceType>[]): this;
     /**
      * Sets multiple choices for this option.
      *
      * @param choices - The choices to set
      */
-    setChoices<Input extends APIApplicationCommandOptionChoice<T>[]>(...choices: Input): this;
+    setChoices<Input extends APIApplicationCommandOptionChoice<ChoiceType>[]>(...choices: Input): this;
     /**
      * Whether this option uses autocomplete.
      *
@@ -1754,7 +1814,7 @@ declare function validateRequiredParameters$1(name: string, description: string,
 declare function validateDefaultPermission$1(value: unknown): asserts value is boolean;
 declare function validateRequired(required: unknown): asserts required is boolean;
 declare function validateChoicesLength(amountAdding: number, choices?: APIApplicationCommandOptionChoice[]): void;
-declare function assertReturnOfBuilder<T extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => T): asserts input is T;
+declare function assertReturnOfBuilder<ReturnType extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => ReturnType): asserts input is ReturnType;
 declare const localizationMapPredicate: _sapphire_shapeshift.UnionValidator<_sapphire_shapeshift.UndefinedToOptional<Partial<Record<"id" | "en-US" | "en-GB" | "bg" | "zh-CN" | "zh-TW" | "hr" | "cs" | "da" | "nl" | "fi" | "fr" | "de" | "el" | "hi" | "hu" | "it" | "ja" | "ko" | "lt" | "no" | "pl" | "pt-BR" | "ro" | "ru" | "es-ES" | "sv-SE" | "th" | "tr" | "uk" | "vi", string | null>>> | null | undefined>;
 declare function validateLocalizationMap(value: unknown): asserts value is LocalizationMap;
 declare function validateDMPermission$1(value: unknown): asserts value is boolean | null | undefined;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _sapphire_shapeshift from '@sapphire/shapeshift';
-import { APIEmbedField, APIEmbedAuthor, APIEmbedFooter, APIEmbedImage, APIEmbed, APISelectMenuOption, APIMessageComponentEmoji, ButtonStyle, ChannelType, APIActionRowComponent, APIActionRowComponentTypes, APIBaseComponent, ComponentType, APIButtonComponent, APISelectMenuComponent, APIChannelSelectComponent, APIMentionableSelectComponent, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIMessageActionRowComponent, APIModalActionRowComponent, APIModalComponent, APIMessageComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
+import { APIEmbedField, APIEmbedAuthor, APIEmbedFooter, APIEmbedImage, APIEmbed, APISelectMenuOption, APIMessageComponentEmoji, ButtonStyle, ChannelType, APIActionRowComponent, APIActionRowComponentTypes, APIBaseComponent, ComponentType, APIButtonComponent, APISelectMenuComponent, APIChannelSelectComponent, Snowflake, APIMentionableSelectComponent, APISelectMenuDefaultValue, SelectMenuDefaultValueType, APIRoleSelectComponent, APIStringSelectComponent, APIUserSelectComponent, APITextInputComponent, TextInputStyle, APIMessageActionRowComponent, APIModalActionRowComponent, APIModalComponent, APIMessageComponent, APIModalInteractionResponseCallbackData, LocalizationMap, LocaleString, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandAttachmentOption, APIApplicationCommandBooleanOption, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, Permissions, RESTPostAPIChatInputApplicationCommandsJSONBody, APIApplicationCommandOption, Locale, ApplicationCommandType, RESTPostAPIContextMenuApplicationCommandsJSONBody } from 'discord-api-types/v10';
 export * from '@discordjs/formatters';
 import { JSONEncodable, Equatable } from '@discordjs/util';
 
@@ -96,10 +96,10 @@ declare namespace Assertions$5 {
 /**
  * Normalizes data that is a rest parameter or an array into an array with a depth of 1.
  *
- * @typeParam T - The data that must satisfy {@link RestOrArray}.
+ * @typeParam ItemType - The data that must satisfy {@link RestOrArray}.
  * @param arr - The (possibly variadic) data to normalize
  */
-declare function normalizeArray<T>(arr: RestOrArray<T>): T[];
+declare function normalizeArray<ItemType>(arr: RestOrArray<ItemType>): ItemType[];
 /**
  * Represents data that may be an array or came from a rest parameter.
  *
@@ -107,7 +107,7 @@ declare function normalizeArray<T>(arr: RestOrArray<T>): T[];
  * This type is used throughout builders to ensure both an array and variadic arguments
  * may be used. It is normalized with {@link normalizeArray}.
  */
-type RestOrArray<T> = T[] | [T[]];
+type RestOrArray<Type> = Type[] | [Type[]];
 
 /**
  * A tuple satisfying the RGB color model.
@@ -640,6 +640,18 @@ declare class ChannelSelectMenuBuilder extends BaseSelectMenuBuilder<APIChannelS
      * @param types - The channel types to use
      */
     setChannelTypes(...types: RestOrArray<ChannelType>): this;
+    /**
+     * Adds default channels to this auto populated select menu.
+     *
+     * @param channels - The channels to add
+     */
+    addDefaultChannels(...channels: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default channels to this auto populated select menu.
+     *
+     * @param channels - The channels to set
+     */
+    setDefaultChannels(...channels: RestOrArray<Snowflake>): this;
     /**
      * {@inheritDoc BaseSelectMenuBuilder.toJSON}
      */
@@ -673,6 +685,30 @@ declare class MentionableSelectMenuBuilder extends BaseSelectMenuBuilder<APIMent
      * ```
      */
     constructor(data?: Partial<APIMentionableSelectComponent>);
+    /**
+     * Adds default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to add
+     */
+    addDefaultRoles(...roles: RestOrArray<Snowflake>): this;
+    /**
+     * Adds default users to this auto populated select menu.
+     *
+     * @param users - The users to add
+     */
+    addDefaultUsers(...users: RestOrArray<Snowflake>): this;
+    /**
+     * Adds default values to this auto populated select menu.
+     *
+     * @param values - The values to add
+     */
+    addDefaultValues(...values: RestOrArray<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.User>>): this;
+    /**
+     * Sets default values to this auto populated select menu.
+     *
+     * @param values - The values to set
+     */
+    setDefaultValues(...values: RestOrArray<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.User>>): this;
 }
 
 /**
@@ -702,6 +738,18 @@ declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectC
      * ```
      */
     constructor(data?: Partial<APIRoleSelectComponent>);
+    /**
+     * Adds default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to add
+     */
+    addDefaultRoles(...roles: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default roles to this auto populated select menu.
+     *
+     * @param roles - The roles to set
+     */
+    setDefaultRoles(...roles: RestOrArray<Snowflake>): this;
 }
 
 /**
@@ -817,6 +865,18 @@ declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectC
      * ```
      */
     constructor(data?: Partial<APIUserSelectComponent>);
+    /**
+     * Adds default users to this auto populated select menu.
+     *
+     * @param users - The users to add
+     */
+    addDefaultUsers(...users: RestOrArray<Snowflake>): this;
+    /**
+     * Sets default users to this auto populated select menu.
+     *
+     * @param users - The users to set
+     */
+    setDefaultUsers(...users: RestOrArray<Snowflake>): this;
 }
 
 /**
@@ -930,13 +990,13 @@ type AnyComponentBuilder = MessageActionRowComponentBuilder | ModalActionRowComp
 /**
  * A builder that creates API-compatible JSON data for action rows.
  *
- * @typeParam T - The types of components this action row holds
+ * @typeParam ComponentType - The types of components this action row holds
  */
-declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentBuilder<APIActionRowComponent<APIMessageActionRowComponent | APIModalActionRowComponent>> {
+declare class ActionRowBuilder<ComponentType extends AnyComponentBuilder> extends ComponentBuilder<APIActionRowComponent<APIMessageActionRowComponent | APIModalActionRowComponent>> {
     /**
      * The components within this action row.
      */
-    readonly components: T[];
+    readonly components: ComponentType[];
     /**
      * Creates a new action row from API data.
      *
@@ -977,17 +1037,17 @@ declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentB
      *
      * @param components - The components to add
      */
-    addComponents(...components: RestOrArray<T>): this;
+    addComponents(...components: RestOrArray<ComponentType>): this;
     /**
      * Sets components for this action row.
      *
      * @param components - The components to set
      */
-    setComponents(...components: RestOrArray<T>): this;
+    setComponents(...components: RestOrArray<ComponentType>): this;
     /**
      * {@inheritDoc ComponentBuilder.toJSON}
      */
-    toJSON(): APIActionRowComponent<ReturnType<T['toJSON']>>;
+    toJSON(): APIActionRowComponent<ReturnType<ComponentType['toJSON']>>;
 }
 
 /**
@@ -1030,19 +1090,19 @@ interface MappedComponentTypes {
 /**
  * Factory for creating components from API data.
  *
- * @typeParam T - The type of component to use
+ * @typeParam ComponentType - The type of component to use
  * @param data - The API data to transform to a component class
  */
-declare function createComponentBuilder<T extends keyof MappedComponentTypes>(data: (APIModalComponent | APIMessageComponent) & {
-    type: T;
-}): MappedComponentTypes[T];
+declare function createComponentBuilder<ComponentType extends keyof MappedComponentTypes>(data: (APIModalComponent | APIMessageComponent) & {
+    type: ComponentType;
+}): MappedComponentTypes[ComponentType];
 /**
  * Factory for creating components from API data.
  *
- * @typeParam C - The type of component to use
+ * @typeParam ComponentBuilder - The type of component to use
  * @param data - The API data to transform to a component class
  */
-declare function createComponentBuilder<C extends MessageComponentBuilder | ModalComponentBuilder>(data: C): C;
+declare function createComponentBuilder<ComponentBuilder extends MessageComponentBuilder | ModalComponentBuilder>(data: ComponentBuilder): ComponentBuilder;
 
 declare const textInputStyleValidator: _sapphire_shapeshift.NativeEnumValidator<typeof TextInputStyle>;
 declare const minLengthValidator: _sapphire_shapeshift.NumberValidator<number>;
@@ -1329,11 +1389,11 @@ declare abstract class ApplicationCommandNumericOptionMinMaxValueMixin {
 /**
  * This mixin holds choices and autocomplete symbols used for options.
  */
-declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<T extends number | string> {
+declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<ChoiceType extends number | string> {
     /**
      * The choices of this option.
      */
-    readonly choices?: APIApplicationCommandOptionChoice<T>[];
+    readonly choices?: APIApplicationCommandOptionChoice<ChoiceType>[];
     /**
      * Whether this option utilizes autocomplete.
      */
@@ -1349,13 +1409,13 @@ declare class ApplicationCommandOptionWithChoicesAndAutocompleteMixin<T extends
      *
      * @param choices - The choices to add
      */
-    addChoices(...choices: APIApplicationCommandOptionChoice<T>[]): this;
+    addChoices(...choices: APIApplicationCommandOptionChoice<ChoiceType>[]): this;
     /**
      * Sets multiple choices for this option.
      *
      * @param choices - The choices to set
      */
-    setChoices<Input extends APIApplicationCommandOptionChoice<T>[]>(...choices: Input): this;
+    setChoices<Input extends APIApplicationCommandOptionChoice<ChoiceType>[]>(...choices: Input): this;
     /**
      * Whether this option uses autocomplete.
      *
@@ -1754,7 +1814,7 @@ declare function validateRequiredParameters$1(name: string, description: string,
 declare function validateDefaultPermission$1(value: unknown): asserts value is boolean;
 declare function validateRequired(required: unknown): asserts required is boolean;
 declare function validateChoicesLength(amountAdding: number, choices?: APIApplicationCommandOptionChoice[]): void;
-declare function assertReturnOfBuilder<T extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => T): asserts input is T;
+declare function assertReturnOfBuilder<ReturnType extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => ReturnType): asserts input is ReturnType;
 declare const localizationMapPredicate: _sapphire_shapeshift.UnionValidator<_sapphire_shapeshift.UndefinedToOptional<Partial<Record<"id" | "en-US" | "en-GB" | "bg" | "zh-CN" | "zh-TW" | "hr" | "cs" | "da" | "nl" | "fi" | "fr" | "de" | "el" | "hi" | "hu" | "it" | "ja" | "ko" | "lt" | "no" | "pl" | "pt-BR" | "ro" | "ru" | "es-ES" | "sv-SE" | "th" | "tr" | "uk" | "vi", string | null>>> | null | undefined>;
 declare function validateLocalizationMap(value: unknown): asserts value is LocalizationMap;
 declare function validateDMPermission$1(value: unknown): asserts value is boolean | null | undefined;

package/dist/index.js

@@ -820,6 +820,37 @@ var ChannelSelectMenuBuilder = class extends BaseSelectMenuBuilder {
     this.data.channel_types.splice(0, this.data.channel_types.length, ...channelTypesValidator.parse(normalizedTypes));
     return this;
   }
+  /**
+   * Adds default channels to this auto populated select menu.
+   *
+   * @param channels - The channels to add
+   */
+  addDefaultChannels(...channels) {
+    const normalizedValues = normalizeArray(channels);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(
+      ...normalizedValues.map((id) => ({
+        id,
+        type: import_v103.SelectMenuDefaultValueType.Channel
+      }))
+    );
+    return this;
+  }
+  /**
+   * Sets default channels to this auto populated select menu.
+   *
+   * @param channels - The channels to set
+   */
+  setDefaultChannels(...channels) {
+    const normalizedValues = normalizeArray(channels);
+    optionsLengthValidator.parse(normalizedValues.length);
+    this.data.default_values = normalizedValues.map((id) => ({
+      id,
+      type: import_v103.SelectMenuDefaultValueType.Channel
+    }));
+    return this;
+  }
   /**
    * {@inheritDoc BaseSelectMenuBuilder.toJSON}
    */
@@ -862,6 +893,63 @@ var MentionableSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   constructor(data) {
     super({ ...data, type: import_v104.ComponentType.MentionableSelect });
   }
+  /**
+   * Adds default roles to this auto populated select menu.
+   *
+   * @param roles - The roles to add
+   */
+  addDefaultRoles(...roles) {
+    const normalizedValues = normalizeArray(roles);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(
+      ...normalizedValues.map((id) => ({
+        id,
+        type: import_v104.SelectMenuDefaultValueType.Role
+      }))
+    );
+    return this;
+  }
+  /**
+   * Adds default users to this auto populated select menu.
+   *
+   * @param users - The users to add
+   */
+  addDefaultUsers(...users) {
+    const normalizedValues = normalizeArray(users);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(
+      ...normalizedValues.map((id) => ({
+        id,
+        type: import_v104.SelectMenuDefaultValueType.User
+      }))
+    );
+    return this;
+  }
+  /**
+   * Adds default values to this auto populated select menu.
+   *
+   * @param values - The values to add
+   */
+  addDefaultValues(...values) {
+    const normalizedValues = normalizeArray(values);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(...normalizedValues);
+    return this;
+  }
+  /**
+   * Sets default values to this auto populated select menu.
+   *
+   * @param values - The values to set
+   */
+  setDefaultValues(...values) {
+    const normalizedValues = normalizeArray(values);
+    optionsLengthValidator.parse(normalizedValues.length);
+    this.data.default_values = normalizedValues.slice();
+    return this;
+  }
 };
 
 // src/components/selectMenu/RoleSelectMenu.ts
@@ -895,6 +983,37 @@ var RoleSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   constructor(data) {
     super({ ...data, type: import_v105.ComponentType.RoleSelect });
   }
+  /**
+   * Adds default roles to this auto populated select menu.
+   *
+   * @param roles - The roles to add
+   */
+  addDefaultRoles(...roles) {
+    const normalizedValues = normalizeArray(roles);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(
+      ...normalizedValues.map((id) => ({
+        id,
+        type: import_v105.SelectMenuDefaultValueType.Role
+      }))
+    );
+    return this;
+  }
+  /**
+   * Sets default roles to this auto populated select menu.
+   *
+   * @param roles - The roles to set
+   */
+  setDefaultRoles(...roles) {
+    const normalizedValues = normalizeArray(roles);
+    optionsLengthValidator.parse(normalizedValues.length);
+    this.data.default_values = normalizedValues.map((id) => ({
+      id,
+      type: import_v105.SelectMenuDefaultValueType.Role
+    }));
+    return this;
+  }
 };
 
 // src/components/selectMenu/StringSelectMenu.ts
@@ -1050,6 +1169,37 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   constructor(data) {
     super({ ...data, type: import_v107.ComponentType.UserSelect });
   }
+  /**
+   * Adds default users to this auto populated select menu.
+   *
+   * @param users - The users to add
+   */
+  addDefaultUsers(...users) {
+    const normalizedValues = normalizeArray(users);
+    optionsLengthValidator.parse((this.data.default_values?.length ?? 0) + normalizedValues.length);
+    this.data.default_values ??= [];
+    this.data.default_values.push(
+      ...normalizedValues.map((id) => ({
+        id,
+        type: import_v107.SelectMenuDefaultValueType.User
+      }))
+    );
+    return this;
+  }
+  /**
+   * Sets default users to this auto populated select menu.
+   *
+   * @param users - The users to set
+   */
+  setDefaultUsers(...users) {
+    const normalizedValues = normalizeArray(users);
+    optionsLengthValidator.parse(normalizedValues.length);
+    this.data.default_values = normalizedValues.map((id) => ({
+      id,
+      type: import_v107.SelectMenuDefaultValueType.User
+    }));
+    return this;
+  }
 };
 
 // src/components/textInput/TextInput.ts
@@ -2558,7 +2708,7 @@ function embedLength(data) {
 __name(embedLength, "embedLength");
 
 // src/index.ts
-var version = "1.7.0-dev.1699704223-5b0aa92c8";
+var version = "1.7.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,