nucleus-core-ts 0.10.130 → 0.10.131

package/dist/.build-ok

@@ -1 +1 @@
-0.10.130
+0.10.131

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

@@ -281,6 +281,18 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                                 store.decidingId === item.instance_id ? /*#__PURE__*/ _jsxs("div", {
                                     className: theme.pending.card.actions,
                                     children: [
+                                        typeof item.pass_no === 'number' && typeof item.max_passes === 'number' ? /*#__PURE__*/ _jsxs("p", {
+                                            className: theme.pending.card.decisionMeta,
+                                            children: [
+                                                item.max_passes > 1 ? say.pendingRound(item.pass_no, item.max_passes) : null,
+                                                item.max_passes > 1 ? ' · ' : null,
+                                                item.rejection_sends_back_to ? say.pendingRejectSendsBack(say.stepOption(item.rejection_sends_back_to.step_order, item.rejection_sends_back_to.step_name)) : say.pendingRejectEndsReview
+                                            ]
+                                        }) : null,
+                                        item.is_last_pass === true && (item.max_passes ?? 1) > 1 ? /*#__PURE__*/ _jsx("p", {
+                                            className: theme.pending.card.lastRoundWarning,
+                                            children: say.pendingLastRoundWarning
+                                        }) : null,
                                         item.require_signature ? /*#__PURE__*/ _jsxs("label", {
                                             className: "flex flex-col gap-1 text-xs",
                                             children: [

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

@@ -1,5 +1,5 @@
 import type { VerificationFlowLabels } from '../labels';
-import type { VerificationBulkStatusItem, VerificationCancelAction, VerificationEntityStatusesAction } from '../types';
+import type { VerificationBulkStatusItem, VerificationCancelAction, VerificationEntityStatusesAction, VerificationStartForEntityAction } from '../types';
 export type VerificationEntityListTheme = {
     container: string;
     header: string;
@@ -52,5 +52,17 @@ export type VerificationEntityListProps = {
      * now the API had one and the product offered none.
      */
     cancelAction?: VerificationCancelAction;
+    /**
+     * Puts a record back into review.
+     *
+     * It was declared on the page's props, passed in by the panel, and never
+     * destructured anywhere — so on a flow with `trigger_on: 'manual'` there was
+     * no way from the product to start a review at all. This list is the one
+     * screen that knows which chains have FINISHED, so a rejected record that has
+     * since been corrected gets its next review here. A record that has never
+     * been reviewed does not appear in this list (it is built from instances), so
+     * its first review still starts from the record's own screen.
+     */
+    startForEntityAction?: VerificationStartForEntityAction;
 };
-export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, cancelAction, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;
+export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, cancelAction, startForEntityAction, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;

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

@@ -97,7 +97,7 @@ const lightTheme = {
     };
     return map[status] ?? status;
 }
-export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels, cancelAction }) {
+export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels, cancelAction, startForEntityAction }) {
     const baseTheme = themeMode === 'light' ? lightTheme : darkTheme;
     const t = {
         ...baseTheme,
@@ -113,6 +113,50 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
     const [cancellingId, setCancellingId] = useState(null);
     const [cancelReason, setCancelReason] = useState('');
     const [cancelNote, setCancelNote] = useState(null);
+    // Which row is being sent back into review, and what it was told.
+    const [startingId, setStartingId] = useState(null);
+    const [startNote, setStartNote] = useState(null);
+    const startAgain = useEffectEvent((item)=>{
+        if (!startForEntityAction) return;
+        setStartingId(item.instance_id);
+        setStartNote(null);
+        startForEntityAction.start({
+            payload: {
+                entity_name: item.entity_name,
+                entity_id: item.entity_id
+            },
+            onAfterHandle: (res)=>{
+                setStartingId(null);
+                const r = res;
+                /*
+         * The engine has plenty of legitimate reasons to refuse — no live flow
+         * for this entity, the first step resolves to nobody, a chain is
+         * already running — and each one is a sentence. Shown on the row rather
+         * than swallowed: a button that does nothing and says nothing is how
+         * "send to review does not work" became a support conversation.
+         */ if (r.success === false) {
+                    setStartNote({
+                        id: item.instance_id,
+                        text: r.message || say.startReviewFailed
+                    });
+                    return;
+                }
+                setStartNote({
+                    id: item.instance_id,
+                    text: r.message || say.reviewStartedNote
+                });
+                loadStatuses(activeTab === 'all' ? undefined : activeTab, currentPage);
+            },
+            onErrorHandle: (err)=>{
+                setStartingId(null);
+                const e = err;
+                setStartNote({
+                    id: item.instance_id,
+                    text: e?.message || say.startReviewFailed
+                });
+            }
+        });
+    });
     const loadStatuses = useEffectEvent((status, page)=>{
         entityStatusesAction.start({
             payload: {
@@ -332,6 +376,25 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                                 className: `${t.statusBadge} ${getStatusBadgeClass(item.status)}`,
                                 children: statusLabel(say, item.status)
                             }),
+                            startForEntityAction && item.status !== 'active' ? /*#__PURE__*/ _jsxs("div", {
+                                className: "shrink-0 flex flex-col items-end gap-1",
+                                children: [
+                                    /*#__PURE__*/ _jsx("button", {
+                                        type: "button",
+                                        disabled: startingId === item.instance_id,
+                                        onClick: (e)=>{
+                                            e.stopPropagation();
+                                            startAgain(item);
+                                        },
+                                        className: themeMode === 'light' ? 'rounded-lg border border-gray-200 bg-white px-2.5 py-1 text-[11px] font-medium text-gray-600 hover:bg-gray-100 disabled:opacity-50 disabled:cursor-not-allowed' : 'rounded-lg border border-white/[0.08] bg-white/[0.04] px-2.5 py-1 text-[11px] font-medium text-white/60 hover:bg-white/[0.1] disabled:opacity-40 disabled:cursor-not-allowed',
+                                        children: startingId === item.instance_id ? say.startingReview : say.startNewReview
+                                    }),
+                                    startNote?.id === item.instance_id ? /*#__PURE__*/ _jsx("p", {
+                                        className: themeMode === 'light' ? 'max-w-[18rem] text-right text-[10px] leading-relaxed text-gray-500' : 'max-w-[18rem] text-right text-[10px] leading-relaxed text-white/45',
+                                        children: startNote.text
+                                    }) : null
+                                ]
+                            }) : null,
                             cancelAction && item.status === 'active' ? cancellingId === item.instance_id ? // No handlers on this wrapper: the row above is a button
                             // when `onEntityClick` is set, so each INTERACTIVE child
                             // stops the bubble itself rather than a bare div doing it

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, describeEntity, entityHref, availableChannels, initialTab, cancelAction, authoringModel, flowFeasibilityAction, manageRolesHref, }: 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, cancelAction, startForEntityAction, authoringModel, flowFeasibilityAction, manageRolesHref, }: VerificationFlowPageProps): ReactElement;

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

@@ -284,7 +284,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, describeEntity, entityHref, availableChannels, initialTab, cancelAction, authoringModel = 1, flowFeasibilityAction, manageRolesHref }) {
+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, cancelAction, startForEntityAction, authoringModel = 1, flowFeasibilityAction, manageRolesHref }) {
     const theme = getVerificationFlowTheme(themeMode);
     setActiveTheme(theme);
     const say = {
@@ -1551,7 +1551,14 @@ export function VerificationFlowPage({ entityName, title, subtitle, flowListActi
                     onEntityClick: onEntityClick,
                     themeMode: themeMode,
                     labels: say,
-                    cancelAction: cancelAction
+                    cancelAction: cancelAction,
+                    /*
+             * Declared on these props, passed in by the panel, and destructured
+             * NOWHERE until now — so on a flow with `trigger_on: 'manual'` the
+             * product had no way to put a record into review at all. The list
+             * knows which chains have finished, so a corrected record gets its
+             * next review from the row it is already on.
+             */ startForEntityAction: startForEntityAction
                 })
             })
         ]

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

@@ -409,6 +409,15 @@ export type VerificationFlowLabels = {
     /** In the diagram's text alternative: the chain finishing approved / rejected. */
     diagramFinishesApproved: string;
     diagramFinishesRejected: string;
+    startNewReview: string;
+    startingReview: string;
+    startReviewFailed: string;
+    reviewStartedNote: string;
+    /** On the reviewer's card: which round, and what Reject will do. */
+    pendingRound: (pass: number, max: number) => string;
+    pendingRejectSendsBack: (stepLabel: string) => string;
+    pendingRejectEndsReview: string;
+    pendingLastRoundWarning: string;
     locale: string;
 };
 export declare const DEFAULT_VERIFICATION_FLOW_LABELS: VerificationFlowLabels;

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

@@ -307,6 +307,14 @@
     diagramSendsBackTo: (stepLabel)=>`if rejected, goes back to ${stepLabel}`,
     diagramFinishesApproved: 'then the record is approved',
     diagramFinishesRejected: 'if rejected, the record is rejected and the review ends',
+    startNewReview: 'Review again',
+    startingReview: 'Starting…',
+    startReviewFailed: 'The review could not be started.',
+    reviewStartedNote: 'Sent for review.',
+    pendingRound: (pass, max)=>`Round ${pass} of ${max}`,
+    pendingRejectSendsBack: (stepLabel)=>`Rejecting sends this back to ${stepLabel}.`,
+    pendingRejectEndsReview: 'Rejecting ends this review.',
+    pendingLastRoundWarning: 'This is the last round this flow allows, so rejecting now ends the review for good — the record will not go back to its author again.',
     locale: 'en-US'
 };
 // ─── Enum → label maps ────────────────────────────────────────────

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

