@azurioh/discord-kernel 0.1.0

package/dist/discord/interaction/select-menu.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStringSelect = createStringSelect;
+exports.createChannelSelect = createChannelSelect;
+exports.createRoleSelect = createRoleSelect;
+exports.createUserSelect = createUserSelect;
+exports.createSelectRow = createSelectRow;
+exports.createSelectHandler = createSelectHandler;
+const discord_js_1 = require("discord.js");
+/** Apply the options every select flavour shares onto its builder. */
+function applyBaseOptions(builder, def, forceDisabled) {
+    builder.setCustomId(def.id);
+    if (def.placeholder !== undefined) {
+        builder.setPlaceholder(def.placeholder);
+    }
+    if (def.minValues !== undefined) {
+        builder.setMinValues(def.minValues);
+    }
+    if (def.maxValues !== undefined) {
+        builder.setMaxValues(def.maxValues);
+    }
+    builder.setDisabled(forceDisabled || (def.disabled ?? false));
+    return builder;
+}
+/** A menu of caller-defined string values. */
+function createStringSelect(def) {
+    return {
+        id: def.id,
+        onSelect: def.onSelect,
+        apply(forceDisabled = false) {
+            const builder = applyBaseOptions(new discord_js_1.StringSelectMenuBuilder(), def, forceDisabled);
+            return builder.addOptions(...def.options.map((option) => ({
+                label: option.label,
+                value: option.value,
+                description: option.description,
+                emoji: option.emoji,
+                default: option.default,
+            })));
+        },
+    };
+}
+/** A menu populated by Discord with the guild's channels. */
+function createChannelSelect(def) {
+    return {
+        id: def.id,
+        onSelect: def.onSelect,
+        apply(forceDisabled = false) {
+            const builder = applyBaseOptions(new discord_js_1.ChannelSelectMenuBuilder(), def, forceDisabled);
+            if (def.defaultChannelIds !== undefined && def.defaultChannelIds.length > 0) {
+                builder.setDefaultChannels(...def.defaultChannelIds);
+            }
+            if (def.channelTypes !== undefined) {
+                builder.setChannelTypes(...def.channelTypes);
+            }
+            return builder;
+        },
+    };
+}
+/** A menu populated by Discord with the guild's roles. */
+function createRoleSelect(def) {
+    return {
+        id: def.id,
+        onSelect: def.onSelect,
+        apply(forceDisabled = false) {
+            const builder = applyBaseOptions(new discord_js_1.RoleSelectMenuBuilder(), def, forceDisabled);
+            if (def.defaultRoleIds !== undefined && def.defaultRoleIds.length > 0) {
+                builder.setDefaultRoles(...def.defaultRoleIds);
+            }
+            return builder;
+        },
+    };
+}
+/**
+ * A menu populated by Discord with the guild's members.
+ *
+ * A distinct flavour from the mentionable one on purpose: naming a person is not
+ * the same act as naming a role, and the calls behind it — adding someone to the
+ * recap's ping list, granting a user a level — take a user id, not either.
+ */
+function createUserSelect(def) {
+    return {
+        id: def.id,
+        onSelect: def.onSelect,
+        apply(forceDisabled = false) {
+            const builder = applyBaseOptions(new discord_js_1.UserSelectMenuBuilder(), def, forceDisabled);
+            if (def.defaultUserIds !== undefined && def.defaultUserIds.length > 0) {
+                builder.setDefaultUsers(...def.defaultUserIds);
+            }
+            return builder;
+        },
+    };
+}
+/**
+ * Wrap a select menu in its own action row. Unlike buttons, Discord gives a
+ * select menu a whole row, so there is nothing to group — hence a distinct
+ * helper from `createActionRow`.
+ */
+function createSelectRow(menu, forceDisabled = false) {
+    return new discord_js_1.ActionRowBuilder().addComponents(menu.apply(forceDisabled));
+}
+/**
+ * Bridge a select menu's `onSelect` to the persistent
+ * {@link import("../../discord/components/component-router").ComponentRouter}.
+ *
+ * Without this a declared `onSelect` would never run: the router dispatches to a
+ * `ComponentHandler`, and nothing else turns an interaction back into the menu
+ * that produced it. Register the result through a module's `components`.
+ */
+function createSelectHandler(menu, authorize) {
+    return {
+        customId: menu.id,
+        // Passed in rather than defaulted: this bridge knows nothing about what
+        // the menu does, and a default here would be exactly the silent "anyone
+        // may click" the required field exists to prevent.
+        authorize,
+        async handle(interaction) {
+            // The router also routes buttons and modals to a matching customId; a
+            // menu only speaks for select interactions.
+            if (!interaction.isAnySelectMenu()) {
+                return;
+            }
+            await menu.onSelect?.({ interaction: interaction, values: interaction.values });
+        },
+    };
+}
+//# sourceMappingURL=select-menu.js.map

