@azurioh/discord-kernel 0.1.0 → 1.0.0

package/dist/discord/components/settings-editor/from-declaration-values.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.controlValue = controlValue;
+exports.isUnchanged = isUnchanged;
+exports.withSubmission = withSubmission;
+const from_declaration_stored_1 = require("../../../discord/components/settings-editor/from-declaration-stored");
+const settings_editor_field_values_1 = require("../../../discord/components/settings-editor/settings-editor-field-values");
+const settings_editor_fields_1 = require("../../../discord/components/settings-editor/settings-editor-fields");
+const duration_1 = require("../../../settings/duration");
+const messages_1 = require("../../../settings/messages");
+/** A decimal number as typed: optional sign, digits with an optional fraction, optional exponent. */
+const DECIMAL_PATTERN = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
+/** Separates the items of a list typed one per line. */
+const LINE_BREAK = /\r?\n/;
+/**
+ * What the modal of a control opens on: the stored value as text for a typed
+ * control, whether a secret is set (never its value), the picked ids for a
+ * picker, minus the entities the guild no longer has, which the text then
+ * reports as unavailable.
+ *
+ * @param params.control - the control being opened.
+ * @param params.subject - the screen's current subject.
+ * @param params.translate - translates the texts shown in place of a value.
+ * @returns the control's prefill.
+ */
+function controlValue(params) {
+    const { control, subject, translate } = params;
+    const value = subject.values[control.fieldKey];
+    const { shape } = control;
+    switch (shape.kind) {
+        case "text":
+            return (0, settings_editor_field_values_1.textFieldValue)(typeof value === "string" ? value : null);
+        case "number":
+            return (0, settings_editor_field_values_1.textFieldValue)(typeof value === "number" ? String(value) : null);
+        case "duration":
+            return (0, settings_editor_field_values_1.textFieldValue)(typeof value === "number" ? (0, duration_1.formatDuration)(value) : null);
+        case "secret":
+            return (0, settings_editor_field_values_1.textFieldValue)(translate((0, from_declaration_stored_1.secretStateKey)(value)));
+        case "lines":
+            return (0, settings_editor_field_values_1.textFieldValue)(Array.isArray(value) && value.length > 0 ? value.join("\n") : null);
+        case "boolean":
+            return (0, settings_editor_field_values_1.pickedFieldValue)(typeof value === "boolean" ? [String(value)] : []);
+        case "single":
+        case "many":
+            return pickedValue({ control, subject, translate });
+        case "toggles":
+            return (0, settings_editor_field_values_1.pickedFieldValue)(shape.keys.filter((key) => (0, from_declaration_stored_1.isToggledOn)({ value, key })));
+        case "search":
+            return (0, settings_editor_field_values_1.pickedFieldValue)(typeof value === "string" || typeof value === "number" ? [String(value)] : []);
+        case "other":
+            // Opens empty: the value it would repeat is already picked in the select beside it.
+            return (0, settings_editor_field_values_1.textFieldValue)(null);
+        default:
+            return shape;
+    }
+}
+/** The picked ids the guild still has, with a notice when any stored one is gone. */
+function pickedValue(params) {
+    const { control, subject, translate } = params;
+    const stored = (0, from_declaration_stored_1.storedIds)(subject.values[control.fieldKey]);
+    const missing = subject.unavailable[control.fieldKey] ?? [];
+    const picked = (0, settings_editor_field_values_1.pickedFieldValue)(stored.filter((id) => !missing.includes(id)));
+    if (missing.length === 0) {
+        return picked;
+    }
+    return { ...picked, text: translate(messages_1.SETTINGS_MESSAGES.valueUnavailable) };
+}
+/**
+ * Whether a submission leaves a control as its modal opened: the same picked
+ * ids in the same order for a picker (whatever notice its text carries), the
+ * same text for a typed control (an empty box and no value alike).
+ *
+ * @param params.control - the control submitted.
+ * @param params.submission - what it came back with.
+ * @param params.current - what its modal opened on.
+ * @returns `true` when nothing was changed.
+ */
+function isUnchanged(params) {
+    const { control, submission, current } = params;
+    if ((0, settings_editor_fields_1.isPickerField)(control.entry)) {
+        const ids = submission.ids ?? [];
+        return (ids.length === current.picked.length && ids.every((id, index) => current.picked[index] === id));
+    }
+    return (submission.value ?? "") === (current.text ?? "");
+}
+/**
+ * Add what one control submitted to a settings patch, in the form the
+ * settings service takes: typed text converted to the value it denotes and
+ * left as text when it denotes none (the service then refuses it with the same
+ * issue as any surface), `null` for a cleared control, and a toggles select
+ * merged into the full record of its field.
+ *
+ * @param params.control - the control submitted.
+ * @param params.submission - what it came back with.
+ * @param params.subject - the screen's current subject, for the toggles the
+ * select does not show.
+ * @param params.patch - the patch built so far.
+ * @returns the patch with the control's value.
+ */
+function withSubmission(params) {
+    const { control, submission, subject, patch } = params;
+    const { fieldKey, shape } = control;
+    const current = Object.hasOwn(patch, fieldKey) ? patch[fieldKey] : subject.values[fieldKey];
+    return { ...patch, [fieldKey]: submittedValue({ shape, submission, current }) };
+}
+/** What one control submitted, as the settings service takes it; `current` is its field's value so far. */
+function submittedValue(params) {
+    const { shape, submission } = params;
+    const { value, ids } = submission;
+    switch (shape.kind) {
+        case "text":
+        case "duration":
+        case "secret":
+            return value;
+        case "number":
+            return value === null ? null : typedNumber(value);
+        case "lines":
+            return value === null ? null : typedLines({ text: value, numeric: shape.numeric });
+        case "boolean":
+            return ids === null || ids.length === 0 ? null : pickedBoolean(ids[0]);
+        case "single":
+            return ids === null || ids.length === 0 ? null : singleId(ids);
+        case "many":
+            return ids === null ? null : [...ids];
+        case "toggles":
+            return { ...toggleRecord(params.current), ...pickedToggles({ keys: shape.keys, ids }) };
+        case "search":
+            if (ids === null || ids.length === 0) {
+                return null;
+            }
+            return shape.numeric ? singleNumber(ids) : singleId(ids);
+        case "other":
+            if (value === null) {
+                return null;
+            }
+            return shape.numeric ? typedNumber(value) : value;
+        default:
+            return shape;
+    }
+}
+/** The one number picked, from its option's value; anything else is left for the service to refuse. */
+function singleNumber(ids) {
+    const picked = singleId(ids);
+    return typeof picked === "string" ? typedNumber(picked) : picked;
+}
+/** A toggles value as a record, or an empty one when the field holds none. */
+function toggleRecord(value) {
+    return typeof value === "object" && value !== null ? { ...value } : {};
+}
+/** Each key of one toggles select, on when picked. */
+function pickedToggles(params) {
+    const picked = params.ids ?? [];
+    // A picked id the select does not offer is kept, for the service to refuse.
+    const keys = [...params.keys, ...picked.filter((id) => !params.keys.includes(id))];
+    return Object.fromEntries(keys.map((key) => [key, picked.includes(key)]));
+}
+/** The number typed, or the text itself when it is not one. */
+function typedNumber(text) {
+    const trimmed = text.trim();
+    return DECIMAL_PATTERN.test(trimmed) ? Number(trimmed) : text;
+}
+/** Each non-empty trimmed line as one item; `null` when no line holds one. */
+function typedLines(params) {
+    const lines = params.text
+        .split(LINE_BREAK)
+        .map((line) => line.trim())
+        .filter((line) => line !== "");
+    if (lines.length === 0) {
+        return null;
+    }
+    return params.numeric ? lines.map(typedNumber) : lines;
+}
+/** `true` and `false` from their options; any other id is left for the service to refuse. */
+function pickedBoolean(id) {
+    if (id === String(true)) {
+        return true;
+    }
+    if (id === String(false)) {
+        return false;
+    }
+    return id;
+}
+/** The one id a single picker took; several are left as a list for the service to refuse. */
+function singleId(ids) {
+    return ids.length === 1 && ids[0] !== undefined ? ids[0] : ids;
+}
+//# sourceMappingURL=from-declaration-values.js.map

