@azurioh/discord-kernel 0.1.0

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

@@ -0,0 +1,171 @@
+import { type Attachment, type ChannelType, ModalBuilder, type ModalSubmitInteraction } from "discord.js";
+export type TextFieldStyleName = "short" | "paragraph";
+/**
+ * A single text field. `required` defaults to Discord's own default (`true`); set
+ * it to `false` to make {@link Modal.read} return `null` when left empty.
+ */
+export interface TextFieldDef {
+    kind?: "text";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    style?: TextFieldStyleName;
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    placeholder?: string;
+    /** Prefilled content, e.g. when editing an existing value. */
+    value?: string;
+}
+/** A single checkbox field — always optional from Discord's own perspective. */
+export interface CheckboxFieldDef {
+    kind: "checkbox";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    /** Pre-ticked state. Defaults to unticked. */
+    default?: boolean;
+}
+/**
+ * A single file upload. `required` defaults to Discord's own default (`true`);
+ * set it to `false` to make {@link Modal.read} return `null` when nothing was
+ * uploaded.
+ */
+export interface FileFieldDef {
+    kind: "file";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    required?: boolean;
+    /** How many files may be uploaded at once. Discord's own default is one of each. */
+    minValues?: number;
+    maxValues?: number;
+}
+/** One choice offered by a {@link SelectFieldDef}. */
+export interface SelectFieldOption {
+    label: string;
+    value: string;
+    description?: string;
+    default?: boolean;
+}
+/**
+ * A single string select menu. `required` defaults to Discord's own default
+ * (`true`); set it to `false` to make {@link Modal.read} return `null` when
+ * nothing was picked.
+ */
+export interface SelectFieldDef {
+    kind: "select";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    options: readonly SelectFieldOption[];
+    placeholder?: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+}
+/**
+ * A single role select menu. `required` defaults to Discord's own default
+ * (`true`); set it to `false` to make {@link Modal.read} return `null` when
+ * nothing was picked.
+ */
+export interface RoleFieldDef {
+    kind: "role";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    defaultRoleIds?: readonly string[];
+    placeholder?: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+}
+/**
+ * A single user select menu. `required` defaults to Discord's own default
+ * (`true`); set it to `false` to make {@link Modal.read} return `null` when
+ * nothing was picked.
+ */
+export interface UserFieldDef {
+    kind: "user";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    defaultUserIds?: readonly string[];
+    placeholder?: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+}
+/**
+ * A single channel select menu. `required` defaults to Discord's own default
+ * (`true`); set it to `false` to make {@link Modal.read} return `null` when
+ * nothing was picked.
+ */
+export interface ChannelFieldDef {
+    kind: "channel";
+    label: string;
+    /** Helper text rendered under the label. */
+    description?: string;
+    defaultChannelIds?: readonly string[];
+    /** Restricts which channel kinds may be picked, e.g. to categories only. */
+    channelTypes?: readonly ChannelType[];
+    placeholder?: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+}
+export type FieldDef = TextFieldDef | CheckboxFieldDef | FileFieldDef | SelectFieldDef | RoleFieldDef | UserFieldDef | ChannelFieldDef;
+/** Field declarations keyed by custom id — the same key `read` returns values under. */
+export type ModalFields = Record<string, FieldDef>;
+/**
+ * Submitted values, keyed like the declaration. A checkbox field always resolves
+ * to a `boolean`; an optional text, file, select, role, user or channel field
+ * widens to `| null` so a caller cannot forget the empty case. A file field's
+ * uploads come back as a list because the field itself may allow several, and
+ * so do a select/role/user/channel field's picks, as the identifiers chosen.
+ * This only resolves correctly because `createModal` infers its fields as
+ * `const`.
+ */
+export type ModalValues<F extends ModalFields> = {
+    [K in keyof F]: F[K] extends CheckboxFieldDef ? boolean : F[K] extends FileFieldDef ? F[K]["required"] extends false ? readonly Attachment[] | null : readonly Attachment[] : F[K] extends SelectFieldDef | RoleFieldDef | UserFieldDef | ChannelFieldDef ? F[K]["required"] extends false ? readonly string[] | null : readonly string[] : F[K] extends TextFieldDef ? F[K]["required"] extends false ? string | null : string : never;
+};
+export interface ModalDef<F extends ModalFields> {
+    id: string;
+    title: string;
+    /**
+     * Text shown above the fields, via a Text Display component — a legend whose
+     * content is not one of the fields themselves. Counts toward the same
+     * five-component budget `fields` does: Discord's own modal object carries
+     * "between 1 and 5 (inclusive) components", label and text display alike.
+     */
+    legend?: string;
+    fields: F;
+}
+/**
+ * Compiled modal: it knows how to render itself (`build`) and how to decode what
+ * came back (`read`) — the same construction/behaviour pairing as a compiled
+ * {@link import("../../discord/interaction/button").Button}. Without it a module
+ * has to hand-roll raw discord.js builders, which the template forbids everywhere
+ * else in the DSL.
+ */
+export interface Modal<F extends ModalFields> {
+    readonly id: string;
+    /**
+     * Build the modal to show. `state` is appended after a colon so the persistent
+     * {@link import("../../discord/components/component-router").ComponentRouter}
+     * still routes it to the handler registered under `id`.
+     */
+    build(state?: string): ModalBuilder;
+    read(interaction: ModalSubmitInteraction): ModalValues<F>;
+}
+/**
+ * Declare a modal: a title, a custom id and typed fields (text, checkbox,
+ * file, select, role, user or channel).
+ *
+ * Discord caps a modal at five components, so keep `fields` — plus one more if
+ * `legend` is set — within that budget. The `const` type parameter is what
+ * preserves each field's literal `kind`/`required`, and therefore the shape of
+ * the values `read` returns.
+ */
+export declare function createModal<const F extends ModalFields>(def: ModalDef<F>): Modal<F>;
+//# sourceMappingURL=modal.d.ts.map

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

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