package/dist/discord/interaction/select-menu.js.map

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

package/dist/discord/permissions.d.ts

@@ -0,0 +1,32 @@
+import { PermissionFlagsBits, PermissionsBitField } from "discord.js";
+/**
+ * Permission helpers shared by the command DSL, the guards and any adapter that
+ * needs to reason about what the bot (or a member) is allowed to do.
+ *
+ * Everything is expressed in terms of {@link PermissionBit} rather than raw
+ * `bigint`s: the values come from discord.js' `PermissionFlagsBits`, so a typo
+ * is a type error instead of a silently wrong bitfield.
+ */
+/**
+ * A single Discord permission flag. Deriving the type from the enum-like object
+ * means the DSL accepts `PermissionFlagsBits.ManageChannels` and rejects an
+ * arbitrary `bigint`.
+ */
+export type PermissionBit = (typeof PermissionFlagsBits)[keyof typeof PermissionFlagsBits];
+/** Combine permission flags into the single bitfield Discord's API expects. */
+export declare function resolvePermissions(permissions: readonly PermissionBit[]): bigint;
+/**
+ * Bits in `required` that `held` lacks (empty when everything is granted).
+ *
+ * `held === null` means the permissions could not be resolved (outside a guild,
+ * or an uncached member). It returns *all* of `required`: an absent answer must
+ * never be mistaken for a granted one.
+ */
+export declare function missingPermissions(held: Readonly<PermissionsBitField> | null, required: readonly PermissionBit[]): PermissionBit[];
+/**
+ * Human-readable names for permission bits, for user-facing messages. Resolved
+ * by reverse lookup in `PermissionFlagsBits` so the names track discord.js
+ * rather than a hand-maintained table that silently rots.
+ */
+export declare function formatPermissions(permissions: readonly PermissionBit[]): string;
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/discord/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAE3F,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,IAAI,EAC1C,QAAQ,EAAE,SAAS,aAAa,EAAE,GAChC,aAAa,EAAE,CAKjB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAE/E"}

package/dist/discord/permissions.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePermissions = resolvePermissions;
+exports.missingPermissions = missingPermissions;
+exports.formatPermissions = formatPermissions;
+const discord_js_1 = require("discord.js");
+/** Combine permission flags into the single bitfield Discord's API expects. */
+function resolvePermissions(permissions) {
+    return discord_js_1.PermissionsBitField.resolve([...permissions]);
+}
+/**
+ * Bits in `required` that `held` lacks (empty when everything is granted).
+ *
+ * `held === null` means the permissions could not be resolved (outside a guild,
+ * or an uncached member). It returns *all* of `required`: an absent answer must
+ * never be mistaken for a granted one.
+ */
+function missingPermissions(held, required) {
+    if (held === null) {
+        return [...required];
+    }
+    return required.filter((permission) => !held.has(permission));
+}
+/**
+ * Human-readable names for permission bits, for user-facing messages. Resolved
+ * by reverse lookup in `PermissionFlagsBits` so the names track discord.js
+ * rather than a hand-maintained table that silently rots.
+ */
+function formatPermissions(permissions) {
+    return permissions.map(permissionName).join(", ");
+}
+function permissionName(permission) {
+    for (const [name, bit] of Object.entries(discord_js_1.PermissionFlagsBits)) {
+        if (bit === permission) {
+            return name;
+        }
+    }
+    return String(permission);
+}
+//# sourceMappingURL=permissions.js.map

