@discordjs/builders 1.3.0-dev.1662293019-8b3d006.0 → 1.3.0-dev.1663675483-5048a3d.0

package/dist/index.d.ts

@@ -539,6 +539,28 @@ declare function isJSONEncodable(maybeEncodable: unknown): maybeEncodable is JSO
  */
 declare class SelectMenuOptionBuilder implements JSONEncodable<APISelectMenuOption> {
     data: Partial<APISelectMenuOption>;
+    /**
+     * Creates a new select menu option from API data
+     *
+     * @param data - The API data to create this select menu option with
+     * @example
+     * Creating a select menu option from an API data object
+     * ```ts
+     * const selectMenuOption = new SelectMenuOptionBuilder({
+     * 	label: 'catchy label',
+     * 	value: '1',
+     * });
+     * ```
+     * @example
+     * Creating a select menu option using setters and API data
+     * ```ts
+     * const selectMenuOption = new SelectMenuOptionBuilder({
+     * 	default: true,
+     * 	value: '1',
+     * })
+     * 	.setLabel('woah')
+     * ```
+     */
     constructor(data?: Partial<APISelectMenuOption>);
     /**
      * Sets the label of this option
@@ -694,24 +716,24 @@ declare class ButtonBuilder extends ComponentBuilder<APIButtonComponent> {
      * Creating a button from an API data object
      * ```ts
      * const button = new ButtonBuilder({
-     * 	style: 'primary',
+     * 	custom_id: 'a cool button',
+     * 	style: ButtonStyle.Primary,
      * 	label: 'Click Me',
      * 	emoji: {
-     * 		name: ':smile:',
-     * 		id: '12345678901234567890123456789012',
+     * 		name: 'smile',
+     * 		id: '123456789012345678',
      * 	},
-     *  custom_id: '12345678901234567890123456789012',
      * });
      * ```
      * @example
      * Creating a button using setters and API data
      * ```ts
      * const button = new ButtonBuilder({
-     * 	style: 'primary',
+     * 	style: ButtonStyle.Secondary,
      * 	label: 'Click Me',
      * })
-     * .setEmoji({ name: ':smile:', id: '12345678901234567890123456789012' })
-     * .setCustomId('12345678901234567890123456789012');
+     * 	.setEmoji({ name: '🙂' })
+     * 	.setCustomId('another cool button');
      * ```
      */
     constructor(data?: Partial<APIButtonComponent>);
@@ -770,6 +792,37 @@ declare class SelectMenuBuilder extends ComponentBuilder<APISelectMenuComponent>
      * The options within this select menu
      */
     readonly options: SelectMenuOptionBuilder[];
+    /**
+     * Creates a new select menu from API data
+     *
+     * @param data - The API data to create this select menu with
+     * @example
+     * Creating a select menu from an API data object
+     * ```ts
+     * const selectMenu = new SelectMenuBuilder({
+     * 	custom_id: 'a cool select menu',
+     * 	placeholder: 'select an option',
+     * 	max_values: 2,
+     * 	options: [
+     * 		{ label: 'option 1', value: '1' },
+     * 		{ label: 'option 2', value: '2' },
+     * 		{ label: 'option 3', value: '3' },
+     * 	],
+     * });
+     * ```
+     * @example
+     * Creating a select menu using setters and API data
+     * ```ts
+     * const selectMenu = new SelectMenuBuilder({
+     * 	custom_id: 'a cool select menu',
+     * })
+     * 	.setMinValues(1)
+     * 	.addOptions({
+     * 		label: 'Catchy',
+     * 		value: 'catch',
+     * 	});
+     * ```
+     */
     constructor(data?: Partial<APISelectMenuComponent>);
     /**
      * Sets the placeholder for this select menu
@@ -840,6 +893,29 @@ interface Equatable<T> {
 declare function isEquatable(maybeEquatable: unknown): maybeEquatable is Equatable<unknown>;
 
 declare class TextInputBuilder extends ComponentBuilder<APITextInputComponent> implements Equatable<APITextInputComponent | JSONEncodable<APITextInputComponent>> {
+    /**
+     * Creates a new text input from API data
+     *
+     * @param data - The API data to create this text input with
+     * @example
+     * Creating a select menu option from an API data object
+     * ```ts
+     * const textInput = new TextInputBuilder({
+     * 	custom_id: 'a cool select menu',
+     * 	label: 'Type something',
+     * 	style: TextInputStyle.Short,
+     * });
+     * ```
+     * @example
+     * Creating a select menu option using setters and API data
+     * ```ts
+     * const textInput = new TextInputBuilder({
+     * 	label: 'Type something else',
+     * })
+     * 	.setCustomId('woah')
+     * 	.setStyle(TextInputStyle.Paragraph);
+     * ```
+     */
     constructor(data?: APITextInputComponent & {
         type?: ComponentType.TextInput;
     });
@@ -916,6 +992,40 @@ declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentB
      * The components within this action row
      */
     readonly components: T[];
+    /**
+     * Creates a new action row from API data
+     *
+     * @param data - The API data to create this action row with
+     * @example
+     * Creating an action row from an API data object
+     * ```ts
+     * const actionRow = new ActionRowBuilder({
+     * 	components: [
+     * 		{
+     * 			custom_id: "custom id",
+     * 			label: "Type something",
+     * 			style: TextInputStyle.Short,
+     * 			type: ComponentType.TextInput,
+     * 		},
+     * 	],
+     * });
+     * ```
+     * @example
+     * Creating an action row using setters and API data
+     * ```ts
+     * const actionRow = new ActionRowBuilder({
+     * 	components: [
+     * 		{
+     * 			custom_id: "custom id",
+     * 			label: "Click me",
+     * 			style: ButtonStyle.Primary,
+     * 			type: ComponentType.Button,
+     * 		},
+     * 	],
+     * })
+     * 	.addComponents(button2, button3);
+     * ```
+     */
     constructor({ components, ...data }?: Partial<APIActionRowComponent<APIActionRowComponentTypes>>);
     /**
      * Adds components to this action row.
@@ -1096,7 +1206,7 @@ declare class SlashCommandBooleanOption extends ApplicationCommandOptionBase {
     toJSON(): APIApplicationCommandBooleanOption;
 }
 
-declare const allowedChannelTypes: readonly [ChannelType.GuildText, ChannelType.GuildVoice, ChannelType.GuildCategory, ChannelType.GuildNews, ChannelType.GuildNewsThread, ChannelType.GuildPublicThread, ChannelType.GuildPrivateThread, ChannelType.GuildStageVoice];
+declare const allowedChannelTypes: readonly [ChannelType.GuildText, ChannelType.GuildVoice, ChannelType.GuildCategory, ChannelType.GuildAnnouncement, ChannelType.AnnouncementThread, ChannelType.PublicThread, ChannelType.PrivateThread, ChannelType.GuildStageVoice];
 declare type ApplicationCommandOptionAllowedChannelTypes = typeof allowedChannelTypes[number];
 declare class ApplicationCommandOptionChannelTypesMixin {
     readonly channel_types?: ApplicationCommandOptionAllowedChannelTypes[];
@@ -1367,14 +1477,16 @@ declare class SlashCommandBuilder {
     /**
      * Returns the final data that should be sent to Discord.
      *
-     * **Note:** Calling this function will validate required properties based on their conditions.
+     * @remarks
+     * This method runs validations on the data before serializing it.
+     * As such, it may throw an error if the data is invalid.
      */
     toJSON(): RESTPostAPIChatInputApplicationCommandsJSONBody;
     /**
      * Sets whether the command is enabled by default when the application is added to a guild.
      *
-     * **Note**: If set to `false`, you will have to later `PUT` the permissions for this command.
-     *
+     * @remarks
+     * If set to `false`, you will have to later `PUT` the permissions for this command.
      * @param value - Whether or not to enable this command by default
      * @see https://discord.com/developers/docs/interactions/application-commands#permissions
      * @deprecated Use {@link (SlashCommandBuilder:class).setDefaultMemberPermissions} or {@link (SlashCommandBuilder:class).setDMPermission} instead.
@@ -1383,8 +1495,8 @@ declare class SlashCommandBuilder {
     /**
      * Sets the default permissions a member should have in order to run the command.
      *
-     * **Note:** You can set this to `'0'` to disable the command by default.
-     *
+     * @remarks
+     * You can set this to `'0'` to disable the command by default.
      * @param permissions - The permissions bit field to set
      * @see https://discord.com/developers/docs/interactions/application-commands#permissions
      */
@@ -1412,7 +1524,7 @@ declare class SlashCommandBuilder {
 }
 interface SlashCommandBuilder extends SharedNameAndDescription, SharedSlashCommandOptions {
 }
-interface SlashCommandSubcommandsOnlyBuilder extends SharedNameAndDescription, Pick<SlashCommandBuilder, 'addSubcommand' | 'addSubcommandGroup' | 'toJSON'> {
+interface SlashCommandSubcommandsOnlyBuilder extends Omit<SlashCommandBuilder, Exclude<keyof SharedSlashCommandOptions, 'options'>> {
 }
 interface SlashCommandOptionsOnlyBuilder extends SharedNameAndDescription, SharedSlashCommandOptions, Pick<SlashCommandBuilder, 'toJSON'> {
 }
@@ -1504,8 +1616,8 @@ declare class ContextMenuCommandBuilder {
     /**
      * Sets whether the command is enabled by default when the application is added to a guild.
      *
-     * **Note**: If set to `false`, you will have to later `PUT` the permissions for this command.
-     *
+     * @remarks
+     * If set to `false`, you will have to later `PUT` the permissions for this command.
      * @param value - Whether or not to enable this command by default
      * @see https://discord.com/developers/docs/interactions/application-commands#permissions
      * @deprecated Use {@link ContextMenuCommandBuilder.setDefaultMemberPermissions} or {@link ContextMenuCommandBuilder.setDMPermission} instead.
@@ -1514,8 +1626,8 @@ declare class ContextMenuCommandBuilder {
     /**
      * Sets the default permissions a member should have in order to run the command.
      *
-     * **Note:** You can set this to `'0'` to disable the command by default.
-     *
+     * @remarks
+     * You can set this to `'0'` to disable the command by default.
      * @param permissions - The permissions bit field to set
      * @see https://discord.com/developers/docs/interactions/application-commands#permissions
      */
@@ -1544,7 +1656,9 @@ declare class ContextMenuCommandBuilder {
     /**
      * Returns the final data that should be sent to Discord.
      *
-     * **Note:** Calling this function will validate required properties based on their conditions.
+     * @remarks
+     * This method runs validations on the data before serializing it.
+     * As such, it may throw an error if the data is invalid.
      */
     toJSON(): RESTPostAPIContextMenuApplicationCommandsJSONBody;
 }

package/dist/index.js

@@ -1009,10 +1009,10 @@ var allowedChannelTypes = [
   import_v1011.ChannelType.GuildText,
   import_v1011.ChannelType.GuildVoice,
   import_v1011.ChannelType.GuildCategory,
-  import_v1011.ChannelType.GuildNews,
-  import_v1011.ChannelType.GuildNewsThread,
-  import_v1011.ChannelType.GuildPublicThread,
-  import_v1011.ChannelType.GuildPrivateThread,
+  import_v1011.ChannelType.GuildAnnouncement,
+  import_v1011.ChannelType.AnnouncementThread,
+  import_v1011.ChannelType.PublicThread,
+  import_v1011.ChannelType.PrivateThread,
   import_v1011.ChannelType.GuildStageVoice
 ];
 var channelTypesPredicate = import_shapeshift6.s.array(import_shapeshift6.s.union(...allowedChannelTypes.map((type) => import_shapeshift6.s.literal(type))));