@azurioh/discord-kernel 0.1.0 → 1.0.0

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

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.layoutDeclaration = layoutDeclaration;
+const from_declaration_controls_1 = require("../../../discord/components/settings-editor/from-declaration-controls");
+const settings_editor_card_view_1 = require("../../../discord/components/settings-editor/settings-editor-card.view");
+const settings_editor_fields_1 = require("../../../discord/components/settings-editor/settings-editor-fields");
+const i18n_1 = require("../../../discord/i18n");
+/** Separates a generated entry key from its number. */
+const KEY_SEPARATOR = "#";
+/** Prefix of the key of every level the layout nests. */
+const LEVEL_KEY_PREFIX = "level";
+/** Suffix of the key of the modal a non-strict searchable field outside any group opens. */
+const SEARCH_ENTRY_SUFFIX = "search";
+/**
+ * Lay the controls of a declaration out on the screen, keeping their order
+ * (the display order of `@/settings/field-order`): a control outside any group is an entry of its own; a group stands
+ * where its first control stands, split into entries of at most
+ * {@link MAX_MODAL_COMPONENTS} controls (one modal each). A level holds at
+ * most {@link MAX_CARD_LEVEL_ENTRIES} entries: past that, a group split over
+ * several entries moves into a level of its own, then the entries past the
+ * last that fits move behind a "more settings" level.
+ *
+ * A non-strict searchable field's select and its free entry are never split:
+ * outside any group they form a modal of their own, named after the field;
+ * inside a group they share one of its modals.
+ *
+ * @param params.declaration - the module's settings declaration, for its groups.
+ * @param params.controls - the controls of the declaration, in declared order.
+ * @returns the root entries, the nested levels and each group entry's controls.
+ */
+function layoutDeclaration(params) {
+    const groups = new Map();
+    const sections = declarationSections({ ...params, groups });
+    const levels = [];
+    const flat = sections.flatMap(sectionEntries);
+    const fields = flat.length <= settings_editor_card_view_1.MAX_CARD_LEVEL_ENTRIES
+        ? flat
+        : paged({
+            entries: sections.flatMap((section) => foldedEntries({ section, levels })),
+            levels,
+        });
+    return { fields, levels, groups };
+}
+/** The sections of the root level, recording each group entry's controls in `groups`. */
+function declarationSections(params) {
+    const { declaration, controls, groups } = params;
+    const sections = [];
+    const seenGroups = new Set();
+    const units = controlUnits(controls);
+    for (const unit of units) {
+        const [first] = unit;
+        if (first === undefined) {
+            continue;
+        }
+        const { groupId } = first;
+        if (groupId === undefined) {
+            sections.push(unit.length === 1 ? { kind: "control", control: first } : searchSection({ unit, groups }));
+        }
+        else if (!seenGroups.has(groupId)) {
+            seenGroups.add(groupId);
+            sections.push(groupSection({ declaration, units, groups, groupId }));
+        }
+    }
+    return sections;
+}
+/**
+ * The controls in order, a non-strict searchable field's select and free
+ * entry kept together as one unit, every other control a unit of its own.
+ */
+function controlUnits(controls) {
+    const units = [];
+    for (const control of controls) {
+        const last = units.at(-1);
+        if ((0, from_declaration_controls_1.isFreeEntry)(control) && last?.[0]?.fieldKey === control.fieldKey) {
+            last.push(control);
+        }
+        else {
+            units.push([control]);
+        }
+    }
+    return units;
+}
+/** A non-strict searchable field outside any group: one modal holding its select and free entry. */
+function searchSection(params) {
+    const { unit, groups } = params;
+    const [{ entry, fieldKey }] = unit;
+    const key = `${fieldKey}${KEY_SEPARATOR}${SEARCH_ENTRY_SUFFIX}`;
+    groups.set(key, unit);
+    const { labelKey, hintKey } = entry;
+    return {
+        kind: "group",
+        labelKey,
+        hintKey,
+        chunks: [{ kind: "group", key, labelKey, hintKey, fields: unit.map(controlEntry) }],
+    };
+}
+/** A declared group split into entries of at most {@link MAX_MODAL_COMPONENTS} controls, no unit split. */
+function groupSection(params) {
+    const { declaration, units, groups, groupId } = params;
+    const group = declaration.groups?.[groupId];
+    const labelKey = group?.label ?? groupId;
+    const hintKey = group?.description ?? i18n_1.SETTINGS_EDITOR_MESSAGES.entryHint;
+    const members = units.filter((unit) => unit[0]?.groupId === groupId);
+    const chunks = [];
+    for (const [index, chunk] of packed(members, settings_editor_fields_1.MAX_MODAL_COMPONENTS).entries()) {
+        const key = `${groupId}${KEY_SEPARATOR}${index + 1}`;
+        groups.set(key, chunk);
+        chunks.push({ kind: "group", key, labelKey, hintKey, fields: chunk.map(controlEntry) });
+    }
+    return { kind: "group", labelKey, hintKey, chunks };
+}
+/**
+ * `units` packed in order into chunks of at most `size` controls, a unit
+ * never split: one that does not fit starts the next chunk.
+ */
+function packed(units, size) {
+    const chunks = [];
+    for (const unit of units) {
+        const last = chunks.at(-1);
+        if (last !== undefined && last.length + unit.length <= size) {
+            last.push(...unit);
+        }
+        else {
+            chunks.push([...unit]);
+        }
+    }
+    return chunks;
+}
+function controlEntry(control) {
+    return control.entry;
+}
+/** The entries a section stands for on a level of its own. */
+function sectionEntries(section) {
+    return section.kind === "control" ? [section.control.entry] : section.chunks;
+}
+/** A section's entries once a group split over several entries moves into a level of its own. */
+function foldedEntries(params) {
+    const { section, levels } = params;
+    if (section.kind === "control" || section.chunks.length === 1) {
+        return sectionEntries(section);
+    }
+    return [
+        nestedLevel({
+            labelKey: section.labelKey,
+            hintKey: section.hintKey,
+            entries: section.chunks,
+            levels,
+        }),
+    ];
+}
+/**
+ * `entries` within {@link MAX_CARD_LEVEL_ENTRIES}: all of them when they fit,
+ * otherwise those before the last place, then a "more settings" level holding
+ * the rest.
+ */
+function paged(params) {
+    const { entries, levels } = params;
+    if (entries.length <= settings_editor_card_view_1.MAX_CARD_LEVEL_ENTRIES) {
+        return entries;
+    }
+    const kept = settings_editor_card_view_1.MAX_CARD_LEVEL_ENTRIES - 1;
+    const more = nestedLevel({
+        labelKey: i18n_1.SETTINGS_EDITOR_MESSAGES.moreEntries,
+        hintKey: i18n_1.SETTINGS_EDITOR_MESSAGES.moreEntriesHint,
+        entries: entries.slice(kept),
+        levels,
+    });
+    return [...entries.slice(0, kept), more];
+}
+/** Add a level holding `entries` (paged to fit) and return the entry that opens it. */
+function nestedLevel(params) {
+    const { labelKey, hintKey, levels } = params;
+    const fields = paged({ entries: params.entries, levels });
+    const key = `${LEVEL_KEY_PREFIX}${KEY_SEPARATOR}${levels.length + 1}`;
+    levels.push({ key, titleKey: labelKey, fields });
+    return { kind: "level", key, levelKey: key, labelKey, hintKey };
+}
+//# sourceMappingURL=from-declaration-layout.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { SearchOptions } from "../../../discord/components/settings-editor/from-declaration-controls";
+import type { DeclarationSubject } from "../../../discord/components/settings-editor/from-declaration-subject";
+import type { SettingsDeclaration } from "../../../settings/define-settings";
+import type { RequestContext, SettingsService } from "../../../settings/settings-service";
+/**
+ * What each searchable field's select offers on the Discord screen (FR-026a):
+ * the first {@link MAX_SELECT_OPTIONS} results of its search for an empty
+ * query, since a select cannot be searched as it is typed. The field's
+ * current value leads the list when the results miss it, so a modal opened
+ * and sent back unchanged keeps it. A field whose search offered nothing
+ * (it failed or timed out, logged by the service) has no entry: the screen
+ * types it instead.
+ *
+ * @param params.declaration - the module's settings declaration.
+ * @param params.service - the settings service the searches run through.
+ * @param params.ctx - the guild, the administrator and their locale.
+ * @param params.subject - the screen's subject: the values searches see, and
+ * the current values' labels.
+ * @returns the options of each searchable field that has any, by field key.
+ */
+export declare function loadSearchOptions(params: {
+    declaration: SettingsDeclaration;
+    service: SettingsService;
+    ctx: RequestContext;
+    subject: DeclarationSubject;
+}): Promise<SearchOptions>;
+//# sourceMappingURL=from-declaration-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-search.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gEAAgE,CAAC;AACpG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AASxG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnF;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,cAAc,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;CAC5B,GAAG,OAAO,CAAC,aAAa,CAAC,CAezB"}

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

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSearchOptions = loadSearchOptions;
+const settings_editor_view_1 = require("../../../discord/components/settings-editor/settings-editor.view");
+const i18n_1 = require("../../../discord/i18n");
+const truncate_text_1 = require("../../../discord/ui/truncate-text");
+const field_search_1 = require("../../../settings/field-search");
+/**
+ * What each searchable field's select offers on the Discord screen (FR-026a):
+ * the first {@link MAX_SELECT_OPTIONS} results of its search for an empty
+ * query, since a select cannot be searched as it is typed. The field's
+ * current value leads the list when the results miss it, so a modal opened
+ * and sent back unchanged keeps it. A field whose search offered nothing
+ * (it failed or timed out, logged by the service) has no entry: the screen
+ * types it instead.
+ *
+ * @param params.declaration - the module's settings declaration.
+ * @param params.service - the settings service the searches run through.
+ * @param params.ctx - the guild, the administrator and their locale.
+ * @param params.subject - the screen's subject: the values searches see, and
+ * the current values' labels.
+ * @returns the options of each searchable field that has any, by field key.
+ */
+async function loadSearchOptions(params) {
+    const { declaration, service, ctx, subject } = params;
+    const searched = await Promise.all(Object.entries(declaration.fields)
+        .filter(([, declared]) => (0, field_search_1.fieldSearch)(declared.spec) !== undefined)
+        .map(async ([key]) => {
+        const results = await service.suggest(declaration, key, "", {
+            ...ctx,
+            values: subject.values,
+        });
+        const options = withCurrent({ results, key, subject }).map(toEditorChoice);
+        return [key, options.slice(0, settings_editor_view_1.MAX_SELECT_OPTIONS)];
+    }));
+    return new Map(searched.filter(([, options]) => options.length > 0));
+}
+/** The results with the field's current value first when they miss it. */
+function withCurrent(params) {
+    const { results, key, subject } = params;
+    const value = subject.values[key];
+    if (results.length === 0 || (typeof value !== "string" && typeof value !== "number")) {
+        return results;
+    }
+    if (results.some((choice) => String(choice.value) === String(value))) {
+        return results;
+    }
+    return [{ name: subject.labels[key] ?? String(value), value }, ...results];
+}
+/** A search result as a select option: its name shown as is, cut to what an option shows. */
+function toEditorChoice(choice) {
+    return {
+        value: String(choice.value),
+        labelKey: i18n_1.SETTINGS_EDITOR_MESSAGES.choiceLabel,
+        labelParams: { label: (0, truncate_text_1.truncateText)(choice.name, settings_editor_view_1.MAX_SELECT_OPTION_TEXT) },
+    };
+}
+//# sourceMappingURL=from-declaration-search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-search.js","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-search.ts"],"names":[],"mappings":";;AA8BA,8CAoBC;AAhDD,oGAGmE;AAEnE,yCAA0D;AAC1D,8DAA0D;AAG1D,0DAAsD;AAGtD;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,iBAAiB,CAAC,MAKvC;IACA,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAA,0BAAW,EAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;SAClE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,EAAE;YAC3D,GAAG,GAAG;YACN,MAAM,EAAE,OAAO,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,yCAAkB,CAAC,CAAU,CAAC;IAC7D,CAAC,CAAC,CACH,CAAC;IACF,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,0EAA0E;AAC1E,SAAS,WAAW,CAAC,MAIpB;IACA,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,EAAE,CAAC;QACtF,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACtE,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,6FAA6F;AAC7F,SAAS,cAAc,CAAC,MAAc;IACrC,OAAO;QACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,QAAQ,EAAE,+BAAwB,CAAC,WAAW;QAC9C,WAAW,EAAE,EAAE,KAAK,EAAE,IAAA,4BAAY,EAAC,MAAM,CAAC,IAAI,EAAE,6CAAsB,CAAC,EAAE;KACzE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { SettingsEditorChoice } from "../../../discord/components/settings-editor/settings-editor-fields";
+/**
+ * How the settings screen reads a value the settings service returned, shared
+ * by what a modal opens on, what the screen shows, and which stored ids the
+ * guild still has.
+ */
+/** The ids a stored picker value holds: none, one, or a list's. */
+export declare function storedIds(value: unknown): readonly string[];
+/** `set` for a secret the surface reads as set, `not set` otherwise. */
+export declare function secretStateKey(value: unknown): string;
+/** Whether `key` is on in a toggles value. */
+export declare function isToggledOn(params: {
+    value: unknown;
+    key: string;
+}): boolean;
+/** The catalog key of the choice offering `value`, or `undefined` when none does. */
+export declare function choiceLabelKey(params: {
+    choices: readonly SettingsEditorChoice[];
+    value: string;
+}): string | undefined;
+//# sourceMappingURL=from-declaration-stored.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-stored.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-stored.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AAGxG;;;;GAIG;AAEH,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,CAQ3D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAG5E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,GAAG,SAAS,CAErB"}

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storedIds = storedIds;
+exports.secretStateKey = secretStateKey;
+exports.isToggledOn = isToggledOn;
+exports.choiceLabelKey = choiceLabelKey;
+const messages_1 = require("../../../settings/messages");
+/**
+ * How the settings screen reads a value the settings service returned, shared
+ * by what a modal opens on, what the screen shows, and which stored ids the
+ * guild still has.
+ */
+/** The ids a stored picker value holds: none, one, or a list's. */
+function storedIds(value) {
+    if (typeof value === "string") {
+        return [value];
+    }
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string");
+    }
+    return [];
+}
+/** `set` for a secret the surface reads as set, `not set` otherwise. */
+function secretStateKey(value) {
+    const isSet = typeof value === "object" && value !== null && "isSet" in value && value.isSet;
+    return isSet === true ? messages_1.SETTINGS_MESSAGES.secretSet : messages_1.SETTINGS_MESSAGES.secretNotSet;
+}
+/** Whether `key` is on in a toggles value. */
+function isToggledOn(params) {
+    const { value, key } = params;
+    return typeof value === "object" && value !== null && Reflect.get(value, key) === true;
+}
+/** The catalog key of the choice offering `value`, or `undefined` when none does. */
+function choiceLabelKey(params) {
+    return params.choices.find((choice) => choice.value === params.value)?.labelKey;
+}
+//# sourceMappingURL=from-declaration-stored.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-stored.js","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-stored.ts"],"names":[],"mappings":";;AAUA,8BAQC;AAGD,wCAGC;AAGD,kCAGC;AAGD,wCAKC;AArCD,kDAAwD;AAExD;;;;GAIG;AAEH,mEAAmE;AACnE,SAAgB,SAAS,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED,wEAAwE;AACxE,SAAgB,cAAc,CAAC,KAAc;IAC5C,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;IAC7F,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,4BAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,4BAAiB,CAAC,YAAY,CAAC;AACtF,CAAC;AAED,8CAA8C;AAC9C,SAAgB,WAAW,CAAC,MAAuC;IAClE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,CAAC;AACxF,CAAC;AAED,qFAAqF;AACrF,SAAgB,cAAc,CAAC,MAG9B;IACA,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { SettingsDeclaration } from "../../../settings/define-settings";
+import type { RequestContext, SettingsService } from "../../../settings/settings-service";
+/**
+ * What the settings screen shows for one guild: every declared field as a
+ * surface reads it (a secret as whether it is set), the stored channels,
+ * roles and members the guild no longer has, and the label a searchable
+ * field's search gives its value.
+ */
+export interface DeclarationSubject {
+    readonly values: Readonly<Record<string, unknown>>;
+    /** Per field key, the stored ids the guild no longer offers. */
+    readonly unavailable: Readonly<Record<string, readonly string[]>>;
+    /** Per searchable field key, its search's label of the value, when it has one. */
+    readonly labels: Readonly<Record<string, string>>;
+}
+/**
+ * Read the guild's settings of a declaration for the screen, and find which
+ * stored entities it no longer has by asking the service's own validator
+ * about each one, so the screen and every other surface agree on it.
+ * A searchable field's value is labelled through `service.label`.
+ *
+ * @param params.declaration - the module's settings declaration.
+ * @param params.service - the settings service the screen reads through.
+ * @param params.ctx - the guild, the administrator and their locale.
+ * @returns the screen's subject.
+ */
+export declare function loadDeclarationSubject(params: {
+    declaration: SettingsDeclaration;
+    service: SettingsService;
+    ctx: RequestContext;
+}): Promise<DeclarationSubject>;
+//# sourceMappingURL=from-declaration-subject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-subject.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-subject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnF;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IAClE,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAKD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACpD,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,cAAc,CAAC;CACpB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2B9B"}

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

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDeclarationSubject = loadDeclarationSubject;
+const from_declaration_stored_1 = require("../../../discord/components/settings-editor/from-declaration-stored");
+const field_search_1 = require("../../../settings/field-search");
+/** The issues that say a stored id no longer names a usable entity of the guild. */
+const UNAVAILABLE_CODES = new Set(["notFound", "channelType"]);
+/**
+ * Read the guild's settings of a declaration for the screen, and find which
+ * stored entities it no longer has by asking the service's own validator
+ * about each one, so the screen and every other surface agree on it.
+ * A searchable field's value is labelled through `service.label`.
+ *
+ * @param params.declaration - the module's settings declaration.
+ * @param params.service - the settings service the screen reads through.
+ * @param params.ctx - the guild, the administrator and their locale.
+ * @returns the screen's subject.
+ */
+async function loadDeclarationSubject(params) {
+    const { declaration, service, ctx } = params;
+    const values = await service.getForSurface(declaration, ctx.guildId);
+    const checked = await Promise.all(Object.entries(declaration.fields).map(async ([key, declared]) => {
+        const missing = await unavailableIds({ ...params, key, declared, value: values[key] });
+        return [key, missing];
+    }));
+    const labelled = await Promise.all(Object.entries(declaration.fields).map(async ([key, declared]) => {
+        const value = values[key];
+        if (value === undefined || (0, field_search_1.fieldSearch)(declared.spec) === undefined) {
+            return [];
+        }
+        const label = await service.label(declaration, key, value, ctx);
+        return label === undefined ? [] : [[key, label]];
+    }));
+    return {
+        values,
+        unavailable: Object.fromEntries(checked.filter(hasMissingIds)),
+        labels: Object.fromEntries(labelled.flat()),
+    };
+}
+function hasMissingIds(entry) {
+    return entry[1].length > 0;
+}
+/** The ids a field stores that the guild no longer offers. */
+async function unavailableIds(params) {
+    const { declaration, service, ctx, key, declared, value } = params;
+    const isList = declared.spec.kind === "list";
+    if (!isEntityKind(itemKind(declared))) {
+        return [];
+    }
+    const ids = (0, from_declaration_stored_1.storedIds)(value);
+    const usable = await Promise.all(ids.map(async (id) => {
+        const result = await service.validate(declaration, ctx.guildId, { [key]: isList ? [id] : id }, ctx);
+        return result.ok || !result.issues.some((issue) => UNAVAILABLE_CODES.has(issue.code));
+    }));
+    return ids.filter((_, index) => usable[index] === false);
+}
+/** The kind of a list's items, or of the field itself when it is not a list. */
+function itemKind(declared) {
+    return declared.spec.kind === "list" ? declared.spec.item.spec.kind : declared.spec.kind;
+}
+/** Whether a field of this kind references a channel, a role or a member of the guild. */
+function isEntityKind(kind) {
+    return kind === "channel" || kind === "role" || kind === "user";
+}
+//# sourceMappingURL=from-declaration-subject.js.map

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

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

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