package/dist/discord/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/discord/permissions.ts"],"names":[],"mappings":";;AAmBA,gDAEC;AASD,gDAQC;AAOD,8CAEC;AA/CD,2CAAsE;AAkBtE,+EAA+E;AAC/E,SAAgB,kBAAkB,CAAC,WAAqC;IACvE,OAAO,gCAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CACjC,IAA0C,EAC1C,QAAkC;IAElC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,WAAqC;IACtE,OAAO,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,UAAyB;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gCAAmB,CAAC,EAAE,CAAC;QAC/D,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACb,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3B,CAAC"}

package/dist/discord/placeholder-registry-errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Two providers registered the same token. Raised while modules register their
+ * placeholders at boot — a wiring mistake that must stop the boot, never a
+ * runtime condition a guild's rendered text could trigger.
+ */
+export declare class DuplicatePlaceholderTokenError extends Error {
+    readonly token: string;
+    constructor(token: string);
+}
+//# sourceMappingURL=placeholder-registry-errors.d.ts.map

package/dist/discord/placeholder-registry-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-registry-errors.d.ts","sourceRoot":"","sources":["../../src/discord/placeholder-registry-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAIlC"}

package/dist/discord/placeholder-registry-errors.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicatePlaceholderTokenError = void 0;
+/**
+ * Two providers registered the same token. Raised while modules register their
+ * placeholders at boot — a wiring mistake that must stop the boot, never a
+ * runtime condition a guild's rendered text could trigger.
+ */
+class DuplicatePlaceholderTokenError extends Error {
+    token;
+    constructor(token) {
+        super(`Placeholder token "${token}" is registered twice`);
+        this.token = token;
+        this.name = "DuplicatePlaceholderTokenError";
+    }
+}
+exports.DuplicatePlaceholderTokenError = DuplicatePlaceholderTokenError;
+//# sourceMappingURL=placeholder-registry-errors.js.map

package/dist/discord/placeholder-registry-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-registry-errors.js","sourceRoot":"","sources":["../../src/discord/placeholder-registry-errors.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,MAAa,8BAA+B,SAAQ,KAAK;IACnC;IAArB,YAAqB,KAAa;QACjC,KAAK,CAAC,sBAAsB,KAAK,uBAAuB,CAAC,CAAC;QADtC,UAAK,GAAL,KAAK,CAAQ;QAEjC,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC9C,CAAC;CACD;AALD,wEAKC"}

package/dist/discord/placeholder-registry.d.ts

