@azurioh/discord-kernel 0.1.0

package/dist/discord/components/settings-editor/settings-editor-card.view.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CARD_BUTTON_LEVEL_ENTRIES = exports.MAX_CARD_LEVEL_ENTRIES = void 0;
+exports.fieldButtonId = fieldButtonId;
+exports.createCardEditorView = createCardEditorView;
+const navigation_1 = require("../../../discord/components/settings-editor/navigation");
+const settings_editor_view_1 = require("../../../discord/components/settings-editor/settings-editor.view");
+const i18n_1 = require("../../../discord/i18n");
+const button_1 = require("../../../discord/interaction/button");
+const card_1 = require("../../../discord/ui/card");
+const colors_1 = require("../../../discord/ui/colors");
+/**
+ * Discord refuses a card carrying more than {@link import("../../../discord/ui/card").MAX_CARD_COMPONENTS}
+ * components; every menu entry a level declares becomes a `Section` — its
+ * text plus a button accessory, three components — so this is what a level's
+ * own field list may not exceed *before* the chrome fixed around it
+ * (breadcrumb, preview, extra blocks, separators, the bottom controls, the
+ * signature) is even counted. Generous rather than exact: the fixed chrome
+ * costs roughly a dozen components on its own, and no level this repository
+ * declares comes within three of this cap.
+ */
+exports.MAX_CARD_LEVEL_ENTRIES = 10;
+/**
+ * Discord refuses an `ActionRow` carrying more than five buttons, so a level
+ * declaring `entryLayout: "buttons"` folds its entries into as many rows of
+ * this size as it needs, rather than the single row it used to require.
+ */
+const BUTTONS_PER_ROW = 5;
+/**
+ * How many entries a level declaring `entryLayout: "buttons"` may carry
+ * before the rows they compile to — one `ActionRow` per five, however many
+ * that takes — would overrun what a container can actually hold.
+ *
+ * Sits higher than {@link MAX_CARD_LEVEL_ENTRIES} on purpose: a `"buttons"`
+ * row costs its `ActionRow` plus the buttons in it, cheaper per entry than a
+ * `"sections"` level's `Section` (text, accessory, the `Section` itself —
+ * three components apiece). Generous rather than exact, for the same reason
+ * {@link MAX_CARD_LEVEL_ENTRIES} is: the fixed chrome (breadcrumb, preview,
+ * separators, the bottom controls, the signature) costs roughly a dozen
+ * components on its own, and no level this repository declares comes within
+ * half of this cap.
+ */
+exports.MAX_CARD_BUTTON_LEVEL_ENTRIES = 20;
+/**
+ * The most buttons {@link SettingsEditorCardChrome.entryActions} ever adds to
+ * one render of a level's own row: the confirm/cancel pair a screen's own
+ * removal swaps to once armed — the single ask button it swaps *from* costs
+ * less. Reserved against every `"buttons"` level's own cap whenever the
+ * chrome declares the hook at all: the guard below runs once at construction,
+ * before any state — and so before `entryActions` has anything to measure —
+ * exists.
+ */
+const ENTRY_ACTIONS_RESERVE = 2;
+/**
+ * The button a menu entry's own `Section` carries, derived from the field's
+ * key rather than declared alongside it — the same relationship `ids.field`
+ * already has to the select it used to name, one level of indirection lower.
+ */
+function fieldButtonId(ids, key) {
+    return `${ids.field}:${key}`;
+}
+/**
+ * The card editor screen: one Components V2 card carrying the breadcrumb, the
+ * last notice, whatever the screen adds above the preview, the preview
+ * itself, a `Section` per entry of the current level — each with the button
+ * `fieldButtonId` names — and the bottom controls, closing with the bot's own
+ * signature.
+ *
+ * The counterpart of `createEditorView` for a screen declaring
+ * `chrome.layout === "card"`; the two never mix; {@link mountSettingsEditor}
+ * picks whichever this screen's chrome names.
+ *
+ * Takes no `SettingsEditorIds` of its own, unlike `createEditorView`: every
+ * button it renders — reset, back, and one per menu entry — already exists,
+ * built by `mountSettingsEditor` against those very ids, so nothing here has
+ * to name them again.
+ */
+function createCardEditorView(fields, levels, buttons, fieldButtons, chrome, translator, locale, dressing) {
+    const screenTitle = translator.translate(locale, chrome.titleKey);
+    // Separates the levels in the breadcrumb trail.
+    const BREADCRUMB_SEPARATOR = " › ";
+    // The root is a level like any other, named after the screen itself, so
+    // rendering never special-cases "no depth declared" — the same bargain
+    // `createEditorView` strikes for the embeds layout. Its own `entryLayout`
+    // is the chrome's, mirroring `SettingsEditorLevel.entryLayout` for the one
+    // level that is never itself a `SettingsEditorLevel`.
+    const root = {
+        key: navigation_1.ROOT_LEVEL_KEY,
+        titleKey: chrome.titleKey,
+        fields,
+        entryLayout: chrome.entryLayout,
+    };
+    const allLevels = [root, ...(levels ?? [])];
+    // A level's fields are authored, not accumulated: passing more entries than a
+    // card can carry is a mistake in the declaration, and Discord would reject
+    // the whole message rather than show the first ones that fit. Failing here
+    // names the level; failing at render time would only say the message was
+    // invalid.
+    for (const level of allLevels) {
+        // A `"buttons"` level spends its budget on rows of `ActionRow`s rather
+        // than `Section`s, so it is checked against its own, higher cap instead
+        // of the `"sections"` one — failing here names the level rather than the
+        // invalid message Discord would otherwise reject. The chrome's own
+        // `entryActions`, when declared, reserves its worst case on top of the
+        // level's declared fields: those buttons exist only once a state renders
+        // them, which this construction-time guard has none of to count instead.
+        if (level.entryLayout === "buttons") {
+            const reserve = chrome.entryActions === undefined ? 0 : ENTRY_ACTIONS_RESERVE;
+            if (level.fields.length + reserve > exports.MAX_CARD_BUTTON_LEVEL_ENTRIES) {
+                throw new Error(`Settings editor level "${level.key}" declares ${level.fields.length} entries${reserve === 0 ? "" : ` (+${reserve} reserved for the chrome's own entryActions)`} with entryLayout "buttons"; a card holds ${exports.MAX_CARD_BUTTON_LEVEL_ENTRIES} before its own controls. Split it into a deeper level.`);
+            }
+        }
+        else if (level.fields.length > exports.MAX_CARD_LEVEL_ENTRIES) {
+            throw new Error(`Settings editor level "${level.key}" declares ${level.fields.length} entries; a card section holds ${exports.MAX_CARD_LEVEL_ENTRIES} before its own controls. Split it into a deeper level.`);
+        }
+    }
+    function levelAt(key) {
+        return allLevels.find((level) => level.key === key) ?? root;
+    }
+    /**
+     * Where the reader is, as a trail rather than only the current name: a level
+     * called "Roles" says nothing on its own about which type it belongs to.
+     */
+    function heading(state) {
+        return state.path
+            .map((key) => translator.translate(locale, levelAt(key).titleKey))
+            .join(BREADCRUMB_SEPARATOR);
+    }
+    /**
+     * The bot's own signature, once at the bottom of the card rather than on
+     * every embed the way two embeds each carried their own footer. Discord's
+     * own timestamp markdown, so it reads in the viewer's own locale exactly as
+     * an embed's timestamp already did.
+     */
+    function signature() {
+        const unixSeconds = Math.floor(dressing.clock.now().getTime() / 1000);
+        return `-# ${screenTitle} • <t:${unixSeconds}:t>`;
+    }
+    /**
+     * One menu entry, as the `Section` that replaces it: its label as the title,
+     * its hint as the line under it, and the button `mountSettingsEditor`
+     * registered for it as the accessory — the very button that opens its modal
+     * or descends into it, reached by a click instead of a pick.
+     */
+    function entrySection(field) {
+        const title = translator.translate(locale, field.labelKey);
+        const lines = [translator.translate(locale, field.hintKey)];
+        const action = fieldButtons.get(field.key);
+        return action === undefined
+            ? { kind: "entry", title, lines }
+            : { kind: "entry", title, lines, action };
+    }
+    /**
+     * A `"buttons"` level's entries, as the rows that replace their `Section`s:
+     * each field's own button — labelled with the entry's own name, not the
+     * generic "Open"/"Edit" a `"sections"` level wears, which is the whole
+     * point of folding them into rows of buttons instead of stacking them.
+     * `mountSettingsEditor` is what actually words the button that way — see
+     * its own `buildFieldButton` — this only collects the ones this level owns.
+     */
+    function entryButtons(level) {
+        return level.fields.map((field) => {
+            const button = fieldButtons.get(field.key);
+            if (button === undefined) {
+                // `fieldButtons` is built by `mountSettingsEditor` over every field of
+                // every level up front, this level's included — unreachable outside a
+                // wiring mistake in that map, not something an administrator can cause.
+                throw new Error(`Settings editor level "${level.key}" has no button registered for field "${field.key}".`);
+            }
+            return button;
+        });
+    }
+    /**
+     * A `"buttons"` level's entries row for one render: its own field buttons,
+     * plus whatever {@link SettingsEditorCardChrome.entryActions} adds — the
+     * create/edit/remove row a module's own removal control now lives in,
+     * rather than floating beside a picker or hiding at the bottom of the card.
+     *
+     * A screen's own action waiting on its second click takes the row over
+     * entirely: while `state.confirming` names anything, the level's own
+     * buttons step aside and the row is exactly what `entryActions` returns —
+     * the confirm/cancel pair, once it recognises its own key in `confirming`.
+     * The same "the pending question replaces what is here" rule the editor's
+     * own reset already follows for the row below the card, transposed to a
+     * level's own entries instead of the screen's outer one.
+     */
+    function levelButtons(level, state) {
+        const actions = chrome.entryActions?.(state) ?? [];
+        return state.confirming === null ? [...entryButtons(level), ...actions] : actions;
+    }
+    /**
+     * Split a `"buttons"` level's entries into as many rows of
+     * {@link BUTTONS_PER_ROW} as they need — Discord's own cap on one
+     * `ActionRow`, not a limit on how many entries the level may declare in
+     * total (that is {@link MAX_CARD_BUTTON_LEVEL_ENTRIES}, checked above).
+     */
+    function buttonRows(buttons) {
+        const rows = [];
+        for (let start = 0; start < buttons.length; start += BUTTONS_PER_ROW) {
+            rows.push({ kind: "controls", buttons: buttons.slice(start, start + BUTTONS_PER_ROW) });
+        }
+        return rows;
+    }
+    /**
+     * The screen's own controls for the current state, outside the card
+     * entirely — see the module-level note on {@link SettingsEditorRow}. Empty
+     * for a screen with nothing to offer here at all — a flat screen with
+     * nothing to reset, with dismissing the message the only way out.
+     */
+    function outerButtons(state) {
+        if (state.confirming === settings_editor_view_1.SETTINGS_EDITOR_RESET_CONFIRMING) {
+            return buttons.confirming;
+        }
+        // Reset, then the return control — the order the outer row reads left to
+        // right. Each is absent rather than disabled wherever there is nothing for
+        // it to do, same principle both already followed on their own.
+        return [
+            ...(0, settings_editor_view_1.resetButtons)(buttons, chrome, state),
+            ...((0, navigation_1.canReturn)(state.path) ? buttons.returning : []),
+        ];
+    }
+    /** {@link outerButtons}, compiled into the one row it renders as — or none at all. */
+    function outerRow(state, forceDisabled) {
+        const row = outerButtons(state);
+        return row.length === 0 ? [] : [(0, button_1.createActionRow)(row, state, { disableAll: forceDisabled })];
+    }
+    /**
+     * The card's blocks, top to bottom — but for the screen's own controls,
+     * which render beside the card rather than inside it — see {@link outerRow}.
+     * `disabled` here means only "the editor's own reset is waiting for its
+     * second click", not the outer neutralising pass: that one is `Card.apply`'s
+     * own `forceDisabled`, applied uniformly across every block a second time —
+     * see {@link import("../../../discord/ui/card").Card}.
+     */
+    function openBlocks(state) {
+        const confirmingReset = state.confirming === settings_editor_view_1.SETTINGS_EDITOR_RESET_CONFIRMING;
+        const level = levelAt((0, navigation_1.currentLevelKey)(state.path));
+        const notice = confirmingReset
+            ? {
+                kind: "entry",
+                title: translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.resetConfirmTitle),
+                lines: [translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.resetConfirmDescription)],
+            }
+            : state.notice === null
+                ? null
+                : { kind: "text", content: state.notice.text };
+        const entries = level.entryLayout === "buttons"
+            ? buttonRows(levelButtons(level, state))
+            : level.fields.map((field) => entrySection(field));
+        return [
+            { kind: "text", content: `-# ${heading(state)}` },
+            notice,
+            ...(chrome.extraBlocks?.(state, confirmingReset) ?? []),
+            { kind: "separator" },
+            ...chrome.preview(state),
+            { kind: "separator" },
+            ...entries,
+            { kind: "text", content: signature() },
+        ];
+    }
+    function cardDef(state) {
+        return { accent: colors_1.EMBED_COLORS.brand, blocks: openBlocks(state) };
+    }
+    const mentions = chrome.allowedMentions === undefined ? {} : { allowedMentions: chrome.allowedMentions };
+    return {
+        render: (state) => ({
+            layout: "card",
+            card: (0, card_1.createCard)(cardDef(state)),
+            // The screen's own controls, beside the card rather than inside it —
+            // empty for a screen with nothing to offer here, which is what
+            // `outerRow` already returns.
+            controls: outerRow(state, false),
+            // Always stated, empty included: this is the screen's whole set of
+            // attachments, and an update that said nothing would leave the image of
+            // an override that has just been cleared sitting on the message.
+            files: [...chrome.filesOf(state)],
+            ...mentions,
+        }),
+        disabledControls: (state) => ({
+            components: [(0, card_1.createCard)(cardDef(state)).apply(state, true), ...outerRow(state, true)],
+        }),
+    };
+}
+//# sourceMappingURL=settings-editor-card.view.js.map

