nexus-shared 4.0.0 → 4.1.0

package/dist/Components/Viewers/OwnerFiles.js

@@ -1,12 +1,12 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { iconEye, iconFile, iconFileText, iconPencil, iconPhoto, iconStar, iconTrash, iconUpload, iconX, InlineIcon } from "nexus-icons";
+import { iconArrowBackUp, iconEye, iconFile, iconFileText, iconPencil, iconPhoto, iconStar, iconTrash, iconUpload, iconX, InlineIcon } from "nexus-icons";
 import { useCallback, useEffect, useLayoutEffect, useRef, useState, useSyncExternalStore } from "react";
 import { cx } from "../../Helpers/ClassHelpers.js";
 import { formatDateTime } from "../../Helpers/DateTimeHelpers.js";
 import { avatarTone, initials } from "../../Helpers/DropdownHelpers.js";
 import { useDatePreferences } from "../../Helpers/DatePreferences.js";
-import { acceptOf, fileKindName, fileKindsSentence, fileRefusal, fileSizeText, PICTURE_LIMITS, pictureLimits, pictureName, roomLeft, takesDocuments, typedFile } from "../../Helpers/FileAdapter.js";
+import { acceptOf, allowsFileChange, fileKindName, fileChangesNote, fileKindsSentence, fileRefusal, fileSizeText, narrowFileChanges, ownerFileActions, PENDING_REMOVAL_TAG, PICTURE_LIMITS, pictureLimits, pictureName, removalHeld, removalHeldQuestion, removalHeldSentence, roomLeft, takesDocuments, typedFile, } from "../../Helpers/FileAdapter.js";
 import { readPath } from "../../Helpers/TableHelpers.js";
 import { isPictureType } from "../../Interfaces/FileInterfaces.js";
 import { getFileAdapter, primaryPictures } from "../../Services/FileApi.js";
