js-discord-modularcommand 2.0.3 → 2.1.0

package/dist/modularcommand.d.ts

@@ -3,7 +3,7 @@
  * @author vicentefelipechile
  * @license MIT
  */
-import { LocalizationMap, ButtonStyle, Locale } from 'discord.js';
+import { LocalizationMap, ButtonStyle } from 'discord.js';
 import ModularModal from './modularmodal.js';
 import ModularButton from './modularbutton.js';
 import { ButtonExecuteFunction, CommandExecuteFunction, CommandOption, ComponentExecuteFunction, ModalExecuteFunction, PermissionCheckFunction } from './types.js';
@@ -37,7 +37,7 @@ export default class ModularCommand {
     /** The options (arguments) that the command accepts. */
     options: CommandOption[];
     /** An object containing localizations for the names and descriptions of the options. */
-    optionsLocalizations: Record<string, Record<Locale, string>>;
+    optionsLocalizations: LocalizationMap;
     /** The main function that executes when the command is invoked. */
     execute: CommandExecuteFunction;
     /** (Optional) The function to handle button interactions. */
@@ -53,7 +53,7 @@ export default class ModularCommand {
     /** Whether the command is marked as Not Safe For Work (NSFW). */
     isNSFW: boolean;
     /** (Optional) An object with localized phrases to be used within the command's execution. */
-    localizationPhrases?: Record<Locale, string>;
+    localizationPhrases?: LocalizationMap;
     /** (Optional) The function that checks if a user has permission to execute the command. */
     permissionCheck?: PermissionCheckFunction;
     /** (Optional) The base ID for components associated with this command. */
@@ -72,23 +72,31 @@ export default class ModularCommand {
      */
     setDescription(description: string): this;
     /**
+     * @deprecated Use setLocalizationDescription instead.
      * Sets the description localizations for the command.
      * @param {LocalizationMap} localizations The description localizations map.
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationsDescription(localizations: LocalizationMap): this;
+    /**
+     * Sets the description localizations for the command.
+     * @param {LocalizationMap} localizations The description localizations map.
+     * @returns {ModularCommand} The command instance for chaining.
+     */
+    setLocalizationDescription(localizations: LocalizationMap): this;
     /**
      * Sets the localizations for the command's options.
-     * @param {Record<string, Record<Locale, string>>} localizations An object with the localizations.
+     * @param {LocalizationMap} localizations An object with the localizations.
      * @returns {ModularCommand} The command instance for chaining.
      */
-    setLocalizationOptions(localizations: Record<string, Record<Locale, string>>): this;
+    setLocalizationOptions(localizations: LocalizationMap): this;
     /**
      * Sets the localization phrases for the command.
-     * @param {Record<Locale, string>} localizationPhrases The localization phrases.
+     * Accepts a partial record, so not all locales need to be provided.
+     * @param {LocalizationMap} localizationPhrases The localization phrases.
      * @returns {ModularCommand} The command instance for chaining.
      */
-    setLocalizationPhrases(localizationPhrases: Record<Locale, string>): this;
+    setLocalizationPhrases(localizationPhrases: LocalizationMap): this;
     /**
      * Sets the execute function for the command.
      * @param {CommandExecuteFunction} executeFunction The function to execute.

package/dist/modularcommand.js

@@ -63,31 +63,50 @@ class ModularCommand {
         return this;
     }
     /**
+     * @deprecated Use setLocalizationDescription instead.
      * Sets the description localizations for the command.
      * @param {LocalizationMap} localizations The description localizations map.
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationsDescription(localizations) {
+        return this.setLocalizationDescription(localizations);
+    }
+    /**
+     * Sets the description localizations for the command.
+     * @param {LocalizationMap} localizations The description localizations map.
+     * @returns {ModularCommand} The command instance for chaining.
+     */
+    setLocalizationDescription(localizations) {
         this.description = localizations[discord_js_1.Locale.EnglishUS] || this.description;
-        this.descriptionLocalizations = localizations;
+        this.descriptionLocalizations = {
+            ...this.descriptionLocalizations,
+            ...localizations,
+        };
         return this;
     }
     /**
      * Sets the localizations for the command's options.
-     * @param {Record<string, Record<Locale, string>>} localizations An object with the localizations.
+     * @param {LocalizationMap} localizations An object with the localizations.
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationOptions(localizations) {
-        this.optionsLocalizations = localizations;
+        this.optionsLocalizations = {
+            ...this.optionsLocalizations,
+            ...localizations,
+        };
         return this;
     }
     /**
      * Sets the localization phrases for the command.
-     * @param {Record<Locale, string>} localizationPhrases The localization phrases.
+     * Accepts a partial record, so not all locales need to be provided.
+     * @param {LocalizationMap} localizationPhrases The localization phrases.
      * @returns {ModularCommand} The command instance for chaining.
      */
     setLocalizationPhrases(localizationPhrases) {
-        this.localizationPhrases = localizationPhrases;
+        this.localizationPhrases = {
+            ...this.localizationPhrases,
+            ...localizationPhrases,
+        };
         return this;
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-discord-modularcommand",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "",
   "keywords": [
     "discord",