wynham-games 1.0.0-beta.10

package/dist/locales/it.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = {
+    manager: {
+        alreadyPlaying: (time) => `> ❌ Sei già in una partita contro questo utente. Attendi ${time}s prima di riprovare.`,
+        selfPlay: "> `❌` Non puoi giocare contro te stesso.",
+        cantPlayWithBot: "> `❌` Non puoi giocare con un bot.",
+        wait: (time) => `Attendi ${time}s prima di poter utilizzare nuovamente il comando.`,
+    },
+    invite: {
+        question: (mention) => `${mention}, accetti la sfida?`,
+        notYourChallenge: "> `❌` Questa sfida non ti riguarda.",
+        timeout: (username) => `> \`⏱️\` **${username}** non ha risposto alla sfida.`,
+        declined: (username) => `> \`❌\` **${username}** ha rifiutato la sfida.`,
+        accept: "Accetta",
+        decline: "Rifiuta",
+    },
+    difficulty: {
+        title: "## 🤖 Scegli difficoltà",
+        selectPrompt: "Seleziona la difficoltà dell'avversario.",
+        notYourChoice: "> `❌` Questa scelta non ti riguarda.",
+        expired: "> `⏱️` Selezione scaduta.",
+        starting: (label) => `⏳ Avvio in modalità **${label}**...`,
+        easy: "Facile",
+        normal: "Normale",
+        hard: "Difficile",
+        impossible: "Impossibile",
+    },
+    tictactoe: {
+        title: "Tris",
+        inviteTitle: "Sfida a Tris",
+        turn: (emoji, username) => `${emoji} Turno di **${username}**`,
+        win: (emoji, username) => `> \`🏆\` ${emoji} **${username}** ha vinto!`,
+        draw: "> `🤝` **Pareggio!**",
+        timeout: "> `⏱️` Tempo scaduto.",
+        cellTaken: "> `❌` Questa casella è già occupata.",
+        notYourTurn: "> `❌` Non è il tuo turno.",
+        notYourGame: "> `❌` Non fai parte di questa partita.",
+    },
+    connect4: {
+        title: "Forza Quattro",
+        inviteTitle: "Sfida a Forza Quattro",
+        column: (n) => `Colonna ${n}`,
+        choosePlaceholder: "Scegli una colonna…",
+        firstTurn: (emoji, username, timestamp) => `> ${emoji} Turno di **${username}** (<t:${timestamp}:R>)`,
+        turn: (emoji, username, timestamp) => `> ${emoji} Turno di **${username}** (<t:${timestamp}:R>)`,
+        turnTimeout: (emoji, username, timestamp) => `> \`⏱️\` Tempo scaduto — ${emoji} Turno di **${username}** (<t:${timestamp}:R>)`,
+        win: (emoji, username) => `> \`🏆\` ${emoji} **${username}** ha vinto!`,
+        draw: "> `🤝` **Pareggio!**",
+        timeout: "> `⏱️` Tempo scaduto.",
+        cancelledBothMissed: "> `⏱️` Nessuno ha giocato — partita annullata.",
+        notYourTurn: "> `❌` Non è il tuo turno.",
+        columnFull: "> `❌` Questa colonna è piena.",
+        notYourGame: "> `❌` Non fai parte di questa partita.",
+    },
+    rps: {
+        title: "Carta Forbice Sasso",
+        inviteTitle: "Sfida a Carta Forbice Sasso",
+        rock: "Sasso",
+        paper: "Carta",
+        scissors: "Forbice",
+        makeChoice: "Fai la tua scelta!",
+        notYourGame: "> `❌` Non fai parte di questa partita.",
+        alreadyChose: "> `❌` Hai già fatto la tua scelta!",
+        chose: (emoji, label) => `> \`✅\` **Hai scelto ${emoji} ${label}** — in attesa del tuo avversario…`,
+        waiting: (username) => `✅ **${username}** ha scelto — in attesa dell'altro giocatore…`,
+        tie: (reveal) => `🤝 **Pareggio!**\n\n${reveal}`,
+        win: (username, reveal) => `🏆 **${username}** vince!\n\n${reveal}`,
+        defaultWin: (username) => `⏱️ **${username}** vince per forfait — l'avversario non ha risposto.`,
+        timeout: "⏱️ Tempo scaduto — nessuno ha risposto.",
+    },
+    hangman: {
+        title: "Impiccato",
+        inviteTitle: "Sfida all'Impiccato",
+        words: [
+            "CASA",
+            "GIARDINO",
+            "MACCHINA",
+            "MUSICA",
+            "SOLE",
+            "MONTAGNA",
+            "FIUME",
+            "SPIAGGIA",
+            "CIOCCOLATO",
+            "FORMAGGIO",
+            "PANETTIERE",
+            "PESCE",
+            "ELEFANTE",
+            "GIRAFFA",
+            "FARFALLA",
+            "FIORE",
+            "FORESTA",
+            "NUVOLA",
+            "STELLA",
+            "PIANETA",
+            "DRAGO",
+            "CAVALIERE",
+            "PRINCIPESSA",
+            "CASTELLO",
+            "TESORO",
+            "AVVENTURA",
+            "COMPUTER",
+            "TELEFONO",
+            "INTERNET",
+            "TASTIERA",
+            "CHITARRA",
+            "PIANOFORTE",
+            "COCCODRILLO",
+            "SERPENTE",
+            "PAPPAGALLO",
+            "DELFINO",
+            "BALENA",
+            "BAGUETTE",
+            "CORNETTO",
+            "FUNGO",
+            "LIMONE",
+            "CALCIO",
+            "NUOTO",
+            "ARRAMPICATA",
+            "CICLISMO",
+            "MISTERO",
+            "FANTASMA",
+            "PIRATA",
+            "NINJA",
+            "GALASSIA",
+            "COMETA",
+            "VULCANO",
+            "SQUALO",
+            "PANTERA",
+            "VOLPE",
+            "GUFO",
+            "TARTARUGA",
+            "UNICORNO",
+            "VAMPIRO",
+            "STREGONE",
+            "DETECTIVE",
+            "ALCHIMISTA",
+            "BIBLIOTECA",
+            "CARTOGRAFIA",
+        ],
+        notYourTurn: "> `❌` Non è il tuo turno.",
+        notYourGame: "> `❌` Non fai parte di questa partita.",
+        alreadyGuessed: (letter) => `> \`❌\` Hai già proposto la lettera **${letter}**.`,
+        alreadyGuessedWord: (word) => `> \`❌\` La parola **${word}** è già stata proposta.`,
+        win: (username, word) => `> \`🎉\` **Bravo ${username}**! La parola era **${word}**.`,
+        lose: (word) => `> \`💀\` **Hai perso!** La parola era **${word}**.`,
+        turn: (username) => `Turno di **${username}** — Buona fortuna!`,
+        firstTurn: (username) => `Turno di **${username}** — Indovina la parola!`,
+        wrongLetters: (letters) => `Lettere o parole sbagliate: **${letters}**`,
+        noWrongLetters: "*Nessuna lettera sbagliata per ora.*",
+        menuLettersAM: "Lettere A → M",
+        menuLettersNZ: "Lettere N → Z",
+        guessButton: "Indovina la parola",
+        modalTitle: "Indovina la parola",
+        modalLabel: "Indovina la parola",
+        timeout: (word) => `> \`⏱️\` Tempo scaduto — La parola era **${word}**.`,
+    },
+    snake: {
+        title: "Snake",
+        start: "> `🎮` Usa i pulsanti per muoverti. Mangia la 🍎 ed evita i muri e la tua stessa coda!",
+        score: (score) => `> \`🍎\` Punteggio: **${score}**`,
+        gameOver: (score) => `> \`💀\` **Partita finita!** Punteggio finale: **${score}**.`,
+        quit: (score) => `> \`🛑\` **Partita interrotta.** Punteggio finale: **${score}**.`,
+        win: (score) => `> \`🏆\` **Hai riempito tutto il tabellone!** Punteggio finale: **${score}**.`,
+        timeout: (score) => `> \`⏱️\` Tempo scaduto — Punteggio finale: **${score}**.`,
+        notYourGame: "> `❌` Questa non è la tua partita.",
+    },
+};
+//# sourceMappingURL=it.js.map

