nucleus-core-ts 0.10.140 → 0.10.142

package/dist/.build-ok

@@ -1 +1 @@
-0.10.140
+0.10.142

package/dist/dist/index.d.ts

@@ -59,7 +59,7 @@ declare function parseCron2(expression: any): {
     };
     error?: undefined;
 };
-export function matchesCron(fields: any, when: any, timeZone: any): any;
+export function matchesCron(fields: any, when2: any, timeZone: any): any;
 export function isDue(input: any): {
     due: boolean;
     error: string | undefined;

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

@@ -1,6 +1,6 @@
 import type { ReactElement } from 'react';
 import type { VerificationFlowLabels } from '../labels';
-import type { VerificationDecideAction, VerificationPendingAction, VerificationSignatureUploadAction } from '../types';
+import type { EntityLabel, VerificationDecideAction, VerificationPendingAction, VerificationSignatureUploadAction } from '../types';
 interface PendingTabProps {
     pendingAction: VerificationPendingAction;
     decideAction: VerificationDecideAction;
@@ -12,6 +12,11 @@ interface PendingTabProps {
     /** Names the record a decision is about. See `VerificationFlowPageProps`. */
     describeEntity?: (entityName: string, entityId: string) => string | undefined;
     entityHref?: (entityName: string, entityId: string) => string | undefined;
+    /** Looks the records up by name; see `VerificationFlowPageProps`. */
+    labelEntities?: (refs: {
+        entity_name: string;
+        entity_id: string;
+    }[]) => Promise<EntityLabel[]>;
 }
-export declare function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref, }: PendingTabProps): ReactElement;
+export declare function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref, labelEntities, }: PendingTabProps): ReactElement;
 export {};

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

@@ -1,11 +1,14 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useEffectEvent, useRef, useState } from 'react';
 import { DEFAULT_VERIFICATION_FLOW_LABELS, refusalSentence } from '../labels';
 import { useVerificationFlowStore } from '../store';
 import { getActiveTheme } from '../theme/store';
 import { entityWord, isRevisionStep, planDecision, returnedSentence, showsLastRoundWarning, signatureFileType } from './decisionPlan';
