nucleus-core-ts 0.10.115 → 0.10.116

package/dist/.build-ok

@@ -1 +1 @@
-0.10.115
+0.10.116

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

@@ -477,6 +477,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: [

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,
@@ -887,7 +904,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 +1144,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,

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;

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

@@ -101,6 +101,13 @@
     stepProperties: 'Step Properties',
     verifierProperties: 'Verifier Properties',
     notificationProperties: 'Notification Properties',
+    stepHelp: 'A step is one position in the chain. The record waits here until every verifier attached to this step has decided, then moves to the next one. Its number comes from the arrows between the steps, not from a field.',
+    verifierHelp: 'Who may decide a step. Connect it to a step — either direction — and every member of the role, or the one person you pick, is asked to approve.',
+    notificationHelp: 'Who hears about it. "Flow started" and "Flow completed" fire once for the whole flow wherever this node sits; the other three fire only for the step this node is connected to.',
+    stepOrderLabel: 'Position in the chain',
+    stepOrderUnset: 'set when you save',
+    canvasEmptyTitle: 'Draw the chain',
+    canvasEmptyBody: 'Drag a Step onto the canvas for each approval the record has to pass, connect the steps in order, then hang a Verifier on each step to say who decides it. A Notification node tells someone it happened.',
     sectionGeneral: 'General',
     sectionAssignment: 'Assignment',
     sectionOptions: 'Options',

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

@@ -47,6 +47,10 @@ export type VerificationFlowPageTheme = {
         container: string;
         background: string;
         dropIndicator: string;
+        /** What to draw, shown on an empty canvas. */
+        emptyHint: string;
+        emptyHintTitle: string;
+        emptyHintBody: string;
     };
     stepNode: {
         container: string;
@@ -90,6 +94,11 @@ export type VerificationFlowPageTheme = {
         headerTitle: string;
         closeButton: string;
         body: string;
+        /** One paragraph under the header saying what this kind of node does. */
+        help: string;
+        /** A fact the flow derives and the operator cannot type. */
+        readOnlyRow: string;
+        readOnlyValue: string;
         section: string;
         sectionTitle: string;
         label: string;

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

@@ -46,7 +46,10 @@ export const verificationFlowPageTheme = {
     canvas: {
         container: 'flex-1 relative bg-[#08080d]',
         background: 'bg-[#08080d]',
-        dropIndicator: 'absolute inset-4 border-2 border-dashed border-white/10 rounded-2xl bg-white/[0.02] pointer-events-none z-10'
+        dropIndicator: 'absolute inset-4 border-2 border-dashed border-white/10 rounded-2xl bg-white/[0.02] pointer-events-none z-10',
+        emptyHint: 'pointer-events-none absolute left-1/2 top-1/2 z-10 w-[28rem] max-w-[calc(100%-3rem)] -translate-x-1/2 -translate-y-1/2 rounded-2xl border border-white/[0.08] bg-white/[0.04] px-6 py-5 text-center',
+        emptyHintTitle: 'text-[13px] font-semibold text-white/70',
+        emptyHintBody: 'mt-2 text-[12px] leading-relaxed text-white/40'
     },
     stepNode: {
         container: 'group relative rounded-2xl border border-blue-500/20 bg-gradient-to-br from-blue-500/[0.08] to-blue-600/[0.03] backdrop-blur-sm px-5 py-4 min-w-[200px] max-w-[260px] shadow-lg shadow-blue-500/[0.04] transition-all hover:border-blue-500/30 hover:shadow-blue-500/[0.08]',
@@ -90,6 +93,9 @@ export const verificationFlowPageTheme = {
         headerTitle: 'text-[12px] font-semibold text-white/80',
         closeButton: 'w-6 h-6 rounded-md flex items-center justify-center text-white/30 hover:text-white/60 hover:bg-white/[0.06] transition-all',
         body: 'flex-1 overflow-auto p-4 space-y-5',
+        help: 'rounded-lg bg-white/[0.04] px-3 py-2.5 text-[11px] leading-relaxed text-white/50',
+        readOnlyRow: 'flex items-baseline justify-between gap-3 rounded-lg bg-white/[0.04] px-3 py-2 text-[11px] text-white/50',
+        readOnlyValue: 'text-[12px] font-semibold tabular-nums text-white/80',
         section: 'space-y-2.5',
         sectionTitle: 'text-[10px] font-bold uppercase tracking-[0.15em] text-white/30 mb-2',
         label: 'block text-[11px] font-medium text-white/50 mb-1',
@@ -239,31 +245,55 @@ export const verificationFlowPageLightTheme = {
     canvas: {
         container: 'flex-1 relative bg-gray-50',
         background: 'bg-gray-50',
-        dropIndicator: 'absolute inset-4 border-2 border-dashed border-gray-300 rounded-2xl bg-gray-100/50 pointer-events-none z-10'
+        dropIndicator: 'absolute inset-4 border-2 border-dashed border-gray-300 rounded-2xl bg-gray-100/50 pointer-events-none z-10',
+        emptyHint: 'pointer-events-none absolute left-1/2 top-1/2 z-10 w-[28rem] max-w-[calc(100%-3rem)] -translate-x-1/2 -translate-y-1/2 rounded-2xl border border-gray-200 bg-white px-6 py-5 text-center shadow-sm',
+        emptyHintTitle: 'text-[13px] font-semibold text-gray-800',
+        emptyHintBody: 'mt-2 text-[12px] leading-relaxed text-gray-500'
     },
-    stepNode: {
+    /*
+   * The light nodes spread the dark ones and override the container, the type
+   * label, the name and the description — which left every BADGE and every
+   * HANDLE at its dark value on a white card. Measured: the order badge and
+   * the verifier's "role" chip came out around 1.5:1, i.e. the facts a node
+   * states were the least readable thing on it. Each light node now names
+   * its own badges and handles.
+   */ stepNode: {
         ...verificationFlowPageTheme.stepNode,
         container: 'group relative rounded-2xl border border-blue-200 bg-gradient-to-br from-blue-50 to-blue-100/50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-sm transition-all hover:border-blue-300 hover:shadow-md',
         containerSelected: 'group relative rounded-2xl border-2 border-blue-400 bg-gradient-to-br from-blue-50 to-blue-100/50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-md ring-4 ring-blue-100',
-        typeLabel: 'text-[9px] font-bold uppercase tracking-[0.2em] text-blue-500',
+        icon: 'text-blue-600',
+        typeLabel: 'text-[9px] font-bold uppercase tracking-[0.2em] text-blue-600',
         nameLabel: 'text-[13px] font-semibold text-gray-800 mt-1.5 leading-tight',
-        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2'
+        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2',
+        handleSource: '!w-3 !h-3 !bg-blue-500 !border-2 !border-white hover:!bg-blue-600',
+        handleTarget: '!w-3 !h-3 !bg-blue-500 !border-2 !border-white hover:!bg-blue-600',
+        orderBadge: 'absolute -top-2 -right-2 w-5 h-5 rounded-full bg-blue-600 text-[9px] font-bold text-white flex items-center justify-center'
     },
     verifierNode: {
         ...verificationFlowPageTheme.verifierNode,
         container: 'group relative rounded-2xl border border-amber-200 bg-gradient-to-br from-amber-50 to-orange-50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-sm transition-all hover:border-amber-300 hover:shadow-md',
         containerSelected: 'group relative rounded-2xl border-2 border-amber-400 bg-gradient-to-br from-amber-50 to-orange-50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-md ring-4 ring-amber-100',
+        icon: 'text-amber-600',
         typeLabel: 'text-[9px] font-bold uppercase tracking-[0.2em] text-amber-600',
         nameLabel: 'text-[13px] font-semibold text-gray-800 mt-1.5 leading-tight',
-        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2'
+        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2',
+        assignedBadge: 'inline-flex items-center gap-1 rounded-md bg-amber-100 border border-amber-300 px-2 py-0.5 text-[10px] font-medium text-amber-800 mt-2',
+        signatureBadge: 'inline-flex items-center gap-1 rounded-md bg-rose-100 border border-rose-300 px-2 py-0.5 text-[10px] font-medium text-rose-800',
+        handleSource: '!w-3 !h-3 !bg-amber-500 !border-2 !border-white hover:!bg-amber-600',
+        handleTarget: '!w-3 !h-3 !bg-amber-500 !border-2 !border-white hover:!bg-amber-600'
     },
     notificationNode: {
         ...verificationFlowPageTheme.notificationNode,
         container: 'group relative rounded-2xl border border-violet-200 bg-gradient-to-br from-violet-50 to-purple-50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-sm transition-all hover:border-violet-300 hover:shadow-md',
         containerSelected: 'group relative rounded-2xl border-2 border-violet-400 bg-gradient-to-br from-violet-50 to-purple-50 px-5 py-4 min-w-[200px] max-w-[260px] shadow-md ring-4 ring-violet-100',
+        icon: 'text-violet-600',
         typeLabel: 'text-[9px] font-bold uppercase tracking-[0.2em] text-violet-600',
         nameLabel: 'text-[13px] font-semibold text-gray-800 mt-1.5 leading-tight',
-        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2'
+        description: 'text-[11px] text-gray-500 mt-1 leading-relaxed line-clamp-2',
+        channelBadge: 'inline-flex items-center rounded-md bg-violet-100 border border-violet-300 px-2 py-0.5 text-[10px] font-medium text-violet-800',
+        triggerBadge: 'inline-flex items-center rounded-md bg-gray-100 border border-gray-300 px-2 py-0.5 text-[10px] font-medium text-gray-700',
+        handleSource: '!w-3 !h-3 !bg-violet-500 !border-2 !border-white hover:!bg-violet-600',
+        handleTarget: '!w-3 !h-3 !bg-violet-500 !border-2 !border-white hover:!bg-violet-600'
     },
     propertiesPanel: {
         container: 'flex flex-col h-full',
@@ -271,6 +301,9 @@ export const verificationFlowPageLightTheme = {
         headerTitle: 'text-[12px] font-semibold text-gray-800',
         closeButton: 'w-6 h-6 rounded-md flex items-center justify-center text-gray-400 hover:text-gray-600 hover:bg-gray-100 transition-all',
         body: 'flex-1 overflow-auto p-4 space-y-5',
+        help: 'rounded-lg bg-gray-50 border border-gray-200 px-3 py-2.5 text-[11px] leading-relaxed text-gray-600',
+        readOnlyRow: 'flex items-baseline justify-between gap-3 rounded-lg bg-gray-50 border border-gray-200 px-3 py-2 text-[11px] text-gray-500',
+        readOnlyValue: 'text-[12px] font-semibold tabular-nums text-gray-800',
         section: 'space-y-2.5',
         sectionTitle: 'text-[10px] font-bold uppercase tracking-[0.15em] text-gray-400 mb-2',
         label: 'block text-[11px] font-medium text-gray-500 mb-1',