@azurioh/discord-kernel 0.1.0

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

@@ -0,0 +1,344 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountSettingsEditor = mountSettingsEditor;
+const interactive_message_1 = require("../../../discord/components/interactive-message");
+const navigation_1 = require("../../../discord/components/settings-editor/navigation");
+const settings_editor_view_1 = require("../../../discord/components/settings-editor/settings-editor.view");
+const settings_editor_card_view_1 = require("../../../discord/components/settings-editor/settings-editor-card.view");
+const settings_editor_field_modal_1 = require("../../../discord/components/settings-editor/settings-editor-field-modal");
+const settings_editor_fields_1 = require("../../../discord/components/settings-editor/settings-editor-fields");
+const i18n_1 = require("../../../discord/i18n");
+const button_1 = require("../../../discord/interaction/button");
+const errors_1 = require("../../../errors");
+const i18n_2 = require("../../../i18n");
+/**
+ * Mount the editor every customisable ticket embed is edited through: a preview
+ * of what members see, a menu of fields, a modal per field, and a confirmed
+ * reset.
+ *
+ * Everything specific to *what* is being edited — where the values are read,
+ * where they are written, how the preview is rendered — is supplied by the
+ * caller. What lives here is the part both screens would otherwise have written
+ * twice: the modal round trip, the read-at-submit-time rule, refusals turned
+ * into notices, and re-rendering through the interaction that is still usable.
+ *
+ * Call it on an already-deferred interaction.
+ */
+async function mountSettingsEditor(interaction, options) {
+    const { translator, locale } = options;
+    const { ids } = options;
+    const mounted = { screen: null };
+    const mountedView = { view: null };
+    // Every level's fields, flattened: a pick is routed by key, and the key is
+    // unique across the screen whichever level offered it.
+    const allFields = [
+        ...options.fields,
+        ...(options.levels ?? []).flatMap((level) => level.fields),
+    ];
+    /**
+     * Run one write and fold its outcome into the state. A refusal is answered
+     * identically wherever it comes from: nothing changes but the notice.
+     *
+     * The `try` covers `write()` alone — a `BusinessError` out of it is a
+     * legitimate refusal to show, because nothing landed. `onWritten` runs
+     * only once that write has actually succeeded, deliberately outside that
+     * `try`: a hook failing after the data is already saved is not a refusal
+     * of the write, and folding it into the same catch would tell the
+     * administrator their change was rejected when it was not — written and
+     * called a refusal is worse than either alone.
+     *
+     * `onWritten` is a public hook; nothing here trusts it not to throw. Its
+     * failure is logged rather than shown or re-thrown: the write already
+     * landed, so the administrator is owed the confirmation of what they
+     * actually did, and a side effect that failed to keep up (a public panel
+     * not yet refreshed, say) is an incident to trace, not a message to hand
+     * back to them on a screen that has nothing to do with it.
+     */
+    async function applyChange(state, write, notice) {
+        let written;
+        try {
+            written = await write();
+        }
+        catch (error) {
+            if (error instanceof errors_1.BusinessError) {
+                // A refusal is the one outcome the screen has to say out loud:
+                // nothing was written, so the preview shows no trace of it.
+                return {
+                    ...state,
+                    notice: { text: (0, i18n_2.resolveBusinessMessage)(error, translator, locale), tone: "refusal" },
+                };
+            }
+            throw error;
+        }
+        try {
+            await options.onWritten?.();
+        }
+        catch (error) {
+            options.logger.error({ err: (0, errors_1.describeError)(error) }, "onWritten failed after a settings editor write had already landed");
+        }
+        const { subject, assets } = written;
+        return { ...state, subject, assets, notice: { text: notice, tone: "confirmation" } };
+    }
+    /** Undo one step of where the screen is: leave the level for the one above it. */
+    function stepBack(clickCtx) {
+        const { state } = clickCtx;
+        return clickCtx.update({
+            ...state,
+            path: (0, navigation_1.popLevel)(state.path),
+            notice: null,
+            // Whatever a screen's own accessory button was waiting to have confirmed
+            // belonged to the level being left; carrying it up would let a click
+            // meant for something else fire it.
+            confirming: null,
+        });
+    }
+    function fieldNotice(field, submission) {
+        return translator.translate(locale, fieldNoticeKey(field, submission), {
+            field: translator.translate(locale, field.labelKey),
+        });
+    }
+    /**
+     * Edit one field: ask for its new value in a modal prefilled with the current
+     * one — a text input, an upload, or a select of the picker's own shape — save
+     * what comes back, and re-render the preview through the modal's own
+     * interaction, since `showModal` has already acknowledged the pick or click.
+     *
+     * `fieldKey` is the key of the field to edit — the select's own picked value
+     * on the embeds layout, the key baked into the button's id on the card
+     * layout — so both reach the very same round trip, and this is where they
+     * meet back up.
+     */
+    async function editField(ctx, fieldKey) {
+        const view = mountedView.view;
+        if (view === null || !(0, settings_editor_fields_1.isEditorField)(allFields, fieldKey)) {
+            // `view` is unreachable while `null`: nothing can click a control before
+            // `mountInteractiveMessage` sends the message it belongs to, and `view` is
+            // assigned before that call. An unrecognised key cannot happen from either
+            // control either — both are built from `allFields` — but is not worth
+            // throwing over.
+            return;
+        }
+        const field = (0, settings_editor_fields_1.editorField)(allFields, fieldKey);
+        if ((0, settings_editor_fields_1.isGroupField)(field)) {
+            await editGroup(ctx, field);
+            return;
+        }
+        if (!(0, settings_editor_fields_1.isValueField)(field) && !(0, settings_editor_fields_1.isPickerField)(field)) {
+            // A level: descending writes nothing, so it answers the click by
+            // re-rendering rather than going through `applyChange` — there is no
+            // outcome to report.
+            const state = mounted.screen?.store.read() ?? ctx.state;
+            await ctx.update({
+                ...state,
+                path: (0, navigation_1.pushLevel)(state.path, field.levelKey),
+                // The notice belonged to the level being left; carrying it down would
+                // credit this one with something that happened elsewhere. Likewise
+                // whatever a screen's own accessory button on that level was waiting
+                // to have confirmed.
+                notice: null,
+                confirming: null,
+            });
+            return;
+        }
+        const submission = await (0, settings_editor_field_modal_1.promptEditorFieldValue)(ctx.interaction, field, options.currentValue(ctx.state.subject, fieldKey), translator, locale);
+        if (submission === null) {
+            return;
+        }
+        // Read at submit time rather than at pick time: a modal can stay open for
+        // minutes, during which the screen may have moved on to another subject.
+        const state = mounted.screen?.store.read() ?? ctx.state;
+        const next = await applyChange(state, () => options.save(state.subject, fieldKey, submission), fieldNotice(field, submission));
+        mounted.screen?.store.write(next);
+        await submission.interaction.update((0, interactive_message_1.toMessageEditOptions)(view.render(next), [...submission.interaction.message.attachments.values()], next));
+    }
+    /**
+     * Edit a group: ask for every member field it declares in one modal,
+     * prefilled the same way a single field is, and save the whole thing as one
+     * write — `options.saveGroup` is what decides what "one write" means for
+     * this group, most often a service that already takes a partial patch.
+     */
+    async function editGroup(ctx, group) {
+        const view = mountedView.view;
+        if (view === null) {
+            return;
+        }
+        const prompt = await (0, settings_editor_field_modal_1.promptEditorGroupValue)(ctx.interaction, group, (memberKey) => options.currentValue(ctx.state.subject, memberKey), options.groupLegend?.(ctx.state.subject, group.key) ?? null, translator, locale);
+        if (prompt === null) {
+            return;
+        }
+        const { saveGroup } = options;
+        if (saveGroup === undefined) {
+            // A screen declaring a `group`-kind field must also declare `saveGroup` —
+            // a wiring mistake in the module, not something an administrator caused,
+            // so the round trip simply ends here rather than throwing at them for it.
+            return;
+        }
+        // Read at submit time rather than at pick time, exactly as `editField`
+        // does: a modal can stay open for minutes, during which the screen may
+        // have moved on to another subject.
+        const state = mounted.screen?.store.read() ?? ctx.state;
+        const next = await applyChange(state, () => saveGroup(state.subject, group.key, prompt.values, prompt.interaction), translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.fieldSaved, {
+            field: translator.translate(locale, group.labelKey),
+        }));
+        mounted.screen?.store.write(next);
+        await prompt.interaction.update((0, interactive_message_1.toMessageEditOptions)(view.render(next), [...prompt.interaction.message.attachments.values()], next));
+    }
+    const buttons = (0, settings_editor_view_1.createEditorButtons)(ids, translator, locale, {
+        // Nothing is written here. Clearing an override that names an uploaded
+        // image destroys the bytes with it, so the click that asks and the click
+        // that carries it out are deliberately two different ones.
+        onReset: (clickCtx) => clickCtx.update({ ...clickCtx.state, confirming: settings_editor_view_1.SETTINGS_EDITOR_RESET_CONFIRMING }),
+        onConfirmReset: async (clickCtx) => {
+            const next = await applyChange(clickCtx.state, () => options.reset(clickCtx.state.subject), translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.resetDone));
+            await clickCtx.update({ ...next, confirming: null });
+        },
+        onCancelReset: (clickCtx) => clickCtx.update({
+            ...clickCtx.state,
+            notice: {
+                text: translator.translate(locale, i18n_1.SETTINGS_EDITOR_MESSAGES.resetCancelled),
+                tone: "confirmation",
+            },
+            confirming: null,
+        }),
+        onReturn: (clickCtx) => stepBack(clickCtx),
+    });
+    const dressing = {
+        clock: options.clock,
+        // Read from the client rather than asked of the caller: every screen wants
+        // the same avatar, and it is the one thing here nobody has to configure.
+        iconUrl: interaction.client.user?.displayAvatarURL() ?? null,
+    };
+    /**
+     * Whether `field` goes somewhere rather than editing anything — the same
+     * question `editField` itself answers for its own routing, asked here only
+     * to word its button: "Open" for a level, "Edit" for everything else.
+     */
+    function isLevelField(field) {
+        return !(0, settings_editor_fields_1.isValueField)(field) && !(0, settings_editor_fields_1.isPickerField)(field) && !(0, settings_editor_fields_1.isGroupField)(field);
+    }
+    /**
+     * Which layout the level owning `field` renders its entries with — the
+     * root's own fields are always `"sections"`, since the root has no picker
+     * above it for a `"buttons"` row to act on. Looked up once per field rather
+     * than threaded through as a parameter: `buildFieldButton` is called from
+     * one place, over every field up front, and this is what tells it apart
+     * from the level a field belongs to without that caller repeating the walk
+     * `createCardEditorView` already does over `options.levels`.
+     */
+    const fieldEntryLayout = new Map();
+    // The root's own layout is the card chrome's `entryLayout` — the embeds
+    // layout never reads this map at all, so a screen without a card chrome
+    // simply leaves every root field labelled the default it is never asked for.
+    const rootEntryLayout = options.chrome.layout === "card" ? (options.chrome.entryLayout ?? "sections") : "sections";
+    for (const field of options.fields) {
+        fieldEntryLayout.set(field.key, rootEntryLayout);
+    }
+    for (const level of options.levels ?? []) {
+        const entryLayout = level.entryLayout ?? "sections";
+        for (const field of level.fields) {
+            fieldEntryLayout.set(field.key, entryLayout);
+        }
+    }
+    /**
+     * The button a card layout's `Section` carries for one menu entry — what
+     * picking it from the old field select used to do, now reached by a click.
+     * Built for every field up front, whichever level declares it: a button not
+     * on the level currently shown is simply never rendered, exactly as
+     * `SettingsEditorButtons.returning` is carried whether or not the current
+     * state shows it.
+     *
+     * A level rendering its entries as a `"buttons"` row has no `Section` text
+     * to say what each one does, so its button carries the entry's own label —
+     * "Declare a game", "This game" — instead of the generic "Open"/"Edit" a
+     * `"sections"` level's accessory button wears.
+     */
+    function buildFieldButton(field) {
+        const navigational = isLevelField(field);
+        const label = fieldEntryLayout.get(field.key) === "buttons"
+            ? translator.translate(locale, field.labelKey)
+            : translator.translate(locale, navigational
+                ? i18n_1.SETTINGS_EDITOR_MESSAGES.openLevelButton
+                : i18n_1.SETTINGS_EDITOR_MESSAGES.editFieldButton);
+        return (0, button_1.createButton)({
+            id: (0, settings_editor_card_view_1.fieldButtonId)(ids, field.key),
+            label,
+            // The entry's own icon wins when it declares one — the generic one lies
+            // for an entry that opens a modal to create something rather than edit
+            // what is already there. Left undeclared, this is exactly the generic
+            // this repository always rendered.
+            emoji: field.icon ?? (navigational ? "➡️" : "✏️"),
+            style: "secondary",
+            // Frozen along with the rest of the screen while the editor's own reset is
+            // waiting for its second click. A screen's own accessory button — a
+            // game's own "remove" — gates itself on whatever *it* is waiting to have
+            // confirmed instead; this one only ever means the editor's.
+            disabled: (state) => state.confirming === settings_editor_view_1.SETTINGS_EDITOR_RESET_CONFIRMING,
+            onClick: (clickCtx) => editField(clickCtx, field.key),
+        });
+    }
+    // The card layout replaces the field select with one button per entry,
+    // looked up by the very key `editField` already routes on; the embeds
+    // layout keeps the select, and never builds a button nothing would render.
+    const fieldButtons = [];
+    const selects = [...(options.selects ?? [])];
+    let view;
+    if (options.chrome.layout === "card") {
+        const fieldButtonMap = new Map(allFields.map((field) => [field.key, buildFieldButton(field)]));
+        fieldButtons.push(...fieldButtonMap.values());
+        view = (0, settings_editor_card_view_1.createCardEditorView)(options.fields, options.levels, buttons, fieldButtonMap, options.chrome, translator, locale, dressing);
+    }
+    else {
+        view = (0, settings_editor_view_1.createEditorView)(ids, options.fields, options.levels, buttons, options.chrome, translator, locale, dressing, 
+        // Whether *any* group on this screen might open on a legend: `groupLegend`
+        // is one hook for the whole screen, not declared per group, so every group
+        // here reserves the one component a legend would cost rather than risk a
+        // modal that only overflows for the one group that actually gets one.
+        options.groupLegend !== undefined);
+        selects.unshift({
+            id: ids.field,
+            onSelect: (pickCtx) => {
+                const picked = pickCtx.values[0];
+                return picked === undefined ? undefined : editField(pickCtx, picked);
+            },
+        });
+    }
+    mountedView.view = view;
+    // The screen's own after the editor's, so a caller cannot shadow a control
+    // the editor depends on: `mountInteractiveMessage` routes to the first match.
+    const allButtons = [...buttons.all, ...fieldButtons, ...(options.buttons ?? [])];
+    mounted.screen = await (0, interactive_message_1.mountInteractiveMessage)(interaction, {
+        initialState: {
+            subject: options.initial.subject,
+            assets: options.initial.assets,
+            notice: null,
+            confirming: null,
+            path: [navigation_1.ROOT_LEVEL_KEY],
+        },
+        buttons: allButtons,
+        selects,
+        view,
+        ownerId: interaction.user.id,
+        logger: options.logger,
+    });
+    return mounted.screen;
+}
+/**
+ * Which notice a submission earns, in the vocabulary its field's own kind
+ * understands: an upload always says so; a picker field reads its clear from
+ * `submission.ids` being `null`, a value field from `submission.value` being
+ * `null` — the two never mean the same thing on the other kind of field.
+ */
+function fieldNoticeKey(field, submission) {
+    if (submission.upload !== null) {
+        return i18n_1.SETTINGS_EDITOR_MESSAGES.fieldUploaded;
+    }
+    if ((0, settings_editor_fields_1.isPickerField)(field)) {
+        return submission.ids === null
+            ? i18n_1.SETTINGS_EDITOR_MESSAGES.fieldCleared
+            : i18n_1.SETTINGS_EDITOR_MESSAGES.fieldSaved;
+    }
+    return submission.value === null
+        ? i18n_1.SETTINGS_EDITOR_MESSAGES.fieldCleared
+        : i18n_1.SETTINGS_EDITOR_MESSAGES.fieldSaved;
+}
+//# sourceMappingURL=mount-settings-editor.js.map

