js-discord-modularcommand 3.2.2 → 3.3.0

package/dist/interaction.d.ts

@@ -6,20 +6,13 @@
  */
 import { BaseInteraction, CommandInteraction, MessageComponentInteraction, ModalSubmitInteraction } from "discord.js";
 import { ClientWithCommands } from "./types";
-/**
- * @interface InteractionHandlerArgs
- * @description Defines the arguments for the custom interaction handler function.
- */
-interface InteractionHandlerArgs {
-    /** The interaction received from Discord. */
-    interaction: CommandInteraction | MessageComponentInteraction | ModalSubmitInteraction;
-}
 /**
  * @type InteractionHandler
  * @description A function signature for a custom interaction handler.
+ * @param interaction The interaction received from Discord.
  * @returns {Promise<boolean | undefined>} A promise that resolves to `false` to stop the default handler, or `true`/`undefined` to continue.
  */
-type InteractionHandler = (args: InteractionHandlerArgs) => Promise<boolean | undefined>;
+type InteractionHandler = (interaction: CommandInteraction | MessageComponentInteraction | ModalSubmitInteraction) => Promise<boolean | undefined>;
 /**
  * @description Creates a modular command handler function for the Discord client.
  * @param {ClientWithCommands} client The Discord client instance with a commands collection.

package/dist/interaction.js

@@ -33,7 +33,7 @@ function ModularCommandHandler(client, customHandler) {
             return;
         }
         if (typeof customHandler === "function") {
-            const response = await customHandler({ interaction });
+            const response = await customHandler(interaction);
             if (response === false)
                 return;
         }

package/dist/locales.d.ts

@@ -5,7 +5,7 @@
  * @description Localization phrases for various command responses in a Discord bot using Discord.js.
  */
 import { Locale } from "discord.js";
-import LOCALE_DELAY from "./modularlocale";
+import LOCALE_DELAY from "./localesdelay";
 /**
  * @description Localization phrases for various commands, specifically for permission errors.
  */

package/dist/locales.js

@@ -14,8 +14,8 @@ exports.LOCALE_NSFW = exports.LOCALE_FORBIDDEN = exports.LOCALE_ERROR = exports.
 // Imports
 // =================================================================================================
 const discord_js_1 = require("discord.js");
-const modularlocale_1 = __importDefault(require("./modularlocale"));
-exports.LOCALE_DELAY = modularlocale_1.default;
+const localesdelay_1 = __importDefault(require("./localesdelay"));
+exports.LOCALE_DELAY = localesdelay_1.default;
 // =================================================================================================
 // Localization Phrases
 // =================================================================================================

package/dist/localesdelay.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @license     MIT
+ * @file        src/localesdelay.ts
+ * @author      vicentefelipechile
+ * @description Generic localization phrases used throughout the application.
+ */
+import { Locale } from "discord.js";
+/**
+ * @description Class to handle localization in a modular way.
+ */
+declare class ModularLocale {
+    locale: Locale;
+    phrases: Record<string, string>;
+    seconds: Record<string, string>;
+    minutes: Record<string, string>;
+    constructor(locale: Locale);
+    /**
+     * Set the singular and plural forms for seconds.
+     * @param {string} singular The singular form (e.g., '{s} segundo').
+     * @param {string} plural The plural form (e.g., '{s} segundos').
+     * @returns {ModularLocale}
+     */
+    setSeconds(singular: string, plural: string): this;
+    /**
+     * Set the singular and plural forms for minutes.
+     * @param {string} singular The singular form (e.g., '{m} minuto').
+     * @param {string} plural The plural form (e.g., '{m} minutos').
+     * @returns {ModularLocale}
+     */
+    setMinutes(singular: string, plural: string): this;
+    /**
+     * Set the main phrase for the command delay.
+     * @param {string} phrase The phrase when only seconds or minutes are present.
+     * @returns {ModularLocale}
+     */
+    setPhrase(phrase: string): this;
+    /**
+     * Set the phrase when both seconds and minutes are present.
+     * @param {string} phrase The phrase for combined time.
+     * @returns {ModularLocale}
+     */
+    setPhrasePlural(phrase: string): this;
+    /**
+     * Set the phrase when only minutes are present.
+     * @param {string} phrase The phrase for when only minutes are present.
+     * @returns {ModularLocale}
+     */
+    setPhraseOnlyMinutes(phrase: string): this;
+    getPhrase: () => Record<string, string>;
+    getSeconds: () => Record<string, string>;
+    getMinutes: () => Record<string, string>;
+    /**
+     * Get the formatted phrase based on the time.
+     * @param {number} time The time in seconds.
+     * @returns {string} The formatted string.
+     */
+    formatTime(time: number): string;
+}
+/**
+ * @description Localization phrases for delay commands in ModularLocale structure.
+ * @example ```js
+ * const phrase = LOCALE_DELAY[Locale.EnglishUS];
+ * console.log( phrase.formatTime(64) );    // 'You must wait 4 seconds and 1 minute.'
+ * console.log( phrase.formatTime(390) );   // 'You must wait 30 seconds and 6 minutes.'
+ * console.log( phrase.formatTime(1) );     // 'You must wait 1 second.'
+ * console.log( phrase.formatTime(120) );   // 'You must wait 2 minutes.'
+ * ```
+ */
+declare const LOCALE_DELAY: {
+    "es-419": ModularLocale;
+    "en-US": ModularLocale;
+    "en-GB": ModularLocale;
+    "es-ES": ModularLocale;
+    "pt-BR": ModularLocale;
+    fr: ModularLocale;
+    de: ModularLocale;
+    it: ModularLocale;
+    ru: ModularLocale;
+    "zh-CN": ModularLocale;
+    "zh-TW": ModularLocale;
+    ja: ModularLocale;
+    ko: ModularLocale;
+    bg: ModularLocale;
+    cs: ModularLocale;
+    da: ModularLocale;
+    nl: ModularLocale;
+    fi: ModularLocale;
+    hu: ModularLocale;
+    no: ModularLocale;
+    pl: ModularLocale;
+    ro: ModularLocale;
+    "sv-SE": ModularLocale;
+    tr: ModularLocale;
+    uk: ModularLocale;
+    hi: ModularLocale;
+    id: ModularLocale;
+    el: ModularLocale;
+    hr: ModularLocale;
+    lt: ModularLocale;
+    th: ModularLocale;
+    vi: ModularLocale;
+};
+export default LOCALE_DELAY;

