@azurioh/discord-kernel 0.1.0

package/dist/discord/events/create-event.d.ts

@@ -0,0 +1,5 @@
+import type { ClientEvents } from "discord.js";
+import type { DiscordEvent } from "../../discord/events/types";
+/** Helper to declare a {@link DiscordEvent} with full type inference on `args`. */
+export declare function createEvent<K extends keyof ClientEvents>(event: DiscordEvent<K>): DiscordEvent<K>;
+//# sourceMappingURL=create-event.d.ts.map

package/dist/discord/events/create-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event.d.ts","sourceRoot":"","sources":["../../../src/discord/events/create-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAEjG"}

package/dist/discord/events/create-event.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEvent = createEvent;
+/** Helper to declare a {@link DiscordEvent} with full type inference on `args`. */
+function createEvent(event) {
+    return event;
+}
+//# sourceMappingURL=create-event.js.map

package/dist/discord/events/create-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-event.js","sourceRoot":"","sources":["../../../src/discord/events/create-event.ts"],"names":[],"mappings":";;AAIA,kCAEC;AAHD,mFAAmF;AACnF,SAAgB,WAAW,CAA+B,KAAsB;IAC/E,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/discord/events/event-router.d.ts

@@ -0,0 +1,16 @@
+import type { Client } from "discord.js";
+import type { DiscordEvent } from "../../discord/events/types";
+import type { Logger } from "../../logger";
+/**
+ * Binds registered {@link DiscordEvent}s to a client. This is the only place in
+ * the app that calls `client.on`/`client.once`.
+ */
+export declare class EventRouter {
+    private readonly logger;
+    private readonly events;
+    constructor(logger: Logger);
+    register(event: DiscordEvent): this;
+    registerAll(events: Iterable<DiscordEvent>): this;
+    bind(client: Client): void;
+}
+//# sourceMappingURL=event-router.d.ts.map

package/dist/discord/events/event-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../../../src/discord/events/event-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAmBvC;;;GAGG;AACH,qBAAa,WAAW;IAGX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAEhB,MAAM,EAAE,MAAM;IAE3C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKnC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAOjD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAU1B"}

package/dist/discord/events/event-router.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventRouter = void 0;
+/**
+ * Wrap a handler so a thrown error is logged instead of escaping to the
+ * process-level `error` event: a failing handler must never take the bot down.
+ */
+function createEventListener(event, logger) {
+    return async (...args) => {
+        try {
+            await event.execute(...args);
+        }
+        catch (error) {
+            logger.error({ event: event.name, err: error instanceof Error ? error.message : String(error) }, "Event handler failed");
+        }
+    };
+}
+/**
+ * Binds registered {@link DiscordEvent}s to a client. This is the only place in
+ * the app that calls `client.on`/`client.once`.
+ */
+class EventRouter {
+    logger;
+    events = [];
+    constructor(logger) {
+        this.logger = logger;
+    }
+    register(event) {
+        this.events.push(event);
+        return this;
+    }
+    registerAll(events) {
+        for (const event of events) {
+            this.register(event);
+        }
+        return this;
+    }
+    bind(client) {
+        for (const event of this.events) {
+            const listener = createEventListener(event, this.logger);
+            if (event.once) {
+                client.once(event.name, listener);
+            }
+            else {
+                client.on(event.name, listener);
+            }
+        }
+    }
+}
+exports.EventRouter = EventRouter;
+//# sourceMappingURL=event-router.js.map

package/dist/discord/events/event-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-router.js","sourceRoot":"","sources":["../../../src/discord/events/event-router.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACH,SAAS,mBAAmB,CAAC,KAAmB,EAAE,MAAc;IAC/D,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACxB,IAAI,CAAC;YACJ,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CACX,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAClF,sBAAsB,CACtB,CAAC;QACH,CAAC;IACF,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAa,WAAW;IAGM;IAFZ,MAAM,GAAmB,EAAE,CAAC;IAE7C,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C,QAAQ,CAAC,KAAmB;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,WAAW,CAAC,MAA8B;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC,MAAc;QAClB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACzD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACjC,CAAC;QACF,CAAC;IACF,CAAC;CACD;AA3BD,kCA2BC"}