package/dist/discord/interaction/modal.js

@@ -0,0 +1,264 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModal = createModal;
+const discord_js_1 = require("discord.js");
+const TEXT_FIELD_STYLES = {
+    short: discord_js_1.TextInputStyle.Short,
+    paragraph: discord_js_1.TextInputStyle.Paragraph,
+};
+/** Separates a modal's static id from the dynamic state appended for routing. */
+const CUSTOM_ID_SEPARATOR = ":";
+function createTextInput(name, field) {
+    const input = new discord_js_1.TextInputBuilder()
+        .setCustomId(name)
+        .setStyle(TEXT_FIELD_STYLES[field.style ?? "short"])
+        .setRequired(field.required ?? true);
+    if (field.minLength !== undefined) {
+        input.setMinLength(field.minLength);
+    }
+    if (field.maxLength !== undefined) {
+        input.setMaxLength(field.maxLength);
+    }
+    if (field.placeholder !== undefined) {
+        input.setPlaceholder(field.placeholder);
+    }
+    if (field.value !== undefined) {
+        input.setValue(field.value);
+    }
+    return input;
+}
+function createFileUpload(name, field) {
+    const upload = new discord_js_1.FileUploadBuilder().setCustomId(name).setRequired(field.required ?? true);
+    if (field.minValues !== undefined) {
+        upload.setMinValues(field.minValues);
+    }
+    if (field.maxValues !== undefined) {
+        upload.setMaxValues(field.maxValues);
+    }
+    return upload;
+}
+function createSelectOption(option) {
+    const built = new discord_js_1.StringSelectMenuOptionBuilder()
+        .setLabel(option.label)
+        .setValue(option.value)
+        .setDefault(option.default ?? false);
+    if (option.description !== undefined) {
+        built.setDescription(option.description);
+    }
+    return built;
+}
+function createStringSelect(name, field) {
+    const select = new discord_js_1.StringSelectMenuBuilder()
+        .setCustomId(name)
+        .setRequired(field.required ?? true)
+        .addOptions(field.options.map(createSelectOption));
+    if (field.placeholder !== undefined) {
+        select.setPlaceholder(field.placeholder);
+    }
+    if (field.minValues !== undefined) {
+        select.setMinValues(field.minValues);
+    }
+    if (field.maxValues !== undefined) {
+        select.setMaxValues(field.maxValues);
+    }
+    return select;
+}
+function createRoleSelect(name, field) {
+    const select = new discord_js_1.RoleSelectMenuBuilder().setCustomId(name).setRequired(field.required ?? true);
+    if (field.defaultRoleIds !== undefined) {
+        select.setDefaultRoles(...field.defaultRoleIds);
+    }
+    if (field.placeholder !== undefined) {
+        select.setPlaceholder(field.placeholder);
+    }
+    if (field.minValues !== undefined) {
+        select.setMinValues(field.minValues);
+    }
+    if (field.maxValues !== undefined) {
+        select.setMaxValues(field.maxValues);
+    }
+    return select;
+}
+function createUserSelect(name, field) {
+    const select = new discord_js_1.UserSelectMenuBuilder().setCustomId(name).setRequired(field.required ?? true);
+    if (field.defaultUserIds !== undefined) {
+        select.setDefaultUsers(...field.defaultUserIds);
+    }
+    if (field.placeholder !== undefined) {
+        select.setPlaceholder(field.placeholder);
+    }
+    if (field.minValues !== undefined) {
+        select.setMinValues(field.minValues);
+    }
+    if (field.maxValues !== undefined) {
+        select.setMaxValues(field.maxValues);
+    }
+    return select;
+}
+function createChannelSelect(name, field) {
+    const select = new discord_js_1.ChannelSelectMenuBuilder()
+        .setCustomId(name)
+        .setRequired(field.required ?? true);
+    if (field.channelTypes !== undefined) {
+        select.setChannelTypes(...field.channelTypes);
+    }
+    if (field.defaultChannelIds !== undefined) {
+        select.setDefaultChannels(...field.defaultChannelIds);
+    }
+    if (field.placeholder !== undefined) {
+        select.setPlaceholder(field.placeholder);
+    }
+    if (field.minValues !== undefined) {
+        select.setMinValues(field.minValues);
+    }
+    if (field.maxValues !== undefined) {
+        select.setMaxValues(field.maxValues);
+    }
+    return select;
+}
+function createLabel(name, field) {
+    const label = new discord_js_1.LabelBuilder().setLabel(field.label);
+    if (field.description !== undefined) {
+        label.setDescription(field.description);
+    }
+    if (field.kind === "checkbox") {
+        return label.setCheckboxComponent(new discord_js_1.CheckboxBuilder().setCustomId(name).setDefault(field.default ?? false));
+    }
+    if (field.kind === "file") {
+        return label.setFileUploadComponent(createFileUpload(name, field));
+    }
+    if (field.kind === "select") {
+        return label.setStringSelectMenuComponent(createStringSelect(name, field));
+    }
+    if (field.kind === "role") {
+        return label.setRoleSelectMenuComponent(createRoleSelect(name, field));
+    }
+    if (field.kind === "user") {
+        return label.setUserSelectMenuComponent(createUserSelect(name, field));
+    }
+    if (field.kind === "channel") {
+        return label.setChannelSelectMenuComponent(createChannelSelect(name, field));
+    }
+    return label.setTextInputComponent(createTextInput(name, field));
+}
+/**
+ * An optional field left blank comes back as an empty string (or not at all when
+ * Discord omits it), two shapes for the same "nothing entered" outcome — collapse
+ * both to `null` so callers branch once.
+ */
+function readOptionalField(interaction, name) {
+    if (!interaction.fields.fields.has(name)) {
+        return null;
+    }
+    const value = interaction.fields.getTextInputValue(name);
+    return value.length > 0 ? value : null;
+}
+/**
+ * The same "nothing entered" collapsing for an upload: an optional file field
+ * left alone comes back absent, or present with no attachment at all.
+ */
+function readOptionalFiles(interaction, name) {
+    if (!interaction.fields.fields.has(name)) {
+        return null;
+    }
+    const uploaded = interaction.fields.getUploadedFiles(name);
+    if (uploaded === null || uploaded.size === 0) {
+        return null;
+    }
+    return [...uploaded.values()];
+}
+/**
+ * The same "nothing entered" collapsing for a string select: an optional select
+ * field left alone comes back absent, or present with no option chosen.
+ */
+function readOptionalSelectValues(interaction, name) {
+    if (!interaction.fields.fields.has(name)) {
+        return null;
+    }
+    const values = interaction.fields.getStringSelectValues(name);
+    return values.length > 0 ? values : null;
+}
+/**
+ * The same "nothing entered" collapsing for a role/user/channel select: an
+ * optional field left alone comes back absent, or present with an empty (or
+ * `null`) selection. The identifiers are returned as the keys of the
+ * `Collection` the underlying getter resolves.
+ */
+function readOptionalIds(interaction, name, getSelected) {
+    if (!interaction.fields.fields.has(name)) {
+        return null;
+    }
+    const selected = getSelected(interaction, name);
+    if (selected === null || selected.size === 0) {
+        return null;
+    }
+    return [...selected.keys()];
+}
+/**
+ * Declare a modal: a title, a custom id and typed fields (text, checkbox,
+ * file, select, role, user or channel).
+ *
+ * Discord caps a modal at five components, so keep `fields` — plus one more if
+ * `legend` is set — within that budget. The `const` type parameter is what
+ * preserves each field's literal `kind`/`required`, and therefore the shape of
+ * the values `read` returns.
+ */
+function createModal(def) {
+    const entries = Object.entries(def.fields);
+    return {
+        id: def.id,
+        build(state) {
+            const customId = state === undefined ? def.id : `${def.id}${CUSTOM_ID_SEPARATOR}${state}`;
+            const modal = new discord_js_1.ModalBuilder().setCustomId(customId).setTitle(def.title);
+            if (def.legend !== undefined) {
+                modal.addTextDisplayComponents((textDisplay) => textDisplay.setContent(def.legend));
+            }
+            return modal.addLabelComponents(...entries.map(([name, field]) => createLabel(name, field)));
+        },
+        read(interaction) {
+            const values = {};
+            for (const [name, field] of entries) {
+                if (field.kind === "checkbox") {
+                    values[name] = interaction.fields.getCheckbox(name);
+                    continue;
+                }
+                const isRequired = field.required ?? true;
+                if (field.kind === "file") {
+                    values[name] = isRequired
+                        ? [...interaction.fields.getUploadedFiles(name, true).values()]
+                        : readOptionalFiles(interaction, name);
+                    continue;
+                }
+                if (field.kind === "select") {
+                    values[name] = isRequired
+                        ? interaction.fields.getStringSelectValues(name)
+                        : readOptionalSelectValues(interaction, name);
+                    continue;
+                }
+                if (field.kind === "role") {
+                    values[name] = isRequired
+                        ? [...interaction.fields.getSelectedRoles(name, true).keys()]
+                        : readOptionalIds(interaction, name, (i, n) => i.fields.getSelectedRoles(n, false));
+                    continue;
+                }
+                if (field.kind === "user") {
+                    values[name] = isRequired
+                        ? [...interaction.fields.getSelectedUsers(name, true).keys()]
+                        : readOptionalIds(interaction, name, (i, n) => i.fields.getSelectedUsers(n, false));
+                    continue;
+                }
+                if (field.kind === "channel") {
+                    values[name] = isRequired
+                        ? [...interaction.fields.getSelectedChannels(name, true).keys()]
+                        : readOptionalIds(interaction, name, (i, n) => i.fields.getSelectedChannels(n, false));
+                    continue;
+                }
+                values[name] = isRequired
+                    ? interaction.fields.getTextInputValue(name)
+                    : readOptionalField(interaction, name);
+            }
+            return values;
+        },
+    };
+}
+//# sourceMappingURL=modal.js.map

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

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