package/dist/locales/it.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"it.js","sourceRoot":"","sources":["../../src/locales/it.ts"],"names":[],"mappings":"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"}

package/dist/structures/GameManager.d.ts

@@ -0,0 +1,32 @@
+import { type Connect4Options, type RPSOptions, type TicTacToeOptions, type HangmanOptions, type SnakeOptions, type GameManagerOptions, GameNameType } from "../structures/Types";
+import { Client, Interaction } from "discord.js";
+import { CooldownsManager } from "./Utils";
+export declare class GameManager {
+    /** The bot's client instance. */
+    readonly client: Client;
+    /** The manager's configuration options. */
+    readonly options: GameManagerOptions;
+    /** Cooldowns manager */
+    readonly cooldowns: typeof CooldownsManager;
+    /**
+     * @param client Your bot's Discord.js client.
+     * @param options Manager configuration options.
+     */
+    constructor(client: Client, options?: GameManagerOptions);
+    /** Validates the given options */
+    private valideOptions;
+    /**
+     * Validates the players, shows the invite and launches the game.
+     * @param gameName The game to launch (see `GameNameType`).
+     * @param interaction The slash command interaction that triggers the game.
+     * @param options Players and visual customization.
+     */
+    createGame(gameName: GameNameType.Connect4, interaction: Interaction, options: Connect4Options): Promise<void>;
+    createGame(gameName: GameNameType.RPS, interaction: Interaction, options: RPSOptions): Promise<void>;
+    createGame(gameName: GameNameType.TicTacToe, interaction: Interaction, options: TicTacToeOptions): Promise<void>;
+    createGame(gameName: GameNameType.Hangman, interaction: Interaction, options: HangmanOptions): Promise<void>;
+    createGame(gameName: GameNameType.Snake, interaction: Interaction, options: SnakeOptions): Promise<void>;
+    /** Checks that players are valid (not the same user, not a bot as challenger). */
+    private validatePlayers;
+}
+//# sourceMappingURL=GameManager.d.ts.map

