@cosmicdrift/kumiko-document-designer 0.363.0 → 0.365.0

package/dist/web/use-own-address.d.ts

@@ -0,0 +1,5 @@
+export type OwnAddress = {
+    readonly email: string | null;
+    readonly profileScreenId: string | null;
+};
+export declare function useOwnAddress(): OwnAddress;

package/dist/web/use-own-address.js

@@ -0,0 +1,14 @@
+// @runtime client
+import { useAppFeatures, useQuery } from "@cosmicdrift/kumiko-renderer";
+import { PROFILE_FEATURE_NAME, PROFILE_SCREEN_ID, USER_ME_QUERY_QN } from "../constants.js";
+export function useOwnAddress() {
+    const features = useAppFeatures();
+    const me = useQuery(USER_ME_QUERY_QN, {});
+    const email = me.data?.email;
+    const hasProfileScreen = features.some((feature) => feature.featureName === PROFILE_FEATURE_NAME &&
+        feature.screens.some((screen) => screen.id === PROFILE_SCREEN_ID));
+    return {
+        email: typeof email === "string" && email !== "" ? email : null,
+        profileScreenId: hasProfileScreen ? PROFILE_SCREEN_ID : null,
+    };
+}

package/dist/web/used-by-label.d.ts

@@ -1,5 +1,6 @@
 import type { OverviewRowView, OverviewUsageView } from "./overview-row.js";
 type Translate = (key: string, params?: Readonly<Record<string, unknown>>) => string;