@@ -0,0 +1,53 @@
+import type { Locale } from "../i18n";
+/**
+ * A token a module offers to text another module's administrator writes,
+ * resolved only once that text is actually rendered.
+ *
+ * `core` sits between the two by design: a module that publishes a token
+ * (`tournament`'s `{tournament_template}`) and a module that renders text
+ * carrying it (`ticket`'s welcome message) never import each other —
+ * `AGENTS.md` forbids it. Both go through {@link PlaceholderRegistry} instead,
+ * which `bootstrap` hands to every module factory from the same container-held
+ * instance, so neither module ever names the other.
+ */
+export interface PlaceholderProvider {
+    /** The token, braces included — `{tournament_template}`. */
+    readonly token: string;
+    /** What it becomes, for one guild, at render time. */
+    resolve(guildId: string, locale: Locale): Promise<string>;
+    /**
+     * Catalog key describing this token in the legend an admin reads while
+     * writing the text — owned by the module that offers the token, since it is
+     * the only one that knows what the token means.
+     */
+    readonly legendKey: string;
+}
+/**
+ * Accumulates every {@link PlaceholderProvider} registered at boot and resolves
+ * them against a piece of already-rendered text.
+ *
+ * Consulted at render, never at construction — that is what makes the order
+ * `bootstrap/modules.ts` lists modules in irrelevant here: a module registers
+ * into this from its own factory, whatever position it holds in that list, and
+ * `resolve` only ever reads the registry as it stands by the time some guild's
+ * text is actually rendered — well after every module has finished
+ * registering, unlike `ChannelExporter` (`bootstrap/channel-exporter.ts`),
+ * which has to be built with the enabled module list already known.
+ */
+export declare class PlaceholderRegistry {
+    private readonly providers;
+    /** @throws DuplicatePlaceholderTokenError — a boot-time wiring mistake. */
+    register(provider: PlaceholderProvider): void;
+    /** Every registered provider, in registration order — for building a legend. */
+    list(): readonly PlaceholderProvider[];
+    /** The token every registered provider answers to. */
+    tokens(): readonly string[];
+    /**
+     * Replace every registered token `text` carries with what it resolves to for
+     * `guildId`/`locale`. A provider whose token is absent from `text` is never
+     * asked to resolve — the common case, since one guild's text rarely uses
+     * every token every module has ever registered.
+     */
+    resolve(text: string, guildId: string, locale: Locale): Promise<string>;
+}
+//# sourceMappingURL=placeholder-registry.d.ts.map

package/dist/discord/placeholder-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-registry.d.ts","sourceRoot":"","sources":["../../src/discord/placeholder-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAO7C,gFAAgF;IAChF,IAAI,IAAI,SAAS,mBAAmB,EAAE;IAItC,sDAAsD;IACtD,MAAM,IAAI,SAAS,MAAM,EAAE;IAI3B;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU7E"}

package/dist/discord/placeholder-registry.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlaceholderRegistry = void 0;
+const placeholder_registry_errors_1 = require("../discord/placeholder-registry-errors");
+/**
+ * Accumulates every {@link PlaceholderProvider} registered at boot and resolves
+ * them against a piece of already-rendered text.
+ *
+ * Consulted at render, never at construction — that is what makes the order
+ * `bootstrap/modules.ts` lists modules in irrelevant here: a module registers
+ * into this from its own factory, whatever position it holds in that list, and
+ * `resolve` only ever reads the registry as it stands by the time some guild's
+ * text is actually rendered — well after every module has finished
+ * registering, unlike `ChannelExporter` (`bootstrap/channel-exporter.ts`),
+ * which has to be built with the enabled module list already known.
+ */
+class PlaceholderRegistry {
+    providers = [];
+    /** @throws DuplicatePlaceholderTokenError — a boot-time wiring mistake. */
+    register(provider) {
+        if (this.providers.some((existing) => existing.token === provider.token)) {
+            throw new placeholder_registry_errors_1.DuplicatePlaceholderTokenError(provider.token);
+        }
+        this.providers.push(provider);
+    }
+    /** Every registered provider, in registration order — for building a legend. */
+    list() {
+        return this.providers;
+    }
+    /** The token every registered provider answers to. */
+    tokens() {
+        return this.providers.map((provider) => provider.token);
+    }
+    /**
+     * Replace every registered token `text` carries with what it resolves to for
+     * `guildId`/`locale`. A provider whose token is absent from `text` is never
+     * asked to resolve — the common case, since one guild's text rarely uses
+     * every token every module has ever registered.
+     */
+    async resolve(text, guildId, locale) {
+        let result = text;
+        for (const provider of this.providers) {
+            if (result.includes(provider.token)) {
+                const value = await provider.resolve(guildId, locale);
+                result = result.split(provider.token).join(value);
+            }
+        }
+        return result;
+    }
+}
+exports.PlaceholderRegistry = PlaceholderRegistry;
+//# sourceMappingURL=placeholder-registry.js.map

