@hartl-services/medusa-base 0.4.0 → 1.1.0

package/dist/admin-components/features/plugin-features/components/ImageSettingInput.d.ts

@@ -0,0 +1,15 @@
+type ImageSettingInputProps = {
+    id: string;
+    hintId: string;
+    label: string;
+    /** Public URL of the current image; `""` = none. */
+    value: string;
+    disabled: boolean;
+    onChange: (url: string) => void;
+};
+/**
+ * Uploads an image to the public File Module storage and hands its URL to
+ * the settings draft; the form stores it on save like any other value.
+ */
+export declare const ImageSettingInput: ({ id, hintId, label, value, disabled, onChange, }: ImageSettingInputProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin-components/features/plugin-features/components/ImageSettingInput.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Hint, Text } from "@medusajs/ui";
+import { useMutation } from "@tanstack/react-query";
+import { useRef, useState } from "react";
+import { texts } from "../../../i18n/texts";
+import { sdk } from "../../../lib/sdk";
+import { validateSettingImage } from "../lib/image-upload";
+/**
+ * Uploads an image to the public File Module storage and hands its URL to
+ * the settings draft; the form stores it on save like any other value.
+ */
+export const ImageSettingInput = ({ id, hintId, label, value, disabled, onChange, }) => {
+    const fileInput = useRef(null);
+    const [error, setError] = useState(null);
+    const upload = useMutation({
+        mutationFn: async (file) => {
+            const { files } = await sdk.admin.upload.create({ files: [file] });
+            const url = files[0]?.url;
+            if (!url) {
+                throw new Error("upload returned no file");
+            }
+            return url;
+        },
+        onSuccess: (url) => onChange(url),
+        onError: () => setError(texts.settings.imageUploadFailed),
+    });
+    const busy = disabled || upload.isPending;
+    const selectFile = (file) => {
+        if (!file) {
+            return;
+        }
+        const invalid = validateSettingImage(file);
+        setError(invalid);
+        if (!invalid) {
+            upload.mutate(file);
+        }
+    };
+    return (_jsxs("div", { className: "grid gap-2", children: [value && (_jsx("div", { className: "bg-ui-bg-subtle flex items-center justify-center rounded-md border p-4", children: _jsx("img", { src: value, alt: texts.settings.imagePreviewAlt(label), className: "max-h-24 max-w-full object-contain" }) })), _jsx("input", { ref: fileInput, id: id, "aria-describedby": hintId, type: "file", accept: "image/png,image/jpeg", className: "hidden", onChange: (event) => {
+                    selectFile(event.target.files?.[0]);
+                    event.target.value = "";
+                } }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { type: "button", size: "small", variant: "secondary", isLoading: upload.isPending, disabled: busy, onClick: () => fileInput.current?.click(), children: value ? texts.settings.imageReplace : texts.settings.imageUpload }), value && (_jsx(Button, { type: "button", size: "small", variant: "transparent", disabled: busy, onClick: () => onChange(""), children: texts.settings.imageRemove })), !value && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.imageNone }))] }), error && _jsx(Hint, { variant: "error", children: error })] }));
+};

package/dist/admin-components/features/plugin-features/components/PluginSettingsForm.js

@@ -2,6 +2,7 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 import { Alert, Button, Container, Heading, Hint, Input, Label, Select, Switch, Text, } from "@medusajs/ui";
 import { texts } from "../../../i18n/texts";
 import { usePluginSettingsForm } from "../hooks/usePluginSettingsForm";
+import { ImageSettingInput } from "./ImageSettingInput";
 const fieldId = (pluginKey, key) => `plugin-setting-${pluginKey}-${key}`;
 export const missingLabels = (plugin) => plugin.missing
     .map((key) => plugin.settings.find((setting) => setting.key === key)?.label ?? key)