package/dist/discord/events/types.d.ts

@@ -0,0 +1,16 @@
+import type { ClientEvents } from "discord.js";
+/**
+ * A typed Discord gateway event handler. `name` is keyed to discord.js'
+ * {@link ClientEvents}, so `args` are inferred per event with no `any`.
+ */
+export interface DiscordEvent<K extends keyof ClientEvents = keyof ClientEvents> {
+    readonly name: K;
+    readonly once?: boolean;
+    execute(...args: ClientEvents[K]): Promise<void> | void;
+}
+/**
+ * The listener actually handed to discord.js. It is type-erased over every event
+ * name because the router holds heterogeneous events in a single collection.
+ */
+export type EventListener = (...args: ClientEvents[keyof ClientEvents]) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/discord/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/discord/events/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,YAAY,GAAG,MAAM,YAAY;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,YAAY,CAAC,MAAM,YAAY,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/discord/events/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/discord/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/discord/events/types.ts"],"names":[],"mappings":""}

package/dist/discord/i18n.d.ts

@@ -0,0 +1,58 @@
+import type { Catalog } from "../i18n";
+/** Catalog keys for the framework's own feedback, under the `core.` namespace. */
+export declare const CORE_MESSAGES: {
+    readonly presenterSuccessTitle: "core.presenter.success-title";
+    readonly presenterWarningTitle: "core.presenter.warning-title";
+    readonly presenterErrorTitle: "core.presenter.error-title";
+    readonly presenterDenialTitle: "core.presenter.denial-title";
+    readonly presenterIncidentFooter: "core.presenter.incident-footer";
+    readonly unknownSubcommand: "core.command.unknown-subcommand";
+    readonly genericError: "core.command.generic-error";
+    readonly cooldownWait: "core.cooldown.wait";
+    readonly guardPermissionDenied: "core.guard.permission-denied";
+    readonly guardRoleDenied: "core.guard.role-denied";
+    readonly guardGuildOnly: "core.guard.guild-only";
+};
+/**
+ * Catalog keys for the settings editor's own chrome — the wording that is the
+ * same whatever is being edited.
+ *
+ * Deliberately *not* the wording of the settings themselves: a field's label and
+ * its one-line hint name something only the calling module knows about, so those
+ * stay in that module's catalog and reach the editor as keys.
+ */
+export declare const SETTINGS_EDITOR_MESSAGES: {
+    readonly modalTitle: "core.settings-editor.modal-title";
+    readonly modalHelper: "core.settings-editor.modal-helper";
+    readonly modalUploadLabel: "core.settings-editor.modal-upload-label";
+    readonly modalUploadHelper: "core.settings-editor.modal-upload-helper";
+    readonly modalImageUrlLabel: "core.settings-editor.modal-image-url-label";
+    readonly modalImageHelper: "core.settings-editor.modal-image-helper";
+    readonly modalImageHelperUploaded: "core.settings-editor.modal-image-helper-uploaded";
+    readonly fieldSaved: "core.settings-editor.field-saved";
+    readonly fieldCleared: "core.settings-editor.field-cleared";
+    readonly fieldUploaded: "core.settings-editor.field-uploaded";
+    readonly resetButton: "core.settings-editor.reset-button";
+    readonly resetConfirmTitle: "core.settings-editor.reset-confirm-title";
+    readonly resetConfirmDescription: "core.settings-editor.reset-confirm-description";
+    readonly resetConfirmButton: "core.settings-editor.reset-confirm-button";
+    readonly resetCancelButton: "core.settings-editor.reset-cancel-button";
+    readonly resetDone: "core.settings-editor.reset-done";
+    readonly resetCancelled: "core.settings-editor.reset-cancelled";
+    readonly backButton: "core.settings-editor.back-button";
+    /**
+     * A card screen's per-entry button: what selecting the entry from the old
+     * field menu used to do, now spelled on the button that replaces it. One
+     * wording for a field that opens a modal, another for one that descends a
+     * level — both generic enough that no card screen has ever needed its own.
+     */
+    readonly editFieldButton: "core.settings-editor.edit-field-button";
+    readonly openLevelButton: "core.settings-editor.open-level-button";
+};
+/**
+ * The framework's own strings: presenter titles, the incident footer, dispatch
+ * fallbacks and the default cooldown notice. Registered by the composition root
+ * before any module catalog.
+ */
+export declare const CORE_CATALOG: Catalog;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/discord/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/discord/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,kFAAkF;AAClF,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYhB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;IAmBpC;;;;;OAKG;;;CAGM,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAiH1B,CAAC"}