package/dist/discord/components/settings-editor/mount-settings-editor.js.map

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

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

@@ -0,0 +1,49 @@
+import type { SettingsEditorField } from "../../../discord/components/settings-editor/settings-editor-fields";
+/**
+ * The level every screen opens on. Its fields are the ones handed to the editor
+ * directly, so a screen with no depth at all never names a level.
+ */
+export declare const ROOT_LEVEL_KEY = "root";
+/**
+ * One level of a screen: the settings it offers and what it is called.
+ *
+ * A screen declares its deeper levels the same way it declares its fields — as
+ * pure data — so the menu, the heading and the return control are all built from
+ * one source rather than three that have to agree.
+ */
+export interface SettingsEditorLevel<F extends string> {
+    /** Identifies the level. A field of kind `level` names one to descend into. */
+    readonly key: string;
+    /** What this level is called, shown in the heading so the reader knows where they are. */
+    readonly titleKey: string;
+    readonly fields: readonly SettingsEditorField<F>[];
+    /**
+     * How this level offers its entries. `"sections"`, the default, gives each
+     * its own row with its hint and button; `"buttons"` folds them into a
+     * single row, for a level whose entries act on what the picker above has
+     * already named and whose hint would only repeat the row.
+     */
+    readonly entryLayout?: "sections" | "buttons";
+}
+/**
+ * Where the screen currently is, outermost first.
+ *
+ * Never empty: the root is always its first entry, which is what makes
+ * "is there anywhere to go back to" a length check rather than a special case.
+ */
+export type SettingsEditorPath = readonly string[];
+/** The level being rendered — the last one entered. */
+export declare function currentLevelKey(path: SettingsEditorPath): string;
+/** Whether there is a level above the current one to return to. */
+export declare function canReturn(path: SettingsEditorPath): boolean;
+/**
+ * Descend into `key`.
+ *
+ * Re-entering a level already on the path unwinds to it rather than stacking a
+ * second copy: a screen that let the same level appear twice would need two
+ * clicks of the return control to leave one place.
+ */
+export declare function pushLevel(path: SettingsEditorPath, key: string): SettingsEditorPath;
+/** Go back one level. At the root there is nothing to pop, so the path stands. */
+export declare function popLevel(path: SettingsEditorPath): SettingsEditorPath;
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG;;;GAGG;AACH,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM;IACpD,+EAA+E;IAC/E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAAC;AAEnD,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAEhE;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAMnF;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAErE"}

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

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROOT_LEVEL_KEY = void 0;
+exports.currentLevelKey = currentLevelKey;
+exports.canReturn = canReturn;
+exports.pushLevel = pushLevel;
+exports.popLevel = popLevel;
+/**
+ * The level every screen opens on. Its fields are the ones handed to the editor
+ * directly, so a screen with no depth at all never names a level.
+ */
+exports.ROOT_LEVEL_KEY = "root";
+/** The level being rendered — the last one entered. */
+function currentLevelKey(path) {
+    return path[path.length - 1] ?? exports.ROOT_LEVEL_KEY;
+}
+/** Whether there is a level above the current one to return to. */
+function canReturn(path) {
+    return path.length > 1;
+}
+/**
+ * Descend into `key`.
+ *
+ * Re-entering a level already on the path unwinds to it rather than stacking a
+ * second copy: a screen that let the same level appear twice would need two
+ * clicks of the return control to leave one place.
+ */
+function pushLevel(path, key) {
+    const existing = path.indexOf(key);
+    if (existing !== -1) {
+        return path.slice(0, existing + 1);
+    }
+    return [...path, key];
+}
+/** Go back one level. At the root there is nothing to pop, so the path stands. */
+function popLevel(path) {
+    return canReturn(path) ? path.slice(0, -1) : path;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/discord/components/settings-editor/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/navigation.ts"],"names":[],"mappings":";;;AAuCA,0CAEC;AAGD,8BAEC;AASD,8BAMC;AAGD,4BAEC;AAhED;;;GAGG;AACU,QAAA,cAAc,GAAG,MAAM,CAAC;AAgCrC,uDAAuD;AACvD,SAAgB,eAAe,CAAC,IAAwB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,sBAAc,CAAC;AAChD,CAAC;AAED,mEAAmE;AACnE,SAAgB,SAAS,CAAC,IAAwB;IACjD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,IAAwB,EAAE,GAAW;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,kFAAkF;AAClF,SAAgB,QAAQ,CAAC,IAAwB;IAChD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/dist/discord/components/settings-editor/settings-editor-card.view.d.ts

@@ -0,0 +1,56 @@
+import type { InteractiveView } from "../../../discord/components/interactive-message";
+import { type SettingsEditorLevel } from "../../../discord/components/settings-editor/navigation";
+import { type SettingsEditorButtons, type SettingsEditorCardChrome, type SettingsEditorDressing, type SettingsEditorIds, type SettingsEditorState } from "../../../discord/components/settings-editor/settings-editor.view";
+import type { SettingsEditorField } from "../../../discord/components/settings-editor/settings-editor-fields";
+import { type Button } from "../../../discord/interaction/button";
+import type { Locale, Translator } from "../../../i18n";
+/**
+ * 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.
+ */
+export declare const MAX_CARD_LEVEL_ENTRIES = 10;
+/**
+ * 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.
+ */
+export declare const MAX_CARD_BUTTON_LEVEL_ENTRIES = 20;
+/**
+ * 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.
+ */
+export declare function fieldButtonId(ids: SettingsEditorIds, key: string): string;
+/**
+ * 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.
+ */
+export declare function createCardEditorView<S, A, F extends string>(fields: readonly SettingsEditorField<F>[], levels: readonly SettingsEditorLevel<F>[] | undefined, buttons: SettingsEditorButtons<S, A>, fieldButtons: ReadonlyMap<string, Button<SettingsEditorState<S, A>>>, chrome: SettingsEditorCardChrome<S, A>, translator: Translator, locale: Locale, dressing: SettingsEditorDressing): InteractiveView<SettingsEditorState<S, A>>;
+//# sourceMappingURL=settings-editor-card.view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings-editor-card.view.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/settings-editor-card.view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAIN,KAAK,mBAAmB,EACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAGN,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EAEtB,KAAK,mBAAmB,EACxB,MAAM,2DAA2D,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6DAA6D,CAAC;AAEvG,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,8BAA8B,CAAC;AAG5E,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AASzC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAahD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAC1D,MAAM,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACzC,MAAM,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EACrD,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EACpE,MAAM,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,EACtC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,sBAAsB,GAC9B,eAAe,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CA+O5C"}