-export function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref }) {
+import { hostRecordLabel, matchesSearch } from './recordLabels';
+import { approvalOffered, supersededSentence } from './supersededCard';
+import { useEntityLabels } from './useEntityLabels';
+export function PendingTab({ pendingAction, decideAction, uploadSignatureAction, onDecisionMade, labels, describeEntity, entityHref, labelEntities }) {
     /*
    * Local, not in the store: a chosen file must not survive cancelling out of
    * its card. Keyed by instance because it was one slot for the whole tab: a
@@ -52,6 +55,13 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
         ...labels
     };
     const store = useVerificationFlowStore();
+    /*
+   * What the reviewer typed to narrow the queue, and the names it is matched
+   * against. Measured in the audit: fourteen cards reading
+   * "Sayfa Versiyonları · 9f769e4b", no search, no order — the one about a
+   * given medicine was found by opening every "Open the record".
+   */ const [query, setQuery] = useState('');
+    const resolvedLabels = useEntityLabels(labelEntities, store.pendingItems);
     const loadPending = useEffectEvent(()=>{
         /*
      * Found in review: the spinner below replaces the whole list, so every
@@ -306,7 +316,8 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
    * `page_versions/9f769e4b-…` and nothing else, so a reviewer signed a leaflet
    * version they had no way to read. `describeEntity` lets the host supply the
    * name; the href, when there is a screen, lets them open it.
-   */ const renderRecord = (item)=>/*#__PURE__*/ _jsxs("span", {
+   */ const nameOf = (item)=>hostRecordLabel(item, resolvedLabels, describeEntity) ?? `${entityWord(say, item.entity_name)}/${item.entity_id}`;
+    const renderRecord = (item)=>/*#__PURE__*/ _jsxs("span", {
             className: theme.pending.card.recordRow,
             children: [
                 /*#__PURE__*/ _jsx("span", {
@@ -315,7 +326,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 }),
                 /*#__PURE__*/ _jsx("span", {
                     className: theme.pending.card.recordValue,
-                    children: describeEntity?.(item.entity_name, item.entity_id) ?? `${entityWord(say, item.entity_name)}/${item.entity_id}`
+                    children: nameOf(item)
                 }),
                 entityHref?.(item.entity_name, item.entity_id) ? /*#__PURE__*/ _jsx("a", {
                     href: entityHref(item.entity_name, item.entity_id),
@@ -326,6 +337,18 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 }) : null
             ]
         });
+    /*
+   * A record the host says was replaced by a newer one: said on the card,
+   * before anything is pressed, because the engine will refuse its approval.
+   * See `supersededCard`.
+   */ const renderSuperseded = (item)=>{
+        const text = supersededSentence(say, item);
+        return text ? /*#__PURE__*/ _jsx("p", {
+            className: theme.pending.card.lastRoundWarning,
+            role: "note",
+            children: text
+        }) : null;
+    };
     const renderSignaturePicker = (item, onPick)=>item.require_signature ? /*#__PURE__*/ _jsxs("label", {
             className: "flex flex-col gap-1 text-xs",
             children: [
@@ -385,7 +408,8 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             className: theme.pending.card.decisionMeta,
                             children: returned
                         }) : null,
-                        renderRecord(item)
+                        renderRecord(item),
+                        renderSuperseded(item)
                     ]
                 }),
                 confirming ? /*#__PURE__*/ _jsxs("div", {
@@ -426,17 +450,21 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 }) : /*#__PURE__*/ _jsxs("div", {
                     className: theme.pending.card.actions,
                     children: [
-                        renderSignaturePicker(item, ()=>enterCard(item)),
-                        /*#__PURE__*/ _jsx("button", {
-                            type: "button",
-                            onClick: ()=>{
-                                enterCard(item);
-                                handleDecide(item, 'approved');
-                            },
-                            "aria-describedby": `resubmit-hint-${item.instance_id}`,
-                            className: theme.pending.approveButton,
-                            children: firstRound ? say.submitForReview : say.resubmit
-                        }),
+                        approvalOffered(item) ? /*#__PURE__*/ _jsxs(_Fragment, {
+                            children: [
+                                renderSignaturePicker(item, ()=>enterCard(item)),
+                                /*#__PURE__*/ _jsx("button", {
+                                    type: "button",
+                                    onClick: ()=>{
+                                        enterCard(item);
+                                        handleDecide(item, 'approved');
+                                    },
+                                    "aria-describedby": `resubmit-hint-${item.instance_id}`,
+                                    className: theme.pending.approveButton,
+                                    children: firstRound ? say.submitForReview : say.resubmit
+                                })
+                            ]
+                        }) : null,
                         /*#__PURE__*/ _jsx("button", {
                             type: "button",
                             id: `withdraw-${item.instance_id}`,
@@ -450,11 +478,11 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             className: theme.pending.cancelButton,
                             children: say.withdrawSubmission
                         }),
-                        /*#__PURE__*/ _jsx("p", {
+                        approvalOffered(item) ? /*#__PURE__*/ _jsx("p", {
                             id: `resubmit-hint-${item.instance_id}`,
                             className: theme.pending.card.decisionMeta,
                             children: firstRound ? say.submitForReviewHint : say.resubmitHint
-                        })
+                        }) : null
                     ]
                 })
             ]
@@ -481,7 +509,8 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                                 say.previousRoundReason(item.sent_back.reason)
                             ]
                         }) : null,
-                        renderRecord(item)
+                        renderRecord(item),
+                        renderSuperseded(item)
                     ]
                 }),
                 store.decidingId === item.instance_id ? /*#__PURE__*/ _jsxs("div", {
@@ -499,7 +528,7 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             className: theme.pending.card.lastRoundWarning,
                             children: say.pendingLastRoundWarning
                         }) : null,
-                        renderSignaturePicker(item),
+                        approvalOffered(item) ? renderSignaturePicker(item) : null,
                         /*#__PURE__*/ _jsx("input", {
                             type: "text",
                             placeholder: say.reasonPlaceholder,
@@ -508,12 +537,12 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                             onChange: (e)=>store.setDecisionReason(e.target.value),
                             className: theme.pending.input
                         }),
-                        /*#__PURE__*/ _jsx("button", {
+                        approvalOffered(item) ? /*#__PURE__*/ _jsx("button", {
                             type: "button",
                             onClick: ()=>handleDecide(item, 'approved'),
                             className: theme.pending.approveButton,
                             children: say.approve
-                        }),
+                        }) : null,
                         /*#__PURE__*/ _jsx("button", {
                             type: "button",
                             onClick: ()=>handleDecide(item, 'rejected'),
@@ -544,6 +573,17 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 })
             ]
         });
