@azurioh/discord-kernel 0.1.0

package/dist/discord/components/settings-editor/settings-editor-field-modal.js

@@ -0,0 +1,353 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptEditorFieldValue = promptEditorFieldValue;
+exports.promptEditorGroupValue = promptEditorGroupValue;
+const discord_js_1 = require("discord.js");
+const settings_editor_fields_1 = require("../../../discord/components/settings-editor/settings-editor-fields");
+const i18n_1 = require("../../../discord/i18n");
+const modal_1 = require("../../../discord/interaction/modal");
+const EDITOR_FIELD_MODAL_ID = "settings-editor:field-value";
+const EDITOR_GROUP_MODAL_ID = "settings-editor:group-value";
+/** Generous enough to write a whole embed description without racing a timeout. */
+const MODAL_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * `createModal(...).build()` with no state produces the same constant
+ * customId for every field modal (`EDITOR_FIELD_MODAL_ID`) and every group
+ * modal (`EDITOR_GROUP_MODAL_ID`) — one identifier shared by the whole
+ * editor. Combined with a `filter` that only checked the user, a stale
+ * `awaitModalSubmit` left behind by a modal the administrator opened and then
+ * dismissed (it keeps listening for the rest of {@link MODAL_TIMEOUT_MS})
+ * would resolve on the *next* modal that same user submitted, whatever field
+ * it belonged to — reported as opening "Add a game", abandoning it, then
+ * declaring a request field named "Date" ending up creating a game named
+ * "Date".
+ *
+ * The fix needs an identifier that is unique per *opening*, not just per
+ * field: the field/group key alone is not enough, because the same field can
+ * be reopened while an earlier, dismissed opening's wait is still alive. A
+ * process-local monotonic counter appended to the key is enough for that —
+ * it only has to distinguish opens within this process's own lifetime, never
+ * survive a restart, and carries no notion of time, so a `Clock` would be the
+ * wrong tool (and untestable without faking time for no reason).
+ *
+ * Making the customId dynamic like this is safe *here*: unlike a persistent
+ * component, this modal is never registered on the `ComponentRouter` — both
+ * `promptEditorFieldValue` and `promptEditorGroupValue` collect their
+ * submission directly with `awaitModalSubmit`, a one-shot collector that
+ * matches by whatever customId it is told to expect, not by the router's
+ * `customId`/`customId:*` rule. A dynamic id would break the router (it needs
+ * a stable prefix to keep matching after a restart); it does not break a
+ * collector.
+ */
+let modalOpenSequence = 0;
+/**
+ * A customId suffix unique to one modal opening: `key` for readability when
+ * debugging, plus a counter so reopening the same field still yields a
+ * different id from the opening before it.
+ */
+function nextModalOpenState(key) {
+    modalOpenSequence += 1;
+    return `${key}-${modalOpenSequence}`;
+}
+/** The customId a built modal actually carries, read back rather than reassembled. */
+function customIdOf(modal) {
+    return modal.toJSON().custom_id;
+}
+/** One image per override — the embed has exactly one slot for each. */
+const MAX_UPLOADS = 1;
+/**
+ * Ask for one field's new value, prefilled with the current one, and wait for
+ * the answer. Returns `null` on timeout or on any failure to show/collect it
+ * (the administrator dismissed the modal, say) — the caller treats that as
+ * "nothing happened", never as an error, and the screen stays as it was.
+ *
+ * `showModal` finally acknowledges `interaction`: nothing can `.update()` on it
+ * again, which is why the submission carries its own interaction to answer
+ * through.
+ *
+ * `MessageComponentInteraction` rather than `AnySelectMenuInteraction`: a menu
+ * entry opens the very same modal whether it is reached by picking it from a
+ * select (the embeds layout) or by clicking the button its own `Section`
+ * carries (the card layout), and both interaction kinds carry `showModal` and
+ * `awaitModalSubmit` from that shared base.
+ */
+async function promptEditorFieldValue(interaction, field, current, translator, locale) {
+    const modal = (0, settings_editor_fields_1.isPickerField)(field)
+        ? createPickerModal(field, current, translator, locale)
+        : field.kind === "image"
+            ? createImageModal(field, current, translator, locale)
+            : createTextModal(field, current, translator, locale);
+    try {
+        const built = modal.build(nextModalOpenState(field.key));
+        const expectedCustomId = customIdOf(built);
+        await interaction.showModal(built);
+        const submitted = await interaction.awaitModalSubmit({
+            time: MODAL_TIMEOUT_MS,
+            filter: (submission) => submission.user.id === interaction.user.id && submission.customId === expectedCustomId,
+        });
+        // A modal opened from a message submits as a `ModalMessageModalSubmit`
+        // interaction — the only kind that can `.update()` the screen in place.
+        // Anything else did not come from it, so it is dropped rather than answered
+        // on a message it has no claim to.
+        if (!submitted.isFromMessage()) {
+            return null;
+        }
+        return { interaction: submitted, ...modal.read(submitted) };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ask for every setting a group declares at once, in a single modal — the
+ * group's counterpart of {@link promptEditorFieldValue}. Each member is laid
+ * out in the geometry its own `kind` imposes, exactly as it would if it were
+ * prompted on its own, and prefilled the same way: from `currentValue`, asked
+ * once per member.
+ *
+ * `legend` is extra text shown above the fields — a token list a message field
+ * reads against, say — already counted against the modal's own five-component
+ * budget by the caller that built it; `null` when the group has nothing to say
+ * there.
+ */
+async function promptEditorGroupValue(interaction, group, currentValue, legend, translator, locale) {
+    const modal = createGroupModal(group, currentValue, legend, translator, locale);
+    try {
+        const built = modal.build(nextModalOpenState(group.key));
+        const expectedCustomId = customIdOf(built);
+        await interaction.showModal(built);
+        const submitted = await interaction.awaitModalSubmit({
+            time: MODAL_TIMEOUT_MS,
+            filter: (submission) => submission.user.id === interaction.user.id && submission.customId === expectedCustomId,
+        });
+        if (!submitted.isFromMessage()) {
+            return null;
+        }
+        return { interaction: submitted, values: modal.read(submitted) };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * A group's modal: one component per member field, each in the shape its own
+ * `kind` names, built through the very builders a single-field modal uses —
+ * `createModal`'s own generic `read` is what lets this stay one function
+ * whatever mix of text and picker members a group declares.
+ *
+ * A member of kind `image` is refused here rather than supported: an image
+ * field needs two components of its own (the upload, and the address beside
+ * it), which a group already spending one slot per member — and possibly one
+ * more on `legend` — has no general room for, and no group this repository
+ * declares needs one.
+ */
+function createGroupModal(group, currentValue, legend, translator, locale) {
+    const label = translator.translate(locale, group.labelKey);
+    const fields = {};
+    for (const member of group.fields) {
+        const current = currentValue(member.key);
+        if ((0, settings_editor_fields_1.isPickerField)(member)) {
+            fields[member.key] = pickerFieldDef(member, pickerShared(member, translator, locale), current.picked, translator, locale);
+            continue;
+        }
+        if (member.kind === "image") {
+            throw new Error(`Settings editor group "${group.key}" declares member "${member.key}" of kind "image"; a group's modal has no room for the separate upload component an image field needs. Declare it as "text" instead.`);
+        }
+        fields[member.key] = valueFieldDefOf(member, current, translator, locale);
+    }
+    const modal = (0, modal_1.createModal)({
+        id: EDITOR_GROUP_MODAL_ID,
+        title: modalTitle(label, translator, locale),
+        ...(legend === null ? {} : { legend }),
+        fields,
+    });
+    return {
+        build: (state) => modal.build(state),
+        read: (interaction) => {
+            const raw = modal.read(interaction);
+            const values = {};
+            for (const member of group.fields) {
+                values[member.key] = (0, settings_editor_fields_1.isPickerField)(member)
+                    ? { value: null, upload: null, ids: raw[member.key] }
+                    : { value: raw[member.key], upload: null, ids: null };
+            }
+            return values;
+        },
+    };
+}
+function modalTitle(label, translator, locale) {
+    return translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.modalTitle, { field: label });
+}
+/** The greyed-out example inside the box, for a field that declared one. */
+function placeholderOf(field, translator, locale) {
+    if (field.placeholderKey === undefined) {
+        return {};
+    }
+    return {
+        placeholder: translator.translate(locale, field.placeholderKey, field.placeholderParams),
+    };
+}
+/**
+ * The one text-input component a `text`-kind field builds, whether it is
+ * prompted on its own (via {@link createTextModal}) or as a member of a group
+ * — the shape a group's modal needs from `createModal`'s own generic `read`
+ * is exactly this, unlabelled by which caller asked for it.
+ */
+function valueFieldDefOf(field, current, translator, locale) {
+    return {
+        kind: "text",
+        label: translator.translate(locale, field.labelKey),
+        description: translator.translate(locale, field.helperKey ?? i18n_1.SETTINGS_EDITOR_MESSAGES.modalHelper),
+        style: field.style,
+        required: false,
+        maxLength: field.maxLength,
+        ...placeholderOf(field, translator, locale),
+        ...(current.text === null ? {} : { value: current.text }),
+    };
+}
+/** Every field but the images: one optional text input, emptied to clear. */
+function createTextModal(field, current, translator, locale) {
+    const label = translator.translate(locale, field.labelKey);
+    const modal = (0, modal_1.createModal)({
+        id: EDITOR_FIELD_MODAL_ID,
+        title: modalTitle(label, translator, locale),
+        fields: { value: valueFieldDefOf(field, current, translator, locale) },
+    });
+    return {
+        build: (state) => modal.build(state),
+        read: (interaction) => ({ value: modal.read(interaction).value, upload: null, ids: null }),
+    };
+}
+/**
+ * An image field: a file upload and the address input side by side, both
+ * optional, two of the five components a modal may carry.
+ *
+ * Offering both is what keeps an administrator from having to host the file
+ * somewhere first, without taking away the address that a guild already
+ * pointing at its own CDN relies on.
+ */
+function createImageModal(field, current, translator, locale) {
+    const label = translator.translate(locale, field.labelKey);
+    const modal = (0, modal_1.createModal)({
+        id: EDITOR_FIELD_MODAL_ID,
+        title: modalTitle(label, translator, locale),
+        fields: {
+            upload: {
+                kind: "file",
+                label: translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.modalUploadLabel),
+                description: translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.modalUploadHelper, {
+                    max: field.uploadMaxMib ?? 0,
+                }),
+                required: false,
+                maxValues: MAX_UPLOADS,
+            },
+            value: {
+                kind: "text",
+                label: translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.modalImageUrlLabel),
+                description: translator.translate(locale, current.uploaded
+                    ? i18n_1.SETTINGS_EDITOR_MESSAGES.modalImageHelperUploaded
+                    : i18n_1.SETTINGS_EDITOR_MESSAGES.modalImageHelper),
+                style: field.style,
+                required: false,
+                maxLength: field.maxLength,
+                ...(current.text === null ? {} : { value: current.text }),
+            },
+        },
+    });
+    return {
+        build: (state) => modal.build(state),
+        read: (interaction) => {
+            const values = modal.read(interaction);
+            return { value: values.value, upload: values.upload?.[0] ?? null, ids: null };
+        },
+    };
+}
+/**
+ * A picker field's modal: one select of the shape its kind names — role, user,
+ * channel or a closed set of choices — prefilled with what it already holds.
+ *
+ * `category` narrows a channel select to {@link ChannelType.GuildCategory}: the
+ * very shorthand `createPickerRow` used to express, reproduced here rather than
+ * left behind now that the picker lives in a modal instead of the message.
+ */
+function createPickerModal(field, current, translator, locale) {
+    const label = translator.translate(locale, field.labelKey);
+    const modal = (0, modal_1.createModal)({
+        id: EDITOR_FIELD_MODAL_ID,
+        title: modalTitle(label, translator, locale),
+        fields: {
+            value: pickerFieldDef(field, pickerShared(field, translator, locale), current.picked, translator, locale),
+        },
+    });
+    return {
+        build: (state) => modal.build(state),
+        read: (interaction) => {
+            const read = modal.read(interaction);
+            return { value: null, upload: null, ids: read.value };
+        },
+    };
+}
+/**
+ * What every picker component shares, whatever its own kind narrows it to —
+ * used whether the field is prompted on its own or as a member of a group.
+ */
+function pickerShared(field, translator, locale) {
+    const placeholder = field.pickerPlaceholderKey === undefined
+        ? undefined
+        : translator.translate(locale, field.pickerPlaceholderKey);
+    return {
+        label: translator.translate(locale, field.labelKey),
+        // Zero is what lets the administrator clear the setting by emptying the
+        // select — `createModal` then hands `null` back on an empty submission
+        // instead of refusing to open with nothing picked.
+        required: (field.minValues ?? 1) !== 0,
+        minValues: field.minValues,
+        maxValues: field.maxValues,
+        ...(placeholder === undefined ? {} : { placeholder }),
+    };
+}
+/** The one component a picker modal carries, in the shape its field's kind names. */
+function pickerFieldDef(field, shared, held, translator, locale) {
+    // `modal.ts`'s builders open a default whenever the key is present at all,
+    // empty array included — so an empty selection is left out entirely rather
+    // than handed through, the same guard `createRoleSelect` (the select-menu
+    // DSL the in-message picker used) already applied.
+    switch (field.kind) {
+        case "role":
+            return { kind: "role", ...shared, ...(held.length === 0 ? {} : { defaultRoleIds: held }) };
+        case "user":
+            return { kind: "user", ...shared, ...(held.length === 0 ? {} : { defaultUserIds: held }) };
+        case "category":
+            return {
+                kind: "channel",
+                ...shared,
+                channelTypes: [discord_js_1.ChannelType.GuildCategory],
+                ...(held.length === 0 ? {} : { defaultChannelIds: held }),
+            };
+        case "channel":
+            return {
+                kind: "channel",
+                ...shared,
+                channelTypes: field.channelTypes,
+                ...(held.length === 0 ? {} : { defaultChannelIds: held }),
+            };
+        case "choice":
+            return {
+                kind: "select",
+                ...shared,
+                options: field.choices.map((choice) => ({
+                    label: translator.translate(locale, choice.labelKey),
+                    value: choice.value,
+                    ...(choice.descriptionKey === undefined
+                        ? {}
+                        : { description: translator.translate(locale, choice.descriptionKey) }),
+                    // Marked rather than prefilled the way an entity select's default is:
+                    // Discord has no "default value" concept for a string select, only a
+                    // per-option flag, which is also how the reader still sees which of a
+                    // closed set is in force.
+                    default: held.includes(choice.value),
+                })),
+            };
+    }
+}
+//# sourceMappingURL=settings-editor-field-modal.js.map