+export declare function templateTitle(t: Translate, row: Pick<OverviewRowView, "title" | "slug" | "kind">): string;
 export declare function usageParts(t: Translate, usage: OverviewUsageView): {
     readonly feature: string;
     readonly notification: string;

package/dist/web/used-by-label.js

@@ -5,6 +5,17 @@ function translateOrRaw(t, key, raw) {
     const translated = t(key);
     return translated === key ? raw : translated;
 }
+const NOTIFICATION_SLUG = /^([^:]+):notify:([^:]+)$/;
+// A seeded system mail has no stored title, so its notification label from the
+// owning feature names it; the slug stays the last resort.
+export function templateTitle(t, row) {
+    if (row.title !== row.slug)
+        return row.title;
+    const match = row.kind === "mail" ? NOTIFICATION_SLUG.exec(row.slug) : null;
+    if (match === null)
+        return row.slug;
+    return usageParts(t, { feature: match[1] ?? "", notification: match[2] ?? "" }).notification;
+}
 export function usageParts(t, usage) {
     return {
         feature: translateOrRaw(t, `${usage.feature}:feature.label`, usage.feature),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-document-designer",
-  "version": "0.363.0",
+  "version": "0.365.0",
   "description": "Document designer for Kumiko: template overview, layout editor (mail layout, PDF letterhead) and the PDF template editor.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -19,13 +19,13 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.363.0",
-    "@cosmicdrift/kumiko-framework": "0.363.0",
-    "@cosmicdrift/kumiko-headless": "0.363.0",
-    "@cosmicdrift/kumiko-renderer": "0.363.0",
-    "@cosmicdrift/kumiko-renderer-puppeteer-client": "0.363.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.363.0",
-    "@cosmicdrift/kumiko-types": "0.363.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.365.0",
+    "@cosmicdrift/kumiko-framework": "0.365.0",
+    "@cosmicdrift/kumiko-headless": "0.365.0",
+    "@cosmicdrift/kumiko-renderer": "0.365.0",
+    "@cosmicdrift/kumiko-renderer-puppeteer-client": "0.365.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.365.0",
+    "@cosmicdrift/kumiko-types": "0.365.0",
     "pdfjs-dist": "6.3.289",
     "react": "^19.2.6"
   },

package/src/changes.json

@@ -1,4 +1,52 @@
 [
+  {
+    "version": "0.365.0",
+    "type": "improvement",
+    "title": "Seeded mails show readable titles and the editor opens in the UI language",
+    "detail": "A mail template without a stored title is named by its notification label (<feature>:notify.<name>.label) in the overview and the editor header instead of its slug. The mail editor opens on the UI language, or its base language, when the template has it, and falls back to the previous choice otherwise. The layout select offers the built-in standard layout when no default layout is stored, and the preview text field shows a hint while empty."
+  },
+  {
+    "version": "0.365.0",
+    "type": "fix",
+    "title": "Layout editor no longer asks for the platform override counts after a tenant save",
+    "detail": "Saving or resetting a layout as tenant admin refetched the tenant-overrides query, which only the platform admin may read, so every save logged a 403. The reload now refetches it only for the platform admin."
+  },
+  {
+    "version": "0.365.0",
+    "type": "improvement",
+    "title": "Mail editor rail edits header chip, tone and footer note",
+    "detail": "The properties rail of the mail editor has a section \"Kopf und Fuß\" with the header chip and the footer note as placeholder lines and the tone as a select (accent, info, success, warning, danger, neutral). The values are saved in the mail meta and show in the preview right away. A tone stored as placeholder stays as its own option; the accent tone is stored as no tone. template-resolver/web exports MAIL_TONES and MailTone."
+  },
+  {
+    "version": "0.365.0",
+    "type": "fix",
+    "title": "Debounced layout validation, collision-free resource keys and reload after a half-finished system publish",
+    "detail": "The layout editor sent a validate query (with an MJML compile) on every change; it now waits 400 ms after the last edit. A second upload with the same file name before the row refetch finished reused the first key; keys handed out earlier are now remembered. When a SystemAdmin saved a mail version but publishing it failed, the editor kept the old state with the error shown; it now reloads so the stored version is visible."
+  },
+  {
+    "version": "0.364.0",
+    "type": "improvement",
+    "title": "Editors and overview show an open draft beside the active version",
+    "detail": "The editor header shows the served version (Active vN) next to the open draft (Draft vM), fed by the active field of find-by-id and layout-source; the template overview shows the draftVersion badge under the status of an active row."
+  },
+  {
+    "version": "0.364.0",
+    "type": "improvement",
+    "title": "Document designer editors follow the approved board",
+    "detail": "Mail-layout templates accept appearance meta (width, font, outer background, accent line, button style) that the mail renderer applies, and the layout-source query returns it. The layout editor uses the shared editor shell with one paper and one shared toolbar (`DocumentContentEditor` gains `toolbarHost`). Mail and PDF editors share frame, info bar, rails and footer.\nThe unused `sender` key of mail template meta is gone from the editor; stored rows that still carry it are read without it, so they stay editable.\nInvalid template meta now reports per-field messages (`templateResolver.errors.template.meta.<field>.required|invalid`) instead of the parser text; the editors show them at the field. The `tenant-overrides` query additionally returns one row per customising tenant (name, status, version, changed at/by) and, with `diffTenantId`, the diff to the system version. A language without a version shows an empty state in the mail editor instead of a disabled editor.\nThe `compileDocumentBody` option `resourceImageMaxWidthPx` caps resource images in mails (180 px). The `send-test` command takes `prefixSubject` (default true) to skip the `[TEST]` subject prefix, the template preview returns `mailLayout` (slug, scope, version of the layout used), and `RenderedMail` carries the layout ref."
+  },
+  {
+    "version": "0.364.0",
+    "type": "fix",
+    "title": "PDF editor keeps unset margins unset, frees old PDF previews, and shows reset and diff errors",
+    "detail": "Setting one margin no longer stores the other three as 15 mm, so the layout's header and footer margins still apply to them. The PDF preview no longer re-renders pages or stacks text layers on re-render and destroys the previous document. A failed reset to the system version shows an error banner in the PDF and mail editors, and a failing diff query shows an error state with retry instead of loading forever. The canvas reserves the footer margin like the renderer. Page formats, orientations and default margins now come from template-resolver (new exports PDF_ORIENTATIONS, PDF_DEFAULT_MARGIN_MM, PDF_HEADER_MARGIN_MM, PDF_FOOTER_MARGIN_MM, PdfOrientation)."
+  },
+  {
+    "version": "0.364.0",
+    "type": "fix",
+    "title": "Layout editor shows the real number of mails or PDFs using a layout",
+    "detail": "The editor asks the overview for the users of one layout (kind and layoutSlug filter) and takes the count from total, so a tenant with more than 200 templates no longer sees a too low usage number."
+  },
   {
     "version": "0.363.0",
     "type": "improvement",

package/dist/web/mail-header.d.ts

@@ -1,23 +0,0 @@
-import type { ReactNode } from "react";
-import type { TemplateRowView } from "./mail-types.js";
-export type EditorMode = "edit" | "preview";
-export type HeaderActions = {
-    readonly busy: boolean;
-    readonly canSave: boolean;
-    readonly canPublish: boolean;
-    readonly onSave: () => void;
-    readonly onPublish: () => void;
-};
-export declare function MailHeader({ title, row, locales, locale, mode, testPending, actions, onBack, onLocale, onMode, onTestMail, }: {
-    readonly title: string;
-    readonly row: TemplateRowView | null;
-    readonly locales: readonly string[];
-    readonly locale: string;
-    readonly mode: EditorMode;
-    readonly testPending: boolean;
-    readonly actions: HeaderActions;
-    readonly onBack: () => void;
-    readonly onLocale: (locale: string) => void;
-    readonly onMode: (mode: EditorMode) => void;
-    readonly onTestMail: () => void;
-}): ReactNode;

package/dist/web/mail-header.js

@@ -1,16 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// @runtime client
-import { usePrimitives, useTranslation } from "@cosmicdrift/kumiko-renderer";
-import { ModeSwitch, StatusBadge } from "@cosmicdrift/kumiko-renderer-web";
-import { asRowStatus, statusLabel, statusTone } from "./status-label.js";
-export function MailHeader({ title, row, locales, locale, mode, testPending, actions, onBack, onLocale, onMode, onTestMail, }) {
-    const t = useTranslation();
-    const { Button, Heading, Link, Text } = usePrimitives();
-    const status = row === null ? null : asRowStatus(row.status);
-    return (_jsxs("div", { className: "flex flex-col gap-3", "data-testid": "mail-editor-header", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx(Link, { href: "#", onPress: onBack, testId: "document-designer-back", children: t("documentDesigner.editor.crumb") }), _jsx(Text, { variant: "muted", children: "\u203A" }), _jsx(Heading, { variant: "page", testId: "document-designer-editor-title", children: title }), row !== null && status !== null && (_jsxs(_Fragment, { children: [_jsx(StatusBadge, { tone: statusTone(status), testId: "document-designer-editor-status", children: statusLabel(t, status, row.version) }), _jsx(StatusBadge, { tone: row.scope === "tenant" ? "accent" : "muted", testId: "document-designer-editor-origin", children: t(row.scope === "tenant"
-                                    ? "documentDesigner.origin.tenant"
-                                    : "documentDesigner.origin.system") })] })), _jsx("div", { className: "grow" }), _jsx(ModeSwitch, { value: locale, onChange: onLocale, ariaLabel: t("documentDesigner.mail.header.localeSwitch"), testId: "mail-locale-switch", options: locales.map((code) => ({ value: code, label: code })) }), _jsx(ModeSwitch, { value: mode, onChange: onMode, ariaLabel: t("documentDesigner.mail.header.modeSwitch"), testId: "mail-mode-switch", options: [
-                            { value: "edit", label: t("documentDesigner.mail.header.edit") },
-                            { value: "preview", label: t("documentDesigner.mail.header.preview") },
-                        ] })] }), _jsxs("div", { className: "flex items-center gap-3", "data-testid": "mail-editor-header-actions", children: [_jsx(Button, { variant: "secondary", disabled: testPending, loading: testPending, onClick: onTestMail, testId: "mail-test-mail-header", children: t("documentDesigner.mail.header.testMail") }), _jsx(Button, { variant: "secondary", disabled: !actions.canSave, loading: actions.busy, onClick: actions.onSave, testId: "mail-header-save", children: t("documentDesigner.editor.save") }), _jsx(Button, { disabled: !actions.canPublish, onClick: actions.onPublish, testId: "mail-header-publish", children: t("documentDesigner.editor.publish") })] })] }));
-}

