@hartl-services/medusa-base 2.6.1 → 2.8.0

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] }));

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

@@ -0,0 +1,13 @@
+/**
+ * The file a drop delivers: the first one, or `null` when the field is
+ * disabled or the drop carried no file (text, a link, …).
+ */
+export declare const pickDroppedFile: (files: ArrayLike<File> | null | undefined, disabled: boolean) => File | null;
+/**
+ * A `dragleave` that only moves onto an element inside the drop area (the
+ * icon, the button, the text) does not leave it; only a move outside, or off
+ * the page, does.
+ */
+export declare const leavesDropArea: (area: {
+    contains(node: Node | null): boolean;
+}, relatedTarget: EventTarget | null) => boolean;

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

@@ -0,0 +1,16 @@
+/**
+ * The file a drop delivers: the first one, or `null` when the field is
+ * disabled or the drop carried no file (text, a link, …).
+ */
+export const pickDroppedFile = (files, disabled) => {
+    if (disabled || !files || files.length === 0) {
+        return null;
+    }
+    return files[0] ?? null;
+};
+/**
+ * A `dragleave` that only moves onto an element inside the drop area (the
+ * icon, the button, the text) does not leave it; only a move outside, or off
+ * the page, does.
+ */
+export const leavesDropArea = (area, relatedTarget) => !area.contains(relatedTarget);

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

@@ -0,0 +1,13 @@
+export type MultiSelectOption<T extends string = string> = {
+    value: T;
+    label: string;
+    /** Shown but not selectable, e.g. while a change of it is being saved. */
+    disabled?: boolean;
+};
+/**
+ * Adds or removes `option` and returns the selection in the order of
+ * `options`; values that are not options are dropped.
+ */
+export declare const toggleMultiSelectValue: <T extends string>(options: readonly MultiSelectOption<T>[], selected: readonly T[], option: T, checked: boolean) => T[];
+/** Labels of the selected options, in the order of `options`. */
+export declare const selectedMultiSelectLabels: <T extends string>(options: readonly MultiSelectOption<T>[], selected: readonly T[]) => string[];

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

@@ -0,0 +1,11 @@
+/**
+ * Adds or removes `option` and returns the selection in the order of
+ * `options`; values that are not options are dropped.
+ */
+export const toggleMultiSelectValue = (options, selected, option, checked) => options
+    .map((candidate) => candidate.value)
+    .filter((value) => (value === option ? checked : selected.includes(value)));
+/** Labels of the selected options, in the order of `options`. */
+export const selectedMultiSelectLabels = (options, selected) => options
+    .filter((candidate) => selected.includes(candidate.value))
+    .map((candidate) => candidate.label);

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

@@ -0,0 +1,12 @@
+import { SquaresPlus } from "@medusajs/icons";
+/** Every icon of `@medusajs/icons` has the type of this one. */
+export type PluginIconComponent = typeof SquaresPlus;
+/**
+ * The icons a plugin descriptor may name in `icon` (the server's
+ * `PLUGIN_ICON_NAMES`, which the Admin cannot import).
+ */
+export declare const PLUGIN_ICONS: Readonly<Record<string, PluginIconComponent>>;
+/** Icon of a plugin without (or with an unknown) `icon`. */
+export declare const DEFAULT_PLUGIN_ICON: PluginIconComponent;
+/** The icon component for a descriptor's icon name; the default icon for `null` or an unknown name. */
+export declare const resolvePluginIcon: (name: string | null | undefined) => PluginIconComponent;

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

@@ -0,0 +1,29 @@
+import { ArchiveBox, ArrowPath, BuildingStorefront, Buildings, ClockSolid, CogSixTooth, CreditCard, DocumentText, Envelope, ReceiptPercent, ShieldCheck, ShoppingCart, SquaresPlus, Tag, TruckFast, Users, } from "@medusajs/icons";
+/**
+ * The icons a plugin descriptor may name in `icon` (the server's
+ * `PLUGIN_ICON_NAMES`, which the Admin cannot import).
+ */
+export const PLUGIN_ICONS = {
+    ArchiveBox,
+    ArrowPath,
+    BuildingStorefront,
+    Buildings,
+    ClockSolid,
+    CogSixTooth,
+    CreditCard,
+    DocumentText,
+    Envelope,
+    ReceiptPercent,
+    ShieldCheck,
+    ShoppingCart,
+    SquaresPlus,
+    Tag,
+    TruckFast,
+    Users,
+};
+/** Icon of a plugin without (or with an unknown) `icon`. */
+export const DEFAULT_PLUGIN_ICON = SquaresPlus;
+/** The icon component for a descriptor's icon name; the default icon for `null` or an unknown name. */
+export const resolvePluginIcon = (name) => (name && Object.prototype.hasOwnProperty.call(PLUGIN_ICONS, name)
+    ? PLUGIN_ICONS[name]
+    : undefined) ?? DEFAULT_PLUGIN_ICON;