package/dist/discord/i18n.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_CATALOG = exports.SETTINGS_EDITOR_MESSAGES = exports.CORE_MESSAGES = void 0;
+/** Catalog keys for the framework's own feedback, under the `core.` namespace. */
+exports.CORE_MESSAGES = {
+    presenterSuccessTitle: "core.presenter.success-title",
+    presenterWarningTitle: "core.presenter.warning-title",
+    presenterErrorTitle: "core.presenter.error-title",
+    presenterDenialTitle: "core.presenter.denial-title",
+    presenterIncidentFooter: "core.presenter.incident-footer",
+    unknownSubcommand: "core.command.unknown-subcommand",
+    genericError: "core.command.generic-error",
+    cooldownWait: "core.cooldown.wait",
+    guardPermissionDenied: "core.guard.permission-denied",
+    guardRoleDenied: "core.guard.role-denied",
+    guardGuildOnly: "core.guard.guild-only",
+};
+/**
+ * Catalog keys for the settings editor's own chrome — the wording that is the
+ * same whatever is being edited.
+ *
+ * Deliberately *not* the wording of the settings themselves: a field's label and
+ * its one-line hint name something only the calling module knows about, so those
+ * stay in that module's catalog and reach the editor as keys.
+ */
+exports.SETTINGS_EDITOR_MESSAGES = {
+    modalTitle: "core.settings-editor.modal-title",
+    modalHelper: "core.settings-editor.modal-helper",
+    modalUploadLabel: "core.settings-editor.modal-upload-label",
+    modalUploadHelper: "core.settings-editor.modal-upload-helper",
+    modalImageUrlLabel: "core.settings-editor.modal-image-url-label",
+    modalImageHelper: "core.settings-editor.modal-image-helper",
+    modalImageHelperUploaded: "core.settings-editor.modal-image-helper-uploaded",
+    fieldSaved: "core.settings-editor.field-saved",
+    fieldCleared: "core.settings-editor.field-cleared",
+    fieldUploaded: "core.settings-editor.field-uploaded",
+    resetButton: "core.settings-editor.reset-button",
+    resetConfirmTitle: "core.settings-editor.reset-confirm-title",
+    resetConfirmDescription: "core.settings-editor.reset-confirm-description",
+    resetConfirmButton: "core.settings-editor.reset-confirm-button",
+    resetCancelButton: "core.settings-editor.reset-cancel-button",
+    resetDone: "core.settings-editor.reset-done",
+    resetCancelled: "core.settings-editor.reset-cancelled",
+    backButton: "core.settings-editor.back-button",
+    /**
+     * A card screen's per-entry button: what selecting the entry from the old
+     * field menu used to do, now spelled on the button that replaces it. One
+     * wording for a field that opens a modal, another for one that descends a
+     * level — both generic enough that no card screen has ever needed its own.
+     */
+    editFieldButton: "core.settings-editor.edit-field-button",
+    openLevelButton: "core.settings-editor.open-level-button",
+};
+/**
+ * The framework's own strings: presenter titles, the incident footer, dispatch
+ * fallbacks and the default cooldown notice. Registered by the composition root
+ * before any module catalog.
+ */
+exports.CORE_CATALOG = {
+    [exports.CORE_MESSAGES.presenterSuccessTitle]: { en: "Success", fr: "Succès" },
+    [exports.CORE_MESSAGES.presenterWarningTitle]: { en: "Warning", fr: "Avertissement" },
+    [exports.CORE_MESSAGES.presenterErrorTitle]: { en: "Error", fr: "Erreur" },
+    [exports.CORE_MESSAGES.presenterDenialTitle]: { en: "Access denied", fr: "Accès refusé" },
+    [exports.CORE_MESSAGES.presenterIncidentFooter]: {
+        en: "Ref: {reference} · contact an admin if this persists",
+        fr: "Réf : {reference} · contactez un admin si le problème persiste",
+    },
+    [exports.CORE_MESSAGES.unknownSubcommand]: {
+        en: "Unknown subcommand.",
+        fr: "Sous-commande inconnue.",
+    },
+    [exports.CORE_MESSAGES.genericError]: {
+        en: "Something went wrong.",
+        fr: "Une erreur est survenue.",
+    },
+    [exports.CORE_MESSAGES.cooldownWait]: {
+        en: "Slow down — try again in {seconds}s.",
+        fr: "Doucement — réessayez dans {seconds}s.",
+    },
+    [exports.CORE_MESSAGES.guardPermissionDenied]: {
+        en: "You do not have permission to use this command. Missing: {missing}.",
+        fr: "Vous n'avez pas la permission d'utiliser cette commande. Manquant : {missing}.",
+    },
+    [exports.CORE_MESSAGES.guardRoleDenied]: {
+        en: "You do not have the role required to use this command.",
+        fr: "Vous n'avez pas le rôle requis pour utiliser cette commande.",
+    },
+    [exports.CORE_MESSAGES.guardGuildOnly]: {
+        en: "This command can only be used in a server.",
+        fr: "Cette commande ne peut être utilisée que sur un serveur.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalTitle]: {
+        en: "Edit: {field}",
+        fr: "Modifier : {field}",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalHelper]: {
+        en: "Leave empty to clear your customisation and go back to the default.",
+        fr: "Laisse vide pour effacer ta personnalisation et revenir à la valeur par défaut.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalUploadLabel]: {
+        en: "Upload an image",
+        fr: "Envoyer une image",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalUploadHelper]: {
+        en: "PNG, JPEG, GIF or WebP, up to {max} MiB. An upload wins over the address below.",
+        fr: "PNG, JPEG, GIF ou WebP, jusqu'à {max} Mio. Un envoi l'emporte sur l'adresse ci-dessous.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalImageUrlLabel]: {
+        en: "…or an image address",
+        fr: "…ou une adresse d'image",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalImageHelper]: {
+        en: "An http(s) address. Leave both empty to restore the default.",
+        fr: "Une adresse http(s). Laisse les deux vides pour revenir au défaut.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.modalImageHelperUploaded]: {
+        en: "An image is uploaded; it cannot be shown here. Empty both to restore the default.",
+        fr: "Une image est envoyée ; impossible de la réafficher. Vide les deux pour le défaut.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.fieldSaved]: {
+        en: "✅ {field} updated.",
+        fr: "✅ {field} mis à jour.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.fieldCleared]: {
+        en: "✅ {field} cleared — the default is used again.",
+        fr: "✅ {field} effacé — la valeur par défaut est de nouveau utilisée.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.fieldUploaded]: {
+        en: "✅ {field} updated with your upload.",
+        fr: "✅ {field} mis à jour avec ton envoi.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetButton]: {
+        en: "Reset everything",
+        fr: "Tout réinitialiser",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetConfirmTitle]: {
+        en: "Reset every field?",
+        fr: "Réinitialiser tous les champs ?",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetConfirmDescription]: {
+        en: "Every field goes back to its default. An uploaded image is not merely unset — its file is deleted for good and cannot be recovered. The preview below is what you are about to lose.",
+        fr: "Chaque champ revient à sa valeur par défaut. Une image envoyée n'est pas simplement retirée : le fichier est supprimé définitivement et ne pourra pas être récupéré. L'aperçu ci-dessous est ce que tu es sur le point de perdre.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetConfirmButton]: {
+        en: "Reset for good",
+        fr: "Réinitialiser définitivement",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetCancelButton]: {
+        en: "Cancel",
+        fr: "Annuler",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetDone]: {
+        en: "✅ Every field is back to its default.",
+        fr: "✅ Tous les champs sont revenus à leur valeur par défaut.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.resetCancelled]: {
+        en: "Nothing was reset. Your customisation is untouched.",
+        fr: "Rien n'a été réinitialisé. Ta personnalisation est intacte.",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.backButton]: {
+        en: "Back",
+        fr: "Retour",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.editFieldButton]: {
+        en: "Edit",
+        fr: "Modifier",
+    },
+    [exports.SETTINGS_EDITOR_MESSAGES.openLevelButton]: {
+        en: "Open",
+        fr: "Ouvrir",
+    },
+};
+//# sourceMappingURL=i18n.js.map