@@ -0,0 +1,57 @@
+import type { DeclarationControl } from "../../../discord/components/settings-editor/from-declaration-controls";
+import type { DeclarationSubject } from "../../../discord/components/settings-editor/from-declaration-subject";
+import type { SettingsEditorGroupMemberSubmission } from "../../../discord/components/settings-editor/settings-editor-field-modal";
+import { type SettingsEditorFieldValue } from "../../../discord/components/settings-editor/settings-editor-fields";
+import type { TranslateKey } from "../../../i18n/translator";
+/**
+ * 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.
+ */
+export declare function controlValue(params: {
+    control: DeclarationControl;
+    subject: DeclarationSubject;
+    translate: TranslateKey;
+}): SettingsEditorFieldValue;
+/**
+ * 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.
+ */
+export declare function isUnchanged(params: {
+    control: DeclarationControl;
+    submission: SettingsEditorGroupMemberSubmission;
+    current: SettingsEditorFieldValue;
+}): boolean;
+/**
+ * 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.
+ */
+export declare function withSubmission(params: {
+    control: DeclarationControl;
+    submission: SettingsEditorGroupMemberSubmission;
+    subject: DeclarationSubject;
+    patch: Readonly<Record<string, unknown>>;
+}): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=from-declaration-values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"from-declaration-values.d.ts","sourceRoot":"","sources":["../../../../src/discord/components/settings-editor/from-declaration-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,kBAAkB,EAClB,MAAM,gEAAgE,CAAC;AAMxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+DAA+D,CAAC;AACxG,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,kEAAkE,CAAC;AAK5H,OAAO,EAEN,KAAK,wBAAwB,EAC7B,MAAM,6DAA6D,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUtD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,YAAY,CAAC;CACxB,GAAG,wBAAwB,CAgC3B;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,mCAAmC,CAAC;IAChD,OAAO,EAAE,wBAAwB,CAAC;CAClC,GAAG,OAAO,CASV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,mCAAmC,CAAC;IAChD,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAKpC"}