@hartl-services/medusa-base 2.5.0 → 2.6.1

package/{dist → .medusa/server/src/admin}/admin-components/features/plugin-features/lib/settings-draft.js

@@ -8,6 +8,29 @@ const initialEntry = (setting) => {
     return setting.value === null ? "" : String(setting.value);
 };
 export const initialSettingsDraft = (settings) => Object.fromEntries(settings.map((setting) => [setting.key, initialEntry(setting)]));
+const HEX_COLOR = /^#[0-9a-fA-F]{6}$/;
+/** `#rrggbb` (either case); the server stores it lowercase. */
+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) => {
@@ -16,10 +39,16 @@ const numberEntryValue = (entry) => {
 };
 /**
  * Keys whose draft value cannot be sent: unparsable, not a number or
- * outside min/max. Saving is disabled while any key is listed.
+ * outside min/max, or a color that is not `#rrggbb`. Saving is disabled while any key is listed.
  */
 export const invalidDraftKeys = (settings, draft, unparsable = []) => settings
     .filter((setting) => {
+    if (setting.type === "color") {
+        const entry = draft[setting.key];
+        return (typeof entry === "string" &&
+            entry.trim() !== "" &&
+            !isHexColor(entry.trim()));
+    }
     if (setting.type !== "number") {
         return false;
     }
@@ -78,6 +107,9 @@ export const changedSettingValues = (settings, draft, unparsable = []) => {
                 values[setting.key] = value;
             }
         }
+        else if (setting.type === "color") {
+            values[setting.key] = normalizeColorInput(text);
+        }
         else {
             values[setting.key] = text;
         }

package/{dist → .medusa/server/src/admin}/admin-components/i18n/texts.d.ts

@@ -54,6 +54,9 @@ export declare const texts: {
         invalidates: (labels: string) => string;
         required: string;
         invalidNumber: string;
+        invalidColor: string;
+        colorPlaceholder: string;
+        colorPickLabel: (label: string) => string;
         outOfRange: string;
         numberMin: (min: number) => string;
         numberMax: (max: number) => string;

package/{dist → .medusa/server/src/admin}/admin-components/i18n/texts.js

@@ -54,6 +54,9 @@ export const texts = {
         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",
+        colorPickLabel: (label) => `${label} auswählen`,
         outOfRange: "Der Wert liegt außerhalb des erlaubten Bereichs.",
         numberMin: (min) => `Mindestens ${min}.`,
         numberMax: (max) => `Höchstens ${max}.`,

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

@@ -0,0 +1,36 @@
+/**
+ * Entry of `@hartl-services/medusa-base/admin-components` (built by
+ * `tsconfig.admin-components.json` into
+ * `.medusa/server/src/admin/admin-components`). Not an Admin extension: routes and widgets live in `routes/`.
+ *
+ * Other plugins compose these into their own Admin page. Everything here
+ * uses the host Admin's React, React Query, React Router and `@medusajs/ui`.
+ * `shared/ui` and `shared/lib` hold the building blocks every plugin reuses.
+ */
+export { PluginPageShell } from "./features/plugin-features/components/PluginPageShell";
+export { PluginFeatureSections } from "./features/plugin-features/components/PluginFeatureSections";
+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";
+export { pluginFeatureKeys } from "./features/plugin-features/queries/pluginFeatureKeys";
+export { sdk } from "./shared/lib/sdk";
+export { getErrorMessage } from "./shared/lib/errors";
+export { ADMIN_DASH, ADMIN_LOCALE, formatAmount, formatDate, formatDateTime, getTodayInputDate, type FormatDateOptions, } from "./shared/lib/format";
+export { dateFromInputValue, dateTimeFromInputValue, inputValueFromDate, inputValueFromDateTime, } from "./shared/lib/date-input";
+export { validateFile } from "./shared/lib/file-validation";
+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 { DateRangeFilter } from "./shared/ui/DateRangeFilter";
+export { FilePickerButton } from "./shared/ui/FilePickerButton";
+export { BackLink } from "./shared/ui/BackLink";
+export { MappedStatusBadge, type MappedStatus } from "./shared/ui/MappedStatusBadge";
+export { OffsetTablePagination } from "./shared/ui/OffsetTablePagination";
+export { PdfPreviewModal } from "./shared/ui/PdfPreviewModal";
+export { PluginFeatureRoute } from "./shared/ui/PluginFeatureRoute";
+export { QueryState } from "./shared/ui/QueryState";
+export { SearchableReferenceField, type SearchableReferenceFieldProps, type SearchableReferenceSelected, } from "./shared/ui/SearchableReferenceField";
+export { SectionHeader } from "./shared/ui/SectionHeader";
+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

@@ -0,0 +1,37 @@
+/**
+ * Entry of `@hartl-services/medusa-base/admin-components` (built by
+ * `tsconfig.admin-components.json` into
+ * `.medusa/server/src/admin/admin-components`). Not an Admin extension: routes and widgets live in `routes/`.
+ *
+ * Other plugins compose these into their own Admin page. Everything here
+ * uses the host Admin's React, React Query, React Router and `@medusajs/ui`.
+ * `shared/ui` and `shared/lib` hold the building blocks every plugin reuses.
+ */
+export { PluginPageShell } from "./features/plugin-features/components/PluginPageShell";
+export { PluginFeatureSections } from "./features/plugin-features/components/PluginFeatureSections";
+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";
+export { pluginFeatureKeys } from "./features/plugin-features/queries/pluginFeatureKeys";
+export { sdk } from "./shared/lib/sdk";
+export { getErrorMessage } from "./shared/lib/errors";
+export { ADMIN_DASH, ADMIN_LOCALE, formatAmount, formatDate, formatDateTime, getTodayInputDate, } from "./shared/lib/format";
+export { dateFromInputValue, dateTimeFromInputValue, inputValueFromDate, inputValueFromDateTime, } from "./shared/lib/date-input";
+export { validateFile } from "./shared/lib/file-validation";
+export { fetchPdfObjectUrl } from "./shared/lib/pdf";
+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 { DateRangeFilter } from "./shared/ui/DateRangeFilter";
+export { FilePickerButton } from "./shared/ui/FilePickerButton";
+export { BackLink } from "./shared/ui/BackLink";
+export { MappedStatusBadge } from "./shared/ui/MappedStatusBadge";
+export { OffsetTablePagination } from "./shared/ui/OffsetTablePagination";
+export { PdfPreviewModal } from "./shared/ui/PdfPreviewModal";
+export { PluginFeatureRoute } from "./shared/ui/PluginFeatureRoute";
+export { QueryState } from "./shared/ui/QueryState";
+export { SearchableReferenceField, } from "./shared/ui/SearchableReferenceField";
+export { SectionHeader } from "./shared/ui/SectionHeader";
+// 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/lib/date-input.d.ts

@@ -0,0 +1,8 @@
+/** Local `Date` at midnight of a "yyyy-mm-dd" string; `null` if empty or not a real date. */
+export declare const dateFromInputValue: (value: string | null | undefined) => Date | null;
+/** "yyyy-mm-dd" of a local `Date`; "" for none or an invalid date. */
+export declare const inputValueFromDate: (date: Date | null | undefined) => string;
+/** Local `Date` of a "yyyy-mm-ddThh:mm" string (`datetime-local` format); `null` if empty or invalid. */
+export declare const dateTimeFromInputValue: (value: string | null | undefined) => Date | null;
+/** "yyyy-mm-ddThh:mm" of a local `Date`; "" for none or an invalid date. */
+export declare const inputValueFromDateTime: (date: Date | null | undefined) => string;

package/.medusa/server/src/admin/admin-components/shared/lib/date-input.js

@@ -0,0 +1,43 @@
+/**
+ * Conversion between the `yyyy-mm-dd` / `yyyy-mm-ddThh:mm` strings that
+ * callers keep as state and the `Date` values of the `DatePicker`. The
+ * `DatePicker` reads and emits local dates (local getters, local midnight), so
+ * these helpers are always local; a calendar-date string stays the same day
+ * regardless of the time zone.
+ */
+const DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+const DATE_TIME_PATTERN = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})$/;
+const pad = (value, length = 2) => String(value).padStart(length, "0");
+const build = ([year, month, day, hour = 0, minute = 0]) => {
+    const date = new Date(year, month - 1, day, hour, minute);
+    const matches = date.getFullYear() === year &&
+        date.getMonth() === month - 1 &&
+        date.getDate() === day &&
+        date.getHours() === hour &&
+        date.getMinutes() === minute;
+    return matches ? date : null;
+};
+/** Local `Date` at midnight of a "yyyy-mm-dd" string; `null` if empty or not a real date. */
+export const dateFromInputValue = (value) => {
+    const match = value ? DATE_PATTERN.exec(value) : null;
+    return match ? build(match.slice(1).map(Number)) : null;
+};
+/** "yyyy-mm-dd" of a local `Date`; "" for none or an invalid date. */
+export const inputValueFromDate = (date) => {
+    if (!date || Number.isNaN(date.getTime())) {
+        return "";
+    }
+    return `${pad(date.getFullYear(), 4)}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+};
+/** Local `Date` of a "yyyy-mm-ddThh:mm" string (`datetime-local` format); `null` if empty or invalid. */
+export const dateTimeFromInputValue = (value) => {
+    const match = value ? DATE_TIME_PATTERN.exec(value) : null;
+    return match ? build(match.slice(1).map(Number)) : null;
+};
+/** "yyyy-mm-ddThh:mm" of a local `Date`; "" for none or an invalid date. */
+export const inputValueFromDateTime = (date) => {
+    if (!date || Number.isNaN(date.getTime())) {
+        return "";
+    }
+    return `${inputValueFromDate(date)}T${pad(date.getHours())}:${pad(date.getMinutes())}`;
+};

package/.medusa/server/src/admin/admin-components/shared/lib/errors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts a human-readable message from an unknown thrown value / failed
+ * response. Returns `undefined` when nothing usable is found so callers can
+ * fall back to a localized "unknown error" string instead of a hard-coded one.
+ * With a `fallback` argument the result is always a string.
+ */
+export declare function getErrorMessage(error: unknown): string | undefined;
+export declare function getErrorMessage(error: unknown, fallback: string): string;
+export declare function getErrorMessage(error: unknown, fallback?: string): string | undefined;

package/{dist/admin-components → .medusa/server/src/admin/admin-components/shared}/lib/errors.js

@@ -1,9 +1,7 @@
-/**
- * Extracts a human-readable message from an unknown thrown value / failed
- * response. Returns `undefined` when nothing usable is found so callers can
- * fall back to a localized "unknown error" string instead of a hard-coded one.
- */
-export const getErrorMessage = (error) => {
+export function getErrorMessage(error, fallback) {
+    return extractErrorMessage(error) ?? fallback;
+}
+const extractErrorMessage = (error) => {
     if (error instanceof Error && error.message) {
         return error.message;
     }

package/.medusa/server/src/admin/admin-components/shared/lib/file-validation.d.ts

@@ -0,0 +1,24 @@
+type FileSelection = {
+    name: string;
+    size: number;
+    type: string;
+};
+type FileValidationOptions = {
+    maxBytes: number;
+    /** Allowed MIME types. */
+    types: string[];
+    /**
+     * Allowed file extensions incl. dot (`".pdf"`). When set, the name must end
+     * with one of them and an empty MIME type is tolerated (browsers often do
+     * not know it); without it the MIME type must match exactly.
+     */
+    extensions?: string[];
+    messages: {
+        wrongType: string;
+        empty: string;
+        tooLarge: string;
+    };
+};
+/** Why `file` is not acceptable (German message from `messages`); `null` = valid. */
+export declare const validateFile: (file: FileSelection, { maxBytes, types, extensions, messages }: FileValidationOptions) => string | null;
+export {};

package/.medusa/server/src/admin/admin-components/shared/lib/file-validation.js

@@ -0,0 +1,18 @@
+/** Why `file` is not acceptable (German message from `messages`); `null` = valid. */
+export const validateFile = (file, { maxBytes, types, extensions, messages }) => {
+    const typeMatches = extensions
+        ? file.type === "" || types.includes(file.type)
+        : types.includes(file.type);
+    const name = file.name.toLowerCase();
+    const extensionMatches = !extensions || extensions.some((extension) => name.endsWith(extension));
+    if (!typeMatches || !extensionMatches) {
+        return messages.wrongType;
+    }
+    if (file.size === 0) {
+        return messages.empty;
+    }
+    if (file.size > maxBytes) {
+        return messages.tooLarge;
+    }
+    return null;
+};

package/.medusa/server/src/admin/admin-components/shared/lib/format.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The Admin surface of the Hartl Services plugins is German-only even though
+ * Medusa Admin supports runtime language selection. All `Intl` formatting is
+ * pinned to this locale so it matches the bundled German texts.
+ */
+export declare const ADMIN_LOCALE = "de-AT";
+/** Shown for a missing or unparsable value. */
+export declare const ADMIN_DASH = "-";
+export type FormatDateOptions = {
+    /**
+     * Format in UTC. Use it for values stored at UTC midnight (e.g. batch
+     * expiry dates); otherwise viewers west of UTC see the previous day.
+     */
+    timeZone?: "UTC";
+};
+/** "09.10.2026"; `ADMIN_DASH` for an empty or invalid value. */
+export declare const formatDate: (value: string | number | Date | null | undefined, options?: FormatDateOptions) => string;
+/** "09.10.2026, 12:30"; `ADMIN_DASH` for an empty or invalid value. */
+export declare const formatDateTime: (value: string | number | Date | null | undefined, options?: FormatDateOptions) => string;
+/**
+ * "€ 20,00" for the given ISO 4217 code (any case). `ADMIN_DASH` without an
+ * amount; "20 XYZ" (raw amount and upper-case code) when the amount is not a
+ * number or the code is unknown to `Intl`.
+ */
+export declare const formatAmount: (amount: number | string | null | undefined, currencyCode: string) => string;
+/**
+ * Today as `yyyy-mm-dd` for `<input type="date">`. By default the viewer's
+ * local day; `utc: true` for values that are stored at UTC midnight.
+ */
+export declare const getTodayInputDate: (options?: {
+    utc?: boolean;
+}) => string;

package/.medusa/server/src/admin/admin-components/shared/lib/format.js

@@ -0,0 +1,77 @@
+/**
+ * The Admin surface of the Hartl Services plugins is German-only even though
+ * Medusa Admin supports runtime language selection. All `Intl` formatting is
+ * pinned to this locale so it matches the bundled German texts.
+ */
+export const ADMIN_LOCALE = "de-AT";
+/** Shown for a missing or unparsable value. */
+export const ADMIN_DASH = "-";
+const toDate = (value) => {
+    if (value === null || value === undefined || value === "") {
+        return null;
+    }
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? null : date;
+};
+/** "09.10.2026"; `ADMIN_DASH` for an empty or invalid value. */
+export const formatDate = (value, options = {}) => {
+    const date = toDate(value);
+    return date
+        ? new Intl.DateTimeFormat(ADMIN_LOCALE, {
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            ...(options.timeZone ? { timeZone: options.timeZone } : {}),
+        }).format(date)
+        : ADMIN_DASH;
+};
+/** "09.10.2026, 12:30"; `ADMIN_DASH` for an empty or invalid value. */
+export const formatDateTime = (value, options = {}) => {
+    const date = toDate(value);
+    return date
+        ? new Intl.DateTimeFormat(ADMIN_LOCALE, {
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            ...(options.timeZone ? { timeZone: options.timeZone } : {}),
+        }).format(date)
+        : ADMIN_DASH;
+};
+/**
+ * "€ 20,00" for the given ISO 4217 code (any case). `ADMIN_DASH` without an
+ * amount; "20 XYZ" (raw amount and upper-case code) when the amount is not a
+ * number or the code is unknown to `Intl`.
+ */
+export const formatAmount = (amount, currencyCode) => {
+    if (amount === null || amount === undefined || amount === "") {
+        return ADMIN_DASH;
+    }
+    const code = currencyCode.toUpperCase();
+    const value = Number(amount);
+    if (!Number.isFinite(value)) {
+        return `${amount} ${code}`;
+    }
+    try {
+        return new Intl.NumberFormat(ADMIN_LOCALE, {
+            style: "currency",
+            currency: code,
+        }).format(value);
+    }
+    catch {
+        return `${amount} ${code}`;
+    }
+};
+/**
+ * Today as `yyyy-mm-dd` for `<input type="date">`. By default the viewer's
+ * local day; `utc: true` for values that are stored at UTC midnight.
+ */
+export const getTodayInputDate = (options = {}) => {
+    const now = new Date();
+    if (options.utc) {
+        return now.toISOString().slice(0, 10);
+    }
+    const timezoneOffsetMs = now.getTimezoneOffset() * 60 * 1000;
+    return new Date(now.getTime() - timezoneOffsetMs).toISOString().slice(0, 10);
+};

package/.medusa/server/src/admin/admin-components/shared/lib/pdf-preview.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pure bookkeeping of `usePdfPreview`: the object URL currently shown and a
+ * request counter, so a response that arrives after the preview was closed or
+ * replaced is discarded (and its object URL revoked).
+ */
+export type PdfPreviewTracker = {
+    /** Starts a request: revokes the shown URL and returns its id. */
+    begin: () => number;
+    /** Takes over `url` if `requestId` is still the latest, else revokes it. */
+    accept: (requestId: number, url: string) => boolean;
+    /** True while `requestId` is the latest request. */
+    isCurrent: (requestId: number) => boolean;
+    /** Invalidates pending requests and revokes the shown URL. */
+    reset: () => void;
+};
+export declare const createPdfPreviewTracker: (revoke?: (url: string) => void) => PdfPreviewTracker;

package/.medusa/server/src/admin/admin-components/shared/lib/pdf-preview.js

@@ -0,0 +1,31 @@
+export const createPdfPreviewTracker = (revoke = (url) => URL.revokeObjectURL(url)) => {
+    let latest = 0;
+    let current = null;
+    const release = () => {
+        if (current) {
+            revoke(current);
+            current = null;
+        }
+    };
+    return {
+        begin: () => {
+            release();
+            latest += 1;
+            return latest;
+        },
+        accept: (requestId, url) => {
+            if (requestId !== latest) {
+                revoke(url);
+                return false;
+            }
+            release();
+            current = url;
+            return true;
+        },
+        isCurrent: (requestId) => requestId === latest,
+        reset: () => {
+            latest += 1;
+            release();
+        },
+    };
+};

package/.medusa/server/src/admin/admin-components/shared/lib/pdf.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fetches a PDF through the SDK, which adds the Admin session or bearer token
+ * (so it works for both supported Admin auth modes), and returns an object
+ * URL for an `<iframe>`. The caller must `URL.revokeObjectURL` it.
+ */
+export declare const fetchPdfObjectUrl: (path: string) => Promise<string>;

package/.medusa/server/src/admin/admin-components/shared/lib/pdf.js

@@ -0,0 +1,13 @@
+import { sdk } from "./sdk";
+/**
+ * Fetches a PDF through the SDK, which adds the Admin session or bearer token
+ * (so it works for both supported Admin auth modes), and returns an object
+ * URL for an `<iframe>`. The caller must `URL.revokeObjectURL` it.
+ */
+export const fetchPdfObjectUrl = async (path) => {
+    const response = await sdk.client.fetch(path, {
+        headers: { accept: "application/pdf" },
+    });
+    const pdf = await response.blob();
+    return URL.createObjectURL(pdf);
+};

package/.medusa/server/src/admin/admin-components/shared/lib/use-debounced-value.d.ts

@@ -0,0 +1,2 @@
+/** `value` once it has stayed unchanged for `delayMs`. */
+export declare const useDebouncedValue: <T>(value: T, delayMs: number) => T;

package/.medusa/server/src/admin/admin-components/shared/lib/use-debounced-value.js

@@ -0,0 +1,10 @@
+import { useEffect, useState } from "react";
+/** `value` once it has stayed unchanged for `delayMs`. */
+export const useDebouncedValue = (value, delayMs) => {
+    const [debounced, setDebounced] = useState(value);
+    useEffect(() => {
+        const timer = window.setTimeout(() => setDebounced(value), delayMs);
+        return () => window.clearTimeout(timer);
+    }, [value, delayMs]);
+    return debounced;
+};

package/.medusa/server/src/admin/admin-components/shared/lib/use-pdf-preview.d.ts

@@ -0,0 +1,24 @@
+export type PdfPreviewState = {
+    isOpen: boolean;
+    /** Object URL of the loaded PDF; `null` until loaded. */
+    url: string | null;
+    isLoading: boolean;
+    /** Message of a failed load. */
+    error: string | null;
+};
+/**
+ * State for a `PdfPreviewModal`. `open(load, errorMessage)` runs `load`
+ * (e.g. `fetchPdfObjectUrl(path)`) and shows the result. A response that
+ * arrives after `close()` or a newer `open()` is dropped; the object URL is
+ * revoked on close, on replacement and on unmount.
+ */
+export declare const usePdfPreview: () => {
+    open: (load: () => Promise<string>, errorMessage: string) => Promise<void>;
+    close: () => void;
+    isOpen: boolean;
+    /** Object URL of the loaded PDF; `null` until loaded. */
+    url: string | null;
+    isLoading: boolean;
+    /** Message of a failed load. */
+    error: string | null;
+};

package/.medusa/server/src/admin/admin-components/shared/lib/use-pdf-preview.js

@@ -0,0 +1,47 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { createPdfPreviewTracker } from "./pdf-preview";
+const CLOSED = {
+    isOpen: false,
+    url: null,
+    isLoading: false,
+    error: null,
+};
+/**
+ * State for a `PdfPreviewModal`. `open(load, errorMessage)` runs `load`
+ * (e.g. `fetchPdfObjectUrl(path)`) and shows the result. A response that
+ * arrives after `close()` or a newer `open()` is dropped; the object URL is
+ * revoked on close, on replacement and on unmount.
+ */
+export const usePdfPreview = () => {
+    const [state, setState] = useState(CLOSED);
+    const tracker = useRef(createPdfPreviewTracker());
+    useEffect(() => {
+        const current = tracker.current;
+        return () => current.reset();
+    }, []);
+    const open = useCallback(async (load, errorMessage) => {
+        const requestId = tracker.current.begin();
+        setState({ isOpen: true, url: null, isLoading: true, error: null });
+        try {
+            const url = await load();
+            if (tracker.current.accept(requestId, url)) {
+                setState({ isOpen: true, url, isLoading: false, error: null });
+            }
+        }
+        catch {
+            if (tracker.current.isCurrent(requestId)) {
+                setState({
+                    isOpen: true,
+                    url: null,
+                    isLoading: false,
+                    error: errorMessage,
+                });
+            }
+        }
+    }, []);
+    const close = useCallback(() => {
+        tracker.current.reset();
+        setState(CLOSED);
+    }, []);
+    return { ...state, open, close };
+};

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

@@ -0,0 +1,8 @@
+import { DatePicker } from "@medusajs/ui";
+import type { ComponentProps } from "react";
+/**
+ * DatePicker follows the dashboard user's language; the shop formats dates as de-AT everywhere.
+ * The upstream picker ignores outside `value` changes from one date to another (only a reset
+ * to empty works): a caller that must update it externally passes a `key`.
+ */
+export declare const AdminDatePicker: (props: ComponentProps<typeof DatePicker>) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { DatePicker, I18nProvider } from "@medusajs/ui";
+import { ADMIN_LOCALE } from "../lib/format";
+/**
+ * DatePicker follows the dashboard user's language; the shop formats dates as de-AT everywhere.
+ * The upstream picker ignores outside `value` changes from one date to another (only a reset
+ * to empty works): a caller that must update it externally passes a `key`.
+ */
+export const AdminDatePicker = (props) => (_jsx(I18nProvider, { locale: ADMIN_LOCALE, children: _jsx(DatePicker, { ...props }) }));

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

@@ -0,0 +1,8 @@
+type BackLinkProps = {
+    to: string;
+    /** Text after the arrow icon, e.g. "Zurück zu E-Mail". */
+    label: string;
+};
+/** Arrow + "Zurück …" link above a sub-page. */
+export declare const BackLink: ({ to, label }: BackLinkProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ArrowLongLeft } from "@medusajs/icons";
+import { Link } from "react-router-dom";
+/** Arrow + "Zurück …" link above a sub-page. */
+export const BackLink = ({ to, label }) => (_jsx("div", { children: _jsxs(Link, { to: to, className: "text-ui-fg-subtle hover:text-ui-fg-base txt-compact-small-plus inline-flex items-center gap-x-1", children: [_jsx(ArrowLongLeft, { "aria-hidden": "true" }), label] }) }));

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

@@ -0,0 +1,20 @@
+type DateRange = {
+    from: string;
+    to: string;
+};
+type DateRangeFilterProps = {
+    /** `yyyy-mm-dd` (local calendar date). */
+    from: string;
+    to: string;
+    onChange: (range: DateRange) => void;
+    fromLabel?: string;
+    toLabel?: string;
+};
+/**
+ * Two labelled date pickers ("Von" / "Bis"). Renders the two fields as a
+ * fragment, so the caller decides the layout (grid, flex row, form). The
+ * upstream picker ignores outside value changes; a caller that resets the
+ * range externally passes a `key`.
+ */
+export declare const DateRangeFilter: ({ from, to, onChange, fromLabel, toLabel, }: DateRangeFilterProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Label } from "@medusajs/ui";
+import { useId } from "react";
+import { dateFromInputValue, inputValueFromDate } from "../lib/date-input";
+import { AdminDatePicker } from "./AdminDatePicker";
+/**
+ * Two labelled date pickers ("Von" / "Bis"). Renders the two fields as a
+ * fragment, so the caller decides the layout (grid, flex row, form). The
+ * upstream picker ignores outside value changes; a caller that resets the
+ * range externally passes a `key`.
+ */
+export const DateRangeFilter = ({ from, to, onChange, fromLabel = "Von", toLabel = "Bis", }) => {
+    const id = useId();
+    const fromLabelId = `${id}-from-label`;
+    const toLabelId = `${id}-to-label`;
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "grid gap-2", children: [_jsx(Label, { id: fromLabelId, children: fromLabel }), _jsx(AdminDatePicker, { "aria-labelledby": fromLabelId, value: dateFromInputValue(from), onChange: (date) => onChange({ from: inputValueFromDate(date), to }) })] }), _jsxs("div", { className: "grid gap-2", children: [_jsx(Label, { id: toLabelId, children: toLabel }), _jsx(AdminDatePicker, { "aria-labelledby": toLabelId, value: dateFromInputValue(to), onChange: (date) => onChange({ from, to: inputValueFromDate(date) }) })] })] }));
+};

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

@@ -0,0 +1,14 @@
+type FilePickerButtonProps = {
+    /** Value of the input's `accept` attribute. */
+    accept: string;
+    label: string;
+    disabled?: boolean;
+    isLoading?: boolean;
+    /** Id of the hidden input (for a `Label htmlFor`). */
+    id?: string;
+    "aria-describedby"?: string;
+    onFileSelected: (file: File) => void;
+};
+/** Button that opens the file dialog; the native input stays hidden. */
+export declare const FilePickerButton: ({ accept, label, disabled, isLoading, id, "aria-describedby": describedBy, onFileSelected, }: FilePickerButtonProps) => import("react/jsx-runtime").JSX.Element;
+export {};