@hartl-services/medusa-base 2.6.1 → 2.8.0

package/.medusa/server/src/admin/admin-components/features/plugin-features/hooks/usePluginSwitch.js

@@ -0,0 +1,66 @@
+import { usePrompt } from "@medusajs/ui";
+import { useQueryClient } from "@tanstack/react-query";
+import { texts } from "../../../i18n/texts";
+import { configuredFeatures } from "../lib/plugin-view";
+import { pluginFeatureKeys } from "../queries/pluginFeatureKeys";
+import { useUpdatePluginFeatures } from "./usePluginFeatures";
+/**
+ * Plugin switch of the hub card and of the plugin page: switching ON saves at
+ * once, switching OFF asks for confirmation first (the descriptor's
+ * `disable_confirm`, else a generic text). Saves with the loaded `version`, so
+ * a concurrent change answers 409 and reloads. After the confirmation the
+ * plugin is read from the query cache again, so a save made while the dialog
+ * was open does not send a stale `version`. Feature switches save through
+ * `saveFeatures`.
+ */
+export function usePluginSwitch(plugin) {
+    const mutation = useUpdatePluginFeatures();
+    const prompt = usePrompt();
+    const queryClient = useQueryClient();
+    /** The newest cached entry of this plugin (detail or list), else the one rendered with. */
+    const latest = () => {
+        const candidates = [
+            queryClient.getQueryData(pluginFeatureKeys.detail(plugin.plugin_key))?.plugin,
+            queryClient
+                .getQueryData(pluginFeatureKeys.list())
+                ?.plugins.find((entry) => entry.plugin_key === plugin.plugin_key),
+            plugin,
+        ].filter((entry) => entry !== undefined);
+        return candidates.reduce((newest, entry) => entry.version > newest.version ? entry : newest);
+    };
+    const save = (current, enabled, features) => {
+        mutation.mutate({
+            plugin_key: current.plugin_key,
+            expected_version: current.version,
+            enabled,
+            features,
+        });
+    };
+    const setEnabled = async (enabled) => {
+        if (!enabled) {
+            const confirmed = await prompt({
+                title: texts.plugin.disableTitle(plugin.label),
+                description: plugin.disable_confirm ?? texts.plugin.disableConfirmDefault,
+                confirmText: texts.plugin.disable,
+                cancelText: texts.plugin.cancel,
+            });
+            if (!confirmed) {
+                return;
+            }
+        }
+        const current = latest();
+        save(current, enabled, configuredFeatures(current));
+    };
+    const setFeature = (key, enabled) => {
+        const current = latest();
+        save(current, current.enabled, {
+            ...configuredFeatures(current),
+            [key]: enabled,
+        });
+    };
+    return {
+        pending: mutation.isPending,
+        setEnabled: (enabled) => void setEnabled(enabled),
+        setFeature,
+    };
+}

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" | "date";
             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,24 @@ 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;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     }[];
 }>;
 export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
@@ -109,8 +144,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 +164,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 +183,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" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -151,8 +199,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 +217,24 @@ 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;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     };
 }>;
 export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload) => Promise<{
@@ -193,8 +263,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 +283,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 +302,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" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -235,8 +318,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 +336,24 @@ 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;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | null;
+        }[];
     };
 }>;
 export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePluginSettingsPayload) => Promise<{
@@ -277,8 +382,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 +402,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 +421,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" | "date";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -319,8 +437,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 +455,24 @@ 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;
+            visible_when: {
+                setting: string;
+                equals: string | boolean;
+            } | 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,47 @@
+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;
+    /** The group applies only while this setting's draft value equals `equals`. */
+    visibleWhen: AdminPluginSettingGroup["visible_when"];
+    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[];
+/** Whether a group's `visible_when` holds for the current form values. */
+export declare const isGroupVisible: (group: Pick<SettingGroupView, "visibleWhen">, draft: Readonly<Record<string, string | boolean | null>>) => boolean;