@@ -165,6 +165,17 @@ export type VerificationFlowPageTheme = {
             recordLabel: string;
             recordValue: string;
             recordLink: string;
+            /**
+             * The round and what Reject will do, on the card, before the press.
+             * Set as a plain fact beside the buttons.
+             */
+            decisionMeta: string;
+            /**
+             * The last allowed round. Louder than `decisionMeta`, because pressing
+             * Reject here ends a regulated review for good rather than sending the
+             * record back to be corrected.
+             */
+            lastRoundWarning: string;
         };
         input: string;
         approveButton: string;

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

@@ -160,7 +160,9 @@ export const verificationFlowPageTheme = {
             recordRow: 'mt-3 flex flex-wrap items-baseline gap-x-2 gap-y-1',
             recordLabel: 'text-[10px] uppercase tracking-wide text-white/30',
             recordValue: 'text-xs text-white/70',
-            recordLink: 'text-xs font-medium text-blue-400 underline underline-offset-2'
+            recordLink: 'text-xs font-medium text-blue-400 underline underline-offset-2',
+            decisionMeta: 'text-[11px] text-white/45 leading-relaxed',
+            lastRoundWarning: 'text-[11px] leading-relaxed text-amber-300/90 rounded-lg border border-amber-500/25 bg-amber-500/[0.07] px-2.5 py-1.5'
         },
         input: 'rounded-lg border border-white/[0.08] bg-white/[0.04] px-3 py-1.5 text-[11px] text-white/80 w-40 outline-none focus:border-white/20',
         approveButton: 'rounded-lg bg-emerald-500/20 border border-emerald-500/30 px-3 py-1.5 text-[11px] font-medium text-emerald-400 hover:bg-emerald-500/30 transition-all',