package/dist/structures/GameManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameManager.d.ts","sourceRoot":"","sources":["../../src/structures/GameManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,kBAAkB,EAAmB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClM,OAAO,EAAE,MAAM,EAAU,WAAW,EAA8B,MAAM,YAAY,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,qBAAa,WAAW;IACpB,iCAAiC;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,2CAA2C;IAC3C,SAAgB,OAAO,EAAE,kBAAkB,CAAC;IAC5C,wBAAwB;IACxB,SAAgB,SAAS,0BAAoB;IAE7C;;;OAGG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAaxD,kCAAkC;IAClC,OAAO,CAAC,aAAa;IAUrB;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9G,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IACpG,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAChH,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5G,UAAU,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4JxG,kFAAkF;YACpE,eAAe;CAsBhC"}

package/dist/structures/GameManager.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameManager = void 0;
+const Types_1 = require("../structures/Types");
+const discord_js_1 = require("discord.js");
+const games_1 = require("../games");
+const Utils_1 = require("../structures/Utils");
+const Utils_2 = require("./Utils");
+const locales_1 = require("../locales");
+class GameManager {
+    /** The bot's client instance. */
+    client;
+    /** The manager's configuration options. */
+    options;
+    /** Cooldowns manager */
+    cooldowns = Utils_2.CooldownsManager;
+    /**
+     * @param client Your bot's Discord.js client.
+     * @param options Manager configuration options.
+     */
+    constructor(client, options) {
+        this.valideOptions(client, options);
+        this.client = client;
+        this.options = {
+            antiSpam: {
+                enable: options?.antiSpam?.enable ?? true,
+                time: options?.antiSpam?.time ?? 5_000,
+            },
+            locale: options?.locale ?? discord_js_1.Locale.EnglishUS,
+        };
+    }
+    /** Validates the given options */
+    valideOptions(client, options) {
+        if (!client)
+            throw new Error("Client is required");
+        const supportedLocales = Object.keys(locales_1.locales);
+        if (options) {
+            if (options.locale && !supportedLocales.includes(options.locale))
+                throw new Error(`Locale "${options.locale}" is not supported. Available: ${supportedLocales.join(", ")}`);
+            if (options.antiSpam && !options.antiSpam.enable && (options.antiSpam.time ?? 5_000) <= 0)
+                throw new Error("Time must be greater than 0");
+        }
+    }
+    async createGame(gameName, interaction, options) {
+        if (!interaction.isRepliable())
+            throw new Error("Interaction is not repliable.");
+        if (!interaction.deferred && !interaction.replied)
+            await interaction.deferReply();
+        (0, Utils_1.gameCheck)(options);
+        const gameLocale = (0, Utils_1.getLang)(options.locale);
+        // Snake is single-player: no invite, no second player.
+        if (gameName === Types_1.GameNameType.Snake) {
+            const opt = options;
+            if (opt.player.bot) {
+                return void (await interaction.followUp({
+                    embeds: [{ description: gameLocale.manager.cantPlayWithBot, color: discord_js_1.Colors.Red }],
+                    flags: discord_js_1.MessageFlags.Ephemeral,
+                }));
+            }
+            const cooldownKey = `${opt.player.id}-${gameName}`;
+            const playing = this.cooldowns.see(cooldownKey);
+            if (playing) {
+                return void (await interaction.followUp({ embeds: [{ description: gameLocale.manager.alreadyPlaying(playing), color: discord_js_1.Colors.Red }] }));
+            }
+            if (this.options.antiSpam && this.options.antiSpam.enable && this.options.antiSpam.time) {
+                const spamKey = `${opt.player.id}-spam`;
+                const time = this.cooldowns.see(spamKey);
+                if (time) {
+                    return void (await interaction.followUp({ embeds: [{ description: gameLocale.manager.wait(time), color: discord_js_1.Colors.Red }] }));
+                }
+                this.cooldowns.add(spamKey, this.options.antiSpam.time);
+            }
+            await new games_1.Snake(this, interaction, opt, gameLocale).launch();
+            return;
+        }
+        const { players: [player1, player2], players, } = options;
+        const time = this.cooldowns.see(`${player1.id}-${player2.id}-${gameName}`);
+        if (time)
+            return void (await interaction.followUp({ embeds: [{ description: gameLocale.manager.alreadyPlaying(time), color: discord_js_1.Colors.Red }] }));
+        if (this.options.antiSpam && this.options.antiSpam.enable && this.options.antiSpam.time) {
+            const cacheKey = `${[player1.id, player2.id].sort().join("-")}`;
+            const time = this.cooldowns.see(cacheKey);
+            if (time) {
+                return void (await interaction.followUp({
+                    embeds: [{ description: gameLocale.manager.wait(time), color: discord_js_1.Colors.Red }],
+                }));
+            }
+            this.cooldowns.add(cacheKey, this.options.antiSpam.time);
+        }
+        switch (gameName) {
+            case Types_1.GameNameType.Connect4: {
+                const validate = await this.validatePlayers(interaction, players, gameLocale);
+                if (!validate)
+                    return;
+                const opt = options;
+                const menuWait = new Utils_1.MenuWaitPlayer(this, interaction, Types_1.GameNameType.Connect4, players, {
+                    title: gameLocale.connect4.inviteTitle,
+                }, opt.locale);
+                if (!(await menuWait.verify()))
+                    return;
+                await new games_1.Connect4(this, interaction, opt, gameLocale).launch();
+                break;
+            }
+            case Types_1.GameNameType.RPS: {
+                const opt = options;
+                if (player2.bot) {
+                    await new games_1.RPS(this, interaction, opt, gameLocale).launch();
+                }
+                else {
+                    const validate = await this.validatePlayers(interaction, players, gameLocale);
+                    if (!validate)
+                        return;
+                    const menuWait = new Utils_1.MenuWaitPlayer(this, interaction, Types_1.GameNameType.RPS, players, {
+                        title: gameLocale.rps.inviteTitle,
+                    }, opt.locale);
+                    if (!(await menuWait.verify()))
+                        return;
+                    await new games_1.RPS(this, interaction, opt, gameLocale).launch();
+                }
+                break;
+            }
+            case Types_1.GameNameType.TicTacToe: {
+                const opt = options;
+                if (player2.bot) {
+                    const diff = await new Utils_1.MenuSelectDifficulty(this, interaction, Types_1.GameNameType.TicTacToe, players, opt.locale).waitForAnswer();
+                    if (!diff)
+                        break;
+                    await new games_1.TicTacToe(this, interaction, { ...opt, difficulty: diff.difficulty }, gameLocale).launch();
+                }
+                else {
+                    const validate = await this.validatePlayers(interaction, players, gameLocale);
+                    if (!validate)
+                        return;
+                    const menuWait = new Utils_1.MenuWaitPlayer(this, interaction, Types_1.GameNameType.TicTacToe, players, {
+                        title: gameLocale.tictactoe.inviteTitle,
+                    }, opt.locale);
+                    if (!(await menuWait.verify()))
+                        return;
+                    await new games_1.TicTacToe(this, interaction, opt, gameLocale).launch();
+                }
+                break;
+            }
+            case Types_1.GameNameType.Hangman: {
+                const validate = await this.validatePlayers(interaction, players, gameLocale);
+                if (!validate)
+                    return;
+                const opt = options;
+                const waitPlayer = new Utils_1.MenuWaitPlayer(this, interaction, Types_1.GameNameType.Hangman, players, {
+                    title: gameLocale.hangman.inviteTitle,
+                }, opt.locale);
+                if (!(await waitPlayer.verify()))
+                    return;
+                await new games_1.Hangman(this, interaction, opt, gameLocale).launch();
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    /** Checks that players are valid (not the same user, not a bot as challenger). */
+    async validatePlayers(interaction, players, locale) {
+        if (!interaction.isRepliable())
+            return false;
+        const [player1, player2] = players;
+        if (player1.id === player2.id) {
+            await interaction.followUp({
+                embeds: [{ description: locale.manager.selfPlay, color: discord_js_1.Colors.Red }],
+                flags: discord_js_1.MessageFlags.Ephemeral,
+            });
+            return false;
+        }
+        if (player2.bot || player1.bot) {
+            await interaction.followUp({
+                embeds: [{ description: locale.manager.cantPlayWithBot, color: discord_js_1.Colors.Red }],
+                flags: discord_js_1.MessageFlags.Ephemeral,
+            });
+            return false;
+        }
+        return true;
+    }
+}
+exports.GameManager = GameManager;
+//# sourceMappingURL=GameManager.js.map

package/dist/structures/GameManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameManager.js","sourceRoot":"","sources":["../../src/structures/GameManager.ts"],"names":[],"mappings":"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"}

package/dist/structures/Types.d.ts

@@ -0,0 +1,241 @@
+import type { Locale, User } from "discord.js";
+import type { WynHamLocales } from "../locales";
+export * from "../locales";
+export interface GameManagerOptions {
+    /** Enable antispam — prevents the same user from starting two games within 15 minutes. Default: `true`. time in ms default: 5_000 */
+    antiSpam?: {
+        enable?: boolean;
+        time?: number;
+    };
+    /**
+     * Default Discord locale for all games created by this manager.
+     * Individual game options can override this. Accepts `Locale.French`, `interaction.guildLocale`, etc.
+     * Default: `Locale.EnglishUS`.
+     */
+    locale?: Locale;
+}
+export interface IGame {
+    launch(): Promise<void>;
+}
+export declare enum GameNameType {
+    Connect4 = "Connect4",
+    RPS = "RPS",
+    TicTacToe = "TicTacToe",
+    Hangman = "Hangman",
+    Snake = "Snake"
+}
+export declare enum BotDifficulty {
+    Easy = "easy",
+    Normal = "normal",
+    Hard = "hard",
+    Impossible = "impossible"
+}
+export declare enum InviteResult {
+    Accepted = "accepted",
+    Declined = "declined",
+    Timeout = "timeout"
+}
+export declare enum Choice {
+    Rock = "rock",
+    Paper = "paper",
+    Scissors = "scissors"
+}
+export declare enum InputType {
+    SelectMenu = "select",
+    Buttons = "buttons"
+}
+export interface Connect4Options {
+    /** Array of the 2 players. */
+    players: [User, User];
+    /** Max time (in seconds) a player has to take their turn before the game ends. Default: `30` seconds. */
+    turnTimeout?: number;
+    /** Discord locale for all in-game strings. Accepts `interaction.locale` or `Locale.French` etc. Default: `Locale.EnglishUS`. */
+    locale?: Locale;
+    /** Theme settings. */
+    theme?: {
+        /** Colors for the game board. */
+        colors?: {
+            /** Color during the game. Default: `0x5865f2` */
+            play?: number;
+            /** Color when a player wins. Default: `0xffd700` */
+            win?: number;
+            /** Color on draw or timeout. Default: `0x808080` */
+            draw?: number;
+        };
+        /** Emojis for the game board. */
+        emojis?: {
+            /** Player 1 pieces. Default: `🔴` */
+            player1?: string;
+            /** Player 2 pieces. Default: `🟡` */
+            player2?: string;
+            /** Empty cells. Default: `⬛` */
+            empty?: string;
+            /** Winning combination pieces. Default: `⚪` */
+            win?: string;
+        };
+        /** Column input mode. `InputType.Buttons` (default) or `InputType.SelectMenu` dropdown. */
+        inputType?: InputType;
+    };
+    /** Language settings. */
+    lang?: {
+        /** Title displayed on the game board. Default: `"Connect Four"` */
+        title?: string;
+        /** Title displayed in the invite message. Default: `"Connect Four Challenge"` */
+        inviteTitle?: string;
+    };
+}
+export interface RPSOptions {
+    /** Array of the 2 players. */
+    players: [User, User];
+    /** Max time (in seconds) a player has to make their choice before the game ends. Default: `30` seconds. */
+    turnTimeout?: number;
+    /** Discord locale for all in-game strings. Accepts `interaction.locale` or `Locale.French` etc. Default: `Locale.EnglishUS`. */
+    locale?: Locale;
+    /** Theme settings. */
+    theme?: {
+        colors?: {
+            /** Color during the game. Default: `0x5865f2` */
+            play?: number;
+            /** Color when a player wins. Default: `0xffd700` */
+            win?: number;
+            /** Color on tie or timeout. Default: `0x808080` */
+            draw?: number;
+        };
+        emojis?: {
+            /** Default: `✊` */
+            rock?: string;
+            /** Default: `🤚` */
+            paper?: string;
+            /** Default: `✌️` */
+            scissors?: string;
+        };
+    };
+    lang?: {
+        /** Title displayed on the game board. Default: `"Rock Paper Scissors"` */
+        title?: string;
+        /** Title displayed in the invite message. Default: `"Rock Paper Scissors Challenge"` */
+        inviteTitle?: string;
+    };
+}
+export interface TicTacToeOptions {
+    /** Array of the 2 players. */
+    players: [User, User];
+    /** Max time (in seconds) a player has to take their turn before the game ends. Default: `30` seconds. */
+    turnTimeout?: number;
+    /**
+     * Bot difficulty — only used if player 2 is a bot.
+     * - `Easy` — always random.
+     * - `Normal` — plays optimally ~50% of the time, otherwise random.
+     * - `Hard` — plays optimally ~80% of the time.
+     * - `Impossible` — always optimal (unbeatable).
+     *
+     * Default: `Hard`.
+     */
+    difficulty?: BotDifficulty;
+    /** Discord locale for all in-game strings. Accepts `interaction.locale` or `Locale.French` etc. Default: `Locale.EnglishUS`. */
+    locale?: Locale;
+    /** Theme settings. */
+    theme?: {
+        colors?: {
+            /** Color during the game. Default: `0x5865f2` */
+            play?: number;
+            /** Color when a player wins. Default: `0xffd700` */
+            win?: number;
+            /** Color on draw or timeout. Default: `0x808080` */
+            draw?: number;
+        };
+        emojis?: {
+            /** Player 1 pieces. Default: `❌` */
+            player1?: string;
+            /** Player 2 pieces. Default: `⭕` */
+            player2?: string;
+            /** Empty cells. Default: `⬜` */
+            empty?: string;
+        };
+    };
+    lang?: {
+        /** Title displayed on the game board. Default: `"Tic-Tac-Toe"` */
+        title?: string;
+        /** Title displayed in the invite message. Default: `"Tic-Tac-Toe Challenge"` */
+        inviteTitle?: string;
+    };
+}
+export interface HangmanOptions {
+    /** Array of the 2 players. */
+    players: [User, User];
+    /** Max time (in seconds) a player has to take their turn before the game ends. Default: `30` seconds. */
+    turnTimeout?: number;
+    /** Number of lives. Default: `6`. */
+    lifeCount?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+    /** Discord locale for all in-game strings and the word list. Overrides the GameManager locale. Default: `Locale.EnglishUS`. */
+    locale?: Locale;
+    /** Theme settings. */
+    theme?: {
+        colors?: {
+            /** Color during the game. Default: `0x5865f2` */
+            play?: number;
+            /** Color on win. Default: `0xffd700` */
+            win?: number;
+            /** Color on loss or timeout. Default: `0x808080` */
+            lose?: number;
+        };
+    };
+    lang?: {
+        /** Title displayed on the game board. Default: `"Hangman"` */
+        title?: string;
+        /** Title displayed in the invite message. Default: `"Hangman Challenge"` */
+        inviteTitle?: string;
+    };
+}
+export interface SnakeOptions {
+    /** The player. Snake is a single-player game, so only one user is required. */
+    player: User;
+    /** Max time (in seconds) the player can stay idle between two moves before the game ends. Default: `30` seconds. */
+    turnTimeout?: number;
+    /** Board width (number of cells). Clamped between `5` and `12`. Default: `10`. */
+    boardWidth?: number;
+    /** Board height (number of cells). Clamped between `5` and `12`. Default: `10`. */
+    boardHeight?: number;
+    /** Discord locale for all in-game strings. Accepts `interaction.locale` or `Locale.French` etc. Default: `Locale.EnglishUS`. */
+    locale?: Locale;
+    /** Theme settings. */
+    theme?: {
+        colors?: {
+            /** Color during the game. Default: `0x5865f2` */
+            play?: number;
+            /** Color when the board is fully filled (win). Default: `0xffd700` */
+            win?: number;
+            /** Color on game over or timeout. Default: `0x808080` */
+            lose?: number;
+        };
+        emojis?: {
+            /** Snake head. Default: `🟢` */
+            head?: string;
+            /** Snake body. Default: `🟩` */
+            body?: string;
+            /** Food. Default: `🍎` */
+            food?: string;
+            /** Empty cells. Default: `⬛` */
+            empty?: string;
+        };
+    };
+    lang?: {
+        /** Title displayed on the game board. Default: `"Snake"` */
+        title?: string;
+    };
+}
+export type GameOptionsType = Connect4Options | RPSOptions | TicTacToeOptions | HangmanOptions | SnakeOptions;
+/** Minimal structural interface for what game classes need from the manager. */
+export interface GameManagerType {
+    readonly cooldowns: {
+        add(key: string, time: number): void;
+        delete(key: string): void;
+        replace(key: string, time: number): void;
+        reset(key: string, time: number): void;
+        see(key: string): number;
+    };
+    readonly options: GameManagerOptions;
+}
+/** Union of all built-in locale types — hovering in your IDE shows the actual translated strings. */
+export type GameLocale = WynHamLocales;
+//# sourceMappingURL=Types.d.ts.map

package/dist/structures/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../src/structures/Types.ts"],"names":[],"mappings":"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"}