package/dist/web/placeholder-panel.d.ts

@@ -1,21 +0,0 @@
-import type { ReactNode } from "react";
-import type { VariableInfo } from "./types.js";
-export type SystemPlaceholderRow = {
-    readonly name: string;
-    readonly label: string;
-    readonly status: "used" | "layout" | "unused";
-};
-export type PlaceholderPanelProps = {
-    readonly variables: Readonly<Record<string, VariableInfo>>;
-    readonly used: readonly string[];
-    readonly missingRequired: readonly string[];
-    readonly systemRows: readonly SystemPlaceholderRow[];
-    readonly resourceKeys: readonly string[];
-    readonly canUpload: boolean;
-    readonly layoutName: string;
-    readonly onInsert: (name: string) => void;
-    readonly onInsertResource: (key: string) => void;
-    readonly onUpload: (file: File) => Promise<void>;
-};
-export declare function visibleSystemPlaceholders(names: readonly string[]): readonly string[];
-export declare function PlaceholderPanel(props: PlaceholderPanelProps): ReactNode;

package/dist/web/placeholder-panel.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-// @runtime client
-import { usePrimitives, useTranslation } from "@cosmicdrift/kumiko-renderer";
-import { cn, SectionCard, UploadZone } from "@cosmicdrift/kumiko-renderer-web";
-const TYPE_GLYPHS = {
-    text: "T",
-    money: "€",
-    date: "D",
-    link: "↗",
-    list: "≡",
-};
-// unsubscribeUrl belongs to mail; the PDF designer never offers it.
-const HIDDEN_SYSTEM_PLACEHOLDERS = new Set(["unsubscribeUrl"]);
-export function visibleSystemPlaceholders(names) {
-    return names.filter((name) => !HIDDEN_SYSTEM_PLACEHOLDERS.has(name));
-}
-export function PlaceholderPanel(props) {
-    const t = useTranslation();
-    const { Button } = usePrimitives();
-    const names = Object.keys(props.variables);
-    return (_jsxs("div", { className: "flex flex-col gap-4", "data-testid": "document-designer-placeholders", children: [_jsx(SectionCard, { title: t("documentDesigner.placeholders.title"), children: _jsx("ul", { className: "m-0 flex list-none flex-col gap-1 p-0", children: names.map((name) => {
-                        const info = props.variables[name];
-                        if (info === undefined)
-                            return null;
-                        const missing = props.missingRequired.includes(name);
-                        const isUsed = props.used.includes(name);
-                        return (_jsx("li", { children: _jsxs("button", { type: "button", "data-testid": `placeholder-${name}`, onClick: () => props.onInsert(name), className: cn("flex w-full items-center gap-2 rounded-md border px-2 py-1 text-left text-sm", missing
-                                    ? "border-status-bad bg-status-bad-surface"
-                                    : "border-border bg-background hover:bg-muted"), children: [_jsx("span", { className: "w-4 text-center text-xs text-muted-foreground", children: TYPE_GLYPHS[info.type] }), _jsxs("span", { className: "min-w-0 flex-1 truncate", children: [info.label ?? name, info.required === true ? " *" : ""] }), _jsx("span", { className: cn("text-xs", missing ? "font-medium text-status-bad" : "text-muted-foreground"), children: missing ? t("documentDesigner.placeholders.missing") : isUsed ? "✓" : "–" })] }) }, name));
-                    }) }) }), _jsx(SectionCard, { title: t("documentDesigner.placeholders.system"), children: _jsx("ul", { className: "m-0 flex list-none flex-col gap-1 p-0", children: props.systemRows.map((row) => (_jsx("li", { children: _jsxs("button", { type: "button", "data-testid": `system-placeholder-${row.name}`, onClick: () => props.onInsert(row.name), className: "flex w-full items-center gap-2 rounded-md border border-primary/30 bg-primary/10 px-2 py-1 text-left text-sm text-primary", children: [_jsx("span", { className: "min-w-0 flex-1 truncate", children: row.label }), _jsx("span", { className: "text-xs", children: row.status === "used"
-                                        ? "✓"
-                                        : row.status === "layout"
-                                            ? t("documentDesigner.placeholders.fromLayout")
-                                            : "–" })] }) }, row.name))) }) }), _jsxs(SectionCard, { title: t("documentDesigner.resources.title"), children: [props.resourceKeys.length === 0 ? (_jsx("p", { className: "text-xs text-muted-foreground", children: t("documentDesigner.resources.empty") })) : (_jsx("ul", { className: "m-0 flex list-none flex-col gap-1 p-0 font-mono text-xs", children: props.resourceKeys.map((key) => (_jsxs("li", { className: "flex items-center justify-between gap-2", children: [_jsx("span", { className: "truncate", children: key }), _jsx(Button, { variant: "link", size: "sm", onClick: () => props.onInsertResource(key), ariaLabel: t("documentDesigner.resources.insertNamed", { key }), children: t("documentDesigner.resources.insert") })] }, key))) })), props.canUpload ? (_jsx(UploadZone, { multiple: false, accept: ["image/png", "image/jpeg", "image/gif", "image/webp"], title: t("documentDesigner.resources.upload"), onUpload: props.onUpload, testId: "document-designer-upload" })) : (_jsx(Button, { variant: "secondary", size: "sm", disabled: true, children: t("documentDesigner.resources.upload") })), !props.canUpload && (_jsx("p", { className: "text-xs text-muted-foreground", children: t("documentDesigner.resources.saveFirst") }))] }), _jsx("p", { className: "text-xs text-muted-foreground", children: t("documentDesigner.placeholders.layoutHint", { layout: props.layoutName }) })] }));
-}