nucleus-core-ts 0.10.115 → 0.10.117

package/dist/.build-ok

@@ -1 +1 @@
-0.10.115
+0.10.117

package/dist/fe/components/VerificationFlowPage/components/PendingTab.d.ts

@@ -9,6 +9,9 @@ interface PendingTabProps {
     onDecisionMade?: (entityName: string, entityId: string) => void;
     /** Spread over the English defaults; omit it and the tab stays English. */
     labels?: Partial<VerificationFlowLabels>;
+    /** Names the record a decision is about. See `VerificationFlowPageProps`. */
+    describeEntity?: (entityName: string, entityId: string) => string | undefined;
+    entityHref?: (entityName: string, entityId: string) => string | undefined;
 }
-export declare function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, }: PendingTabProps): ReactElement;
+export declare function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref, }: PendingTabProps): ReactElement;
 export {};

package/dist/fe/components/VerificationFlowPage/components/PendingTab.js

@@ -5,11 +5,26 @@ import { DEFAULT_VERIFICATION_FLOW_LABELS } from '../labels';
 import { useVerificationFlowStore } from '../store';
 import { getActiveTheme } from '../theme/store';
 import { planDecision, signatureFileType } from './decisionPlan';
-export function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels }) {
+export function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref }) {
     // Local, not in the store: only one card is in deciding mode at a time, and
     // a chosen file must not survive cancelling out of that card.
     const [signatureFile, setSignatureFile] = useState(null);
-    const [signatureNote, setSignatureNote] = useState(null);
+    /*
+   * Renamed from `signatureNote`, and that is the whole bug.
+   *
+   * It carried every engine refusal — wrong role, already signed an earlier
+   * step, account switched off — but its ONE render site sat inside the
+   * `require_signature` branch. On a step that needs no signature (the
+   * ordinary case) pressing Approve wrote the refusal into state that nothing
+   * rendered: the card stayed open, nothing was recorded, and the reviewer was
+   * told nothing at all. It is now its own always-rendered block.
+   */ const [decisionNote, setDecisionNote] = useState(null);
+    /*
+   * A queue that could not be READ is not an empty queue. Both failure paths
+   * used to call `setPendingItems([])`, so a 500, an expired session and a
+   * genuinely clear queue all rendered the same reassuring tick and
+   * "No pending verifications".
+   */ const [loadError, setLoadError] = useState(null);
     const theme = getActiveTheme();
     const say = {
         ...DEFAULT_VERIFICATION_FLOW_LABELS,
@@ -18,6 +33,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
     const store = useVerificationFlowStore();
     const loadPending = useEffectEvent(()=>{
         store.setLoadingPending(true);
+        setLoadError(null);
         pendingAction.start({
             payload: undefined,
             onAfterHandle: (res)=>{
@@ -25,6 +41,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 if (response.success === false) {
                     console.error('[PendingTab] API returned success=false:', res);
                     store.setPendingItems([]);
+                    setLoadError(response.message || say.pendingLoadFailedBody);
                     store.setLoadingPending(false);
                     return;
                 }
@@ -36,6 +53,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 const msg = errObj?.message || errObj?.error || JSON.stringify(err);
                 console.error(`[PendingTab] Pending error (HTTP ${code ?? '?'}):`, msg);
                 store.setPendingItems([]);
+                setLoadError(typeof msg === 'string' ? msg : say.pendingLoadFailedBody);
                 store.setLoadingPending(false);
             }
         });
@@ -72,19 +90,19 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
            * already says exactly what is wrong, and a reviewer can act on
            * "cannot decide it" in a way they cannot act on "something failed".
            */ if (res && res.success === false) {
-                    setSignatureNote(res.message || say.decisionRefused);
+                    setDecisionNote(res.message || say.decisionRefused);
                     return;
                 }
                 store.setDecidingId(null);
                 store.setDecisionReason('');
                 setSignatureFile(null);
-                setSignatureNote(null);
+                setDecisionNote(null);
                 onDecisionMade?.(item.entity_name, item.entity_id);
                 loadPending();
             },
             onErrorHandle: (err)=>{
                 const msg = err?.message;
-                setSignatureNote(msg || say.decisionRefused);
+                setDecisionNote(msg || say.decisionRefused);
             }
         });
     });