package/dist/discord/i18n.js.map

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

package/dist/discord/interaction/button.d.ts

@@ -0,0 +1,39 @@
+import { ActionRowBuilder, ButtonBuilder, type ButtonInteraction } from "discord.js";
+export type ButtonStyleName = "primary" | "secondary" | "success" | "danger";
+/**
+ * Interaction context handed to a button's `onClick`, mirroring the command
+ * {@link import("../../discord/command/context").Context}: it exposes the
+ * triggering interaction, the current state, and an `update` that re-renders the
+ * message with the next state.
+ */
+export interface ComponentContext<S> {
+    readonly interaction: ButtonInteraction;
+    readonly state: S;
+    update(next: S): Promise<void>;
+}
+export interface ButtonDef<S> {
+    id: string;
+    label?: string;
+    emoji?: string;
+    style?: ButtonStyleName;
+    disabled?: (state: S) => boolean;
+    onClick?: (ctx: ComponentContext<S>) => Promise<void> | void;
+}
+/**
+ * Type-erased compiled button: knows how to render itself for a given state
+ * (`apply`) and how to react to a click (`onClick`) — the component analogue of
+ * a compiled subcommand. A button is *behaviour*, not a passive widget, which is
+ * why it lives in the interaction layer rather than a UI/embed module.
+ */
+export interface Button<S> {
+    readonly id: string;
+    readonly onClick?: (ctx: ComponentContext<S>) => Promise<void> | void;
+    apply(state: S, forceDisabled?: boolean): ButtonBuilder;
+}
+/** Declare a button: a definition bundling construction (`apply`) and behaviour (`onClick`). */
+export declare function createButton<S>(def: ButtonDef<S>): Button<S>;
+/** Group buttons into a single action row, applying each against the current state. */
+export declare function createActionRow<S>(buttons: Button<S>[], state: S, options?: {
+    disableAll?: boolean;
+}): ActionRowBuilder<ButtonBuilder>;
+//# sourceMappingURL=button.d.ts.map

