fbp-language 1.1.4 → 1.1.7

package/README.md

@@ -23,7 +23,7 @@ Puis, dans le `package.json` de ton projet :
     "start": "fbp run lancer"
   },
   "dependencies": {
-    "fbp-language": "^1.1.4"
+    "fbp-language": "^1.1.6"
   }
 }
 ```
@@ -129,7 +129,7 @@ npm test
 Les fichiers d'essai internes se trouvent dans `tests/fixtures`. Ils ne font pas partie du paquet publié.
 
 
-## Informations Discord dynamiques (v1.1.4)
+## Informations Discord dynamiques (v1.1.6)
 
 Les champs d'un embed peuvent récupérer les informations accessibles au moment où la commande est utilisée. Exemple :
 
@@ -149,3 +149,75 @@ discordChampDynamique("serveur-info", "Avatar", "discordAvatar")
 ```
 
 Sources disponibles : `discordServeur.nom`, `discordServeur.id`, `discordServeur.creation`, `discordMembres.nombre`, `discordProfil.nom`, `discordProfil.id`, `discordProfil.avatar`, `discordRoles.nombre`, `discordSalons.nombre`, `discordStatistiques.membres`, `discordStatistiques.roles`, `discordStatistiques.salons`, `discordLatence` et `discordAvatar`. `discordOptionUtilisateur(nomCommande, nomOption, description)` ajoute un sélecteur facultatif de membre à une commande embed. Les données accessibles dépendent des permissions et du cache Discord du bot.
+
+
+## Options des commandes slash (v1.1.6)
+
+Les commandes slash peuvent maintenant recevoir des options texte, nombre, entier ou booléen. Le dernier argument indique si l'option est obligatoire ; il est facultatif et vaut `false` par défaut.
+
+```fbp
+discordConnexion()
+discordCommande("bonjour", "Salut {{prenom}} !")
+discordOptionTexte("bonjour", "prenom", "Ton prénom", true)
+discordOptionEntier("bonjour", "age", "Ton âge")
+discordOptionNombre("bonjour", "note", "Une valeur décimale")
+discordOptionBooleen("bonjour", "confirme", "Confirmer ?")
+```
+
+Dans une réponse texte, `{{prenom}}` est remplacé par la valeur saisie. Pour les embeds, les champs dynamiques peuvent lire une option avec `discordChampDynamique("commande", "Champ", "option.prenom")` (ou `discordOption.prenom`). Les options absentes ne sont pas remplacées et une option obligatoire inaccessible produit une réponse d'erreur.
+
+Fonctions disponibles :
+
+- `discordOptionTexte(commande, nom, description, obligatoire)`
+- `discordOptionNombre(commande, nom, description, obligatoire)`
+- `discordOptionEntier(commande, nom, description, obligatoire)`
+- `discordOptionBooleen(commande, nom, description, obligatoire)`
+- `discordOptionUtilisateur(commande, nom, description)` pour le sélecteur de membre existant des commandes embed.
+
+Les noms d'options doivent respecter les règles Discord (minuscules, chiffres, tirets et underscores, 1 à 32 caractères). Une commande peut avoir jusqu'à 25 options. Les types d'options sont déclarés lors de l'enregistrement des commandes ; redémarre le bot après avoir modifié leur définition. Le bot a besoin du scope `applications.commands` et de l'accès au serveur concerné. Aucun intent privilégié supplémentaire n'est requis pour ces options.
+
+
+## Choix prédéfinis des options (v1.1.6)
+
+Pour limiter les réponses possibles d'une option, ajoute des choix après avoir déclaré l'option :
+
+```fbp
+discordConnexion()
+discordCommande("couleur", "Couleur choisie : {{couleur}}")
+discordOptionTexte("couleur", "couleur", "Choisis une couleur", true)
+discordChoixTexte("couleur", "couleur", "Bleu", "bleu")
+discordChoixTexte("couleur", "couleur", "Rouge", "rouge")
+
+discordCommande("difficulte", "Niveau choisi : {{niveau}}")
+discordOptionEntier("difficulte", "niveau", "Choisis un niveau", true)
+discordChoixEntier("difficulte", "niveau", "Facile", 1)
+discordChoixEntier("difficulte", "niveau", "Normal", 2)
+discordChoixEntier("difficulte", "niveau", "Difficile", 3)
+```
+
+- `discordChoixTexte(commande, option, nomChoix, valeur)` ajoute un choix à une option texte.
+- `discordChoixEntier(commande, option, nomChoix, valeur)` ajoute un choix à une option entière.
+- Déclare toujours l'option avant ses choix.
+- Une option peut avoir jusqu'à 25 choix. Les noms de choix sont limités à 100 caractères.
+- Les choix sont présentés par Discord sous forme de liste et la valeur choisie est récupérable comme les autres options.
+
+
+## Limites numériques des options (v1.1.7)
+
+Les options slash de type nombre et entier peuvent imposer une valeur minimale et maximale. Déclare l'option d'abord, puis ses limites :
+
+```fbp
+discordConnexion()
+discordCommande("age", "Âge sélectionné : {{age}}")
+discordOptionEntier("age", "age", "Choisis un âge", true)
+discordOptionEntierLimites("age", "age", 13, 99)
+
+discordCommande("note", "Note sélectionnée : {{note}}")
+discordOptionNombre("note", "note", "Choisis une note", true)
+discordOptionNombreLimites("note", "note", 0, 20)
+```
+
+- `discordOptionEntierLimites(commande, option, minimum, maximum)` accepte uniquement des bornes entières.
+- `discordOptionNombreLimites(commande, option, minimum, maximum)` accepte des bornes numériques, y compris décimales.
+- Le minimum doit être inférieur ou égal au maximum.
+- Les limites s'appliquent à l'interface Discord. Une option avec des choix prédéfinis ne peut pas recevoir de limites.