@@ -99,7 +117,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
    * uploaded as the signed-in user and only its id is sent. A rejection needs
    * no signature: you do not sign what you are refusing.
    */ const handleDecide = useEffectEvent((item, decision)=>{
-        setSignatureNote(null);
+        setDecisionNote(null);
         const plan = planDecision({
             decision,
             requireSignature: item.require_signature,
@@ -111,7 +129,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
             return;
         }
         if (plan.kind === 'blocked') {
-            setSignatureNote(plan.reason === 'no-upload-action' ? say.signatureUnavailable : say.signatureMissing);
+            setDecisionNote(plan.reason === 'no-upload-action' ? say.signatureUnavailable : say.signatureMissing);
             return;
         }
         if (!uploadSignatureAction || !signatureFile) return;
@@ -126,7 +144,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
             extension: signatureFile.name.split('.').pop() || '',
             type: signatureFileType(signatureFile.type)
         }));
-        setSignatureNote(say.signatureUploading);
+        setDecisionNote(say.signatureUploading);
         uploadSignatureAction.start({
             payload: form,
             onAfterHandle: (res)=>{
@@ -134,12 +152,12 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 if (!id) {
                     // Reported, never swallowed: a decision that silently did not happen
                     // is worse than one that failed loudly.
-                    setSignatureNote(say.signatureUploadFailed);
+                    setDecisionNote(say.signatureUploadFailed);
                     return;
                 }
                 sendDecision(item, decision, id);
             },
-            onErrorHandle: ()=>setSignatureNote(say.signatureUploadFailed)
+            onErrorHandle: ()=>setDecisionNote(say.signatureUploadFailed)
         });
     });
     if (store.isLoadingPending) {
@@ -150,6 +168,36 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
             })
         });
     }