package/dist/localesdelay.js

@@ -0,0 +1,334 @@
+"use strict";
+/**
+ * @license     MIT
+ * @file        src/localesdelay.ts
+ * @author      vicentefelipechile
+ * @description Generic localization phrases used throughout the application.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+// =================================================================================================
+// Imports
+// =================================================================================================
+const discord_js_1 = require("discord.js");
+// =================================================================================================
+// Helper Functions
+// =================================================================================================
+/**
+ * Format a time unit (seconds or minutes) for localization.
+ * @param unit The time unit ('s' for seconds, 'm' for minutes).
+ * @param unitCount The count of the time unit.
+ * @param unitData The localization data for the time unit.
+ * @returns The formatted string for the time unit.
+ */
+function formatUnit(unit, unitCount, unitData) {
+    if (unitCount === 1) {
+        return unitData.singular.replace(`{${unit}}`, unitCount.toString());
+    }
+    else {
+        return unitData.plural.replace(`{${unit}}`, unitCount.toString());
+    }
+}
+;
+// =================================================================================================
+// ModularLocale Class
+// =================================================================================================
+/**
+ * @description Class to handle localization in a modular way.
+ */
+class ModularLocale {
+    constructor(locale) {
+        this.getPhrase = () => this.phrases;
+        this.getSeconds = () => this.seconds;
+        this.getMinutes = () => this.minutes;
+        this.locale = locale;
+        this.phrases = {};
+        this.seconds = {};
+        this.minutes = {};
+    }
+    /**
+     * Set the singular and plural forms for seconds.
+     * @param {string} singular The singular form (e.g., '{s} segundo').
+     * @param {string} plural The plural form (e.g., '{s} segundos').
+     * @returns {ModularLocale}
+     */
+    setSeconds(singular, plural) {
+        this.seconds = { singular, plural };
+        return this;
+    }
+    /**
+     * Set the singular and plural forms for minutes.
+     * @param {string} singular The singular form (e.g., '{m} minuto').
+     * @param {string} plural The plural form (e.g., '{m} minutos').
+     * @returns {ModularLocale}
+     */
+    setMinutes(singular, plural) {
+        this.minutes = { singular, plural };
+        return this;
+    }
+    /**
+     * Set the main phrase for the command delay.
+     * @param {string} phrase The phrase when only seconds or minutes are present.
+     * @returns {ModularLocale}
+     */
+    setPhrase(phrase) {
+        this.phrases.singular = phrase;
+        return this;
+    }
+    /**
+     * Set the phrase when both seconds and minutes are present.
+     * @param {string} phrase The phrase for combined time.
+     * @returns {ModularLocale}
+     */
+    setPhrasePlural(phrase) {
+        this.phrases.plural = phrase;
+        return this;
+    }
+    /**
+     * Set the phrase when only minutes are present.
+     * @param {string} phrase The phrase for when only minutes are present.
+     * @returns {ModularLocale}
+     */
+    setPhraseOnlyMinutes(phrase) {
+        this.phrases.onlyMinutes = phrase;
+        return this;
+    }
+    /**
+     * Get the formatted phrase based on the time.
+     * @param {number} time The time in seconds.
+     * @returns {string} The formatted string.
+     */
+    formatTime(time) {
+        const minutes = Math.floor(time / 60);
+        const seconds = time % 60;
+        let formattedPhrase = '';
+        if (minutes > 0 && seconds > 0) {
+            formattedPhrase = this.phrases.plural
+                .replace('{seconds}', formatUnit('s', seconds, this.seconds))
+                .replace('{minutes}', formatUnit('m', minutes, this.minutes));
+        }
+        else if (minutes > 0 && seconds === 0) {
+            // Handle case where only minutes are present
+            formattedPhrase = this.phrases.onlyMinutes
+                .replace('{minutes}', formatUnit('m', minutes, this.minutes));
+        }
+        else {
+            formattedPhrase = this.phrases.singular
+                .replace('{seconds}', formatUnit('s', seconds, this.seconds))
+                .replace('{minutes}', '')
+                .trim();
+        }
+        return formattedPhrase.replace(/\s+/g, ' ').trim();
+    }
+}
+// =================================================================================================
+// Localization Phrases
+// =================================================================================================
+/**
+ * @description Localization phrases for delay commands in ModularLocale structure.
+ * @example ```js
+ * const phrase = LOCALE_DELAY[Locale.EnglishUS];
+ * console.log( phrase.formatTime(64) );    // 'You must wait 4 seconds and 1 minute.'
+ * console.log( phrase.formatTime(390) );   // 'You must wait 30 seconds and 6 minutes.'
+ * console.log( phrase.formatTime(1) );     // 'You must wait 1 second.'
+ * console.log( phrase.formatTime(120) );   // 'You must wait 2 minutes.'
+ * ```
+ */
+const LOCALE_DELAY = {
+    [discord_js_1.Locale.SpanishLATAM]: new ModularLocale(discord_js_1.Locale.SpanishLATAM)
+        .setSeconds('{s} segundo', '{s} segundos')
+        .setMinutes('{m} minuto', '{m} minutos')
+        .setPhrase('Debes esperar {seconds} antes de utilizar este comando denuevo.')
+        .setPhrasePlural('Debes esperar {seconds} y {minutes} antes de utilizar este comando denuevo.')
+        .setPhraseOnlyMinutes('Debes esperar {minutes} antes de utilizar este comando denuevo.'),
+    [discord_js_1.Locale.EnglishUS]: new ModularLocale(discord_js_1.Locale.EnglishUS)
+        .setSeconds('{s} second', '{s} seconds')
+        .setMinutes('{m} minute', '{m} minutes')
+        .setPhrase('You must wait {seconds} before using this command again.')
+        .setPhrasePlural('You must wait {seconds} and {minutes} before using this command again.')
+        .setPhraseOnlyMinutes('You must wait {minutes} before using this command again.'),
+    [discord_js_1.Locale.EnglishGB]: new ModularLocale(discord_js_1.Locale.EnglishGB)
+        .setSeconds('{s} second', '{s} seconds')
+        .setMinutes('{m} minute', '{m} minutes')
+        .setPhrase('One must exhibit a spot of patience, you see. A brief pause of {seconds} is required before another attempt, what?')
+        .setPhrasePlural('One must exhibit a spot of patience, you see. A brief pause of {seconds} and {minutes} is required before another attempt, what?')
+        .setPhraseOnlyMinutes('One must exhibit a spot of patience, you see. A brief pause of {minutes} is required before another attempt, what?'),
+    [discord_js_1.Locale.SpanishES]: new ModularLocale(discord_js_1.Locale.SpanishES)
+        .setSeconds('{s} segundo', '{s} segundos')
+        .setMinutes('{m} minuto', '{m} minutos')
+        .setPhrase('¡Joder, tío! ¡Que te esperes {seconds} antes de utilizar este comando, coño!')
+        .setPhrasePlural('¡Joder, tío! ¡Que te esperes {seconds} y {minutes}, coño!')
+        .setPhraseOnlyMinutes('¡Joder, tío! ¡Que te esperes {minutes} antes de utilizar este comando, coño!'),
+    [discord_js_1.Locale.PortugueseBR]: new ModularLocale(discord_js_1.Locale.PortugueseBR)
+        .setSeconds('{s} segundo', '{s} segundos')
+        .setMinutes('{m} minuto', '{m} minutos')
+        .setPhrase('Você deve esperar {seconds} antes de usar este comando novamente.')
+        .setPhrasePlural('Você deve esperar {seconds} e {minutes} antes de usar este comando novamente.')
+        .setPhraseOnlyMinutes('Você deve esperar {minutes} antes de usar este comando novamente.'),
+    [discord_js_1.Locale.French]: new ModularLocale(discord_js_1.Locale.French)
+        .setSeconds('{s} seconde', '{s} secondes')
+        .setMinutes('{m} minute', '{m} minutes')
+        .setPhrase('Vous devez attendre {seconds} avant d\'utiliser cette commande à nouveau.')
+        .setPhrasePlural('Vous devez attendre {seconds} et {minutes} avant d\'utiliser cette commande à nouveau.')
+        .setPhraseOnlyMinutes('Vous devez attendre {minutes} avant d\'utiliser cette commande à nouveau.'),
+    [discord_js_1.Locale.German]: new ModularLocale(discord_js_1.Locale.German)
+        .setSeconds('{s} Sekunde', '{s} Sekunden')
+        .setMinutes('{m} Minute', '{m} Minuten')
+        .setPhrase('Sie müssen {seconds} warten, bevor Sie diesen Befehl erneut verwenden können.')
+        .setPhrasePlural('Sie müssen {seconds} und {minutes} warten, bevor Sie diesen Befehl erneut verwenden können.')
+        .setPhraseOnlyMinutes('Sie müssen {minutes} warten, bevor Sie diesen Befehl erneut verwenden können.'),
+    [discord_js_1.Locale.Italian]: new ModularLocale(discord_js_1.Locale.Italian)
+        .setSeconds('{s} secondo', '{s} secondi')
+        .setMinutes('{m} minuto', '{m} minuti')
+        .setPhrase('Devi aspettare {seconds} prima di utilizzare di nuovo questo comando.')
+        .setPhrasePlural('Devi aspettare {seconds} e {minutes} prima di utilizzare di nuovo questo comando.')
+        .setPhraseOnlyMinutes('Devi aspettare {minutes} prima di utilizzare di nuovo questo comando.'),
+    [discord_js_1.Locale.Russian]: new ModularLocale(discord_js_1.Locale.Russian)
+        .setSeconds('{s} секунду', '{s} секунд')
+        .setMinutes('{m} минуту', '{m} минут')
+        .setPhrase('Вы должны подождать {seconds} перед повторным использованием этой команды.')
+        .setPhrasePlural('Вы должны подождать {seconds} и {minutes} перед повторным использованием этой команды.')
+        .setPhraseOnlyMinutes('Вы должны подождать {minutes} перед повторным использованием этой команды.'),
+    [discord_js_1.Locale.ChineseCN]: new ModularLocale(discord_js_1.Locale.ChineseCN)
+        .setSeconds('{s} 秒', '{s} 秒')
+        .setMinutes('{m} 分钟', '{m} 分钟')
+        .setPhrase('您必须等待 {seconds} 才能再次使用此命令.')
+        .setPhrasePlural('您必须等待 {seconds} 和 {minutes} 才能再次使用此命令.')
+        .setPhraseOnlyMinutes('您必须等待 {minutes} 才能再次使用此命令.'),
+    [discord_js_1.Locale.ChineseTW]: new ModularLocale(discord_js_1.Locale.ChineseTW)
+        .setSeconds('{s} 秒', '{s} 秒')
+        .setMinutes('{m} 分鐘', '{m} 分鐘')
+        .setPhrase('您必須等待 {seconds} 才能再次使用此命令.')
+        .setPhrasePlural('您必須等待 {seconds} 和 {minutes} 才能再次使用此命令.')
+        .setPhraseOnlyMinutes('您必須等待 {minutes} 才能再次使用此命令.'),
+    [discord_js_1.Locale.Japanese]: new ModularLocale(discord_js_1.Locale.Japanese)
+        .setSeconds('{s} 秒', '{s} 秒')
+        .setMinutes('{m} 分', '{m} 分')
+        .setPhrase('このコマンドを再度使用するには、{seconds} 待つ必要があります.')
+        .setPhrasePlural('このコマンドを再度使用するには、{seconds} と {minutes} 待つ必要があります.')
+        .setPhraseOnlyMinutes('このコマンドを再度使用するには、{minutes} 待つ必要があります.'),
+    [discord_js_1.Locale.Korean]: new ModularLocale(discord_js_1.Locale.Korean)
+        .setSeconds('{s} 초', '{s} 초')
+        .setMinutes('{m} 분', '{m} 분')
+        .setPhrase('이 명령어를 다시 사용하려면 {seconds} 기다려야 합니다.')
+        .setPhrasePlural('이 명령어를 다시 사용하려면 {seconds} 하고 {minutes} 기다려야 합니다.')
+        .setPhraseOnlyMinutes('이 명령어를 다시 사용하려면 {minutes} 기다려야 합니다.'),
+    [discord_js_1.Locale.Bulgarian]: new ModularLocale(discord_js_1.Locale.Bulgarian)
+        .setSeconds('{s} секунд', '{s} секунди')
+        .setMinutes('{m} минут', '{m} минути')
+        .setPhrase('Трябва да изчакате {seconds} преди да използвате тази команда отново.')
+        .setPhrasePlural('Трябва да изчакате {seconds} и {minutes} преди да използвате тази команда отново.')
+        .setPhraseOnlyMinutes('Трябва да изчакате {minutes} преди да използвате тази команда отново.'),
+    [discord_js_1.Locale.Czech]: new ModularLocale(discord_js_1.Locale.Czech)
+        .setSeconds('{s} sekundu', '{s} sekund')
+        .setMinutes('{m} minutu', '{m} minut')
+        .setPhrase('Musíte počkat {seconds} než znovu použijete tento příkaz.')
+        .setPhrasePlural('Musíte počkat {seconds} a {minutes} než znovu použijete tento příkaz.')
+        .setPhraseOnlyMinutes('Musíte počkat {minutes} než znovu použijete tento příkaz.'),
+    [discord_js_1.Locale.Danish]: new ModularLocale(discord_js_1.Locale.Danish)
+        .setSeconds('{s} sekund', '{s} sekunder')
+        .setMinutes('{m} minut', '{m} minutter')
+        .setPhrase('Du skal vente {seconds} før du kan bruge denne kommando igen.')
+        .setPhrasePlural('Du skal vente {seconds} og {minutes} før du kan bruge denne kommando igen.')
+        .setPhraseOnlyMinutes('Du skal vente {minutes} før du kan bruge denne kommando igen.'),
+    [discord_js_1.Locale.Dutch]: new ModularLocale(discord_js_1.Locale.Dutch)
+        .setSeconds('{s} seconde', '{s} seconden')
+        .setMinutes('{m} minuut', '{m} minuten')
+        .setPhrase('Je moet {seconds} wachten voordat je dit commando opnieuw kunt gebruiken.')
+        .setPhrasePlural('Je moet {seconds} en {minutes} wachten voordat je dit commando opnieuw kunt gebruiken.')
+        .setPhraseOnlyMinutes('Je moet {minutes} wachten voordat je dit commando opnieuw kunt gebruiken.'),
+    [discord_js_1.Locale.Finnish]: new ModularLocale(discord_js_1.Locale.Finnish)
+        .setSeconds('{s} sekunti', '{s} sekuntia')
+        .setMinutes('{m} minuutti', '{m} minuuttia')
+        .setPhrase('Sinun on odotettava {seconds} ennen kuin voit käyttää tätä komentoa uudelleen.')
+        .setPhrasePlural('Sinun on odotettava {seconds} ja {minutes} ennen kuin voit käyttää tätä komentoa uudelleen.')
+        .setPhraseOnlyMinutes('Sinun on odotettava {minutes} ennen kuin voit käyttää tätä komentoa uudelleen.'),
+    [discord_js_1.Locale.Hungarian]: new ModularLocale(discord_js_1.Locale.Hungarian)
+        .setSeconds('{s} másodperc', '{s} másodpercet')
+        .setMinutes('{m} perc', '{m} percet')
+        .setPhrase('Várnod kell {seconds} mielőtt újra használhatod ezt a parancsot.')
+        .setPhrasePlural('Várnod kell {seconds} és {minutes} mielőtt újra használhatod ezt a parancsot.')
+        .setPhraseOnlyMinutes('Várnod kell {minutes} mielőtt újra használhatod ezt a parancsot.'),
+    [discord_js_1.Locale.Norwegian]: new ModularLocale(discord_js_1.Locale.Norwegian)
+        .setSeconds('{s} sekund', '{s} sekunder')
+        .setMinutes('{m} minutt', '{m} minutter')
+        .setPhrase('Du må vente {seconds} før du kan bruke denne kommandoen igjen.')
+        .setPhrasePlural('Du må vente {seconds} og {minutes} før du kan bruke denne kommandoen igjen.')
+        .setPhraseOnlyMinutes('Du må vente {minutes} før du kan bruke denne kommandoen igjen.'),
+    [discord_js_1.Locale.Polish]: new ModularLocale(discord_js_1.Locale.Polish)
+        .setSeconds('{s} sekundę', '{s} sekundy')
+        .setMinutes('{m} minutę', '{m} minuty')
+        .setPhrase('Musisz poczekać {seconds} zanim ponownie użyjesz tego polecenia.')
+        .setPhrasePlural('Musisz poczekać {seconds} i {minutes} zanim ponownie użyjesz tego polecenia.')
+        .setPhraseOnlyMinutes('Musisz poczekać {minutes} zanim ponownie użyjesz tego polecenia.'),
+    [discord_js_1.Locale.Romanian]: new ModularLocale(discord_js_1.Locale.Romanian)
+        .setSeconds('{s} secundă', '{s} secunde')
+        .setMinutes('{m} minut', '{m} minute')
+        .setPhrase('Trebuie să aștepți {seconds} înainte de a folosi din nou acest comandă.')
+        .setPhrasePlural('Trebuie să aștepți {seconds} și {minutes} înainte de a folosi din nou acest comandă.')
+        .setPhraseOnlyMinutes('Trebuie să aștepți {minutes} înainte de a folosi din nou acest comandă.'),
+    [discord_js_1.Locale.Swedish]: new ModularLocale(discord_js_1.Locale.Swedish)
+        .setSeconds('{s} sekund', '{s} sekunder')
+        .setMinutes('{m} minut', '{m} minuter')
+        .setPhrase('Du måste vänta {seconds} innan du kan använda det här kommandot igen.')
+        .setPhrasePlural('Du måste vänta {seconds} och {minutes} innan du kan använda det här kommandot igen.')
+        .setPhraseOnlyMinutes('Du måste vänta {minutes} innan du kan använda det här kommandot igen.'),
+    [discord_js_1.Locale.Turkish]: new ModularLocale(discord_js_1.Locale.Turkish)
+        .setSeconds('{s} saniye', '{s} saniye')
+        .setMinutes('{m} dakika', '{m} dakika')
+        .setPhrase('Bu komutu tekrar kullanmadan önce {seconds} beklemeniz gerekir.')
+        .setPhrasePlural('Bu komutu tekrar kullanmadan önce {seconds} ve {minutes} beklemeniz gerekir.')
+        .setPhraseOnlyMinutes('Bu komutu tekrar kullanmadan önce {minutes} beklemeniz gerekir.'),
+    [discord_js_1.Locale.Ukrainian]: new ModularLocale(discord_js_1.Locale.Ukrainian)
+        .setSeconds('{s} секунду', '{s} секунди')
+        .setMinutes('{m} хвилину', '{m} хвилини')
+        .setPhrase('Вам потрібно почекати {seconds} перш ніж знову використовувати цю команду.')
+        .setPhrasePlural('Вам потрібно почекати {seconds} і {minutes} перш ніж знову використовувати цю команду.')
+        .setPhraseOnlyMinutes('Вам потрібно почекати {minutes} перш ніж знову використовувати цю команду.'),
+    [discord_js_1.Locale.Hindi]: new ModularLocale(discord_js_1.Locale.Hindi)
+        .setSeconds('{s} सेकंड', '{s} सेकंड')
+        .setMinutes('{m} मिनट', '{m} मिनट')
+        .setPhrase('आपको इस कमांड का उपयोग करने से पहले {seconds} इंतजार करना होगा.')
+        .setPhrasePlural('आपको इस कमांड का उपयोग करने से पहले {seconds} और {minutes} इंतजार करना होगा.')
+        .setPhraseOnlyMinutes('आपको इस कमांड का उपयोग करने से पहले {minutes} इंतजार करना होगा.'),
+    [discord_js_1.Locale.Indonesian]: new ModularLocale(discord_js_1.Locale.Indonesian)
+        .setSeconds('{s} detik', '{s} detik')
+        .setMinutes('{m} menit', '{m} menit')
+        .setPhrase('Anda harus menunggu {seconds} sebelum menggunakan perintah ini lagi.')
+        .setPhrasePlural('Anda harus menunggu {seconds} dan {minutes} sebelum menggunakan perintah ini lagi.')
+        .setPhraseOnlyMinutes('Anda harus menunggu {minutes} sebelum menggunakan perintah ini lagi.'),
+    [discord_js_1.Locale.Greek]: new ModularLocale(discord_js_1.Locale.Greek)
+        .setSeconds('{s} δευτερόλεπτο', '{s} δευτερόλεπτα')
+        .setMinutes('{m} λεπτό', '{m} λεπτά')
+        .setPhrase('Πρέπει να περιμένετε {seconds} πριν χρησιμοποιήσετε ξανά αυτήν την εντολή.')
+        .setPhrasePlural('Πρέπει να περιμένετε {seconds} και {minutes} πριν χρησιμοποιήσετε ξανά αυτήν την εντολή.')
+        .setPhraseOnlyMinutes('Πρέπει να περιμένετε {minutes} πριν χρησιμοποιήσετε ξανά αυτήν την εντολή.'),
+    [discord_js_1.Locale.Croatian]: new ModularLocale(discord_js_1.Locale.Croatian)
+        .setSeconds('{s} sekundu', '{s} sekunde')
+        .setMinutes('{m} minutu', '{m} minute')
+        .setPhrase('Morate pričekati {seconds} prije nego što ponovno upotrijebite ovu naredbu.')
+        .setPhrasePlural('Morate pričekati {seconds} i {minutes} prije nego što ponovno upotrijebite ovu naredbu.')
+        .setPhraseOnlyMinutes('Morate pričekati {minutes} prije nego što ponovno upotrijebite ovu naredbu.'),
+    [discord_js_1.Locale.Lithuanian]: new ModularLocale(discord_js_1.Locale.Lithuanian)
+        .setSeconds('{s} sekundę', '{s} sekundes')
+        .setMinutes('{m} minutę', '{m} minutes')
+        .setPhrase('Prieš vėl naudodamiesi šiuo komandu, turite palaukti {seconds}.')
+        .setPhrasePlural('Prieš vėl naudodamiesi šiuo komandu, turite palaukti {seconds} ir {minutes}.')
+        .setPhraseOnlyMinutes('Prieš vėl naudodamiesi šiuo komandu, turite palaukti {minutes}.'),
+    [discord_js_1.Locale.Thai]: new ModularLocale(discord_js_1.Locale.Thai)
+        .setSeconds('{s} วินาที', '{s} วินาที')
+        .setMinutes('{m} นาที', '{m} นาที')
+        .setPhrase('คุณต้องรอ {seconds} ก่อนที่จะใช้คำสั่งนี้อีกครั้ง')
+        .setPhrasePlural('คุณต้องรอ {seconds} และ {minutes} ก่อนที่จะใช้คำสั่งนี้อีกครั้ง')
+        .setPhraseOnlyMinutes('คุณต้องรอ {minutes} ก่อนที่จะใช้คำสั่งนี้อีกครั้ง'),
+    [discord_js_1.Locale.Vietnamese]: new ModularLocale(discord_js_1.Locale.Vietnamese)
+        .setSeconds('{s} giây', '{s} giây')
+        .setMinutes('{m} phút', '{m} phút')
+        .setPhrase('Bạn phải đợi {seconds} trước khi sử dụng lại lệnh này.')
+        .setPhrasePlural('Bạn phải đợi {seconds} và {minutes} trước khi sử dụng lại lệnh này.')
+        .setPhraseOnlyMinutes('Bạn phải đợi {minutes} trước khi sử dụng lại lệnh này.')
+};
+Object.freeze(LOCALE_DELAY);
+// =================================================================================================
+// Export
+// =================================================================================================
+exports.default = LOCALE_DELAY;