package/dist/discord/components/settings-editor/from-declaration-values.js.map

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

package/dist/discord/components/settings-editor/from-declaration.d.ts

@@ -0,0 +1,39 @@
+import type { SettingsEditorOptions } from "../../../discord/components/settings-editor/mount-settings-editor";
+import type { Locale } from "../../../i18n/locale";
+import type { Translator } from "../../../i18n/translator";
+import type { SettingsDeclaration } from "../../../settings/define-settings";
+import type { SettingsService } from "../../../settings/settings-service";
+/** What the adapter hands `mountSettingsEditor`; the caller adds its own ids, chrome, clock and logger. */
+type DeclarationEditorOptions = Pick<SettingsEditorOptions<unknown, never, string>, "fields" | "levels" | "initial" | "currentValue" | "displayValue" | "save" | "saveGroup" | "reset">;
+/**
+ * Build the settings-editor options of a declaration for one guild: its
+ * fields and levels, the subject it opens on, and the hooks that read and
+ * write through the settings service. The caller spreads the result into
+ * `mountSettingsEditor` with its own `ids`, `chrome`, `clock` and `logger`.
+ *
+ * Every write goes through `service.set` as the administrator, so the screen
+ * accepts and refuses exactly what every other surface does; a group's modal
+ * is one write carrying only the members the administrator changed.
+ *
+ * A searchable field (FR-026a) is a select of the first 25 results of its
+ * search for an empty query, read when the screen opens, and shows its
+ * search's label as its current value. A non-strict one also gets an "Other
+ * value" text entry in the same modal: a value typed there replaces the pick
+ * and is validated on save like any other. A field whose search offered
+ * nothing is typed instead.
+ *
+ * @param declaration - the module's settings declaration.
+ * @param service - the settings service the screen reads and writes through.
+ * @param context - the guild, the administrator, their locale and the
+ * translator of the texts shown in place of a value.
+ * @returns the editor options, the initial subject read from the service.
+ * @throws SettingsDeclarationError when a list holds an item kind lists cannot hold.
+ */
+export declare function settingsEditorFromDeclaration<D extends SettingsDeclaration>(declaration: D, service: SettingsService, context: {
+    readonly guildId: string;
+    readonly userId: string;
+    readonly locale: Locale;
+    readonly translator: Translator;
+}): Promise<DeclarationEditorOptions>;
+export {};
+//# sourceMappingURL=from-declaration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACX,qBAAqB,EAErB,MAAM,4DAA4D,CAAC;AAOpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnF,2GAA2G;AAC3G,KAAK,wBAAwB,GAAG,IAAI,CACnC,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,EAC7C,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAClG,CAAC;AAeF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,6BAA6B,CAAC,CAAC,SAAS,mBAAmB,EAChF,WAAW,EAAE,CAAC,EACd,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACR,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CAChC,GACC,OAAO,CAAC,wBAAwB,CAAC,CAwCnC"}