+    /*
+   * The failure state comes FIRST, and it is a different screen from the
+   * empty one. "You have nothing to approve" is a fact a reviewer acts on by
+   * going away; "we could not ask" is one they act on by trying again.
+   */ if (loadError) {
+        return /*#__PURE__*/ _jsxs("div", {
+            className: theme.pending.failure.container,
+            role: "alert",
+            children: [
+                /*#__PURE__*/ _jsx("p", {
+                    className: theme.pending.failure.title,
+                    children: say.pendingLoadFailedTitle
+                }),
+                /*#__PURE__*/ _jsx("p", {
+                    className: theme.pending.failure.text,
+                    children: say.pendingLoadFailedBody
+                }),
+                /*#__PURE__*/ _jsx("p", {
+                    className: theme.pending.failure.text,
+                    children: loadError
+                }),
+                /*#__PURE__*/ _jsx("button", {
+                    type: "button",
+                    onClick: ()=>loadPending(),
+                    className: theme.pending.failure.button,
+                    children: say.retry
+                })
+            ]
+        });
+    }
     if (store.pendingItems.length === 0) {
         return /*#__PURE__*/ _jsxs("div", {
             className: theme.pending.empty.container,
@@ -185,89 +233,109 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 className: theme.pending.title,
                 children: say.pendingApprovals(store.pendingItems.length)
             }),
-            store.pendingItems.map((item)=>/*#__PURE__*/ _jsx("div", {
+            store.pendingItems.map((item)=>/*#__PURE__*/ _jsxs("div", {
                     className: theme.pending.card.container,
-                    children: /*#__PURE__*/ _jsxs("div", {
-                        className: "flex items-center justify-between",
-                        children: [
-                            /*#__PURE__*/ _jsxs("div", {
-                                children: [
-                                    /*#__PURE__*/ _jsx("p", {
-                                        className: theme.pending.card.title,
-                                        children: say.pendingCardTitle(item.flow_name, item.step_order)
-                                    }),
-                                    /*#__PURE__*/ _jsxs("p", {
-                                        className: theme.pending.card.subtitle,
-                                        children: [
-                                            item.entity_name,
-                                            "/",
-                                            item.entity_id
-                                        ]
-                                    })
-                                ]
-                            }),
-                            store.decidingId === item.instance_id ? /*#__PURE__*/ _jsxs("div", {
-                                className: theme.pending.card.actions,
-                                children: [
-                                    item.require_signature ? /*#__PURE__*/ _jsxs("label", {
-                                        className: "flex flex-col gap-1 text-xs",
-                                        children: [
-                                            /*#__PURE__*/ _jsx("span", {
-                                                children: say.signaturePrompt
-                                            }),
-                                            /*#__PURE__*/ _jsx("input", {
-                                                type: "file",
-                                                onChange: (e)=>{
-                                                    setSignatureFile(e.target.files?.[0] ?? null);
-                                                    setSignatureNote(null);
-                                                },
-                                                className: theme.pending.input
-                                            }),
-                                            signatureNote ? /*#__PURE__*/ _jsx("span", {
-                                                className: "text-red-600",
-                                                children: signatureNote
-                                            }) : null
-                                        ]
-                                    }) : null,
-                                    /*#__PURE__*/ _jsx("input", {
-                                        type: "text",
-                                        placeholder: say.reasonPlaceholder,
-                                        value: store.decisionReason,
-                                        onChange: (e)=>store.setDecisionReason(e.target.value),
-                                        className: theme.pending.input
-                                    }),
-                                    /*#__PURE__*/ _jsx("button", {
-                                        type: "button",
-                                        onClick: ()=>handleDecide(item, 'approved'),
-                                        className: theme.pending.approveButton,
-                                        children: say.approve
-                                    }),
-                                    /*#__PURE__*/ _jsx("button", {
-                                        type: "button",
-                                        onClick: ()=>handleDecide(item, 'rejected'),
-                                        className: theme.pending.rejectButton,
-                                        children: say.reject
-                                    }),
-                                    /*#__PURE__*/ _jsx("button", {
-                                        type: "button",
-                                        onClick: ()=>{
-                                            store.setDecidingId(null);
-                                            store.setDecisionReason('');
-                                            setSignatureFile(null);
-                                            setSignatureNote(null);
-                                        },
-                                        className: theme.pending.cancelButton,
-                                        children: say.cancel
-                                    })
-                                ]
-                            }) : /*#__PURE__*/ _jsx("button", {
-                                type: "button",
-                                onClick: ()=>store.setDecidingId(item.instance_id),
-                                className: theme.pending.reviewButton,
-                                children: say.review
-                            })
-                        ]
-                    })
+                    children: [
+                        /*#__PURE__*/ _jsxs("div", {
+                            className: "flex flex-wrap items-start justify-between gap-3",
+                            children: [
+                                /*#__PURE__*/ _jsxs("div", {
+                                    className: "min-w-0",
+                                    children: [
+                                        /*#__PURE__*/ _jsx("p", {
+                                            className: theme.pending.card.title,
+                                            children: say.pendingCardTitle(item.flow_name, item.step_order)
+                                        }),
+                                        item.step_name ? /*#__PURE__*/ _jsx("p", {
+                                            className: theme.pending.card.subtitle,
+                                            children: item.step_name
+                                        }) : null,
+                                        /*#__PURE__*/ _jsxs("span", {
+                                            className: theme.pending.card.recordRow,
+                                            children: [
+                                                /*#__PURE__*/ _jsx("span", {
+                                                    className: theme.pending.card.recordLabel,
+                                                    children: say.pendingRecordLabel
+                                                }),
+                                                /*#__PURE__*/ _jsx("span", {
+                                                    className: theme.pending.card.recordValue,
+                                                    children: describeEntity?.(item.entity_name, item.entity_id) ?? `${item.entity_name}/${item.entity_id}`
+                                                }),
+                                                entityHref?.(item.entity_name, item.entity_id) ? /*#__PURE__*/ _jsx("a", {
+                                                    href: entityHref(item.entity_name, item.entity_id),
+                                                    target: "_blank",
+                                                    rel: "noopener noreferrer",
+                                                    className: theme.pending.card.recordLink,
+                                                    children: say.openRecord
+                                                }) : null
+                                            ]
+                                        })
+                                    ]
+                                }),
+                                store.decidingId === item.instance_id ? /*#__PURE__*/ _jsxs("div", {
+                                    className: theme.pending.card.actions,
+                                    children: [
+                                        item.require_signature ? /*#__PURE__*/ _jsxs("label", {
+                                            className: "flex flex-col gap-1 text-xs",
+                                            children: [
+                                                /*#__PURE__*/ _jsx("span", {
+                                                    children: say.signaturePrompt
+                                                }),
+                                                /*#__PURE__*/ _jsx("input", {
+                                                    type: "file",
+                                                    onChange: (e)=>{
+                                                        setSignatureFile(e.target.files?.[0] ?? null);
+                                                        setDecisionNote(null);
+                                                    },
+                                                    className: theme.pending.input
+                                                })
+                                            ]
+                                        }) : null,
+                                        /*#__PURE__*/ _jsx("input", {
+                                            type: "text",
+                                            placeholder: say.reasonPlaceholder,
+                                            value: store.decisionReason,
+                                            onChange: (e)=>store.setDecisionReason(e.target.value),
+                                            className: theme.pending.input
+                                        }),
+                                        /*#__PURE__*/ _jsx("button", {
+                                            type: "button",
+                                            onClick: ()=>handleDecide(item, 'approved'),
+                                            className: theme.pending.approveButton,
+                                            children: say.approve
+                                        }),
+                                        /*#__PURE__*/ _jsx("button", {
+                                            type: "button",
+                                            onClick: ()=>handleDecide(item, 'rejected'),
+                                            className: theme.pending.rejectButton,
+                                            children: say.reject
+                                        }),
+                                        /*#__PURE__*/ _jsx("button", {
+                                            type: "button",
+                                            onClick: ()=>{
+                                                store.setDecidingId(null);
+                                                store.setDecisionReason('');
+                                                setSignatureFile(null);
+                                                setDecisionNote(null);
+                                            },
+                                            className: theme.pending.cancelButton,
+                                            children: say.cancel
+                                        })
+                                    ]
+                                }) : /*#__PURE__*/ _jsx("button", {
+                                    type: "button",
+                                    onClick: ()=>store.setDecidingId(item.instance_id),
+                                    className: theme.pending.reviewButton,
+                                    children: say.review
+                                })
+                            ]
+                        }),
+                        store.decidingId === item.instance_id && decisionNote ? /*#__PURE__*/ _jsx("p", {
+                            className: theme.pending.notice,
+                            role: "alert",
+                            children: decisionNote
+                        }) : null
+                    ]
                 }, `${item.instance_id}-${item.step_order}`))
         ]
     });

package/dist/fe/components/VerificationFlowPage/components/PropertiesPanel.d.ts

@@ -34,6 +34,8 @@ interface PropertiesPanelProps {
     panelTheme: VerificationFlowPageTheme['propertiesPanel'];
     /** Spread over the English defaults; omit it and the panel stays English. */
     labels?: Partial<VerificationFlowLabels>;
+    /** The channels this install can deliver on. Omit = all five, as before. */
+    availableChannels?: NotificationChannel[];
 }
-export declare function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode, onClose, listUsersAction, listRolesAction, panelTheme, labels, }: PropertiesPanelProps): ReactElement;
+export declare function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode, onClose, listUsersAction, listRolesAction, panelTheme, labels, availableChannels, }: PropertiesPanelProps): ReactElement;
 export {};