package/dist/discord/placeholder-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-registry.js","sourceRoot":"","sources":["../../src/discord/placeholder-registry.ts"],"names":[],"mappings":";;;AAAA,uFAAuF;AA2BvF;;;;;;;;;;;GAWG;AACH,MAAa,mBAAmB;IACd,SAAS,GAA0B,EAAE,CAAC;IAEvD,2EAA2E;IAC3E,QAAQ,CAAC,QAA6B;QACrC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,4DAA8B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,gFAAgF;IAChF,IAAI;QACH,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,sDAAsD;IACtD,MAAM;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,OAAe,EAAE,MAAc;QAC1D,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACtD,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;QACD,OAAO,MAAM,CAAC;IACf,CAAC;CACD;AArCD,kDAqCC"}

package/dist/discord/presenter.d.ts

@@ -0,0 +1,26 @@
+import type { EmbedBuilder } from "discord.js";
+import type { Locale } from "../i18n";
+/**
+ * Port that renders framework-level responses (errors, denials, confirmations)
+ * as embeds. The command pipeline depends on this interface, never on a concrete
+ * embed module — so a bot can fully restyle/localise feedback by providing its
+ * own implementation, with zero changes to the core.
+ *
+ * Every method receives the locale resolved for the interaction being answered,
+ * so titles and fixed copy follow the user's language, not the process's.
+ *
+ * The default implementation lives in `infrastructure/discord/default-presenter.ts`.
+ */
+export interface Presenter {
+    /** A successful, affirmative action. */
+    confirmation(message: string, locale: Locale): EmbedBuilder;
+    /** A benign business problem (bad input, missing resource, conflict). */
+    warning(message: string, locale: Locale): EmbedBuilder;
+    /** A serious—but expected—business error. */
+    error(message: string, locale: Locale): EmbedBuilder;
+    /** An authorization denial from a guard. */
+    denial(message: string, locale: Locale): EmbedBuilder;
+    /** An unexpected failure, carrying a quotable incident reference. */
+    systemError(message: string, reference: string, locale: Locale): EmbedBuilder;
+}
+//# sourceMappingURL=presenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presenter.d.ts","sourceRoot":"","sources":["../../src/discord/presenter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,SAAS;IACzB,wCAAwC;IACxC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5D,yEAAyE;IACzE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACvD,6CAA6C;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACrD,4CAA4C;IAC5C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IACtD,qEAAqE;IACrE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;CAC9E"}

package/dist/discord/presenter.js

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

package/dist/discord/presenter.js.map

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

package/dist/discord/ui/card.d.ts