package/dist/registercommand.js

@@ -49,19 +49,24 @@ const discord_js_1 = require("discord.js");
 const cooldown_1 = __importStar(require("./cooldown"));
 const locales_1 = require("./locales");
 /**
- * @description Gets localized description for a subcommand.
+ * @description Gets localized value for a subcommand or its option.
  * Supports multiple languages and falls back to default description if not found.
+ * This consolidated function handles both subcommand descriptions and option descriptions.
  * @param {ModularCommand} command The command instance.
  * @param {string} subCommandName The name of the subcommand.
- * @param {string} defaultDescription The default description.
+ * @param {string | null} optionName The name of the option, or null for the subcommand description itself.
+ * @param {string} defaultValue The default value to use if no localization is found.
  * @param {string} locale The locale to use (defaults to EnglishUS).
- * @returns {string} The localized description.
+ * @returns {string} The localized value.
  */
-function getLocalizedSubCommandDescription(command, subCommandName, defaultDescription, locale = discord_js_1.Locale.EnglishUS) {
+function getLocalizedSubCommandValue(command, subCommandName, optionName, defaultValue, locale = discord_js_1.Locale.EnglishUS) {
     if (!command.subCommandLocalizations)
-        return defaultDescription;
+        return defaultValue;
     const localizations = command.subCommandLocalizations;
-    const key = `${subCommandName}.description`;
+    // Build the key based on whether we're looking for subcommand or option description
+    const key = optionName
+        ? `${subCommandName}.${optionName}.description`
+        : `${subCommandName}.description`;
     // Try to get the localization for the requested locale
     const targetLocalizations = localizations[locale];
     if (targetLocalizations?.[key]) {
@@ -73,36 +78,11 @@ function getLocalizedSubCommandDescription(command, subCommandName, defaultDescr
         return enLocalizations[key];
     }
     else {
-        throw new Error(`Missing localization for subcommand '${subCommandName}' in command '${command.name}'`);
-    }
-}
-/**
- * @description Gets localized description for a subcommand option.
- * Supports multiple languages and falls back to default description if not found.
- * @param {ModularCommand} command The command instance.
- * @param {string} subCommandName The name of the subcommand.
- * @param {string} optionName The name of the option.
- * @param {string} defaultDescription The default description.
- * @param {string} locale The locale to use (defaults to EnglishUS).
- * @returns {string} The localized description.
- */
-function getLocalizedOptionDescription(command, subCommandName, optionName, defaultDescription, locale = discord_js_1.Locale.EnglishUS) {
-    if (!command.subCommandLocalizations)
-        return defaultDescription;
-    const localizations = command.subCommandLocalizations;
-    const key = `${subCommandName}.${optionName}.description`;
-    // Try to get the localization for the requested locale
-    const targetLocalizations = localizations[locale];
-    if (targetLocalizations?.[key]) {
-        return targetLocalizations[key];
-    }
-    // Fall back to English if the requested locale is not found
-    const enLocalizations = localizations[discord_js_1.Locale.EnglishUS];
-    if (enLocalizations?.[key]) {
-        return enLocalizations[key];
-    }
-    else {
-        throw new Error(`Missing localization for option '${optionName}' in subcommand '${subCommandName}' for command '${command.name}'`);
+        // Build appropriate error message
+        const context = optionName
+            ? `option '${optionName}' in subcommand '${subCommandName}' for command '${command.name}'`
+            : `subcommand '${subCommandName}' in command '${command.name}'`;
+        throw new Error(`Missing localization for ${context}`);
     }
 }
 /**
@@ -125,6 +105,31 @@ function createOptionBuilder(opt, description) {
         return option;
     };
 }
+/**
+ * @description Processes and adds a single option to a subcommand builder.
+ * This helper function encapsulates the logic for retrieving localized descriptions
+ * and adding options to subcommands, improving code maintainability.
+ * @param {SlashCommandSubcommandBuilder} subcommand The subcommand builder to add the option to.
+ * @param {CommandOption} opt The option to add.
+ * @param {string} subCommandName The name of the subcommand (used for localization).
+ * @param {ModularCommand} command The command instance (used for localization).
+ * @param {Record<string, OptionType>} options The options record to populate.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function addSubCommandOption(subcommand, opt, subCommandName, command, options) {
+    // Get base description
+    let description = typeof opt.description === 'string'
+        ? opt.description
+        : (opt.description[discord_js_1.Locale.EnglishUS] || `The description for ${opt.name} in English.`);
+    // Apply subcommand-specific localization
+    description = getLocalizedSubCommandValue(command, subCommandName, opt.name, description);
+    if (!description) {
+        throw new Error(`Option '${opt.name}' in subcommand '${subCommandName}' is missing a description.`);
+    }
+    options[opt.name] = opt.type;
+    const optionBuilder = createOptionBuilder(opt, description);
+    addOptionToBuilder(subcommand, opt, optionBuilder);
+}
 /**
  * @description Adds an option to a command or subcommand builder based on its type.
  * @param {any} builder The command or subcommand builder.
@@ -172,29 +177,18 @@ function processSubCommands(commandBuilder, command, options) {
             if (typeof subCmd.name !== 'string' || subCmd.name.trim() === '') {
                 throw new Error("A subcommand is missing a name.");
             }
-            // Get localized description for subcommand
-            const subCmdDescription = getLocalizedSubCommandDescription(command, subCmd.name, subCmd.description);
+            // Get localized description for subcommand (pass null for optionName to get subcommand description)
+            const subCmdDescription = getLocalizedSubCommandValue(command, subCmd.name, null, subCmd.description);
             if (typeof subCmdDescription !== 'string' || subCmdDescription.trim() === '') {
                 throw new Error(`Subcommand '${subCmd.name}' is missing a description.`);
             }
             subcommand
                 .setName(subCmd.name)
                 .setDescription(subCmdDescription);
-            // Add options to the subcommand
+            // Add options to the subcommand using the helper function
             if (subCmd.options) {
                 subCmd.options.forEach(opt => {
-                    // Get base description
-                    let description = typeof opt.description === 'string'
-                        ? opt.description
-                        : (opt.description[discord_js_1.Locale.EnglishUS] || `The description for ${opt.name} in English.`);
-                    // Apply subcommand-specific localization
-                    description = getLocalizedOptionDescription(command, subCmd.name, opt.name, description);
-                    if (!description) {
-                        throw new Error(`Option '${opt.name}' in subcommand '${subCmd.name}' is missing a description.`);
-                    }
-                    options[opt.name] = opt.type;
-                    const optionBuilder = createOptionBuilder(opt, description);
-                    addOptionToBuilder(subcommand, opt, optionBuilder);
+                    addSubCommandOption(subcommand, opt, subCmd.name, command, options);
                 });
             }
             return subcommand;
@@ -313,6 +307,9 @@ function createChatInputExecutor(command, options) {
         }
         // Add the current subcommand to args if it exists
         if (currentSubcommand) {
+            if ('subcommand' in args) {
+                console.warn(`Warning: 'subcommand' key already exists in args for command ${command.name}. Overwriting.`);
+            }
             args['subcommand'] = currentSubcommand;
         }
         const locale = getCommandLocale(command, interaction);
@@ -375,9 +372,13 @@ function createButtonExecutor(command) {
         const buttonObject = command.buttons.get(interaction.customId.split('_')[1]);
         if (!buttonObject)
             return;
-        if (!buttonObject.allowOthers && interaction.user.id !== interaction.message.author.id) {
-            await interaction.reply({ content: locales_1.LOCALE_FORBIDDEN[interaction.locale], flags: discord_js_1.MessageFlags.Ephemeral });
-            return;
+        // Check if the button is allowed to be used by others
+        if (buttonObject.allowOthers === false) {
+            const interactionData = interaction.message.interactionMetadata;
+            if (interactionData !== null && interactionData.user.id !== interaction.user.id) {
+                await interaction.reply({ content: locales_1.LOCALE_FORBIDDEN[interaction.locale], flags: discord_js_1.MessageFlags.Ephemeral });
+                return;
+            }
         }
         await buttonObject.execute({
             interaction,
@@ -429,7 +430,7 @@ function RegisterCommand(commands) {
             throw new Error("A command is missing a name.");
         }
         if (typeof command.description !== 'string' || command.description.trim() === '') {
-            throw new Error(`Command "${command.name}" is missing a description.`);
+            throw new Error(`Command "${command.name}" doesn't have a description.`);
         }
         // Build SlashCommand Data
         const commandBuilder = new discord_js_1.SlashCommandBuilder()

package/package.json

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