package/dist/discord/interaction/select-menu.d.ts

@@ -0,0 +1,104 @@
+import { ActionRowBuilder, type AnySelectMenuInteraction, ChannelSelectMenuBuilder, type ChannelSelectMenuInteraction, type ChannelType, RoleSelectMenuBuilder, type RoleSelectMenuInteraction, StringSelectMenuBuilder, type StringSelectMenuInteraction, UserSelectMenuBuilder, type UserSelectMenuInteraction } from "discord.js";
+import type { ComponentAuthorization, ComponentHandler } from "../../discord/components/component-router";
+/** The builders this DSL can produce; the union an action row accepts. */
+export type AnySelectMenuBuilder = StringSelectMenuBuilder | ChannelSelectMenuBuilder | RoleSelectMenuBuilder | UserSelectMenuBuilder;
+/**
+ * Context handed to `onSelect`, mirroring
+ * {@link import("../../discord/interaction/button").ComponentContext}: the
+ * triggering interaction plus the picked values, already unwrapped so a handler
+ * does not have to know where discord.js keeps them.
+ */
+export interface SelectContext<I extends AnySelectMenuInteraction> {
+    readonly interaction: I;
+    readonly values: readonly string[];
+}
+/**
+ * Presentation options shared by every select flavour. Split from the handler so
+ * the shared `applyBaseOptions` never sees `onSelect`: a callback is
+ * contravariant in its interaction type, so a common supertype for the
+ * *definitions* cannot exist.
+ */
+export interface SelectLayout {
+    id: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+}
+/** A select declaration: its layout plus the behaviour it carries. */
+export interface BaseSelectDef<I extends AnySelectMenuInteraction> extends SelectLayout {
+    onSelect?: (ctx: SelectContext<I>) => Promise<void> | void;
+}
+/**
+ * Compiled select menu: renders itself (`apply`) and owns its behaviour
+ * (`onSelect`), exactly like a compiled
+ * {@link import("../../discord/interaction/button").Button}. It lives in the
+ * interaction layer for the same reason — it carries behaviour, it is not a
+ * passive widget.
+ */
+export interface SelectMenu<B, I extends AnySelectMenuInteraction> {
+    readonly id: string;
+    readonly onSelect?: (ctx: SelectContext<I>) => Promise<void> | void;
+    apply(forceDisabled?: boolean): B;
+}
+export interface StringSelectOption {
+    label: string;
+    value: string;
+    description?: string;
+    emoji?: string;
+    default?: boolean;
+}
+export interface StringSelectDef extends BaseSelectDef<StringSelectMenuInteraction> {
+    options: readonly StringSelectOption[];
+}
+export interface ChannelSelectDef extends BaseSelectDef<ChannelSelectMenuInteraction> {
+    /** Restricts what the picker offers, e.g. text channels only. */
+    channelTypes?: readonly ChannelType[];
+    /**
+     * What the picker opens already holding.
+     *
+     * A picker returns its whole selection, never a delta, so one that opens
+     * empty over a setting that already has a value turns "change this" into
+     * "type the list again" — and anything the administrator forgets to re-pick
+     * is silently dropped.
+     */
+    defaultChannelIds?: readonly string[];
+}
+export interface RoleSelectDef extends BaseSelectDef<RoleSelectMenuInteraction> {
+    /** What the picker opens already holding. See {@link ChannelSelectDef.defaultChannelIds}. */
+    defaultRoleIds?: readonly string[];
+}
+export interface UserSelectDef extends BaseSelectDef<UserSelectMenuInteraction> {
+    /** What the picker opens already holding. See {@link ChannelSelectDef.defaultChannelIds}. */
+    defaultUserIds?: readonly string[];
+}
+/** A menu of caller-defined string values. */
+export declare function createStringSelect(def: StringSelectDef): SelectMenu<StringSelectMenuBuilder, StringSelectMenuInteraction>;
+/** A menu populated by Discord with the guild's channels. */
+export declare function createChannelSelect(def: ChannelSelectDef): SelectMenu<ChannelSelectMenuBuilder, ChannelSelectMenuInteraction>;
+/** A menu populated by Discord with the guild's roles. */
+export declare function createRoleSelect(def: RoleSelectDef): SelectMenu<RoleSelectMenuBuilder, RoleSelectMenuInteraction>;
+/**
+ * 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.
+ */
+export declare function createUserSelect(def: UserSelectDef): SelectMenu<UserSelectMenuBuilder, UserSelectMenuInteraction>;
+/**
+ * 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`.
+ */
+export declare function createSelectRow<B extends AnySelectMenuBuilder, I extends AnySelectMenuInteraction>(menu: SelectMenu<B, I>, forceDisabled?: boolean): ActionRowBuilder<B>;
+/**
+ * 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`.
+ */
+export declare function createSelectHandler<B extends AnySelectMenuBuilder, I extends AnySelectMenuInteraction>(menu: SelectMenu<B, I>, authorize: ComponentAuthorization): ComponentHandler;
+//# sourceMappingURL=select-menu.d.ts.map

package/dist/discord/interaction/select-menu.d.ts.map

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