@@ -27,13 +28,14 @@ const SettingField = ({ pluginKey, setting, invalidatesLabels, value, invalid, d
                             ? texts.settings.secretClearUndoLabel(setting.label)
                             : texts.settings.secretClearLabel(setting.label), onClick: () => onChange(clearPending ? "" : null), children: clearPending
                             ? texts.settings.secretClearUndo
-                            : texts.settings.secretClear }))] })) : setting.type === "select" ? (_jsxs(Select, { value: typeof value === "string" ? value : "", disabled: disabled, onValueChange: (next) => onChange(next), children: [_jsx(Select.Trigger, { id: id, "aria-describedby": hintId, children: _jsx(Select.Value, { placeholder: texts.settings.selectPlaceholder }) }), _jsx(Select.Content, { children: setting.options.map((option) => (_jsx(Select.Item, { value: option.value, children: option.label }, option.value))) })] })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: "number", step: "any", min: setting.min ?? undefined, max: setting.max ?? undefined, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: setting.type === "url" ? "url" : "text", value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), _jsxs("div", { id: hintId, className: "grid gap-1", children: [setting.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: setting.description })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatesLabels && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.invalidates(invalidatesLabels) })), bounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: bounds ?? texts.settings.invalidNumber }))] })] }));
+                            : texts.settings.secretClear }))] })) : setting.type === "select" ? (_jsxs(Select, { value: typeof value === "string" ? value : "", disabled: disabled, onValueChange: (next) => onChange(next), children: [_jsx(Select.Trigger, { id: id, "aria-describedby": hintId, children: _jsx(Select.Value, { placeholder: texts.settings.selectPlaceholder }) }), _jsx(Select.Content, { children: setting.options.map((option) => (_jsx(Select.Item, { value: option.value, children: option.label }, option.value))) })] })) : setting.type === "image" ? (_jsx(ImageSettingInput, { id: id, hintId: hintId, label: setting.label, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (url) => onChange(url) })) : setting.type === "number" ? (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: "number", step: "any", min: setting.min ?? undefined, max: setting.max ?? undefined, value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value, event.target.validity.badInput) })) : (_jsx(Input, { id: id, "aria-describedby": hintId, "aria-invalid": invalid, type: setting.type === "url" ? "url" : "text", value: typeof value === "string" ? value : "", disabled: disabled, onChange: (event) => onChange(event.target.value) })), _jsxs("div", { id: hintId, className: "grid gap-1", children: [setting.description && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: setting.description })), clearPending && (_jsx(Hint, { variant: "info", children: texts.settings.secretClearPending })), invalidatesLabels && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: texts.settings.invalidates(invalidatesLabels) })), bounds && !invalid && (_jsx(Text, { size: "small", className: "text-ui-fg-muted", children: bounds })), invalid && (_jsx(Hint, { variant: "error", children: bounds ?? texts.settings.invalidNumber }))] })] }));
 };
 export const PluginSettingsForm = ({ plugin }) => {
     const form = usePluginSettingsForm(plugin);
     const pending = form.mutation.isPending;
     const hasTextFields = plugin.settings.some((setting) => setting.type !== "boolean" &&
         setting.type !== "secret" &&
-        setting.type !== "select");
+        setting.type !== "select" &&
+        setting.type !== "image");
     return (_jsxs(Container, { className: "divide-y p-0", "aria-busy": pending, children: [_jsxs("div", { className: "px-6 py-4", children: [_jsx(Heading, { level: "h2", children: texts.sections.settings }), hasTextFields && (_jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: texts.settings.clearHint }))] }), _jsxs("form", { onSubmit: form.submit, className: "grid gap-5 px-6 py-5", children: [!plugin.configured && (_jsx(Alert, { variant: "warning", children: texts.settings.missing(missingLabels(plugin)) })), plugin.settings.map((setting) => (_jsx(SettingField, { pluginKey: plugin.plugin_key, setting: setting, invalidatesLabels: invalidatesLabels(plugin, setting), value: form.draft[setting.key], invalid: form.invalid.includes(setting.key), disabled: pending, onChange: (value, badInput) => form.setValue(setting.key, value, badInput) }, setting.key))), _jsx("div", { className: "flex justify-end", children: _jsx(Button, { type: "submit", size: "small", isLoading: pending, disabled: !form.dirty || form.invalid.length > 0 || pending, children: texts.settings.save }) })] })] }));
 };