+    /*
+   * The card being acted on stays whatever is typed: hiding it mid-decision
+   * would also hide the refusal written under it.
+   */ const shown = store.pendingItems.filter((item)=>item.instance_id === store.decidingId || matchesSearch([
+            nameOf(item),
+            entityWord(say, item.entity_name),
+            item.entity_id,
+            item.flow_name,
+            item.step_name
+        ], query));
+    const searching = query.trim() !== '';
     return /*#__PURE__*/ _jsxs("div", {
         className: theme.pending.container,
         children: [
@@ -551,7 +591,20 @@ export function PendingTab({ pendingAction, decideAction, uploadSignatureAction,
                 className: theme.pending.title,
                 children: say.pendingApprovals(store.pendingItems.length)
             }),
-            store.pendingItems.map((item)=>/*#__PURE__*/ _jsxs("div", {
+            store.pendingItems.length > 1 ? /*#__PURE__*/ _jsx("input", {
+                type: "search",
+                value: query,
+                onChange: (e)=>setQuery(e.target.value),
+                placeholder: say.pendingSearchLabel,
+                "aria-label": say.pendingSearchLabel,
+                className: theme.pending.input
+            }) : null,
+            searching ? /*#__PURE__*/ _jsx("p", {
+                className: theme.pending.card.decisionMeta,
+                role: "status",
+                children: shown.length === 0 ? say.pendingSearchNoMatch(query.trim()) : say.pendingSearchShowing(shown.length, store.pendingItems.length)
+            }) : null,
+            shown.map((item)=>/*#__PURE__*/ _jsxs("div", {
                     className: theme.pending.card.container,
                     children: [
                         isRevisionStep(item) ? renderRevisionCard(item) : renderReviewCard(item),

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

@@ -1,5 +1,5 @@
 import type { VerificationFlowLabels } from '../labels';
-import type { VerificationBulkStatusItem, VerificationCancelAction, VerificationEntityStatusesAction, VerificationStartForEntityAction } from '../types';
+import type { EntityLabel, VerificationBulkStatusItem, VerificationCancelAction, VerificationEntityStatusesAction, VerificationStartForEntityAction } from '../types';
 export type VerificationEntityListTheme = {
     container: string;
     header: string;
@@ -26,6 +26,15 @@ export type VerificationEntityListTheme = {
     progressSection: string;
     progressBar: string;
     progressFill: string;
+    /**
+     * The fill of a chain that stopped. It fell through to `bg-white/20`, which
+     * on the light track (`bg-gray-200`) is invisible: a chain cancelled at 3/3
+     * showed an empty bar beside "3/3".
+     */
+    progressCancelled: string;
+    /** The search box above the rows, and the line saying what it found. */
+    searchInput: string;
+    searchNote: string;
     progressLabel: string;
     /** "Round 2 (at most 3)" under the bar, which otherwise reads backwards. */
     roundLabel: string;
@@ -68,5 +77,16 @@ export type VerificationEntityListProps = {
      * its first review still starts from the record's own screen.
      */
     startForEntityAction?: VerificationStartForEntityAction;
+    /**
+     * The same naming hooks the queue has. Rows printed the table's word and a
+     * full uuid, so an operator looking for one medicine's review read every
+     * row's id. See `VerificationFlowPageProps`.
+     */
+    describeEntity?: (entityName: string, entityId: string) => string | undefined;
+    entityHref?: (entityName: string, entityId: string) => string | undefined;
+    labelEntities?: (refs: {
+        entity_name: string;
+        entity_id: string;
+    }[]) => Promise<EntityLabel[]>;
 };
-export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, cancelAction, startForEntityAction, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;
+export declare function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode, onEntityClick, pageSize, labels, cancelAction, startForEntityAction, describeEntity, entityHref, labelEntities, }: VerificationEntityListProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,8 +1,10 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useEffectEvent, useRef, useState } from 'react';
 import { DEFAULT_VERIFICATION_FLOW_LABELS, refusalSentence } from '../labels';
-import { chainRoundLabel, chainStatusWord, entityWord, listStatusLabel, rowForStartNote } from './decisionPlan';
+import { chainProgress, chainRoundLabel, chainStatusWord, entityWord, listStatusLabel, rowForStartNote } from './decisionPlan';
+import { hostRecordLabel, matchesSearch } from './recordLabels';
+import { useEntityLabels } from './useEntityLabels';
 const darkTheme = {
     container: 'space-y-4',
     header: 'space-y-1',
@@ -28,6 +30,9 @@ const darkTheme = {
     progressSection: 'flex items-center gap-2.5 shrink-0 w-[140px]',
     progressBar: 'flex-1 h-1.5 rounded-full bg-white/8 overflow-hidden',
     progressFill: 'h-full rounded-full transition-all duration-500',
+    progressCancelled: 'bg-white/20',
+    searchInput: 'w-full rounded-lg border border-white/[0.08] bg-white/[0.04] px-3 py-2 text-xs text-white/80 outline-none placeholder:text-white/30 focus:border-white/20',
+    searchNote: 'text-[11px] leading-relaxed text-white/45',
     progressLabel: 'text-[10px] text-white/40 font-medium whitespace-nowrap w-[45px] text-right',
     roundLabel: 'text-[10px] text-white/45 whitespace-nowrap',
     metaSection: 'flex items-center gap-4 shrink-0',
@@ -67,6 +72,9 @@ const lightTheme = {
     progressSection: 'flex items-center gap-2.5 shrink-0 w-[140px]',
     progressBar: 'flex-1 h-1.5 rounded-full bg-gray-200 overflow-hidden',
     progressFill: 'h-full rounded-full transition-all duration-500',
+    progressCancelled: 'bg-gray-400',
+    searchInput: 'w-full rounded-lg border border-gray-200 bg-white px-3 py-2 text-xs text-gray-800 outline-none placeholder:text-gray-400 focus:border-gray-400',
+    searchNote: 'text-[11px] leading-relaxed text-gray-500',
     progressLabel: 'text-[10px] text-gray-500 font-medium whitespace-nowrap w-[45px] text-right',
     roundLabel: 'text-[10px] text-gray-500 whitespace-nowrap',
     metaSection: 'flex items-center gap-4 shrink-0',
@@ -88,7 +96,7 @@ const lightTheme = {
     'rejected',
     'cancelled'
 ];
-export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels, cancelAction, startForEntityAction }) {
+export function VerificationEntityList({ entityName, entityStatusesAction, theme: themeOverrides, themeMode = 'dark', onEntityClick, pageSize = 20, labels, cancelAction, startForEntityAction, describeEntity, entityHref, labelEntities }) {
     const baseTheme = themeMode === 'light' ? lightTheme : darkTheme;
     const t = {
         ...baseTheme,
@@ -107,6 +115,15 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
     // Which row is being sent back into review, and what it was told.
     const [startingId, setStartingId] = useState(null);
     const [startNote, setStartNote] = useState(null);
+    // What the reader typed to narrow the rows on screen; see `shownItems`.
+    const [query, setQuery] = useState('');
+    /*
+   * The list could not be READ. Measured in the audit: a reviewer opening this
+   * tab got `403 operator privileges required`, the cached state went to
+   * `data: null`, and the list read that as "0 records" and "No verification
+   * records found" while dozens of chains existed. `forbidden` is the server
+   * refusing this reader, which is said differently from a failure.
+   */ const [loadFailure, setLoadFailure] = useState(null);
     /*
    * Counts list reloads, so an answer can tell whether the list it was asked
    * about is still the one on screen. See `startAgain`.
@@ -181,6 +198,7 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
      * under a row through tab switches and page turns, long after the row it
      * described had changed state.
      */ setStartNote(null);
+        setLoadFailure(null);
         loadGeneration.current += 1;
         entityStatusesAction.start({
             payload: {
@@ -188,6 +206,20 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                 status: status === 'all' ? undefined : status,
                 page: page || 1,
                 limit: pageSize
+            },
+            onAfterHandle: (res)=>{
+                const r = res;
+                if (r?.success === false) setLoadFailure({
+                    forbidden: false,
+                    message: r.message
+                });
+            },
+            onErrorHandle: (err, code)=>{
+                const e = err;
+                setLoadFailure({
+                    forbidden: code === 403,
+                    message: e?.message
+                });
             }
         });
     });
@@ -243,6 +275,26 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
     const items = responseData?.data?.items || [];
     const total = responseData?.data?.total || 0;
     const totalPages = Math.ceil(total / pageSize) || 1;
+    // Whose chains these are; see `BulkStatusResult.scope`. Absent on an older engine.
+    const scope = responseData?.data?.scope;
+    const resolvedLabels = useEntityLabels(labelEntities, items);
+    /*
+   * The rows that match what was typed, by the host's name for the record,
+   * the entity word, the id, the flow, the step and the status word. Only the
+   * page on screen: the server pages the list and only the host knows the
+   * names, so a search across pages would be a claim this list cannot back —
+   * the line under the box says so when there are more pages. A row whose
+   * cancel is open stays, so the question and its answer are not hidden
+   * mid-decision.
+   */ const searching = query.trim() !== '';
+    const shownItems = searching ? items.filter((item)=>item.instance_id === cancellingId || matchesSearch([
+            hostRecordLabel(item, resolvedLabels, describeEntity),
+            entityWord(say, item.entity_name),
+            item.entity_id,
+            item.flow_name,
+            item.current_step_name,
+            chainStatusWord(say, item)
+        ], query)) : items;
     const getStatusBadgeClass = (item)=>{
         if (item.status === 'active' && item.current_step_kind === 'revision') return t.statusRevision;
         switch(item.status){
@@ -267,7 +319,8 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
             case 'active':
                 return 'bg-gradient-to-r from-amber-400 to-cyan-400';
             default:
-                return 'bg-white/20';
+                // Cancelled, withdrawn, or a status this list does not know.
+                return t.progressCancelled;
         }
     };
     /*
@@ -279,14 +332,10 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
    * region that is always mounted (so it is announced), shown on the record's
    * row when that row is on this page (`rowForStartNote`) and above the list
    * when it is not.
-   */ const noteRowId = isPending ? null : rowForStartNote(items, startNote);
+   */ // The rows actually drawn: a note for a row the search hid is shown above.
+    const noteRowId = isPending ? null : rowForStartNote(shownItems, startNote);
     const noteShownAbove = startNote !== null && !isPending && noteRowId === null;
     const noteClass = themeMode === 'light' ? 'text-[10px] leading-relaxed text-gray-500' : 'text-[10px] leading-relaxed text-white/45';
-    const calculateProgress = (item)=>{
-        if (item.status === 'completed') return 100;
-        if (item.total_steps === 0) return 0;
-        return Math.round((item.current_step_order - 1) / item.total_steps * 100);
-    };
     return /*#__PURE__*/ _jsxs("div", {
         className: t.container,
         children: [
@@ -297,9 +346,9 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                         className: t.title,
                         children: say.verificationStatusTitle
                     }),
-                    /*#__PURE__*/ _jsx("p", {
+                    loadFailure ? null : /*#__PURE__*/ _jsx("p", {
                         className: t.description,
-                        children: say.recordCount(total, entityWord(say, entityName))
+                        children: scope === 'started_by_me' ? say.recordCountStartedByMe(total, entityWord(say, entityName)) : say.recordCount(total, entityWord(say, entityName))
                     })
                 ]
             }),
@@ -312,6 +361,27 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                         children: listStatusLabel(say, tab)
                     }, tab))
             }),
+            !loadFailure && (items.length > 1 || searching) ? /*#__PURE__*/ _jsxs("div", {
+                className: "flex flex-col gap-1",
+                children: [
+                    /*#__PURE__*/ _jsx("input", {
+                        type: "search",
+                        value: query,
+                        onChange: (e)=>setQuery(e.target.value),
+                        placeholder: say.statusesSearchLabel,
+                        "aria-label": say.statusesSearchLabel,
+                        className: t.searchInput
+                    }),
+                    searching ? /*#__PURE__*/ _jsxs("p", {
+                        className: t.searchNote,
+                        role: "status",
+                        children: [
+                            shownItems.length === 0 ? say.statusesSearchNoMatch(query.trim()) : say.statusesSearchShowing(shownItems.length, items.length),
+                            totalPages > 1 ? ` ${say.statusesSearchPageOnly(currentPage, totalPages)}` : null
+                        ]
+                    }) : null
+                ]
+            }) : null,
             /*#__PURE__*/ _jsx("p", {
                 role: "status",
                 className: noteShownAbove ? noteClass : 'sr-only',
@@ -322,6 +392,33 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                 children: /*#__PURE__*/ _jsx("div", {
                     className: `w-6 h-6 rounded-full border-2 animate-spin ${themeMode === 'light' ? 'border-gray-200 border-t-blue-500' : 'border-white/10 border-t-cyan-400'}`
                 })
+            }) : loadFailure ? /*#__PURE__*/ _jsxs("div", {
+                className: t.emptyState,
+                role: "alert",
+                children: [
+                    /*#__PURE__*/ _jsx("p", {
+                        className: t.emptyText,
+                        children: loadFailure.forbidden ? say.statusesForbidden : say.statusesLoadFailedTitle
+                    }),
+                    loadFailure.forbidden ? null : /*#__PURE__*/ _jsxs(_Fragment, {
+                        children: [
+                            /*#__PURE__*/ _jsx("p", {
+                                className: t.emptyText,
+                                children: say.statusesLoadFailedBody
+                            }),
+                            loadFailure.message ? /*#__PURE__*/ _jsx("p", {
+                                className: t.entityId,
+                                children: loadFailure.message
+                            }) : null,
+                            /*#__PURE__*/ _jsx("button", {
+                                type: "button",
+                                className: t.pageButton,
+                                onClick: ()=>reloadCurrent(),
+                                children: say.retry
+                            })
+                        ]
+                    })
+                ]
             }) : items.length === 0 ? /*#__PURE__*/ _jsxs("div", {
                 className: t.emptyState,
                 children: [
@@ -345,14 +442,16 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                     }),
                     /*#__PURE__*/ _jsx("p", {
                         className: t.emptyText,
-                        children: activeTab === 'all' ? say.noRecords : say.noRecordsForStatus(listStatusLabel(say, activeTab))
+                        children: scope === 'started_by_me' ? activeTab === 'all' ? say.noRecordsStartedByMe : say.noRecordsStartedByMeForStatus(listStatusLabel(say, activeTab)) : activeTab === 'all' ? say.noRecords : say.noRecordsForStatus(listStatusLabel(say, activeTab))
                     })
                 ]
             }) : /*#__PURE__*/ _jsx("div", {
                 className: t.list,
-                children: items.map((item)=>{
-                    const progress = calculateProgress(item);
+                children: shownItems.map((item)=>{
+                    // In review steps; see `chainProgress`.
+                    const progress = chainProgress(item);
                     const round = chainRoundLabel(say, item);
+                    const href = entityHref?.(item.entity_name, item.entity_id);
                     return /*#__PURE__*/ _jsxs("article", {
                         className: `${t.listItem} ${onEntityClick ? t.listItemHover : ''} ${onEntityClick ? 'cursor-pointer' : ''}`,
                         onClick: ()=>onEntityClick?.(item),
@@ -367,7 +466,7 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                                 children: [
                                     /*#__PURE__*/ _jsx("p", {
                                         className: t.entityName,
-                                        children: entityWord(say, item.entity_name)
+                                        children: hostRecordLabel(item, resolvedLabels, describeEntity) ?? entityWord(say, item.entity_name)
                                     }),
                                     /*#__PURE__*/ _jsx("p", {
                                         className: t.entityId,
@@ -377,6 +476,15 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                                         className: t.flowName,
                                         children: item.flow_name
                                     }),
+                                    href ? /*#__PURE__*/ _jsx("a", {
+                                        href: href,
+                                        target: "_blank",
+                                        rel: "noopener noreferrer",
+                                        onClick: (e)=>e.stopPropagation(),
+                                        onKeyDown: (e)=>e.stopPropagation(),
+                                        className: themeMode === 'light' ? 'text-[11px] font-medium text-blue-600 hover:underline' : 'text-[11px] font-medium text-cyan-300 hover:underline',
+                                        children: say.openRecord
+                                    }) : null,
                                     noteRowId === item.instance_id && startNote ? /*#__PURE__*/ _jsx("p", {
                                         "aria-hidden": "true",
                                         className: noteClass,
@@ -395,17 +503,13 @@ export function VerificationEntityList({ entityName, entityStatusesAction, theme
                                                 children: /*#__PURE__*/ _jsx("div", {
                                                     className: `${t.progressFill} ${getProgressColor(item.status)}`,
                                                     style: {
-                                                        width: `${progress}%`
+                                                        width: `${progress.percent}%`
                                                     }
                                                 })
                                             }),
-                                            /*#__PURE__*/ _jsxs("span", {
+                                            /*#__PURE__*/ _jsx("span", {
                                                 className: t.progressLabel,
-                                                children: [
-                                                    item.current_step_order,
-                                                    "/",
-                                                    item.total_steps
-                                                ]
+                                                children: progress.label
                                             })
                                         ]
                                     }),

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, startForEntityAction, 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, labelEntities, canManageFlows, }: VerificationFlowPageProps): ReactElement;