@discordjs/builders 0.14.0-dev.1651147747-679dcda → 0.14.0-dev.1652400688-aed687b

package/dist/index.d.ts

@@ -1199,6 +1199,39 @@ declare function validateDefaultPermission$1(value: unknown): asserts value is b
 declare function validateRequired(required: unknown): asserts required is boolean;
 declare function validateChoicesLength(amountAdding: number, choices?: APIApplicationCommandOptionChoice[]): void;
 declare function assertReturnOfBuilder<T extends ApplicationCommandOptionBase | SlashCommandSubcommandBuilder | SlashCommandSubcommandGroupBuilder>(input: unknown, ExpectedInstanceOf: new () => T): asserts input is T;
+declare const localizationMapPredicate: _sapphire_shapeshift.UnionValidator<{
+    "en-US": string | null;
+    "en-GB": string | null;
+    bg: string | null;
+    "zh-CN": string | null;
+    "zh-TW": string | null;
+    hr: string | null;
+    cs: string | null;
+    da: string | null;
+    nl: string | null;
+    fi: string | null;
+    fr: string | null;
+    de: string | null;
+    el: string | null;
+    hi: string | null;
+    hu: string | null;
+    it: string | null;
+    ja: string | null;
+    ko: string | null;
+    lt: string | null;
+    no: string | null;
+    pl: string | null;
+    "pt-BR": string | null;
+    ro: string | null;
+    ru: string | null;
+    "es-ES": string | null;
+    "sv-SE": string | null;
+    th: string | null;
+    tr: string | null;
+    uk: string | null;
+    vi: string | null;
+} | null | undefined>;
+declare function validateLocalizationMap(value: unknown): asserts value is LocalizationMap;
 
 declare const Assertions$1_validateDescription: typeof validateDescription;
 declare const Assertions$1_validateLocale: typeof validateLocale;
@@ -1206,6 +1239,8 @@ declare const Assertions$1_validateMaxOptionsLength: typeof validateMaxOptionsLe
 declare const Assertions$1_validateRequired: typeof validateRequired;
 declare const Assertions$1_validateChoicesLength: typeof validateChoicesLength;
 declare const Assertions$1_assertReturnOfBuilder: typeof assertReturnOfBuilder;