package/dist/discord/components/settings-editor/from-declaration.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.settingsEditorFromDeclaration = settingsEditorFromDeclaration;
+const from_declaration_controls_1 = require("../../../discord/components/settings-editor/from-declaration-controls");
+const from_declaration_display_1 = require("../../../discord/components/settings-editor/from-declaration-display");
+const from_declaration_layout_1 = require("../../../discord/components/settings-editor/from-declaration-layout");
+const from_declaration_search_1 = require("../../../discord/components/settings-editor/from-declaration-search");
+const from_declaration_subject_1 = require("../../../discord/components/settings-editor/from-declaration-subject");
+const from_declaration_values_1 = require("../../../discord/components/settings-editor/from-declaration-values");
+const business_error_1 = require("../../../errors/business-error");
+const field_order_1 = require("../../../settings/field-order");
+/**
+ * Build the settings-editor options of a declaration for one guild: its
+ * fields and levels, the subject it opens on, and the hooks that read and
+ * write through the settings service. The caller spreads the result into
+ * `mountSettingsEditor` with its own `ids`, `chrome`, `clock` and `logger`.
+ *
+ * Every write goes through `service.set` as the administrator, so the screen
+ * accepts and refuses exactly what every other surface does; a group's modal
+ * is one write carrying only the members the administrator changed.
+ *
+ * A searchable field (FR-026a) is a select of the first 25 results of its
+ * search for an empty query, read when the screen opens, and shows its
+ * search's label as its current value. A non-strict one also gets an "Other
+ * value" text entry in the same modal: a value typed there replaces the pick
+ * and is validated on save like any other. A field whose search offered
+ * nothing is typed instead.
+ *
+ * @param declaration - the module's settings declaration.
+ * @param service - the settings service the screen reads and writes through.
+ * @param context - the guild, the administrator, their locale and the
+ * translator of the texts shown in place of a value.
+ * @returns the editor options, the initial subject read from the service.
+ * @throws SettingsDeclarationError when a list holds an item kind lists cannot hold.
+ */
+async function settingsEditorFromDeclaration(declaration, service, context) {
+    const { guildId, userId, locale, translator } = context;
+    const ctx = { guildId, userId, locale };
+    const subject = await (0, from_declaration_subject_1.loadDeclarationSubject)({ declaration, service, ctx });
+    const searchOptions = await (0, from_declaration_search_1.loadSearchOptions)({ declaration, service, ctx, subject });
+    const controls = displayedControls(declaration, searchOptions);
+    const layout = (0, from_declaration_layout_1.layoutDeclaration)({ declaration, controls });
+    const scope = {
+        declaration,
+        service,
+        ctx,
+        translate: (key) => translator.translate(locale, key),
+        controls: new Map(controls.map((control) => [control.entry.key, control])),
+        groups: layout.groups,
+    };
+    return {
+        fields: layout.fields,
+        levels: layout.levels,
+        initial: { subject, assets: [] },
+        currentValue: (subject, key) => (0, from_declaration_values_1.controlValue)({ translate: scope.translate, subject, control: controlAt({ scope, key }) }),
+        displayValue: (subject, key) => {
+            const control = controlAt({ scope, key });
+            // The free entry holds nothing of its own: its field shows beside the select.
+            return (0, from_declaration_controls_1.isFreeEntry)(control)
+                ? null
+                : (0, from_declaration_display_1.controlDisplay)({ translate: scope.translate, subject, control });
+        },
+        save: (subject, key, submission) => saveControl({ scope, subject, control: controlAt({ scope, key }), submission }),
+        saveGroup: (subject, groupKey, submissions) => saveGroupControls({ scope, subject, groupKey, submissions }),
+        reset: async () => {
+            await service.reset(declaration, guildId, "all", scope.ctx);
+            return reload(scope);
+        },
+    };
+}
+/** The controls of a declaration in its display order, the one every surface shows. */
+function displayedControls(declaration, searchOptions) {
+    const rank = new Map((0, field_order_1.displayOrder)(declaration)
+        .entries.flatMap((entry) => (entry.kind === "field" ? [entry.key] : entry.fields))
+        .map((key, index) => [key, index]));
+    const place = (control) => rank.get(control.fieldKey) ?? rank.size;
+    return (0, from_declaration_controls_1.declarationControls)(declaration, searchOptions).sort((left, right) => place(left) - place(right));
+}
+/** The screen's subject, read back from the service. */
+async function reload(scope) {
+    const { declaration, service, ctx } = scope;
+    return { subject: await (0, from_declaration_subject_1.loadDeclarationSubject)({ declaration, service, ctx }), assets: [] };
+}
+/** Write `patch` in one `service.set` (nothing when it is empty), then read the screen back. */
+async function write(params) {
+    const { scope, patch } = params;
+    if (Object.keys(patch).length > 0) {
+        await scope.service.set(scope.declaration, scope.ctx.guildId, patch, scope.ctx);
+    }
+    return reload(scope);
+}
+function controlAt(params) {
+    const { scope, key } = params;
+    const control = scope.controls.get(key);
+    if (control === undefined) {
+        throw new business_error_1.NotFoundError(`Settings screen of "${scope.declaration.id}" has no field "${key}"`);
+    }
+    return control;
+}
+/**
+ * Save one entry as submitted. A secret opens on whether it is set, not on
+ * its value: sent back untouched, that text must not replace the secret.
+ */
+function saveControl(params) {
+    const { scope, subject, control, submission } = params;
+    const untouchedSecret = control.shape.kind === "secret" &&
+        (0, from_declaration_values_1.isUnchanged)({
+            control,
+            submission,
+            current: (0, from_declaration_values_1.controlValue)({ translate: scope.translate, subject, control }),
+        });
+    const patch = untouchedSecret ? {} : (0, from_declaration_values_1.withSubmission)({ control, submission, subject, patch: {} });
+    return write({ scope, patch });
+}
+/**
+ * Save a group's modal in one write carrying only the members changed from
+ * what the modal opened on: a picker whose stored entity is gone, or a
+ * secret showing whether it is set, left untouched keeps its stored value.
+ */
+function saveGroupControls(params) {
+    const { scope, subject, groupKey, submissions } = params;
+    let patch = {};
+    for (const control of scope.groups.get(groupKey) ?? []) {
+        const submission = submissions[control.entry.key];
+        const current = (0, from_declaration_values_1.controlValue)({ translate: scope.translate, subject, control });
+        if (submission !== undefined && !(0, from_declaration_values_1.isUnchanged)({ control, submission, current })) {
+            patch = (0, from_declaration_values_1.withSubmission)({ control, submission, subject, patch });
+        }
+    }
+    return write({ scope, patch });
+}
+//# sourceMappingURL=from-declaration.js.map