package/dist/discord/components/settings-editor/settings-editor-field-modal.js.map

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

package/dist/discord/components/settings-editor/settings-editor-fields.d.ts

@@ -0,0 +1,216 @@
+import type { ChannelType } from "discord.js";
+import type { TextFieldStyleName } from "../../../discord/interaction/modal";
+import type { TranslationParams } from "../../../i18n";
+/**
+ * How a field is entered.
+ *
+ * `image` is the only typed one that differs: it offers a file upload beside the
+ * address box, because an administrator should not have to host a picture
+ * somewhere before the bot will show it.
+ *
+ * `role`, `category`, `user`, `channel` and `choice` are picked rather than
+ * typed — see {@link SettingsEditorPickerField}.
+ */
+export type SettingsEditorFieldKind = "text" | "image" | "level" | "role" | "category" | "user" | "channel" | "choice";
+/**
+ * What every menu entry states, whatever picking it does.
+ *
+ * `hintKey` is required rather than optional on purpose: an entry the reader
+ * cannot tell apart from its neighbours is the very problem these screens exist
+ * to solve, so a declaration without one does not typecheck.
+ */
+interface SettingsEditorEntry<F extends string> {
+    readonly key: F;
+    readonly labelKey: string;
+    /** Shown under the label in the menu — what this field controls, in one line. */
+    readonly hintKey: string;
+    /**
+     * The emoji a card layout's own button wears for this entry, in place of the
+     * generic one `mount-settings-editor.ts` would otherwise pick from the
+     * entry's own kind — a pencil for something edited, an arrow for a level
+     * descended into. Declared only where the generic would lie: an entry that
+     * opens a modal to *create* something reads wrong under a pencil, the icon
+     * for changing what already exists. Left undeclared, which is most entries,
+     * the generic stands exactly as it did before this existed.
+     */
+    readonly icon?: string;
+}
+/**
+ * An entry that goes somewhere rather than editing anything: picking it descends
+ * into `levelKey`, and the return control comes back.
+ *
+ * It declares no modal geometry because it opens no modal — which the union
+ * below enforces rather than leaving to a comment.
+ */
+export interface SettingsEditorLevelField<F extends string> extends SettingsEditorEntry<F> {
+    readonly kind: "level";
+    readonly levelKey: string;
+}
+/**
+ * One editable field of a customisable embed: what it is called, what editing it
+ * looks like, and what it is allowed to hold.
+ *
+ * Pure data, deliberately: both screens declare their fields as a constant list,
+ * which is what lets the menu, the modal and the notices be built from one
+ * declaration instead of three that have to agree.
+ */
+export interface SettingsEditorValueField<F extends string> extends SettingsEditorEntry<F> {
+    readonly kind: "text" | "image";
+    readonly style: TextFieldStyleName;
+    /**
+     * Stops an over-long value at the client instead of rejecting it after the
+     * round trip. The domain parsers still enforce the real limit: this one is
+     * capped by what a modal input can carry at all.
+     */
+    readonly maxLength: number;
+    /**
+     * Replaces the generic "leave empty to clear" helper under the box, for a
+     * field whose empty case means something of its own.
+     */
+    readonly helperKey?: string;
+    /**
+     * The upload cap the helper text states, in MiB. Declared by the screen
+     * because the limit is the caller's own — the editor neither enforces it nor
+     * knows what is being stored.
+     */
+    readonly uploadMaxMib?: number;
+    /** Greyed-out example inside the box — the welcome message's token list. */
+    readonly placeholderKey?: string;
+    readonly placeholderParams?: TranslationParams;
+}
+/** What every picked entry states, whichever list it is picked from. */
+interface SettingsEditorPickerEntry<F extends string> extends SettingsEditorEntry<F> {
+    /** How many may be picked at once. One unless the screen says otherwise. */
+    readonly maxValues?: number;
+    /** Zero lets the picker clear the setting; one makes it mandatory. */
+    readonly minValues?: number;
+    /** Shown inside the picker before anything is chosen. */
+    readonly pickerPlaceholderKey?: string;
+}
+/**
+ * An entry picked from a list Discord populates itself — a role, a member, or a
+ * category channel.
+ *
+ * `category` is the shorthand for the one channel shape a screen keeps asking
+ * for; anything else states its own types through
+ * {@link SettingsEditorChannelField}.
+ */
+export interface SettingsEditorEntityField<F extends string> extends SettingsEditorPickerEntry<F> {
+    readonly kind: "role" | "category" | "user";
+}
+/** An entry picked from the guild's channels, narrowed to the types it names. */
+export interface SettingsEditorChannelField<F extends string> extends SettingsEditorPickerEntry<F> {
+    readonly kind: "channel";
+    /**
+     * Required rather than optional: a channel picker offering every kind in the
+     * guild for a setting that only accepts one of them invites a choice the write
+     * then refuses.
+     */
+    readonly channelTypes: readonly ChannelType[];
+}
+/** One option of a {@link SettingsEditorChoiceField}. */
+export interface SettingsEditorChoice {
+    /** What is stored — never shown, so it is not translated. */
+    readonly value: string;
+    readonly labelKey: string;
+    /** Shown under the label, as a menu entry's hint is. Optional: a two-way toggle rarely needs one. */
+    readonly descriptionKey?: string;
+}
+/**
+ * An entry picked from a list the screen itself declares — a visibility mode, a
+ * weekday.
+ *
+ * The command layer expresses these as `createStringOption().choices(...)`, and
+ * a setting that had a closed set of values when it was a command still has one
+ * once it moves behind a screen. Typing the value back into a modal would turn a
+ * guaranteed-valid pick into a spelling test whose only feedback is a refusal.
+ */
+export interface SettingsEditorChoiceField<F extends string> extends SettingsEditorPickerEntry<F> {
+    readonly kind: "choice";
+    readonly choices: readonly SettingsEditorChoice[];
+}
+/**
+ * An entry whose value is picked rather than typed.
+ *
+ * A modal carries text inputs only and cannot be changed once open, so a role, a
+ * member, a channel or one of a closed set of values has to be chosen from a
+ * component. Declaring the kind rather than wiring each picker by hand keeps the
+ * one-declaration property: a field cannot appear in the menu with no way to
+ * edit it.
+ *
+ * It states no modal geometry, for the same reason a level does not.
+ */
+export type SettingsEditorPickerField<F extends string> = SettingsEditorEntityField<F> | SettingsEditorChannelField<F> | SettingsEditorChoiceField<F>;
+/**
+ * An entry that asks for several settings at once, in a single modal — a
+ * tournament's announcement message, colour, image and footer, which read as
+ * one decision rather than four.
+ *
+ * Its member fields are declared *inside* the group rather than as menu
+ * entries of their own: that is what keeps the repository's "one declaration"
+ * property — each member still owns the single `key` `currentValue` and the
+ * write are named by, it is only the menu that no longer lists it separately.
+ *
+ * A level that reduces to a single group is not a level: per the rule this
+ * repository already states for `COMMS_AREA_FIELDS` ("a domain that carries a
+ * single setting *is* that setting, not a level"), a group replaces the level
+ * outright rather than being offered as its lone entry.
+ */
+export interface SettingsEditorGroupField<F extends string> extends SettingsEditorEntry<F> {
+    readonly kind: "group";
+    /** The settings this modal asks for, in the order it poses them. */
+    readonly fields: readonly (SettingsEditorValueField<F> | SettingsEditorPickerField<F>)[];
+}
+/**
+ * A menu entry: either something to edit, or somewhere to go.
+ *
+ * Kept as one union so a level and a field are declared side by side in the same
+ * list, in the order the menu offers them — the screen's shape is one constant,
+ * not a field list plus a navigation table that could disagree about ordering.
+ */
+export type SettingsEditorField<F extends string> = SettingsEditorValueField<F> | SettingsEditorPickerField<F> | SettingsEditorLevelField<F> | SettingsEditorGroupField<F>;
+/** Whether this entry is typed — a text box or an image upload — rather than picked. */
+export declare function isValueField<F extends string>(field: SettingsEditorField<F>): field is SettingsEditorValueField<F>;
+/**
+ * Whether this entry is picked from a list rather than typed.
+ *
+ * Both shapes open a modal; this only decides which geometry it opens with — a
+ * role/user/channel select or a string select, prefilled from the current
+ * selection, in place of a text input.
+ */
+export declare function isPickerField<F extends string>(field: SettingsEditorField<F>): field is SettingsEditorPickerField<F>;
+/** Whether this entry opens a modal asking for several settings at once. */
+export declare function isGroupField<F extends string>(field: SettingsEditorField<F>): field is SettingsEditorGroupField<F>;
+/** The stored value of one field, as the modal editing it opens on. */
+export interface SettingsEditorFieldValue {
+    /** Prefills the text input; `null` when there is nothing to type back. */
+    readonly text: string | null;
+    /**
+     * Whether the field currently holds an upload. Discord cannot prefill a file
+     * input, so the modal says so in words instead of opening on a blank that
+     * reads like nothing being set.
+     */
+    readonly uploaded: boolean;
+    /** The identifiers a picker field currently carries. Empty for a field that is not picked. */
+    readonly picked: readonly string[];
+}
+/** A text override, as the modal editing it opens on. */
+export declare function textFieldValue(value: string | null): SettingsEditorFieldValue;
+/** A picker override, as the modal editing it opens on — prefilled from what it already holds. */
+export declare function pickedFieldValue(ids: readonly string[]): SettingsEditorFieldValue;
+/** Discord's own cap on a modal text input, whatever the embed itself would take. */
+export declare const MAX_MODAL_INPUT_LENGTH = 4000;
+/**
+ * Discord's own cap on a modal's top-level components: "between 1 and 5
+ * (inclusive) components that make up the modal" (Discord's interaction
+ * callback data reference). A group's member fields count against it one for
+ * one — each becomes a `Label` — and so does the legend a group's modal may
+ * carry, via a `TextDisplay`.
+ */
+export declare const MAX_MODAL_COMPONENTS = 5;
+/** Whether a value picked from the menu is one of the fields a screen declared. */
+export declare function isEditorField<F extends string>(fields: readonly SettingsEditorField<F>[], value: string): value is F;
+/** The declaration of one field, by key. */
+export declare function editorField<F extends string>(fields: readonly SettingsEditorField<F>[], key: F): SettingsEditorField<F>;
+export {};
+//# sourceMappingURL=settings-editor-fields.d.ts.map

