@discordjs/builders 0.15.0-dev.1654430642-7a1095b → 0.15.0-dev.1654517016-e1176fa

package/dist/index.d.ts

@@ -78,6 +78,9 @@ declare namespace Assertions$5 {
   };
 }
 
+declare function normalizeArray<T>(arr: RestOrArray<T>): T[];
+declare type RestOrArray<T> = T[] | [T[]];
+
 declare type RGBTuple = [red: number, green: number, blue: number];
 interface IconData {
     /**
@@ -110,7 +113,7 @@ declare class UnsafeEmbedBuilder {
      *
      * @param fields The fields to add
      */
-    addFields(fields: APIEmbedField[]): this;
+    addFields(...fields: RestOrArray<APIEmbedField>): this;
     /**
      * Removes, replaces, or inserts fields in the embed (max 25)
      *
@@ -123,7 +126,7 @@ declare class UnsafeEmbedBuilder {
      * Sets the embed's fields (max 25).
      * @param fields The fields to set
      */
-    setFields(fields: APIEmbedField[]): this;
+    setFields(...fields: RestOrArray<APIEmbedField>): this;
     /**
      * Sets the author of this embed
      *
@@ -188,7 +191,7 @@ declare class UnsafeEmbedBuilder {
  * Represents a validated embed in a message (image/video preview, rich embed, etc.)
  */
 declare class EmbedBuilder extends UnsafeEmbedBuilder {
-    addFields(fields: APIEmbedField[]): this;
+    addFields(...fields: RestOrArray<APIEmbedField>): this;
     spliceFields(index: number, deleteCount: number, ...fields: APIEmbedField[]): this;
     setAuthor(options: EmbedAuthorOptions | null): this;
     setColor(color: number | RGBTuple | null): this;
@@ -584,12 +587,12 @@ declare class ActionRowBuilder<T extends AnyComponentBuilder> extends ComponentB
      * @param components The components to add to this action row.
      * @returns
      */
-    addComponents(components: T[]): this;
+    addComponents(...components: RestOrArray<T>): this;
     /**
      * Sets the components in this action row
      * @param components The components to set this row to
      */
-    setComponents(components: T[]): this;
+    setComponents(...components: RestOrArray<T>): this;
     toJSON(): APIActionRowComponent<ReturnType<T['toJSON']>>;
 }
 
@@ -763,12 +766,12 @@ declare class UnsafeModalBuilder implements JSONEncodable<APIModalInteractionRes
      * Adds components to this modal
      * @param components The components to add to this modal
      */
-    addComponents(components: (ActionRowBuilder<ModalActionRowComponentBuilder> | APIActionRowComponent<APIModalActionRowComponent>)[]): this;
+    addComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder> | APIActionRowComponent<APIModalActionRowComponent>>): this;
     /**
      * Sets the components in this modal
      * @param components The components to set this modal to
      */
-    setComponents(components: ActionRowBuilder<ModalActionRowComponentBuilder>[]): this;
+    setComponents(...components: RestOrArray<ActionRowBuilder<ModalActionRowComponentBuilder>>): this;
     toJSON(): APIModalInteractionResponseCallbackData;
 }
 
@@ -831,12 +834,12 @@ declare class UnsafeSelectMenuBuilder extends ComponentBuilder<APISelectMenuComp
      * @param options The options to add to this select menu
      * @returns
      */
-    addOptions(options: (UnsafeSelectMenuOptionBuilder | APISelectMenuOption)[]): this;
+    addOptions(...options: RestOrArray<UnsafeSelectMenuOptionBuilder | APISelectMenuOption>): this;
     /**
      * Sets the options on this select menu
      * @param options The options to set on this select menu
      */
-    setOptions(options: (UnsafeSelectMenuOptionBuilder | APISelectMenuOption)[]): this;
+    setOptions(...options: RestOrArray<UnsafeSelectMenuOptionBuilder | APISelectMenuOption>): this;
     toJSON(): APISelectMenuComponent;
 }
 
@@ -849,8 +852,8 @@ declare class SelectMenuBuilder extends UnsafeSelectMenuBuilder {
     setMaxValues(maxValues: number): this;
     setCustomId(customId: string): this;
     setDisabled(disabled?: boolean): this;
-    addOptions(options: (UnsafeSelectMenuOptionBuilder | APISelectMenuOption)[]): this;
-    setOptions(options: (UnsafeSelectMenuOptionBuilder | APISelectMenuOption)[]): this;
+    addOptions(...options: RestOrArray<UnsafeSelectMenuOptionBuilder | APISelectMenuOption>): this;
+    setOptions(...options: RestOrArray<UnsafeSelectMenuOptionBuilder | APISelectMenuOption>): this;
     toJSON(): APISelectMenuComponent;
 }
 
