@cosmicdrift/kumiko-renderer 0.377.0 → 0.379.0

package/dist/web/widgets/index.d.ts

@@ -10,6 +10,7 @@ export { FloatingPanel, type FloatingPanelGeometry, type FloatingPanelProps, } f
 export { BooleanField, type BooleanFieldProps, DateField, type DateFieldProps, FileField, type FileFieldProps, MoneyField, NumberField, type NumberFieldProps, PercentField, RangeField, type RangeFieldProps, SelectField, type SelectFieldProps, TextareaField, type TextareaFieldProps, TextField, type TextFieldProps, } from "./form-fields.tsx";
 export { InfinityList, type InfinityListProps, type InfinityListSelection, } from "./infinity-list.tsx";
 export { ModeSwitch, type ModeSwitchVariant } from "./mode-switch.tsx";
+export { PdfPreview, type PdfPreviewSource } from "./pdf-preview.tsx";
 export { type PhotoSlotSpec, PhotoSlots, type PhotoSlotsProps } from "./photo-slots.tsx";
 export { PlanCard, type PlanCardActionSlot, type PlanCardLinkSlot, type PlanCardPrice, type PlanCardProps, PlanGrid, type PlanGridProps, } from "./plan-card.tsx";
 export { ProgressBar } from "./progress-bar.tsx";

package/dist/web/widgets/index.js

@@ -13,6 +13,7 @@ export { FloatingPanel, } from "./floating-panel.js";
 export { BooleanField, DateField, FileField, MoneyField, NumberField, PercentField, RangeField, SelectField, TextareaField, TextField, } from "./form-fields.js";
 export { InfinityList, } from "./infinity-list.js";
 export { ModeSwitch } from "./mode-switch.js";
+export { PdfPreview } from "./pdf-preview.js";
 export { PhotoSlots } from "./photo-slots.js";
 export { PlanCard, PlanGrid, } from "./plan-card.js";
 export { ProgressBar } from "./progress-bar.js";

package/dist/web/widgets/pdf-preview.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+export type PdfPreviewSource = {
+    readonly base64: string;
+} | {
+    readonly url: string;
+};
+export declare function PdfPreview({ source, testId, }: {
+    readonly source: PdfPreviewSource;
+    readonly testId?: string;
+}): ReactNode;

package/dist/web/widgets/pdf-preview.js

