@discordjs/builders 1.13.0 → 1.13.1

package/dist/index.js

@@ -38,8 +38,8 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
   ActionRowBuilder: () => ActionRowBuilder,
   ApplicationCommandNumericOptionMinMaxValueMixin: () => ApplicationCommandNumericOptionMinMaxValueMixin,
   ApplicationCommandOptionBase: () => ApplicationCommandOptionBase,
@@ -51,24 +51,25 @@ __export(src_exports, {
   ChannelSelectMenuBuilder: () => ChannelSelectMenuBuilder,
   ComponentAssertions: () => Assertions_exports2,
   ComponentBuilder: () => ComponentBuilder,
-  ComponentsV2Assertions: () => Assertions_exports6,
+  ComponentsV2Assertions: () => Assertions_exports7,
   ContainerBuilder: () => ContainerBuilder,
-  ContextMenuCommandAssertions: () => Assertions_exports9,
+  ContextMenuCommandAssertions: () => Assertions_exports10,
   ContextMenuCommandBuilder: () => ContextMenuCommandBuilder,
   EmbedAssertions: () => Assertions_exports,
   EmbedBuilder: () => EmbedBuilder,
   FileBuilder: () => FileBuilder,
   FileUploadAssertions: () => Assertions_exports3,
   FileUploadBuilder: () => FileUploadBuilder,
-  LabelAssertions: () => Assertions_exports5,
+  LabelAssertions: () => Assertions_exports6,
   LabelBuilder: () => LabelBuilder,
   MediaGalleryBuilder: () => MediaGalleryBuilder,
   MediaGalleryItemBuilder: () => MediaGalleryItemBuilder,
   MentionableSelectMenuBuilder: () => MentionableSelectMenuBuilder,
-  ModalAssertions: () => Assertions_exports7,
+  ModalAssertions: () => Assertions_exports8,
   ModalBuilder: () => ModalBuilder,
   RoleSelectMenuBuilder: () => RoleSelectMenuBuilder,
   SectionBuilder: () => SectionBuilder,
+  SelectMenuAssertions: () => Assertions_exports5,
   SelectMenuBuilder: () => StringSelectMenuBuilder,
   SelectMenuOptionBuilder: () => StringSelectMenuOptionBuilder,
   SeparatorBuilder: () => SeparatorBuilder,
@@ -76,7 +77,7 @@ __export(src_exports, {
   SharedSlashCommand: () => SharedSlashCommand,
   SharedSlashCommandOptions: () => SharedSlashCommandOptions,
   SharedSlashCommandSubcommands: () => SharedSlashCommandSubcommands,
-  SlashCommandAssertions: () => Assertions_exports8,
+  SlashCommandAssertions: () => Assertions_exports9,
   SlashCommandAttachmentOption: () => SlashCommandAttachmentOption,
   SlashCommandBooleanOption: () => SlashCommandBooleanOption,
   SlashCommandBuilder: () => SlashCommandBuilder,
@@ -105,7 +106,7 @@ __export(src_exports, {
   resolveBuilder: () => resolveBuilder,
   version: () => version
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/messages/embed/Assertions.ts
 var Assertions_exports = {};
@@ -246,7 +247,7 @@ var EmbedBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of fields that can be added is 25.
    *
    * It's useful for modifying and adjusting order of the already-existing fields of an embed.
@@ -407,7 +408,7 @@ var EmbedBuilder = class {
 };
 
 // src/index.ts
-__reExport(src_exports, require("@discordjs/formatters"), module.exports);
+__reExport(index_exports, require("@discordjs/formatters"), module.exports);
 
 // src/components/Assertions.ts
 var Assertions_exports2 = {};
@@ -832,7 +833,7 @@ var FileUploadBuilder = class extends ComponentBuilder {
   /**
    * Sets the maximum number of file uploads required.
    *
-   * @param maxValues - The maximum values that must be uploaded
+   * @param maxValues - The maximum values that can be uploaded
    */
   setMaxValues(maxValues) {
     this.data.max_values = maxValues;
@@ -932,9 +933,9 @@ var BaseSelectMenuBuilder = class extends ComponentBuilder {
     return this;
   }
   /**
-   * Sets the maximum values that must be selected in the select menu.
+   * Sets the maximum values that can be selected in the select menu.
    *
-   * @param maxValues - The maximum values that must be selected
+   * @param maxValues - The maximum values that can be selected
    */
   setMaxValues(maxValues) {
     this.data.max_values = minMaxValidator.parse(maxValues);
@@ -1229,7 +1230,71 @@ var RoleSelectMenuBuilder = class extends BaseSelectMenuBuilder {
 };
 
 // src/components/selectMenu/StringSelectMenu.ts
+var import_v1010 = require("discord-api-types/v10");
+
+// src/components/selectMenu/Assertions.ts
+var Assertions_exports5 = {};
+__export(Assertions_exports5, {
+  selectMenuChannelPredicate: () => selectMenuChannelPredicate,
+  selectMenuMentionablePredicate: () => selectMenuMentionablePredicate,
+  selectMenuRolePredicate: () => selectMenuRolePredicate,
+  selectMenuStringOptionPredicate: () => selectMenuStringOptionPredicate,
+  selectMenuStringPredicate: () => selectMenuStringPredicate,
+  selectMenuUserPredicate: () => selectMenuUserPredicate
+});
+var import_shapeshift5 = require("@sapphire/shapeshift");
 var import_v109 = require("discord-api-types/v10");
+var selectMenuBasePredicate = import_shapeshift5.s.object({
+  id: idValidator.optional(),
+  placeholder: import_shapeshift5.s.string().lengthLessThanOrEqual(150).optional(),
+  min_values: import_shapeshift5.s.number().greaterThanOrEqual(0).lessThanOrEqual(25).optional(),
+  max_values: import_shapeshift5.s.number().greaterThanOrEqual(0).lessThanOrEqual(25).optional(),
+  custom_id: customIdValidator,
+  disabled: import_shapeshift5.s.boolean().optional()
+});
+var selectMenuChannelPredicate = selectMenuBasePredicate.extend({
+  type: import_shapeshift5.s.literal(import_v109.ComponentType.ChannelSelect),
+  channel_types: import_shapeshift5.s.nativeEnum(import_v109.ChannelType).array().optional(),
+  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v109.SelectMenuDefaultValueType.Channel) }).array().lengthLessThanOrEqual(25).optional()
+}).setValidationEnabled(isValidationEnabled);
+var selectMenuMentionablePredicate = selectMenuBasePredicate.extend({
+  type: import_shapeshift5.s.literal(import_v109.ComponentType.MentionableSelect),
+  default_values: import_shapeshift5.s.object({
+    id: import_shapeshift5.s.string(),
+    type: import_shapeshift5.s.union([import_shapeshift5.s.literal(import_v109.SelectMenuDefaultValueType.Role), import_shapeshift5.s.literal(import_v109.SelectMenuDefaultValueType.User)])
+  }).array().lengthLessThanOrEqual(25).optional()
+}).setValidationEnabled(isValidationEnabled);
+var selectMenuRolePredicate = selectMenuBasePredicate.extend({
+  type: import_shapeshift5.s.literal(import_v109.ComponentType.RoleSelect),
+  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v109.SelectMenuDefaultValueType.Role) }).array().lengthLessThanOrEqual(25).optional()
+}).setValidationEnabled(isValidationEnabled);
+var selectMenuUserPredicate = selectMenuBasePredicate.extend({
+  type: import_shapeshift5.s.literal(import_v109.ComponentType.UserSelect),
+  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v109.SelectMenuDefaultValueType.User) }).array().lengthLessThanOrEqual(25).optional()
+}).setValidationEnabled(isValidationEnabled);
+var selectMenuStringOptionPredicate = import_shapeshift5.s.object({
+  label: import_shapeshift5.s.string().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100),
+  value: import_shapeshift5.s.string().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100),
+  description: import_shapeshift5.s.string().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100).optional(),
+  emoji: emojiValidator.optional(),
+  default: import_shapeshift5.s.boolean().optional()
+}).setValidationEnabled(isValidationEnabled);
+var selectMenuStringPredicate = selectMenuBasePredicate.extend({
+  type: import_shapeshift5.s.literal(import_v109.ComponentType.StringSelect),
+  options: selectMenuStringOptionPredicate.array().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(25)
+}).reshape((value) => {
+  if (value.min_values !== void 0 && value.options.length < value.min_values) {
+    return import_shapeshift5.Result.err(new RangeError(`The number of options must be greater than or equal to min_values`));
+  }
+  if (value.min_values !== void 0 && value.max_values !== void 0 && value.min_values > value.max_values) {
+    return import_shapeshift5.Result.err(
+      new RangeError(`The maximum amount of options must be greater than or equal to the minimum amount of options`)
+    );
+  }
+  return import_shapeshift5.Result.ok(value);
+}).setValidationEnabled(isValidationEnabled);
+
+// src/components/selectMenu/StringSelectMenu.ts
 var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   static {
     __name(this, "StringSelectMenuBuilder");
@@ -1271,7 +1336,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
    */
   constructor(data) {
     const { options, ...initData } = data ?? {};
-    super({ ...initData, type: import_v109.ComponentType.StringSelect });
+    super({ ...initData, type: import_v1010.ComponentType.StringSelect });
     this.options = options?.map((option) => new StringSelectMenuOptionBuilder(option)) ?? [];
   }
   /**
@@ -1284,7 +1349,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
     optionsLengthValidator.parse(this.options.length + normalizedOptions.length);
     this.options.push(
       ...normalizedOptions.map(
-        (normalizedOption) => normalizedOption instanceof StringSelectMenuOptionBuilder ? normalizedOption : new StringSelectMenuOptionBuilder(jsonOptionValidator.parse(normalizedOption))
+        (normalizedOption) => normalizedOption instanceof StringSelectMenuOptionBuilder ? normalizedOption : new StringSelectMenuOptionBuilder(selectMenuStringOptionPredicate.parse(normalizedOption))
       )
     );
     return this;
@@ -1331,7 +1396,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
       index,
       deleteCount,
       ...normalizedOptions.map(
-        (normalizedOption) => normalizedOption instanceof StringSelectMenuOptionBuilder ? normalizedOption : new StringSelectMenuOptionBuilder(jsonOptionValidator.parse(normalizedOption))
+        (normalizedOption) => normalizedOption instanceof StringSelectMenuOptionBuilder ? normalizedOption : new StringSelectMenuOptionBuilder(selectMenuStringOptionPredicate.parse(normalizedOption))
       )
     );
     optionsLengthValidator.parse(clone.length);
@@ -1351,7 +1416,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
 };
 
 // src/components/selectMenu/UserSelectMenu.ts
-var import_v1010 = require("discord-api-types/v10");
+var import_v1011 = require("discord-api-types/v10");
 var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   static {
     __name(this, "UserSelectMenuBuilder");
@@ -1379,7 +1444,7 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
    * ```
    */
   constructor(data) {
-    super({ ...data, type: import_v1010.ComponentType.UserSelect });
+    super({ ...data, type: import_v1011.ComponentType.UserSelect });
   }
   /**
    * Adds default users to this auto populated select menu.
@@ -1393,7 +1458,7 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
     this.data.default_values.push(
       ...normalizedValues.map((id) => ({
         id,
-        type: import_v1010.SelectMenuDefaultValueType.User
+        type: import_v1011.SelectMenuDefaultValueType.User
       }))
     );
     return this;
@@ -1408,7 +1473,7 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
     optionsLengthValidator.parse(normalizedValues.length);
     this.data.default_values = normalizedValues.map((id) => ({
       id,
-      type: import_v1010.SelectMenuDefaultValueType.User
+      type: import_v1011.SelectMenuDefaultValueType.User
     }));
     return this;
   }
@@ -1416,7 +1481,7 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
 
 // src/components/textInput/TextInput.ts
 var import_util = require("@discordjs/util");
-var import_v1011 = require("discord-api-types/v10");
+var import_v1012 = require("discord-api-types/v10");
 var import_fast_deep_equal = __toESM(require("fast-deep-equal"));
 var TextInputBuilder = class extends ComponentBuilder {
   static {
@@ -1446,7 +1511,7 @@ var TextInputBuilder = class extends ComponentBuilder {
    * ```
    */
   constructor(data) {
-    super({ type: import_v1011.ComponentType.TextInput, ...data });
+    super({ type: import_v1012.ComponentType.TextInput, ...data });
   }
   /**
    * Sets the custom id for this text input.
@@ -1542,67 +1607,12 @@ var TextInputBuilder = class extends ComponentBuilder {
 };
 
 // src/components/label/Assertions.ts
-var Assertions_exports5 = {};
-__export(Assertions_exports5, {
+var Assertions_exports6 = {};
+__export(Assertions_exports6, {
   labelPredicate: () => labelPredicate
 });
 var import_shapeshift6 = require("@sapphire/shapeshift");
 var import_v1013 = require("discord-api-types/v10");
-
-// src/components/selectMenu/Assertions.ts
-var import_shapeshift5 = require("@sapphire/shapeshift");
-var import_v1012 = require("discord-api-types/v10");
-var selectMenuBasePredicate = import_shapeshift5.s.object({
-  id: idValidator.optional(),
-  placeholder: import_shapeshift5.s.string().lengthLessThanOrEqual(150).optional(),
-  min_values: import_shapeshift5.s.number().greaterThanOrEqual(0).lessThanOrEqual(25).optional(),
-  max_values: import_shapeshift5.s.number().greaterThanOrEqual(0).lessThanOrEqual(25).optional(),
-  custom_id: customIdValidator,
-  disabled: import_shapeshift5.s.boolean().optional()
-});
-var selectMenuChannelPredicate = selectMenuBasePredicate.extend({
-  type: import_shapeshift5.s.literal(import_v1012.ComponentType.ChannelSelect),
-  channel_types: import_shapeshift5.s.nativeEnum(import_v1012.ChannelType).array().optional(),
-  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v1012.SelectMenuDefaultValueType.Channel) }).array().lengthLessThanOrEqual(25).optional()
-}).setValidationEnabled(isValidationEnabled);
-var selectMenuMentionablePredicate = selectMenuBasePredicate.extend({
-  type: import_shapeshift5.s.literal(import_v1012.ComponentType.MentionableSelect),
-  default_values: import_shapeshift5.s.object({
-    id: import_shapeshift5.s.string(),
-    type: import_shapeshift5.s.union([import_shapeshift5.s.literal(import_v1012.SelectMenuDefaultValueType.Role), import_shapeshift5.s.literal(import_v1012.SelectMenuDefaultValueType.User)])
-  }).array().lengthLessThanOrEqual(25).optional()
-}).setValidationEnabled(isValidationEnabled);
-var selectMenuRolePredicate = selectMenuBasePredicate.extend({
-  type: import_shapeshift5.s.literal(import_v1012.ComponentType.RoleSelect),
-  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v1012.SelectMenuDefaultValueType.Role) }).array().lengthLessThanOrEqual(25).optional()
-}).setValidationEnabled(isValidationEnabled);
-var selectMenuUserPredicate = selectMenuBasePredicate.extend({
-  type: import_shapeshift5.s.literal(import_v1012.ComponentType.UserSelect),
-  default_values: import_shapeshift5.s.object({ id: import_shapeshift5.s.string(), type: import_shapeshift5.s.literal(import_v1012.SelectMenuDefaultValueType.User) }).array().lengthLessThanOrEqual(25).optional()
-}).setValidationEnabled(isValidationEnabled);
-var selectMenuStringOptionPredicate = import_shapeshift5.s.object({
-  label: labelValidator,
-  value: import_shapeshift5.s.string().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100),
-  description: import_shapeshift5.s.string().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100).optional(),
-  emoji: emojiValidator.optional(),
-  default: import_shapeshift5.s.boolean().optional()
-}).setValidationEnabled(isValidationEnabled);
-var selectMenuStringPredicate = selectMenuBasePredicate.extend({
-  type: import_shapeshift5.s.literal(import_v1012.ComponentType.StringSelect),
-  options: selectMenuStringOptionPredicate.array().lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(25)
-}).reshape((value) => {
-  if (value.min_values !== void 0 && value.options.length < value.min_values) {
-    return import_shapeshift5.Result.err(new RangeError(`The number of options must be greater than or equal to min_values`));
-  }
-  if (value.min_values !== void 0 && value.max_values !== void 0 && value.min_values > value.max_values) {
-    return import_shapeshift5.Result.err(
-      new RangeError(`The maximum amount of options must be greater than or equal to the minimum amount of options`)
-    );
-  }
-  return import_shapeshift5.Result.ok(value);
-}).setValidationEnabled(isValidationEnabled);
-
-// src/components/label/Assertions.ts
 var labelPredicate = import_shapeshift6.s.object({
   id: idValidator.optional(),
   type: import_shapeshift6.s.literal(import_v1013.ComponentType.Label),
@@ -1765,8 +1775,8 @@ var LabelBuilder = class extends ComponentBuilder {
 var import_v1020 = require("discord-api-types/v10");
 
 // src/components/v2/Assertions.ts
-var Assertions_exports6 = {};
-__export(Assertions_exports6, {
+var Assertions_exports7 = {};
+__export(Assertions_exports7, {
   accessoryPredicate: () => accessoryPredicate,
   assertReturnOfBuilder: () => assertReturnOfBuilder,
   containerColorPredicate: () => containerColorPredicate,
@@ -2102,7 +2112,8 @@ var ContainerBuilder = class extends ComponentBuilder {
    * 		},
    * 	],
    * })
-   * 	.addComponents(separator, section);
+   *  .addSeparatorComponents(separator)
+   *  .addSectionComponents(section);
    * ```
    */
   constructor({ components, ...data } = {}) {
@@ -2667,8 +2678,8 @@ var ActionRowBuilder = class extends ComponentBuilder {
 var import_v1025 = require("discord-api-types/v10");
 
 // src/interactions/modals/Assertions.ts
-var Assertions_exports7 = {};
-__export(Assertions_exports7, {
+var Assertions_exports8 = {};
+__export(Assertions_exports8, {
   componentsValidator: () => componentsValidator,
   titleValidator: () => titleValidator,
   validateRequiredParameters: () => validateRequiredParameters2
@@ -2860,8 +2871,8 @@ var ModalBuilder = class {
 };
 
 // src/interactions/slashCommands/Assertions.ts
-var Assertions_exports8 = {};
-__export(Assertions_exports8, {
+var Assertions_exports9 = {};
+__export(Assertions_exports9, {
   assertReturnOfBuilder: () => assertReturnOfBuilder2,
   contextsPredicate: () => contextsPredicate,
   integrationTypesPredicate: () => integrationTypesPredicate,
@@ -3913,8 +3924,8 @@ SlashCommandBuilder = __decorateClass([
 ], SlashCommandBuilder);
 
 // src/interactions/contextMenuCommands/Assertions.ts
-var Assertions_exports9 = {};
-__export(Assertions_exports9, {
+var Assertions_exports10 = {};
+__export(Assertions_exports10, {
   contextsPredicate: () => contextsPredicate2,
   integrationTypesPredicate: () => integrationTypesPredicate2,
   validateDMPermission: () => validateDMPermission2,
@@ -4145,7 +4156,7 @@ function embedLength(data) {
 __name(embedLength, "embedLength");
 
 // src/index.ts
-var version = "1.13.0";
+var version = "1.13.1";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -4177,6 +4188,7 @@ var version = "1.13.0";
   ModalBuilder,
   RoleSelectMenuBuilder,
   SectionBuilder,
+  SelectMenuAssertions,
   SelectMenuBuilder,
   SelectMenuOptionBuilder,
   SeparatorBuilder,