@@ -1422,4 +1425,4 @@ declare function isEquatable(maybeEquatable: unknown): maybeEquatable is Equatab
 
 declare function embedLength(data: APIEmbed): number;
 
-export { ActionRowBuilder, AnyAPIActionRowComponent, AnyComponentBuilder, ApplicationCommandNumericOptionMinMaxValueMixin, ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, ApplicationCommandOptionChannelTypesMixin, ApplicationCommandOptionWithChoicesAndAutocompleteMixin, ButtonBuilder, Assertions$4 as ComponentAssertions, ComponentBuilder, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, ContextMenuCommandType, Assertions$5 as EmbedAssertions, EmbedAuthorData, EmbedAuthorOptions, EmbedBuilder, EmbedFooterData, EmbedFooterOptions, EmbedImageData, Equatable, Faces, IconData, JSONEncodable, MappedComponentTypes, MessageActionRowComponentBuilder, MessageComponentBuilder, ModalActionRowComponentBuilder, Assertions$2 as ModalAssertions, ModalBuilder, ModalComponentBuilder, RGBTuple, SelectMenuBuilder, SelectMenuOptionBuilder, SharedNameAndDescription, SharedSlashCommandOptions, Assertions$1 as SlashCommandAssertions, SlashCommandAttachmentOption, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, Assertions$3 as TextInputAssertions, TextInputBuilder, TimestampStyles, TimestampStylesString, ToAPIApplicationCommandOptions, UnsafeButtonBuilder, UnsafeEmbedBuilder, UnsafeModalBuilder, UnsafeSelectMenuBuilder, UnsafeSelectMenuOptionBuilder, UnsafeTextInputBuilder, blockQuote, bold, channelMention, codeBlock, createComponentBuilder, embedLength, formatEmoji, hideLinkEmbed, hyperlink, inlineCode, isEquatable, isJSONEncodable, italic, quote, roleMention, spoiler, strikethrough, time, underscore, userMention };
+export { ActionRowBuilder, AnyAPIActionRowComponent, AnyComponentBuilder, ApplicationCommandNumericOptionMinMaxValueMixin, ApplicationCommandOptionAllowedChannelTypes, ApplicationCommandOptionBase, ApplicationCommandOptionChannelTypesMixin, ApplicationCommandOptionWithChoicesAndAutocompleteMixin, ButtonBuilder, Assertions$4 as ComponentAssertions, ComponentBuilder, Assertions as ContextMenuCommandAssertions, ContextMenuCommandBuilder, ContextMenuCommandType, Assertions$5 as EmbedAssertions, EmbedAuthorData, EmbedAuthorOptions, EmbedBuilder, EmbedFooterData, EmbedFooterOptions, EmbedImageData, Equatable, Faces, IconData, JSONEncodable, MappedComponentTypes, MessageActionRowComponentBuilder, MessageComponentBuilder, ModalActionRowComponentBuilder, Assertions$2 as ModalAssertions, ModalBuilder, ModalComponentBuilder, RGBTuple, RestOrArray, SelectMenuBuilder, SelectMenuOptionBuilder, SharedNameAndDescription, SharedSlashCommandOptions, Assertions$1 as SlashCommandAssertions, SlashCommandAttachmentOption, SlashCommandBooleanOption, SlashCommandBuilder, SlashCommandChannelOption, SlashCommandIntegerOption, SlashCommandMentionableOption, SlashCommandNumberOption, SlashCommandOptionsOnlyBuilder, SlashCommandRoleOption, SlashCommandStringOption, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandsOnlyBuilder, SlashCommandUserOption, Assertions$3 as TextInputAssertions, TextInputBuilder, TimestampStyles, TimestampStylesString, ToAPIApplicationCommandOptions, UnsafeButtonBuilder, UnsafeEmbedBuilder, UnsafeModalBuilder, UnsafeSelectMenuBuilder, UnsafeSelectMenuOptionBuilder, UnsafeTextInputBuilder, blockQuote, bold, channelMention, codeBlock, createComponentBuilder, embedLength, formatEmoji, hideLinkEmbed, hyperlink, inlineCode, isEquatable, isJSONEncodable, italic, normalizeArray, quote, roleMention, spoiler, strikethrough, time, underscore, userMention };

package/dist/index.js