package/dist/discord/interaction/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/discord/interaction/button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAS7E;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtE,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CACxD;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAiB5D;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,CAAC,EAChC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EACpB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,gBAAgB,CAAC,aAAa,CAAC,CAKjC"}

package/dist/discord/interaction/button.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createButton = createButton;
+exports.createActionRow = createActionRow;
+const discord_js_1 = require("discord.js");
+const BUTTON_STYLES = {
+    primary: discord_js_1.ButtonStyle.Primary,
+    secondary: discord_js_1.ButtonStyle.Secondary,
+    success: discord_js_1.ButtonStyle.Success,
+    danger: discord_js_1.ButtonStyle.Danger,
+};
+/** Declare a button: a definition bundling construction (`apply`) and behaviour (`onClick`). */
+function createButton(def) {
+    const style = BUTTON_STYLES[def.style ?? "secondary"];
+    return {
+        id: def.id,
+        onClick: def.onClick,
+        apply(state, forceDisabled = false) {
+            const builder = new discord_js_1.ButtonBuilder().setCustomId(def.id).setStyle(style);
+            if (def.label !== undefined) {
+                builder.setLabel(def.label);
+            }
+            if (def.emoji !== undefined) {
+                builder.setEmoji(def.emoji);
+            }
+            builder.setDisabled(forceDisabled || (def.disabled?.(state) ?? false));
+            return builder;
+        },
+    };
+}
+/** Group buttons into a single action row, applying each against the current state. */
+function createActionRow(buttons, state, options = {}) {
+    const disableAll = options.disableAll ?? false;
+    return new discord_js_1.ActionRowBuilder().addComponents(...buttons.map((entry) => entry.apply(state, disableAll)));
+}
+//# sourceMappingURL=button.js.map

