@discordjs/builders 2.0.0-dev.1748650424-ef2c1bfa7 → 2.0.0-dev.1748909649-d40ceedad

package/dist/index.d.mts

@@ -8,7 +8,13 @@ import { APIComponentInMessageActionRow, APISeparatorComponent as APISeparatorCo
 
 interface EmojiOrLabelButtonData extends Pick<Exclude<APIButtonComponent, APIButtonComponentWithSKUId>, 'emoji' | 'label'> {
 }
+/**
+ * A mixin that adds emoji and label symbols to a button builder.
+ */
 declare class EmojiOrLabelButtonMixin {
+    /**
+     * @internal
+     */
     protected readonly data: EmojiOrLabelButtonData;
     /**
      * Sets the emoji to display on this button.
@@ -41,6 +47,9 @@ interface ComponentBuilderBaseData {
  * @typeParam Component - The type of API data that is stored within the builder
  */
 declare abstract class ComponentBuilder<Component extends APIBaseComponent<ComponentType>> implements JSONEncodable<Component> {
+    /**
+     * @internal
+     */
     protected abstract readonly data: ComponentBuilderBaseData;
     /**
      * Sets the id of this component.
@@ -66,6 +75,9 @@ declare abstract class ComponentBuilder<Component extends APIBaseComponent<Compo
  * A builder that creates API-compatible JSON data for buttons.
  */
 declare abstract class BaseButtonBuilder<ButtonData extends APIButtonComponent> extends ComponentBuilder<ButtonData> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<ButtonData>;
     /**
      * Sets whether this button is disabled.
@@ -83,6 +95,9 @@ type CustomIdButtonStyle = APIButtonComponentWithCustomId['style'];
 declare const CustomIdButtonBuilder_base: ts_mixer_dist_types_types_js.Class<any[], BaseButtonBuilder<APIButtonComponentWithCustomId> & EmojiOrLabelButtonMixin, (abstract new () => BaseButtonBuilder<APIButtonComponentWithCustomId>) & typeof EmojiOrLabelButtonMixin>;
 /**
  * A builder that creates API-compatible JSON data for buttons with custom IDs.
+ *
+ * @mixes {@link BaseButtonBuilder}\<{@link discord-api-types/v10#(APIButtonComponentWithCustomId:interface)}\>
+ * @mixes {@link EmojiOrLabelButtonMixin}
  */
 declare abstract class CustomIdButtonBuilder extends CustomIdButtonBuilder_base {
     protected readonly data: Partial<APIButtonComponentWithCustomId>;
@@ -124,6 +139,9 @@ declare class DangerButtonBuilder extends CustomIdButtonBuilder {
 declare const LinkButtonBuilder_base: ts_mixer_dist_types_types_js.Class<any[], BaseButtonBuilder<APIButtonComponentWithURL> & EmojiOrLabelButtonMixin, (abstract new () => BaseButtonBuilder<APIButtonComponentWithURL>) & typeof EmojiOrLabelButtonMixin>;
 /**
  * A builder that creates API-compatible JSON data for buttons with links.
+ *
+ * @mixes {@link BaseButtonBuilder}\<{@link discord-api-types/v10#(APIButtonComponentWithURL:interface)}\>
+ * @mixes {@link EmojiOrLabelButtonMixin}
  */
 declare class LinkButtonBuilder extends LinkButtonBuilder_base {
     protected readonly data: Partial<APIButtonComponentWithURL>;
@@ -157,9 +175,12 @@ declare class PremiumButtonBuilder extends BaseButtonBuilder<APIButtonComponentW
 /**
  * The base select menu builder that contains common symbols for select menu builders.
  *
- * @typeParam SelectMenuType - The type of select menu this would be instantiated for.
+ * @typeParam Data - The type of API data that is stored within the builder
  */
 declare abstract class BaseSelectMenuBuilder<Data extends APISelectMenuComponent> extends ComponentBuilder<Data> implements JSONEncodable<APISelectMenuComponent> {
+    /**
+     * @internal
+     */
     protected abstract readonly data: Partial<Pick<Data, 'custom_id' | 'disabled' | 'id' | 'max_values' | 'min_values' | 'placeholder'>>;
     /**
      * Sets the placeholder for this select menu.
@@ -219,9 +240,9 @@ type RestOrArray<Type> = Type[] | [Type[]];
 declare class ChannelSelectMenuBuilder extends BaseSelectMenuBuilder<APIChannelSelectComponent> {
     protected readonly data: Partial<APIChannelSelectComponent>;
     /**
-     * Creates a new select menu from API data.
+     * Creates a new channel select menu.
      *
-     * @param data - The API data to create this select menu with
+     * @param data - The API data to create this channel select menu with
      * @example
      * Creating a select menu from an API data object:
      * ```ts
@@ -278,9 +299,9 @@ declare class ChannelSelectMenuBuilder extends BaseSelectMenuBuilder<APIChannelS
 declare class MentionableSelectMenuBuilder extends BaseSelectMenuBuilder<APIMentionableSelectComponent> {
     protected readonly data: Partial<APIMentionableSelectComponent>;
     /**
-     * Creates a new select menu from API data.
+     * Creates a new mentionable select menu.
      *
-     * @param data - The API data to create this select menu with
+     * @param data - The API data to create this mentionable select menu with
      * @example
      * Creating a select menu from an API data object:
      * ```ts
@@ -336,9 +357,9 @@ declare class MentionableSelectMenuBuilder extends BaseSelectMenuBuilder<APIMent
 declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectComponent> {
     protected readonly data: Partial<APIRoleSelectComponent>;
     /**
-     * Creates a new select menu from API data.
+     * Creates a new role select menu.
      *
-     * @param data - The API data to create this select menu with
+     * @param data - The API data to create this role select menu with
      * @example
      * Creating a select menu from an API data object:
      * ```ts
@@ -382,7 +403,7 @@ declare class RoleSelectMenuBuilder extends BaseSelectMenuBuilder<APIRoleSelectC
 declare class StringSelectMenuOptionBuilder implements JSONEncodable<APISelectMenuOption> {
     private readonly data;
     /**
-     * Creates a new string select menu option from API data.
+     * Creates a new string select menu option.
      *
      * @param data - The API data to create this string select menu option with
      * @example
@@ -461,9 +482,9 @@ declare class StringSelectMenuBuilder extends BaseSelectMenuBuilder<APIStringSel
      */
     get options(): readonly StringSelectMenuOptionBuilder[];
     /**
-     * Creates a new select menu from API data.
+     * Creates a new string select menu.
      *
-     * @param data - The API data to create this select menu with
+     * @param data - The API data to create this string select menu with
      * @example
      * Creating a select menu from an API data object:
      * ```ts
@@ -491,7 +512,7 @@ declare class StringSelectMenuBuilder extends BaseSelectMenuBuilder<APIStringSel
      * 	});
      * ```
      */
-    constructor({ options, ...data }?: Partial<APIStringSelectComponent>);
+    constructor(data?: Partial<APIStringSelectComponent>);
     /**
      * Adds options to this select menu.
      *
@@ -544,9 +565,9 @@ declare class StringSelectMenuBuilder extends BaseSelectMenuBuilder<APIStringSel
 declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectComponent> {
     protected readonly data: Partial<APIUserSelectComponent>;
     /**
-     * Creates a new select menu from API data.
+     * Creates a new user select menu.
      *
-     * @param data - The API data to create this select menu with
+     * @param data - The API data to create this user select menu with
      * @example
      * Creating a select menu from an API data object:
      * ```ts
@@ -588,9 +609,12 @@ declare class UserSelectMenuBuilder extends BaseSelectMenuBuilder<APIUserSelectC
  * A builder that creates API-compatible JSON data for text inputs.
  */
 declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<APITextInputComponent>;
     /**
-     * Creates a new text input from API data.
+     * Creates a new text input.
      *
      * @param data - The API data to create this text input with
      * @example
@@ -715,10 +739,16 @@ declare const textInputPredicate: z.ZodObject<{
     required?: boolean | undefined;
 }>;
 
+/**
+ * A builder that creates API-compatible JSON data for files.
+ */
 declare class FileBuilder extends ComponentBuilder<APIFileComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<APIFileComponent>;
     /**
-     * Creates a new file from API data.
+     * Creates a new file.
      *
      * @param data - The API data to create this file with
      * @example
@@ -764,7 +794,7 @@ declare class FileBuilder extends ComponentBuilder<APIFileComponent> {
 declare class MediaGalleryItemBuilder implements JSONEncodable<APIMediaGalleryItem> {
     private readonly data;
     /**
-     * Creates a new media gallery item from API data.
+     * Creates a new media gallery item.
      *
      * @param data - The API data to create this media gallery item with
      * @example
@@ -820,10 +850,20 @@ declare class MediaGalleryItemBuilder implements JSONEncodable<APIMediaGalleryIt
 interface MediaGalleryBuilderData extends Partial<Omit<APIMediaGalleryComponent, 'items'>> {
     items: MediaGalleryItemBuilder[];
 }
+/**
+ * A builder that creates API-compatible JSON data for media galleries.
+ */
 declare class MediaGalleryBuilder extends ComponentBuilder<APIMediaGalleryComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: MediaGalleryBuilderData;
     /**
-     * Creates a new media gallery from API data.
+     * The items in this media gallery.
+     */
+    get items(): readonly MediaGalleryItemBuilder[];
+    /**
+     * Creates a new media gallery.
      *
      * @param data - The API data to create this container with
      * @example
@@ -857,10 +897,6 @@ declare class MediaGalleryBuilder extends ComponentBuilder<APIMediaGalleryCompon
      * ```
      */
     constructor(data?: Partial<APIMediaGalleryComponent>);
-    /**
-     * The items in this media gallery.
-     */
-    get items(): readonly MediaGalleryItemBuilder[];
     /**
      * Adds a media gallery item to this media gallery.
      *
@@ -881,10 +917,16 @@ declare class MediaGalleryBuilder extends ComponentBuilder<APIMediaGalleryCompon
     toJSON(validationOverride?: boolean): APIMediaGalleryComponent;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for text displays.
+ */
 declare class TextDisplayBuilder extends ComponentBuilder<APITextDisplayComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<APITextDisplayComponent>;
     /**
-     * Creates a new text display from API data.
+     * Creates a new text display.
      *
      * @param data - The API data to create this text display with
      * @example
@@ -916,10 +958,16 @@ declare class TextDisplayBuilder extends ComponentBuilder<APITextDisplayComponen
     toJSON(validationOverride?: boolean): APITextDisplayComponent;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for thumbnails.
+ */
 declare class ThumbnailBuilder extends ComponentBuilder<APIThumbnailComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<APIThumbnailComponent>;
     /**
-     * Creates a new thumbnail from API data.
+     * Creates a new thumbnail.
      *
      * @param data - The API data to create this thumbnail with
      * @example
@@ -977,11 +1025,20 @@ interface SectionBuilderData extends Partial<Omit<APISectionComponent, 'accessor
     accessory?: SectionBuilderAccessory;
     components: TextDisplayBuilder[];
 }
+/**
+ * A builder that creates API-compatible JSON data for sections.
+ */
 declare class SectionBuilder extends ComponentBuilder<APISectionComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: SectionBuilderData;
+    /**
+     * The components within this section.
+     */
     get components(): readonly TextDisplayBuilder[];
     /**
-     * Creates a new section from API data.
+     * Creates a new section.
      *
      * @param data - The API data to create this section with
      * @example
@@ -1086,10 +1143,16 @@ declare class SectionBuilder extends ComponentBuilder<APISectionComponent> {
     toJSON(validationOverride?: boolean): APISectionComponent;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for separators.
+ */
 declare class SeparatorBuilder extends ComponentBuilder<APISeparatorComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: Partial<APISeparatorComponent>;
     /**
-     * Creates a new separator from API data.
+     * Creates a new separator.
      *
      * @param data - The API data to create this separator with
      * @example
@@ -1136,9 +1199,24 @@ type ContainerComponentBuilders = ActionRowBuilder | FileBuilder | MediaGalleryB
 interface ContainerBuilderData extends Partial<Omit<APIContainerComponent, 'components'>> {
     components: ContainerComponentBuilders[];
 }
+/**
+ * A builder that creates API-compatible JSON data for containers.
+ */
 declare class ContainerBuilder extends ComponentBuilder<APIContainerComponent> {
+    /**
+     * @internal
+     */
     protected readonly data: ContainerBuilderData;
-    constructor({ components, ...rest }?: Partial<APIContainerComponent>);
+    /**
+     * Gets the components within this container.
+     */
+    get components(): readonly ContainerComponentBuilders[];
+    /**
+     * Creates a new container builder.
+     *
+     * @param data - The API data to create the container with
+     */
+    constructor(data?: Partial<APIContainerComponent>);
     /**
      * Sets the accent color of this container.
      *
@@ -1342,17 +1420,18 @@ interface ActionRowBuilderData extends Partial<Omit<APIActionRowComponent<APICom
 }
 /**
  * A builder that creates API-compatible JSON data for action rows.
- *
- * @typeParam ComponentType - The types of components this action row holds
  */
 declare class ActionRowBuilder extends ComponentBuilder<APIActionRowComponent<APIComponentInActionRow>> {
+    /**
+     * @internal
+     */
     protected readonly data: ActionRowBuilderData;
     /**
      * The components within this action row.
      */
     get components(): readonly AnyActionRowComponentBuilder[];
     /**
-     * Creates a new action row from API data.
+     * Creates a new action row.
      *
      * @param data - The API data to create this action row with
      * @example
@@ -1385,7 +1464,7 @@ declare class ActionRowBuilder extends ComponentBuilder<APIActionRowComponent<AP
      * 	.addComponents(button2, button3);
      * ```
      */
-    constructor({ components, ...data }?: Partial<APIActionRowComponent<APIComponentInActionRow>>);
+    constructor(data?: Partial<APIActionRowComponent<APIComponentInActionRow>>);
     /**
      * Adds primary button components to this action row.
      *
@@ -2554,6 +2633,9 @@ interface ApplicationCommandNumericOptionMinMaxValueData extends Pick<APIApplica
  * This mixin holds minimum and maximum symbols used for options.
  */
 declare abstract class ApplicationCommandNumericOptionMinMaxValueMixin {
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandNumericOptionMinMaxValueData;
     /**
      * Sets the maximum number value of this option.
@@ -2588,6 +2670,9 @@ interface ApplicationCommandOptionChannelTypesData extends Pick<APIApplicationCo
  * This mixin holds channel type symbols used for options.
  */
 declare class ApplicationCommandOptionChannelTypesMixin {
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandOptionChannelTypesData;
     /**
      * Adds channel types to this option.
@@ -2610,6 +2695,9 @@ interface ApplicationCommandOptionWithAutocompleteData extends Pick<Autocompleta
  * This mixin holds choices and autocomplete symbols used for options.
  */
 declare class ApplicationCommandOptionWithAutocompleteMixin {
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandOptionWithAutocompleteData;
     /**
      * Whether this option uses autocomplete.
@@ -2624,8 +2712,13 @@ interface ApplicationCommandOptionWithChoicesData {
 }
 /**
  * This mixin holds choices and autocomplete symbols used for options.
+ *
+ * @typeParam ChoiceType - The type of the choices within this option
  */
 declare class ApplicationCommandOptionWithChoicesMixin<ChoiceType extends number | string> {
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandOptionWithChoicesData;
     /**
      * Adds multiple choices to this option.
@@ -2647,6 +2740,9 @@ interface SharedNameData extends Partial<Pick<RESTPostAPIApplicationCommandsJSON
  * This mixin holds name and description symbols for chat input commands.
  */
 declare class SharedName {
+    /**
+     * @internal
+     */
     protected readonly data: SharedNameData;
     /**
      * Sets the name of this command.
@@ -2685,6 +2781,9 @@ interface SharedNameAndDescriptionData extends SharedNameData, Partial<Pick<APIA
  * This mixin holds name and description symbols for chat input commands.
  */
 declare class SharedNameAndDescription extends SharedName {
+    /**
+     * @internal
+     */
     protected readonly data: SharedNameAndDescriptionData;
     /**
      * Sets the description of this command.
@@ -2724,8 +2823,19 @@ interface ApplicationCommandOptionBaseData extends Partial<Pick<APIApplicationCo
  * The base application command option builder that contains common symbols for application command builders.
  */
 declare abstract class ApplicationCommandOptionBase extends SharedNameAndDescription implements JSONEncodable<APIApplicationCommandBasicOption> {
+    /**
+     * @internal
+     */
     protected static readonly predicate: z.ZodTypeAny;
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandOptionBaseData & SharedNameAndDescriptionData;
+    /**
+     * Creates a new application command option builder.
+     *
+     * @param type - The type of the option
+     */
     constructor(type: ApplicationCommandOptionType);
     /**
      * Sets whether this option is required.
@@ -2747,6 +2857,9 @@ declare abstract class ApplicationCommandOptionBase extends SharedNameAndDescrip
  * A chat input command attachment option.
  */
 declare class ChatInputCommandAttachmentOption extends ApplicationCommandOptionBase {
+    /**
+     * Creates a new attachment option.
+     */
     constructor();
 }
 
@@ -2754,14 +2867,23 @@ declare class ChatInputCommandAttachmentOption extends ApplicationCommandOptionB
  * A chat input command boolean option.
  */
 declare class ChatInputCommandBooleanOption extends ApplicationCommandOptionBase {
+    /**
+     * Creates a new boolean option.
+     */
     constructor();
 }
 
 declare const ChatInputCommandChannelOption_base: ts_mixer_dist_types_types_js.Class<any[], ApplicationCommandOptionBase & ApplicationCommandOptionChannelTypesMixin, typeof ApplicationCommandOptionBase & typeof ApplicationCommandOptionChannelTypesMixin>;
 /**
  * A chat input command channel option.
+ *
+ * @mixes {@link ApplicationCommandOptionBase}
+ * @mixes {@link ApplicationCommandOptionChannelTypesMixin}
  */
 declare class ChatInputCommandChannelOption extends ChatInputCommandChannelOption_base {
+    /**
+     * @internal
+     */
     protected static readonly predicate: zod.ZodObject<{
         name: zod.ZodString;
         name_localizations: zod.ZodOptional<zod.ZodObject<Record<discord_api_types_v10.Locale, zod.ZodOptional<zod.ZodString>>, "strict", zod.ZodTypeAny, {
@@ -3053,6 +3175,9 @@ declare class ChatInputCommandChannelOption extends ChatInputCommandChannelOptio
             vi?: string | undefined;
         } | undefined;
     }>;
+    /**
+     * Creates a new channel option.
+     */
     constructor();
 }
 
@@ -3061,8 +3186,16 @@ declare const ChatInputCommandIntegerOption_base: ts_mixer_dist_types_types_js.C
 }>;
 /**
  * A chat input command integer option.
+ *
+ * @mixes {@link ApplicationCommandOptionBase}
+ * @mixes {@link ApplicationCommandNumericOptionMinMaxValueMixin}
+ * @mixes {@link ApplicationCommandOptionWithAutocompleteMixin}
+ * @mixes {@link ApplicationCommandOptionWithChoicesMixin}\<number\>
  */
 declare class ChatInputCommandIntegerOption extends ChatInputCommandIntegerOption_base {
+    /**
+     * @internal
+     */
     protected static readonly predicate: zod.ZodIntersection<zod.ZodObject<{
         name: zod.ZodString;
         name_localizations: zod.ZodOptional<zod.ZodObject<Record<discord_api_types_v10.Locale, zod.ZodOptional<zod.ZodString>>, "strict", zod.ZodTypeAny, {
@@ -3595,6 +3728,9 @@ declare class ChatInputCommandIntegerOption extends ChatInputCommandIntegerOptio
             } | undefined;
         }[] | undefined;
     }>]>>;
+    /**
+     * Creates a new integer option.
+     */
     constructor();
 }
 
@@ -3602,6 +3738,9 @@ declare class ChatInputCommandIntegerOption extends ChatInputCommandIntegerOptio
  * A chat input command mentionable option.
  */
 declare class ChatInputCommandMentionableOption extends ApplicationCommandOptionBase {
+    /**
+     * Creates a new mentionable option.
+     */
     constructor();
 }
 
@@ -3610,8 +3749,16 @@ declare const ChatInputCommandNumberOption_base: ts_mixer_dist_types_types_js.Cl
 }>;
 /**
  * A chat input command number option.
+ *
+ * @mixes {@link ApplicationCommandOptionBase}
+ * @mixes {@link ApplicationCommandNumericOptionMinMaxValueMixin}
+ * @mixes {@link ApplicationCommandOptionWithAutocompleteMixin}
+ * @mixes {@link ApplicationCommandOptionWithChoicesMixin}\<number\>
  */
 declare class ChatInputCommandNumberOption extends ChatInputCommandNumberOption_base {
+    /**
+     * @internal
+     */
     protected static readonly predicate: zod.ZodIntersection<zod.ZodObject<{
         name: zod.ZodString;
         name_localizations: zod.ZodOptional<zod.ZodObject<Record<discord_api_types_v10.Locale, zod.ZodOptional<zod.ZodString>>, "strict", zod.ZodTypeAny, {
@@ -4144,6 +4291,9 @@ declare class ChatInputCommandNumberOption extends ChatInputCommandNumberOption_
             } | undefined;
         }[] | undefined;
     }>]>>;
+    /**
+     * Creates a new number option.
+     */
     constructor();
 }
 
@@ -4151,6 +4301,9 @@ declare class ChatInputCommandNumberOption extends ChatInputCommandNumberOption_
  * A chat input command role option.
  */
 declare class ChatInputCommandRoleOption extends ApplicationCommandOptionBase {
+    /**
+     * Creates a new role option.
+     */
     constructor();
 }
 
@@ -4159,8 +4312,15 @@ declare const ChatInputCommandStringOption_base: ts_mixer_dist_types_types_js.Cl
 }>;
 /**
  * A chat input command string option.
+ *
+ * @mixes {@link ApplicationCommandOptionBase}
+ * @mixes {@link ApplicationCommandOptionWithAutocompleteMixin}
+ * @mixes {@link ApplicationCommandOptionWithChoicesMixin}\<string\>
  */
 declare class ChatInputCommandStringOption extends ChatInputCommandStringOption_base {
+    /**
+     * @internal
+     */
     protected static readonly predicate: zod.ZodIntersection<zod.ZodObject<{
         name: zod.ZodString;
         name_localizations: zod.ZodOptional<zod.ZodObject<Record<discord_api_types_v10.Locale, zod.ZodOptional<zod.ZodString>>, "strict", zod.ZodTypeAny, {
@@ -4693,7 +4853,13 @@ declare class ChatInputCommandStringOption extends ChatInputCommandStringOption_
             } | undefined;
         }[] | undefined;
     }>]>>;
+    /**
+     * @internal
+     */
     protected readonly data: ApplicationCommandOptionBaseData & ApplicationCommandOptionWithAutocompleteData & ApplicationCommandOptionWithChoicesData & Partial<Pick<APIApplicationCommandStringOption, 'max_length' | 'min_length'>>;
+    /**
+     * Creates a new string option builder.
+     */
     constructor();
     /**
      * Sets the maximum length of this string option.
@@ -4721,6 +4887,9 @@ declare class ChatInputCommandStringOption extends ChatInputCommandStringOption_
  * A chat input command user option.
  */
 declare class ChatInputCommandUserOption extends ApplicationCommandOptionBase {
+    /**
+     * Creates a new user option.
+     */
     constructor();
 }
 
@@ -4729,11 +4898,15 @@ interface SharedChatInputCommandOptionsData {
 }
 /**
  * This mixin holds symbols that can be shared in chat input command options.
- *
- * @typeParam TypeAfterAddingOptions - The type this class should return after adding an option.
  */
 declare class SharedChatInputCommandOptions {
+    /**
+     * @internal
+     */
     protected readonly data: SharedChatInputCommandOptionsData;
+    /**
+     * The options within this command.
+     */
     get options(): readonly ApplicationCommandOptionBase[];
     /**
      * Adds boolean options.
@@ -4835,7 +5008,15 @@ interface ChatInputCommandSubcommandGroupData {
  * @see {@link https://discord.com/developers/docs/interactions/application-commands#subcommands-and-subcommand-groups}
  */
 declare class ChatInputCommandSubcommandGroupBuilder extends SharedNameAndDescription implements JSONEncodable<APIApplicationCommandSubcommandGroupOption> {
+    /**
+     * The API data associated with this subcommand group.
+     *
+     * @internal
+     */
     protected readonly data: ChatInputCommandSubcommandGroupData & SharedNameAndDescriptionData;
+    /**
+     * The options within this subcommand group.
+     */
     get options(): readonly ChatInputCommandSubcommandBuilder[];
     /**
      * Adds a new subcommand to this group.
@@ -4856,6 +5037,8 @@ declare const ChatInputCommandSubcommandBuilder_base: ts_mixer_dist_types_types_
 /**
  * A builder that creates API-compatible JSON data for chat input command subcommands.
  *
+ * @mixes {@link SharedNameAndDescription}
+ * @mixes {@link SharedChatInputCommandOptions}
  * @see {@link https://discord.com/developers/docs/interactions/application-commands#subcommands-and-subcommand-groups}
  */
 declare class ChatInputCommandSubcommandBuilder extends ChatInputCommandSubcommandBuilder_base implements JSONEncodable<APIApplicationCommandSubcommandOption> {
@@ -4874,10 +5057,11 @@ interface SharedChatInputCommandSubcommandsData {
 }
 /**
  * This mixin holds symbols that can be shared in chat input subcommands.
- *
- * @typeParam TypeAfterAddingSubcommands - The type this class should return after adding a subcommand or subcommand group.
  */
 declare class SharedChatInputCommandSubcommands {
+    /**
+     * @internal
+     */
     protected readonly data: SharedChatInputCommandSubcommandsData;
     /**
      * Adds subcommand groups to this command.
@@ -7991,7 +8175,15 @@ declare const chatInputCommandSubcommandPredicate: z.ZodObject<{
 
 interface CommandData extends Partial<Pick<RESTPostAPIApplicationCommandsJSONBody, 'contexts' | 'default_member_permissions' | 'integration_types' | 'nsfw'>> {
 }
+/**
+ * The base class for all command builders.
+ */
 declare abstract class CommandBuilder<Command extends RESTPostAPIApplicationCommandsJSONBody> implements JSONEncodable<Command> {
+    /**
+     * The API data associated with this command.
+     *
+     * @internal
+     */
     protected readonly data: CommandData;
     /**
      * Sets the contexts of this command.
@@ -8374,9 +8566,22 @@ type ContextMenuCommandType = ApplicationCommandType.Message | ApplicationComman
 declare const ContextMenuCommandBuilder_base: ts_mixer_dist_types_types_js.Class<any[], CommandBuilder<RESTPostAPIContextMenuApplicationCommandsJSONBody> & SharedName, (abstract new () => CommandBuilder<RESTPostAPIContextMenuApplicationCommandsJSONBody>) & typeof SharedName>;
 /**
  * A builder that creates API-compatible JSON data for context menu commands.
+ *
+ * @mixes {@link CommandBuilder}\<{@link discord-api-types/v10#(RESTPostAPIContextMenuApplicationCommandsJSONBody:interface)}\>
+ * @mixes {@link SharedName}
  */
 declare abstract class ContextMenuCommandBuilder extends ContextMenuCommandBuilder_base {
+    /**
+     * The API data associated with this context menu command.
+     *
+     * @internal
+     */
     protected readonly data: Partial<RESTPostAPIContextMenuApplicationCommandsJSONBody>;
+    /**
+     * Creates a new context menu command.
+     *
+     * @param data - The API data to create this context menu command with
+     */
     constructor(data?: Partial<RESTPostAPIContextMenuApplicationCommandsJSONBody>);
     /**
      * {@inheritDoc CommandBuilder.toJSON}
@@ -8384,6 +8589,9 @@ declare abstract class ContextMenuCommandBuilder extends ContextMenuCommandBuild
     abstract toJSON(validationOverride?: boolean): RESTPostAPIContextMenuApplicationCommandsJSONBody;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for message context menu commands.
+ */
 declare class MessageContextCommandBuilder extends ContextMenuCommandBuilder {
     /**
      * {@inheritDoc CommandBuilder.toJSON}
@@ -8391,6 +8599,9 @@ declare class MessageContextCommandBuilder extends ContextMenuCommandBuilder {
     toJSON(validationOverride?: boolean): RESTPostAPIContextMenuApplicationCommandsJSONBody;
 }
 
+/**
+ * A builder that creates API-compatible JSON data for user context menu commands.
+ */
 declare class UserContextCommandBuilder extends ContextMenuCommandBuilder {
     /**
      * {@inheritDoc CommandBuilder.toJSON}
@@ -8457,11 +8668,11 @@ declare class ModalBuilder implements JSONEncodable<APIModalInteractionResponseC
      */
     get components(): readonly ActionRowBuilder[];
     /**
-     * Creates a new modal from API data.
+     * Creates a new modal.
      *
      * @param data - The API data to create this modal with
      */
-    constructor({ components, ...data }?: Partial<APIModalInteractionResponseCallbackData>);
+    constructor(data?: Partial<APIModalInteractionResponseCallbackData>);
     /**
      * Sets the title of this modal.
      *
@@ -8780,11 +8991,14 @@ declare const embedPredicate: z.ZodEffects<z.ZodEffects<z.ZodObject<{
  * A builder that creates API-compatible JSON data for the embed author.
  */
 declare class EmbedAuthorBuilder implements JSONEncodable<APIEmbedAuthor> {
+    /**
+     * The API data associated with this embed author.
+     */
     private readonly data;
     /**
-     * Creates a new embed author from API data.
+     * Creates a new embed author.
      *
-     * @param data - The API data to use
+     * @param data - The API data to create this embed author with
      */
     constructor(data?: Partial<APIEmbedAuthor>);
     /**
@@ -8827,11 +9041,14 @@ declare class EmbedAuthorBuilder implements JSONEncodable<APIEmbedAuthor> {
  * A builder that creates API-compatible JSON data for embed fields.
  */
 declare class EmbedFieldBuilder implements JSONEncodable<APIEmbedField> {
+    /**
+     * The API data associated with this embed field.
+     */
     private readonly data;
     /**
-     * Creates a new embed field from API data.
+     * Creates a new embed field.
      *
-     * @param data - The API data to use
+     * @param data - The API data to create this embed field with
      */
     constructor(data?: Partial<APIEmbedField>);
     /**
@@ -8866,11 +9083,14 @@ declare class EmbedFieldBuilder implements JSONEncodable<APIEmbedField> {
  * A builder that creates API-compatible JSON data for the embed footer.
  */
 declare class EmbedFooterBuilder implements JSONEncodable<APIEmbedFooter> {
+    /**
+     * The API data associated with this embed footer.
+     */
     private readonly data;
     /**
-     * Creates a new embed footer from API data.
+     * Creates a new embed footer.
      *
-     * @param data - The API data to use
+     * @param data - The API data to create this embed footer with
      */
     constructor(data?: Partial<APIEmbedFooter>);
     /**
@@ -8920,11 +9140,11 @@ declare class EmbedBuilder implements JSONEncodable<APIEmbed> {
      */
     get fields(): readonly EmbedFieldBuilder[];
     /**
-     * Creates a new embed from API data.
+     * Creates a new embed.
      *
      * @param data - The API data to create this embed with
      */
-    constructor(data?: APIEmbed);
+    constructor(data?: Partial<APIEmbed>);
     /**
      * Appends fields to the embed.
      *
@@ -9317,12 +9537,14 @@ declare const pollPredicate: z.ZodObject<{
 declare abstract class PollMediaBuilder {
     /**
      * The API data associated with this poll media.
+     *
+     * @internal
      */
     protected readonly data: Partial<APIPollMedia>;
     /**
-     * Creates new poll media from API data.
+     * Creates new poll media.
      *
-     * @param data - The API data to use
+     * @param data - The API data to create this poll media with
      */
     constructor(data?: Partial<APIPollMedia>);
     /**
@@ -9364,13 +9586,16 @@ declare class PollAnswerMediaBuilder extends PollMediaBuilder {
 interface PollAnswerData extends Omit<APIPollAnswer, 'answer_id' | 'poll_media'> {
     poll_media: PollAnswerMediaBuilder;
 }
+/**
+ * A builder that creates API-compatible JSON data for poll answers.
+ */
 declare class PollAnswerBuilder implements JSONEncodable<Omit<APIPollAnswer, 'answer_id'>> {
     /**
      * The API data associated with this poll answer.
      */
     private readonly data;
     /**
-     * Creates a new poll answer from API data.
+     * Creates a new poll answer.
      *
      * @param data - The API data to create this poll answer with
      */
@@ -9424,7 +9649,7 @@ declare class PollBuilder implements JSONEncodable<RESTAPIPoll> {
      */
     get answers(): readonly PollAnswerBuilder[];
     /**
-     * Creates a new poll from API data.
+     * Creates a new poll.
      *
      * @param data - The API data to create this poll with
      */
@@ -9553,11 +9778,14 @@ declare class PollBuilder implements JSONEncodable<RESTAPIPoll> {
  * A builder that creates API-compatible JSON data for allowed mentions.
  */
 declare class AllowedMentionsBuilder implements JSONEncodable<APIAllowedMentions> {
+    /**
+     * The API data associated with these allowed mentions.
+     */
     private readonly data;
     /**
-     * Creates a new allowed mentions builder from API data.
+     * Creates a new allowed mentions builder.
      *
-     * @param data - The API data to create this allowed mentions builder with
+     * @param data - The API data to create this allowed mentions with
      */
     constructor(data?: Partial<APIAllowedMentions>);
     /**
@@ -10656,11 +10884,14 @@ declare const messagePredicate: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
  * A builder that creates API-compatible JSON data for attachments.
  */
 declare class AttachmentBuilder implements JSONEncodable<RESTAPIAttachment> {
+    /**
+     * The API data associated with this attachment.
+     */
     private readonly data;
     /**
-     * Creates a new attachment builder from API data.
+     * Creates a new attachment builder.
      *
-     * @param data - The API data to create this attachment builder with
+     * @param data - The API data to create this attachment with
      */
     constructor(data?: Partial<RESTAPIAttachment>);
     /**
@@ -10733,11 +10964,14 @@ declare class AttachmentBuilder implements JSONEncodable<RESTAPIAttachment> {
  * A builder that creates API-compatible JSON data for message references.
  */
 declare class MessageReferenceBuilder implements JSONEncodable<RESTAPIMessageReference> {
+    /**
+     * The API data associated with this message reference.
+     */
     private readonly data;
     /**
-     * Creates a new message reference builder from API data.
+     * Creates a new message reference builder.
      *
-     * @param data - The API data to create this message reference builder with
+     * @param data - The API data to create this message reference with
      */
     constructor(data?: Partial<RESTAPIMessageReference>);
     /**
@@ -10821,11 +11055,11 @@ declare class MessageBuilder implements JSONEncodable<RESTPostAPIChannelMessageJ
      */
     get embeds(): readonly EmbedBuilder[];
     /**
-     * Creates a new message builder from API data.
+     * Creates a new message builder.
      *
-     * @param data - The API data to create this message builder with
+     * @param data - The API data to create this message with
      */
-    constructor({ attachments, embeds, components, message_reference, poll, allowed_mentions, ...data }?: Partial<RESTPostAPIChannelMessageJSONBody>);
+    constructor(data?: Partial<RESTPostAPIChannelMessageJSONBody>);
     /**
      * Sets the content of the message.
      *