package/dist/discord/components/settings-editor/from-declaration.js.map

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

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

@@ -1,7 +1,9 @@
+export { settingsEditorFromDeclaration } from "../../../discord/components/settings-editor/from-declaration";
 export { mountSettingsEditor, type SettingsEditorOptions, type SettingsEditorWrite, } from "../../../discord/components/settings-editor/mount-settings-editor";
 export { currentLevelKey, type SettingsEditorLevel, } from "../../../discord/components/settings-editor/navigation";
 export { editorComponentIds, MAX_SELECT_OPTION_TEXT, MAX_SELECT_OPTIONS, SETTINGS_EDITOR_RESET_CONFIRMING, type SettingsEditorCardChrome, type SettingsEditorChrome, type SettingsEditorEmbedsChrome, type SettingsEditorIds, type SettingsEditorState, } from "../../../discord/components/settings-editor/settings-editor.view";
 export { fieldButtonId, MAX_CARD_BUTTON_LEVEL_ENTRIES, MAX_CARD_LEVEL_ENTRIES, } from "../../../discord/components/settings-editor/settings-editor-card.view";
 export type { SettingsEditorGroupSubmission, SettingsEditorSubmission, } from "../../../discord/components/settings-editor/settings-editor-field-modal";
-export { MAX_MODAL_COMPONENTS, MAX_MODAL_INPUT_LENGTH, pickedFieldValue, type SettingsEditorChoice, type SettingsEditorField, type SettingsEditorFieldValue, type SettingsEditorGroupField, type SettingsEditorPickerField, type SettingsEditorValueField, textFieldValue, } from "../../../discord/components/settings-editor/settings-editor-fields";
+export { pickedFieldValue, textFieldValue, } from "../../../discord/components/settings-editor/settings-editor-field-values";
+export { MAX_MODAL_COMPONENTS, MAX_MODAL_INPUT_LENGTH, type SettingsEditorChoice, type SettingsEditorField, type SettingsEditorFieldValue, type SettingsEditorGroupField, type SettingsEditorPickerField, type SettingsEditorValueField, } from "../../../discord/components/settings-editor/settings-editor-fields";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACxB,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACN,eAAe,EACf,KAAK,mBAAmB,GACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACxB,MAAM,2DAA2D,CAAC;AACnE,OAAO,EACN,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,GACtB,MAAM,gEAAgE,CAAC;AACxE,YAAY,EACX,6BAA6B,EAC7B,wBAAwB,GACxB,MAAM,kEAAkE,CAAC;AAC1E,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,cAAc,GACd,MAAM,6DAA6D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AACtG,OAAO,EACN,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACxB,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACN,eAAe,EACf,KAAK,mBAAmB,GACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,gCAAgC,EAChC,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACxB,MAAM,2DAA2D,CAAC;AACnE,OAAO,EACN,aAAa,EACb,6BAA6B,EAC7B,sBAAsB,GACtB,MAAM,gEAAgE,CAAC;AACxE,YAAY,EACX,6BAA6B,EAC7B,wBAAwB,GACxB,MAAM,kEAAkE,CAAC;AAC1E,OAAO,EACN,gBAAgB,EAChB,cAAc,GACd,MAAM,mEAAmE,CAAC;AAC3E,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC7B,MAAM,6DAA6D,CAAC"}

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.textFieldValue = exports.pickedFieldValue = exports.MAX_MODAL_INPUT_LENGTH = exports.MAX_MODAL_COMPONENTS = exports.MAX_CARD_LEVEL_ENTRIES = exports.MAX_CARD_BUTTON_LEVEL_ENTRIES = exports.fieldButtonId = exports.SETTINGS_EDITOR_RESET_CONFIRMING = exports.MAX_SELECT_OPTIONS = exports.MAX_SELECT_OPTION_TEXT = exports.editorComponentIds = exports.currentLevelKey = exports.mountSettingsEditor = void 0;
+exports.MAX_MODAL_INPUT_LENGTH = exports.MAX_MODAL_COMPONENTS = exports.textFieldValue = exports.pickedFieldValue = exports.MAX_CARD_LEVEL_ENTRIES = exports.MAX_CARD_BUTTON_LEVEL_ENTRIES = exports.fieldButtonId = exports.SETTINGS_EDITOR_RESET_CONFIRMING = exports.MAX_SELECT_OPTIONS = exports.MAX_SELECT_OPTION_TEXT = exports.editorComponentIds = exports.currentLevelKey = exports.mountSettingsEditor = exports.settingsEditorFromDeclaration = void 0;
+var from_declaration_1 = require("../../../discord/components/settings-editor/from-declaration");
+Object.defineProperty(exports, "settingsEditorFromDeclaration", { enumerable: true, get: function () { return from_declaration_1.settingsEditorFromDeclaration; } });
 var mount_settings_editor_1 = require("../../../discord/components/settings-editor/mount-settings-editor");
 Object.defineProperty(exports, "mountSettingsEditor", { enumerable: true, get: function () { return mount_settings_editor_1.mountSettingsEditor; } });
 var navigation_1 = require("../../../discord/components/settings-editor/navigation");