@@ -92,6 +92,7 @@ __export(src_exports, {
   isEquatable: () => isEquatable,
   isJSONEncodable: () => isJSONEncodable,
   italic: () => italic,
+  normalizeArray: () => normalizeArray,
   quote: () => quote,
   roleMention: () => roleMention,
   spoiler: () => spoiler,
@@ -162,6 +163,14 @@ var embedFooterPredicate = import_shapeshift.s.object({
 var timestampPredicate = import_shapeshift.s.union(import_shapeshift.s.number, import_shapeshift.s.date).nullable;
 var titlePredicate = fieldNamePredicate.nullable;
 
+// src/util/normalizeArray.ts
+function normalizeArray(arr) {
+  if (Array.isArray(arr[0]))
+    return arr[0];
+  return arr;
+}
+__name(normalizeArray, "normalizeArray");
+
 // src/messages/embed/UnsafeEmbed.ts
 var UnsafeEmbedBuilder = class {
   constructor(data = {}) {
@@ -170,7 +179,8 @@ var UnsafeEmbedBuilder = class {
     if (data.timestamp)
       this.data.timestamp = new Date(data.timestamp).toISOString();
   }
-  addFields(fields) {
+  addFields(...fields) {
+    fields = normalizeArray(fields);
     if (this.data.fields)
       this.data.fields.push(...fields);
     else
@@ -184,8 +194,8 @@ var UnsafeEmbedBuilder = class {
       this.data.fields = fields;
     return this;
   }
-  setFields(fields) {
-    this.spliceFields(0, this.data.fields?.length ?? 0, ...fields);
+  setFields(...fields) {
+    this.spliceFields(0, this.data.fields?.length ?? 0, ...normalizeArray(fields));
     return this;
   }
   setAuthor(options) {
@@ -245,9 +255,10 @@ __name(UnsafeEmbedBuilder, "UnsafeEmbedBuilder");
 
 // src/messages/embed/Embed.ts
 var EmbedBuilder = class extends UnsafeEmbedBuilder {
-  addFields(fields) {
+  addFields(...fields) {
+    fields = normalizeArray(fields);
     validateFieldLength(fields.length, this.data.fields);
-    return super.addFields(embedFieldsArrayPredicate.parse(fields));
+    return super.addFields(...embedFieldsArrayPredicate.parse(fields));
   }
   spliceFields(index, deleteCount, ...fields) {
     validateFieldLength(fields.length - deleteCount, this.data.fields);
@@ -528,12 +539,12 @@ var ActionRowBuilder = class extends ComponentBuilder {
     __publicField(this, "components");
     this.components = components?.map((c) => createComponentBuilder(c)) ?? [];
   }
-  addComponents(components) {
-    this.components.push(...components);
+  addComponents(...components) {
+    this.components.push(...normalizeArray(components));
     return this;
   }
-  setComponents(components) {
-    this.components.splice(0, this.components.length, ...components);
+  setComponents(...components) {
+    this.components.splice(0, this.components.length, ...normalizeArray(components));
     return this;
   }
   toJSON() {
@@ -731,12 +742,12 @@ var UnsafeModalBuilder = class {
     this.data.custom_id = customId;
     return this;
   }
-  addComponents(components) {
-    this.components.push(...components.map((component) => component instanceof ActionRowBuilder ? component : new ActionRowBuilder(component)));
+  addComponents(...components) {
+    this.components.push(...normalizeArray(components).map((component) => component instanceof ActionRowBuilder ? component : new ActionRowBuilder(component)));
     return this;
   }
-  setComponents(components) {
-    this.components.splice(0, this.components.length, ...components);
+  setComponents(...components) {
+    this.components.splice(0, this.components.length, ...normalizeArray(components));
     return this;
   }
   toJSON() {
@@ -809,12 +820,12 @@ var UnsafeSelectMenuBuilder = class extends ComponentBuilder {
     this.data.disabled = disabled;
     return this;
   }
-  addOptions(options) {
-    this.options.push(...options.map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(option)));
+  addOptions(...options) {
+    this.options.push(...normalizeArray(options).map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(option)));
     return this;
   }
-  setOptions(options) {
-    this.options.splice(0, this.options.length, ...options.map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(option)));
+  setOptions(...options) {
+    this.options.splice(0, this.options.length, ...normalizeArray(options).map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(option)));
     return this;
   }
   toJSON() {
@@ -843,12 +854,14 @@ var SelectMenuBuilder = class extends UnsafeSelectMenuBuilder {
   setDisabled(disabled = true) {
     return super.setDisabled(disabledValidator.parse(disabled));
   }
-  addOptions(options) {
+  addOptions(...options) {
+    options = normalizeArray(options);
     optionsLengthValidator.parse(this.options.length + options.length);
     this.options.push(...options.map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(optionValidator.parse(option))));
     return this;
   }
-  setOptions(options) {
+  setOptions(...options) {
+    options = normalizeArray(options);
     optionsLengthValidator.parse(options.length);
     this.options.splice(0, this.options.length, ...options.map((option) => option instanceof UnsafeSelectMenuOptionBuilder ? option : new UnsafeSelectMenuOptionBuilder(optionValidator.parse(option))));
     return this;
@@ -1673,6 +1686,7 @@ __name(embedLength, "embedLength");
   isEquatable,
   isJSONEncodable,
   italic,
+  normalizeArray,
   quote,
   roleMention,
   spoiler,