@@ -379,7 +381,9 @@ export const verificationFlowPageLightTheme = {
             recordRow: 'mt-3 flex flex-wrap items-baseline gap-x-2 gap-y-1',
             recordLabel: 'text-[10px] uppercase tracking-wide text-gray-400',
             recordValue: 'text-xs text-gray-700',
-            recordLink: 'text-xs font-medium text-blue-600 underline underline-offset-2'
+            recordLink: 'text-xs font-medium text-blue-600 underline underline-offset-2',
+            decisionMeta: 'text-[11px] text-gray-500 leading-relaxed',
+            lastRoundWarning: 'text-[11px] leading-relaxed text-amber-800 rounded-lg border border-amber-300 bg-amber-50 px-2.5 py-1.5'
         },
         input: 'rounded-lg border border-gray-200 bg-gray-50 px-3 py-1.5 text-[11px] text-gray-800 w-40 outline-none focus:border-gray-400',
         approveButton: 'rounded-lg bg-emerald-50 border border-emerald-200 px-3 py-1.5 text-[11px] font-medium text-emerald-700 hover:bg-emerald-100 transition-all',

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

@@ -208,6 +208,21 @@ export type PendingItem = {
     step_name?: string;
     require_signature: boolean;
     created_at: string;
+    /**
+     * The round, and what a rejection would DO — so the card can say it beside
+     * the button instead of in the answer that comes back after it is pressed.
+     *
+     * Optional because a host on an older backend sends neither, and a card that
+     * crashes on a missing field is worse than one that says nothing about
+     * rounds. Absent reads as "one round", which is what model 1 is.
+     */
+    pass_no?: number;
+    max_passes?: number;
+    is_last_pass?: boolean;
+    rejection_sends_back_to?: {
+        step_order: number;
+        step_name?: string;
+    };
 };
 export type VerificationFlowPageThemeOverrides = {
     layout?: Record<string, string>;