@@ -0,0 +1,114 @@
+import { ContainerBuilder } from "discord.js";
+import { type Button } from "../../discord/interaction/button";
+import type { AnySelectMenuBuilder } from "../../discord/interaction/select-menu";
+/** Discord refuses a message carrying more components than this, container included. */
+export declare const MAX_CARD_COMPONENTS = 40;
+/** Discord's cap on the characters carried by every `TextDisplay` in a message, summed. */
+export declare const MAX_CARD_TEXT_CHARACTERS = 4000;
+/** One image inside a `gallery` block. */
+export interface CardImage {
+    /** A URL, `attachment://` included for a file the message itself carries. */
+    readonly url: string;
+    readonly description?: string;
+    readonly spoiler?: boolean;
+}
+/**
+ * The two shapes an `entry` may carry besides its text, plus the bare one with
+ * neither.
+ *
+ * Modelled as a three-way union rather than one shape with two optional
+ * fields: Discord's `Section` accepts exactly **one** accessory, so `action`
+ * and `thumbnail` together is not a looser version of the block, it is an
+ * invalid one. A two-optional-field shape would only catch that at
+ * `apply()`, with Discord's own rejection as the first symptom; this union
+ * makes the combination fail to compile instead. Each arm carries the other
+ * field as `?: never` — without it, TypeScript's leniency on excess
+ * properties across a union (a property valid on *any* arm is accepted on
+ * all of them) would let both through anyway.
+ */
+export type CardEntryAccessory<S> = {
+    readonly action?: never;
+    readonly thumbnail?: never;
+} | {
+    readonly action: Button<S>;
+    readonly thumbnail?: never;
+} | {
+    readonly action?: never;
+    readonly thumbnail: string;
+};
+/**
+ * What a compiled select menu must offer for a card to render it — `apply`
+ * only, never `onSelect`.
+ *
+ * `SelectMenu<B, I>` (the DSL's own compiled shape) is contravariant in `I`,
+ * so a `SelectMenu<StringSelectMenuBuilder, StringSelectMenuInteraction>` —
+ * what `createStringSelect` hands back — is not assignable to a version
+ * fixed at the union `AnySelectMenuInteraction`. A card never reads
+ * `onSelect` (that is wired separately, through the module's
+ * `ComponentRouter`), so this asks for nothing beyond what it actually
+ * calls, and every flavour of compiled select menu satisfies it as-is.
+ */
+export interface CardSelectMenu {
+    readonly id: string;
+    apply(forceDisabled?: boolean): AnySelectMenuBuilder;
+}
+/**
+ * One piece of a card, declared as data rather than built. `createCard`
+ * compiles a list of these into a `ContainerBuilder`, the same split
+ * `createButton`/`createModal`/`createStringSelect` keep between a
+ * definition and the builder it compiles to.
+ */
+export type CardBlock<S> = {
+    readonly kind: "text";
+    readonly content: string;
+} | ({
+    readonly kind: "entry";
+    readonly title: string;
+    readonly lines?: readonly string[];
+} & CardEntryAccessory<S>) | {
+    readonly kind: "controls";
+    readonly buttons: readonly Button<S>[];
+} | {
+    readonly kind: "select";
+    readonly menu: CardSelectMenu;
+} | {
+    readonly kind: "separator";
+    readonly spacing?: "small" | "large";
+    readonly divider?: boolean;
+} | {
+    readonly kind: "gallery";
+    readonly images: readonly CardImage[];
+};
+export interface CardDef<S> {
+    /** The container's left-edge accent colour — see `EMBED_COLORS` for the bot's palette. */
+    readonly accent?: number;
+    /**
+     * The card's content, top to bottom.
+     *
+     * `null` entries are accepted and skipped: a conditional block is declared
+     * in place, at the position it would occupy, rather than assembled into a
+     * separate array the caller builds beside this one and has to keep in
+     * sync.
+     */
+    readonly blocks: readonly (CardBlock<S> | null)[];
+}
+/**
+ * A compiled card: knows how to render itself for a given state. Mirrors
+ * `Button<S>.apply` (`src/core/discord/interaction/button.ts`) on purpose —
+ * same parameters, same meaning for `forceDisabled` — which is what lets
+ * `disabledControls` neutralise a card exactly the way it neutralises a
+ * button row: by applying it a second time with `true`, no special case
+ * required.
+ */
+export interface Card<S> {
+    apply(state: S, forceDisabled?: boolean): ContainerBuilder;
+}
+/**
+ * Declare a card: a definition compiling to a `ContainerBuilder`, the
+ * Components V2 analogue of an embed. Follows the same split as
+ * `createButton`/`createModal`/`createStringSelect` — data in, a compiled
+ * value with an `apply` out — so a caller never touches a V2 builder
+ * directly.
+ */
+export declare function createCard<S>(def: CardDef<S>): Card<S>;
+//# sourceMappingURL=card.d.ts.map

package/dist/discord/ui/card.d.ts.map

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