package/dist/discord/components/settings-editor/settings-editor-fields.d.ts.map

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

package/dist/discord/components/settings-editor/settings-editor-fields.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_MODAL_COMPONENTS = exports.MAX_MODAL_INPUT_LENGTH = void 0;
+exports.isValueField = isValueField;
+exports.isPickerField = isPickerField;
+exports.isGroupField = isGroupField;
+exports.textFieldValue = textFieldValue;
+exports.pickedFieldValue = pickedFieldValue;
+exports.isEditorField = isEditorField;
+exports.editorField = editorField;
+/** Whether this entry is typed — a text box or an image upload — rather than picked. */
+function isValueField(field) {
+    return field.kind === "text" || field.kind === "image";
+}
+/**
+ * Whether this entry is picked from a list rather than typed.
+ *
+ * Both shapes open a modal; this only decides which geometry it opens with — a
+ * role/user/channel select or a string select, prefilled from the current
+ * selection, in place of a text input.
+ */
+function isPickerField(field) {
+    return (field.kind === "role" ||
+        field.kind === "category" ||
+        field.kind === "user" ||
+        field.kind === "channel" ||
+        field.kind === "choice");
+}
+/** Whether this entry opens a modal asking for several settings at once. */
+function isGroupField(field) {
+    return field.kind === "group";
+}
+/** A text override, as the modal editing it opens on. */
+function textFieldValue(value) {
+    return { text: value, uploaded: false, picked: [] };
+}
+/** A picker override, as the modal editing it opens on — prefilled from what it already holds. */
+function pickedFieldValue(ids) {
+    return { text: null, uploaded: false, picked: ids };
+}
+/** Discord's own cap on a modal text input, whatever the embed itself would take. */
+exports.MAX_MODAL_INPUT_LENGTH = 4000;
+/**
+ * Discord's own cap on a modal's top-level components: "between 1 and 5
+ * (inclusive) components that make up the modal" (Discord's interaction
+ * callback data reference). A group's member fields count against it one for
+ * one — each becomes a `Label` — and so does the legend a group's modal may
+ * carry, via a `TextDisplay`.
+ */
+exports.MAX_MODAL_COMPONENTS = 5;
+/** Whether a value picked from the menu is one of the fields a screen declared. */
+function isEditorField(fields, value) {
+    return fields.some((field) => field.key === value);
+}
+/** The declaration of one field, by key. */
+function editorField(fields, key) {
+    const found = fields.find((field) => field.key === key);
+    if (found === undefined) {
+        // Unreachable: a key only ever reaches here after `isEditorField` matched
+        // it against this very list. Kept because nothing in the types ties the two
+        // calls together.
+        throw new Error(`No editable field declared under "${key}"`);
+    }
+    return found;
+}
+//# sourceMappingURL=settings-editor-fields.js.map