package/dist/discord/components/settings-editor/settings-editor-card.view.js.map

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

package/dist/discord/components/settings-editor/settings-editor-field-modal.d.ts

@@ -0,0 +1,69 @@
+import { type Attachment, type MessageComponentInteraction, type ModalMessageModalSubmitInteraction } from "discord.js";
+import { type SettingsEditorFieldValue, type SettingsEditorGroupField, type SettingsEditorPickerField, type SettingsEditorValueField } from "../../../discord/components/settings-editor/settings-editor-fields";
+import type { Locale, Translator } from "../../../i18n";
+export interface SettingsEditorSubmission {
+    /** The modal's own submit interaction — the only one still usable to answer. */
+    readonly interaction: ModalMessageModalSubmitInteraction;
+    /** `null` when the field came back empty, which is how an override is cleared. */
+    readonly value: string | null;
+    /**
+     * The uploaded image, on the fields that offer one. Always `null` elsewhere,
+     * and `null` on those when nothing was uploaded.
+     */
+    readonly upload: Attachment | null;
+    /**
+     * What a picker field reported. `null` when the selection was emptied — that
+     * is how such a setting is cleared. Always `null` on a value field.
+     */
+    readonly ids: readonly string[] | null;
+}
+/**
+ * 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.
+ */
+export declare function promptEditorFieldValue<F extends string>(interaction: MessageComponentInteraction, field: SettingsEditorValueField<F> | SettingsEditorPickerField<F>, current: SettingsEditorFieldValue, translator: Translator, locale: Locale): Promise<SettingsEditorSubmission | null>;
+/** What one member field of a group came back with — the group's own per-member slice. */
+export interface SettingsEditorGroupMemberSubmission {
+    readonly value: string | null;
+    readonly upload: Attachment | null;
+    readonly ids: readonly string[] | null;
+}
+/**
+ * What a group's modal came back with, one entry per member field it declared.
+ * A member absent from a submission cannot happen — every member the group
+ * declares is a component of the very modal that produced this — but the type
+ * stays a partial record rather than asserting it, since nothing here proves it
+ * to the compiler.
+ */
+export type SettingsEditorGroupSubmission<F extends string> = Readonly<Partial<Record<F, SettingsEditorGroupMemberSubmission>>>;
+/** What opening a group's modal resolves to: the submitted values, and the one interaction left to answer through. */
+export interface SettingsEditorGroupPrompt<F extends string> {
+    readonly interaction: ModalMessageModalSubmitInteraction;
+    readonly values: SettingsEditorGroupSubmission<F>;
+}
+/**
+ * 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.
+ */
+export declare function promptEditorGroupValue<F extends string>(interaction: MessageComponentInteraction, group: SettingsEditorGroupField<F>, currentValue: (memberKey: F) => SettingsEditorFieldValue, legend: string | null, translator: Translator, locale: Locale): Promise<SettingsEditorGroupPrompt<F> | null>;
+//# sourceMappingURL=settings-editor-field-modal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-editor-field-modal.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/settings-editor-field-modal.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,UAAU,EAEf,KAAK,2BAA2B,EAEhC,KAAK,kCAAkC,EACvC,MAAM,YAAY,CAAC;AACpB,OAAO,EAEN,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,MAAM,6DAA6D,CAAC;AAWrE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAyDjD,MAAM,WAAW,wBAAwB;IACxC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,kCAAkC,CAAC;IACzD,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAC5D,WAAW,EAAE,2BAA2B,EACxC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC,CAAC,CAAC,EACjE,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CA2B1C;AAED,0FAA0F;AAC1F,MAAM,WAAW,mCAAmC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,6BAA6B,CAAC,CAAC,SAAS,MAAM,IAAI,QAAQ,CACrE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,mCAAmC,CAAC,CAAC,CACvD,CAAC;AAEF,sHAAsH;AACtH,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,MAAM;IAC1D,QAAQ,CAAC,WAAW,EAAE,kCAAkC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAC5D,WAAW,EAAE,2BAA2B,EACxC,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAC,EAClC,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,wBAAwB,EACxD,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAkB9C"}