@discordjs/builders 0.11.0 → 0.12.0

package/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+# [0.12.0](https://github.com/discordjs/discord.js/compare/@discordjs/builders@0.11.0...@discordjs/builders@0.12.0) (2021-12-08)
+
+## Bug Fixes
+
+- **builders:** Dont export `Button` component stuff twice (#7289) ([86d9d06](https://github.com/discordjs/discord.js/commit/86d9d0674347c08d056cd054cb4ce4253195bf94))
+
+## Documentation
+
+- **SlashCommandSubcommands:** Updating old links from Discord developer portal (#7224) ([bd7a6f2](https://github.com/discordjs/discord.js/commit/bd7a6f265212624199fb0b2ddc8ece39759c63de))
+
+## Features
+
+- Add components to /builders (#7195) ([2bb40fd](https://github.com/discordjs/discord.js/commit/2bb40fd767cf5918e3ba422ff73082734bfa05b0))
+
+## Typings
+
+- Make `required` a boolean (#7307) ([c10afea](https://github.com/discordjs/discord.js/commit/c10afeadc702ab98bec5e077b3b92494a9596f9c))
+
+# [0.11.0](https://github.com/discordjs/builders/compare/v0.10.0...v0.11.0) (2021-12-29)
+
+## Bug Fixes
+
+- **ApplicationCommandOptions:** clean up code for builder options ([#68](https://github.com/discordjs/builders/issues/68)) ([b5d0b15](https://github.com/discordjs/builders/commit/b5d0b157b1262bd01fa011f8e0cf33adb82776e7))
+
+# [0.10.0](https://github.com/discordjs/builders/compare/v0.9.0...v0.10.0) (2021-12-24)
+
+## Bug Fixes
+
+- use zod instead of ow for max/min option validation ([#66](https://github.com/discordjs/builders/issues/66)) ([beb35fb](https://github.com/discordjs/builders/commit/beb35fb1f65bd6be2321e17cc792f67e8615fd48))
+
+## Features
+
+- add max/min option for int and number builder options ([#47](https://github.com/discordjs/builders/issues/47)) ([2e1e860](https://github.com/discordjs/builders/commit/2e1e860b46e3453398b20df63dabb6d4325e32d1))
+
+# [0.9.0](https://github.com/discordjs/builders/compare/v0.8.2...v0.9.0) (2021-12-02)
+
+## Bug Fixes
+
+- replace ow with zod ([#58](https://github.com/discordjs/builders/issues/58)) ([0b6fb81](https://github.com/discordjs/builders/commit/0b6fb8161b858e42781855fb73aaa873fec58160))
+
+## Features
+
+- **SlashCommandBuilder:** add autocomplete ([#53](https://github.com/discordjs/builders/issues/53)) ([05b07a7](https://github.com/discordjs/builders/commit/05b07a7e88848188c27d7380d9f948cba25ef778))
+
+## [0.8.2](https://github.com/discordjs/builders/compare/v0.8.1...v0.8.2) (2021-10-30)
+
+## Bug Fixes
+
+- downgrade ow because of esm issues ([#55](https://github.com/discordjs/builders/issues/55)) ([3722d2c](https://github.com/discordjs/builders/commit/3722d2c1109a7a5c0abad63c1a7eb944df6e46c8))
+
+## [0.8.1](https://github.com/discordjs/builders/compare/v0.8.0...v0.8.1) (2021-10-29)
+
+## Bug Fixes
+
+- documentation ([e33ec8d](https://github.com/discordjs/builders/commit/e33ec8dfd5785312f82e0afb017a3dac614fd71d))
+
+# [0.7.0](https://github.com/discordjs/builders/compare/v0.6.0...v0.7.0) (2021-10-18)
+
+## Bug Fixes
+
+- properly type `toJSON` methods ([#34](https://github.com/discordjs/builders/issues/34)) ([7723ad0](https://github.com/discordjs/builders/commit/7723ad0da169386e638188de220451a97513bc25))
+
+## Features
+
+- **ContextMenus:** add context menu command builder ([#29](https://github.com/discordjs/builders/issues/29)) ([f0641e5](https://github.com/discordjs/builders/commit/f0641e55733de8992600f3082bcf054e6f815cf7))
+- add support for channel types on channel options ([#41](https://github.com/discordjs/builders/issues/41)) ([f6c187e](https://github.com/discordjs/builders/commit/f6c187e0ad6ebe03e65186ece3e95cb1db5aeb50))
+
+# [0.6.0](https://github.com/discordjs/builders/compare/v0.5.0...v0.6.0) (2021-08-24)
+
+## Bug Fixes
+
+- **SlashCommandBuilder:** allow subcommands and groups to coexist at the root level ([#26](https://github.com/discordjs/builders/issues/26)) ([0be4daf](https://github.com/discordjs/builders/commit/0be4dafdfc0b5747c880be0078c00ada913eb4fb))
+
+## Features
+
+- create `Embed` builder ([#11](https://github.com/discordjs/builders/issues/11)) ([eb942a4](https://github.com/discordjs/builders/commit/eb942a4d1f3bcec9a4e370b6af602a713ad8f9b7))
+- **SlashCommandBuilder:** create setDefaultPermission function ([#19](https://github.com/discordjs/builders/issues/19)) ([5d53759](https://github.com/discordjs/builders/commit/5d537593937a8da330153ce4711b7d093a80330e))
+- **SlashCommands:** add number option type ([#23](https://github.com/discordjs/builders/issues/23)) ([1563991](https://github.com/discordjs/builders/commit/1563991d421bb07bf7a412c87e7613692d770f04))
+
+# [0.5.0](https://github.com/discordjs/builders/compare/v0.3.0...v0.5.0) (2021-08-10)
+
+## Features
+
+- **Formatters:** add `formatEmoji` ([#20](https://github.com/discordjs/builders/issues/20)) ([c3d8bb5](https://github.com/discordjs/builders/commit/c3d8bb5363a1d46b45c0def4277da6921e2ba209))
+
+# [0.4.0](https://github.com/discordjs/builders/compare/v0.3.0...v0.4.0) (2021-08-05)
+
+## Features
+
+- `sub command` => `subcommand` ([#18](https://github.com/discordjs/builders/pull/18)) ([95599c5](https://github.com/discordjs/builders/commit/95599c5b5366ebd054c4c277c52f1a44cda1209d))
+
+# [0.3.0](https://github.com/discordjs/builders/compare/v0.2.0...v0.3.0) (2021-08-01)
+
+## Bug Fixes
+
+- **Shrug:** Update comment ([#14](https://github.com/discordjs/builders/issues/14)) ([6fa6c40](https://github.com/discordjs/builders/commit/6fa6c405f2ea733811677d3d1bfb1e2806d504d5))
+- shrug face rendering ([#13](https://github.com/discordjs/builders/issues/13)) ([6ad24ec](https://github.com/discordjs/builders/commit/6ad24ecd96c82b0f576e78e9e53fc7bf9c36ef5d))
+
+## Features
+
+- **formatters:** mentions ([#9](https://github.com/discordjs/builders/issues/9)) ([f83fe99](https://github.com/discordjs/builders/commit/f83fe99b83188ed999845751ffb005c687dbd60a))
+- **Formatters:** Add a spoiler function ([#16](https://github.com/discordjs/builders/issues/16)) ([c213a6a](https://github.com/discordjs/builders/commit/c213a6abb114f65653017a4edec4bdba2162d771))
+- **SlashCommands:** add slash command builders ([#3](https://github.com/discordjs/builders/issues/3)) ([6aa3af0](https://github.com/discordjs/builders/commit/6aa3af07b0ee342fff91f080914bb12b3ab773f8))
+- shrug, tableflip and unflip strings ([#5](https://github.com/discordjs/builders/issues/5)) ([de5fa82](https://github.com/discordjs/builders/commit/de5fa823cd6f1feba5b2d0a63b2cb1761dfd1814))
+
+# [0.2.0](https://github.com/discordjs/builders/compare/v0.1.1...v0.2.0) (2021-07-03)
+
+## Features
+
+- **Formatters:** added `hyperlink` and `hideLinkEmbed` ([#4](https://github.com/discordjs/builders/issues/4)) ([c532daf](https://github.com/discordjs/builders/commit/c532daf2ba2feae75bf9668f63462e96a5314cff))
+
+# [0.1.1](https://github.com/discordjs/builders/compare/v0.1.0...v0.1.1) (2021-06-30)
+
+## Bug Fixes
+
+- **Deps:** added `tslib` as dependency ([#2](https://github.com/discordjs/builders/issues/2)) ([5576ff3](https://github.com/discordjs/builders/commit/5576ff3b67136b957bed0ab8a4c655d5de322813))
+
+# 0.1.0 (2021-06-30)
+
+## Features
+
+- added message formatters ([#1](https://github.com/discordjs/builders/issues/1)) ([765e46d](https://github.com/discordjs/builders/commit/765e46dac96c4e49d350243e5fad34c2bc738a7c))

package/README.md

@@ -8,14 +8,14 @@
 		<a href="https://discord.gg/djs"><img src="https://img.shields.io/discord/222078108977594368?color=5865F2&logo=discord&logoColor=white" alt="Discord server" /></a>
 		<a href="https://www.npmjs.com/package/@discordjs/builders"><img src="https://img.shields.io/npm/v/@discordjs/builders.svg?maxAge=3600" alt="npm version" /></a>
 		<a href="https://www.npmjs.com/package/@discordjs/builders"><img src="https://img.shields.io/npm/dt/@discordjs/builders.svg?maxAge=3600" alt="npm downloads" /></a>
-		<a href="https://github.com/discordjs/builders/actions"><img src="https://github.com/discordjs/builders/workflows/Tests/badge.svg" alt="Build status" /></a>
+		<a href="https://github.com/discordjs/discord.js/actions"><img src="https://github.com/discordjs/discord.js/actions/workflows/test.yml/badge.svg" alt="Build status" /></a>
 		<a href="https://codecov.io/gh/discordjs/builders"><img src="https://codecov.io/gh/discordjs/builders/branch/main/graph/badge.svg" alt="Code coverage" /></a>
 	</p>
 </div>
 
 ## Installation
 
-**Node.js 16.6.0 or newer is required.**
+**Node.js 16.9.0 or newer is required.**
 
 ```sh-session
 npm install @discordjs/builders
@@ -37,7 +37,7 @@ Here are some examples for the builders and utilities you can find in this packa
   See also the [Update Guide](https://discordjs.guide/additional-info/changes-in-v13.html), including updated and removed items in the library.
 - [discord.js Discord server](https://discord.gg/djs)
 - [Discord API Discord server](https://discord.gg/discord-api)
-- [GitHub](https://github.com/discordjs/builders)
+- [GitHub](https://github.com/discordjs/discord.js/tree/main/packages/builders)
 - [npm](https://www.npmjs.com/package/@discordjs/builders)
 - [Related libraries](https://discord.com/developers/docs/topics/community-resources#libraries)
 
@@ -45,7 +45,7 @@ Here are some examples for the builders and utilities you can find in this packa
 
 Before creating an issue, please ensure that it hasn't already been reported/suggested, and double-check the
 [documentation](https://discord.js.org/#/docs/builders).  
-See [the contribution guide](https://github.com/discordjs/builders/blob/main/.github/CONTRIBUTING.md) if you'd like to submit a PR.
+See [the contribution guide](https://github.com/discordjs/discord.js/blob/main/.github/CONTRIBUTING.md) if you'd like to submit a PR.
 
 ## Help
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { APIEmbedField, APIEmbed, APIEmbedThumbnail, APIEmbedImage, APIEmbedVideo, APIEmbedAuthor, APIEmbedProvider, APIEmbedFooter, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandBooleanOption, ChannelType, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, RESTPostAPIApplicationCommandsJSONBody, APIApplicationCommandOption, ApplicationCommandType } from 'discord-api-types/v9';
+import { APIEmbedField, APIEmbed, APIEmbedThumbnail, APIEmbedImage, APIEmbedVideo, APIEmbedAuthor, APIEmbedProvider, APIEmbedFooter, APIMessageComponentEmoji, APISelectMenuOption, ButtonStyle, ComponentType, APIMessageComponent, APIActionRowComponent, APIButtonComponent, APISelectMenuComponent, ApplicationCommandOptionType, APIApplicationCommandBasicOption, APIApplicationCommandBooleanOption, ChannelType, APIApplicationCommandChannelOption, APIApplicationCommandOptionChoice, APIApplicationCommandIntegerOption, APIApplicationCommandMentionableOption, APIApplicationCommandNumberOption, APIApplicationCommandRoleOption, APIApplicationCommandStringOption, APIApplicationCommandUserOption, APIApplicationCommandSubcommandGroupOption, APIApplicationCommandSubcommandOption, RESTPostAPIApplicationCommandsJSONBody, APIApplicationCommandOption, ApplicationCommandType } from 'discord-api-types/v9';
 import { z } from 'zod';
 import { Snowflake } from 'discord-api-types/globals';
 import { URL } from 'url';
@@ -42,36 +42,36 @@ declare const footerTextPredicate: z.ZodNullable<z.ZodString>;
 declare const timestampPredicate: z.ZodNullable<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
 declare const titlePredicate: z.ZodNullable<z.ZodString>;
 
-declare const Assertions$2_fieldNamePredicate: typeof fieldNamePredicate;
-declare const Assertions$2_fieldValuePredicate: typeof fieldValuePredicate;
-declare const Assertions$2_fieldInlinePredicate: typeof fieldInlinePredicate;
-declare const Assertions$2_embedFieldPredicate: typeof embedFieldPredicate;
-declare const Assertions$2_embedFieldsArrayPredicate: typeof embedFieldsArrayPredicate;
-declare const Assertions$2_fieldLengthPredicate: typeof fieldLengthPredicate;
-declare const Assertions$2_validateFieldLength: typeof validateFieldLength;
-declare const Assertions$2_authorNamePredicate: typeof authorNamePredicate;
-declare const Assertions$2_urlPredicate: typeof urlPredicate;
-declare const Assertions$2_colorPredicate: typeof colorPredicate;
-declare const Assertions$2_descriptionPredicate: typeof descriptionPredicate;
-declare const Assertions$2_footerTextPredicate: typeof footerTextPredicate;
-declare const Assertions$2_timestampPredicate: typeof timestampPredicate;
-declare const Assertions$2_titlePredicate: typeof titlePredicate;
-declare namespace Assertions$2 {
+declare const Assertions$3_fieldNamePredicate: typeof fieldNamePredicate;
+declare const Assertions$3_fieldValuePredicate: typeof fieldValuePredicate;
+declare const Assertions$3_fieldInlinePredicate: typeof fieldInlinePredicate;
+declare const Assertions$3_embedFieldPredicate: typeof embedFieldPredicate;
+declare const Assertions$3_embedFieldsArrayPredicate: typeof embedFieldsArrayPredicate;
+declare const Assertions$3_fieldLengthPredicate: typeof fieldLengthPredicate;
+declare const Assertions$3_validateFieldLength: typeof validateFieldLength;
+declare const Assertions$3_authorNamePredicate: typeof authorNamePredicate;
+declare const Assertions$3_urlPredicate: typeof urlPredicate;
+declare const Assertions$3_colorPredicate: typeof colorPredicate;
+declare const Assertions$3_descriptionPredicate: typeof descriptionPredicate;
+declare const Assertions$3_footerTextPredicate: typeof footerTextPredicate;
+declare const Assertions$3_timestampPredicate: typeof timestampPredicate;
+declare const Assertions$3_titlePredicate: typeof titlePredicate;
+declare namespace Assertions$3 {
   export {
-    Assertions$2_fieldNamePredicate as fieldNamePredicate,
-    Assertions$2_fieldValuePredicate as fieldValuePredicate,
-    Assertions$2_fieldInlinePredicate as fieldInlinePredicate,
-    Assertions$2_embedFieldPredicate as embedFieldPredicate,
-    Assertions$2_embedFieldsArrayPredicate as embedFieldsArrayPredicate,
-    Assertions$2_fieldLengthPredicate as fieldLengthPredicate,
-    Assertions$2_validateFieldLength as validateFieldLength,
-    Assertions$2_authorNamePredicate as authorNamePredicate,
-    Assertions$2_urlPredicate as urlPredicate,
-    Assertions$2_colorPredicate as colorPredicate,
-    Assertions$2_descriptionPredicate as descriptionPredicate,
-    Assertions$2_footerTextPredicate as footerTextPredicate,
-    Assertions$2_timestampPredicate as timestampPredicate,
-    Assertions$2_titlePredicate as titlePredicate,
+    Assertions$3_fieldNamePredicate as fieldNamePredicate,
+    Assertions$3_fieldValuePredicate as fieldValuePredicate,
+    Assertions$3_fieldInlinePredicate as fieldInlinePredicate,
+    Assertions$3_embedFieldPredicate as embedFieldPredicate,
+    Assertions$3_embedFieldsArrayPredicate as embedFieldsArrayPredicate,
+    Assertions$3_fieldLengthPredicate as fieldLengthPredicate,
+    Assertions$3_validateFieldLength as validateFieldLength,
+    Assertions$3_authorNamePredicate as authorNamePredicate,
+    Assertions$3_urlPredicate as urlPredicate,
+    Assertions$3_colorPredicate as colorPredicate,
+    Assertions$3_descriptionPredicate as descriptionPredicate,
+    Assertions$3_footerTextPredicate as footerTextPredicate,
+    Assertions$3_timestampPredicate as timestampPredicate,
+    Assertions$3_titlePredicate as titlePredicate,
   };
 }
 
@@ -448,6 +448,246 @@ declare enum Faces {
     Unflip = "\u252C\u2500\u252C \u30CE( \u309C-\u309C\u30CE)"
 }
 
+/**
+ * Represents an option within a select menu component
+ */
+declare class SelectMenuOption {
+    readonly label: string;
+    readonly value: string;
+    readonly description?: string;
+    readonly emoji?: APIMessageComponentEmoji;
+    readonly default?: boolean;
+    constructor(data?: APISelectMenuOption);
+    /**
+     * Sets the label of this option
+     * @param label The label to show on this option
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the value of this option
+     * @param value The value of this option
+     */
+    setValue(value: string): this;
+    /**
+     * Sets the description of this option.
+     * @param description The description of this option
+     */
+    setDescription(description: string): this;
+    /**
+     * Sets whether this option is selected by default
+     * @param isDefault Whether or not this option is selected by default
+     */
+    setDefault(isDefault: boolean): this;
+    /**
+     * Sets the emoji to display on this button
+     * @param emoji The emoji to display on this button
+     */
+    setEmoji(emoji: APIMessageComponentEmoji): this;
+    toJSON(): APISelectMenuOption;
+}
+
+declare const customIdValidator: z.ZodString;
+declare const emojiValidator: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    animated: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    name?: string | undefined;
+    id?: string | undefined;
+    animated?: boolean | undefined;
+}, {
+    name?: string | undefined;
+    id?: string | undefined;
+    animated?: boolean | undefined;
+}>;
+declare const disabledValidator: z.ZodBoolean;
+declare const buttonLabelValidator: z.ZodString;
+declare const buttonStyleValidator: z.ZodNumber;
+declare const placeholderValidator: z.ZodString;
+declare const minMaxValidator: z.ZodNumber;
+declare const optionsValidator: z.ZodArray<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, "atleastone">;
+declare function validateRequiredSelectMenuParameters(options: SelectMenuOption[], customId?: string): void;
+declare const labelValueValidator: z.ZodString;
+declare const defaultValidator: z.ZodBoolean;
+declare function validateRequiredSelectMenuOptionParameters(label?: string, value?: string): void;
+declare const urlValidator: z.ZodString;
+declare function validateRequiredButtonParameters(style: ButtonStyle, label?: string, emoji?: APIMessageComponentEmoji, customId?: string, url?: string): void;
+
+declare const Assertions$2_customIdValidator: typeof customIdValidator;
+declare const Assertions$2_emojiValidator: typeof emojiValidator;
+declare const Assertions$2_disabledValidator: typeof disabledValidator;
+declare const Assertions$2_buttonLabelValidator: typeof buttonLabelValidator;
+declare const Assertions$2_buttonStyleValidator: typeof buttonStyleValidator;
+declare const Assertions$2_placeholderValidator: typeof placeholderValidator;
+declare const Assertions$2_minMaxValidator: typeof minMaxValidator;
+declare const Assertions$2_optionsValidator: typeof optionsValidator;
+declare const Assertions$2_validateRequiredSelectMenuParameters: typeof validateRequiredSelectMenuParameters;
+declare const Assertions$2_labelValueValidator: typeof labelValueValidator;
+declare const Assertions$2_defaultValidator: typeof defaultValidator;
+declare const Assertions$2_validateRequiredSelectMenuOptionParameters: typeof validateRequiredSelectMenuOptionParameters;
+declare const Assertions$2_urlValidator: typeof urlValidator;
+declare const Assertions$2_validateRequiredButtonParameters: typeof validateRequiredButtonParameters;
+declare namespace Assertions$2 {
+  export {
+    Assertions$2_customIdValidator as customIdValidator,
+    Assertions$2_emojiValidator as emojiValidator,
+    Assertions$2_disabledValidator as disabledValidator,
+    Assertions$2_buttonLabelValidator as buttonLabelValidator,
+    Assertions$2_buttonStyleValidator as buttonStyleValidator,
+    Assertions$2_placeholderValidator as placeholderValidator,
+    Assertions$2_minMaxValidator as minMaxValidator,
+    Assertions$2_optionsValidator as optionsValidator,
+    Assertions$2_validateRequiredSelectMenuParameters as validateRequiredSelectMenuParameters,
+    Assertions$2_labelValueValidator as labelValueValidator,
+    Assertions$2_defaultValidator as defaultValidator,
+    Assertions$2_validateRequiredSelectMenuOptionParameters as validateRequiredSelectMenuOptionParameters,
+    Assertions$2_urlValidator as urlValidator,
+    Assertions$2_validateRequiredButtonParameters as validateRequiredButtonParameters,
+  };
+}
+
+/**
+ * Represents a discord component
+ */
+interface Component {
+    /**
+     * The type of this component
+     */
+    readonly type: ComponentType;
+    /**
+     * Converts this component to an API-compatible JSON object
+     */
+    toJSON: () => APIMessageComponent;
+}
+
+declare type ActionRowComponent = ButtonComponent | SelectMenuComponent;
+/**
+ * Represents an action row component
+ */
+declare class ActionRow<T extends ActionRowComponent> implements Component {
+    readonly components: T[];
+    readonly type = ComponentType.ActionRow;
+    constructor(data?: APIActionRowComponent);
+    /**
+     * Adds components to this action row.
+     * @param components The components to add to this action row.
+     * @returns
+     */
+    addComponents(...components: T[]): this;
+    /**
+     * Sets the components in this action row
+     * @param components The components to set this row to
+     */
+    setComponents(components: T[]): this;
+    toJSON(): APIActionRowComponent;
+}
+
+declare class ButtonComponent implements Component {
+    readonly type: ComponentType.Button;
+    readonly style: ButtonStyle;
+    readonly label?: string;
+    readonly emoji?: APIMessageComponentEmoji;
+    readonly disabled?: boolean;
+    readonly custom_id: string;
+    readonly url: string;
+    constructor(data?: APIButtonComponent);
+    /**
+     * Sets the style of this button
+     * @param style The style of the button
+     */
+    setStyle(style: ButtonStyle): this;
+    /**
+     * Sets the URL for this button
+     * @param url The URL to open when this button is clicked
+     */
+    setURL(url: string): this;
+    /**
+     * Sets the custom Id for this button
+     * @param customId The custom ID to use for this button
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets the emoji to display on this button
+     * @param emoji The emoji to display on this button
+     */
+    setEmoji(emoji: APIMessageComponentEmoji): this;
+    /**
+     * Sets whether this button is disable or not
+     * @param disabled Whether or not to disable this button or not
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Sets the label for this button
+     * @param label The label to display on this button
+     */
+    setLabel(label: string): this;
+    toJSON(): APIButtonComponent;
+}
+
+interface MappedComponentTypes {
+    [ComponentType.ActionRow]: ActionRow<ActionRowComponent>;
+    [ComponentType.Button]: ButtonComponent;
+    [ComponentType.SelectMenu]: SelectMenuComponent;
+}
+/**
+ * Factory for creating components from API data
+ * @param data The api data to transform to a component class
+ */
+declare function createComponent<T extends keyof MappedComponentTypes>(data: APIMessageComponent & {
+    type: T;
+}): MappedComponentTypes[T];
+
+/**
+ * Represents a select menu component
+ */
+declare class SelectMenuComponent implements Component {
+    readonly type: ComponentType.SelectMenu;
+    readonly options: SelectMenuOption[];
+    readonly placeholder?: string;
+    readonly min_values?: number;
+    readonly max_values?: number;
+    readonly custom_id: string;
+    readonly disabled?: boolean;
+    constructor(data?: APISelectMenuComponent);
+    /**
+     * Sets the placeholder for this select menu
+     * @param placeholder The placeholder to use for this select menu
+     */
+    setPlaceholder(placeholder: string): this;
+    /**
+     * Sets thes minimum values that must be selected in the select menu
+     * @param minValues The minimum values that must be selected
+     */
+    setMinValues(minValues: number): this;
+    /**
+     * Sets thes maximum values that must be selected in the select menu
+     * @param minValues The maximum values that must be selected
+     */
+    setMaxValues(maxValues: number): this;
+    /**
+     * Sets the custom Id for this select menu
+     * @param customId The custom ID to use for this select menu
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets whether or not this select menu is disabled
+     * @param disabled Whether or not this select menu is disabled
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Adds options to this select menu
+     * @param options The options to add to this select menu
+     * @returns
+     */
+    addOptions(...options: SelectMenuOption[]): this;
+    /**
+     * Sets the options on this select menu
+     * @param options The options to set on this select menu
+     */
+    setOptions(options: SelectMenuOption[]): this;
+    toJSON(): APISelectMenuComponent;
+}
+
 declare class SharedNameAndDescription {
     readonly name: string;
     readonly description: string;
@@ -467,7 +707,7 @@ declare class SharedNameAndDescription {
 
 declare abstract class ApplicationCommandOptionBase extends SharedNameAndDescription {
     abstract readonly type: ApplicationCommandOptionType;
-    readonly required = false;
+    readonly required: boolean;
     /**
      * Marks the option as required
      *
@@ -509,8 +749,8 @@ interface SlashCommandChannelOption extends ApplicationCommandOptionChannelTypes
 }
 
 declare abstract class ApplicationCommandNumericOptionMinMaxValueMixin {
-    protected readonly maxValue?: number;
-    protected readonly minValue?: number;
+    readonly max_value?: number;
+    readonly min_value?: number;
     /**
      * Sets the maximum number value of this option
      * @param max The maximum value this option can be
@@ -644,7 +884,7 @@ declare class SharedSlashCommandOptions<ShouldOmitSubcommandFunctions = true> {
 /**
  * Represents a folder for subcommands
  *
- * For more information, go to https://discord.com/developers/docs/interactions/slash-commands#subcommands-and-subcommand-groups
+ * For more information, go to https://discord.com/developers/docs/interactions/application-commands#subcommands-and-subcommand-groups
  */
 declare class SlashCommandSubcommandGroupBuilder implements ToAPIApplicationCommandOptions {
     /**
@@ -672,7 +912,7 @@ interface SlashCommandSubcommandGroupBuilder extends SharedNameAndDescription {
 /**
  * Represents a subcommand
  *
- * For more information, go to https://discord.com/developers/docs/interactions/slash-commands#subcommands-and-subcommand-groups
+ * For more information, go to https://discord.com/developers/docs/interactions/application-commands#subcommands-and-subcommand-groups
  */
 declare class SlashCommandSubcommandBuilder implements ToAPIApplicationCommandOptions {
     /**
@@ -747,31 +987,31 @@ interface SlashCommandSubcommandsOnlyBuilder extends SharedNameAndDescription, P
 interface SlashCommandOptionsOnlyBuilder extends SharedNameAndDescription, SharedSlashCommandOptions, Pick<SlashCommandBuilder, 'toJSON'> {
 }
 interface ToAPIApplicationCommandOptions {
-    toJSON(): APIApplicationCommandOption;
+    toJSON: () => APIApplicationCommandOption;
 }
 
-declare function validateRequiredParameters$1(name: string, description: string, options: ToAPIApplicationCommandOptions[]): void;
 declare function validateName$1(name: unknown): asserts name is string;
 declare function validateDescription(description: unknown): asserts description is string;
+declare function validateMaxOptionsLength(options: unknown): asserts options is ToAPIApplicationCommandOptions[];
+declare function validateRequiredParameters$1(name: string, description: string, options: ToAPIApplicationCommandOptions[]): void;
 declare function validateDefaultPermission$1(value: unknown): asserts value is boolean;
 declare function validateRequired(required: unknown): asserts required is boolean;
-declare function validateMaxOptionsLength(options: unknown): asserts options is ToAPIApplicationCommandOptions[];
 declare function validateMaxChoicesLength(choices: APIApplicationCommandOptionChoice[]): void;
 declare function assertReturnOfBuilder<T extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => T): asserts input is T;
 
 declare const Assertions$1_validateDescription: typeof validateDescription;
-declare const Assertions$1_validateRequired: typeof validateRequired;
 declare const Assertions$1_validateMaxOptionsLength: typeof validateMaxOptionsLength;
+declare const Assertions$1_validateRequired: typeof validateRequired;
 declare const Assertions$1_validateMaxChoicesLength: typeof validateMaxChoicesLength;
 declare const Assertions$1_assertReturnOfBuilder: typeof assertReturnOfBuilder;
 declare namespace Assertions$1 {
   export {
-    validateRequiredParameters$1 as validateRequiredParameters,
     validateName$1 as validateName,
     Assertions$1_validateDescription as validateDescription,
+    Assertions$1_validateMaxOptionsLength as validateMaxOptionsLength,
+    validateRequiredParameters$1 as validateRequiredParameters,
     validateDefaultPermission$1 as validateDefaultPermission,
     Assertions$1_validateRequired as validateRequired,
-    Assertions$1_validateMaxOptionsLength as validateMaxOptionsLength,
     Assertions$1_validateMaxChoicesLength as validateMaxChoicesLength,
     Assertions$1_assertReturnOfBuilder as assertReturnOfBuilder,
   };
@@ -823,22 +1063,22 @@ declare class ContextMenuCommandBuilder {
 }
 declare type ContextMenuCommandType = ApplicationCommandType.User | ApplicationCommandType.Message;
 
-declare function validateRequiredParameters(name: string, type: number): void;
+declare function validateDefaultPermission(value: unknown): asserts value is boolean;
 declare function validateName(name: unknown): asserts name is string;
 declare function validateType(type: unknown): asserts type is ContextMenuCommandType;
-declare function validateDefaultPermission(value: unknown): asserts value is boolean;
+declare function validateRequiredParameters(name: string, type: number): void;
 
-declare const Assertions_validateRequiredParameters: typeof validateRequiredParameters;
+declare const Assertions_validateDefaultPermission: typeof validateDefaultPermission;
 declare const Assertions_validateName: typeof validateName;
 declare const Assertions_validateType: typeof validateType;
-declare const Assertions_validateDefaultPermission: typeof validateDefaultPermission;
+declare const Assertions_validateRequiredParameters: typeof validateRequiredParameters;
 declare namespace Assertions {
   export {
-    Assertions_validateRequiredParameters as validateRequiredParameters,
+    Assertions_validateDefaultPermission as validateDefaultPermission,
     Assertions_validateName as validateName,
     Assertions_validateType as validateType,
-    Assertions_validateDefaultPermission as validateDefaultPermission,
+    Assertions_validateRequiredParameters as validateRequiredParameters,
   };
 }
 
-export { AuthorOptions, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, ContextMenuCommandType, Embed, Assertions$2 as EmbedAssertions, Faces, FooterOptions, Assertions$1 as SlashCommandAssertions, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, TimestampStyles, TimestampStylesString, ToAPIApplicationCommandOptions, blockQuote, bold, channelMention, codeBlock, formatEmoji, hideLinkEmbed, hyperlink, inlineCode, italic, memberNicknameMention, quote, roleMention, spoiler, strikethrough, time, underscore, userMention };
+export { ActionRow, ActionRowComponent, AuthorOptions, ButtonComponent, Component, Assertions$2 as ComponentAssertions, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, ContextMenuCommandType, Embed, Assertions$3 as EmbedAssertions, Faces, FooterOptions, MappedComponentTypes, SelectMenuComponent, SelectMenuOption, Assertions$1 as SlashCommandAssertions, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, TimestampStyles, TimestampStylesString, ToAPIApplicationCommandOptions, blockQuote, bold, channelMention, codeBlock, createComponent, formatEmoji, hideLinkEmbed, hyperlink, inlineCode, italic, memberNicknameMention, quote, roleMention, spoiler, strikethrough, time, underscore, userMention };