@hartl-services/medusa-base 2.6.0 → 2.7.0

package/.medusa/server/src/admin/admin-components/i18n/texts.d.ts

@@ -2,9 +2,16 @@ export declare const texts: {
     menu: {
         label: string;
     };
+    breadcrumbs: {
+        hub: string;
+        emailAttachments: string;
+    };
     page: {
         title: string;
         description: string;
+        pluginsHeading: string;
+        installed: (count: number) => string;
+        editShop: string;
     };
     states: {
         loading: string;
@@ -15,14 +22,19 @@ export declare const texts: {
     };
     plugin: {
         switchLabel: (label: string) => string;
+        switchRow: string;
         open: string;
         openLabel: (label: string) => string;
+        disableTitle: (label: string) => string;
+        disableConfirmDefault: string;
+        disable: string;
+        cancel: string;
     };
     chips: {
         enabled: string;
         disabled: string;
         configured: string;
-        notConfigured: (labels: string) => string;
+        notConfigured: string;
     };
     detail: {
         back: string;
@@ -32,9 +44,13 @@ export declare const texts: {
         settings: string;
         actions: string;
     };
+    info: {
+        label: (label: string) => string;
+    };
     hints: {
         pluginDisabled: string;
         parentDisabled: (parentLabel: string) => string;
+        lastRequiredFeature: string;
         saving: string;
     };
     gate: {
@@ -44,6 +60,7 @@ export declare const texts: {
     };
     settings: {
         missing: (labels: string) => string;
+        requiredLegend: string;
         save: string;
         secretPlaceholder: string;
         secretClear: string;
@@ -51,8 +68,10 @@ export declare const texts: {
         secretClearUndo: string;
         secretClearLabel: (label: string) => string;
         secretClearUndoLabel: (label: string) => string;
+        /** Shown on a secret: the settings whose change deletes it ("A", "A oder B"). */
+        invalidatedBy: (labels: readonly string[]) => string;
+        /** Shown on the changing setting: the secrets its change deletes. */
         invalidates: (labels: string) => string;
-        required: string;
         invalidNumber: string;
         invalidColor: string;
         colorPlaceholder: string;
@@ -61,6 +80,7 @@ export declare const texts: {
         numberMin: (min: number) => string;
         numberMax: (max: number) => string;
         numberRange: (min: number, max: number) => string;
+        numberInteger: string;
         selectPlaceholder: string;
         imageUpload: string;
         imageReplace: string;

package/.medusa/server/src/admin/admin-components/i18n/texts.js

@@ -2,9 +2,16 @@ export const texts = {
     menu: {
         label: "Hartl Services Plugins",
     },
+    breadcrumbs: {
+        hub: "Plugins",
+        emailAttachments: "Anhänge",
+    },
     page: {
         title: "Hartl Services Plugins",
-        description: "Plugins ein- oder ausschalten und öffnen, um Funktionen, Einstellungen und Aktionen zu verwalten. Änderungen gelten sofort; abgeschaltete Funktionen sind im Shop nicht erreichbar.",
+        description: "Plugins ein- oder ausschalten und öffnen, um Funktionen, Einstellungen und Aktionen zu verwalten. Änderungen gelten sofort.",
+        pluginsHeading: "Plugins",
+        installed: (count) => `${count} installiert`,
+        editShop: "Bearbeiten",
     },
     states: {
         loading: "Plugins werden geladen…",
@@ -14,15 +21,20 @@ export const texts = {
         notFound: "Dieses Plugin ist nicht installiert.",
     },
     plugin: {
-        switchLabel: (label) => `${label} aktiv`,
+        switchLabel: (label) => `${label} eingeschaltet`,
+        switchRow: "Plugin eingeschaltet",
         open: "Öffnen",
         openLabel: (label) => `${label} öffnen`,
+        disableTitle: (label) => `${label} ausschalten?`,
+        disableConfirmDefault: "Die Funktionen des Plugins sind dann im Shop nicht mehr erreichbar. Gespeicherte Einstellungen und Daten bleiben erhalten.",
+        disable: "Ausschalten",
+        cancel: "Abbrechen",
     },
     chips: {
-        enabled: "aktiv",
-        disabled: "aus",
-        configured: "konfiguriert",
-        notConfigured: (labels) => `nicht konfiguriert: ${labels}`,
+        enabled: "Aktiv",
+        disabled: "Aus",
+        configured: "Konfiguriert",
+        notConfigured: "Nicht konfiguriert",
     },
     detail: {
         back: "Zurück zu Hartl Services Plugins",
@@ -32,9 +44,13 @@ export const texts = {
         settings: "Einstellungen",
         actions: "Aktionen",
     },
+    info: {
+        label: (label) => `Erklärung zu ${label}`,
+    },
     hints: {
         pluginDisabled: "Das Plugin ist ausgeschaltet. Alle Funktionen sind inaktiv, ihre Einstellungen bleiben erhalten.",
         parentDisabled: (parentLabel) => `Inaktiv, solange „${parentLabel}“ ausgeschaltet ist.`,
+        lastRequiredFeature: "Mindestens eine Funktion muss eingeschaltet bleiben.",
         saving: "Wird gespeichert…",
     },
     gate: {
@@ -44,6 +60,7 @@ export const texts = {
     },
     settings: {
         missing: (labels) => `Nicht konfiguriert: ${labels}`,
+        requiredLegend: "* Pflichtfeld",
         save: "Einstellungen speichern",
         secretPlaceholder: "gesetzt",
         secretClear: "Löschen",
@@ -51,8 +68,12 @@ export const texts = {
         secretClearUndo: "Nicht löschen",
         secretClearLabel: (label) => `${label} löschen`,
         secretClearUndoLabel: (label) => `${label} nicht löschen`,
+        /** Shown on a secret: the settings whose change deletes it ("A", "A oder B"). */
+        invalidatedBy: (labels) => `Wird gelöscht, wenn ${labels.length > 1
+            ? `${labels.slice(0, -1).join(", ")} oder ${labels[labels.length - 1]}`
+            : labels.join("")} sich ändert.`,
+        /** Shown on the changing setting: the secrets its change deletes. */
         invalidates: (labels) => `Beim Ändern muss ${labels} neu eingegeben werden.`,
-        required: "Pflichtfeld",
         invalidNumber: "Bitte eine gültige Zahl eingeben.",
         invalidColor: "Bitte eine Hex-Farbe wie #1a2b3c eingeben.",
         colorPlaceholder: "Standard",
@@ -61,6 +82,7 @@ export const texts = {
         numberMin: (min) => `Mindestens ${min}.`,
         numberMax: (max) => `Höchstens ${max}.`,
         numberRange: (min, max) => `Zwischen ${min} und ${max}.`,
+        numberInteger: "Ganze Zahl.",
         selectPlaceholder: "Bitte auswählen",
         imageUpload: "Bild hochladen",
         imageReplace: "Anderes Bild hochladen",

package/.medusa/server/src/admin/admin-components/index.d.ts

@@ -9,6 +9,7 @@
  */
 export { PluginPageShell } from "./features/plugin-features/components/PluginPageShell";
 export { PluginFeatureSections } from "./features/plugin-features/components/PluginFeatureSections";
+export { PluginLabelCrumb, pluginBreadcrumb, } from "./features/plugin-features/components/PluginBreadcrumb";
 export { PluginFeatureDisabledNotice, PluginFeatureGate, } from "./features/plugin-features/components/PluginFeatureGate";
 export { usePluginFeature } from "./features/plugin-features/hooks/usePluginFeatures";
 export { usePluginFeatureEnabled, type PluginFeatureEnabledState, } from "./features/plugin-features/hooks/usePluginFeatureEnabled";
@@ -22,15 +23,26 @@ export { fetchPdfObjectUrl } from "./shared/lib/pdf";
 export { usePdfPreview, type PdfPreviewState } from "./shared/lib/use-pdf-preview";
 export { useDebouncedValue } from "./shared/lib/use-debounced-value";
 export { AdminDatePicker } from "./shared/ui/AdminDatePicker";
+export { AdminPageHeader } from "./shared/ui/AdminPageHeader";
+export { AdminSection } from "./shared/ui/AdminSection";
+export { BreadcrumbTrail, type BreadcrumbTrailItem, } from "./shared/ui/BreadcrumbTrail";
 export { DateRangeFilter } from "./shared/ui/DateRangeFilter";
+export { InfoTooltip } from "./shared/ui/InfoTooltip";
+export { FileDropField } from "./shared/ui/FileDropField";
 export { FilePickerButton } from "./shared/ui/FilePickerButton";
+export { FocusModalShell } from "./shared/ui/FocusModalShell";
 export { BackLink } from "./shared/ui/BackLink";
 export { MappedStatusBadge, type MappedStatus } from "./shared/ui/MappedStatusBadge";
+export { MultiSelectDropdown } from "./shared/ui/MultiSelectDropdown";
+export type { MultiSelectOption } from "./shared/ui/multi-select";
 export { OffsetTablePagination } from "./shared/ui/OffsetTablePagination";
 export { PdfPreviewModal } from "./shared/ui/PdfPreviewModal";
 export { PluginFeatureRoute } from "./shared/ui/PluginFeatureRoute";
+export { PluginIcon } from "./shared/ui/PluginIcon";
 export { QueryState } from "./shared/ui/QueryState";
 export { SearchableReferenceField, type SearchableReferenceFieldProps, type SearchableReferenceSelected, } from "./shared/ui/SearchableReferenceField";
 export { SectionHeader } from "./shared/ui/SectionHeader";
+export { SwitchRow } from "./shared/ui/SwitchRow";
+export { WidgetHeader } from "./shared/ui/WidgetHeader";
 export { Extension, filterSlashItems, InsertMenu, isDefaultAllowedHref, Mark, mergeAttributes, Node, NodeSelection, NodeViewContent, NodeViewWrapper, normalizeLinkHref, Plugin, PluginKey, ReactNodeViewRenderer, RichTextEditor, TextSelection, useEditorState, useRichTextEditor, } from "./shared/ui/rich-text-editor";
 export type { AnyExtension, ChainedCommands, Editor, JSONContent, NestedContainer, NodeViewProps, Range, RichTextEditorConfig, SlashContext, SlashItem, } from "./shared/ui/rich-text-editor";

package/.medusa/server/src/admin/admin-components/index.js

@@ -9,6 +9,7 @@
  */
 export { PluginPageShell } from "./features/plugin-features/components/PluginPageShell";
 export { PluginFeatureSections } from "./features/plugin-features/components/PluginFeatureSections";
+export { PluginLabelCrumb, pluginBreadcrumb, } from "./features/plugin-features/components/PluginBreadcrumb";
 export { PluginFeatureDisabledNotice, PluginFeatureGate, } from "./features/plugin-features/components/PluginFeatureGate";
 export { usePluginFeature } from "./features/plugin-features/hooks/usePluginFeatures";
 export { usePluginFeatureEnabled, } from "./features/plugin-features/hooks/usePluginFeatureEnabled";
@@ -23,15 +24,25 @@ export { usePdfPreview } from "./shared/lib/use-pdf-preview";
 export { useDebouncedValue } from "./shared/lib/use-debounced-value";
 // Shared UI
 export { AdminDatePicker } from "./shared/ui/AdminDatePicker";
+export { AdminPageHeader } from "./shared/ui/AdminPageHeader";
+export { AdminSection } from "./shared/ui/AdminSection";
+export { BreadcrumbTrail, } from "./shared/ui/BreadcrumbTrail";
 export { DateRangeFilter } from "./shared/ui/DateRangeFilter";
+export { InfoTooltip } from "./shared/ui/InfoTooltip";
+export { FileDropField } from "./shared/ui/FileDropField";
 export { FilePickerButton } from "./shared/ui/FilePickerButton";
+export { FocusModalShell } from "./shared/ui/FocusModalShell";
 export { BackLink } from "./shared/ui/BackLink";
 export { MappedStatusBadge } from "./shared/ui/MappedStatusBadge";
+export { MultiSelectDropdown } from "./shared/ui/MultiSelectDropdown";
 export { OffsetTablePagination } from "./shared/ui/OffsetTablePagination";
 export { PdfPreviewModal } from "./shared/ui/PdfPreviewModal";
 export { PluginFeatureRoute } from "./shared/ui/PluginFeatureRoute";
+export { PluginIcon } from "./shared/ui/PluginIcon";
 export { QueryState } from "./shared/ui/QueryState";
 export { SearchableReferenceField, } from "./shared/ui/SearchableReferenceField";
 export { SectionHeader } from "./shared/ui/SectionHeader";
+export { SwitchRow } from "./shared/ui/SwitchRow";
+export { WidgetHeader } from "./shared/ui/WidgetHeader";
 // Rich-text editor
 export { Extension, filterSlashItems, InsertMenu, isDefaultAllowedHref, Mark, mergeAttributes, Node, NodeSelection, NodeViewContent, NodeViewWrapper, normalizeLinkHref, Plugin, PluginKey, ReactNodeViewRenderer, RichTextEditor, TextSelection, useEditorState, useRichTextEditor, } from "./shared/ui/rich-text-editor";

package/.medusa/server/src/admin/admin-components/shared/ui/AdminPageHeader.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+type AdminPageHeaderProps = {
+    /** Icon element for the badge, e.g. `<Buildings />` or `<PluginIcon name="Users" />`. */
+    icon: ReactNode;
+    /** The page's `h1`. */
+    title: ReactNode;
+    /** One short subtitle line under the title. */
+    description?: ReactNode;
+    /** Info button (`InfoTooltip`) next to the title, for the longer description. */
+    info?: ReactNode;
+    /** Status badges at the end (`StatusBadge`s); they wrap below the text on narrow screens. */
+    badges?: ReactNode;
+    /** Buttons at the end, after the badges. */
+    actions?: ReactNode;
+};
+/**
+ * Title container of an Admin page: large `IconBadge`, `h1`, subtle subtitle
+ * and a slot at the end for status badges and actions. The route's
+ * breadcrumb belongs in the route `handle`, not in the page.
+ */
+export declare const AdminPageHeader: ({ icon, title, description, info, badges, actions, }: AdminPageHeaderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/AdminPageHeader.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Container, Heading, IconBadge, Text } from "@medusajs/ui";
+/**
+ * Title container of an Admin page: large `IconBadge`, `h1`, subtle subtitle
+ * and a slot at the end for status badges and actions. The route's
+ * breadcrumb belongs in the route `handle`, not in the page.
+ */
+export const AdminPageHeader = ({ icon, title, description, info, badges, actions, }) => (_jsx(Container, { children: _jsxs("div", { className: "flex flex-wrap items-center gap-x-4 gap-y-3", children: [_jsx(IconBadge, { size: "large", children: icon }), _jsxs("div", { className: "flex min-w-0 flex-[1_1_320px] flex-col gap-y-0.5", children: [_jsxs("div", { className: "flex items-center gap-x-1", children: [_jsx(Heading, { level: "h1", children: title }), info] }), description ? (_jsx(Text, { size: "small", leading: "compact", className: "text-ui-fg-subtle", children: description })) : null] }), badges || actions ? (_jsxs("div", { className: "flex flex-wrap items-center gap-2", children: [badges, actions] })) : null] }) }));

package/.medusa/server/src/admin/admin-components/shared/ui/AdminSection.d.ts

@@ -0,0 +1,26 @@
+import type { HTMLAttributes, ReactNode } from "react";
+type AdminSectionProps = Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
+    /** The section's `h2`; omit it (and the other header props) for a section without header row. */
+    title?: ReactNode;
+    /** Subtle line under the title. */
+    description?: ReactNode;
+    /** Short subtle note at the end of the header row, e.g. "Version 3". */
+    note?: ReactNode;
+    /** Buttons at the end of the header row. */
+    actions?: ReactNode;
+    /**
+     * Content of the right-aligned last row, usually the save `Button`. Add
+     * `className="mr-auto"` to an element that should sit on the left instead.
+     */
+    footer?: ReactNode;
+    /** The rows. Each direct child is separated from the next by a divider. */
+    children?: ReactNode;
+};
+/**
+ * A section as the Admin builds it: `Container` with dividers, an optional
+ * header row (title, description, note, actions), the given rows and an
+ * optional right-aligned footer row. Rows are `SwitchRow`s or your own
+ * `px-6 py-5` blocks.
+ */
+export declare const AdminSection: ({ title, description, note, actions, footer, children, className, ...rest }: AdminSectionProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/AdminSection.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { clx, Container, Heading, Text } from "@medusajs/ui";
+/**
+ * A section as the Admin builds it: `Container` with dividers, an optional
+ * header row (title, description, note, actions), the given rows and an
+ * optional right-aligned footer row. Rows are `SwitchRow`s or your own
+ * `px-6 py-5` blocks.
+ */
+export const AdminSection = ({ title, description, note, actions, footer, children, className, ...rest }) => {
+    const hasHeader = Boolean(title || description || note || actions);
+    return (_jsxs(Container, { className: clx("divide-y p-0", className), ...rest, children: [hasHeader ? (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-x-4 gap-y-2 px-6 py-4", children: [_jsxs("div", { className: "flex min-w-0 flex-col gap-y-0.5", children: [title ? _jsx(Heading, { level: "h2", children: title }) : null, description ? (_jsx(Text, { size: "small", leading: "compact", className: "text-ui-fg-subtle", children: description })) : null] }), note || actions ? (_jsxs("div", { className: "flex flex-wrap items-center justify-end gap-x-4 gap-y-2", children: [note ? (_jsx(Text, { size: "small", leading: "compact", className: "text-ui-fg-subtle", children: note })) : null, actions] })) : null] })) : null, children, footer ? (_jsx("div", { className: "flex flex-wrap items-center justify-end gap-x-4 gap-y-2 px-6 py-3", children: footer })) : null] }));
+};

package/.medusa/server/src/admin/admin-components/shared/ui/BreadcrumbTrail.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+export type BreadcrumbTrailItem = {
+    label: ReactNode;
+    /** Admin path of the crumb; the last item is never a link. */
+    to?: string;
+};
+type BreadcrumbTrailProps = {
+    items: readonly BreadcrumbTrailItem[];
+};
+/**
+ * Several breadcrumbs in ONE route-`handle` crumb. The Admin renders
+ * `handle.breadcrumb(match)` per matched route, and a plugin's route map
+ * only contains parent routes that have a page in the same plugin; use this
+ * as the label of the last crumb when a parent lives in another plugin:
+ *
+ * `export const handle = { breadcrumb: () => <BreadcrumbTrail items={[{ label: "Plugins", to: "/settings/hartl-services" }, { label: "Affiliate" }]} /> }`
+ *
+ * Looks like the Admin's own crumbs (muted text, linked parents, triangle
+ * separator). Only for a leaf route: the Admin wraps a crumb that has a child
+ * route in a link of its own.
+ */
+export declare const BreadcrumbTrail: ({ items }: BreadcrumbTrailProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/BreadcrumbTrail.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TriangleRightMini } from "@medusajs/icons";
+import { Fragment } from "react";
+import { Link } from "react-router-dom";
+/**
+ * Several breadcrumbs in ONE route-`handle` crumb. The Admin renders
+ * `handle.breadcrumb(match)` per matched route, and a plugin's route map
+ * only contains parent routes that have a page in the same plugin; use this
+ * as the label of the last crumb when a parent lives in another plugin:
+ *
+ * `export const handle = { breadcrumb: () => <BreadcrumbTrail items={[{ label: "Plugins", to: "/settings/hartl-services" }, { label: "Affiliate" }]} /> }`
+ *
+ * Looks like the Admin's own crumbs (muted text, linked parents, triangle
+ * separator). Only for a leaf route: the Admin wraps a crumb that has a child
+ * route in a link of its own.
+ */
+export const BreadcrumbTrail = ({ items }) => (_jsx("span", { className: "inline-flex items-center", children: items.map((item, index) => {
+        const last = index === items.length - 1;
+        return (_jsxs(Fragment, { children: [item.to && !last ? (_jsx(Link, { className: "transition-fg hover:text-ui-fg-subtle", to: item.to, children: item.label })) : (_jsx("span", { children: item.label })), last ? null : (_jsx("span", { className: "mx-2", children: _jsx(TriangleRightMini, { className: "rtl:rotate-180" }) }))] }, index));
+    }) }));

package/.medusa/server/src/admin/admin-components/shared/ui/FileDropField.d.ts

@@ -0,0 +1,21 @@
+type FileDropFieldProps = {
+    /** Value of the file input's `accept` attribute. */
+    accept: string;
+    /** Text of the button that opens the file dialog. */
+    label: string;
+    /** Line under the button: the chosen file, a hint about allowed files, … */
+    text?: string;
+    disabled?: boolean;
+    isLoading?: boolean;
+    /** Id of the hidden input (for a `Label htmlFor`). */
+    id?: string;
+    "aria-describedby"?: string;
+    /** Called with the chosen or dropped file; the caller validates it. */
+    onFileSelected: (file: File) => void;
+};
+/**
+ * Dashed drop area for one file: the file dialog button plus drag and drop.
+ * Medusa UI has no such field; the Admin docs show nothing for it either.
+ */
+export declare const FileDropField: ({ accept, label, text, disabled, isLoading, id, "aria-describedby": describedBy, onFileSelected, }: FileDropFieldProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/FileDropField.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ArrowUpTray } from "@medusajs/icons";
+import { Text } from "@medusajs/ui";
+import { useState } from "react";
+import { leavesDropArea, pickDroppedFile } from "./file-drop";
+import { FilePickerButton } from "./FilePickerButton";
+/**
+ * Dashed drop area for one file: the file dialog button plus drag and drop.
+ * Medusa UI has no such field; the Admin docs show nothing for it either.
+ */
+export const FileDropField = ({ accept, label, text, disabled, isLoading, id, "aria-describedby": describedBy, onFileSelected, }) => {
+    const [dragging, setDragging] = useState(false);
+    const locked = disabled || isLoading === true;
+    return (_jsxs("div", { className: `flex min-h-[120px] flex-col items-center justify-center gap-y-2 rounded-lg border border-dashed p-4 text-center transition-fg ${dragging
+            ? "border-ui-border-interactive bg-ui-bg-base-hover"
+            : "border-ui-border-strong bg-ui-bg-subtle"}`, onDragOver: (event) => {
+            event.preventDefault();
+            if (!locked) {
+                setDragging(true);
+            }
+        }, onDragLeave: (event) => {
+            if (leavesDropArea(event.currentTarget, event.relatedTarget)) {
+                setDragging(false);
+            }
+        }, onDrop: (event) => {
+            event.preventDefault();
+            setDragging(false);
+            const file = pickDroppedFile(event.dataTransfer.files, locked);
+            if (file) {
+                onFileSelected(file);
+            }
+        }, children: [_jsx(ArrowUpTray, { className: "text-ui-fg-muted" }), _jsx(FilePickerButton, { accept: accept, label: label, disabled: disabled, isLoading: isLoading, id: id, "aria-describedby": describedBy, onFileSelected: onFileSelected }), text ? (_jsx(Text, { size: "small", leading: "compact", className: "text-ui-fg-muted", children: text })) : null] }));
+};

package/.medusa/server/src/admin/admin-components/shared/ui/FocusModalShell.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+type FocusModalShellProps = {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Accessible title (screen readers only; the page behind gives the context). */
+    title: string;
+    /** Accessible description (screen readers only). */
+    description: string;
+    /** Label of the primary button in the header, e.g. "Anhang anlegen". */
+    submitLabel: string;
+    onSubmit: () => void;
+    /** Blocks closing and shows the loading state on the primary button. */
+    isPending?: boolean;
+    /** Disables the primary button, e.g. while the form is invalid. */
+    submitDisabled?: boolean;
+    cancelLabel?: string;
+    /** The sections of the form, one block per section. */
+    children: ReactNode;
+};
+/**
+ * Full-screen form dialog as the Admin builds it: the actions (cancel and the
+ * primary button) in the header at the right, a centered body (720px) with
+ * the sections below. Closing is blocked while `isPending`. Put one
+ * `<section className="flex flex-col gap-y-5">` per section in `children`.
+ */
+export declare const FocusModalShell: ({ open, onOpenChange, title, description, submitLabel, onSubmit, isPending, submitDisabled, cancelLabel, children, }: FocusModalShellProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/FocusModalShell.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, FocusModal } from "@medusajs/ui";
+/**
+ * Full-screen form dialog as the Admin builds it: the actions (cancel and the
+ * primary button) in the header at the right, a centered body (720px) with
+ * the sections below. Closing is blocked while `isPending`. Put one
+ * `<section className="flex flex-col gap-y-5">` per section in `children`.
+ */
+export const FocusModalShell = ({ open, onOpenChange, title, description, submitLabel, onSubmit, isPending = false, submitDisabled = false, cancelLabel = "Abbrechen", children, }) => (_jsx(FocusModal, { onOpenChange: (next) => {
+        if (!next && !isPending) {
+            onOpenChange(false);
+        }
+    }, open: open, children: _jsx(FocusModal.Content, { children: _jsxs("div", { className: "flex h-full flex-col overflow-hidden", children: [_jsxs(FocusModal.Header, { children: [_jsx(FocusModal.Title, { className: "sr-only", children: title }), _jsx(FocusModal.Description, { className: "sr-only", children: description }), _jsxs("div", { className: "flex items-center justify-end gap-x-2", children: [_jsx(FocusModal.Close, { asChild: true, children: _jsx(Button, { disabled: isPending, size: "small", variant: "secondary", children: cancelLabel }) }), _jsx(Button, { disabled: isPending || submitDisabled, isLoading: isPending, onClick: onSubmit, size: "small", type: "button", children: submitLabel })] })] }), _jsx(FocusModal.Body, { className: "flex flex-1 flex-col items-center overflow-y-auto", children: _jsx("div", { className: "mx-auto flex w-full max-w-[720px] flex-col gap-y-8 px-2 py-16", children: children }) })] }) }) }));

package/.medusa/server/src/admin/admin-components/shared/ui/InfoTooltip.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode } from "react";
+type InfoTooltipProps = {
+    /** Accessible name of the button, e.g. "Erklärung zu Mindestlänge". */
+    label: string;
+    /** The explanation shown in the tooltip. */
+    children: ReactNode;
+};
+/**
+ * Small info button next to a label or heading; hovering or focusing it
+ * shows the longer explanation that does not fit under the field.
+ */
+export declare const InfoTooltip: ({ label, children }: InfoTooltipProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/InfoTooltip.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { InformationCircle } from "@medusajs/icons";
+import { IconButton, Tooltip } from "@medusajs/ui";
+/**
+ * Small info button next to a label or heading; hovering or focusing it
+ * shows the longer explanation that does not fit under the field.
+ */
+export const InfoTooltip = ({ label, children }) => (_jsx(Tooltip, { content: children, maxWidth: 320, children: _jsx(IconButton, { type: "button", variant: "transparent", size: "2xsmall", "aria-label": label, children: _jsx(InformationCircle, {}) }) }));

package/.medusa/server/src/admin/admin-components/shared/ui/MultiSelectDropdown.d.ts

@@ -0,0 +1,22 @@
+import { type MultiSelectOption } from "./multi-select";
+type MultiSelectDropdownProps<T extends string> = {
+    options: readonly MultiSelectOption<T>[];
+    value: readonly T[];
+    onChange: (value: T[]) => void;
+    /** Id of the trigger button (for a `Label htmlFor`). */
+    id?: string;
+    "aria-labelledby"?: string;
+    /** Accessible name when there is no visible label. */
+    "aria-label"?: string;
+    disabled?: boolean;
+    /** Shown when nothing is selected. */
+    placeholder?: string;
+};
+/**
+ * Select for several values: the trigger shows the chosen labels as badges
+ * (or the placeholder), the menu holds one checkbox item per option. The menu
+ * stays open while ticking. Medusa UI has no multi select; this is the
+ * Admin's own with the same look as its `Select`.
+ */
+export declare const MultiSelectDropdown: <T extends string>({ options, value, onChange, id, "aria-labelledby": labelledBy, "aria-label": ariaLabel, disabled, placeholder, }: MultiSelectDropdownProps<T>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/MultiSelectDropdown.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ChevronDownMini } from "@medusajs/icons";
+import { Badge, clx, DropdownMenu } from "@medusajs/ui";
+import { selectedMultiSelectLabels, toggleMultiSelectValue, } from "./multi-select";
+/**
+ * Select for several values: the trigger shows the chosen labels as badges
+ * (or the placeholder), the menu holds one checkbox item per option. The menu
+ * stays open while ticking. Medusa UI has no multi select; this is the
+ * Admin's own with the same look as its `Select`.
+ */
+export const MultiSelectDropdown = ({ options, value, onChange, id, "aria-labelledby": labelledBy, "aria-label": ariaLabel, disabled, placeholder = "Keine", }) => {
+    const labels = selectedMultiSelectLabels(options, value);
+    return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenu.Trigger, { asChild: true, disabled: disabled, children: _jsxs("button", { "aria-label": ariaLabel, "aria-labelledby": labelledBy, className: clx("bg-ui-bg-field shadow-borders-base txt-compact-small text-ui-fg-base flex min-h-8 w-full items-center justify-between gap-x-2 rounded-md px-2 py-[3px] text-left transition-fg", "hover:bg-ui-bg-field-hover focus-visible:shadow-borders-interactive-with-active outline-none", "disabled:bg-ui-bg-disabled disabled:text-ui-fg-disabled disabled:cursor-not-allowed"), id: id, type: "button", children: [_jsx("span", { className: "flex min-w-0 flex-wrap items-center gap-1", children: labels.length ? (labels.map((label) => (_jsx(Badge, { size: "2xsmall", children: label }, label)))) : (_jsx("span", { className: "text-ui-fg-muted", children: placeholder })) }), _jsx(ChevronDownMini, { className: "text-ui-fg-muted flex-none" })] }) }), _jsx(DropdownMenu.Content, { align: "start", className: "min-w-[var(--radix-dropdown-menu-trigger-width)]", children: options.map((option) => (_jsx(DropdownMenu.CheckboxItem, { checked: value.includes(option.value), disabled: option.disabled, onCheckedChange: (checked) => onChange(toggleMultiSelectValue(options, value, option.value, checked === true)), onSelect: (event) => event.preventDefault(), children: option.label }, option.value))) })] }));
+};

package/.medusa/server/src/admin/admin-components/shared/ui/PdfPreviewModal.js

@@ -4,4 +4,4 @@ import { Button, FocusModal, Text } from "@medusajs/ui";
  * Full-screen PDF preview. Owns no URL: the caller creates the object URL and
  * revokes it when the modal closes (see `fetchPdfObjectUrl`).
  */
-export const PdfPreviewModal = ({ open, onOpenChange, title, url, isLoading = false, error = null, frameTitle = "Vorschau", loadingText = "Wird geladen.", closeLabel = "Schließen", }) => (_jsx(FocusModal, { onOpenChange: onOpenChange, open: open, children: _jsxs(FocusModal.Content, { children: [_jsx(FocusModal.Header, { children: _jsx(FocusModal.Title, { children: title }) }), _jsx(FocusModal.Body, { className: "h-[75vh] p-0", children: url && !isLoading ? (_jsx("iframe", { className: "h-full w-full border-0", src: url, title: frameTitle })) : error ? (_jsx(Text, { "aria-atomic": "true", "aria-live": "assertive", className: "p-6 text-ui-fg-error", role: "alert", children: error })) : (_jsx(Text, { "aria-atomic": "true", "aria-live": "polite", className: "p-6 text-ui-fg-subtle", role: "status", children: loadingText })) }), _jsx(FocusModal.Footer, { children: _jsx(FocusModal.Close, { asChild: true, children: _jsx(Button, { variant: "secondary", children: closeLabel }) }) })] }) }));
+export const PdfPreviewModal = ({ open, onOpenChange, title, url, isLoading = false, error = null, frameTitle = "Vorschau", loadingText = "Wird geladen.", closeLabel = "Schließen", }) => (_jsx(FocusModal, { onOpenChange: onOpenChange, open: open, children: _jsxs(FocusModal.Content, { children: [_jsxs(FocusModal.Header, { children: [_jsx(FocusModal.Title, { children: title }), _jsxs(FocusModal.Description, { className: "sr-only", children: ["PDF-Vorschau: ", title] })] }), _jsx(FocusModal.Body, { className: "h-[75vh] p-0", children: url && !isLoading ? (_jsx("iframe", { className: "h-full w-full border-0", src: url, title: frameTitle })) : error ? (_jsx(Text, { "aria-atomic": "true", "aria-live": "assertive", className: "p-6 text-ui-fg-error", role: "alert", children: error })) : (_jsx(Text, { "aria-atomic": "true", "aria-live": "polite", className: "p-6 text-ui-fg-subtle", role: "status", children: loadingText })) }), _jsx(FocusModal.Footer, { children: _jsx(FocusModal.Close, { asChild: true, children: _jsx(Button, { variant: "secondary", children: closeLabel }) }) })] }) }));

package/.medusa/server/src/admin/admin-components/shared/ui/PluginIcon.d.ts

@@ -0,0 +1,10 @@
+type PluginIconProps = {
+    /** `icon` of the plugin as the Admin API reports it (`@medusajs/icons` component name). */
+    name: string | null | undefined;
+};
+/**
+ * The `@medusajs/icons` icon a plugin descriptor names; a default icon for no
+ * or an unknown name. Put it into `IconBadge` / `AdminPageHeader`.
+ */
+export declare const PluginIcon: ({ name }: PluginIconProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/PluginIcon.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { resolvePluginIcon } from "./plugin-icon";
+/**
+ * The `@medusajs/icons` icon a plugin descriptor names; a default icon for no
+ * or an unknown name. Put it into `IconBadge` / `AdminPageHeader`.
+ */
+export const PluginIcon = ({ name }) => {
+    const Icon = resolvePluginIcon(name);
+    return _jsx(Icon, {});
+};

package/.medusa/server/src/admin/admin-components/shared/ui/SwitchRow.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+type SwitchRowProps = {
+    /** Id of the switch; the label points to it. */
+    id: string;
+    label: ReactNode;
+    /** Info button (`InfoTooltip`) next to the label, for a longer explanation. */
+    info?: ReactNode;
+    /** Subtle explanation under the label. */
+    description?: ReactNode;
+    /** Further muted line under the description, e.g. why the switch is locked. */
+    hint?: ReactNode;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    /** Locks the switch. Dim the row itself through `className` (e.g. `opacity-50`). */
+    disabled?: boolean;
+    /** Child row of a parent switch: indented. */
+    indent?: boolean;
+    /** Element after the switch, e.g. an "Öffnen" button. */
+    trailing?: ReactNode;
+    className?: string;
+};
+/**
+ * One row of switches in an `AdminSection`: label with optional description
+ * on the left, `Switch` (and optional `trailing` element) on the right (`px-6 py-3`).
+ */
+export declare const SwitchRow: ({ id, label, info, description, hint, checked, onCheckedChange, disabled, indent, trailing, className, }: SwitchRowProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/SwitchRow.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { clx, Label, Switch, Text } from "@medusajs/ui";
+/**
+ * One row of switches in an `AdminSection`: label with optional description
+ * on the left, `Switch` (and optional `trailing` element) on the right (`px-6 py-3`).
+ */
+export const SwitchRow = ({ id, label, info, description, hint, checked, onCheckedChange, disabled, indent, trailing, className, }) => {
+    const describedBy = [
+        description ? `${id}-description` : null,
+        hint ? `${id}-hint` : null,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return (_jsxs("div", { className: clx("flex items-center gap-4 py-3 pr-6", indent ? "pl-12" : "pl-6", className), children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-y-0.5", children: [_jsxs("div", { className: "flex items-center gap-x-1", children: [_jsx(Label, { htmlFor: id, size: "small", weight: "plus", children: label }), info] }), description ? (_jsx(Text, { id: `${id}-description`, size: "small", leading: "compact", className: "text-ui-fg-subtle", children: description })) : null, hint ? (_jsx(Text, { id: `${id}-hint`, size: "small", leading: "compact", className: "text-ui-fg-muted", children: hint })) : null] }), _jsx(Switch, { id: id, "aria-describedby": describedBy || undefined, className: "shrink-0", checked: checked, disabled: disabled, onCheckedChange: (next) => onCheckedChange(next === true) }), trailing] }));
+};

package/.medusa/server/src/admin/admin-components/shared/ui/WidgetHeader.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+type WidgetHeaderProps = {
+    title: ReactNode;
+    /** Info button (`InfoTooltip`) next to the title, for the explanation that used to be a description. */
+    info?: ReactNode;
+    /** Button at the end, e.g. "Rechnung ausstellen". */
+    actions?: ReactNode;
+};
+/**
+ * Header of a compact side widget: `h2` with an optional info button and
+ * optional actions on one line (`px-6 py-3`). Sits at the top of a
+ * `Container className="divide-y p-0"`.
+ */
+export declare const WidgetHeader: ({ title, info, actions }: WidgetHeaderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/.medusa/server/src/admin/admin-components/shared/ui/WidgetHeader.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Heading } from "@medusajs/ui";
+/**
+ * Header of a compact side widget: `h2` with an optional info button and
+ * optional actions on one line (`px-6 py-3`). Sits at the top of a
+ * `Container className="divide-y p-0"`.
+ */
+export const WidgetHeader = ({ title, info, actions }) => (_jsxs("div", { className: "flex items-center justify-between gap-3 px-6 py-3", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-x-1", children: [_jsx(Heading, { level: "h2", children: title }), info] }), actions ? _jsx("div", { className: "flex shrink-0 items-center gap-2", children: actions }) : null] }));