package/dist/discord/interaction/button.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.js","sourceRoot":"","sources":["../../../src/discord/interaction/button.ts"],"names":[],"mappings":";;AA6CA,oCAiBC;AAGD,0CASC;AA1ED,2CAAkG;AAIlG,MAAM,aAAa,GAAyC;IAC3D,OAAO,EAAE,wBAAW,CAAC,OAAO;IAC5B,SAAS,EAAE,wBAAW,CAAC,SAAS;IAChC,OAAO,EAAE,wBAAW,CAAC,OAAO;IAC5B,MAAM,EAAE,wBAAW,CAAC,MAAM;CAC1B,CAAC;AAmCF,gGAAgG;AAChG,SAAgB,YAAY,CAAI,GAAiB;IAChD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC;IACtD,OAAO;QACN,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK;YACjC,MAAM,OAAO,GAAG,IAAI,0BAAa,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxE,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,CAAC,WAAW,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YACvE,OAAO,OAAO,CAAC;QAChB,CAAC;KACD,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAgB,eAAe,CAC9B,OAAoB,EACpB,KAAQ,EACR,UAAoC,EAAE;IAEtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IAC/C,OAAO,IAAI,6BAAgB,EAAiB,CAAC,aAAa,CACzD,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CACzD,CAAC;AACH,CAAC"}

package/dist/discord/interaction/interaction-router.d.ts

@@ -0,0 +1,21 @@
+import type { Interaction } from "discord.js";
+/**
+ * Anything that can consume a gateway interaction. `handle` returns `true` when
+ * it claimed the interaction, `false` to let the next dispatcher try. This is the
+ * seam that lets the whole app share a single `interactionCreate` listener.
+ */
+export interface InteractionDispatcher {
+    handle(interaction: Interaction): Promise<boolean>;
+}
+/**
+ * Aggregates {@link InteractionDispatcher}s behind one entry point so the app
+ * registers a *single* `interactionCreate` listener (wired at the composition
+ * root, attached in `bootstrap/lifecycle`). Dispatchers are tried in order and
+ * the first to claim the interaction wins — no global state, no singleton.
+ */
+export declare class InteractionRouter {
+    private readonly dispatchers;
+    constructor(dispatchers: readonly InteractionDispatcher[]);
+    dispatch(interaction: Interaction): Promise<void>;
+}
+//# sourceMappingURL=interaction-router.d.ts.map

package/dist/discord/interaction/interaction-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-router.d.ts","sourceRoot":"","sources":["../../../src/discord/interaction/interaction-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,SAAS,qBAAqB,EAAE;IAEpE,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAOvD"}

package/dist/discord/interaction/interaction-router.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionRouter = void 0;
+/**
+ * Aggregates {@link InteractionDispatcher}s behind one entry point so the app
+ * registers a *single* `interactionCreate` listener (wired at the composition
+ * root, attached in `bootstrap/lifecycle`). Dispatchers are tried in order and
+ * the first to claim the interaction wins — no global state, no singleton.
+ */
+class InteractionRouter {
+    dispatchers;
+    constructor(dispatchers) {
+        this.dispatchers = dispatchers;
+    }
+    async dispatch(interaction) {
+        for (const dispatcher of this.dispatchers) {
+            if (await dispatcher.handle(interaction)) {
+                return;
+            }
+        }
+    }
+}
+exports.InteractionRouter = InteractionRouter;
+//# sourceMappingURL=interaction-router.js.map

package/dist/discord/interaction/interaction-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-router.js","sourceRoot":"","sources":["../../../src/discord/interaction/interaction-router.ts"],"names":[],"mappings":";;;AAWA;;;;;GAKG;AACH,MAAa,iBAAiB;IACA;IAA7B,YAA6B,WAA6C;QAA7C,gBAAW,GAAX,WAAW,CAAkC;IAAG,CAAC;IAE9E,KAAK,CAAC,QAAQ,CAAC,WAAwB;QACtC,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1C,OAAO;YACR,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAVD,8CAUC"}