@hartl-services/medusa-base 2.6.0 → 2.7.0

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-features-admin-client.d.ts

@@ -25,8 +25,12 @@ export declare const listPluginFeatures: () => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -41,12 +45,17 @@ export declare const listPluginFeatures: () => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -55,10 +64,14 @@ export declare const listPluginFeatures: () => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -67,8 +80,12 @@ export declare const listPluginFeatures: () => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -81,6 +98,20 @@ export declare const listPluginFeatures: () => Promise<{
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+        }[];
     }[];
 }>;
 export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
@@ -109,8 +140,12 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -125,12 +160,17 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -139,10 +179,14 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -151,8 +195,12 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -165,6 +213,20 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+        }[];
     };
 }>;
 export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload) => Promise<{
@@ -193,8 +255,12 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -209,12 +275,17 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -223,10 +294,14 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -235,8 +310,12 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -249,6 +328,20 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+        }[];
     };
 }>;
 export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePluginSettingsPayload) => Promise<{
@@ -277,8 +370,12 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "select";
             options: {
@@ -293,12 +390,17 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
             type: "number";
             min: number | null;
             max: number | null;
+            integer: boolean;
             default: number | null;
             value: number | null;
             key: string;
@@ -307,10 +409,14 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         } | {
-            type: "string" | "boolean" | "color" | "url" | "image";
+            type: "string" | "boolean" | "color" | "image" | "url";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -319,8 +425,12 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             group: string | null;
             required: boolean;
             is_set: boolean;
-            source: "default" | "stored" | "config" | "none";
+            source: "none" | "default" | "stored" | "config";
             invalidates: string[];
+            hint: string | null;
+            placeholder: string | null;
+            width: "full" | "half";
+            section: string | null;
         })[];
         configured: boolean;
         missing: string[];
@@ -333,6 +443,20 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             confirm: string | null;
         }[];
         admin_page: string | null;