package/dist/admin-components/features/plugin-features/hooks/usePluginFeatureEnabled.d.ts

@@ -74,7 +74,7 @@ export declare const pluginFeatureEnabledQueryOptions: (pluginKey: string, featu
                 source: "default" | "stored" | "config" | "none";
                 invalidates: string[];
             } | {
-                type: "string" | "boolean" | "url";
+                type: "string" | "boolean" | "url" | "image";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;

package/dist/admin-components/features/plugin-features/hooks/usePluginFeatures.d.ts

@@ -54,7 +54,7 @@ export declare function usePluginFeatures(): import("@tanstack/react-query").Use
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -141,7 +141,7 @@ export declare function usePluginFeature(pluginKey: string | undefined): import(
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -222,7 +222,7 @@ export declare function useUpdatePluginFeatures(): import("@tanstack/react-query
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -307,7 +307,7 @@ export declare function useUpdatePluginSettings(pluginKey: string): import("@tan
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;

package/dist/admin-components/features/plugin-features/hooks/usePluginSettingsForm.d.ts

@@ -63,7 +63,7 @@ export declare function usePluginSettingsForm(plugin: AdminPluginFeatures): {
                 source: "default" | "stored" | "config" | "none";
                 invalidates: string[];
             } | {
-                type: "string" | "boolean" | "url";
+                type: "string" | "boolean" | "url" | "image";
                 default: string | number | boolean | null;
                 value: string | number | boolean | null;
                 key: string;

package/dist/admin-components/features/plugin-features/lib/image-upload.d.ts

@@ -0,0 +1,6 @@
+/** Largest image an `image` setting accepts in the Admin. */
+export declare const SETTING_IMAGE_MAX_BYTES: number;
+type ImageSelection = Pick<File, "size" | "type">;
+/** Why `file` cannot be uploaded for an `image` setting; `null` = valid. */
+export declare const validateSettingImage: (file: ImageSelection) => string | null;
+export {};

package/dist/admin-components/features/plugin-features/lib/image-upload.js

@@ -0,0 +1,17 @@
+/** Largest image an `image` setting accepts in the Admin. */
+export const SETTING_IMAGE_MAX_BYTES = 2 * 1024 * 1024;
+// Gmail and Outlook do not display SVG or WebP in e-mails.
+const IMAGE_TYPES = new Set(["image/png", "image/jpeg"]);
+/** Why `file` cannot be uploaded for an `image` setting; `null` = valid. */
+export const validateSettingImage = (file) => {
+    if (!IMAGE_TYPES.has(file.type)) {
+        return "Bitte eine PNG- oder JPG-Datei auswählen.";
+    }
+    if (file.size === 0) {
+        return "Die Bilddatei ist leer.";
+    }
+    if (file.size > SETTING_IMAGE_MAX_BYTES) {
+        return "Die Bilddatei darf maximal 2 MiB groß sein.";
+    }
+    return null;
+};

package/dist/admin-components/features/plugin-features/lib/plugin-features-admin-client.d.ts

@@ -55,7 +55,7 @@ export declare const listPluginFeatures: () => Promise<{
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -135,7 +135,7 @@ export declare const retrievePluginFeatures: (pluginKey: string) => Promise<{
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -215,7 +215,7 @@ export declare const updatePluginFeatures: (payload: UpdatePluginFeaturesPayload
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;
@@ -295,7 +295,7 @@ export declare const updatePluginSettings: (pluginKey: string, payload: UpdatePl
             source: "default" | "stored" | "config" | "none";
             invalidates: string[];
         } | {
-            type: "string" | "boolean" | "url";
+            type: "string" | "boolean" | "url" | "image";
             default: string | number | boolean | null;
             value: string | number | boolean | null;
             key: string;

package/dist/admin-components/i18n/texts.d.ts

@@ -59,6 +59,12 @@ export declare const texts: {
         numberMax: (max: number) => string;
         numberRange: (min: number, max: number) => string;
         selectPlaceholder: string;
+        imageUpload: string;
+        imageReplace: string;
+        imageRemove: string;
+        imageNone: string;
+        imageUploadFailed: string;
+        imagePreviewAlt: (label: string) => string;
         clearHint: string;
         source: {
             stored: string;

package/dist/admin-components/i18n/texts.js

@@ -59,6 +59,12 @@ export const texts = {
         numberMax: (max) => `Höchstens ${max}.`,
         numberRange: (min, max) => `Zwischen ${min} und ${max}.`,
         selectPlaceholder: "Bitte auswählen",
+        imageUpload: "Bild hochladen",
+        imageReplace: "Anderes Bild hochladen",
+        imageRemove: "Entfernen",
+        imageNone: "Kein Bild hinterlegt",
+        imageUploadFailed: "Das Bild konnte nicht hochgeladen werden.",
+        imagePreviewAlt: (label) => `Vorschau ${label}`,
         clearHint: "Ein leeres Feld speichern entfernt den gespeicherten Wert (dann gilt Konfiguration oder Standard).",
         source: {
             stored: "gespeichert",

package/dist/documents/config/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Documents part of the `@hartl-services/medusa-base/config` entry point: values a shop
+ * needs in `medusa-config.ts` or in a test, without loading the plugin itself.
+ */
+export { createDefaultDocumentHtmlFactory } from "../templates/html-factory";
+/**
+ * Placeholder environment values for `medusa build`. `medusa-config.ts` is
+ * evaluated at build time, where the runtime-only Documents PDF executable
+ * is not set; spread these under the real environment during the build.
+ */
+export declare const DOCUMENTS_BUILD_PLACEHOLDERS: Readonly<Record<string, string>>;

package/dist/documents/config/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOCUMENTS_BUILD_PLACEHOLDERS = exports.createDefaultDocumentHtmlFactory = void 0;
+/**
+ * Documents part of the `@hartl-services/medusa-base/config` entry point: values a shop
+ * needs in `medusa-config.ts` or in a test, without loading the plugin itself.
+ */
+var html_factory_1 = require("../templates/html-factory");
+Object.defineProperty(exports, "createDefaultDocumentHtmlFactory", { enumerable: true, get: function () { return html_factory_1.createDefaultDocumentHtmlFactory; } });
+/**
+ * Placeholder environment values for `medusa build`. `medusa-config.ts` is
+ * evaluated at build time, where the runtime-only Documents PDF executable
+ * is not set; spread these under the real environment during the build.
+ */
+exports.DOCUMENTS_BUILD_PLACEHOLDERS = {
+    DOCUMENT_PDF_EXECUTABLE: "google-chrome",
+};

package/dist/documents/templates/financial-document.d.ts

@@ -0,0 +1,3 @@
+import type { FinancialDocumentRenderInput } from "../types";
+import { type DocumentLayout } from "./layout";
+export declare const renderFinancialDocument: (input: FinancialDocumentRenderInput, layout: DocumentLayout, timeZone: string) => string;

package/dist/documents/templates/financial-document.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderFinancialDocument = void 0;
+const format_1 = require("./format");
+const html_utils_1 = require("./html-utils");
+const layout_1 = require("./layout");
+const labelsByKind = {
+    cancellation: {
+        number: "Stornonummer",
+        title: "Stornorechnung",
+    },
+    credit_note: {
+        number: "Gutschriftnummer",
+        title: "Gutschrift",
+    },
+    invoice: {
+        number: "Rechnungsnummer",
+        title: "Rechnung",
+    },
+};
+const renderAddress = (input) => {
+    const address = input.order.billing_address;
+    if (!address) {
+        return (0, html_utils_1.escapeHtml)(input.order.email);
+    }
+    return [
+        address.company,
+        [address.first_name, address.last_name]
+            .filter((part) => Boolean(part))
+            .join(" "),
+        address.address_1,
+        address.address_2,
+        [address.postal_code, address.city]
+            .filter((part) => Boolean(part))
+            .join(" "),
+        address.country_code ? (0, layout_1.formatCountryName)(address.country_code) : null,
+    ]
+        .filter((part) => Boolean(part))
+        .map(html_utils_1.escapeHtml)
+        .join("<br />");
+};
+/** "Charge: L-1, MHD: 30.06.2027"; the quantity only when a line has several batches. */
+const renderBatchDetails = (line, timeZone) => {
+    const showQuantity = line.batch_allocations.length > 1;
+    return line.batch_allocations
+        .map((allocation) => {
+        const parts = [
+            `Charge: ${allocation.lot_number}`,
+            `MHD: ${(0, format_1.formatDocumentDate)(allocation.expiry_date, timeZone)}`,
+            showQuantity ? `Menge: ${allocation.quantity}` : null,
+        ].filter((part) => Boolean(part));
+        return `<div class="batch">${(0, html_utils_1.escapeHtml)(parts.join(", "))}</div>`;
+    })
+        .join("");
+};
+const renderLines = (input, timeZone) => input.lines
+    .map((line) => `<tr>
+        <td class="item">
+          <div class="item-title">${(0, html_utils_1.escapeHtml)(line.title)}</div>
+          ${line.sku ? `<div class="sku">SKU: ${(0, html_utils_1.escapeHtml)(line.sku)}</div>` : ""}
+          ${renderBatchDetails(line, timeZone)}
+        </td>
+        <td class="number quantity">${(0, html_utils_1.escapeHtml)(line.quantity)}</td>
+        <td class="number">${(0, html_utils_1.renderMoney)(line.unit_price)}</td>
+        <td class="number">${(0, html_utils_1.renderMoney)(line.total)}</td>
+      </tr>`)
+    .join("");
+const isExemptIntraCommunitySupply = (input) => input.order.tax_compliance?.exemption_wording ===
+    "steuerfreie_innergemeinschaftliche_lieferung";
+const renderTaxCompliance = (input) => {
+    const evidence = input.order.tax_compliance;
+    if (!evidence || !isExemptIntraCommunitySupply(input)) {
+        return "";
+    }
+    return `<section class="tax-compliance">
+      <h2>Steuerliche Angaben</h2>
+      <strong>${(0, html_utils_1.escapeHtml)(evidence.customer_company_name)}</strong><br />
+      UID des Kunden: ${(0, html_utils_1.escapeHtml)(evidence.customer_vat_number)}<br />
+      Steuerfreie innergemeinschaftliche Lieferung
+    </section>`;
+};
+const renderDiscountTotal = (input) => {
+    const discount = input.totals.discount_total;
+    const displayAmount = input.document.kind === "invoice" && Number(discount.amount) > 0
+        ? `-${discount.amount}`
+        : discount.amount;
+    return (0, html_utils_1.renderMoney)(discount, displayAmount);
+};
+const formatTaxRate = (rate) => new Intl.NumberFormat(format_1.DEFAULT_FORMAT_LOCALE, {
+    maximumFractionDigits: 2,
+    style: "percent",
+}).format(rate / 100);
+/** One totals row below the Menge/Einzelpreis columns; the amount sits under "Summe". */
+const renderTotalRow = (label, value, className) => `<tr${className ? ` class="${className}"` : ""}><td class="spacer"></td><td class="label" colspan="2">${(0, html_utils_1.escapeHtml)(label)}</td><td class="number">${value}</td></tr>`;
+const renderTaxRows = (input) => {
+    const { tax_breakdown: breakdown, tax_total: taxTotal } = input.totals;
+    const rows = breakdown.length > 0
+        ? breakdown.map((entry) => ({
+            label: `${entry.name} ${formatTaxRate(entry.rate)}`,
+            money: entry.tax_total,
+        }))
+        : [{ label: "Umsatzsteuer", money: taxTotal }];
+    return rows
+        .map(({ label, money }) => renderTotalRow(label, (0, html_utils_1.renderMoney)(money)))
+        .join("");
+};
+/** Only invoices ask for payment; cancellations and credit notes do not. */
+const renderPaymentTerms = (input) => input.document.kind === "invoice" && input.settings.payment_terms
+    ? `<section class="payment-terms">${(0, html_utils_1.escapeHtml)(input.settings.payment_terms)}</section>`
+    : "";
+const renderFinancialDocument = (input, layout, timeZone) => {
+    const labels = labelsByKind[input.document.kind];
+    const metadata = [
+        { label: labels.number, value: input.document.number },
+        {
+            label: "Bestellung",
+            value: (0, html_utils_1.formatOrderReference)(input.order.display_id),
+        },
+    ];
+    if (input.document.kind !== "invoice") {
+        metadata.push({
+            label: "Ursprungsrechnung",
+            value: input.document.source_document_number ?? "-",
+        });
+    }
+    if (input.order.tax_compliance && isExemptIntraCommunitySupply(input)) {
+        metadata.push({
+            label: "Kunden-UID",
+            value: input.order.tax_compliance.customer_vat_number,
+        });
+    }
+    metadata.push({
+        label: "Datum",
+        value: (0, format_1.formatDocumentDate)(input.document.issued_at, timeZone),
+    });
+    const { totals } = input;
+    const body = `<table class="items financial-items">
+      <thead><tr><th class="item">Artikel</th><th class="number quantity">Menge</th><th class="number">Einzelpreis</th><th class="number">Summe</th></tr></thead>
+      <tbody class="lines">${renderLines(input, timeZone)}</tbody>
+      <tbody class="totals">
+        ${renderTotalRow("Zwischensumme", (0, html_utils_1.renderMoney)(totals.subtotal))}
+        ${renderTotalRow("Versand", (0, html_utils_1.renderMoney)(totals.shipping_total))}
+        ${renderTotalRow("Rabatt", renderDiscountTotal(input))}
+        ${renderTaxRows(input)}
+        ${renderTotalRow("Gesamt", (0, html_utils_1.renderMoney)(totals.total), "grand-total")}
+      </tbody>
+    </table>
+    ${renderTaxCompliance(input)}
+    ${renderPaymentTerms(input)}`;
+    return layout({
+        body,
+        documentTitle: labels.title,
+        metadata,
+        number: input.document.number,
+        pageTitle: labels.title,
+        recipient: renderAddress(input),
+    });
+};
+exports.renderFinancialDocument = renderFinancialDocument;

package/dist/documents/templates/format.d.ts

@@ -0,0 +1,30 @@
+export declare const DEFAULT_FORMAT_LOCALE = "de-AT";
+export type FormatMoneyInput = {
+    readonly amount: number | string;
+    readonly currencyCode: string;
+};
+export type FormatMoneyOptions = {
+    readonly locale?: Intl.LocalesArgument;
+};
+export declare const formatMoney: ({ amount, currencyCode }: FormatMoneyInput, { locale }?: FormatMoneyOptions) => string;
+export type FormatDateOptions = {
+    readonly locale?: Intl.LocalesArgument;
+    /** IANA time zone the date is shown in; there is deliberately no default. */
+    readonly timeZone: string;
+    readonly options?: Omit<Intl.DateTimeFormatOptions, "timeZone">;
+};
+export declare const formatDate: (value: string | Date, { locale, options, timeZone }: FormatDateOptions) => string;
+export type MoneyParts = {
+    /** Currency symbol or code; empty when the amount could not be formatted. */
+    readonly currency: string;
+    /** Signed, localized number without the currency. */
+    readonly amount: string;
+};
+/**
+ * `formatMoney` split into currency and number, so a template can align the
+ * currency and the amount separately. Falls back to the whole
+ * `formatMoney` text as `amount`.
+ */
+export declare const formatMoneyParts: ({ amount, currencyCode }: FormatMoneyInput, { locale }?: FormatMoneyOptions) => MoneyParts;
+/** A document date as "01.01.2027" in the given time zone. */
+export declare const formatDocumentDate: (value: string | Date, timeZone: string) => string;

package/dist/documents/templates/format.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDocumentDate = exports.formatMoneyParts = exports.formatDate = exports.formatMoney = exports.DEFAULT_FORMAT_LOCALE = void 0;
+exports.DEFAULT_FORMAT_LOCALE = "de-AT";
+const formatMoney = ({ amount, currencyCode }, { locale = exports.DEFAULT_FORMAT_LOCALE } = {}) => {
+    const numericAmount = Number(amount);
+    const normalizedCurrencyCode = currencyCode.toUpperCase();
+    const fallback = `${String(amount)} ${normalizedCurrencyCode}`;
+    if (!Number.isFinite(numericAmount)) {
+        return fallback;
+    }
+    try {
+        return new Intl.NumberFormat(locale, {
+            currency: normalizedCurrencyCode,
+            style: "currency",
+        }).format(numericAmount);
+    }
+    catch {
+        return fallback;
+    }
+};
+exports.formatMoney = formatMoney;
+const formatDate = (value, { locale = exports.DEFAULT_FORMAT_LOCALE, options, timeZone }) => {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return String(value);
+    }
+    return new Intl.DateTimeFormat(locale, { timeZone, ...options }).format(date);
+};
+exports.formatDate = formatDate;
+/**
+ * `formatMoney` split into currency and number, so a template can align the
+ * currency and the amount separately. Falls back to the whole
+ * `formatMoney` text as `amount`.
+ */
+const formatMoneyParts = ({ amount, currencyCode }, { locale = exports.DEFAULT_FORMAT_LOCALE } = {}) => {
+    const numericAmount = Number(amount);
+    const fallback = {
+        currency: "",
+        amount: (0, exports.formatMoney)({ amount, currencyCode }, { locale }),
+    };
+    if (!Number.isFinite(numericAmount)) {
+        return fallback;
+    }
+    try {
+        const parts = new Intl.NumberFormat(locale, {
+            currency: currencyCode.toUpperCase(),
+            style: "currency",
+        }).formatToParts(numericAmount);
+        return {
+            currency: parts
+                .filter((part) => part.type === "currency")
+                .map((part) => part.value)
+                .join(""),
+            amount: parts
+                .filter((part) => part.type !== "currency" &&
+                !(part.type === "literal" && !part.value.trim()))
+                .map((part) => part.value)
+                .join(""),
+        };
+    }
+    catch {
+        return fallback;
+    }
+};
+exports.formatMoneyParts = formatMoneyParts;
+/** A document date as "01.01.2027" in the given time zone. */
+const formatDocumentDate = (value, timeZone) => (0, exports.formatDate)(value, {
+    timeZone,
+    options: { day: "2-digit", month: "2-digit", year: "numeric" },
+});
+exports.formatDocumentDate = formatDocumentDate;

package/dist/documents/templates/html-factory.d.ts

@@ -0,0 +1,15 @@
+import type { DocumentHtmlFactory } from "../types";
+import { type DocumentTheme } from "./layout";
+/**
+ * The plugin's default document markup (German, locale de-AT). The legal
+ * sender comes with every render input (`input.merchant`, the base plugin's
+ * shop master data). `timeZone` is the IANA time zone in which printed dates
+ * are shown; the plugin passes its resolved `numbering.timeZone` so the date
+ * on a document matches the period its number was allocated in. `theme`
+ * adds a project's CSS and page background (watermark) on top of the default
+ * look; the logo comes from the Documents settings (`input.settings`).
+ */
+export declare const createDefaultDocumentHtmlFactory: ({ timeZone, theme, }: {
+    timeZone: string;
+    theme?: DocumentTheme;
+}) => DocumentHtmlFactory;

package/dist/documents/templates/html-factory.js

@@ -0,0 +1,41 @@
+"use strict";
+/* eslint-disable @medusajs/use-medusa-error-not-generic-error -- Invalid render inputs are programmer errors, not HTTP responses. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDefaultDocumentHtmlFactory = void 0;
+const layout_1 = require("./layout");
+const financial_document_1 = require("./financial-document");
+const packing_list_1 = require("./packing-list");
+/**
+ * The plugin's default document markup (German, locale de-AT). The legal
+ * sender comes with every render input (`input.merchant`, the base plugin's
+ * shop master data). `timeZone` is the IANA time zone in which printed dates
+ * are shown; the plugin passes its resolved `numbering.timeZone` so the date
+ * on a document matches the period its number was allocated in. `theme`
+ * adds a project's CSS and page background (watermark) on top of the default
+ * look; the logo comes from the Documents settings (`input.settings`).
+ */
+const createDefaultDocumentHtmlFactory = ({ timeZone, theme, }) => {
+    return (input) => {
+        const kind = input.document.kind;
+        switch (kind) {
+            case "invoice":
+            case "cancellation":
+            case "credit_note":
+                if ("totals" in input) {
+                    return (0, financial_document_1.renderFinancialDocument)(input, (0, layout_1.createDocumentLayout)(input.merchant, input.settings, true, theme), timeZone);
+                }
+                break;
+            case "packing_list":
+                if ("fulfillment" in input) {
+                    return (0, packing_list_1.renderPackingList)(input, (0, layout_1.createDocumentLayout)(input.merchant, input.settings, false, theme), timeZone);
+                }
+                break;
+            default: {
+                const unsupportedKind = kind;
+                throw new TypeError(`Unsupported document kind: ${unsupportedKind}`);
+            }
+        }
+        throw new TypeError(`Invalid input for document kind: ${kind}`);
+    };
+};
+exports.createDefaultDocumentHtmlFactory = createDefaultDocumentHtmlFactory;

package/dist/documents/templates/html-utils.d.ts

@@ -0,0 +1,8 @@
+import type { DocumentMoney } from "../types";
+export declare const escapeHtml: (value: string | number | null | undefined) => string;
+export declare const formatOrderReference: (displayId: number | null) => string;
+/**
+ * An amount as `<span class="money">` with separate currency and amount
+ * spans; `amount` overrides the money's own amount (e.g. a negated value).
+ */
+export declare const renderMoney: (money: DocumentMoney, amount?: string) => string;

package/dist/documents/templates/html-utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMoney = exports.formatOrderReference = exports.escapeHtml = void 0;
+const format_1 = require("./format");
+const escapeHtml = (value) => String(value ?? "")
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#039;");
+exports.escapeHtml = escapeHtml;
+const formatOrderReference = (displayId) => displayId === null ? "-" : `#${displayId}`;
+exports.formatOrderReference = formatOrderReference;
+/**
+ * An amount as `<span class="money">` with separate currency and amount
+ * spans; `amount` overrides the money's own amount (e.g. a negated value).
+ */
+const renderMoney = (money, amount = money.amount) => {
+    const parts = (0, format_1.formatMoneyParts)({ amount, currencyCode: money.currency_code });
+    return `<span class="money"><span class="currency">${(0, exports.escapeHtml)(parts.currency)}</span> <span class="amount">${(0, exports.escapeHtml)(parts.amount)}</span></span>`;
+};
+exports.renderMoney = renderMoney;