package/dist/fe/components/VerificationFlowPage/components/PropertiesPanel.js

@@ -28,10 +28,11 @@ const ALL_RECIPIENT_TYPES = [
     'user'
 ];
 // ─── Channel Multi-Select ─────────────────────────────────────────
-function ChannelMultiSelect({ selected, onChange, msTheme, say }) {
+function ChannelMultiSelect({ selected, onChange, msTheme, say, available }) {
     const theme = msTheme;
     const channelLabels = notificationChannelLabels(say);
     const [isOpen, setIsOpen] = useState(false);
+    const canDeliver = (ch)=>!available || available.includes(ch);
     const toggle = (channel)=>{
         if (selected.includes(channel)) {
             onChange(selected.filter((c)=>c !== channel));
@@ -91,15 +92,28 @@ function ChannelMultiSelect({ selected, onChange, msTheme, say }) {
             }),
             isOpen && /*#__PURE__*/ _jsx("div", {
                 className: theme.dropdown,
-                children: ALL_CHANNELS.map((ch)=>/*#__PURE__*/ _jsxs("button", {
+                children: ALL_CHANNELS.map((ch)=>{
+                    /*
+             * A channel this install cannot deliver on is shown and refused,
+             * not hidden: the author should see that SMS exists as a product
+             * feature and that THIS deployment does not have it, which is a
+             * different thing from it not existing at all.
+             */ const deliverable = canDeliver(ch);
+                    return /*#__PURE__*/ _jsxs("button", {
                         type: "button",
-                        className: selected.includes(ch) ? theme.optionSelected : theme.option,
-                        onClick: ()=>toggle(ch),
+                        disabled: !deliverable,
+                        title: deliverable ? undefined : say.channelUnavailable,
+                        className: `${selected.includes(ch) ? theme.optionSelected : theme.option}${deliverable ? '' : ' opacity-40 cursor-not-allowed'}`,
+                        onClick: ()=>{
+                            if (deliverable) toggle(ch);
+                        },
                         children: [
                             selected.includes(ch) ? '✓ ' : '',
-                            channelLabels[ch] ?? ch
+                            channelLabels[ch] ?? ch,
+                            deliverable ? '' : ` — ${say.channelUnavailable}`
                         ]
-                    }, ch))
+                    }, ch);
+                })
             })
         ]
     });