@@ -14,9 +16,10 @@ var settings_editor_card_view_1 = require("../../../discord/components/settings-
 Object.defineProperty(exports, "fieldButtonId", { enumerable: true, get: function () { return settings_editor_card_view_1.fieldButtonId; } });
 Object.defineProperty(exports, "MAX_CARD_BUTTON_LEVEL_ENTRIES", { enumerable: true, get: function () { return settings_editor_card_view_1.MAX_CARD_BUTTON_LEVEL_ENTRIES; } });
 Object.defineProperty(exports, "MAX_CARD_LEVEL_ENTRIES", { enumerable: true, get: function () { return settings_editor_card_view_1.MAX_CARD_LEVEL_ENTRIES; } });
+var settings_editor_field_values_1 = require("../../../discord/components/settings-editor/settings-editor-field-values");
+Object.defineProperty(exports, "pickedFieldValue", { enumerable: true, get: function () { return settings_editor_field_values_1.pickedFieldValue; } });
+Object.defineProperty(exports, "textFieldValue", { enumerable: true, get: function () { return settings_editor_field_values_1.textFieldValue; } });
 var settings_editor_fields_1 = require("../../../discord/components/settings-editor/settings-editor-fields");
 Object.defineProperty(exports, "MAX_MODAL_COMPONENTS", { enumerable: true, get: function () { return settings_editor_fields_1.MAX_MODAL_COMPONENTS; } });
 Object.defineProperty(exports, "MAX_MODAL_INPUT_LENGTH", { enumerable: true, get: function () { return settings_editor_fields_1.MAX_MODAL_INPUT_LENGTH; } });
-Object.defineProperty(exports, "pickedFieldValue", { enumerable: true, get: function () { return settings_editor_fields_1.pickedFieldValue; } });
-Object.defineProperty(exports, "textFieldValue", { enumerable: true, get: function () { return settings_editor_fields_1.textFieldValue; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/index.ts"],"names":[],"mappings":";;;AAAA,oGAIoE;AAHnE,4HAAA,mBAAmB,OAAA;AAIpB,8EAGyD;AAFxD,6GAAA,eAAe,OAAA;AAGhB,kGAUmE;AATlE,0HAAA,kBAAkB,OAAA;AAClB,8HAAA,sBAAsB,OAAA;AACtB,0HAAA,kBAAkB,OAAA;AAClB,wIAAA,gCAAgC,OAAA;AAOjC,4GAIwE;AAHvE,0HAAA,aAAa,OAAA;AACb,0IAAA,6BAA6B,OAAA;AAC7B,mIAAA,sBAAsB,OAAA;AAMvB,sGAWqE;AAVpE,8HAAA,oBAAoB,OAAA;AACpB,gIAAA,sBAAsB,OAAA;AACtB,0HAAA,gBAAgB,OAAA;AAOhB,wHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/index.ts"],"names":[],"mappings":";;;AAAA,0FAAsG;AAA7F,iIAAA,6BAA6B,OAAA;AACtC,oGAIoE;AAHnE,4HAAA,mBAAmB,OAAA;AAIpB,8EAGyD;AAFxD,6GAAA,eAAe,OAAA;AAGhB,kGAUmE;AATlE,0HAAA,kBAAkB,OAAA;AAClB,8HAAA,sBAAsB,OAAA;AACtB,0HAAA,kBAAkB,OAAA;AAClB,wIAAA,gCAAgC,OAAA;AAOjC,4GAIwE;AAHvE,0HAAA,aAAa,OAAA;AACb,0IAAA,6BAA6B,OAAA;AAC7B,mIAAA,sBAAsB,OAAA;AAMvB,kHAG2E;AAF1E,gIAAA,gBAAgB,OAAA;AAChB,8HAAA,cAAc,OAAA;AAEf,sGASqE;AARpE,8HAAA,oBAAoB,OAAA;AACpB,gIAAA,sBAAsB,OAAA"}

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

@@ -1,12 +1,14 @@
 import type { ChatInputCommandInteraction, ModalMessageModalSubmitInteraction } from "discord.js";
 import type { Clock } from "../../../clock";
-import { type InteractiveMessageHandle, type InteractiveSelect, type StateStore } from "../../../discord/components/interactive-message";
+import type { InteractiveMessageHandle, InteractiveSelect } from "../../../discord/components/interactive-message/interactive-message-collector";
+import type { StateStore } from "../../../discord/components/interactive-message/state-store";
 import { type SettingsEditorLevel } from "../../../discord/components/settings-editor/navigation";
 import { type SettingsEditorChrome, type SettingsEditorIds, type SettingsEditorState } from "../../../discord/components/settings-editor/settings-editor.view";
 import type { SettingsEditorGroupSubmission, SettingsEditorSubmission } from "../../../discord/components/settings-editor/settings-editor-field-modal";
 import { type SettingsEditorField, type SettingsEditorFieldValue } from "../../../discord/components/settings-editor/settings-editor-fields";
 import { type Button } from "../../../discord/interaction/button";
-import { type Locale, type Translator } from "../../../i18n";
+import type { Locale } from "../../../i18n/locale";
+import type { Translator } from "../../../i18n/translator";
 import type { Logger } from "../../../logger";
 /**
  * What one write leaves behind: the new subject, and the files the message must
@@ -36,6 +38,18 @@ export interface SettingsEditorOptions<S, A, F extends string> {
     readonly initial: SettingsEditorWrite<S, A>;
     /** What the modal for `field` opens on. */
     currentValue(subject: S, field: F): SettingsEditorFieldValue;
+    /**
+     * What `field` currently holds, already translated, shown on the card under
+     * the entry's hint as "Current: …" so an administrator reads it without
+     * opening the modal. Rendered from the state's subject, so it follows every
+     * write. `null` shows no line for that field; a group shows one
+     * `label: value` per member answering one; a level shows nothing. A long
+     * value is cut with an ellipsis.
+     *
+     * Read by the card layout only: the embeds layout ignores it. Left out, the
+     * card renders exactly as it did without it.
+     */
+    displayValue?(subject: S, field: F): string | null;
     /**
      * Persist one field — its typed value, its upload, or what a picker's select
      * came back with, whichever `submission` carries.

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

@@ -1 +1 @@
-{"version":3,"file":"mount-settings-editor.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/mount-settings-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,2BAA2B,EAE3B,kCAAkC,EAClC,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACN,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EAGtB,KAAK,UAAU,EAEf,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAIN,KAAK,mBAAmB,EACxB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAIN,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,MAAM,2DAA2D,CAAC;AAKnE,OAAO,KAAK,EACX,6BAA6B,EAC7B,wBAAwB,EACxB,MAAM,kEAAkE,CAAC;AAK1E,OAAO,EAMN,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAE7B,MAAM,6DAA6D,CAAC;AAErE,OAAO,EAAE,KAAK,MAAM,EAAuC,MAAM,8BAA8B,CAAC;AAEhG,OAAO,EAAE,KAAK,MAAM,EAA0B,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,2CAA2C;IAC3C,YAAY,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,wBAAwB,CAAC;IAC7D;;;;;;;;;;;;OAYG;IACH,IAAI,CACH,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,CAAC,EACR,UAAU,EAAE,wBAAwB,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,CACT,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,CAAC,EACR,WAAW,EAAE,6BAA6B,CAAC,CAAC,CAAC,EAC7C,WAAW,EAAE,kCAAkC,GAC7C,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC;;;;;;OAMG;IACH,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IAClD,mEAAmE;IACnE,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAwCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,MAAM,EAC/D,WAAW,EAAE,2BAA2B,EACxC,OAAO,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACrC,OAAO,CAAC,wBAAwB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,CAoY/F"}
+{"version":3,"file":"mount-settings-editor.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/mount-settings-editor.ts"],"names":[],"mappings":"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"}

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

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mountSettingsEditor = mountSettingsEditor;
-const interactive_message_1 = require("../../../discord/components/interactive-message");
+const message_edit_options_1 = require("../../../discord/components/interactive-message/message-edit-options");
+const mount_interactive_message_1 = require("../../../discord/components/interactive-message/mount-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");
@@ -9,8 +10,9 @@ const settings_editor_field_modal_1 = require("../../../discord/components/setti
 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");
+const business_error_1 = require("../../../errors/business-error");
+const describe_error_1 = require("../../../errors/describe-error");
+const business_message_1 = require("../../../i18n/business-message");
 /**
  * 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
@@ -60,12 +62,12 @@ async function mountSettingsEditor(interaction, options) {
             written = await write();
         }
         catch (error) {
-            if (error instanceof errors_1.BusinessError) {
+            if (error instanceof business_error_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" },
+                    notice: { text: (0, business_message_1.resolveBusinessMessage)(error, translator, locale), tone: "refusal" },
                 };
             }
             throw error;
@@ -74,7 +76,7 @@ async function mountSettingsEditor(interaction, options) {
             await options.onWritten?.();
         }
         catch (error) {
-            options.logger.error({ err: (0, errors_1.describeError)(error) }, "onWritten failed after a settings editor write had already landed");
+            options.logger.error({ err: (0, describe_error_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" } };
@@ -149,7 +151,7 @@ async function mountSettingsEditor(interaction, options) {
         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));
+        await submission.interaction.update((0, message_edit_options_1.toMessageEditOptions)(view.render(next), [...submission.interaction.message.attachments.values()], next));
     }
     /**
      * Edit a group: ask for every member field it declares in one modal,
@@ -181,7 +183,7 @@ async function mountSettingsEditor(interaction, options) {
             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));
+        await prompt.interaction.update((0, message_edit_options_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
@@ -285,7 +287,9 @@ async function mountSettingsEditor(interaction, options) {
     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);
+        view = (0, settings_editor_card_view_1.createCardEditorView)(options.fields, options.levels, buttons, fieldButtonMap, options.chrome, translator, locale, dressing, options.displayValue === undefined
+            ? undefined
+            : (subject, field) => options.displayValue?.(subject, field) ?? null);
     }
     else {
         view = (0, settings_editor_view_1.createEditorView)(ids, options.fields, options.levels, buttons, options.chrome, translator, locale, dressing, 
@@ -306,7 +310,7 @@ async function mountSettingsEditor(interaction, options) {
     // 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, {
+    mounted.screen = await (0, mount_interactive_message_1.mountInteractiveMessage)(interaction, {
         initialState: {
             subject: options.initial.subject,
             assets: options.initial.assets,