+        icon: string | null;
+        summary: string | null;
+        disable_hint: string | null;
+        disable_confirm: string | null;
+        features_heading: string | null;
+        features_note: string | null;
+        all_off_warning: string | null;
+        require_enabled_feature: boolean;
+        setting_groups: {
+            name: string;
+            description: string | null;
+            note: string | null;
+            requires_feature: string | null;
+        }[];
     };
 }>;
 export declare const runPluginAction: (pluginKey: string, actionKey: string) => Promise<{

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-view.d.ts

@@ -0,0 +1,49 @@
+import type { AdminPluginFeature, AdminPluginFeatures, AdminPluginSetting, PluginSettingSource } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+/** Configured feature values (what the base stores), keyed by feature key. */
+export declare const configuredFeatures: (plugin: Pick<AdminPluginFeatures, "features">) => Record<string, boolean>;
+/** Labels of the required settings that have no value, "A, B". */
+export declare const missingLabels: (plugin: Pick<AdminPluginFeatures, "missing" | "settings">) => string;
+/** The plugin has settings that must be filled for it to count as configured. */
+export declare const hasRequiredSettings: (plugin: Pick<AdminPluginFeatures, "settings">) => boolean;
+/** The plugin is not configured: something required is missing. */
+export declare const isUnconfigured: (plugin: Pick<AdminPluginFeatures, "settings" | "configured">) => boolean;
+/**
+ * Every top-level feature is switched off (as configured, regardless of the
+ * plugin switch). `false` for a plugin without features.
+ */
+export declare const allTopLevelFeaturesOff: (plugin: Pick<AdminPluginFeatures, "features">) => boolean;
+/**
+ * The feature is the only enabled top-level feature of a plugin that requires
+ * one (`require_enabled_feature`): switching it off would be rejected by the
+ * server, so the Admin locks it.
+ */
+export declare const isLastRequiredFeature: (plugin: Pick<AdminPluginFeatures, "features" | "require_enabled_feature">, feature: Pick<AdminPluginFeature, "key" | "parent_key" | "enabled">) => boolean;
+/** The feature's parent when that parent is off, else `undefined`. */
+export declare const disabledParent: (features: readonly AdminPluginFeature[], feature: AdminPluginFeature) => AdminPluginFeature | undefined;
+/**
+ * Labels of the settings whose change deletes the given secret (reverse of
+ * `invalidates`), in the order the settings are declared.
+ */
+export declare const invalidatedByLabels: (settings: readonly AdminPluginSetting[], secretKey: string) => string[];
+/** Whether a settings group is dimmed: its required feature exists and is not effective. */
+export declare const isGroupDimmed: (features: readonly AdminPluginFeature[], requiresFeature: string | null) => boolean;
+/**
+ * Labels of the secrets that a change of `setting` deletes (forward
+ * `invalidates`), in the setting's order; unknown keys fall back to the key.
+ */
+export declare const invalidatesLabels: (settings: readonly AdminPluginSetting[], setting: Pick<AdminPluginSetting, "invalidates">) => string[];
+/**
+ * The description a setting shows in its info tooltip: only when a `hint`
+ * takes the place under the field and the description says something else.
+ */
+export declare const settingInfoText: (setting: Pick<AdminPluginSetting, "hint" | "description">) => string | null;
+/** The description a page header shows in its info tooltip: when the summary is shown instead and differs. */
+export declare const headerInfoText: (plugin: Pick<AdminPluginFeatures, "summary" | "description">) => string | null;
+/** "default" is the normal case and not worth a line under every field. */
+export declare const showsSourceHint: (source: PluginSettingSource) => boolean;
+/** The plain-language range line ("Zwischen 8 und 128.") is only a separate line when no `hint` explains the field. */
+export declare const showsBoundsLine: (setting: Pick<AdminPluginSetting, "hint">) => boolean;
+/** The plugins in hub order: those that cannot be switched off first, then the server's order. */
+export declare const hubOrder: <T extends {
+    switchable: boolean;
+}>(plugins: readonly T[]) => T[];

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/plugin-view.js

@@ -0,0 +1,72 @@
+/** Configured feature values (what the base stores), keyed by feature key. */
+export const configuredFeatures = (plugin) => Object.fromEntries(plugin.features.map((feature) => [feature.key, feature.enabled]));
+/** Labels of the required settings that have no value, "A, B". */
+export const missingLabels = (plugin) => plugin.missing
+    .map((key) => plugin.settings.find((setting) => setting.key === key)?.label ?? key)
+    .join(", ");
+/** The plugin has settings that must be filled for it to count as configured. */
+export const hasRequiredSettings = (plugin) => plugin.settings.some((setting) => setting.required);
+/** The plugin is not configured: something required is missing. */
+export const isUnconfigured = (plugin) => !plugin.configured && hasRequiredSettings(plugin);
+/**
+ * Every top-level feature is switched off (as configured, regardless of the
+ * plugin switch). `false` for a plugin without features.
+ */
+export const allTopLevelFeaturesOff = (plugin) => {
+    const topLevel = plugin.features.filter((feature) => feature.parent_key === null);
+    return topLevel.length > 0 && topLevel.every((feature) => !feature.enabled);
+};
+/**
+ * The feature is the only enabled top-level feature of a plugin that requires
+ * one (`require_enabled_feature`): switching it off would be rejected by the
+ * server, so the Admin locks it.
+ */
+export const isLastRequiredFeature = (plugin, feature) => plugin.require_enabled_feature &&
+    feature.parent_key === null &&
+    feature.enabled &&
+    plugin.features.every((other) => other.key === feature.key || other.parent_key !== null || !other.enabled);
+/** The feature's parent when that parent is off, else `undefined`. */
+export const disabledParent = (features, feature) => {
+    const parent = features.find((candidate) => candidate.key === feature.parent_key);
+    return parent && !parent.enabled ? parent : undefined;
+};
+/**
+ * Labels of the settings whose change deletes the given secret (reverse of
+ * `invalidates`), in the order the settings are declared.
+ */
+export const invalidatedByLabels = (settings, secretKey) => settings
+    .filter((setting) => setting.invalidates.includes(secretKey))
+    .map((setting) => setting.label);
+/** Whether a settings group is dimmed: its required feature exists and is not effective. */
+export const isGroupDimmed = (features, requiresFeature) => requiresFeature !== null &&
+    features.find((feature) => feature.key === requiresFeature)
+        ?.effective_enabled === false;
+/**
+ * Labels of the secrets that a change of `setting` deletes (forward
+ * `invalidates`), in the setting's order; unknown keys fall back to the key.
+ */
+export const invalidatesLabels = (settings, setting) => setting.invalidates.map((key) => settings.find((candidate) => candidate.key === key)?.label ?? key);
+/**
+ * The description a setting shows in its info tooltip: only when a `hint`
+ * takes the place under the field and the description says something else.
+ */
+export const settingInfoText = (setting) => setting.hint !== null &&
+    setting.description !== null &&
+    setting.description !== setting.hint
+    ? setting.description
+    : null;
+/** The description a page header shows in its info tooltip: when the summary is shown instead and differs. */
+export const headerInfoText = (plugin) => plugin.summary !== null &&
+    plugin.description !== null &&
+    plugin.description !== plugin.summary
+    ? plugin.description
+    : null;
+/** "default" is the normal case and not worth a line under every field. */
+export const showsSourceHint = (source) => source !== "default";
+/** The plain-language range line ("Zwischen 8 und 128.") is only a separate line when no `hint` explains the field. */
+export const showsBoundsLine = (setting) => setting.hint === null;
+/** The plugins in hub order: those that cannot be switched off first, then the server's order. */
+export const hubOrder = (plugins) => [
+    ...plugins.filter((plugin) => !plugin.switchable),
+    ...plugins.filter((plugin) => plugin.switchable),
+];

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-draft.d.ts

@@ -12,17 +12,6 @@ export declare const initialSettingsDraft: (settings: readonly AdminPluginSettin
 export declare const isHexColor: (value: string) => boolean;
 /** Colors are typed and sent lowercase; surrounding spaces are dropped. */
 export declare const normalizeColorInput: (value: string) => string;
-export type SettingSection = {
-    /** Section heading; `null` = no heading. */
-    group: string | null;
-    settings: AdminPluginSetting[];
-};
-/**
- * Splits the settings (in their given order) into consecutive runs of the
- * same `group`; a new section starts whenever the group differs from the
- * previous setting's group.
- */
-export declare const groupSettings: (settings: readonly AdminPluginSetting[]) => SettingSection[];
 /**
  * Keys of number fields whose input the browser could not parse (e.g. "1e"):
  * the input then reports `""`, which must not be read as "cleared".
@@ -30,7 +19,7 @@ export declare const groupSettings: (settings: readonly AdminPluginSetting[]) =>
 export type UnparsableKeys = readonly string[];
 /**
  * Keys whose draft value cannot be sent: unparsable, not a number or
- * outside min/max, or a color that is not `#rrggbb`. Saving is disabled while any key is listed.
+ * outside min/max, a fraction for an integer setting, or a color that is not `#rrggbb`. Saving is disabled while any key is listed.
  */
 export declare const invalidDraftKeys: (settings: readonly AdminPluginSetting[], draft: SettingsDraft, unparsable?: UnparsableKeys) => string[];
 /**

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-draft.js

@@ -13,24 +13,6 @@ const HEX_COLOR = /^#[0-9a-fA-F]{6}$/;
 export const isHexColor = (value) => HEX_COLOR.test(value);
 /** Colors are typed and sent lowercase; surrounding spaces are dropped. */
 export const normalizeColorInput = (value) => value.trim().toLowerCase();
-/**
- * Splits the settings (in their given order) into consecutive runs of the
- * same `group`; a new section starts whenever the group differs from the
- * previous setting's group.
- */
-export const groupSettings = (settings) => {
-    const sections = [];
-    for (const setting of settings) {
-        const last = sections[sections.length - 1];
-        if (last && last.group === setting.group) {
-            last.settings.push(setting);
-        }
-        else {
-            sections.push({ group: setting.group, settings: [setting] });
-        }
-    }
-    return sections;
-};
 const outsideBounds = (setting, value) => (setting.min !== null && value < setting.min) ||
     (setting.max !== null && value > setting.max);
 const numberEntryValue = (entry) => {
@@ -39,7 +21,7 @@ const numberEntryValue = (entry) => {
 };
 /**
  * Keys whose draft value cannot be sent: unparsable, not a number or
- * outside min/max, or a color that is not `#rrggbb`. Saving is disabled while any key is listed.
+ * outside min/max, a fraction for an integer setting, or a color that is not `#rrggbb`. Saving is disabled while any key is listed.
  */
 export const invalidDraftKeys = (settings, draft, unparsable = []) => settings
     .filter((setting) => {
@@ -60,7 +42,9 @@ export const invalidDraftKeys = (settings, draft, unparsable = []) => settings
         return false;
     }
     const value = numberEntryValue(entry);
-    return value === null || outsideBounds(setting, value);
+    return (value === null ||
+        outsideBounds(setting, value) ||
+        (setting.integer && !Number.isInteger(value)));
 })
     .map((setting) => setting.key);
 /**

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-layout.d.ts

@@ -0,0 +1,43 @@
+import type { AdminPluginSetting, AdminPluginSettingGroup } from "@hartl-services/medusa-food-supplements-contracts/types/plugin-features-admin";
+/** One row of fields: a full-width setting, or consecutive `half` settings sharing a row. */
+export type SettingFieldRow = {
+    kind: "full";
+    setting: AdminPluginSetting;
+} | {
+    kind: "half";
+    settings: AdminPluginSetting[];
+};
+/**
+ * A run of rows in a group. Boolean settings are switch rows of their own;
+ * all other settings between two switches (or two sub-headings) share one
+ * `fields` block. `heading` is the sub-heading that starts the block.
+ */
+export type SettingBlock = {
+    kind: "fields";
+    heading: string | null;
+    rows: SettingFieldRow[];
+} | {
+    kind: "switch";
+    heading: string | null;
+    setting: AdminPluginSetting;
+};
+/** One card of the settings form: a group with its metadata and blocks. */
+export type SettingGroupView = {
+    /** Group name as in `setting.group`; `null` = the ungrouped settings. */
+    name: string | null;
+    /** Card heading (the group name, or the fallback title for ungrouped). */
+    title: string;
+    description: string | null;
+    note: string | null;
+    requiresFeature: string | null;
+    settings: AdminPluginSetting[];
+    blocks: SettingBlock[];
+};
+/** Blocks of one group's settings (in their given order). */
+export declare const buildSettingBlocks: (settings: readonly AdminPluginSetting[]) => SettingBlock[];
+/**
+ * Groups the settings into cards, in order of the first appearance of each
+ * group; settings without a group form one card titled `ungroupedTitle`.
+ * `groups` supplies the description, note and required feature per group.
+ */
+export declare const buildSettingGroups: (settings: readonly AdminPluginSetting[], groups: readonly AdminPluginSettingGroup[], ungroupedTitle: string) => SettingGroupView[];

package/.medusa/server/src/admin/admin-components/features/plugin-features/lib/settings-layout.js

@@ -0,0 +1,66 @@
+/** Blocks of one group's settings (in their given order). */
+export const buildSettingBlocks = (settings) => {
+    const blocks = [];
+    let previousSection = null;
+    for (const [index, setting] of settings.entries()) {
+        const startsSection = setting.section !== null && (index === 0 || setting.section !== previousSection);
+        const sectionChanged = index > 0 && setting.section !== previousSection;
+        previousSection = setting.section;
+        const heading = startsSection ? setting.section : null;
+        if (setting.type === "boolean") {
+            blocks.push({ kind: "switch", heading, setting });
+            continue;
+        }
+        const last = blocks[blocks.length - 1];
+        let block;
+        if (last?.kind === "fields" && !startsSection && !sectionChanged) {
+            block = last;
+        }
+        else {
+            block = { kind: "fields", heading, rows: [] };
+            blocks.push(block);
+        }
+        const lastRow = block.rows[block.rows.length - 1];
+        if (setting.width === "half") {
+            if (lastRow?.kind === "half") {
+                lastRow.settings.push(setting);
+            }
+            else {
+                block.rows.push({ kind: "half", settings: [setting] });
+            }
+        }
+        else {
+            block.rows.push({ kind: "full", setting });
+        }
+    }
+    return blocks;
+};
+/**
+ * Groups the settings into cards, in order of the first appearance of each
+ * group; settings without a group form one card titled `ungroupedTitle`.
+ * `groups` supplies the description, note and required feature per group.
+ */
+export const buildSettingGroups = (settings, groups, ungroupedTitle) => {
+    const byName = new Map();
+    for (const setting of settings) {
+        const entry = byName.get(setting.group);
+        if (entry) {
+            entry.push(setting);
+        }
+        else {
+            byName.set(setting.group, [setting]);
+        }
+    }
+    return [...byName.entries()].map(([name, groupSettings]) => {
+        const meta = name === null ? undefined : groups.find((group) => group.name === name);
+        return {
+            name,
+            title: name ?? ungroupedTitle,
+            description: meta?.description ?? null,
+            note: meta?.note ?? null,
+            requiresFeature: meta?.requires_feature ?? null,
+            settings: groupSettings,
+            blocks: buildSettingBlocks(groupSettings),
+        };
+    });
+};