@@ -420,7 +434,7 @@ function RoleSearchList({ listRolesAction, selectedRole, onSelect, ursTheme, say
     });
 }
 // ─── Main Properties Panel ────────────────────────────────────────
-export function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode, onClose, listUsersAction, listRolesAction, panelTheme, labels }) {
+export function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode, onClose, listUsersAction, listRolesAction, panelTheme, labels, availableChannels }) {
     const theme = panelTheme;
     const say = {
         ...DEFAULT_VERIFICATION_FLOW_LABELS,
@@ -477,6 +491,27 @@ export function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode,
             /*#__PURE__*/ _jsxs("div", {
                 className: theme.body,
                 children: [
+                    /*#__PURE__*/ _jsxs("p", {
+                        className: theme.help,
+                        children: [
+                            nodeType === 'step' && say.stepHelp,
+                            nodeType === 'verifier' && say.verifierHelp,
+                            nodeType === 'notification' && say.notificationHelp
+                        ]
+                    }),
+                    nodeType === 'step' && /* The one fact a step carries at runtime, and the operator cannot
+           * type it: it is derived from the arrows when the flow is saved. */ /*#__PURE__*/ _jsxs("p", {
+                        className: theme.readOnlyRow,
+                        children: [
+                            /*#__PURE__*/ _jsx("span", {
+                                children: say.stepOrderLabel
+                            }),
+                            /*#__PURE__*/ _jsx("span", {
+                                className: theme.readOnlyValue,
+                                children: Number(data.stepOrder) > 0 ? data.stepOrder : say.stepOrderUnset
+                            })
+                        ]
+                    }),
                     /*#__PURE__*/ _jsxs("div", {
                         className: theme.section,
                         children: [
@@ -677,6 +712,7 @@ export function PropertiesPanel({ nodeId, nodeData, onUpdateNode, onDeleteNode,
                                         onChange: (channels)=>update({
                                                 channels
                                             }),
+                                        available: availableChannels,
                                         msTheme: theme.multiSelect,
                                         say: say
                                     })

package/dist/fe/components/VerificationFlowPage/components/VerificationFlowPage.d.ts

@@ -1,4 +1,4 @@
 import '@xyflow/react/dist/style.css';
 import type { ReactElement } from 'react';
 import type { VerificationFlowPageProps } from '../types';
-export declare function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending, showEntityStatuses, className, themeMode, labels, }: VerificationFlowPageProps): ReactElement;
+export declare function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending, showEntityStatuses, className, themeMode, labels, describeEntity, entityHref, availableChannels, initialTab, }: VerificationFlowPageProps): ReactElement;

package/dist/fe/components/VerificationFlowPage/components/VerificationFlowPage.js

@@ -149,7 +149,19 @@ function createNewNode(nodeType, position, say) {
         base.data = {
             ...base.data,
             trigger: 'on_step_reached',
-            channels: []
+            channels: [
+                'portal'
+            ],
+            /*
+       * The recipient the panel ALREADY shows.
+       *
+       * The properties panel renders `data.recipientType || 'all_verifiers'`,
+       * so a node nobody opened read "All Verifiers" while the field was
+       * undefined — and `buildSavePayload` only writes a recipient row when
+       * the field is set. The result was a notification node that drew
+       * correctly, saved, published green and reached nobody, with no error
+       * anywhere. Seeding it makes the screen's claim true.
+       */ recipientType: 'all_verifiers'
         };
     }
     return base;
@@ -252,14 +264,19 @@ function buildSavePayload(flowId, entityName, flowName, flowDescription, trigger
                 channel: ch
             });
         }
-        if (d.recipientType) {
-            notification_recipients.push({
-                rule_id: n.id,
-                recipient_type: d.recipientType,
-                recipient_user_id: d.recipientUserId,
-                recipient_role: d.recipientRole
-            });
-        }
+        /*
+     * ALWAYS a recipient row, defaulting to what the panel displays.
+     *
+     * `if (d.recipientType)` skipped the row for every node the operator
+     * never opened, which is every node they dropped and wired without
+     * thinking about it — the commonest way to build a flow. A rule with no
+     * recipient resolves to an empty list and the send loop never runs.
+     */ notification_recipients.push({
+            rule_id: n.id,
+            recipient_type: d.recipientType || 'all_verifiers',
+            recipient_user_id: d.recipientUserId,
+            recipient_role: d.recipientRole
+        });
     }
     return {
         flow_id: flowId,
@@ -280,7 +297,7 @@ function buildSavePayload(flowId, entityName, flowName, flowDescription, trigger
     };
 }
 // ─── Main Component ───────────────────────────────────────────────
-export function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending = true, showEntityStatuses = false, className, themeMode = 'dark', labels }) {
+export function VerificationFlowPage({ entityName, title, subtitle, flowListAction, flowGetAction, flowSaveAction, flowPublishAction, flowUnpublishAction, flowDeleteAction, pendingAction, decideAction, uploadSignatureAction, listUsersAction, listRolesAction, entityStatusesAction, onFlowSelected, onDecisionMade, onEntityClick, onBack, showPending = true, showEntityStatuses = false, className, themeMode = 'dark', labels, describeEntity, entityHref, availableChannels, initialTab }) {
     const theme = getVerificationFlowTheme(themeMode);
     setActiveTheme(theme);
     const say = {
@@ -626,6 +643,15 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
     useEffect(()=>{
         loadFlows();
     }, []);
+    /*
+   * Open where the host said, once, on mount. The store is module-level and
+   * survives navigation, so this is also what stops a reviewer who came from
+   * a notification landing on whatever tab they happened to leave open.
+   */ useEffect(()=>{
+        if (initialTab) store.setActiveTab(initialTab);
+    }, [
+        initialTab
+    ]);
     useEffect(()=>{
         if (store.selectedFlowId) {
             loadFlowDetail(store.selectedFlowId);
@@ -887,7 +913,7 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                         children: viewMode === 'designer' && store.activeTab === 'flow' && /*#__PURE__*/ _jsxs(_Fragment, {
                             children: [
                                 /*#__PURE__*/ _jsx("span", {
-                                    className: "text-[11px] text-white/50 font-medium",
+                                    className: cn('text-[11px] font-medium', themeMode === 'light' ? 'text-gray-600' : 'text-white/50'),
                                     children: flowName || say.untitledFlow
                                 }),
                                 selectedFlow?.is_draft !== undefined && /*#__PURE__*/ _jsx("span", {
@@ -1127,6 +1153,19 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                             isDraggingOver && /*#__PURE__*/ _jsx("div", {
                                 className: theme.canvas.dropIndicator
                             }),
+                            !store.isLoadingGraph && nodes.length === 0 && /*#__PURE__*/ _jsxs("div", {
+                                className: theme.canvas.emptyHint,
+                                children: [
+                                    /*#__PURE__*/ _jsx("p", {
+                                        className: theme.canvas.emptyHintTitle,
+                                        children: say.canvasEmptyTitle
+                                    }),
+                                    /*#__PURE__*/ _jsx("p", {
+                                        className: theme.canvas.emptyHintBody,
+                                        children: say.canvasEmptyBody
+                                    })
+                                ]
+                            }),
                             /*#__PURE__*/ _jsxs(ReactFlow, {
                                 nodes: nodes,
                                 edges: edges,
@@ -1259,7 +1298,8 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                             listUsersAction: listUsersAction,
                             listRolesAction: listRolesAction,
                             panelTheme: theme.propertiesPanel,
-                            labels: say
+                            labels: say,
+                            availableChannels: availableChannels
                         })
                     })
                 ]
@@ -1271,7 +1311,9 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                     decideAction: decideAction,
                     uploadSignatureAction: uploadSignatureAction,
                     onDecisionMade: onDecisionMade,
-                    labels: say
+                    labels: say,
+                    describeEntity: describeEntity,
+                    entityHref: entityHref
                 })
             }),
             store.activeTab === 'statuses' && showEntityStatuses && entityStatusesAction && /*#__PURE__*/ _jsx("div", {

package/dist/fe/components/VerificationFlowPage/labels.d.ts

@@ -122,6 +122,22 @@ export type VerificationFlowLabels = {
     stepProperties: string;
     verifierProperties: string;
     notificationProperties: string;
+    /**
+     * What each kind of node IS, said where the operator is standing.
+     *
+     * The owner of this product asked, about his own screen, "what does the
+     * step node even do?" — and nothing on it could answer him. One paragraph
+     * at the top of each properties panel, plus the derived order a step
+     * cannot be given by hand.
+     */
+    stepHelp: string;
+    verifierHelp: string;
+    notificationHelp: string;
+    stepOrderLabel: string;
+    stepOrderUnset: string;
+    /** The blank canvas, which said nothing at all. */
+    canvasEmptyTitle: string;
+    canvasEmptyBody: string;
     sectionGeneral: string;
     sectionAssignment: string;
     sectionOptions: string;
@@ -161,6 +177,21 @@ export type VerificationFlowLabels = {
     approve: string;
     reject: string;
     review: string;
+    /**
+     * The queue could not be READ. Until this existed the tab rendered the
+     * empty state for a failed request, so "you have nothing to approve" and
+     * "we could not ask" looked identical — and the second one is the state a
+     * reviewer must act on.
+     */
+    pendingLoadFailedTitle: string;
+    pendingLoadFailedBody: string;
+    retry: string;
+    /** Heading above the record a decision is about. */
+    pendingRecordLabel: string;
+    /** Opens the record itself, so a reviewer can read what they are signing. */
+    openRecord: string;
+    /** Shown beside a channel this deployment cannot deliver on. */
+    channelUnavailable: string;
     verificationStatusTitle: string;
     /** "12 records for orders" — count and entity, both inside the label. */
     recordCount: (count: number, entityName: string) => string;