@@ -0,0 +1,140 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Suspense, use, useCallback, useMemo, useState } from "react";
+import { useTranslation } from "../../i18n.js";
+import { createBoundedLoadCache } from "./bounded-load-cache.js";
+// pdf.js runs in the main thread ("fake worker"): the worker module is bundled
+// with the app and handed over through globalThis.pdfjsWorker, so no worker or
+// CDN URL is ever fetched (self-hosting and CSP stay intact).
+const RENDER_SCALE = 96 / 72;
+const MAX_CACHED_DOCUMENTS = 4;
+const cachedDocument = createBoundedLoadCache(MAX_CACHED_DOCUMENTS, (loaded) => {
+    if (loaded.ok)
+        void loaded.loadingTask.destroy();
+});
+function decodeBase64(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index++)
+        bytes[index] = binary.charCodeAt(index);
+    return bytes;
+}
+async function loadBytes(source) {
+    if ("base64" in source)
+        return decodeBase64(source.base64);
+    const res = await fetch(source.url, { credentials: "same-origin" });
+    if (!res.ok)
+        throw new Error(`pdf fetch failed (${res.status})`);
+    return new Uint8Array(await res.arrayBuffer());
+}
+async function loadDocument(source) {
+    try {
+        const [pdfjs, worker, data] = await Promise.all([
+            import("pdfjs-dist"),
+            import("pdfjs-dist/build/pdf.worker.min.mjs"),
+            loadBytes(source),
+        ]);
+        Object.assign(globalThis, { pdfjsWorker: worker });
+        const loadingTask = pdfjs.getDocument({ data });
+        return { ok: true, document: await loadingTask.promise, loadingTask };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+// The promise must be stable across renders for use().
+function documentFor(source) {
+    const key = "base64" in source ? `base64:${source.base64}` : `url:${source.url}`;
+    return cachedDocument(key, () => loadDocument(source));
+}
+function PageView({ document, pageNumber, }) {
+    const t = useTranslation();
+    const page = use(pageFor(document, pageNumber));
+    // Stable identity: the mount callbacks below depend on it, and a new viewport per render re-mounts canvas and text layer.
+    const viewport = useMemo(() => page.getViewport({ scale: RENDER_SCALE }), [page]);
+    const [availableWidth, setAvailableWidth] = useState(null);
+    const measureFrame = useCallback((frame) => {
+        if (frame === null)
+            return;
+        const observer = new ResizeObserver(() => setAvailableWidth(frame.clientWidth));
+        observer.observe(frame);
+        setAvailableWidth(frame.clientWidth);
+        return () => observer.disconnect();
+    }, []);
+    // The sheet keeps its natural pixel size and is scaled as a whole, so canvas and text layer stay aligned.
+    const fitScale = availableWidth === null || availableWidth <= 0
+        ? 1
+        : Math.min(1, availableWidth / viewport.width);
+    const mountCanvas = useCallback((canvas) => {
+        if (canvas === null)
+            return;
+        const pixelRatio = globalThis.devicePixelRatio || 1;
+        canvas.width = Math.floor(viewport.width * pixelRatio);
+        canvas.height = Math.floor(viewport.height * pixelRatio);
+        const task = page.render({
+            canvas,
+            viewport,
+            transform: pixelRatio === 1 ? undefined : [pixelRatio, 0, 0, pixelRatio, 0, 0],
+        });
+        task.promise.catch(() => undefined);
+        return () => task.cancel();
+    }, [page, viewport]);
+    const mountTextLayer = useCallback((container) => {
+        if (container === null)
+            return;
+        container.style.setProperty("--total-scale-factor", String(RENDER_SCALE));
+        container.style.setProperty("--scale-factor", String(RENDER_SCALE));
+        let layer = null;
+        let cancelled = false;
+        void import("pdfjs-dist").then(({ TextLayer }) => {
+            // skip: cleanup ran before pdfjs finished loading
+            if (cancelled)
+                return undefined;
+            // TextLayer.cancel() keeps rendered spans; a re-mount must not append a second layer.
+            container.replaceChildren();
+            const textLayer = new TextLayer({
+                textContentSource: page.streamTextContent(),
+                container,
+                viewport,
+            });
+            layer = textLayer;
+            return textLayer.render().catch(() => undefined);
+        });
+        return () => {
+            cancelled = true;
+            layer?.cancel();
+        };
+    }, [page, viewport]);
+    return (_jsxs("figure", { className: "m-0 flex w-full flex-col items-center gap-2 rounded-lg bg-muted p-4", "data-testid": `pdf-page-${pageNumber}`, children: [_jsx("div", { ref: measureFrame, className: "w-full", children: _jsx("div", { className: "mx-auto", style: { width: viewport.width * fitScale, height: viewport.height * fitScale }, children: _jsxs("div", { className: "relative border border-border bg-white shadow-md", style: {
+                            width: viewport.width,
+                            height: viewport.height,
+                            transform: `scale(${fitScale})`,
+                            transformOrigin: "top left",
+                        }, children: [_jsx("canvas", { ref: mountCanvas, style: { width: viewport.width, height: viewport.height }, className: "block" }), _jsx("div", { ref: mountTextLayer, className: "absolute inset-0 overflow-hidden leading-none [&_span]:absolute [&_span]:origin-top-left [&_span]:cursor-text [&_span]:whitespace-pre [&_span]:text-transparent [&_span::selection]:bg-primary/30" })] }) }) }), _jsx("figcaption", { className: "text-xs text-muted-foreground", children: t("kumiko.widget.pdf-preview.pageOf", { page: pageNumber, pages: document.numPages }) })] }));
+}
+const pageCache = new WeakMap();
+function pageFor(document, pageNumber) {
+    let pages = pageCache.get(document);
+    if (pages === undefined) {
+        pages = new Map();
+        pageCache.set(document, pages);
+    }
+    let page = pages.get(pageNumber);
+    if (page === undefined) {
+        page = document.getPage(pageNumber);
+        pages.set(pageNumber, page);
+    }
+    return page;
+}
+function Pages({ source }) {
+    const t = useTranslation();
+    const loaded = use(documentFor(source));
+    if (!loaded.ok) {
+        return _jsx("p", { className: "text-sm text-status-bad", children: t("kumiko.widget.pdf-preview.renderFailed") });
+    }
+    const pageNumbers = Array.from({ length: loaded.document.numPages }, (_, index) => index + 1);
+    return (_jsx(_Fragment, { children: pageNumbers.map((pageNumber) => (_jsx(Suspense, { fallback: null, children: _jsx(PageView, { document: loaded.document, pageNumber: pageNumber }) }, pageNumber))) }));
+}
+export function PdfPreview({ source, testId = "pdf-preview", }) {
+    const t = useTranslation();
+    return (_jsx("div", { className: "flex flex-col items-stretch gap-4 overflow-auto", "data-testid": testId, children: _jsx(Suspense, { fallback: _jsx("p", { className: "text-sm text-muted-foreground", children: t("kumiko.widget.pdf-preview.loading") }), children: _jsx(Pages, { source: source }) }) }));
+}

package/dist/web/widgets/upload-zone.d.ts

@@ -3,7 +3,7 @@ export type UploadZoneProps = {
     /** Uploads a single file (POST + optional follow-up mutation). Throws on
      *  failure — the message ends up in the row's error line. Runs in
      *  parallel per file within a batch (no sequential waiting). */
-    readonly onUpload: (file: File) => Promise<void>;
+    readonly onUpload: (file: File) => Promise<string | undefined | void>;
     readonly title: ReactNode;
     readonly hint?: ReactNode;
     readonly accept?: readonly string[];
@@ -14,6 +14,15 @@ export type UploadZoneProps = {
     readonly capture?: "environment" | "user";
     readonly disabled?: boolean;
     readonly testId?: string;
+    /** Turns a failed upload into the row's error text. Default: the error's own message. */
+    readonly describeError?: (cause: unknown) => string;
+    /** Controlled use, for a form field: a string returned by `onUpload` becomes the row's value
+     *  and done rows get a remove button that calls this with it. The zone does not drop the row;
+     *  the owner removes the value from `doneValues`, which the zone then follows. */
+    readonly onRemove?: (value: string) => void;
+    /** The values the owner currently holds. Done rows whose value left the list disappear, and
+     *  going from some to none (an external reset) clears every row, error rows included. */
+    readonly doneValues?: readonly string[];
 };
 export declare function matchesAccept(file: File, accept?: readonly string[]): boolean;
 /** Drop zone + multi-file picker with a per-file status row (uploading/done/
@@ -21,4 +30,4 @@ export declare function matchesAccept(file: File, accept?: readonly string[]): b
  *  independently — unlike `FileField` (single file, FileRef value inside a
  *  form field). `onUpload` decides what "upload" means (storage POST, ingest
  *  mutation, or both); the zone only tracks uploading/done/error. */
-export declare function UploadZone({ onUpload, title, hint, accept, multiple, capture, disabled, testId, }: UploadZoneProps): ReactNode;
+export declare function UploadZone({ onUpload, title, hint, accept, multiple, capture, disabled, testId, describeError, onRemove, doneValues, }: UploadZoneProps): ReactNode;

package/dist/web/widgets/upload-zone.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { CheckCircle2, FileUp, Loader2, TriangleAlert, Upload } from "lucide-react";
-import { useId, useRef, useState } from "react";
+import { CheckCircle2, FileUp, Loader2, TriangleAlert, Upload, X } from "lucide-react";
+import { useEffect, useId, useRef, useState } from "react";
 import { useTranslation } from "../../index.js";
 import { toAcceptAttr } from "../lib/accept-attr.js";
 import { cn } from "../lib/cn.js";
@@ -44,7 +44,7 @@ function partitionByAccept(files, accept) {
  *  independently — unlike `FileField` (single file, FileRef value inside a
  *  form field). `onUpload` decides what "upload" means (storage POST, ingest
  *  mutation, or both); the zone only tracks uploading/done/error. */
-export function UploadZone({ onUpload, title, hint, accept, multiple = true, capture, disabled, testId, }) {
+export function UploadZone({ onUpload, title, hint, accept, multiple = true, capture, disabled, testId, describeError, onRemove, doneValues, }) {
     const t = useTranslation();
     const inputId = useId();
     const inputRef = useRef(null);
@@ -54,16 +54,31 @@ export function UploadZone({ onUpload, title, hint, accept, multiple = true, cap
     // preview leaves it undefined. These ids are React keys/row ids, not
     // globally unique identifiers, so a per-instance counter is enough.
     const nextRowId = useRef(0);
+    const previousDoneCount = useRef(0);
+    const doneCount = doneValues?.length;
+    useEffect(() => {
+        if (doneCount === undefined)
+            return;
+        if (doneCount === 0 && previousDoneCount.current > 0)
+            setRows([]);
+        previousDoneCount.current = doneCount;
+    }, [doneCount]);
     async function uploadOne(file) {
         const rowId = String(nextRowId.current++);
         const uploadFile = await resizeImageBeforeUpload(file);
         setRows((prev) => [...prev, { id: rowId, fileName: uploadFile.name, status: "uploading" }]);
         try {
-            await onUpload(uploadFile);
-            setRows((prev) => prev.map((row) => (row.id === rowId ? { ...row, status: "done" } : row)));
+            const value = await onUpload(uploadFile);
+            setRows((prev) => prev.map((row) => row.id === rowId
+                ? { ...row, status: "done", ...(typeof value === "string" && { value }) }
+                : row));
         }
         catch (cause) {
-            const message = cause instanceof Error ? cause.message : t("kumiko.widget.upload.error");
+            const message = describeError !== undefined
+                ? describeError(cause)
+                : cause instanceof Error
+                    ? cause.message
+                    : t("kumiko.widget.upload.error");
             setRows((prev) => prev.map((row) => (row.id === rowId ? { ...row, status: "error", error: message } : row)));
         }
     }
@@ -95,6 +110,10 @@ export function UploadZone({ onUpload, title, hint, accept, multiple = true, cap
             return;
         void uploadFiles(e.dataTransfer.files);
     }
+    function removeRow(row) {
+        if (row.value !== undefined)
+            onRemove?.(row.value);
+    }
     const acceptAttr = toAcceptAttr(accept);
     return (_jsxs("div", { "data-testid": testId, className: "flex flex-col gap-4", children: [_jsxs("label", { htmlFor: inputId, onDragOver: (e) => {
                     e.preventDefault();
@@ -104,5 +123,9 @@ export function UploadZone({ onUpload, title, hint, accept, multiple = true, cap
                     if (!(e.relatedTarget instanceof Node) || !e.currentTarget.contains(e.relatedTarget)) {
                         setDragOver(false);
                     }
-                }, onDrop: handleDrop, "data-testid": testId !== undefined ? `${testId}-dropzone` : undefined, className: cn("flex w-full cursor-pointer flex-col items-center gap-3 rounded-lg border-2 border-dashed p-10 text-center transition-colors has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-ring has-[:focus-visible]:ring-offset-2", dragOver ? "border-primary bg-muted/40" : "border-border", disabled === true && "cursor-not-allowed opacity-50"), children: [_jsx(Upload, { className: "size-8 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: "text-sm", children: title }), hint !== undefined && _jsx("span", { className: "text-sm text-muted-foreground", children: hint }), _jsx("input", { ref: inputRef, id: inputId, type: "file", multiple: multiple, className: "sr-only", "data-testid": testId !== undefined ? `${testId}-input` : undefined, disabled: disabled, ...(acceptAttr !== undefined && { accept: acceptAttr }), ...(capture !== undefined && { capture }), onChange: (e) => void uploadFiles(e.target.files) })] }), rows.length > 0 && (_jsx("ul", { className: "flex flex-col gap-2", children: rows.map((row) => (_jsxs("li", { "data-testid": testId !== undefined ? `${testId}-row` : undefined, className: "flex items-center justify-between gap-3 rounded-md border border-border px-4 py-2", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(FileUp, { className: "size-4 shrink-0 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: "truncate text-sm", children: row.fileName })] }), _jsxs("output", { className: "flex shrink-0 items-center gap-1.5 text-xs text-muted-foreground", children: [STATUS_ICON[row.status], _jsx("span", { className: "sr-only", children: t(STATUS_LABEL_KEY[row.status]) }), row.status === "error" && row.error !== undefined && _jsx("span", { children: row.error })] })] }, row.id))) }))] }));
+                }, onDrop: handleDrop, "data-testid": testId !== undefined ? `${testId}-dropzone` : undefined, className: cn("flex w-full cursor-pointer flex-col items-center gap-3 rounded-lg border-2 border-dashed p-10 text-center transition-colors has-[:focus-visible]:ring-2 has-[:focus-visible]:ring-ring has-[:focus-visible]:ring-offset-2", dragOver ? "border-primary bg-muted/40" : "border-border", disabled === true && "cursor-not-allowed opacity-50"), children: [_jsx(Upload, { className: "size-8 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: "text-sm", children: title }), hint !== undefined && _jsx("span", { className: "text-sm text-muted-foreground", children: hint }), _jsx("input", { ref: inputRef, id: inputId, type: "file", multiple: multiple, className: "sr-only", "data-testid": testId !== undefined ? `${testId}-input` : undefined, disabled: disabled, ...(acceptAttr !== undefined && { accept: acceptAttr }), ...(capture !== undefined && { capture }), onChange: (e) => void uploadFiles(e.target.files) })] }), rows.length > 0 && (_jsx("ul", { className: "flex flex-col gap-2", children: rows
+                    .filter((row) => row.value === undefined ||
+                    doneValues === undefined ||
+                    doneValues.includes(row.value))
+                    .map((row) => (_jsxs("li", { "data-testid": testId !== undefined ? `${testId}-row` : undefined, className: "flex items-center justify-between gap-3 rounded-md border border-border px-4 py-2", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsx(FileUp, { className: "size-4 shrink-0 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: "truncate text-sm", children: row.fileName })] }), _jsxs("output", { className: "flex shrink-0 items-center gap-1.5 text-xs text-muted-foreground", children: [STATUS_ICON[row.status], _jsx("span", { className: "sr-only", children: t(STATUS_LABEL_KEY[row.status]) }), row.status === "error" && row.error !== undefined && _jsx("span", { children: row.error }), row.value !== undefined && onRemove !== undefined && disabled !== true && (_jsx("button", { type: "button", className: "rounded-sm p-0.5 text-muted-foreground hover:text-foreground", "aria-label": t("kumiko.widget.upload.remove"), "data-testid": testId !== undefined ? `${testId}-remove` : undefined, onClick: () => removeRow(row), children: _jsx(X, { className: "size-3.5", "aria-hidden": "true" }) }))] })] }, row.id))) }))] }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-renderer",
-  "version": "0.377.0",
+  "version": "0.379.0",
   "description": "React renderer for Kumiko screens. The root export holds the platform-agnostic logic (primitives contract, hooks, KumikoScreen, navigation and SSE abstractions); ./headless the DOM-free UI logic, ./live the HTTP dispatcher, ./web the browser bindings (HTML primitives, history navigation, EventSource live events, createKumikoApp).",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -17,6 +17,10 @@
       "types": "./dist/headless/index.d.ts",
       "default": "./dist/headless/index.js"
     },
+    "./flow-diagram": {
+      "types": "./dist/flow-diagram/index.d.ts",
+      "default": "./dist/flow-diagram/index.js"
+    },
     "./headless/apex": {
       "types": "./dist/headless/apex/index.d.ts",
       "default": "./dist/headless/apex/index.js"
@@ -44,8 +48,8 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.377.0",
-    "@cosmicdrift/kumiko-types": "0.377.0",
+    "@cosmicdrift/kumiko-framework": "0.379.0",
+    "@cosmicdrift/kumiko-types": "0.379.0",
     "@radix-ui/react-dialog": "^1.1.15",
     "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-label": "^2.1.8",
@@ -64,6 +68,7 @@
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
     "lucide-react": "^1.14.0",
+    "pdfjs-dist": "6.3.289",
     "qrcode": "^1.5.4",
     "radix-ui": "^1.4.3",
     "react": "^19.2.6",
@@ -87,8 +92,8 @@
     }
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-locale-de": "0.377.0",
-    "@cosmicdrift/kumiko-testing": "0.377.0",
+    "@cosmicdrift/kumiko-locale-de": "0.379.0",
+    "@cosmicdrift/kumiko-testing": "0.379.0",
     "@tailwindcss/cli": "^4.3.0",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -118,6 +123,10 @@
         "types": "./dist/headless/index.d.ts",
         "default": "./dist/headless/index.js"
       },
+      "./flow-diagram": {
+        "types": "./dist/flow-diagram/index.d.ts",
+        "default": "./dist/flow-diagram/index.js"
+      },
       "./headless/apex": {
         "types": "./dist/headless/apex/index.d.ts",
         "default": "./dist/headless/apex/index.js"

package/src/changes.json

@@ -1,4 +1,147 @@
 [
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "actionForm success box shows the message and every fact on its own line",
+    "detail": "The success message and the successFacts of an actionForm no longer run together (\"Fertig.Gebucht: 20Übersprungen: 0\"). The message is its own line, a fact with one value is one \"Label: value\" line, a fact with several lines (for example file names) is a label line followed by one line per value instead of a comma chain. New test ids action-form-success-text and action-form-success-fact-<n>-line-<i>.",
+    "migration": "None. Tests that read the textContent of a multi-line fact now see the label and the lines without the former \", \" separators."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Empty list with an active default filter offers \"Show all\"",
+    "detail": "A list that is empty only because its defaultFilters are on says so and offers a Show all button instead of the \"create the first one\" text. The hard-coded Loading… banners use the kumiko.widget.loading key, so they follow the locale."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "Count messages use singular and plural forms",
+    "detail": "Nine count messages (template usage, mail preview entries, layout origin and footer, tag delete confirmation, embedded-list paste warnings) now come as .one and .other keys in en, de, es, fr and it, so \"1 template\" no longer reads \"1 templates\". Apps that override these keys must rename them to .one and .other."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "Shell header: the parent crumb no longer slides under a long title",
+    "detail": "The page title truncates on its own; the parent crumb stays whole and is left out when the space beside the header actions gets narrower than 20rem (a container query on the header's left side instead of the sm viewport breakpoint). The h1 carries the full title as tooltip."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "A rejected empty embedded list shows its error at the list, once, without a banner-only failure",
+    "detail": "The empty state of an embedded list now shows list-level issues (min items, required), and the surrounding field no longer prints them a second time. An issue on a derived head total that is not laid out (an empty list leaves it without a value) no longer adds the generic form banner while another issue is shown; it still shows the banner when it is the only issue. A list below its minItems now reads \"At least 1 row required.\" / \"At least N rows required.\" (errors.validation.list_min_rows.one and .other) instead of the generic too-small text. Only embedded lists get the row wording (their schema reports a custom issue with params.i18nKey and minimum, which both zod bridges now forward); other arrays such as a required multiSelect keep errors.validation.too_small.",
+    "migration": "None."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "An embedded list does not repeat its section title as a visible label",
+    "detail": "When the label of an embedded-list field equals the title of the section it sits in (for example \"Positionen\" under \"Positionen\"), entityEdit and actionForm screens now keep the label for screen readers only instead of printing it twice. Applies by default, no setting.",
+    "migration": "None."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Embedded-list footer totals can sum several columns under their own label",
+    "detail": "EmbeddedFieldDef.totals entries are now a column name (as before) or { label, from } with an i18n label and the sub-fields to add up, for example Net { from: [\"amount\"] }, VAT { from: [\"vatAmount\"] } and Gross { from: [\"amount\", \"vatAmount\"] }. Display only, the server derivation is unchanged. The boot validator rejects an empty from and any from entry that is not a number, money or decimal sub-field. Money sums use the same format as string totals. The ui-walkthrough receive-invoice screen and the embedded recipe now lay out only the Positionen list with a footer of Net, VAT and Gross; the derived head totals are still computed on the server but not laid out, and the list requires at least one line (minItems 1).",
+    "migration": "Optional. Replace a totals string list with labelled entries where the footer should show Net, VAT and Gross (solon invoice screens)."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "projectionDetail shows the record again after a record action",
+    "detail": "After a writeHandler action on a projectionDetail (header or section action) the screen refetched the record but the shown fields kept their old values until a reload. The actions now reload through the same path as the reload button, which re-applies the refetched record to a form without user input.",
+    "migration": "None."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Live updates reconnect, resync and coalesce refetches",
+    "detail": "The web EventSource reconnects with exponential backoff and jitter after a refused handshake unless the session ended, rewires every subscribed entity on the new connection and sends each listener a LIVE_RESYNC_EVENT_TYPE event after a reconnect, because frames during the gap are lost. useQuery and the nav tree refetch in the background and collapse a burst of live events into one trailing run (LIVE_REFETCH_COALESCE_MS); an event during a running fetch queues exactly one follow-up. A failed refetch keeps the last data on screen and shows QueryErrorBanner with a retry button above it."
+  },
+  {
+    "version": "0.379.0",
+    "type": "breaking",
+    "title": "Forms ask before unsaved input is discarded",
+    "detail": "A dirty entity form or writeForm section now asks with the discard dialog before an in-app navigation, a projectionDetail tab switch, browser back or forward, and the browser asks on tab close or reload (beforeunload). A successful save clears the form before its follow-up navigation, and wizards with layout.draft keep their draft instead of asking. requestLeave, hasUnsavedInput and useUnsavedInputSource are exported for custom screens.",
+    "migration": "End-to-end tests that fill a form and then navigate away without saving now meet the dialog (testId leave-guard-dialog); confirm it or save first. page.goto from a dirty form triggers the browser's beforeunload prompt."
+  },
+  {
+    "version": "0.379.0",
+    "type": "breaking",
+    "title": "Form writes carry a requestId and reuse it only for a safe retry",
+    "detail": "The form controller passes { requestId } as third argument to dispatcher.write. After a transport failure without a server answer, a submit with the same values reuses the requestId, so the server idempotency guard does not run the write twice; any server answer or changed values get a new one. generateRequestId moved to the headless dispatcher module.",
+    "migration": "Tests that assert a mocked dispatcher.write with toHaveBeenCalledWith(type, payload) must accept the third argument, e.g. toHaveBeenCalledWith(type, payload, expect.objectContaining({ requestId: expect.any(String) })). Custom Dispatcher implementations should forward options.requestId."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Failed submits focus the first invalid field, clearer format errors",
+    "detail": "After a failed submit the web form focuses and scrolls to the first field with aria-invalid (FormProps.focusFirstErrorKey; native forms ignore it). Format errors for email, url, date, datetime and uuid name the expected format with an example, the error line no longer shifts the labels of neighbouring fields, and SegmentedControl options with up to four entries get equal widths."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "Toolbar navigate actions are hidden when the user may not open the target screen",
+    "detail": "A toolbarAction of kind navigate on entityList, projectionList and relatedList now follows the access rule of its target screen, the same check metric jumps use. Before, the button showed for every role and led to an access-denied page.",
+    "migration": "None. Gate the target screen with its own access rule; the toolbar button follows it."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "actionForm loads a singleton row without a record id",
+    "detail": "load.singleton: true on an actionForm sends the load query without idParam and prefills the form from the tenant's single row, like projectionDetail. A route id is never forwarded. The boot validator rejects singleton together with idParam."
+  },
+  {
+    "version": "0.379.0",
+    "type": "improvement",
+    "title": "Dashboard text block link shown only to given roles",
+    "detail": "A text block of kind link ({ text, screen, roles? }) renders a link to a screen and is hidden unless the user holds one of the roles. This only gates the display; the target screen still checks access on the server. The boot validator rejects an unknown target screen and an empty roles list."
+  },
+  {
+    "version": "0.379.0",
+    "type": "fix",
+    "title": "DataTable no longer hides its last column under the sticky actions column",
+    "detail": "Header and text cells wrap instead of staying on one line (badges, dates and row actions keep their own nowrap), and a row-action group wraps when the column is narrow. A table whose cells could not shrink scrolled sideways without a visible scrollbar and its last column slid under the sticky actions column. Long values now wrap (up to max-w-xs per column) instead of being cut with an ellipsis."
+  },
+  {
+    "version": "0.378.0",
+    "type": "fix",
+    "title": "Non-modal drawers narrow the content instead of covering it",
+    "detail": "A Drawer with modal={false} on a wide viewport now publishes the width it occupies as --kumiko-drawer-inset-right or --kumiko-drawer-inset-left on the document root, and the shell content area (main next to the sidebar) takes it as inline padding, so error banners, right columns and the pinned form footer end beside the drawer. Modal drawers and narrow viewports keep overlaying. Two non-modal drawers open on the same side overwrite each other's value."
+  },
+  {
+    "version": "0.378.0",
+    "type": "improvement",
+    "title": "Files fields show download and PDF preview",
+    "detail": "A read-only detail field with renderer { format: \"file\" } (projectionDetail, readOnly edit field) lists each file with its name and a download link; PDFs get an inline preview toggle. New optional primitive FileValueList, and PdfPreview (moved here from the document designer) with a per-source bounded document cache so several PDFs can share a page. i18n keys kumiko.field.file-list.download/preview/hidePreview and kumiko.widget.pdf-preview.* ship in de, es, fr and it.",
+    "migration": "PdfPreview is now exported from @cosmicdrift/kumiko-renderer/web (props: source {base64}|{url}, testId)."
+  },
+  {
+    "version": "0.378.0",
+    "type": "improvement",
+    "title": "FormScreenLayout gives custom screens the standard form screen layout",
+    "detail": "New universal component FormScreenLayout (children, description, actions, secondaryActions, onSubmit, width, testId) renders the same left-aligned form column, section stack and pinned footer as an entityEdit screen. Fill it with Section primitives (title, icon, subtitle); description becomes the form subtitle.",
+    "migration": "Custom form screens can replace FormScreenShell + Card with FormScreenLayout + Section."
+  },
+  {
+    "version": "0.378.0",
+    "type": "fix",
+    "title": "Card renders no footer bar for an empty footer slot",
+    "detail": "slots.footer set to false or null (for example `hasDone && <Button/>`) left an empty grey footer bar. The bar now renders only when the footer slot has content."
+  },
+  {
+    "version": "0.378.0",
+    "type": "improvement",
+    "title": "flow-diagram subpath",
+    "detail": "\"@cosmicdrift/kumiko-renderer/flow-diagram\" exports renderFlow(spec) and the FlowSpec, FlowNode, FlowEdge, FlowIcon types, a pure string function that renders an animated SVG flow diagram."
+  },
+  {
+    "version": "0.378.0",
+    "type": "breaking",
+    "title": "Renderer stylesheet no longer scans the document designer",
+    "detail": "The renderer stylesheet stopped scanning the document designer sources by relative path, which broke in isolated installs.",
+    "migration": "Apps that embed the document designer add `@import \"@cosmicdrift/kumiko-document-designer/web/styles.css\";` after the renderer stylesheet import in their styles.css."
+  },
   {
     "version": "0.377.0",
     "type": "improvement",

package/src/web/styles.css

@@ -34,12 +34,13 @@
    imported through. Here that is `<package>/src/web` in both layouts, so:
    - `../` is the renderer's own src (shared screens and components) and
      `../../dist` its compiled twin;
-   - the sibling packages (bundled-features, document-designer, neither
-     ships its own compiled CSS) need two variants: `../../../X` in the
+   - the sibling package bundled-features (no compiled CSS of its own) needs two variants: `../../../X` in the
      workspace (unscoped dir name) and `../../../kumiko-X` in a standalone
      consumer (scoped registry name under node_modules/@cosmicdrift/).
    A path that doesn't exist in a given layout is simply not matched, no
-   error. samples is monorepo-only (in-repo sample build), a no-op elsewhere.
+   error. The document designer is not scanned from here: it ships its own
+   `@cosmicdrift/kumiko-document-designer/web/styles.css`, which an app imports
+   after this file. samples is monorepo-only (in-repo sample build), a no-op elsewhere.
 
    The published packages ship compiled dist (class names survive as string
    literals in the .js), so every src line has a dist twin; src stays for
@@ -51,10 +52,6 @@
 @source "../../../bundled-features/dist/**/*.js";
 @source "../../../kumiko-bundled-features/src/**/*.{ts,tsx}";
 @source "../../../kumiko-bundled-features/dist/**/*.js";
-@source "../../../document-designer/src/**/*.{ts,tsx}";
-@source "../../../document-designer/dist/**/*.js";
-@source "../../../kumiko-document-designer/src/**/*.{ts,tsx}";
-@source "../../../kumiko-document-designer/dist/**/*.js";
 @source "../../../../samples/**/src/**/*.{ts,tsx}";
 /* In the monorepo `tsc --build` emits composite output (incl. compiled tests
    and stale files of deleted components) into dist; scanning it would make the
@@ -62,8 +59,6 @@
 @source not "../../dist/**/__tests__/**";
 @source not "../../../bundled-features/dist/**/__tests__/**";
 @source not "../../../kumiko-bundled-features/dist/**/__tests__/**";
-@source not "../../../document-designer/dist/**/__tests__/**";
-@source not "../../../kumiko-document-designer/dist/**/__tests__/**";
 
 /* Dark-Mode via class-selector (nicht media). Erlaubt JS-Toggle
    und überschreibt System-Preference wenn die App will. */
@@ -301,6 +296,15 @@
   --shell-header-height: 3.5rem;
 }
 
+/* A non-modal side Drawer publishes the width it occupies (widgets/drawer.tsx); the content area
+   narrows by that much instead of sitting underneath. Only <main>: the drawer starts below the
+   header, and the pinned form footer lives inside <main>. No transition: the sheet slides by
+   transform, its width never animates. */
+[data-slot="sidebar-inset"] > main {
+  padding-inline-end: var(--kumiko-drawer-inset-right, 0px);
+  padding-inline-start: var(--kumiko-drawer-inset-left, 0px);
+}
+
 /* Light-Mode-Overrides — aktiv wenn `<html>` KEINE `.dark` Klasse
    hat. Dark ist der Default (siehe @theme oben); toggled der User
    auf light, greifen diese Werte. */