+declare const Assertions$1_localizationMapPredicate: typeof localizationMapPredicate;
+declare const Assertions$1_validateLocalizationMap: typeof validateLocalizationMap;
 declare namespace Assertions$1 {
   export {
     validateName$1 as validateName,
@@ -1217,6 +1252,8 @@ declare namespace Assertions$1 {
     Assertions$1_validateRequired as validateRequired,
     Assertions$1_validateChoicesLength as validateChoicesLength,
     Assertions$1_assertReturnOfBuilder as assertReturnOfBuilder,
+    Assertions$1_localizationMapPredicate as localizationMapPredicate,
+    Assertions$1_validateLocalizationMap as validateLocalizationMap,
   };
 }
 
@@ -1225,6 +1262,10 @@ declare class ContextMenuCommandBuilder {
      * The name of this context menu command
      */
     readonly name: string;
+    /**
+     * The localized names for this command
+     */
+    readonly name_localizations?: LocalizationMap;
     /**
      * The type of this context menu command
      */
@@ -1257,6 +1298,19 @@ declare class ContextMenuCommandBuilder {
      * @see https://discord.com/developers/docs/interactions/application-commands#permissions
      */
     setDefaultPermission(value: boolean): this;
+    /**
+     * Sets a name localization
+     *
+     * @param locale The locale to set a description for
+     * @param localizedName The localized description for the given locale
+     */
+    setNameLocalization(locale: LocaleString, localizedName: string | null): this;
+    /**
+     * Sets the name localizations
+     *
+     * @param localizedNames The dictionary of localized descriptions to set
+     */
+    setNameLocalizations(localizedNames: LocalizationMap | null): this;
     /**
      * Returns the final data that should be sent to Discord.
      *

package/dist/index.js

@@ -119,8 +119,8 @@ __export(Assertions_exports, {
   validateFieldLength: () => validateFieldLength
 });
 var import_shapeshift = require("@sapphire/shapeshift");
-var fieldNamePredicate = import_shapeshift.s.string.lengthGe(1).lengthLe(256);
-var fieldValuePredicate = import_shapeshift.s.string.lengthGe(1).lengthLe(1024);
+var fieldNamePredicate = import_shapeshift.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(256);
+var fieldValuePredicate = import_shapeshift.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(1024);
 var fieldInlinePredicate = import_shapeshift.s.boolean.optional;
 var embedFieldPredicate = import_shapeshift.s.object({
   name: fieldNamePredicate,
@@ -128,7 +128,7 @@ var embedFieldPredicate = import_shapeshift.s.object({
   inline: fieldInlinePredicate
 });
 var embedFieldsArrayPredicate = embedFieldPredicate.array;
-var fieldLengthPredicate = import_shapeshift.s.number.le(25);
+var fieldLengthPredicate = import_shapeshift.s.number.lessThanOrEqual(25);
 function validateFieldLength(amountAdding, fields) {
   fieldLengthPredicate.parse((fields?.length ?? 0) + amountAdding);
 }
@@ -145,10 +145,10 @@ var embedAuthorPredicate = import_shapeshift.s.object({
   iconURL: imageURLPredicate,
   url: urlPredicate
 });
-var RGBPredicate = import_shapeshift.s.number.int.ge(0).le(255);
-var colorPredicate = import_shapeshift.s.number.int.ge(0).le(16777215).or(import_shapeshift.s.tuple([RGBPredicate, RGBPredicate, RGBPredicate])).nullable;
-var descriptionPredicate = import_shapeshift.s.string.lengthGe(1).lengthLe(4096).nullable;
-var footerTextPredicate = import_shapeshift.s.string.lengthGe(1).lengthLe(2048).nullable;
+var RGBPredicate = import_shapeshift.s.number.int.greaterThanOrEqual(0).lessThanOrEqual(255);
+var colorPredicate = import_shapeshift.s.number.int.greaterThanOrEqual(0).lessThanOrEqual(16777215).or(import_shapeshift.s.tuple([RGBPredicate, RGBPredicate, RGBPredicate])).nullable;
+var descriptionPredicate = import_shapeshift.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(4096).nullable;
+var footerTextPredicate = import_shapeshift.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(2048).nullable;
 var embedFooterPredicate = import_shapeshift.s.object({
   text: footerTextPredicate,
   iconURL: imageURLPredicate
@@ -429,18 +429,18 @@ var UnsafeSelectMenuOptionBuilder = class {
 __name(UnsafeSelectMenuOptionBuilder, "UnsafeSelectMenuOptionBuilder");
 
 // src/components/Assertions.ts
-var customIdValidator = import_shapeshift2.s.string.lengthGe(1).lengthLe(100);
+var customIdValidator = import_shapeshift2.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100);
 var emojiValidator = import_shapeshift2.s.object({
   id: import_shapeshift2.s.string,
   name: import_shapeshift2.s.string,
   animated: import_shapeshift2.s.boolean
 }).partial.strict;
 var disabledValidator = import_shapeshift2.s.boolean;
-var buttonLabelValidator = import_shapeshift2.s.string.lengthGe(1).lengthLe(80);
+var buttonLabelValidator = import_shapeshift2.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(80);
 var buttonStyleValidator = import_shapeshift2.s.nativeEnum(import_v10.ButtonStyle);
-var placeholderValidator = import_shapeshift2.s.string.lengthLe(150);
-var minMaxValidator = import_shapeshift2.s.number.int.ge(0).le(25);
-var labelValueDescriptionValidator = import_shapeshift2.s.string.lengthGe(1).lengthLe(100);
+var placeholderValidator = import_shapeshift2.s.string.lengthLessThanOrEqual(150);
+var minMaxValidator = import_shapeshift2.s.number.int.greaterThanOrEqual(0).lessThanOrEqual(25);
+var labelValueDescriptionValidator = import_shapeshift2.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100);
 var optionValidator = import_shapeshift2.s.union(import_shapeshift2.s.object({
   label: labelValueDescriptionValidator,
   value: labelValueDescriptionValidator,
@@ -448,14 +448,14 @@ var optionValidator = import_shapeshift2.s.union(import_shapeshift2.s.object({
   emoji: emojiValidator.optional,
   default: import_shapeshift2.s.boolean.optional
 }), import_shapeshift2.s.instance(UnsafeSelectMenuOptionBuilder));
-var optionsValidator = optionValidator.array.lengthGe(0);
-var optionsLengthValidator = import_shapeshift2.s.number.int.ge(0).le(25);
+var optionsValidator = optionValidator.array.lengthGreaterThanOrEqual(0);
+var optionsLengthValidator = import_shapeshift2.s.number.int.greaterThanOrEqual(0).lessThanOrEqual(25);
 function validateRequiredSelectMenuParameters(options, customId) {
   customIdValidator.parse(customId);
   optionsValidator.parse(options);
 }
 __name(validateRequiredSelectMenuParameters, "validateRequiredSelectMenuParameters");
-var labelValueValidator = import_shapeshift2.s.string.lengthGe(1).lengthLe(100);
+var labelValueValidator = import_shapeshift2.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100);
 var defaultValidator = import_shapeshift2.s.boolean;
 function validateRequiredSelectMenuOptionParameters(label, value) {
   labelValueValidator.parse(label);
@@ -619,12 +619,12 @@ __export(Assertions_exports3, {
 var import_shapeshift3 = require("@sapphire/shapeshift");
 var import_v105 = require("discord-api-types/v10");
 var textInputStyleValidator = import_shapeshift3.s.nativeEnum(import_v105.TextInputStyle);
-var minLengthValidator = import_shapeshift3.s.number.int.ge(0).le(4e3);
-var maxLengthValidator = import_shapeshift3.s.number.int.ge(1).le(4e3);
+var minLengthValidator = import_shapeshift3.s.number.int.greaterThanOrEqual(0).lessThanOrEqual(4e3);
+var maxLengthValidator = import_shapeshift3.s.number.int.greaterThanOrEqual(1).lessThanOrEqual(4e3);
 var requiredValidator = import_shapeshift3.s.boolean;
-var valueValidator = import_shapeshift3.s.string.lengthLe(4e3);
-var placeholderValidator2 = import_shapeshift3.s.string.lengthLe(100);
-var labelValidator = import_shapeshift3.s.string.lengthGe(1).lengthLe(45);
+var valueValidator = import_shapeshift3.s.string.lengthLessThanOrEqual(4e3);
+var placeholderValidator2 = import_shapeshift3.s.string.lengthLessThanOrEqual(100);
+var labelValidator = import_shapeshift3.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(45);
 function validateRequiredParameters(customId, style, label) {
   customIdValidator.parse(customId);
   textInputStyleValidator.parse(style);
@@ -750,8 +750,8 @@ __export(Assertions_exports4, {
   validateRequiredParameters: () => validateRequiredParameters2
 });
 var import_shapeshift4 = require("@sapphire/shapeshift");
-var titleValidator = import_shapeshift4.s.string.lengthGe(1).lengthLe(45);
-var componentsValidator = import_shapeshift4.s.instance(ActionRowBuilder).array.lengthGe(1);
+var titleValidator = import_shapeshift4.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(45);
+var componentsValidator = import_shapeshift4.s.instance(ActionRowBuilder).array.lengthGreaterThanOrEqual(1);
 function validateRequiredParameters2(customId, title, components) {
   customIdValidator.parse(customId);
   titleValidator.parse(title);
@@ -876,10 +876,12 @@ __name(SelectMenuOptionBuilder, "SelectMenuOptionBuilder");
 var Assertions_exports5 = {};
 __export(Assertions_exports5, {
   assertReturnOfBuilder: () => assertReturnOfBuilder,
+  localizationMapPredicate: () => localizationMapPredicate,
   validateChoicesLength: () => validateChoicesLength,
   validateDefaultPermission: () => validateDefaultPermission,
   validateDescription: () => validateDescription,
   validateLocale: () => validateLocale,
+  validateLocalizationMap: () => validateLocalizationMap,
   validateMaxOptionsLength: () => validateMaxOptionsLength,
   validateName: () => validateName,
   validateRequired: () => validateRequired,
@@ -888,18 +890,18 @@ __export(Assertions_exports5, {
 var import_shapeshift5 = require("@sapphire/shapeshift");
 var import_is = __toESM(require("@sindresorhus/is"));
 var import_v108 = require("discord-api-types/v10");
-var namePredicate = import_shapeshift5.s.string.lengthGe(1).lengthLe(32).regex(/^[\P{Lu}\p{N}\p{sc=Devanagari}\p{sc=Thai}_-]+$/u);
+var namePredicate = import_shapeshift5.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(32).regex(/^[\P{Lu}\p{N}\p{sc=Devanagari}\p{sc=Thai}_-]+$/u);
 function validateName(name) {
   namePredicate.parse(name);
 }
 __name(validateName, "validateName");
-var descriptionPredicate2 = import_shapeshift5.s.string.lengthGe(1).lengthLe(100);
+var descriptionPredicate2 = import_shapeshift5.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100);
 var localePredicate = import_shapeshift5.s.nativeEnum(import_v108.Locale);
 function validateDescription(description) {
   descriptionPredicate2.parse(description);
 }
 __name(validateDescription, "validateDescription");
-var maxArrayLengthPredicate = import_shapeshift5.s.unknown.array.lengthLe(25);
+var maxArrayLengthPredicate = import_shapeshift5.s.unknown.array.lengthLessThanOrEqual(25);
 function validateLocale(locale) {
   return localePredicate.parse(locale);
 }
@@ -923,7 +925,7 @@ function validateRequired(required) {
   booleanPredicate.parse(required);
 }
 __name(validateRequired, "validateRequired");
-var choicesLengthPredicate = import_shapeshift5.s.number.le(25);
+var choicesLengthPredicate = import_shapeshift5.s.number.lessThanOrEqual(25);
 function validateChoicesLength(amountAdding, choices) {
   choicesLengthPredicate.parse((choices?.length ?? 0) + amountAdding);
 }
@@ -945,6 +947,11 @@ function assertReturnOfBuilder(input, ExpectedInstanceOf) {
   }
 }
 __name(assertReturnOfBuilder, "assertReturnOfBuilder");
+var localizationMapPredicate = import_shapeshift5.s.object(Object.fromEntries(Object.values(import_v108.Locale).map((locale) => [locale, import_shapeshift5.s.string.nullish]))).strict.nullish;
+function validateLocalizationMap(value) {
+  localizationMapPredicate.parse(value);
+}
+__name(validateLocalizationMap, "validateLocalizationMap");
 
 // src/interactions/slashCommands/SlashCommandBuilder.ts
 var import_ts_mixer6 = require("ts-mixer");
@@ -975,12 +982,13 @@ var SharedNameAndDescription = class {
     if (!this.name_localizations) {
       Reflect.set(this, "name_localizations", {});
     }
+    const parsedLocale = validateLocale(locale);
     if (localizedName === null) {
-      this.name_localizations[locale] = null;
+      this.name_localizations[parsedLocale] = null;
       return this;
     }
     validateName(localizedName);
-    this.name_localizations[validateLocale(locale)] = localizedName;
+    this.name_localizations[parsedLocale] = localizedName;
     return this;
   }
   setNameLocalizations(localizedNames) {
@@ -996,12 +1004,13 @@ var SharedNameAndDescription = class {
     if (!this.description_localizations) {
       Reflect.set(this, "description_localizations", {});
     }
+    const parsedLocale = validateLocale(locale);
     if (localizedDescription === null) {
-      this.description_localizations[locale] = null;
+      this.description_localizations[parsedLocale] = null;
       return this;
     }
     validateDescription(localizedDescription);
-    this.description_localizations[validateLocale(locale)] = localizedDescription;
+    this.description_localizations[parsedLocale] = localizedDescription;
     return this;
   }
   setDescriptionLocalizations(localizedDescriptions) {
@@ -1032,6 +1041,8 @@ var ApplicationCommandOptionBase = class extends SharedNameAndDescription {
   }
   runRequiredValidations() {
     validateRequiredParameters3(this.name, this.description, []);
+    validateLocalizationMap(this.name_localizations);
+    validateLocalizationMap(this.description_localizations);
     validateRequired(this.required);
   }
 };
@@ -1129,9 +1140,13 @@ __name(ApplicationCommandNumericOptionMinMaxValueMixin, "ApplicationCommandNumer
 // src/interactions/slashCommands/mixins/ApplicationCommandOptionWithChoicesAndAutocompleteMixin.ts
 var import_shapeshift7 = require("@sapphire/shapeshift");
 var import_v1013 = require("discord-api-types/v10");
-var stringPredicate = import_shapeshift7.s.string.lengthGe(1).lengthLe(100);
-var numberPredicate = import_shapeshift7.s.number.gt(-Infinity).lt(Infinity);
-var choicesPredicate = import_shapeshift7.s.object({ name: stringPredicate, value: import_shapeshift7.s.union(stringPredicate, numberPredicate) }).array;
+var stringPredicate = import_shapeshift7.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(100);
+var numberPredicate = import_shapeshift7.s.number.greaterThan(-Infinity).lessThan(Infinity);
+var choicesPredicate = import_shapeshift7.s.object({
+  name: stringPredicate,
+  name_localizations: localizationMapPredicate,
+  value: import_shapeshift7.s.union(stringPredicate, numberPredicate)
+}).array;
 var booleanPredicate2 = import_shapeshift7.s.boolean;
 var ApplicationCommandOptionWithChoicesAndAutocompleteMixin = class {
   constructor() {
@@ -1148,13 +1163,13 @@ var ApplicationCommandOptionWithChoicesAndAutocompleteMixin = class {
       Reflect.set(this, "choices", []);
     }
     validateChoicesLength(choices.length, this.choices);
-    for (const { name, value } of choices) {
+    for (const { name, name_localizations, value } of choices) {
       if (this.type === import_v1013.ApplicationCommandOptionType.String) {
         stringPredicate.parse(value);
       } else {
         numberPredicate.parse(value);
       }
-      this.choices.push({ name, value });
+      this.choices.push({ name, name_localizations, value });
     }
     return this;
   }
@@ -1367,7 +1382,9 @@ var SlashCommandSubcommandGroupBuilder = class {
     return {
       type: import_v1020.ApplicationCommandOptionType.SubcommandGroup,
       name: this.name,
+      name_localizations: this.name_localizations,
       description: this.description,
+      description_localizations: this.description_localizations,
       options: this.options.map((option) => option.toJSON())
     };
   }
@@ -1387,7 +1404,9 @@ var SlashCommandSubcommandBuilder = class {
     return {
       type: import_v1020.ApplicationCommandOptionType.Subcommand,
       name: this.name,
+      name_localizations: this.name_localizations,
       description: this.description,
+      description_localizations: this.description_localizations,
       options: this.options.map((option) => option.toJSON())
     };
   }
@@ -1409,6 +1428,8 @@ var SlashCommandBuilder = class {
   }
   toJSON() {
     validateRequiredParameters3(this.name, this.description, this.options);
+    validateLocalizationMap(this.name_localizations);
+    validateLocalizationMap(this.description_localizations);
     return {
       name: this.name,
       name_localizations: this.name_localizations,
@@ -1455,7 +1476,7 @@ __export(Assertions_exports6, {
 });
 var import_shapeshift10 = require("@sapphire/shapeshift");
 var import_v1021 = require("discord-api-types/v10");
-var namePredicate2 = import_shapeshift10.s.string.lengthGe(1).lengthLe(32).regex(/^( *[\p{L}\p{N}\p{sc=Devanagari}\p{sc=Thai}_-]+ *)+$/u);
+var namePredicate2 = import_shapeshift10.s.string.lengthGreaterThanOrEqual(1).lengthLessThanOrEqual(32).regex(/^( *[\p{L}\p{N}\p{sc=Devanagari}\p{sc=Thai}_-]+ *)+$/u);
 var typePredicate = import_shapeshift10.s.union(import_shapeshift10.s.literal(import_v1021.ApplicationCommandType.User), import_shapeshift10.s.literal(import_v1021.ApplicationCommandType.Message));
 var booleanPredicate3 = import_shapeshift10.s.boolean;
 function validateDefaultPermission2(value) {
@@ -1480,6 +1501,7 @@ __name(validateRequiredParameters4, "validateRequiredParameters");
 var ContextMenuCommandBuilder = class {
   constructor() {
     __publicField(this, "name");
+    __publicField(this, "name_localizations");
     __publicField(this, "type");
     __publicField(this, "defaultPermission");
   }
@@ -1498,10 +1520,34 @@ var ContextMenuCommandBuilder = class {
     Reflect.set(this, "defaultPermission", value);
     return this;
   }
+  setNameLocalization(locale, localizedName) {
+    if (!this.name_localizations) {
+      Reflect.set(this, "name_localizations", {});
+    }
+    const parsedLocale = validateLocale(locale);
+    if (localizedName === null) {
+      this.name_localizations[parsedLocale] = null;
+      return this;
+    }
+    validateName2(localizedName);
+    this.name_localizations[parsedLocale] = localizedName;
+    return this;
+  }
+  setNameLocalizations(localizedNames) {
+    if (localizedNames === null) {
+      Reflect.set(this, "name_localizations", null);
+      return this;
+    }
+    Reflect.set(this, "name_localizations", {});
+    Object.entries(localizedNames).forEach((args) => this.setNameLocalization(...args));
+    return this;
+  }
   toJSON() {
     validateRequiredParameters4(this.name, this.type);
+    validateLocalizationMap(this.name_localizations);
     return {
       name: this.name,
+      name_localizations: this.name_localizations,
       type: this.type,
       default_permission: this.defaultPermission
     };