package/dist/cli.js

@@ -8,7 +8,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const compiler_1 = require("./compiler");
 const errors_1 = require("./errors");
-const VERSION = "1.1.4";
+const VERSION = "1.1.7";
 function help() {
     console.log(`FBP — French Bot Programming
 

package/dist/compiler.js

@@ -112,7 +112,7 @@ class FbpCompiler {
     constructor(options = {}) {
         this.output = options.onOutput ?? (value => console.log(value));
     }
-    resolveDiscordValue(source, interaction, selectedUser, selectedMember) {
+    resolveDiscordValue(source, interaction, selectedUser, selectedMember, optionValues) {
         const guild = interaction.guild;
         const values = {
             "discordServeur.nom": guild?.name ?? "Serveur indisponible",
@@ -130,6 +130,9 @@ class FbpCompiler {
             "discordLatence": String(Math.max(0, Math.round(interaction.client.ws.ping))) + " ms",
             "discordAvatar": selectedUser?.displayAvatarURL({ size: 256 }) ?? interaction.user.displayAvatarURL({ size: 256 })
         };
+        const optionMatch = source.trim().match(/^(?:discordOption|option)\.([a-z0-9_-]{1,32})$/);
+        if (optionMatch)
+            return optionValues.get(optionMatch[1]) ?? "Option indisponible : " + optionMatch[1];
         return source.trim() in values ? values[source.trim()] : "Source inconnue : " + source.trim();
     }
     runFile(filePath) {
@@ -217,6 +220,41 @@ class FbpCompiler {
                                 .setDescription(response.userOption.description)
                                 .setRequired(false));
                         }
+                        for (const option of response.options ?? []) {
+                            const add = {
+                                texte: () => builder.addStringOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "string")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                nombre: () => builder.addNumberOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    if (option.minValue !== undefined)
+                                        item.setMinValue(option.minValue);
+                                    if (option.maxValue !== undefined)
+                                        item.setMaxValue(option.maxValue);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "number")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                entier: () => builder.addIntegerOption(item => {
+                                    item.setName(option.name).setDescription(option.description).setRequired(option.required);
+                                    if (option.minValue !== undefined)
+                                        item.setMinValue(option.minValue);
+                                    if (option.maxValue !== undefined)
+                                        item.setMaxValue(option.maxValue);
+                                    for (const choice of option.choices ?? [])
+                                        if (typeof choice.value === "number")
+                                            item.addChoices({ name: choice.name, value: choice.value });
+                                    return item;
+                                }),
+                                booleen: () => builder.addBooleanOption(item => item.setName(option.name).setDescription(option.description).setRequired(option.required))
+                            }[option.type];
+                            add();
+                        }
                         return builder.toJSON();
                     });
                     const manager = client.application?.commands;
@@ -244,8 +282,33 @@ class FbpCompiler {
                 if (response === undefined)
                     return;
                 try {
+                    const optionValues = new Map();
+                    for (const option of response.options ?? []) {
+                        let value = null;
+                        if (option.type === "texte")
+                            value = interaction.options.getString(option.name);
+                        else if (option.type === "nombre") {
+                            const number = interaction.options.getNumber(option.name);
+                            value = number === null ? null : String(number);
+                        }
+                        else if (option.type === "entier") {
+                            const number = interaction.options.getInteger(option.name);
+                            value = number === null ? null : String(number);
+                        }
+                        else {
+                            const boolean = interaction.options.getBoolean(option.name);
+                            value = boolean === null ? null : String(boolean);
+                        }
+                        if (value === null && option.required) {
+                            await interaction.reply({ content: "Option obligatoire indisponible : " + option.name, ephemeral: true });
+                            return;
+                        }
+                        if (value !== null)
+                            optionValues.set(option.name, value);
+                    }
                     if (response.type === "text") {
-                        await interaction.reply(response.content);
+                        const content = response.content.replace(/\{\{([a-z0-9_-]{1,32})\}\}/g, (match, name) => optionValues.has(name) ? optionValues.get(name) : match);
+                        await interaction.reply(content);
                     }
                     else {
                         const embed = new discord_js_1.EmbedBuilder()
@@ -255,9 +318,11 @@ class FbpCompiler {
                         const guild = interaction.guild;
                         const selectedUser = response.userOption ? interaction.options.getUser(response.userOption.name) : null;
                         const selectedMember = selectedUser && guild ? await guild.members.fetch(selectedUser.id).catch(() => null) : null;
+                        if (response.userOption && selectedUser)
+                            optionValues.set(response.userOption.name, selectedMember?.displayName ?? selectedUser.username);
                         const fields = response.fields.map(field => ({
                             name: field.name,
-                            value: field.dynamic ? this.resolveDiscordValue(field.value, interaction, selectedUser, selectedMember) : field.value,
+                            value: field.dynamic ? this.resolveDiscordValue(field.value, interaction, selectedUser, selectedMember, optionValues) : field.value.replace(/\{\{([a-z0-9_-]{1,32})\}\}/g, (match, name) => optionValues.get(name) ?? match),
                             inline: false
                         }));
                         if (fields.length)
@@ -266,7 +331,11 @@ class FbpCompiler {
                     }
                 }
                 catch (error) {
+                    const message = "Une erreur est survenue pendant l'exécution de cette commande.";
                     this.output("Erreur Discord : " + (error instanceof Error ? error.message : String(error)));
+                    if (!interaction.replied && !interaction.deferred) {
+                        await interaction.reply({ content: message, ephemeral: true }).catch(() => undefined);
+                    }
                 }
             });
             void client.login(token).catch((error) => this.output("Connexion Discord impossible : " + (error instanceof Error ? error.message : String(error))));
@@ -282,7 +351,7 @@ class FbpCompiler {
             if (!/^[a-z0-9_-]{1,32}$/.test(commandName)) {
                 throw new errors_1.FbpError("Le nom d'une commande slash doit contenir 1 à 32 caractères : lettres minuscules, chiffres, tirets ou underscores.", undefined, line);
             }
-            this.discordCommands.set(commandName, { type: "text", content: values[1] });
+            this.discordCommands.set(commandName, { type: "text", content: values[1], options: [] });
             return;
         }
         if (name === "discordCommandeEmbed") {
@@ -296,7 +365,7 @@ class FbpCompiler {
                 throw new errors_1.FbpError("Le nom d'une commande slash doit contenir 1 à 32 caractères : lettres minuscules, chiffres, tirets ou underscores.", undefined, line);
             if (!/^#[0-9a-fA-F]{6}$/.test(color))
                 throw new errors_1.FbpError("La couleur d'un embed doit être au format hexadécimal, par exemple #5865F2.", undefined, line);
-            this.discordCommands.set(commandName, { type: "embed", title, description, color, fields: [] });
+            this.discordCommands.set(commandName, { type: "embed", title, description, color, fields: [], options: [] });
             return;
         }
         if (name === "discordChampDynamique") {
@@ -314,6 +383,83 @@ class FbpCompiler {
             command.fields.push({ name: fieldName, value: source, dynamic: true });
             return;
         }
+        if (name === "discordChoixTexte" || name === "discordChoixEntier") {
+            if (values.length !== 4 || values.some(value => typeof value !== "string" && typeof value !== "number")) {
+                throw new errors_1.FbpError("Utilisation : discordChoixTexte(nomCommande, nomOption, nomChoix, valeur) ou discordChoixEntier(...).", undefined, line);
+            }
+            const [commandName, optionName, choiceName, choiceValue] = values;
+            if (typeof commandName !== "string" || typeof optionName !== "string" || typeof choiceName !== "string") {
+                throw new errors_1.FbpError("Le nom de la commande, de l'option et du choix doivent être du texte.", undefined, line);
+            }
+            const command = this.discordCommands.get(commandName);
+            if (!command)
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas déclarée.", undefined, line);
+            const option = (command.options ?? []).find(item => item.name === optionName);
+            const expectedType = name === "discordChoixTexte" ? "texte" : "entier";
+            if (!option || option.type !== expectedType)
+                throw new errors_1.FbpError("L'option « " + optionName + " » n'existe pas ou n'a pas le bon type.", undefined, line);
+            if (!choiceName.trim() || choiceName.length > 100)
+                throw new errors_1.FbpError("Le nom d'un choix doit contenir de 1 à 100 caractères.", undefined, line);
+            if (expectedType === "texte" && typeof choiceValue !== "string")
+                throw new errors_1.FbpError("La valeur d'un choix texte doit être du texte.", undefined, line);
+            if (expectedType === "entier" && (typeof choiceValue !== "number" || !Number.isInteger(choiceValue)))
+                throw new errors_1.FbpError("La valeur d'un choix entier doit être un nombre entier.", undefined, line);
+            if (option.minValue !== undefined || option.maxValue !== undefined)
+                throw new errors_1.FbpError("Une option avec des limites numériques ne peut pas recevoir de choix prédéfinis.", undefined, line);
+            const choices = option.choices ?? (option.choices = []);
+            if (choices.some(choice => choice.name === choiceName || choice.value === choiceValue))
+                throw new errors_1.FbpError("Ce nom ou cette valeur de choix existe déjà.", undefined, line);
+            if (choices.length >= 25)
+                throw new errors_1.FbpError("Une option Discord ne peut pas contenir plus de 25 choix.", undefined, line);
+            choices.push({ name: choiceName, value: choiceValue });
+            return;
+        }
+        if (name === "discordOptionNombreLimites" || name === "discordOptionEntierLimites") {
+            if (values.length !== 4 || typeof values[0] !== "string" || typeof values[1] !== "string" || typeof values[2] !== "number" || typeof values[3] !== "number") {
+                throw new errors_1.FbpError("Utilisation : discordOptionNombreLimites(commande, option, minimum, maximum) ou discordOptionEntierLimites(...).", undefined, line);
+            }
+            const [commandName, optionName, minimum, maximum] = values;
+            const command = this.discordCommands.get(commandName);
+            if (!command)
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas déclarée.", undefined, line);
+            const expectedType = name === "discordOptionNombreLimites" ? "nombre" : "entier";
+            const option = (command.options ?? []).find(item => item.name === optionName);
+            if (!option || option.type !== expectedType)
+                throw new errors_1.FbpError("L'option « " + optionName + " » n'existe pas ou n'a pas le type numérique attendu.", undefined, line);
+            if (!Number.isFinite(minimum) || !Number.isFinite(maximum) || minimum > maximum || (expectedType === "entier" && (!Number.isInteger(minimum) || !Number.isInteger(maximum)))) {
+                throw new errors_1.FbpError("Les limites doivent être des nombres valides, minimum inférieur ou égal au maximum ; elles doivent être entières pour une option entière.", undefined, line);
+            }
+            if (option.choices?.length)
+                throw new errors_1.FbpError("Une option avec des choix prédéfinis ne peut pas recevoir de limites numériques.", undefined, line);
+            option.minValue = minimum;
+            option.maxValue = maximum;
+            return;
+        }
+        if (name === "discordOptionTexte" || name === "discordOptionNombre" || name === "discordOptionEntier" || name === "discordOptionBooleen") {
+            if (values.length < 3 || values.length > 4 || values.some(value => typeof value !== "string" && typeof value !== "boolean")) {
+                throw new errors_1.FbpError("Utilisation : discordOptionTexte/Nombre/Entier/Booleen(nomCommande, nomOption, description, obligatoire).", undefined, line);
+            }
+            const [commandName, optionName, description] = values;
+            const required = values.length === 4 ? values[3] : false;
+            if (typeof commandName !== "string" || typeof optionName !== "string" || typeof description !== "string" || typeof required !== "boolean") {
+                throw new errors_1.FbpError("Les trois premiers arguments doivent être du texte et le quatrième, facultatif, doit être true ou false.", undefined, line);
+            }
+            const command = this.discordCommands.get(commandName);
+            if (!command)
+                throw new errors_1.FbpError("La commande « " + commandName + " » n'est pas déclarée.", undefined, line);
+            if (!/^[a-z0-9_-]{1,32}$/.test(optionName))
+                throw new errors_1.FbpError("Le nom de l'option doit contenir 1 à 32 caractères minuscules, chiffres, tirets ou underscores.", undefined, line);
+            if (!description.trim() || description.length > 100)
+                throw new errors_1.FbpError("La description de l'option doit contenir 1 à 100 caractères.", undefined, line);
+            const options = command.options ?? (command.options = []);
+            if (options.some(option => option.name === optionName) || (command.type === "embed" && command.userOption?.name === optionName))
+                throw new errors_1.FbpError("L'option « " + optionName + " » existe déjà pour cette commande.", undefined, line);
+            if (options.length + (command.type === "embed" && command.userOption ? 1 : 0) >= 25)
+                throw new errors_1.FbpError("Une commande slash Discord ne peut pas contenir plus de 25 options.", undefined, line);
+            const type = name === "discordOptionTexte" ? "texte" : name === "discordOptionNombre" ? "nombre" : name === "discordOptionEntier" ? "entier" : "booleen";
+            options.push({ name: optionName, description, type, required });
+            return;
+        }
         if (name === "discordOptionUtilisateur") {
             if (values.length !== 3 || values.some(value => typeof value !== "string")) {
                 throw new errors_1.FbpError("Utilisation : discordOptionUtilisateur(nomCommande, nomOption, description).", undefined, line);
@@ -326,6 +472,11 @@ class FbpCompiler {
                 throw new errors_1.FbpError("Le nom de l'option doit contenir 1 à 32 caractères minuscules, chiffres, tirets ou underscores.", undefined, line);
             if (!description.trim() || description.length > 100)
                 throw new errors_1.FbpError("La description de l'option doit contenir 1 à 100 caractères.", undefined, line);
+            const options = command.options ?? (command.options = []);
+            if (options.some(option => option.name === optionName) || command.userOption?.name === optionName)
+                throw new errors_1.FbpError("L'option « " + optionName + " » existe déjà pour cette commande.", undefined, line);
+            if (options.length + 1 > 25)
+                throw new errors_1.FbpError("Une commande slash Discord ne peut pas contenir plus de 25 options.", undefined, line);
             command.userOption = { name: optionName, description };
             return;
         }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "fbp-language",
   "displayName": "FBP - French Bot Programming",
-  "description": "Langage FBP avec prise en charge des commandes slash et des embeds Discord.",
-  "version": "1.1.4",
+  "description": "Langage FBP avec options slash Discord, limites numériques, choix prédéfinis et embeds dynamiques.",
+  "version": "1.1.7",
   "type": "commonjs",
   "main": "dist/compiler.js",
   "bin": {