@@ -86,6 +86,8 @@ export function useOwnerFiles(params) {
     const [busy, setBusy] = useState(null);
     // Why the image editor could not be opened, the last time it was tried: the input says so until it opens.
     const [editorProblem, setEditorProblem] = useState(null);
+    // The changes a refusal said are left for an owner (`FileAdapter.changesLeft`), with its words; another owner forgets it.
+    const [learned, setLearned] = useState(null);
     const latest = useRef(params);
     latest.current = params;
     const { module, category, ownerId } = params;
@@ -101,9 +103,8 @@ export function useOwnerFiles(params) {
         if (!answer.ok || !answer.result)
             return setStatus({ kind: "failed", message: answer.message ?? "The files could not be loaded." });
         setStatus({ kind: "ready", data: answer.result });
-        const primary = answer.result.files.find(file => file.isPrimary) ?? null;
-        primaryPictures.set(ownerOf(current), primary);
-        return primary;
+        primaryPictures.set(ownerOf(current), answer.result.files.find(file => file.isPrimary) ?? null);
+        return answer.result;
     }, [ownerKey]);
     useEffect(() => {
         if (!ownerKey) {
@@ -121,20 +122,60 @@ export function useOwnerFiles(params) {
     /** Why nothing can be changed, when it is the page's or the backend's rule (not a form shown read only). */
     const readOnlyReason = locked ?? (data && !data.category.canWrite ? data.readOnlyReason || READ_ONLY_REASON : null);
     const pictures = data ? !takesDocuments(data.category) : true;
+    /** A Delete here waits for a review: the page said so, or the backend did. */
+    const holdsRemovals = Boolean(params.holdsRemovals || data?.category.holdsRemovals);
+    // The changes allowed: the page's, narrowed by what a refusal said of this owner ("only added to now").
+    const learnedNow = learned && learned.key === ownerKey ? learned : null;
+    const changes = narrowFileChanges(params.changes, learnedNow?.changes);
+    /** Why only some changes, while some are left out (`fileChangesNote`). */
+    const changesNote = canWrite ? fileChangesNote({ changes: params.changes, reason: params.changesReason }, learnedNow) : null;
+    /** The buttons offered for the owner's files, and for one file when given. */
+    const offer = (file) => ownerFileActions({ canWrite, changes, maxCount: data?.category.maxCount ?? 0, kept: data?.files.length ?? 0, holdsRemovals, keeps: typeof getFileAdapter().keep === "function" }, file);
+    /** "The picture stays until Nexus support approves its removal." for this file. */
+    const nounOf = (file) => (isPictureType(file.contentType) ? "picture" : "file");
+    const heldSentence = (file) => removalHeldSentence(nounOf(file), params.removalReviewer);
+    /** "If the public sees this picture, it stays until Nexus support approves its removal.": the answer decides. */
+    const heldQuestion = (file) => removalHeldQuestion(nounOf(file), params.removalReviewer);
+    /** A Delete held for a review: the file stays, marked, until the list is read again; the person is told once. */
+    function held(file, answered) {
+        const now = typeof answered === "object" && answered !== null && answered.id === file.id ? answered : null;
+        setStatus(current => current.kind !== "ready" ? current : { kind: "ready", data: { ...current.data, files: current.data.files.map(item => (item.id === file.id ? { ...item, ...now, pendingRemoval: true } : item)) } });
+        toast("Removal sent for review", { tone: "info", message: heldSentence(file) });
+    }
+    /**
+     * Says why a change failed, once; a refusal that says the files may now be changed only some ways (a receipt posted
+     * since this page read it) also narrows what is offered for this owner, under its words.
+     */
+    function refused(title, answer) {
+        toastFileFailure(title, answer);
+        const left = getFileAdapter().changesLeft(answer);
+        if (left && ownerKey)
+            setLearned({ key: ownerKey, changes: left, reason: answer.message ?? null });
+    }
+    // What the change under way did, for `onFilesChange` (the last, when it did several: an upload of three files).
+    const done = useRef(null);
+    const noted = (kind, file) => {
+        done.current = { kind, file };
+    };
     /** Runs one change with its line of progress, then reads the files again and tells the page. */
     async function change(label, work) {
         if (busy)
             return;
         setBusy(label);
+        done.current = null;
+        const before = data?.files ?? [];
         try {
             const changed = await work();
             if (changed) {
-                const primary = await load();
-                if (primary !== undefined)
-                    latest.current.onChange?.(primary);
+                const read = await load();
+                if (read)
+                    latest.current.onChange?.(read.files.find(file => file.isPrimary) ?? null);
+                if (done.current)
+                    latest.current.onFilesChange?.(read ? read.files : before, done.current);
             }
         }
         finally {
+            done.current = null;
             setBusy(null);
         }
     }
@@ -150,7 +191,7 @@ export function useOwnerFiles(params) {
      * `replacing`: the file a one-file category keeps, deleted once the editor has saved, since the category has no room
      * for both.
      */
-    async function editAndStore(src, name, primary, replacing) {
+    async function editAndStore(src, name, primary, replacing, edited = false) {
         if (!owner || !data)
             return false;
         const module = await editor(setEditorProblem);
@@ -168,9 +209,16 @@ export function useOwnerFiles(params) {
         if (replacing) {
             const removed = await getFileAdapter().remove(owner, replacing.id);
             if (!removed.ok) {
-                toastFileFailure("The picture was not replaced", removed);
+                refused("The picture was not replaced", removed);
                 return false;
             }
+            // Held for a review (a category not known to hold removals before): it keeps its place, so nothing is uploaded.
+            if (removalHeld(removed.result)) {
+                held(replacing, removed.result);
+                noted("hold", replacing);
+                return true;
+            }
+            noted("delete", replacing);
         }
         const stored = await getFileAdapter().upload(owner, { file: saved.blob, name: pictureName(saved.name || name, saved.blob.type), thumbnail: saved.thumbnail });
         if (!stored.ok || !stored.result) {
@@ -178,11 +226,13 @@ export function useOwnerFiles(params) {
             // A replaced file is gone: the list is read again either way.
             return Boolean(replacing);
         }
-        if (primary && !stored.result.isPrimary) {
+        noted(edited ? "edit" : "upload", stored.result);
+        // A picture may be added where the main one may not be chosen: it is kept, and stays as it is.
+        if (primary && !stored.result.isPrimary && allowsFileChange(changes, "primary")) {
             const made = await getFileAdapter().setPrimary(owner, stored.result.id);
             if (!made.ok) {
                 // Stored all the same: the list is read again, and the person is told once, not also "saved".
-                toastFileFailure("The picture was saved, but it is not the main picture yet", made);
+                refused("The picture was saved, but it is not the main picture yet", made);
                 return true;
             }
         }
@@ -265,8 +315,10 @@ export function useOwnerFiles(params) {
                 }
             }
             const answer = await getFileAdapter().upload(owner, { file: blob, name, thumbnail });
-            if (answer.ok)
+            if (answer.ok) {
                 stored++;
+                noted("upload", answer.result ?? null);
+            }
             else
                 toastFileFailure(`"${file.name}" was not uploaded`, answer);
         }
@@ -283,7 +335,7 @@ export function useOwnerFiles(params) {
          * keeps one file, the new picture takes the place of the one kept (Replace).
          */
         replace: async () => {
-            if (!data)
+            if (!data || !offer().upload)
                 return;
             const replacing = data.category.maxCount === 1 ? data.files[0] : undefined;
             if (!replacing && !hasRoom(data))
@@ -294,7 +346,7 @@ export function useOwnerFiles(params) {
         },
         /** Chooses several files and stores them: each picture through the editor, one at a time (the gallery's Upload). */
         upload: async () => {
-            if (!data || !hasRoom(data))
+            if (!data || !offer().upload || !hasRoom(data))
                 return;
             const chosen = await chooseFiles(acceptOf(data.category), data.category.maxCount > 1);
             if (chosen.length > 0)
@@ -305,22 +357,25 @@ export function useOwnerFiles(params) {
          * that keeps one file, the edited picture takes its place.
          */
         edit: async (file) => {
-            if (!data)
+            if (!data || !offer(file).edit)
                 return;
             const replacing = data.category.maxCount === 1 && data.files.length === 1 ? file : undefined;
             if (!replacing && !hasRoom(data))
                 return;
-            await change("Saving", () => editAndStore(getFileAdapter().fileUrl(file, "original"), file.name, file.isPrimary || Boolean(replacing), replacing));
+            await change("Saving", () => editAndStore(getFileAdapter().fileUrl(file, "original"), file.name, file.isPrimary || Boolean(replacing), replacing, true));
         },
         makePrimary: (file) => owner &&
+            (file ? offer(file).makePrimary : offer().clearPrimary) &&
             change("Saving", async () => {
                 const answer = await getFileAdapter().setPrimary(owner, file?.id ?? null);
                 if (!answer.ok)
-                    toastFileFailure(file ? "This picture could not be made the main one" : "The picture could not be removed", answer);
+                    refused(file ? "This picture could not be made the main one" : "The picture could not be removed", answer);
+                else
+                    noted("primary", file);
                 return answer.ok;
             }),
         rename: async (file) => {
-            if (!owner)
+            if (!owner || !offer(file).rename)
                 return;
             const name = await messageBox.prompt({ title: "Rename", label: "Name", defaultValue: file.name.replace(/\.[A-Za-z][A-Za-z0-9]{0,3}$/, ""), confirmLabel: "Rename" });
             if (name === null || !name.trim())
@@ -328,25 +383,53 @@ export function useOwnerFiles(params) {
             await change("Saving", async () => {
                 const answer = await getFileAdapter().rename(owner, file.id, name.trim());
                 if (!answer.ok)
-                    toastFileFailure("The file was not renamed", answer);
+                    refused("The file was not renamed", answer);
+                else
+                    noted("rename", file);
                 return answer.ok;
             });
         },
         remove: async (file) => {
-            if (!owner)
+            if (!owner || !offer(file).remove)
                 return;
             const yes = await messageBox.confirm({
                 title: `Delete "${file.name}"?`,
-                message: file.isPrimary && (data?.files.length ?? 0) > 1 ? "It is the main picture now; the next one takes its place. It cannot be brought back." : "It cannot be brought back.",
-                tone: "danger",
+                message: holdsRemovals
+                    ? heldQuestion(file)
+                    : file.isPrimary && (data?.files.length ?? 0) > 1
+                        ? "It is the main picture now; the next one takes its place. It cannot be brought back."
+                        : "It cannot be brought back.",
+                tone: holdsRemovals ? "warning" : "danger",
                 confirmLabel: "Delete",
             });
             if (!yes)
                 return;
-            await change("Deleting", async () => {
+            await change(holdsRemovals ? "Sending the removal for review" : "Deleting", async () => {
                 const answer = await getFileAdapter().remove(owner, file.id);
                 if (!answer.ok)
-                    toastFileFailure("The file was not deleted", answer);
+                    refused("The file was not deleted", answer);
+                else if (removalHeld(answer.result)) {
+                    held(file, answer.result);
+                    noted("hold", file);
+                }
+                else
+                    noted("delete", file);
+                return answer.ok;
+            });
+        },
+        /** Keeps a file whose removal waits for a review: the removal is cancelled. */
+        keep: async (file) => {
+            const adapter = getFileAdapter();
+            if (!owner || !adapter.keep || !offer(file).keep)
+                return;
+            await change("Keeping", async () => {
+                const answer = await adapter.keep(owner, file.id);
+                if (!answer.ok)
+                    refused("The removal was not cancelled", answer);
+                else {
+                    toast("Removal cancelled", { tone: "success", message: `"${file.name}" is kept.` });
+                    noted("keep", answer.result ?? file);
+                }
                 return answer.ok;
             });
         },
@@ -365,7 +448,7 @@ export function useOwnerFiles(params) {
             });
         },
     };
-    return { status, data, busy, canWrite, readOnlyReason, pictures, editorProblem, actions };
+    return { status, data, busy, canWrite, readOnlyReason, changes, changesNote, offer, pictures, holdsRemovals, editorProblem, actions };
 }
 const FOCUSABLE = 'button, a[href], input, select, textarea, [tabindex]:not([tabindex="-1"])';
 /**
@@ -450,6 +533,18 @@ export function OwnerPicture({ owner, size = 28, aspect = 1, shape = "rect", lab
     }
     return (_jsx("button", { type: "button", className: classes, style: style, "data-tone": tone, "aria-label": label, title: label, onClick: onClick, onPointerEnter: preloadImageEditor, children: face }));
 }
+/**
+ * "Removal waiting for review" on a file whose Delete waits for a review, a warning tag; when it was asked in the
+ * person's date-time format beside it where there is room (`withTime`), else in its tooltip.
+ */
+function PendingRemoval({ file, when, withTime, className }) {
+    const asked = file.removalAt ? formatDateTime(file.removalAt, when) : "";
+    return (_jsx("span", { className: cx("nx-table__tag", className), "data-tone": "warning", title: asked ? `Removal asked ${asked}` : undefined, children: withTime && asked ? `${PENDING_REMOVAL_TAG} since ${asked}` : PENDING_REMOVAL_TAG }));
+}
+/** Keep, in place of Delete on a file whose removal waits: cancels the removal. */
+function KeepButton({ file, busy, keep, size = "sm" }) {
+    return (_jsx(Button, { size: size, variant: "ghost", icon: _jsx(InlineIcon, { icon: iconArrowBackUp }), "aria-label": `Keep ${file.name}`, title: "Keep it: cancel its removal", ...busyProps(busy, () => void keep(file)), children: "Keep" }));
+}
 /** The held tiles a gallery draws while its pictures are read, so the grid is there at once. */
 const HELD_TILES = [0, 1, 2];
 /** "2 of 20 · PNG, JPEG or WebP, up to 300 KB each": how many are kept, of how many, what kinds and how large. */
@@ -482,7 +577,7 @@ function noRoomReason(owned, replaces = true) {
 export function PictureGallery(props) {
     const files = useOwnerFiles(props);
     const preferences = useDatePreferences();
-    const { status, data, busy, canWrite, readOnlyReason, editorProblem, actions } = files;
+    const { status, data, busy, readOnlyReason, changesNote, offer, editorProblem, actions } = files;
     const rootRef = useRef(null);
     useFocusThroughChange(rootRef, busy);
     // The main picture's original that could not be shown (a file gone since the list was read): the icon stands in.
@@ -509,7 +604,11 @@ export function PictureGallery(props) {
         const owned = data;
         // Held at the limit with its reason, as the pictures' Upload is; pressed, it says the refusal (`hasRoom`).
         const full = noRoomReason(owned, false);
-        return (_jsxs("div", { ref: rootRef, className: "nx-files", "data-state": "ready", "aria-busy": busy ? "true" : undefined, children: [_jsxs("div", { className: "nx-files__bar", children: [_jsx("p", { className: "nx-files__note", "aria-live": "polite", children: busy ? `${busy}…` : limitsLine(owned) }), canWrite && (_jsx(Button, { variant: "primary", size: "sm", icon: _jsx(InlineIcon, { icon: iconUpload }), "aria-disabled": busy || full ? true : undefined, title: full ?? undefined, onClick: () => (busy ? undefined : void actions.upload()), onPointerEnter: preloadImageEditor, children: "Upload" }))] }), readOnlyReason && _jsx("p", { className: "nx-files__note", children: readOnlyReason }), editorProblem && !busy && (_jsx("p", { className: "nx-files__note nx-files__note--error", role: "alert", children: editorProblem })), owned.files.length === 0 ? (_jsxs("div", { className: "nx-files__empty", children: [_jsx(InlineIcon, { icon: iconFileText }), _jsxs("p", { children: ["No ", noun, "s yet."] }), canWrite && _jsxs("p", { className: "nx-files__note", children: ["Upload ", owned.category.maxCount > 1 ? `up to ${owned.category.maxCount}` : "one", "."] })] })) : (_jsx("ul", { className: "nx-files__list", children: owned.files.map(file => (_jsxs("li", { className: "nx-files__row", children: [isPictureType(file.contentType) ? (_jsx("button", { type: "button", className: "nx-picture", style: { "--nx-picture-h": "40px", "--nx-picture-ratio": 1 }, "aria-label": `View ${file.name}`, onClick: () => void actions.view(file), children: _jsx("img", { src: getFileAdapter().fileUrl(file, "thumbnail"), alt: "", loading: "lazy", decoding: "async" }) })) : (_jsx("span", { className: "nx-picture nx-picture--empty", style: { "--nx-picture-h": "40px", "--nx-picture-ratio": 1 }, "aria-hidden": "true", children: _jsx(InlineIcon, { icon: iconFile }) })), _jsxs("div", { className: "nx-files__row-text", children: [_jsx("a", { className: "nx-files__name", href: getFileAdapter().fileUrl(file, "original"), target: "_blank", rel: "noopener", children: file.name }), _jsxs("span", { className: "nx-files__note", children: [fileKindName(file.contentType), " \u00B7 ", fileSizeText(file.size), file.createdAt && ` · ${formatDateTime(file.createdAt, preferences)}`] })] }), canWrite && (_jsxs("div", { className: "nx-files__actions", children: [_jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconPencil }), "aria-label": `Rename ${file.name}`, title: "Rename", ...busyProps(busy, () => void actions.rename(file)) }), _jsx(Button, { size: "sm", variant: "ghost", hoverTone: "danger", icon: _jsx(InlineIcon, { icon: iconTrash }), "aria-label": `Delete ${file.name}`, title: "Delete", ...busyProps(busy, () => void actions.remove(file)) })] }))] }, file.id))) }))] }));
+        const offered = offer();
+        return (_jsxs("div", { ref: rootRef, className: "nx-files", "data-state": "ready", "aria-busy": busy ? "true" : undefined, children: [_jsxs("div", { className: "nx-files__bar", children: [_jsx("p", { className: "nx-files__note", "aria-live": "polite", children: busy ? `${busy}…` : limitsLine(owned) }), offered.upload && (_jsx(Button, { variant: "primary", size: "sm", icon: _jsx(InlineIcon, { icon: iconUpload }), "aria-disabled": busy || full ? true : undefined, title: full ?? undefined, onClick: () => (busy ? undefined : void actions.upload()), onPointerEnter: preloadImageEditor, children: "Upload" }))] }), readOnlyReason && _jsx("p", { className: "nx-files__note", children: readOnlyReason }), changesNote && _jsx("p", { className: "nx-files__note", children: changesNote }), editorProblem && !busy && (_jsx("p", { className: "nx-files__note nx-files__note--error", role: "alert", children: editorProblem })), owned.files.length === 0 ? (_jsxs("div", { className: "nx-files__empty", children: [_jsx(InlineIcon, { icon: iconFileText }), _jsxs("p", { children: ["No ", noun, "s yet."] }), offered.upload && _jsxs("p", { className: "nx-files__note", children: ["Upload ", owned.category.maxCount > 1 ? `up to ${owned.category.maxCount}` : "one", "."] })] })) : (_jsx("ul", { className: "nx-files__list", children: owned.files.map(file => {
+                        const mine = offer(file);
+                        return (_jsxs("li", { className: "nx-files__row", children: [isPictureType(file.contentType) ? (_jsx("button", { type: "button", className: "nx-picture", style: { "--nx-picture-h": "40px", "--nx-picture-ratio": 1 }, "aria-label": `View ${file.name}`, onClick: () => void actions.view(file), children: _jsx("img", { src: getFileAdapter().fileUrl(file, "thumbnail"), alt: "", loading: "lazy", decoding: "async" }) })) : (_jsx("span", { className: "nx-picture nx-picture--empty", style: { "--nx-picture-h": "40px", "--nx-picture-ratio": 1 }, "aria-hidden": "true", children: _jsx(InlineIcon, { icon: iconFile }) })), _jsxs("div", { className: "nx-files__row-text", children: [_jsx("a", { className: "nx-files__name", href: getFileAdapter().fileUrl(file, "original"), target: "_blank", rel: "noopener", children: file.name }), _jsxs("span", { className: "nx-files__note", children: [fileKindName(file.contentType), " \u00B7 ", fileSizeText(file.size), file.createdAt && ` · ${formatDateTime(file.createdAt, preferences)}`] }), file.pendingRemoval && _jsx(PendingRemoval, { file: file, when: preferences, withTime: true })] }), (mine.rename || mine.remove || mine.keep) && (_jsxs("div", { className: "nx-files__actions", children: [mine.rename && _jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconPencil }), "aria-label": `Rename ${file.name}`, title: "Rename", ...busyProps(busy, () => void actions.rename(file)) }), mine.remove && _jsx(Button, { size: "sm", variant: "ghost", hoverTone: "danger", icon: _jsx(InlineIcon, { icon: iconTrash }), "aria-label": `Delete ${file.name}`, title: "Delete", ...busyProps(busy, () => void actions.remove(file)) }), mine.keep && _jsx(KeepButton, { file: file, busy: busy, keep: actions.keep })] }))] }, file.id));
+                    }) }))] }));
     }
     const owned = loading ? null : data;
     const kept = owned?.files ?? [];
@@ -520,7 +619,16 @@ export function PictureGallery(props) {
     const coverUrl = primary ? getFileAdapter().fileUrl(primary, "original") : null;
     const coverShown = coverUrl && coverFailed !== coverUrl;
     const editHeld = busy || noRoom ? true : undefined;
-    return (_jsx("div", { ref: rootRef, className: "nx-files nx-files--panes", "data-state": loading ? "loading" : "ready", "aria-busy": loading || busy ? "true" : undefined, children: _jsxs("div", { className: "nx-files__frame", children: [_jsxs("div", { className: "nx-files__side", children: [_jsx("span", { className: cx("nx-picture", "nx-files__cover", !coverShown && "nx-picture--empty", loading && "nx-picture--loading"), style: shape, role: "img", "aria-label": primary ? `The main picture: ${primary.name}` : loading ? "The main picture" : "No main picture", children: coverShown ? _jsx("img", { src: coverUrl, alt: "", decoding: "async", onError: () => setCoverFailed(coverUrl) }) : _jsx(InlineIcon, { icon: iconPhoto }) }), _jsxs("div", { className: "nx-files__about", children: [canWrite && owned && (_jsxs("div", { className: "nx-files__side-actions", children: [_jsx(Button, { variant: "primary", icon: _jsx(InlineIcon, { icon: iconUpload }), "aria-disabled": busy || noRoom ? true : undefined, title: noRoom ?? undefined, onClick: () => (busy ? undefined : void (single && kept.length > 0 ? actions.replace() : actions.upload())), onPointerEnter: preloadImageEditor, onFocus: preloadImageEditor, children: single && kept.length > 0 ? "Replace" : "Upload" }), primary && (_jsx(Button, { hoverTone: "danger", icon: _jsx(InlineIcon, { icon: single ? iconTrash : iconX }), title: single ? undefined : "Show no picture: the pictures are kept", ...busyProps(busy, () => void (single ? actions.remove(primary) : actions.makePrimary(null))), children: single ? "Delete" : "Remove" }))] })), _jsx("p", { className: "nx-files__note", "aria-live": "polite", children: loading ? `Loading the ${noun}s…` : busy ? `${busy}…` : limitsLine(owned) }), readOnlyReason && _jsx("p", { className: "nx-files__note", children: readOnlyReason }), editorProblem && !busy && (_jsx("p", { className: "nx-files__note nx-files__note--error", role: "alert", children: editorProblem }))] })] }), _jsx("div", { className: "nx-files__pane", children: loading ? (_jsx("ul", { className: "nx-files__grid", style: shape, "aria-hidden": "true", children: HELD_TILES.map(index => (_jsx("li", { children: _jsx("span", { className: "nx-table__bone nx-files__bone" }) }, index))) })) : kept.length === 0 ? (_jsxs("div", { className: "nx-files__empty", children: [_jsx(InlineIcon, { icon: iconPhoto }), _jsxs("p", { children: ["No ", noun, "s yet."] }), canWrite && _jsxs("p", { className: "nx-files__note", children: ["Upload ", owned.category.maxCount > 1 ? `up to ${owned.category.maxCount}` : "one", "."] })] })) : (_jsx("ul", { className: "nx-files__grid", style: shape, "aria-label": props.title ? `${props.title}: pictures` : "Pictures", children: kept.map(file => (_jsxs("li", { className: "nx-files__tile", "data-primary": file.isPrimary || undefined, children: [_jsx("span", { className: "nx-files__thumb", children: _jsx("img", { src: getFileAdapter().fileUrl(file, "thumbnail"), alt: "", loading: "lazy", decoding: "async" }) }), file.isPrimary && (_jsx("span", { className: "nx-table__tag nx-files__mark", "data-tone": "primary", children: "Main" })), _jsxs("div", { className: "nx-files__tools", role: "group", "aria-label": file.isPrimary ? `${file.name}, the main picture` : file.name, children: [_jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconEye }), "aria-label": `View ${file.name}`, title: "View", onClick: () => void actions.view(file), onPointerEnter: preloadImageEditor }), canWrite && !file.isPrimary && _jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconStar }), "aria-label": `Make ${file.name} the main picture`, title: "Make it the main picture", ...busyProps(busy, () => void actions.makePrimary(file)) }), canWrite && (_jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconPencil }), "aria-label": `Edit ${file.name}`, title: noRoom ? `Edit. ${noRoom}` : "Edit: saved as a new picture", "aria-disabled": editHeld, onClick: () => (busy ? undefined : void actions.edit(file)), onPointerEnter: preloadImageEditor, onFocus: preloadImageEditor })), canWrite && !file.isPrimary && _jsx(Button, { size: "sm", variant: "ghost", hoverTone: "danger", icon: _jsx(InlineIcon, { icon: iconTrash }), "aria-label": `Delete ${file.name}`, title: "Delete", ...busyProps(busy, () => void actions.remove(file)) })] })] }, file.id))) })) })] }) }));
+    const offered = owned ? offer() : null;
+    // Beside Upload: Delete in a one-file category (Keep while its removal waits), else Remove (no main picture, the pictures kept).
+    const mainOffer = primary ? offer(primary) : null;
+    const sideKeep = Boolean(single && mainOffer?.keep);
+    const sideRemove = Boolean(primary && offered && (single ? mainOffer?.remove : offered.clearPrimary));
+    return (_jsx("div", { ref: rootRef, className: "nx-files nx-files--panes", "data-state": loading ? "loading" : "ready", "aria-busy": loading || busy ? "true" : undefined, children: _jsxs("div", { className: "nx-files__frame", children: [_jsxs("div", { className: "nx-files__side", children: [_jsx("span", { className: cx("nx-picture", "nx-files__cover", !coverShown && "nx-picture--empty", loading && "nx-picture--loading"), style: shape, role: "img", "aria-label": primary ? `The main picture: ${primary.name}` : loading ? "The main picture" : "No main picture", children: coverShown ? _jsx("img", { src: coverUrl, alt: "", decoding: "async", onError: () => setCoverFailed(coverUrl) }) : _jsx(InlineIcon, { icon: iconPhoto }) }), _jsxs("div", { className: "nx-files__about", children: [offered && (offered.upload || sideRemove || sideKeep) && (_jsxs("div", { className: "nx-files__side-actions", children: [offered.upload && (_jsx(Button, { variant: "primary", icon: _jsx(InlineIcon, { icon: iconUpload }), "aria-disabled": busy || noRoom ? true : undefined, title: noRoom ?? undefined, onClick: () => (busy ? undefined : void (single && kept.length > 0 ? actions.replace() : actions.upload())), onPointerEnter: preloadImageEditor, onFocus: preloadImageEditor, children: single && kept.length > 0 ? "Replace" : "Upload" })), sideRemove && primary && (_jsx(Button, { hoverTone: "danger", icon: _jsx(InlineIcon, { icon: single ? iconTrash : iconX }), title: single ? undefined : "Show no picture: the pictures are kept", ...busyProps(busy, () => void (single ? actions.remove(primary) : actions.makePrimary(null))), children: single ? "Delete" : "Remove" })), sideKeep && primary && _jsx(KeepButton, { file: primary, busy: busy, keep: actions.keep, size: "md" })] })), primary?.pendingRemoval && _jsx(PendingRemoval, { file: primary, when: preferences, withTime: true }), _jsx("p", { className: "nx-files__note", "aria-live": "polite", children: loading ? `Loading the ${noun}s…` : busy ? `${busy}…` : limitsLine(owned) }), readOnlyReason && _jsx("p", { className: "nx-files__note", children: readOnlyReason }), changesNote && _jsx("p", { className: "nx-files__note", children: changesNote }), editorProblem && !busy && (_jsx("p", { className: "nx-files__note nx-files__note--error", role: "alert", children: editorProblem }))] })] }), _jsx("div", { className: "nx-files__pane", children: loading ? (_jsx("ul", { className: "nx-files__grid", style: shape, "aria-hidden": "true", children: HELD_TILES.map(index => (_jsx("li", { children: _jsx("span", { className: "nx-table__bone nx-files__bone" }) }, index))) })) : kept.length === 0 ? (_jsxs("div", { className: "nx-files__empty", children: [_jsx(InlineIcon, { icon: iconPhoto }), _jsxs("p", { children: ["No ", noun, "s yet."] }), offered?.upload && _jsxs("p", { className: "nx-files__note", children: ["Upload ", owned.category.maxCount > 1 ? `up to ${owned.category.maxCount}` : "one", "."] })] })) : (_jsx("ul", { className: "nx-files__grid", style: shape, "aria-label": props.title ? `${props.title}: pictures` : "Pictures", children: kept.map(file => {
+                            const mine = offer(file);
+                            const about = [file.name, file.isPrimary && "the main picture", file.pendingRemoval && PENDING_REMOVAL_TAG.toLowerCase()].filter(Boolean).join(", ");
+                            return (_jsxs("li", { className: "nx-files__tile", "data-primary": file.isPrimary || undefined, "data-pending": file.pendingRemoval || undefined, children: [_jsxs("span", { className: "nx-files__thumb", children: [_jsx("img", { src: getFileAdapter().fileUrl(file, "thumbnail"), alt: "", loading: "lazy", decoding: "async" }), file.pendingRemoval && _jsx(PendingRemoval, { file: file, when: preferences, className: "nx-files__pending" })] }), file.isPrimary && (_jsx("span", { className: "nx-table__tag nx-files__mark", "data-tone": "primary", children: "Main" })), _jsxs("div", { className: "nx-files__tools", role: "group", "aria-label": about, children: [_jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconEye }), "aria-label": `View ${file.name}`, title: "View", onClick: () => void actions.view(file), onPointerEnter: preloadImageEditor }), mine.makePrimary && _jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconStar }), "aria-label": `Make ${file.name} the main picture`, title: "Make it the main picture", ...busyProps(busy, () => void actions.makePrimary(file)) }), mine.edit && (_jsx(Button, { size: "sm", variant: "ghost", icon: _jsx(InlineIcon, { icon: iconPencil }), "aria-label": `Edit ${file.name}`, title: noRoom ? `Edit. ${noRoom}` : "Edit: saved as a new picture", "aria-disabled": editHeld, onClick: () => (busy ? undefined : void actions.edit(file)), onPointerEnter: preloadImageEditor, onFocus: preloadImageEditor })), mine.remove && !file.isPrimary && _jsx(Button, { size: "sm", variant: "ghost", hoverTone: "danger", icon: _jsx(InlineIcon, { icon: iconTrash }), "aria-label": `Delete ${file.name}`, title: "Delete", ...busyProps(busy, () => void actions.remove(file)) }), mine.keep && _jsx(KeepButton, { file: file, busy: busy, keep: actions.keep })] })] }, file.id));
+                        }) })) })] }) }));
 }
 /** An owner's documents as a list: `PictureGallery` with `view="documents"`. */
 export function DocumentList(props) {
@@ -558,11 +666,13 @@ export function openPictureGallery({ popupTitle, ...props }) {
 /**
  * A column with each row's picture: every visible row's read in one call per page, and a click opens the row's
  * gallery. A change there redraws the row's picture without a reload.
+ * It is a `lead` column: every table draws it first of the page's columns (after the row number), pinned on the left
+ * when the page pins others there, wherever it stands in `columns`, until the user moves, unpins or hides it.
  *
  * @example
  * columns: [pictureColumn({ module: NexusModule.Enterprise, category: "branch-picture", rowTitle: row => row.branchName }), ...]
  */
-export function pictureColumn({ module, category, ownerKey = "id", rowTitle, nameKey, lockReason, onChange, aspect, shape, maxWidth, maxHeight, type, quality, readOnly, view, ...column }) {
+export function pictureColumn({ module, category, ownerKey = "id", rowTitle, nameKey, lockReason, onChange, aspect, shape, maxWidth, maxHeight, type, quality, readOnly, changes, changesReason, holdsRemovals, removalReviewer, view, ...column }) {
     return {
         key: "picture",
         label: "Picture",
@@ -571,6 +681,7 @@ export function pictureColumn({ module, category, ownerKey = "id", rowTitle, nam
         sortable: false,
         searchable: false,
         resizable: false,
+        lead: true,
         ...column,
         value: () => null,
         render: row => {
@@ -582,7 +693,7 @@ export function pictureColumn({ module, category, ownerKey = "id", rowTitle, nam
             const owner = { module, category, ownerId };
             const named = nameKey ? readPath(row, nameKey) : null;
             const locked = typeof lockReason === "function" ? lockReason(row) : lockReason;
-            return (_jsx(OwnerPicture, { owner: owner, aspect: aspect, shape: shape, name: typeof named === "string" ? named : null, label: title ? `${title}: pictures` : "Pictures", onClick: () => openPictureGallery({ ...owner, title, aspect, shape, maxWidth, maxHeight, type, quality, readOnly, lockReason: locked ?? null, view, onChange: primary => onChange?.(row, primary) }) }));
+            return (_jsx(OwnerPicture, { owner: owner, aspect: aspect, shape: shape, name: typeof named === "string" ? named : null, label: title ? `${title}: pictures` : "Pictures", onClick: () => openPictureGallery({ ...owner, title, aspect, shape, maxWidth, maxHeight, type, quality, readOnly, changes, changesReason, holdsRemovals, removalReviewer, lockReason: locked ?? null, view, onChange: primary => onChange?.(row, primary) }) }));
         },
         text: () => "",
     };

package/dist/Helpers/ApiModules.js

@@ -117,6 +117,9 @@ export const NEXUS_MODULES = [
     { module: NexusModule.Message, key: "message", label: "Message", env: "API_MESSAGE" },
     { module: NexusModule.Chat, key: "chat", label: "Chat", env: "API_CHAT" },
     { module: NexusModule.Accounting, key: "accounting", label: "Accounting", env: "API_ACCOUNTING" },
+    // Retired on 2026-11-11 (`NexusModule.Report` is deprecated): kept so the list's published entries do not change in a
+    // minor and an old proxy URL (/api/app/report/...) is still known. An app sets no API_REPORT, and a list a person
+    // picks a module from leaves it out (`info.module !== NexusModule.Report`).
     { module: NexusModule.Report, key: "report", label: "Report", env: "API_REPORT" },
     { module: NexusModule.Requisition, key: "requisition", label: "Requisition", env: "API_REQUISITION" },
     { module: NexusModule.Tenant, key: "tenant", label: "Tenant", env: "API_TENANT" },
@@ -126,6 +129,7 @@ export const NEXUS_MODULES = [
     { module: NexusModule.Pharmacy, key: "pharmacy", label: "Pharmacy", env: "API_PHARMACY" },
     { module: NexusModule.Staffing, key: "staffing", label: "Staffing", env: "API_STAFFING" },
     { module: NexusModule.Portfolio, key: "portfolio", label: "Portfolio", env: "API_PORTFOLIO" },
+    { module: NexusModule.Inventory, key: "inventory", label: "Inventory", env: "API_INVENTORY" },
     // The app's own API routes (/api/...), never through the proxy.
     { module: NexusModule.None, key: "app", label: "App" },
 ];

package/dist/Helpers/AuditEntries.d.ts

@@ -0,0 +1,50 @@
+/** An entry as far as its person goes: their token, and their name when the history's answer carries it. */
+export interface AuditActor {
+    creatorUserId?: string | null;
+    creatorName?: string | null;
+}
+/**
+ * A token, short. It names nobody and only tells two apart, so its first characters are enough. A token is the same
+ * text for one id on every entry this reader is given (the id is encrypted for the reader, not at random).
+ */
+export declare const shortToken: (token: string) => string;
+/**
+ * Names the people behind a history's tokens: given the tokens of entries the answer names nobody for, the app answers
+ * `{ [token]: "Sita Rai (sita.rai)" }` - the whole text the line shows after "by". A token it leaves out keeps its short
+ * form.
+ */
+export type AuditActorNamesResolver = (tokens: string[], signal: AbortSignal) => Promise<Record<string, string>>;
+/**
+ * Sets, once for the app, how a record's history (`AuditHistory`) names the person behind an entry its answer names
+ * nobody for (no `creatorName`). The history collects the tokens of every page it shows (the first and each "Show
+ * more"), asks once per page for those it has had no answer for, and says "by Sita Rai (sita.rai)" for each one
+ * answered. A token is the same text for one person on every entry this reader is given, so the app can look it up (its
+ * own list of people, or a call to the server that made it). A call that fails keeps the line's "User 3fA9b2…" and is
+ * asked again by the next history; a token left out of the answer keeps it for the page's life. Answers are kept for the
+ * page's life; `null` stops asking and forgets them.
+ *
+ * @example
+ * setAuditActorNames(async (tokens, signal) => {
+ *   const answer = await api.post<Record<string, string>>(USERS.names, tokens, { signal, toast: false });
+ *   return answer.ok ? answer.result : {};
+ * });
+ */
+export declare function setAuditActorNames(resolver: AuditActorNamesResolver | null): void;
+/** The name the app gave for a token, once it has given one. */
+export declare const knownAuditActorName: (token: string | null | undefined) => string | undefined;
+/**
+ * The tokens of these entries the app is still to be asked for: entries with no name in the answer, whose token has had
+ * no answer yet, each token once. Empty without a resolver.
+ */
+export declare function unnamedAuditActors(entries: readonly AuditActor[]): string[];
+/**
+ * Asks the app, in one call, for the names of these entries' unnamed people (`unnamedAuditActors`) and keeps the answer.
+ * Resolves `true` when it learnt a name. A failed or aborted call keeps nothing, so a later history asks again.
+ */
+export declare function resolveAuditActors(entries: readonly AuditActor[], signal: AbortSignal): Promise<boolean>;
+/**
+ * Who made a change, as the entry's line says it: "by Sita Rai" when the history's answer names them (`creatorName`) or
+ * the app has named their token (`setAuditActorNames`), else the start of their token ("User 3fA9b2…"), which still
+ * tells two people apart; `null` when it says neither.
+ */
+export declare function auditActorText(entry: AuditActor): string | null;

package/dist/Helpers/AuditEntries.js

@@ -0,0 +1,96 @@
+/*
+ * The words of a record's history entry (Components/Forms/CrudHistory.tsx) that are worked out rather than drawn, so Node
+ * tests run them, and the app's way of naming the people behind the entries' tokens. Only `setAuditActorNames` and its
+ * type are exported from the package.
+ */
+/**
+ * A token, short. It names nobody and only tells two apart, so its first characters are enough. A token is the same
+ * text for one id on every entry this reader is given (the id is encrypted for the reader, not at random).
+ */
+export const shortToken = (token) => (token.length > 8 ? `${token.slice(0, 6)}…` : token);
+let actorResolver = null;
+/** What the app answered, by token, for the page's life: a second history asks only for the people it has not seen. */
+const actorNames = new Map();
+/** Tokens the app answered nothing for: not asked again, so a history full of one stranger never asks on every page. */
+const actorUnknown = new Set();
+/**
+ * Sets, once for the app, how a record's history (`AuditHistory`) names the person behind an entry its answer names
+ * nobody for (no `creatorName`). The history collects the tokens of every page it shows (the first and each "Show
+ * more"), asks once per page for those it has had no answer for, and says "by Sita Rai (sita.rai)" for each one
+ * answered. A token is the same text for one person on every entry this reader is given, so the app can look it up (its
+ * own list of people, or a call to the server that made it). A call that fails keeps the line's "User 3fA9b2…" and is
+ * asked again by the next history; a token left out of the answer keeps it for the page's life. Answers are kept for the
+ * page's life; `null` stops asking and forgets them.
+ *
+ * @example
+ * setAuditActorNames(async (tokens, signal) => {
+ *   const answer = await api.post<Record<string, string>>(USERS.names, tokens, { signal, toast: false });
+ *   return answer.ok ? answer.result : {};
+ * });
+ */
+export function setAuditActorNames(resolver) {
+    actorResolver = resolver;
+    actorNames.clear();
+    actorUnknown.clear();
+}
+/** The name the app gave for a token, once it has given one. */
+export const knownAuditActorName = (token) => (token ? actorNames.get(token) : undefined);
+/**
+ * The tokens of these entries the app is still to be asked for: entries with no name in the answer, whose token has had
+ * no answer yet, each token once. Empty without a resolver.
+ */
+export function unnamedAuditActors(entries) {
+    if (!actorResolver)
+        return [];
+    const tokens = new Set();
+    for (const entry of entries) {
+        const token = entry.creatorUserId;
+        if (!token || entry.creatorName?.trim() || actorNames.has(token) || actorUnknown.has(token))
+            continue;
+        tokens.add(token);
+    }
+    return [...tokens];
+}
+/**
+ * Asks the app, in one call, for the names of these entries' unnamed people (`unnamedAuditActors`) and keeps the answer.
+ * Resolves `true` when it learnt a name. A failed or aborted call keeps nothing, so a later history asks again.
+ */
+export async function resolveAuditActors(entries, signal) {
+    const resolver = actorResolver;
+    const tokens = unnamedAuditActors(entries);
+    if (!resolver || tokens.length === 0)
+        return false;
+    let answer;
+    try {
+        answer = await resolver(tokens, signal);
+    }
+    catch {
+        return false;
+    }
+    // The history went away, or the app set another resolver meanwhile: this answer is not kept.
+    if (signal.aborted || resolver !== actorResolver)
+        return false;
+    let learnt = false;
+    for (const token of tokens) {
+        const given = answer?.[token];
+        const name = typeof given === "string" ? given.trim() : "";
+        if (name) {
+            actorNames.set(token, name);
+            learnt = true;
+        }
+        else
+            actorUnknown.add(token);
+    }
+    return learnt;
+}
+/**
+ * Who made a change, as the entry's line says it: "by Sita Rai" when the history's answer names them (`creatorName`) or
+ * the app has named their token (`setAuditActorNames`), else the start of their token ("User 3fA9b2…"), which still
+ * tells two people apart; `null` when it says neither.
+ */
+export function auditActorText(entry) {
+    const name = entry.creatorName?.trim() || knownAuditActorName(entry.creatorUserId);
+    if (name)
+        return `by ${name}`;
+    return entry.creatorUserId ? `User ${shortToken(entry.creatorUserId)}` : null;
+}

package/dist/Helpers/ChatBackend.d.ts

@@ -1,5 +1,5 @@
 import { type ApiEndpoint, type ApiModuleValue } from "../Interfaces/ApiInterfaces.ts";
-import type { AppChatDomain, ChatConversation, ChatDomainInfo, ChatDomainValue, ChatDraft, ChatHistory, ChatHistoryRequest, ChatId, ChatMessage, ChatParticipant, ChatParticipantPage, ChatParticipantQuery, ChatScope, ChatSummary, NewChatRequest } from "../Interfaces/ChatInterfaces.ts";
+import type { AppChatDomain, ChatConversation, ChatDomainInfo, ChatDomainValue, ChatDraft, ChatHistory, ChatHistoryRequest, ChatId, ChatMessage, ChatMessageKind, ChatParticipant, ChatParticipantPage, ChatParticipantQuery, ChatScope, ChatSummary, NewChatRequest } from "../Interfaces/ChatInterfaces.ts";
 /** The actions a chat needs from a backend. A backend that does not serve one takes that feature off the panel. */
 export declare const CHAT_ACTIONS: {
     /** The conversations a record holds, for this reader. */
@@ -106,6 +106,11 @@ export declare class NexusChatBackend<TDomain extends ChatDomainValue = AppChatD
     protected toConversation(row: Row): ChatConversation;
     /** One message row. The names are the ones a Nexus contract uses; override this alone for a backend that differs. */
     protected toMessage(row: Row): ChatMessage;
+    /**
+     * What a message is, from the backend's `EChatMessageTypes` (0 a chat line, 1 the mail a thread opens with, 2 a
+     * notification) or a word. Anything else is a chat line.
+     */
+    protected toKind(value: unknown): ChatMessageKind;
     /** One set of counts. */
     protected toSummary(row: Row): ChatSummary;
     /** One participant row. */
@@ -125,6 +130,8 @@ export declare function getChatBackend(): ChatBackend<any>;
  *   { domain: EDomainTypes.Leave, key: "leave", label: "Leave request" },
  *   { domain: EDomainTypes.Procurement, key: "procurement", label: "Purchase order" },
  * ]);
+ *
+ * A row's `card` shows a message's record as a card read live from its module (`domainCard`, `DomainCard`).
  */
 export declare function defineChatDomains<TDomain extends ChatDomainValue>(list: readonly ChatDomainInfo<TDomain>[]): readonly ChatDomainInfo<TDomain>[];
 /** The registered domains. Empty until an app calls `defineChatDomains`. */

package/dist/Helpers/ChatBackend.js

@@ -254,10 +254,23 @@ export class NexusChatBackend extends ChatBackend {
                 })),
             }),
             ...(row.isSystem === true && { isSystem: true }),
+            ...((row.messageType ?? row.kind) !== undefined && { kind: this.toKind(row.messageType ?? row.kind) }),
             ...(Array.isArray(row.deliveredTo) && { deliveredTo: row.deliveredTo.map(id).filter((value) => value !== null) }),
             ...(Array.isArray(row.readBy) && { readBy: row.readBy.map(id).filter((value) => value !== null) }),
         };
     }
+    /**
+     * What a message is, from the backend's `EChatMessageTypes` (0 a chat line, 1 the mail a thread opens with, 2 a
+     * notification) or a word. Anything else is a chat line.
+     */
+    toKind(value) {
+        const written = String(value).toLowerCase();
+        if (written === "1" || written === "mail")
+            return "mail";
+        if (written === "2" || written === "notification")
+            return "notification";
+        return "chat";
+    }
     /** One set of counts. */
     toSummary(row) {
         const lastText = text(row.lastMessageText ?? row.lastMessage ?? row.lastBody);
@@ -309,6 +322,8 @@ let domains = [];
  *   { domain: EDomainTypes.Leave, key: "leave", label: "Leave request" },
  *   { domain: EDomainTypes.Procurement, key: "procurement", label: "Purchase order" },
  * ]);
+ *
+ * A row's `card` shows a message's record as a card read live from its module (`domainCard`, `DomainCard`).
  */
 export function defineChatDomains(list) {
     const seen = new Set();
@@ -317,6 +332,9 @@ export function defineChatDomains(list) {
         if (seen.has(key))
             throw new Error(`Two chat domains have the value ${key}.`);
         seen.add(key);
+        if (info.card && (typeof info.card.load !== "function" || typeof info.card.view !== "function")) {
+            throw new Error(`The chat domain ${key}'s card needs a load and a view.`);
+        }
     }
     domains = list;
     return list;